Cuenta de Expo, Proyectos y Permisos

Estructura cuentas de Expo, proyectos de EAS y acceso basado en roles para que los equipos puedan lanzar múltiples aplicaciones bajo una organización - con propiedad clara, aislamiento de credenciales y permisos de menor privilegio.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

# Inicia sesión y vincula una nueva aplicación a un proyecto de organización
eas login
eas init

// app.json - dirige la aplicación a una organización e identifica el proyecto de EAS
{
  "expo": {
    "name": "Retail App",
    "slug": "retail-app",
    "owner": "acme-mobile",
    "extra": {
      "eas": {
        "projectId": "bd2f7e21-1ee7-47f2-8357-d7c4b50622fb"
      }
    }
  }
}

# Verifica qué cuenta es propietaria del proyecto vinculado
eas project:info

Cuándo usar esto:

• Tu equipo tiene más de un desarrollador tocando compilaciones, credenciales o variables de entorno.
• Lanzas múltiples aplicaciones (por cliente, marca o plataforma) y necesitas credenciales aisladas con facturación compartida.
• Necesitas capacidad de auditoría - quién puede enviar a la tienda, rotar secretos o invitar miembros.
• Te estás mudando de una cuenta personal a una organización sin romper aplicaciones en producción.

Ejemplo trabajado

// app.config.ts - org multi-app: patrón projectId compartido, slugs distintos por aplicación
import type { ExpoConfig } from "expo/config";
 
const APP_SLUG = "retail-consumer";
const ORG_OWNER = "acme-mobile";
 
const config: ExpoConfig = {
  name: "Acme Retail",
  slug: APP_SLUG,
  owner: ORG_OWNER,
  version: "3.1.0",
  ios: {
    bundleIdentifier: "com.acme.retail",
  },
  android: {
    package: "com.acme.retail",
  },
  extra: {
    eas: {
      projectId: "bd2f7e21-1ee7-47f2-8357-d7c4b50622fb",
    },
    appFamily: "retail",
  },
};
 
export default config;

// eas.json - los perfiles heredan credenciales de org a través del projectId vinculado
{
  "cli": {
    "version": ">= 16.0.0",
    "appVersionSource": "remote"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "environment": "development"
    },
    "preview": {
      "distribution": "internal",
      "environment": "preview"
    },
    "production": {
      "distribution": "store",
      "environment": "production",
      "autoIncrement": true
    }
  },
  "submit": {
    "production": {
      "ios": {
        "appleTeamId": "ABCDE12345"
      }
    }
  }
}

# CI: usa un token de robot con alcance mínimo - no una contraseña personal
# Panel de Expo → Configuración de cuenta → Access Tokens → Crear token
export EXPO_TOKEN="xxxxxxxxxxxxxxxxxxxxxxxx"
eas build --profile production --platform ios --non-interactive

Lo que demuestra esto:

• owner dirige la aplicación a una organización - compilaciones, credenciales y variables de entorno se limitan a acme-mobile.
• projectId es la clave duradera que los servicios de EAS usan en cambios de slug o bundle ID.
• Los perfiles de compilación se asignan a entornos sin duplicar almacenes de credenciales por desarrollador.
• Los tokens de robot para CI preservan el principio de menor privilegio - sin contraseñas personales compartidas.

Profundización

Cómo funciona

Tipos de cuenta

Cada registro en expo.dev crea una cuenta Personal. Crea una Organización cuando más de una persona necesita acceso a compilaciones, envío o credenciales.

Vinculación de proyectos de EAS

eas init  →  crea/vincula proyecto bajo cuenta activa
          →  escribe extra.eas.projectId en config de aplicación
          →  EAS Build / Update / variables de entorno se basan en projectId

• slug es legible por humanos y se usa en URLs - puede cambiar.
• projectId es un UUID - estable durante la vida útil del proyecto.
• owner determina qué almacén de credenciales y facturación de la cuenta se aplica.

Roles de organización

Asigna Developer para ingenieros que lanzan a diario. Reserva Owner para líderes y contactos de facturación. Usa Viewer para stakeholders que solo necesitan abrir compilaciones de vista previa en Expo Go.

Patrones de gobernanza multi-app

Acceso programático

• Tokens de acceso personal - vinculados a un usuario; heredan las membresías y roles de org de ese usuario.
• Usuarios/tokens de robot - para CI/CD; asigna a una org con rol Developer como mínimo para compilaciones.
• SSO - Las orgs Enterprise pueden forzar single sign-on (consulta la documentación de Expo SSO).

Notas de TypeScript

// Leyendo metadatos de proyecto vinculado en tiempo de ejecución (solo diagnósticos - no para auth)
import Constants from "expo-constants";
 
const projectId = Constants.expoConfig?.extra?.eas?.projectId;
const owner = Constants.expoConfig?.owner; // disponible en config estática
 
export function DiagnosticsBanner() {
  if (!__DEV__) return null;
  return (
    <Text>
      EAS {projectId ?? "unlinked"} · owner: {owner ?? "personal"}
    </Text>
  );
}

Nunca uses projectId u owner para autorización en la aplicación - son identificadores de tiempo de compilación, no límites de seguridad.

Errores comunes

• Compartir contraseña de cuenta personal - Sin rastro de auditoría, sin revocación por persona, viola los ToS de Expo. Solución: Crea una Organización e invita miembros con roles apropiados.
• Omitir owner en proyectos de org - eas build puede dirigirse a tu cuenta personal en lugar del equipo. Solución: Establece "owner": "org-slug" en app.json antes de eas init o transfiere el proyecto.
• Codificar credenciales por máquina desarrollador - Las claves de Apple/Google almacenadas localmente rompen CI e incorporación. Solución: Deja que EAS hospede credenciales bajo el proyecto de org; usa eas credentials para rotación.
• Otorgar Owner a cada ingeniero - Un clic equivocado puede eliminar credenciales de producción. Solución: Por defecto Developer; mantén dos Owners para cobertura de factor de autobús.
• Reutilizar un proyecto de EAS para aplicaciones no relacionadas - Credenciales, variables de entorno y canales de actualización colisionan. Solución: Un projectId por app binary (bundle ID / package).
• Transferir sin Admin en ambos lados - Los movimientos de proyectos requieren Owner o Admin en origen y destino. Solución: Usa una organización en depósito para transferencias de terceros.
• Tokens de CI en cuentas personales - El token hereda el alcance del proyecto personal; se va cuando el empleado se va. Solución: Crea un token de robot bajo la organización.

Alternativas

FAQs

eas login
eas init

Relacionado

• Ambientes y Variables de Entorno de EAS - variables de entorno a nivel de proyecto y a nivel de cuenta
• Conceptos básicos de plataforma Expo - eas init y vinculación temprana de proyectos
• Expo Go vs Development Builds - limitaciones de rol Viewer y flujos de trabajo dev-client
• app.json & app.config.js - configuración de owner, slug y extra
• Actualización de versiones de Expo SDK - coordinación de actualización a nivel de org entre múltiples proyectos
• Best Practices - lista de verificación de gobernanza para equipos de producción

Versiones de stack: Esta página se escribió para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (expo ~57.0.4).