この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Newer Version Available

This content describes an older version of this product. View Latest

ConnectionParams クラス

外部システムを認証するためのログイン情報が含まれます。

名前空間

DataSource

使用方法

DataSource.Provider クラスの拡張が、認証をサポートすることを示す DataSource.AuthenticationCapability 値を返す場合、DataSource.Connection クラスは、コンストラクタで DataSource.ConnectionParams インスタンスを使用してインスタンス化されます。

DataSource.ConnectionParams インスタンスに含まれる認証情報は、Salesforce の外部データソース定義の [ID 種別] 項目に応じて異なります。
  • [ID 種別]Named Principal に設定されている場合、外部データソース定義のログイン情報が使用されます。
  • [ID 種別]Per User に設定されている場合は、次のようになります。
    • クエリと検索の場合、ログイン情報は、そのクエリまたは検索を呼び出した現在のユーザに固有です。ユーザの外部システム用認証設定のログイン情報が使用されます。
    • 外部システムのスキーマの同期など、管理接続の場合、外部データソース定義のログイン情報が使用されます。

このクラスの値は、デバッグログに出現することがあり、「Apex 開発」権限を持つユーザがアクセスできます。セキュリティを強化する必要がある場合は、Apex コールアウトエンドポイントとして、URL ではなく指定ログイン情報を使用することをお勧めします。Apex コールアウトで指定ログイン情報をコールアウトエンドポイントとして指定するすべての認証が Salesforce によって管理されるため、コードでこれらを行う必要はありません。

ConnectionParams のプロパティ

ConnectionParams のプロパティは次のとおりです。

certificateName

外部システムに対する各接続を確立するための証明書の名前。

署名

public String certificateName {get; set;}

プロパティ値

型: String

Salesforce の外部データソース定義から取得された値。

endpoint

外部システムの URL。

署名

public String endpoint {get; set;}

プロパティ値

型: String

Salesforce の外部データソース定義から取得された値。

oauthToken

外部システムによって発行された OAuth トークン。

署名

public String oauthToken {get; set;}

プロパティ値

型: String

password

外部システムの認証用のパスワード。

署名

public String password {get; set;}

プロパティ値

型: String

値は、Salesforce の外部データソース定義の [ID 種別] 項目によって異なります。
  • [ID 種別]Named Principal に設定されている場合、外部データソース定義のログイン情報が使用されます。
  • [ID 種別]Per User に設定されている場合は、次のようになります。
    • クエリと検索の場合、ログイン情報は、そのクエリまたは検索を呼び出した現在のユーザに固有です。ユーザの外部システム用認証設定のログイン情報が使用されます。
    • 外部システムのスキーマの同期など、管理接続の場合、外部データソース定義のログイン情報が使用されます。

principalType

外部システムへのアクセスに使用するログイン情報のセットを決定する DataSource.IdentityType のインスタンス。

署名

public DataSource.IdentityType principalType {get; set;}

プロパティ値

型: DataSource.IdentityType

protocol

外部システムの認証に使用するプロトコルの種別。

署名

public DataSource.AuthenticationProtocol protocol {get; set;}

プロパティ値

型: DataSource.AuthenticationProtocol

repository

将来の使用のために予約されています。

署名

public String repository {get; set;}

プロパティ値

型: String

将来の使用のために予約されています。

username

外部システムの認証用のユーザ名。

署名

public String username {get; set;}

プロパティ値

型: String

値は、Salesforce の外部データソース定義の [ID 種別] 項目によって異なります。
  • [ID 種別]Named Principal に設定されている場合、外部データソース定義のログイン情報が使用されます。
  • [ID 種別]Per User に設定されている場合は、次のようになります。
    • クエリと検索の場合、ログイン情報は、そのクエリまたは検索を呼び出した現在のユーザに固有です。ユーザの外部システム用認証設定のログイン情報が使用されます。
    • 外部システムのスキーマの同期など、管理接続の場合、外部データソース定義のログイン情報が使用されます。