ConnectedApp

接続アプリケーションに複数の権限セットを割り当てることができますが、各権限セット名は別の行に入力する必要があります。同じ権限セット名を各接続アプリケーションについて複数回入力することはできません。

現在の権限セットを新しい権限セットに置き換えることで、権限セットを変更することもできます。接続アプリケーションに割り当てられた各権限セット名が一意であることを確認してください。

個々の権限セットを削除したり、接続アプリケーションのリリース: (<permissionSetName></permissionSetName>) で空の permissionSetName 文字列を入力することですべての権限セットを接続アプリケーションから削除したりできます。

この項目を使用するには、ConnectedAppOauthConfig サブタイプの isAdminApproved 項目を true に設定する必要があります。

組織に含まれるユーザーを入力します。ユーザーが組織に含まれない場合、接続アプリケーションをリリースしたときにユーザーがこの項目から削除されます。ユーザーを指定しない場合は、この項目を空白のままにできます。

組織でこの項目を使用するには、ConAppPluginExecuteAsUser 設定を有効にする必要があります。

接続アプリケーションに複数のプロファイルを割り当てることができますが、各プロファイル名は別の行に入力する必要があります。同じプロファイル名を各接続アプリケーションについて複数回入力することはできません。

現在のプロファイルを新しいプロファイルに置き換えることで、プロファイルを変更することもできます。接続アプリケーションに割り当てられた各プロファイル名が一意であることを確認してください。

個々のプロファイルを削除することも接続アプリケーションのリリース: (<profileName></profileName>) で空の profileName 文字列を入力することですべてのプロファイルを接続アプリケーションから削除することもできます。

この項目を使用するには、ConnectedAppOauthConfig サブタイプの isAdminApproved 項目を true に設定する必要があります。

• Get — OAuth 認証が使用され、サードパーティアプリケーションがユーザー情報にアクセスすることを許可するように求められます。このアクセスメソッドを使用する場合、キャンバスアプリケーションで OAuth 認証フローが開始されるようにする必要があります。
• Post — OAuth 認証を使用しますが、システム管理者がキャンバスアプリケーションをインストールする場合、キャンバスアプリケーションはユーザーのアクセスを暗黙的に許可します。したがって、サードパーティがユーザー情報にアクセスすることを許可するようにユーザーが求められることはありません。このアクセスメソッドを使用する場合、認証は直接キャンバスアプリケーションの URL に post 送信されます。

API バージョン 31.0 以降で利用できます。

• Aura — 今後の使用のために予約されています。
• AppLauncher — 今後の使用のために予約されています。
• Chatter — キャンバスアプリケーションを Chatter タブのアプリケーションナビゲーションリストに表示できます。
• ChatterFeed — キャンバスアプリケーションを Chatter フィード項目として表示できます。
• MobileNav — キャンバスアプリケーションを Salesforce モバイルアプリケーションのモバイルカードに表示できます。API バージョン 31.0 以降で利用できます。
• None — キャンバスアプリケーションをキャンバスアプリケーションのプレビューアーでのみ表示できます。
• OpenCTI — キャンバスアプリケーションをコール制御ツールに表示できます。
• PageLayout — キャンバスアプリケーションをページレイアウトに表示できます。Salesforce モバイルアプリケーションで参照する場合、キャンバスアプリケーションはレコード詳細ページに表示されます。API バージョン 31.0 以降で利用できます。
• Publisher — キャンバスアプリケーションをグローバルアクションとして表示できます。
• ServiceDesk — キャンバスアプリケーションを Salesforce コンソールのフッターまたはサイドバーに表示できます。
• UserProfile — 今後の使用のために予約されています。
• Visualforce — キャンバスアプリケーションを Visualforce ページに表示できます。

• HideShare — 関連するキャンバスアプリケーションのパブリッシャーで [共有] ボタンが非表示になります。API バージョン 30.0 以降で利用できます。
• HideHeader — 関連するキャンバスアプリケーションのパブリッシャーでヘッダーが非表示になります。API バージョン 30.0 以降で利用できます。
• PersonalEnabled — エンドユーザーは、アプリケーションをキャンバス個人用アプリケーションとしてインストールできます。API バージョン 32.0 以降で利用できます。

