• コードに資格証明を直接指定します。

  from borneo.iam import SignatureProvider
  #
  # Use SignatureProvider directly via API. Note that the
  # private_key argument can either point to a key file or be the
  # string content of the private key itself.
  #
  at_provider = SignatureProvider(tenant_id='ocid1.tenancy.oc1..tenancy',
                                  user_id='ocid1.user.oc1..user',
                                  private_key=key_file_or_key, 
                                  fingerprint='fingerprint',   
                                  pass_phrase='mypassphrase')

• 構成ファイルを使用したデフォルト・プロファイルとの接続:

  from borneo.iam import SignatureProvider
  #
  # Use SignatureProvider with a default credentials file and
  # profile $HOME/.oci/config
  #
  at_provider = SignatureProvider()

• 構成ファイルを使用したデフォルト以外のプロファイルとの接続:

  from borneo.iam import SignatureProvider
  #
  # Use SignatureProvider with a non-default credentials file and profile
  #
  at_provider = SignatureProvider(config_file='myconfigfile', 
                                  profile_name='myprofile')

• Instance Principalを使用した接続:

  Instance PrincipalはIAMサービス機能で、インスタンスが認可者(またはプリンシパル)となり、サービス・リソースに対するアクションを実行できます。各コンピュート・インスタンスは、自身のアイデンティティを持ち、追加された証明書を使用して認証を行います。

  at_provider =
  SignatureProvider.create_with_instance_principal(region=my_region)

• リソース・プリンシパルを使用した接続:

  リソース・プリンシパルはIAMサービス機能で、リソースを認可済俳優(またはプリンシパル)にでき、サービス・リソースに対するアクションを実行できます。

  at_provider = SignatureProvider.create_with_resource_principal()

from borneo import NoSQLHandle, NoSQLHandleConfig, Regions
from borneo.iam import SignatureProvider
# the region to which the application will connect
region = Regions.US_ASHBURN_1
# create a configuration object
config = NoSQLHandleConfig(region, at_provider)
# create a handle from the configuration object
handle = NoSQLHandle(config)

• コードに資格証明を直接指定します。

  privateKeyFile := "/path/to/privateKeyFile"
  passphrase := "examplepassphrase"
  sp, err := iam.NewRawSignatureProvider("ocid1.tenancy.oc1..tenancy",
                                         "ocid1.user.oc1..user",
                                         "us-ashburn-1", 
                                         "fingerprint", 
                                         "compartmentID", 
                                         privateKeyFile ,
                                         &passphrase )
  if err != nil {
      return
  }
  cfg := nosqldb.Config{
      AuthorizationProvider: sp,
      // This is only required if the "region" property is not 
      //specified in the config file.
      Region: "us-ashburn-1",
  }

• 構成ファイルを使用したデフォルト・プロファイルとの接続:

  cfg := nosqldb.Config{
  // This is only required if the "region" property is not 
  //specified in ~/.oci/config.
  // This takes precedence over the "region" property when both are specified.
      Region: "us-ashburn-1", 
  }
  client, err := nosqldb.NewClient(cfg)

• 構成ファイルを使用したデフォルト以外のプロファイルとの接続:

  sp, err := iam.NewSignatureProviderFromFile("your_config_file_path", 
             "your_profile_name", "", "compartment_id")
  if err != nil {
      return
  }
  cfg := nosqldb.Config{
      AuthorizationProvider: sp,
      // This is only required if the "region" property is not specified in the config file.
      Region: "us-ashburn-1",
  }
  client, err := nosqldb.NewClient(cfg)

• Instance Principalを使用した接続:

  Instance PrincipalはIAMサービス機能で、インスタンスが認可者(またはプリンシパル)となり、サービス・リソースに対するアクションを実行できます。各コンピュート・インスタンスは、自身のアイデンティティを持ち、追加された証明書を使用して認証を行います。

  sp, err := iam.NewSignatureProviderWithInstancePrincipal("compartment_id")
  if err != nil {
      return
  }
  cfg := nosqldb.Config{
      AuthorizationProvider: sp,
      Region: "us-ashburn-1",
  }
  client, err := nosqldb.NewClient(cfg)

• リソース・プリンシパルを使用した接続:

  リソース・プリンシパルはIAMサービス機能で、リソースを認可済俳優(またはプリンシパル)にでき、サービス・リソースに対するアクションを実行できます。

  sp, err := iam.NewSignatureProviderWithResourcePrincipal("compartment_id")
  if err != nil {
      return
  }
  cfg := nosqldb.Config{
      AuthorizationProvider: sp,
      Region: "us-ashburn-1",
  }
  client, err := nosqldb.NewClient(cfg)

• コードに資格証明を直接指定します。

  初期構成では、auth.iamプロパティの一部として資格証明を直接指定できます。NoSQLClientインスタンスを次のように作成します。

  const NoSQLClient = require('oracle-nosqldb').NoSQLClient;
  let client = new NoSQLClient({
      region: <your-service-region>
      auth: {
          iam: {
              tenantId: myTenancyOCID,
              userId: myUserOCID,
              fingerprint: myPublicKeyFingerprint,
              privateKeyFile: myPrivateKeyFile,
              passphrase: myPrivateKeyPassphrase
          }
      }
  });

