SSO 用のアプリマニフェストを更新し、アプリをプレビューする

[アーティクル]
09/30/2024

アプリマニフェスト (以前は Teams アプリマニフェスト) を更新する前に、アプリで SSO を有効にするようにコードが構成されていることを確認してください。

アプリとボットリソースをMicrosoft Entra IDに登録しました。また、トークンを処理するようにコードを構成しました。次に、アプリマニフェストを更新して、アプリの SSO を有効にする必要があります。アプリマニフェストでは、アプリを Teams に統合する方法について説明します。

webApplicationInfo プロパティ

アプリマニフェストファイルで webApplicationInfo プロパティを構成します。このプロパティを使用すると、アプリの SSO を使用して、アプリユーザーがボットアプリにシームレスにアクセスできるようになります。

webApplicationInfo には 2 つの要素があります、id および resource。

要素	説明
`id`	Microsoft Entra IDで作成したアプリ ID (GUID) を入力します。
`resource`	スコープの作成時にMicrosoft Entra IDで作成したアプリのサブドメイン URI とアプリケーション ID URI を入力します。 Microsoft Entra ID>Expose api セクションからコピーできます。

注:

webApplicationInfo プロパティを実装するには、アプリマニフェストバージョン 1.5 以降を使用します。

Microsoft Entra IDに登録したアプリケーション ID URI は、公開した API のスコープで構成されます。 resourceでアプリのサブドメイン URI を構成して、getAuthToken()を使用する認証要求がアプリマニフェストで指定されたドメインから送信されるようにします。

詳細については、「webApplicationInfo」を参照してください。

アプリマニフェストを構成するには

アプリプロジェクトを開きます。
アプリマニフェストフォルダーを開きます。
注:
- アプリマニフェストフォルダーは、プロジェクトのルートにある必要があります。詳細については、「Microsoft Teams アプリパッケージを作成する」を参照してください。
- manifest.jsonを作成する方法の詳細については、Microsoft Teams のアプリマニフェストスキーマに関するページを参照してください。
manifest.json ファイルを開きます。
次のいずれかのコードスニペットをアプリマニフェストファイルに追加して、新しいプロパティを追加します。
- アプリにスタンドアロンボットがある場合は、次のコードスニペットを追加します。
```
"webApplicationInfo": 
{
"id": "{Azure AD AppId}",
"resource": "api://botid-{Azure AD AppId}"
}
```
- アプリにボットとタブが含まれている場合は、次のコードスニペットを追加します。
```
"webApplicationInfo": 
{
"id": "{Azure AD AppId}",
"resource": "api://subdomain.example.com/botid-{Azure AD AppId}"
}
```
  ここで、
  - {Azure AD AppId}は、Microsoft Entra IDでアプリを登録したときに作成したアプリ ID です。これは GUID です。
  - subdomain.example.comは、Microsoft Entra IDでスコープを作成するときに登録したアプリケーション ID URI です。
id プロパティの Microsoft Entra ID からアプリ ID を更新します。
次のプロパティでサブドメイン URL を更新します:
1. contentUrl
2. configurationUrl
3. validDomains
アプリマニフェストファイルを保存します。詳細については、「アプリマニフェスト」を参照してください。

