System Settings

---

"Mail server(s)" , "Internal network" , "Notifications", "Active Directory" ,"SFTP transfer" , "System Information", "System preferences", "Theme", Jobs dashboard , "Proctoring settings", "Proctorio settings", "Additional modules" ,"System support", "Single sign-on" and "LRS settings" are located in the "System settings" page.

1. Accessing the page

   To access the "System settings" page, you should click on the "System" menu and select "System settings."

   
2. Page layout

On the "System settings" page you will find these tabs: "Mail server", "Internal network", "Notifications", "Active Directory", "SFTP transfer", "System information", "System preferences", "Theme", "Proctoring settings", "Proctorio settings", "Additional modules","System support", "Single sign-on" and "LRS settings" .



1. Mail server

   The "Mail server" tab serves to set parameters for a mail server that will be used for sending various notifications to administrators and users via email. There is no limit regarding the number of mail servers that can be set.

   
   Mail server
   1. The drop-down list determines the mail server from which the parameters are displayed.
   Parameters
   2. Enter the hostname of the mail server.
   3. Enter the port number of the mail server.
   4. Enable SMTH authentication.
   5. Enable starting TLS protocol.
   6. Enter the username of the mail server.
   7. Enter the password for the mail server.
   8. Enter the email address a recipient will see as the sender's address.
   Server status
   9. You can test if the mail server works by sending an email to the address you specify in the "Send test email to" field.
   10. Click the "Send" button to send the test email.
   Note: only one mail server can be active at a time. You can set a mail server to be active by clicking on the "Activate" button in the form of an inactive mail server. Only inactive mail servers can be deleted by clicking on the "Delete" button in the form of the inactive mail server.
   11. By clicking the "Update existing" button, the entered parameters will be applied to the selected mail server.
   12. By clicking on the "Create new" button, you will create a new mail server with the entered parameters.
   Mail job parameters
   13. Interval - enter the number of second between two successive executions of the mail job.
   14. Batch size - enter the maximal number of emails sent during one execution of the mail job.
   15. Click the "Save mail job parameters" button to save the changes.


2. Internal network

   The "Internal network" tab allows you to define the IP addresses within your local network from which certain parts of the application can be accessed.

   
   1. This is the IP mask of the internal network, only machines with IP addresses starting with this prefix will be allowed access.
   2. This is the client's IP address.
   3. Clicking the "Confirm" button will save the changes you have made.
   4. Clicking the "Cancel" button will invalidate all the changes you have made.


3. Notifications

   The "Notifications" tab contains email and in-application notification templates sent automatically when a certain action is made inside the application. The emails and application notifications are predefined but can be edited by changing email/application notification templates. When editing the templates, the variables (text between $ signs) cannot be edited, added or removed.

   

   How to configure notifications.

   
   
   
   1. The notification name serves to identify a particular event. Here you will be able to find all notifications available in the system.
   2. The application notification section is used to configure notifications and templates in the application.
   3. The email notification section is used to configure notifications and templates that will be sent to users via email.
   4. The "Status" column has the option "Enable/Disable."
   5. The "Edit" option prompts a dialog for a selected mail/application notification.
   
   1. This is the body of the email. The text can be edited, but all the variables must remain the same because it replaces them with specific data.
   2. This is the list of all variables of a selected email template.
   3. This is the "Mail subject name" box where you can change the email subject.
   
   1. This is the body of the application notification. The text can be edited, but all the variables must remain the same because it replaces them with specific data.
   2. This is the list of all variables of a selected application notification template.
   3. This is the "Notification title" which can be configured for the selected notification.
      

   To save the modified email/application template, click on the "Save" button. If some of the variables are missing, you will be prompted with an error message.

   If you accidentally delete any of the variables, it will be shown in the missing variables list.

   Clicking the "Cancel" button will close the opened dialog.

   To see how to trigger each notification, please see how to configure notifications.

