GitHub
  • Preparing search index...
  • The search index is not available
Documentation
  • Documentation
  • @forgerock/journey-client
  • index
  • journey

Function journey

  • journey<ActionType extends ActionTypes = ActionTypes>(
        options: {
            config: JourneyClientConfig;
            logger?: { custom?: CustomLogger; level: LogLevel };
            requestMiddleware?: RequestMiddleware<ActionType>[];
        },
    ): Promise<JourneyClient>

    Creates a journey client for AM authentication tree/journey interactions.

    Journey-client is designed specifically for ForgeRock Access Management (AM) servers. It uses AM-proprietary endpoints for callback-based authentication trees.

    Type Parameters

    • ActionType extends ActionTypes = ActionTypes

    Parameters

    • options: {
          config: JourneyClientConfig;
          logger?: { custom?: CustomLogger; level: LogLevel };
          requestMiddleware?: RequestMiddleware<ActionType>[];
      }

      Configuration options for the journey client

      • config: JourneyClientConfig

        Server configuration with required wellknown URL

      • Optionallogger?: { custom?: CustomLogger; level: LogLevel }

        Optional logger configuration

      • OptionalrequestMiddleware?: RequestMiddleware<ActionType>[]

        Optional middleware for request customization

    Returns Promise<JourneyClient>

    A journey client instance

    Throws

    When the wellknown URL is invalid, the fetch fails, or the response indicates a non-AM server

    Example

    try {
    const client = await journey({
    config: {
    serverConfig: {
    wellknown: 'https://am.example.com/am/oauth2/alpha/.well-known/openid-configuration',
    },
    },
    });
    const step = await client.start({ journey: 'Login' });
    } catch (error) {
    console.error('Failed to initialize:', error.message);
    }
    • Defined in journey-client/src/lib/client.store.ts:80

Settings

Member Visibility
GitHub
Documentation
  • Loading...