Actualizar el manifiesto de la aplicación para el SSO y versión preliminar de la aplicación

Antes de actualizar el manifiesto de la aplicación (anteriormente denominado manifiesto de aplicación de Teams), asegúrese de que el código de la aplicación de pestaña está configurado para habilitar el inicio de sesión único (SSO).

Configuración del código

Ha registrado la aplicación de pestaña en Microsoft Entra ID y ha obtenido un identificador de aplicación. También ha configurado el código para llamar a getAuthToken() y controlar el token de acceso. Ahora, debe actualizar el manifiesto de la aplicación para habilitar el inicio de sesión único para la aplicación de pestaña. El manifiesto de la aplicación describe cómo se integra una aplicación en Teams.

propiedad webApplicationInfo

Configure la webApplicationInfo propiedad en el archivo de manifiesto de la aplicación. Esta propiedad permite que el inicio de sesión único de la aplicación ayude a los usuarios de esta a acceder sin problemas a la aplicación de pestañas.

  

webApplicationInfo tiene dos elementos: id y resource.

Elemento	Descripción
id	Escriba el identificador de aplicación (GUID) que creó en Microsoft Entra ID.
resource	Escriba el URI del subdominio de la aplicación y el URI de identificador de aplicación que creó en Microsoft Entra ID al crear el ámbito. Puede copiarlo desde la sección Microsoft Entra ID>Expose an API (Exponer una API ).

Nota:

Use la versión 1.5 o posterior del manifiesto de la aplicación para implementar la webApplicationInfo propiedad .

El URI del identificador de aplicación que registró en Microsoft Entra ID se configura con el ámbito de la API que ha expuesto. Configure el URI de subdominio de la aplicación en resource para asegurarse de que la solicitud de autenticación que usa getAuthToken() procede del dominio especificado en el manifiesto de la aplicación.

Para obtener más información, consulte webApplicationInfo.

Para configurar el manifiesto de aplicación

1. Abra el proyecto de la aplicación de pestañas.

2. Abra la carpeta del manifiesto de la aplicación.

   Nota:

   • La carpeta del manifiesto de la aplicación debe estar en la raíz del proyecto. Para obtener más información, consulte Crear un paquete de la aplicación Microsoft Teams.
   • Para obtener más información sobre cómo crear un manifest.json, consulte el esquema de manifiesto de la aplicación.

3. Abrir el manifest.json archivo

4. Agregue el siguiente fragmento de código al archivo de manifiesto de la aplicación para agregar la nueva propiedad:

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

   donde,

   • {Microsoft Entra AppId} es el identificador de aplicación que creó cuando registró la aplicación en Microsoft Entra ID. Es el GUID.
   • subdomain.example.com es el URI del identificador de aplicación que registró al crear el ámbito en Microsoft Entra ID.

5. Actualice el identificador de la aplicación desde Microsoft Entra ID en la propiedad id .

6. Actualice la URL del subdominio en las propiedades siguientes:

   1. contentUrl
   2. configurationUrl
   3. validDomains

7. Guarde el archivo de manifiesto de la aplicación. Para obtener más información, vea manifiesto de aplicación.

Este es un ejemplo del manifiesto de aplicación actualizado

{
  "$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"
  }
}

Nota:

Durante la depuración, puede usar ngrok para probar la aplicación en Microsoft Entra ID. En ese caso, debe reemplazar el subdominio en api://subdomain.example.com/00000000-0000-0000-0000-000000000000 por la dirección URL de ngrok. Deberá actualizar la dirección URL cada vez que cambie el subdominio ngrok. Por ejemplo, api://23c3-103-50-148-128.ngrok.io/bccfbe67-e08b-4ec1-a7fd-e0aaf41a097c.

Carga de una aplicación personalizada y versión preliminar en Teams

Ha configurado la aplicación de pestaña para habilitar el inicio de sesión único en Microsoft Entra ID, en el código de la aplicación y en el archivo de manifiesto de la aplicación. Ahora puede cargar la aplicación de pestaña personalizada en Teams y obtener una vista previa de ella en el entorno de Teams.

Para obtener una vista previa de la aplicación de pestañas en Teams:

1. Cree un paquete de aplicación de Microsoft Teams

   El paquete de aplicación es un archivo ZIP que contiene un archivo de manifiesto e iconos de aplicación.

2. Abra Teams.

3. Seleccione Aplicaciones>Administrar las aplicaciones>Cargar una aplicación.

   Aparecen las opciones para cargar una aplicación.

4. Seleccione Cargar una aplicación personalizada para cargar la aplicación de pestaña personalizada en Teams.

5. Seleccione el archivo ZIP del paquete de aplicación y, a continuación, seleccione Agregar.

   La aplicación de pestaña personalizada se carga y aparece el cuadro de diálogo para informarle de los permisos adicionales que podrían ser necesarios.

6. Seleccione Continuar.

   

   Aparece el cuadro de diálogo Consentimiento de Microsoft Entra.

7. Seleccione Aceptar para dar su consentimiento para los ámbitos de open-id.

   

   Teams abre la aplicación de pestañas y puede usarla.

   

   ¡Enhorabuena! Ha habilitado el inicio de sesión único para la aplicación de pestañas.

Consulte también

• Esquema del manifiesto de la aplicación
• Formato de esquema de manifiesto de aplicación
• Crear un paquete de aplicación de Microsoft Teams