Share via

Atualizar o manifesto do aplicativo para SSO e aplicativo de visualização

  • Artigo

Antes de atualizar o manifesto do aplicativo (anteriormente chamado de manifesto do aplicativo teams), verifique se o código do aplicativo de guia está configurado para habilitar o SSO (logon único).

Configurar código

Você registrou seu aplicativo de guia em Microsoft Entra ID e obteve uma ID do aplicativo. Você também configurou seu código para chamar getAuthToken() e manipular o token de acesso. Agora, você deve atualizar o manifesto do aplicativo para habilitar o SSO para seu aplicativo de guias. O manifesto do aplicativo descreve como um aplicativo se integra ao Teams.

propriedade webApplicationInfo

Configure a webApplicationInfo propriedade no arquivo de manifesto do aplicativo. Essa propriedade habilita o SSO para seu aplicativo para ajudar os usuários do aplicativo a acessar seu aplicativo guia diretamente.

  A captura de tela mostra a configuração do manifesto do aplicativo.

webApplicationInfo tem dois elementos, id e resource.

Elemento Descrição
id Insira a ID do aplicativo (GUID) que você criou no Microsoft Entra ID.
recurso Insira o URI de subdomínio do aplicativo e o URI de ID do aplicativo que você criou em Microsoft Entra ID ao criar escopo. Você pode copiá-lo da seção ID> Microsoft EntraExpor uma API.

Observação

Use o manifesto do aplicativo versão 1.5 ou posterior para implementar a webApplicationInfo propriedade.

O URI de ID do aplicativo que você registrou no Microsoft Entra ID está configurado com o escopo da API que você expôs. Configure o URI resource de subdomínio do aplicativo para garantir que a solicitação de autenticação usada getAuthToken() seja do domínio fornecido no manifesto do aplicativo.

Para obter mais informações, consulte webApplicationInfo.

Para configurar o manifesto do aplicativo

  1. Abra o projeto de aplicativo guia.

  2. Abra a pasta manifesto do aplicativo.

    Observação

  3. Abrir o manifest.json arquivo

  4. Adicione o seguinte snippet de código ao arquivo de manifesto do aplicativo para adicionar a nova propriedade:

    "webApplicationInfo":
{
"id": "{Microsoft Entra AppId}",
"resource": "api://subdomain.example.com/{Microsoft Entra AppId}"
}

    Em que:

    • {Microsoft Entra AppId}é a ID do aplicativo que você criou quando registrou seu aplicativo em Microsoft Entra ID. É o GUID.
    • subdomain.example.comé o URI de ID do aplicativo que você registrou ao criar escopo em Microsoft Entra ID.

  5. Atualize a ID do aplicativo de Microsoft Entra ID na propriedade id.

  6. Atualize a URL do subdomínio nas seguintes propriedades:

    1. contentUrl
    2. configurationUrl
    3. validDomains

  7. Salve o arquivo de manifesto do aplicativo. Para obter mais informações, consulte o manifesto do aplicativo.


Aqui está um exemplo do manifesto do aplicativo atualizado 
{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json",
  "manifestVersion": "1.11",
  "version": "1.0.0",
  "id": "bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c",
  "developer": {
    "name": "Microsoft",
    "websiteUrl": "https://www.microsoft.com",
    "privacyUrl": "https://www.microsoft.com/privacy",
    "termsOfUseUrl": "https://www.microsoft.com/termsofuse"
  },
  "name": {
    "short": "Teams Auth SSO",
    "full": "Teams Auth SSO"
  },
  "description": {
    "short": "Teams Auth SSO app",
    "full": "The Teams Auth SSO app"
  },
  "icons": {
    "outline": "outline.png",
    "color": "color.png"
  },
  "accentColor": "#60A18E",
  "staticTabs": [
    {
      "entityId": "auth",
      "name": "Auth",
      "contentUrl": "https://contoso.com/Home/Index",
      "scopes": [ "personal" ]
    }
  ],
  "configurableTabs": [
    {
      "configurationUrl": "https://contoso.com/Home/Configure",
      "canUpdateConfiguration": true,
      "scopes": [
        "team"
      ]
    }
  ],
  "permissions": [ "identity", "messageTeamMembers" ],
  "validDomains": [
    "contoso.com"
  ],
  "webApplicationInfo": {
    "id": "bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c",
    "resource": "api://contoso.com/bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c"
  }
}

Observação

Durante a depuração, você pode usar o ngrok para testar seu aplicativo em Microsoft Entra ID. Nesse caso, você precisa substituir o subdomínio pela api://subdomain.example.com/00000000-0000-0000-0000-000000000000 URL ngrok. Você precisará atualizar a URL sempre que o subdomínio ngrok for alterado. Por exemplo, api://23c3-103-50-148-128.ngrok.io/bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c.

Carregar um aplicativo personalizado e visualizar no Teams

Você configurou o aplicativo de guia para habilitar o SSO no Microsoft Entra ID, no código do aplicativo e no arquivo de manifesto do aplicativo. Agora você pode carregar seu aplicativo de guia personalizado no Teams e visualiza-lo no ambiente do Teams.

Aplicativo SSO

Para visualizar seu aplicativo guia no Teams:

  1. Crie um pacote de aplicativos.

    O pacote do aplicativo é um arquivo zip que contém o arquivo de manifesto do aplicativo e os ícones do aplicativo.

  2. Abra o Teams.

  3. Selecione Aplicativos>Gerencie seus aplicativos>Carregue um aplicativo.

    As opções para carregar um aplicativo são exibidas.

  4. Selecione Carregar um aplicativo personalizado para carregar o aplicativo de guia personalizado no Teams.

  5. Selecione o arquivo zip do pacote do aplicativo e selecione Adicionar.

    Seu aplicativo de guia personalizado é carregado e a caixa de diálogo aparece para informá-lo das permissões adicionais que podem ser necessárias.

  6. Selecione Continuar.

    Caixa de diálogo do Teams informando sobre permissões adicionais necessárias

    A caixa de diálogo de consentimento Microsoft Entra é exibida.

  7. Selecione Aceitar para dar consentimento para escopos de open-id.

    caixa de diálogo de consentimento Microsoft Entra

    O Teams abre o aplicativo guia e você pode usá-lo.

    Exemplo do aplicativo guia do Teams com o SSO habilitado

    Parabéns! Você habilitou o SSO para seu aplicativo guia.

Confira também