4. Active Directory

   Please note that the Active Directory can be enabled only upon your request. For more information, contact the YouTestMe team at sales@youtestme.com.

   1. To configure the integration with Active Directory or other directory services that support LDAP protocol, choose the "Active Directory" tab on the "System settings" page.
   2. Enter the "LDAP server" address. This parameter is the LDAP URL address of the directory's domain controller. It is usually a combination of LDAP protocol, a host of the directory's domain controller, and the LDAP port:
      [ldap|ldaps]://{DOMAIN_CONTROLLER_HOST}:{LDAP_PORT} (for example: ldap://mydomain.org:389)
   3. Enter the "Search Base" parameter, representing the node under which the users will be searched for. It is usually a distinguished name of a root node or a node of an organizational unit or group.
      For example: OU=Testing Center,DC=mydomain,DC=org
   4. Optionally enter the "Search filter," a parameter used for filtering the users for synchronization within the Search Base node to be synchronized in GetCertified. A filter has to be in the format specified here. Usually, it is a filter that will match the users from a directory group or users with specific attributes.
      By the default (&(objectClass=user)(samaccountname=*)(sn=*)(givenName=*)(mail=*)(objectGUID=*)) is applied to match only users with non-null parameters required for GetCertified user creation.
      For example: (memberOf=CN=YTM users, OU=Testing Center, DC=server, DC=net) - Only the users that belong to the "YTM users" group will be synchronized and able to sign into GetCertified with the Active Directory credentials. If you change the Search Filter or Search Base. In that case, all users that are synchronized and don't match the new Search Filter and Search Base will remain in GetCertified, but will not sign in using the Active Directory account credentials anymore.
   5. Enter the "Service account.", a distinguished Name or User Principal Name of the Active Directory account, which is used to establish the LDAP connection and synchronize the users. This account does not have to match the Search Filter.
      
   6. Enter the "Password" of the service account.
   7. Click the "Confirm" button if you want to save the Active Directory integration settings.
   8. To reset the changes you have made, click the "Cancel" button.
   
5. SFTP transfer

   On the "SFTP Transfer" tab, you can activate sending test completion reports stored in a CSV format. If activated, reports will be sent at regular intervals. They will contain information that refers to all newly completed test attempts (an empty CSV file will be sent if none of the test attempts were completed successfully in a defined interval).
   Note: This tab is visible only to the clients who requested this module to be activated.

   
   1. Here you can adjust if the transfer is "Active" or "Inactive."
   2. Here you should enter the IP address.
   3. Here you should enter the port.
   4. Here you should enter the username.
   5. Here you should enter the password.
   6. Here you should enter the time interval (in minutes).
   7. Displayed here is the time when the last report was sent.
   8. Click the "Confirm" button if you want to save the changes you have made.
   9. If you are not satisfied with the changes you have made, click the "Cancel" button.


6. System information

   Basic information about your system is displayed on the "System information" tab.

   You can access release info by clicking on the link "Open Release Info," and it will open in a new tab.

   


