POST | Criar política de acesso

Descrição

Crie uma política de acesso no PAM Core. Uma única requisição define o nome da política, suas regras de senha e de sessão, o comportamento dos aprovadores, os critérios que determinam quais credenciais e dispositivos a política abrange e suas limitações de horário de acesso.

Pré-requisitos

• Uma aplicação com a autorização Access Policy (V2) concedida pelo administrador no A2A, com a Permissão do recurso PAM definida como Leitura e escrita. Para mais informações, acesse Como gerenciar autorizações no A2A.
• Um token de acesso OAuth 2.0 válido. Para mais informações, acesse Como autenticar uma aplicação A2A.
• Os sites, tipos de dispositivo e tipos de credencial referenciados em criteria devem existir previamente.

Requisição

POST /api/v2/pam/access-policies

Cabeçalhos

Corpo da requisição

Password

Session

Approvers config

Criteria

O objeto criteria contém as regras que determinam quais recursos a política abrange. Os critérios são combinados com lógica AND; os valores dentro de cada array são combinados com lógica OR. Um array vazio desabilita o critério.

Access limitation

Exemplo de requisição

POST {{url}}/api/v2/pam/access-policies

Corpo

{
    "name": "PAM Administrators",
    "description": "Full access for PAM admins.",
    "password": {
        "allow_view": true,
        "view_mode": "complete",
        "require_reason": false,
        "require_approval": true,
        "approvals_required": 1,
        "disapprovals_to_cancel": 1,
        "approval_in_levels": true,
        "allow_emergency_access": true,
        "allow_change_expiration": true,
        "change_expiration_minutes": 30,
        "require_approval_days": false
    },
    "session": {
        "allow_start": true,
        "block_during_freezing": false,
        "require_reason": true,
        "require_approval": true,
        "approvals_required": 1,
        "disapprovals_to_cancel": 1,
        "approval_in_levels": true,
        "allow_emergency_access": true,
        "require_change_id": true,
        "require_approval_days": true,
        "approval_days": ["all"],
        "approval_times": ["all"]
    },
    "approvers_config": {
        "governance_id_required": true,
        "always_add_user_manager": true
    },
    "criteria": {
        "site_ids": [1],
        "device_type_ids": [3],
        "credential_type_ids": [5],
        "device_tags": ["prod"],
        "credential_tags": ["finance"]
    },
    "access_limitation": {
        "days": ["all"],
        "times": ["all"],
        "period_start": null,
        "period_end": null
    }
}

Resposta

HTTP/1.1 201 Created
Location: /api/v2/pam/access-policies/3001
ETag: "v1"

O cabeçalho Location contém o caminho da política criada e o cabeçalho ETag contém sua versão atual. Guarde o valor do ETag — PUT | Atualizar política de acesso por [id], PATCH | Atualizar parcialmente a política de acesso por [id] e DELETE | Excluir política de acesso por [id] o utilizam no cabeçalho If-Match para detectar alterações concorrentes.

Exemplo de corpo da resposta

{
    "data": {
        "id": 3001,
        "access_policy": {
            "name": "PAM Administrators",
            "active": true,
            "description": "Full access for PAM admins."
        },
        "password": {
            "allow_view": true,
            "view_mode": "complete",
            "require_reason": false,
            "require_approval": true,
            "approvals_required": 1,
            "disapprovals_to_cancel": 1,
            "approval_in_levels": true,
            "allow_emergency_access": true,
            "allow_change_expiration": true,
            "change_expiration_minutes": 30,
            "require_approval_days": false,
            "approval_days": [],
            "approval_times": [],
            "approval_custom_times": []
        },
        "session": {
            "allow_start": true,
            "block_during_freezing": false,
            "require_reason": true,
            "require_approval": true,
            "approvals_required": 1,
            "disapprovals_to_cancel": 1,
            "approval_in_levels": true,
            "allow_emergency_access": true,
            "require_change_id": true,
            "require_approval_days": true,
            "approval_days": ["all"],
            "approval_times": ["all"],
            "approval_custom_times": []
        },
        "approvers_config": {
            "governance_id_required": true,
            "always_add_user_manager": true
        },
        "criteria": {
            "site_ids": [1],
            "device_type_ids": [3],
            "credential_type_ids": [5],
            "devices": [],
            "products": [],
            "usernames": [],
            "additional_information": [],
            "device_tags": ["prod"],
            "credential_tags": ["finance"]
        },
        "access_limitation": {
            "days": ["all"],
            "times": ["all"],
            "custom_times": [],
            "period_start": null,
            "period_end": null
        }
    },
    "meta": {
        "links": { "self": "/api/v2/pam/access-policies/3001" },
        "actions": {
            "deactivate": "/api/v2/pam/access-policies/3001/deactivate"
        }
    }
}

Campos do corpo da resposta

Erros

Para mensagens de erros de autenticação e a política de 403 versus 404, acesse API v2 - Convenções e comportamentos compartilhados.