Introduction

Configuration des informations d'identification

Vous devez tout d'abord configurer vos informations d'identification ainsi que le fichier de configuration. Pour obtenir des instructions, reportez-vous à Fichier de configuration du kit SDK et de l'interface de ligne de commande.

Vous devez ensuite configurer le client afin qu'il utilise les informations d'identification. Les informations d'identification sont extraites via une interface AuthenticationDetailsProvider. Les clients peuvent effectuer cette implémentation selon votre choix. Nous avons inclus une classe de générateur/POJO simple pour vous aider dans cette tâche (SimpleAuthenticationDetailsProvider).

• Vous pouvez charger une configuration avec ou sans profil :

  ConfigFile config 
      = ConfigFileReader.parse("~/.oci/config");
  ConfigFile configWithProfile 
      = ConfigFileReader.parse("~/.oci/config", "DEFAULT");

• Le fournisseur de clé privée peut être créé directement avec le chemin d'accès au fichier ou à l'aide du fichier de configuration :

  Supplier<InputStream> privateKeySupplier 
      = new SimplePrivateKeySupplier("~/.oci/oci_api_key.pem");
  Supplier<InputStream> privateKeySupplierFromConfigEntry 
      = new SimplePrivateKeySupplier(config.get("key_file"));

• Pour créer un fournisseur d'authentification à l'aide du générateur, procédez comme suit :

  AuthenticationDetailsProvider provider 
      = SimpleAuthenticationDetailsProvider.builder()
          .tenantId("myTenantId")
          .userId("myUserId")
          .fingerprint("myFingerprint")
          .privateKeySupplier(privateKeySupplier)
          .build();

• Pour créer un fournisseur d'authentification à l'aide du générateur avec un fichier de configuration, procédez comme suit :

  AuthenticationDetailsProvider provider 
      = SimpleAuthenticationDetailsProvider.builder()
          .tenantId(config.get("tenancy"))
          .userId(config.get("user"))
          .fingerprint(config.get("fingerprint"))
          .privateKeySupplier(privateKeySupplier)
          .build();

• Enfin, si vous utilisez des clés de fichier de configuration standard et l'emplacement de fichier de configuration standard, vous pouvez simplifier ce processus en utilisant ConfigFileAuthenticationDetailsProvider :

  AuthenticationDetailsProvider provider 
      = new ConfigFileAuthenticationDetailsProvider("ADMIN_USER");

Configuration des options côté client

Créez une configuration côté client via la classe ClientConfiguration. Si vous ne fournissez pas votre propre configuration, le kit SDK pour Java utilise une configuration par défaut. Pour fournir votre propre configuration, utilisez ce qui suit :

ClientConfiguration clientConfig 
    = ClientConfiguration.builder()
        .connectionTimeoutMillis(3000)
        .readTimeoutMillis(60000)
        .build();

Une fois que vous disposez d'une configuration d'informations d'identification et d'une configuration client facultative, vous pouvez commencer à créer des instances de service.

Pour obtenir un exemple de code qui illustre la configuration et l'utilisation des délais d'expiration de connexion et de lecture dans la configuration client, reportez-vous à l'exemple de délai d'expiration de configuration client sur GitHub.

Configuration des options personnalisées

Dans le fichier de configuration, vous pouvez insérer des paires clé-valeur personnalisées que vous définissez, puis les référencer si nécessaire. Par exemple, vous pouvez spécifier un ID de compartiment fréquemment utilisé dans le fichier de configuration :

[DEFAULT]
user=ocid1.user.oc1..aaaaaaaat5nvwcna5j6aqzjcmdy5eqbb6qt2jvpkanghtgdaqedqw3rynjq
fingerprint=20:3b:97:13:55:1c:5b:0d:d3:37:d8:50:4e:c5:3a:34
key_file=~/.oci/oci_api_key.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>


custom_compartment_id=ocid1.compartment.oc1..<unique_ID>

Vous pouvez ensuite en extraire la valeur :

ConfigFile config 
    = ConfigFileReader.parse("~/.oci/config");

String compartmentId = config.get("custom_compartment_id");