mirror of
https://github.com/zitadel/zitadel.git
synced 2025-08-12 05:07:31 +00:00
docs: standardize multi-factor spelling and related string updates (#8752)
Some checks are pending
Code Scanning / CodeQL-Build (javascript) (push) Waiting to run
ZITADEL CI/CD / core (push) Waiting to run
ZITADEL CI/CD / console (push) Waiting to run
ZITADEL CI/CD / version (push) Waiting to run
ZITADEL CI/CD / compile (push) Blocked by required conditions
ZITADEL CI/CD / core-unit-test (push) Blocked by required conditions
ZITADEL CI/CD / core-integration-test (push) Blocked by required conditions
ZITADEL CI/CD / lint (push) Blocked by required conditions
ZITADEL CI/CD / container (push) Blocked by required conditions
ZITADEL CI/CD / e2e (push) Blocked by required conditions
ZITADEL CI/CD / release (push) Blocked by required conditions
Code Scanning / CodeQL-Build (go) (push) Waiting to run
Some checks are pending
Code Scanning / CodeQL-Build (javascript) (push) Waiting to run
ZITADEL CI/CD / core (push) Waiting to run
ZITADEL CI/CD / console (push) Waiting to run
ZITADEL CI/CD / version (push) Waiting to run
ZITADEL CI/CD / compile (push) Blocked by required conditions
ZITADEL CI/CD / core-unit-test (push) Blocked by required conditions
ZITADEL CI/CD / core-integration-test (push) Blocked by required conditions
ZITADEL CI/CD / lint (push) Blocked by required conditions
ZITADEL CI/CD / container (push) Blocked by required conditions
ZITADEL CI/CD / e2e (push) Blocked by required conditions
ZITADEL CI/CD / release (push) Blocked by required conditions
Code Scanning / CodeQL-Build (go) (push) Waiting to run
- **docs: s/Secondfactor/Second factor/** - **docs: s/IDP/IdP/** - **docs: s/Hardwaretokens/Hardware tokens/** - **docs: standardize multi-factor vs multi factor vs multifactor** # Which Problems Are Solved - English strings are improved # How the Problems Are Solved - With better strings --------- Co-authored-by: Fabi <fabienne@zitadel.com>
This commit is contained in:
@@ -2827,7 +2827,7 @@ service AdminService {
|
||||
responses: {
|
||||
key: "400";
|
||||
value: {
|
||||
description: "invalid second-factor type";
|
||||
description: "invalid second factor type";
|
||||
schema: {
|
||||
json_schema: {
|
||||
ref: "#/definitions/rpcStatus";
|
||||
@@ -2862,7 +2862,7 @@ service AdminService {
|
||||
responses: {
|
||||
key: "400";
|
||||
value: {
|
||||
description: "Invalid second-factor type";
|
||||
description: "Invalid second factor type";
|
||||
schema: {
|
||||
json_schema: {
|
||||
ref: "#/definitions/rpcStatus";
|
||||
@@ -2886,12 +2886,12 @@ service AdminService {
|
||||
tags: "Settings";
|
||||
tags: "Login Settings";
|
||||
tags: "Authentication Methods"
|
||||
summary: "List Multi Factors (MFA)";
|
||||
description: "Returns a list of multi factors (MFA) configured on the login settings of the instance. It affects all organizations, without custom login settings. Authentication factors are used as an additional layer of security for your users (e.g. Authentication App, FingerPrint, Windows Hello, etc). Per definition, it is called multifactor factor or passwordless as it is used as first and second authentication and a password is not necessary. In the UI we generalize it as passwordless or passkey."
|
||||
summary: "List Multi-factors (MFA)";
|
||||
description: "Returns a list of multi-factors (MFA) configured on the login settings of the instance. It affects all organizations, without custom login settings. Authentication factors are used as an additional layer of security for your users (e.g. Authentication App, FingerPrint, Windows Hello, etc). Per definition, it is called multifactor factor or passwordless as it is used as first and second authentication and a password is not necessary. In the UI we generalize it as passwordless or passkey."
|
||||
responses: {
|
||||
key: "200";
|
||||
value: {
|
||||
description: "multi factors of default login policy";
|
||||
description: "multi-factors of default login policy";
|
||||
};
|
||||
};
|
||||
};
|
||||
@@ -2946,7 +2946,7 @@ service AdminService {
|
||||
tags: "Settings";
|
||||
tags: "Login Settings";
|
||||
tags: "Authentication Methods"
|
||||
summary: "Remove Multi Factor (MFA)";
|
||||
summary: "Remove Multi-factor (MFA)";
|
||||
description: "Remove a multi-factor (MFA) from the login settings of the instance. It affects all organizations, without custom login settings. Authentication factors are used as an additional layer of security for your users (e.g. Authentication App, FingerPrint, Windows Hello, etc). Per definition, it is called multi-factor factor or passwordless as it is used as first and second authentication and a password is not necessary. In the UI we generalize it as passwordless or passkey."
|
||||
responses: {
|
||||
key: "200";
|
||||
|
@@ -597,7 +597,7 @@ service AuthService {
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "List Authentication Factors";
|
||||
description: "Returns a list of possible authentication factors, multi-factor (MFA), second-factor (2FA)"
|
||||
description: "Returns a list of possible authentication factors, multi-factor (MFA), second factor (2FA)"
|
||||
};
|
||||
}
|
||||
|
||||
@@ -612,8 +612,8 @@ service AuthService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Add One-Time-Password (OTP)";
|
||||
description: "Add a new One-Time-Password (OTP) factor to the authenticated user. OTP is an authenticator app like Google/Microsoft Authenticator, Authy, etc. Only one OTP per user is allowed. After adding a new OTP it has to be verified."
|
||||
summary: "Add One-Time Password (OTP)";
|
||||
description: "Add a new One-Time Password (OTP) factor to the authenticated user. OTP is an authenticator app like Google/Microsoft Authenticator, Authy, etc. Only one OTP per user is allowed. After adding a new OTP it has to be verified."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -629,8 +629,8 @@ service AuthService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Verify One-Time-Password (OTP)";
|
||||
description: "Verify the last added One-Time-Password (OTP) factor of the authenticated user. OTP is an authenticator app like Google/Microsoft Authenticator, Authy, etc. Only one OTP per user is allowed."
|
||||
summary: "Verify One-Time Password (OTP)";
|
||||
description: "Verify the last added One-Time Password (OTP) factor of the authenticated user. OTP is an authenticator app like Google/Microsoft Authenticator, Authy, etc. Only one OTP per user is allowed."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -645,8 +645,8 @@ service AuthService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Remove One-Time-Password (OTP)";
|
||||
description: "Remove the configured One-Time-Password (OTP) factor of the authenticated user. OTP is an authenticator app like Google/Microsoft Authenticator, Authy, etc. As only one OTP per user is allowed, the user will not have OTP as a second-factor afterward."
|
||||
summary: "Remove One-Time Password (OTP)";
|
||||
description: "Remove the configured One-Time Password (OTP) factor of the authenticated user. OTP is an authenticator app like Google/Microsoft Authenticator, Authy, etc. As only one OTP per user is allowed, the user will not have OTP as a second factor afterward."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -661,8 +661,8 @@ service AuthService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Add One-Time-Password (OTP) SMS";
|
||||
description: "Add a new One-Time-Password (OTP) SMS factor to the authenticated user. OTP SMS will enable the user to verify a OTP with the latest verified phone number. The phone number has to be verified to add the second factor."
|
||||
summary: "Add One-Time Password (OTP) SMS";
|
||||
description: "Add a new One-Time Password (OTP) SMS factor to the authenticated user. OTP SMS will enable the user to verify a OTP with the latest verified phone number. The phone number has to be verified to add the second factor."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -677,8 +677,8 @@ service AuthService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Remove One-Time-Password (OTP) SMS";
|
||||
description: "Remove the configured One-Time-Password (OTP) SMS factor of the authenticated user. As only one OTP SMS per user is allowed, the user will not have OTP SMS as a second-factor afterward."
|
||||
summary: "Remove One-Time Password (OTP) SMS";
|
||||
description: "Remove the configured One-Time Password (OTP) SMS factor of the authenticated user. As only one OTP SMS per user is allowed, the user will not have OTP SMS as a second factor afterward."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -693,8 +693,8 @@ service AuthService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Add One-Time-Password (OTP) Email";
|
||||
description: "Add a new One-Time-Password (OTP) Email factor to the authenticated user. OTP Email will enable the user to verify a OTP with the latest verified email. The email has to be verified to add the second factor."
|
||||
summary: "Add One-Time Password (OTP) Email";
|
||||
description: "Add a new One-Time Password (OTP) Email factor to the authenticated user. OTP Email will enable the user to verify a OTP with the latest verified email. The email has to be verified to add the second factor."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -709,8 +709,8 @@ service AuthService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Remove One-Time-Password (OTP) Email";
|
||||
description: "Remove the configured One-Time-Password (OTP) Email factor of the authenticated user. As only one OTP Email per user is allowed, the user will not have OTP Email as a second-factor afterward."
|
||||
summary: "Remove One-Time Password (OTP) Email";
|
||||
description: "Remove the configured One-Time Password (OTP) Email factor of the authenticated user. As only one OTP Email per user is allowed, the user will not have OTP Email as a second factor afterward."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -726,7 +726,7 @@ service AuthService {
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Add Universal Second Factor (U2F)";
|
||||
description: "Add a new Universal-Second-Factor (U2F) to the authenticated user. U2F is a device-dependent authentication like FingerScan, FaceID, WindowHello, etc. The factor has to be verified after adding. Multiple factors can be added."
|
||||
description: "Add a new Universal Second Factor (U2F) to the authenticated user. U2F is a device-dependent authentication like FingerScan, FaceID, WindowHello, etc. The factor has to be verified after adding. Multiple factors can be added."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -743,7 +743,7 @@ service AuthService {
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Add Universal Second Factor (U2F)";
|
||||
description: "Verify the last added new Universal-Second-Factor (U2F) to the authenticated user."
|
||||
description: "Verify the last added new Universal Second Factor (U2F) to the authenticated user."
|
||||
};
|
||||
}
|
||||
|
||||
@@ -759,7 +759,7 @@ service AuthService {
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
tags: "User Authentication Factor"
|
||||
summary: "Remove Universal Second Factor (U2F)";
|
||||
description: "Remove a specific Universal-Second-Factor (U2F) from the authenticated user by sending the id."
|
||||
description: "Remove a specific Universal Second Factor (U2F) from the authenticated user by sending the id."
|
||||
};
|
||||
}
|
||||
|
||||
|
@@ -1345,7 +1345,7 @@ service ManagementService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
summary: "Get User Authentication Factors (2FA/MFA)";
|
||||
description: "Get a list of authentication factors the user has set. Including Second-Factors (2FA) and Multi-Factors (MFA).\n\nDeprecated: please use user service v2 ListAuthenticationMethodTypes"
|
||||
description: "Get a list of authentication factors the user has set. Including Second Factors (2FA) and Multi-Factors (MFA).\n\nDeprecated: please use user service v2 ListAuthenticationMethodTypes"
|
||||
tags: "Users";
|
||||
tags: "User Human";
|
||||
deprecated: true;
|
||||
@@ -1378,7 +1378,7 @@ service ManagementService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
summary: "Remove Multi-Factor OTP";
|
||||
description: "Remove the configured One-Time-Password (OTP) as a factor from the user. OTP is an authentication app, like Authy or Google/Microsoft Authenticator.\n\nDeprecated: please use user service v2 RemoveTOTP"
|
||||
description: "Remove the configured One-Time Password (OTP) as a factor from the user. OTP is an authentication app, like Authy or Google/Microsoft Authenticator.\n\nDeprecated: please use user service v2 RemoveTOTP"
|
||||
tags: "Users";
|
||||
tags: "User Human";
|
||||
deprecated: true;
|
||||
@@ -1412,7 +1412,7 @@ service ManagementService {
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
summary: "Remove Multi-Factor U2F";
|
||||
deprecated: true;
|
||||
description: "Remove the configured Universal-Second-Factor (U2F) as a factor from the user. U2F is a device-dependent factor like FingerPrint, Windows-Hello, etc.\n\nDeprecated: please use user service v2 RemoveU2F"
|
||||
description: "Remove the configured Universal Second Factor (U2F) as a factor from the user. U2F is a device-dependent factor like FingerPrint, Windows-Hello, etc.\n\nDeprecated: please use user service v2 RemoveU2F"
|
||||
tags: "Users";
|
||||
tags: "User Human";
|
||||
responses: {
|
||||
@@ -1444,7 +1444,7 @@ service ManagementService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
summary: "Remove Multi-Factor OTP SMS";
|
||||
description: "Remove the configured One-Time-Password (OTP) SMS as a factor from the user. As only one OTP SMS per user is allowed, the user will not have OTP SMS as a second-factor afterward.\n\nDeprecated: please use user service v2 RemoveOTPSMS"
|
||||
description: "Remove the configured One-Time Password (OTP) SMS as a factor from the user. As only one OTP SMS per user is allowed, the user will not have OTP SMS as a second factor afterward.\n\nDeprecated: please use user service v2 RemoveOTPSMS"
|
||||
tags: "Users";
|
||||
tags: "User Human";
|
||||
deprecated: true;
|
||||
@@ -1477,7 +1477,7 @@ service ManagementService {
|
||||
|
||||
option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_operation) = {
|
||||
summary: "Remove Multi-Factor OTP SMS";
|
||||
description: "Remove the configured One-Time-Password (OTP) Email as a factor from the user. As only one OTP Email per user is allowed, the user will not have OTP Email as a second-factor afterward.\n\nDeprecated: please use user service v2 RemoveOTPEmail"
|
||||
description: "Remove the configured One-Time Password (OTP) Email as a factor from the user. As only one OTP Email per user is allowed, the user will not have OTP Email as a second factor afterward.\n\nDeprecated: please use user service v2 RemoveOTPEmail"
|
||||
tags: "Users";
|
||||
tags: "User Human";
|
||||
deprecated: true;
|
||||
@@ -4618,8 +4618,8 @@ service ManagementService {
|
||||
tags: "Settings";
|
||||
tags: "Login Settings";
|
||||
tags: "Authentication Methods"
|
||||
summary: "List Multi Factors (MFA)";
|
||||
description: "Returns a list of multi factors (MFA) configured on the login settings of the organization. Authentication factors are used as an additional layer of security for your users (e.g. Authentication App, FingerPrint, Windows Hello, etc). Per definition, it is called multifactor factor or passwordless as it is used as first and second authentication and a password is not necessary. In the UI we generalize it as passwordless or passkey."
|
||||
summary: "List Multi-factors (MFA)";
|
||||
description: "Returns a list of multi-factors (MFA) configured on the login settings of the organization. Authentication factors are used as an additional layer of security for your users (e.g. Authentication App, FingerPrint, Windows Hello, etc). Per definition, it is called multifactor factor or passwordless as it is used as first and second authentication and a password is not necessary. In the UI we generalize it as passwordless or passkey."
|
||||
parameters: {
|
||||
headers: {
|
||||
name: "x-zitadel-orgid";
|
||||
@@ -4671,7 +4671,7 @@ service ManagementService {
|
||||
tags: "Settings";
|
||||
tags: "Login Settings";
|
||||
tags: "Authentication Methods"
|
||||
summary: "Remove Multi Factor (MFA)";
|
||||
summary: "Remove Multi-factor (MFA)";
|
||||
description: "Remove a multi-factor (MFA) from the login settings of the organization. It affects all organizations, without custom login settings. Authentication factors are used as an additional layer of security for your users (e.g. Authentication App, FingerPrint, Windows Hello, etc). Per definition, it is called multi-factor factor or passwordless as it is used as first and second authentication and a password is not necessary. In the UI we generalize it as passwordless or passkey."
|
||||
parameters: {
|
||||
headers: {
|
||||
|
@@ -18,12 +18,12 @@ message Authenticators {
|
||||
Password password = 2;
|
||||
// Meta information about the user's WebAuthN authenticators.
|
||||
repeated WebAuthN web_auth_n = 3;
|
||||
// A list of the user's time-based one-time-password (TOTP) authenticators,
|
||||
// A list of the user's time-based one-time password (TOTP) authenticators,
|
||||
// incl. the name for identification.
|
||||
repeated TOTP totps = 4;
|
||||
// A list of the user's one-time-password (OTP) SMS authenticators.
|
||||
// A list of the user's one-time password (OTP) SMS authenticators.
|
||||
repeated OTPSMS otp_sms = 5;
|
||||
// A list of the user's one-time-password (OTP) Email authenticators.
|
||||
// A list of the user's one-time password (OTP) Email authenticators.
|
||||
repeated OTPEmail otp_email = 6;
|
||||
// A list of the user's authentication keys. They can be used to authenticate e.g. by JWT Profile.
|
||||
repeated AuthenticationKey authentication_keys = 7;
|
||||
@@ -100,7 +100,7 @@ message WebAuthN {
|
||||
// State whether the WebAuthN registration has been completed.
|
||||
bool is_verified = 3;
|
||||
// States if the user has been verified during the registration. Authentication with this device
|
||||
// will be considered as multi factor authentication (MFA) without the need to check a password
|
||||
// will be considered as multi-factor authentication (MFA) without the need to check a password
|
||||
// (typically known as Passkeys).
|
||||
// Without user verification it will be a second factor authentication (2FA), typically done
|
||||
// after a password check.
|
||||
@@ -154,7 +154,7 @@ message VerifyWebAuthNRegistration {
|
||||
}
|
||||
|
||||
message OTPSMS {
|
||||
// unique identifier of the one-time-password (OTP) SMS authenticator.
|
||||
// unique identifier of the one-time password (OTP) SMS authenticator.
|
||||
string otp_sms_id = 1 [
|
||||
(grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
|
||||
example: "\"69629023906488334\""
|
||||
@@ -171,7 +171,7 @@ message OTPSMS {
|
||||
}
|
||||
|
||||
message OTPEmail {
|
||||
// unique identifier of the one-time-password (OTP) Email authenticator.
|
||||
// unique identifier of the one-time password (OTP) Email authenticator.
|
||||
string otp_email_id = 1 [
|
||||
(grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
|
||||
example: "\"69629023906488334\""
|
||||
@@ -188,7 +188,7 @@ message OTPEmail {
|
||||
}
|
||||
|
||||
message TOTP {
|
||||
// unique identifier of the time-based one-time-password (TOTP) authenticator.
|
||||
// unique identifier of the time-based one-time password (TOTP) authenticator.
|
||||
string totp_id = 1 [
|
||||
(grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
|
||||
example: "\"69629023906488334\""
|
||||
|
@@ -719,7 +719,7 @@ service ZITADELUsers {
|
||||
|
||||
// Start a TOTP registration
|
||||
//
|
||||
// Start the registration of a new time-based one-time-password (TOTP) generator for a user.
|
||||
// Start the registration of a new time-based one-time password (TOTP) generator for a user.
|
||||
// As a response a secret is returned, which is used to initialize a TOTP app or device.
|
||||
rpc StartTOTPRegistration (StartTOTPRegistrationRequest) returns (StartTOTPRegistrationResponse) {
|
||||
option (google.api.http) = {
|
||||
@@ -743,7 +743,7 @@ service ZITADELUsers {
|
||||
|
||||
// Verify a TOTP registration
|
||||
//
|
||||
// Verify the time-based one-time-password (TOTP) registration with the generated code.
|
||||
// Verify the time-based one-time password (TOTP) registration with the generated code.
|
||||
rpc VerifyTOTPRegistration (VerifyTOTPRegistrationRequest) returns (VerifyTOTPRegistrationResponse) {
|
||||
option (google.api.http) = {
|
||||
post: "/resources/v3alpha/users/{id}/totp/{totp_id}/_verify"
|
||||
@@ -767,7 +767,7 @@ service ZITADELUsers {
|
||||
|
||||
// Remove a TOTP authenticator
|
||||
//
|
||||
// Remove an existing time-based one-time-password (TOTP) authenticator from a user, so it cannot be used for authentication anymore.
|
||||
// Remove an existing time-based one-time password (TOTP) authenticator from a user, so it cannot be used for authentication anymore.
|
||||
rpc RemoveTOTPAuthenticator (RemoveTOTPAuthenticatorRequest) returns (RemoveTOTPAuthenticatorResponse) {
|
||||
option (google.api.http) = {
|
||||
delete: "/resources/v3alpha/users/{id}/totp/{totp_id}"
|
||||
@@ -790,7 +790,7 @@ service ZITADELUsers {
|
||||
|
||||
// Add a OTP SMS authenticator
|
||||
//
|
||||
// Add a new one-time-password (OTP) SMS authenticator to a user.
|
||||
// Add a new one-time password (OTP) SMS authenticator to a user.
|
||||
// If the phone is not passed as verified, a verification code will be generated,
|
||||
// which can be either returned or will be sent to the user by SMS.
|
||||
rpc AddOTPSMSAuthenticator (AddOTPSMSAuthenticatorRequest) returns (AddOTPSMSAuthenticatorResponse) {
|
||||
@@ -841,7 +841,7 @@ service ZITADELUsers {
|
||||
|
||||
// Remove a OTP SMS authenticator
|
||||
//
|
||||
// Remove an existing one-time-password (OTP) SMS authenticator from a user, so it cannot be used for authentication anymore.
|
||||
// Remove an existing one-time password (OTP) SMS authenticator from a user, so it cannot be used for authentication anymore.
|
||||
rpc RemoveOTPSMSAuthenticator (RemoveOTPSMSAuthenticatorRequest) returns (RemoveOTPSMSAuthenticatorResponse) {
|
||||
option (google.api.http) = {
|
||||
delete: "/resources/v3alpha/users/{id}/otp_sms/{otp_sms_id}"
|
||||
@@ -864,7 +864,7 @@ service ZITADELUsers {
|
||||
|
||||
// Add a OTP Email authenticator
|
||||
//
|
||||
// Add a new one-time-password (OTP) Email authenticator to a user.
|
||||
// Add a new one-time password (OTP) Email authenticator to a user.
|
||||
// If the email is not passed as verified, a verification code will be generated,
|
||||
// which can be either returned or will be sent to the user by email.
|
||||
rpc AddOTPEmailAuthenticator (AddOTPEmailAuthenticatorRequest) returns (AddOTPEmailAuthenticatorResponse) {
|
||||
@@ -915,7 +915,7 @@ service ZITADELUsers {
|
||||
|
||||
// Remove a OTP Email authenticator
|
||||
//
|
||||
// Remove an existing one-time-password (OTP) Email authenticator from a user, so it cannot be used for authentication anymore.
|
||||
// Remove an existing one-time password (OTP) Email authenticator from a user, so it cannot be used for authentication anymore.
|
||||
rpc RemoveOTPEmailAuthenticator (RemoveOTPEmailAuthenticatorRequest) returns (RemoveOTPEmailAuthenticatorResponse) {
|
||||
option (google.api.http) = {
|
||||
delete: "/resources/v3alpha/users/{id}/otp_email/{otp_email_id}"
|
||||
|
@@ -70,7 +70,7 @@ message LoginSettings {
|
||||
];
|
||||
google.protobuf.Duration second_factor_check_lifetime = 12 [
|
||||
(grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
|
||||
description: "Defines after how long the second-factor check is valid.";
|
||||
description: "Defines after how long the second factor check is valid.";
|
||||
example: "\"64800s\"";
|
||||
}
|
||||
];
|
||||
|
@@ -70,7 +70,7 @@ message LoginSettings {
|
||||
];
|
||||
google.protobuf.Duration second_factor_check_lifetime = 12 [
|
||||
(grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
|
||||
description: "Defines after how long the second-factor check is valid.";
|
||||
description: "Defines after how long the second factor check is valid.";
|
||||
example: "\"64800s\"";
|
||||
}
|
||||
];
|
||||
|
@@ -771,7 +771,7 @@ service UserService {
|
||||
|
||||
// Remove TOTP generator from a user
|
||||
//
|
||||
// Remove the configured TOTP generator of a user. As only one TOTP generator per user is allowed, the user will not have TOTP as a second-factor afterward..
|
||||
// Remove the configured TOTP generator of a user. As only one TOTP generator per user is allowed, the user will not have TOTP as a second factor afterward.
|
||||
rpc RemoveTOTP (RemoveTOTPRequest) returns (RemoveTOTPResponse) {
|
||||
option (google.api.http) = {
|
||||
delete: "/v2/users/{user_id}/totp"
|
||||
@@ -794,7 +794,7 @@ service UserService {
|
||||
|
||||
// Add OTP SMS for a user
|
||||
//
|
||||
// Add a new One-Time-Password (OTP) SMS factor to the authenticated user. OTP SMS will enable the user to verify a OTP with the latest verified phone number. The phone number has to be verified to add the second factor..
|
||||
// Add a new One-Time Password (OTP) SMS factor to the authenticated user. OTP SMS will enable the user to verify a OTP with the latest verified phone number. The phone number has to be verified to add the second factor..
|
||||
rpc AddOTPSMS (AddOTPSMSRequest) returns (AddOTPSMSResponse) {
|
||||
option (google.api.http) = {
|
||||
post: "/v2/users/{user_id}/otp_sms"
|
||||
@@ -816,9 +816,9 @@ service UserService {
|
||||
};
|
||||
}
|
||||
|
||||
// Remove One-Time-Password (OTP) SMS from a user
|
||||
// Remove One-Time Password (OTP) SMS from a user
|
||||
//
|
||||
// Remove the configured One-Time-Password (OTP) SMS factor of a user. As only one OTP SMS per user is allowed, the user will not have OTP SMS as a second-factor afterward..
|
||||
// Remove the configured One-Time Password (OTP) SMS factor of a user. As only one OTP SMS per user is allowed, the user will not have OTP SMS as a second factor afterward.
|
||||
rpc RemoveOTPSMS (RemoveOTPSMSRequest) returns (RemoveOTPSMSResponse) {
|
||||
option (google.api.http) = {
|
||||
delete: "/v2/users/{user_id}/otp_sms"
|
||||
@@ -841,7 +841,7 @@ service UserService {
|
||||
|
||||
// Add OTP Email for a user
|
||||
//
|
||||
// Add a new One-Time-Password (OTP) Email factor to the authenticated user. OTP Email will enable the user to verify a OTP with the latest verified email. The email has to be verified to add the second factor..
|
||||
// Add a new One-Time Password (OTP) Email factor to the authenticated user. OTP Email will enable the user to verify a OTP with the latest verified email. The email has to be verified to add the second factor..
|
||||
rpc AddOTPEmail (AddOTPEmailRequest) returns (AddOTPEmailResponse) {
|
||||
option (google.api.http) = {
|
||||
post: "/v2/users/{user_id}/otp_email"
|
||||
@@ -863,9 +863,9 @@ service UserService {
|
||||
};
|
||||
}
|
||||
|
||||
// Remove One-Time-Password (OTP) Email from a user
|
||||
// Remove One-Time Password (OTP) Email from a user
|
||||
//
|
||||
// Remove the configured One-Time-Password (OTP) Email factor of a user. As only one OTP Email per user is allowed, the user will not have OTP Email as a second-factor afterward..
|
||||
// Remove the configured One-Time Password (OTP) Email factor of a user. As only one OTP Email per user is allowed, the user will not have OTP Email as a second factor afterward.
|
||||
rpc RemoveOTPEmail (RemoveOTPEmailRequest) returns (RemoveOTPEmailResponse) {
|
||||
option (google.api.http) = {
|
||||
delete: "/v2/users/{user_id}/otp_email"
|
||||
|
@@ -769,7 +769,7 @@ service UserService {
|
||||
|
||||
// Remove TOTP generator from a user
|
||||
//
|
||||
// Remove the configured TOTP generator of a user. As only one TOTP generator per user is allowed, the user will not have TOTP as a second-factor afterward.
|
||||
// Remove the configured TOTP generator of a user. As only one TOTP generator per user is allowed, the user will not have TOTP as a second factor afterward.
|
||||
//
|
||||
// Deprecated: please move to the corresponding endpoint under user service v2 (GA).
|
||||
rpc RemoveTOTP (RemoveTOTPRequest) returns (RemoveTOTPResponse) {
|
||||
@@ -795,7 +795,7 @@ service UserService {
|
||||
|
||||
// Add OTP SMS for a user
|
||||
//
|
||||
// Add a new One-Time-Password (OTP) SMS factor to the authenticated user. OTP SMS will enable the user to verify a OTP with the latest verified phone number. The phone number has to be verified to add the second factor.
|
||||
// Add a new One-Time Password (OTP) SMS factor to the authenticated user. OTP SMS will enable the user to verify a OTP with the latest verified phone number. The phone number has to be verified to add the second factor.
|
||||
//
|
||||
// Deprecated: please move to the corresponding endpoint under user service v2 (GA).
|
||||
rpc AddOTPSMS (AddOTPSMSRequest) returns (AddOTPSMSResponse) {
|
||||
@@ -820,9 +820,9 @@ service UserService {
|
||||
};
|
||||
}
|
||||
|
||||
// Remove One-Time-Password (OTP) SMS from a user
|
||||
// Remove One-Time Password (OTP) SMS from a user
|
||||
//
|
||||
// Remove the configured One-Time-Password (OTP) SMS factor of a user. As only one OTP SMS per user is allowed, the user will not have OTP SMS as a second-factor afterward.
|
||||
// Remove the configured One-Time Password (OTP) SMS factor of a user. As only one OTP SMS per user is allowed, the user will not have OTP SMS as a second factor afterward.
|
||||
//
|
||||
// Deprecated: please move to the corresponding endpoint under user service v2 (GA).
|
||||
rpc RemoveOTPSMS (RemoveOTPSMSRequest) returns (RemoveOTPSMSResponse) {
|
||||
@@ -848,7 +848,7 @@ service UserService {
|
||||
|
||||
// Add OTP Email for a user
|
||||
//
|
||||
// Add a new One-Time-Password (OTP) Email factor to the authenticated user. OTP Email will enable the user to verify a OTP with the latest verified email. The email has to be verified to add the second factor.
|
||||
// Add a new One-Time Password (OTP) Email factor to the authenticated user. OTP Email will enable the user to verify a OTP with the latest verified email. The email has to be verified to add the second factor.
|
||||
//
|
||||
// Deprecated: please move to the corresponding endpoint under user service v2 (GA).
|
||||
rpc AddOTPEmail (AddOTPEmailRequest) returns (AddOTPEmailResponse) {
|
||||
@@ -873,9 +873,9 @@ service UserService {
|
||||
};
|
||||
}
|
||||
|
||||
// Remove One-Time-Password (OTP) Email from a user
|
||||
// Remove One-Time Password (OTP) Email from a user
|
||||
//
|
||||
// Remove the configured One-Time-Password (OTP) Email factor of a user. As only one OTP Email per user is allowed, the user will not have OTP Email as a second-factor afterward.
|
||||
// Remove the configured One-Time Password (OTP) Email factor of a user. As only one OTP Email per user is allowed, the user will not have OTP Email as a second factor afterward.
|
||||
//
|
||||
// Deprecated: please move to the corresponding endpoint under user service v2 (GA).
|
||||
rpc RemoveOTPEmail (RemoveOTPEmailRequest) returns (RemoveOTPEmailResponse) {
|
||||
|
Reference in New Issue
Block a user