Skip to content
SESAME
Menu

WSU values (Playbook)#

These four settings carry Wayne State's shared values. Set them in the environment, or let the private Playbook package supply them when the environment is empty, and a fresh app boots against the real services.

Open sesame, minus the incantation. Four settings carry Wayne State's shared values: where the CAS server lives, and who signs the gateway and oauth2 assertions.

Setting Config key Meaning
SESAME_CAS_BASE_URL cas.base_url The CAS server, an absolute https:// URL (http://localhost or http://127.0.0.1 only in a local environment).
SESAME_GATEWAY_ISSUER gateway.issuer The iss claim the gateway assertion must carry.
SESAME_OAUTH2_ISSUER oauth2.issuer The iss claim the bearer token must carry.
SESAME_OAUTH2_JWKS_URL oauth2.jwks_url The URL of the issuer's key set.

Set them in the environment, as with every other setting. When the environment is empty, the private waynestate/playbook package supplies the university's values, so a fresh app boots against the real services without a .env full of addresses. The environment always wins: a set variable beats the playbook, and an empty one counts as unset.

The playbook is never required. It sits in suggest, not require, and SESAME runs fine without it, reading these four from the environment alone.

Get Playbook with your own GitLab token#

The repository is private, so every path below authenticates with a personal access token of your own. Pick the one that fits:

Composer#

Point Composer at the instance in your composer.json:

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://git.wayne.edu/enterprise-apps/playbook.git"
        }
    ]
}

Then require the package:

composer require waynestate/playbook

The credential goes in auth.json (a gitlab-token entry for git.wayne.edu), never in the repository.

Fetch the values file directly#

curl --fail -H "PRIVATE-TOKEN: $GITLAB_TOKEN" \
    "https://git.wayne.edu/api/v4/projects/enterprise-apps%2Fplaybook/repository/files/playbook.env/raw?ref=main" \
    -o .env.playbook
Invoke-WebRequest `
    -Headers @{ 'PRIVATE-TOKEN' = $env:GITLAB_TOKEN } `
    -Uri "https://git.wayne.edu/api/v4/projects/enterprise-apps%2Fplaybook/repository/files/playbook.env/raw?ref=main" `
    -OutFile .env.playbook

A fetched .env.playbook is plain KEY=value lines to copy into the app's .env.

Clone#

git clone https://git.wayne.edu/enterprise-apps/playbook.git

The token is your own: read_api for curl, read_repository for clone and Composer; keep it out of the repo. Playbook is private, so on a 404 ask the Enterprise Applications team for read access.

Use the values#

A fetched .env.playbook is plain KEY=value lines: copy the ones you need into your app's .env (or your Citadel environment). SESAME does not read .env.playbook itself.

The token is your own: read_api for curl, read_repository for clone and Composer.

Playbook is private on git.wayne.edu. If you get a 404, ask the Enterprise Applications team for read access.

Raw-PHP apps that build their config by hand can resolve a value the same way the Laravel config does:

use Waynestate\Sesame\Support\Setting;

$baseUrl = Setting::get('SESAME_CAS_BASE_URL'); // env, then playbook, else null