Para configurar SSO para una aptitud o un asistente digital en Microsoft Teams, debe crear una aplicación de Azure AD. Esta aplicación es además de la aplicación de Azure AD que ya ha creado como parte de la configuración del canal de Microsoft Teams.

Antes de comenzar, asegúrese de tener lo siguiente:

• Una cuenta de Azure con una suscripción activa.
• El ID de aplicación de Microsoft para el bot configurado con el canal de Microsoft Teams.
• Acceso de administrador al portal de Azure.

A continuación, se muestran los pasos para crear una aplicación Azure AD para conexión única:

1. Cree un nuevo registro de aplicación.
   1. Navegue hasta https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade en el portal de Azure.
   2. Haga clic en Nuevo registro.
   3. Rellene el campo Nombre.
   4. En la sección Tipos de cuenta admitidos, seleccione el botón de radio Cuentas en cualquier directorio organizativo (cualquier directorio de Azure AD- Multi-inquilino) y cuentas personales de Microsoft (por ejemplo, Skype, Xbox).
   5. Haga clic en Registrar.

      Una vez creada la aplicación, estará en la sección Visión general. Se deben crear el ID de aplicación (cliente) y el ID de directorio (inquilino) para la aplicación.

2. Agregue una configuración de plataforma web:
   1. En la navegación izquierda, seleccione Autenticación.
   2. En Configuración de plataforma, haga clic en Agregar una plataforma y seleccione Web.
   3. Agregue un URI de redirección con el siguiente formato:

      <YOUR_Oracle-Digital-Assistant_URL>/connectors/v2/callback

   4. Haga clic en Configurar.
3. Cree un secreto de cliente:
   1. En la navegación izquierda, seleccione Certificados y secretos.
   2. Haga clic en + Nuevo secreto de cliente, rellene los campos necesarios y haga clic en Agregar.
   3. Copie el valor del secreto de cliente y almacénelo en un lugar seguro. Necesitará este valor más adelante.
4. Configure el token:
   1. En la navegación izquierda, seleccione Configuración de token.
   2. Haga clic en + Agregar reclamación opcional.
   3. Para Tipo de token, seleccione Acceso.
   4. Seleccione estas reclamaciones:
      • given_name
      • upn
      • email
   5. Haga clic en Add.
   6. Seleccione el permiso de perfil Volver en el correo electrónico de Microsoft Graph, permiso de perfil (necesario para que las reclamaciones aparezcan en el token) y haga clic en Agregar.
   7. En la navegación izquierda, seleccione Permisos de API.

      Allí puede ver que se crean tres permisos.

   8. Haga clic en + Agregar un permiso y agregue User.ReadBasic.All.

      Necesitará esto para acceder a la información del perfil.

5. Defina el URI del ID de la aplicación:
   1. En la navegación izquierda, seleccione Exponer una API.
   2. Haga clic en el campo URI de id. de aplicación.
   3. Actualice el valor con el formato:

      api://botid-<Microsoft_App_ID_for_your_bot>

      Nota
      
      Debe ser el ID de aplicación del bot, no el de la aplicación SSO.
   4. Haga clic en + Agregar un ámbito.
   5. En el panel que se abre:
      • Defina access_as_user como el nombre de Ámbito.

        La parte de dominio del nombre de ámbito que se muestra justo debajo del campo de texto debe coincidir automáticamente con el URI del ID de aplicación definido en el paso anterior, con /access_as_user agregado al final.

      • Defina ¿Quién puede conceder? en Los administradores y los usuarios.
   6. Rellene los campos para configurar las peticiones de datos de consentimiento de administrador y usuario con valores adecuados para el ámbito access_as_user.

      Estas son algunas sugerencias:

      • Título de consentimiento del administrador: Teams puede acceder al perfil del usuario.
      • Descripción del consentimiento del administrador: permite a Teams llamar a las API web de la aplicación como usuario actual.
      • Título de consentimiento del usuario: Teams puede acceder a su perfil de usuario y realizar solicitudes en su nombre.
      • Descripción del consentimiento del usuario: permite a Teams llamar a las API de esta aplicación con los mismos derechos que tiene
   7. Asegúrese de que Estado esté definido en Activado.
   8. En la sección Autorizaciones de aplicaciones cliente, haga clic en + Agregar una aplicación cliente.
   9. Introduzca los siguientes ID:
      • 1fec8e78-bce4-4aaf-ab1b-5451cc387264

        Esta es la aplicación móvil y de escritorio de Teams.

      • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346

        Esta es la aplicación web de Teams.

