다음을 통해 공유


Jit Network Access Policies - Create Or Update

Just-In-Time 액세스 제어를 사용하여 리소스를 보호하기 위한 정책 만들기

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/locations/{ascLocation}/jitNetworkAccessPolicies/{jitNetworkAccessPolicyName}?api-version=2020-01-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
ascLocation
path True

string

ASC가 구독의 데이터를 저장하는 위치입니다. 위치 가져오기에서 검색할 수 있습니다.

jitNetworkAccessPolicyName
path True

string

Just-In-Time 액세스 구성 정책의 이름입니다.

resourceGroupName
path True

string

사용자의 구독 내에 있는 리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

regex 패턴: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Azure 구독 ID

regex 패턴: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

작업에 대한 API 버전

요청 본문

Name 필수 형식 Description
properties.virtualMachines True

JitNetworkAccessPolicyVirtualMachine[]

Microsoft.Compute/virtualMachines 리소스 종류에 대한 구성입니다.

kind

string

리소스 종류

properties.requests

JitNetworkAccessRequest[]

응답

Name 형식 Description
200 OK

JitNetworkAccessPolicy

그래

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Create JIT network access policy

샘플 요청

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default?api-version=2020-01-01

{
  "kind": "Basic",
  "properties": {
    "virtualMachines": [
      {
        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
        "ports": [
          {
            "number": 22,
            "protocol": "*",
            "allowedSourceAddressPrefix": "*",
            "maxRequestAccessDuration": "PT3H"
          },
          {
            "number": 3389,
            "protocol": "*",
            "allowedSourceAddressPrefix": "*",
            "maxRequestAccessDuration": "PT3H"
          }
        ]
      }
    ],
    "requests": [
      {
        "virtualMachines": [
          {
            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
            "ports": [
              {
                "number": 3389,
                "allowedSourceAddressPrefix": "192.127.0.2",
                "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
                "status": "Initiated",
                "statusReason": "UserRequested"
              }
            ]
          }
        ],
        "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
        "requestor": "barbara@contoso.com"
      }
    ],
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
  "name": "default",
  "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
  "location": "westeurope"
}

샘플 응답

{
  "kind": "Basic",
  "properties": {
    "virtualMachines": [
      {
        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
        "ports": [
          {
            "number": 22,
            "protocol": "*",
            "allowedSourceAddressPrefix": "*",
            "maxRequestAccessDuration": "PT3H"
          },
          {
            "number": 3389,
            "protocol": "*",
            "allowedSourceAddressPrefix": "*",
            "maxRequestAccessDuration": "PT3H"
          }
        ]
      }
    ],
    "requests": [
      {
        "virtualMachines": [
          {
            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Compute/virtualMachines/vm1",
            "ports": [
              {
                "number": 3389,
                "allowedSourceAddressPrefix": "192.127.0.2",
                "endTimeUtc": "2018-05-17T09:06:45.5691611Z",
                "status": "Initiated",
                "statusReason": "UserRequested"
              }
            ]
          }
        ],
        "startTimeUtc": "2018-05-17T08:06:45.5691611Z",
        "requestor": "barbara@contoso.com"
      }
    ],
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg1/providers/Microsoft.Security/locations/westeurope/jitNetworkAccessPolicies/default",
  "name": "default",
  "type": "Microsoft.Security/locations/jitNetworkAccessPolicies",
  "location": "westeurope"
}

정의

Name Description
CloudError

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

CloudErrorBody

오류 세부 정보입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

JitNetworkAccessPolicy
JitNetworkAccessPolicyVirtualMachine
JitNetworkAccessPortRule
JitNetworkAccessRequest
JitNetworkAccessRequestPort
JitNetworkAccessRequestVirtualMachine
protocol
status

포트의 상태

statusReason

status 값이 있는 이유에 대한 설명

CloudError

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

Name 형식 Description
error.additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

error.code

string

오류 코드입니다.

error.details

CloudErrorBody[]

오류 세부 정보입니다.

error.message

string

오류 메시지입니다.

error.target

string

오류 대상입니다.

CloudErrorBody

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

CloudErrorBody[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

JitNetworkAccessPolicy

Name 형식 Description
id

string

리소스 ID

kind

string

리소스 종류

location

string

리소스가 저장되는 위치

name

string

리소스 이름

properties.provisioningState

string

Just-In-Time 정책의 프로비전 상태를 가져옵니다.

properties.requests

JitNetworkAccessRequest[]

properties.virtualMachines

JitNetworkAccessPolicyVirtualMachine[]

Microsoft.Compute/virtualMachines 리소스 종류에 대한 구성입니다.

type

string

리소스 종류

JitNetworkAccessPolicyVirtualMachine

Name 형식 Description
id

string

이 정책에 연결된 가상 머신의 리소스 ID

ports

JitNetworkAccessPortRule[]

가상 머신에 대한 포트 구성

publicIpAddress

string

해당되는 경우 이 정책에 연결된 Azure Firewall의 공용 IP 주소

JitNetworkAccessPortRule

Name 형식 Description
allowedSourceAddressPrefix

string

"allowedSourceAddressPrefixes" 매개 변수와 함께 사용할 수 없습니다. IP 주소 또는 CIDR(예: "192.168.0.3" 또는 "192.168.0.0/16")이어야 합니다.

allowedSourceAddressPrefixes

string[]

"allowedSourceAddressPrefix" 매개 변수와 함께 사용할 수 없습니다.

maxRequestAccessDuration

string

최대 기간 요청을 수행할 수 있습니다. ISO 8601 기간 형식입니다. 최소 5분, 최대 1일

number

integer

protocol

protocol

JitNetworkAccessRequest

Name 형식 Description
justification

string

시작 요청을 만들기 위한 근거

requestor

string

요청을 한 사람의 ID입니다.

startTimeUtc

string

요청의 시작 시간(UTC)

virtualMachines

JitNetworkAccessRequestVirtualMachine[]

JitNetworkAccessRequestPort

Name 형식 Description
allowedSourceAddressPrefix

string

"allowedSourceAddressPrefixes" 매개 변수와 함께 사용할 수 없습니다. IP 주소 또는 CIDR(예: "192.168.0.3" 또는 "192.168.0.0/16")이어야 합니다.

allowedSourceAddressPrefixes

string[]

"allowedSourceAddressPrefix" 매개 변수와 함께 사용할 수 없습니다.

endTimeUtc

string

요청이 UTC로 끝나는 날짜 & 시간입니다.

mappedPort

integer

해당하는 경우 Azure Firewall에서 이 포트의 number 매핑되는 포트

number

integer

status

status

포트의 상태

statusReason

statusReason

status 값이 있는 이유에 대한 설명

JitNetworkAccessRequestVirtualMachine

Name 형식 Description
id

string

이 정책에 연결된 가상 머신의 리소스 ID

ports

JitNetworkAccessRequestPort[]

가상 머신에 대해 열린 포트

protocol

Name 형식 Description
*

string

TCP

string

UDP

string

status

포트의 상태

Name 형식 Description
Initiated

string

Revoked

string

statusReason

status 값이 있는 이유에 대한 설명

Name 형식 Description
Expired

string

NewerRequestInitiated

string

UserRequested

string