Imposta OCI Serverless Fn per la connessione con l'applicazione Identity Aware basata su REST

1. Connettersi alla console di Oracle Cloud Infrastructure come amministratore della tenancy.
2. Aprire il menu di navigazione e selezionare Identità e sicurezza → Identità → Compartimenti.
3. Selezionare Crea compartimento e aggiungere un compartimento, ad esempio ocifn_compartment: per i dettagli sulla creazione di un compartimento, vedere Per creare un compartimento

1. Connettersi alla console di Oracle Cloud Infrastructure come amministratore della tenancy.
2. Aprire il menu di navigazione e selezionare Networking → Virtual Cloud Networks.
3. Selezionare Avvia procedura guidata VCN per creare una nuova VCN.
4. Nella finestra di dialogo selezionare Crea VCN con connettività Internet e fare clic su Avvia procedura guidata VCN.
5. Nella procedura guidata immettere i dettagli riportati di seguito.
   1. Nome VCN: immettere il nome della VCN, ad esempio ocifn_vcn.
   2. Compartimento: immettere il compartimento entro il quale verranno create le risorse VCN, ad esempio ocifn_compartment.
6. Fare clic su Avanti, quindi su Crea per creare la VCN e le risorse di rete correlate.

1. Connettersi alla console di Oracle Cloud Infrastructure come amministratore della tenancy.
2. Aprire il menu di navigazione e selezionare Identity & Security → Key Management & Secret Management
3. Fare clic su Crea vault.
4. Selezionare il compartimento in cui verrà creato il vault e assegnare un nome al vault. Fare clic su Crea vault.
5. Aprire il vault creato e fare clic su Crea chiave. Creare la chiave nello stesso compartimento in cui è stato creato il vault. Assegnare un nome alla chiave e fare clic su Crea chiave.
6. Nel menu Risorse, selezionare Segreti. Fare clic su Crea segreto.
7. Nella pagina Crea segreto aggiungere i dettagli per il compartimento, il nome e la descrizione. Selezionare la chiave creata dall'elenco a discesa Chiave di cifratura. Selezionare l'opzione Generazione manuale dei segreti e immettere il codice client e il segreto client in uno dei formati seguenti nel campo Contenuto segreto.
   1. Autorizzazione basata su OAuth

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

      Per il codice di esempio per la creazione del token di autorizzazione per l'autorizzazione basata su OAuth, vedere OAuth Authorization - Sample Token Creation Code.
   2. Autorizzazione di base

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

      .
   Per il codice di esempio per la creazione del token di autorizzazione per l'autorizzazione di base, vedere Autorizzazione di base - Codice creazione token di esempio
8. Selezionare Crea segreto per salvare le modifiche.

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

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

1. Connettersi alla console di Oracle Cloud Infrastructure come amministratore della tenancy.
2. Aprire il menu di navigazione e selezionare Identità e sicurezza → Identità → Criteri.
3. Selezionare Crea criterio, specificare un nome per il criterio, ad esempio ocifn_policy, quindi selezionare il compartimento radice della tenancy.
4. Aggiungere un'istruzione di criterio simile alla seguente:

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

1. Connettersi alla console di Oracle Cloud Infrastructure come amministratore della tenancy.
2. Aprire il menu di navigazione e selezionare Identità e sicurezza → Identità → Criteri.
3. Selezionare Crea criterio, specificare un nome per il criterio, ad esempio ocifn_policy, quindi selezionare il compartimento radice della tenancy.
4. Utilizzando Costruzione guidata criteri, selezionare Funzioni dalla lista Casi d'uso dei criteri e basare il criterio sul modello Consenti agli utenti di creare, distribuire e gestire funzioni e applicazioni.
5. Selezionare il gruppo creato in precedenza, ocifn_group e ocifn_compartment per la posizione. Questo dovrebbe fornire una dichiarazione politica simile 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: questo è un esempio di base e di facile comprensione con un codice minimo, che dimostra il funzionamento delle funzioni. Questo caso d'uso è ideale per i clienti che devono integrare una singola applicazione con il connettore REST generico, richiedendo una configurazione minima. L'impostazione iniziale viene eseguita con un'applicazione Oracle Identity Cloud Service (IDCS). I passi dettagliati per configurare e distribuire questa funzione sono disponibili nel file `README.md` all'interno di questa directory.
2. idm-agcs-serverless-IDCS-application-sample: questo esempio è incentrato sull'esempio dell'applicazione IDCS con una configurazione minima. Include il framework per aggiungere altre applicazioni in futuro all'interno di questa funzione. I passi di configurazione e distribuzione sono descritti nel file `README.md` che si trova in questa directory.
3. idm-agcs-serverless-azuread-application-sample: questo esempio è specifico per i clienti che hanno bisogno di un esempio di applicazione AzureAD con una configurazione minima. Contiene il framework per aggiungere altre applicazioni in futuro all'interno di questa funzione. I passi dettagliati per configurare e distribuire questa funzione sono disponibili nel file `README.md` all'interno di questa directory.
4. idm-agcs-serverless-multi-application-sample: questo esempio è rivolto ai clienti che necessitano di esempi di applicazioni IDCS e AzureAD con una configurazione minima. Include il framework per aggiungere altre applicazioni in futuro all'interno di questa funzione. Il file `README.md` in questa directory fornisce tutti i passi necessari per configurare e distribuire questa funzione.

1. Sviluppare test seguendo l'esempio descritto di seguito:
   prova del campione 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 prima riga del test consiste nel recuperare il modello di richiesta configurato passando il nome connectedSystem, il nome dell'entità e l'operazione.
   • La seconda riga recupera il modello di risposta configurato utilizzando parametri simili.
   • Gli utenti devono passare gli attributi richiesti nel modello di richiesta inserendoli nella mappa degli attributi.
   • Quindi, gli utenti devono solo chiamare il metodo di utility generica processAndValidateRequestAndResponseTemplate, che convalida internamente sia i modelli di richiesta che quelli di risposta per la correttezza richiamando l'API e mappando la sua risposta con il modello di risposta configurato.
   • Il test verrà superato se i modelli di richiesta e risposta configurati sono configurati correttamente; in caso contrario, si verificherà un errore, consentendo agli utenti di visualizzare il motivo dell'errore e correggere di conseguenza i modelli.

   Il file di test di esempio è disponibile nell'implementazione di esempio nella seguente posizione: <SampleBase>/grc-test-infra/src/test/java/com/oracle/idm/agcs/grc/fn/test/infra/RequestResponseTemplateValidationTest.java

2. Aggiungere i prerequisiti seguenti prima di eseguire il test:
   1. Aggiornare il file <SampleBase>/grc-test-infra/src/test/resources/config con i valori seguenti per l'ambiente in uso:

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

   2. Aggiornare il file <SampleBase>/grc-test-infra/src/test/resources/config.properties con il valore seguente per l'ambiente in uso:

      connectedSystemName=<connectedSystemName>

   3. Aggiungere la chiave SSH privata (file .pem) per la chiave di firma API alla seguente posizione:

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

3. Eseguire il test sviluppato e costruire la funzione:
   1. Passare alla directory functions dell'implementazione di esempio.
   2. Compilare e raggruppare le funzioni

      mvn clean package-DisDevMode=true