Uso de tokens de acceso personal

Una vez creado el PAT, puede usarlo en cualquier lugar en el que se requieran las credenciales de usuario para la autenticación Azure DevOps.

Notificaciones

Los usuarios reciben dos notificaciones durante la vigencia de un PAT: una tras la creación y la otra siete días antes de la expiración.

Después de crear un PAT, recibirá una notificación similar al ejemplo siguiente.

Siete días antes de que expire el PAT, recibirá una notificación similar al ejemplo siguiente.

Notificación inesperada

Si recibe una notificación PAT inesperada, es posible que un administrador o una herramienta haya creado un PAT en su nombre. Vea los ejemplos siguientes:

• Al conectarse a un repositorio Azure DevOps Git a través de git.exe. crea un token con un nombre para mostrar como "git: https://MyOrganization.visualstudio.com/ on MyMachine".
• Cuando usted o un administrador configura una implementación de aplicación web de Azure App Service, crea un token con un nombre para mostrar como "Service Hooks: : Azure App Service: : Deploy web app".
• Cuando usted o un administrador configura pruebas de carga web, como parte de una canalización, crea un token con un nombre para mostrar como "WebAppLoadTestCDIntToken".
• Cuando se Microsoft Teams la extensión de mensajería de integración, crea un token con un nombre para mostrar como "Microsoft Teams Integration".

Si cree que existe un error de PAT, le recomendamos que revoque el PAT. A continuación, cambie la contraseña. Como usuario Azure AD usuario, consulte con el administrador para ver si su organización se usó desde un origen o ubicación desconocidos. Consulte también las preguntas más frecuentes sobre cómo registrar accidentalmente un PAT en un repositorio GitHub público.

Uso de un PAT

El token es su identidad y le representa cuando se usa. Trate y use un PAT como la contraseña.

Las interacciones de Git requieren un nombre de usuario, que puede ser cualquier cosa excepto la cadena vacía. El PAT se usa como contraseña. Además, tiene que codificar en Base64 el nombre de usuario y PAT para usarlo con la autenticación básica HTTP. En Linux o macOS, en Bash, puede escribir:

MY_PAT=yourPAT # replace "yourPAT" with your actual PAT
B64_PAT=$(printf "%s"":$MY_PAT" | base64)
git -c http.extraHeader="Authorization: Basic ${B64_PAT}" clone https://dev.azure.com/yourOrgName/yourProjectName/_git/yourRepoName 

En Windows, puede hacer algo similar en PowerShell:

$MyPat = 'yourPAT'
$B64Pat = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("$MyPat"))
git -c http.extraHeader="Authorization: Basic $B64Pat" clone https://dev.azure.com/yourOrgName/yourProjectName/_git/yourRepoName

Para mantener el token más seguro, use administradores de credenciales para que no tenga que escribir las credenciales cada vez. Se recomienda el siguiente administrador de credenciales:

• Git Administrador de credenciales Core (Windows también requiere Git para Windows)

Uso de un PAT en el código

Vea el ejemplo siguiente que obtiene una lista de compilaciones mediante curl.

curl -u :{PAT} https://dev.azure.com/{organization}/_apis/build-release/builds

Si desea proporcionar el PAT a través de un encabezado HTTP, conviéndolo primero en una cadena Base64 (en el ejemplo siguiente se muestra cómo convertir a Base64 mediante C#). A continuación, la cadena resultante se puede proporcionar como un encabezado HTTP en el formato siguiente:

Authorization: Basic BASE64_USERNAME_PAT_STRING

Aquí está en C# mediante la clase HttpClient.

public static async void GetBuilds()
{
    try
    {
        var personalaccesstoken = "PATFROMWEB";

        using (HttpClient client = new HttpClient())
        {
            client.DefaultRequestHeaders.Accept.Add(
                new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));

            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic",
                Convert.ToBase64String(
                    System.Text.ASCIIEncoding.ASCII.GetBytes(
                        string.Format("{0}:{1}", "", personalaccesstoken))));

            using (HttpResponseMessage response = client.GetAsync(
                        "https://dev.azure.com/{organization}/{project}/_apis/build/builds?api-version=5.0").Result)
            {
                response.EnsureSuccessStatusCode();
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.ToString());
    }
}

public static async void GetBuilds()
{
    try
    {
        var personalaccesstoken = "PATFROMWEB";

        using (HttpClient client = new HttpClient())
        {
            client.DefaultRequestHeaders.Accept.Add(
                new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));

            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic",
                Convert.ToBase64String(
                    System.Text.ASCIIEncoding.ASCII.GetBytes(
                        string.Format("{0}:{1}", "", personalaccesstoken))));

            using (HttpResponseMessage response = client.GetAsync(
                        $"https://dev.azure.com/{organization}/{project}/_apis/build/builds?api-version=5.0").Result)
            {
                response.EnsureSuccessStatusCode();
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.ToString());
    }
}

Cuando el código funciona, es un buen momento para cambiar de autenticación básica a OAuth.

Si habilita la autenticación básica de IIS para TFS, las PAT no son válidas. Para obtener más información, vea Usar la autenticación básica de IIS con TFS local.

Para obtener más ejemplos de cómo usar las PAT, vea Administradores de credenciales de Git,API REST,NuGet en un equipo Mac,Clientes de informes o Introducción a la CLI de Azure DevOps.

Artículos relacionados

• Acerca de la seguridad, autenticación y autorización
• Permisos y acceso predeterminados para Azure DevOps
• Revocación de los PAT de otros usuarios

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2017

Un token de acceso personal (PAT) se usa como contraseña alternativa para autenticarse en Azure DevOps. Aprenda a crear, usar, modificar y revocar LAS PAT para Azure DevOps.

Si trabaja con herramientas de Microsoft, su cuenta Microsoft (MSA) o Azure Active Directory (Azure AD) es un enfoque aceptable y bien admitido. Sin embargo, si trabaja con herramientas de terceros que no admiten cuentas de Microsoft o Azure AD (o no quiere proporcionar sus credenciales principales a la herramienta), puede usar las PAT para limitar el riesgo.

Las PAT son fáciles de crear cuando las necesita y fáciles de revocar cuando no lo hace. Para configurar las PAT para herramientas que no son de Microsoft, use administradores de credenciales de Git o cónmalos manualmente. Se recomienda revisar nuestra guía de autenticación para ayudarle a elegir el mecanismo de autenticación correcto. En el caso de los proyectos más pequeños que requieren una solución menos sólida, las PAT son una alternativa sencilla. A menos que los usuarios usen un administrador de credenciales, deben escribir sus credenciales cada vez.

Puede crear y administrar las PAT mediante una de las siguientes maneras:

• la interfaz de usuario en la configuración de usuario, que se describe en detalle en este artículo
• a través del ciclo de vida de PAT API de Administración

Creación de un PAT