更新後のアプリマニフェストの例を次に示します。

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.7/MicrosoftTeams.schema.json",
  "manifestVersion": "1.7",
  "version": "1.0",
  "id": "00000000-0000-0000-0000-000000000000",
  "packageName": "com.microsoft.teams.samples.auth",
  "developer": {
    "name": "Your Name Here",
    "websiteUrl": "https://www.example.com",
    "privacyUrl": "https://www.example.com/PrivacyStatement",
    "termsOfUseUrl": "https://www.example.com/TermsOfUse"
  },
  "name": {
    "short": "Teams AuthBot"
  },
  "description": {
    "short": "Authentication sample for Microsoft Teams",
    "full": "Authentication sample for Microsoft Teams"
  },
  "icons": {
    "outline": "outline.png",
    "color": "color.png"
  },
  "accentColor": "#F3F4F6",
  "configurableTabs": [

  ],
  "staticTabs": [
    {
      "contentUrl": "https://<<BASE_URI_DOMAIN>>/tab/simple",
      "entityId": "simpleAuth",
      "name": "Simple Auth",
      "scopes": [
        "personal"
      ]
    },
    {
      "contentUrl": "https://<<BASE_URI_DOMAIN>>/tab/silent?loginHint={loginHint}&userObjectId={userObjectId}&tenantId={tid}",
      "entityId": "silentAuth",
      "name": "Silent Auth",
      "scopes": [
        "personal"
      ]
    },
    {
      "contentUrl": "https://<<BASE_URI_DOMAIN>>/tab/sso",
      "entityId": "ssoAuth",
      "name": "SSO Auth",
      "scopes": [
        "personal"
      ]
    }
  ],
  "bots": [
    {
      "botId": "<<REGISTERED_BOT_ID>>",
      "scopes": [
        "personal"
      ]
    }
  ],
  "permissions": [
    "messageTeamMembers",
    "identity"
  ],
  "validDomains": [
    "<<BASE_URI_DOMAIN>>",
    "token.botframework.com"
  ],
  "webApplicationInfo": {
      "id": "<<REGISTERED_BOT_ID>>",
      "resource": "api://<<BASE_URI_DOMAIN>>/<<REGISTERED_BOT_ID>>"
  }
}

注:

デバッグ中に、ngrok を使用してMicrosoft Entra IDでアプリをテストできます。その場合は、 api://subdomain.example.com/00000000-0000-0000-0000-000000000000 のサブドメインを ngrok URL に置き換える必要があります。 ngrok サブドメインが変更されるたびに、URL を更新する必要があります。たとえば、api://23c3-103-50-148-128.ngrok.io/bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c。

Teams でカスタムアプリとプレビューをアップロードする

SSO を有効にするようにアプリを構成しました。 Teams でカスタムアプリをアップロードし、Teams 環境でプレビューできるようになりました。

Teams でアプリをプレビューするには:

アプリパッケージを作成します。

アプリパッケージは、アプリマニフェストとアプリアイコンを含む ZIP ファイルです。
Teams を開きます。
[アプリ]>[アプリの管理]>[アプリのアップロード] を選択します。

アプリをアップロードするオプションが表示されます。
[ カスタムアプリのアップロード] を選択して、カスタムアプリを Teams にアップロードします。
アプリパッケージの ZIP ファイルを選択し、[追加] を選択します。

カスタムアプリがアップロードされます。同意ダイアログが表示され、必要なアクセス許可が通知されます。
[続行] を選択します。

Teams によってアプリが開き、それを使用できます。

おめでとうございます! ボットまたはメッセージ拡張機能アプリの SSO を有効にしました。

開発者ポータルでの SSO サポート

開発者ポータルで SSO 対応アプリをアップロードすることもできます。インポートした後に開発者ポータルで SSO サポートを有効にするには:

開発者ポータルを開きます。
[ ツール] を選択し、表示されるアプリの一覧からアプリを選択して開発者ポータルで開きます。
[構成] を選択します。

[ 構成] ページが表示されます。
Microsoft Entra IDで構成したメッセージングエンドポイントを [エンドポイントアドレス] として入力します。
[保存] を選択します。

開発者ポータルでは、アプリの SSO がサポートされるようになりました。

次の方法で共有

SSO 用のアプリマニフェストを更新し、アプリをプレビューする

webApplicationInfo プロパティ

アプリマニフェストを構成するには

Teams でカスタムアプリとプレビューをアップロードする

開発者ポータルでの SSO サポート

その他のリソース

次の方法で共有

SSO 用のアプリ マニフェストを更新し、アプリをプレビューする

webApplicationInfo プロパティ

アプリ マニフェストを構成するには

Teams でカスタム アプリとプレビューをアップロードする

開発者ポータルでの SSO サポート

その他のリソース

SSO 用のアプリマニフェストを更新し、アプリをプレビューする

アプリマニフェストを構成するには

Teams でカスタムアプリとプレビューをアップロードする