onPremisesPublishing リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Entra アプリケーション プロキシを介して発行されたオンプレミス アプリケーションは、アプリケーション オブジェクトとそれに関連付けられている onPremisesPublishing プロパティによって表されます。 アプリケーション プロキシは、オンプレミス アプリケーションへの安全なリモート アクセスを提供します。
onPremisesPublishing オブジェクトは、オンプレミス アプリケーションのアプリケーション プロキシを構成するためのプロパティのセットを表します。
カスタム アプリケーションをインスタンス化するか、アプリケーションを作成した後、アプリケーションの onPremisesPublishing プロパティを更新することで、アプリケーションのアプリケーション プロキシ設定を構成できます。
アプリケーション プロキシの構成に関するチュートリアルについては、「 Microsoft Graph API を使用してアプリケーション プロキシの構成を自動化する」を参照してください。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| alternateUrl | String | 複数のアプリ プロキシ アプリケーションの前でトラフィック マネージャーを構成する場合、alternateUrl はトラフィック マネージャーを指すわかりやすい URL です。 |
| applicationServerTimeout | String | 接続を閉じる前に、コネクタがバックエンド アプリケーションからの応答を待機する期間。 使用可能な値は、 default、 longです。 既定値に設定すると、バックエンド アプリケーションのタイムアウトの長さは 85 秒です。 long に設定すると、バックエンド のタイムアウトが 180 秒に増加します。 サーバーが要求に応答するのに 85 秒以上かかる場合、またはアプリケーションにアクセスできず、エラー状態が "バックエンド タイムアウト" である場合は、 long を使用します。 既定値は、default です。 |
| applicationType | String | このアプリケーションがアプリケーション プロキシで構成されたアプリケーションであるかどうかを示します。 これはシステムによって事前に設定されています。 読み取り専用です。 |
| externalAuthenticationType | externalAuthenticationType | アプリケーションの事前認証設定の詳細を確認します。 事前認証では、ユーザーがアプリにアクセスする前に認証する必要があります。 パススルーでは認証は必要ありません。 可能な値は、passthru、aadPreAuthentication です。 |
| externalUrl | String | アプリケーションの発行済みの外部 URL。 たとえば、「 https://intranet-contoso.msappproxy.net/ 」のように入力します。 |
| internalUrl | String | アプリケーションの内部 URL。 たとえば、https://intranet/. のように指定します。 |
| isBackendCertificateValidationEnabled | ブール型 | アプリケーションに対してバックエンド SSL 証明書の検証が有効かどうかを示します。 新しいアプリケーション プロキシ アプリの場合、プロパティは既定で true に設定されます。 既存のすべてのアプリの場合、プロパティは false に設定されます。 |
| isHttpOnlyCookieEnabled | ブール型 | HTTPOnly Cookie フラグを HTTP 応答ヘッダーに設定する必要があるかどうかを示します。 この値を true に設定すると、アプリケーション プロキシ Cookie に HTTP 応答ヘッダーに HTTPOnly フラグが含まれます。 リモート デスクトップ サービスを使用している場合は、この値を False に設定します。 既定値は、false です。 |
| isOnPremPublishingEnabled | ブール型 | アプリケーションが現在アプリケーション プロキシ経由で発行されているかどうかを示します。 これはシステムによって事前設定されています。 読み取り専用です。 |
| isPersistentCookieEnabled | ブール型 | HTTP 応答ヘッダーで永続的 Cookie フラグを設定する必要があるかどうかを示します。 この値は false に設定したままにします。 この設定は、プロセス間で Cookie を共有できないアプリケーションにのみ使用します。 Cookie の設定の詳細については、「 Microsoft Entra ID でオンプレミス アプリケーションにアクセスするための Cookie 設定」を参照してください。 既定値は、false です。 |
| isSecureCookieEnabled | ブール型 | HTTP 応答ヘッダーで Secure Cookie フラグを設定する必要があるかどうかを示します。 暗号化された HTTPS 要求などのセキュリティで保護されたチャネル経由で Cookie を送信するには、この値を true に設定します。 既定値は、true です。 |
| isStateSessionEnabled | ブール型 | クライアントが OAuth 2.0 承認コード許可フローを使用するときの状態パラメーターの検証が有効かどうかを示します。 この設定を使用すると、管理者はアプリの CSRF 保護を有効にするかどうかを指定できます。 |
| isTranslateHostHeaderEnabled | ブール型 | アプリケーションが応答ヘッダーの URL を変換する必要があるかどうかを示します。 アプリケーションで認証要求で元のホスト ヘッダーが必要な場合を除き、この値は true のままにします。 既定値は、true です。 |
| isTranslateLinksInBodyEnabled | ブール型 | アプリケーションがアプリケーション本文の URL を翻訳する必要があるかどうかを示します。 他のオンプレミス アプリケーションへのハードコーディングされた HTML リンクがあり、カスタム ドメインを使用していない場合を除き、この値は false のままにします。 詳細については、「 アプリケーション プロキシを使用して翻訳をリンクする」を参照してください。 既定値は、false です。 |
| onPremisesApplicationSegments (非推奨) | onPremisesApplicationSegment コレクション | オンプレミスのワイルドカード アプリケーションのアプリケーション セグメント コレクションを表します。 このプロパティは非推奨であり、2023 年 6 月 1 日にデータの返しを停止します。 代わりに segmentsConfiguration を 使用します。 |
| segmentsConfiguration | segmentConfiguration | Microsoft Entra アプリケーション プロキシを通じて発行されるオンプレミスのワイルドカード アプリケーションのアプリケーション セグメントのコレクションを表します。 |
| singleSignOnSettings | onPremisesPublishingSingleSignOn | オンプレミス アプリケーションのシングル サインオン構成を表します。 |
| verifiedCustomDomainCertificatesMetadata | verifiedCustomDomainCertificatesMetadata | カスタム ドメインが使用されている場合にアプリケーションに関連付けられている証明書の詳細。
null 既定のドメインを使用する場合。 読み取り専用です。 |
| verifiedCustomDomainKeyCredential | keyCredential | 使用されるカスタム ドメインに関連付けられているキー資格情報。 |
| verifiedCustomDomainPasswordCredential | passwordCredential | 使用されるカスタム ドメインに関連付けられているパスワード資格情報。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"alternateUrl": "String",
"applicationServerTimeout": "String",
"applicationType": "String",
"externalAuthenticationType": "String",
"externalUrl": "String",
"internalUrl": "String",
"isBackendCertificateValidationEnabled": true,
"isHttpOnlyCookieEnabled": true,
"isOnPremPublishingEnabled": true,
"isPersistentCookieEnabled": true,
"isSecureCookieEnabled": true,
"isStateSessionEnabled": true,
"isTranslateHostHeaderEnabled": true,
"isTranslateLinksInBodyEnabled": true,
"onPremisesApplicationSegments":[{"@odata.type":"microsoft.graph.onPremisesApplicationSegment"}],
"segmentsConfiguration":{"@odata.type":"microsoft.graph.segmentConfiguration"},
"singleSignOnSettings": {"@odata.type": "microsoft.graph.onPremisesPublishingSingleSignOn"},
"verifiedCustomDomainCertificatesMetadata": {"@odata.type": "microsoft.graph.verifiedCustomDomainCertificatesMetadata"},
"verifiedCustomDomainKeyCredential": {"@odata.type": "microsoft.graph.keyCredential"},
"verifiedCustomDomainPasswordCredential": {"@odata.type": "microsoft.graph.passwordCredential"}
}