• 構成ファイルを使用したデフォルト・プロファイルとの接続:

  資格証明はOracle Cloud Infrastructure構成ファイルに格納できます。構成ファイルのデフォルト・パスは~/.oci/configで、~はユーザーのホーム・ディレクトリを表します。Windowsでは、~はUSERPROFILE環境変数の値です。ファイルには複数のプロファイルを含めることができます。デフォルトでは、SDKはDEFAULTというプロファイルを使用して資格証明を格納します。

  これらのデフォルト値を使用するには、~/.ociディレクトリにconfigという名前のファイルを次の内容で作成します。

  [DEFAULT]
  tenancy=<your-tenancy-ocid>
  user=<your-user-ocid>
  fingerprint=<fingerprint-of-your-public-key>
  key_file=<path-to-your-private-key-file>
  pass_phrase=<your-private-key-passphrase>
  region=<your-region-identifier>

  また、OCI構成ファイルの資格証明とともにリージョン識別子を指定することもできます。ドライバはデフォルトで上の場所を参照し、リージョンが資格証明とともに提供されている場合は、初期構成を指定する必要はなく、引数なしコンストラクタを使用できます。

  const NoSQLClient = require('oracle-nosqldb').NoSQLClient;
  let client = new NoSQLClient();

  または、構成でリージョンを指定することもできます。

  const NoSQLClient = require('oracle-nosqldb').NoSQLClient;
  let client = new NoSQLClient({ region: Region.US_ASHBURN_1 });

• 構成ファイルを使用したデフォルト以外のプロファイルとの接続:

  OCI構成ファイルの別のパスと構成ファイル内の別のプロファイルを使用できます。この場合、これらは初期構成のauth.iamプロパティ内で指定します。たとえば、OCI構成ファイル・パスが~/myapp/.oci/configで、資格証明をプロファイルJaneに格納する場合:

  次に、次のようにNoSQLClientインスタンスを作成します。

  const NoSQLClient = require('oracle-nosqldb').NoSQLClient;
  let client = new NoSQLClient({
      region: Region.US_ASHBURN_1,
      auth: {
          iam: {
              configFile: '~/myapp/.oci/config',
              profileName: 'Jane'
          }
      }
  });

• Instance Principalを使用した接続:

  Instance PrincipalはIAMサービス機能で、インスタンスが認可者(またはプリンシパル)となり、サービス・リソースに対するアクションを実行できます。各コンピュート・インスタンスは、自身のアイデンティティを持ち、追加された証明書を使用して認証を行います。

  設定したら、次のようにNoSQLClientインスタンスを作成します。

  const NoSQLClient = require('oracle-nosqldb').NoSQLClient;
  const client = new NoSQLClient({
      region: Region.US_ASHBURN_1,
      compartment: 'ocid1.compartment.oc1..............'
      auth: {
          iam: {
              useInstancePrincipal: true
          }
      }
  });

  前述と同じ構成でJSON構成ファイルを使用することもできます。Instance Principalを使用する場合、コンパートメントID (OCID)をコンパートメント・プロパティとして指定する必要があります。これは、デフォルトのコンパートメントを使用する場合でも必要です。コンパートメント名やパスではなく、コンパートメントIDを使用する必要があります。また、Instance Principalを使用する場合、NoSQLClient APIをコールするときに、表名にコンパートメント名またはパスの接頭辞を付けることはできません。

• リソース・プリンシパルを使用した接続:

  リソース・プリンシパルはIAMサービス機能で、リソースを認可済俳優(またはプリンシパル)にでき、サービス・リソースに対するアクションを実行できます。

  設定したら、次のようにNoSQLClientインスタンスを作成します。

  const NoSQLClient = require('oracle-nosqldb').NoSQLClient;
  const client = new NoSQLClient({
      region: Region.US_ASHBURN_1,
      compartment: 'ocid1.compartment.oc1...........................'
      auth: {
          iam: {
              useResourcePrincipal: true
          }
      }
  });

  前述と同じ構成でJSON構成ファイルを使用することもできます。リソース・プリンシパルを使用する場合は、コンパートメントID (OCID)をコンパートメント・プロパティとして指定する必要があります。これは、デフォルトのコンパートメントを使用する場合でも必要です。コンパートメント名やパスではなく、コンパートメントIDを使用する必要があります。また、リソース・プリンシパルを使用する場合、NoSQLClient APIをコールするときに、表名にコンパートメント名またはパスの接頭辞を付けることはできません。

• コードに資格証明を直接指定します。

  IAMAuthorizationProviderの作成時に、資格証明をIAMCredentialsとして直接指定できます。次のようにNoSQLClientを作成します。

  var client = new NoSQLClient(
      new NoSQLConfig
      {
          Region=<your-service-region>,
          AuthorizationProvider = new IAMAuthorizationProvider(
              new IAMCredentials
              {
                  TenantId=myTenancyOCID,
                  UserId=myUserOCID,
                  Fingerprint=myPublicKeyFingerprint,
                  PrivateKeyFile=myPrivateKeyFile
              })
      });

