Difference between revisions of "SSO Check List"

From IVS Wiki
Jump to: navigation, search
Line 35: Line 35:
 
:{{Checkbox - empty | item = Understand VALT [[VALT_Technical_Specifications#Users_.26_Groups | Users & Groups]].}}
 
:{{Checkbox - empty | item = Understand VALT [[VALT_Technical_Specifications#Users_.26_Groups | Users & Groups]].}}
 
}}
 
}}
 
{{hr}}
 
 
==Required Information from IdP==
 
<dl>
 
<dt>Identity Provider (IdP) URL</dt>
 
<dd class="singleLineHeight">This refers to the service or application that manages and authenticates user identities, which VALT will use to verify login credentials.</dd>
 
<dt>Remote Sign-In URL</dt>
 
<dd class="singleLineHeight">This is the URL provided by the IdP where users are redirected to initiate the login process.</dd>
 
<dt>Remote Sign-Out URL</dt>
 
<dd class="singleLineHeight">This URL leads to the IdP's logout page, where users can safely end their sessions, ensuring a secure sign-out process from VALT.</dd>
 
<dt>Certificate in .cer format</dt>
 
<dd class="singleLineHeight">VALT requires a digital certificate in .cer format from the IDP to establish a secure, encrypted communication channel.</dd>
 
</dl>
 
 
{{hr - 2}}
 
 
<h3>Optional Items</h3>
 
{{Aside - Helpful | content = VALT is also able to map custom attributes to some of the following fields for a user:}}
 
 
<dl>
 
<dt>Display Name Attribute</dt>
 
<dd class="singleLineHeight">This specifies the user attribute (such as username or email) that VALT displays within the application.</dd>
 
<dd class="singleLineHeight"><em>Helpful when people are not easy to recognize by the username field</em>.</dd>
 
<dt>Pin Code</dt>
 
<dd class="singleLineHeight">This specifies the code used for authentication into [[BEAM]].</dd>
 
<dd class="singleLineHeight"><em>Without one set, no pin is needed to enter BEAM</em>.</dd>
 
<dt>Card Number</dt>
 
<dd class="singleLineHeight">This specifies the card number associated with a user.</dd>
 
<dd class="singleLineHeight"><em>Only applies to customers with [[VALT Card Reader]]</em>.</dd>
 
<dt>Email</dt>
 
<dd class="singleLineHeight">The users email can also be pulled into the system.</dd>
 
<dd class="singleLineHeight"><em>If the VALT application is not connected to mail server, this field is not used for anything.</em></dd>
 
</dl>
 
 
{{hr}}
 
 
==User Mapping==
 
User mapping is used to map groups in the customer's system to groups within VALT. Users are mapped to VALT groups using attributes and values being passed from the IdP.
 
{{Aside | content = <b>NOTE:</b> SSO in VALT is a one to one mapping for groups}}
 
 
{{hr - 2}}
 
 
===Required===
 
<dl>
 
<dt>Name</dt>
 
<dd class="singleLineHeight">The value to define the mapping. <em>Used only in this section of VALT.</em>
 
<dt>Attribute</dt>
 
<dd class="singleLineHeight">The item that gets passed back to VALT.</dd>
 
<dt>User Value<dt>
 
<dd class="singleLineHeight">The value of the item that gets passed back to VALT.</dd>
 
<dt>Group to Add</dt>
 
<dd class="singleLineHeight">The group created on the VALT side that defines the user's rights in the application.</dd>
 
</dl>
 
 
}}
 
}}

Revision as of 10:00, 1 April 2024

SAML Check List

Where to Begin?

Before SSO is configured on your VALT server, there are a few things that need to be done, setup, and understood. This article aims to help you identify where you are in the process and what steps need to be done before you configure SSO on your server!


SSO Checklist

The following list of items should be done, in order. Identifying where you are in this process is your first step!


New System

If you have a new system, use this list to identify what needs to be done.

☑ Identify desire to use SSO for VALT authentication.

☐ Server racked and patched. **If a VM is being used, ensure you have completed our VM Validation**.

☐ Create DNS entry for VALT and install an SSL certificate. **IVS can generate CSR's and install the certs.**.

☐ Configure VALT to talk to an NTP server.

☐ Understand the SSO workflow.

☐ Understand VALT Users & Groups.


Existing System

If you have an existing system, use this list to identify what needs to be done.

☑ Identify desire to use SSO for VALT authentication.

☐ Create DNS entry for VALT and install an SSL certificate. **IVS can generate CSR's and install the certs.**.

☐ Configure VALT to talk to an NTP server.

☐ Understand the SSO workflow.

☐ Understand VALT Users & Groups.