Configurer OCI Serverless Fn pour la connexion à l'application Identity Aware basée sur REST

1. Connectez-vous à la console Oracle Cloud Infrastructure en tant qu'administrateur de location.
2. Ouvrez le menu de navigation et sélectionnez Identité et sécurité → Identité → Compartiments.
3. Sélectionnez Créer un compartiment et ajoutez un compartiment, par exemple ocifn_compartment : Pour plus de détails sur la création d'un compartiment, voir Pour créer un compartiment.

1. Connectez-vous à la console Oracle Cloud Infrastructure en tant qu'administrateur de location.
2. Ouvrez le menu de navigation et sélectionnez Service de réseau → réseaux en nuage virtuels.
3. Sélectionnez Démarrer l'Assistant VCN pour créer un nouveau VCN.
4. Dans la boîte de dialogue, sélectionnez Créer un VCN avec connectivité Internet et cliquez sur l'Assistant Démarrer le VCN.
5. Dans l'assistant, entrez les détails suivants :
   1. Nom du VCN : Entrez le nom du VCN, par exemple ocifn_vcn.
   2. Compartiment : Entrez le compartiment dans lequel les ressources de VCN seront créées, par exemple ocifn_compartment.
6. Cliquez sur Suivant, puis sur Créer pour créer le VCN et les ressources de réseau connexes.

1. Connectez-vous à la console Oracle Cloud Infrastructure en tant qu'administrateur de location.
2. Ouvrez le menu de navigation et sélectionnez Identité et sécurité → Gestion des clés et des clés secrètes.
3. Cliquez sur Créer une chambre forte.
4. Sélectionnez le compartiment dans lequel la chambre forte sera créée et donnez un nom à la chambre forte. Cliquez sur Créer une chambre forte.
5. Ouvrez la chambre forte que vous avez créée et cliquez sur Créer une clé. Créez la clé dans le compartiment que vous avez créé votre chambre forte. Donnez un nom à la clé et cliquez sur Créer une clé.
6. Dans le menu Ressources, sélectionnez Clés secrètes. Cliquez sur Créer une clé secrète.
7. Dans la page Créer une clé secrète, ajoutez des détails pour le compartiment, le nom et la description. Sélectionnez la clé que vous avez créée dans la liste déroulante Clé de chiffrement. Sélectionnez l'option Génération manuelle des clés secrètes et entrez votre code client et votre clé secrète client dans l'un des formats suivants dans le champ Contenu de la clé secrète.
   1. Autorisation basée sur OAuth

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

      Pour un exemple de code permettant de créer un jeton d'autorisation pour une autorisation basée sur OAuth, voir OAuth Authorization - Sample Token Creation Code.
   2. Autorisation de base

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

      .
   Pour un exemple de code permettant de créer un jeton d'autorisation pour l'autorisation de base, voir Autorisation de base - Exemple de code de création de jeton.
8. Sélectionnez Créer une clé secrète pour enregistrer vos modifications.

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

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

1. Connectez-vous à la console Oracle Cloud Infrastructure en tant qu'administrateur de location.
2. Ouvrez le menu de navigation et sélectionnez Identité et sécurité → Identité → Politiques.
3. Sélectionnez Créer une politique, spécifiez un nom pour la politique, par exemple ocifn_policy, et sélectionnez le compartiment racine de la location.
4. Ajoutez un énoncé de politique similaire à :

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