7. System preferences

   On the "System preferences" tab, you can customize certain elements of the application.

   
   Standard date and time format
   1. The date format in the application is displayed here.
   2. The time format in the application is displayed here.
   3. Enable additional languages.
   Answer ordinal markup
   4. Choose one of three options to display the answer ordinal:
      - NUMERICAL - Answer ordinal numbers will be presented as "1. 2. 3..."
      - ALPHA_LOWER - Answer ordinal numbers will be presented as "a. b. c..."
      - ALPHA_UPPER - Answer ordinal numbers will be presented as "A. B. C..."
      Note: The markup you choose will apply to all new and old tests/surveys. It will apply for the test creation process, test-taking process, personal report, and report builder.
   White labeling options
   5. You can modify the web browser tab title text.
   6. You can modify the text next to "Copyright" on the login page.
   7. You can modify the confirmation text on the instruction screen dialog of "All assignments."
   8. You can modify the $from$ parameter in the system emails for all emails sent from the application.
   9. You can modify the URL of the application in the emails sent from the system.
   10. Login instructions - you can write detailed guidelines or put useful links so the users will know what to do when login.
   11. You can choose to display the YouTestMe privacy policy.
   Score report
   12. Passing criteria - Enter the text on the conditions for taking the test.
   13. Main text description - Enter the necessary information about the test.
   14. Sections description - Enter information about sections.
   15. Re-test policy - Enter information about retaking the test.
   16. Show pool information - Check this option if you want the report to contain information about the pools included in the test.
   17. Show sections diagram - Check this option if you want the report to contain information about the candidates' achieved results for each section.
   18. Show section groups diagram - Check this option if you want the report to contain a diagram for created section groups.
   Logo
   19. If you click the "Change logo," you can change the logo on the login page.
   20. If you click the "Default logo," you can change the login page's logo to the default "YouTestMe" logo.
   Favicon
   21. If you click "Change favicon," you will change the icon next to the web browser title text.
   22. If you click "Cancel," you will cancel the change of the favicon.
   System parameters
   23. "Session timeout in minutes" - Configure the length of the session timeout in minutes.
   24. "Lockout duration in minutes" - Configure for how long the user will be locked out after failed logins.
   25. "Redirect URL for the shared tests' end - Defines the URL users are redirected to at the end of the test accessed via direct links shared to them. URL should start with "http://" or "https://".
   26. If you are satisfied with the changes you have made, click the "Confirm" button.
   27. If you are not satisfied with the changes you have made, click the "Cancel" button.
   

   How to change the application theme.



8. Theme

   On the "Theme" tab, you can:

   1. Make application rebranding according to your company/organization colors.
   2. After making the desired changes click the "Confirm" button.
   3. If you want to discard your changes, click the "Cancel" button.
   


9. Language Bundles

   In the "Language bundles" tab, users can customize the application interface text according to their needs - change labels' names, create new hints, modify notifications' content.

   There are 5 default language bundles in the system. A language bundle is a file consisting of the key/value pair properties. Each property is connected to one or multiple UI components based on a property key.

   

   Note that it is not possible to delete default language bundles, but you can create new ones based on them. Also, it is not possible to have two active bundles of the same type simultaneously.

   There are two ways to create a custom language bundle:
   1. Changing the language bundle by editing one-by-one property value.
   2. Downloading the language bundle, editing the file offline using the desired text editor, and importing it into the application.
      Note: The keys must not be changed. Otherwise, the changes will not be visible.
      
   To create a new language bundle by editing one-by-one property value:
   1. Click the "Pencil" icon for the language bundle based on which you want to create a new one.
   
   2. Search the property value or key you want to change.
   3. Choose the desired key from the list. If you cannot find the key for the desired property value, you can use preview key mode to easily find it. For more information on how to use it, please visit the Preview keys mode.
   4. Edit the text.
   5. Confirm or discard the changes you made in the property value field.
   Note: In one language bundle, you can edit as many property values as you want. All of them will be displayed when you activate the language bundle.
   6. Click the "Save as" button to save a new language bundle.
   
   To create a new language bundle by uploading a file:
   1. Download the language bundle and edit the file by changing the property values.
      Note: The downloaded file will be saved in .properties format.
   2. Load the file by clicking the "Load from properties file" button. The "Choose file" dialog will appear. Choose a modified .properties file and confirm your choice.
   3. Click the "Save as" button to create a new language bundle or the "Save" button to update the existing one.

   Once you create a new language bundle, it will have an inactive status.

   To activate a new language bundle:
   1. Click the "Activate language" button.
   
   2. Click the "Yes" button in the pop-up window.

      Note: Once you activate the language bundle, it will be applied globally, and the currently active bundle of the same type will be deactivated.

   Example of how the message looks before and after changes.

   Before

   

   After

   
   You can reactivate the default language bundle at any time. If you want to delete a custom language bundle:
   1. Click the "Trash can" icon.
   
   2. Click the "Yes" button in the pop-up window.
   

   After deleting a custom language bundle that was active, the default bundle will be activated automatically.

   Preview keys mode

   To easier modify the language bundles, you can use the option to display property keys.
   1. Click the "Activate preview keys mode" button.
   2. Open the page that contains the value you want to change. Then click the button to preview language bundle keys.
      The example is displayed in the following picture.
   
   3. Find the value you want to change, language bundle type, and the property key. Then continue following the steps for creating custom language bundles.
      The example is marked in the following picture.

   Once you want to turn off the keys preview mode, click the "Deactivate keys preview mode" button in the "Language bundles" tab.

