> ## 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.

# Cybozu Office

> Instructions for integrating with Cybozu Office.

## Supported Features

<Badge color="blue">Account Creation</Badge> <Badge color="blue">Account Deletion</Badge>

<Info>
  A common administrator email address and password are required for the integration.
  When integrating with Cybozu Office, only Cybozu Office users are retrieved.
  To retrieve all accounts, please integrate via "cybozu.com Common Administration."
</Info>

## Integration Methods

The following integration methods are available:

* Integration via ID/Password
* Integration via API

## Prerequisites

### For ID/Password Integration

<Info>
  **If you use 2FA (Two-Factor Authentication)**

  When integrating via ID/Password, REST API cannot be executed with password authentication for.
  Users who have enabled [two-factor authentication](https://jp.cybozu.help/general/ja/id/02042.html).

  Please prepare a dedicated integration account with two-factor authentication disabled.

  For details, see [When two-factor authentication is configured (external site)](https://cybozu.dev/ja/common/docs/user-api/overview/authentication/#2fa).
</Info>

#### How to Log In to Cybozu

Go to the [Cybozu login page](https://www.cybozu.com/jp/login/) or your organization's Cybozu subdomain.
Enter the common administrator email address and password, and log in.

<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="Cybozu login page" width="1199" height="434" data-path="images/integrations/79jc5hfcpb/1661926365281-image.png" />

<Info>
  [URL to bypass SAML authentication (external site)](https://jp.kintone.help/general/ja/admin/list_saml/saml_restriction#list_saml_saml_restriction_20)

  Even if "Require SAML authentication" is enabled.
  Cybozu.com common administrators can still log in to cybozu.com using password authentication.
</Info>

#### How to Obtain Your Workspace Key

After logging in to Cybozu, part of the URL becomes your **workspace key** — save it for later.

`https://{workspace-key}.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="Example of workspace key in URL" width="968" height="286" data-path="images/integrations/79jc5hfcpb/1661924762843-image.png" />

### For API Integration

#### How to Obtain an API Key

1. Go to cybozu.com Common Administration > External Integration > API Token > click **Generate API Token**.

<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 token generation screen" width="2878" height="1422" data-path="images/integrations/79jc5hfcpb/1761116109226-screenshot.png" />

2. Check **Read and Write**, then click **Generate**.

Copy the generated **API key**.

<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 key generation result" width="1472" height="1180" data-path="images/integrations/79jc5hfcpb/1761116250754-screenshot.png" />

## Integration Setup

1. In the Admina integration screen, search for **Cybozu 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="Cybozu Office search results" width="1284" height="758" data-path="images/integrations/79jc5hfcpb/1767777996490-screenshot.png" />

### Integration via ID/Password

Click the **\[ID/Password]** tab, enter an arbitrary **workspace name**, the **workspace key** obtained in the previous step.
The **common administrator email address and password**, then click **Connect**.

If Basic authentication is configured, also enter the **Basic authentication login name and password**.

<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 integration screen" width="676" height="1310" data-path="images/integrations/79jc5hfcpb/1767778195374-screenshot.png" />

### Integration via API

On the **\[API]** tab, enter the **workspace key and API key** obtained in the previous step, then click **Connect**.

<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 integration screen" width="710" height="998" data-path="images/integrations/79jc5hfcpb/1767778207520-screenshot.png" />

## Verifying the Integration

Once the integration with Cybozu Office is successful, the registered user information will appear in the account list.

If the process does not complete successfully, go to the Status tab on the integration screen, click **Edit**.
Try connecting again.

If the issue persists, please contact us via chat.

For an overview of the Cybozu integration, see the [integration page](http://admina.moneyforward.com/en/integrations/cybozu).