名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Entra アプリケーション プロキシを介して公開されたオンプレミス アプリケーションは、アプリケーション オブジェクトとそれに関連付けられている onPremisesPublishing プロパティによって表されます。 アプリケーション プロキシは、オンプレミス アプリケーションへの安全なリモート アクセスを提供します。
onPremisesPublishing オブジェクトは、オンプレミス アプリケーションのアプリケーション プロキシを構成するためのプロパティ セットを表します。
カスタム アプリケーションをインスタンス化するかアプリケーションを作成した後、アプリケーションのアプリケーション プロキシ設定は、アプリケーションの onPremisesPublishing プロパティを更新することによって構成できます。
アプリケーション プロキシの構成に関するチュートリアルについては、「Microsoft Graph API を使用したアプリケーション プロキシの構成の自動化」を参照してください。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| alternateUrl | 文字列 | 複数のアプリ プロキシ アプリケーションの前でトラフィック マネージャーを構成している場合、このわかりやすい URL はトラフィック マネージャーを指します。 |
| applicationServerTimeout | 文字列 | コネクタが接続を閉じる前にバックエンド アプリケーションからの応答を待機する時間。 指定可能な値は default、 long です。 既定に設定すると、バックエンド アプリケーションのタイムアウトの長さは 85 秒になります。 long に設定すると、バックエンド タイムアウトは 180 秒に増加します。 サーバーが要求に応答するのに 85 秒以上かかる場合、またはアプリケーションにアクセスできず、エラー状態が "バックエンド タイムアウト" の場合は、 long を使用します。 既定値は、default です。 |
| applicationType | 文字列 | このアプリケーションがアプリケーション プロキシで構成されたアプリケーションであるかどうかを示すシステム定義の値。 有効な値は quickaccessapp および nonwebapp です。 読み取り専用です。 |
| externalAuthenticationType | externalAuthenticationType | アプリケーションの事前認証設定の詳細を説明します。 事前認証では、ユーザーはアプリにアクセスする前に認証する必要があります。 パススルーでは認証は必要ありません。 可能な値は passthru、 aadPreAuthentication です。 |
| externalUrl | 文字列 | アプリケーションの公開済み外部 URL。 たとえば、「 https://intranet-contoso.msappproxy.net/ 」のように入力します。 |
| internalUrl | 文字列 | アプリケーションの内部 URL。 たとえば、「 https://intranet/ 」のように入力します。 |
| isAccessibleViaZTNAClient | ブール型 | 管理対象デバイス上の グローバル セキュア アクセス クライアント を介してアプリケーションにアクセスできるかどうかを示します。 |
| isBackendCertificateValidationEnabled | ブール型 | バックエンド SSL 証明書の検証がアプリケーションに対して有効になっているかどうかを示します。 すべての新しい アプリケーション プロキシ アプリでは、このプロパティは既定で true に設定されます。 すべての既存のアプリの場合、このプロパティは false に設定されます。 |
| isContinuousAccessEvaluationEnabled | ブール型 | アプリケーション プロキシ アプリケーションに対して継続的アクセス評価が有効になっているかどうかを示します。 すべてのアプリケーション プロキシ アプリについて、このプロパティは既定で true に設定されています。 |
| isDnsResolutionEnabled | ブール型 | Microsoft Entra Private Access が DNS 解決を処理する必要があることを示します。 既定では false です。 |
| isHttpOnlyCookieEnabled | ブール型 | HTTP 応答ヘッダーに HTTPOnly Cookie フラグを設定する必要があるかどうかを示します。 この値を true に設定すると、アプリケーション プロキシ Cookie で HTTP 応答ヘッダーに HTTPOnly フラグが含まれます。 リモート デスクトップ サービスを使用している場合は、この値を False に設定します。 既定値は、false です。 |
| isOnPremPublishingEnabled | ブール型 | アプリケーションが現在アプリケーション プロキシ経由で公開されているかどうかを示します。 これはシステムによって事前設定されています。 読み取り専用です。 |
| isPersistentCookieEnabled | ブール型 | HTTP 応答ヘッダーに永続的 Cookie フラグを設定する必要があるかどうかを示します。 この値は false に設定したままにします。 この設定は、プロセス間で Cookie を共有できないアプリケーションにのみ使用します。 Cookie 設定の詳細については、「Microsoft Entra ID のオンプレミス アプリケーションにアクセスするための Cookie 設定」を参照してください。 既定値は、false です。 |
| isSecureCookieEnabled | ブール型 | HTTP 応答ヘッダーでセキュリティで保護された 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 を使用してください。 |
| セグメント設定 | segmentConfiguration | Microsoft Entra アプリケーション プロキシを介して公開されるオンプレミス ワイルドカード アプリケーションのアプリケーション セグメントのコレクションを表します。 |
| singleSignOnSettings | onPremisesPublishingSingleSignOn | オンプレミス アプリケーションのシングル サインオン構成を表します。 |
| trafficRoutingMethod | trafficRoutingMethod | コネクタ グループ内の複数のコネクタ間でトラフィックがどのように分散されるかを示します。 指定できる値は、 none、 random、 sessionPersistence、 performance (Not implemented)、 unknownFutureValue です。 |
| useAlternateUrlForTranslationAndRedirect | ブール型 | アプリケーションで externalUrl ではなく alternateUrl を使用する必要があるかどうかを示します。 |
| verifiedCustomDomainCertificatesMetadata | verifiedCustomDomainCertificatesMetadata | カスタム ドメインが使用されている場合にアプリケーションに関連付けられている証明書の詳細。
null 既定のドメインを使用する場合。 読み取り専用です。 |
| verifiedCustomDomainKeyCredential | keyCredential | 使用されるカスタム ドメインに関連付けられているキー資格情報。 |
| verifiedCustomDomainPasswordCredential | passwordCredential | 使用されるカスタム ドメインに関連付けられているパスワード資格情報。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"alternateUrl": "String",
"applicationServerTimeout": "String",
"applicationType": "String",
"externalAuthenticationType": "String",
"externalUrl": "String",
"internalUrl": "String",
"isAccessibleViaZTNAClient": "Boolean",
"isBackendCertificateValidationEnabled": true,
"isContinuousAccessEvaluationEnabled": "Boolean",
"isDnsResolutionEnabled": "Boolean",
"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"},
"trafficRoutingMethod": "String",
"useAlternateUrlForTranslationAndRedirect": "Boolean",
"verifiedCustomDomainCertificatesMetadata": {"@odata.type": "microsoft.graph.verifiedCustomDomainCertificatesMetadata"},
"verifiedCustomDomainKeyCredential": {"@odata.type": "microsoft.graph.keyCredential"},
"verifiedCustomDomainPasswordCredential": {"@odata.type": "microsoft.graph.passwordCredential"}
}