OCI Serverless Fn für die Verbindung mit einer REST-basierten Identity Aware-Anwendung einrichten

1. Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole als Mandantenadministrator an.
2. Öffnen Sie das Navigationsmenü, und wählen Sie Identität und Sicherheit → Identität → Compartments aus.
3. Wählen Sie Compartment erstellen aus, und fügen Sie ein Compartment hinzu. Beispiel: ocifn_compartment: Weitere Informationen zum Erstellen eines Compartments finden Sie unter So erstellen Sie ein Compartment

1. Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole als Mandantenadministrator an.
2. Öffnen sie das navigationsmenü, und wählen sie Networking → Virtuelle cloudnetze.
3. Wählen Sie VCN-Assistenten starten aus, um ein neues VCN zu erstellen.
4. Wählen Sie im Dialogfeld die Option VCN mit Internetverbindung erstellen aus, um auf VCN-Assistenten starten zu klicken.
5. Geben Sie im Assistenten die folgenden Details ein:
   1. VCN-Name: Geben Sie den VCN-Namen ein. Beispiel: ocifn_vcn.
   2. Compartment: Geben Sie das Compartment ein, in dem die VCN-Ressourcen erstellt werden. Beispiel: ocifn_compartment.
6. Klicken Sie auf Weiter und dann auf Erstellen, um das VCN und die zugehörigen Netzwerkressourcen zu erstellen.

1. Melden Sie sich als Mandantenadministrator bei der Oracle Cloud Infrastructure-Konsole an.
2. Öffnen Sie das Navigationsmenü, und wählen Sie Identität und Sicherheit → Schlüsselverwaltung und Secret-Verwaltung aus
3. Klicken Sie auf Vault erstellen.
4. Wählen Sie das Compartment aus, in dem der Vault erstellt werden soll, und geben Sie dem Vault einen Namen. Klicken Sie auf Vault erstellen.
5. Öffnen Sie den erstellten Vault, und klicken Sie auf Schlüssel erstellen. Erstellen Sie den Schlüssel in demselben Compartment, in dem Sie den Vault erstellt haben. Geben Sie dem Schlüssel einen Namen, und klicken Sie auf Schlüssel erstellen.
6. Wählen Sie aus dem Menü Ressourcen die OptionSecrets. Klicken Sie auf Secret erstellen.
7. Fügen Sie auf der Seite Secret erstellen Details zu Compartment, Name und Beschreibung hinzu. Wählen Sie den erstellten Schlüssel aus der Dropdown-Liste Verschlüsselungsschlüssel aus. Wählen Sie die Option Manuelle Secret-Generierung aus, und geben Sie Ihren Clientcode und Ihr Client Secret in einem der folgenden Formate in das Feld Secret-Inhalt ein.
   1. OAuth-basierte Autorisierung

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

      Beispielcode zum Erstellen des Autorisierungstokens für die OAuth-basierte Autorisierung finden Sie unter OAuth Authorization - Sample Token Creation Code.
   2. Basisautorisierung

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

      .
   Beispielcode zum Erstellen des Autorisierungstokens für die Basisautorisierung finden Sie unter Basisautorisierung - Beispiel-Tokenerstellungscode
8. Wählen Sie Secret erstellen aus, um die Änderungen zu speichern.

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

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

1. Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole als Mandantenadministrator an.
2. Öffnen Sie das Navigationsmenü, und wählen Sie Identität und Sicherheit → Identität → Policys aus.
3. Wählen Sie Policy erstellen aus, geben Sie einen Namen für die Policy an. Beispiel: ocifn_policy, und wählen Sie das Root Compartment des Mandanten aus.
4. Fügen Sie eine Policy-Anweisung ähnlich der folgenden hinzu:

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

1. Melden Sie sich als Mandantenadministrator bei der Oracle Cloud Infrastructure-Konsole an.
2. Öffnen Sie das Navigationsmenü, und wählen Sie Identität und Sicherheit → Identität → Policys aus.
3. Wählen Sie Policy erstellen aus, geben Sie einen Namen für die Policy an. Beispiel: ocifn_policy, und wählen Sie das Root Compartment des Mandanten aus.
4. Wählen Sie in Policy Builder in der Liste Policy-Anwendungsfälle die Option Funktionen aus, und richten Sie Ihre Policy auf der Vorlage Erstellen, Bereitstellen und Verwalten von Funktionen und Anwendungen durch Benutzer zulassen aus.
5. Wählen Sie die zuvor erstellte Gruppe ocifn_group und ocifn_compartment für den Speicherort aus. Dadurch erhalten Sie eine Policy-Anweisung ähnlich der folgenden:

   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: Dies ist ein einfaches und leicht verständliches Beispiel mit minimalem Code, das die Funktionsweise von Funktionen demonstriert. Dieser Anwendungsfall eignet sich ideal für Kunden, die eine einzelne Anwendung mit dem generischen REST-Connector integrieren müssen und eine minimale Konfiguration erfordern. Das anfängliche Setup erfolgt mit einer Oracle Identity Cloud Service-(IDCS-)Anwendung. Ausführliche Schritte zum Konfigurieren und Bereitstellen dieser Funktion finden Sie in der Datei `README.md` in diesem Verzeichnis.
