Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Kit de herramientas para agentes de Microsoft 365 (anteriormente conocido como Kit de herramientas de Teams) ahora administra la aplicación Microsoft Entra con el archivo de manifiesto de la aplicación como fuente de confianza durante el ciclo de vida de desarrollo de aplicaciones de Microsoft Teams.
Personalizar plantilla de manifiesto de Microsoft Entra
Puede personalizar la plantilla de manifiesto de Microsoft Entra para actualizar la aplicación de Microsoft Entra.
Abrir
aad.template.jsonen el proyecto.
Actualice la plantilla directamente o haga referencia a valores de otro archivo. Estos son los escenarios de personalización:
Agregar un permiso de aplicación
Si la aplicación de Teams requiere más permisos para llamar a una API con permisos adicionales, deberá actualizar
requiredResourceAccessla propiedad en la plantilla de manifiesto de Microsoft Entra. Puede ver el siguiente ejemplo de esta propiedad:"requiredResourceAccess": [ { "resourceAppId": "Microsoft Graph", "resourceAccess": [ { "id": "User.Read", // For Microsoft Graph API, you can also use uuid for permission id "type": "Scope" // Scope is for delegated permission }, { "id": "User.Export.All", "type": "Role" // Role is for application permission } ] }, { "resourceAppId": "Office 365 SharePoint Online", "resourceAccess": [ { "id": "AllSites.Read", "type": "Scope" } ] } ]En la lista siguiente se proporcionan diferentes identificadores de propiedad y su uso:
La
resourceAppIdpropiedad se usa para diferentes API. ParaMicrosoft GraphyOffice 365 SharePoint Online, escriba el nombre directamente en lugar del UUID, y para otras API use UUID.La
resourceAccess.idpropiedad se usa para diferentes permisos. ParaMicrosoft GraphyOffice 365 SharePoint Online, escriba el nombre del permiso directamente en lugar del UUID, y para otras API use UUID.La
resourceAccess.typepropiedad se usa para permisos delegados o permisos de aplicación.Scopesignifica permiso delegado yRolesignifica permiso de aplicación.
Autorización previa de una aplicación cliente
Puede utilizar
preAuthorizedApplicationsuna propiedad para autorizar una aplicación cliente para indicar que la API confía en la aplicación. Los usuarios no dan su consentimiento cuando el cliente llama a la API expuesta. Puede ver el siguiente ejemplo de esta propiedad:"api": { ... "preAuthorizedApplications": [ { "appId": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", "delegatedPermissionIds": [ "${{AAD_APP_ACCESS_AS_USER_PERMISSION_ID}}" ] } ] ... }preAuthorizedApplications.appIdpropiedad que se utiliza para la aplicación que desea autorizar. Si no conoce el identificador de la aplicación y solo conoce el nombre de la aplicación, siga estos pasos para buscar el identificador de aplicación:Vaya a Azure Portal y abra Registros de aplicaciones.
Seleccione Todas las aplicaciones y busque el nombre de la aplicación.
Seleccione el nombre de la aplicación y obtenga el id. de la aplicación en la página de información general.
Actualizar la dirección URL de redirección para la respuesta de autenticación
Las direcciones URL de redireccionamiento se usan cuando devuelven respuestas de autenticación, como tokens después de una autenticación correcta. Puedes personalizar las URL de redireccionamiento mediante la propiedad
redirectUrisdentrowebde ,spa,publicClient. Por ejemplo, para agregarlahttps://www.examples.com/auth-end.htmlcomo dirección URL de redireccionamiento, puede agregarla como ejemplo siguiente:"publicClient": { "redirectUris": [ "https://www.examples.com/auth-end.html" ] }, "web": { "redirectUris": [ "https://www.examples.com/auth-end.html" ], "implicitGrantSettings": {} }, "spa": { "redirectUris": [ "https://www.examples.com/auth-end.html", ] }Actualice los cambios de aplicación de Microsoft Entra para el entorno local o remoto.
Selecciona
PreviewCodeLens enaad.template.json.
Seleccione el entorno local o de desarrollo .
Selecciona
Deploy Azure AD ManifestCodeLens enaad.local.jsonoaad.dev.json.Se implementan los cambios para la aplicación Microsoft Entra utilizada en el entorno local o de desarrollo.
Además, puede abrir la paleta de comandos y seleccionar Teams: Actualizar aplicación Microsoft Entra para actualizar la aplicación Microsoft Entra.
Marcadores de posición de plantilla de manifiesto de Microsoft Entra
El archivo de manifiesto de Microsoft Entra contiene argumentos de marcador de posición con {{...}} se reemplaza durante la compilación para diferentes entornos. Puede hacer referencia a variables de entorno con los argumentos de marcador de posición.
Variable de entorno de referencia en la plantilla de manifiesto de Microsoft Entra
No es necesario escribir valores permanentes en la plantilla de manifiesto de Microsoft Entra y el archivo de plantilla de manifiesto de Microsoft Entra admite valores variables de entorno de referencia. Puede utilizar la sintaxis ${{YOUR_ENV_VARIABLE_NAME}} de la herramienta como valores de parámetro para resolver los valores de variables de entorno.
Editar y obtener una vista previa del manifiesto de Microsoft Entra con CodeLens
El archivo de plantilla de manifiesto de Microsoft Entra tiene CodeLens para revisar y editar el código.
Archivo de plantilla de manifiesto de Microsoft Entra
Hay una vista previa de CodeLens al principio del archivo de plantilla de manifiesto de Microsoft Entra. Seleccione CodeLens para generar un manifiesto de Microsoft Entra basado en su entorno.
Argumento de marcador de posición CodeLens
Argumento de marcador de posición CodeLens le ayuda a ver los valores de la depuración local y a desarrollar su entorno. Si mueve el mouse sobre el argumento de marcador de posición, se muestra el cuadro de información sobre herramientas para los valores de todos los entornos.
Acceso necesario a recursos CodeLens
La plantilla de manifiesto de Microsoft Entra en Agents Toolkit también admite cadenas legibles por el usuario para Microsoft Graph permisos y Office 365 SharePoint Online permisos. El esquema de manifiesto oficial de Microsoft Entra, que es la resourceAppId propiedad and resourceAccess inrequiredResourceAccess, solo admite el UUID. Si introduces el UUID, CodeLens muestra cadenas legibles por el usuario; de lo contrario, muestra el UUID.
Aplicaciones autorizadas previamente CodeLens
CodeLens muestra el nombre de la aplicación para el id. de aplicación preautorizado para la propiedad dentro de la preAuthorizedApplications propiedad api.
Ver la aplicación Microsoft Entra en el Azure Portal
Copie el identificador de cliente de la aplicación Microsoft Entra desde
.env.xxxel archivo () de laAAD_APP_CLIENT_IDpropiedad.Nota:
xxx en el id. de cliente indica el nombre del entorno en el que ha implementado la aplicación Microsoft Entra.
Vaya a Azure Portal e inicie sesión en la cuenta de Microsoft 365.
Nota:
Asegúrese de que las credenciales de inicio de sesión de la aplicación Teams y la cuenta de M365 sean las mismas.
Abra la página Registros de aplicaciones y busque la aplicación de Microsoft Entra con el id. de cliente que copió anteriormente.
Seleccione la aplicación Microsoft Entra en el resultado de la búsqueda para ver la información detallada.
En la página de información de la aplicación Microsoft Entra, seleccione el menú Manifiesto para ver el manifiesto de esta aplicación. El esquema del manifiesto es el mismo que el del
aad.template.jsonarchivo. Para más información sobre el manifiesto, consulte Manifiesto de la aplicación Microsoft Entra.
Puede seleccionar Otro menú para ver o configurar la aplicación Microsoft Entra a través de su portal.
Utilizar una aplicación de Microsoft Entra existente
Puede utilizar la aplicación de Microsoft Entra existente para el proyecto de Teams. Para obtener más información, consulte usar una aplicación de Microsoft Entra existente para su aplicación de Teams.
Aplicación de Microsoft Entra en Teams ciclo de vida de desarrollo de aplicaciones
Debe interactuar con la aplicación Microsoft Entra durante varias etapas del ciclo de vida de desarrollo de aplicaciones de Teams.
Para crear un proyecto
Puedes crear un proyecto con Agents Toolkit que incluya la compatibilidad con el inicio de sesión único (SSO) de forma predeterminada, como
SSO-enabled tab. Para obtener más información sobre cómo crear una nueva aplicación, consulte Crear una nueva aplicación de Teams con el Kit de herramientas de agentes. Se crea automáticamente un archivo de manifiesto de Microsoft Entra enaad.template.json. Kit de herramientas de agentes crea o actualiza la aplicación Microsoft Entra durante el desarrollo local o mientras mueve la aplicación a la nube.Para agregar el SSO al bot o a la pestaña
Después de crear una aplicación de Teams sin SSO integrado, Kit de herramientas de agentes le ayuda progresivamente a agregar SSO para el proyecto. Como resultado, se crea automáticamente un archivo de manifiesto de Microsoft Entra en
aad.template.jsonformatoKit de herramientas de agentes crea o actualiza la aplicación Microsoft Entra durante la siguiente sesión de desarrollo local o mientras mueve la aplicación a la nube.
Para compilar localmente
El Kit de herramientas de agentes realiza las siguientes funciones durante el desarrollo local:
Lea el
.env.localarchivo para buscar una aplicación de Microsoft Entra existente. Si ya existe una aplicación de Microsoft Entra, Kit de herramientas de agentes reutiliza la aplicación de Microsoft Entra existente. En caso contrario, deberá crear una nueva aplicación con elaad.template.jsonarchivo.Inicialmente omite algunas propiedades del archivo de manifiesto que requieren más contexto, como
redirectUrisla propiedad que requiere un punto de conexión de desarrollo local durante la creación de una nueva aplicación de Microsoft Entra con el archivo de manifiesto.Una vez que el entorno de desarrollo local se inicia correctamente, el , y otras propiedades de la aplicación Microsoft Entra y otras propiedades que no están disponibles durante la fase de
identifierUrisredirectUriscreación se actualizan en consecuencia.Los cambios realizados en la aplicación de Microsoft Entra se cargarán durante la siguiente sesión de desarrollo local. Puede ver los cambios de la aplicación Microsoft Entra aplicados manualmente.
Para aprovisionar recursos en la nube
Debe aprovisionar recursos en la nube e implementar la aplicación mientras la mueve a la nube. En fases, como la depuración local, Kit de herramientas de agentes:
Lee el
.env.{env}archivo para buscar una aplicación de Microsoft Entra existente. Si ya existe una aplicación de Microsoft Entra, Kit de herramientas de agentes reutiliza la aplicación de Microsoft Entra existente. En caso contrario, deberá crear una nueva aplicación con elaad.template.jsonarchivo.Inicialmente omite algunas propiedades del archivo de manifiesto que requieren más contexto, como
redirectUrispropiedad. Esta propiedad requiere un punto de conexión de front-end o bot durante la creación de una nueva aplicación Microsoft Entra con el archivo de manifiesto.Completa el aprovisionamiento de otros recursos, y, a continuación, la aplicación de Microsoft Entra y
redirectUrisse actualizan según los puntos deidentifierUrisconexión correctos.
Para crear una aplicación
El comando en la nube implementa la aplicación en los recursos aprovisionados. No incluye la implementación de los cambios de aplicación de Microsoft Entra que ha realizado.
Kit de herramientas de agentes actualiza la aplicación Microsoft Entra según el archivo de plantilla de manifiesto de Microsoft Entra.
Limitaciones
La extensión Agents Toolkit no admite todas las propiedades enumeradas en el esquema de manifiesto de Microsoft Entra.
En la tabla siguiente se enumeran las propiedades que no son compatibles con la extensión Agents Toolkit:
Propiedades no admitidas Motivo passwordCredentialsNo se permiten en el manifiesto createdDateTimeSolo lectura y no se puede cambiar logoUrlSolo lectura y no se puede cambiar publisherDomainSolo lectura y no se puede cambiar La
requiredResourceAccesspropiedad se usa para cadenas de nombre de aplicación o nombre de permiso de recurso legible por el usuario solo paraMicrosoft GraphyOffice 365 SharePoint OnlineAPI. Debe usar UUID para otras API. Realice los pasos siguientes para recuperar identificadores de Azure Portal:- Registro de una nueva aplicación de Microsoft Entra en Azure Portal.
- Seleccione
API permissionsen la página de la aplicación Microsoft Entra. - Seleccione
add a permissionesta opción para agregar los permisos que necesite. - Seleccione
Manifesten larequiredResourceAccesspropiedad, donde puede encontrar los identificadores de API y los permisos.