• 構成ファイルを使用したデフォルト・プロファイルとの接続:

  資格証明はOracle Cloud Infrastructure構成ファイルに格納できます。構成ファイルのデフォルト・パスは~/.oci/configで、~はユーザーのホーム・ディレクトリを表します。Windowsでは、~はUSERPROFILE環境変数の値です。ファイルには複数のプロファイルを含めることができます。デフォルトでは、SDKはDEFAULTという名前のプロファイルを使用して資格証明を格納します

  これらのデフォルト値を使用するには、~/.oci ディレクトリにconfigという名前のファイルを次の内容で作成します。

  [DEFAULT]
  tenancy=<your-tenancy-ocid>
  user=<your-user-ocid>
  fingerprint=<fingerprint-of-your-public-key>
  key_file=<path-to-your-private-key-file>
  pass_phrase=<your-private-key-passphrase>
  region=<your-region-identifier>

  また、OCI構成ファイルの資格証明とともにリージョン識別子を指定することもできます。デフォルトでは、ドライバはOCI構成ファイル内の資格証明とリージョンをデフォルト・パスおよびデフォルト・プロファイルで検索します。したがって、前述の資格証明とともにリージョンを指定する場合は、構成を渡さずにNoSQLClientインスタンスを作成できます。

  var client = new NoSQLClient();

  または、NoSQLConfigにリージョン(およびその他のプロパティ)を指定することもできます。

  var client = new NoSQLClient(
      new NoSQLConfig(
      {
          Region = Region.US_ASHBURN_1,
          Timeout = TimeSpan.FromSeconds(10),
      });

• 構成ファイルを使用したデフォルト以外のプロファイルとの接続:

  OCI構成ファイルの別のパスと構成ファイル内の別のプロファイルを使用できます。この場合、初期構成のauth.iamプロパティ内にこれらを指定します。たとえば、OCI構成ファイル・パスが~/myapp/.oci/configで、資格証明をプロファイルJaneに格納する場合:

  次に、次のようにNoSQLClientインスタンスを作成します。

  var client = new NoSQLClient(
      new NoSQLConfig
      {
          Region = Region.US_ASHBURN_1,
          AuthorizationProvider = new IAMAuthorizationProvider(
              "~/myapp/.oci/config", "Jane")
      });

• Instance Principalを使用した接続:

  Instance PrincipalはIAMサービス機能で、インスタンスが認可者(またはプリンシパル)となり、サービス・リソースに対するアクションを実行できます。各コンピュート・インスタンスは、自身のアイデンティティを持ち、追加された証明書を使用して認証を行います。設定したら、次のようにNoSQLClientインスタンスを作成します。

  var client = new NoSQLClient(
      new NoSQLConfig
      {
          Region=<your-service-region>,
          Compartment="ocid1.compartment.oc1.............................",
          AuthorizationProvider=IAMAuthorizationProvider.CreateWithInstancePrincipal()
      });

  次のように、JSONで同じ構成を表すこともできます。

  {
      "Region": "<your-service-region>",
      "AuthorizationProvider":
      {
          "AuthorizationType": "IAM",
          "UseInstancePrincipal": true
      },
      "Compartment": "ocid1.compartment.oc1.............................",
  }

  Instance Principalを使用する場合、コンパートメントID (OCID)をcompartmentプロパティとして指定する必要があります。これは、デフォルトのコンパートメントを使用する場合でも必要です。コンパートメント名やパスではなく、コンパートメントIDを使用する必要があります。また、Instance Principalを使用する場合、NoSQLClient APIをコールするときに、表名にコンパートメント名またはパスの接頭辞を付けることはできません。

• リソース・プリンシパルを使用した接続:

  リソース・プリンシパルはIAMサービス機能で、リソースを認可済俳優(またはプリンシパル)にでき、サービス・リソースに対するアクションを実行できます。設定したら、次のようにNoSQLClientインスタンスを作成します。

  var client = new NoSQLClient(
      new NoSQLConfig
      {
          Region = <your-service-region>,
          Compartment =
              "ocid1.compartment.oc1.............................",
          AuthorizationProvider =
              IAMAuthorizationProvider.CreateWithResourcePrincipal()
      });

  次のように、JSONで同じ構成を表すこともできます。

  {
      "Region": "<your-service-region>",
      "AuthorizationProvider":
      {
          "AuthorizationType": "IAM",
          "UseResourcePrincipal": true
      },
      "Compartment": "ocid1.compartment.oc1.............................",
  }

  リソース・プリンシパルを使用する場合は、コンパートメントID (OCID)をcompartmentプロパティとして指定する必要があります。これは、デフォルトのコンパートメントを使用する場合でも必要です。コンパートメント名やパスではなく、コンパートメントIDを使用する必要があります。また、リソース・プリンシパルを使用する場合、NoSQLClient APIをコールするときに、表名にコンパートメント名またはパスの接頭辞を付けることはできません。