Esquemas de autenticação de ponto de extremidade de serviço

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Saiba como definir as credenciais no cabeçalho da solicitação HTTP quando estiver chamando o ponto de extremidade externo. O Azure DevOps pode se conectar ao serviço externo usando as credenciais. O Azure DevOps dá suporte a um conjunto fechado de esquemas de autenticação utilizados por um tipo de ponto de extremidade de serviço personalizado. O Azure DevOps interpreta o esquema de autenticação usado em qualquer endpoint personalizado & para suportar a conexão com o serviço externo.

Consulte os seguintes esquemas de autenticação que fazem parte do conjunto fechado.

Autenticação básica

Como medida de segurança, recomendamos o uso de entidades de serviço & ou identidades geridas em vez da autenticação básica. Para obter mais informações, consulte Usar entidades de serviço & identidades gerenciadas.

Autenticação baseada em tokens

Este esquema leva uma entrada - API Token (confidencial)

O cabeçalho de autenticação padrão usado é: {{endpoint.apitoken}}

{
    "id": "endpoint-auth-scheme-token",
    "description": "i18n:Token based endpoint authentication scheme",
    "type": "ms.vss-endpoint.service-endpoint-type",
    "targets": [
        "ms.vss-endpoint.endpoint-types"
    ],
    "properties": {
        "name": "Token",
        "displayName": "i18n:Token Based Authentication",
        "authenticationSchemes": [
            {
                "type": "ms.vss-endpoint.endpoint-auth-scheme-token",
                "headers": [
                    {
                        "name": "Authorization",
                        "value": "{{endpoint.apitoken}}"
                    }
                ],
                "inputDescriptors": [
                    {
                        "id": "apitoken",
                        "name": "i18n:API Token",
                        "description": "i18n:API Token for connection to endpoint",
                        "inputMode": "textbox",
                        "isConfidential": true,
                        "validation": {
                            "isRequired": true,
                            "dataType": "string",
                            "maxLength": 300
                        }
                    }
                ]
            }
        ]
    }
}

Autenticação baseada em certificado

Este esquema aceita uma entrada única - Certificado (confidencial)

O valor do certificado deve ser fornecido na área de texto.

{
    "id": "endpoint-auth-scheme-cert",
    "description": "i18n:Creates a certificate-based endpoint authentication scheme",
    "type": "ms.vss-endpoint.service-endpoint-type",
    "targets": [
        "ms.vss-endpoint.endpoint-types"
    ],
    "properties": {
        "name": "Certificate",
        "displayName": "i18n:Certificate Based",
        "authenticationSchemes": [
            {
                "type": "ms.vss-endpoint.endpoint-auth-scheme-cert",
                "inputDescriptors": [
                    {
                        "id": "certificate",
                        "name": "i18n:Certificate",
                        "description": "Content of the certificate",
                        "inputMode": "TextArea",
                        "isConfidential": true,
                        "validation": {
                            "isRequired": true,
                            "dataType": "string"
                        }
                    }
                ]
            }
        ]
    }
}

Sem autenticação

Esse esquema é usado quando um tipo de ponto de extremidade não requer nenhuma entrada. Por exemplo, serviços externos que suportam acesso anónimo aos seus recursos.

{
    "id": "endpoint-auth-scheme-none",
    "description": "i18n:Creates an endpoint authentication scheme with no authentication.",
    "type": "ms.vss-endpoint.endpoint-auth-scheme-none",
    "targets": [
        "ms.vss-endpoint.endpoint-auth-schemes"
    ],
    "properties": {
        "name": "None",
        "displayName": "i18n:No Authentication"
    }
}