com.inductiveautomation.ignition.gateway.auth.idp

Interface IdpAdapterManager

public interface IdpAdapterManager

An IdpAdapterManager is the source of record for all IdpAdapters configured in the system

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	IdpAdapterManager.ChangeEvent Encapsulates a change event which occurred to an IdpAdapter in the IdpAdapterManager
static class	IdpAdapterManager.NotFoundException An Exception capturing the scenario where an IdP Adapter with a given ID does not exist in the system

Method Summary

Modifier and Type	Method and Description
java.lang.String	addConfig(IdpAdapterConfig config) Add a new Identity Provider Adapter
WebAuthSession	createSession(java.lang.String idpId, com.google.common.collect.ImmutableCollection<java.lang.String> securityZones) Creates a WebAuthSession given the targeted IdP Adapter's ID
java.net.URI	generateLogoutRequestUri(java.lang.String idpId, java.net.URI logoutRedirectUri, WebAuthState.Builder webAuthStateBuilder, java.lang.String token) Generates the URI to redirect the end user for performing logout with an external IdP.
java.net.URI	generateWebAuthRequestUri(java.lang.String idpId, java.net.URI authRedirectUri, WebAuthState.Builder webAuthStateBuilder) Generates the URI to redirect the end user for performing web auth with an external IdP.
com.google.common.collect.ImmutableCollection<org.apache.commons.lang3.tuple.Pair<java.lang.String,java.lang.String>>	getAll()
java.util.Optional<IdpAdapterConfig>	getConfig(java.lang.String id) Fetch the IdpAdapterConfig associated with the given IdP ID
com.google.common.eventbus.EventBus	getEventBus()
void	removeProviderConfig(java.lang.String id) Remove an Identity Provider Adapter from the system
void	updateProviderConfig(java.lang.String id, IdpAdapterConfig config) Update an existing Identity Provider Adapter

Method Detail

getAll

@Nonnull
com.google.common.collect.ImmutableCollection<org.apache.commons.lang3.tuple.Pair<java.lang.String,java.lang.String>> getAll()

Returns:

An ImmutableCollection of all pairs of Identity Provider Adapter IDs and their names configured in the system

getConfig

@Nonnull
java.util.Optional<IdpAdapterConfig> getConfig(@Nonnull
                                                        java.lang.String id)

Fetch the IdpAdapterConfig associated with the given IdP ID

Parameters:

id - The targeted IdP ID

Returns:

An Optional which contains the IdpAdapterConfig associated with the given IdP ID or an empty Optional if there exists no IdP Adapter with the given ID

addConfig

@Nonnull
java.lang.String addConfig(@Nonnull
                                    IdpAdapterConfig config)
                             throws IdpAdapterManagerException

Add a new Identity Provider Adapter

Parameters:

config - the configuration of the new IdP Adapter

Returns:

The new IdP Adapter's ID

Throws:

IdpAdapterManagerException - if there is a problem adding the new config

updateProviderConfig

void updateProviderConfig(@Nonnull
                          java.lang.String id,
                          @Nonnull
                          IdpAdapterConfig config)
                   throws IdpAdapterManagerException,
                          IdpAdapterManager.NotFoundException

Update an existing Identity Provider Adapter

Parameters:

id - the ID of the IdP Adapter to update

config - the new configuration which will replace the IdP Adapter's current configuration

Throws:

IdpAdapterManagerException - if there is a problem updating the config

IdpAdapterManager.NotFoundException

removeProviderConfig

void removeProviderConfig(@Nonnull
                          java.lang.String id)
                   throws IdpAdapterManagerException,
                          IdpAdapterManager.NotFoundException

Remove an Identity Provider Adapter from the system

Parameters:

id - the ID of the IdP Adapter to remove

Throws:

IdpAdapterManagerException - if there is a problem removing the config

IdpAdapterManager.NotFoundException

generateWebAuthRequestUri

@Nonnull
java.net.URI generateWebAuthRequestUri(@Nonnull
                                                java.lang.String idpId,
                                                @Nonnull
                                                java.net.URI authRedirectUri,
                                                @Nonnull
                                                WebAuthState.Builder webAuthStateBuilder)
                                         throws IdpAdapterManagerException

Generates the URI to redirect the end user for performing web auth with an external IdP.

Parameters:

idpId - the targeted IdP Adapter ID

authRedirectUri - the redirect URI to the route which will handle the web auth response

webAuthStateBuilder - the WebAuthState.Builder to attach state to be linked from pre- to post-web-auth

Returns:

the URI to redirect the end user for performing web auth with the targeted external IdP

Throws:

IdpAdapterManagerException - if there is an unexpected problem generating the web auth request URI

generateLogoutRequestUri

@Nonnull
java.net.URI generateLogoutRequestUri(@Nonnull
                                               java.lang.String idpId,
                                               @Nonnull
                                               java.net.URI logoutRedirectUri,
                                               @Nonnull
                                               WebAuthState.Builder webAuthStateBuilder,
                                               @Nullable
                                               java.lang.String token)
                                        throws IdpAdapterManagerException

Generates the URI to redirect the end user for performing logout with an external IdP.

Parameters:

idpId - the targeted IdP Adapter ID

logoutRedirectUri - the redirect URI to the route which will handle the logout response

webAuthStateBuilder - the WebAuthState.Builder to attach state to be linked from pre- to post-logout

token - the optional token from which authentication was asserted, to be used as a hint for some implementations to perform logout appropriately

Returns:

the URI to redirect the end user for performing logout with the targeted external IdP

Throws:

IdpAdapterManagerException - if there is an unexpected problem generating the logout request URI

createSession

@Nonnull
WebAuthSession createSession(@Nullable
                                      java.lang.String idpId,
                                      @Nonnull
                                      com.google.common.collect.ImmutableCollection<java.lang.String> securityZones)

Creates a WebAuthSession given the targeted IdP Adapter's ID

Parameters:

idpId - the targeted IdP Adapter ID

securityZones - the security zones of the context in which the WebAuthSession will run

getEventBus

@Nonnull
com.google.common.eventbus.EventBus getEventBus()

Returns:

the EventBus where this IdpAdapterManager publishes change events