diff --git a/website/docs/how-to/how-to-download-login-history.mdx b/website/docs/how-to/how-to-download-login-history.mdx new file mode 100644 index 0000000000..7c313324c4 --- /dev/null +++ b/website/docs/how-to/how-to-download-login-history.mdx @@ -0,0 +1,23 @@ +--- +title: How to download your login history +--- + +:::info availability + +Login history is an enterprise feature available from Unleash 4.22 onwards. + +::: + +[Login history](../reference/login-history.md) enables Unleash admins to audit login events and their respective information, including whether they were successful or not. + +## Step 1: Navigate to the login history page {#step-1} + +Navigate to the _login history_ page in the admin UI (available at the URL `/admin/logins`). Use the _settings_ button in the navigation menu and select "login history". + +![The admin UI navigation settings submenu with the login history item highlighted.](/img/login-history-1.png) + +## Step 2: Click the "Download login history" button {#step-2} + +Use the "download login history" button to proceed with the download of the login history as CSV. + +![The login history table with the "download login history" button highlighted.](/img/login-history-2.png) diff --git a/website/docs/reference/login-history.md b/website/docs/reference/login-history.md new file mode 100644 index 0000000000..ca850a0ae1 --- /dev/null +++ b/website/docs/reference/login-history.md @@ -0,0 +1,42 @@ +--- +title: Login history +--- + +:::info + +Login history is an enterprise feature available from Unleash 4.22 onwards. + +::: + +Unleash's login history lets you track login events in your Unleash instance, and whether the attempts were successful in logging in or not. + +![Login history table](/img/login-history-table.png) + +For each login event, it lists: + + - **Created**: When it happened + - **Username**: The username that was used + - **Authentication**: The authentication type that was used + - **IP address**: The IP address that made the attempt + - **Success**: Whether the attempt was successful or not + - **Failure reason**: If the attempt was not successful, the reason why + +You can see the failure reason by hovering over the "False" badge in the "Success" column. + +![Login history table failure reason](/img/login-history-table-fail.png) + +Use the login history to: + +- Audit login events in your Unleash instance +- Identify failed login attempts and investigate the cause +- Debug misconfigured authentication providers + +The login history is mutable: You can remove individual login events or clear the entire history by deleting all of them. + +Finally, the login history can be downloaded ([how do I download my Unleash login history](../how-to/how-to-download-login-history.mdx)) for external backups, audits, and the like. + +## Retention + +Events in the login history are retained for 336 hours (14 days). + +Events older than the retention period are automatically deleted, and you won't be able to recover them. If you would like to collect login event information past the retention period, we suggest periodically downloading the login history. diff --git a/website/sidebars.js b/website/sidebars.js index aafc080d70..84963a53e8 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -69,6 +69,7 @@ module.exports = { 'how-to/how-to-create-api-tokens', 'how-to/how-to-create-personal-access-tokens', 'how-to/how-to-create-service-accounts', + 'how-to/how-to-download-login-history', 'how-to/how-to-use-the-admin-api', 'how-to/how-to-enable-openapi', ], @@ -316,6 +317,7 @@ module.exports = { 'reference/feature-toggle-types', 'reference/feature-toggle-variants', 'reference/front-end-api', + 'reference/login-history', 'reference/network-view', 'reference/playground', 'reference/public-signup', diff --git a/website/static/img/login-history-1.png b/website/static/img/login-history-1.png new file mode 100644 index 0000000000..e4a7377ed8 Binary files /dev/null and b/website/static/img/login-history-1.png differ diff --git a/website/static/img/login-history-2.png b/website/static/img/login-history-2.png new file mode 100644 index 0000000000..f4561bc3de Binary files /dev/null and b/website/static/img/login-history-2.png differ diff --git a/website/static/img/login-history-table-fail.png b/website/static/img/login-history-table-fail.png new file mode 100644 index 0000000000..d009b319e9 Binary files /dev/null and b/website/static/img/login-history-table-fail.png differ diff --git a/website/static/img/login-history-table.png b/website/static/img/login-history-table.png new file mode 100644 index 0000000000..2f2f4e6783 Binary files /dev/null and b/website/static/img/login-history-table.png differ