Googleグループ情報をCloudGate UNOに取り込む　-OAuth設定-

このガイドではCloudGateを導入するための前準備であるG Suite側でのOAuth（オー・オース)設定を説明しています。

 

目次

1. APIプロジェクトの作成
1-1. 事前準備
1-2. プロジェクトの作成
1-3. APIを有効にする

2. OAuthのクライアントIDを作成する

3. APIスコープの承認

 

1. APIプロジェクトの作成

1-1. 事前準備

Google管理コンソール（https://admin.google.com/）にG Suite特権管理者でログインします。
トップページの「アプリ」をクリックして、次の画面で「その他のGoogleサービス」をクリックします。（「アプリ」がない場合は、トップページ画面下の「その他の設定」をクリックすることで、「アプリ」のリンクを見つけることができます。）

主なGoogleサービスが一覧表示されます。
Google Cloud Platform 項目の「ステータス」が「オン」になっていることを確認します。
オンになっていない場合は、右側の三本線のメニューから「すべてのユーザーに対してオンにする」を選択して設定します。

Google Cloud Platform 項目が見つからない場合は、ページ下の1ページあたりの行数を変更するか、ページを切り替えて確認します。

 

1-2. プロジェクトの作成

Google Cloud Platform（https://console.developers.google.com）に、G Suite特権管理者でログインします。

利用規約が表示される場合は、以下を選択して「同意して続行」をクリックします。 

• 利用規約：チェックを入れる（必須項目）
• 最新情報をメールで通知：（任意項目）
  

画面右の「作成」をクリックします。 もしくは画面左上のプルダウンをクリックして、「新しいプロジェクト」をクリックします。

 

新しいプロジェクトを作成する画面が表示されるので、プロジェクト名に「CloudGate-Group」と入力して「作成」ボタンをクリックします。

※プロジェクトの作成が完了するまで少し時間がかかります。

 

1-3. APIを有効にする

プロジェクトの作成が完了したら、プロジェクト「CloudGate-Group」を選択した状態で、ナビゲーションメニュー（画面左上の「三本線のアイコン」）から「APIとサービス」にマウスカーソルを合わせて「ライブラリ」をクリックします。

※「このページを表示するには、プロジェクトを選択してください。」と表示される場合：
「選択」ボタンをクリックして、作成したプロジェクト「CloudGate-Group」を選択します。

検索窓に以下の2つのAPIを1つずつ入力して検索し、APIを有効化します。 

• Admin SDK
• Contacts API

それぞれの検索結果画面にて対象のAPIをクリックして「有効にする」ボタンをクリックします。 

再度、ナビゲーションメニューから「APIとサービス」にマウスカーソルを合わせて「ライブラリ」をクリックし、もう1つのAPIについても有効にする操作を実施します。

ナビゲーションメニューから「APIとサービス」にマウスカーソルを合わせて「ダッシュボード」をクリックし、画面下部の一覧表に、有効にしたAPIがリスト表示されていることを確認してください。

 

2. OAuthのクライアントIDを作成する

有効にしたAPIがリスト表示されていることを確認したら、左メニューより「認証情報」をクリックします。

認証情報の画面より「認証情報を作成」をクリックします。表示されたリストより「サービスアカウント」をクリックします。

「サービスアカウントキーの作成」画面に遷移します。

 

• サービス アカウントの詳細
  サービス アカウント名に「CloudGate-Group」を入力して「作成」をクリックします。
  
  
  
• サービス アカウントの権限（オプション）
  「役割を選択」のプルダウンから「Project」を選択して「オーナー」を選択します。
  「続行」をクリックして次の画面に進みます。
  
  
• ユーザーにこのサービス アカウントへのアクセス権を付与（オプション）
  「キーを作成」をクリックします。
  表示された画面から「JSON」を選択して「作成」をクリックします。
  
  
  

 

サービスアカウントキーの作成が完了することで「CloudGate-Group**************.json」という名称のプライベートキーが自動でダウンロードされます。

 

「秘密鍵がパソコンに保存されました」と表示されるので画面を閉じます。
「完了」をクリックし、次に進みます。

 

画面右側の「サービスアカウントの管理」をクリックし、作成したサービスアカウント表の右端のメニューから「編集」を選択します。

 

「サービスアカウントの詳細」画面で「ドメイン全体の委任の表示」をクリックして、表示される「G Suite ドメイン全体の委任を有効にする」にチェックを入れます。

「同意画面のプロダクト名」に「CloudGate-Group」と入力し、そのまま「保存」をクリックします。

 

ナビゲーションメニューから「APIとサービス」にマウスカーソルを合わせて「認証情報」をクリックし、表示された画面で、作成した「サービスアカウントの名前のリンク」をクリックします。

作成されたサービスアカウントの情報が画面上に表示されます。
画面上で確認できる「クライアントID」と「サービスアカウント（メールアドレス）」の値をテキストエディタなどにコピー＆ペーストして控えます。 

※「クライアントID」と「サービスアカウント（メールアドレス）」の値は「3-1. API アクセスの有効化」の作業で必要になります。「サービスアカウント」の1行目に表示されている「CloudGate-Group」という文字はコピー不要です。

 

画面上部の「三本線のアイコン」をクリックして表示されるスライドメニューより「IAMと管理」にマウスカーソルを合わせて「IAM」をクリックします。

ナビゲーションメニューから「IAMと管理」にマウスカーソルを合わせて「IAM」をクリックし、表示された画面で、「CloudGate-Group」プロジェクトの役割が、「オーナー」もしくは「編集者」であることを確認します。

「役割」の設定を確認できたら、Google Cloud Platform での作業は完了です。画面を閉じて「3. APIスコープの承認」の手順に進みます。

※「オーナー」または「編集者」以外の場合は、列右端の鉛筆マークをクリックして、「役割」のプルダウンより「Project」から「オーナー」もしくは「編集者」を選択します。

※作成した「CloudGate-Group」プロジェクトが一覧にない場合は、以下手順で確認します。

（1）画面上部の「追加」をクリックします。
（2）「メンバーの追加」画面で、「メンバー」欄には先ほどサービスアカウント情報の確認画面でコピーした「サービスアカウント（メールアドレス）」の値を入力します。
（3）「役割」のプルダウンより「Project」項目にマウスカーソルを合わせ「オーナー」を選択します。

追加したサービスアカウントがリストに反映されたことを確認し、Google Cloud Platform での作業は完了です。画面を閉じて次の手順に進みます。

 

3. APIスコープの承認

Google管理コンソール（https://admin.google.com/）にG Suite特権管理者でログインします。

ダッシュボードから、「セキュリティ」をクリックします。
ダッシュボードの一覧にない場合は、画面下の「その他の設定」をクリックすることで、「セキュリティ」が表示されます。

セキュリティ設定の画面内の「詳細設定」をクリックし、詳細設定のサブメニューから「認証」項目内の「API クライアント アクセスを管理する」のリンクをクリックします。

「APIクライアントアクセスを管理する」画面で、以下の値を入力します。

• クライアント名：「3. OAuthのクライアントID作成」の作業で確認したクライアントID を入力
• 1つ以上のAPI の範囲：以下の3つのURLをコピー＆ペーストして入力
  https://www.google.com/m8/feeds,
  https://www.googleapis.com/auth/admin.directory.group,
  https://www.googleapis.com/auth/admin.directory.user

上記の値を入力し、「承認」をクリックします。

下記の画面のように入力した内容が追加されたことを確認します。