Package org.forgerock.openidm.accountchange.server

Interface OpenidmAccountStatusNotificationHandlerCfg

  • All Superinterfaces:
    org.forgerock.opendj.server.config.server.AccountStatusNotificationHandlerCfg, org.forgerock.opendj.config.Configuration
    public interface OpenidmAccountStatusNotificationHandlerCfg
extends org.forgerock.opendj.server.config.server.AccountStatusNotificationHandlerCfg
    A server-side interface for querying Openidm Account Status Notification Handler settings.

    The Openidm Account Status Notification Handler is an account status notification handler that listens to two kind of changes: password change and password reset. The changes are either immediately sent to OpenIDM or first stored locally and sent later to OpenIDM at the provided interval. The communication with OpenIDM is done through HTTP or HTTPS, with optional SSL client authentication.

    • Method Detail

      • configurationClass

        Class<? extends OpenidmAccountStatusNotificationHandlerCfg> configurationClass()
        Gets the configuration class associated with this Openidm Account Status Notification Handler.
        Specified by:
        configurationClass in interface org.forgerock.opendj.server.config.server.AccountStatusNotificationHandlerCfg
        Specified by:
        configurationClass in interface org.forgerock.opendj.config.Configuration
        Returns:
        Returns the configuration class associated with this Openidm Account Status Notification Handler.

      • addOpenidmChangeListener

        void addOpenidmChangeListener​(org.forgerock.opendj.config.server.ConfigurationChangeListener<OpenidmAccountStatusNotificationHandlerCfg> listener)
        Register to be notified when this Openidm Account Status Notification Handler is changed.
        Parameters:
        listener - The Openidm Account Status Notification Handler configuration change listener.

      • removeOpenidmChangeListener

        void removeOpenidmChangeListener​(org.forgerock.opendj.config.server.ConfigurationChangeListener<OpenidmAccountStatusNotificationHandlerCfg> listener)
        Deregister an existing Openidm Account Status Notification Handler configuration change listener.
        Parameters:
        listener - The Openidm Account Status Notification Handler configuration change listener.

      • getAttributeType

        SortedSet<org.forgerock.opendj.ldap.schema.AttributeType> getAttributeType()
        Gets the "attribute-type" property.

        Specifies the attribute types that this plug-in will send along with the password change.

        Zero or more attribute types can be specified.

        Returns:
        Returns an unmodifiable set containing the values of the "attribute-type" property.

      • getCertificateSubjectDN

        org.forgerock.opendj.ldap.DN getCertificateSubjectDN()
        Gets the "certificate-subject-dn" property.

        Specifies the subject DN of the certificate used by OpenIDM.

        The subject DN is used to retrieve the OpenIDM certificate in the truststore. This certificate's public key is necessary to encrypt the JSON content sent to OpenIDM.

        Returns:
        Returns the value of the "certificate-subject-dn" property.

      • getJavaClass

        String getJavaClass()
        Gets the "java-class" property.

        Specifies the fully-qualified name of the Java class that provides the Openidm Account Status Notification Handler implementation.

        Specified by:
        getJavaClass in interface org.forgerock.opendj.server.config.server.AccountStatusNotificationHandlerCfg
        Returns:
        Returns the value of the "java-class" property.

      • getKeyManagerProvider

        String getKeyManagerProvider()
        Gets the "key-manager-provider" property.

        Specifies the name of the key manager that should be used with this Openidm Account Status Notification Handler.

        It must be provided when ssl-cert-nickname is provided, and must contain a certificate corresponding to the nickname.

        Returns:
        Returns the value of the "key-manager-provider" property.

      • getKeyManagerProviderDN

        org.forgerock.opendj.ldap.DN getKeyManagerProviderDN()
        Gets the "key-manager-provider" property as a DN.

        Specifies the name of the key manager that should be used with this Openidm Account Status Notification Handler.

        It must be provided when ssl-cert-nickname is provided, and must contain a certificate corresponding to the nickname.

        Returns:
        Returns the DN value of the "key-manager-provider" property.

      • getLogFile

        String getLogFile()
        Gets the "log-file" property.

        Specifies the log file location where the changed passwords are written when the plug-in cannot contact OpenIDM.

        The default location is the logs directory of the server instance, using the file name "pwsync". Passwords in this file will be encrypted.

        Returns:
        Returns the value of the "log-file" property.

      • getOpenidmPassword

        String getOpenidmPassword()
        Gets the "openidm-password" property.

        Specifies the password to use for HTTP Basic Authentication.

        The password must be provided when client certification is not activated, i.e. when no ssl-cert-nickname is provided.

        Returns:
        Returns the value of the "openidm-password" property.

      • getOpenidmUrl

        String getOpenidmUrl()
        Gets the "openidm-url" property.

        Specifies the URL to OpenIDM endpoint.

        The URL can be either HTTP or HTTPS.

        Returns:
        Returns the value of the "openidm-url" property.

      • getOpenidmUsername

        String getOpenidmUsername()
        Gets the "openidm-username" property.

        Specifies the username to use for HTTP Basic Authentication.

        The username must be provided when client certification is not activated, i.e. when no ssl-cert-nickname is provided.

        Returns:
        Returns the value of the "openidm-username" property.

      • getPasswordAttribute

        String getPasswordAttribute()
        Gets the "password-attribute" property.

        Specifies the attribute type used to hold user passwords in JSON returned to OpenIDM.

        This attribute type must be defined in the managed object schema in OpenIDM, and it must have either the user password or auth password syntax.

        Returns:
        Returns the value of the "password-attribute" property.

      • getPrivateKeyAlias

        String getPrivateKeyAlias()
        Gets the "private-key-alias" property.

        Specifies the alias of the private key that should be used by OpenIDM to decrypt the encrypted JSON content of the requests.

        The encryption of the JSON content sent to OpenIDM requires this alias.

        Returns:
        Returns the value of the "private-key-alias" property.

      • getQueryId

        String getQueryId()
        Gets the "query-id" property.

        Specifies the query-id for the patch-by-query request.

        This must match the query ID defined in the managed object service in OpenIDM.

        Returns:
        Returns the value of the "query-id" property.

      • getSSLCertNickname

        String getSSLCertNickname()
        Gets the "ssl-cert-nickname" property.

        Specifies the SSL certificate nickname, which is the alias under which is stored the client certificate in the keystore. It must be provided to activate SSL client authentication when requesting OpenIDM.

        The SSL certificate nickname is necessary to ensure that the appropriate client certificate is retrieved from the keystore when SSL client authentication is required and multiples certificates are present in the keystore.

        Returns:
        Returns the value of the "ssl-cert-nickname" property.

      • getTrustManagerProvider

        String getTrustManagerProvider()
        Gets the "trust-manager-provider" property.

        Specifies the name of the trust manager that should be used with the Openidm Account Status Notification Handler.

        It must contain the OpenIDM certificate with the subject DN equals to the certificate-subject-dn property.

        Returns:
        Returns the value of the "trust-manager-provider" property.

      • getTrustManagerProviderDN

        org.forgerock.opendj.ldap.DN getTrustManagerProviderDN()
        Gets the "trust-manager-provider" property as a DN.

        Specifies the name of the trust manager that should be used with the Openidm Account Status Notification Handler.

        It must contain the OpenIDM certificate with the subject DN equals to the certificate-subject-dn property.

        Returns:
        Returns the DN value of the "trust-manager-provider" property.

      • getUpdateInterval

        long getUpdateInterval()
        Gets the "update-interval" property.

        Specifies the interval when passwords update notifications are sent.

        If this value is 0, then updates are sent synchronously. If this value is strictly superior to zero, then updates are first stored locally, then sent asynchronously by a background thread.

        Returns:
        Returns the value of the "update-interval" property.