Skip to content

Orbit login service

To use a SAML SSO service for user authentication in Orbit, you must first configure an Orbit Login Service.

  1. Run the Orbit Updater Configurator as Administrator.
  2. On the Login Service tab, check that Update is set to Update if not installed or already installed and a newer version is available.
  3. Choose the Service directory (default: %ProgramFiles%\Apteco\OrbitLoginService).

  4. Choose the Service name (default: OrbitLoginService).

    Login Service tab in Orbit Updater Configurator

  5. Save changes and restart the Orbit Updater Service to pick up the changes.

    Orbit Updater Service restart

  6. Check that the OrbitLoginService is installed and running.

    OrbitLoginService listed in Windows Services

  7. Right-click on the OrbitLoginService and select Properties.

    OrbitLoginService Properties dialog

  8. Warning

    If you don't complete step 8, you will see the following error in the Orbit Login Service logs:

    Text Only
    System.Security.Cryptography.CryptographicException: Error occurred during a cryptographic operation.

Orbit API Configurator

To set up the Login Service in the Orbit API Configurator, enter the following values under External login service options:

Setting Value
Base URL https://localhost:5005
Issuer https://AptecoLoginApi
Audience https://AptecoLoginApi
Secret key VerySecretAptecoJWTKey

External login service options in Orbit API Configurator

Warning

Change the Secret Key from the default value before using in production.

Save and close the Orbit API Configurator.