adds some additional information to the guest provider thats not immediately obvious

Signed-off-by: Peter Macdonald <macdonald.peter90@gmail.com>
2025-01-29 10:37:57 +01:00
parent cec92027c7
commit 486dda4a10
1 changed files with 17 additions and 0 deletions
@@ -63,3 +63,20 @@ auth:
    # highlight-add-next-line
    guest: {}
 ```
+
+The above is all you need to get working with the guest provider. However, you can also add additional configuration if you need to such as the following:
+
+```yaml title="app-config.local.yaml"
+auth:
+  providers:
+    guest:
+      userEntityRef: user:default/john-smith
+      ownershipEntityRefs: [group:default/smith-family]
+      dangerouslyAllowOutsideDevelopment: false
+```
+
+The `userEntityRef` is used as the entity reference for the guest user and the `ownershipEntityRefs` is a list of entity references to user for ownership of the guest user if the user is not found in the catalog.
+
+The `dangerouslyAllowOutsideDevelopment` flag is used to allow users to sign in with the guest provider outside of their development environments.
+
+You can find this information by looking at the config file [here](https://github.com/backstage/backstage/blob/master/plugins/auth-backend-module-guest-provider/config.d.ts)