• IdpInitiated — ID プロバイダーが開始します。Salesforce は、SSO フローを開始するための初期要求を行います。
• SpInitiated — サービスプロバイダーが開始します。キャンバスアプリケーションは、呼び出された後に SSO フローを開始します。
• None — キャンバスアプリケーションは SAML SSO を使用していません。API バージョン 31.0 以降で利用できます。

API バージョン 32.0 以降では、この項目の値を設定できるのは作成中のみです。値を定義して保存した後は、編集できません。値は 8 ～ 256 文字の英数字にする必要があり、特殊文字とスペースは使用できません。コンシューマー鍵はグローバルに一意である必要があります。

値は、8 文字以上 (256 文字以下) の英数字 (特殊文字とスペースは不可) にする必要があります。組織で別の接続アプリケーションにすでに使用されている秘密を指定した場合、エラーが発生します。

API バージョン 32.0 以降で利用できます。

true に設定すると、適切なプロファイルまたは権限セットを持つユーザーのみがアプリケーションにアクセスできます。このユーザーは、アプリケーションにアクセスする前に承認する必要はありません。各プロファイルの [接続アプリケーションへのアクセス] リストを編集して、アプリケーションのプロファイルを管理します。各権限セットの [割り当てられた接続アプリケーション] リストを編集して、アプリケーションの権限セットを管理します。この設定は、Group Edition では使用できません。API バージョン 46.0 以降で利用できます。

接続アプリケーションのコンシューマーは、組織で接続アプリケーションをリリースするときにこの設定を編集できます。

false (デフォルト) に設定した場合、接続アプリケーションは、クライアントのログイン情報フローを使用できません。

API バージョン 56.0 以降で利用できます。

true に設定した場合、接続アプリケーションで認証コードとログイン情報フローおよび関連するヘッドレス ID 機能をすべて使用できます。デフォルト値は false です。

この項目は、API バージョン 57.0 以降で利用できます。

true に設定されている場合は、ユーザーのログイン情報を POST 本文に含める必要があります。デフォルト値は false です。

この項目は、API バージョン 57.0 以降で利用できます。

クライアントアプリケーションでクライアントの秘密の機密性を維持できず、かつ Web サーバーフローを使用する必要があるときは、true に設定します。接続アプリケーション用にクライアントの秘密は依然として生成されますが、この設定で、アクセストークン要求内の client_secret パラメーターが不要であることを Web サーバーフローに指示します。秘密を使用しない Web サーバーフローよりもセキュアなオプションとしてユーザーエージェントフローをお勧めします。API バージョン 49.0 以降で利用できます。

false に設定した場合、接続アプリケーションで調査できるのは自身のトークンのみです。また、動的クライアント登録エンドポイントを介して OAuth 2.0 接続アプリケーションを直接登録している OAuth クライアントは、自身とその登録済みアプリケーションのトークンを確認できます。API バージョン 49.0 以降で利用できます。

この項目は、API バージョン 59.0 以降で正式に使用できます。

true に設定すると、PKCE 拡張は必須となり、実装されていない認証コードフローのバリエーションは失敗します。false に設定した場合でも PKCE を実装することは可能ですが、必須ではありません。デフォルト値は false です。

この項目は、API バージョン 59.0 以降で利用できます。

この項目は、API バージョン 60.0 以降で使用できます。

クライアントの秘密を保���できる Web サーバーベースのアプリケーションでは、このオプションを選択します。モバイルアプリケーションやユーザーのコンピューターにインストールするアプリケーションなど、クライアントの秘密を保護できないアプリケーションでは、このオプションを選択しないことをお勧めします。API バージョン 51.0 以降で利用できます。

この項目は、API バージョン 60.0 以降で使用できます。

この項目は、API バージョン 60.0 以降で使用できます。

