Package org.keycloak.credential

Class CredentialTypeMetadata

java.lang.Object
org.keycloak.credential.CredentialTypeMetadata
All Implemented Interfaces:
Comparable<CredentialTypeMetadata>
public class CredentialTypeMetadata extends Object implements Comparable<CredentialTypeMetadata>
Author:
Marek Posolda

  • Field Details

  • Method Details

    • getType

      public String getType()
      Returns:
      credential type like for example "password", "otp" or "webauthn"

    • getDisplayName

      public String getDisplayName()
      Returns:
      the label, which will be shown to the end user on various screens, like login screen with available authentication mechanisms. This label will reference this particular authenticator type. It should be clear to end users. For example, implementations can return "Authenticator Application" for OTP or "Security Key" for WebAuthn. Alternatively, this method can return a message key, so that it is possible to localize it for various languages.

    • getHelpText

      public String getHelpText()
      Returns:
      the text, which will be shown to the user on various screens, like login screen with available authentication mechanisms. This text will reference this particular authenticator type. For example for OTP, the returned text could be "Enter a verification code from authenticator application" . Alternatively, this method can return a message key, so that it is possible to localize it for various languages.

    • getIconCssClass

      public String getIconCssClass()
      Return the icon CSS, which can be used to display icon, which represents this particular authenticator. The icon will be displayed on various places. For example the "Select authenticator" screen during login, where user can select from various authentication mechanisms for two-factor or passwordless authentication. The returned value can be either: - Key of the property, which will reference the actual CSS in the themes.properties file. For example if you return "kcAuthenticatorWebAuthnClass" from this method, then your themes.properties should have the property like for example "kcAuthenticatorWebAuthnClass=fa fa-key list-view-pf-icon-lg" . This would mean that "fa fa-key list-view-pf-icon-lg" will be the actual CSS used. - the icon CSS class directly. For example you can return "fa fa-key list-view-pf-icon-lg" directly for the above example with WebAuthn. This alternative is fine just if your authenticator can use same CSS class for all the themes. If you don't expect your authenticator to need icon (for example it will never be shown in the "select authenticator" screen), then it is fine to keep the default value.

    • getCreateAction

      public String getCreateAction()
      Returns:
      the providerID of the required action, which can be used by the user to create new credential of our type. Null if there is no action for creating credential. For example we're creating credential in case of "otp" type, but we're updating credential in case of type "password"

    • getUpdateAction

      public String getUpdateAction()
      Returns:
      the providerID of the required action, which can be used by the user to update credential of our type. Null if there is no action for updating credential. For example we're creating credential in case of "otp" type, but we're updating credential in case of type "password"

    • isRemoveable

      public boolean isRemoveable()
      Returns:
      true if user can remove some previously registered credentials of this type.

    • getCategory

      public CredentialTypeMetadata.Category getCategory()
      Returns:
      Category of this credential

    • builder

      public static CredentialTypeMetadata.CredentialTypeMetadataBuilder builder()

    • compareTo

      public int compareTo(CredentialTypeMetadata other)
      Specified by:
      compareTo in interface Comparable<CredentialTypeMetadata>