Compartir a través de


Jit Network Access Policies - Create Or Update

Crear una directiva para proteger los recursos mediante el control de acceso Just-In-Time

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
ascLocation
path True

string

Ubicación donde ASC almacena los datos de la suscripción. se puede recuperar desde Get locations

jitNetworkAccessPolicyName
path True

string

Nombre de una directiva de configuración de acceso Just-In-Time.

resourceGroupName
path True

string

Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre no distingue mayúsculas de minúsculas.

Patrón de Regex: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Identificador de suscripción de Azure

Patrón de Regex: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

Versión de API para la operación

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties.virtualMachines True

JitNetworkAccessPolicyVirtualMachine[]

Configuraciones para el tipo de recurso Microsoft.Compute/virtualMachines.

kind

string

Tipo de recurso

properties.requests

JitNetworkAccessRequest[]

Respuestas

Nombre Tipo Description
200 OK

JitNetworkAccessPolicy

De acuerdo

Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Create JIT network access policy

Solicitud de ejemplo

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"
}

Respuesta de muestra

{
  "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"
}

Definiciones

Nombre Description
CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

CloudErrorBody

Detalle del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

JitNetworkAccessPolicy
JitNetworkAccessPolicyVirtualMachine
JitNetworkAccessPortRule
JitNetworkAccessRequest
JitNetworkAccessRequestPort
JitNetworkAccessRequestVirtualMachine
protocol
status

Estado del puerto

statusReason

Descripción de por qué el status tiene su valor

CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

Nombre Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

error.code

string

Código de error.

error.details

CloudErrorBody[]

Detalles del error.

error.message

string

Mensaje de error.

error.target

string

Destino del error.

CloudErrorBody

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

CloudErrorBody[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

JitNetworkAccessPolicy

Nombre Tipo Description
id

string

Identificador de recurso

kind

string

Tipo de recurso

location

string

Ubicación donde se almacena el recurso

name

string

Nombre del recurso

properties.provisioningState

string

Obtiene el estado de aprovisionamiento de la directiva Just-In-Time.

properties.requests

JitNetworkAccessRequest[]

properties.virtualMachines

JitNetworkAccessPolicyVirtualMachine[]

Configuraciones para el tipo de recurso Microsoft.Compute/virtualMachines.

type

string

Tipo de recurso

JitNetworkAccessPolicyVirtualMachine

Nombre Tipo Description
id

string

Identificador de recurso de la máquina virtual vinculada a esta directiva

ports

JitNetworkAccessPortRule[]

Configuraciones de puerto para la máquina virtual

publicIpAddress

string

Dirección IP pública de Azure Firewall vinculada a esta directiva, si procede

JitNetworkAccessPortRule

Nombre Tipo Description
allowedSourceAddressPrefix

string

Excluyente mutuamente con el parámetro "allowedSourceAddressPrefixes". Debe ser una dirección IP o CIDR, por ejemplo "192.168.0.3" o "192.168.0.0/16".

allowedSourceAddressPrefixes

string[]

Excluyente mutuamente con el parámetro "allowedSourceAddressPrefix".

maxRequestAccessDuration

string

Se pueden realizar solicitudes de duración máxima. En formato de duración ISO 8601. Mínimo 5 minutos, máximo 1 día

number

integer

protocol

protocol

JitNetworkAccessRequest

Nombre Tipo Description
justification

string

Justificación para realizar la solicitud de inicio

requestor

string

Identidad de la persona que realizó la solicitud

startTimeUtc

string

Hora de inicio de la solicitud en UTC

virtualMachines

JitNetworkAccessRequestVirtualMachine[]

JitNetworkAccessRequestPort

Nombre Tipo Description
allowedSourceAddressPrefix

string

Excluyente mutuamente con el parámetro "allowedSourceAddressPrefixes". Debe ser una dirección IP o CIDR, por ejemplo "192.168.0.3" o "192.168.0.0/16".

allowedSourceAddressPrefixes

string[]

Excluyente mutuamente con el parámetro "allowedSourceAddressPrefix".

endTimeUtc

string

La fecha & hora a la que finaliza la solicitud en UTC

mappedPort

integer

El puerto que se asigna a la number de este puerto en Azure Firewall, si procede.

number

integer

status

status

Estado del puerto

statusReason

statusReason

Descripción de por qué el status tiene su valor

JitNetworkAccessRequestVirtualMachine

Nombre Tipo Description
id

string

Identificador de recurso de la máquina virtual vinculada a esta directiva

ports

JitNetworkAccessRequestPort[]

Puertos abiertos para la máquina virtual

protocol

Nombre Tipo Description
*

string

TCP

string

UDP

string

status

Estado del puerto

Nombre Tipo Description
Initiated

string

Revoked

string

statusReason

Descripción de por qué el status tiene su valor

Nombre Tipo Description
Expired

string

NewerRequestInitiated

string

UserRequested

string