New translation batch for es (#27152)
* Add crowdin translations * Run script/i18n/homogenize-frontmatter.js * Run script/i18n/fix-translation-errors.js * Run script/i18n/lint-translation-files.js --check rendering * run script/i18n/reset-files-with-broken-liquid-tags.js --language=es * run script/i18n/reset-known-broken-translation-files.js Co-authored-by: Robert Sese <rsese@github.com>
This commit is contained in:
docubot
@@ -82,7 +82,7 @@ Antes de comenzar, deberás crear un repositorio en {% ifversion ghae %}{% data
|
||||
- run: echo Hello ${{ inputs.who-to-greet }}.
|
||||
shell: bash
|
||||
- id: random-number-generator
|
||||
run: echo "::set-output name=random-id::$(echo $RANDOM)"
|
||||
run: echo "::set-output name=random-number::$(echo $RANDOM)"
|
||||
shell: bash
|
||||
- run: echo "${{ github.action_path }}" >> $GITHUB_PATH
|
||||
shell: bash
|
||||
|
||||
@@ -50,9 +50,7 @@ Puedes configurar un _flujo de trabajo_ de {% data variables.product.prodname_ac
|
||||
|
||||
### Flujos de trabajo
|
||||
|
||||
Un flujo de trabajo es un proceso automatizado configurable que ejecutará uno o más jobs. Los flujos de trabajo se definen mediante un archivo de YAML que se verifica en tu repositorio y se ejecutará cuando lo active un evento dentro de este o puede activarse manualmente o en una programación definida.
|
||||
|
||||
Puedes tener flujos de trabajo múltiples en un repositorio, cada uno de los cuales pueden llevar a cabo un conjunto de pasos diferente. Por ejemplo, puedes tener un flujo de trabajo para crear y probar las solicitudes de cambio, otro para desplegar tu aplicación cada que se cree un lanzamiento y todavía otro más que agregue una etiqueta cada que alguien abra una propuesta nueva.
|
||||
{% data reusables.actions.about-workflows-long %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %}Puedes referenciar un flujo de trabajo dentro de otro flujo de trabajo, consulta la sección "[Reutilizar flujos de trabajo](/actions/learn-github-actions/reusing-workflows)".{% endif %}
|
||||
|
||||
@@ -86,168 +84,7 @@ Para obtener más información, consulta la sección "[Crear acciones](/actions/
|
||||
|
||||
{% data reusables.actions.about-runners %} Cada ejecutor puede ejecutar un job individual a la vez. {% ifversion ghes or ghae %} Debes hospedar tus propios ejecutores para {% data variables.product.product_name %}. {% elsif fpt or ghec %}{% data variables.product.company_short %} proporciona ejecutores de Ubuntu Linux, Microsoft Windows y macOS para ejecutar tus flujos de trabajo; cada flujo de trabajo se ejecuta en una máquina virtual nueva y recién aprovisionada. Si necesitas un sistema operativo diferente o si requieres una configuración de hardware específica, puedes hospedar tus propios ejecutores.{% endif %} Para obtener más información{% ifversion fpt or ghec %} sobre los ejecutores auto-hospedados{% endif %}, consulta la sección "[Hospedar tus propios ejecutores](/actions/hosting-your-own-runners)".
|
||||
|
||||
## Crear un flujo de trabajo de ejemplo
|
||||
|
||||
Las {% data variables.product.prodname_actions %} utilizan la sintaxis de YAML para definir el flujo de trabajo. Cada flujo de trabajo se almacena como un archivo de YAML por separado en tu repositorio de código en un directorio que se llama `.github/workflows`.
|
||||
|
||||
Puedes crear un flujo de trabajo de ejemplo en tu repositorio que active automáticamente una serie de comandos cada que se suba código. En este flujo de trabajo, las {% data variables.product.prodname_actions %} verifican el código que se subió, instalan las dependencias de software, y ejecutan `bats -v`.
|
||||
|
||||
1. En tu repositorio, crea el directorio `.github/workflows/` para almacenar tus archivos de flujo de trabajo.
|
||||
1. En el directorio `.github/workflows/`, crea un archivo nuevo que se llame `learn-github-actions.yml` y agrega el siguiente código.
|
||||
|
||||
```yaml
|
||||
name: learn-github-actions
|
||||
on: [push]
|
||||
jobs:
|
||||
check-bats-version:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: {% data reusables.actions.action-checkout %}
|
||||
- uses: {% data reusables.actions.action-setup-node %}
|
||||
with:
|
||||
node-version: '14'
|
||||
- run: npm install -g bats
|
||||
- run: bats -v
|
||||
```
|
||||
1. Confirma estos cambios y cárgalos a tu repositorio de {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
Tu archivo de flujo de trabajo de {% data variables.product.prodname_actions %} nuevo estará ahora instalado en tu repositorio y se ejecutará automáticamente cada que alguien suba un cambio a éste. For details about a workflow's execution history, see "[Viewing the workflow's activity](/actions/learn-github-actions/introduction-to-github-actions#viewing-the-workflows-activity)."
|
||||
|
||||
## Entender el archivo de flujo de trabajo
|
||||
|
||||
Para ayudarte a entender cómo se utiliza la sintaxis de YAML para crear un flujo de trabajo, esta sección explica cada línea del ejemplo de la introducción:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
name: learn-github-actions
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
<em>Opcional</em> - El nombre del flujo de trabajo ta como aparece en la pestaña de Acciones del repositorio de {% data variables.product.prodname_dotcom %}.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
on: [push]
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Especifica el activador de este flujo de trabajo. Este ejemplo utiliza el evento <code>push</code>, así que una ejecución de flujo de trabajo se activa cada que alguien sube un cambio al repositorio o fusiona una solicitud de cambios. Esto se activa mediante una subida a cada rama; para encontrar ejemplos de la sintaxis que solo se ejecuta en subidas a ramas específicas, rutas o etiquetas, consulta la sección <a href="https://docs.github.com/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore">"Sintaxis de flujo de trabajo para las {% data variables.product.prodname_actions %}".</a>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Agrupa los jobs que se ejecutan en el flujo de trabajo <code>learn-github-actions</code>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
check-bats-version:
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Define un job que se llame <code>check-bats-version</code>. Las llaves hijas definirán las propiedades del job.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
runs-on: ubuntu-latest
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Configura el job para que se ejecute en la versión más reciente de un ejecutor Ubuntu Linux. Esto significa que el job se ejecutará en una máquina virtual nueva que se hospede en GitHub. Para encontrar ejemplos de sintaxis que utilicen otros ejecutores, consulta la sección <a href="https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on">"Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}".</a>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
steps:
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Agrupa todos los pasos que se ejecutan en el job <code>check-bats-version</code>. Cada elemento anidado debajo de esta sección es una acción o script de shell por separado.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
- uses: {% data reusables.actions.action-checkout %}
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
The <code>uses</code> keyword specifies that this step will run <code>v3</code> of the <code>actions/checkout</code> action. Esta es una acción que comprueba tu repositorio en el ejecutor, lo cual te permite ejecutar scripts u otras acciones contra tu código (tales como herramientas de compilación y prueba). Debes utilizar la acción de verificación en cualquier momento en el que tu flujo de trabajo se ejecute contra el código del repositorio.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
- uses: {% data reusables.actions.action-setup-node %}
|
||||
with:
|
||||
node-version: '14'
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
This step uses the <code>{% data reusables.actions.action-setup-node %}</code> action to install the specified version of the Node.js (this example uses v14). Esto pone a los comandos <code>node</code> y <code>npm</code> en tu <code>PATH</code>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
- run: npm install -g bats
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
La palabra clave <code>run</code> le dice al job que ejecute un comando en el ejecutor. Ene ste caso, estás utilizando <code>npm</code> para instalar el paquete de pruebas del software <code>bats</code>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
- run: bats -v
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Finalmente, ejecutarás el comando <code>bats</code> con un parámetro que producirá la versión del software.
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### Visualizar el archivo de flujo de trabajo
|
||||
|
||||
En este diagrama, puedes ver el archivo de flujo de trabajo que acabas de crear, así como la forma en que los componentes de {% data variables.product.prodname_actions %} se organizan en una jerarquía. Cada paso ejecuta una acción o script de shell simples. Los pasos 1 y 2 ejecutan acciones, mientras que los pasos 3 y 4 ejecutan scripts de shell. Para encontrar más acciones preconstruidas para tus flujos de trabajo, consulta la sección "[Encontrar y personalizar acciones](/actions/learn-github-actions/finding-and-customizing-actions)".
|
||||
|
||||
|
||||
|
||||
## Ver la actividad del flujo de trabajo
|
||||
|
||||
Una vez que tu flujo de trabajo haya comenzado a ejecutarse, puedes ver la gráfica de visualización del progreso de dicha ejecución, así como la actividad de cada paso en {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
1. Debajo del nombre de tu repositorio, da clic en **Acciones**. 
|
||||
1. En la barra lateral izquierda, da clic en el flujo de trabajo que quieras ver. 
|
||||
1. Debajo de "Ejecuciones de flujo de trabajo", da clic en el nombre de la ejecución que quieres ver. 
|
||||
1. Debajo de **Jobs** o en la gráfica de visualización, da clic en el job que quieras ver. 
|
||||
1. Ve los resultados de cada paso. 
|
||||
{% data reusables.actions.workflow-basic-example-and-explanation %}
|
||||
|
||||
## Pasos siguientes
|
||||
|
||||
@@ -263,7 +100,8 @@ Para entender cómo funciona la facturación de las {% data variables.product.pr
|
||||
|
||||
{% data reusables.actions.contacting-support %}
|
||||
|
||||
{% ifversion ghec or ghes or ghae %}
|
||||
## Leer más
|
||||
|
||||
{% ifversion ghec or ghes or ghae %}
|
||||
- "[Acerca de {% data variables.product.prodname_actions %} para empresas](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises)"{% endif %}
|
||||
- "[Acerca de {% data variables.product.prodname_actions %} para empresas](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises)"
|
||||
{% endif %}
|
||||
|
||||
@@ -0,0 +1,205 @@
|
||||
---
|
||||
title: Acerca de los flujos de trabajo
|
||||
shortTitle: Acerca de los flujos de trabajo
|
||||
intro: 'Get a high level overview {% data variables.product.prodname_actions %} workflows, including triggers, syntax, and advanced features.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
type: overview
|
||||
redirect_from:
|
||||
- /actions/learn-github-actions/managing-complex-workflows
|
||||
- /actions/using-workflows/advanced-workflow-features
|
||||
topics:
|
||||
- Workflows
|
||||
miniTocMaxHeadingLevel: 3
|
||||
---
|
||||
|
||||
## Acerca de los flujos de trabajo
|
||||
|
||||
{% data reusables.actions.about-workflows-long %}
|
||||
|
||||
## Workflow basics
|
||||
|
||||
A workflow must contain the following basic components:
|
||||
|
||||
1. One or more _events_ that will trigger the workflow.
|
||||
1. One or more _jobs_, each of which will execute on a _runner_ machine and run a series of one or more _steps_.
|
||||
1. Each step can either run a script that you define or run an action, which is a reusable extension that can simplify your workflow.
|
||||
|
||||
For more information these basic components, see "[Understanding GitHub Actions](/actions/learn-github-actions/understanding-github-actions#the-components-of-github-actions)."
|
||||
|
||||
|
||||
|
||||
## Activar un flujo de trabajo
|
||||
|
||||
{% data reusables.actions.about-triggers %}
|
||||
|
||||
For more information, see "[Triggering a workflow](/actions/using-workflows/triggering-a-workflow)", and for a full list of events, see "[Events that trigger workflows](/actions/using-workflows/events-that-trigger-workflows)."
|
||||
|
||||
## Sintaxis de flujos de trabajo
|
||||
|
||||
Workflow are defined using YAML. For the full reference of the YAML syntax for authoring workflows, see "[Workflow syntax for GitHub Actions](/actions/using-workflows/workflow-syntax-for-github-actions#about-yaml-syntax-for-workflows)."
|
||||
|
||||
|
||||
{% data reusables.actions.workflow-basic-example-and-explanation %}
|
||||
|
||||
For more on managing workflow runs, such as re-running, cancelling, or deleting a workflow run, see "[Managing workflow runs](/actions/managing-workflow-runs)."
|
||||
|
||||
## Utilizar flujos de trabajo iniciales
|
||||
|
||||
{% data reusables.actions.workflow-template-overview %}
|
||||
|
||||
For more information on using and creating starter workflows, see "[Using starter workflows](/actions/using-workflows/using-starter-workflows)" and "[Creating starter workflows for your organization](/actions/using-workflows/creating-starter-workflows-for-your-organization)."
|
||||
|
||||
## Características avanzadas de los flujos de trabajo
|
||||
|
||||
This section briefly describes some of the advanced features of {% data variables.product.prodname_actions %} that help you create more complex workflows.
|
||||
|
||||
### Almacenar secretos
|
||||
|
||||
Si tus flujos de trabajo utilizan datos sensibles tales como contraseñas o certificados, puedes guardarlos en {% data variables.product.prodname_dotcom %} como _secretos_ y luego usarlos en tus flujos de trabajo como variables de ambiente. This means that you will be able to create and share workflows without having to embed sensitive values directly in the workflow's YAML source.
|
||||
|
||||
This example job demonstrates how to reference an existing secret as an environment variable, and send it as a parameter to an example command.
|
||||
|
||||
{% raw %}
|
||||
```yaml
|
||||
jobs:
|
||||
example-job:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Retrieve secret
|
||||
env:
|
||||
super_secret: ${{ secrets.SUPERSECRET }}
|
||||
run: |
|
||||
example-command "$super_secret"
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
Para obtener más información, consulta la sección "[Secretos cifrados](/actions/security-guides/encrypted-secrets)".
|
||||
|
||||
### Crear jobs dependientes
|
||||
|
||||
Predeterminadamente, los jobs en tu flujo de trabajo se ejecutan todos en paralelo y al mismo tiempo. If you have a job that must only run after another job has completed, you can use the `needs` keyword to create this dependency. If one of the jobs fails, all dependent jobs are skipped; however, if you need the jobs to continue, you can define this using the `if` conditional statement.
|
||||
|
||||
En este ejemplo, los jobs de `setup`, `build`, y `test` se ejecutan en serie, y `build` y `test` son dependientes de que el job que las precede se complete con éxito:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
setup:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: ./setup_server.sh
|
||||
build:
|
||||
needs: setup
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: ./build_server.sh
|
||||
test:
|
||||
needs: build
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: ./test_server.sh
|
||||
```
|
||||
|
||||
Para obtener más información, consulta la sección "[Definir los jobs de prerrequisito](/actions/using-jobs/using-jobs-in-a-workflow#defining-prerequisite-jobs)".
|
||||
|
||||
### Utilizar una matriz de compilaciones
|
||||
|
||||
You can use a build matrix if you want your workflow to run tests across multiple combinations of parameters, such as operating systems, platforms, and languages. La matriz de compilaciones se crea utilizando la palabra clave `strategy`, la cual recibe las opciones de compilación como un arreglo. Por ejemplo, esta matriz de compilaciones ejecutará el job varias veces, utilizando diferentes versiones de Node.js:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
strategy:
|
||||
matrix:
|
||||
node: [6, 8, 10]
|
||||
steps:
|
||||
- uses: {% data reusables.actions.action-setup-node %}
|
||||
with:
|
||||
node-version: {% raw %}${{ matrix.node }}{% endraw %}
|
||||
```
|
||||
|
||||
Para obtener más información, consulte la sección "[Utilizar una matriz de compilación para tus jobs](/actions/using-jobs/using-a-build-matrix-for-your-jobs)".
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
### Almacenar dependencias en caché
|
||||
|
||||
Los ejecutores hospedados en {% data variables.product.prodname_dotcom %} se inician como ambientes nuevos para cada job, así que, si tus jobs utilizan dependencias a menudo, puedes considerar almacenar estos archivos en caché para ayudarles a mejorar el rendimiento. Una vez que se crea el caché, estará disponible para todos los flujos de trabajo en el mismo repositorio.
|
||||
|
||||
Este ejemplo ilustra cómo almacenar el directorio `~/.npm` en el caché:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
example-job:
|
||||
steps:
|
||||
- name: Cache node modules
|
||||
uses: {% data reusables.actions.action-cache %}
|
||||
env:
|
||||
cache-name: cache-node-modules
|
||||
with:
|
||||
path: ~/.npm
|
||||
key: {% raw %}${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}{% endraw %}
|
||||
restore-keys: |
|
||||
{% raw %}${{ runner.os }}-build-${{ env.cache-name }}-{% endraw %}
|
||||
```
|
||||
|
||||
Para obtener más información, consulta la sección "[Almacenar las dependencias en caché para agilizar los flujos de trabajo](/actions/using-workflows/caching-dependencies-to-speed-up-workflows)".
|
||||
{% endif %}
|
||||
|
||||
### Usar bases de datos y contenedores de servicio
|
||||
|
||||
Si tu job requiere de un servicio de caché o de base de datos, puedes utilizar la palabra clave [`services`](/actions/using-jobs/running-jobs-in-a-container) para crear un contenedor efímero para almacenar el servicio; el contenedor resultante estará entonces disponible para todos los pasos de ese job y se eliminará cuando el job se haya completado. Este ejemplo ilustra como un job puede utilizar `services` para crear un contenedor de `postgres` y luego utilizar a `node` para conectarse al servicio.
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
container-job:
|
||||
runs-on: ubuntu-latest
|
||||
container: node:10.18-jessie
|
||||
services:
|
||||
postgres:
|
||||
image: postgres
|
||||
steps:
|
||||
- name: Check out repository code
|
||||
uses: {% data reusables.actions.action-checkout %}
|
||||
- name: Install dependencies
|
||||
run: npm ci
|
||||
- name: Connect to PostgreSQL
|
||||
run: node client.js
|
||||
env:
|
||||
POSTGRES_HOST: postgres
|
||||
POSTGRES_PORT: 5432
|
||||
```
|
||||
|
||||
For more information, see "[Using containerized services](/actions/using-containerized-services)."
|
||||
|
||||
### Utilizar etiquetas para enrutar los flujos de trabajo
|
||||
|
||||
Si quieres asegurarte de que un tipo específico de ejecutor procesará tu job, puedes utilizar etiquetas para controlar donde se ejecutan los jobs. Puedes asignar etiquetas a un ejecutor auto-hospedado adicionalmente a su etiqueta predeterminada de `self-hosted`. Entonces, puedes referirte a estas etiquetas en tu flujo de trabajo de YAML, garantizando que el job se enrute de forma predecible.{% ifversion not ghae %}Los ejecutores hospedados en {% data variables.product.prodname_dotcom %} tienen asignadas etiquetas predefinidas.{% endif %}
|
||||
|
||||
Este ejemplo muestra como un flujo de trabajo puede utilizar etiquetas para especificar el ejecutor requerido:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
example-job:
|
||||
runs-on: [self-hosted, linux, x64, gpu]
|
||||
```
|
||||
|
||||
Un flujo de trabajo solo se ejecutará en un ejecutor que tenga todas las etiquetas en el arreglo `runs-on`. El job irá preferencialmente a un ejecutor auto-hospedado inactivo con las etiquetas especificadas. {% ifversion fpt or ghec %}If none are available and a {% data variables.product.prodname_dotcom %}-hosted runner with the specified labels exists, the job will go to a {% data variables.product.prodname_dotcom %}-hosted runner.{% endif %}
|
||||
|
||||
To learn more about self-hosted runner labels, see "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)."
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
To learn more about {% data variables.product.prodname_dotcom %}-hosted runner labels, see "[Supported runners and hardware resources](/actions/using-github-hosted-runners/about-github-hosted-runners#supported-runners-and-hardware-resources)."
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %}
|
||||
### Reutilizar flujos de trabajo
|
||||
{% data reusables.actions.reusable-workflows %}
|
||||
{% endif %}
|
||||
|
||||
### Utilizar ambientes
|
||||
|
||||
You can configure environments with protection rules and secrets to control the execution of jobs in a workflow. Cad job en un flujo de trabajo puede referenciar un solo ambiente. Cualquier regla de protección que se configure para el ambiente debe pasar antes de que un job que referencia al ambiente se envíe a un ejecutor. Para obtener más información, consulta la sección "[Utilizar ambientes para despliegue](/actions/deployment/using-environments-for-deployment)".
|
||||
@@ -1,183 +0,0 @@
|
||||
---
|
||||
title: Características avanzadas de los flujos de trabajo
|
||||
shortTitle: Características avanzadas de los flujos de trabajo
|
||||
intro: 'Esta guía te muestra cómo utilizar las características avanzadas de las {% data variables.product.prodname_actions %}, con administración de secretos, jobs dependientes, almacenamiento en caché, matrices de compilación, ambientes y etiquetas.'
|
||||
redirect_from:
|
||||
- /actions/learn-github-actions/managing-complex-workflows
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Workflows
|
||||
miniTocMaxHeadingLevel: 4
|
||||
---
|
||||
|
||||
{% data reusables.actions.enterprise-beta %}
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
## Resumen
|
||||
|
||||
Este artículo describe algunas de las características avanzadas de las {% data variables.product.prodname_actions %} que te ayudan a crear flujos de trabajo más complejos.
|
||||
|
||||
## Almacenar secretos
|
||||
|
||||
Si tus flujos de trabajo utilizan datos sensibles tales como contraseñas o certificados, puedes guardarlos en {% data variables.product.prodname_dotcom %} como _secretos_ y luego usarlos en tus flujos de trabajo como variables de ambiente. Esto significa que podrás crear y compartir flujos de trabajo sin tener que embeber valores sensibles directamente en el flujo de trabajo de YAML.
|
||||
|
||||
Esta acción de ejemplo ilustra cómo referenciar un secreto existente como una variable de ambiente y enviarla como parámetro a un comando de ejemplo.
|
||||
|
||||
{% raw %}
|
||||
```yaml
|
||||
jobs:
|
||||
example-job:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Retrieve secret
|
||||
env:
|
||||
super_secret: ${{ secrets.SUPERSECRET }}
|
||||
run: |
|
||||
example-command "$super_secret"
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
Para obtener más información, consulta "[Crear y almacenar secretos cifrados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)".
|
||||
|
||||
## Crear jobs dependientes
|
||||
|
||||
Predeterminadamente, los jobs en tu flujo de trabajo se ejecutan todos en paralelo y al mismo tiempo. Así que, si tienes un job que solo debe ejecutarse después de que se complete otro job, puedes utilizar la palabra clave `needs` para crear esta dependencia. Si un de los jobs falla, todos los jobs dependientes se omitirán; sin embargo, si necesitas que los jobs sigan, puedes definir esto utilizando la declaración condicional [`if`](/actions/using-jobs/using-conditions-to-control-job-execution).
|
||||
|
||||
En este ejemplo, los jobs de `setup`, `build`, y `test` se ejecutan en serie, y `build` y `test` son dependientes de que el job que las precede se complete con éxito:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
setup:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: ./setup_server.sh
|
||||
build:
|
||||
needs: setup
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: ./build_server.sh
|
||||
test:
|
||||
needs: build
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: ./test_server.sh
|
||||
```
|
||||
|
||||
Para obtener más información, consulta la sección "[Definir los jobs de prerrequisito](/actions/using-jobs/using-jobs-in-a-workflow#defining-prerequisite-jobs)".
|
||||
|
||||
## Utilizar una matriz de compilaciones
|
||||
|
||||
Puedes utilizar una matriz de compilaciones si quieres que tu flujo de trabajo ejecute pruebas a través de varias combinaciones de sistemas operativos, plataformas y lenguajes. La matriz de compilaciones se crea utilizando la palabra clave `strategy`, la cual recibe las opciones de compilación como un arreglo. Por ejemplo, esta matriz de compilaciones ejecutará el job varias veces, utilizando diferentes versiones de Node.js:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
strategy:
|
||||
matrix:
|
||||
node: [6, 8, 10]
|
||||
steps:
|
||||
- uses: {% data reusables.actions.action-setup-node %}
|
||||
with:
|
||||
node-version: {% raw %}${{ matrix.node }}{% endraw %}
|
||||
```
|
||||
|
||||
Para obtener más información, consulte la sección "[Utilizar una matriz de compilación para tus jobs](/actions/using-jobs/using-a-build-matrix-for-your-jobs)".
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## Almacenar dependencias en caché
|
||||
|
||||
Los ejecutores hospedados en {% data variables.product.prodname_dotcom %} se inician como ambientes nuevos para cada job, así que, si tus jobs utilizan dependencias a menudo, puedes considerar almacenar estos archivos en caché para ayudarles a mejorar el rendimiento. Una vez que se crea el caché, estará disponible para todos los flujos de trabajo en el mismo repositorio.
|
||||
|
||||
Este ejemplo ilustra cómo almacenar el directorio `~/.npm` en el caché:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
example-job:
|
||||
steps:
|
||||
- name: Cache node modules
|
||||
uses: {% data reusables.actions.action-cache %}
|
||||
env:
|
||||
cache-name: cache-node-modules
|
||||
with:
|
||||
path: ~/.npm
|
||||
key: {% raw %}${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}{% endraw %}
|
||||
restore-keys: |
|
||||
{% raw %}${{ runner.os }}-build-${{ env.cache-name }}-{% endraw %}
|
||||
```
|
||||
|
||||
Para obtener más información, consulta la sección "<a href="/actions/guides/caching-dependencies-to-speed-up-workflows" class="dotcom-only">Almacenar las dependencias en caché para agilizar los flujos de trabajo</a>".
|
||||
{% endif %}
|
||||
|
||||
## Usar bases de datos y contenedores de servicio
|
||||
|
||||
Si tu job requiere de un servicio de caché o de base de datos, puedes utilizar la palabra clave [`services`](/actions/using-jobs/running-jobs-in-a-container) para crear un contenedor efímero para almacenar el servicio; el contenedor resultante estará entonces disponible para todos los pasos de ese job y se eliminará cuando el job se haya completado. Este ejemplo ilustra como un job puede utilizar `services` para crear un contenedor de `postgres` y luego utilizar a `node` para conectarse al servicio.
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
container-job:
|
||||
runs-on: ubuntu-latest
|
||||
container: node:10.18-jessie
|
||||
services:
|
||||
postgres:
|
||||
image: postgres
|
||||
steps:
|
||||
- name: Check out repository code
|
||||
uses: {% data reusables.actions.action-checkout %}
|
||||
- name: Install dependencies
|
||||
run: npm ci
|
||||
- name: Connect to PostgreSQL
|
||||
run: node client.js
|
||||
env:
|
||||
POSTGRES_HOST: postgres
|
||||
POSTGRES_PORT: 5432
|
||||
```
|
||||
|
||||
Para obtener más información, consulta la sección "[Utilizar bases de datos y contenedores de servicios](/actions/configuring-and-managing-workflows/using-databases-and-service-containers)".
|
||||
|
||||
## Utilizar etiquetas para enrutar los flujos de trabajo
|
||||
|
||||
Esta característica te ayuda a asignar jobs a un ejecutor hospedado específico. Si quieres asegurarte de que un tipo específico de ejecutor procesará tu job, puedes utilizar etiquetas para controlar donde se ejecutan los jobs. Puedes asignar etiquetas a un ejecutor auto-hospedado adicionalmente a su etiqueta predeterminada de `self-hosted`. Entonces, puedes referirte a estas etiquetas en tu flujo de trabajo de YAML, garantizando que el job se enrute de forma predecible.{% ifversion not ghae %}Los ejecutores hospedados en {% data variables.product.prodname_dotcom %} tienen asignadas etiquetas predefinidas.{% endif %}
|
||||
|
||||
Este ejemplo muestra como un flujo de trabajo puede utilizar etiquetas para especificar el ejecutor requerido:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
example-job:
|
||||
runs-on: [self-hosted, linux, x64, gpu]
|
||||
```
|
||||
|
||||
Un flujo de trabajo solo se ejecutará en un ejecutor que tenga todas las etiquetas en el arreglo `runs-on`. El job irá preferencialmente a un ejecutor auto-hospedado inactivo con las etiquetas especificadas. Si no hay alguno disponible y existe un ejecutor hospedado en {% data variables.product.prodname_dotcom %} con las etiquetas especificadas, el job irá a un ejecutor hospedado en {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
Para aprender más acerca de las etiquetas auto-hospedadas, consulta la sección ["Utilizar etiquetas con los ejecutores auto-hospedados](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)".
|
||||
|
||||
{% ifversion fpt or ghes %}
|
||||
Para aprender más sobre las etiquetas de los ejecutores hospedados en {% data variables.product.prodname_dotcom %}, consulta la sección ["Ejecutores y recursos de hardware compatibles"](/actions/using-github-hosted-runners/about-github-hosted-runners#supported-runners-and-hardware-resources).
|
||||
{% endif %}
|
||||
|
||||
{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %}
|
||||
## Reutilizar flujos de trabajo
|
||||
{% data reusables.actions.reusable-workflows %}
|
||||
{% endif %}
|
||||
|
||||
## Utilizar ambientes
|
||||
|
||||
Puedes configurr ambientes con reglas de protección y secretos. Cad job en un flujo de trabajo puede referenciar un solo ambiente. Cualquier regla de protección que se configure para el ambiente debe pasar antes de que un job que referencia al ambiente se envíe a un ejecutor. Para obtener más información, consulta la sección "[Utilizar ambientes para despliegue](/actions/deployment/using-environments-for-deployment)".
|
||||
|
||||
## Utilizar flujos de trabajo iniciales
|
||||
|
||||
{% data reusables.actions.workflow-template-overview %}
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.actions-tab %}
|
||||
1. Si tu repositorio ya cuenta con flujos de trabajo: En la esquina superior izquierda, da clic sobre **Flujo de trabajo nuevo**. 
|
||||
1. Debajo del nombre del flujo de trabajo inicial que te gustaría utilizar, haz clic en **Configurar este flujo de trabajo**. 
|
||||
|
||||
## Pasos siguientes
|
||||
|
||||
Para seguir aprendiendo sobre las {% data variables.product.prodname_actions %}, consulta la sección "[Compartir flujos de trabajo, secretos y ejecutores con tu organización](/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization)".
|
||||
@@ -21,12 +21,12 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
children:
|
||||
- /about-workflows
|
||||
- /triggering-a-workflow
|
||||
- /events-that-trigger-workflows
|
||||
- /workflow-syntax-for-github-actions
|
||||
- /workflow-commands-for-github-actions
|
||||
- /reusing-workflows
|
||||
- /advanced-workflow-features
|
||||
- /creating-starter-workflows-for-your-organization
|
||||
- /using-starter-workflows
|
||||
- /sharing-workflows-secrets-and-runners-with-your-organization
|
||||
|
||||
@@ -20,14 +20,7 @@ miniTocMaxHeadingLevel: 3
|
||||
|
||||
## Acerca de los activadores de los flujos de trabajo
|
||||
|
||||
Los activadores de los flujos de trabajo son eventos que ocasionan que se ejecute un flujo de trabajo. Estos eventos pueden ser:
|
||||
|
||||
- Eventos que ocurren en el repositorio de tu flujo de trabajo
|
||||
- Eventos que ocurren fuera de {% data variables.product.product_name %} y activan un evento de `repository_dispatch` en {% data variables.product.product_name %}
|
||||
- Tiempos programados
|
||||
- Manual
|
||||
|
||||
Por ejemplo, puedes configurar tu flujo de trabajo para que se ejecute cuando se realiza una subida a la rama predeterminada de tu repositorio, cuando se crea un lanzamiento o cuando se abre una propuesta.
|
||||
{% data reusables.actions.about-triggers %}
|
||||
|
||||
Los activadores de los flujos de trabajo se definen con la clave `on`. Para obtener más información, consulta la sección "[Sintaxis del flujo de trabajo para las {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#on)".
|
||||
|
||||
@@ -43,7 +36,7 @@ Los siguientes pasos se producen para activar una ejecución de flujo de trabajo
|
||||
|
||||
{% data reusables.actions.actions-do-not-trigger-workflows %} Para obtener más información, consulta la sección "[Autenticarse con el GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)".
|
||||
|
||||
Si no quieres activar un flujo de trabajo dentro una ejecución de flujo de trabajo, puedes utilizar un token de acceso personal en vez de un `GITHUB_TOKEN` para activar los eventos que requieren tu token. Necesitaras crear un token de acceso personal y almacenarlo como un secreto. Para minimizar tus costos de uso de {% data variables.product.prodname_actions %}, asegúrate de no crear ejecuciones de flujo de trabajo recurrentes o involuntarias. Para obtener más información acerca de cómo crear un token de acceso personal, consulta la sección "[Crear un token de acceso personal](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)". Para obtener más información sobre cómo almacenr un token de acceso personal como secreto, consulta la sección "[Crear y almacenar secretos cifrados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)".
|
||||
Si no quieres activar un flujo de trabajo dentro una ejecución de flujo de trabajo, puedes utilizar un token de acceso personal en vez de un `GITHUB_TOKEN` para activar los eventos que requieren tu token. Necesitaras crear un token de acceso personal y almacenarlo como un secreto. Para minimizar tus costos de uso de {% data variables.product.prodname_actions %}, asegúrate de no crear ejecuciones de flujo de trabajo recurrentes o involuntarias. For more information about creating a personal access token, see "[Creating a personal access token](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)." Para obtener más información sobre cómo almacenr un token de acceso personal como secreto, consulta la sección "[Crear y almacenar secretos cifrados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)".
|
||||
|
||||
Por ejemplo, el siguiente flujo de trabajo utiliza un token de acceso personal (almacenado como secreto y llamado `MY_TOKEN`) para agregar una etiqueta a una propuesta de cambios a través del cli.{% data variables.product.prodname_cli %}. Cualquier flujo de trabajo que se ejecute cuando una etiqueta se agrega se ejecutará una vez mediante este espejo.
|
||||
|
||||
|
||||
@@ -39,8 +39,10 @@ Cualquiera con permiso de escritura en un repositorio puede configurar flujos de
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.actions-tab %}
|
||||
1. Si ya tienes un flujo de trabajo en tu repositorio, haz clic en **Flujo de trabajo nuevo**.
|
||||
1. Encuentra el flujo de trabajo inicial que quieras utilizar y luego haz clic en **Configurar este flujo de trabajo**.{% if actions-starter-template-ui %} Para ayudarte a encontrar el flujo de trabajo inicial que quieres, puedes buscar palabras clave o filtrar por categoría.{% endif %}
|
||||
1. Si el flujo de trabajo inicial contiene comentarios que detallen pasos de configuración adicional, sigue estos pasos. Muchos de los flujos de trabajo iniciales tienen guías correspondientes. Para obtener más información, consulta [las guías de {% data variables.product.prodname_actions %}](/actions/guides).
|
||||
1. The "{% if actions-starter-template-ui %}Choose a workflow{% else %}Choose a workflow template{% endif %}" page shows a selection of recommended starter workflows. Find the starter workflow that you want to use, then click {% if actions-starter-template-ui %}**Configure**{% else %}**Set up this workflow**{% endif %}.{% if actions-starter-template-ui %} To help you find the starter workflow that you want, you can search for keywords or filter by category.{% endif %}
|
||||
|
||||
{% if actions-starter-template-ui %}{% else %}{% endif %}
|
||||
1. Si el flujo de trabajo inicial contiene comentarios que detallen pasos de configuración adicional, sigue estos pasos. Muchos de los flujos de trabajo iniciales tienen guías correspondientes. For more information, see the [{% data variables.product.prodname_actions %} guides](/actions/guides).
|
||||
1. Algunos flujos de trabajo iniciales utilizan secretos. Por ejemplo, {% raw %}`${{ secrets.npm_token }}`{% endraw %}. Si el flujo de trabajo inicial utiliza un secreto, almacena el valor descrito en el nombre del secreto como un secreto en tu repositorio. Para obtener más información, consulta "[Secretos cifrados](/actions/reference/encrypted-secrets)".
|
||||
1. Opcionalmente, haz cambios adicionales. Por ejemplo, puede que quieras cambiar el valor de `on` para que este cambie cuando se ejecute el flujo de trabajo.
|
||||
1. Haz clic en **Iniciar confirmación**.
|
||||
|
||||
@@ -1,38 +1,53 @@
|
||||
---
|
||||
title: Lanzamientos de GitHub Enterprise Server
|
||||
intro: 'Documentación para las versiones actualmente compatibles y previamente obsoletizadas de {{ site.data.variables.product.prodname_ghe_server }}.'
|
||||
intro: '{% data variables.product.company_short %} releases new versions of {% data variables.product.product_name %} regularly. You can review supported versions, see deprecation dates, and browse documentation for the release you''ve deployed.'
|
||||
allowTitleToDifferFromFilename: true
|
||||
versions:
|
||||
ghes: '*'
|
||||
topics:
|
||||
- Enterprise
|
||||
- Upgrades
|
||||
shortTitle: Lanzamientos
|
||||
---
|
||||
|
||||
## Actualmente compatibles
|
||||
## About releases of {% data variables.product.product_name %}
|
||||
|
||||
Consulta la sección [{% data variables.product.prodname_enterprise %}](https://github.com/enterprise) para obtener más información sobre el último lanzamiento.
|
||||
{% data reusables.enterprise.constantly-improving %} {% data variables.product.company_short %} supports the four most recent feature releases. For more information, see "[About upgrades to new releases](/admin/overview/about-upgrades-to-new-releases)."
|
||||
|
||||
{% for supportedRelease in enterpriseServerReleases.supported %}
|
||||
- [{% data variables.product.prodname_ghe_server %} {{supportedRelease}}](/enterprise-server@{{supportedRelease}})
|
||||
{% endfor %}
|
||||
You can see what's new for each release in the [release notes](/admin/release-notes), and you can view administrator and user documentation for all releases here on {% data variables.product.prodname_docs %}. When you read the documentation, make sure to select the version that reflects your product. Para obtener más información, consulta la sección "[Acerca de las versiones de {% data variables.product.prodname_docs %}](/get-started/learning-about-github/about-versions-of-github-docs)".
|
||||
|
||||
## Obsoletizado
|
||||
## Currently supported releases
|
||||
|
||||
La documentación dlae s versiones obsoletizadas sigue estando disponible pero ya no se le da mantenimiento.
|
||||
{% data variables.product.company_short %} supports the following releases of {% data variables.product.product_name %}. For more information about the latest release, see the [{% data variables.product.prodname_enterprise %}](https://github.com/enterprise) website.
|
||||
|
||||
{% for deprecatedRelease in enterpriseServerReleases.deprecatedReleasesWithNewFormat %}
|
||||
- [Enterprise Server {{deprecatedRelease}}](/enterprise-server@{{deprecatedRelease}})
|
||||
{% endfor %}
|
||||
| Versión | Lanzamiento | Deprecation | Notas de lanzamiento | Documentación |
|
||||
|:------- |:----------- |:----------- |:-------------------- |:------------- |
|
||||
| | | | | |
|
||||
{%- for version in enterpriseServerReleases.supported %}
|
||||
| {{version}} | {{enterpriseServerReleases.dates[version].releaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | [{{version}} release notes](/enterprise-server@{{version}}/admin/release-notes) | [{{version}} documentation](/enterprise-server@{{version}}) |
|
||||
{%- endfor %}
|
||||
|
||||
{% for deprecatedReleaseLegacyFormat in enterpriseServerReleases.deprecatedReleasesWithLegacyFormat %}
|
||||
- [Enterprise Server {{deprecatedReleaseLegacyFormat}}](/enterprise/{{deprecatedReleaseLegacyFormat}})
|
||||
{% endfor %}
|
||||
## Deprecated releases
|
||||
|
||||
## Documentación obsoletizada para desarrolladores
|
||||
{% data variables.product.company_short %} provides documentation for deprecated versions, but does not maintain or update the documentation.
|
||||
|
||||
La documentación para desarrolladores para las versiones obsoletizadas sigue disponible, pero ya no se le da mantenimiento.
|
||||
| Versión | Lanzamiento | Deprecation | Notas de lanzamiento | Documentación |
|
||||
|:------- |:----------- |:----------- |:-------------------- |:------------- |
|
||||
| | | | | |
|
||||
{%- for version in enterpriseServerReleases.deprecatedReleasesWithNewFormat %}
|
||||
| {{version}} | {{enterpriseServerReleases.dates[version].releaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | [{{version}} release notes](/enterprise-server@{{version}}/admin/release-notes) | [{{version}} documentation](/enterprise-server@{{version}}) |
|
||||
{%- endfor %}
|
||||
{%- for version in enterpriseServerReleases.deprecatedReleasesWithLegacyFormat %}
|
||||
| {{version}} | {{enterpriseServerReleases.dates[version].releaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | [{{version}} release notes](https://enterprise.github.com/releases/series/{{version}}) | [{{version}} documentation](/enterprise/{{version}}) |
|
||||
{%- endfor %}
|
||||
|
||||
{% for deprecatedDevRelease in enterpriseServerReleases.deprecatedReleasesOnDeveloperSite %}
|
||||
- [Enterprise Server {{deprecatedDevRelease}}](https://developer.github.com/enterprise/{{deprecatedDevRelease}})
|
||||
{% endfor %}
|
||||
### Documentación obsoletizada para desarrolladores
|
||||
|
||||
{% data variables.product.company_short %} hosted developer documentation for {% data variables.product.product_name %} on a separate site until the 2.17 release. {% data variables.product.company_short %} continues to provide developer documentation for version 2.16 and earlier, but does not maintain or update the documentation.
|
||||
|
||||
| Versión | Lanzamiento | Deprecation | Developer documentation |
|
||||
|:------- |:----------- |:----------- |:----------------------- |
|
||||
| | | | |
|
||||
{%- for version in enterpriseServerReleases.deprecatedReleasesOnDeveloperSite %}
|
||||
| {{version}} | {{enterpriseServerReleases.dates[version].releaseDate}} | {{enterpriseServerReleases.dates[version].deprecationDate}} | [{{version}} developer documentation](https://developer.github.com/enterprise/{{version}}) |
|
||||
{%- endfor %}
|
||||
|
||||
@@ -27,7 +27,7 @@ topics:
|
||||
|
||||
Como propietario de empresa, puedes permitir que los usuarios finales envíen cuentas de contribuciones anonimizadas para su trabajo desde {% data variables.product.product_location %} hacia su gráfica de contribuciones de {% data variables.product.prodname_dotcom_the_website %}.
|
||||
|
||||
Después de habilitar las {% data variables.product.prodname_unified_contributions %}, antes de que los usuarios individuales puedan enviar conteos de contribuciones de {% data variables.product.product_location %} a {% data variables.product.prodname_dotcom_the_website %}, cada uno de ellos también debe conectar su cuenta personal de {% data variables.product.product_name %} con una cuenta personal de {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta la sección "[Enviar contribuciones empresariales a tu perfil de {% data variables.product.prodname_dotcom_the_website %}](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile)".
|
||||
After you enable {% data variables.product.prodname_unified_contributions %}, before individual users can send contribution counts from {% data variables.product.product_location %} to {% data variables.product.prodname_dotcom_the_website %}, each user must also connect their user account on {% data variables.product.product_name %} with a personal account on {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta la sección "[Enviar contribuciones empresariales a tu perfil de {% data variables.product.prodname_dotcom_the_website %}](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile)".
|
||||
|
||||
{% data reusables.github-connect.sync-frequency %}
|
||||
|
||||
|
||||
@@ -32,7 +32,7 @@ Puedes elegir permitir los resultados de búsqueda para los repositorios públic
|
||||
|
||||
Los usuarios jamás podrán buscar en {% data variables.product.product_location %} desde {% data variables.product.prodname_dotcom_the_website %}, incluso si tienen acceso a ambos ambientes.
|
||||
|
||||
Después de habilitar la búsqueda unificada para {% data variables.product.product_location %}, antes de que los usuarios individuales puedan ver los resultados de búsqueda de {% data variables.product.prodname_dotcom_the_website %} en {% data variables.product.product_location %}, cada uno de ellos también debe conectar su cuenta personal de {% data variables.product.product_name %} con una cuenta personal de {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta la sección "[Habilitar la búsqueda de repositorios de {% data variables.product.prodname_dotcom_the_website %} en tu cuenta de empresa privada](/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment)".
|
||||
After you enable unified search for {% data variables.product.product_location %}, before individual users can see search results from private repositories on {% data variables.product.prodname_dotcom_the_website %} in {% data variables.product.product_location %}, each user must also connect their user account on {% data variables.product.product_name %} with a user account on {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta la sección "[Habilitar la búsqueda de repositorios de {% data variables.product.prodname_dotcom_the_website %} en tu cuenta de empresa privada](/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment)".
|
||||
|
||||
Buscar a través de las API REST y GraphQL no incluye {% data variables.product.prodname_dotcom_the_website %} los resultados de búsqueda. No están admitidas la búsqueda avanzada y buscar wikis en {% data variables.product.prodname_dotcom_the_website %}.
|
||||
|
||||
|
||||
@@ -22,7 +22,7 @@ topics:
|
||||
- Security
|
||||
---
|
||||
|
||||
Debes habilitar el modo privado si {% data variables.product.product_location %} es de acceso público por internet. En el modo privado, los usuarios no pueden clonar repositorios en forma anónima por `git://`. Si también está habilitada la autenticación incorporada, un administrador debe invitar a los nuevos usuarios para que creen una cuenta en la instancia. Para obtener más información, consulta "[Usar la autenticación incorporada](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-built-in-authentication)."
|
||||
Debes habilitar el modo privado si {% data variables.product.product_location %} es de acceso público por internet. En el modo privado, los usuarios no pueden clonar repositorios en forma anónima por `git://`. Si también está habilitada la autenticación incorporada, un administrador debe invitar a los nuevos usuarios para que creen una cuenta en la instancia. For more information, see "[Configuring built-in authentication](/admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication)."
|
||||
|
||||
{% data reusables.enterprise_installation.image-urls-viewable-warning %}
|
||||
|
||||
|
||||
@@ -186,14 +186,31 @@ For example, the following words are reserved, among others:
|
||||
|
||||
For the full list or reserved words, navigate to "Reserved logins" in the site admin dashboard.
|
||||
|
||||
{% ifversion ghes or ghae %}
|
||||
{% if ghas-committers-calculator %}
|
||||
## {% data variables.product.prodname_advanced_security %} Committers
|
||||
|
||||
You can see the number of active committers that are currently using seats for {% data variables.product.prodname_GH_advanced_security %}, and you can calculate how many additional seats would be used if you enabled {% data variables.product.prodname_GH_advanced_security %} for more organizations and repositories.
|
||||
|
||||
Under "Current active committer count", you can see the number of active committers for repositories with {% data variables.product.prodname_GH_advanced_security %} enabled. This is the number of licensed seats that are currently being used.
|
||||
|
||||
Under "Maximum committers across across entire instance", you can see the number of active committers across all the repositories in your enterprise. This is the number of seats that would be used if you enabled {% data variables.product.prodname_GH_advanced_security %} for every repository in your enterprise.
|
||||
|
||||
Under "Calculate Additional Advanced Committers", you can calculate how many more additional seats will be used if you enable {% data variables.product.prodname_GH_advanced_security %} for specific organizations and repositories. Under "Organizations and Repositories", enter or paste a list of organizations and repositories, with one organization or repository per line.
|
||||
|
||||
```
|
||||
example-org
|
||||
octo-org/octo-repo
|
||||
```
|
||||
|
||||
The result is the number of additional seats that would be used if you enabled {% data variables.product.prodname_GH_advanced_security %} for those organizations and repositories.
|
||||
|
||||
For more information about billing for {% data variables.product.prodname_advanced_security %}, see "[About billing for {% data variables.product.prodname_advanced_security %}](/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security)."
|
||||
{% endif %}
|
||||
|
||||
## Enterprise overview
|
||||
|
||||
Refer to this section of the site admin dashboard to manage organizations, people, policies, and settings.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Repositories
|
||||
|
||||
This is a list of the repositories on {% data variables.product.product_location %}. You can click on a repository name and access functions for administering the repository.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Utilizar un ambiente de montaje
|
||||
intro: 'Aprende sobre cómo utilizar {% data variables.product.prodname_actions %} con los ambientes de montaje de {% data variables.product.prodname_ghe_server %}.'
|
||||
intro: 'Learn about using {% data variables.product.prodname_actions %} with {% data variables.product.prodname_ghe_server %} staging instances.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
@@ -11,18 +11,34 @@ topics:
|
||||
- Upgrades
|
||||
redirect_from:
|
||||
- /admin/github-actions/using-a-staging-environment
|
||||
shortTitle: Utiliza un área de pruebas
|
||||
shortTitle: Use staging environment
|
||||
---
|
||||
|
||||
Puede ser útil tener un ambiente de montaje o de pruebas para {% data variables.product.product_location %}, para que así puedas probar las actualizaciones o características nuevas antes de implementarlas en tu ambiente productivo.
|
||||
## About staging environments for {% data variables.product.product_name %}
|
||||
|
||||
Una forma común para crear el ambiente de montaje es utilizar un respaldo de tu instancia productiva y restablecerlo al ambiente de montaje.
|
||||
Puede ser útil tener un ambiente de montaje o de pruebas para {% data variables.product.product_location %}, para que así puedas probar las actualizaciones o características nuevas antes de implementarlas en tu ambiente productivo. Para obtener más información, consulta "[Configurar una instancia de preparación](/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance)."
|
||||
|
||||
Cuando configures un ambiente de montaje de {% data variables.product.prodname_ghe_server %} que cuente con {% data variables.product.prodname_actions %} habilitadas, debes utilizar una configuración de almacenamiento externo diferente al de tu ambiente productivo para almacenar las {% data variables.product.prodname_actions %}. De lo contrario, tu ambiente de montaje escribirá en el mismo almacenamiento externo que utiliza tu ambiente productivo.
|
||||
## Using a staging environment with {% data variables.product.prodname_actions %}
|
||||
|
||||
Espera ver errores de tipo `404` en tu ambiente de montaje cuando trates de ver las bitácoras o artefactos para las ejecuciones de flujo de trabajo de {% data variables.product.prodname_actions %}, ya que estos datos estarán ausentes de tu ubicación de almacenamiento de montaje.
|
||||
A common way to create the staging environment is to restore a backup of your production {% data variables.product.product_name %} instance to a new virtual machine in the staging environment. If you use a staging instance and plan to test {% data variables.product.prodname_actions %} functionality, you should review your storage configuration in the staging environment.
|
||||
|
||||
Aunque no es necesario que las {% data variables.product.prodname_actions %} sean funcionales en tu ambiente de montaje, opcionalmente, puedes copiar los archivos del la ubicación de almacenamiento productivo hacia la ubicación de almacenamiento de montaje.
|
||||
After you restore a {% data variables.product.prodname_ghe_server %} backup to the staging instance, if you try to view logs or artifacts from existing {% data variables.product.prodname_actions %} workflow runs on your staging instance, you will see `404` errors, because this data will be missing from your staging storage location. To work around the `404` errors, you can copy data from production to use in your staging environment.
|
||||
|
||||
### Configuring storage
|
||||
|
||||
When you set up a staging environment that includes a {% data variables.product.product_name %} instance with {% data variables.product.prodname_actions %} enabled, you must use a different external storage configuration for {% data variables.product.prodname_actions %} storage than your production environment.
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning**: If you don't change the storage configuration, your staging instance may be able to write to the same external storage that you use for production, which could result in loss of data.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
For more information about storage configuration for {% data variables.product.prodname_actions %}, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#enabling-github-actions-with-your-storage-provider)."
|
||||
|
||||
### Copying files from production to staging
|
||||
|
||||
To more accurately mirror your production environment, you can optionally copy files from your production storage location for {% data variables.product.prodname_actions %} to the staging storage location.
|
||||
|
||||
* Para una cuenta de almacenamiento de Azure, puedes utilizar [`azcopy`](https://docs.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-blobs#copy-all-containers-directories-and-blobs-to-another-storage-account). Por ejemplo:
|
||||
|
||||
|
||||
@@ -1,59 +0,0 @@
|
||||
---
|
||||
title: Permitir autenticación integrada para usuarios fuera de tu proveedor de identidad
|
||||
intro: 'Puedes configurar una autenticación integrada para autenticar usuarios que no tienen acceso a tu proveedor de identidad que usa LDAP, SAML o CAS.'
|
||||
redirect_from:
|
||||
- /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
- /enterprise/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
- /admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
shortTitle: Autenticación fuera del IdP
|
||||
---
|
||||
|
||||
## Acerca de la autenticación integrada para usuarios fuera de tu proveedor de identidad
|
||||
|
||||
Puedes utilizar la autenticación integrada para usuarios externos cuando no puedes agregar cuentas específicas a tu proveedor de identidad (IdP), como cuentas para contratistas o usuarios de equipos. También puedes usar la autenticación integrada para acceder a una cuenta de reserva si el proveedor de identidad no está disponible.
|
||||
|
||||
Una vez que se configura la autenticación integrada y un usuario autentica exitosamente con SAML o CAS, ya no tendrá la opción de autenticar con un nombre de usuario y una contraseña. Si un usuario autentica exitosamente con LDAP, las credenciales ya no se consideran internas.
|
||||
|
||||
La autenticación integrada para un IdP se desactiva por defecto.
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Advertencia:** Si desactivas la autenticación integrada, debes suspender individualmente a todo usuario que ya no debe tener acceso a la instancia. Para obtener más información, consulta [Suspender y anular suspensión de usuarios](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)."
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
## Configurar autenticación integrada para usuarios fuera de tu proveedor de identidad
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
4. Selecciona tu proveedor de identidad. 
|
||||
5. Selecciona **Permitir la creación de cuentas con autenticación integrada**. 
|
||||
6. Lee la advertencia, luego haz clic en **Aceptar**.
|
||||
|
||||
{% data reusables.enterprise_user_management.two_factor_auth_header %}
|
||||
{% data reusables.enterprise_user_management.2fa_is_available %}
|
||||
|
||||
## Invitar a usuarios fuera de tu proveedor de identidad a autenticar tu instancia
|
||||
|
||||
Cuando un usuario acepta la invitación, puede utilizar su nombre de usuario y contraseña para iniciar sesión en lugar de iniciar sesión a través del IdP.
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.sign-in %}
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %}
|
||||
{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %}
|
||||
|
||||
## Leer más
|
||||
|
||||
- "[Utilizar LDAP](/enterprise/admin/authentication/using-ldap)"
|
||||
- "[Usar SAML](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml)"
|
||||
- "[Usar CAS](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas)"
|
||||
@@ -1,25 +0,0 @@
|
||||
---
|
||||
title: Autenticar usuarios para tu instancia de servidor de GitHub Enterprise
|
||||
intro: 'Puedes usar la autenticación integrada de {% data variables.product.prodname_ghe_server %} o elegir entre CAS, LDAP o SAML para integrar tus cuentas existentes y administrar centralmente el acceso de usuarios para {% data variables.product.product_location %}.'
|
||||
redirect_from:
|
||||
- /enterprise/admin/categories/authentication
|
||||
- /enterprise/admin/guides/installation/user-authentication
|
||||
- /enterprise/admin/articles/inviting-users
|
||||
- /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance
|
||||
- /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance
|
||||
versions:
|
||||
ghes: '*'
|
||||
topics:
|
||||
- Enterprise
|
||||
children:
|
||||
- /using-built-in-authentication
|
||||
- /disabling-unauthenticated-sign-ups
|
||||
- /using-cas
|
||||
- /using-saml
|
||||
- /using-ldap
|
||||
- /allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
- /changing-authentication-methods
|
||||
shortTitle: Autenticar usuarios
|
||||
---
|
||||
|
||||
@@ -1,53 +0,0 @@
|
||||
---
|
||||
title: Usar la autenticación integrada
|
||||
intro: 'Cuando usas el método de autenticación predeterminado, todos los detalles de autenticación se almacenan dentro de {% data variables.product.product_location %}. La autenticación integrada es el método predeterminado, si ya no tienes un proveedor de autenticación establecido, como LDAP, SAML o CAS.'
|
||||
redirect_from:
|
||||
- /enterprise/admin/user-management/using-built-in-authentication
|
||||
- /enterprise/admin/authentication/using-built-in-authentication
|
||||
- /admin/authentication/using-built-in-authentication
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-built-in-authentication
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
shortTitle: Utilizar la autenticación integrada
|
||||
---
|
||||
|
||||
Puedes crear mensajes personalizados que los usuarios verán en las páginas de inicio de sesión y de cierre de sesión. Para obtener más información, consulta "[Personalizar mensajes de usuario en tu instancia](/enterprise/admin/user-management/customizing-user-messages-on-your-instance)."
|
||||
|
||||
## Configurar la autenticación integrada
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
4. Selecciona **Autenticación integrada**. 
|
||||
|
||||
{% data reusables.enterprise_user_management.two_factor_auth_header %}
|
||||
{% data reusables.enterprise_user_management.2fa_is_available %}
|
||||
|
||||
## Crear tu cuenta
|
||||
|
||||
Una vez que se ha creado tu instancia, necesitarás crear tu propia cuenta de administrador.
|
||||
|
||||
1. En la página "Crear cuenta de administrador " en `http(s)://[hostname]/join`, elige tu nombre de usuario, contraseña y dirección de correo electrónico, luego haz clic en **Crear una cuenta**. 
|
||||
{% data reusables.enterprise_site_admin_settings.sign-in %}
|
||||
|
||||
## Invitar usuarios
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %}
|
||||
{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %}
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** Si el correo electrónico para notificaciones se configura en el aplicativo, también se enviará una invitación a la dirección de correo electrónico proporcionada.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
## Leer más
|
||||
|
||||
- "[Configurar el correo electrónico para notificaciones](/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications)"
|
||||
@@ -1,53 +0,0 @@
|
||||
---
|
||||
title: Usar CAS
|
||||
redirect_from:
|
||||
- /enterprise/admin/articles/configuring-cas-authentication
|
||||
- /enterprise/admin/articles/about-cas-authentication
|
||||
- /enterprise/admin/user-management/using-cas
|
||||
- /enterprise/admin/authentication/using-cas
|
||||
- /admin/authentication/using-cas
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-cas
|
||||
intro: 'CAS es un protocolo de inicio de sesión único (SSO) para varias aplicaciones web. Una cuenta de usuario CAS no usa un {% ifversion ghes %}asiento{% else %}de licencia de usuario{% endif %} hasta que el usuario inicia sesión.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- SSO
|
||||
---
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication %}
|
||||
|
||||
## Consideraciones sobre el nombre de usuario con CAS
|
||||
|
||||
{% data reusables.enterprise_management_console.username_normalization %}
|
||||
|
||||
{% data reusables.enterprise_management_console.username_normalization_sample %}
|
||||
|
||||
{% data reusables.enterprise_user_management.two_factor_auth_header %}
|
||||
{% data reusables.enterprise_user_management.external_auth_disables_2fa %}
|
||||
|
||||
## Atributos de CAS
|
||||
|
||||
Están disponibles los siguientes atributos.
|
||||
|
||||
| Nombre del atributo | Tipo | Descripción |
|
||||
| ------------------- | --------- | ------------------------------------------------------------------------ |
|
||||
| `nombre de usuario` | Requerido | El nombre de usuario {% data variables.product.prodname_ghe_server %}. |
|
||||
|
||||
## Configurar CAS
|
||||
{% warning %}
|
||||
|
||||
**Advertencia:** Antes de configurar CAS en {% data variables.product.product_location %}, ten en cuenta que los usuarios no podrán usar sus nombres de usuario ni contraseñas CAS para autenticar las solicitudes de API o las operaciones Git a través de HTTP/HTTPS. En cambio, será necesario que [creen un token de acceso](/enterprise/{{ currentVersion }}/user/articles/creating-an-access-token-for-command-line-use).
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
3. Selecciona **CAS**. 
|
||||
4. {% data reusables.enterprise_user_management.built-in-authentication-option %} 
|
||||
5. En el campo **URL del servidor**, escribe la URL completa de tu servidor CAS. Si tu servidor CAS usa un certificado que no puede ser validado por {% data variables.product.prodname_ghe_server %}, puedes usar el comando `ghe-ssl-ca-certificate-install` para instalarlo como un certificado de confianza.
|
||||
@@ -1,314 +0,0 @@
|
||||
---
|
||||
title: Usar SAML
|
||||
redirect_from:
|
||||
- /enterprise/admin/articles/configuring-saml-authentication
|
||||
- /enterprise/admin/articles/about-saml-authentication
|
||||
- /enterprise/admin/user-management/using-saml
|
||||
- /enterprise/admin/authentication/using-saml
|
||||
- /admin/authentication/using-saml
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-saml
|
||||
intro: 'Puedes configurar el inicio de sesión único de SAML (SSO) para {% data variables.product.product_name %}, el cual permite que los usuarios se autentiquen mediante un proveedor de identidad (IdP) de SAML para acceder a tu instancia.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- SSO
|
||||
---
|
||||
|
||||
## Acerca de SAML para {% data variables.product.product_name %}
|
||||
|
||||
El SSO de SAML permite que las personas se autentiquen y accedan a {% data variables.product.product_location %} mediante un sistema externo para la administración de identidades.
|
||||
|
||||
SAML es un estándar basado en XML para autenticación y autorización. Cuando configuras SAML para {% data variables.product.product_location %}, el sistema de autenticación externo se denomina un "proveedor de identidad" (IdP). Tu instancia actúa como un proveedor de servicios (PS) de SAML. Para obtener más información, consulta el [Lenguaje de Marcado para Confirmaciones de Seguridad](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) en Wikipedia.
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication %}
|
||||
|
||||
## Servicios SAML admitidos
|
||||
|
||||
{% data reusables.saml.saml-supported-idps %}
|
||||
|
||||
{% ifversion ghes > 3.3 %}
|
||||
|
||||
Si tu IdP es compatible con confirmaciones cifradas, puedes configurarlas en {% data variables.product.product_name %} para incrementar la seguridad durante el proceso de autenticación.
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.saml.saml-single-logout-not-supported %}
|
||||
|
||||
## Consideraciones sobre el nombre de usuario con SAML
|
||||
|
||||
Cada nombre de usuario {% data variables.product.prodname_ghe_server %} lo determina una de las siguientes aserciones en la respuesta SAML, ordenadas por prioridad:
|
||||
|
||||
- El atributo de nombre de usuario personalizado, si está definido y si hay uno.
|
||||
- Una aserción `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`, si hay una.
|
||||
- Una aserción `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` assertion, si hay una.
|
||||
- El elemento `NameID`.
|
||||
|
||||
Se requiere el elemento `NameID`, incluso si hay otros atributos.
|
||||
|
||||
Se crea un mapeo entre la `NameID` y el nombre de usuario de {% data variables.product.prodname_ghe_server %}, para que la `NameID` deba ser persistente, única, y no estar sujeta a cambios para el ciclo de vida del usuario.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota**: su ka `NameID` de un usuario sí cambia en el IdP, este verá un mensaje de error cuando intente iniciar sesión en {% data variables.product.product_location %}. Para restablecer el acceso de un usuario, necesitarás actualizar el mapeo de la `NameID` de la cuenta del usuario. Para obtener más información, consulta la sección "[Actualizar la `NameID` de SAML de un usuario](#updating-a-users-saml-nameid)".
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.enterprise_management_console.username_normalization %}
|
||||
|
||||
{% data reusables.enterprise_management_console.username_normalization_sample %}
|
||||
|
||||
{% data reusables.enterprise_user_management.two_factor_auth_header %}
|
||||
{% data reusables.enterprise_user_management.external_auth_disables_2fa %}
|
||||
|
||||
## Metadatos SAML
|
||||
|
||||
Los metadatos del proveedor de servicios de {% data variables.product.product_location %} se encuentran disponibles en `http(s)://[hostname]/saml/metadata`.
|
||||
|
||||
Para configurar tu proveedor de identidad de forma manual, la URL del Servicio de consumidor de aserciones (ACS) es `http(s)://[hostname]/saml/consume`. Esta usa el enlace `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST`.
|
||||
|
||||
## Atributos de SAML
|
||||
|
||||
Estos atributos están disponibles. Puedes modificar el nombre del atributo en [Consola de administración](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/), a excepción del atributo `administrator`.
|
||||
|
||||
| Nombre de atributo predeterminado | Tipo | Descripción |
|
||||
| --------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ID del nombre` | Requerido | Un identificador de usuario persistente. Se puede usar cualquier formato de identificador de nombre persistente. El elemento `NameID` se usará para un nombre de usuario {% data variables.product.prodname_ghe_server %}, a menos que se proporcione una de las aserciones alternativas. |
|
||||
| `administrador` | Opcional | Cuando el valor es "true", el usuario será promovido automáticamente como un administrador. Cualquier otro valor o un valor no existente degradará al usuario a una cuenta de usuario normal. |
|
||||
| `nombre de usuario` | Opcional | El nombre de usuario {% data variables.product.prodname_ghe_server %}. |
|
||||
| `nombre_completo` | Opcional | El nombre del usuario que se muestra en su página de perfil. Los usuarios pueden cambiar sus nombres después del aprovisionamiento. |
|
||||
| `emails` | Opcional | Las direcciones de correo electrónico para el usuario. Se puede especificar más de una. |
|
||||
| `claves_públicas` | Opcional | Las claves SSH públicas para el usuario. Se puede especificar más de una. |
|
||||
| `gpg_keys` | Opcional | Las claves GPG para el usuario. Se puede especificar más de una. |
|
||||
|
||||
Para especificar más de un valor para un atributo, utiliza elementos múltiples de `<saml2:AttributeValue>`.
|
||||
|
||||
```
|
||||
<saml2:Attribute FriendlyName="public_keys" Name="urn:oid:1.2.840.113549.1.1.1" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
|
||||
<saml2:AttributeValue>ssh-rsa LONG KEY</saml2:AttributeValue>
|
||||
<saml2:AttributeValue>ssh-rsa LONG KEY 2</saml2:AttributeValue>
|
||||
</saml2:Attribute>
|
||||
```
|
||||
|
||||
## Configurar parámetros SAML
|
||||
|
||||
Puedes habilitar o inhabilitar la autenticación de SAML para {% data variables.product.product_location %} o puedes editar una configuración existente. Puedes ver y editar los ajustes de autenticación para {% data variables.product.product_name %} en la {% data variables.enterprise.management_console %}. Para obtener más información, consulta la sección "[Acceder a la consola de administración](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)".
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota**: {% data reusables.enterprise.test-in-staging %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
1. Selecciona **SAML**.
|
||||
|
||||
|
||||
1. {% data reusables.enterprise_user_management.built-in-authentication-option %}
|
||||
|
||||
|
||||
1. Opcionalmente, para activar el SSO de respuesta no solicitada, selecciona **IdP initiated SSO**. Por defecto, {% data variables.product.prodname_ghe_server %} responderá a una solicitud iniciada por un proveedor de identidad (IdP) no solicitada con una `AuthnRequest` de vuelta al IdP.
|
||||
|
||||
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Nota**: Te recomendamos mantener este valor **deseleccionado**. Deberías habilitar esta característica **únicamente** en la remota instancia de que tu implementación de SAML no sea compatible con el SSO que inició el proveedor de servicios y cuando lo recomiende {% data variables.contact.enterprise_support %}.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
1. Selecciona **Disable administrator demotion/promotion (Desactivar la degradación/promoción del administrador)** si **no** quieres que tu proveedor de SAML determine los derechos del administrador para los usuarios en {% data variables.product.product_location %}.
|
||||
|
||||
|
||||
{%- ifversion ghes > 3.3 %}
|
||||
1. Opcionalmente, para permitir que {% data variables.product.product_location %} reciba confirmaciones cifradas desde tu IdP de SAML, selecciona **Requerir confirmaciones cifradas**. Debes asegurarte de que tu IdP sea compatible con las aserciones cifradas y que los métodos de transporte de llaves y de cifrado en la consola de administración empaten con los valores configurados en tu IdP. También debes proporcionar un certificado público de {% data variables.product.product_location %} a tu IdP. Para obtener más información, consulta la sección "[Habilitar las aserciones cifradas](#enabling-encrypted-assertions)".
|
||||
|
||||
|
||||
{%- endif %}
|
||||
1. En el campo **URL de inicio de sesión único**, teclea la terminal HTTP o HTTPS en tu IdP para las solicitudes de inicio de sesión único. Este valor lo provee la configuración de tu IdP. Si el host solo se encuentra disponible en tu red interna, podrías necesitar [configurar {% data variables.product.product_location %} para utilizar servidores de nombres internos](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-dns-nameservers/).
|
||||
|
||||
|
||||
1. Opcionalmente, en el campo de **Emisor**, teclea el nombre del emisor SAML. Esto verifica la autenticidad de los mensajes que se envían a {% data variables.product.product_location %}.
|
||||
|
||||
|
||||
1. En los menús desplegables de **Método de firma** y **Método de resumen**, elige el algoritmo de hash que usa tu emisor SAML para verificar la integridad de las respuestas desde {% data variables.product.product_location %}. Especifica el formato con el menú desplegable **Formato de identificador de nombre**.
|
||||
|
||||
|
||||
1. Dentro de **Verification certificate (Certificado de comprobación)**, haz clic en **Choose File (Elegir archivo)** y elige un certificado para validar las respuestas SAML desde el IdP.
|
||||
|
||||
|
||||
1. Modifica los nombres de atributo de SAML para hacerlos coincidir con tu IdP, si es necesario, o acepta los nombres predeterminados.
|
||||
|
||||
|
||||
|
||||
{% ifversion ghes > 3.3 %}
|
||||
|
||||
## Habilitar las aserciones cifradas
|
||||
|
||||
Para habilitar las aserciones cifradas, tu IdP de SAML también debe ser compatible con estas. Debes proporcionar un certificado público de {% data variables.product.product_location %} a tu IdP y configurar los ajustes de cifrado que empaten con este.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota**: {% data reusables.enterprise.test-in-staging %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
1. Opcionalmente, habilita la depuración de SAML. La depuración de SAML registra las entradas verbosas en la bitácora de autenticación de {% data variables.product.product_name %} y podría ayudarte a solucionar problemas de los intentos de autenticación fallidos. Para obtener más información, consulta la sección "[Configurar la depuración de SAML](#configuring-saml-debugging)".
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
1. Selecciona **Requerir aserciones cifradas**.
|
||||
|
||||
|
||||
1. A la derecha de "Cerficado de cifrado", haz clic en **Descargar** para guardar una copia del certificado público de {% data variables.product.product_location %} en tu máquina local.
|
||||
|
||||
|
||||
1. Inicia sesión en tu IdP de SAML como administrador.
|
||||
1. En la aplicación de {% data variables.product.product_location %}, habilita las aserciones cifradas.
|
||||
- Anota el método de cifrado y de transporte de llave.
|
||||
- Proporciona el certificado público que descargaste en el paso 7.
|
||||
1. Regresa a la consola de administración en {% data variables.product.product_location %}.
|
||||
1. A la derecha de "Método de cifrado", selecciona el método de cifrado para tu IdP desde el paso 9.
|
||||
|
||||
|
||||
1. A la derecha de "Método de transporte de llave", selecciona el método de transporte de llave para tu IdP desde el paso 9.
|
||||
|
||||
|
||||
1. Haz clic en **Guardar parámetros**.
|
||||
{% data reusables.enterprise_site_admin_settings.wait-for-configuration-run %}
|
||||
|
||||
Si habilitaste la depuración de SAML para probar la autenticación con las aserciones cifradas, inhabilita la depuración de SAML cuando termines de hacer las pruebas. Para obtener más información, consulta la sección "[Configurar la depuración de SAML](#configuring-saml-debugging)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Actualizar la `NameID` de SAML de un usuario
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
2. Selecciona **SAML**. 
|
||||
3. En la lista de usuarios, da clic en el nombre de usuario del cual te gustaría actualizar el mapeo de la `NameID`. 
|
||||
{% data reusables.enterprise_site_admin_settings.security-tab %}
|
||||
5. A la derecha de "Actualizar la NameID de SAML", haz clic en **Editar**. 
|
||||
6. En el campo de "NameID", teclea la `NameID` nueva para el usuario. 
|
||||
7. Da clic en **Actualizar NameID**. 
|
||||
|
||||
## Revocar acceso a {% data variables.product.product_location %}
|
||||
|
||||
Si eliminas un usuario desde tu proveedor de identidad, también debes suspenderlos de forma manual. De lo contrario, seguirán estando disponibles para autenticarse usando los tokens de acceso o las claves SSH. Para obtener más información, consulta "[Suspender y anular suspensión de usuarios](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)".
|
||||
|
||||
## Requisitos para los mensajes de respuesta
|
||||
|
||||
El mensaje de respuesta debe cumplir con los siguientes requisitos:
|
||||
|
||||
- Se debe proporcionar el elemento `<Destination>` en el documento de respuesta raíz y empatar la URL ACS únicamente cuando dicho documento se firme. Si la aserción está firmada, ésta se ignorará.
|
||||
- Siempre deberá proporcionarse el elemento `<Audience>` como parte del elemento `<AudienceRestriction>`. Debe coincidir con la `EntityId` de {% data variables.product.prodname_ghe_server %}. Ésta es la URL para la instancia de {% data variables.product.prodname_ghe_server %}, tal como `https://ghe.corp.example.com`.
|
||||
- Cada aserción en la respuesta **debe** estar protegida con una firma digital. Esto se puede lograr firmando cada elemento `<Assertion>` individual o firmando el elemento `<Response>`.
|
||||
- Un elemento `<NameID>` se debe proporcionar como parte del elemento `<Subject>`. Se puede usar cualquier formato de identificador de nombre persistente.
|
||||
- El atributo `Recipient` debe estar presente y establecido en la URL ACS. Por ejemplo:
|
||||
|
||||
```xml
|
||||
<samlp:Response ...>
|
||||
<saml:Assertion ...>
|
||||
<saml:Subject>
|
||||
<saml:NameID ...>...</saml:NameID>
|
||||
<saml:SubjectConfirmation ...>
|
||||
<saml:SubjectConfirmationData Recipient="https://ghe.corp.example.com/saml/consume" .../>
|
||||
</saml:SubjectConfirmation>
|
||||
</saml:Subject>
|
||||
<saml:AttributeStatement>
|
||||
<saml:Attribute FriendlyName="USERNAME-ATTRIBUTE" ...>
|
||||
<saml:AttributeValue>monalisa</saml:AttributeValue>
|
||||
</saml:Attribute>
|
||||
</saml:AttributeStatement>
|
||||
</saml:Assertion>
|
||||
</samlp:Response>
|
||||
```
|
||||
|
||||
## Autenticación SAML
|
||||
|
||||
{% data variables.product.prodname_ghe_server %} registra los mensajes de error para la autenticación de SAML fallida en la bitácora de autenticación en _/var/log/github/auth.log_. Para obtener más información sobre los requisitos de respuesta de SAML, consulta la sección "[Requisitos de mensaje de respuesta](#response-message-requirements)".
|
||||
|
||||
### Error: "Another user already owns the account"
|
||||
|
||||
Cuando un usuario ingresa en {% data variables.product.prodname_ghe_server %} por primera vez con la autenticación de SAML, {% data variables.product.prodname_ghe_server %} crea una cuenta de usuario en la instancia y mapea la `NameID` de SAML hacia la cuenta.
|
||||
|
||||
Cuando el usuario vuelve a ingresar, {% data variables.product.prodname_ghe_server %} compara el mapeo de la `NameID` de la cuenta con la respuesta del IdP. Si la `NameID` en la respuesta del IdP ya no empata con la `NameID` que {% data variables.product.prodname_ghe_server %} espera para el usuario, el inicio de sesión fallará. El usuario verá el siguiente mensaje.
|
||||
|
||||
> Another user already owns the account. Please have your administrator check the authentication log.
|
||||
|
||||
Este mensaje habitualmente indica que el nombre de usuario o dirección de correo electrónico cambió en el IdP. Asegúrate de que el mapeo de la `NameID` de la cuenta de usuario de {% data variables.product.prodname_ghe_server %} coincida con la `NameID` en tu IdP. Para obtener más información, consulta la sección "[Actualizar la `NameID` de SAML de un usuario](#updating-a-users-saml-nameid)".
|
||||
|
||||
### Si la respuesta SAML no está firmada o la firma no coincide con los contenidos, se presentará el siguiente mensaje de error en el registro de autenticación:
|
||||
|
||||
Si el `Recipient` no empata con la URL de ACS para {% data variables.product.product_location %}, uno de los siguientes dos mensajes de error se mostrará en la bitácora de autenticación cuando un usuario intenta autenticarse.
|
||||
|
||||
```
|
||||
El destinatario en la respuesta SAML no debe estar en blanco.
|
||||
```
|
||||
|
||||
```
|
||||
El destinatario en la respuesta SAML no era válido.
|
||||
```
|
||||
|
||||
Asegúrate de que hayas configurado el valor de `Recipient` en tu IdP en la URL completa de ACS para {% data variables.product.product_location %}. Por ejemplo, `https://ghe.corp.example.com/saml/consume`.
|
||||
|
||||
### Error: "SAML Response is not signed or has been modified"
|
||||
|
||||
Si tu IdP no firma la respuesta de SAML, o si la firma no empata con el contenido, se mostrará el siguiente mensaje de error en la bitácora de autenticación.
|
||||
|
||||
```
|
||||
SAML Response is not signed or has been modified.
|
||||
```
|
||||
|
||||
Asegúrate de haber configurado aserciones firmadas para la aplicación de {% data variables.product.prodname_ghe_server %} en tu IdP.
|
||||
|
||||
### Error: "Audience is invalid" or "No assertion found"
|
||||
|
||||
Si la respuesta del IdP carece o tiene un valor incorrecto para `Audience`, se mostrará el siguiente mensaje de error en la bitácora de autenticación.
|
||||
|
||||
```shell
|
||||
La audiencia es no válida. Audience attribute does not match https://<em>YOUR-INSTANCE-URL</em>
|
||||
```
|
||||
|
||||
Asegúrate de haber configurado el valor de la `Audience` en tu IdP a la `EntityId` de {% data variables.product.product_location %}, la cual es la URL completa de {% data variables.product.product_location %}. Por ejemplo, `https://ghe.corp.example.com`.
|
||||
|
||||
### Configurar la depuración de SAML
|
||||
|
||||
Puedes configurar {% data variables.product.product_name %} para escribir bitácoras de depuración verbosas en _/var/log/github/auth.log_ para cada intento de autenticación de SAML. Es posible que puedas solucionar los problemas de los intentos de autenticación fallidos con esta salida adicional.
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Advertencias**:
|
||||
|
||||
- Habilita la depuración de SAML solo temporalmente e inhabilita la depuración inmediatamente después de que termines de solucionar los problemas. Si dejas habilitada la depuración, el tamaño de tu bitácora podría incrementarse mucho más rápido de lo habitual, lo cual podría impactar negativamente el rendimiento de {% data variables.product.product_name %}.
|
||||
- Prueba los ajustes de autenticación nuevos de {% data variables.product.product_location %} en un ambiente de pruebas antes de aplicar los ajustes en tu ambiente de producción. Para obtener más información, consulta "[Configurar una instancia de preparación](/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance)."
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.options-tab %}
|
||||
1. Debajo de "depuración de SAML", selecciona el menú desplegable y haz clic en **Habilitado**.
|
||||
|
||||
|
||||
|
||||
1. Intenta iniciar sesión en {% data variables.product.product_location %} mediante tu IdP de SAML.
|
||||
|
||||
1. Revisa la salida de depuración en _/var/log/github/auth.log_ en {% data variables.product.product_location %}.
|
||||
|
||||
1. Cuando termines de solucionar los problemas, selecciona el menú desplegable y haz clic en **Inhabilitado**.
|
||||
|
||||
|
||||
|
||||
### Decodificar respuestas en _auth.log_
|
||||
|
||||
Alguna salida en _auth.log_ podría estar cifrada en Base64. Puedes acceder al shell administrativo y utilizar la utilidad de `base64` en {% data variables.product.product_location %} para decodificar estas respuestas. Para obtener más información, consulta "[Acceder al shell administrativo (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)".
|
||||
|
||||
```shell
|
||||
$ base64 --decode <em>ENCODED OUTPUT</em>
|
||||
```
|
||||
@@ -1,14 +0,0 @@
|
||||
---
|
||||
title: Configurar la autenticación y el aprovisionamiento con tu proveedor de identidad
|
||||
intro: Puedes configurar la autenticación y aprovisionamiento de usuarios si integras un proveedor de identidad (IdP) que sea compatible con el inicio de sesión único (SSO) de SAML y con SCIM.
|
||||
versions:
|
||||
ghae: '*'
|
||||
redirect_from:
|
||||
- /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider
|
||||
children:
|
||||
- /configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
|
||||
- /configuring-authentication-and-provisioning-for-your-enterprise-using-okta
|
||||
- /mapping-okta-groups-to-teams
|
||||
shortTitle: Utilizar un IdP para el SSO & SCIM
|
||||
---
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Administración de accesos y de identidad
|
||||
intro: Puedes configurar cómo los usuarios acceden a tu empersa.
|
||||
intro: 'You can configure how people access {% ifversion ghec or ghae %}your enterprise on {% data variables.product.product_name %}{% elsif ghes %}{% data variables.product.product_location %}{% endif %}.'
|
||||
redirect_from:
|
||||
- /enterprise/admin/authentication
|
||||
- /admin/authentication
|
||||
@@ -14,10 +14,12 @@ topics:
|
||||
- Enterprise
|
||||
- SSO
|
||||
children:
|
||||
- /authenticating-users-for-your-github-enterprise-server-instance
|
||||
- /managing-iam-for-your-enterprise
|
||||
- /managing-iam-with-enterprise-managed-users
|
||||
- /using-built-in-authentication
|
||||
- /using-cas-for-enterprise-iam
|
||||
- /using-ldap-for-enterprise-iam
|
||||
- /using-saml-for-enterprise-iam
|
||||
- /using-enterprise-managed-users-and-saml-for-iam
|
||||
- /managing-recovery-codes-for-your-enterprise
|
||||
- /configuring-authentication-and-provisioning-with-your-identity-provider
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,97 @@
|
||||
---
|
||||
title: About authentication for your enterprise
|
||||
shortTitle: Acerca de la autenticación
|
||||
intro: 'You {% ifversion ghae %}must configure SAML single sign-on (SSO) so people can{% else %}can choose how people{% endif %} authenticate to access {% ifversion ghec %}your enterprise''s resources on {% data variables.product.product_name %}{% elsif ghes %}{% data variables.product.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.product_name %}{% endif %}.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
type: overview
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- SSO
|
||||
---
|
||||
|
||||
## About authentication for your enterprise
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
Enterprise owners on {% data variables.product.product_name %} can control the requirements for authentication and access to the enterprise's resources. You can choose to allow members create and manage user accounts, or your enterprise can create and manage accounts for members. If you allow members to manage their own accounts, you can also configure SAML authentication to both increase security and centralize identity and access for the web applications that your team uses. If you choose to manage your members' user accounts, you must configure SAML authentication.
|
||||
|
||||
## Authentication methods for {% data variables.product.product_name %}
|
||||
|
||||
The following options are available for account management and authentication on {% data variables.product.product_name %}.
|
||||
|
||||
- [Authentication through {% data variables.product.product_location %}](#authentication-through-githubcom)
|
||||
- [Authentication through {% data variables.product.product_location %} with additional SAML access restriction](#authentication-through-githubcom-with-additional-saml-access-restriction)
|
||||
- [Authentication with {% data variables.product.prodname_emus %} and SAML SSO](#authentication-with-enterprise-managed-users-and-saml-sso)
|
||||
|
||||
### Authentication through {% data variables.product.product_location %}
|
||||
|
||||
By default, each member must create a personal account on {% data variables.product.product_location %}. You grant access to your enterprise, and the member can access your enterprise's resources after signing into the account on {% data variables.product.product_location %}. The member manages the account, and can contribute to other enterprises, organizations, and repositories on {% data variables.product.product_location %}.
|
||||
|
||||
### Authentication through {% data variables.product.product_location %} with additional SAML access restriction
|
||||
|
||||
If you configure additional SAML access restriction, each member must create and manage a personal account on {% data variables.product.product_location %}. You grant access to your enterprise, and the member can access your enterprise's resources after both signing into the account on {% data variables.product.product_location %} and successfully authenticating with your SAML identity provider (IdP). The member can contribute to other enterprises, organizations, and repositories on {% data variables.product.product_location %} using their personal account. For more information about requiring SAML authentication for all access your enterprise's resources, see "[About SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)."
|
||||
|
||||
If you use a standalone organization with {% data variables.product.product_name %}, or if you don't want to use SAML authentication for every organization in your enterprise, you can configure SAML for an individual organization. Para obtener más información, consulta la sección "[Acerca de la administración de identidad y accesos con el inicio de sesión único de SAML](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)".
|
||||
|
||||
### Authentication with {% data variables.product.prodname_emus %} and SAML SSO
|
||||
|
||||
If you need more control of the accounts for your enterprise members on {% data variables.product.product_location %}, you can use {% data variables.product.prodname_emus %}. With {% data variables.product.prodname_emus %}, you provision and manage accounts for your enterprise members on {% data variables.product.product_location %} using your IdP. Each member signs into an account that you create, and your enterprise manages the account. Contributions to the rest of {% data variables.product.prodname_dotcom_the_website %} are restricted. Para obtener más información, consulta la sección "[Acerca de {% data variables.product.prodname_emus %}](/admin/identity-and-access-management/using-enterprise-managed-users-and-saml-for-iam/about-enterprise-managed-users)".
|
||||
|
||||
{% elsif ghes %}
|
||||
|
||||
Site administrators can decide how people authenticate to access a {% data variables.product.product_name %} instance. You can use {% data variables.product.product_name %}'s built-in authentication, or, if you want to centralize identity and access management for the web applications that your team uses, you can configure an external authentication method.
|
||||
|
||||
## Authentication methods for {% data variables.product.product_name %}
|
||||
|
||||
The following authentication methods are available for {% data variables.product.product_name %}.
|
||||
|
||||
- [Built-in authentication](#built-in-authentication)
|
||||
- [External authentication](#external-authentication)
|
||||
|
||||
### Built-in authentication
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication-new-accounts %} To access your instance, people authenticate with the credentials for the account. For more information, see "[Configuring built-in authentication](/admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication)."
|
||||
|
||||
### External authentication
|
||||
|
||||
If you use an external directory or identity provider (IdP) to centralize access to multiple web applications, you may be able to configure external authentication for {% data variables.product.product_location %}. Para obtener más información, consulta lo siguiente.
|
||||
|
||||
- "[Using CAS for enterprise IAM](/admin/identity-and-access-management/using-cas-for-enterprise-iam)"
|
||||
- "[Using LDAP for enterprise IAM](/admin/identity-and-access-management/using-ldap-for-enterprise-iam)"
|
||||
- "[Using SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam)"
|
||||
|
||||
If you choose to use external authentication, you can also configure fallback authentication for people who don't have an account on your external authentication provider. For example, you may want to grant access to a contractor or machine user. For more information, see "[Allowing built-in authentication for users outside your provider](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)."
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
{% data variables.product.product_name %} uses SAML SSO for authentication. Enterprise owners must configure SAML SSO with a SAML identity provider (IdP) during initialization. For more information, see "[About SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam)."
|
||||
|
||||
{% endif %}
|
||||
|
||||
## About access control
|
||||
|
||||
{% ifversion ghec or ghae %}Members of your enterprise{% elsif ghes %}People with access to {% data variables.product.product_location %}{% endif %} can manage access to {% ifversion ghec %}your enterprise's resources{% elsif ghae %}your enterprise{% elsif ghes %}resources on your instance{% endif %} by using organization membership, teams, and roles. Para obtener más información, consulta lo siguiente.
|
||||
|
||||
{%- ifversion ghec %}
|
||||
- "[Invitar a usuarios para que se unan a nuestra organización](/organizations/managing-membership-in-your-organization/inviting-users-to-join-your-organization)"
|
||||
{%- elsif ghes or ghae %}
|
||||
- "[Adding people to your organization](/organizations/managing-membership-in-your-organization/adding-people-to-your-organization)"
|
||||
{%- endif %}
|
||||
- "[Roles en una organización](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)"
|
||||
- [Acerca de los equipos](/organizations/organizing-members-into-teams/about-teams)"
|
||||
- "[Roles de repositorio para una organización](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)"
|
||||
- "[Niveles de permiso para el repositorio de una cuenta de usuario](/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-a-user-account-repository)"
|
||||
|
||||
## Leer más
|
||||
|
||||
- [Tipos de cuentas de {% data variables.product.company_short %}](/get-started/learning-about-github/types-of-github-accounts)"
|
||||
- "[Acerca de las cuentas de empresa](/admin/overview/about-enterprise-accounts)"
|
||||
{%- ifversion ghec %}
|
||||
- "[Can I create accounts for people in my organization?](/organizations/managing-membership-in-your-organization/can-i-create-accounts-for-people-in-my-organization)"
|
||||
{% endif %}
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: Allowing built-in authentication for users outside your provider
|
||||
intro: 'You can configure fallback authentication to allow built-in authentication for people who don''t have an account on your CAS, LDAP, or SAML authentication provider.'
|
||||
redirect_from:
|
||||
- /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
- /enterprise/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
- /admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/allowing-built-in-authentication-for-users-outside-your-identity-provider
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
shortTitle: Fallback authentication
|
||||
---
|
||||
|
||||
## About built-in authentication for users outside your provider
|
||||
|
||||
By default, when you enable external authentication for {% data variables.product.product_name %}, built-in authentication is disabled for your instance. For more information, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#external-authentication)."
|
||||
|
||||
If you're unable to add specific accounts to your external authentication provider, such as accounts for contractors or machine users, you can configure fallback authentication. Fallback authentication allows built-in authentication for outside users and to access a fallback account if your authentication provider is unavailable.
|
||||
|
||||
If you configure built-in authentication and a person successfully authenticates with SAML or CAS, the person will no longer have the option to authenticate with a username and password. Si un usuario autentica exitosamente con LDAP, las credenciales ya no se consideran internas.
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Advertencia:** Si desactivas la autenticación integrada, debes suspender individualmente a todo usuario que ya no debe tener acceso a la instancia. Para obtener más información, consulta "[Suspender y anular suspensión de usuarios](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)."
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
## Configuring built-in authentication for users outside your provider
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
4. Selecciona tu proveedor de identidad. 
|
||||
5. Selecciona **Permitir la creación de cuentas con autenticación integrada**. 
|
||||
6. Lee la advertencia, luego haz clic en **Aceptar**.
|
||||
|
||||
{% data reusables.enterprise_user_management.two_factor_auth_header %}
|
||||
{% data reusables.enterprise_user_management.2fa_is_available %}
|
||||
|
||||
## Inviting users outside your provider to authenticate to your instance
|
||||
|
||||
Cuando un usuario acepta la invitación, puede utilizar su nombre de usuario y contraseña para iniciar sesión en lugar de iniciar sesión a través del IdP.
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.sign-in %}
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %}
|
||||
{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %}
|
||||
|
||||
## Leer más
|
||||
|
||||
- "[Using CAS for enterprise IAM](/admin/identity-and-access-management/using-cas-for-enterprise-iam)"
|
||||
- "[Using LDAP for enterprise IAM](/admin/identity-and-access-management/using-ldap-for-enterprise-iam)"
|
||||
- "[Using SAML for enterprise IAM](/admin/identity-and-access-management/using-saml-for-enterprise-iam)"
|
||||
@@ -6,6 +6,7 @@ redirect_from:
|
||||
- /enterprise/admin/authentication/changing-authentication-methods
|
||||
- /admin/authentication/changing-authentication-methods
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/changing-authentication-methods
|
||||
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/changing-authentication-methods
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: overview
|
||||
@@ -39,4 +40,4 @@ Otras cuestiones que deberías tener en cuenta son las siguientes:
|
||||
|
||||
* **Autenticación de dos factores:** {% data reusables.enterprise_user_management.external_auth_disables_2fa %}
|
||||
|
||||
* **Autenticación integrada para usuarios fuera de tu proveedor de identidad:** Puedes invitar usuarios a autenticar {% data variables.product.product_location %} sin agregarlos a tu proveedor de identidad. Para obtener más información, consulta "[Permitir autenticación integrada para usuarios fuera de tu proveedor de identidad](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider)".
|
||||
* **Fallback authentication for users with no account on your external authentication provider:** You can invite users to authenticate to {% data variables.product.product_location %} without adding them to your identity provider. For more information, see "[Allowing built-in authentication for users outside your provider](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)."
|
||||
@@ -1,20 +1,35 @@
|
||||
---
|
||||
title: Administrar el IAM para tu empresa
|
||||
shortTitle: IAM para tu empresa
|
||||
intro: 'Puedes administrar centralmente las {% ifversion ghae %}cuentas y {% endif %}el acceso a tus {% ifversion ghae %}empresas{% elsif ghec %}recursos empresariales{% endif %} en {% data variables.product.product_name %} con el inicio de sesión único de (SSO) de SAML y la Administración de Identidad Entre Dominios (SCIM).'
|
||||
intro: |
|
||||
{%- ifversion ghec %}
|
||||
You can invite existing personal accounts on {% data variables.product.product_location %} to be members of your enterprise, and you can optionally enable SAML single sign-on (SSO) to centrally manage access. Alternatively, you can use {% data variables.product.prodname_emus %} with SAML SSO to create and control the accounts of your enterprise members.
|
||||
{%- elsif ghes %}
|
||||
You can use {% data variables.product.product_name %}'s built-in authentication, or you can centrally manage authentication and access to your instance with CAS, LDAP, or SAML.
|
||||
{%- elsif ghae %}
|
||||
You must use SAML single sign-on (SSO) to centrally manage authentication and access to your enterprise on {% data variables.product.product_name %}. Optionally, you can use System for Cross-domain Identity Management (SCIM) to automatically provision accounts and access on {% data variables.product.product_name %} when you make changes on your identity provider (IdP).
|
||||
{%- endif %}
|
||||
redirect_from:
|
||||
- /enterprise/admin/categories/authentication
|
||||
- /enterprise/admin/guides/installation/user-authentication
|
||||
- /enterprise/admin/articles/inviting-users
|
||||
- /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance
|
||||
- /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance
|
||||
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance
|
||||
versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
children:
|
||||
- /about-identity-and-access-management-for-your-enterprise
|
||||
- /configuring-saml-single-sign-on-for-your-enterprise
|
||||
- /configuring-user-provisioning-for-your-enterprise
|
||||
- /managing-team-synchronization-for-organizations-in-your-enterprise
|
||||
- /configuring-saml-single-sign-on-for-your-enterprise-using-okta
|
||||
- /switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
|
||||
- /about-authentication-for-your-enterprise
|
||||
- /username-considerations-for-external-authentication
|
||||
- /changing-authentication-methods
|
||||
- /allowing-built-in-authentication-for-users-outside-your-provider
|
||||
shortTitle: Manage IAM for your enterprise
|
||||
---
|
||||
|
||||
{% data reusables.enterprise-accounts.emu-saml-note %}
|
||||
|
||||
@@ -0,0 +1,81 @@
|
||||
---
|
||||
title: Username considerations for external authentication
|
||||
shortTitle: Username considerations
|
||||
intro: '{% ifversion ghes or ghec %}When you use {% ifversion ghes %}CAS, LDAP, or SAML for authentication{% elsif ghec %}{% data variables.product.prodname_emus %}{% endif %}, {% endif %}{% data variables.product.product_name %} follows certain rules to determine the username for each user account {% ifversion ghec or ghae %}in your enterprise{% elsif ghes %}on your instance{% endif %}.'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
type: reference
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- SSO
|
||||
---
|
||||
|
||||
## About usernames with external authentication
|
||||
|
||||
{% ifversion ghes %}
|
||||
|
||||
You can configure external authentication for {% data variables.product.product_name %} using CAS, LDAP, or SAML. For more information, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#authentication-methods-for-github-enterprise-server)."
|
||||
|
||||
When you use external authentication, {% data variables.product.product_location %} automatically creates a username for each person when the person signs into {% data variables.product.product_location %} through your external authentication system for the first time.
|
||||
|
||||
{% elsif ghec %}
|
||||
|
||||
If you use an enterprise with {% data variables.product.prodname_emus %}, members of your enterprise authenticate to access {% data variables.product.prodname_dotcom %} through your SAML identity provider (IdP). For more information, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#authentication-methods-for-github-enterprise-server)."
|
||||
|
||||
{% data variables.product.product_name %} automatically creates a username for each person when the person signs in through your IdP for the first time.
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
{% data variables.product.product_name %} uses SAML SSO for authentication, and automatically creates a username for each person when the person signs in through your identity provider (IdP) for the first time.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## About username normalization
|
||||
|
||||
Usernames for user accounts on {% ifversion ghes or ghae %}{% data variables.product.product_name %}{% elsif ghec %}{% data variables.product.prodname_dotcom_the_website %}{% endif %} can only contain alphanumeric characters and dashes (`-`).
|
||||
|
||||
{% ifversion ghec or ghes %}When you configure {% ifversion ghes %}CAS, LDAP, or {% endif %}SAML authentication, {% endif %}{% data variables.product.product_name %} uses an identifier from the user account on your {% ifversion ghes %}external authentication provider{% elsif ghec or ghae %}IdP{% endif %} to determine the username for the corresponding user account on {% ifversion ghes or ghae %}{% data variables.product.product_name %}{% elsif ghec %}{% data variables.product.prodname_dotcom_the_website %}{% endif %}. If the identifier for the account on your provider includes unsupported characters, {% data variables.product.product_name %} will normalize the username per the following rules.
|
||||
|
||||
1. {% data variables.product.product_name %} will normalize any non-alphanumeric character in your account's username into a dash. For example, a username of `mona.the.octocat` will be normalized to `mona-the-octocat`. Nota que los nombres de usuarios normalizados tampoco pueden comenzar o terminar con una raya. Tampoco pueden contener dos rayas seguidas.
|
||||
|
||||
1. Los nombres de usuarios creados a partir de direcciones de correo electrónico se crean con los caracteres normalizados que preceden al caracter `@`.
|
||||
|
||||
1. If multiple accounts are normalized into the same {% data variables.product.product_name %} username, only the first user account is created. Los siguientes usuarios con el mismo nombre de usuario no podrán registrarse.
|
||||
|
||||
### Examples of username normalization
|
||||
|
||||
| Identifier on provider | Normalized username for {% data variables.product.product_location %} | Resultado |
|
||||
|:----------------------- |:--------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------- |
|
||||
| The.Octocat | `the-octocat` | El nombre de usuario se crea correctamente. |
|
||||
| !The.Octocat | `-the-octocat` | No se crea este nombre de usuario debido a que comienza con una raya. |
|
||||
| The.Octocat! | `the-octocat-` | No se crea este nombre de usuario debido a que termina con una raya. |
|
||||
| The!!Octocat | `the--octocat` | No se crea este nombre de usuario debido a que contiene dos rayas seguidas. |
|
||||
| The!Octocat | `the-octocat` | No se crea este nombre de usuario. A pesar de que el nombre de usuario normalizado es válido, ya existía. |
|
||||
| The.Octocat@example.com | `the-octocat` | No se crea este nombre de usuario. A pesar de que el nombre de usuario normalizado es válido, ya existía. |
|
||||
|
||||
### About username normalization with SAML
|
||||
|
||||
{% ifversion ghec or ghes %}If you {% ifversion ghec %}use an enterprise with {% data variables.product.prodname_emus %}, you must use SAML authentication. {% else %}configure SAML authentication for {% data variables.product.product_location %}, {% endif %}{% endif %}{% data variables.product.product_name %} determines each person's username by one of the following assertions in the SAML response, ordered by priority.
|
||||
|
||||
1. The custom `username` attribute, if defined and present
|
||||
1. Una aserción `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`, si hay una.
|
||||
1. Una aserción `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` assertion, si hay una.
|
||||
1. El elemento `NameID`.
|
||||
|
||||
{% data variables.product.product_name %} requires the `NameID` element even if other attributes are present. For more information, see "[SAML configuration reference](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference#saml-attributes)."
|
||||
|
||||
{% data variables.product.product_name %} creates a mapping between the `NameID` from the IdP and the username {% ifversion ghec or ghae %}in{% elsif ghes %}on{% endif %} {% data variables.product.product_location %}, so the `NameID` should be persistent, unique, and not subject to change for the lifecycle of the user.
|
||||
|
||||
{% ifversion ghes %}
|
||||
{% note %}
|
||||
|
||||
**Note**: If the `NameID` for a user does change on the IdP, the person will see an error message when {% ifversion ghec %}authenticating through your IdP to access your resources on{% else %}signing into{% endif} {% data variables.product.product_location %}. To restore the person's access, you'll need to update the user account's `NameID` mapping. For more information, see "[Updating a user's SAML `NameID`](/admin/identity-and-access-management/using-saml-for-enterprise-iam/updating-a-users-saml-nameid)."
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: Configurar la autenticación integrada
|
||||
intro: 'When you use the default authentication method, all authentication details are stored on {% data variables.product.product_location %}.'
|
||||
permissions: 'Site administrators can configure authentication for a {% data variables.product.product_name %} instance.'
|
||||
redirect_from:
|
||||
- /enterprise/admin/user-management/using-built-in-authentication
|
||||
- /enterprise/admin/authentication/using-built-in-authentication
|
||||
- /admin/authentication/using-built-in-authentication
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-built-in-authentication
|
||||
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-built-in-authentication
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
shortTitle: Configure built-in authentication
|
||||
---
|
||||
|
||||
## About built-in authentication
|
||||
|
||||
By default, {% data variables.product.product_name %} uses built-in authentication. Each person creates a user account on {% data variables.product.product_location %} from an invitation or by signing up, and then authenticates with the credentials for the account to access your instance. Your {% data variables.product.product_name %} instance stores the authentication information for the account.
|
||||
|
||||
You can prevent unauthenticated people from creating new user accounts on your instance. For more information, see "[Disabling unauthenticated sign-ups](/admin/identity-and-access-management/using-built-in-authentication/disabling-unauthenticated-sign-ups)."
|
||||
|
||||
{% data reusables.enterprise_user_management.alternatively-enable-external-authentication %}
|
||||
|
||||
## Configurar la autenticación integrada
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
4. Selecciona **Autenticación integrada**. 
|
||||
|
||||
{% data reusables.enterprise_user_management.two_factor_auth_header %}
|
||||
{% data reusables.enterprise_user_management.2fa_is_available %}
|
||||
|
||||
## Crear tu cuenta
|
||||
|
||||
Una vez que se ha creado tu instancia, necesitarás crear tu propia cuenta de administrador.
|
||||
|
||||
1. En la página "Crear cuenta de administrador " en `http(s)://[hostname]/join`, elige tu nombre de usuario, contraseña y dirección de correo electrónico, luego haz clic en **Crear una cuenta**. 
|
||||
{% data reusables.enterprise_site_admin_settings.sign-in %}
|
||||
|
||||
## Pasos siguientes
|
||||
|
||||
<a name="inviting-users"></a>
|
||||
|
||||
After you configure built-in authentication and create your administrative account, you can invite people to create accounts and use your instance. For more information, see "[Inviting people to use your instance](/admin/identity-and-access-management/using-built-in-authentication/inviting-people-to-use-your-instance)."
|
||||
|
||||
## Leer más
|
||||
|
||||
- "[Configurar el correo electrónico para notificaciones](/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications)"
|
||||
@@ -6,7 +6,9 @@ redirect_from:
|
||||
- /enterprise/admin/authentication/disabling-unauthenticated-sign-ups
|
||||
- /admin/authentication/disabling-unauthenticated-sign-ups
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/disabling-unauthenticated-sign-ups
|
||||
intro: 'Si usas la autenticación integrada, puedes impedir que las personas no autenticadas puedan crear una cuenta.'
|
||||
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/disabling-unauthenticated-sign-ups
|
||||
intro: 'If you''re using built-in authentication for {% data variables.product.product_location %}, you can block unauthenticated people from creating new user accounts on your instance.'
|
||||
permissions: 'Site administrators can disable unauthenticated sign-ups on a {% data variables.product.product_name %} instance.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
@@ -14,9 +16,18 @@ topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
shortTitle: Bloquear la creación de cuentas
|
||||
- Identity
|
||||
shortTitle: Block unauthenticated sign-up
|
||||
---
|
||||
|
||||
## About unauthenticated sign-ups
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication-new-accounts %} {% data reusables.enterprise_user_management.unauthenticated-sign-ups %} You can disable unauthenticated sign-ups and require an invitation to create a new user account on your instance.
|
||||
|
||||
{% data reusables.enterprise_user_management.alternatively-enable-external-authentication %}
|
||||
|
||||
## Desactivar los registros no autenticados
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.privacy %}
|
||||
@@ -0,0 +1,16 @@
|
||||
---
|
||||
title: Usar la autenticación integrada
|
||||
shortTitle: Built-in authentication
|
||||
intro: 'If you don''t use a centralized, external system for your users'' identity, you can use built-in authentication to allow {% data variables.product.prodname_ghe_server %} to manage accounts and perform local authentication.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
children:
|
||||
- /configuring-built-in-authentication
|
||||
- /inviting-people-to-use-your-instance
|
||||
- /disabling-unauthenticated-sign-ups
|
||||
---
|
||||
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Inviting people to use your instance
|
||||
intro: 'When you use built-in authentication for {% data variables.product.product_name %}, you can invite people by email address to create a user account on your instance.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
permissions: 'Enterprise owners can invite people to create a user account on a {% data variables.product.product_name %} instance.'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
shortTitle: Invite people
|
||||
---
|
||||
|
||||
## About invitations for new users
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication-new-accounts %} {% data reusables.enterprise_user_management.unauthenticated-sign-ups %}
|
||||
|
||||
You can disable unauthenticated sign-ups and require an invitation to create a new user account on your instance. For more information, see "[Disabling unauthenticated sign-ups](/admin/identity-and-access-management/using-built-in-authentication/disabling-unauthenticated-sign-ups)."
|
||||
|
||||
{% data reusables.enterprise_user_management.alternatively-enable-external-authentication %}
|
||||
|
||||
## Inviting people to create a user account
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %}
|
||||
{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %}
|
||||
|
||||
If you've configured email for notifications on {% data variables.product.product_location %}, your instance will send the invitation to the provided email address. Para obtener más información, consulta la sección "[Configurar las notificaciones de correo electrónico](/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications)".
|
||||
@@ -0,0 +1,10 @@
|
||||
---
|
||||
title: Using CAS for enterprise IAM
|
||||
shortTitle: CAS for enterprise IAM
|
||||
intro: 'You can centrally manage accounts and access to {% data variables.product.product_location %} by integrating with your existing CAS identity provider (IdP).'
|
||||
versions:
|
||||
ghes: '*'
|
||||
children:
|
||||
- /using-cas
|
||||
---
|
||||
|
||||
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: Usar CAS
|
||||
redirect_from:
|
||||
- /enterprise/admin/articles/configuring-cas-authentication
|
||||
- /enterprise/admin/articles/about-cas-authentication
|
||||
- /enterprise/admin/user-management/using-cas
|
||||
- /enterprise/admin/authentication/using-cas
|
||||
- /admin/authentication/using-cas
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-cas
|
||||
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-cas
|
||||
intro: 'If you use Central Authentication Service (CAS) to centralize access to multiple web applications, you can integrate {% data variables.product.product_name %} by configuring CAS authentication for your instance.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- SSO
|
||||
---
|
||||
|
||||
## About CAS authentication for {% data variables.product.product_name %}
|
||||
|
||||
CAS is a single sign-on (SSO) protocol that centralizes authentication to multiple web applications. For more information, see "[Central Authentication Service](https://en.wikipedia.org/wiki/Central_Authentication_Service)" on Wikipedia.
|
||||
|
||||
After you configure CAS, people who use {% data variables.product.product_location %} must use a personal access token to authenticate API or Git requests over HTTP(S). CAS credentials cannot be used to authenticate these requests. Para obtener más información, consulta la sección "[Crear un token de acceso personal](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)".
|
||||
|
||||
If you configure CAS, people with accounts on your identity provider (IdP) do not consume a user license until the person signs into {% data variables.product.product_location %}.
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication %}
|
||||
|
||||
## Consideraciones sobre el nombre de usuario con CAS
|
||||
|
||||
{% data reusables.enterprise_user_management.consider-usernames-for-external-authentication %} For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)."
|
||||
|
||||
## Atributos de CAS
|
||||
|
||||
Están disponibles los siguientes atributos.
|
||||
|
||||
| Nombre del atributo | Tipo | Descripción |
|
||||
| ------------------- | --------- | ------------------------------------------------------------------------ |
|
||||
| `nombre de usuario` | Requerido | El nombre de usuario {% data variables.product.prodname_ghe_server %}. |
|
||||
|
||||
## Configurar CAS
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
3. Selecciona **CAS**.
|
||||
|
||||
|
||||
4. {% data reusables.enterprise_user_management.built-in-authentication-option %}
|
||||
|
||||
|
||||
5. En el campo **URL del servidor**, escribe la URL completa de tu servidor CAS. Si tu servidor CAS usa un certificado que no puede ser validado por {% data variables.product.prodname_ghe_server %}, puedes usar el comando `ghe-ssl-ca-certificate-install` para instalarlo como un certificado de confianza. Para obtener más información, consulta la sección "[Utilidades de línea de comandos](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-ssl-ca-certificate-install)".
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /early-access/github/articles/get-started-with-managed-users-for-your-enterprise
|
||||
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users
|
||||
- /admin/authentication/managing-your-enterprise-users-with-your-identity-provider/about-enterprise-managed-users
|
||||
- /admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/about-enterprise-managed-users
|
||||
versions:
|
||||
ghec: '*'
|
||||
type: overview
|
||||
@@ -76,7 +77,7 @@ El nombre de usuario del usuario de configuración es el código corto de tu emp
|
||||
|
||||
Los {% data variables.product.prodname_managed_users_caps %} se deben autenticar mediante su proveedor de identidad. Para autenticarse, un {% data variables.product.prodname_managed_user %} puede visitar su portal de aplicación IdP o utilizar una página de inicio de sesión en {% data variables.product.prodname_dotcom_the_website %}.
|
||||
|
||||
{% data reusables.enterprise-accounts.about-recovery-codes %} Para obtener más información, consulta la sección "[Administrar los códigos de recuperación de tu empresa](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)".
|
||||
{% data reusables.enterprise-accounts.about-recovery-codes %}Para obtener más información, consulta la sección "[Administrar los códigos de recuperación para tu empresa](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)".
|
||||
|
||||
### Autenticarse como un {% data variables.product.prodname_managed_user %} a través de {% data variables.product.prodname_dotcom_the_website %}
|
||||
|
||||
@@ -6,6 +6,7 @@ product: '{% data reusables.gated-features.emus %}'
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/configuring-saml-single-sign-on-for-enterprise-managed-users
|
||||
- /admin/authentication/managing-your-enterprise-users-with-your-identity-provider/configuring-saml-single-sign-on-for-enterprise-managed-users
|
||||
- /admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users
|
||||
versions:
|
||||
ghec: '*'
|
||||
type: tutorial
|
||||
@@ -9,6 +9,7 @@ redirect_from:
|
||||
- /early-access/github/articles/configuring-provisioning-for-managed-users-with-okta
|
||||
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/configuring-scim-provisioning-for-enterprise-managed-users-with-okta
|
||||
- /admin/authentication/managing-your-enterprise-users-with-your-identity-provider/configuring-scim-provisioning-for-enterprise-managed-users-with-okta
|
||||
- /admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users-with-okta
|
||||
type: tutorial
|
||||
topics:
|
||||
- Accounts
|
||||
@@ -6,6 +6,7 @@ product: '{% data reusables.gated-features.emus %}'
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/configuring-scim-provisioning-for-enterprise-managed-users
|
||||
- /admin/authentication/managing-your-enterprise-users-with-your-identity-provider/configuring-scim-provisioning-for-enterprise-managed-users
|
||||
- /admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users
|
||||
versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
@@ -1,11 +1,12 @@
|
||||
---
|
||||
title: Administrar el IAM con los usuarios de Enterprise Managed
|
||||
title: Using Enterprise Managed Users and SAML for IAM
|
||||
shortTitle: Usuarios Administrados de Enterprise
|
||||
product: '{% data reusables.gated-features.emus %}'
|
||||
intro: Puedes administrar la identidad y el acceso con tu proveedor de identidad y aprovisionar cuentas que solo puedan contribuir con tu empresa.
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider
|
||||
- /admin/authentication/managing-your-enterprise-users-with-your-identity-provider
|
||||
- /admin/identity-and-access-management/managing-iam-with-enterprise-managed-users
|
||||
versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
@@ -6,6 +6,7 @@ product: '{% data reusables.gated-features.emus %}'
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/managing-team-memberships-with-identity-provider-groups
|
||||
- /admin/authentication/managing-your-enterprise-users-with-your-identity-provider/managing-team-memberships-with-identity-provider-groups
|
||||
- /admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/managing-team-memberships-with-identity-provider-groups
|
||||
versions:
|
||||
ghec: '*'
|
||||
type: how_to
|
||||
@@ -0,0 +1,10 @@
|
||||
---
|
||||
title: Using LDAP for enterprise IAM
|
||||
shortTitle: LDAP for enterprise IAM
|
||||
intro: You can centrally manage accounts and access to {% data variables.product.product_location %} by integrating with your existing LDAP directory.
|
||||
versions:
|
||||
ghes: '*'
|
||||
children:
|
||||
- /using-ldap
|
||||
---
|
||||
|
||||
@@ -10,7 +10,8 @@ redirect_from:
|
||||
- /enterprise/admin/authentication/using-ldap
|
||||
- /admin/authentication/using-ldap
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-ldap
|
||||
intro: 'LDAP te permite autenticar el {% data variables.product.prodname_ghe_server %} en tus cuentas existentes y administrar de manera centralizada el acceso a los repositorios. LDAP es un protocolo de aplicación popular para acceder a servicios de información de directorios y mantenerlos, y uno de los protocolos más comunes que se usan para integrar software de terceros con directorios de usuarios de empresas grandes.'
|
||||
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-ldap
|
||||
intro: 'If you use Lightweight Directory Access Protocol (LDAP) to centralize access across applications, you can integrate {% data variables.product.product_name %} by configuring LDAP authentication for your instance.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
@@ -21,6 +22,12 @@ topics:
|
||||
- Identity
|
||||
---
|
||||
|
||||
## About LDAP authentication for {% data variables.product.product_name %}
|
||||
|
||||
LDAP is a popular application protocol for access and maintenance of directory information services, and is one of the most common protocols for integration of third-party software with large company user directories. For more information, see "[Lightweight Directory Access Protocol](https://en.wikipedia.org/wiki/Lightweight_Directory_Access_Protocol)" on Wikipedia.
|
||||
|
||||
If you use an LDAP directory for centralized authentication, you can configure LDAP authentication for the people who use {% data variables.product.product_location %}.
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication %}
|
||||
|
||||
## Servicios LDAP admitidos
|
||||
@@ -36,12 +43,7 @@ El {% data variables.product.prodname_ghe_server %} se integra con los siguiente
|
||||
|
||||
## Consideraciones sobre el nombre de usuario con LDAP
|
||||
|
||||
{% data reusables.enterprise_management_console.username_normalization %}
|
||||
|
||||
{% data reusables.enterprise_management_console.username_normalization_sample %}
|
||||
|
||||
{% data reusables.enterprise_user_management.two_factor_auth_header %}
|
||||
{% data reusables.enterprise_user_management.2fa_is_available %}
|
||||
{% data reusables.enterprise_user_management.consider-usernames-for-external-authentication %} For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)."
|
||||
|
||||
## Configurar LDAP con {% data variables.product.product_location %}
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
title: Acerca de la administración de identidades y de accesos para tu empresa
|
||||
shortTitle: Acerca de la administración de identidad y de acceso
|
||||
intro: 'Puedes utilizar el inicio de sesión único (SSO) de SAML y el Sistema para la Administración de Identidad Entre Dominios (SCIM) para administrar el acceso centralmente {% ifversion ghec %}a las organizaciones que pertenecen a tu empresa en {% data variables.product.prodname_dotcom_the_website %}{% endif %}{% ifversion ghae %} a {% data variables.product.product_location %}{% endif %}.'
|
||||
title: About SAML for enterprise IAM
|
||||
shortTitle: About SAML for IAM
|
||||
intro: 'You can use SAML single sign-on (SSO) {% ifversion ghec or ghae %}and System for Cross-domain Identity Management (SCIM) {% endif %}to centrally manage access {% ifversion ghec %}to organizations owned by your enterprise on {% data variables.product.prodname_dotcom_the_website %}{% elsif ghes %}to {% data variables.product.product_location %}{% elsif ghae %}to {% data variables.product.product_location %}{% endif %}.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
type: overview
|
||||
topics:
|
||||
@@ -19,17 +20,21 @@ redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/about-user-provisioning-for-organizations-in-your-enterprise-account
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/about-identity-and-access-management-for-your-enterprise
|
||||
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/about-identity-and-access-management-for-your-enterprise
|
||||
---
|
||||
|
||||
## Acerca de la administración de identidades y de accesos para tu empresa
|
||||
## About SAML SSO for {% ifversion ghec or ghae %}your enterprise on {% endif %}{% ifversion ghec or ghes %}{% data variables.product.product_location %}{% elsif ghae %}{% data variables.product.product_name %}{% endif %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
{% data reusables.saml.dotcom-saml-explanation %} {% data reusables.saml.about-saml-enterprise-accounts %} Para obtener más información, consulta la sección "[Configurar el inicio de sesión único de SAML en tu empresa](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise)".
|
||||
|
||||
If your enterprise members manage their own personal accounts on {% data variables.product.product_location %}, you can configure SAML authentication as an additional access restriction for your enterprise or organization. Alternatively, you can provision and manage the accounts of your enterprise members on {% data variables.product.product_location %} by using an enterprise account with {% data variables.product.prodname_emus %} enabled. For more information, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#authentication-methods-for-github-enterprise-cloud)."
|
||||
|
||||
{% data reusables.enterprise-accounts.about-recovery-codes %}Para obtener más información, consulta la sección "[Administrar los códigos de recuperación para tu empresa](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise)".
|
||||
|
||||
Después de que habilites el SSO de SAML, dependiendo del IdP que utilizas, debes poder habilitar las características de administración de acceso y de identidad adicionales. {% data reusables.scim.enterprise-account-scim %}
|
||||
Después de que habilites el SSO de SAML, dependiendo del IdP que utilizas, debes poder habilitar las características de administración de acceso y de identidad adicionales.
|
||||
|
||||
Si utilizas Azure AD como tu IdP, puedes utilizar la sincronización de equipos para administrar la membresía del equipo dentro de cada organización. {% data reusables.identity-and-permissions.about-team-sync %} Para obtener más información, consulta la sección "[Administrar la sincronización de equipos para las organizaciones de tu cuenta empresarial](/admin/authentication/managing-identity-and-access-for-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise)".
|
||||
|
||||
@@ -39,10 +44,44 @@ Si utilizas Azure AD como tu IdP, puedes utilizar la sincronización de equipos
|
||||
|
||||
{% data reusables.enterprise-accounts.emu-short-summary %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** You cannot use SCIM at the enterprise level unless your enterprise is enabled for {% data variables.product.prodname_emus %}.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
El configurar las {% data variables.product.prodname_emus %} para el inicio de sesión único de SAML y utilizar el aprovisionamiento involucra seguir un proceso diferente al que se llevaría para una empresa que no está utilizando {% data variables.product.prodname_managed_users %}. Si tu empresa utiliza {% data variables.product.prodname_emus %}, consulta la sección "[Configurar el inicio de sesión único de SAML para los Usuarios Administrados de Enterprise](/github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/configuring-saml-single-sign-on-for-enterprise-managed-users)".
|
||||
|
||||
{% elsif ghes %}
|
||||
|
||||
El SSO de SAML permite que las personas se autentiquen y accedan a {% data variables.product.product_location %} mediante un sistema externo para la administración de identidades.
|
||||
|
||||
SAML es un estándar basado en XML para autenticación y autorización. Cuando configuras SAML para {% data variables.product.product_location %}, el sistema de autenticación externo se denomina un "proveedor de identidad" (IdP). Tu instancia actúa como un proveedor de servicios (PS) de SAML. For more information about the SAML standard, see [Security Assertion Markup Language](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) on Wikipedia.
|
||||
|
||||
For more information about the configuration of SAML SSO on {% data variables.product.product_name %}, see "[Configuring SAML single sign-on for your enterprise](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise)."
|
||||
|
||||
{% data reusables.saml.saml-ghes-account-revocation %}
|
||||
|
||||
{% data reusables.enterprise_user_management.external_auth_disables_2fa %}
|
||||
|
||||
{% data reusables.enterprise_user_management.built-in-authentication %}
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
{% data reusables.saml.ae-uses-saml-sso %}{% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %}
|
||||
|
||||
Después de configurar la aplicación de {% data variables.product.product_name %} en tu proveedor de identidad (IdP), puedes aprovisionar el acceso a {% data variables.product.product_location %} si asignas la aplicación a los usuarios y grupos de tu IdP. Para obtener más información acerca del SSO de SAML para {% data variables.product.product_name %}, consulta la sección "[Configurar el inicio de sesión único de SAML para tu empresa](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)".
|
||||
|
||||
{% data reusables.scim.after-you-configure-saml %} Para obtener más información, consulta la sección "[Configurar el aprovisionamiento de usuarios para tu empresa](/admin/authentication/configuring-user-provisioning-for-your-enterprise)".
|
||||
|
||||
Para aprender cómo configurar tanto la autenticación como el aprovisionamiento de usuarios para {% data variables.product.product_location %} con tu IdP específico, consulta la sección "[Configurar la autenticación y el aprovisionamiento con tu proveedor de identidad](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
## IdP compatibles
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
Probamos y damos compatibilidad oficial de los siguientes IdP. Para el SSO de SAML, ofrecemos soporte limitado para todos los proveedores de identidad que implementan el SAML 2.0 estándar. Para obtener más información, consulta la sección [Wiki de SAML](https://wiki.oasis-open.org/security) en el sitio web de OASIS.
|
||||
|
||||
| IdP | SAML | Sincronización de equipos |
|
||||
@@ -54,27 +93,33 @@ Probamos y damos compatibilidad oficial de los siguientes IdP. Para el SSO de SA
|
||||
| PingOne | {% octicon "check-circle-fill" aria-label="The check icon" %} | |
|
||||
| Shibboleth | {% octicon "check-circle-fill" aria-label="The check icon" %} | |
|
||||
|
||||
{% elsif ghes %}
|
||||
|
||||
{% data reusables.saml.saml-supported-idps %}
|
||||
|
||||
{% ifversion ghes > 3.3 %}
|
||||
|
||||
Si tu IdP es compatible con confirmaciones cifradas, puedes configurarlas en {% data variables.product.product_name %} para incrementar la seguridad durante el proceso de autenticación.
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% data reusables.saml.saml-single-logout-not-supported %}
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
{% data reusables.saml.ae-uses-saml-sso %}{% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %}
|
||||
|
||||
Después de configurar la aplicación de {% data variables.product.product_name %} en tu proveedor de identidad (IdP), puedes aprovisionar el acceso a {% data variables.product.product_location %} si asignas la aplicación a los usuarios y grupos de tu IdP. Para obtener más información acerca del SSO de SAML para {% data variables.product.product_name %}, consulta la sección "[Configurar el inicio de sesión único de SAML para tu empresa](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)".
|
||||
|
||||
{% data reusables.scim.after-you-configure-saml %} Para obtener más información, consulta la sección "[Configurar el aprovisionamiento de usuarios para tu empresa](/admin/authentication/configuring-user-provisioning-for-your-enterprise)".
|
||||
|
||||
Para aprender cómo configurar tanto la autenticación como el aprovisionamiento de usuarios para {% data variables.product.product_location %} con tu IdP específico, consulta la sección "[Configurar la autenticación y el aprovisionamiento con tu proveedor de identidad](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider)".
|
||||
|
||||
## IdP compatibles
|
||||
|
||||
Los siguientes IdP son oficialmente compatibles para su integración con {% data variables.product.prodname_ghe_managed %}.
|
||||
|
||||
{% data reusables.saml.okta-ae-sso-beta %}
|
||||
|
||||
{% data reusables.github-ae.saml-idp-table %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae %}
|
||||
|
||||
## Mapear equipos de {% data variables.product.prodname_ghe_managed %} en grupos de Okta
|
||||
|
||||
Si utilizas Okta como tu IdP, puedes mapear grupos de Okta en los equipos de {% data variables.product.prodname_ghe_managed %}. Para obtener más información, consulta la sección "[Mapear grupos de Okta en los equipos](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)".
|
||||
Si utilizas Okta como tu IdP, puedes mapear grupos de Okta en los equipos de {% data variables.product.product_name %}. Para obtener más información, consulta la sección "[Mapear grupos de Okta en los equipos](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Configurar la autenticación y el aprovisionamiento para tu empresa utilizando Azure AD
|
||||
shortTitle: Configurar con Azure AD
|
||||
shortTitle: Configure with Azure AD
|
||||
intro: 'Puedes utilizar un inquilino en Azure Active Directory (Azure AD) como proveedor de identidad (IdP) para administrar centralmente la autenticación y el aprovisionamiento de usuarios para {% data variables.product.product_location %}.'
|
||||
permissions: 'Enterprise owners can configure authentication and provisioning for an enterprise on {% data variables.product.product_name %}.'
|
||||
versions:
|
||||
@@ -15,6 +15,7 @@ topics:
|
||||
redirect_from:
|
||||
- /admin/authentication/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
|
||||
- /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
|
||||
- /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
|
||||
---
|
||||
|
||||
## Acerca de la autenticación y el aprovisionamiento de usuarios con Azure AD
|
||||
@@ -1,12 +1,13 @@
|
||||
---
|
||||
title: Configurar la autenticación y aprovisionamiento para tu empresa utilizando Okta
|
||||
shortTitle: Configurar con Okta
|
||||
shortTitle: Configure with Okta
|
||||
intro: 'Puedes utilizar Okta como un proveedor de identidad (IdP) para administrar centralmente la autenticación y aprovisionamiento de usuarios para {% data variables.product.prodname_ghe_managed %}.'
|
||||
permissions: 'Enterprise owners can configure authentication and provisioning for {% data variables.product.prodname_ghe_managed %}.'
|
||||
versions:
|
||||
ghae: '*'
|
||||
redirect_from:
|
||||
- /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta
|
||||
- /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
@@ -7,13 +7,14 @@ redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise-account-using-okta
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/configuring-saml-single-sign-on-for-your-enterprise-account-using-okta
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise-using-okta
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise-using-okta
|
||||
versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Authentication
|
||||
- Enterprise
|
||||
type: how_to
|
||||
shortTitle: Configurar el SAML con Okta
|
||||
shortTitle: Configure SAML SSO with Okta
|
||||
---
|
||||
|
||||
{% data reusables.enterprise-accounts.emu-saml-note %}
|
||||
@@ -1,10 +1,11 @@
|
||||
---
|
||||
title: Configurar el inicio de sesión único de SAML para tu empresa
|
||||
shortTitle: Configurar el SSO de SAML
|
||||
intro: 'Puedes controlar el acceso seguro a {% ifversion ghec %}los recursos como repositorios, propuestas y solicitudes de cambios dentro de las organizaciones de tu empresa{% elsif ghae %}tu empresa en {% data variables.product.prodname_ghe_managed %}{% endif %} si {% ifversion ghec %}requieres{% elsif ghae %}la configuración {% endif %}del inicio de sesión único (SSO) de SAML a través de tu proveedor de identidad (IdP).'
|
||||
permissions: 'Enterprise owners can configure SAML SSO for an enterprise on {% data variables.product.product_name %}.'
|
||||
intro: 'You can control and secure access to {% ifversion ghec %}resources like repositories, issues, and pull requests within your enterprise''s organizations{% elsif ghes %}{% data variables.product.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.prodname_ghe_managed %}{% endif %} by {% ifversion ghec %}enforcing{% elsif ghes or ghae %}configuring{% endif %} SAML single sign-on (SSO) through your identity provider (IdP).'
|
||||
permissions: '{% ifversion ghes %}Site administrators{% elsif ghec or ghae %}Enterprise owners{% endif %} can configure SAML SSO for {% ifversion ghec or ghae %}an enterprise on {% data variables.product.product_name %}{% elsif ghes %}a {% data variables.product.product_name %} instance{% endif %}.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
@@ -19,11 +20,12 @@ redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/enabling-saml-single-sign-on-for-organizations-in-your-enterprise-account
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/enforcing-saml-single-sign-on-for-organizations-in-your-enterprise-account
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise
|
||||
---
|
||||
|
||||
{% data reusables.enterprise-accounts.emu-saml-note %}
|
||||
|
||||
## Acerca del SSO de SAML para tus cuentas empresariales
|
||||
## Acerca de SAML SSO
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
@@ -37,24 +39,34 @@ redirect_from:
|
||||
|
||||
{% data reusables.scim.enterprise-account-scim %}
|
||||
|
||||
{% elsif ghae %}
|
||||
{% elsif ghes or ghae %}
|
||||
|
||||
El SSO de SAML te permite controlar centralmente y asegurar el acceso a {% data variables.product.product_location %}desde tu IdP de SAML. Cuando un usuario no autenticado vista {% data variables.product.product_location %} en un buscador, {% data variables.product.product_name %} lo redirigirá a tu IdP de SAML para autenticarse. Después de que el usuario se autentica exitosamente con una cuenta en el IdP, éste lo redirige de regreso a {% data variables.product.product_location %}. {% data variables.product.product_name %} valida la respuesta de tu IdP y luego le otorga acceso al usuario.
|
||||
|
||||
Después de autenticarse exitosamente en tu IdP, la sesión de SAML del usuario para {% data variables.product.product_location %} se encuentra activa en el buscador por 24 horas. Después de 24 horas, el usuario debe autenticarse nuevamente con tu IdP.
|
||||
|
||||
{% data reusables.saml.saml-ghes-account-revocation %}
|
||||
|
||||
{% ifversion ghae %}
|
||||
|
||||
{% data reusables.saml.assert-the-administrator-attribute %}
|
||||
|
||||
{% data reusables.scim.after-you-configure-saml %} Para obtener más información, consulta la sección "[Configurar el aprovisionamiento de usuarios para tu empresa](/admin/authentication/configuring-user-provisioning-for-your-enterprise)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Proveedores de identidad compatibles
|
||||
|
||||
{% data reusables.saml.saml-supported-idps %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
## Consideraciones sobre el nombre de usuario con SAML
|
||||
|
||||
{% ifversion ghec %}If you use {% data variables.product.prodname_emus %}, {% endif %}{% data reusables.enterprise_user_management.consider-usernames-for-external-authentication %} For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)."
|
||||
|
||||
## Requerir el inicio de sesión único de SAML para las organizaciones en tu cuenta empresarial
|
||||
|
||||
{% note %}
|
||||
@@ -81,6 +93,61 @@ Para obtener información más detallada sobre cómo habilitar el SAML utilizand
|
||||
11. Haz clic en **Save ** (guardar).
|
||||
{% data reusables.enterprise-accounts.download-recovery-codes %}
|
||||
|
||||
{% elsif ghes %}
|
||||
|
||||
## Configurar el SSO de SAML
|
||||
|
||||
Puedes habilitar o inhabilitar la autenticación de SAML para {% data variables.product.product_location %} o puedes editar una configuración existente. You can view and edit authentication settings for {% data variables.product.product_name %} in the management console. Para obtener más información, consulta la sección "[Acceder a la consola de administración](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)".
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota**: {% data reusables.enterprise.test-in-staging %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
1. Selecciona **SAML**.
|
||||
|
||||
|
||||
1. {% data reusables.enterprise_user_management.built-in-authentication-option %}
|
||||
|
||||
|
||||
1. Opcionalmente, para activar el SSO de respuesta no solicitada, selecciona **IdP initiated SSO**. Por defecto, {% data variables.product.prodname_ghe_server %} responderá a una solicitud iniciada por un proveedor de identidad (IdP) no solicitada con una `AuthnRequest` de vuelta al IdP.
|
||||
|
||||
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Nota**: Te recomendamos mantener este valor **deseleccionado**. Deberías habilitar esta característica **únicamente** en la remota instancia de que tu implementación de SAML no sea compatible con el SSO que inició el proveedor de servicios y cuando lo recomiende {% data variables.contact.enterprise_support %}.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
1. Selecciona **Disable administrator demotion/promotion (Desactivar la degradación/promoción del administrador)** si **no** quieres que tu proveedor de SAML determine los derechos del administrador para los usuarios en {% data variables.product.product_location %}.
|
||||
|
||||
|
||||
{%- ifversion ghes > 3.3 %}
|
||||
1. Opcionalmente, para permitir que {% data variables.product.product_location %} reciba confirmaciones cifradas desde tu IdP de SAML, selecciona **Requerir confirmaciones cifradas**. Debes asegurarte de que tu IdP sea compatible con las aserciones cifradas y que los métodos de transporte de llaves y de cifrado en la consola de administración empaten con los valores configurados en tu IdP. También debes proporcionar un certificado público de {% data variables.product.product_location %} a tu IdP. Para obtener más información, consulta la sección "[Habilitar las aserciones cifradas](/admin/identity-and-access-management/using-saml-for-enterprise-iam/enabling-encrypted-assertions)".
|
||||
|
||||
|
||||
{%- endif %}
|
||||
1. En el campo **URL de inicio de sesión único**, teclea la terminal HTTP o HTTPS en tu IdP para las solicitudes de inicio de sesión único. Este valor lo provee la configuración de tu IdP. Si el host solo se encuentra disponible en tu red interna, podrías necesitar [configurar {% data variables.product.product_location %} para utilizar servidores de nombres internos](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-dns-nameservers/).
|
||||
|
||||
|
||||
1. Opcionalmente, en el campo de **Emisor**, teclea el nombre del emisor SAML. Esto verifica la autenticidad de los mensajes que se envían a {% data variables.product.product_location %}.
|
||||
|
||||
|
||||
1. En los menús desplegables de **Método de firma** y **Método de resumen**, elige el algoritmo de hash que usa tu emisor SAML para verificar la integridad de las respuestas desde {% data variables.product.product_location %}. Especifica el formato con el menú desplegable **Formato de identificador de nombre**.
|
||||
|
||||
|
||||
1. Dentro de **Verification certificate (Certificado de comprobación)**, haz clic en **Choose File (Elegir archivo)** y elige un certificado para validar las respuestas SAML desde el IdP.
|
||||
|
||||
|
||||
1. Modifica los nombres de atributo de SAML para hacerlos coincidir con tu IdP, si es necesario, o acepta los nombres predeterminados.
|
||||
|
||||
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
## Habilitar el SSO de SAML
|
||||
@@ -89,18 +156,12 @@ Para obtener información más detallada sobre cómo habilitar el SAML utilizand
|
||||
|
||||
Los siguientes IdP proporcionan documentación sobre cómo configurar el SSO de SAML para {% data variables.product.product_name %}. Si no se lista tu IdP, por favor, contáctalo para solicitar soporte para {% data variables.product.product_name %}.
|
||||
|
||||
| IdP | Más información |
|
||||
|:----------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Azure AD | [Tutorial: Integración del inicio de sesión único (SSO) de Azure Active Directory con {% data variables.product.prodname_ghe_managed %}](https://docs.microsoft.com/azure/active-directory/saas-apps/github-ae-tutorial) en los Documentos de Microsoft. Para configurar a Azure AD para {% data variables.product.prodname_ghe_managed %}, consulta la sección "[Configurar la autenticación y aprovisionamiento para tu empresa utilizando Azure AD](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)". |
|
||||
| Okta (Beta) | Para configurar Okta para {% data variables.product.prodname_ghe_managed %}, consulta la sección "[Configurar la autenticación y el aprovisionamiento para tu empresa utilizando Okta](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta)". |
|
||||
| IdP | Más información |
|
||||
|:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Azure AD | "[Configuring authentication and provisioning for your enterprise using Azure AD](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)" |
|
||||
| Okta | "[Configuring authentication and provisioning for your enterprise using Okta](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta)" |
|
||||
|
||||
Durante la inicialización para {% data variables.product.product_name %}, debes configurar a {% data variables.product.product_name %} como un proveedor de servicios (SP) de SAML en tu IdP. Debes ingresar varios valores únicos en tu IdP para configurar {% data variables.product.product_name %} como un SP válido.
|
||||
|
||||
| Valor | Otros nombres | Descripción | Ejemplo |
|
||||
|:--------------------------------------------------------- |:---------------- |:--------------------------------------------------------------------------------- |:------------------------- |
|
||||
| ID de Entidad de SP | URL de SP | Tu URL de más alto nivel para {% data variables.product.prodname_ghe_managed %} | <code>https://<em>YOUR-GITHUB-AE-HOSTNAME</em></code> |
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | URL de respuesta | URL a la que el IdP enviará respuestas de SAML | <code>https://<em>YOUR-GITHUB-AE-HOSTNAME</em>/saml/consume</code> |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | <code>https://<em>YOUR-GITHUB-AE-HOSTNAME</em>/sso</code> |
|
||||
During initialization for {% data variables.product.product_name %}, you must configure {% data variables.product.product_name %} as a SAML service provider (SP) on your IdP. Debes ingresar varios valores únicos en tu IdP para configurar {% data variables.product.product_name %} como un SP válido. For more information, see "[SAML configuration reference](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference#saml-metadata)."
|
||||
|
||||
## Editar la configuración del SSO de SAML
|
||||
|
||||
@@ -152,3 +213,16 @@ Si los detalles de tu IdP cambian, necesitarás editar la configuración de SSO
|
||||
{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghec or ghes %}
|
||||
|
||||
## Leer más
|
||||
|
||||
{%- ifversion ghec %}
|
||||
- "[Managing SAML single sign-on for your organization](/organizations/managing-saml-single-sign-on-for-your-organization)"
|
||||
{%- endif %}
|
||||
{%- ifversion ghes %}
|
||||
- "[Promoting or demoting a site administrator](/admin/user-management/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator)"
|
||||
{%- endif %}
|
||||
|
||||
{% endif %}
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Configurar el aprovisionamiento de usuarios para tu empresa
|
||||
shortTitle: Configurar el aprovisionamiento de usuarios
|
||||
shortTitle: Configure user provisioning
|
||||
intro: 'Puedes configurar el Sistema para la Administración de Identidad entre Dominios (SCIM) para tu empresa, el cual aprovisiona las cuentas de usuario automáticamente en {% data variables.product.product_location %} cuando asignas la aplicación para {% data variables.product.product_location %} a un usuario en tu proveedor de identidad (IdP).'
|
||||
permissions: 'Enterprise owners can configure user provisioning for an enterprise on {% data variables.product.product_name %}.'
|
||||
versions:
|
||||
@@ -14,15 +14,16 @@ topics:
|
||||
- SSO
|
||||
redirect_from:
|
||||
- /admin/authentication/configuring-user-provisioning-for-your-enterprise
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-user-provisioning-for-your-enterprise
|
||||
---
|
||||
|
||||
## Acerca del aprovisionamiento de usuarios para tu empresa
|
||||
|
||||
{% data reusables.saml.ae-uses-saml-sso %} Para obtener más información, consulta la sección "[Configurar el incio de sesión único de SAML para tu empresa](/admin/authentication/configuring-saml-single-sign-on-for-your-enterprise)".
|
||||
|
||||
{% data reusables.scim.after-you-configure-saml %} Para obtener más información acerca del SCIM, consulta la sección [Sistema para la Administración de Identidad entre Dominios: Protocolo (RFC 7644)](https://tools.ietf.org/html/rfc7644) en el sitio web de IETF.
|
||||
You can configure user provisioning with SCIM to automatically create or suspend user accounts and grant access for {% data variables.product.product_name %} when you assign or unassign the application on your IdP. For more information about SCIM, see [System for Cross-domain Identity Management: Protocol (RFC 7644)](https://tools.ietf.org/html/rfc7644) on the IETF website.
|
||||
|
||||
{% ifversion ghae %}
|
||||
If you do not configure user provisioning with SCIM, your IdP will not communicate with {% data variables.product.product_name %} automatically when you assign or unassign the application to a user. Without SCIM, {% data variables.product.product_name %} creates a user account using SAML Just-in-Time (JIT) provisioning the first time someone navigates to {% data variables.product.product_name %} and signs in by authenticating through your IdP.
|
||||
|
||||
Configurar el aprovisionamiento le permite a tu IdP comunicarse con {% data variables.product.product_location %} cuando asignas o desasignas la aplicación para {% data variables.product.product_name %} a un usuario en tu IdP. Cuando asignas la aplicación, tu IdP pedirá que {% data variables.product.product_location %} cree una cuenta y enviará un correo electrónico de incorporación al usuario. Cuando desasignas la aplicación, tu IdP se comunicará con {% data variables.product.product_name %} para invalidad cualquier sesión de SAML e inhabilitar la cuenta del miembro.
|
||||
|
||||
@@ -30,8 +31,6 @@ Para configurar el aprovisionamiento para tu empresa, debes inhabilitar el aprov
|
||||
|
||||
La aplicación de aprovisionamiento en tu IdP se comunica con {% data variables.product.product_name %} a través de nuestra API de SCIM para empresas. Para obtener más información, consulta la sección "[Adminsitración de GitHub Enterprise](/rest/reference/enterprise-admin#scim)" en la documentación de la API de REST de {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Proveedores de identidad compatibles
|
||||
|
||||
Los siguientes IDP son compatibles con SSO con {% data variables.product.prodname_ghe_managed %}:
|
||||
@@ -44,18 +43,12 @@ Para los IdP que son compatibles con el mapeo de equipos, puedes asignar o dejar
|
||||
|
||||
## Prerrequisitos
|
||||
|
||||
{% ifversion ghae %}
|
||||
|
||||
Para aprovisionar y desaprovisionar automáticamente el acceso a {% data variables.product.product_location %} desde tu IdP, primero debes configurar el SSO de SAML cuando inicializas {% data variables.product.product_name %}. Para obtener más información, consulta la sección "[Inicializar {% data variables.product.prodname_ghe_managed %}](/admin/configuration/initializing-github-ae)".
|
||||
|
||||
Debes tener acceso administrativo en tu IdP para configurar la aplicación para el aprovisionamiento de usuarios para {% data variables.product.product_name %}.
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Habilitar el aprovisionamiento de usuarios para tu empresa
|
||||
|
||||
{% ifversion ghae %}
|
||||
|
||||
1. Mientras tengas una sesión activa en {% data variables.product.product_location %} como propietario de empresa, crea un token de acceso personal con el alcance **admin:enterprise**. Para obtener más información, consulta la sección "[Crear un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)".
|
||||
{% note %}
|
||||
|
||||
@@ -89,5 +82,3 @@ Debes tener acceso administrativo en tu IdP para configurar la aplicación para
|
||||
|:------------------ |:--------------------------------------- |:--------------------------------------------------------------------------------------------------------------------- |:------------------------------------------------------------------ |
|
||||
| URL | URL de inquilino | URL para la API de aprovisionamiento de SCIM para tu empresa en {% data variables.product.prodname_ghe_managed %} | <nobr>`{% data variables.product.api_url_pre %}/scim/v2</nobr>` |
|
||||
| Secreto compartido | Token de acceso personal, token secreto | Toekn para que la aplicación en tu IdP realice las tareas de aprovisionamiento en nombre de un propietario de empresa | Token de acceso personal que creaste en el paso 1 |
|
||||
|
||||
{% endif %}
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: Habilitar las aserciones cifradas
|
||||
shortTitle: Enable encrypted assertions
|
||||
intro: 'You can improve {% data variables.product.product_location %}''s security with SAML single sign-on (SSO) by encrypting the messages that your SAML identity provider (IdP) sends.'
|
||||
permissions: 'Site administrators can configure encrypted assertions for a {% data variables.product.product_name %} instance.'
|
||||
versions:
|
||||
ghes: '> 3.3'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- Security
|
||||
- SSO
|
||||
---
|
||||
|
||||
## About encrypted assertions
|
||||
|
||||
If your IdP support encryption of assertions, you can configure encrypted assertions on {% data variables.product.product_name %} for increased security during the authentication process.
|
||||
|
||||
## Prerrequisitos
|
||||
|
||||
To enable encrypted assertions for authentication to {% data variables.product.product_name %}, you must configure SAML authentication, and your IdP must support encrypted assertions.
|
||||
|
||||
## Habilitar las aserciones cifradas
|
||||
|
||||
To enable encrypted assertions, you must provide {% data variables.product.product_location %}'s public certificate to your IdP, and configure encryption settings that match your IdP.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota**: {% data reusables.enterprise.test-in-staging %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
1. Opcionalmente, habilita la depuración de SAML. La depuración de SAML registra las entradas verbosas en la bitácora de autenticación de {% data variables.product.product_name %} y podría ayudarte a solucionar problemas de los intentos de autenticación fallidos. For more information, see "[Troubleshooting SAML authentication](/admin/identity-and-access-management/using-saml-for-enterprise-iam/troubleshooting-saml-authentication#configuring-saml-debugging)."
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
1. Selecciona **Requerir aserciones cifradas**.
|
||||
|
||||
|
||||
1. A la derecha de "Cerficado de cifrado", haz clic en **Descargar** para guardar una copia del certificado público de {% data variables.product.product_location %} en tu máquina local.
|
||||
|
||||
|
||||
1. Inicia sesión en tu IdP de SAML como administrador.
|
||||
1. En la aplicación de {% data variables.product.product_location %}, habilita las aserciones cifradas.
|
||||
- Anota el método de cifrado y de transporte de llave.
|
||||
- Proporciona el certificado público que descargaste en el paso 7.
|
||||
1. Regresa a la consola de administración en {% data variables.product.product_location %}.
|
||||
1. A la derecha de "Método de cifrado", selecciona el método de cifrado para tu IdP desde el paso 9.
|
||||
|
||||
|
||||
1. A la derecha de "Método de transporte de llave", selecciona el método de transporte de llave para tu IdP desde el paso 9.
|
||||
|
||||
|
||||
1. Haz clic en **Guardar parámetros**.
|
||||
{% data reusables.enterprise_site_admin_settings.wait-for-configuration-run %}
|
||||
|
||||
Si habilitaste la depuración de SAML para probar la autenticación con las aserciones cifradas, inhabilita la depuración de SAML cuando termines de hacer las pruebas. For more information, see "[Troubleshooting SAML authentication](/admin/identity-and-access-management/using-saml-for-enterprise-iam/troubleshooting-saml-authentication#configuring-saml-debugging)."
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: Using SAML for enterprise IAM
|
||||
shortTitle: SAML for enterprise IAM
|
||||
intro: 'You can centrally manage {% ifversion ghes or ghae %}accounts and {% endif %}access to {% ifversion ghes %}{% data variables.product.product_location %}{% elsif ghae %}your enterprise{% elsif ghec %}your enterprise''s resources{% endif %} with SAML single sign-on (SSO){% ifversion ghec or ghae %} and System for Cross-domain Identity Management (SCIM){% endif %}.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise
|
||||
- /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider
|
||||
- /enterprise/admin/articles/configuring-saml-authentication
|
||||
- /enterprise/admin/articles/about-saml-authentication
|
||||
- /enterprise/admin/user-management/using-saml
|
||||
- /enterprise/admin/authentication/using-saml
|
||||
- /admin/authentication/using-saml
|
||||
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-saml
|
||||
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-saml
|
||||
children:
|
||||
- /about-saml-for-enterprise-iam
|
||||
- /saml-configuration-reference
|
||||
- /configuring-saml-single-sign-on-for-your-enterprise
|
||||
- /configuring-user-provisioning-for-your-enterprise
|
||||
- /managing-team-synchronization-for-organizations-in-your-enterprise
|
||||
- /configuring-saml-single-sign-on-for-your-enterprise-using-okta
|
||||
- /configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
|
||||
- /configuring-authentication-and-provisioning-for-your-enterprise-using-okta
|
||||
- /mapping-okta-groups-to-teams
|
||||
- /enabling-encrypted-assertions
|
||||
- /updating-a-users-saml-nameid
|
||||
- /switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
|
||||
- /troubleshooting-saml-authentication
|
||||
---
|
||||
|
||||
{% data reusables.enterprise-accounts.emu-saml-note %}
|
||||
@@ -14,6 +14,7 @@ redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise-account
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/managing-team-synchronization-for-organizations-in-your-enterprise-account
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise
|
||||
shortTitle: Administrar la sincronización de equipos
|
||||
---
|
||||
|
||||
@@ -1,11 +1,13 @@
|
||||
---
|
||||
title: Mapping Okta groups to teams
|
||||
shortTitle: Map Okta groups to teams
|
||||
intro: 'You can map your Okta groups to teams on {% data variables.product.prodname_ghe_managed %} to automatically add and remove team members.'
|
||||
permissions: 'Enterprise owners can configure authentication and provisioning for {% data variables.product.prodname_ghe_managed %}.'
|
||||
versions:
|
||||
ghae: '*'
|
||||
redirect_from:
|
||||
- /admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams
|
||||
- /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/mapping-okta-groups-to-teams
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
@@ -57,7 +59,7 @@ When you push an Okta group and map the group to a team, all of the group's memb
|
||||
|
||||
1. Type the name of the group to push to {% data variables.product.prodname_ghe_managed %}, then click **Save**.
|
||||
|
||||
|
||||
|
||||
|
||||
## Mapping a team to the Okta group
|
||||
|
||||
@@ -0,0 +1,142 @@
|
||||
---
|
||||
title: SAML configuration reference
|
||||
shortTitle: SAML reference
|
||||
intro: 'You can see SAML metadata for {% ifversion ghec %}your organization or enterprise on {% data variables.product.product_name %}{% elsif ghes %}{% data variables.product.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.product_name %}{% endif %}, and you can learn more about available SAML attributes and response requirements.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
type: reference
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- SSO
|
||||
---
|
||||
|
||||
## About SAML configuration
|
||||
|
||||
To use SAML single sign-on (SSO) for authentication to {% data variables.product.product_name %}, you must configure both your external SAML identity provider (IdP) and {% ifversion ghes %}{% data variables.product.product_location %}{% elsif ghec %}your enterprise or organization on {% data variables.product.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.product_name %}{% endif %}. In a SAML configuration, {% data variables.product.product_name %} functions as a SAML service provider (SP).
|
||||
|
||||
You must enter unique values from your SAML IdP when configuring SAML SSO for {% data variables.product.product_name %}, and you must also enter unique values from {% data variables.product.product_name %} on your IdP. For more information about the configuration of SAML SSO for {% data variables.product.product_name %}, see "[Configuring SAML single sign-on for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise){% ifversion ghes or ghae %}{% elsif ghec %}" or "[Enabling and testing SAML single sign-on for your organization](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization){% endif %}."
|
||||
|
||||
## Metadatos SAML
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
The SP metadata for {% data variables.product.product_name %} is available for either organizations or enterprises with SAML SSO. {% data variables.product.product_name %} uses the `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` binding.
|
||||
|
||||
### Organizaciones
|
||||
|
||||
You can configure SAML SSO for an individual organization in your enterprise. You can also configure SAML SSO for an organization if you use an individual organization on {% data variables.product.product_name %} and do not use an enterprise account. For more information, see "[Managing SAML single sign-on for your organization](/organizations/managing-saml-single-sign-on-for-your-organization)."
|
||||
|
||||
The SP metadata for an organization on {% data variables.product.product_location %} is available at `https://github.com/orgs/ORGANIZATION/saml/metadata`, where **ORGANIZATION** is the name of your organization on {% data variables.product.product_location %}.
|
||||
|
||||
| Valor | Otros nombres | Descripción | Ejemplo |
|
||||
|:--------------------------------------------------------- |:------------------------------------ |:---------------------------------------------------------------------------------------- |:--------------------------------------------------- |
|
||||
| ID de Entidad de SP | SP URL, audience restriction | The top-level URL for your organization on {% data variables.product.product_location %} | `https://github.com/orgs/ORGANIZATION` |
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | Reply, recipient, or destination URL | URL a la que el IdP enviará respuestas de SAML | `https://github.com/orgs/ORGANIZATION/saml/consume` |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | `https://github.com/orgs/ORGANIZATION/saml/sso` |
|
||||
|
||||
### Enterprises
|
||||
|
||||
The SP metadata for an enterprise on {% data variables.product.product_location %} is available at `https://github.com/enterprises/ENTERPRISE/saml/metadata`, where **ENTERPRISE** is the name of your enterprise on {% data variables.product.product_location %}.
|
||||
|
||||
| Valor | Otros nombres | Descripción | Ejemplo |
|
||||
|:--------------------------------------------------------- |:------------------------------------ |:-------------------------------------------------------------------------------------- |:-------------------------------------------------------- |
|
||||
| ID de Entidad de SP | SP URL, audience restriction | The top-level URL for your enterprise on {% data variables.product.product_location %} | `https://github.com/enterprises/ENTERPRISE` |
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | Reply, recipient, or destination URL | URL a la que el IdP enviará respuestas de SAML | `https://github.com/enterprises/ENTERPRISE/saml/consume` |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | `https://github.com/enterprises/ENTERPRISE/saml/sso` |
|
||||
|
||||
{% elsif ghes %}
|
||||
|
||||
The SP metadata for {% data variables.product.product_location %} is available at `http(s)://HOSTNAME/saml/metadata`, where **HOSTNAME** is the hostname for your instance. {% data variables.product.product_name %} uses the `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` binding.
|
||||
|
||||
| Valor | Otros nombres | Descripción | Ejemplo |
|
||||
|:--------------------------------------------------------- |:------------------------------------ |:---------------------------------------------------------------- |:--------------------------------- |
|
||||
| ID de Entidad de SP | SP URL, audience restriction | Your top-level URL for {% data variables.product.product_name %} | `http(s)://HOSTNAME` |
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | Reply, recipient, or destination URL | URL a la que el IdP enviará respuestas de SAML | `http(s)://HOSTNAME/saml/consume` |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | `http(s)://HOSTNAME/sso` |
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
The SP metadata for your enterprise on {% data variables.product.product_name %} is available at `https://HOSTNAME/saml/metadata`, where **HOSTNAME** is the hostname for your enterprise on {% data variables.product.product_name %}. {% data variables.product.product_name %} uses the `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` binding.
|
||||
|
||||
| Valor | Otros nombres | Descripción | Ejemplo |
|
||||
|:--------------------------------------------------------- |:------------------------------------ |:---------------------------------------------------------------- |:------------------------------- |
|
||||
| ID de Entidad de SP | SP URL, audience restriction | Your top-level URL for {% data variables.product.product_name %} | `https://HOSTNAME` |
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | Reply, recipient, or destination URL | URL a la que el IdP enviará respuestas de SAML | `https://HOSTNAME/saml/consume` |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | `https://HOSTNAME/sso` |
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Atributos de SAML
|
||||
|
||||
The following SAML attributes are available for {% data variables.product.product_name %}.{% ifversion ghes %} You can change the attribute names in the management console, with the exception of the `administrator` attribute. For more information, see "[Accessing the management console](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)."{% endif %}
|
||||
|
||||
| Nombre | Required? | Descripción |
|
||||
|:--------------------- |:--------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ID del nombre` | Sí | Un identificador de usuario persistente. Se puede usar cualquier formato de identificador de nombre persistente. {% ifversion ghec %}If you use an enterprise with {% data variables.product.prodname_emus %}, {% endif %}{% data variables.product.product_name %} will normalize the `NameID` element to use as a username unless one of the alternative assertions is provided. For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)." |
|
||||
| `SessionNotOnOrAfter` | No | The date that {% data variables.product.product_name %} invalidates the associated session. After invalidation, the person must authenticate once again to access {% ifversion ghec or ghae %}your enterprise's resources{% elsif ghes %}{% data variables.product.product_location %}{% endif %}. For more information, see "[Session duration and timeout](#session-duration-and-timeout)." |
|
||||
{%- ifversion ghes or ghae %}
|
||||
| `administrator` | No | When the value is `true`, {% data variables.product.product_name %} will automatically promote the user to be a {% ifversion ghes %}site administrator{% elsif ghae %}enterprise owner{% endif %}. Any other value or a non-existent value will demote the account and remove administrative access. | | `username` | No | The username for {% data variables.product.product_location %}. |
|
||||
{%- endif %}
|
||||
| `full_name` | No | {% ifversion ghec %}If you configure SAML SSO for an enterprise and you use {% data variables.product.prodname_emus %}, the{% else %}The{% endif %} full name of the user to display on the user's profile page. | | `emails` | No | The email addresses for the user.{% ifversion ghes or ghae %} You can specify more than one address.{% endif %}{% ifversion ghec or ghes %} If you sync license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_github_connect %} uses `emails` to identify unique users across products. For more information, see "[Syncing license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}](/billing/managing-your-license-for-github-enterprise/syncing-license-usage-between-github-enterprise-server-and-github-enterprise-cloud)."{% endif %} | | `public_keys` | No | {% ifversion ghec %}If you configure SAML SSO for an enterprise and you use {% data variables.product.prodname_emus %}, the{% else %}The{% endif %} public SSH keys for the user. You can specify more than one key. | | `gpg_keys` | No | {% ifversion ghec %}If you configure SAML SSO for an enterprise and you use {% data variables.product.prodname_emus %}, the{% else %}The{% endif %} GPG keys for the user. You can specify more than one key. |
|
||||
|
||||
Para especificar más de un valor para un atributo, utiliza elementos múltiples de `<saml2:AttributeValue>`.
|
||||
|
||||
```xml
|
||||
<saml2:Attribute FriendlyName="public_keys" Name="urn:oid:1.2.840.113549.1.1.1" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
|
||||
<saml2:AttributeValue>ssh-rsa LONG KEY</saml2:AttributeValue>
|
||||
<saml2:AttributeValue>ssh-rsa LONG KEY 2</saml2:AttributeValue>
|
||||
</saml2:Attribute>
|
||||
```
|
||||
|
||||
## SAML response requirements
|
||||
|
||||
{% data variables.product.product_name %} requires that the response message from your IdP fulfill the following requirements.
|
||||
|
||||
- Your IdP must provide the `<Destination>` element on the root response document and match the ACS URL only when the root response document is signed. If your IdP signs the assertion, {% data variables.product.product_name %} will ignore the assertion.
|
||||
- Your IdP must always provide the `<Audience>` element as part of the `<AudienceRestriction>` element. The value must match your `EntityId` for {% data variables.product.product_name %}.{% ifversion ghes or ghae %} This value is the URL where you access {% data variables.product.product_location %}, such as {% ifversion ghes %}`http(s)://HOSTNAME`{% elsif ghae %}`https://SUBDOMAIN.githubenterprise.com`, `https://SUBDOMAIN.github.us`, or `https://SUBDOMAIN.ghe.com`{% endif %}.{% endif %}
|
||||
|
||||
{%- ifversion ghec %}
|
||||
- If you configure SAML for an organization, this value is `https://github.com/orgs/ORGANIZATION`.
|
||||
- If you configure SAML for an enterprise, this URL is `https://github.com/enterprises/ENTERPRISE`.
|
||||
{%- endif %}
|
||||
- Your IdP must protect each assertion in the response with a digital signature. You can accomplish this by signing each individual `<Assertion>` element or by signing the `<Response>` element.
|
||||
- Your IdP must provide a `<NameID>` element as part of the `<Subject>` element. You may use any persistent name identifier format.
|
||||
- Your IdP must include the `Recipient` attribute, which must be set to the ACS URL. The following example demonstrates the attribute.
|
||||
|
||||
```xml
|
||||
<samlp:Response ...>
|
||||
<saml:Assertion ...>
|
||||
<saml:Subject>
|
||||
<saml:NameID ...>...</saml:NameID>
|
||||
<saml:SubjectConfirmation ...>
|
||||
<saml:SubjectConfirmationData Recipient="https://{% ifversion ghec %}github.com/enterprises/ENTERPRISE{% elsif ghes %}HOSTNAME{% elsif ghae %}SUBDOMAIN.ghe.com{% endif %}/saml/consume" .../>
|
||||
</saml:SubjectConfirmation>
|
||||
</saml:Subject>
|
||||
<saml:AttributeStatement>
|
||||
<saml:Attribute FriendlyName="USERNAME-ATTRIBUTE" ...>
|
||||
<saml:AttributeValue>monalisa</saml:AttributeValue>
|
||||
</saml:Attribute>
|
||||
</saml:AttributeStatement>
|
||||
</saml:Assertion>
|
||||
</samlp:Response>
|
||||
```
|
||||
|
||||
## Session duration and timeout
|
||||
|
||||
To prevent a person from authenticating with your IdP and staying authorized indefinitely, {% data variables.product.product_name %} periodically invalidates the session for each user account with access to {% ifversion ghec or ghae %}your enterprise's resources{% elsif ghes %}{% data variables.product.product_location %}{% endif %}. After invalidation, the person must authenticate with your IdP once again. By default, if your IdP does not assert a value for the `SessionNotOnOrAfter` attribute, {% data variables.product.product_name %} invalidates a session {% ifversion ghec %}24 hours{% elsif ghes or ghae %}one week{% endif %} after successful authentication with your IdP.
|
||||
|
||||
To customize the session duration, you may be able to define the value of the `SessionNotOnOrAfter` attribute on your IdP. If you define a value less than 24 hours, {% data variables.product.product_name %} may prompt people to authenticate every time {% data variables.product.product_name %} initiates a redirect.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Notas**:
|
||||
|
||||
- For Azure AD, the configurable lifetime policy for SAML tokens does not control session timeout for {% data variables.product.product_name %}.
|
||||
- Okta does not currently send the `SessionNotOnOrAfter` attribute during SAML authentication with {% data variables.product.product_name %}. For more information, contact Okta.
|
||||
|
||||
{% endnote %}
|
||||
@@ -9,10 +9,11 @@ topics:
|
||||
- Enterprise
|
||||
- Organizations
|
||||
type: how_to
|
||||
shortTitle: Cambiar desde una organización
|
||||
shortTitle: From organization to enterprise
|
||||
redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
|
||||
---
|
||||
|
||||
## Acerca del inicio de sesión único de SAML para las cuentas empresariales
|
||||
@@ -41,4 +42,4 @@ No se te requiere eliminar ninguna configuración de SAML a nivel organizacional
|
||||
1. Notifica a los miembros de tu empresa sobre este cambio.
|
||||
- Los miembros ya no podrán acceder a las organizaciones si hacen clic en la app de SAML de la organización en el tablero del IdP. Necesitarán utilizar la app nueva que se configuró para la cuenta empresarial.
|
||||
- Los miembros necesitarán autorizar cualquier PAT o llave SSH que no se hayan autorizado antes para utilizarlos con el SSO de SAML en su organización. Para obtener más información, consulta las secciones "[Autorizar que un token de acceso personal se utilice con el inicio de sesión único de SAML](/github/authenticating-to-github/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)" y "[Autorizar a una llave SSH para que se utilice con el inicio de sesión único de SAML](/github/authenticating-to-github/authenticating-with-saml-single-sign-on/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)".
|
||||
- Los miembros podrían necesitar volver a autorizar las {% data variables.product.prodname_oauth_apps %} que se autorizaran anteriormente en la organización. Para obtener más información, consulta la sección "[Acerca de la autenticación con el inicio de sesión único de SAML](/github/authenticating-to-github/authenticating-with-saml-single-sign-on/about-authentication-with-saml-single-sign-on#about-oauth-apps-and-saml-sso)".
|
||||
- Los miembros podrían necesitar volver a autorizar las {% data variables.product.prodname_oauth_apps %} que se autorizaran anteriormente en la organización. Para obtener más información, consulta la sección "[Acerca de la autenticación con el inicio de sesión único de SAML](/github/authenticating-to-github/authenticating-with-saml-single-sign-on/about-authentication-with-saml-single-sign-on#about-oauth-apps-github-apps-and-saml-sso)".
|
||||
@@ -0,0 +1,102 @@
|
||||
---
|
||||
title: Autenticación SAML
|
||||
shortTitle: Troubleshoot SAML SSO
|
||||
intro: 'If you use SAML single sign-on (SSO) and people are unable to authenticate to access {% data variables.product.product_location %}, you can troubleshoot the problem.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- Security
|
||||
- SSO
|
||||
- Troubleshooting
|
||||
---
|
||||
|
||||
## About problems with SAML authentication
|
||||
|
||||
{% data variables.product.product_name %} logs error messages for failed SAML authentication in the authentication log at _/var/log/github/auth.log_. You can review responses in this log file, and you can also configure more verbose logging.
|
||||
|
||||
For more information about SAML response requirements, see "[SAML configuration reference](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference#saml-response-requirements)."
|
||||
|
||||
## Configurar la depuración de SAML
|
||||
|
||||
Puedes configurar {% data variables.product.product_name %} para escribir bitácoras de depuración verbosas en _/var/log/github/auth.log_ para cada intento de autenticación de SAML. Es posible que puedas solucionar los problemas de los intentos de autenticación fallidos con esta salida adicional.
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Advertencias**:
|
||||
|
||||
- Habilita la depuración de SAML solo temporalmente e inhabilita la depuración inmediatamente después de que termines de solucionar los problemas. Si dejas habilitada la depuración, el tamaño de tu bitácora podría incrementarse mucho más rápido de lo habitual, lo cual podría impactar negativamente el rendimiento de {% data variables.product.product_name %}.
|
||||
- Prueba los ajustes de autenticación nuevos de {% data variables.product.product_location %} en un ambiente de pruebas antes de aplicar los ajustes en tu ambiente de producción. Para obtener más información, consulta "[Configurar una instancia de preparación](/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance)."
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.policies-tab %}
|
||||
{% data reusables.enterprise-accounts.options-tab %}
|
||||
1. Debajo de "depuración de SAML", selecciona el menú desplegable y haz clic en **Habilitado**.
|
||||
|
||||
|
||||
|
||||
1. Intenta iniciar sesión en {% data variables.product.product_location %} mediante tu IdP de SAML.
|
||||
|
||||
1. Revisa la salida de depuración en _/var/log/github/auth.log_ en {% data variables.product.product_location %}.
|
||||
|
||||
1. Cuando termines de solucionar los problemas, selecciona el menú desplegable y haz clic en **Inhabilitado**.
|
||||
|
||||
|
||||
|
||||
## Decodificar respuestas en _auth.log_
|
||||
|
||||
Alguna salida en _auth.log_ podría estar cifrada en Base64. Puedes acceder al shell administrativo y utilizar la utilidad de `base64` en {% data variables.product.product_location %} para decodificar estas respuestas. Para obtener más información, consulta "[Acceder al shell administrativo (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)".
|
||||
|
||||
```shell
|
||||
$ base64 --decode <em>ENCODED OUTPUT</em>
|
||||
```
|
||||
|
||||
## Error: "Another user already owns the account"
|
||||
|
||||
When a user signs into {% data variables.product.product_location %} for the first time with SAML authentication, {% data variables.product.product_name %} creates a user account on the instance and maps the SAML `NameID` to the account.
|
||||
|
||||
Cuando el usuario vuelve a ingresar, {% data variables.product.prodname_ghe_server %} compara el mapeo de la `NameID` de la cuenta con la respuesta del IdP. Si la `NameID` en la respuesta del IdP ya no empata con la `NameID` que {% data variables.product.product_name %} espera para el usuario, el inicio de sesión fallará. El usuario verá el siguiente mensaje.
|
||||
|
||||
> Another user already owns the account. Please have your administrator check the authentication log.
|
||||
|
||||
Este mensaje habitualmente indica que el nombre de usuario o dirección de correo electrónico cambió en el IdP. Asegúrate de que el mapeo de la `NameID` de la cuenta de usuario de {% data variables.product.prodname_ghe_server %} coincida con la `NameID` en tu IdP. For more information, see "[Updating a user's SAML `NameID`](/admin/identity-and-access-management/using-saml-for-enterprise-iam/updating-a-users-saml-nameid)."
|
||||
|
||||
## Si la respuesta SAML no está firmada o la firma no coincide con los contenidos, se presentará el siguiente mensaje de error en el registro de autenticación:
|
||||
|
||||
Si el `Recipient` no empata con la URL de ACS para {% data variables.product.product_location %}, uno de los siguientes dos mensajes de error se mostrará en la bitácora de autenticación cuando un usuario intenta autenticarse.
|
||||
|
||||
```
|
||||
El destinatario en la respuesta SAML no debe estar en blanco.
|
||||
```
|
||||
|
||||
```
|
||||
El destinatario en la respuesta SAML no era válido.
|
||||
```
|
||||
|
||||
Asegúrate de que hayas configurado el valor de `Recipient` en tu IdP en la URL completa de ACS para {% data variables.product.product_location %}. Por ejemplo, `https://ghe.corp.example.com/saml/consume`.
|
||||
|
||||
## Error: "SAML Response is not signed or has been modified"
|
||||
|
||||
Si tu IdP no firma la respuesta de SAML, o si la firma no empata con el contenido, se mostrará el siguiente mensaje de error en la bitácora de autenticación.
|
||||
|
||||
```
|
||||
SAML Response is not signed or has been modified.
|
||||
```
|
||||
|
||||
Asegúrate de haber configurado aserciones firmadas para la aplicación de {% data variables.product.product_name %} en tu IdP.
|
||||
|
||||
## Error: "Audience is invalid" or "No assertion found"
|
||||
|
||||
Si la respuesta del IdP carece o tiene un valor incorrecto para `Audience`, se mostrará el siguiente mensaje de error en la bitácora de autenticación.
|
||||
|
||||
```
|
||||
La audiencia es no válida. Audience attribute does not match https://<em>YOUR-INSTANCE-URL</em>
|
||||
```
|
||||
|
||||
Ensure that you set the value for `Audience` on your IdP to the `EntityId` for {% data variables.product.product_location %}, which is the full URL to your instance. Por ejemplo, `https://ghe.corp.example.com`.
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Updating a user's SAML NameID
|
||||
shortTitle: Update SAML NameID
|
||||
intro: 'When an account''s `NameID` changes on your identity provider (IdP) and the person can no longer {% ifversion ghes or ghae %}sign into {% data variables.product.product_location %}{% elsif ghec %}authenticate to access your enterprise''s resources{% endif %}, you must {% ifversion ghec %}either contact {% data variables.product.company_short %} Support or revoke the person''s linked identity{% elsif ghes %}update the `NameID` mapping on {% data variables.product.product_location %}{% elsif ghae %}contact {% data variables.product.company_short %} Support{% endif %}.'
|
||||
versions:
|
||||
ghes: '*'
|
||||
type: how_to
|
||||
topics:
|
||||
- Accounts
|
||||
- Authentication
|
||||
- Enterprise
|
||||
- Identity
|
||||
- SSO
|
||||
---
|
||||
|
||||
## About updates to users' SAML `NameID`
|
||||
|
||||
In some situations, you may need to update values associated with a person's account on your SAML IdP. If that identifier is also the `NameID` that you use for authentication on {% data variables.product.product_name %}, you must update the `NameID` mapping on your instance so the person can continue to authenticate successfully. For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)."
|
||||
|
||||
## Actualizar la `NameID` de SAML de un usuario
|
||||
|
||||
Enterprise owners can update a user's SAML `NameID` on a {% data variables.product.product_name %} instance.
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
2. Selecciona **SAML**. 
|
||||
3. En la lista de usuarios, da clic en el nombre de usuario del cual te gustaría actualizar el mapeo de la `NameID`. 
|
||||
{% data reusables.enterprise_site_admin_settings.security-tab %}
|
||||
5. To the right of "Update SAML NameID", click **Edit** . 
|
||||
6. En el campo de "NameID", teclea la `NameID` nueva para el usuario. 
|
||||
7. Da clic en **Actualizar NameID**. 
|
||||
@@ -65,6 +65,7 @@ redirect_from:
|
||||
- /admin/configuration/configuring-your-enterprise/configuring-data-encryption-for-your-enterprise
|
||||
introLinks:
|
||||
overview: '{% ifversion ghes %}/admin/overview/system-overview{% elsif ghae %}/admin/overview/about-github-ae{% elsif ghec %}/admin/overview/about-enterprise-accounts{% endif %}'
|
||||
Releases: '{% ifversion ghes %}/admin/all-releases{% endif %}'
|
||||
changelog:
|
||||
label: enterprise
|
||||
featuredLinks:
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Configurar una instancia de preparación
|
||||
intro: 'Puedes utilizar una *instancia de preparación* para probar las modificaciones antes de que se apliquen a {% data variables.product.product_location %}. Por ejemplo, podrías utilizar una instancia de preparación para probar nuevas actualizaciones del {% data variables.product.prodname_ghe_server %} o para practicar importar datos de migración.'
|
||||
intro: 'You can set up a {% data variables.product.product_name %} instance in a separate, isolated environment, and use the instance to validate and test changes.'
|
||||
redirect_from:
|
||||
- /enterprise/admin/installation/setting-up-a-staging-instance
|
||||
- /admin/installation/setting-up-a-staging-instance
|
||||
@@ -14,26 +14,35 @@ topics:
|
||||
shortTitle: Configurar una instancia de pruebas
|
||||
---
|
||||
|
||||
## About staging instances
|
||||
|
||||
{% data variables.product.company_short %} recommends that you set up a separate environment to test backups, updates, or changes to the configuration for {% data variables.product.product_location %}. This environment, which you should isolate from your production systems, is called a staging environment.
|
||||
|
||||
For example, to protect against loss of data, you can regularly validate the backup of your production instance. You can regularly restore the backup of your production data to a separate {% data variables.product.product_name %} instance in a staging environment. On this staging instance, you could also test the upgrade to the latest feature release of {% data variables.product.product_name %}.
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Sugerencia:** puedes volver a usar tu archivo de licencia existente de {% data variables.product.prodname_enterprise %} siempre que la instancia de preparación no se use para producción.
|
||||
**Tip:** You may reuse your existing {% data variables.product.prodname_enterprise %} license file as long as the staging instance is not used in a production capacity.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
Para probar en profundidad un aparato del {% data variables.product.prodname_ghe_server %} deberás considerar los sistemas externos que interactúan con este. Algunos factores que considerar probar son:
|
||||
## Considerations for a staging environment
|
||||
|
||||
- La autenticación, en especial si se está usando un proveedor externo de autenticación
|
||||
- La integración con un sistema externo de vales
|
||||
- La integración con un servidor de integración continua
|
||||
- Los scripts externos o el software que usan {% data variables.product.prodname_enterprise_api %}
|
||||
- El servidor externo SMTP para notificaciones por correo electrónico
|
||||
To thoroughly test {% data variables.product.product_name %} and recreate an environment that's as similar to your production environment as possible, consider the external systems that interact with your instance. For example, you may want to test the following in your staging environment.
|
||||
|
||||
- Authentication, especially if you use an external authentication provider like SAML
|
||||
- La integración con un sistema externo de vales
|
||||
- La integración con un servidor de integración continua
|
||||
- Los scripts externos o el software que usan {% data variables.product.prodname_enterprise_api %}
|
||||
- El servidor externo SMTP para notificaciones por correo electrónico
|
||||
|
||||
## Configurar una instancia de preparación
|
||||
|
||||
1. Realiza una copia de seguridad de tu instancia de producción utilizando {% data variables.product.prodname_enterprise_backup_utilities %}. Para obtener más información, consulta la sección "Acerca de {% data variables.product.prodname_enterprise_backup_utilities %}" en "[Configurar copias de seguridad en tu aparato](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance#about-github-enterprise-server-backup-utilities)."
|
||||
2. Configura una nueva instancia para que actúe como tu entorno de preparación. Puedes utilizar las mismas guías para aprovisionar e instalar tu instancia de preparación como hiciste para tu instancia de producción. Para obtener más información, consulta "[Configurar una instancia del {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/installation/setting-up-a-github-enterprise-server-instance/)."
|
||||
3. Restaura tu copia de seguridad a tu instancia de preparación. Para obtener más información, consulta la sección "Restaurar una copia de seguridad" en "[Configurar copias de seguridad en tu aparato](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance#restoring-a-backup)."
|
||||
3. Optionally, if you plan to test {% data variables.product.prodname_actions %} functionality in your test environment, review the considerations for your logs and storage. For more information, see "[Using a staging environment](/admin/github-actions/advanced-configuration-and-troubleshooting/using-a-staging-environment)."
|
||||
4. Restaura tu copia de seguridad a tu instancia de preparación. Para obtener más información, consulta la sección "Restaurar una copia de seguridad" en "[Configurar copias de seguridad en tu aparato](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance#restoring-a-backup)."
|
||||
|
||||
{% ifversion ghes %}
|
||||
## Leer más
|
||||
|
||||
- "[Acerca de las mejoras a los lanzamientos nuevos](/admin/overview/about-upgrades-to-new-releases)"
|
||||
{% endif %}
|
||||
|
||||
@@ -24,7 +24,7 @@ topics:
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
Your enterprise account on {% data variables.product.prodname_dotcom_the_website %} allows you to manage multiple organizations. Your enterprise account must have a handle, like an organization or personal account on {% data variables.product.prodname_dotcom %}.
|
||||
Your enterprise account on {% data variables.product.prodname_dotcom_the_website %} allows you to manage multiple organizations. Your enterprise account must have a handle, like an organization or user account on {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
{% elsif ghes or ghae %}
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@ topics:
|
||||
---
|
||||
{% ifversion ghes < 3.3 %}{% data reusables.enterprise.upgrade-ghes-for-features %}{% endif %}
|
||||
|
||||
{% data variables.product.product_name %} is constantly improving, with new functionality and bug fixes introduced through feature and patch releases. {% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %}
|
||||
{% data reusables.enterprise.constantly-improving %}{% ifversion ghae %}{% data variables.product.prodname_ghe_managed %} is a fully managed service, so {% data variables.product.company_short %} completes the upgrade process for your enterprise.{% endif %}
|
||||
|
||||
Feature releases include new functionality and feature upgrades and typically occur quarterly. {% ifversion ghae %}{% data variables.product.company_short %} will upgrade your enterprise to the latest feature release. You will be given advance notice of any planned downtime for your enterprise.{% endif %}
|
||||
|
||||
|
||||
@@ -124,7 +124,7 @@ El {% data variables.product.prodname_ghe_server %} proporciona cuatro métodos
|
||||
|
||||
- La autenticación de claves públicas SSH proporciona acceso del repositorio usando Git y el shell administrativo. Para obtener más información, consulta "[Acerca de SSH](/authentication/connecting-to-github-with-ssh/about-ssh)" y "[Acceder al shell administrativo (SSH)](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)."
|
||||
- El nombre de usuario y la autenticación de contraseña con cookies HTTP proporciona acceso a la aplicación web y la gestión de sesiones, con autenticación opcional de dos factores (2FA). Para obtener más información, consulta ña sección "[Utilizar la autenticación integrada](/admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-built-in-authentication)".
|
||||
- La autenticación externa LDAP, SAML o CAS mediante un servicio LDAP, SAML Identity Provider (IdP) u otro servicio compatible proporciona acceso a la aplicación web. Para más información, consulta "[Autenticar usuarios para tu instancia de servidor de GitHub Enterprise](/admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance)."
|
||||
- La autenticación externa LDAP, SAML o CAS mediante un servicio LDAP, SAML Identity Provider (IdP) u otro servicio compatible proporciona acceso a la aplicación web. Para obtener más información, consulta la sección "[Administrar el IAM para tu empresa](/admin/identity-and-access-management/managing-iam-for-your-enterprise)".
|
||||
- OAuth y los token de acceso personal proporcionan acceso a los datos del repositorio de Git y a API para clientes externos y servicios. Para obtener más información, consulta la sección "[Crear un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)".
|
||||
|
||||
### Auditoría y registro de acceso
|
||||
|
||||
@@ -31,7 +31,7 @@ You can enforce policies to control the security settings for organizations owne
|
||||
|
||||
## Requiring two-factor authentication for organizations in your enterprise
|
||||
|
||||
Enterprise owners can require that organization members, billing managers, and outside collaborators in all organizations owned by an enterprise use two-factor authentication to secure their personal accounts.
|
||||
Enterprise owners can require that organization members, billing managers, and outside collaborators in all organizations owned by an enterprise use two-factor authentication to secure their user accounts.
|
||||
|
||||
Before you can require 2FA for all organizations owned by your enterprise, you must enable two-factor authentication for your own account. For more information, see "[Securing your account with two-factor authentication (2FA)](/articles/securing-your-account-with-two-factor-authentication-2fa/)."
|
||||
|
||||
@@ -39,9 +39,9 @@ Before you can require 2FA for all organizations owned by your enterprise, you m
|
||||
|
||||
**Warnings:**
|
||||
|
||||
- When you require two-factor authentication for your enterprise, members, outside collaborators, and billing managers (including bot accounts) in all organizations owned by your enterprise who do not use 2FA will be removed from the organization and lose access to its repositories. They will also lose access to their forks of the organization's private repositories. You can reinstate their access privileges and settings if they enable two-factor authentication for their personal account within three months of their removal from your organization. For more information, see "[Reinstating a former member of your organization](/articles/reinstating-a-former-member-of-your-organization)."
|
||||
- Any organization owner, member, billing manager, or outside collaborator in any of the organizations owned by your enterprise who disables 2FA for their personal account after you've enabled required two-factor authentication will automatically be removed from the organization.
|
||||
- If you're the sole owner of a enterprise that requires two-factor authentication, you won't be able to disable 2FA for your personal account without disabling required two-factor authentication for the enterprise.
|
||||
- When you require two-factor authentication for your enterprise, members, outside collaborators, and billing managers (including bot accounts) in all organizations owned by your enterprise who do not use 2FA will be removed from the organization and lose access to its repositories. They will also lose access to their forks of the organization's private repositories. You can reinstate their access privileges and settings if they enable two-factor authentication for their account within three months of their removal from your organization. For more information, see "[Reinstating a former member of your organization](/articles/reinstating-a-former-member-of-your-organization)."
|
||||
- Any organization owner, member, billing manager, or outside collaborator in any of the organizations owned by your enterprise who disables 2FA for their account after you've enabled required two-factor authentication will automatically be removed from the organization.
|
||||
- If you're the sole owner of a enterprise that requires two-factor authentication, you won't be able to disable 2FA for your user account without disabling required two-factor authentication for the enterprise.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
|
||||
@@ -61,10 +61,10 @@ shortTitle: Administración de proyectos con Jira
|
||||
|
||||
5. En el modal **Add New Account** (Agregar nueva cuenta), completa tus parámetros de {% data variables.product.prodname_enterprise %}:
|
||||
- Desde el menú desplegable de **Host**, elige **{% data variables.product.prodname_enterprise %}**.
|
||||
- En el campo **Team or User Account** (Cuenta de equipo o usuario), escribe el nombre de tu organización {% data variables.product.prodname_enterprise %} o cuenta personal.
|
||||
- In the **Team or User Account** field, type the name of your {% data variables.product.prodname_enterprise %} organization or user account.
|
||||
- En el campo **OAuth Key** (Clave OAuth), escribe el ID de cliente de tu aplicación de programador de {% data variables.product.prodname_enterprise %}.
|
||||
- En el campo **OAuth Secret** (OAuth secreto), escribe el secreto de cliente para tu aplicación de programador de {% data variables.product.prodname_enterprise %}.
|
||||
- Si no quieres enlazar los repositorios nuevos que pertenecen a tu organización o cuenta personal de {% data variables.product.prodname_enterprise %}, quita la marca de selección de **Enlazar los repositorios nuevos automáticamente**.
|
||||
- If you don't want to link new repositories owned by your {% data variables.product.prodname_enterprise %} organization or user account, deselect **Auto Link New Repositories**.
|
||||
- Si no quieres habilitar las confirmaciones inteligentes, deselecciona **Habilitar las confirmaciones inteligentes**.
|
||||
- Da clic en **Agregar**.
|
||||
6. Revisa los permisos que concedes a tu cuenta de {% data variables.product.prodname_enterprise %} y haz clic en **Authorize application** (Autorizar aplicación).
|
||||
|
||||
@@ -24,7 +24,7 @@ You can choose to join an organization owned by your enterprise as a member or a
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning**: If an organization uses SCIM to provision users, joining the organization this way could have unintended consequences. Para obtener más información, consulta la sección "[Acerca de SCIM](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim)".
|
||||
**Warning**: If an organization uses SCIM to provision users, joining the organization this way could have unintended consequences. For more information, see "[About SCIM for organizations](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)."
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
@@ -32,7 +32,7 @@ You can choose to join an organization owned by your enterprise as a member or a
|
||||
|
||||
You can join an organization owned by your enterprise and manage your role within the organization, directly from the settings for your enterprise account.
|
||||
|
||||
If an organization enforces SAML single sign-on (SSO), you cannot use the enterprise settings to join the organization. Instead, you must join the organization using that organization's identity provider (IdP). Then, you can manage your role in your enterprise settings. For more information, see "[Joining an organization that enforces SAML SSO](#joining-an-organization-that-enforces-saml-sso)."
|
||||
If an organization enforces SAML single sign-on (SSO), you cannot use the enterprise settings to join the organization. En vez de esto, debes unirte a la organización utilizando su proveedor de identidad (IdP). Then, you can manage your role in your enterprise settings. For more information, see "[Joining an organization that enforces SAML SSO](#joining-an-organization-that-enforces-saml-sso)."
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
1. On the **Organizations** tab, to the right of the organization you want to manage your role in, select the {% octicon "gear" aria-label="The gear icon" %} dropdown menu and click the action you want to take.
|
||||
|
||||
@@ -46,11 +46,13 @@ Si no tienes un token de acceso personal ni una clave SSH, puedes crear un token
|
||||
|
||||
Para utilizar un token de acceso personal existente o nuevo o una llave SSH con la organización que utiliza o requiere el SSO de SAML, necesitarás autorizar el token o la llave SSH para que se utilicen con una organización que maneje el SSO de SAML. Para obtener más información, consulta "[Autorizar un token de acceso personal para utilizarlo con el inicio de sesión único de SAML](/articles/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)" o "[Autorizar una llave SSH para su uso con el inicio de sesión único de SAML](/articles/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)."
|
||||
|
||||
## Acerca de {% data variables.product.prodname_oauth_apps %} y del SSO de SAML
|
||||
## About {% data variables.product.prodname_oauth_apps %}, {% data variables.product.prodname_github_apps %}, and SAML SSO
|
||||
|
||||
Debes tener una sesión de SAML activa cada vez que autorices a una {% data variables.product.prodname_oauth_app %} para que acceda a una organización que utilice o requiera el SSO de SAML.
|
||||
You must have an active SAML session each time you authorize an {% data variables.product.prodname_oauth_app %} or {% data variables.product.prodname_github_app %} to access an organization that uses or enforces SAML SSO. You can create an active SAML session by navigating to `https://github.com/orgs/ORGANIZATION-NAME/sso` in your browser.
|
||||
|
||||
Después de que un propietario de empresa u organización habilite o requiera el SSO de SAML para su organización, debes volver a autorizar a cualquier {% data variables.product.prodname_oauth_app %} que hayas autorizado antes para que acceda a dicha organización. Para ver las {% data variables.product.prodname_oauth_apps %} que autorizaste o para volver a autorizar alguna {% data variables.product.prodname_oauth_app %}, visita tu [página de {% data variables.product.prodname_oauth_apps %}](https://github.com/settings/applications).
|
||||
After an enterprise or organization owner enables or enforces SAML SSO for an organization, and after you authenticate via SAML for the first time, you must reauthorize any {% data variables.product.prodname_oauth_apps %} or {% data variables.product.prodname_github_apps %} that you previously authorized to access the organization.
|
||||
|
||||
To see the {% data variables.product.prodname_oauth_apps %} you've authorized, visit your [{% data variables.product.prodname_oauth_apps %} page](https://github.com/settings/applications). To see the {% data variables.product.prodname_github_apps %} you've authorized, visit your [{% data variables.product.prodname_github_apps %} page](https://github.com/settings/apps/authorizations).
|
||||
|
||||
{% endif %}
|
||||
|
||||
|
||||
@@ -52,6 +52,7 @@ Los propietarios de las organizaciones pueden administrar el límite de gastos d
|
||||
{% data reusables.dotcom_billing.monthly-spending-limit-actions-packages %}
|
||||
{% data reusables.dotcom_billing.update-spending-limit %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Administrar el límite de gastos de {% data variables.product.prodname_actions %} para tu cuenta empresarial
|
||||
|
||||
Los propietarios de la empresa y gerentes de facturación pueden administrar el límite de gastos para {% data variables.product.prodname_actions %} para una cuenta empresarial.
|
||||
@@ -62,7 +63,7 @@ Los propietarios de la empresa y gerentes de facturación pueden administrar el
|
||||
1. Sobre "uso mensual de paquetes y {% data variables.product.prodname_actions %}", haz clic en **Límite de gastos**. 
|
||||
{% data reusables.dotcom_billing.monthly-spending-limit %}
|
||||
{% data reusables.dotcom_billing.update-spending-limit %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Administrar las notificaciones de uso y límite de gastos
|
||||
{% data reusables.billing.email-notifications %}
|
||||
|
||||
@@ -37,6 +37,7 @@ Los propietarios de la organización y gerentes de facturación pueden ver el us
|
||||
{% data reusables.dotcom_billing.actions-packages-storage %}
|
||||
{% data reusables.dotcom_billing.actions-packages-report-download-org-account %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Visualizar el uso de {% data variables.product.prodname_actions %} para tu cuenta empresarial
|
||||
|
||||
Los propietarios de empresa y gerentes de facturación pueden ver el uso de {% data variables.product.prodname_actions %} para una cuenta empresarial.
|
||||
@@ -53,3 +54,4 @@ Los propietarios de empresa y gerentes de facturación pueden ver el uso de {% d
|
||||
1. Debajo de "{% data variables.product.prodname_actions %}", visualiza los detalles de uso para transferencia de datos de cada organización en tu cuenta empresarial. 
|
||||
{% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %}
|
||||
{% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %}
|
||||
{% endif %}
|
||||
|
||||
@@ -25,6 +25,10 @@ shortTitle: View Advanced Security usage
|
||||
|
||||
{% data reusables.advanced-security.about-ghas-license-seats %} For more information, see "[About billing for {% data variables.product.prodname_GH_advanced_security %}](/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security)."
|
||||
|
||||
{% if ghas-committers-calculator %}
|
||||
You can calculate how many additional seats will be used if you enable {% data variables.product.prodname_GH_advanced_security %} for more organizations and repositories with the site admin dashboard. For more information, see "[Site admin dashboard](/admin/configuration/configuring-your-enterprise/site-admin-dashboard#advanced-security-active-committers)."
|
||||
{% endif %}
|
||||
|
||||
## Viewing {% data variables.product.prodname_GH_advanced_security %} license usage for your enterprise account
|
||||
|
||||
You can check how many seats your license includes and how many of them are currently used.
|
||||
|
||||
@@ -38,6 +38,7 @@ Los propietarios de las organizaciones pueden administrar el límite de gastos d
|
||||
{% data reusables.dotcom_billing.monthly-spending-limit-codespaces %}
|
||||
{% data reusables.dotcom_billing.update-spending-limit %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Administrar el límite de gastos de {% data variables.product.prodname_codespaces %} para tu cuenta empresarial
|
||||
|
||||
Los propietarios de la empresa y gerentes de facturación pueden administrar el límite de gastos para {% data variables.product.prodname_codespaces %} para una cuenta empresarial.
|
||||
@@ -48,6 +49,7 @@ Los propietarios de la empresa y gerentes de facturación pueden administrar el
|
||||
1. Sobre "Uso mensual de {% data variables.product.prodname_codespaces %}", haz clic en **Límite de gastos**. 
|
||||
{% data reusables.dotcom_billing.monthly-spending-limit %}
|
||||
{% data reusables.dotcom_billing.update-spending-limit %}
|
||||
{% endif %}
|
||||
|
||||
## Exportar cambios cuando llegaste a tu límite de gastos
|
||||
|
||||
|
||||
@@ -21,6 +21,7 @@ Los propietarios de la organización y gerentes de facturación pueden ver el us
|
||||
{% data reusables.dotcom_billing.codespaces-minutes %}
|
||||
{% data reusables.dotcom_billing.actions-packages-report-download-org-account %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Visualizar el uso de {% data variables.product.prodname_codespaces %} para tu cuenta empresarial
|
||||
|
||||
Los propietarios de empresa y gerentes de facturación pueden ver el uso de {% data variables.product.prodname_codespaces %} para una cuenta empresarial.
|
||||
@@ -30,4 +31,4 @@ Los propietarios de empresa y gerentes de facturación pueden ver el uso de {% d
|
||||
{% data reusables.enterprise-accounts.billing-tab %}
|
||||
1. Debajo de "{% data variables.product.prodname_codespaces %}", ve los detalles de uso de cada organización en tu cuenta empresarial.
|
||||
{% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -53,6 +53,7 @@ Los propietarios de las organizaciones pueden administrar el límite de gastos d
|
||||
{% data reusables.dotcom_billing.monthly-spending-limit-actions-packages %}
|
||||
{% data reusables.dotcom_billing.update-spending-limit %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Administrar el límite de gastos de {% data variables.product.prodname_registry %} para tu cuenta empresarial
|
||||
|
||||
Los propietarios de la empresa y gerentes de facturación pueden administrar el límite de gastos para {% data variables.product.prodname_registry %} para una cuenta empresarial.
|
||||
@@ -63,6 +64,7 @@ Los propietarios de la empresa y gerentes de facturación pueden administrar el
|
||||
1. Sobre "uso mensual de paquetes y {% data variables.product.prodname_actions %}", haz clic en **Límite de gastos**. 
|
||||
{% data reusables.dotcom_billing.monthly-spending-limit %}
|
||||
{% data reusables.dotcom_billing.update-spending-limit %}
|
||||
{% endif %}
|
||||
|
||||
## Administrar las notificaciones de uso y límite de gastos
|
||||
{% data reusables.billing.email-notifications %}
|
||||
|
||||
@@ -36,6 +36,7 @@ Los propietarios de la organización y gerentes de facturación pueden ver el us
|
||||
{% data reusables.dotcom_billing.actions-packages-storage %}
|
||||
{% data reusables.dotcom_billing.actions-packages-report-download-org-account %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
## Visualizar el uso de {% data variables.product.prodname_registry %} para tu cuenta empresarial
|
||||
|
||||
Los propietarios de empresa y gerentes de facturación pueden ver el uso de {% data variables.product.prodname_registry %} para una cuenta empresarial.
|
||||
@@ -52,3 +53,4 @@ Los propietarios de empresa y gerentes de facturación pueden ver el uso de {% d
|
||||
1. Debajo de "{% data variables.product.prodname_registry %}", visualiza los detalles de uso de transferencia de datos para cada organización en tu cuenta empresarial. 
|
||||
{% data reusables.dotcom_billing.actions-packages-storage-enterprise-account %}
|
||||
{% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %}
|
||||
{% endif %}
|
||||
|
||||
@@ -54,7 +54,7 @@ Puedes agregar más usuarios a tu organización{% ifversion ghec %} o empresa en
|
||||
|
||||
Si tienes dudas sobre tu suscripción, contacta al{% data variables.contact.contact_support %}.
|
||||
|
||||
Para apoyar aún más las capacidades de colaboración de tu equipo, puedes mejorar a {% data variables.product.prodname_ghe_cloud %}, el cual incluye características como las ramas protegidas y los propietarios de código en los repositorios privados. {% data reusables.enterprise.link-to-ghec-trial %}
|
||||
To further support your team's collaboration abilities, you can upgrade to {% data variables.product.prodname_ghe_cloud %}, which includes features like SAML single sign-on and advanced auditing. {% data reusables.enterprise.link-to-ghec-trial %}
|
||||
|
||||
Para obtener más información sobre los precios por usuario para {% data variables.product.prodname_ghe_cloud %}, consulta [la documentación de {% data variables.product.prodname_ghe_cloud %}](/enterprise-cloud@latest/billing/managing-billing-for-your-github-account/about-per-user-pricing).
|
||||
|
||||
|
||||
@@ -31,11 +31,11 @@ Account security is fundamental to the security of your supply chain. If an atta
|
||||
{% ifversion ghec %}
|
||||
If you're an enterprise or organization owner, you can configure centralized authentication with SAML. While you can add or remove members manually, it's simpler and more secure to set up single sign-on (SSO) and SCIM between {% data variables.product.product_name %} and your SAML identity provider (IdP). This also simplifies the authentication process for all members of your enterprise.
|
||||
|
||||
You can configure SAML authentication for an enterprise or organization account. With SAML, you can grant access to the personal accounts of members of your enterprise or organization on {% data variables.product.product_location %} through your IdP, or you can create and control the accounts that belong to your enterprise by using {% data variables.product.prodname_emus %}. For more information, see "[About identity and access management with SAML single sign-on](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)".
|
||||
You can configure SAML authentication for an enterprise or organization account. With SAML, you can grant access to the personal accounts of members of your enterprise or organization on {% data variables.product.product_location %} through your IdP, or you can create and control the accounts that belong to your enterprise by using {% data variables.product.prodname_emus %}. For more information, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise)."
|
||||
|
||||
After you configure SAML authentication, when members request access to your resources, they'll be directed to your SSO flow to ensure they are still recognized by your IdP. If they are unrecognized, their request is declined.
|
||||
|
||||
Some IdPs support a protocol called SCIM, which can automatically provision or deprovision access on {% data variables.product.product_name %} when you make changes on your IdP. With SCIM, you can simplify administration as your team grows, and you can quickly revoke access to accounts. SCIM is available for individual organizations on {% data variables.product.product_name %}, or for enterprises that use {% data variables.product.prodname_emus %}. Para obtener más información, consulta la sección "[Acerca de SCIM](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim)".
|
||||
Some IdPs support a protocol called SCIM, which can automatically provision or deprovision access on {% data variables.product.product_name %} when you make changes on your IdP. With SCIM, you can simplify administration as your team grows, and you can quickly revoke access to accounts. SCIM is available for individual organizations on {% data variables.product.product_name %}, or for enterprises that use {% data variables.product.prodname_emus %}. For more information, see "[About SCIM for organizations](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)."
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
@@ -43,7 +43,7 @@ If you're the site administrator for {% data variables.product.product_location
|
||||
|
||||
Some authentication methods also support communicating additional information to {% data variables.product.product_name %}, for example, what groups the user is a member of, or synchronizing cryptographic keys for the user. This is a great way to simplify your administration as your organization grows.
|
||||
|
||||
Para obtener más información sobre estos métodos de autenticación, consulta las secciones "[Utilizar CAS](/admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-cas)", "[Utilizar SAML](/admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-saml)" y "[Utilizar LDAP](/admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-ldap)".
|
||||
For more information about the authentication methods available for {% data variables.product.product_name %}, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise)."
|
||||
{% endif %}
|
||||
|
||||
## Configure two-factor authentication
|
||||
|
||||
@@ -43,7 +43,7 @@ The dependency graph is central to supply chain security. The dependency graph i
|
||||
Other supply chain features on {% data variables.product.prodname_dotcom %} rely on the information provided by the dependency graph.
|
||||
|
||||
- Dependency review uses the dependency graph to identify dependency changes and help you understand the security impact of these changes when you review pull requests.
|
||||
- {% data variables.product.prodname_dependabot %} cross-references dependency data provided by the dependency graph with the list of known vulnerabilities published in the {% data variables.product.prodname_advisory_database %}, scans your dependecies and generates {% data variables.product.prodname_dependabot_alerts %} when a potential vulnerability is detected.
|
||||
- {% data variables.product.prodname_dependabot %} cross-references dependency data provided by the dependency graph with the list of known vulnerabilities published in the {% data variables.product.prodname_advisory_database %}, scans your dependencies and generates {% data variables.product.prodname_dependabot_alerts %} when a potential vulnerability is detected.
|
||||
{% ifversion fpt or ghec or ghes > 3.2 %}- {% data variables.product.prodname_dependabot_security_updates %} use the dependency graph and {% data variables.product.prodname_dependabot_alerts %} to help you update dependencies with known vulnerabilities in your repository.
|
||||
|
||||
{% data variables.product.prodname_dependabot_version_updates %} don't use the dependency graph and rely on the semantic versioning of dependencies instead. {% data variables.product.prodname_dependabot_version_updates %} help you keep your dependencies updated, even when they don’t have any vulnerabilities.
|
||||
|
||||
@@ -9,34 +9,34 @@ versions:
|
||||
|
||||
## Acerca de {% data variables.product.prodname_discussions %}
|
||||
|
||||
With {% data variables.product.prodname_discussions %}, the community for your project can create and participate in conversations within the project's repository or organization. Los debates fotalecen a los mantenedores del proyecto, contribuyentes y visitantes para que se reunan y logren sus metas en una ubicación centralizada, sin herramientas de terceros.
|
||||
Con los {% data variables.product.prodname_discussions %}, la comunidad de tu proyecto puede crear y participar en las conversaciones dentro de la organización o repositorio del proyecto. Los debates fotalecen a los mantenedores del proyecto, contribuyentes y visitantes para que se reunan y logren sus metas en una ubicación centralizada, sin herramientas de terceros.
|
||||
|
||||
- Comparte anuncios e información, recolecta comentarios, planea y toma decisiones
|
||||
- Haz preguntas, debate y respóndelas, y marca los debates como respondidos
|
||||
- Create polls to gauge community opinion
|
||||
- Crear encuestas para medir la opinión de la comunidad
|
||||
- Fomenta un ambiente amigable para los visitantes y contribuyentes para que se debatan las metas, el desarrollo, la administración y los flujos de trabajo
|
||||
|
||||
|
||||
|
||||
You might use repository discussions to discuss topics that are specific to the repository. If your project spans multiple repositories, you might use organization discussions to discuss topics that aren't specific to a single repository in your organization.
|
||||
Puedes utilizar los debates del repositorio para hablar sobre temas que sean específicos de este. Si tu proyecto abarca varios repositorios, puedes utilizar los debates de la organización para hablar sobre los temas que no sean específicos para un solo repositorio de tu organización.
|
||||
|
||||
No necesitas cerrar un debate de la misma forma en que cierras una propuesta o una solicitud de cambios.
|
||||
|
||||
Si un administrador de repositorio o mantenedor de proyecto habilita los {% data variables.product.prodname_discussions %} para un repositorio, cualquiera que visite el repositorio podrá crear y participar en los debates de este. If an organization owner enables {% data variables.product.prodname_discussions %} for an organization, anyone who can view the source repository can create an organization discussion.
|
||||
Si un administrador de repositorio o mantenedor de proyecto habilita los {% data variables.product.prodname_discussions %} para un repositorio, cualquiera que visite el repositorio podrá crear y participar en los debates de este. Si un propietario de organización habilita los {% data variables.product.prodname_discussions %} para esta, cualquiera que pueda ver el repositorio origen puede crear un debate de organización.
|
||||
|
||||
Los administradores del repositorio y los mantenedores del proyecto pueden administrar los debates y las categorías de los mismos en un repositorio y fijarlos para incrementar la visibilidad de éstos. Los moderadores y colaboradores pueden marcar los comentarios como respuestas, fijar debates, y convertir las propuestas en debates. Similarly, for organization discussions, the role of a user in the source repository determines how a user can interact with organization discussions. Para obtener más información, consulta la sección "[Roles de repositorio para una organización](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)".
|
||||
Los administradores del repositorio y los mantenedores del proyecto pueden administrar los debates y las categorías de los mismos en un repositorio y fijarlos para incrementar la visibilidad de éstos. Los moderadores y colaboradores pueden marcar los comentarios como respuestas, fijar debates, y convertir las propuestas en debates. Del mismo modo, para los debates organizacionales, el rol de un usuario en el repositorio origen determinará cómo puede interactuar dicho usuario con los debates de la organización. Para obtener más información, consulta la sección "[Roles de repositorio para una organización](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)".
|
||||
|
||||
For more information about management of discussions, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions)."
|
||||
Para obtener más información sobre la administración de debates, consulta la sección "[Administrar debates](/discussions/managing-discussions-for-your-community/managing-discussions)".
|
||||
|
||||
## About polls
|
||||
## Acerca de las encuestas
|
||||
|
||||
You can create polls in the polls category to gauge interest in new ideas and project direction. Anyone with read access to your repository can create polls, vote in polls, and view their results. Logged out users can view the results of polls in public repositories.
|
||||
Puedes crear encuestas en la categoría de encuestas para medir el interés en las ideas nuevas y la dirección de los proyectos. Cualquiera con acceso de lectura en tu repositorio puede crear encuestas, votar en ellas y ver sus resultados. Los usuarios que hayan cerrado sesión pueden ver los resultados de las encuestas en los repositorios públicos.
|
||||
|
||||
Polls require a question and at least two options. You can add a maximum of eight options and the options can contain a maximum of 128 characters.
|
||||
Las encuestas requieren una pregunta y por lo menos dos opciones. Puedes agregar un máximo de ocho opciones y estas pueden contener un máximo de 128 caracteres.
|
||||
|
||||
Voters cannot change their vote. Editing a poll will reset any votes that have already been cast.
|
||||
Los votantes no pueden cambiar su voto. El editar una encuesta restablecerá cualquier voto que se haya emitido.
|
||||
|
||||
For more information on creating polls, see "[Creating a poll](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-poll)."
|
||||
Para obtener más información sobre cómo crear encuestas, consulta la sección "[Crear una encuesta](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-poll)".
|
||||
|
||||
## Acerca de la organización de debates
|
||||
|
||||
@@ -48,7 +48,7 @@ Para los debates con un formato de pregunta/respuesta, un comentario individual
|
||||
|
||||
{% data reusables.discussions.about-announcement-format %}
|
||||
|
||||
For more information, see "[Managing categories for discussions](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions)."
|
||||
Para obtener más información, consulta la sección "[Administrar las categorías de los debates](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions)".
|
||||
|
||||
{% data reusables.discussions.you-can-label-discussions %}
|
||||
|
||||
@@ -58,9 +58,9 @@ Como mantenedor o miembro de la comunidad, inicia un debate para hacer una pregu
|
||||
|
||||
Participa en un debate para hacer y responder preguntas, proporcionar retroalimentación e interactuar con la comunidad del proyecto. Para obtener más información, consulta la sección "[Participar en un debate](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)".
|
||||
|
||||
Puedes destacar los debates que contengan conversaciones importantes, útiles o ejemplares entre los miembros de la comunidad. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion)."
|
||||
Puedes destacar los debates que contengan conversaciones importantes, útiles o ejemplares entre los miembros de la comunidad. Para obtener más información, consulta la sección "[Administrar los debates](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion)".
|
||||
|
||||
{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)."
|
||||
{% data reusables.discussions.you-can-convert-an-issue %} Para obtener más información, consulta la sección "[Moderar los debates](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)".
|
||||
|
||||
## Compartir retroalimentación
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ versions:
|
||||
|
||||
{% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.about-announcement-format %}
|
||||
|
||||
Repository administrators and project maintainers can delete a discussion in that repository. Similarly, administrators and maintainers of the source repository for an organization's discussions can delete a discussion in that organization. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)."
|
||||
Los administradores de repositorio y mantenedores de proyecto pueden borrar un debate en este repositorio. Del mismo modo, los administradores y mantenedores del repositorio origen de los debates de una organización pueden borrar cualquier debate en esta. Para obtener más información, consulta la sección "[Administrar debates](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)".
|
||||
|
||||
{% data reusables.discussions.github-recognizes-members %} Estos miembros aparecen en una lista de los contribuyentes más útiles en los debates del proyecto. Conforme crezca tu proyecto, podrás otorgar permisos de acceso superiores a los miembros activos de tu comunidad. Para obtener más información, consulta la sección "[Otorgar permisos superiores a los colaboradores principales](/discussions/guides/granting-higher-permissions-to-top-contributors)"
|
||||
|
||||
@@ -25,21 +25,21 @@ Para obtener más información acerca de la participación en los debates, consu
|
||||
|
||||
## Prerrequisitos
|
||||
|
||||
To collaborate with maintainers in repository discussions, a repository administrator or project maintainer must enable {% data variables.product.prodname_discussions %} for the repository. Para obtener más información, consulta la sección "[Habilitar o inhabilitar los {% data variables.product.prodname_discussions %} para un repositorio](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)".
|
||||
Para colaborar con los mantenedores en los debates de los repositorios, un administrador de repositorio o mantenedor de proyeto debe habilitar los {% data variables.product.prodname_discussions %} en dicho repositorio. Para obtener más información, consulta la sección "[Habilitar o inhabilitar los {% data variables.product.prodname_discussions %} para un repositorio](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)".
|
||||
|
||||
To collaborate with maintainers in organization discussions, {% data variables.product.prodname_discussions %} must be enabled for the organization. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)."
|
||||
Para colaborar con los mantenedores en los debates de las organizaciones, se deben habilitar los {% data variables.product.prodname_discussions %} en la organización. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)."
|
||||
|
||||
## Iniciar un debate
|
||||
|
||||
{% data reusables.discussions.starting-a-discussion %}
|
||||
|
||||
## Starting a poll
|
||||
## Iniciar una encuesta
|
||||
|
||||
{% data reusables.discussions.starting-a-poll %}
|
||||
|
||||
## Filtrar la lista de debates
|
||||
|
||||
You can search for discussions and filter the list of discussions in a repository or organization. Para obtener más información, consulta la sección "[Buscar buscar debates](/search-github/searching-on-github/searching-discussions)".
|
||||
Puedes buscar debates y filtrar la lista de estos en un repositorio u organización. Para obtener más información, consulta la sección "[Buscar buscar debates](/search-github/searching-on-github/searching-discussions)".
|
||||
|
||||
{% data reusables.discussions.navigate-to-repo-or-org %}
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
@@ -48,7 +48,7 @@ You can search for discussions and filter the list of discussions in a repositor
|
||||
|
||||
## Convertir una propuesta en un debate
|
||||
|
||||
{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)."
|
||||
{% data reusables.discussions.you-can-convert-an-issue %} Para obtener más información, consulta la sección "[Moderar los debates](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)".
|
||||
|
||||
## Leer más
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Guía de inicio rápido para los debates de GitHub
|
||||
intro: 'Enable {% data variables.product.prodname_discussions %} on an existing repository or organization and start conversations with your community.'
|
||||
intro: 'Habilita los {% data variables.product.prodname_discussions %} en un repositorio u organización e inicia conversaciones con tu comunidad.'
|
||||
allowTitleToDifferFromFilename: true
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -27,9 +27,9 @@ Cuando habilitas los {% data variables.product.prodname_discussions %} por prime
|
||||
1. Debajo de "Iniciar un debate nuevo" edita la plantilla para que se apegue con los recursos y el tono que quieras configurar para tu comunidad.
|
||||
1. Da clic en **Iniciar debate**. 
|
||||
|
||||
## Enabling {% data variables.product.prodname_discussions %} on your organization
|
||||
## Habilitar los {% data variables.product.prodname_discussions %} en tu organización
|
||||
|
||||
Organization owners can enable {% data variables.product.prodname_discussions %} for their organization.
|
||||
Los propietarios de las organizaciones pueden habilitar los {% data variables.product.prodname_discussions %} para su organización.
|
||||
|
||||
{% data reusables.discussions.about-organization-discussions %}
|
||||
|
||||
@@ -37,18 +37,18 @@ Organization owners can enable {% data variables.product.prodname_discussions %}
|
||||
|
||||
## Aceptar contribuyentes en tus debates
|
||||
|
||||
You can welcome your community and introduce a new way to communicate in a repository or organization by creating a welcome post and pinning the post to your {% data variables.product.prodname_discussions %} page. El fijar y bloquear los debates ayuda a que las personas sepan si una publicación se hizo a manera de anuncio. Puedes utilizar los anuncios como una forma de vincular a las personas con más recursos y ofrecerles orientación para abrir debates en tu comunidad. For more information about pinning a discussion, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion)."
|
||||
Puedes darles la bienvenida a tu comunidad y presentarles una forma nueva de comunicarse en un repositorio u organización si creas una publicación de bienvenida y la anclas a tu página de {% data variables.product.prodname_discussions %}. El fijar y bloquear los debates ayuda a que las personas sepan si una publicación se hizo a manera de anuncio. Puedes utilizar los anuncios como una forma de vincular a las personas con más recursos y ofrecerles orientación para abrir debates en tu comunidad. Para obtener más información sobre cómo fijar un debate, consulta la sección "[Administrar los debates](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion)".
|
||||
|
||||
|
||||
## Configurar los lineamientos comunitarios para los contribuyentes
|
||||
|
||||
For repository discussions, you can set contributing guidelines to encourage collaborators to have meaningful, useful conversations that are relevant to the repository. También puedes actualizar el archivo de README del repositorio para comunicar tus expectativas de cuándo deberían los colaboradores abrir una propuesta o un debate. Para obtener más información sobre proporcionar lineamientos para tu proyecto, consulta las secciones "[Agregar un código de conducta a tu proyecto](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)" y "[Configurar tu proyecto para que tegan contribuciones sanas](/communities/setting-up-your-project-for-healthy-contributions)".
|
||||
En el caso de los debates de repositorio, puedes configurar lineamientos de contribución para fomentar que los colaboradores tengan conversaciones útiles y significativas que sean relevantes para el repositorio. También puedes actualizar el archivo de README del repositorio para comunicar tus expectativas de cuándo deberían los colaboradores abrir una propuesta o un debate. Para obtener más información sobre proporcionar lineamientos para tu proyecto, consulta las secciones "[Agregar un código de conducta a tu proyecto](/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project)" y "[Configurar tu proyecto para que tegan contribuciones sanas](/communities/setting-up-your-project-for-healthy-contributions)".
|
||||
|
||||
For organization discussions, you share information about how to engage with your organization by creating an organization profile README. Para obtener más información, consulta la sección "[Personalizar el perfil de tu organización ](/organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile)".
|
||||
Para el caso de los debates, puedes compartir información sobre cómo participar en tu organización al crear un README de perfil para ella. Para obtener más información, consulta la sección "[Personalizar el perfil de tu organización ](/organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile)".
|
||||
|
||||
## Crear un debate nuevo
|
||||
|
||||
Any authenticated user who can view the repository can create a discussion in that repository. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a discussion in that organization.
|
||||
Cualquier usuario sin autenticar que pueda ver el repositorio podrá crear un debate en este. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a discussion in that organization.
|
||||
|
||||
{% data reusables.discussions.starting-a-discussion %}
|
||||
|
||||
|
||||
@@ -67,7 +67,7 @@ Como propietario empresarial o administrador, puedes administrar los ajustes a n
|
||||
## Parte 3: Compilar de forma segura
|
||||
Para aumentar la seguridad de {% data variables.product.product_location %}, puedes configurar la autenticación para los miembros empresariales, utilizar herramientas y registro en bitácoras de auditoría para permanecer en cumplimiento, configurar las características de seguridad y análisis para tus organizaciones y, opcionalmente, habilitar la {% data variables.product.prodname_GH_advanced_security %}.
|
||||
### 1. Autenticar a los miembros empresariales
|
||||
Puedes utilizar el método de autenticación integrado en {% data variables.product.product_name %} o puedes elegir entre un proveedor de autenticación establecido, tal como CAS, LDAP o SAML, para integrar tus cuentas existentes y administrar centralmente el acceso de los usuarios a {% data variables.product.product_location %}. Para obtener más información, consulta la sección "[Autenticar usuarios en {% data variables.product.product_location %}](/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance)".
|
||||
You can use {% data variables.product.product_name %}'s built-in authentication method, or you can choose between an external authentication provider, such as CAS, LDAP, or SAML, to integrate your existing accounts and centrally manage user access to {% data variables.product.product_location %}. For more information, see "[About authentication for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise)."
|
||||
|
||||
También puedes requerir la autenticación bifactorial para cada una de tus organizaciones. Para obtener más información, consulta la sección "[Requerir la autenticación bifactorial en una organización](/admin/user-management/managing-organizations-in-your-enterprise/requiring-two-factor-authentication-for-an-organization)".
|
||||
|
||||
|
||||
@@ -24,7 +24,7 @@ Puedes ver y revocar la identidad vinculada de cada miembro, sesiones activas y
|
||||
|
||||
{% data reusables.saml.about-linked-identities %}
|
||||
|
||||
Cuando esté disponible, la entrada incluirá datos de SCIM. Para obtener más información, consulta la sección "[Acerca de SCIM](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim)".
|
||||
Cuando esté disponible, la entrada incluirá datos de SCIM. For more information, see "[About SCIM for organizations](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)."
|
||||
|
||||
{% warning %}
|
||||
|
||||
|
||||
@@ -29,7 +29,7 @@ An organization owner can restrict the ability to invite collaborators. For more
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghes %}
|
||||
Before you can add someone as an outside collaborator on a repository, the person must have a personal account on {% data variables.product.product_location %}. If your enterprise uses an external authentication system such as SAML or LDAP, the person you want to add must sign in through that system to create an account. If the person does not have access to the authentication system and built-in authentication is enabled for your enterprise, a site admin can create a personal account for the person. For more information, see "[Using built-in authentication](/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-built-in-authentication#inviting-users)."
|
||||
Before you can add someone as an outside collaborator on a repository, the person must have a personal account on {% data variables.product.product_location %}. If your enterprise uses an external authentication system such as SAML or LDAP, the person you want to add must sign in through that system to create an account. If the person does not have access to the authentication system and built-in authentication is enabled for your enterprise, a site administrator can create an account for the person. For more information, see "[Configuring built-in authentication](/admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication)."
|
||||
{% endif %}
|
||||
|
||||
{% ifversion not ghae %}
|
||||
|
||||
@@ -23,7 +23,7 @@ If your organization has a paid per-user subscription, an unused license must be
|
||||
|
||||
If your organization requires members to use two-factor authentication, users that you invite must enable two-factor authentication before accepting the invitation. For more information, see "[Requiring two-factor authentication in your organization](/organizations/keeping-your-organization-secure/requiring-two-factor-authentication-in-your-organization)" and "[Securing your account with two-factor authentication (2FA)](/github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa)."
|
||||
|
||||
{% ifversion fpt %}Organizations that use {% data variables.product.prodname_ghe_cloud %}{% else %}You{% endif %} can implement SCIM to add, manage, and remove organization members' access to {% data variables.product.prodname_dotcom_the_website %} through an identity provider (IdP). For more information, see "[About SCIM](/enterprise-cloud@latest/organizations/managing-saml-single-sign-on-for-your-organization/about-scim){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}
|
||||
{% ifversion fpt %}Organizations that use {% data variables.product.prodname_ghe_cloud %}{% else %}You{% endif %} can implement SCIM to add, manage, and remove organization members' access to {% data variables.product.prodname_dotcom_the_website %} through an identity provider (IdP). For more information, see "[About SCIM for organizations](/enterprise-cloud@latest/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}
|
||||
|
||||
## Inviting a user to join your organization
|
||||
|
||||
|
||||
@@ -46,7 +46,9 @@ Los miembros de una organización también deben contar con una sesión activa d
|
||||
|
||||
{% data reusables.saml.saml-supported-idps %}
|
||||
|
||||
Algunos IdP admiten acceso de suministro a una organización de {% data variables.product.prodname_dotcom %} a través de SCIM. {% data reusables.scim.enterprise-account-scim %} Para obtener más información, consulta la sección "[Acerca de SCIM](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim)".
|
||||
Algunos IdP admiten acceso de suministro a una organización de {% data variables.product.prodname_dotcom %} a través de SCIM. For more information, see "[About SCIM for organizations](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)."
|
||||
|
||||
{% data reusables.scim.enterprise-account-scim %}
|
||||
|
||||
## Agregar miembros a una organización usando SAML SSO
|
||||
|
||||
@@ -54,7 +56,7 @@ Una vez que activas SAML SSO, hay varias maneras de poder agregar nuevos miembro
|
||||
|
||||
Para aprovisionar nuevos usuarios sin una invitación de un propietario de la organización, puedes usar la URL `https://github.com/orgs/ORGANIZATION/sso/sign_up`, reemplazando _ORGANIZATION_ con el nombre de tu organización. Por ejemplo, puedes configurar tu IdP para que cualquiera con acceso al IdP pueda hacer clic en el tablero del IdP para unirse a tu organización de {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
Si tu IdP admite SCIM, {% data variables.product.prodname_dotcom %} puede invitar automáticamente a los miembros para que se unan a tu organización cuando les otorgas acceso en tu IdP. Si eliminas el acceso de un miembro a tu organización de {% data variables.product.prodname_dotcom %} en tu IdP de SAML, éste se eliminará automáticamente de la organización de{% data variables.product.prodname_dotcom %}. Para obtener más información, consulta la sección "[Acerca de SCIM](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim)".
|
||||
Si tu IdP admite SCIM, {% data variables.product.prodname_dotcom %} puede invitar automáticamente a los miembros para que se unan a tu organización cuando les otorgas acceso en tu IdP. Si eliminas el acceso de un miembro a tu organización de {% data variables.product.prodname_dotcom %} en tu IdP de SAML, éste se eliminará automáticamente de la organización de{% data variables.product.prodname_dotcom %}. For more information, see "[About SCIM for organizations](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)."
|
||||
|
||||
{% data reusables.organizations.team-synchronization %}
|
||||
|
||||
@@ -62,5 +64,6 @@ Si tu IdP admite SCIM, {% data variables.product.prodname_dotcom %} puede invita
|
||||
|
||||
## Leer más
|
||||
|
||||
- "[SAML configuration reference](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference)"
|
||||
- "[Acerca de la autenticación de dos factores y el inicio de sesión único de SAML ](/articles/about-two-factor-authentication-and-saml-single-sign-on)"
|
||||
- "[Acerca de la autenticación con el inicio de sesión único de SAML](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)"
|
||||
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: About SCIM for organizations
|
||||
intro: 'Con Sistema para la administración de identidades entre dominios (SCIM), los administradores pueden automatizar el intercambio de información de identidad del usuario entre los sistemas.'
|
||||
redirect_from:
|
||||
- /articles/about-scim
|
||||
- /github/setting-up-and-managing-organizations-and-teams/about-scim
|
||||
- /organizations/managing-saml-single-sign-on-for-your-organization/about-scim
|
||||
versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Organizations
|
||||
- Teams
|
||||
---
|
||||
|
||||
## About SCIM for organizations
|
||||
|
||||
If your organization uses [SAML SSO](/articles/about-identity-and-access-management-with-saml-single-sign-on), you can implement SCIM to add, manage, and remove organization members' access to {% data variables.product.product_name %}. Por ejemplo, un administrador puede desaprovisionar a un miembro de la organización usando el SCIM y eliminar automáticamente el miembro de la organización.
|
||||
|
||||
{% data reusables.saml.ghec-only %}
|
||||
|
||||
{% data reusables.scim.enterprise-account-scim %}
|
||||
|
||||
Si usas SAML SSO sin implementar SCIM, no tendrás un desaprovisionamiento automático. Cuando las sesiones de los miembros de la organización expiran una vez que su acceso ha sido eliminado del IdP, no se eliminan automáticamente de la organización. Los tokens autorizados otorgan acceso a la organización incluso una vez que las sesiones han expirado. If SCIM is not used, to fully remove a member's access, an organization owner must remove the member's access in the IdP and manually remove the member from the organization on {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
{% data reusables.scim.changes-should-come-from-idp %}
|
||||
|
||||
## Proveedores de identidad compatibles
|
||||
|
||||
These identity providers (IdPs) are compatible with the {% data variables.product.product_name %} SCIM API for organizations. Para obtener más información, consulta el [SCIM](/rest/scim) en la documentación de la API de {% ifversion ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}.
|
||||
- Azure AD
|
||||
- Okta
|
||||
- OneLogin
|
||||
|
||||
## About SCIM configuration for organizations
|
||||
|
||||
{% data reusables.scim.dedicated-configuration-account %}
|
||||
|
||||
Before you authorize the {% data variables.product.prodname_oauth_app %}, you must have an active SAML session. Para obtener más información, consulta la sección "[Acerca de la autenticación con el inicio de sesión único de SAML](/authentication/authenticating-with-saml-single-sign-on/about-authentication-with-saml-single-sign-on#about-oauth-apps-github-apps-and-saml-sso)".
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota:** {% data reusables.scim.nameid-and-username-must-match %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Leer más
|
||||
|
||||
- "[Visualizar y administrar un acceso de SAML de un miembro a tu organización](/github/setting-up-and-managing-organizations-and-teams//viewing-and-managing-a-members-saml-access-to-your-organization)"
|
||||
@@ -1,39 +0,0 @@
|
||||
---
|
||||
title: Acerca de SCIM
|
||||
intro: 'Con Sistema para la administración de identidades entre dominios (SCIM), los administradores pueden automatizar el intercambio de información de identidad del usuario entre los sistemas.'
|
||||
redirect_from:
|
||||
- /articles/about-scim
|
||||
- /github/setting-up-and-managing-organizations-and-teams/about-scim
|
||||
versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Organizations
|
||||
- Teams
|
||||
---
|
||||
|
||||
{% data reusables.enterprise-accounts.emu-scim-note %}
|
||||
|
||||
Si usas [SAML SSO](/articles/about-identity-and-access-management-with-saml-single-sign-on) en tu organización, puedes implementar SCIM para agregar, administrar y eliminar el acceso de los miembros de la organización a {% data variables.product.product_name %}. Por ejemplo, un administrador puede desaprovisionar a un miembro de la organización usando el SCIM y eliminar automáticamente el miembro de la organización.
|
||||
|
||||
{% data reusables.saml.ghec-only %}
|
||||
|
||||
Si usas SAML SSO sin implementar SCIM, no tendrás un desaprovisionamiento automático. Cuando las sesiones de los miembros de la organización expiran una vez que su acceso ha sido eliminado del IdP, no se eliminan automáticamente de la organización. Los tokens autorizados otorgan acceso a la organización incluso una vez que las sesiones han expirado. Para eliminar el acceso, los administradores de la organización pueden eliminar de forma manual el token autorizado de la organización o automatizar su eliminación con SCIM.
|
||||
|
||||
Estos proveedores de identidad son compatibles con la API de SCIM de {% data variables.product.product_name %} para organizaciones. Para obtener más información, consulta el [SCIM](/rest/reference/scim) en la documentación de la API de {% ifversion ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}.
|
||||
- Azure AD
|
||||
- Okta
|
||||
- OneLogin
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota:** {% data reusables.scim.nameid-and-username-must-match %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.scim.changes-should-come-from-idp %}
|
||||
|
||||
{% data reusables.scim.enterprise-account-scim %}
|
||||
|
||||
## Leer más
|
||||
|
||||
- "[Visualizar y administrar un acceso de SAML de un miembro a tu organización](/github/setting-up-and-managing-organizations-and-teams//viewing-and-managing-a-members-saml-access-to-your-organization)"
|
||||
@@ -18,7 +18,7 @@ Puedes controlar el acceso a tu organización en {% data variables.product.produ
|
||||
|
||||
{% data reusables.saml.ghec-only %}
|
||||
|
||||
El SSO de SAML controla y asegura el acceso a los recursos organizacionales como los repositorios, informes de problemas y solicitudes de extracción. SCIM agrega, administra y elimina automáticamente el acceso a tu organización en {% data variables.product.product_location %} cuando haces cambios en Okta. Para obtener más información, consulta la sección "[Acerca de la administración de accesos e identidad con el inicio de sesión único de SAML](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)" y "[Acerca de SCIM](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim)".
|
||||
El SSO de SAML controla y asegura el acceso a los recursos organizacionales como los repositorios, informes de problemas y solicitudes de extracción. SCIM agrega, administra y elimina automáticamente el acceso a tu organización en {% data variables.product.product_location %} cuando haces cambios en Okta. For more information, see "[About identity and access management with SAML single sign-on](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)" and "[About SCIM for organizations](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)."
|
||||
|
||||
Después de que habilites SCIM, las siguientes características de aprovisionamiento estarán disponibles para cualquier usuario al que asignes tu aplicación de {% data variables.product.prodname_ghe_cloud %} en Okta.
|
||||
|
||||
@@ -38,6 +38,12 @@ Como alternativa, puedes configurar el SSO de SAML para una empresa utilizando O
|
||||
1. Habilita y prueba el SSO de SAML en {% data variables.product.prodname_dotcom %} utilizando la URL de registro, URL del emisor, y certificados pùblicos de la guìa "Còmo configurar SAML 2.0". Para obtener más información, consulta "[Habilitar y probar el inicio de sesión único para tu organización](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization#enabling-and-testing-saml-single-sign-on-for-your-organization)".
|
||||
|
||||
## Configurar el aprovisionamiento de acceso con SCIM en Okta
|
||||
|
||||
{% data reusables.scim.dedicated-configuration-account %}
|
||||
|
||||
1. Sign into {% data variables.product.prodname_dotcom_the_website %} using an account that is an organization owner and is ideally used only for SCIM configuration.
|
||||
1. To create an active SAML session for your organization, navigate to `https://github.com/orgs/ORGANIZATION-NAME/sso`. Para obtener más información, consulta la sección "[Acerca de la autenticación con el inicio de sesión único de SAML](/authentication/authenticating-with-saml-single-sign-on/about-authentication-with-saml-single-sign-on#about-oauth-apps-github-apps-and-saml-sso)".
|
||||
1. Navigate to Okta.
|
||||
{% data reusables.saml.okta-dashboard-click-applications %}
|
||||
{% data reusables.saml.okta-applications-click-ghec-application-label %}
|
||||
{% data reusables.saml.okta-provisioning-tab %}
|
||||
@@ -47,12 +53,6 @@ Como alternativa, puedes configurar el SSO de SAML para una empresa utilizando O
|
||||
1. A la derecha del nombre de tu organizaciòn, da clic en **Otorgar**.
|
||||
|
||||
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota**: si no ves tu organización en la lista, dirígete a `https://github.com/orgs/ORGANIZATION-NAME/sso` en tu buscador y autentícate con ella a través del SSO de SAML utilizando tu cuenta de administrador en el IdP. Por ejemplo, si tu nombre de organización es `octo-org`, La URL sería `https://github.com/orgs/octo-org/sso`. Para obtener más información, consulta la sección "[Acerca de la autenticación con el inicio de sesión único de SAML](/github/authenticating-to-github/about-authentication-with-saml-single-sign-on)".
|
||||
|
||||
{% endnote %}
|
||||
1. Da clic en **Autorizar OktaOAN**.
|
||||
{% data reusables.saml.okta-save-provisioning %}
|
||||
{% data reusables.saml.okta-edit-provisioning %}
|
||||
@@ -60,6 +60,5 @@ Como alternativa, puedes configurar el SSO de SAML para una empresa utilizando O
|
||||
## Leer más
|
||||
|
||||
- "[Configurar el inicio de sesión único de SAML para tu cuenta empresarial utilizando Okta](/enterprise-cloud@latest/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise-using-okta)"
|
||||
- "[Administrar la sincronización de equipos para tu organización](/organizations/managing-saml-single-sign-on-for-your-organization/managing-team-synchronization-for-your-organization#enabling-team-synchronization-for-okta)"
|
||||
- [Understanding SAML](https://developer.okta.com/docs/concepts/saml/) en la documentación de Okta
|
||||
- [Understanding SCIM](https://developer.okta.com/docs/concepts/scim/) en la documentación de Okta
|
||||
|
||||
@@ -1,17 +1,20 @@
|
||||
---
|
||||
title: Conectar tu proveedor de identidad con tu organización
|
||||
intro: 'Para usar el inicio de sesión único de SAML y SCIM, debes conectar tu proveedor de identidad con tu organización {% data variables.product.product_name %}.'
|
||||
intro: 'To use SAML single sign-on and SCIM, you must connect your identity provider (IdP) to your organization on {% data variables.product.product_name %}.'
|
||||
redirect_from:
|
||||
- /articles/connecting-your-identity-provider-to-your-organization
|
||||
- /github/setting-up-and-managing-organizations-and-teams/connecting-your-identity-provider-to-your-organization
|
||||
versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Authentication
|
||||
- Organizations
|
||||
- Teams
|
||||
shortTitle: Conectar un IdP
|
||||
---
|
||||
|
||||
## About connection of your IdP to your organization
|
||||
|
||||
Cuando habilitas el SSO de SAML para tu organización de {% data variables.product.product_name %}, conectas tu proveedor de identidad (IdP) a ella. Para obtener más información, consulta "[Habilitar y probar el inicio de sesión único para tu organización](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization)".
|
||||
|
||||
{% data reusables.saml.ghec-only %}
|
||||
@@ -24,14 +27,14 @@ Puedes encontrar los detalles de implementación de SAML y de SCIM para tu IdP e
|
||||
- PingOne [SAML](https://support.pingidentity.com/s/marketplace-integration/a7i1W0000004ID3QAM/github-connector)
|
||||
- Shibboleth [SAML](https://wiki.shibboleth.net/confluence/display/IDP30/Home)
|
||||
|
||||
Puedes acceder a los metadatos del proveedor de servicios de tu organización en la siguiente URL, reemplazando ORGANIZATION con tu nombre de usuario de la organización.
|
||||
|
||||
```
|
||||
http(s)://github.com/orgs/ORGANIZATION/saml/metadata.xml
|
||||
```
|
||||
|
||||
{% note %}
|
||||
|
||||
**Nota:** Los proveedores de identidad que soportan {% data variables.product.product_name %} SCIM son Azure AD, Okta y OneLogin. {% data reusables.scim.enterprise-account-scim %} Para obtener más información sobre SCIM, consulta la sección "[Acerca de SCIM](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim)".
|
||||
**Nota:** Los proveedores de identidad que soportan {% data variables.product.product_name %} SCIM son Azure AD, Okta y OneLogin. For more information about SCIM, see "[About SCIM for organizations](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)."
|
||||
|
||||
{% data reusables.scim.enterprise-account-scim %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Metadatos SAML
|
||||
|
||||
For more information about SAML metadata for your organization, see "[SAML configuration reference](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference)."
|
||||
|
||||
@@ -59,3 +59,4 @@ Haz clic en **Save ** (guardar). "
|
||||
- "[SAML configuration reference](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference)"
|
||||
|
||||
@@ -12,7 +12,7 @@ topics:
|
||||
- Teams
|
||||
children:
|
||||
- /about-identity-and-access-management-with-saml-single-sign-on
|
||||
- /about-scim
|
||||
- /about-scim-for-organizations
|
||||
- /connecting-your-identity-provider-to-your-organization
|
||||
- /configuring-saml-single-sign-on-and-scim-using-okta
|
||||
- /enabling-and-testing-saml-single-sign-on-for-your-organization
|
||||
|
||||
@@ -18,8 +18,8 @@ Los proveedores de identidad (IdP) habilitados para SCIM utilizan la API de SCIM
|
||||
{% note %}
|
||||
|
||||
**Notas:**
|
||||
- La API de SCIM se encuentra disponible únicamente para las organizaciones de [{% data variables.product.prodname_ghe_cloud %}](/billing/managing-billing-for-your-github-account/about-billing-for-github-accounts) que cuentan con el [SSO de SAML](/rest/overview/other-authentication-methods#authenticating-for-saml-sso) habilitado. {% data reusables.scim.enterprise-account-scim %} Para obtener más información sobre SCIM, consulta la sección "[Acerca de SCIM](/organizations/managing-saml-single-sign-on-for-your-organization/about-scim)".
|
||||
- La API de SCIM no puede utilizarse con {% data variables.product.prodname_emus %}.
|
||||
- The SCIM API is available only for individual organizations that use [{% data variables.product.prodname_ghe_cloud %}](/billing/managing-billing-for-your-github-account/about-billing-for-github-accounts) with [SAML SSO](/rest/overview/other-authentication-methods#authenticating-for-saml-sso) enabled. For more information about SCIM, see "[About SCIM for organizations](/enterprise-cloud@latest/organizations/managing-saml-single-sign-on-for-your-organization/about-scim-for-organizations)."
|
||||
- The SCIM API cannot be used with an enterprise account or with an {% data variables.product.prodname_emu_org %}.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
||||
@@ -62,27 +62,23 @@ Puedes buscar en {% data variables.product.product_name %} utilizando la {% data
|
||||
|
||||
|
||||
|
||||
{% ifversion fpt or ghes or ghae or ghec %}
|
||||
|
||||
## Buscar repositorios en {% data variables.product.prodname_dotcom_the_website %} desde tu ambiente de empresa privada
|
||||
|
||||
Si tuilizas {% ifversion fpt or ghec %}{% data variables.product.prodname_ghe_server %} o {% data variables.product.prodname_ghe_managed %}{% else %}{% data variables.product.product_name %}{% endif %} y eres miembro de una organización de {% data variables.product.prodname_dotcom_the_website %} que utiliza {% data variables.product.prodname_ghe_cloud %}, un propietario de empresa de tu ambiente de {% data variables.product.prodname_enterprise %} puede habilitar {% data variables.product.prodname_github_connect %} para que puedas buscar en ambos ambientes al mismo tiempo{% ifversion ghes or ghae %} desde {% data variables.product.product_name %}{% endif %}. Para obtener más información, consulta lo siguiente.
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
{% ifversion fpt or ghes or ghec %}
|
||||
If you use both {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_ghe_server %} or {% data variables.product.prodname_ghe_managed %}, and an enterprise owner has enabled {% data variables.product.prodname_unified_search %}, you can search across both environments at the same time from {% data variables.product.prodname_ghe_server %} or {% data variables.product.prodname_ghe_managed %}. For more information, see [the {% data variables.product.prodname_ghe_server %} documentation](/enterprise-server@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment) or [the {% data variables.product.prodname_ghe_managed %} documentation](/github-ae@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment).
|
||||
|
||||
- "[Habilitar la {% data variables.product.prodname_unified_search %} en tu empresa]({% ifversion not ghes %}/enterprise-server@latest{% endif %}/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)" en la documentación de {% data variables.product.prodname_ghe_server %}{% endif %}
|
||||
- "[Habilitar la {% data variables.product.prodname_unified_search %} para tu empresa](/github-ae@latest/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)" en la documentación de {% data variables.product.prodname_ghe_managed %}
|
||||
{% else %}
|
||||
|
||||
{% ifversion ghes or ghae %}
|
||||
If you use both {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.product_name %}, and an enterprise owner has enabled {% data variables.product.prodname_unified_search %}, you can search across both environments at the same time from {% data variables.product.product_name %}. For more information about how enterprise owners can enable {% data variables.product.prodname_unified_search %}, see "[Enabling {% data variables.product.prodname_unified_search %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)."
|
||||
|
||||
Para limitar tu búsqueda por entorno, puedes usar una opción de filtro en {% data variables.search.advanced_url %} o puedes usar el prefijo de búsqueda `environment:`. Para solo buscar contenido en {% data variables.product.product_name %}, usa la sintaxis de búsqueda `environment:local`. Para solo buscar contenido en {% data variables.product.prodname_dotcom_the_website %}, usa la sintaxis de búsqueda `environment:github`.
|
||||
Your enterprise owner on {% data variables.product.product_name %} can separately enable {% data variables.product.prodname_unified_search %} for all public repositories on {% data variables.product.prodname_dotcom_the_website %} and for private repositories owned by the organization or enterprise on {% data variables.product.prodname_dotcom_the_website %} that is connected to {% data variables.product.product_name %} through {% data variables.product.prodname_github_connect %}.
|
||||
|
||||
Tu propietario de empresa en {% data variables.product.product_name %} puede habilitar la {% data variables.product.prodname_unified_search %} para todos los repositorios públicos y privados o únicamente los privados en la organización conectada de {% data variables.product.prodname_ghe_cloud %}.
|
||||
Before you can use {% data variables.product.prodname_unified_search %} for private repositories, you must connect your personal accounts on {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.product_name %}. Para obtener más información, consulta la sección "[Habilitar la búsqueda de repositorios en {% data variables.product.prodname_dotcom_the_website %} desde tu ambiente empresarial privado](/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment)".
|
||||
|
||||
Cuando buscas en {% data variables.product.product_name %}, solo puedes buscar en los repositorios privados de la organización conectada de {% data variables.product.prodname_dotcom_the_website %} a los cuales tengas acceso. Los propietarios de empresa de {% data variables.product.product_name %} y los propietarios de organizaciones en {% data variables.product.prodname_dotcom_the_website %} no pueden buscar en los repositorios privados que pertenezcan a tu cuenta de {% data variables.product.prodname_dotcom_the_website %}. Para buscar los repositorios privados aplicables, debes habilitar la búsqueda en repositorios privados para tus cuentas personales de {% data variables.product.product_name %}. Para obtener más información, consulta la sección "[Habilitar la búsqueda de repositorios en {% data variables.product.prodname_dotcom_the_website %} desde tu ambiente empresarial privado](/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment)".
|
||||
|
||||
{% endif %}
|
||||
When you search from {% data variables.product.product_name %}, only private repositories that you have access to and that are owned by the connected organization or enterprise account will be included in search results. Neither you nor anyone else will be able to search private repositories owned by your personal account on {% data variables.product.prodname_dotcom_the_website %} from {% data variables.product.product_name %}.
|
||||
|
||||
To limit your search to one environment, you can use a filter option on the {% data variables.search.advanced_url %} or you can use the `environment:` search prefix. Para solo buscar contenido en {% data variables.product.product_name %}, usa la sintaxis de búsqueda `environment:local`. Para solo buscar contenido en {% data variables.product.prodname_dotcom_the_website %}, usa la sintaxis de búsqueda `environment:github`.
|
||||
{% endif %}
|
||||
|
||||
## Leer más
|
||||
|
||||
@@ -10,47 +10,23 @@ redirect_from:
|
||||
- /github/searching-for-information-on-github/enabling-githubcom-repository-search-in-github-enterprise-server
|
||||
- /github/searching-for-information-on-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-in-github-enterprise-server
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- GitHub search
|
||||
---
|
||||
|
||||
## Acerca de cómo buscar repositorios de {% data variables.product.prodname_dotcom_the_website %} desde {% ifversion fpt or ghec %}tu ambiente empresarial privado{% else %}{% data variables.product.product_name %}{% endif %}
|
||||
## About search for {% data variables.product.prodname_dotcom_the_website %} repositories from {% data variables.product.product_name %}
|
||||
|
||||
Puedes buscar repositorios privados designados en {% data variables.product.prodname_ghe_cloud %} desde {% ifversion fpt or ghec %}tu ambiente privado de {% data variables.product.prodname_enterprise %}{% else %}{% data variables.product.product_location %}{% ifversion ghae %} en {% data variables.product.prodname_ghe_managed %}{% endif %}{% endif %}. {% ifversion fpt or ghec %}Por ejemplo, si utilizas {% data variables.product.prodname_ghe_server %}, puedes buscar repositorios privados desde tu empresa en {% data variables.product.prodname_ghe_cloud %} en la interfaz web de {% data variables.product.prodname_ghe_server %}.{% endif %}
|
||||
You can search for designated private repositories on {% data variables.product.prodname_ghe_cloud %} from {% data variables.product.product_location %}{% ifversion ghae %} on {% data variables.product.prodname_ghe_managed %}{% endif %}. For more information about searching across environments, see "[About searching on GitHub](/github/searching-for-information-on-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment)."
|
||||
|
||||
## Prerrequisitos
|
||||
|
||||
- Un propietario de empresa de {% ifversion fpt or ghec %}tu ambiente privado de {% data variables.product.prodname_enterprise %}{% else %}{% data variables.product.product_name %}{% endif %} debe habilitar {% data variables.product.prodname_github_connect %} y {% data variables.product.prodname_unified_search %}. Para obtener más información, consulta lo siguiente.
|
||||
{% ifversion fpt %}
|
||||
- "[Enabling {% data variables.product.prodname_unified_search %} for your enterprise](/enterprise-server@latest/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)" in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}{% ifversion ghec %}
|
||||
- "[Enabling {% data variables.product.prodname_unified_search %} for your enterprise](/enterprise-server@latest/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)" in the {% data variables.product.prodname_ghe_server %} documentation{% endif %}{% ifversion ghes %}
|
||||
- "[Enabling {% data variables.product.prodname_unified_search %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)"{% endif %}{% ifversion fpt or ghec or ghae %}
|
||||
- "[Enabling {% data variables.product.prodname_unified_search %} for your enterprise](/github-ae@latest/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)"{% ifversion fpt or ghec %} in the {% data variables.product.prodname_ghe_managed %} documentation{% endif %}
|
||||
{% endif %}
|
||||
An enterprise owner for {% data variables.product.product_name %} must enable {% data variables.product.prodname_github_connect %} and {% data variables.product.prodname_unified_search %} for private repositories. Para obtener más información, consulta la sección "[Habilitar la {% data variables.product.prodname_unified_search %} en tu empresa](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)".
|
||||
|
||||
- Ya debes tener acceso a los repositorios privados y conectar tu cuenta {% ifversion fpt or ghec %}en tu ambiente privado de {% data variables.product.prodname_enterprise %}{% else %} en {% data variables.product.product_name %}{% endif %} con tu cuenta en {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información sobre los repositorios en los que puedes buscar, consulta la sección "[Acerca de cómo buscar en GitHub](/github/searching-for-information-on-github/getting-started-with-searching-on-github/about-searching-on-github#searching-repositories-on-githubcom-from-your-private-enterprise-environment)".
|
||||
|
||||
## Habilitar la búsqueda de repositorios de GitHub.com desde {% ifversion fpt or ghec %}tu ambiente privado de {% data variables.product.prodname_enterprise %}{% else %}{% data variables.product.product_name %}{% endif %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
Para obtener más información, consulta lo siguiente.
|
||||
|
||||
| Tue ambiente empresarial | Más información |
|
||||
|:--------------------------------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| {% data variables.product.prodname_ghe_server %} | "[Habilitar la búsqueda de repositorios de {% data variables.product.prodname_dotcom_the_website %} desde tu ambiente empresarial privado](/enterprise-server@latest/search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment#enabling-githubcom-repository-search-from-github-enterprise-server)" |
|
||||
| {% data variables.product.prodname_ghe_managed %} | "[Habilitar la búsqueda de repositorios de {% data variables.product.prodname_dotcom_the_website %} desde tu ambiente empresarial privado](/github-ae@latest//search-github/getting-started-with-searching-on-github/enabling-githubcom-repository-search-from-your-private-enterprise-environment#enabling-githubcom-repository-search-from-github-ae)" |
|
||||
|
||||
{% elsif ghes or ghae %}
|
||||
## Enabling {% data variables.product.prodname_dotcom_the_website %} repository search from {% data variables.product.product_name %}
|
||||
|
||||
1. Inicia sesión en {% data variables.product.product_name %} y en {% data variables.product.prodname_dotcom_the_website %}.
|
||||
1. En {% data variables.product.product_name %}, en la esquina superior derecha de cualquier página, haz clic en tu foto de perfil y luego haz clic en **Ajustes**. 
|
||||
{% data reusables.github-connect.github-connect-tab-user-settings %}
|
||||
{% data reusables.github-connect.connect-dotcom-and-enterprise %}
|
||||
{% data reusables.github-connect.connect-dotcom-and-enterprise %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -16,9 +16,9 @@ topics:
|
||||
|
||||
GitHub.com, GitHub Enterprise Server y la información que subas a cualquiera de los productos puede estar sujeta a las regulaciones de control de comercio, incluso bajo las Regulaciones sobre Exportación de la Administracción de los Estados Unidos (EAR). Regulaciones de Administración de Exportación (las EAR).
|
||||
|
||||
La visión de GitHub deber ser la plataforma global para la colaboración de desarrolladores, sin importar dónde residan. Nos tomamos en serio nuestra responsabilidad de examinar a fondo los mandatos del gobierno para estar seguros de que los usuarios y clientes no se van afectados más allá de lo que exige la ley. Esto incluye mantener servicios de repositorio público, incluyendo aquellos para proyectos de código abierto, disponibles y accesibles para apoyar las comunicaciones personales que involucran a los desarrolladores en las regiones sancionadas. Esto también significa que GitHub abogará por que los desarrolladores en las áreas sancionadas disfruten de un mejor acceso a la plataforma y de un acceso completo a la comunidad global de código abierto.
|
||||
La visión de GitHub deber ser la plataforma global para la colaboración de desarrolladores, sin importar dónde residan. We take seriously our responsibility to examine government sanctions thoroughly to be certain that users and customers are not impacted beyond what is required by law. Esto incluye mantener servicios de repositorio público, incluyendo aquellos para proyectos de código abierto, disponibles y accesibles para apoyar las comunicaciones personales que involucran a los desarrolladores en las regiones sancionadas. Esto también significa que GitHub abogará por que los desarrolladores en las áreas sancionadas disfruten de un mejor acceso a la plataforma y de un acceso completo a la comunidad global de código abierto.
|
||||
|
||||
Como resultado de nuestro apoyo y arduo trabajo con los reguladores de los EE.UU. GitHub ha asegurado una licencia de la Oficina de Control de Bienes Extrangeros (OFAC) del Departamento del Tesoro de los EE.UU. para restablecer nuestros servicios en la nube para los desarrolladores en Iran. Y seguiremos trabajando con los reguladores de los EE.UU. para asegurar licencias similares y ofrecer servicios de colaboración con los desarrolladores en Siria y Crimea. Estamos comprometidos a apoyar el acceso de los desarrolladores en la manera más amplia posible, ya que creemos que el ofrecer servicios de colaboración de código para los desarrolladores en las regiones sancionadas fortalece aún más la comunidad de desarrollo, constituye un progreso humano y apoya el progreso permanente de la política extrangera de los EE.UU. para promover el discurso y tráfico de información libres. Para obtener más información acerca de la licencia que aseguramos para los desarrolladores en Iran, lee [la publicación del blog](https://github.blog/2021-01-05-advancing-developer-freedom-github-is-fully-available-in-iran).
|
||||
Como resultado de nuestro apoyo y arduo trabajo con los reguladores de los EE.UU. GitHub ha asegurado una licencia de la Oficina de Control de Bienes Extrangeros (OFAC) del Departamento del Tesoro de los EE.UU. para restablecer nuestros servicios en la nube para los desarrolladores en Iran. Y seguiremos trabajando con los reguladores de los EE.UU. regulators to secure similar licenses to offer collaboration services to developers in other sanctioned regions, such as Syria and Crimea. Estamos comprometidos a apoyar el acceso de los desarrolladores en la manera más amplia posible, ya que creemos que el ofrecer servicios de colaboración de código para los desarrolladores en las regiones sancionadas fortalece aún más la comunidad de desarrollo, constituye un progreso humano y apoya el progreso permanente de la política extrangera de los EE.UU. para promover el discurso y tráfico de información libres. Para obtener más información acerca de la licencia que aseguramos para los desarrolladores en Iran, lee [la publicación del blog](https://github.blog/2021-01-05-advancing-developer-freedom-github-is-fully-available-in-iran).
|
||||
|
||||
Aunque hemos proporcionado la siguiente información para tu comodidad, es tu responsabilidad asegurar que el uso de los productos y servicios de GitHub cumple con todas las leyes y regulaciones aplicables, incluyendo las leyes de control de exportaciones de EE. UU. .
|
||||
|
||||
@@ -42,13 +42,13 @@ GitHub Enterprise Server es una aplicación virtual autoalojada que se puede eje
|
||||
|
||||
GitHub Enterprise Server es un producto comercial de mercado masivo y se le ha asignado el Número de Clasificación de Control de Exportación (ECCN) de `5D992.` y puede exportarse a la mayoría de destinos sin necesidad de licencia (NLR).
|
||||
|
||||
GitHub Enterprise Server no puede venderse, exportarse o reexportarse a ningún país listado en el Grupo de Países E:1 que se encuentran en el Suplemento No. 1 a la parte 740 del EAR o a la región de Crimea de Ucrania. Esta lista contiene actualmente a Cuba, Irán, Corea del Norte y Syria, pero está sujeta a cambios.
|
||||
GitHub Enterprise Server may not be sold to, exported, or re-exported to any country listed in Country Group E:1 in Supplement No. 1 to part 740 of the EAR or to the following regions of Ukraine: Crimea and the separatist areas of Donetsk and Luhansk. The countries listed currently include Cuba, Iran, North Korea, Syria, Russia, and Belarus, but this list is subject to change.
|
||||
|
||||
## Preguntas frecuentes
|
||||
|
||||
### ¿En qué países y territorios se aplican las sanciones del gobierno estadounidense? .
|
||||
|
||||
Crimea, Cuba, Irán, Corea del Norte y Syria. Sin embargo, en lo que corresponde a Iran, GitHub ahora tiene una licencia de la Oficina de Control de Bienes Extranjeros (OFAC) del Departamento del Tesoro de los EE.UU. para proporcionar servicios en la nube a los desarrolladores que residen o se ubican de otra forma en este país. Tanto las versiones de paga como las gratuitas de los servicios de la nube de GitHub se encuentran habitualmente disponibles también para los desarrolladores que se ubican en Cuba.
|
||||
Crimea, the separatist areas of Donetsk and Luhasnk, Cuba, Iran, North Korea, and Syria. Sin embargo, en lo que corresponde a Iran, GitHub ahora tiene una licencia de la Oficina de Control de Bienes Extranjeros (OFAC) del Departamento del Tesoro de los EE.UU. para proporcionar servicios en la nube a los desarrolladores que residen o se ubican de otra forma en este país. Tanto las versiones de paga como las gratuitas de los servicios de la nube de GitHub se encuentran habitualmente disponibles también para los desarrolladores que se ubican en Cuba.
|
||||
|
||||
### ¿Cómo garantiza GitHub que las personas que no viven o que tienen vínculos profesionales con los países y territorios sancionados continúan teniendo acceso o capacidad de solicitud?
|
||||
|
||||
@@ -64,11 +64,11 @@ Los viajes en estas regiones podrían impactar el estado de tu cuenta, pero la d
|
||||
|
||||
Ahora, GitHub cuenta con una licencia de la OFAC para proporcionar servicios en la nube a los desarrolladores que residen o se ubican de otra forma en el país de Irán, sancionado por los EE.UU. Esta licencia incluye todos los servicios públicos y privados para los individuos y organizaciones, tanto gratuitos como de pago. Tanto las versiones de paga como las gratuitas de los servicios de la nube de GitHub se encuentran habitualmente disponibles también para los desarrolladores que se ubican en Cuba.
|
||||
|
||||
GitHub está comprometido a continuar con la oferta de servicios de repositorios públicos gratuitos para los desarrolladores con cuentas individuales y organizacionales en Siria y Crimea. Esto incluye el acceso limitado a los servicios gratuitos, tales como los repositorios públicos para proyectos de código abierto (y las páginas públicas asociadas), gists públicos, y los minutos gratuitos asignados de acciones, únicamente para las comunicaciones personales, y no así para propósitos comerciales.
|
||||
GitHub is committed to continuing to offer free public repository services to developers with individual and organizational accounts in Syria, Crimea, and the separatist areas of Donetsk and Luhansk. Esto incluye el acceso limitado a los servicios gratuitos, tales como los repositorios públicos para proyectos de código abierto (y las páginas públicas asociadas), gists públicos, y los minutos gratuitos asignados de acciones, únicamente para las comunicaciones personales, y no así para propósitos comerciales.
|
||||
|
||||
Para las cuentas organizacionales de pago en estas regiones sancionadas, los usuarios podrían tener acceso limitado a los repositorios públicos, los cuales se hayan degradado a repositorios archivados de solo lectura. Para las cuentas organizacionales gratuitas en estas regiones sancionadas, sin embargo, los usuarios seguiran teniendo acceso completo a los repositorios gratuitos para los proyectos de código abierto (y las páginas públicas asociadas), gists públicos, y minutos de acciones gratuitos asignados.
|
||||
|
||||
GitHub seguirá fomentando, en conjunto con los reguladores de los EE.UU. para que tengan el mejor acceso posible a los servicios de colaboración de código para los desarrolladores de Siria y Crimea, incluyendo los repositorios privados. Creemos que el ofrecer estos servicios es un avance en el progreso humano, las comunicaciones internacionales, así como para las restricciones permanentes de la política extranjera de los EE.UU. para promover el discurso y tráfico de información libres.
|
||||
GitHub seguirá fomentando, en conjunto con los reguladores de los EE.UU. para que siga existiendo el mayor nivel de acceso a los servicios de colaboración de código para los desarrolladores en las regiones sancionadas, tales como Siria y Crimea, incluyendo los repositorios privados. Creemos que el ofrecer estos servicios es un avance en el progreso humano, las comunicaciones internacionales, así como para las restricciones permanentes de la política extranjera de los EE.UU. para promover el discurso y tráfico de información libres.
|
||||
|
||||
Los Nacionales Especialmente Designados (SDN) u otras partes bloqueadas o denegadas bajo las leyes de los EE.UU. y otras aplicables, así como ciertas oficialías de gobierno, podrían restringirse en su acceso o uso de GitHub, donde sea que se encuentren. Los usuarios no pueden utilizar GitHub.com para o en nombre de dichas partes, las cuales incluyen habitualmente a los gobiernos de las regiones sancionadas.
|
||||
|
||||
|
||||
@@ -4,3 +4,5 @@
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
ghes: '>3.4'
|
||||
ghae: 'issue-5169'
|
||||
|
||||
@@ -0,0 +1,3 @@
|
||||
---
|
||||
versions:
|
||||
ghes: '*'
|
||||
@@ -14,20 +14,6 @@ upcoming_changes:
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: tambling
|
||||
-
|
||||
location: EnterpriseBillingInfo.availableSeats
|
||||
description: 'Se eliminará a `availableSeats`. Utiliza EnterpriseBillingInfo.totalAvailableLicenses en sustitución.'
|
||||
reason: 'Se reemplazará a `availableSeats` con `totalAvailableLicenses` para proporcionar más claridad en el valor que se devuelva'
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: BlakeWilliams
|
||||
-
|
||||
location: EnterpriseBillingInfo.seats
|
||||
description: 'Se eliminará a `seats`. Utiliza EnterpriseBillingInfo.totalLicenses en sustitución.'
|
||||
reason: 'Se reemplazará a `seats` con `totalLicenses` para proporcionar más claridad en el valor que se devuelva'
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: BlakeWilliams
|
||||
-
|
||||
location: UnassignedEvent.user
|
||||
description: 'Se eliminará a `user`. Utiliza el campo `assignee` en sustitución.'
|
||||
|
||||
@@ -14,20 +14,6 @@ upcoming_changes:
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: tambling
|
||||
-
|
||||
location: EnterpriseBillingInfo.availableSeats
|
||||
description: 'Se eliminará a `availableSeats`. Utiliza EnterpriseBillingInfo.totalAvailableLicenses en sustitución.'
|
||||
reason: 'Se reemplazará a `availableSeats` con `totalAvailableLicenses` para proporcionar más claridad en el valor que se devuelva'
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: BlakeWilliams
|
||||
-
|
||||
location: EnterpriseBillingInfo.seats
|
||||
description: 'Se eliminará a `seats`. Utiliza EnterpriseBillingInfo.totalLicenses en sustitución.'
|
||||
reason: 'Se reemplazará a `seats` con `totalLicenses` para proporcionar más claridad en el valor que se devuelva'
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: BlakeWilliams
|
||||
-
|
||||
location: UnassignedEvent.user
|
||||
description: 'Se eliminará a `user`. Utiliza el campo `assignee` en sustitución.'
|
||||
|
||||
@@ -14,20 +14,6 @@ upcoming_changes:
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: tambling
|
||||
-
|
||||
location: EnterpriseBillingInfo.availableSeats
|
||||
description: 'Se eliminará a `availableSeats`. Utiliza EnterpriseBillingInfo.totalAvailableLicenses en sustitución.'
|
||||
reason: 'Se reemplazará a `availableSeats` con `totalAvailableLicenses` para proporcionar más claridad en el valor que se devuelva'
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: BlakeWilliams
|
||||
-
|
||||
location: EnterpriseBillingInfo.seats
|
||||
description: 'Se eliminará a `seats`. Utiliza EnterpriseBillingInfo.totalLicenses en sustitución.'
|
||||
reason: 'Se reemplazará a `seats` con `totalLicenses` para proporcionar más claridad en el valor que se devuelva'
|
||||
date: '2020-01-01T00:00:00+00:00'
|
||||
criticality: breaking
|
||||
owner: BlakeWilliams
|
||||
-
|
||||
location: UnassignedEvent.user
|
||||
description: 'Se eliminará a `user`. Utiliza el campo `assignee` en sustitución.'
|
||||
|
||||
@@ -0,0 +1,8 @@
|
||||
Los activadores de los flujos de trabajo son eventos que ocasionan que se ejecute un flujo de trabajo. Estos eventos pueden ser:
|
||||
|
||||
- Eventos que ocurren en el repositorio de tu flujo de trabajo
|
||||
- Eventos que ocurren fuera de {% data variables.product.product_name %} y activan un evento de `repository_dispatch` en {% data variables.product.product_name %}
|
||||
- Tiempos programados
|
||||
- Manual
|
||||
|
||||
Por ejemplo, puedes configurar tu flujo de trabajo para que se ejecute cuando se realiza una subida a la rama predeterminada de tu repositorio, cuando se crea un lanzamiento o cuando se abre una propuesta.
|
||||
@@ -0,0 +1,3 @@
|
||||
Un flujo de trabajo es un proceso automatizado configurable que ejecutará uno o más jobs. Los flujos de trabajo se definen mediante un archivo de YAML que se verifica en tu repositorio y se ejecutará cuando lo active un evento dentro de este o puede activarse manualmente o en una programación definida.
|
||||
|
||||
Workflows are defined in the `.github/workflows` directory in a repository, and a repository can have multiple workflows, each of which can perform a different set of tasks. Por ejemplo, puedes tener un flujo de trabajo para crear y probar las solicitudes de cambio, otro para desplegar tu aplicación cada que se cree un lanzamiento y todavía otro más que agregue una etiqueta cada que alguien abra una propuesta nueva.
|
||||
@@ -0,0 +1,172 @@
|
||||
## Crear un flujo de trabajo de ejemplo
|
||||
|
||||
Las {% data variables.product.prodname_actions %} utilizan la sintaxis de YAML para definir el flujo de trabajo. Each workflow is stored as a separate YAML file in your code repository, in a directory named `.github/workflows`.
|
||||
|
||||
Puedes crear un flujo de trabajo de ejemplo en tu repositorio que active automáticamente una serie de comandos cada que se suba código. In this workflow, {% data variables.product.prodname_actions %} checks out the pushed code, installs the [bats](https://www.npmjs.com/package/bats) testing framework, and runs a basic command to output the bats version: `bats -v`.
|
||||
|
||||
1. En tu repositorio, crea el directorio `.github/workflows/` para almacenar tus archivos de flujo de trabajo.
|
||||
1. En el directorio `.github/workflows/`, crea un archivo nuevo que se llame `learn-github-actions.yml` y agrega el siguiente código.
|
||||
|
||||
```yaml
|
||||
name: learn-github-actions
|
||||
on: [push]
|
||||
jobs:
|
||||
check-bats-version:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: {% data reusables.actions.action-checkout %}
|
||||
- uses: {% data reusables.actions.action-setup-node %}
|
||||
with:
|
||||
node-version: '14'
|
||||
- run: npm install -g bats
|
||||
- run: bats -v
|
||||
```
|
||||
1. Confirma estos cambios y cárgalos a tu repositorio de {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
Tu archivo de flujo de trabajo de {% data variables.product.prodname_actions %} nuevo estará ahora instalado en tu repositorio y se ejecutará automáticamente cada que alguien suba un cambio a éste. To see the details about a workflow's execution history, see "[Viewing the activity for a workflow run](#viewing-the-activity-for-a-workflow-run)."
|
||||
|
||||
## Entender el archivo de flujo de trabajo
|
||||
|
||||
Para ayudarte a entender cómo se utiliza la sintaxis de YAML para crear un flujo de trabajo, esta sección explica cada línea del ejemplo de la introducción:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
name: learn-github-actions
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
<em>Opcional</em> - El nombre del flujo de trabajo ta como aparece en la pestaña de Acciones del repositorio de {% data variables.product.prodname_dotcom %}.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
on: [push]
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Especifica el activador de este flujo de trabajo. Este ejemplo utiliza el evento <code>push</code>, así que una ejecución de flujo de trabajo se activa cada que alguien sube un cambio al repositorio o fusiona una solicitud de cambios. This is triggered by a push to every branch; for examples of syntax that runs only on pushes to specific branches, paths, or tags, see "<a href="/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore">Workflow syntax for {% data variables.product.prodname_actions %}</a>."
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Agrupa los jobs que se ejecutan en el flujo de trabajo <code>learn-github-actions</code>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
check-bats-version:
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Define un job que se llame <code>check-bats-version</code>. Las llaves hijas definirán las propiedades del job.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
runs-on: ubuntu-latest
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Configura el job para que se ejecute en la versión más reciente de un ejecutor Ubuntu Linux. Esto significa que el job se ejecutará en una máquina virtual nueva que se hospede en GitHub. For syntax examples using other runners, see "<a href="/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on">Workflow syntax for {% data variables.product.prodname_actions %}</a>."
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
steps:
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Agrupa todos los pasos que se ejecutan en el job <code>check-bats-version</code>. Cada elemento anidado debajo de esta sección es una acción o script de shell por separado.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
- uses: {% data reusables.actions.action-checkout %}
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
The <code>uses</code> keyword specifies that this step will run <code>v3</code> of the <code>actions/checkout</code> action. Esta es una acción que comprueba tu repositorio en el ejecutor, lo cual te permite ejecutar scripts u otras acciones contra tu código (tales como herramientas de compilación y prueba). Debes utilizar la acción de verificación en cualquier momento en el que tu flujo de trabajo se ejecute contra el código del repositorio.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
- uses: {% data reusables.actions.action-setup-node %}
|
||||
with:
|
||||
node-version: '14'
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
This step uses the <code>{% data reusables.actions.action-setup-node %}</code> action to install the specified version of the Node.js (this example uses v14). Esto pone a los comandos <code>node</code> y <code>npm</code> en tu <code>PATH</code>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
- run: npm install -g bats
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
La palabra clave <code>run</code> le dice al job que ejecute un comando en el ejecutor. Ene ste caso, estás utilizando <code>npm</code> para instalar el paquete de pruebas del software <code>bats</code>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
```yaml
|
||||
- run: bats -v
|
||||
```
|
||||
</td>
|
||||
<td>
|
||||
Finalmente, ejecutarás el comando <code>bats</code> con un parámetro que producirá la versión del software.
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### Visualizar el archivo de flujo de trabajo
|
||||
|
||||
En este diagrama, puedes ver el archivo de flujo de trabajo que acabas de crear, así como la forma en que los componentes de {% data variables.product.prodname_actions %} se organizan en una jerarquía. Cada paso ejecuta una acción o script de shell simples. Los pasos 1 y 2 ejecutan acciones, mientras que los pasos 3 y 4 ejecutan scripts de shell. Para encontrar más acciones preconstruidas para tus flujos de trabajo, consulta la sección "[Encontrar y personalizar acciones](/actions/learn-github-actions/finding-and-customizing-actions)".
|
||||
|
||||
|
||||
|
||||
## Viewing the activity for a workflow run
|
||||
|
||||
When your workflow is triggered, a _workflow run_ is created that executes the workflow. After a workflow run has started, you can see a visualization graph of the run's progress and view each step's activity on {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
1. Debajo del nombre de tu repositorio, da clic en **Acciones**.
|
||||
|
||||
|
||||
1. En la barra lateral izquierda, da clic en el flujo de trabajo que quieres ver.
|
||||
|
||||
|
||||
1. Debajo de "Ejecuciones de flujo de trabajo", da clic en el nombre de la ejecución que quieres ver.
|
||||
|
||||
|
||||
1. Debajo de **Jobs** o en la gráfica de visualización, da clic en el job que quieras ver.
|
||||
|
||||
|
||||
1. View the results of each step.
|
||||
|
||||
|
||||
@@ -1 +1 @@
|
||||
1. Optionally, under the billing summary at the top of the page click **Get usage report** to email a CSV report of storage use for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_registry %}, and {% data variables.product.prodname_codespaces %} in each of your enterprise account's organizations to the primary email address for the account. 
|
||||
1. Opcionalmente, bajo el resumen de facturación en la parte superior de la página, haz clic en **Obtener reporte de uso** para enviar un reporte de CSV por correo electrónico sobre el uso de almacenamiento de {% data variables.product.prodname_actions %}, el {% data variables.product.prodname_registry %} y {% data variables.product.prodname_codespaces %} en cada una de las organizaciones de tu cuenta empresarial para la dirección de correo electrónico principal de la cuenta. 
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
1. Dentro de "Personas {% octicon "person" aria-label="The People icon" %}", haz clic en **Administrators (Administradores)**.
|
||||
|
||||
![Administrators tab]{% ifversion ghec%}(/assets/images/help/business-accounts/business-accounts-admin-tab-dotcom.png){% else %}{% if enterprise-membership-view-improvements %}(/assets/images/help/business-accounts/business-accounts-admin-tab-new.png){% else %}(/assets/images/help/business-accounts/business-accounts-admin-tab.png){% endif %}{% endif %}
|
||||
![Pestaña de administrador]{% ifversion ghec%}(/assets/images/help/business-accounts/business-accounts-admin-tab-dotcom.png){% else %}{% if enterprise-membership-view-improvements %}(/assets/images/help/business-accounts/business-accounts-admin-tab-new.png){% else %}(/assets/images/help/business-accounts/business-accounts-admin-tab.png){% endif %}{% endif %}
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user