Webex Control HubとGoogle WorkspaceのSSO連携を設定してみた。

# :moon: はじめに
この記事は Cisco Systems Japan の有志による Advent Calendar 2024 の 2枚目の18日目として投稿しています。 こんにちは！ ソリューションズエンジニア（コラボレーション）の清水です。本日の記事は、Webex Control HubとGoogle WorkspaceのSSO連携について、実際に設定して動作確認をしましたので、その内容をご紹介いたします。

# :moon: 背景
今年はGoogle Workspaceとの連携について、いろいろとお話する機会が多かったです。Google Workspaceとシスコデバイス(Cisco Desk、Roomシリーズ)の連携により、たとえば、リソースカレンダーの予定が自動的にシスコデバイスと同期され、ワンタッチでGoogle Meetの会議参加できたり、リアルタイムで会議室の外から、利用状況が備え付けのディスプレイに表示されたりと、GoogleとWebexを連携すると、より便利な機能がいろいろと利用できます。そういった中、今回はWebex Control Hubのユーザ認証をSSO化したく、かつ、それをGoogle WorkspaceのSSO連携機能で実現したいと思い、実践してみましたので、その内容をこの記事で紹介したいと思います。

## :moon:  Webex Control Hubとは？
本題へ入る前に、Webex Control Hubについて簡単にご説明しますと、Webexの統合管理プラットフォームで、ご利用になるWebexサービス全体の設定や管理を一元化することができます。Webexの管理者は、ユーザーの追加や削除、セキュリティポリシーの適用、分析データの確認などを直感的なインターフェースで効率的に行えます。今回はこのWebex Control HubとGoogle WorspaceをSSO連携についてのお話です。

それでは、Webex Control HubとGoogle WorkspaceのSSO設定を紹介していきます。

## :moon: Webex Control Hub と Google WorkspaceのSSO設定手順のサマリー

:zero:前提条件の確認
Webex Control Hubの管理者アクセス権限とGoogle Workspaceの管理者権限が必要です。

:one:メタデータをダウンロード
Webex Control HubとGoogole Workspaceそれぞれのメタデータをダウンロードします。

:two:Google Workspace側の設定
Googleの管理者サイト(管理コンソール)にログインし、「アプリ」セクションから「ウェブアプリとモバイルアプリ」メニューからカスタムSAMLアプリを追加、メタデータ情報をもとに各パラメータを設定し、Webex Control Hub向けのSSO設定を構成します。

:three:Webex Control Hub側の設定
Webexの管理者サイト(コントロールハブ)にログインし、「設定」から「認証」を選択します。「シングルサインオンの設定」を選択、メタデータをアップロード後、各パラメータを設定し、SSO設定を有効化します。

### :moon: Webex側メタデータダウンロードまでの手順
ここから手順詳細はガイドに沿って設定します。下記ページもあわせてご参照ください。
[Google アプリと統合された Control Hub でシングル サインオンを設定する](https://help.webex.com/ja-jp/article/brd76f/)

Webex Control Hub側の設定です。手順に沿って、メタデータをダウンロードします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/c85c10a0-0679-1748-6c38-977ad1588856.png)

SSOを有効化
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/13e021e9-3b75-1c25-9576-5101aaf87d44.png)

SAMLを選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/49d73ccb-19b6-7128-2266-480c76d71f79.png)

Ciscoによる自己署名を選択
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/52dbb558-ac9e-2adf-2f82-85519b730a2c.png)

メタデータのダウンロードをクリックして、メタデータをダウンロードします。
後程、テキストエディタで、メタデータファイルを開き、必要なパラメータを確認します。

### :moon: Google Wrokspace側メタデータダウンロードまでの手順
Google Workspace側の設定です。手順に沿って同様にメタデータをダウンロードします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/8eee28a2-6d53-5647-ff52-13d29156435a.png)

管理コンソールにアクセス、
ウェブアプリとモバイルアプリメニューからカスタムSAMLアプリの追加
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/15114581-067e-d2de-77a4-3909ae064745.png)

