Skip to main content
User identity and end-to-end encryption on webAI are split across two focused facades:
FacadePurpose
sdk.identityRead the user’s device identity (), display name, profile image, and authentication state. Update display name and generate short ODID forms.
sdk.cryptoEncrypt and decrypt data with end-to-end encryption using peer public keys.
Apps access them through the platform bridge object:
const sdk = window.apogeeSDK || null;
if (!sdk) return;
const identity = sdk.identity.getState();
Declare identity and crypto in your shell manifest under requires.managers as needed.

Full reference

The complete reference for each facade lives in the in-app Developer panel.

Open the Developer panel

  1. Open Settings → Experimental and toggle Developer Mode on.
  2. A terminal icon appears in the top right of the app. Click it to open the Developer panel.
  3. Go to the Documentation section → Docs tab → identity or crypto.

End-to-end encryption

The sdk.crypto facade provides encryption primitives for securely exchanging data with other peers. You pass the recipient’s public key (as a JSON Web Key) when encrypting, and your own private key when decrypting received data. See the Developer panel for the current method signatures, parameter shapes, and interactive examples.

Learn more

Build apps

Build your first app using the webAI SDK and platform facades.

Terminology

ODID, public keys, CRDT, WebGPU — a glossary of platform terms.