We’ve developed some resources to help you work effectively from home during COVID-19 Click to learn more

Scenarios

In this article

    These scenarios walk you through the sample code and what happens when you run the sample.

    1. Administrator installs, or user navigates to, partner application.
    2. Redirect started because the user attempting to access to SuperOffice functionality has not been authenticated. 
    3. User is redirected to SuperID with client ID for authentication.
    4. SuperID successfully authenticates the user and then sends them to the partner applications redirect URL.
    5. Partner application receives SuperID request and JWT token. Validated using certificates.
    6. Partner application processes/configures user and stores system user token in database.
    7. Partner service polls database for new tenant user tokens.
    8. Partner service signs user token with private key and sends it to SuperID to exchange for a system user ticket..
    9. Partner service validates system user token using certificates.
    10. Partner service calls tenant web services using system user ticket.

    Application code

    The default page displays two action links.

    Create company with login user

    The first link uses the current users' SoSession (Principal Context) to create a new company in the tenant SuperOffice. This is standard functionality used to contrast how to perform the same operation as a system user.

    Create company with system user

    The second link uses a system user token to get a system user ticket, and then uses the system user ticket to authenticate and create a new company in the tenant database.

    This scenario is not the recommended way to leverage a system user in an application. Threading with a NetServer SoSession instance is a complex topic, and it is only here in this example as a demonstration of signing the token, sending the signed token to SuperID, and then validating the returned JWT token containing the system user ticket.

    The preferred way to use a system user token is demonstrated in the System Console project.