---
title: Google Workspaceを利用してSAML認証によるSSOを実装する
category: 外部システム連携
weight: 1
---

Google Workspaceを利用してSSOを実装する方法を説明します。  
Google WorkspaceをIdP, KurocoをSPとしたSAML認証によるシングルサインオンになります。

## 前提条件
このチュートリアルはGoogle Workspaceのアカウントを所持していることが前提となります。

## Kurucoの管理画面でSP設定を追加
まずはKurocoの管理画面でSP設定をします。  

**1. SSO SAML SP設定の画面へ遷移する**  
[SSO SAML SP編集](/ja/docs/management/sso-saml-sp/)を参考にSAML SP編集画面へ遷移します。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/517150757a6c63145d9682b3234d2bd4.png)
**2. SPの設定を追加する**  
SSO SAML SP編集画面で下記を入力し、[追加する]をクリックします。
- ログインSAML SP Name: お好きな名前
- エンティティID:半角英数字でお好きなID
- 有効:チェックを外す
- (API用) Grantトークン生成:チェックする
- 自動ユーザ登録：チェックする
- Allow IDP Initiated Flow:チェックする

![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/c1fbe8baf6bf4989d91ce7e5a2db68b6.png)
SSO SAML SP一覧画面に、作成したSP設定が追加されます。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/892362fa51a2d07bc220b342048625cb.png)
**3. SPの設定を確認する**  
SSO SAML SP一覧画面より、先ほど追加したSP設定の「ログインSAML SP Name」をクリックします。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/6b8864ddd7e39fc90c632eb85c5445b2.png)
編集画面より「ログインSAML SP ACS URI」「エンティティID」を確認し、コピーしておきます。  
次のGoogle Workspaceの管理画面の設定で利用します。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/d02711d523ed777518d27be97a78eaf9.png)
## Google Workspaceの管理画面の設定
次に、[Google Workspaceの管理画面](https://admin.google.com/)からSAML連携を設定します。    

:::caution
以下の作業は必ずGoogle Workspaceの管理者の権限でログインをお願いします。
:::

:::caution
Googleの仕様によりキャプチャの内容が変わる可能性もございます。
:::

**1. Google Workspaceの管理画面からAppsの設定画面へ遷移する**  
管理画面より[アプリ]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/90b66ea97ea86e95da3269f110116c84.png)
**2. SAML appsの設定画面へ遷移する**  
アプリ一覧画面より、[SAML アプリ]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/84ce9ddfe575a684a15fcfe3f6bdddf3.png)
**3. SAML appsを追加する**  
[アプリを追加]->[カスタム SAML アプリの追加]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/a95d4fc7cde1a6c28d02d03cdfce9b06.png)
**4. カスタムアプリを作成する**  
下記２点を設定し、[続行]をクリックします。
- アプリ名
- アプリのアイコン
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/76dddd2934dc2183c30cdcfcad8d4c09.png)
**5. IdP情報をダウンロードする**  
[メタデータをダウンロード]をクリックし、IdPメタデータをダウンロードします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/107219819f8e2f6140d2133f17fe6f5a.png)
ダウンロードしたら[続行]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/310a03e842dd4d9e544e8aa693e2986c.png)
**6. サービス プロバイダの情報を入力する**  
下記内容を入力します。 

- ACSのURL: Kurocoの管理画面で確認した「ログインSAML SP ACS URI」   
- エンティティID: Kurocoの管理画面で確認した「エンティティID」  
- 開始URL: / など、ログイン後のページURL  
- 署名付き応答： チェックを入れる  
- 名前IDの形式: 「EMAIL」を選択する
- 名前ID: 「Basic Information > Primary Email」を選択する

![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/7b25f73d4889b86308675f183279941a.png)
入力したら[続行]をクリックします。

**7. マッピング情報を設定する**  
[マッピングを追加]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/56747b7f6a97156dc219ebaa79a5c142.png)
下記内容を設定します。  
- Basic Information / Last name：name1
- Basic Information / First name：name2

![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/5b4f335df4cf5238aa4692fd0319624e.png)
設定したら[完了]をクリックします。  

カスタムSAMLアプリが追加されました。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/96182f4a75fca266668b26e089133ae2.png?witdh=600)
**8. ユーザーアクセスをオンにする**  
初期設定ではユーザーアクセスが「オフ」になっているので、「オン」に変更します。  
[ユーザーアクセス]の下矢印をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/a618d32005aad696b1b0d1c35655becc.png)

サービスのステータスで「オン」にチェックを入れ、[保存]をクリックします。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/d452f6c83eb9007ca037c2fa3143af6c.png)
以上でGoogle Workspaceの設定が完了です。

## Kurucoの管理画面でSP設定にIdP情報を設定する 
Kuroco管理画面に移動し、[SSO SAML SP編集](/ja/docs/management/sso-saml-sp/)を参考にSAML SP編集画面へ遷移します。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/6b8864ddd7e39fc90c632eb85c5445b2.png)
[2-5. IdP情報をダウンロードする]でダウンロードしたIdP情報のXMLファイルをアップロードし、有効にチェックを入れます。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/db00c38e86343a2e5f6e6cedd525766e.png)
設定完了後、[更新する]ボタンをクリックしたら設定は完了です。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/c23b583df339349232fb78dc1f03a3a4.png)
## 利用方法 
作成したSAML SP画面を確認します。  
SSO SAML SP一覧画面より、先ほど追加したSP設定の「ログインSAML SP Name」をクリックします。  
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/28ecf71b9d9da226c4fef71134084d86.png)
「ログインSAML SP ACS URI」が確認できます。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/91c0fb64db5e5d6c2a34cef25a11bc6b.png)
アクセスすると、Google ログイン画面に遷移します。
![Image (fetched from Gyazo)](https://t.gyazo.com/teams/diverta/d4afc2bf385a0db7cbd8757b9d919080.png)
こちらでSAMLログインができるようになります。