10. Custom types

    Creating a custom type

    In the "Custom types" tab, users can create custom type and define value for the "Dropdown" type of custom user properties.

    1. Click on the "Custom types" tab.
    2. Click the "New custom type" button to create the "Dropdown" type of custom user properties.
    

    The new pop-up window will show up, where you should:

    1. Enter the name of the custom type. The name must be unique.
    2. Enter the description (optional).
    3. Click save to create a custom type.
    4. At any moment, you can cancel the creation of a new custom type by clicking the cancel button.
    

    Creating a value of the custom type

    Once you create a custom type, you should add new values. To do so:

    1. Click the show values icon (eye) to display a table of values for the wanted custom type.
    2. Click the "Add new value" button.
    

    The new pop-up will show up, where you should:

    1. Enter the name of the value. The name must be unique.
    2. Enter the description (optional).
    3. Click save to add a new value to a custom type.
    

    Editing and deleting custom types and their values

    1. At any moment, you can edit the existing custom type by clicking on the "pen" icon.
    2. You can delete the existing type only if there are no custom user properties of this type. In case you want to delete the type, first you will need to delete the custom user property of this type.
    3. You can export the list of custom types as XLS, PDF, CSV, and XML files.
    
    1. At any moment, you can edit the existing value by clicking on the "pen" icon.
    2. You can delete the existing value only if there are no custom user properties of this type. In case you want to delete the value, first you will need to delete the custom user property of this type.
    3. You can export the list of values as XLS, PDF, CSV, and XML files.
    
