iosikEv2VpnConfiguration を作成する
名前空間: microsoft.graph
大事な: /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
新しい iosikEv2VpnConfiguration オブジェクトを 作成します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
---|---|
委任 (職場または学校のアカウント) | DeviceManagementConfiguration.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 |
アプリケーション | DeviceManagementConfiguration.ReadWrite.All |
HTTP 要求
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
要求ヘッダー
ヘッダー | 値 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
承諾 | application/json |
要求本文
要求本文で、iosikEv2VpnConfiguration オブジェクトの JSON 表現を指定します。
次の表は、iosikEv2VpnConfiguration を作成するときに必要なプロパティを示しています。
プロパティ | 型 | 説明 |
---|---|---|
id | String | エンティティのキー。 deviceConfiguration から継承します |
lastModifiedDateTime | DateTimeOffset | オブジェクトの最終更新の DateTime。 deviceConfiguration から継承します |
roleScopeTagIds | String collection | このエンティティ インスタンスのスコープ タグの一覧。 deviceConfiguration から継承します |
supportsScopeTags | ブール型 | 基になるデバイス構成がスコープ タグの割り当てをサポートするかどうかを示します。 ScopeTags プロパティへの割り当ては、この値が false であり、スコープ付きユーザーにエンティティが表示されない場合は許可されません。 これは Silverlight で作成されたレガシ ポリシーに対して発生し、Azure Portal でポリシーを削除して再作成することで解決できます。 このプロパティは読み取り専用です。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | このポリシーの OS エディションの適用性。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | このポリシーの OS バージョンの適用規則。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | このポリシーのデバイス モードの適用規則。 deviceConfiguration から継承します |
createdDateTime | DateTimeOffset | オブジェクトが作成された DateTime。 deviceConfiguration から継承します |
description | String | 管理者が指定した、デバイス構成についての説明。 deviceConfiguration から継承します |
displayName | String | 管理者が指定した、デバイス構成の名前。 deviceConfiguration から継承します |
version | Int32 | デバイス構成のバージョン。 deviceConfiguration から継承します |
connectionName | String | ユーザーに表示される接続名。 appleVpnConfiguration から継承 |
connectionType | appleVpnConnectionType | 接続の種類。
appleVpnConfiguration から継承されます。 使用できる値は、 ciscoAnyConnect 、 pulseSecure 、 f5EdgeClient 、 dellSonicWallMobileConnect 、 checkPointCapsuleVpn 、 customVpn 、 ciscoIPSec 、 citrix 、 ciscoAnyConnectV2 、 paloAltoGlobalProtect zscalerPrivateAccess 、 f5Access2018 、 citrixSso 、 paloAltoGlobalProtectV2 、 ikEv2 alwaysOn 、 microsoftTunnel 、 netMotionMobility 、 microsoftProtect です。 |
loginGroupOrDomain | String | 接続の種類が Dell SonicWALL Mobile Connection に設定されている場合のログイン グループまたはドメイン。 appleVpnConfiguration から継承 |
role | String | 接続の種類が Pulse Secure に設定されている場合のロール。 appleVpnConfiguration から継承 |
国土 | String | 接続の種類が Pulse Secure に設定されている場合の領域。 appleVpnConfiguration から継承 |
サーバー | vpnServer | ネットワーク上の VPN サーバー。 エンド ユーザーがこのネットワークの場所にアクセスできることを確認します。 appleVpnConfiguration から継承 |
識別子 | String | 接続の種類がカスタム VPN に設定されている場合に、VPN ベンダーによって提供される識別子。 例: Cisco AnyConnect は、appleVpnConfiguration から継承された com.cisco.anyconnect.applevpn.plugin という形式の識別子を使用します |
customData | keyvalue コレクション | 接続の種類が [カスタム VPN] に設定されている場合のカスタム データ。 このフィールドを使用して、Intuneでサポートされていない機能を有効にし、VPN ソリューションで使用できます。 これらのキーと値のペアを追加する方法については、VPN ベンダーにお問い合わせください。 このコレクションには、最大 25 個の要素を含めることができます。 appleVpnConfiguration から継承 |
customKeyValueData | keyValuePair コレクション | 接続の種類が [カスタム VPN] に設定されている場合のカスタム データ。 このフィールドを使用して、Intuneでサポートされていない機能を有効にし、VPN ソリューションで使用できます。 これらのキーと値のペアを追加する方法については、VPN ベンダーにお問い合わせください。 このコレクションには、最大 25 個の要素を含めることができます。 appleVpnConfiguration から継承 |
enableSplitTunneling | ブール型 | VPN 経由ですべてのネットワーク トラフィックを送信します。 appleVpnConfiguration から継承 |
authenticationMethod | vpnAuthenticationMethod | この VPN 接続の認証方法。
appleVpnConfiguration から継承されます。 可能な値は、certificate 、usernameAndPassword 、sharedSecret 、derivedCredential 、azureAD です。 |
enablePerApp | ブール型 | これを true に設定すると、後でエンド ユーザー Per-App iOS デバイスでこの VPN コネシトンをトリガーできるアプリに関連付けることができる VPN ペイロードが作成されます。 appleVpnConfiguration から継承 |
safariDomains | String collection | アプリごとのこの VPN 設定が有効になっている場合の Safari ドメイン。 この VPN に関連付けられているアプリに加えて、ここで指定した Safari ドメインもこの VPN 接続をトリガーできます。 appleVpnConfiguration から継承 |
onDemandRules | vpnOnDemandRule コレクション | オンデマンド ルール。 このコレクションには、最大で 500 個の要素を含めることができます。 appleVpnConfiguration から継承 |
providerType | vpnProviderType | アプリごとの VPN のプロバイダーの種類。
appleVpnConfiguration から継承されます。 可能な値は notConfigured 、appProxy 、packetTunnel です。 |
associatedDomains | String collection | appleVpnConfiguration から継承された関連ドメイン |
excludedDomains | String collection | アプリごとの VPN がアクティブ化されている場合でも、VPN ではなくパブリック インターネット経由でアクセスされるドメイン appleVpnConfiguration から継承 |
disableOnDemandUserOverride | ブール型 | AppleVpnConfiguration から継承された設定アプリでユーザーが自動 VPN を無効にできないように切り替える |
disconnectOnIdle | ブール型 | オンデマンド接続アイドル後に切断するかどうか appleVpnConfiguration から継承 |
disconnectOnIdleTimerInSeconds | Int32 | オンデマンド接続を切断するまでの待機時間 (秒単位)。 有効な値 0 から 65535 appleVpnConfiguration から継承 |
proxyServer | vpnProxyServer | プロクシ。 appleVpnConfiguration から継承 |
optInToDeviceIdSharing | ブール型 | ネットワーク アクセス制御の検証中に使用するために、デバイスの ID をサード パーティの vpn クライアントに共有する Opt-In。 appleVpnConfiguration から継承 |
userDomain | String | Zscaler のみ。 Zscaler アプリでログイン フィールドに事前設定する静的ドメインを入力します。 空のままにすると、代わりにユーザーの Azure Active Directory ドメインが使用されます。 iosVpnConfiguration から継承 |
strictEnforcement | ブール型 | Zscaler のみ。 ユーザーが Zscaler アプリにサインインするまで、ネットワーク トラフィックをブロックします。 "True" は、トラフィックがブロックされていることを意味します。 iosVpnConfiguration から継承 |
cloudName | String | Zscaler のみ。 ユーザーが割り当てられている Zscaler クラウド。 iosVpnConfiguration から継承 |
excludeList | String collection | Zscaler のみ。 Zscaler クラウドを介して送信されないネットワーク アドレスの一覧。 iosVpnConfiguration から継承 |
targetedMobileApps | appListItem コレクション | 対象となるモバイル アプリ。 このコレクションには、最大で 500 個の要素を含めることができます。 iosVpnConfiguration から継承 |
microsoftTunnelSiteId | String | Microsoft Tunnel サイト ID。 iosVpnConfiguration から継承 |
childSecurityAssociationParameters | iosVpnSecurityAssociationParameters | 子セキュリティ関連付けパラメーター |
clientAuthenticationType | vpnClientAuthenticationType | VPN クライアントが使用するクライアント認証の種類。 可能な値は、userAuthentication 、deviceAuthentication です。 |
deadPeerDetectionRate | vpnDeadPeerDetectionRate | ピア接続がまだアクティブであるかどうかをチェックする頻度を決定します。 . 使用可能な値: medium 、none 、low 、high 。 |
disableMobilityAndMultihoming | ブール型 | MOBIKE を無効にする |
disableRedirect | ブール型 | リダイレクトを無効にする |
enableCertificateRevocationCheck | ブール型 | ベスト エフォート失効チェックを有効にします。サーバーの応答タイムアウトによって失敗することはありません |
enableEAP | ブール型 | EAP のみの認証を有効にする |
enablePerfectForwardSecrecy | ブール型 | 完全前方秘密 (PFS) を有効にします。 |
enableUseInternalSubnetAttributes | ブール型 | [内部サブネット属性の使用] を有効にします。 |
localIdentifier | vpnLocalIdentifier | VPN 経由で接続しようとしているクライアントを識別する方法。 . 可能な値は deviceFQDN 、empty 、clientCertificateSubjectName です。 |
remoteIdentifier | String | IKEv2 サーバーのアドレス。 FQDN、UserFQDN、ネットワーク アドレス、または ASN1DN である必要があります |
securityAssociationParameters | iosVpnSecurityAssociationParameters | セキュリティ関連付けパラメーター |
serverCertificateCommonName | String | サーバー認証で使用される IKEv2 サーバー証明書の一般的な名前 |
serverCertificateIssuerCommonName | String | 発行者 認証で使用される IKEv2 サーバー証明書発行者の共通名 |
serverCertificateType | vpnServerCertificateType | VPN サーバーが認証のために VPN クライアントに提示する証明書の種類。 使用可能な値: rsa 、ecdsa256 、ecdsa384 、ecdsa521 。 |
sharedSecret | String | 共有シークレット認証が選択されている場合に使用されます |
tlsMaximumVersion | String | EAP-TLS 認証で使用される TLS の最大バージョン |
tlsMinimumVersion | String | EAP-TLS 認証で使用する TLS の最小バージョン |
allowDefaultSecurityAssociationParameters | ブール型 | 明示的に指定しない限り、すべてのパラメーターをデバイスの既定値に設定することで、セキュリティ関連付けパラメーターを使用できるようにします。 |
allowDefaultChildSecurityAssociationParameters | ブール型 | 明示的に指定しない限り、すべてのパラメーターをデバイスの既定値に設定することで、子セキュリティ関連付けパラメーターを使用できるようにします。 |
alwaysOnConfiguration | appleVpnAlwaysOnConfiguration | AlwaysOn 構成 |
enableAlwaysOnConfiguration | ブール型 | Always on VPN が有効かどうかを判断します |
mtuSizeInBytes | Int32 | 最大伝送ユニット。 有効な値 1280 から 1400 |
応答
成功した場合、このメソッドは応答コード 201 Created
と、応答本文に iosikEv2VpnConfiguration オブジェクトを返します。
例
要求
以下は、要求の例です。
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 5689
{
"@odata.type": "#microsoft.graph.iosikEv2VpnConfiguration",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"connectionName": "Connection Name value",
"connectionType": "pulseSecure",
"loginGroupOrDomain": "Login Group Or Domain value",
"role": "Role value",
"realm": "Realm value",
"server": {
"@odata.type": "microsoft.graph.vpnServer",
"description": "Description value",
"address": "Address value",
"isDefaultServer": true
},
"identifier": "Identifier value",
"customData": [
{
"@odata.type": "microsoft.graph.keyValue",
"key": "Key value",
"value": "Value value"
}
],
"customKeyValueData": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"enableSplitTunneling": true,
"authenticationMethod": "usernameAndPassword",
"enablePerApp": true,
"safariDomains": [
"Safari Domains value"
],
"onDemandRules": [
{
"@odata.type": "microsoft.graph.vpnOnDemandRule",
"ssids": [
"Ssids value"
],
"dnsSearchDomains": [
"Dns Search Domains value"
],
"probeUrl": "https://example.com/probeUrl/",
"action": "evaluateConnection",
"domainAction": "neverConnect",
"domains": [
"Domains value"
],
"probeRequiredUrl": "https://example.com/probeRequiredUrl/",
"interfaceTypeMatch": "ethernet",
"dnsServerAddressMatch": [
"Dns Server Address Match value"
]
}
],
"providerType": "appProxy",
"associatedDomains": [
"Associated Domains value"
],
"excludedDomains": [
"Excluded Domains value"
],
"disableOnDemandUserOverride": true,
"disconnectOnIdle": true,
"disconnectOnIdleTimerInSeconds": 14,
"proxyServer": {
"@odata.type": "microsoft.graph.vpnProxyServer",
"automaticConfigurationScriptUrl": "https://example.com/automaticConfigurationScriptUrl/",
"address": "Address value",
"port": 4
},
"optInToDeviceIdSharing": true,
"userDomain": "User Domain value",
"strictEnforcement": true,
"cloudName": "Cloud Name value",
"excludeList": [
"Exclude List value"
],
"targetedMobileApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
"childSecurityAssociationParameters": {
"@odata.type": "microsoft.graph.iosVpnSecurityAssociationParameters",
"securityEncryptionAlgorithm": "des",
"securityIntegrityAlgorithm": "sha1_96",
"securityDiffieHellmanGroup": 10,
"lifetimeInMinutes": 1
},
"clientAuthenticationType": "deviceAuthentication",
"deadPeerDetectionRate": "none",
"disableMobilityAndMultihoming": true,
"disableRedirect": true,
"enableCertificateRevocationCheck": true,
"enableEAP": true,
"enablePerfectForwardSecrecy": true,
"enableUseInternalSubnetAttributes": true,
"localIdentifier": "empty",
"remoteIdentifier": "Remote Identifier value",
"securityAssociationParameters": {
"@odata.type": "microsoft.graph.iosVpnSecurityAssociationParameters",
"securityEncryptionAlgorithm": "des",
"securityIntegrityAlgorithm": "sha1_96",
"securityDiffieHellmanGroup": 10,
"lifetimeInMinutes": 1
},
"serverCertificateCommonName": "Server Certificate Common Name value",
"serverCertificateIssuerCommonName": "Server Certificate Issuer Common Name value",
"serverCertificateType": "ecdsa256",
"sharedSecret": "Shared Secret value",
"tlsMaximumVersion": "Tls Maximum Version value",
"tlsMinimumVersion": "Tls Minimum Version value",
"allowDefaultSecurityAssociationParameters": true,
"allowDefaultChildSecurityAssociationParameters": true,
"alwaysOnConfiguration": {
"@odata.type": "microsoft.graph.appleVpnAlwaysOnConfiguration",
"tunnelConfiguration": "cellular",
"userToggleEnabled": true,
"voicemailExceptionAction": "allowTrafficOutside",
"airPrintExceptionAction": "allowTrafficOutside",
"cellularExceptionAction": "allowTrafficOutside",
"allowAllCaptiveNetworkPlugins": true,
"allowedCaptiveNetworkPlugins": {
"@odata.type": "microsoft.graph.specifiedCaptiveNetworkPlugins",
"allowedBundleIdentifiers": [
"Allowed Bundle Identifiers value"
]
},
"allowCaptiveWebSheet": true,
"natKeepAliveIntervalInSeconds": 13,
"natKeepAliveOffloadEnable": true
},
"enableAlwaysOnConfiguration": true,
"mtuSizeInBytes": 14
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 5861
{
"@odata.type": "#microsoft.graph.iosikEv2VpnConfiguration",
"id": "b87b0327-0327-b87b-2703-7bb827037bb8",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"connectionName": "Connection Name value",
"connectionType": "pulseSecure",
"loginGroupOrDomain": "Login Group Or Domain value",
"role": "Role value",
"realm": "Realm value",
"server": {
"@odata.type": "microsoft.graph.vpnServer",
"description": "Description value",
"address": "Address value",
"isDefaultServer": true
},
"identifier": "Identifier value",
"customData": [
{
"@odata.type": "microsoft.graph.keyValue",
"key": "Key value",
"value": "Value value"
}
],
"customKeyValueData": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"enableSplitTunneling": true,
"authenticationMethod": "usernameAndPassword",
"enablePerApp": true,
"safariDomains": [
"Safari Domains value"
],
"onDemandRules": [
{
"@odata.type": "microsoft.graph.vpnOnDemandRule",
"ssids": [
"Ssids value"
],
"dnsSearchDomains": [
"Dns Search Domains value"
],
"probeUrl": "https://example.com/probeUrl/",
"action": "evaluateConnection",
"domainAction": "neverConnect",
"domains": [
"Domains value"
],
"probeRequiredUrl": "https://example.com/probeRequiredUrl/",
"interfaceTypeMatch": "ethernet",
"dnsServerAddressMatch": [
"Dns Server Address Match value"
]
}
],
"providerType": "appProxy",
"associatedDomains": [
"Associated Domains value"
],
"excludedDomains": [
"Excluded Domains value"
],
"disableOnDemandUserOverride": true,
"disconnectOnIdle": true,
"disconnectOnIdleTimerInSeconds": 14,
"proxyServer": {
"@odata.type": "microsoft.graph.vpnProxyServer",
"automaticConfigurationScriptUrl": "https://example.com/automaticConfigurationScriptUrl/",
"address": "Address value",
"port": 4
},
"optInToDeviceIdSharing": true,
"userDomain": "User Domain value",
"strictEnforcement": true,
"cloudName": "Cloud Name value",
"excludeList": [
"Exclude List value"
],
"targetedMobileApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
"childSecurityAssociationParameters": {
"@odata.type": "microsoft.graph.iosVpnSecurityAssociationParameters",
"securityEncryptionAlgorithm": "des",
"securityIntegrityAlgorithm": "sha1_96",
"securityDiffieHellmanGroup": 10,
"lifetimeInMinutes": 1
},
"clientAuthenticationType": "deviceAuthentication",
"deadPeerDetectionRate": "none",
"disableMobilityAndMultihoming": true,
"disableRedirect": true,
"enableCertificateRevocationCheck": true,
"enableEAP": true,
"enablePerfectForwardSecrecy": true,
"enableUseInternalSubnetAttributes": true,
"localIdentifier": "empty",
"remoteIdentifier": "Remote Identifier value",
"securityAssociationParameters": {
"@odata.type": "microsoft.graph.iosVpnSecurityAssociationParameters",
"securityEncryptionAlgorithm": "des",
"securityIntegrityAlgorithm": "sha1_96",
"securityDiffieHellmanGroup": 10,
"lifetimeInMinutes": 1
},
"serverCertificateCommonName": "Server Certificate Common Name value",
"serverCertificateIssuerCommonName": "Server Certificate Issuer Common Name value",
"serverCertificateType": "ecdsa256",
"sharedSecret": "Shared Secret value",
"tlsMaximumVersion": "Tls Maximum Version value",
"tlsMinimumVersion": "Tls Minimum Version value",
"allowDefaultSecurityAssociationParameters": true,
"allowDefaultChildSecurityAssociationParameters": true,
"alwaysOnConfiguration": {
"@odata.type": "microsoft.graph.appleVpnAlwaysOnConfiguration",
"tunnelConfiguration": "cellular",
"userToggleEnabled": true,
"voicemailExceptionAction": "allowTrafficOutside",
"airPrintExceptionAction": "allowTrafficOutside",
"cellularExceptionAction": "allowTrafficOutside",
"allowAllCaptiveNetworkPlugins": true,
"allowedCaptiveNetworkPlugins": {
"@odata.type": "microsoft.graph.specifiedCaptiveNetworkPlugins",
"allowedBundleIdentifiers": [
"Allowed Bundle Identifiers value"
]
},
"allowCaptiveWebSheet": true,
"natKeepAliveIntervalInSeconds": 13,
"natKeepAliveOffloadEnable": true
},
"enableAlwaysOnConfiguration": true,
"mtuSizeInBytes": 14
}