Skip to content

Commit 04b9292

Browse files
committed
docs(add): feedback
1 parent 223cb42 commit 04b9292

File tree

1 file changed

+12
-33
lines changed

1 file changed

+12
-33
lines changed

pages/audit-trail/reference-content/iam-authentication-logs.mdx

Lines changed: 12 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ dates:
99

1010
This page explains how to differentiate IAM member authentication methods and understand and how they appear in Audit Trail.
1111

12+
This page only covers **Unauthenticated API** methods that actually perform and/or complete an authentication step.
1213

1314
## Authentication code login
1415

@@ -52,32 +53,13 @@ As with the other methods, if MFA is required, `CheckLoginMFAOTP` is triggered b
5253
This flow integrates with **SAML (Security Assertion Markup Language)** for Single Sign-On (SSO).
5354
It allows you to set up identity federation on your Organization and provide your teams with secure access to their via an Identity Provider (IdP).
5455

55-
- `InitiateSamlLogin`
56-
Starts the SAML login process and redirects the user to the Identity Provider (IdP).
56+
- `InitiateSamlLogin`**`
57+
Starts the SAML login and redirects the user to the IdP.
5758

5859
- `CreateSamlLogin`
5960
Finalizes authentication once the SAML response is received and validated.
6061

61-
- `EnableOrganizationSaml`
62-
Activates SAML authentication for the organization.
63-
64-
- `AddSamlCertificate`
65-
Adds a certificate used to validate SAML assertions.
66-
67-
- `UpdateSaml`
68-
Updates the SAML configuration for the organization.
69-
70-
- `DeleteSaml`
71-
Removes the SAML configuration for the organization.
72-
73-
- `DeleteSamlCertificate`
74-
Deletes an existing SAML certificate.
75-
76-
- `CreateJWT`
77-
Creates a JWT token after successful SAML authentication.
78-
79-
- `DeleteJWT`
80-
Deletes a previously issued JWT token.
62+
As with the other methods, if MFA is required, `CheckLoginMFAOTP` is triggered before committing the login. Otherwise, the flow continues to `CommitLogin`.
8163

8264
## Common steps
8365

@@ -87,6 +69,9 @@ It allows you to set up identity federation on your Organization and provide you
8769
- `CommitLogin`
8870
The final step of the login process. Transforms the authenticated session into a JWT (JSON Web Token).
8971

72+
- `RenewJWT`
73+
Exchanges a valid login session/refresh context for a new JWT without re-authenticating credentials.
74+
9075

9176
## Summary of authentication methods
9277

@@ -97,16 +82,10 @@ It allows you to set up identity federation on your Organization and provide you
9782
| **CreatePasswordLogin** | Authenticates using username and password. | Password login |
9883
| **InitiateOAuth2Login** | Redirects the user to the OAuth2 provider for authentication. | OAuth2 login |
9984
| **CreateOAuth2Login** | Finalizes authentication after OAuth2 provider confirmation. | OAuth2 login |
100-
| **InitiateSamlLogin** | Starts the SAML login process and redirects to the IdP. | SAML login |
101-
| **CreateSamlLogin** | Finalizes authentication after receiving SAML response. | SAML login |
102-
| **EnableOrganizationSaml**| Enables SAML authentication for the organization. | SAML login |
103-
| **AddSamlCertificate** | Adds a certificate to validate SAML assertions. | SAML login |
104-
| **UpdateSaml** | Updates SAML configuration. | SAML login |
105-
| **DeleteSaml** | Deletes SAML configuration. | SAML login |
106-
| **DeleteSamlCertificate** | Removes a SAML certificate. | SAML login |
107-
| **CreateJWT** | Issues a JWT token after successful SAML authentication. | SAML login |
108-
| **DeleteJWT** | Deletes a previously issued JWT token. | SAML login |
109-
| **CheckLoginMFAOTP** | Validates the MFA one-time password if required. | All flows (if MFA) |
110-
| **CommitLogin** | Finalizes login and transforms the session into a JWT. | All flows |
85+
| **InitiateSamlLogin** | Redirects the user to the SAML IdP. | SAML Login |
86+
| **CreateSamlLogin** | Finalizes login after SAML response validation. | SAML Login |
87+
| **CheckLoginMFAOTP** | Validates MFA OTP when required. | All flows (if MFA) |
88+
| **CommitLogin** | Commits login and issues the JWT. | All flows |
89+
| **RenewJWT** | Renews the JWT without full re-authentication. | Session maintenance |
11190

11291

0 commit comments

Comments
 (0)