Organizaciones

Una organización agrupa credenciales bajo un solo propietario para que varias personas puedan compartirlas: API keys para la JSON API y usuarios proxy para el proxy port. Todo lo que consumen las credenciales de una organización se descuenta del plan del propietario de la organización, no de la persona que envió la request.

Dónde encontrarlo

Inicia sesión en el dashboard y abre Organizations en la barra lateral. Cada organización a la que perteneces aparece como una fila:

Columna	Qué muestra
Organización	El nombre. Haz clic en él, o en Open, para ir a la página de la organización.
Tu rol	Owner, Admin o Member
Miembros	Cuántas personas forman parte de ella, incluido el owner
Keys	Cuántas API keys posee la organización
Creado	Cuándo se creó
Acciones	Open

Crear una organización

Haz clic en New organization, introduce un nombre de entre 2 y 60 caracteres y confirma. Te convertirás en el owner. El nombre debe contener al menos una letra o dígito, y no puede coincidir con el de una organización existente (se comparan letras y dígitos; el resto se ignora).

Crear una organización requiere un plan que cubra a más de una persona. La fila Organizations you own en Usage & Limits muestra si tu plan lo admite.

Roles

Hay tres, y cada organización tiene exactamente un owner.

Rol	Qué puede hacer
Member	Crear y usar las API keys y usuarios proxy de la organización, renombrar sus API keys y ver los miembros y equipos de la organización
Admin	Todo lo que puede hacer un member, además de añadir y eliminar personas, cambiar sus roles, gestionar todas las credenciales de la organización y renombrar la organización
Owner	Todo lo que puede hacer un admin, además de transferir la organización a otra persona. El owner mantiene el plan contra el que se facturan todas las credenciales de la organización.

El owner no puede ser eliminado, no puede salir y no puede ser degradado. La propiedad se transfiere en una sola dirección: mediante transferencia.

Pertenecer a la organización es lo que otorga acceso a sus credenciales. Un member sin permisos de admin puede crear una key o un usuario proxy pagado por la empresa, que es el objetivo: un desarrollador que escribe collectors no debería necesitar una credencial personal que le facture silenciosamente a él en lugar de a la empresa.

La página de la organización

Open en cualquier fila te lleva a la página de esa organización. Seis tarjetas se ubican en la parte superior: Members (con el desglose de owner, admin y member debajo), Your role, Owner, API keys, Proxy users y Teams. Debajo de ellas, dos pestañas:

• Members: las personas en la organización, además de los controles que te otorga tu rol.
• Teams: los equipos a los que perteneces dentro de esta organización, en modo de solo lectura.

Los owners y admins también tienen un botón Rename en el encabezado de la página.

Añadir personas

Los owners y admins disponen de una tarjeta Add a member encima de la tabla de Members. Introduce una dirección de correo electrónico, selecciona Member o Admin y envía el formulario.

Lo que sucede a continuación depende de la dirección, y el dashboard te indica cuál fue el caso:

• La dirección ya tiene una cuenta de FourA: se une de inmediato y recibe un correo electrónico indicando la organización, quién la agregó y qué permisos tiene su rol.
• La dirección no tiene cuenta: FourA le envía una invitación por correo electrónico y se une en el momento en que inicia sesión con esa dirección. No hay nada que presionar, y la invitación funciona tanto si se registra por primera vez como si ya tenía una cuenta que nunca había abierto.

Las invitaciones caducan después de 14 días. Volver a agregar la misma dirección actualiza la invitación pendiente en lugar de acumular una segunda.

El owner recibe un correo electrónico cada vez que alguien se une, ya que el nuevo integrante consume los créditos del owner. Nadie recibe un correo de confirmación por su propia acción.

Pending Invitations

Mientras haya al menos una invitación abierta, aparece una tabla de Invitations encima de Members, visible para owners y admins. En ella se listan la dirección, el rol asignado, quién envió la invitación y cuándo. Las invitaciones caducadas permanecen en la lista y quedan marcadas para que puedas ver por qué nadie se unió. Utiliza la acción en la fila para retirar una invitación.

Changing a Role

Los owners y admins pueden cambiar el rol de un integrante entre Member y Admin mediante el menú desplegable en la columna Role. Tres reglas:

• No puedes cambiar tu propio rol. Pídeselo a otro admin o sal de la organización.
• El rol del owner no se puede editar aquí. Utiliza Make owner en su lugar.
• Cada cambio solicita confirmación previa y detalla qué podrá hacer la persona a partir de ese momento.

Removing Someone, and Leaving

