0
Fork 0
mirror of https://github.com/verdaccio/verdaccio.git synced 2024-12-23 22:27:34 -05:00
verdaccio/website/translated_docs/es-ES/packages.md

146 lines
5.3 KiB
Markdown
Raw Normal View History

2017-12-16 07:29:18 -05:00
---
id: packages
title: "Acceso a Paquetes"
2017-12-16 07:29:18 -05:00
---
Es una serie de restricciones que permiten o restringen el acceso al almacenamiento local basado en unos criterios específicos.
2017-12-16 07:29:18 -05:00
Las restricciones de seguridad permanecen en los hombros de la extensión usada, por defecto `verdaccio`usa [htpasswd plugin](https://github.com/verdaccio/verdaccio-htpasswd). Si usas una extensión diferente ten en cuenta que el comportamiento podría ser diferente. La extensión por defecto no maneja por si mismo `allow_access` y `allow_publish`, se usa un soporte interno en caso que la extensión no este lista para ella.
Para mas información sobre permisos, visite [la sección de autenticación](auth.md).
2017-12-16 07:29:18 -05:00
### Uso
2017-12-16 07:29:18 -05:00
```yalm
packages:
# scoped packages
'@scope/*':
access: all
publish: all
2017-12-16 07:29:18 -05:00
proxy: server2
'private-*':
access: all
publish: all
proxy: uplink1
2017-12-16 07:29:18 -05:00
'**':
# allow all users (including non-authenticated users) to read and
# publish all packages
access: all
publish: all
proxy: uplink2
2017-12-16 07:29:18 -05:00
```
si ninguno esta especificado, por defecto uno se define
2017-12-16 07:29:18 -05:00
```yaml
packages:
'**':
access: all
publish: $authenticated
```
La lista de grupos validos de acuerdo a la extensión por defecto son
2017-12-16 07:29:18 -05:00
```js
'$all', '$anonymous', '@all', '@anonymous', 'all', 'undefined', 'anonymous'
```
Todos los usuarios reciben todo ese grupo de permisos independientemente si es anónimo o no más el grupo proveído por la extensión, en caso de ` htpasswd` se regresa el nombre de usuario por grupo. Por ejemplo, si has iniciado sesión como ` npmUser` el listado de grupos será.
2017-12-16 07:29:18 -05:00
```js
// groups without '$' are going to be deprecated eventually
'$all', '$anonymous', '@all', '@anonymous', 'all', 'undefined', 'anonymous', 'npmUser'
```
Si quieres proteger un grupo específico de paquetes bajo un grupo, necesitas hacer algo así. Vamos a usar un `Regex` que cubre los todos los páquetes prefijos con`npmuser-`. Recomendamos usar un prefijo en sus paquetes, en esa manera es mucho mas sencillo protegerlos.
2017-12-16 07:29:18 -05:00
```yaml
packages:
'npmuser-*':
access: npmuser
publish: npmuser
```
Reinicia `verdaccio` en tu terminal trata de instalar `npmuser-core`.
2017-12-16 07:29:18 -05:00
```bash
$ npm install npmuser-core
npm install npmuser-core
npm ERR! code E403
npm ERR! 403 Forbidden: npmuser-core@latest
npm ERR! A complete log of this run can be found in:
npm ERR! /Users/user/.npm/_logs/2017-07-02T12_20_14_834Z-debug.log
```
Puedes cambiar el comportamiento por defecto usando una diferente extensión de autenticación. `verdaccio` solo revisa si el usuario trata de acceder a un publicar un paquete específico pertenece al grupo correcto.
2017-12-16 07:29:18 -05:00
#### Definir múltiples grupos
2017-12-16 07:29:18 -05:00
Define múltiples grupos de acceso es sencillo, solo defínelos con espacios entre ellos.
2017-12-16 07:29:18 -05:00
```yaml
'company-*':
access: admin internal
publish: admin
proxy: server1
2017-12-16 07:29:18 -05:00
'supersecret-*':
access: secret super-secret-area ultra-secret-area
publish: secret ultra-secret-area
proxy: server1
2017-12-16 07:29:18 -05:00
```
#### Bloqueando el acceso a paquetes
2017-12-16 07:29:18 -05:00
Si quieres bloquear el acceso/publicar a un grupo de paquetes. Solo, no definas `access` y `publish`.
2017-12-16 07:29:18 -05:00
```yaml
packages:
'old-*':
'**':
access: all
publish: $authenticated
```
#### Bloqueando proxy a un grupo específico de paquetes
Podrías querer bloquear uno o varios paquetes que sean descargados desde repositorios remotos, pero al mismo tiempo, permitir otros acceder a diferentes * uplinks*.
Veamos el siguiente ejemplo:
```yaml
packages:
'jquery':
access: $all
publish: $all
'my-company-*':
access: $all
publish: $authenticated
'**':
access: all
publish: $authenticated
proxy: npmjs
```
Vamos a describir que es lo que queremos con el ejemplo de arriba:
* Quiero almacenar mi propia dependencia ` jquery` pero necesito evitar que se busque en el proxy.
* Quiero que todas mis dependencias que coincidan con `my-company-*` pero necesito evitar que dichos paquetes se actualicen vía proxy.
* Quiero que el resto de dependencias se actualicen vía proxy.
Se **consciente que el orden de la definición de los paquetes es importante y siempre usa doble wildcard**. Porque sino lo incluyes `verdaccio`lo incluirá por ti y en la forma que tus dependencias son resueltas se verá afectada.
### Configuración
2017-12-16 07:29:18 -05:00
Puedes definir multiples `paquetes`y cada uno de ellos deben tener un único ` Regex`.
2017-12-16 07:29:18 -05:00
| Propiedad | Tipo | Requerido | Ejemplo | Soporte | Descripción |
| --------- | ------- | --------- | -------------- | ------- | ---------------------------------------------------------- |
| access | string | No | $all | all | define que grupos estan permitidos para acceder al paquete |
| publish | string | No | $authenticated | all | defini que grupos estan permitidos a publicar |
| proxy | string | No | npmjs | all | limita las busquedas a un uplink específico |
| storage | boolean | No | [true,false] | all | TODO |
2017-12-16 07:29:18 -05:00
> Recomendamos ya no usar **allow_access**/**allow_publish** y **proxy_access** nunca más, esas propiedades están depreciadas y pronto serán removidas, por favor use las versiones cortas (**access**/**publish**/**proxy**).