> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# サイボウズ Office

> サイボウズとの連携の手順です。

## サポートする機能

<Badge color="blue">アカウント作成</Badge> <Badge color="blue">アカウント削除</Badge>

<Info>
  連携には共通管理者のメールアドレスとパスワードが必要です。
  サイボウズOfficeとの連携では、Cybozu Officeのユーザーのみを取得します。
  全てのアカウントを取得する連携は「cybozu.com 共通管理」で連携してください。
</Info>

## 連携方法

以下の連携方法で連携いただけます。

* ID/Passwordでの連携
* APIでの連携

## 事前準備

### ID/Passwordで連携する場合

<Info>
  **2FA（2要素認証）をご利用の場合**

  ID/Passwordによる連携で、[2 要素認証](https://jp.cybozu.help/general/ja/id/02042.html)を有効にしたユーザーでは、パスワード認証で REST API を実行できません。

  2要素認証を無効にした連携用アカウントをご用意ください。

  詳細は[2要素認証を設定している場合（外部サイト）](https://cybozu.dev/ja/common/docs/user-api/overview/authentication/#2fa)をご参照ください。
</Info>

#### サイボウズへのログイン方法

[サイボウズ ログインページ](https://www.cybozu.com/jp/login/)または、ご利用のサイボウズのサブドメインから共通の管理者権限のメールアドレス・パスワードを入力し、ログインします。

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/79jc5hfcpb/1661926365281-image.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=6afadebf2a247d610966a1a76b188663" alt="サイボウズログインページ" width="1199" height="434" data-path="images/integrations/79jc5hfcpb/1661926365281-image.png" />

<Info>
  [SAML認証を回避するURL（外部サイト）](https://jp.kintone.help/general/ja/admin/list_saml/saml_restriction#list_saml_saml_restriction_20)

  「SAML認証の使用を必須にする」を有効にしていても、cybozu.com共通管理者だけはパスワード認証を利用してcybozu.comにログインできます。
</Info>

#### ワークスペースキーの取得方法

サイボウズにログイン後、URLの一部が**ワークスペースキー**となるので、保存しておきます。

`https://{ワークスペースキー}.cybozu.com/o/`

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/79jc5hfcpb/1661924762843-image.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=3ac058f943ad6688970ceb36abec5477" alt="ワークスペースキーの例" width="968" height="286" data-path="images/integrations/79jc5hfcpb/1661924762843-image.png" />

### APIで連携する場合

#### APIキーの取得方法

1. cybozu.com共通管理 > 外部連携 > APIトークン > **APIトークンを生成** をクリックします。

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/79jc5hfcpb/1761116109226-screenshot.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=5d0926b8765b7f9b7fa6bbf859651eb3" alt="APIトークン生成画面" width="2878" height="1422" data-path="images/integrations/79jc5hfcpb/1761116109226-screenshot.png" />

2. **Read and Write** にチェックを入れ、**生成**をクリックします。

生成された**APIキー**をコピーします。

<img src="https://mintcdn.com/admina-sbn/qJjJh1wxF6j7EyS6/images/integrations/79jc5hfcpb/1761116250754-screenshot.png?fit=max&auto=format&n=qJjJh1wxF6j7EyS6&q=85&s=e6410211c158b3f3bd7f46c57c444017" alt="APIキー生成結果" width="1472" height="1180" data-path="images/integrations/79jc5hfcpb/1761116250754-screenshot.png" />

## インテグレーションのセットアップ

1. Adminaのインテグレーション画面にて、**サイボウズ Office** で検索します。

<img src="https://mintcdn.com/admina-sbn/qJjJh1wxF6j7EyS6/images/integrations/79jc5hfcpb/1767777996490-screenshot.png?fit=max&auto=format&n=qJjJh1wxF6j7EyS6&q=85&s=a9c9f5563ef9e6c05d33b3a48cedf067" alt="サイボウズ Office 検索結果" width="1284" height="758" data-path="images/integrations/79jc5hfcpb/1767777996490-screenshot.png" />

### ID/Passwordによる連携

\[ID/Password]タブをクリックし、任意の**ワークスペース名**、前の手順で取得した**ワークスペースキー**、**共通管理者のメールアドレスとパスワード**を入力し、**連携する**をクリックします。

Basic認証を設定している場合は、**Basic認証のログイン名とパスワード**も入力してください。

<img src="https://mintcdn.com/admina-sbn/qJjJh1wxF6j7EyS6/images/integrations/79jc5hfcpb/1767778195374-screenshot.png?fit=max&auto=format&n=qJjJh1wxF6j7EyS6&q=85&s=330892c1b8f2f90969bc8e56dacd744b" alt="ID/Password連携画面" width="676" height="1310" data-path="images/integrations/79jc5hfcpb/1767778195374-screenshot.png" />

### APIによる連携

\[API]タブで、前の手順で取得した**ワークスペースキー、APIキー**を入力し、**連携する**をクリックします。

<img src="https://mintcdn.com/admina-sbn/qJjJh1wxF6j7EyS6/images/integrations/79jc5hfcpb/1767778207520-screenshot.png?fit=max&auto=format&n=qJjJh1wxF6j7EyS6&q=85&s=0878119a04a311a193c115f8e8d44d79" alt="API連携画面" width="710" height="998" data-path="images/integrations/79jc5hfcpb/1767778207520-screenshot.png" />

## 連携の確認

サイボウズ Officeとの連携に成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。

正常に完了しない場合は、インテグレーション画面のステータスタブから**編集**し、再度連携をお試しください。

解決しない場合はチャットにてお問い合わせください🙏

サイボウズの連携概要については[連携ページ](http://admina.moneyforward.com/jp/integrations/cybozu)をご覧ください。