Los owners y admins disponen de la opción Remove en todas las filas excepto en la suya propia y en la del owner. Tu propia fila muestra Leave, sin importar tu rol.

Eliminar a alguien también lo retira de los equipos de la organización, por lo que deja de ver sus credenciales de inmediato. Esto no afecta a las credenciales en sí: la key o el usuario proxy de una organización pertenecen a la organización, no a quien los creó.

El owner no puede ser eliminado ni abandonar la organización. Transfiere la organización primero.

Handing the Organization Over

Solo el owner puede hacer esto. En la pestaña Members, haz clic en Make owner en la fila de la persona que asumirá el rol y confirma.

La organización pasa a su plan: a partir de ese momento, cada request que realicen sus keys y cada túnel que abran sus usuarios proxy se descuenta de sus créditos, su tráfico, sus límites y su factura. El owner saliente pasa a ser admin y conserva todos los permisos que corresponden a un admin.

Which Keys You See

Todas las keys que pertenecen a una organización son visibles para todos los integrantes de la misma. Lo que cambia es lo que puedes hacer con ellas:

Action	Member	Admin	Owner
Usar la key, revelarla, crear nuevas keys de la organización	Sí	Sí	Sí
Renombrarla, editar su descripción	Sí	Sí	Sí
Regenerar, deshabilitar, eliminar	No	Sí	Sí
Mover la key fuera de la organización	No	No	Sí

Cambiar el nombre de una key es inofensivo. Regenerar o deshabilitar una detiene a cada colega que la esté usando en el instante en que ocurre, por lo que esas acciones corresponden a los administradores. Transferir una key fuera retira el recurso de la empresa y traslada su uso al plan propio de quien la toma, por lo que eso corresponde únicamente al owner.

Consulta Managing API Keys para ver el instructivo completo.

Qué proxy users puedes ver

Un proxy user sigue los mismos tres niveles, por las mismas razones.

Acción	Member	Admin	Owner
Usarlo, leer su contraseña, crear nuevos	Sí	Sí	Sí
Nueva contraseña, deshabilitar, eliminar, cambiar targeting guardado	No	Sí	Sí
Transferirlo fuera de la organización	No	No	Sí

El targeting guardado corresponde a los admins en lugar de a los members porque reorientarlo cambia de forma silenciosa cada conexión que toda la organización realiza con esa credencial. Una nueva contraseña corresponde allí porque rompe cada archivo de configuración en el que la credencial ya esté pegada.

El gestor de descargas de una empresa debe usar un proxy user de la organización. Uno personal deja de funcionar el día en que esa persona se marcha, y se le factura a ella. Consulta Proxy Users para ver el instructivo.

El filtro de Owner

Una vez que perteneces a una organización, aparece un menú desplegable Owner encima de Overview, Metrics, Activity, API Keys y Proxy. Tiene tres tipos de opciones: Everything, Personal y una entrada por organización. La elección se mantiene entre visitas y se aplica a cada una de esas cinco páginas.

Usage & Limits y Billing deliberadamente no admiten el filtro. Responden a "qué se me factura a mí", que es una pregunta diferente de "qué puedo ver": un member nunca ve la cuota del owner.

Atribución de facturación

Cada request realizado con una key propiedad de la organización, y cada túnel abierto con un proxy user propiedad de la organización, se factura al owner de la organización, sin importar quién lo ejecutó. Esa es la razón principal para mover una credencial a una organización: cambia contra quién se contabiliza el uso en créditos, tráfico, límites del plan y facturas.

La página Usage & Limits del owner contabiliza las credenciales de la organización junto con las personales, en la pestaña de API keys y en la de Proxy users, y divide ambas para que quede claro de dónde provino el gasto.

Teams

Cada organización recibe un equipo predeterminado llamado Everyone. Las nuevas keys se archivan en él automáticamente y todos los que se unen a la organización son añadidos a él, que es lo que hace que la membresía otorgue acceso a las keys.

La pestaña Teams enumera los equipos a los que perteneces, con tu rol en cada uno, su cantidad de miembros y las keys que te permite usar (Keys you can use). Crear y editar equipos aún no está disponible en el panel.

Relacionado

• Gestión de API keys: Crea, transfiere y gestiona keys dentro de una organización
• Usuarios proxy: Crea y transfiere usuarios proxy dentro de una organización
• Uso y límites: Miembros del equipo, organizaciones y lo que permite tu plan
• Facturación y suscripciones: Cómo el plan del propietario cubre el uso de las keys de la organización
• Resumen del panel: Todas las secciones del dashboard