11. Jobs Dashboard

    On the "Jobs Dashboard" tab you can create jobs that will be executed at the scheduled time, as many times as you mark. The job allows you to automatically import the data from an external system into the YouTestMe GetCertified and export data from the YouTestMe GetCertified to an external system.

    Creating a New Job

    Click on the "New job" button.

    A dialog will appear to enter all the necessary information to create and schedule a new job.

    New job dialog consists of the following three sections:

    1. Job information - General information about the job, including type, name and description.
    2. Schedule settings - Parameters of the schedule, start time, end time, repeat interval, and the number of repeats.
    3. Job parameters - Specific job parameters related to the type of job.
    

    Job Information

    This part of the dialog is the same for each job regardless of the type you choose.

    1. Type - Choose whether you want to import or export data.
    2. Name - Enter the job name.
    3. Description - Optionally enter the job description.
    

    Schedule Settings

    This part of the dialog is the same for each job regardless of the type you choose.

    1. Start time - Choose the start time, the time when the job will execute for the first time. If the chosen start time is in the past, the first execution will occur next time according to schedule (multiply of the repeat interval if job repeats) or will not occur if the job does not repat.
    2. Repeat - Check the "Repeat" option to repeat the job periodically in equal time intervals after the start time. If it is unchecked, job will execute only once at the start time.
    3. Repeat forever - Check the "Repeat forever" option to repeat the job indefinitely or until the end time if specified.
    4. Number of repeats - If "Repeat forever" is unchecked, chose the number of repeats after the first job execution at the start time. If you choose three times, the job will be repeated three times in equal intervals after the start time and executed four times in total.
    5. End time - Optionally, choose the "End time." After the chosen time, the job will no longer execute, even if there are remaining repeats.
    6. Repeat interval - Specify the "Repeat interval," the time between two consecutive job executions. It could be at least 1 minute.
    

    Job parameters

    Importing data job parameters

    To create a new "Import data" job, do the following:

    1. Resource - Choose the type of data to import. You can choose between:
       1. Users
       2. Tests
       3. Testing sessions
       4. Session candidates
    2. Location - Choose the "Location" from which the files with data will be imported:
       1. Choose "File system" to import data from files located in the folder on the server's file system.
       2. Choose "SFTP server" to import data from files located in the SFTP server folder. For the SFTP server, additional parameters have to be specified.
    3. Folder - Enter the absolute path to the folder in the chosen location to import files from.
    4. File names - Enter the regex expression to match the names of the files to import from the folder. For example, the regex expression "Users_.*\.csv" will match all the files whose name starts with "Users_" with the ".csv" extension.
    5. Modified only - Check the "Modified only" option to import only files created or modified after the previous job execution, or leave it unchecked to import all files from the folder satisfying the "File names" regex expression.
    6. File type - The only supported File type currently is CSV.
    7. Delimeter - Enter the character to use for separating entries in CSV file.
    8. Skip lines - Enter the number of lines in the CSV file to skip before reading. Usually, it is set to one to skip the first line, which represents the header.
    

    Export data job parameters

    1. Resource - Choose the type of data to export referred to as "Resource." Currently, only the "Test results" (Completion statuses) option is available.
    2. Modified only - Check "Modified only" to export only records created or modified after the previous job execution. Otherwise, all records will be exported.
    3. Location - Choose the "Location" from which the files with data will be imported:
       1. Choose the "File system" to export the file to the folder located on the server's file system.
       2. Choose "SFTP server" to export the file to the SFTP server folder. For the SFTP server, additional parameters have to be specified.
    4. Folder - Enter the absolute path to the folder in the chosen location to export data to.
    5. File name - Enter the file name prefix of the file to export. The name of the exported file will be in the format: #{file_name}_#{timestamp}.#{file_type_extension}.
    6. File type - The only supported File type currently is the CSV.
    7. Delimiter - Enter the character to use for separating entries in the CSV file.
    

    SFTP server parameters

    1. Location - Choose the "SFTP server."
    2. Host - Enter the hostname of the SFTP server.
    3. Port - Enter the port of the SFTP server.
    4. Username - Enter the username of the SFTP server user.
    5. Password - Enter the password of the SFTP server user.

    The rest of the options are the same for each location and type.

    

    Jobs list

    Once you create a Job, you will see it in the table where all created jobs are saved and details about each. For each job listed in the table, the following actions can be executed:

    1. Excecute the job immediately, disregarding the current schedule.
    2. Preview complete excecution history and logs of a job.
    3. Edit job.
    4. Use the previously created job as a template, so you can change only a few pieces of information and save it as a new job.
    5. Delete the job.
    

    Execution history and logs

    To preview the complete execution history and logs for all jobs in the system:

    1. Click on the "Execution history and logs" to see the details about executed jobs.
    2. See the job type.
    3. See the time when the job is excecuted.
    4. See the number of errors occured during excecution.
    5. Preview a log.
    

    Job excuted notification

    After each job execution, the system administrators will receive the notification. To ensure that the system administrator will receive the notification, you need to enable it under "Notifications" tab. For more information on how to enable Job executed notification, visit Notifications .



12. Webex settings

    To set up the Webex integration, choose the "Webex settings" tab on the "System settings" page.
    "Client ID" and "Client Secret" need to be configured. You can find this information after you register the integration on the hosting Webex account.

    

    You should log in with the Webex hosting account on https://developer.webex.com/.

    

    Click on the profile icon and choose "My Webex Apps".

    

    Click on "Create a New App."

    
    1. Enter integration name.
    2. Enter Contact email.
    3. Choose icon.
    4. Enter Description.
    5. Enter Redirect URI, use the Redirect URI parameter from Webex Settings .
    6. Select all "Meetings" Scopes.
    7. Click "Add integration."
    

    Once you create an integration, you will get the "Client ID" and "Client Secret."

    
    1. Copy "Client ID" in the GetCertified Application under the "Webex settings" tab.
    2. Copy "Client Secret."
    3. Click the "Save" button.
    4. Click the "Get token" button, and you will be redirected to the Webex page, where you should log in again with the hosting Webex account.
    5. Once you are logged in, click the "Accept" button.
    

    Once you accept, the "Validate token" button will appear in the GetCertified application, which is an indication that you have access to this token.

