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

# SS1クラウド

> SS1クラウドとの連携方法です。企業コードの確認から、連携方法まで一連の手順を解説します。

export const IntegrationCapabilities = ({lang = "ja", modes = "", plan = "", lifecycle = "", automation = "", fetch = "", capabilities = "", memo = ""}) => {
  const TEXT = ({
    ja: {
      rows: {
        mode: "連携モード",
        plan: "連携確認プラン",
        lifecycle: "アカウントライフサイクル",
        automation: "自動化",
        fetch: "取得データ",
        capabilities: "対応機能",
        memo: "備考"
      },
      empty: "-",
      more: "各項目の意味は[連携可能SaaS・機能対応一覧](/integrations/supported-saas)をご覧ください。",
      mode: {
        "API Key": "APIキー"
      },
      lifecycle: {
        provisioning: "アカウント作成",
        deactivate: "アカウント無効化",
        delete: "アカウント削除"
      },
      automation: {
        provisioning: "アカウント作成",
        deactivate: "アカウント無効化",
        delete: "アカウント削除"
      },
      fetch: {
        User: "ユーザー名",
        Mail: "メールアドレス",
        Role: "ロール",
        Status: "ステータス",
        "2FA": "二要素認証",
        LastActivity: "最終利用日",
        Licenses: "ライセンス"
      },
      capabilities: {
        "employee-master": "従業員マスター連携",
        "identity-provider": "IDプロバイダー連携",
        "cost-aggregation": "コスト管理",
        "file-aggregation": "ファイル管理",
        "file-permissions": "ファイル権限管理",
        "device-aggregation": "MDM連携"
      }
    },
    en: {
      rows: {
        mode: "Integration mode",
        plan: "Verified plan",
        lifecycle: "Account lifecycle",
        automation: "Automation",
        fetch: "Fetched data",
        capabilities: "Capabilities",
        memo: "Notes"
      },
      empty: "-",
      more: "See [Supported SaaS and Capabilities](/en/integrations/supported-saas) for what each item means.",
      mode: {},
      lifecycle: {
        provisioning: "Account creation",
        deactivate: "Account deactivation",
        delete: "Account deletion"
      },
      automation: {
        provisioning: "Account creation",
        deactivate: "Account deactivation",
        delete: "Account deletion"
      },
      fetch: {
        LastActivity: "Last Activity"
      },
      capabilities: {
        "employee-master": "HR master",
        "identity-provider": "Identity provider",
        "cost-aggregation": "Cost management",
        "file-aggregation": "File management",
        "file-permissions": "File permissions",
        "device-aggregation": "MDM integration"
      }
    }
  })[lang === "en" ? "en" : "ja"];
  const BADGE_COLORS = {
    "ID/Password": "yellow",
    "API Key": "cyan",
    OAuth: "red",
    App: "purple",
    User: "blue",
    Mail: "cyan",
    Role: "orange",
    Status: "teal",
    "2FA": "pink",
    LastActivity: "green",
    Licenses: "purple",
    provisioning: "green",
    delete: "red",
    deactivate: "yellow",
    "employee-master": "blue",
    "identity-provider": "teal",
    "cost-aggregation": "yellow",
    "file-aggregation": "cyan",
    "file-permissions": "orange",
    "device-aggregation": "purple"
  };
  const list = value => String(value || "").split(",").map(item => item.trim()).filter(Boolean);
  const badges = (source, labels) => {
    const values = list(source);
    if (values.length === 0) {
      return <span className="integration-capabilities-empty">{TEXT.empty}</span>;
    }
    return values.map(value => <span key={value} className={"integration-catalog-badge integration-catalog-badge--" + (BADGE_COLORS[value] || "gray")}>
        {labels?.[value] ?? value}
      </span>);
  };
  const text = value => value || <span className="integration-capabilities-empty">{TEXT.empty}</span>;
  const ROWS = [["mode", badges(modes, TEXT.mode)], ["plan", text(plan)], ["lifecycle", badges(lifecycle, TEXT.lifecycle)], ["automation", badges(automation, TEXT.automation)], ["fetch", badges(fetch, TEXT.fetch)], ["capabilities", badges(capabilities, TEXT.capabilities)], ["memo", text(memo)]];
  return <div className="integration-capabilities">
      <dl className="integration-capabilities-list">
        {ROWS.map(([key, value]) => <div className="integration-capabilities-row" key={key}>
            <dt>{TEXT.rows[key]}</dt>
            <dd>{value}</dd>
          </div>)}
      </dl>
    </div>;
};

## 連携仕様

<IntegrationCapabilities modes="ID/Password" capabilities="device-aggregation" memo="ユーザー（サービスアカウント）は取得しません。シリアル番号・製造元を取得しないため、既存デバイスとのシリアルマージはできません。" />

## 事前準備

### 企業コードの確認方法

SS1クラウドの利用登録時に、ログイン用のURLが発行されます。URLに含まれる `{company_code}` の部分が企業コードです。

