API の接続の作成と管理
Salesforce で MuleSoft API および HTTP コールアウトに対して有効化したアクションの使用を承認する接続を作成します。API カタログ外から他の外部 API ソースの接続を作成し、カタログから接続を表示できます。
必要なエディション
| 使用可能なインターフェース: Lightning Experience |
| 使用可能なエディション: Developer Edition、Enterprise Edition、Performance Edition、および Unlimited Edition |
API のアクションを有効化する前に接続を作成します。MuleSoft API に接続がまだない場合、API のアクションを有効化すると、接続の作成プロセスが開始されます。
- Salesforce で、[設定] から、[クイック検索] ボックスに「API カタログ」と入力し、[API カタログ] を選択します。
- アクションを有効化する MuleSoft API を選択します。
- 接続を作成してアクションを有効化するには、[Activate Actions] をクリックします。
- API バージョンを選択します。
- デフォルトの接続の表示ラベルと名前をカスタマイズするには、オーバータイプします。
- 説明を入力します。
- Salesforce へのこの接続の管理対象指定ログイン情報として使用する対象 URL (API インスタンス) を選択します。選択した対象にアクセスできない場合は、Anypoint Platform 管理者にアクセスを承認するように依頼し、もう一度状況を確認します。必要に応じて SLA 層を選択します。「 MuleSoft ドキュメント: クライアントアプリケーション、契約、ログイン情報」を参照してください。
-
[作成して続行] をクリックします。
MuleSoft によるクライアント ID 適用を使用する API では、外部ログイン情報、指定ログイン情報、外部サービス、権限セットなどの接続設定が自動的に作成されます。
外部認証プロトコルまたはカスタム認証プロトコルを使用する API の場合、API カタログは指定ログイン情報を作成し、接続の [Authentication Status (認証状況)] を [Custom (カスタム)] に設定します。接続が完了したら、接続ログイン情報を確認し、必要に応じて設定を完了します。「外部ログイン情報の作成および編集」を参照してください。
最初に作成した接続は自動的にデフォルト接続として設定されます。オートメーションで別の接続を使用するには、デフォルト接続として設定します。
接続をすぐに更新することはできませんが、有効化アクションプロセスを完了したら更新できます。接続を作成したら、接続の表示ラベルと説明のみを更新できます。別のリダイレクト先 URL を使用するには、新しいリダイレクト先 URL を使用して API バージョンの別の接続を作成します。
API アクションを実行するときに権限エラーが発生しないように、作成する接続にユーザー権限を割り当ててください。
API のアクションの有効化に進みます。「Activate Invocable Actions for APIs」を参照してください。
MuleSoft API の複数の接続の作成
MuleSoft API に複数の送信先 URL (API インスタンス) がある場合、API に対して複数の接続を作成できます。ただし、各対象 URL で一度に使用できる有効な接続は 1 つのみです。
- Salesforce で、[設定] から、[クイック検索] ボックスに「API カタログ」と入力し、[API カタログ] を選択します。
- 接続を作成する API を選択します。
- [新しい接続] をクリックします。
- API バージョンを選択します。
- デフォルトの接続の表示ラベルと名前 (デフォルトは API 参照名とバージョン) をカスタマイズするには、表示ラベルと名前をオーバータイプします。
- 説明を入力します。
- Salesforce へのこの接続の管理対象指定ログイン情報として使用する対象 URL (API インスタンス) を選択します。選択したリンク先 URL にアクセスできない場合は、Anypoint Platform 管理者にアクセスを承認するように依頼し、もう一度状況を確認します。必要に応じて SLA 層を選択します。「 MuleSoft ドキュメント: クライアントアプリケーション、契約、ログイン情報」を参照してください。
-
[完了] をクリックします。
MuleSoft からのクライアント ID 適用を使用する API の場合、外部ログイン情報、指定ログイン情報、外部サービス、権限セットを含む接続設定が自動的に作成されます。
外部認証プロトコルまたはカスタム認証プロトコルを使用する API の場合、API カタログは指定ログイン情報を作成し、接続の [Authentication Status (認証状況)] を [Custom (カスタム)] に設定します。接続が完了したら、接続ログイン情報を確認し、必要に応じて設定を完了します。「外部ログイン情報の作成および編集」を参照してください。
最初に作成した接続は自動的にデフォルトとして設定されます。オートメーションで別の接続を使用するには、デフォルト接続として設定します。
MuleSoft API のデフォルト接続の設定
関連付けられた MuleSoft API のアクションを実行するオートメーションで使用されるデフォルト接続として接続を設定します。最初に作成した接続は自動的にデフォルトとして設定されます。
- MuleSoft API のバージョンの [接続] タブを選択します。
- デフォルトとして設定する接続の場合、[デフォルトとして設定]アクションを選択します。
HTTP コールアウトの接続の作成
HTTP コールアウトをサポートする接続を作成するには、有効化アクションプロセスを経由せずに接続を作成します。
- Salesforce で、[設定] から、[クイック検索] ボックスに「API カタログ」と入力し、[API カタログ] を選択します。
- 接続を作成する API を選択します。
- [新しい接続] をクリックします。
- API バージョンを選択します。
- デフォルトの接続の表示ラベルと名前 (デフォルトは API 参照名とバージョン) をカスタマイズするには、表示ラベルと名前をオーバータイプします。
- 説明を入力します。
- Salesforce へのこの接続の管理対象指定ログイン情報として使用する対象 URL を選択します。API カタログには、Anypoint API Manager で管理される有効な対象 URL のみが表示されます。
-
[完了] をクリックします。
外部ログイン情報、指定ログイン情報、外部サービス、権限セットなどの接続設定が自動的に作成されます。
接続のユーザー権限の割り当て
接続を作成したら、有効化されたアクションへのアクセス権を特定の Salesforce ユーザーに付与して、Salesforce オートメーションで使用できるようにします。接続の作成プロセスの一環として、API 接続の権限を割り当てるように促されます。この手順をスキップした場合は、後で権限を割り当てることができます。権限エラーを回避するには、関連付けられた API アクションを使用する前に権限を割り当てます。
- Salesforce で、[設定] から、[クイック検索] ボックスに「API カタログ」と入力し、[API カタログ] を選択します。
- 接続権限を設定する API を選択します。
-
その API の [Permission Status (権限状況)] が [Not Assigned (未割り当て)] の場合、または権限の割り当てを更新する場合は、[Assign (割り当て)] をクリックします。
API の [権限セット] ページが開きます。
- 組織の標準に従って、ユーザーの割り当てを管理および追加します。詳細は、「権限セット割り当ての管理」を参照してください。
接続の編集
接続の表示ラベルまたは説明を更新できます。
- Salesforce で、[設定] から、[クイック検索] ボックスに「API カタログ」と入力し、[API カタログ] を選択します。
- 変更する API バージョンを選択します。
- [接続] タブで、[編集] をクリックします。
- 接続の表示ラベルまたは説明を更新します。
別のリダイレクト先 URL を使用するには、新しいリダイレクト先 URL を使用して API バージョンの別の接続を作成します。
接続の削除
未使用のデフォルト以外の接続を削除します。
- Salesforce で、[設定] から、[クイック検索] ボックスに「API カタログ」と入力し、[API カタログ] を選択します。
- 削除する接続がある API を選択します。
-
[Connections]タブで、デフォルトとして設定されていない接続を選択し、[Delete]をクリックします。
デフォルトとして設定された接続を削除するには、別の接続をデフォルトとして設定し、デフォルト以外の接続を削除します。「Create and Manage Connections for Your APIs」を参照してください。
