Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Quando si definisce un tipo di endpoint servizio personalizzato nell'estensione, si specifica uno schema di autenticazione che indica ad Azure DevOps come impostare le credenziali nell'intestazione della richiesta HTTP. Azure DevOps supporta gli schemi di autenticazione seguenti per gli endpoint personalizzati.
Suggerimento
Per le linee guida più recenti per lo sviluppo di estensioni, incluse la tematizzazione e la migrazione da VSS.SDK, vedere il portale per sviluppatori di Azure DevOps Extension SDK.
Autenticazione di base
Usa un nome utente e una password inviati come intestazione codificata in Base64 Authorization.
Importante
Se possibile, usare entità servizio e identità gestite anziché l'autenticazione di base. Per ulteriori informazioni, consultare Uso di principali di servizio & identità gestite.
Il tipo di schema predefinito è ms.vss-endpoint.endpoint-auth-scheme-basic. Non è necessario dichiararlo nel manifesto dell'estensione — fai riferimento alla matrice di tipo authenticationSchemes dell'endpoint:
"authenticationSchemes": [
{
"type": "ms.vss-endpoint.endpoint-auth-scheme-basic"
}
]
Azure DevOps richiede all'utente il nome utente e la password e li invia come intestazione HTTP Basic Authorization standard.
Autenticazione basata su token
Accetta un singolo input riservato, ovvero un token API. Il valore del token viene inviato nell'intestazione Authorization .
{
"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
}
}
]
}
]
}
}
Il {{endpoint.apitoken}} segnaposto viene risolto nel valore immesso dall'utente nel campo Token API in fase di esecuzione.
Autenticazione basata su certificati
Accetta un singolo input riservato, ovvero il contenuto del certificato, immesso in un'area di testo.
{
"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"
}
}
]
}
]
}
}
Nessuna autenticazione
Usare questo schema quando il servizio esterno supporta l'accesso anonimo e non sono necessarie credenziali.
{
"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"
}
}