<img src="https://mintcdn.com/admina-sbn/TmkkJO00jlcDxtIf/images/integrations/ss1-cloud/login-url.png?fit=max&auto=format&n=TmkkJO00jlcDxtIf&q=85&s=87ec840446cf4f1eee81123bc6ac88c0" alt="SS1クラウドのログインURL。company_codeの部分が企業コードにあたる" width="812" height="82" data-path="images/integrations/ss1-cloud/login-url.png" />

企業コードに加えて、SS1クラウドへのログインに使用する**ユーザー名**・**パスワード**もあわせてご用意ください。

<Note>
  海外環境管理オプションをご利用の場合、ログインURLのドメイン（`mgr.ss1-cloud-gl.com`）部分が異なります。
</Note>

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

1. インテグレーション画面にて**SS1クラウド**を検索します。

2. **リージョン**を「日本（`mgr.ss1-cloud.com`）」「グローバル（`mgr.ss1-cloud-gl.com`）」から選択します。続いて、**ドメインコード**（企業コード）・**ユーザー名**・**パスワード**を入力し、**連携する**をクリックします。

   <img src="https://mintcdn.com/admina-sbn/ERtuPC2OPeUBe5i0/images/integrations/ss1-cloud/integrate-workspace.png?fit=max&auto=format&n=ERtuPC2OPeUBe5i0&q=85&s=49a4fde5fb9b970b5bc935933f4a0853" alt="連携設定画面" width="738" height="1168" data-path="images/integrations/ss1-cloud/integrate-workspace.png" />

3. SS1クラウドとの連携が成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。正常に完了しない場合は、まず [SaaSとの連携に失敗する場合の対処法](/it-management/saas-management/93nahw45is-trouble) に記載のステップをお試しください。それでも解決しない場合は、[ご提供いただきたい情報](/it-management/saas-management/93nahw45is-trouble#info-to-provide) をご確認のうえ、[サポート窓口](/contact-support)までお問い合わせください。

## MDM連携

デバイス管理機能をご利用の場合、SS1クラウドとのデバイス同期が可能です。詳細は[MDM連携に対応SaaSとデバイスを連携する](/it-management/device/k1u975zc6h-mdm)をご覧ください。

<Info>
  SS1クラウドのデバイスAPIはWindows PCに加え、Mac・モバイル端末の情報も取得できます。

  また、シリアルナンバーはSS1クラウド側のAPIレスポンスに含まれないため取得できません。マージキーとして機能しないため、既存デバイスとは自動でマージされず新規登録されます。
</Info>

### 同期対象の項目

| 当サービス側の項目 | 同期パターン | SS1クラウド側 | 補足事項 |
| - | - | - | - |
| 資産番号 | (2)当サービスベース | `<mdmname>_<pc_name>` | 重複を避けるためプレフィックスが付与されます。 |
| シリアルナンバー(IMEI) | (1)MDMベース | 取得不可 | SS1クラウド側のAPIレスポンスに含まれないため取得できません。 |
| Email | (2)当サービスベース | `logon_user` 経由でログオンユーザーのレコードを参照 | ログオンユーザーにメールアドレスが無いため、ユーザー名の一致で紐付けます。 |
| 種別 | (2)当サービスベース | `instrument_type_name` | 「デスクトップパソコン」はデスクトップPC、「ノートパソコン」はラップトップPCとして判定されます。 |
| ステータス | (2)当サービスベース | `work_status_name` | 「社内作業」の場合は「利用」になります。それ以外の値の対応は今後精査の予定です。 |
| ロケーション1 / 2 | (2)当サービスベース | `department`（ロケーション1のみ） | ロケーション1にはデバイスが所属する部署名が同期されます。ロケーション2は同期されません。 |
| 購入日 | (2)当サービスベース | `purchase_date` | 値が空の場合があります。 |
| メモリ | (1)MDMベース | `memory_size` | MB単位です。 |
| HDD/SSD | (1)MDMベース | `sysdrive_size` | 合計容量（MB単位）。空き容量は `sysdrive_free_size` として別に保持されます。 |
| OS | (1)MDMベース | `os_name` | 例: "Windows 11 Home" |
| バージョン | (1)MDMベース | `release_id` | リリースID（例: "25H2"）です。 |
| ホスト名 | (1)MDMベース | `pc_name` | コンピューター名です。 |
| 最終利用(MDM) | (1)MDMベース | `last_survive_date` | SS1エージェントの最終ハートビート（チェックイン）です。 |
| MDMリンク | (1)MDMベース | `https://mgr.ss1-cloud.com/mgr/instrument/detail/index/{id}/instrument` | 「MDMで開く」リンクからSS1の機器の詳細画面に遷移できます。 |
| 管理対象 | (1)MDMベース | `is_installed` | SS1エージェントのインストール状態です。 |
| 管理対象 | (3)MDM項目 | （固定で Managed） | |