Configurar o OCI Serverless Fn para Conexão com o Aplicativo Identity Aware baseado em REST

1. Acesse a Console do Oracle Cloud Infrastructure como um administrador de tenancy.
2. Abra o menu de navegação e selecione Identity & Security → Identity → Compartments.
3. Selecione Criar Compartimento e adicione um compartimento, por exemplo ocifn_compartment: Para obter detalhes sobre como criar um compartimento, consulte Para criar um compartimento

1. Acesse a Console do Oracle Cloud Infrastructure como um administrador de tenancy.
2. Abra o menu de navegação e selecione Rede → Redes virtuais na nuvem.
3. Selecione Iniciar Assistente de VCN para criar uma nova VCN.
4. Na caixa de diálogo, selecione Criar VCN com Conectividade da Internet e clique no Assistente de Inicialização da VCN.
5. No assistente, informe os seguintes detalhes:
   1. Nome da VCN: Digite o nome da VCN, por exemplo, ocifn_vcn.
   2. Compartimento : Informe o compartimento no qual os recursos da VCN serão criados, por exemplo, ocifn_compartment.
6. Clique em Próximo e, em seguida, clique em Criar para criar a VCN e os recursos de rede relacionados.

1. Acesse o Oracle Cloud Infrastructure Console como administrador de tenancy.
2. Abra o menu de navegação e selecione Identity & Security → Key Management & Secret Management
3. Clique em Criar Vault.
4. Selecione o compartimento no qual o Vault será criado e dê um Nome ao Vault. Clique em Criar Vault.
5. Abra o Vault que você criou e clique em Criar Chave. Crie a Chave no mesmo compartimento que você criou o Vault. Atribua um nome à Chave e clique em Create Key.
6. No menu Resources, selecione Secrets. Clique em Criar Segredo.
7. Na página Criar Segredo, adicione detalhes para compartimento, nome e descrição. Selecione a chave criada na lista drop-down Chave de Criptografia. Selecione a opção Geração manual de segredo e informe o código do cliente e o segredo do cliente em um dos formatos a seguir no campo Conteúdo do Segredo.
   1. Autorização baseada em OAuth

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

      Para obter o código de amostra para criar o token de autorização para autorização baseada em OAuth, consulte Autorização OAuth - Código de Criação de Token de Amostra.
   2. Autorização Básica

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

      .
   Para obter código de amostra para criar token de autorização para autorização Básica, consulte Autorização Básica - Código de Criação de Token de Amostra
8. Selecione Criar Segredo para salvar suas alterações.

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

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

1. Acesse o Oracle Cloud Infrastructure Console como administrador de tenancy.
2. Abra o menu de navegação e selecione Identity & Security → Identity → Policies.
3. Selecione Criar Política, especifique um nome para a política, por exemplo ocifn_policy, e selecione o compartimento raiz da tenancy.
4. Adicione uma instrução de política semelhante a:

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

1. Acesse a Console do Oracle Cloud Infrastructure como um administrador de tenancy.
2. Abra o menu de navegação e selecione Identity & Security → Identity → Policies.
3. Selecione Criar Política, especifique um nome para a política, por exemplo ocifn_policy, e selecione o compartimento raiz da tenancy.
4. Usando o Policy Builder, selecione Funções na lista Casos de uso da política e baseie sua política no modelo Permitir que os usuários criem, implantem e gerenciem funções e aplicativos.
5. Selecione o grupo criado anteriormente, ocifn_group e o ocifn_compartment para o local. Isso deverá fornecer uma instrução de política semelhante 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: Esta é uma amostra básica e de fácil compreensão com código mínimo, demonstrando como as funções funcionam. Esse caso de uso é ideal para clientes que precisam integrar um único aplicativo ao conector REST Genérico, exigindo configuração mínima. A configuração inicial é com um aplicativo do Oracle Identity Cloud Service (IDCS). As etapas detalhadas para configurar e implantar esta função podem ser encontradas no arquivo `README.md` dentro deste diretório.
2. idm-agcs-serverless-IDCS-application-sample: Esta amostra concentra-se no exemplo do aplicativo IDCS com configuração mínima. Ele inclui o framework para adicionar mais aplicativos no futuro dentro dessa função. As etapas de configuração e implantação estão detalhadas no arquivo `README.md` localizado neste diretório.
3. idm-agcs-serverless-azuread-application-sample: Esta amostra destina-se especificamente a clientes que precisam de um exemplo de aplicativo AzureAD com configuração mínima. Ele contém o framework para adicionar mais aplicativos no futuro dentro dessa função. Etapas detalhadas para configurar e implantar esta função estão disponíveis no arquivo `README.md` dentro deste diretório.
4. idm-agcs-serverless-multi-application-sample: Esta amostra destina-se a clientes que precisam de exemplos de aplicativos IDCS e AzureAD com configuração mínima. Ele inclui o framework para adicionar mais aplicativos no futuro dentro dessa função. O arquivo `README.md` neste diretório fornece todas as etapas necessárias para configurar e implantar esta função.

1. Desenvolva testes seguindo o exemplo descrito abaixo:
   teste grc-infra teste de amostra

   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);
       }
   }

   • A primeira linha dentro do teste é obter o modelo de Solicitação configurado, informando o Nome, o nome da entidade e a operação connectedSystem.
   • A segunda linha obtém o modelo de Resposta configurado usando parâmetros semelhantes.
   • Os usuários precisam informar os atributos obrigatórios no modelo de solicitação, colocando-os no mapa de atributos.
   • Em seguida, os usuários só precisam chamar o método de utilitário genérico processAndValidateRequestAndResponseTemplate, que valida internamente os modelos de solicitação e resposta para correção chamando a API e mapeando sua resposta com o modelo de resposta configurado.
   • O teste será aprovado se os modelos de solicitação e resposta configurados estiverem configurados corretamente; caso contrário, ele falhará, permitindo que os usuários vejam o motivo da falha e corrijam os modelos adequadamente.

   O arquivo de teste de exemplo pode ser encontrado na implementação de amostra no seguinte local: <SampleBase>/grc-test-infra/src/test/java/com/oracle/idm/agcs/grc/fn/test/infra/RequestResponseTemplateValidationTest.java

2. Adicione os seguintes pré-requisitos antes de executar o teste:
   1. Atualize o arquivo <SampleBase>/grc-test-infra/src/test/resources/config com os seguintes valores para seu ambiente:

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

   2. Atualize o arquivo <SampleBase>/grc-test-infra/src/test/resources/config.properties com o seguinte valor para seu ambiente:

      connectedSystemName=<connectedSystemName>

   3. Adicione a chave SSH privada (arquivo (.pem) para a Chave de Assinatura de API ao seguinte local:

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

3. Execute o teste desenvolvido e crie a função:
   1. Navegue até o diretório functions da implementação de amostra.
   2. Compilar e empacotar as funções

      mvn clean package-DisDevMode=true