6. Actualice el manifiesto:
   1. En la navegación izquierda, seleccione Manifiesto.
   2. Defina "acceptMappedClaims" en true.
   3. Defina "accessTokenAcceptedVersion" en 2.
   4. Haga clic en Guardar.
7. Otorgue permisos de administración de inquilino a la aplicación Azure AD.
   1. En la navegación izquierda, seleccione Visión general.
   2. Copie el ID de aplicación (cliente), el ID de directorio (inquilino) y el URI de ID de aplicación y guárdelo en un lugar adecuado.
   3. En una ventana de explorador privada, conéctese a la cuenta de administrador de Microsoft.
      La dirección URL tiene el siguiente formato:

       https://login.microsoftonline.com/<tenant-id>/adminconsent?client_id=<client-id>

      donde sustituirá <tenant-id> por el ID de directorio (inquilino) que acaba de copiar y sustituirá <client-id> por el ID de aplicación (cliente) que acaba de copiar.
8. En el cuadro de diálogo Permisos solicitados, revise y acepte los permisos.

Actualice el bot de Microsoft con los detalles de conexión única que haya configurado:

1. Abra el bot en el portal de desarrolladores de Teams y abra el Editor de manifiestos.
2. Seleccione el separador Información básica.
3. Desplácese hasta el campo ID de aplicación (cliente) e inserte el ID de aplicación (cliente).
4. Seleccione el separador Conexión única.
5. En el URI de ID de aplicación, agregue el URI de ID de aplicación que copió anteriormente.
6. En la navegación de la izquierda, seleccione Publicar en organización.

Ahora registrará la aplicación Azure AD como servicio de autenticación en Oracle Digital Assistant.

1. En otra ventana o separador del explorador, abra Digital Assistant, amplíe Configuración en el menú de la izquierda y seleccione Servicios de autenticación.

2. Haga clic en Agregar servicio.
3. En el cuadro de diálogo Nuevo servicio de autenticación, introduzca estos valores:
   • Proveedor de identidad: plataforma de identidad de Microsoft
   • Nombre: nombre para identificar el servicio de autenticación.
   • URL de punto final de token: URL del proveedor de identidad para solicitar tokens de acceso. Utilice:

     https://login.microsoftonline.com/<Azure-Active-Directory-TenantID>/oauth2/v2.0/token

   • Punto final de autorización: URL del proveedor de identidad para la página con la que los usuarios se autentican introduciendo su nombre de usuario y contraseña. Utilice:

     https://login.microsoftonline.com/<Azure-Active-Directory-TenantID>/oauth2/v2.0/authorize

   • Id. de cliente y secreto de cliente: ID y secreto de cliente para la aplicación Azure AD (cliente OAuth) registrados. Utilice el ID y el secreto de la aplicación.
   • Ámbito: <Application(client)_ID_for_your_bot>/access_as_user
   • Reclamación del asunto: reclamación del perfil del token de acceso que se utiliza para identificar al usuario. Utilice correo electrónico.

En aptitudes que necesitan autenticación SSO, incorpore el componente OAuth 2.0 Account Link en el flujo de diálogo para manejar la autenticación a través del servicio de autenticación. En ese componente, asegúrese de definir la propiedad enableSingleSignOn en true. (Para los flujos de diálogo basados en YAML, el componente se denomina System.OAuth2AccountLink).

Para eliminar varias tarjetas, puede utilizar iteratorVariable con el elemento card en un elemento de respuesta de tipo tarjetas. A continuación, se muestra un ejemplo de uso de una tarjeta adaptable para eliminar varias tarjetas de pizza:

responseItems:
  - type: "cards"
    headerText: "Here are our pizzas you can order today:"
    cardLayout: "horizontal"
    cards:
      - title: "${pizzas.name}"
        description: "${pizzas.description}"
        imageUrl: "${pizzas.image}"
        iteratorVariable: "pizzas"
        actions:
          - label: "Order Now"
            type: "postback"
            payload:
              action: "order"
              variables:
                orderedPizza: "${pizzas.name}"
                orderedPizzaImage: "${pizzas.image}"
        channelCustomProperties:
        - channel: "msteams"
          properties:
            adaptiveCard:
              type: "AdaptiveCard"
              version: "1.0"
              fallbackText: "Adaptive card version not supported"
              body:
              - type: "TextBlock"
                text: "${pizzas.name}"
                weight: "bolder"
              - type: "TextBlock"
                text: "${pizzas.description}"
                wrap: true
              - type: "Image"
                url: "${pizzas.image}"
                horizontalAlignment: "center"
              actions:
              - type: "Action.Submit"
                title: "Order"
                data: 
                  action: "order" 
                  variables:
                    orderedPizza: "${pizzas.name}"
                    orderedPizzaImage: "${pizzas.image}"

Puede definir una tarjeta adaptable con un elemento de respuesta de texto de la siguiente manera:

responseItems:
  - type: "text"
    text: "This text is replaced with adaptive card defined in custom property"
    footerText: "Is that correct?"
    visible:
      expression: "${system.channelType=='msteams' && system.entityToResolve.value.name=='Confirmed'}"
    channelCustomProperties:
      - channel: "msteams"
        properties:
          adaptiveCard:
            type: "AdaptiveCard"
            version: '1.0'          
            fallbackText: "Adaptive card version not supported"                                             
            body:
            - type: TextBlock
              text: 'I have all information needed to create your expense. Just to verify my understanding, here is an overview of your expense:'
              wrap: true
            - type: FactSet
              facts:
              - title: Expense Type
                value: "${expense.value.Type}"
              - title: Amount
                value: "${expense.value.Amount.totalCurrency}"
              - title: Date
                value: "${expense.value.Date.date?number_to_date}"
              - title: Receipt URL
                value: "${expense.value.Receipt?has_content?then(expense.value.Receipt.url,'N/A')}"
 
            actions:
            - type: Action.ShowCard
              title: Edit
              id: edit
              card:
                type: AdaptiveCard             
                version: '1.0'
                body:
                - type: TextBlock
                  size: Medium
                  weight: Bolder
                  text: Edit Expense
                - type: TextBlock
                  text: Expense Type
                  weight: Bolder
                - type: Input.ChoiceSet
                  choices:
                  - title: Metro, bus, train
                    value: Public transport
                  - title: Taxi
                    value: Taxi
                  - title: Breakfast, lunch, dinner
                    value: dinner
                  id: Type
                  value: "${expense.value.Type!''}"
                  spacing: None
                - type: TextBlock
                  text: Amount
                  weight: Bolder
                - type: Input.Text
                  id: amount
                  spacing: None
                  value: "${expense.value.Amount?has_content?then(expense.value.Amount.totalCurrency,'')}"
                - type: TextBlock
                  text: Date
                  weight: Bolder
                - type: Input.Date
                  id: Date
                  value: "${expense.value.Date?has_content?then(expense.value.Date.date?number_to_date,'')}"
                  spacing: None
                actions:
                - type: Action.Submit
                  title: Submit
                  id: submit

También puede definir varias tarjetas adaptables en esta propiedad personalizada. Para ello, prefije la propiedad type con un guion (-) para indicar una lista YAML, en lugar de una asignación:

channelCustomProperties:
  - channel: "msteams"
    properties:
      adaptiveCard:
      - type: AdaptiveCard
        body: ...
      - type: AdaptiveCard
        body: ...

Esto puede resultar útil si necesita eliminar varias tarjetas estáticas, si bien es más habitual eliminar varias tarjetas utilizando la propiedad iteratorVariable.

Las tarjetas adaptables tienen una acción de envío (Action.Submit) que se puede usar para recopilar la entrada del usuario y enviarla a la aptitud.

La carga útil de la acción se define en la propiedad data de la acción de envío. Si desea que el componente de respuesta común realice una transición después de seleccionar el botón o definir algunas variables, puede utilizar las propiedades estándar action y variables:

