Configuración de OCI Serverless Fn para conectarse con la aplicación de reconocimiento de identidad basada en REST

1. Conéctese a la consola de Oracle Cloud Infrastructure como administrador de arrendamiento.
2. Abra el menú de navegación y seleccione Identity & Security → Identity → Compartments.
3. Seleccione Crear compartimento y agregue un compartimento, por ejemplo ocifn_compartment: para obtener más información sobre la creación de un compartimento, consulte Para crear un compartimento

1. Conéctese a la consola de Oracle Cloud Infrastructure como administrador de arrendamiento.
2. Abra el menú de navegación y seleccione Networking → Virtual cloud networks.
3. Seleccione Iniciar asistente de VCN para crear una nueva VCN.
4. En el cuadro de diálogo, seleccione Create VCN with Internet Connectivity y haga clic en Start VCN Wizard.
5. En el asistente, introduzca los siguientes detalles:
   1. Nombre de VCN: introduzca el nombre de la VCN, por ejemplo, ocifn_vcn.
   2. Compartimento: introduzca el compartimento en el que se crearán los recursos de la VCN, por ejemplo ocifn_compartment.
6. Haga clic en Siguiente y, a continuación, en Crear para crear la VCN y los recursos de red relacionados.

1. Inicie sesión en la consola de Oracle Cloud Infrastructure como administrador de arrendamiento.
2. Abra el menú de navegación y seleccione Identity & Security → Key Management & Secret Management.
3. Haga clic en Crear almacén.
4. Seleccione el compartimento en el que se creará el almacén y asigne un nombre al almacén. Haga clic en Crear almacén.
5. Abra el almacén que ha creado y haga clic en Crear clave. Cree la clave en el mismo compartimento en el que ha creado el almacén. Asigne un nombre a la clave y haga clic en Create Key.
6. Desde el menú Recursos, seleccione Secretos. Haga clic en Crear secreto.
7. En la página Crear secreto, agregue detalles para el compartimento, el nombre y la descripción. Seleccione la clave que ha creado en la lista desplegable Clave de cifrado. Seleccione la opción Generación manual de secretos e introduzca el código de cliente y el secreto de cliente en uno de los siguientes formatos en el campo Contenido secreto.
   1. Autorización basada en OAuth

      {
        "clientCode": "69b48365-14e2-430a-bd75-171f89c158fa",
        "clientSecret": "*/Z9g:gM*SWWLLCGkQhQg2hdWelAZD82"
      }

      Para ver el código de ejemplo para crear un token de autorización para la autorización basada en OAuth, consulte OAuth Authorization - Sample Token Creation Code.
   2. Autorización Básica

      {
        "username": "69b48365-14e2-430a-bd75-171f89c158fa",
        "password": "*/Z9g:gM*SWWLLCGkQhQg2hdWelAZD82"
      }

      .
   Para ver el código de ejemplo para crear un token de autorización para la autorización básica, consulte Autorización básica: código de creación de token de muestra
8. Seleccione Crear secreto para guardar los cambios.

secretId: "ocid1.vaultsecret.oc1.iad.dyyyyehdl4ggaawnqt47hfj48ltofzkdg6wy5fjne859jg0"
region: "us-ashburn-1"

ALL { resource.type = 'fnfunc', resource.compartment.id = 'ocid1.compartment.oc1..fdfdfege4om6nat7fue56566556qqvj3eesjqhmjaegeiaxa' }

1. Inicie sesión en la consola de Oracle Cloud Infrastructure como administrador de arrendamiento.
2. Abra el menú de navegación y seleccione Identity & Security → Identity → Policies.
3. Seleccione Crear política, especifique un nombre para la política, por ejemplo ocifn_policy, y seleccione el compartimento raíz del arrendamiento.
4. Agregue una sentencia de política similar a:

   Allow dynamic-group <dynamic-group-name> to read secret-family in tenancy

1. Conéctese a la consola de Oracle Cloud Infrastructure como administrador de arrendamiento.
2. Abra el menú de navegación y seleccione Identity & Security → Identity → Policies.
3. Seleccione Crear política, especifique un nombre para la política, por ejemplo ocifn_policy, y seleccione el compartimento raíz del arrendamiento.
4. Mediante Policy Builder, seleccione Functions en la lista Casos de uso de política y base la política en la plantilla Permitir a los usuarios crear, desplegar y gestionar funciones y aplicaciones.
5. Seleccione el grupo creado anteriormente, ocifn_group y ocifn_compartment para la ubicación. Esto debería proporcionarle una sentencia de política similar a:

   Allow group 'Default'/'ocifn_grp' to use cloud-shell in tenancy
   Allow group 'Default'/'ocifn_grp' to manage repos in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to read objectstorage-namespaces in tenancy
   Allow group 'Default'/'ocifn_grp' to manage logging-family in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to read metrics in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to manage functions-family in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to use virtual-network-family in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to use apm-domains in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to read vaults in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to use keys in compartment ocifn_compartment
   Allow service faas to use apm-domains in compartment ocifn_compartment
   Allow service faas to read repos in tenancy where request.operation='ListContainerImageSignatures'
   Allow service faas to {KEY_READ} in compartment ocifn_compartment where request.operation='GetKeyVersion'
   Allow service faas to {KEY_VERIFY} in compartment ocifn_compartment where request.operation='Verify'