この項目を使用するには、isClientCredentialEnabled を true に設定し、consumerKey を指定します。

API バージョン 56.0 以降で利用できます。

• Basic — ID URL サービスへのアクセスを許可します (Address、Email、Phone、Profile をリリースする場合と同じ動作)。
• Api — API を介したログインユーザーのアカウントへのアクセスを許可します。
• Web — Web で access_token を使用することを許可します。この使用には visualforce も含まれ、Visualforce ページへのアクセスが許可されます。
• Full — ログインユーザーがアクセスできるすべてのデータへのアクセスを許可します。
• Chatter — Connect REST API リソースへのアクセスのみを許可します。
• CustomApplications — Visualforce を使用したカスタムアプリケーションなどのカスタムアプリケーションへのアクセスを提供します。
• RefreshToken — 更新トークンを受信できる場合に、それを返すことを指定します (OfflineAccess をリリースする場合と同じ動作)。
• OpenID — ログインユーザーの OpenID Connect アプリケーションの一意の識別子へのアクセスを許可します。
• Profile — ログインユーザーのプロファイルへのアクセスを許可します (Basic をリリースする場合と同じ動作)。
• Email — ログインユーザーのメールアドレスへのアクセスを許可します (Basic をリリースする場合と同じ動作)。
• Address — ログインユーザーの住所へのアクセスを許可します (Basic をリリースする場合と同じ動作)。
• Phone — ログインユーザーの電話番号値へのアクセスを許可します (Basic をリリースする場合と同じ動作)。
• OfflineAccess — ユーザーがオフラインのときにアプリケーションがユーザーのデータを操作し更新トークンを取得することを許可します (RefreshToken をリリースする場合と同じ動作)。
• CustomPermissions — 接続アプリケーションに関連付けられている組織のカスタム権限へのアクセスを許可し現在のユーザーで各権限が有効かどうかを示します。
• Wave — Analytics REST API リソースへのアクセスを許可します。API バージョン 35.0 以降で利用できます。
• Eclair — Analytics REST API Charts Geodata リソースへのアクセスを許可します。API バージョン 35.0 以降で利用できます。
• Pardot — ユーザーの代わりに Pardot API サービスへアクセスすることを許可します。アクセス可能なすべてのサービスは、Pardot アカウントで管理します。API バージョン 49.0 以降で利用できます。
• Lightning — ハイブリッドアプリケーションが OAuth 2.0 ハイブリッドアプリケーショントークンフローおよびハイブリッドアプリケーション更新トークンフローを介して Lightning の子セッションを直接取得できるようにします。API バージョン 51.0 以降で利用できます。
• Content — ハイブリッドアプリケーションが OAuth 2.0 ハイブリッドアプリケーショントークンフローおよびハイブリッドアプリケーション更新トークンフローを介してコンテンツの子セッションを直接取得できるようにします。API バージョン 51.0 以降で利用できます。
• CDPIngest — Data Cloud の取り込み API サービスにアクセスできるようにします。顧客はこれらの API サービスを使用して、Data Cloud の外部データセットのアップロードと管理を行います。API バージョン 52.0 以降で利用できます。
• Chatbot — Einstein ボット API サービスへのアクセスを許可します。API バージョン 54.0 以降で利用できます。
• ForgotPassword — パスワードを忘れた場合のヘッドレス API へのアクセスを許可します。内部インテグレーションユーザーに割り当てることで、この API へ認証済み要求を送るためのアクセストークンを取得できます。API バージョン 57.0 以降で利用できます。
• UserRegistration — ヘッドレス登録 API へのアクセスを許可します。内部インテグレーションユーザーに割り当てることで、この API へ認証済み要求を送るためのアクセストークンを取得できます。API バージョン 58.0 以降で利用できます。
• PwdlessLogin — パスワードなしのヘッドレスログイン API へのアクセスを許可します。内部インテグレーションユーザーに割り当てることで、この API へ認証済み要求を送るためのアクセストークンを取得できます。API バージョン 59.0 以降で利用できます。

メタデータを取得する場合の有効値は次のとおりです。

