Configuration d'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, reportez-vous à Procédure de création d'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 Fonctions de réseau → Réseaux Cloud virtuels.
3. Sélectionnez Démarrer l'assistant VCN pour créer un VCN.
4. Dans la boîte de dialogue, sélectionnez Créer un VCN avec connectivité Internet, puis cliquez sur Démarrer l'assistant 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 VCN seront créées, par exemple ocifn_compartment.
6. Cliquez sur Suivant, puis sur Créer pour créer le VCN et les ressources réseau associées.

1. Connectez-vous à l'administrateur de location de la console Oracle Cloud Infrastructure.
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 un coffre.
4. Sélectionnez le compartiment dans lequel le coffre sera créé et attribuez un nom au coffre. Cliquez sur Créer un coffre.
5. Ouvrez le coffre que vous avez créé et cliquez sur Créer une clé. Créez la clé dans le compartiment dans lequel vous avez créé le coffre. 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. Sur la page Créer une clé secrète, ajoutez des détails sur le compartiment, le nom et la description. Sélectionnez la clé que vous avez créée dans la liste déroulante Clé de cryptage. Sélectionnez l'option Génération manuelle de clé secrète, puis entrez le code client et la clé secrète client dans l'un des formats suivants dans le champ Contenu de clé secrète.
   1. Autorisation basée sur OAuth

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

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

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

      .
   Pour obtenir un exemple de code permettant de créer un jeton d'autorisation pour l'autorisation de base, reportez-vous à 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é → Stratégies.
3. Sélectionnez Créer une stratégie, indiquez le nom de la stratégie, par exemple ocifn_policy, puis sélectionnez le compartiment racine de la location.
4. Ajoutez une instruction de stratégie semblable à la suivante :

   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é → Stratégies.
3. Sélectionnez Créer une stratégie, indiquez le nom de la stratégie, par exemple ocifn_policy, puis sélectionnez le compartiment racine de la location.
4. A l'aide du générateur de stratégies, sélectionnez Fonctions dans la liste Cas d'utilisation de stratégie, puis basez votre stratégie sur le modèle Autoriser les utilisateurs à créer, déployer et gérer des fonctions et des applications.
5. Sélectionnez le groupe créé précédemment, ocifn_group et ocifn_compartment pour l'emplacement. Vous devriez ainsi obtenir une instruction de stratégie semblable à la suivante :

   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 : échantillon de base et facile à comprendre avec un minimum de code, illustrant le fonctionnement des fonctions. Ce cas d'emploi est idéal pour les clients qui ont besoin d'intégrer une seule application au connecteur REST générique, ce qui nécessite 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 le cadre pour 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 s'adresse spécifiquement aux clients qui ont besoin d'un exemple d'application AzureAD avec une configuration minimale. Il contient le framework pour ajouter d'autres applications à l'avenir dans cette fonction. Les étapes détaillées de configuration et de déploiement de cette fonction sont disponibles dans le fichier `README.md` de ce répertoire.
4. idm-agcs-serverless-multi-application-sample : cet exemple s'adresse aux clients qui ont besoin d'exemples d'application IDCS et AzureAD avec une configuration minimale. Il inclut le cadre pour 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 présenté ci-dessous :
   test grc-test-essai-échantillon 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 première ligne du test consiste à obtenir le modèle de demande configuré en transmettant le nom connectedSystem, le nom d'entité et l'opération.
   • 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 la correspondance d'attributs.
   • Ensuite, les utilisateurs doivent simplement appeler la méthode utilitaire générique processAndValidateRequestAndResponseTemplate, qui valide en interne les modèles de demande et de réponse pour vérifier l'exactitude en appelant l'API et en mettant en correspondance sa réponse avec le modèle de réponse configuré.
   • Le test réussira si les modèles de demande et de réponse configurés sont correctement configurés ; sinon, il échouera, 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 d'implémentation à l'emplacement suivant : <SampleBase>/grc-test-infra/src/test/java/com/oracle/idm/agcs/grc/fn/test/infra/RequestResponseTemplateValidationTest.java

2. Ajoutez les prérequis 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) de 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. Accédez au répertoire functions de l'exemple d'implémentation.
   2. Compiler et packager les fonctions

      mvn clean package-DisDevMode=true