actions:
- type: "Action.Submit"
  title: "Order"
  data: 
    action: "order" 
    variables:
      orderedPizza: "${pizzas.name}"
      orderedPizzaImage: "${pizzas.image}"

Si utiliza campos de entrada en la tarjeta, el nombre y el valor de estos campos se agregarán como pares clave-valor al objeto JSON data. En el ejemplo anterior, con la tarjeta Editar gasto, se incluyen tres campos para modificar el tipo de gasto, el importe y la fecha. Cuando el usuario pulsa el botón Enviar en este caso, se envía un objeto JSON como el siguiente:

{
  "Type" : "Taxi",
  "Amount" : "10.0 dollar"
  "Date" : "2019-09-02"
}

El componente Respuesta Común no sabe cómo procesar esta información, ya que no sigue la estructura de carga útil común con las propiedades action y variables. Para resolver este problema, tiene estas opciones:

• Convertir la carga útil de JSON en una cadena que luego se pareará con entidades. Si se encuentra alguna coincidencia, se actualizará el juego de variables con el componente con el valor de entidad o los valores de entidad correspondientes (en el caso de una entidad de bolsa compuesta).

  Para configurar esta opción, agregue la propiedad booleana system.convertToString a la propiedad data de la acción de envío:

  actions:
  - type: Action.Submit
    title: Submit
    id: submit                   
    data:
      system.convertToString: true

• Hacer que la aptitud actualice las variables con el mismo nombre que los campos de entrada. En el ejemplo anterior, se actualizarían las variables "Type", "Amount" y "Date".

  Para configurar esta opción, agregue la propiedad booleana system.setVariables a la propiedad data de la acción de envío:

  actions:
  - type: Action.Submit
    title: Submit
    id: submit                   
    data:
      system.setVariables: true

Si no configura ninguna de estas opciones, los valores enviados se ignorarán.

Si utiliza un componente de respuesta común con una entidad de bolsa compuesta, normalmente utilizará la primera opción, que rellenará todas las entidades coincidentes en la bolsa en función de la carga útil de JSON de la cadena.

Cuando un usuario selecciona un botón en una tarjeta adaptable, la conversación no se actualiza para mostrar que el usuario ha seleccionado dicha opción a menos que incluya una acción messageBack para la tarjeta

Para configurar una acción messageBack, consulte https://docs.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-actions#adaptive-cards-with-messageback-action.

Aunque no puede desactivar técnicamente los botones y campos de las tarjetas adaptables, puede crear un efecto similar sustituyendo la tarjeta cuando se llama a una acción de envío. Para ello, utilice la propiedad booleana replaceMessage específica de Microsoft Teams en los componentes de Common Response.

Para permitir que la tarjeta se vuelva a representar de esta forma, agregue esta propiedad en la sección channelCustomProperties del componente de respuesta personalizado:

        ...
           - type: "text"
             text: "This text is replaced with the adaptive card defined in custom property"
             channelCustomProperties:
               - channel: "msteams"
                 properties:
                   replaceMessage: "true"
                   adaptiveCard:
                     ...

También puede utilizar una expresión de Apache FreeMarker para definir el valor de la propiedad.

El esquema JSON de las tarjetas adaptables es relativamente complejo, ya que admite muchas construcciones diferentes. Por lo tanto, es probable que se produzcan errores cuando se intenta definir el contenido de la tarjeta adaptable directamente dentro de un componente de respuesta común. Es posible que le resulte más sencillo usar el siguiente proceso para crear tarjetas adaptables:

1. Con las herramientas visuales del Diseñador de tarjetas adaptables de Microsoft, cree la definición de la tarjeta adaptable.
2. Haga clic en Copiar JSON de tarjeta para obtener la definición en formato JSON.
3. Utilice un conversor en línea (como https://jsonformatter.org/json-to-yaml) para convertir la definición a YAML.
4. Copie el resultado en un editor de texto e inserte el sangrado necesario en el lugar donde aparecerá en la definición del flujo de diálogo.
5. Pegue el texto resultante en el flujo de diálogo.