1.プロジェクトの作成
Google Cloud Platform にて YourDesk 用のプロジェクトを作成します。これにより YourDesk から Google Workspace の API へのアクセスが可能となります。
1.Google Cloud Platform を開き、設定を行う Google Workspace の管理権限を持ったアカウントでログインします。
2.ページ上部にあるプルダウンをクリックします。※プルダウンには「プロジェクトの選択」もしくは「既存のプロジェクト名」が表示されています。
3.「選択元」が YourDesk と連携を行う組織になっていることを確認し、右上の「新しいプロジェクト」をクリックします。
4.「プロジェクト名」に YourDesk と入力し、組織、場所にはそれぞれ組織を設定します。
2.API を有効にする
1.左上のナビゲーションメニューから「API とサービス」 > 「ライブラリ」と選択し API ライブラリを開きます。
2.入力フィールドに「Admin SDK API」と入力し API を検索します。
3.検索結果から「Admin SDK API」を選択し、「有効化」をクリックします。
※ Google Workspace の会議室情報を取得するために使用する Admin Directory API は、Admin SDK API に含まれます。
4.(カレンダー連携を利用する場合)左上の ← アイコンをクリックし API ライブラリに戻り、入力フィールドに「Google Calendar API」と入力し API を検索します。
5.(カレンダー連携を利用する場合)検索結果から「Google Calendar API」を選択し、「有効化」をクリックします。
3.認証情報を作成する
1.左上のナビゲーションメニューから「API とサービス」 > 「認証情報」と選択し認証情報を開きます。
2.ページ上部にある「+認証情報を作成」をクリックし「 OAuth クライアント ID 」を選択します。
3.“OAuth クライアント ID を作成するには、まず同意画面で設定を行う必要があります”とメッセージが表示されるので「同意画面を設定」をクリックします。
4.「 OAuth 同意画面」が表示されたら User Type を「内部」にチェックし「作成」をクリックします。
5.ページが開いたら以下の内容を入力して「保存して次へ」をクリックします。
# アプリ情報 アプリ名:yourdesk ユーザーサポートメール:貴社ご担当者のメールアドレス アプリのロゴ:(任意、未指定でも可) # アプリのドメイン アプリケーションのホームページ:未指定 [アプリケーション プライバシー ポリシー] リンク:未指定 [アプリケーション利用規約] リンク:未指定 # 承認済みドメイン 承認済みドメイン 1 :yourdesk.jp # デベロッパーの連絡先情報 メールアドレス : yourdesk_sales@sios.com
6.新たに表示されるメニューから「データアクセス」を選択、「スコープを追加または削除」をクリックし API にてアクセスを許可するスコープを追加します。
7.「選択したスコープの更新」がポップアップされるので、以下の「範囲」のスコープにチェックを入れ「更新」をクリックします。
.../auth/userinfo.email openid .../auth/calendar(カレンダー連携を利用する場合)
8.各項目が以下の設定になっていることを確認し「 save(もしくは保存)」をクリックします。
# 非機密のスコープ .../auth/userinfo.email openid # 機密性の高いスコープ .../auth/calendar(カレンダー連携を利用する場合) # 制限付きのスコープ なし
9.保存が完了するのを待ちます。(保存が完了するとボタンが無効化された状態で表示されます。)
10.左上のナビゲーションメニューから「 API とサービス」 > 「認証情報」をクリックします。表示されたページ内の「+認証情報を作成」をクリックし表示されるリストの中から「 OAuth クライアント ID 」を選択します。
11.「OAuth クライアント ID の作成」画面が表示されたら以下の内容を入力し「作成」をクリックします。
アプリケーションの種類:ウェブ アプリケーション 名前:YourDesk # 承認済みのリダイレクト URI URI 1:https://gateway.yourdesk.jp/[組織コード]/oauth/2/callback ※ [組織コード] には事前に通知される貴社の組織コードを入力してください。 組織コード:sios の場合)https://gateway.yourdesk.jp/sios/oauth/2/callback (カレンダー連携を利用する場合)「+ URI を追加」をクリックし追加された入力フィールドに以下を入力します。 URI 2:https://app.yourdesk.jp/calendar-callback
12.「OAuth クライアントを作成しました」というポップアップがされるので「 JSON をダウンロード」をクリックしダウンロードします。
4.カレンダー連携設定(1)
1.左上のナビゲーションメニューから「IAMと管理」 > 「サービスアカウント」と選択しサービス アカウントを開きます。
2.「+サービスアカウントを作成」をクリックします。
3.「サービスアカウントの作成」ページが開くので、以下の内容を入力し「完了」をクリックします。(最初の入力項目のみが必要で以降の項目は省略するため、入力が終わったら「作成して続行」ではなくページ下部の「作成して閉じる」もしくは「完了」をクリックしてください。)
サービスアカウント名:yourdesk-calendar サービスアカウント ID:(自動入力) ※上記以外の項目は全て省略可能なため入力の必要はない。
4.サービスアカウントの一覧に 2 で作成したサービスアカウントが表示されますので、この詳細を開き「鍵」もしくは「キー」タブを開きます。「鍵を追加」もしくは「キーを追加」プルダウンから「新しい鍵を作成」をクリックします。
5.「yourdesk-calendar」の秘密鍵の作成がポップアップされますので「キーのタイプ」で「 JSON 」をチェック、「作成」をクリックしダウンロードします。
5.カレンダー連携設定(2)
※この章の手順1〜4は {Google Admin}[https://admin.google.com/]、手順5以降は Google カレンダーで操作します。
1.Google Admin を開き、左上のナビゲーションメニューから「セキュリティ」 > 「アクセスとデータ管理」 > 「APIの制御」と選択しAPIの制御を開きます。
2.ページ下部の「ドメイン全体の委任を管理」をクリックします。
3.ドメイン全体の委任ページが開くので「新しく追加」をクリックします。
4.「新しいクライアント ID を追加」が表示されたら、カレンダー連携用サービスアカウントのクライアント ID と、以下の3つのスコープを登録します。
4-5 で取得したカレンダー連携用サービスアカウント(yourdesk-calendar)の JSON ファイルを開き、client_id の内容を「クライアント ID」に入力します。
「OAuth スコープ」に以下の3つのスコープを追加し、「承認」をクリックします。
https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly https://www.googleapis.com/auth/calendar.acls.readonly
追加する admin.directory.resource.calendar.readonly は会議室情報の読み取り、calendar.acls.readonly はカレンダー共有権限の読み取りに使用します。
※ すでにカレンダー連携を設定済みの場合は、「ドメイン全体の委任を管理」の一覧で対象のクライアント ID の「編集」を開きます。既存のスコープを残したまま、上記3つのうち未登録のスコープを追加し、「承認」をクリックしてください。
画面例:設定済みのクライアントで「スコープを編集」を開いた場合。画像内では長いスコープの末尾が見切れているため、入力する値は上記の一覧を参照してください。
5.会議室カレンダーの共有設定を変更できるアカウントで、Google カレンダーを開きます。
※ 手順5から手順9は、会議室カレンダー連携を行う場合にのみ必要です。
YourDesk の「SSO/カレンダー連携」画面の「Google Workspace の管理者のメールアドレス( delegated_admin_email )」(以下 delegated_admin_email )に指定する管理アカウントが会議室カレンダーにアクセスできるように、会議室ごとに共有権限を設定します。
delegated_admin_email にも管理者アカウントを指定する必要がありますが、この操作は delegated_admin_email に指定するアカウントとは別の管理者アカウント(対象の会議室カレンダーの共有設定が可能なアカウント)で行ってください。
| アカウントの役割 | この手順での設定例 |
|---|---|
| 会議室カレンダーの共有設定を行う管理者アカウント | ‘admin@g.yourdesk.jp` |
| YourDesk が会議室カレンダーを操作するための管理者アカウント ‘delegated_admin_email` | ‘tester3@g.yourdesk.jp` |
※ メールアドレスと会議室名は設定例です。実際に使用するアカウントと会議室に読み替えてください。
6.Google カレンダーの「設定」を開き、「マイカレンダーの設定」から対象の会議室カレンダーを選択します。
この例では「サイオスビル-6-会議室A (12)」を選択します。
7.「共有する相手」で、共有先の管理者アカウントを追加します。
「ユーザーやグループを追加」から、delegated_admin_email に指定した管理者アカウント(この例では tester3@g.yourdesk.jp)を追加します。すでに登録されている場合は、そのアカウントの権限を確認します。
8.共有先の管理者アカウントの権限で「すべての予定の詳細の変更や表示ができます」を選択します。
「共有する相手」にある対象アカウントのプルダウンメニューで、「すべての予定の詳細の変更や表示ができます」を選択し、共有設定を完了します。
画面例:admin@g.yourdesk.jp で「サイオスビル-6-会議室A (12)」の共有設定を開き、共有先の tester3@g.yourdesk.jp に権限を設定する場合。
9.YourDesk と連携するすべての会議室カレンダーに、同じ共有設定を行います。
他の会議室も、手順6〜8と同様に設定してください。各会議室の「共有する相手」に delegated_admin_email で指定した管理者アカウントが登録され、権限が「すべての予定の詳細の変更や表示ができます」になっていることを確認します。
6.ユーザープロビジョニングの設定(1)
※ユーザープロビジョニングを利用しない場合でもこの設定が必要となります。
1.Google Cloud Platform の左上のナビゲーションメニューから「IAMと管理」 > 「サービスアカウント」と選択しサービス アカウントを開きます。
2.「+サービスアカウントを作成」をクリックします。
3.「サービスアカウントの作成」ページが開くので、以下の内容を入力し「完了」をクリックします。(最初の入力項目のみが必要で以降の項目は省略するため、入力が終わったら「作成して続行」ではなくページ下部の「作成して閉じる」もしくは「完了」をクリックしてください。)
サービスアカウント名:yourdesk-provisioning サービスアカウント ID:(自動入力) ※上記以外の項目は全て省略可能なため入力の必要はない。
4.サービスアカウントの一覧に 2 で作成したサービスアカウントが表示されますので、この詳細を開き「鍵」もしくは「キー」タブを開きます。「鍵を追加」もしくは「キーを追加」プルダウンから「新しい鍵を作成」をクリックします。
5.「yourdesk-provisioning」の秘密鍵の作成がポップアップされますので「キーのタイプ」で「 JSON 」をチェック、「作成」をクリックしダウンロードします。
7.ユーザープロビジョニングの設定(2)
※これ以降の手順は Google Cloud Platform ではなく {Google Admin}[https://admin.google.com/] による操作になります。ご注意ください。
1.Google Admin を開き、左上のナビゲーションメニューから「アカウント」 > 「管理者ロール」と選択し管理者ロール一覧を開きます。
2.ページ上部の「新しいロールを作成」をクリックします。
3.ロールを作成ページが開くので以下の内容を入力し「続行」をクリックします。
名前:YourDeskプロビジョニングロール 説明:YourDeskプロビジョニングロール
4.権限のツリー下方の「管理 API の権限」から「組織部門 > 読み取り」と「ユーザー > 読み取り」をチェックして「続行」をクリックします。
5.確認画面が表示されますので、内容を確認したら「ロールを作成」をクリックします。
6.作成されたロールの詳細画面が表示されますので「サービスアカウントへの割り当て」をクリックします。
7.「サービス アカウントを追加」という入力フィールドが表示されるため、6-4 で取得した JSON ファイルを開き「client_email」の内容を入力し「追加」をクリックします。
8.アカウントが追加されたら「ロールを割り当て」をクリックします。
8.YourDesk での設定
1.YourDesk に管理者ユーザーでログインし「メニュー」 > 「 SSO/カレンダー連携」を開きます。
2.「Google Workspace」を選択し以下の項目を入力します。
認証タイプ: OAuth Client ID: ※「認証情報JSON読込」をクリックし、3-12 で取得した JSON ファイルを指定することで自動入力されます。 Client Secret: ※「認証情報JSON読込」をクリックし、3-12 で取得した JSON ファイルを指定することで自動入力されます。 ユーザープロビジョニング: する or しない ドメイン(「する」の場合): Google Workspace 上の「ドメイン」 ユーザープロビジョニング用秘密鍵JSON: 「ユーザープロビジョニング用秘密鍵JSON読込」をクリックし、6-5 で取得した JSON ファイルを指定することで自動入力されます。 ※ ユーザープロビジョニングを利用しない場合でも「ユーザープロビジョニング用秘密鍵JSON」は必須項目となります。 カレンダー連携: する or しない カレンダー連携用秘密鍵JSON: 「カレンダー連携用秘密鍵JSON読込」をクリックし、4-5 で取得した JSON ファイルを指定することで自動入力されます。 ※カレンダー連携、会議室連携の片方もしくは両方を利用する場合には「カレンダー連携用秘密鍵JSON」は必須項目となります。 Google Workspace の管理者のメールアドレス: 5-5 で「YourDesk が会議室カレンダーを操作するための管理者アカウント」として設定したアカウントのメールアドレス
「ドメイン」は console.cloud.google.com/welcome などでも確認が可能です。「選択中のプロジェクト」に表示されている最上位階層が「ドメイン」になります。
3.「保存」をクリックします。
4.「メニュー」 > 「ログアウト」をクリックし、ログイン画面にて「Googleで続ける」ボタンをクリックし SSO でログインします。
5.ログインが正しく行われるか、カレンダー連携が有効となっているか、会議室連携が有効となっているかなどを確認します。
***
※契約終了、または SSO オプション解除時には以下の操作をお願いします。
***