# service-accounts Source: https://docs.applivery.com/es/platform/api/service-accounts/ --- --- title: Cuentas de servicio description: >- Cuentas de servicio de Applivery para acceso a la API seguro y automatizado — roles, permisos y buenas prácticas para la gestión de tokens. slug: service-accounts collection: docs locale: es visible: true canonical: 'https://docs.applivery.com/es/platform/api/service-accounts/' category: Distribución de apps section: API platform: API audience: administrators difficulty: intermediate keywords: - Cuenta de servicio - API - automatización - token Bearer - Workspace API - CI/CD - seguridad item_name: Cuentas de servicio schema_type: TechArticle language: es domain: api-management capability: api-authentication headline: Entender y usar las Cuentas de servicio para el acceso a la API target_keyword: Cuenta de servicio Applivery secondary_keywords: - Workspace API - token Bearer - autenticación API intent: informational reading_time: 8 prerequisites: - Comprensión básica de las APIs - Familiaridad con la plataforma Applivery - Conocimiento de los métodos de autenticación content_type: article applivery_type: docs_product llm_summary: >- Las Cuentas de servicio de Applivery son un tipo especial de cuenta para la autenticación no humana. Se autentican contra la Workspace API usando un token Bearer y proporcionan acceso a nivel de Workspace para automatización transversal de apps. Hay tres roles: Admin, Developer y Viewer. El token solo se muestra una vez al crearse — debe copiarse de inmediato. answers_questions: - ¿Qué es una Cuenta de servicio de Applivery? - ¿Cómo se autentican las Cuentas de servicio? - ¿Cuándo debo usar una Cuenta de servicio en lugar de un App API Token? - ¿Qué roles puedo asignar a una Cuenta de servicio? - ¿Cómo creo una Cuenta de servicio en Applivery? version: '' reviewer: '' faq_items: - question: ¿Qué es una Cuenta de servicio de Applivery? answer: >- Una Cuenta de servicio es un tipo especial de cuenta de Applivery para la autenticación no humana, que representa un sistema automatizado que interactúa con la API de Applivery. - question: ¿Cómo se autentican las Cuentas de servicio? answer: >- Las Cuentas de servicio se autentican contra la Workspace API usando un token Bearer, lo que les da acceso a nivel de Workspace. - question: ¿Cuándo debo usar una Cuenta de servicio en lugar de un App API Token? answer: >- Usa una Cuenta de servicio para el acceso a nivel de Workspace (múltiples apps) y la Workspace API. Usa un App API Token para el acceso a una sola app y la API de Integraciones. - question: ¿Qué roles puedo asignar a una Cuenta de servicio? answer: >- Puedes asignar los roles Admin (acceso completo), Developer (acceso a recursos de apps) o Viewer (solo lectura) a una Cuenta de servicio. - question: ¿Cómo creo una Cuenta de servicio en Applivery? answer: >- Ve a Ajustes del Workspace > Cuentas de servicio y haz clic en '+ Crear Cuenta de servicio'. Debes tener permisos de Admin. - question: ¿Dónde encuentro el token Bearer de la Cuenta de servicio? answer: >- El token Bearer se muestra después de crear la Cuenta de servicio. Cópialo de inmediato, ya que no se puede recuperar más adelante. - question: >- ¿Cómo debo almacenar de forma segura el token Bearer de la Cuenta de servicio? answer: >- Guarda el token como secreto en tu plataforma de CI/CD o gestor de secretos, y nunca lo confirmes en el control de versiones. - question: ¿Qué funciones de Applivery requieren una Cuenta de servicio? answer: >- La Workspace API, la integración BrowserStack App Live y los scripts de automatización transversal de apps requieren una Cuenta de servicio. how_to_steps: [] updatedDate: '2026-06-08' show_child_grid: true featured: false noindex: false evergreen: false pillar_content: false og_title: 'Cuentas de servicio de Applivery: acceso seguro a la API' og_description: >- Aprende a usar las Cuentas de servicio de Applivery para el acceso a la API seguro y automatizado. Entiende los roles, permisos y buenas prácticas. og_type: article og_template: gradient-modern twitter_card: summary_large_image summary: >- Las Cuentas de servicio de Applivery proporcionan una forma segura para que entidades no humanas como sistemas automatizados y pipelines de CI/CD interactúen con la API de Applivery. Usan tokens Bearer para la autenticación y ofrecen acceso a nivel de Workspace, lo que permite la automatización transversal de apps y las integraciones a nivel de plataforma. tldr: >- Las Cuentas de servicio de Applivery permiten el acceso a la API seguro y automatizado para entidades no humanas usando tokens Bearer y permisos a nivel de Workspace. answer_target: >- Una Cuenta de servicio de Applivery es un tipo especial de cuenta diseñada para la autenticación no humana con la API de Applivery. Usa un token Bearer para la autenticación y proporciona acceso a nivel de Workspace, lo que permite a los sistemas automatizados, integraciones o pipelines interactuar con los recursos de todas las apps y módulos de tu organización. key_takeaways: - Las Cuentas de servicio son para el acceso a la API no humano. - Los tokens Bearer proporcionan acceso a nivel de Workspace. - Almacena y rota los tokens de forma segura regularmente. - Elige el rol apropiado basándote en el principio de mínimo privilegio. - Entiende la diferencia entre las Cuentas de servicio y los App API Tokens. main_topics: - Creación de Cuentas de servicio - Roles y permisos - Uso del token Bearer - Almacenamiento seguro de tokens - Cuenta de servicio vs App API Token entities: - Applivery - Workspace API - BrowserStack App Live - GitHub Actions - Azure Pipelines - Bitrise - Jenkins related_queries: - ¿Qué es una Cuenta de servicio de Applivery? - ¿Cómo creo una Cuenta de servicio de Applivery? - ¿Cuáles son los diferentes roles para las Cuentas de servicio de Applivery? - ¿Cómo uso un token Bearer para la autenticación de la API? - ¿Dónde debo guardar el token de la Cuenta de servicio de Applivery? - ¿Cuál es la diferencia entre una Cuenta de servicio y un App API Token? - ¿Cómo gestionar las Cuentas de servicio existentes de Applivery? - ¿Cómo rotar los tokens de las Cuentas de servicio de Applivery? related_topics: - app-api-token - workspace-api - api-authentication content_scope: comprehensive confidence_level: well-established limitations: Esta guía ofrece una cobertura completa del tema. update_frequency: occasionally word_count: 858 sources: [] organization: Not specified fact_checker: '' related_articles: [] see_also: [] translations: en: content/en/docs/platform/api/service-accounts.mdx translation_key: platform-service-accounts faqs: - question: ¿Qué es una Cuenta de servicio de Applivery? answer: >- Una Cuenta de servicio es un tipo especial de cuenta de Applivery para la autenticación no humana, que representa un sistema automatizado que interactúa con la API de Applivery. - question: ¿Cómo se autentican las Cuentas de servicio? answer: >- Las Cuentas de servicio se autentican contra la Workspace API usando un token Bearer, lo que les da acceso a nivel de Workspace. - question: ¿Cuándo debo usar una Cuenta de servicio en lugar de un App API Token? answer: >- Usa una Cuenta de servicio para el acceso a nivel de Workspace (múltiples apps) y la Workspace API. Usa un App API Token para el acceso a una sola app y la API de Integraciones. - question: ¿Qué roles puedo asignar a una Cuenta de servicio? answer: >- Puedes asignar los roles Admin (acceso completo), Developer (acceso a recursos de apps) o Viewer (solo lectura) a una Cuenta de servicio. - question: ¿Cómo creo una Cuenta de servicio en Applivery? answer: >- Ve a Ajustes del Workspace > Cuentas de servicio y haz clic en '+ Crear Cuenta de servicio'. Debes tener permisos de Admin. - question: ¿Dónde encuentro el token Bearer de la Cuenta de servicio? answer: >- El token Bearer se muestra después de crear la Cuenta de servicio. Cópialo de inmediato, ya que no se puede recuperar más adelante. - question: >- ¿Cómo debo almacenar de forma segura el token Bearer de la Cuenta de servicio? answer: >- Guarda el token como secreto en tu plataforma de CI/CD o gestor de secretos, y nunca lo confirmes en el control de versiones. - question: ¿Qué funciones de Applivery requieren una Cuenta de servicio? answer: >- La Workspace API, la integración BrowserStack App Live y los scripts de automatización transversal de apps requieren una Cuenta de servicio. updated_date: '2026-06-08' type: article doc-type: api-reference section: "api-reference" --- Una Cuenta de servicio es un tipo especial de cuenta de Applivery diseñada para la autenticación no humana, de máquina a máquina. A diferencia de las cuentas de usuario, que están vinculadas a una persona, una Cuenta de servicio representa un sistema automatizado, una integración o un pipeline que necesita interactuar con la API de Applivery por su propia cuenta. Las Cuentas de servicio se autentican contra la **Workspace API** (API de Organizaciones) usando un token Bearer. Esto les da acceso a nivel de Workspace a los recursos de todas las apps y módulos de tu organización, lo que las convierte en las credenciales adecuadas para la automatización transversal de apps y las integraciones a nivel de plataforma. * * * ## Cuentas de servicio vs. App API Tokens Applivery tiene dos mecanismos de autenticación distintos. Elegir el correcto para tu caso de uso es importante: | | Cuenta de servicio | App API Token | | --- | --- | --- | | **Ámbito** | A nivel de Workspace — todas las apps de la organización | Solo una app | | **Se usa para** | Workspace API (API de Organizaciones) | API de Integraciones (subida por app, Publicaciones, Builds) | | **Casos de uso típicos** | Automatización transversal de apps, BrowserStack App Live, scripts a nivel de Workspace | Subidas de Builds desde CI/CD, integraciones por app | | **Formato del token** | Token Bearer | Cadena de App Token | | **Se crea en** | Ajustes del Workspace → Cuentas de servicio | Ajustes de la app → API Tokens | Si necesitas subir Builds desde un pipeline de CI/CD para una sola app, usa un [App API Token](https://docs.applivery.com/es/app-distribution/api/app-api-token/). Si necesitas consultar o gestionar recursos en múltiples apps, o conectar una plataforma de terceros como BrowserStack App Live, usa una Cuenta de servicio. * * * ## Roles y permisos Al crear una Cuenta de servicio, le asignas uno de tres roles. El rol determina qué operaciones puede realizar la Cuenta de servicio en todo el Workspace: | Rol | Descripción | | --- | --- | | **Admin** | Acceso completo a todos los recursos y ajustes del Workspace. Puede crear, modificar y eliminar cualquier recurso. | | **Editor** | Acceso de lectura y escritura a los recursos de la app (Builds, Publicaciones, configuraciones). No puede gestionar los ajustes del Workspace ni otros usuarios. | | **Visualizador** | Acceso de solo lectura a los recursos del Workspace. No puede crear ni modificar ningún dato. | :::tip Sigue el principio de mínimo privilegio: asigna el rol más restrictivo que permita a la Cuenta de servicio realizar su función prevista. ::: * * * ## Crear una Cuenta de servicio Las Cuentas de servicio se gestionan desde los Ajustes del Workspace. Solo los usuarios con permisos de **Admin** pueden crear o eliminar Cuentas de servicio. En el [**panel de Applivery**](https://dashboard.applivery.io/), dirígete a los **Ajustes del Workspace** 1 desde el menú desplegable superior, luego abre **Cuentas de servicio** 2 en el menú de la izquierda y haz clic en el botón **\+ Crear Cuenta de Servicio** 3. ![Service Account](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/7b329256-a6af-40b1-a101-837f11ca1866.png) Introduce un nombre descriptivo para la cuenta (ej: `ci-pipeline`, `browserstack-integration`) y selecciona un **Rol**: Admin, Developer o Viewer. Una vez listo, haz clic en **Crear**. :::warning Recuerda que también tendrás que conceder permisos a la Cuenta de servicio según el segmento en el que quieras usarla. Puedes leer más sobre la asignación de permisos basada en segmentos en el siguiente [enlace](https://docs.applivery.com/es/device-management/general-settings/segments/#how-to-create-segments-and-permissions). ::: Se mostrarán los detalles de la Cuenta de servicio: | Campo | Descripción | | --- | --- | | **Cuenta** | El identificador de la Cuenta de servicio, con el formato `{service-account-id}@{organization-id}.iam.applivery.io` | | **Token Bearer** | El token de autenticación utilizado en las solicitudes a la API. | :::warning Copia el token Bearer de inmediato. Por razones de seguridad, Applivery no vuelve a mostrar el token completo después de salir de esta pantalla. Si pierdes el token, tendrás que eliminar la Cuenta de servicio y crear una nueva. ::: * * * ## Usar el token Bearer en las solicitudes a la API Incluye el token Bearer en la cabecera `Authorization` de cada solicitud a la Workspace API: ```bash curl 'https://api.applivery.io/v1/organizations/{organizationId}/...' \ -H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN' ``` Sustituye `YOUR_SERVICE_ACCOUNT_TOKEN` por el token copiado durante la creación, y `{organizationId}` por el identificador de tu organización. * * * ## Almacenar el token de forma segura El token Bearer concede acceso a nivel de Workspace. Trátalo como una contraseña: - **Nunca lo confirmes en el control de versiones.** Guárdalo como secreto en tu plataforma de CI/CD, gestor de secretos o variable de entorno. - **Una Cuenta de servicio por integración.** Crea una Cuenta de servicio separada para cada sistema externo (ej: una para BrowserStack, otra para un script de automatización del Workspace). Esto limita el impacto si un token se ve comprometido y facilita su rotación sin afectar a otros sistemas. - **Rota los tokens periódicamente.** Elimina y recrea las Cuentas de servicio como parte de tu política regular de rotación de credenciales. **Plataformas de CI/CD — dónde guardar el token:** | Plataforma | Dónde guardar | | --- | --- | | GitHub Actions | Secreto del repositorio o de la organización | | Azure Pipelines | Variable del pipeline (secreto) | | Bitrise | Secreto (con el toggle Protegido activado) | | Jenkins | Credencial de Jenkins (texto secreto) | * * * ## Gestionar las Cuentas de servicio existentes Todas las Cuentas de servicio de tu Workspace aparecen en la sección **Cuentas de servicio** de los **Ajustes del Workspace**. Desde esta vista puedes: - **Ver** el identificador de la cuenta y el rol de cada Cuenta de servicio. - **Eliminar** una Cuenta de servicio para revocar su acceso de inmediato. Cualquier sistema que use el token de la cuenta eliminada recibirá errores `401 Unauthorized` en las solicitudes posteriores. No hay forma de recuperar o regenerar un token de una Cuenta de servicio existente. Si un token necesita reemplazarse, elimina la cuenta y crea una nueva. * * * ## Dónde se requieren las Cuentas de servicio Las siguientes funciones e integraciones de Applivery se autentican mediante el token Bearer de una Cuenta de servicio: | Función | Motivo | | --- | --- | | Workspace API (API de Organizaciones) | Todos los endpoints de la Workspace API requieren autenticación con Cuenta de servicio. | | Integración BrowserStack App Live | App Live se conecta a tu Workspace de Applivery usando el token Bearer de una Cuenta de servicio. | | Scripts de automatización transversal de apps | Cualquier script que lee o escribe datos en múltiples apps necesita acceso a nivel de Workspace. |