13. Proctoring settings

    Please note that the Proctoring service can be enabled only upon your request. For more information, contact the YouTestMe team at sales@youtestme.com. Upon activation, you will be provided with all the necessary parameters for configuring the proctoring service. In case you request the proctoring service before the application delivery, all settings will already be configured.

    1. To configure the Proctoring service, choose the "Proctoring settings" tab on the "System settings" page.
    2. Enter the "Proctoring server URL" This parameter represents the Web address of the Proctoring server and is provided by YouTestMe.
    3. Enter the "Secret key" provided by YouTestMe.
    4. Enter the "Session template" name. This parameter represents the name of the proctoring session template created in the Proctoring application. The session template specifies additions (5) and metrics (6) of the Proctoring session. Enter the "default" for the default session template.
       * In the newer versions of the Proctoring service, this is the only way to specify the proctoring session. Chosen additions (5) and metrics (6) will not be considered.
    5. Choose the "Session metrics" from the dropdown menu. The session metrics represent the events that the service tracks and penalizes during the proctoring session.
       * This configuration will be considered only for the older versions of the Proctoring service.
    6. Choose the "Session additions" from the dropdown menu. The session additions represent the additional proctoring features that will be included in the proctoring session.
       * This configuration will be considered only for the older versions of the Proctoring service.
    7. Enter the "API address." provided by YouTestMe. Typically, it is a combination of the URL address of the YouTestMe GetCertified application and one of the endpoints (/proctoringResultsNew, /proctoringResults) the version of the Proctoring service.
    8. Click the "Confirm" button if you want to save the Proctoring configuration.
    9. To reset the changes you have made, click the "Cancel" button.
    


14. Proctorio settings

    Please note that the Proctorio can be enabled only upon your request. For more information, contact the YouTestMe team at sales@youtestme.com. Upon the activation, you will be provided with the necessary parameters to configure the integration with Proctorio.

    1. To configure the integration with Proctorio automated proctoring service, choose the "Proctorio settings" tab on the "System settings" page.
    2. Enter the "API endpoint" This parameter represents the URL of the Proctorio API endpoint and is provided by YouTestMe or Proctorio.
    3. Enter the "Secret key" provided by YouTestMe or Proctorio.
    4. Enter the "Consumer key" provided by YouTestMe or Proctorio.
    5. Choose the "Exam settings" from the dropdown menu. Exam settings enable you to choose the Proctorio features you want to add and control during the proctoring session.
       
    6. Click the "Confirm" button if you want to save the Proctorio integration settings.
    7. To reset the changes you have made, click the "Cancel" button.
    


15. Additional modules

    On the "Additional modules" tab, by enabling the next options, you can:

    1. Hide user's private information.
    2. Configure SFTP Protocol and automatically receive test results on your FTP server.
    3. Show or hide passed and failed labels through the application.
    4. Allow users to register in the application without the administrator's approval.
    


16. System support
    

    The "System support" tab serves to enable customized support. You can provide useful information such as support email, support phone number, and an additional description for users support page.

    1. Describe the purpose of email and phone.
    2. Provide desired support email.
    3. Provide desired support phone number.
    4. Here you can define useful details about support contact. For example, expected email response time to customers' issues or business hours when support is available, etc.
    5. The "Confirm" button will apply the changes.
    6. The "Cancel" button will delete everything entered before saving.