• Api — API を介したログインユーザーのアカウントへのアクセスを許可します。
• Basic — ID URL サービスへのアクセスを許可し、Address、Email、Phone、Profile を含めます。
• Chatter — Connect REST API リソースへのアクセスのみを許可します。
• CustomApplications — Visualforce を使用したカスタムアプリケーションなどのカスタムアプリケーションへのアクセスを許可します。
• Full — ログインユーザーがアクセスできるすべてのデータへのアクセスを許可します。
• OpenID — ログインユーザーの OpenID Connect アプリケーションの一意の識別子へのアクセスを許可します。
• CDPIngest — Data Cloud の取り込み API サービスにアクセスできるようにします。顧客はこれらの API サービスを使用して、Data Cloud の外部データセットのアップロードと管理を行います。API バージョン 52.0 以降で利用できます。
• Pardot — ユーザーの代わりに Pardot API サービスへアクセスすることを許可します。アクセス可能なすべてのサービスは、Pardot アカウントで管理します。API バージョン 49.0 以降で利用できます。
• Lightning — ハイブリッドアプリケーションが OAuth 2.0 ハイブリッドアプリケーショントークンフローおよびハイブリッドアプリケーション更新トークンフローを介して Lightning の子セッションを直接取得できるようにします。API バージョン 51.0 以降で利用できます。
• Content — ハイブリッドアプリケーションが OAuth 2.0 ハイブリッドアプリケーショントークンフローおよびハイブリッドアプリケーション更新トークンフローを介してコンテンツの子セッションを直接取得できるようにします。API バージョン 51.0 以降で利用できます。
• RefreshToken — 更新トークンを受信できる場合にそれを返すように指定します。OfflineAccess を許可する場合と同じです。
• Wave — Analytics REST API リソースへのアクセスを許可します。API バージョン 35.0 以降で利用できます。
• Eclair — Analytics REST API Charts Geodata リソースへのアクセスを許可します。API バージョン 35.0 以降で利用できます。
• Web — Web で access_token を使用することを許可します。この使用には visualforce も含まれ、Visualforce ページへのアクセスが許可されます。
• Chatbot — Einstein ボット API サービスへのアクセスを許可します。API バージョン 54.0 以降で利用できます。
• ForgotPassword — パスワードを忘れた場合のヘッドレス API へのアクセスを許可します。内部インテグレーションユーザーに割り当てることで、この API へ認証済み要求を送るためのアクセストークンを取得できます。API バージョン 57.0 以降で利用できます。
• UserRegistration — ヘッドレス登録 API へのアクセスを許可します。内部インテグレーションユーザーに割り当てることで、この API へ認証済み要求を送るためのアクセストークンを取得できます。API バージョン 58.0 以降で利用できます。
• PwdlessLogin — パスワードなしのヘッドレスログイン API へのアクセスを許可します。内部インテグレーションユーザーに割り当てることで、この API へ認証済み要求を送るためのアクセストークンを取得できます。API バージョン 59.0 以降で利用できます。

• ENFORCE (デフォルト) — ユーザープロファイルに割り当てられた IP 範囲など、組織に対して設定された IP 制限を適用します。
• BYPASS_2FACTOR — アプリケーションを実行しているユーザーは、次のいずれかの条件を満たす場合に、組織の IP 制限をスキップできます。
  • アプリケーションに許可された IP 範囲のリストが存在し、アプリケーションが Web サーバーの OAuth 認証フローを使用している。これらの IP から送信された要求のみが許可されます。
  • アプリケーションに許可された IP 範囲のリストが存在しないが、アプリケーションが Web サーバーの認証フローを使用している。新しいブラウザーまたはデバイスから Salesforce にアクセスした場合、ユーザーは ID 検証を正常に完了する。
• BYPASS — ユーザーは組織の IP 制限なしでこのアプリケーションを実行できます。
• ENFORCE_RELAXREFRESH — ユーザープロファイルに割り当てられた IP 範囲など、組織に対して設定された IP 制限を適用します。ただし、このオプションでは、接続アプリケーションが更新トークンを使用してアクセストークンを取得する場合、この制限はスキップされます。

