Introduction

Configuration des données d'identification

Tout d'abord, vous devez configurer vos données d'identification et votre fichier de configuration. Pour les instructions, voir Fichier de configuration des trousses SDK et de l'interface de ligne de commande.

Vous devez ensuite configurer le client pour utiliser les données d'identification. Les données d'identification sont abstraites au moyen d'une interface AuthenticationDetailsProvider. Les clients peuvent toutefois mettre en oeuvre ce processus. Nous avons inclus une simple classe POJO/générateur pour vous aider à effectuer 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és privées 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 avec le générateur :

  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 :

  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 du fichier de configuration standard, vous pouvez simplifier cette opération à l'aide de ConfigFileAuthenticationDetailsProvider :

  AuthenticationDetailsProvider provider 
      = new ConfigFileAuthenticationDetailsProvider("ADMIN_USER");

Configuration des options côté client

Créez une configuration côté client au moyen de la classe ClientConfiguration. Si vous ne fournissez pas votre propre configuration, la trousse SDK pour Java utilise une configuration par défaut. Pour définir votre propre configuration, utilisez les éléments suivants :

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

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

Pour un exemple de code montrant comment configurer et utiliser les temporisations de connexion et de lecture dans votre configuration de client, voir Exemple de temporisation dans une configuration de 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 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 extraire la valeur :

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

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