v1.16.0: la app de macOS por fin se firma de verdad
El build NUNCA firmó la app de macOS. Al no pasarle ninguna identidad, el bundler de Tauri se saltaba `codesign` entero y el .dmg salía con la firma ad hoc que deja el enlazador: Identifier=labstream_desktop-0a5819ba37119701 flags=0x20002(adhoc,linker-signed) Info.plist=not bound Sealed Resources=none Tres cosas mal, y ninguna avisaba en ningún log: · El Entitlements.plist del repo era DECORACIÓN. Los entitlements se escriben al firmar; sin firma, el micrófono, la cámara y el JIT nunca pidieron nada porque nunca estuvieron pedidos. · Ni el Info.plist ni los recursos iban dentro de la firma: se podían cambiar sin romperla. · El identificador era el del enlazador y no `co.labstream.os`, que es por el que macOS recuerda los permisos que le concedes a una app. AHORA. `APPLE_SIGNING_IDENTITY` se calcula en un paso propio y no en el `env:` del build, porque un secret que no existe llega como cadena VACÍA y Tauri lee `APPLE_CERTIFICATE=""` como «hay certificado» y revienta al importarlo. Solo se exporta lo que tiene valor: · con Developer ID → firma real, y notarizado si están las tres claves; · sin él → identidad "-", firma AD HOC. No engaña a Gatekeeper, pero sella los recursos, ata el Info.plist y APLICA LOS ENTITLEMENTS. En cuanto Jonathan añada los secrets, la siguiente etiqueta sale firmada de verdad sin tocar un solo archivo. ENSAYADO sobre una copia de la app instalada, con el mismo comando que va a correr el CI. Antes y después: flags=0x20002(adhoc,linker-signed) → flags=0x10002(adhoc,runtime) Identifier=labstream_desktop-0a58… → Identifier=co.labstream.os Info.plist=not bound → Info.plist entries=17 Sealed Resources=none → Sealed Resources version=2 rules=13 (sin entitlements) → allow-jit, audio-input, camera Y EL ENSAYO ENCONTRÓ UNA TRAMPA que `plutil -lint` no ve: el Entitlements.plist llevaba `--entitlements` dentro de un comentario XML, y dos guiones seguidos ahí son XML inválido. plutil lo aceptaba; AMFI, que es quien lo lee de verdad dentro de codesign, contestaba «Failed to parse entitlements» y la firma fallaba. Queda avisado en el propio archivo. De paso se cae `com.apple.security.network.client`: es exclusiva del App Sandbox y esta app no lo usa, así que no hacía nada. LA RED QUE FALTABA: un paso nuevo comprueba la firma del .app y TUMBA la publicación si los entitlements no llegaron. Que esto estuviera roto no lo dijo nada durante meses; se descubrió a mano persiguiendo otra cosa. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Este commit está contenido en:
78
README.md
78
README.md
@@ -229,20 +229,72 @@ Es la forma de mirar un cambio visual —la barra, los colores— sin sacárselo
|
||||
|
||||
---
|
||||
|
||||
## Avisos de seguridad del sistema (instalación interna sin firmar)
|
||||
## Firma de macOS
|
||||
|
||||
Como los instaladores **no están firmados** con certificado de pago, la primera
|
||||
vez cada sistema muestra una advertencia. Es normal para apps internas:
|
||||
### Lo que pasaba hasta la 1.15.0
|
||||
|
||||
- **Windows (SmartScreen):** pantalla azul *"Windows protegió su PC"* →
|
||||
**Más información → Ejecutar de todos modos**.
|
||||
- **macOS (Gatekeeper):** *"no se puede abrir porque proviene de un desarrollador
|
||||
no identificado"* → clic derecho sobre la app → **Abrir** → **Abrir**. (Si
|
||||
insiste, ejecutar una vez: `xattr -cr "/Applications/Labstream OS.app"`.)
|
||||
El build **no firmaba** la app de macOS. No se le pasaba ninguna identidad, así que
|
||||
el bundler de Tauri se saltaba `codesign` entero y el `.dmg` salía con la firma ad hoc
|
||||
que deja el enlazador. En la app instalada se veía así:
|
||||
|
||||
Si en el futuro se distribuye a clientes externos, conviene firmar:
|
||||
*code signing* en Windows (~150–400 USD/año) y un *Apple Developer ID* + notarizado
|
||||
en Mac (99 USD/año) para quitar estos avisos.
|
||||
```
|
||||
$ codesign -dv "/Applications/Labstream OS.app"
|
||||
Identifier=labstream_desktop-0a5819ba37119701
|
||||
CodeDirectory ... flags=0x20002(adhoc,linker-signed)
|
||||
Info.plist=not bound
|
||||
Sealed Resources=none
|
||||
TeamIdentifier=not set
|
||||
```
|
||||
|
||||
Tres cosas mal, y ninguna avisaba:
|
||||
|
||||
- **`Entitlements.plist` no se aplicaba.** Los permisos de micrófono, cámara y JIT
|
||||
eran decoración: se escriben al firmar, y no se firmaba.
|
||||
- **`Info.plist=not bound` y `Sealed Resources=none`.** Ni el Info.plist ni los
|
||||
recursos iban dentro de la firma: cualquiera podía cambiarlos sin romperla.
|
||||
- **Identificador de enlazador** (`labstream_desktop-<hash>`) en vez del de la app
|
||||
(`co.labstream.os`), que es por lo que macOS recuerda los permisos concedidos.
|
||||
|
||||
### Lo que hace ahora (desde la 1.16.0)
|
||||
|
||||
`build.yml` decide según los secrets que haya en el repo:
|
||||
|
||||
| Secrets | Resultado |
|
||||
| --- | --- |
|
||||
| ninguno | Firma **ad hoc** (`-s -`) con hardened runtime y los entitlements. Gatekeeper sigue avisando, pero el bundle va sellado y los permisos se aplican. |
|
||||
| `APPLE_CERTIFICATE` + `APPLE_CERTIFICATE_PASSWORD` | Firma real con **Developer ID**. Gatekeeper deja de avisar en cualquier Mac. |
|
||||
| …y además `APPLE_ID` + `APPLE_PASSWORD` + `APPLE_TEAM_ID` | Firma real + **notarizado y grapado**. Ni el primer arranque avisa. |
|
||||
|
||||
Y hay un paso que **tumba la publicación** si los entitlements no llegaron al `.app`.
|
||||
Ese paso es la lección: que esto estuviera roto no lo dijo nada durante meses.
|
||||
|
||||
### Pasar a Developer ID (99 USD/año)
|
||||
|
||||
1. Alta en el Apple Developer Program.
|
||||
2. En *Certificates* crear uno de tipo **Developer ID Application** y exportarlo del
|
||||
Llavero como `.p12` con contraseña.
|
||||
3. Convertirlo a texto: `base64 -i certificado.p12 | pbcopy`.
|
||||
4. En GitHub → *Settings ▸ Secrets and variables ▸ Actions*, añadir:
|
||||
- `APPLE_CERTIFICATE` — lo que quedó en el portapapeles.
|
||||
- `APPLE_CERTIFICATE_PASSWORD` — la contraseña del `.p12`.
|
||||
- `APPLE_SIGNING_IDENTITY` — opcional; por defecto `Developer ID Application`.
|
||||
5. Para notarizar, además:
|
||||
- `APPLE_ID` — el correo de la cuenta de desarrollador.
|
||||
- `APPLE_PASSWORD` — una **contraseña específica de app** (appleid.apple.com, no la
|
||||
del Apple ID).
|
||||
- `APPLE_TEAM_ID` — el identificador de equipo de 10 caracteres.
|
||||
|
||||
No hay que tocar ni un archivo: en cuanto los secrets existan, la siguiente etiqueta
|
||||
sale firmada.
|
||||
|
||||
### Mientras siga ad hoc
|
||||
|
||||
- **macOS (Gatekeeper):** *"no se puede abrir porque proviene de un desarrollador no
|
||||
identificado"* → clic derecho sobre la app → **Abrir** → **Abrir**. (Si insiste:
|
||||
`xattr -cr "/Applications/Labstream OS.app"`.)
|
||||
- **Windows (SmartScreen):** *"Windows protegió su PC"* → **Más información →
|
||||
Ejecutar de todos modos**. Windows es aparte: su firma cuesta 150–400 USD/año y no
|
||||
la toca nada de lo de arriba.
|
||||
|
||||
---
|
||||
|
||||
@@ -257,10 +309,10 @@ labstream-desktop/
|
||||
│ ├── tauri.conf.json nombre, versión, iconos, instaladores, entitlements
|
||||
│ ├── Cargo.toml dependencias Rust + versión
|
||||
│ ├── Info.plist textos de permiso (micrófono/cámara) en macOS
|
||||
│ ├── Entitlements.plist entitlements de macOS (audio-input, cámara, red)
|
||||
│ ├── Entitlements.plist entitlements de macOS (micrófono, cámara, JIT)
|
||||
│ ├── build.rs
|
||||
│ ├── capabilities/default.json
|
||||
│ ├── icons/ se generan desde app-icon.png
|
||||
│ └── src/{main.rs,lib.rs} lib.rs crea la ventana + SERVER_URL + tray
|
||||
└── .github/workflows/build.yml build automático de .exe (Windows) y .dmg (macOS)
|
||||
└── .github/workflows/build.yml build de .exe (Windows) y .dmg (macOS) + firma de macOS
|
||||
```
|
||||
|
||||
Referencia en una nueva incidencia
Block a user