org.sourceid.saml20.adapter
Interface ConfigurableAuthnAdapter

All Known Subinterfaces:
IdpAuthenticationAdapter, SpAuthenticationAdapter
All Known Implementing Classes:
AbstractPasswordIdpAuthnAdapter

public interface ConfigurableAuthnAdapter

A base interface for common methods across the authentication adapters. This interface defines the method that the PingFederate server uses to discover metadata about an adapter implementation getAdapterDescriptor(). It also defines the method that the PingFederate server calls to push administrator entered GUI configuration values into the adapter configure(Configuration).

Author:
Brian Campbell
See Also:
AuthnAdapterDescriptor, Configuration

Method Summary
 void configure(Configuration configuration)
          This method is called by the PingFederate server to push configuration values entered by the administrator via the dynamically rendered GUI configuration screen in the PingFederate administration console.
 AuthnAdapterDescriptor getAdapterDescriptor()
          The PingFederate server will invoke this method on your adapter implementation to discover metadata about the implementation.
 

Method Detail

getAdapterDescriptor

AuthnAdapterDescriptor getAdapterDescriptor()
The PingFederate server will invoke this method on your adapter implementation to discover metadata about the implementation. This included the adapter's attribute contract and a description of what configuration fields to render in the GUI.

Your implementation of this method should return the same AuthnAdapterDescriptor object from call to call - behaviour of the system is undefined if this convention is not followed.

Returns:
an AuthnAdapterDescriptor object that describes this adapter implementation.

configure

void configure(Configuration configuration)
This method is called by the PingFederate server to push configuration values entered by the administrator via the dynamically rendered GUI configuration screen in the PingFederate administration console. Your implementation should use the Configuration parameter to configure its own internal state as needed. The tables and fields available in the Configuration object will correspond to the tables and fields defined on the AdapterConfigurationGuiDescriptor on the AuthnAdapterDescriptor returned by the getAdapterDescriptor() method of this class.

Each time the PingFederate server creates a new instance of your adapter implementation this method will be invoked with the proper configuration. All concurrency issues are handled in the server so you don't need to worry about them here. The server doesn't allow access to your adapter implementation instance until after creation and configuration is completed.

Parameters:
configuration - the Configuration object constructed from the values entered by the user via the GUI.


Copyright 2007 Ping Identity Corp. All rights reserved.