アプリに名前や説明の項目を入力し、次へ進みます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/793f0982-371d-aebb-60f6-2f56fe01e6f1.png)

メタデータのダウンロードをクリックし、メタデータのダウンロード後、次へ進みます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/99ba89b1-76ef-8f0a-647e-deb8576921db.png)

サービスプロバイダの詳細設定にて、
ACSのURL、エンティティIDを入力します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/361f88e3-b313-1cf7-ddab-35db77b3245c.png)

こちらの２つのパラメータは、Webexのメタデータファイルをテキストエディタで開き、各パラメータを確認します。下記の添付イメージの朱色で囲んでいるところ(Entity ID、ACSのURL)をご参照ください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/aa0434c8-6c40-c4fc-c595-2e4c2a0b80c0.png)

:::note info
AssertionConsumerService の Webex メタデータ ファイルを検索し、[Location] キーワードに続く URL をコピーして、[サービス プロバイダーの詳細] ページの ACS URL フィールドに貼り付けます。
:::

:::note info
entityID の Webex メタデータ ファイルを検索し、[サービス プロバイダーの詳細] ページの [Entity ID] フィールドに続く URL をコピーします。
:::

ACS URLフィールド、Entity IDフィールドの入力を完成させて、次へをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/748d3753-a361-4883-a62b-734cacedafd1.png)

属性マッピングはそのままで完了します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/f0585e2a-b38c-027d-02e1-bcaf00904645.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/5bcd63f9-60ff-8d53-a904-0e712d8e0caa.png)
設定は上記で完了ですが、サービスのステータスがデフォルトでオフ（すべてのユーザー）になっていると思いますので、こちらをオン（すべてのユーザー)に変更します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/7abe0eb0-586a-27ba-3f5b-f1de0ffad099.png)
こちらでGoogle Workspace側の設定は完了です。Webex Control Hub側の設定に戻ります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/f8efaf53-7e4f-9033-d07d-5630e1614651.png)

メタデータのところから、手順を進めます。
Google Workspaceの手順でダウンロードしたメタデータをアップロードし、次へ進みます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/b00776ce-811e-6dc8-b67b-9a427790940a.png)

特にマッピング、属性、変更せずに、次へ進みます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/b6954010-51ac-3a0c-acc8-0f27a232a6a7.png)

SSOの認証テストを行います。
成功しましたら、そのまま手順を進めて、アクティベートします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/2fcce727-4142-5c92-5180-903ecea45a0f.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/40f1b5ff-e5a9-f4c6-ff40-df13c22d4b7b.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/c03a9103-2169-4a09-c623-5dc5bc34584f.png)

こちらでWebex Control HubとGoogle WorkspaceのSSO連携の設定は完了です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/969833/9f9574e5-3a5d-4684-bab4-0d9db72449cb.png)

# :moon: さいごに
最後まで読んでいただきましてありがとうございました。今回はWebex Control HubとGoogle WorkspaceのSSO連携設定をご紹介しましたが、Control Hubとその他のシステムとのSSO連携設定については下記URLにガイドありますので、ご興味を持っていただけましたら、あわせてご参照いただけたら、幸いです。
[Control Hub のシングル サインオン インテグレーション](https://help.webex.com/ja-jp/article/lfu88u/)

それでは、みなさまもお体に気をつけて、楽しいクリスマスをお過ごしください。:santa: :gift:

# 免責事項
本サイトおよび対応するコメントにおいて表明される意見は、投稿者本人の個人的意見であり、シスコの意見ではありません。本サイトの内容は、情報の提供のみを目的として掲載されており、シスコや他の関係者による推奨や表明を目的としたものではありません。各利用者は、本Webサイトへの掲載により、投稿、リンクその他の方法でアップロードした全ての情報の内容に対して全責任を負い、本Web サイトの利用に関するあらゆる責任からシスコを免責することに同意したものとします。