Jumpcloud
Jumpcloud, is a Unified Device and Identity Access Management platform that provides services such as Multi-Factor Authentication (MFA), Single Sign-On, password management, and cloud directory. In this guide, we integrate the Jumpcloud SSO to authenticate users into the Wazuh platform.
There are three stages in the single sign-on integration.
Jumpcloud Configuration
Create an account in Jumpcloud. Request a free trial if you don't have a paid license.
Create a new user. This step can be skipped if you are just testing, you can use your Jumpcloud
admin
user for example.Go to User Management, click on Users > (+) > Manual user entry. Fill in the user information, activate the user and click on save user.
Create a new group and assign the user.
Go to User Management > User Groups > (+) and give a name to the group. In our case, this is
wazuh-readonly
.The name you give to your group will be used in the configuration. It will be our
backend_roles
inroles_mapping.yml
.In the selected User Groups, go to the Users tab, select the newly created user and Save the changes.
Create a new app. Configure the SAML settings while you create the app.
Under the User Authentication section, go to SSO Applications, click + Add New Application, and select Custom Application.
Complete the Create New Application Integration page with the appropriate information.
Click Next on the Select Application page.
Check the Manage Single Sign-On (SSO) and Configure SSO with SAML options on the Select Options page. Click Next to proceed to the next step.
Assign a Display Label to the application, and click the Show this application in User Portal checkbox on the Enter General Info page. Click Save Application to apply the settings.
Click Configure Application on the Review page.
Complete the SSO tab with the appropriate information.
IdP Entity ID:
wazuh
(this will be theidp.entity_id
in our Wazuh indexer configuration).SP Entity ID:
wazuh-saml
(this will be thesp.entity_id
in our Wazuh indexer configuration).ACS URL:
https://<WAZUH_DASHBOARD_URL>/_opendistro/_security/saml/acs
Check Sign Assertion.
Check Declare Redirect Endpoint.
Check include group attribute and add Roles as the attribute. This will be used later in the
config.yml
configuration file.
The rest of the options can be left as their default values.
On the User Groups tab, select the Group created previously and click save.
Note the necessary parameters from the SAML settings of the new app.
Open the recently created application, go to the SSO tab and select Export Metadata. This will be our
metadata_file
. Place the metadata file in the configuration directory of the Wazuh indexer. The path to the directory is/etc/wazuh-indexer/opensearch-security/
.Extract the
exchange_key
from themetadata_file
under theds:X509Certificate
tag.
Wazuh indexer configuration
Edit the Wazuh indexer security configuration files. We recommend that you back up these files before you carry out the configuration.
Place the
metadata_jumpcloud.xml
file within the/etc/wazuh-indexer/opensearch-security/
directory. Set the file ownership towazuh-indexer
using the following command:# chown wazuh-indexer:wazuh-indexer /etc/wazuh-indexer/opensearch-security/metadata_jumpcloud.xml
Edit the
/etc/wazuh-indexer/opensearch-security/config.yml
file and change the following values:Set the
order
inbasic_internal_auth_domain
to0
and thechallenge
flag tofalse
.Include a
saml_auth_domain
configuration under theauthc
section similar to the following:
authc: ... basic_internal_auth_domain: description: "Authenticate via HTTP Basic against internal users database" http_enabled: true transport_enabled: true order: 0 http_authenticator: type: "basic" challenge: false authentication_backend: type: "intern" saml_auth_domain: http_enabled: true transport_enabled: true order: 1 http_authenticator: type: saml challenge: true config: idp: metadata_file: '/etc/wazuh-indexer/opensearch-security/metadata_jumpcloud.xml' entity_id: wazuh sp: entity_id: wazuh-saml forceAuthn: true kibana_url: https://<WAZUH_DASHBOARD_URL> roles_key: Roles exchange_key: 'MIIBkTCB+wIBADBSMQs......' authentication_backend: type: noop
Ensure to change the following parameters to their corresponding value:
idp.metadata_file
idp.entity_id
sp.entity_id
kibana_url
roles_key
exchange_key
Run the
securityadmin
script to load the configuration changes made in theconfig.yml
file.# export JAVA_HOME=/usr/share/wazuh-indexer/jdk/ && bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/securityadmin.sh -f /etc/wazuh-indexer/opensearch-security/config.yml -icl -key /etc/wazuh-indexer/certs/admin-key.pem -cert /etc/wazuh-indexer/certs/admin.pem -cacert /etc/wazuh-indexer/certs/root-ca.pem -h localhost -nhnv
The
-h
flag specifies the hostname or the IP address of the Wazuh indexer node. Note that this command uses localhost, set your Wazuh indexer address if necessary.The command output must be similar to the following:
Security Admin v7 Will connect to localhost:9200 ... done Connected as "CN=admin,OU=Wazuh,O=Wazuh,L=California,C=US" OpenSearch Version: 2.8.0 Contacting opensearch cluster 'opensearch' and wait for YELLOW clusterstate ... Clustername: wazuh-cluster Clusterstate: GREEN Number of nodes: 1 Number of data nodes: 1 .opendistro_security index already exists, so we do not need to create one. Populate config from /etc/wazuh-indexer/opensearch-security Will update '/config' with /etc/wazuh-indexer/opensearch-security/config.yml SUCC: Configuration for 'config' created or updated SUCC: Expected 1 config types for node {"updated_config_types":["config"],"updated_config_size":1,"message":null} is 1 (["config"]) due to: null Done with success
Wazuh dashboard configuration
Create a new role mapping for the backend role. Follow these steps to create a new role mapping, and grant read-only permissions to the backend role.
Log into the Wazuh dashboard as administrator.
Click the upper-left menu icon ☰ to open the options, select Security, and then Roles to open the roles page.
Click Create role, complete the empty fields with the following parameters, and then click Create to complete the task.
Name: Assign a name to the role.
Cluster permissions:
cluster_composite_ops_ro
Index:
*
Index permissions:
read
Tenant permissions: Select
global_tenant
and theRead only
option.
Select the newly created role.
Select the Mapped users tab and click Manage mapping.
Under Backend roles, add the name of the group you created in JumpCloud and click Map to confirm the action. In our case, the backend role is
wazuh-readonly
.
Check the value of
run_as
in the/usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml
configuration file. Ifrun_as
is set tofalse
, proceed to the next step.hosts: - default: url: https://localhost port: 55000 username: wazuh-wui password: "<wazuh-wui-password>" run_as: false
If
run_as
is set totrue
, you need to add a role mapping on the Wazuh dashboard. To map the backend role to Wazuh, follow these steps:Click the upper-left menu icon ☰ to open the available options.
Click Wazuh to open the Wazuh dashboard menu, select Security, and then Roles mapping to open the page.
Click Create Role mapping and complete the empty fields with the following parameters:
Role mapping name: Assign a name to the role mapping.
Roles: Select
readonly
.Custom rules: Click Add new rule to expand this field.
User field:
backend_roles
Search operation:
FIND
Value: Assign the name of the group you created in JumpCloud. In our case, the backend role is
wazuh-readonly
.
Click Save role mapping to save and map the backend role with Wazuh as read-only.
Edit the Wazuh dashboard configuration file. Add these configurations to
/etc/wazuh-dashboard/opensearch_dashboards.yml
. We recommend that you back up these files before you carry out the configuration.opensearch_security.auth.type: "saml" server.xsrf.allowlist: ["/_opendistro/_security/saml/acs", "/_opendistro/_security/saml/logout", "/_opendistro/_security/saml/acs/idpinitiated"] opensearch_security.session.keepalive: false
Restart the Wazuh dashboard service.
# systemctl restart wazuh-dashboard
# service wazuh-dashboard restart
Test the configuration. Go to your Wazuh dashboard URL and log in with your Jumpcloud account.