ServiceNow for Microsoft Teamsの連携方法について #2

## はじめに
この記事はServiceNowアドベントカレンダー2024の12月24日分の記事として執筆しています。
セットアップの手順は以下の記事を参照してください。

https://qiita.com/AoraNow_Yongki_Lee/items/7d950376527c3f31c14d

セットアップ手順だけでは足りない部分があり、こちらの記事で補足します。

## セットアップ手順の補足
### Teams
#### カスタムアプリをアップロード
組織全体に公開することではなく、ローカルで検証したい場合、カスタムアプリをアップロードします。
自分以外のユーザにはアプリが公開されません。
①アプリを管理 ＞ アプリをアップロード ＞ カスタムアプリをアップロード
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/33a102f0-eb2b-eae6-2c3f-1f1fd7e1349a.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/d5099858-f4a5-e8d6-3b64-3da7a19aef02.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/c375994e-526b-0d70-eca0-8914b984b151.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/706998b5-1298-08f3-423b-939870dc2bda.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/2f9b8055-133d-22c9-d7b8-d0b79776b72f.png)
②チャットができることを確認
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/28448f64-b4be-4932-06d1-220dbd5a7378.png)
③Employee Centerにアクセスできることを確認
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/81d6da12-a0b7-8a14-734f-603f29bf7871.png)

### カスタムポータルの埋め込み
#### プロパティ設定
「Employee Center」以外のポータルにアクセスしたい場合、以下のプロパティを設定します。サービスポータルにアクセスしたい場合「sp」を設定します。
※マニフェストファイルを作成する前に設定してください。
①システムプロパティ[sys_properties]で「sn_now_teams.portal.suffix」を検索し、押下する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/0a401730-09cc-ae45-d1d7-f1097f2938ff.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/472d2ec6-d6c5-bd92-3208-7a5b48ecbbac.png)
②アプリケーションスコープを「Microsoft Integrations - Core」に設定する
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/0c8aa634-f261-8552-b09f-a5de640d429d.png" width=50%></img>
③アクセスしたいポータルのsuffixを設定する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/4074fdee-bf0d-b6ff-7c39-b51b9a67973d.png)

#### カスタムヘッダー設定
ポータルのヘッダにカスタムヘッダを追加して、Teamsからアクセスできるようにする。
①HTTP応答ヘッダー[sys_response_header]でカスタムヘッダを設定する
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/6606e298-622a-defc-3c5c-b4541d298237.png" width=50%></img>
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/75f3dc31-7160-9405-17bd-7213df4cec13.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/2a3265d1-13a4-0761-e830-a093d3c192de.png)
値は以下のドキュメントから抜粋
<a href="https://www.servicenow.com/docs/ja-JP/bundle/xanadu-employee-service-management/page/product/sn-teams/task/customize-custom-portal-employee-center.html" target="_blank">カスタムポータルの埋め込み</a>
```
Frame-ancestors 'self' https://teams.microsoft.com *.office.com *.office365.com *.microsoft365.com *.cloud.microsoft
```
#### タブ名を指定する
①マニフェスト作成の際にタブ名を指定する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/860e2aa2-340a-2820-28d3-cc64b48acfc6.png)
#### カスタムポータルの確認
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/a2c88638-524e-9689-c579-6fb2cbd452aa.png)

### Microsoft Teams admin center
#### ユーザとグループ制御
一部のユーザにアプリを公開したい場合、Teamsのユーザとグループを利用して制御することができます。
①admin centerにアクセスし、Manage apps ＞ 該当アプリにアクセスする
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/1e3de139-2d61-5bff-5ba8-b4b7a1bfe0f1.png)
②タブ「Users and groups」
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/3e594372-4227-b5b0-93b3-fc32f0cc30ab.png)
③「Edit availability」を押下し、「Specific users or groups」を押下する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/53aaab38-75c2-407d-5f59-26df1f4d216e.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/a4d7ba1a-b0c4-4efd-dc0f-4a89c409b231.png)
④制御したいユーザとグループを指定する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/22583381-e1d1-e8f5-d744-8631ebbe7dcd.png)

