# Autenticación de servidor a servidor

Use un token de acceso de instalación de corta duración cuando un servicio necesite realizar solicitudes de Copilot en nombre de una organización sin las credenciales de un usuario. En Acciones de GitHub, use GITHUB_TOKEN integrado en su lugar.

<!-- markdownlint-disable GHD046 GHD005 -->

<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->

## Acciones de GitHub

Para los flujos de trabajo en un repositorio propiedad de la organización, conceda permisos al token integrado para hacer solicitudes a Copilot:

```yaml
permissions:
  contents: read
  copilot-requests: write

jobs:
  copilot:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - run: your-application
        env:
          GITHUB_TOKEN: $
```

La directiva de la organización **Permitir el uso de Copilot CLI facturado a la organización** debe estar habilitada. Este enfoque no necesita ningún secreto de autenticación almacenado ni GitHub aplicación. Para obtener más información, consulte [Uso de la CLI de Copilot en Acciones de GitHub con GITHUB\_TOKEN](/es/copilot/how-tos/copilot-cli/use-copilot-cli-in-actions).

## Otros servicios y sistemas de CI

Para servicios fuera de Acciones de GitHub:

1. Cree una aplicación de GitHub con el permiso del repositorio **Solicitudes de Copilot** establecido en **Lectura y escritura**.

2. Instálelo en la organización a la que se debe facturar. La comprobación de permisos de Copilot actual requiere acceso **a todos los repositorios**.

3. [Generación de un token de acceso de instalación para una aplicación de GitHub](/es/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app) con un identificador del repositorio y el permiso de Copilot:

   ```json
   {
     "repository_ids": [123456789],
     "permissions": {
       "copilot_requests": "write"
     }
   }
   ```

4. Pase el token resultante `ghs_` al entorno de ejecución como `COPILOT_GITHUB_TOKEN`.

La organización debe estar habilitada para las solicitudes de Copilot de las instalaciones de GitHub App. Los tokens de instalación expiran después de una hora.

> \[!WARNING]
> No pase un token de instalación mediante `github_token`, `gitHubToken` o una opción equivalente del SDK. Esa opción es para tokens de usuario. Los tokens de instalación deben usar la ruta de autenticación del entorno de ejecución.

## Configuración del entorno de ejecución

En los ejemplos siguientes se supone que el token minted está en `INSTALLATION_TOKEN`. Solo lo pasan al entorno de ejecución hijo y deshabilitan el recurso a las credenciales de usuario almacenadas.

<div class="ghd-codetabs">
<div class="ghd-codetab" data-lang="typescript" data-label="TypeScript"><div class="ghd-codetab-fallback-label" role="heading" aria-level="3">TypeScript</div>

```typescript
import { CopilotClient, RuntimeConnection } from "@github/copilot-sdk";

const token = process.env.INSTALLATION_TOKEN;
if (!token) throw new Error("INSTALLATION_TOKEN is required");

const client = new CopilotClient({
    connection: RuntimeConnection.forStdio(),
    env: {
        ...process.env,
        COPILOT_GITHUB_TOKEN: token,
    },
    useLoggedInUser: false,
});
```

</div>

<div class="ghd-codetab" data-lang="python" data-label="Python"><div class="ghd-codetab-fallback-label" role="heading" aria-level="3">Python</div>

```python
import os

from copilot import CopilotClient, RuntimeConnection

client = CopilotClient(
    connection=RuntimeConnection.for_stdio(),
    env={**os.environ, "COPILOT_GITHUB_TOKEN": os.environ["INSTALLATION_TOKEN"]},
    use_logged_in_user=False,
)
```

</div>

<div class="ghd-codetab" data-lang="go" data-label="Go"><div class="ghd-codetab-fallback-label" role="heading" aria-level="3">Go</div>

```golang
package main

import (
    "log"
    "os"

    copilot "github.com/github/copilot-sdk/go"
)

func main() {
    token, ok := os.LookupEnv("INSTALLATION_TOKEN")
    if !ok {
        log.Fatal("INSTALLATION_TOKEN is required")
    }
    client := copilot.NewClient(&copilot.ClientOptions{
        Connection:      copilot.StdioConnection{},
        Env:             append(os.Environ(), "COPILOT_GITHUB_TOKEN="+token),
        UseLoggedInUser: copilot.Bool(false),
    })
    _ = client
}
```

</div>

