Standalone authentication username and password format - Platform - BlueCat Gateway

When using Standalone authentication, Gateway does not maintain a database for standalone user authentication accounts. Only one set of credentials is configured during Gateway container initialization (by default, the admin group).

You can specify these credentials the first time you launch the Gateway container. Gateway will automatically set its default credentials to the specified values. The standalone username and password have the following restrictions.

The maximum length for the standalone username and password is 100 characters.
The username and password cannot be empty.
The username and password cannot be all spaces.
Leading and trailing spaces in the password will be removed. However, leading and trailing spaces of the username will NOT be removed.

For more details on how Gateway Standalone authentication works, see About Standalone authentication installations in the Gateway Administration Guide.

To change the username and password for the default user when using Standalone authentication:

Note: Changing the Standalone username and password requires stopping and removing the Gateway container. To make sure you do not lose your data, make sure you use bind mounts to map the Gateway workspace and logs directory.

Stop the running container that is using Standalone authentication. To do so, use the docker stop command:
```
docker stop <Container name or Container ID>
```
Remove the stopped standalone container with the docker rm command:
```
docker rm <Container name or Container ID>
```
Reinstall the container by running the same docker run command you used when first installing the Standalone instance of Gateway, but with a new username and password. Typically, you'll use a command like the following:
```
docker run -d \
-p 80:8000 \
-p 443:44300 \
-v <Path to mapped workspace directory>:/bluecat_gateway/ \
-v <Path to mapped logs directory>:/logs/ \
-e AUTHENTICATION=STANDALONE \
-e STANDALONE_USERNAME=<New Standalone account user name> \
-e STANDALONE_PASSWORD=<New Standalone account password> \
--name bluecat_gateway quay.io/bluecat/gateway:25.1.0
```
For more details, see Installing BlueCat Gateway as a Docker container or Installing BlueCat Gateway on RHEL with RHEL-compiled Docker or Podman in the Gateway Installation Guide, as appropriate.

Special characters and symbols in standalone credential details

You can include the following characters and symbols in a standalone username or password:

Standard punctuation characters: ` ~ ! @ # $ % ^ & * ( ) - _ = + \ | [ ] { } ; : , < . > / ?
Quotation marks: " “ ” ' ‘ ’
Whitespace characters
Unicode characters and symbols, including accented characters

To use characters with special meanings in docker syntax (such as | pipe characters or quotation marks), use the \ escape character. For example:

-e AUTHENTICATION=Standalone \
-e STANDALONE_USERNAME='`~!@#$%^&*()-_=+\|[]{};:,<.>/?;'\''" Español日本語♥★☎'\
-e STANDALONE_PASSWORD='`~!@#$%^&*()-_=+\|[]{};:,<.>/?;'\''" Español日本語♥★☎'\