更新トークンを提供する場合、ユーザーはアクセストークンの期限 (セッションタイムアウト値で定義) が切れても再承認することなく OAuth 対応の接続アプリケーションに引き続きアクセスできます。接続アプリケーションは、更新トークンをアクセストークンと交換して新しいセッションを開始します。更新トークンポリシーは、発行された更新トークンの使用時にのみ評価され、ユーザーの現在のセッションに影響を与えることはありません。更新トークンは、ユーザーのセッションが期限切れになったか、使用できないときにのみ必要になります。たとえば、1 時間後にトークンが期限切れになるように更新トークンポリシーを設定します。ユーザーがアプリケーションを 2 時間使用する場合、1 時間後にユーザーが再認証を強制されることはありません。ただし、セッションの期限が切れ、クライアントが新しいセッションのための更新トークンの交換を試みた場合、ユーザーは再度認証を要求されます。

有効なオプションは、次のとおりです。

• zero — 更新トークンは直ちに無効になります。ユーザーはすでに発行されている現在のセッション (アクセストークン) を使用できますが、アクセストークンの期限が切れたときに新しいセッションを取得することはできません。
• infinite — ユーザーまたは Salesforce システム管理者が取り消さない限り、更新トークンを無期限に使用できます。デフォルト設定。
• specific_lifetime:number:HOURS, DAYS, MONTHS — 更新トークンは一定期間有効です。たとえば、ポリシーで specific_lifetime:1:DAYS に設定されている場合、ユーザーは 24 時間のみ新しいセッションを取得できます。
• specific_inactivity:number:HOURS, DAYS, MONTHS — 更新トークンは、指定された期間内で使用されている限り、有効です。たとえば、specific_inactivity:7:DAYS に設定されている場合、更新トークンが 7 日以内に新しいセッションのために交換されなければ、次のトークン使用の試行は失敗します。期限切れのトークンは新しいセッションを生成できません。更新トークンが 7 日以内に交換された場合、そのトークンはさらに次の 7 日間有効です。無操作状態の監視期間もリセットされます。

SamlEncryptionType

• AES_128 — 128 ビットの鍵
• AES_256 — 256 ビットの鍵
• Triple_Des — トリプル DES アルゴリズム

• PostBinding
• RedirectBinding

• Unspecified (デフォルト) — 形式は指定されません。
• EmailAddress — 件名種別がユーザーの名前または統合 ID (SP の内部の ID) である場合に使用します。
• Persistent — ユーザー ID および永続 ID の件名種別と併用します。
• Transient — 件名種別がカスタム属性である場合に使用し、ユーザーがログインするたびに変更される可能性があります。

• SHA1
• SHA256

• Username — Salesforce ユーザー名。
• FederationId — サービスプロバイダーでのユーザーの識別子。この値はサービスプロバイダーから取得します。
• UserId — 15 文字の Salesforce ユーザー識別子。
• PersistentID — ID プロバイダーおよびサービスプロバイダーに固有の永続的で不透明な識別子。
• CustomAttr — samlSubjectCustomAttr のカスタム項目値から取得する識別子。

• Block — 組織のユーザーが接続アプリケーションにアクセスできなくなります。アプリケーションをブロックすると、接続アプリケーションを使用する現在のすべてのユーザーセッションが終了し、すべての新しいセッションが防止されます。
• RaiseSessionLevel — ユーザーが接続アプリケーションにログインするときに多要素認証を使用して ID を検証することを要求します。この設定は、API ログインのユーザー承認ステップを含む承認フローに適用されます。これらのフローは、OAuth 2.0 更新トークンフロー、Web サーバーフロー、ユーザーエージェントフローです。JSON Web トークン (JWT) ベアラーフローなど、その他のフローにはユーザー承認ステップは含まれていません。ユーザー承認ステップのないフローでは、高保証セッションセキュリティレベルでの API ログインはブロックされます。