Security and sign-in

Single sign-on configuration

GET/api/w/:wid/sso

Issuer, client id, domains and their verification records, default role, enforcement. Never the client secret, only its fingerprint.

#Authentication

Session cookie

A signed-in person: the console's session cookie. Every state-changing request also carries the header x-immiscible-csrf: 1, and the member's role decides what it may do. Bearer tokens are ignored on these routes, so no machine credential can reach them.

#Path parameters

widstringrequired

Workspace id

Request

curl "https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/sso" \
  -H "cookie: __Host-sid=$IMMISCIBLE_SESSION"

const res = await fetch('https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/sso', {
  headers: {
    cookie: `__Host-sid=${process.env.IMMISCIBLE_SESSION}`,
  },
});
const data = await res.json();
console.log(res.status, data);

import os
import requests

res = requests.get(
    "https://immiscible.fly.dev/api/w/$IMMISCIBLE_WORKSPACE/sso",
    headers={
        "cookie": f"__Host-sid={os.environ['IMMISCIBLE_SESSION']}",
    },
)
print(res.status_code, res.json())