Introducción

Configuración de credenciales

En primer lugar, debe configurar sus credenciales y el archivo de configuración. Para obtener instrucciones, consulte Archivo de configuración de SDK y CLI.

A continuación, debe configurar el cliente para usar las credenciales. Las credenciales se sintetizan mediante una interfaz AuthenticationDetailsProvider. Sin embargo, los clientes pueden implantar esta opción. Hemos incluido una clase de POJO/creador sencilla que le ayudará con esta tarea (SimpleAuthenticationDetailsProvider).

• Puede cargar una configuración con o sin un perfil:

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

• El proveedor de claves privadas se puede crear con la ruta de acceso de archivo directamente o mediante el archivo de configuración:

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

• Para crear un proveedor de autenticación con el creador:

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

• Para crear un proveedor de autenticación mediante el creador con un archivo de configuración:

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

• Por último, si utiliza claves de archivo de configuración estándar y la ubicación de archivo de configuración estándar, puede simplificar el proceso con ConfigFileAuthenticationDetailsProvider:

  AuthenticationDetailsProvider provider 
      = new ConfigFileAuthenticationDetailsProvider("ADMIN_USER");

Configuración de opciones del cliente

Cree una configuración del cliente a través de la clase ClientConfiguration. Si no proporciona su propia configuración, el SDK para Java utiliza una configuración por defecto. Para proporcionar su propia configuración, utilice lo siguiente:

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

Cuando tenga una configuración de credenciales y la configuración de cliente opcional, puede empezar a crear instancias de servicio.

Para obtener un ejemplo de código que muestre cómo configurar y utilizar la y leer los timeouts en la configuración del cliente, consulte el ejemplo de timeout de configuración de cliente en GitHub.

Configuración de opciones personalizadas

En el archivo de configuración, puede insertar pares de clave-valor personalizados que defina y, a continuación, hacer referencia a ellos según sea necesario. Por ejemplo, puede especificar un ID de compartimento de uso frecuente en el archivo de configuración:

[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>

A continuación, puede recuperar el valor:

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

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