<div class="ghd-codetab" data-lang="rust" data-label="Rust"><div class="ghd-codetab-fallback-label" role="heading" aria-level="3">Rust</div>

```rust
use github_copilot_sdk::{ClientOptions, Transport};

fn main() {
    let token = std::env::var("INSTALLATION_TOKEN").expect("INSTALLATION_TOKEN is required");
    let options = ClientOptions::new()
        .with_transport(Transport::Stdio)
        .with_env([("COPILOT_GITHUB_TOKEN", token)])
        .with_use_logged_in_user(false);
    drop(options);
}
```

</div>

<div class="ghd-codetab" data-lang="dotnet" data-label=".NET"><div class="ghd-codetab-fallback-label" role="heading" aria-level="3">.NET</div>

```csharp
using System.Collections;
using GitHub.Copilot;

var token = Environment.GetEnvironmentVariable("INSTALLATION_TOKEN")
    ?? throw new InvalidOperationException("INSTALLATION_TOKEN is required");
var environment = Environment.GetEnvironmentVariables()
    .Cast<DictionaryEntry>()
    .ToDictionary(entry => (string)entry.Key, entry => entry.Value?.ToString() ?? "");
environment["COPILOT_GITHUB_TOKEN"] = token;

await using var client = new CopilotClient(new CopilotClientOptions
{
    Connection = RuntimeConnection.ForStdio(),
    Environment = environment,
    UseLoggedInUser = false,
});
```

</div>

<div class="ghd-codetab" data-lang="java" data-label="Java"><div class="ghd-codetab-fallback-label" role="heading" aria-level="3">Java</div>

```java
import com.github.copilot.CopilotClient;
import com.github.copilot.rpc.CopilotClientOptions;
import java.util.HashMap;
import java.util.Objects;

var environment = new HashMap<>(System.getenv());
var token = Objects.requireNonNull(
    System.getenv("INSTALLATION_TOKEN"), "INSTALLATION_TOKEN is required");
environment.put("COPILOT_GITHUB_TOKEN", token);

try (var client = new CopilotClient(new CopilotClientOptions()
        .setEnvironment(environment)
        .setUseLoggedInUser(false))) {
    // Use the client.
}
```

</div>

</div>

Para FFI en el proceso, establezca `COPILOT_GITHUB_TOKEN` en el entorno del host antes de cargar el entorno de ejecución; no se admiten opciones de entorno específicas por cliente. Para un URI de entorno de ejecución existente, configúrelo en ese proceso de ejecución.

## Tokens de actualización

Emita un nuevo token de instalación antes de que expire el token actual. Para un proceso secundario, reinicie el cliente del SDK con el nuevo entorno. Para un entorno de ejecución en proceso o existente, reinicie el entorno de ejecución del host con el nuevo token.

## Billing

El uso se atribuye y factura a la cuenta que posee la instalación de la aplicación GitHub. Utilice una instalación de la organización para la facturación de la organización; una instalación de la cuenta de usuario atribuye el uso a ese usuario.

## Troubleshooting

| Síntoma                                                                                         | Check                                                                                                                                        |
| ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `401 Unauthorized`                                                                              | Confirme que la organización admite la autenticación de instalación de aplicaciones de GitHub para Copilot.                                  |
| `403 Resource not accessible by integration` o un error al mencionar la información del usuario | Confirme que el token de instalación está en `COPILOT_GITHUB_TOKEN`, no en la opción explícita de token del SDK.                             |
| `403 Forbidden`desde la API de Copilot                                                          | Confirme que la solicitud de token contiene `repository_ids` y `copilot_requests: write`.                                                    |
| `403 Forbidden` con la solicitud de token necesaria                                             | Confirme que la instalación de la aplicación tiene acceso a **Todos los repositorios** y, a continuación, genere un nuevo token.             |
| El modelo solicitado no está disponible                                                         | Confirme que la directiva de Copilot de la organización permite usar el modelo y que el entorno de ejecución incluido sea compatible con él. |
| Cuenta incorrecta facturada                                                                     | Confirme que la instalación pertenece a la organización deseada.                                                                             |

## Lectura adicional

* [Autenticación](/es/copilot/how-tos/copilot-sdk/auth/authenticate): otros métodos de autenticación y prioridad
* [Generación de un token de acceso de instalación para una aplicación de GitHub](/es/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app): creación de tokens de aplicación de GitHub