#### アイコン配置
アプリ公開の際、アプリのアイコン配置を設定することができます。
①Setup policies ＞ Global（Org-wide default）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/34db64b9-749a-085b-ac53-1273e60c6a08.png)
②Add apps
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/5cbfd18e-05e6-32f6-8260-fc7326eb3c0b.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/670099cf-9bb1-a841-520b-c3ce001b7b2f.png)
③App barに追加し、Saveボタンを押下
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/3e9c42e4-c982-c20e-74de-461a6ea3605e.png)
④Confirmを押下
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/fa90da98-4221-f843-0d26-4e7316d1d9c6.png)
⑤設定した場所に配置されたことを確認
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/e2889542-ef54-7baa-a84e-6d75d2fc97dd.png)

### アンインストール
#### Admin center：ServiceNow for Microsoft Teamsアンインストール
Teamsにアップロードしたアプリを削除します。
①Microsoft Teams Admin Centerにアクセスして、Teams apps ＞ Manage apps ＞ Servicenow for Teamsの詳細ページを開く
https://admin.teams.microsoft.com/
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/1904fe83-876c-e164-fa9b-ffaf5d755a7e.png)
②Actions ＞ Deleteを押下
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/1a8c687c-3fae-793f-4076-f1b863ad2f41.png)
③Deleteを押下
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/96e99dbf-2104-8fd7-6a90-5ba2f72f3779.png" width=50%></img>
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/a7064d18-3ea6-153b-8ca3-0d145798d48f.png)

#### ServiceNow：ServiceNow for Microsoft Teamsアンインストール
ServiceNowにインストールしたTeamsアプリを削除します。
①ServiceNow for Microsoft Teams ＞ Azure アプリのインストール
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/ddef0535-5f67-ee8b-6fac-7cc35f78bf05.png" width=50%></img>
②Microsoft Teamsの「アンインストール」を押下
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/38e1e42b-da96-60bf-aa83-848f58599178.png)

#### インストール済みアプリの削除
「Azureアプリのインストール」でインストールした以下のアプリをテーブルで管理しています。Azure Portalで物理的にアプリを削除してもServiceNowでは認識できないため、別途削除が必要になります。
・Notifyコネクタ
・要求ベースのチャット
・SSOおよびアクティビティの通知
※[アプリの物理削除はAzure Portalで行ってください。](#azure-portalエンタープライズアプリケーションアンインストール)
①インストール済みアプリ[sn_now_azure_installed_app]でアプリを削除
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/d450d198-4a52-a946-639e-002aaa45d189.png)
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/ed98c1ea-eed0-20cf-13f6-c499d7e6a3a5.png" width=50%></img>

#### Virtual Agentのインテグレーションの解除
①対話型インターフェース ＞ チャネルと統合
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/6834743b-87a0-288b-8fde-0a36f0e54d18.png" width=50%></img>
②Channels and integrations ＞ 統合 ＞ Microsoft Teams ＞ 管理
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/c9dde3e9-7214-3d2e-baa2-52eb78766052.png)
③Now Virtual Agent ＞ ・・・ ＞ 統合を削除
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/a844c55b-fdb6-784d-076a-1d417e7f21b6.png)
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/ff56e9f3-5244-f823-eab0-80ff261f9ef2.png" width=50%></img>
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/519f65be-88d6-d5d2-9b44-107818feeb96.png)

#### Azure Portal：エンタープライズアプリケーションアンインストール
「Azureアプリのインストール」でインストールした以下のアプリを物理的に削除します。
・Notifyコネクタ
・要求ベースのチャット
・SSOおよびアクティビティの通知
https://portal.azure.com/
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/5002cf19-80eb-2793-ba18-d50dcd0d41dc.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3914791/6f5fc13e-16db-90bb-199c-3e37c66645b8.png)

## 参考資料
### カスタムポータル
[カスタムポータルの埋め込み](https://www.servicenow.com/docs/ja-JP/bundle/xanadu-employee-service-management/page/product/sn-teams/task/customize-custom-portal-employee-center.html)
→従業員センター(esc)ではなくカスタムポータルを使用する場合は、埋め込みの従業員センターをカスタムポータルで置き換えて、Microsoft Teams 内でアクセスできる。例えば、サービスポータル(sp)やナレッジポータル(kb)等のポータルへアクセスできるように設定変更ができる