2. idm-agcs-serverless-IDCS-application-sample: Dieses Beispiel konzentriert sich auf das IDCS-Anwendungsbeispiel mit minimaler Konfiguration. Es enthält das Framework, um zukünftig weitere Anwendungen innerhalb dieser Funktion hinzuzufügen. Konfigurations- und Bereitstellungsschritte werden in der Datei `README.md` in diesem Verzeichnis ausführlich beschrieben.
3. idm-agcs-serverless-azuread-application-sample: Dieses Beispiel ist speziell für Kunden gedacht, die ein AzureAD-Anwendungsbeispiel mit minimaler Konfiguration benötigen. Es enthält das Framework, um in dieser Funktion zukünftig weitere Anwendungen hinzuzufügen. Detaillierte Schritte zum Konfigurieren und Bereitstellen dieser Funktion sind in der Datei `README.md` in diesem Verzeichnis verfügbar.
4. idm-agcs-serverless-multi-application-sample: Dieses Beispiel ist für Kunden gedacht, die IDCS- und AzureAD-Anwendungsbeispiele mit minimaler Konfiguration benötigen. Es enthält das Framework, um zukünftig weitere Anwendungen innerhalb dieser Funktion hinzuzufügen. Die Datei README.md in diesem Verzeichnis enthält alle erforderlichen Schritte zum Konfigurieren und Bereitstellen dieser Funktion.

1. Entwickeln Sie Tests gemäß dem folgenden Beispiel:
   Grc-Test-Infra-Probentest

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

   • Die erste Zeile im Test besteht darin, die konfigurierte Anforderungsvorlage abzurufen, indem Sie den connectedSystem-Namen, den Entitynamen und den Vorgang übergeben.
   • Die zweite Zeile ruft die konfigurierte Antwortvorlage mit ähnlichen Parametern ab.
   • Benutzer müssen die erforderlichen Attribute in der Anforderungsvorlage übergeben, indem sie sie in die Attributzuordnung aufnehmen.
   • Anschließend müssen Benutzer nur die generische Utilitymethode processAndValidateRequestAndResponseTemplate aufrufen, mit der sowohl die Anforderungs- als auch die Antwortvorlagen intern auf Richtigkeit validiert werden, indem die API aufgerufen und ihre Antwort der konfigurierten Antwortvorlage zugeordnet wird.
   • Der Test ist erfolgreich, wenn die konfigurierten Anforderungs- und Antwortvorlagen korrekt konfiguriert sind. Andernfalls verläuft der Test nicht erfolgreich, sodass Benutzer den Fehlergrund anzeigen und die Vorlagen entsprechend korrigieren können.

   Die Beispieltestdatei finden Sie in der Beispielimplementierung am folgenden Speicherort: <SampleBase>/grc-test-infra/src/test/java/com/oracle/idm/agcs/grc/fn/test/infra/RequestResponseTemplateValidationTest.java

2. Fügen Sie die folgenden Voraussetzungen hinzu, bevor Sie den Test ausführen:
   1. Aktualisieren Sie die Datei <SampleBase>/grc-test-infra/src/test/resources/config mit den folgenden Werten für Ihre Umgebung:

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

   2. Aktualisieren Sie die Datei <SampleBase>/grc-test-infra/src/test/resources/config.properties mit dem folgenden Wert für Ihre Umgebung:

      connectedSystemName=<connectedSystemName>

   3. Fügen Sie den privaten SSH-Schlüssel (.pem-Datei) für den API-Signaturschlüssel an folgendem Speicherort hinzu:

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

3. Führen Sie den entwickelten Test aus, und erstellen Sie die Funktion:
   1. Navigieren Sie zum Verzeichnis functions der Beispielimplementierung.
   2. Funktionen kompilieren und verpacken

      mvn clean package-DisDevMode=true