REST コネクタを追加
REST への認証
コネクタを追加したら、必要なプロパティを設定します。- Api Key： IBM Cloud に対してユーザーを識別するAPI キーを入力。
- URI： リソースの場所のURI（Uniform Resource Identifier）を入力。
- Region： S3 互換Web サービスのホスティングリージョンを入力。
- Oracle Namespace： 使用するOracle Cloud Object Storage ネームスペースを入力。
- Azure Storage Account： Azure ストレージアカウントの名前を入力。
- Access Key
- AWS Credentials File
- Azure Active Directory
- Azure Managed Service Identity
- Azure Service Principal
- Azure Service Principal Certificate
- Azure Shared Access Signature
- Basic (default)
- Digest
- GCP Instance Account
- IAM Secret Key
- Negotiate
- None
- OAuth
- OAuth Client
- OAuth JWT
- OAuth Password
- OAuth PKCE
- Secure File Transfer Protocol
Azure Access Key
AWS Credentials File
認証情報ファイルで接続するには、次のプロパティを指定します：- Auth Scheme： AwsCredentialsFile を選択。
- AWS Credentials File： Amazon Web Services（AWS）認証情報ファイルの場所を入力。
- （オプション）AWS Credentials File Profile： 指定した認証情報ファイルから使用するAWS プロファイルの名前を入力。プロファイル名を入力しない場合、Sync はdefault という名前のプロファイルを使用します。
Azure Active Directory
Azure Active Directory（AD）ユーザーアカウントで接続するには、次のプロパティを指定します：- Auth Scheme： AzureAD を選択。
- Use Lake Formation： AWS Lake Formation サービスに一時的な認証情報を取得させる場合は、Enable チェックボックスをオンにします。この一時的な認証情報は、設定されたIAM ロールに基づいてユーザーにアクセスポリシーを適用します。このサービスは、Security Assertion Markup Language（SAML）アサーションを提供しながら、AzureAD、Okta、ADFS、PingFederate で認証する場合に使用できます。デフォルトでは、Enable チェックボックスはオフです。
- OAuth Client Id： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
- OAuth Client Secret： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントシークレットを入力。
Azure Managed Service Identity
Azure Service Principal
Azure サービスプリンシパルとクライアントシークレットで接続するには、次のプロパティを設定します：- Auth Scheme： AzureServicePrincipal を選択。
- Azure Tenant： 接続するMicrosoft Online テナントを入力。
- OAuth Client Id： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
- OAuth Client Secret： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントシークレットを入力。
- （オプション）Scope： アプリケーションへのアクセス範囲を指定。
- （オプション）OAuth Authorization URL： OAuth サービスのOAuth 認可URL を入力。
- （オプション）OAuth Access Token URL： アクセストークンを取得するURL を入力。
- （オプション）OAuth Refresh Token URL： OAuth トークンを更新するURL を入力。
- Azure ポータルにログインします。
- 左ナビゲーションペインですべてのサービスを選択します。次にアプリの登録を検索し選択します。
- 新規登録をクリックします。
- アプリケーションの名前を入力して任意のAzure AD ディレクトリ - マルチテナントを選択します。
- アプリケーションを作成したら、概要セクションに表示されるアプリケーション（クライアント）ID の値をコピーします。この値をOAuth クライアントId として使用します。
- 証明書とシークレットセクションに移動して、アプリケーションの新しいクライアント シークレットを選択します。
- 有効期間を指定してクライアントシークレットを保存します。保存するとキーの値が表示されます。
- 値は一度しか表示されないので、コピーしておきます。この値をOAuth クライアントシークレットとして使用します。
- 認証タブで、必ずアクセストークン（暗黙的なフローに使用） を選択します。
Azure Service Principal Certificate
Azure サービスプリンシパルとクライアント証明書で接続するには、次のプロパティを設定します：- Auth Scheme： AzureServicePrincipalCert を選択。
- Azure Tenant： 接続するMicrosoft Online テナントを入力。
- OAuth JWT Cert： Java web token（JWT）証明書ストアを入力。
- OAuth JWT Cert Type： JWT 証明書を格納するキーストアの種類を入力。デフォルトの種類はPEMKEY_BLOB です。
- （オプション）OAuth Client Id： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
- （オプション）Scope： アプリケーションへのアクセス範囲を指定。
- （オプション）OAuth Authorization URL： OAuth サービスのOAuth 認可URL を入力。
- （オプション）OAuth Access Token URL： アクセストークンを取得するURL を入力。
- （オプション）OAuth Refresh Token URL： OAuth トークンを更新するURL を入力。
- （オプション）OAuth JWT Cert Password： OAuth JWT 証明書のパスワードを入力。
- （オプション）OAuth JWT Cert Subject： OAuth JWT 証明書のサブジェクトを入力。
- Azure ポータルにログインします。
- 左ナビゲーションペインですべてのサービスを選択します。次にアプリの登録を検索し選択します。
- 新規登録をクリックします。
- アプリケーションの名前を入力して任意のAzure AD ディレクトリ - マルチテナントを選択します。
- アプリケーションを作成したら、概要セクションに表示されるアプリケーション（クライアント）ID の値をコピーします。この値をOAuth クライアントId として使用します。
- 証明書とシークレットセクションに移動して、証明書のアップロードを選択します。次に、ローカルマシンからアップロードする証明書を選択します。
- 有効期間を指定してクライアントシークレットを保存します。保存するとキーの値が表示されます。
- 値は一度しか表示されないので、コピーしておきます。この値をOAuth クライアントシークレットとして使用します。
- 認証タブで、必ずアクセストークン（暗黙的なフローに使用） を選択します。
Azure Shared Access Signature
Azure の共有アクセス署名で接続するには、次のプロパティを設定します：
- Auth Scheme：SAS を選択。
- Azure Shared Access Signature：ストレージアカウントに関連付けられている共有アクセス署名を入力。
Azure 共有アクセス署名を作成するには：
- Azure ポータルにルートアカウントの資格情報を使用してサインインします。
- ストレージ アカウントをクリックして、使用するストレージアカウントを選択します。
- 設定のShared Access Signature をクリックします。
- アクセスポリシーとトークンの有効期限を設定します。
- SAS の生成をクリックし、生成されたトークンをコピーします。
Basic
Digest
GCP Instance Account
IAM Secret Key
IAM シークレットキーで接続するには、次のプロパティを設定します：- Auth Scheme： IAMSecretKey を選択。
- Access Key： アカウントのアクセスキーを入力。この値はセキュリティ認証情報ページから取得できます。
- Secret Key： アカウントのシークレットキーを入力。この値はセキュリティ認証情報ページから取得できます。
Negotiate
Kerberos 資格情報で接続するには、次のプロパティを指定します：- Auth Scheme： Negotiate を選択。
- User： REST への認証に使用するユーザー名を入力。
- Password： REST への認証に使用するパスワードを入力。
- Kerberos KDC： 認証に使用するKerberos キー配布センター（KDC）サービスを入力。
- Kerberos Realm： 認証に使用するKerberos レルムを入力。
- Kerberos SPN： Kerberos ドメインコントローラーのサービスプリンシパル名（SPN）を入力。
- （オプション）Kerberos User： Kerberos ドメインコントローラーのプリンシパル名を入力。名前はHost/User@Realm の形式にする必要があります。
- （オプション）Kerberos Keytab File： Kerberos プリンシパルと暗号化キーのペアを含むキータブファイルのパスを入力。
- （オプション）Kerberos Service Realm： サービスのKerberos レルムを入力。
- （オプション）Kerberos Service KDC： 認証に使用するKerberos キー配布センター（KDC）サービスを入力。
- （オプション）Kerberos Ticket Cache： MIT Kerberos 資格情報キャッシュファイルの完全なパスを入力。Sync は、指定されたキャッシュファイルを使用して、Apache HBase への接続に必要なKerberos チケットを取得します。
OAuth
OAuth カスタムクレデンシャルで接続するには、次のプロパティを指定します：- Auth Scheme： OAuth を選択。
- OAuth Client Id： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
- OAuth Client Secret： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントシークレットを入力。
- （オプション）Scope： アプリケーションへのアクセス範囲を指定。
- （オプション）OAuth Authorization URL： OAuth サービスのOAuth 認可URL を入力。
- （オプション）OAuth Access Token URL： アクセストークンを取得するURL を入力。
- （オプション）OAuth Refresh Token URL： OAuth トークンを更新するURL を入力。
OAuth Client
OAuth クライアントで接続するには、次のプロパティを指定します：- Auth Scheme： OAuthClient を選択。
- OAuth JWT Cert： Java web token（JWT）証明書ストアを入力。
- OAuth JWT Cert Type： JWT 証明書を格納するキーストアの種類を入力。デフォルトの種類はPEMKEY_BLOB です。
- OAuth Client Id： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
- OAuth Client Secret： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントシークレットを入力。
- （オプション）Scope： アプリケーションへのアクセス範囲を指定。
- （オプション）OAuth Authorization URL： OAuth サービスのOAuth 認可URL を入力。
- （オプション）OAuth Access Token URL： アクセストークンを取得するURL を入力。
- （オプション）OAuth Refresh Token URL： OAuth トークンを更新するURL を入力。
- （オプション）Subject Id： アプリケーションが委任アクセスをリクエストしているユーザーサブジェクトを入力。
- Subject Type： クライアントクレデンシャル認証のサブジェクトの種類を選択。デフォルトの種類はenterprise です。
OAuth JWT
- （オプション）OAuth JWT Audience： JWT を使用できるエンティティのスペース区切りリストを入力。
- （オプション）OAuth JWT Validity Time： JWT の有効期間を秒単位で指定。デフォルトは3600 秒です。上下の矢印をクリックして秒数を指定するか、テキストボックスに直接数値を入力します。
OAuth Password
- OAuth Version： 使用するOAuth バージョンを選択。デフォルト値は最新バージョンです。
- （オプション）Scope： アプリケーションへのアクセス範囲を指定。
- （オプション）OAuth Authorization URL： OAuth サービスのOAuth 認可URL を入力。
- （オプション）OAuth Access Token URL： アクセストークンを取得するURL を入力。
- （オプション）OAuth Refresh Token URL： OAuth トークンを更新するURL を入力。
OAuth PKCE
OAuth PKCE 拡張で接続するには、次のプロパティを設定します：- Auth Scheme： OAuthPKCE を選択。
- （オプション）OAuth Client Id： OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
Secure File Transfer Protocol
Secure File Transfer Protocol（SFTP）で接続するには、次のプロパティを設定します：- Auth Scheme： SFTP を選択。
- SSH Auth Mode： サービスへのSSH トンネルを確立する際に使用する認証モードを選択。デフォルトのモードはPassword です。
- SSH User： SSH ユーザーを入力。
- （オプション）SSH Password： SSH パスワードを入力。
接続を完了する
接続を完了するには：- 次のプロパティを指定します：
- Format： 接続先のREST ソースで使用されるデータ構造化標準を選択。デフォルトの標準はJSON です。
- Data Model： 指定したフォーマットのドキュメントを解析し、データベースメタデータを生成するために使用するデータモデルを選択。デフォルトのデータモデルはDocument です。
- JSON Format： JSON ドキュメントのフォーマットを選択。デフォルト値はJSON です。
- （オプション）XPath： XML ドキュメント内の同じ階層で繰り返されるXML パスを入力。複数のパスをセミコロン区切りのリストで指定できます。
- AWS Region： Amazon Web Services をホストするリージョンを選択。デフォルトのリージョンはNORTHERNVIRGINIA です。
- （オプション）Storage Base URL： クラウドストレージサービスプロバイダーのURL を入力。
- 高度な設定 タブで詳細な接続設定を定義します。（ただし、ほとんどの場合、これらの設定は必要ありません。）
- REST への接続をクリックしてREST アカウントに接続します。
- 作成およびテストをクリックして接続を作成します。