SeciossLink管理コンソール左メニューの「統合ID管理」–「Google スプレッドシート 設定」では、外部のGoogleスプレッドシートからユーザー情報やグループ情報を同期させるための設定を行います。
事前にGoogle側で設定を行ってからSeciossLink側で設定を行います。
のそれぞれについて解説します。
Googleサービス側事前設定
Google Cloud Platform にアクセスし、スプレッドシートをアップロードするGoogle の特権管理者アカウントでログインします
1.プロジェクトの新規作成
- ホーム画面左上のプロジェクト表示箇所をクリックして、プロジェクトを新規で作成します。
- 「新しいプロジェクト」をクリックします。
- 「新しいプロジェクト」で任意のプロジェクト名を入力し、「作成」をクリックします。
2.APIの設定
- 作成したプロジェクトが画面左上に表示されていることを確認し、「APIとサービス」をクリックします。
- API とサービスの設定 で左メニューの「ライブラリ」をクリックします。
- API の検索項欄に「Google Sheets API」検索し、検索結果に表示された「Google Sheets API」をクリックします。
- Google Sheets API の詳細画面から「有効にする」をクリックし、Google Sheets API を有効にします。
- ステータスが「有効」になっていること確認してください。
3.サービスアカウント設定
- API とサービスの設定 で左メニューの「認証情報」をクリックします。
- 「+認証情報を作成」>「サービス アカウント」をクリックします。
- サービスアカウントで任意のアカウント名とアカウントIDを入力し、「完了」をクリックします。
- 認証情報にサービスアカウントが作成されていることを確認し、作成されたサービスアカウントをクリックします。
- サービスアカウントの詳細画面に表示されている「メール」と「一意のID」をテキストエディタ等に控えておきます。
- 「鍵」タブをクリックし、「キーを追加」>「新しい鍵を生成」をクリックします。
- キーのタイプを「P12」を選択し、「作成」をクリックします。
- P12 証明書がダウンロードされます。後ほど使用しますので、任意の場所に保存してください。
※秘密鍵のパスワードを控える必要はありませんので、「閉じる」をクリックします。 - 作成したキーの情報が表示されることを確認します。
4.クライアントAPI承認設定
Google Workspace の管理コンソールにGoogleの特権管理者アカウントでログインします。
- ホーム画面の左メニューから「セキュリティ」>「アクセスとデータ管理」>「API の制御」をクリックします。
- API の制御の設定から「ドメイン全体の委任を管理」をクリックします。
- 「API クライアント」画面で「新しく追加」をクリックします。
- 「新しいクライアントIDを追加」の画面が表示されたら、「クライアントID」「OAuthスコープ(カンマ区切り)」の値を入力して、「承認」ボタンをクリックします。
クライアントID:サービスアカウント作成後に控えた「一意のID」の値を入力します。
OAuthスコープ(カンマ区切り):API のURL を入力します。
https://www.googleapis.com/auth/spreadsheets.readonly - 作成したAPI クライアント画面上に表示されていることをご確認ください。
SeciossLink側設定
SeciossLink管理コンソール左メニューの「統合ID管理」–「Google スプレッドシート 設定」で設定画面を開きます。必要事項を入力・設定したら、画面下部の「保存」ボタンをクリックしてください。
Google スプレッドシート 設定で設定できる項目は以下の通りです。
| 項目名 | 説明 |
|---|---|
| システムID※ | システムを識別するIDを入力します。 |
| 同期の設定 | Googleスプレッドシート設定を有効にする場合は「有効」にチェックを入れます。 |
| スプレッドシートID |
スプレッドシートの一意の識別子で、スプレッドシートの URL から取得できます。 例)https://docs.google.com/spreadsheets/d/<スプレッドシート ID>/edit?gid=<SHEET_ID>#gid=<SHEET_ID> |
| 管理アカウント | スプレッドシート連携で使用する管理アカウントを入力を入力します。 |
| OAuth API メールアドレス | Googleクラウドコンソール>APIとサービス>認証情報にある「サービスアカウント」のメールを入力します。 |
| OAuth API 秘密鍵 | サービスアカウント設定時にダウンロードした秘密鍵(.p12形式)をアップロードします。 |
| 複数値の区切り文字 |
区切り文字を入力します。 許可するサービスの例)区切り文字が「;」の場合 |
| ユーザー | |
| 同期の実行 | ユーザー情報の同期を有効にする場合は「有効」にチェックします。 |
| 更新の種類 | 同期した際に実行する更新の種類(「追加」「変更」「削除」)にチェックを入れます。 |
| 同期条件 | スプレッドシートから登録したユーザーのみを同期の対象とする場合は、チェックします。 |
| シート名 |
スプレッドシート内の対象ワークシート名を入力します。 例)ユーザー |
| 属性 |
同期する属性を入力します。 Google Sheets(同期元):スプレッドシートに記載の項目を入力(例:ユーザーID) 必須項目は「ユーザーID(連携キー)」「姓」「名」「メールアドレス」「地域」「言語」「ユーザー状態」「サービス」「ロール」となります。 |
| 固定値 | 「属性名」で指定したSeciossLink の属性値に、「値」で指定した値を設定します。 |
| グループ | |
| 同期の実行 | グループ情報の同期を有効にする場合は「有効」にチェックします。 |
| 同期条件 | Microsoft Entra IDからグループを同期する場合の条件をLDAPフィルター形式で指定します。 |
| 更新の種類 | 同期した際に実行する更新の種類(「追加」「変更」「削除」)にチェックを入れます。 |
| シート名 |
スプレッドシート内の対象ワークシート名を入力します。 例)グループ |
| 属性 |
同期する属性を入力します。 Google Sheets(同期元):スプレッドシートに記載の項目を入力(例:グループ名) |
| 固定値 | 「属性名」で指定したSeciossLink の属性値に、「値」で指定した値を設定します。 |
| メンバー | |
| 同期の実行 | グループメンバー情報の同期を有効にする場合は「有効」にチェックします。 |
| ユーザーメンバーのシート名 |
ユーザーグループと連携するユーザーメンバーのシート名を入力します。 例)ユーザー所属 |
| グループメンバーのシート名 |
ユーザーグループと連携するグループメンバーのシート名を入力します。 例)グループ所属 |
| 連絡先メンバーのシート名 |
ユーザーグループと連携する連絡先メンバーのシート名を入力します。 例)連絡先所属 |
| 属性 |
同期する属性を入力します。 Google Sheets(同期元)にスプレッドシートに記載の項目を「グループ名」と「メンバー」を入力します。 ※スプレッドシートの記載方法として、連絡先メンバーには連絡先のメールアドレスを入力してください。 |
| 連絡先 | |
| 同期の実行 | 連絡先情報の同期を有効にする場合は「有効」にチェックします。 |
| 更新の種類 | 同期したい種類にそれぞれチェックします。 |
| シート名 |
スプレッドシート内の対象ワークシート名を入力します。 例)連絡先 |
| 属性 |
同期する属性を入力します。 Google Sheets(同期元):スプレッドシートに記載の項目を入力(例:ユーザーID) 必須項目は「メールアドレス(連携キー)」「姓」「名」となります。 |
| 固定値 | 「属性名」で指定したSeciossLink の属性値に、「値」で指定した値を設定します。 |
※は必須項目です。
同期の実行
実際にGoogleスプレッドシートとSeciossLinkの同期を実施するためには以下の2つの方法があります。
スケジュールを使用した同期
「統合ID管理」-「実行時間設定」の設定を使用することで、実行時間をスケジュールで指定した同期ができます。
設定の詳細については実行時間設定の記載をご確認ください。
即時同期
画面下部の「差分確認」ボタンをクリックすると、SeciossLink側とGoogleスプレッドシート側での差分の一覧が表示されます。
「戻る」をクリックすると、Google スプレッドシート 設定画面に戻ります。
「差分確認」をクリックすると、再度差分の取得を実行し、取得した結果が表示されます。
「差分同期」をクリックすると、マスター同期に表示されていた差分データが即時でSeciossLink側に同期されます。
クリックした際にはダイアログが表示されるため、問題が無ければ「OK」をクリックします。