Neuvector SSO Configuration

Prerequisites

• Ensure the Global SSO Settings have already been configured for this cluster.
• Access to Keycloak Master Realm

Create Keycloak Client

tip

If this client already exists due to it being configured for another cluster, consider adding the environment name as common prefix to the client name. For example, the client name could be my-org-run-neuvector.

1. While you are in the smoothglue realm, click on Clients under Manage in the left pane.
2. Click Create client.
3. Enter client name neuvector for Client ID.
4. Click on the Next button.
5. Toggle on Client authentication.
6. Click on the Next button. Note: The application's FQDN name may be obtained by running kubectl get virtualservice -A
7. Enter https://{{ application_fqdn }}/openId_auth for Valid Redirect URIs.
8. Click on the Save button.

Creating Client Scopes

Neuvector needs to be added in the Client Scopes.

1. While you are in the smoothglue realm, click on Client Scopes.
2. Click Create client scope.
3. Enter Neuvector for Name, and click on the Save button.
4. Go to the Mappers tab.
5. Click Configure a new mapper.
6. Select Group Membership
7. Enter the following information:
   1. Name - Groups
   2. Token claim Name - groups
   3. Full group path - Enabled
   4. Add to ID token - Enabled
   5. Add to access token - Enabled
   6. Save
8. Go to Clients, and click on the same client name received for Neuvector.
9. Go to the Client Scopes tab.
10. Click Add client scope.
11. Enable the Neuvector client scope.
12. Click Add -> Default.

SSO Configuration

Retrieve the client_secret from the Keycloak client:

1. As a Keycloak Admin and within the smoothglue realm, click Clients on the left-hand panel.
2. Click on the neuvector client.
3. Click on the Credentials tab.
4. Copy the value from the Client Secret field.

Add the following values to bigbang-secrets.yaml to configure SSO:

neuvector:
  values:
    neuvector.ini:
      auth.generic_oauth:
        role_attribute_strict: true
  sso:
    enabled: true
    client_id: neuvector # should match the client name in keycloak
    client_secret: ""    # change to your Neuvector client secret
    group_claim: groups
    group_mapped_roles:
      - group: /_structsureAdmins
        global_role: admin
      - group: /_structsureAudit
        global_role: reader

info

See How to Configure Big Bang Values for more information on configuring Big Bang applications.