Picvario: Configuring OpenID Authorization Using GSuite

Picvario: Configuring OpenID Authorization Using GSuite

OpenID is an open standard of a decentralized authentication system that allows the user to create a single account for authenticating to multiple unrelated Internet resources.

To set up OpenID authorization on the Picvario website:

Configure settings on Google:

  1. Go to https://console.developers.google.com/apis/credentials using your organization's administrator account.
  2. Create a new web application (for example, named Picvario).
  3. Get the ClientID and Client Secret in the control panel:
    MicrosoftTeams-image__7_.png
    MicrosoftTeams-image__8_.png
  4. Add the following address to the list of authorized URIs: 
 <site_url>/api/v1/users/oidc/callback

MicrosoftTeams-image__9_.png

Configure settings on Picvario:

  1. Copy the environment variable from frontend SITE_BASE_URL=< some url >.
  2. In the tenant's Options ( https://<tenant-name>.<site_url>/admin/options/option/) or in hosted versions ( https://<site_url>/admin/options/option/ ), create the parameter: 
    OPENID_AUTH_ENABLED

After the parameter is added, 11 more parameters will be created AUTOMATICALLY. You will need to change their values to:

 

KEY

VAL

PUBLIC

 

OIDC_TOKEN_USE_BASIC_AUTH

True

False

 

OIDC_RP_SIGN_ALGO

RS256

False

 

OIDC_RP_SCOPES

email profile openid

False

 

OIDC_RP_CLIENT_SECRET

(from Google)

False

 

OIDC_RP_CLIENT_ID

(from Google)

False

 

OIDC_OP_USER_ENDPOINT

https://openidconnect.googleapis.com/v1/userinfo

False

 

OIDC_OP_TOKEN_ENDPOINT

https://oauth2.googleapis.com/token

False

 

OIDC_OP_JWKS_ENDPOINT

https://www.googleapis.com/oauth2/v3/certs

False

 

OIDC_OP_AUTHORIZATION_ENDPOINT

https://accounts.google.com/o/oauth2/v2/auth

False

IMPORTANT! The Public property of all of the above-mentioned options must have the False value! (set by default)

If you want to allow anonymous users to view assets, use ALLOW_ANONYMOUS_USERS = True. This parameter must be public (Public = True) regardless of the value of the parameter itself.

To allow authorization BOTH via Gsuite AND via Picvario, the MULTI_AUTH parameter is used. This parameter is also public (Public = True).

MULTI_AUTH=True/False 

  • parameter that determines whether authentication is possible using several available methods: standard and via OpenID. In the UI, this option is displayed as a page with the standard login and password fields and an additional button at the bottom: "Sign in via corporate account". When the value is False, the authentication option is determined by the OPENID_AUTH_ENABLED.

Sequence of public key search for token verification / Option Priority:

  1. OIDC_RP_IDP_SIGN_KEY_PATH
  2. OIDC_RP_IDP_SIGN_KEY
  3. OIDC_OP_JWKS_ENDPOINT

If errors such as

SuspiciousOperation

or

JWS token verification

failed appear, make sure there is no conflict between these options. 

Only 

OIDC_OP_JWKS_ENDPOINT

should be specified for GSuite. Other options in this list should be left empty!


    • Related Articles

    • Picvario: Taxonomy

      Taxonomy is a hierarchical/tree-like label structure and a useful tool for organizing content. A simple example of taxonomy is organizing files into folders in Windows Explorer. Taxonomy trees can be created by system administrators only. Once ...
    • Picvario: How to Customise the Appearance of the System

      The appearance of Picvario can be customised according to your brand visual identity. Currently, you can choose what the logo of your workspace will look like and what colour scheme will be used for some elements of the interface. To set the ...
    • Picvario: AzureAD Integration

      Use this function to configure authorization through Microsoft Azure Active Directory. On the AzureAD side On the Azure AD side, please, specify: Callback: https://<yourworkspacename.api.picvario.com>/oauth2/callback For example: ...
    • Picvario: Managing Users

      You can add new users both through the Picvario interface and admin panel. Manage access rules is only possible in the admin panel. Creating a new user in the Picvario interface In the Picvario interface go to User profile - System settings — User ...
    • Picvario: System Options

      Users with admin rights are able to manage import restrictions and other system settings. For editing the options, go to System Settings > Options > Main. Maximum number of files when importing via web browser. The default value is set to 100. This ...