1. idm-agcs-serverless-getting-started-sample: se trata de un ejemplo básico y fácil de entender con un código mínimo, que muestra cómo funcionan las funciones. Este caso de uso es ideal para los clientes que necesitan integrar una única aplicación con el conector REST genérico, lo que requiere una configuración mínima. La configuración inicial se realiza con una aplicación de Oracle Identity Cloud Service (IDCS). Los pasos detallados para configurar y desplegar esta función se pueden encontrar en el archivo `README.md` de este directorio.
2. idm-agcs-serverless-IDCS-application-sample: este ejemplo se centra en el ejemplo de aplicación de IDCS con una configuración mínima. Incluye el marco para agregar más aplicaciones en el futuro dentro de esta función. Los pasos de configuración y despliegue se detallan en el archivo `README.md` ubicado en este directorio.
3. idm-agcs-serverless-azuread-application-sample: este ejemplo es específicamente para clientes que necesitan un ejemplo de aplicación AzureAD con una configuración mínima. Contiene el marco para agregar más aplicaciones en el futuro dentro de esta función. Los pasos detallados para configurar y desplegar esta función están disponibles en el archivo `README.md` dentro de este directorio.
4. idm-agcs-serverless-multi-application-sample: este ejemplo es para clientes que necesitan ejemplos de aplicaciones IDCS y AzureAD con una configuración mínima. Incluye el marco para agregar más aplicaciones en el futuro dentro de esta función. El archivo `README.md` de este directorio proporciona todos los pasos necesarios para configurar y desplegar esta función.

1. Desarrolle pruebas siguiendo el ejemplo que se describe a continuación:
   ensayo de muestras de grc-test-infra

   package com.oracle.idm.agcs.grc.fn.test.infra;
    
   public class RequestResponseTemplateValidationTest {
    
       public void validateSearchUserAsIdentityRequestResponseTemplate() throws IOException, URISyntaxException, InterruptedException {
           // Get the configured Request template by passing the connectedSystem Name, entity name, and operation
           RequestTemplateOutput requestTemplate = getRequestTemplateOutput(connectedSystemName, UserAsIdentityEntity, Operation.SEARCH);
            
           // Get the configured Response template by passing the connectedSystem Name, entity name, and operation
           ResponseTemplateOutput responseTemplate = getResponseTemplateOutput(connectedSystemName, UserAsIdentityEntity, Operation.SEARCH);
            
           // Pass the required attributes in the request template by putting them in the attribute map
           HashMap<String, Object> attributesMap = new HashMap<>();
            
           // Call the generic utility method to validate request and response template
           Map<String, Object> lastRecord = processAndValidateRequestAndResponseTemplate(requestTemplate, responseTemplate, attributesMap);
            
           // Retrieve the necessary data from the response for further processing
           userAsIdentityUid = ((ArrayList<String>) lastRecord.get("uid")).get(0);
       }
   }

   • La primera línea dentro de la prueba es obtener la plantilla de solicitud configurada transfiriendo el nombre, el nombre de entidad y la operación connectedSystem.
   • La segunda línea obtiene la plantilla Response configurada mediante parámetros similares.
   • Los usuarios deben transferir los atributos necesarios en la plantilla de solicitud colocándolos en la asignación de atributos.
   • A continuación, los usuarios solo tienen que llamar al método de utilidad genérica processAndValidateRequestAndResponseTemplate, que valida internamente las plantillas de solicitud y respuesta para que sean correctas llamando a la API y asignando su respuesta a la plantilla de respuesta configurada.
   • La prueba se superará si las plantillas de solicitud y respuesta configuradas están configuradas correctamente; de lo contrario, fallará, lo que permitirá a los usuarios ver la razón del fallo y corregir las plantillas según corresponda.

   El archivo de prueba de ejemplo se puede encontrar en la implementación de ejemplo en la siguiente ubicación: <SampleBase>/grc-test-infra/src/test/java/com/oracle/idm/agcs/grc/fn/test/infra/RequestResponseTemplateValidationTest.java

2. Agregue los siguientes requisitos previos antes de ejecutar la prueba:
   1. Actualice el archivo <SampleBase>/grc-test-infra/src/test/resources/config con los siguientes valores para su entorno:

      [DEFAULT]
      user=<<USER>>
      fingerprint=<<FINGERPRINT>>
      key_file=<<PEM_FILE_RELATIVE_PATH>>
      tenancy=<<TENANCY>>
      region=<<REGION>>

   2. Actualice el archivo <SampleBase>/grc-test-infra/src/test/resources/config.properties con el siguiente valor para su entorno:

      connectedSystemName=<connectedSystemName>

   3. Agregue la clave SSH privada (archivo .pem) para la clave de firma de API a la siguiente ubicación:

      <SampleBase>/grc-test-infra/src/test/resources/oci_api_key.pem

3. Ejecute la prueba desarrollada y cree la función:
   1. Navegue hasta el directorio functions de la implementación de ejemplo.
   2. Compilar y empaquetar las funciones

      mvn clean package-DisDevMode=true