Compartir a través de

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

  • Artículo

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.

  Captura de pantalla que muestra la configuración del manifiesto de la aplicación.

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 del identificador de aplicación que creó en Microsoft Entra id. al crear el ámbito. Puede copiarlo desde la secciónExponer una API del identificador> de Microsoft Entra.

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:

  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ó al registrar la aplicación en Microsoft Entra id. Es el GUID.
    • subdomain.example.comes 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 identificador. 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.

Aplicación de inicio de sesión único

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.

    Cuadro de diálogo de Teams que informa sobre los permisos adicionales necesarios

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

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

    cuadro de diálogo de consentimiento de Microsoft Entra

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

    Ejemplo de aplicación de pestañas de Teams con SSO habilitado

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

Consulte también