17. Single sign-on

    GetCertified can act as a Service Provider through the SAML 2.0 protocol, which allows the exchange of authorization data with an Identity Provider. GetCertified supports OneLogin, Okta, SSO Circle, and many other Identity Providers.

    SAML 2.0 based Single Sign-on (SSO) can be configured for multiple identity providers simultaneously. You need to create an SSO configuration and define the parameters of the identity provider. Each created SSO configuration you create has an assertion consumer service end-point that will process the SAML response.

    1. To access the Single sign-on configuration panel, choose the "Single Sign-on" tab on the "System settings" page.
    2. By clicking the "Add new configuration" button, a new pop-up window will appear where you can enter the parameters of the new SSO configuration.
    3. All existing Single sign-on configurations are displayed in the table with their names, descriptions, statuses, and available actions.
    4. By clicking the edit icon, a pop-up window will appear, where you can change the parameters of the selected SSO configuration.
    5. SSO configuration can be deleted by clicking the trash can icon.
    

    When creating a new or updating an existing SSO configuration, you need to enter the parameters for configuring the service provider's side.



When creating a new or updating an existing SSO configuration, you need enter the parameters for configuring the service provider's side. GetCertified provides the parameters that you need to configure the identity provider's side.

1. Enter the "Name" of the SSO configuration. The name must be unique for each SSO configuration since it identifies the SSO configuration.
2. Optionally enter the "Description" of the SSO configuration.
3. Choose the "Status" of the SSO configuration. If the status is "Enabled," users will be able to sign in with the identity provider specified in the configuration. Otherwise, they will not be able to do so.
4. Use the provided "Service provider Entity ID" URL to configure the service provider on the identity provider's side. The value represents the service provider's identifier.
5. Use the provided "Assertion consumer service URL" to configure the service provider on the identity provider side. The field's value represents the end-point URL, where the SAML response from the identity provider will be returned.
6. Choose the "Assertion consumer service binding" that is suitable for the identity provider. The field's value represents the SAML protocol binding when returning the SAML response from the identity provider.
7. Enter the "Identity provider Entity ID," identifier of the provider entity. The entered value must be an URL.
8. Enter the "Single sign-on service URL," an URL of the identity provider's single sign-on service end-point, where the service provider will send the authentication request.
9. Choose the "Single sign-on service binding," a SAML protocol binding when the service provider sends the authentication request to the identity provider.
10. Input the "Certificate," the public x509 certificate of the identity provider. The certificate must be in a string format without headers. Use the tool on the following link to convert the certificate to a string format without headers.
11. Enter the "Username attribute," the name of the assertion in the SAML response whose value will be used as the GetCertified user's username.
12. Enter the "Email attribute," the name of the assertion in the SAML response whose value will be used as the GetCertified user's email.
13. Optionally enter the "First name attribute," the name of the assertion in the SAML response whose value will be used as the GetCertified user's first name.
14. Optionally enter the "Last name attribute," the name of the assertion in the SAML response whose value will be used as the GetCertified user's last name.



3. LRS settings

   The LRS settings assure the manager of a test to send each candidate's test results into the LRS system and track each candidate's success.
   The given explanation is just an example of the Yet Analytics Learning Record Store integration with GetCertified. You can use any other Learning Record Store that supports Tin Can API (xAPI). Before you start configuring LRS parameters in the system settings, you need to log in to the LRS system. To set up your LRS parameters :

   1. Visit the Yet Analytics link.
   2. Sign up to receive the verification email.
   After the successful signing up into the LRS system, you can log in to the LRS. To do so :
   1. Enter your email.
   2. Enter password.
   3. Click the "Sign in" button.

   If you forgot the password:

   4. Click on the "Reset password" link.
   
   Note: After you log in with your LRS user credentials, you will receive your API endpoint, API key, and API secret key to make the LRS integration with GetCertified possible. When you log in to the LRS, you can see the LRS parameters you will insert to finish the configuration process.
   To preview your LRS parameters:
   1. Click "LRS SETTINGS."
   2. Click "Info."
   

   The pop-up window will open, and there you can see all the needed parameters you will insert in the GetCertified.

   
   To configure learning record store parameters, go to the "System settings" page, find the "LRS settings" tab, and fill the following fields:
   1. API endpoint - insert the endpoint URL LRS has provided you.
   2. API key - insert the key, which provides you authentification.
   3. API secret key - insert the secret key used for the authentication process as well.
   4. Click the "Confirm" button to save the configuration.
   5. Click the "Cancel" button to revert the changes.
   

---

System settings