Preconfigured Installs: Overview
Audience: account administrators.
A preconfigured install ships your organization's sign-in settings with the extension, so your users open it to a login screen that is already correct — right method, right Access ID, right region.
Preconfigured links are created by Akeyless support. You can't create one yourself from
the extension or the console. Send your authentication method, Access ID and region to your
account team or Akeyless support, and Akeyless
sends you a link per browser to share with your users.
One destination, four paths
Every path writes to the same place: a browser-storage record named akeyless_installation_preferences. The login screen reads it every time it opens.
| Path | Use when | Page |
|---|---|---|
| Bridge link | You send users a link that Akeyless creates for you | Bridge Link Install |
| Store URL parameters | You link to the store from a portal, using a link from Akeyless | Bridge Link Install |
| Cookiebridge URL | You use the hosted bridge service | Bridge Link Install |
| Preconfigured package | You distribute the extension yourself | Preconfigured Package |
Know which path you used before troubleshooting. The bridge link expires after 10 minutes; the package applies on first install only. The symptoms look identical, the causes are not.
The preconfigured fields
| Field | Effect |
|---|---|
preferredAuthMethod | Which method the login screen opens on: alias, saml, oidc, google, github, access-id, email |
allowedAuthMethods | Restricts the picker to these methods |
prefillAccessId | Pre-fills the Access ID field |
prefillAlias | Pre-fills the field when the method is Alias |
environment | Region for email sign-in: global, us, eu, wmt, dbk, cvs |
contactSupportUrl | Destination of Contact Support |
privacyPolicyUrl | Destination of Privacy Policy |
openWebConsoleUrl | Destination of Open Web Console |
passkeyEnabled | Initial state of Passkey Management |
passkeyVerification | Passkey verification before creating or using a passkey: off, on or required (required locks it on in Settings). Only this bundled file can turn it off; the bridge and URL sources can only make it stricter. |
preconfiguredSignInTitle | Heading of the login info box. Default "Ready to Sign In". Max 120 characters |
preconfiguredSignInMessage | Body of that box. Blank lines separate paragraphs. Max 2000 characters |
installationSource | Records which path delivered the settings |
What your users will see
| Configuration | Login screen |
|---|---|
| One allowed method, not email | No auth picker, no Access ID field. Your title and message, and a single sign-in button. Powered by Akeyless at the bottom |
| One allowed method, email | Email, password and 2FA only — no auth picker, no region picker |
| Several allowed methods | Picker limited to those methods, opened on the preferred one, Access ID pre-filled |
Defaults
If you set no support or privacy URL, the extension uses:
https://www.akeyless.io/contact-support/https://www.akeyless.com/privacy-policy/
Related
Updated 7 days ago