1. Connectez-vous à la console Oracle Cloud Infrastructure en tant qu'administrateur de location.
2. Ouvrez le menu de navigation et sélectionnez Identité et sécurité → Identité → Politiques.
3. Sélectionnez Créer une politique, spécifiez un nom pour la politique, par exemple ocifn_policy, et sélectionnez le compartiment racine de la location.
4. À l'aide du générateur de politiques, sélectionnez Fonctions dans la liste Cas d'utilisation de politique et basez votre politique sur le modèle Permettre aux utilisateurs de créer, de déployer et de gérer des fonctions et des applications.
5. Sélectionnez le groupe créé précédemment, ocifn_group et ocifn_compartment pour l'emplacement. Cela devrait vous donner un énoncé de politique similaire à :

   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 : Il s'agit d'un échantillon de base facile à comprendre avec un code minimal, montrant comment fonctionnent les fonctions. Ce cas d'utilisation est idéal pour les clients qui doivent intégrer une seule application au connecteur REST générique, nécessitant une configuration minimale. La configuration initiale est effectuée avec une application Oracle Identity Cloud Service (IDCS). Les étapes détaillées de configuration et de déploiement de cette fonction se trouvent dans le fichier `README.md` de ce répertoire.
2. idm-agcs-serverless-IDCS-application-sample : Cet exemple se concentre sur l'exemple d'application IDCS avec une configuration minimale. Il inclut la structure permettant d'ajouter d'autres applications à l'avenir dans cette fonction. Les étapes de configuration et de déploiement sont détaillées dans le fichier `README.md` situé dans ce répertoire.
3. idm-agcs-serverless-azuread-application-sample : Cet exemple est destiné spécifiquement aux clients qui ont besoin d'un exemple d'application AzureAD avec une configuration minimale. Il contient la structure permettant d'ajouter d'autres applications à l'avenir dans cette fonction. Des étapes détaillées pour configurer et déployer cette fonction sont disponibles dans le fichier `README.md` dans ce répertoire.
4. idm-agcs-serverless-multi-application-sample : Cet exemple est destiné aux clients nécessitant à la fois des exemples d'application IDCS et AzureAD avec une configuration minimale. Il inclut la structure permettant d'ajouter d'autres applications à l'avenir dans cette fonction. Le fichier `README.md` de ce répertoire fournit toutes les étapes nécessaires pour configurer et déployer cette fonction.

1. Développez des tests en suivant l'exemple décrit ci-dessous :
   grc-test-infra test d'échantillon

   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 première ligne du test consiste à obtenir le modèle de demande configuré en transmettant le nom, le nom d'entité et l'opération connectedSystem.
   • La deuxième ligne obtient le modèle de réponse configuré à l'aide de paramètres similaires.
   • Les utilisateurs doivent transmettre les attributs requis dans le modèle de demande en les plaçant dans le mappage d'attributs.
   • Ensuite, les utilisateurs doivent simplement appeler la méthode d'utilitaire générique processAndValidateRequestAndResponseTemplate, qui valide en interne les modèles de demande et de réponse pour vérifier leur exactitude en appelant l'API et en mappant sa réponse avec le modèle de réponse configuré.
   • Le test réussit si les modèles de demande et de réponse configurés sont correctement configurés. Sinon, il échoue, permettant aux utilisateurs de voir le motif de l'échec et de corriger les modèles en conséquence.

   L'exemple de fichier de test se trouve dans l'exemple de mise en oeuvre à l'emplacement suivant : <SampleBase>/grc-test-infra/src/test/java/com/oracle/idm/agcs/grc/fn/test/infra/RequestResponseTemplateValidationTest.java

2. Ajoutez les préalables suivants avant d'exécuter le test :
   1. Mettez à jour le fichier <SampleBase>/grc-test-infra/src/test/resources/config avec les valeurs suivantes pour votre environnement :

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

   2. Mettez à jour le fichier <SampleBase>/grc-test-infra/src/test/resources/config.properties avec la valeur suivante pour votre environnement :

      connectedSystemName=<connectedSystemName>

   3. Ajoutez la clé SSH privée (fichier .pem) pour la clé de signature d'API à l'emplacement suivant :

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

3. Exécutez le test développé et créez la fonction :
   1. Naviguez jusqu'au répertoire functions de l'exemple de mise en oeuvre.
   2. Compiler et packager les fonctions

      mvn clean package-DisDevMode=true