> For the complete documentation index, see [llms.txt](https://community-test.logicnets.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://community-test.logicnets.com/release-9/design-considerations-and-frameworks/frameworks/logon-framework/logon-framework-project-settings.md).

# Logon Framework Project Settings

## Description

The Logon Framework has some project-level settings that allow you to customize the opening logon page and display of user meta data. In addition, there are settings that control local login authentication options and the operation of the *Request Access* screen.

## Standard Logon Screens

The user screens accessible from the logon package are as follows:

* Logon page You can easily customize this page with your corporate logo and application title, and you can style your logon page and application with your corporate colors. You can also control the authentication options available to the user. The cookie policy banner is managed using the System Configuration package.

  ![](https://2802811211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdFhfexCjZ5JMhwGzzywq%2Fuploads%2Fgit-blob-606f1d5f3b38c5652217b5280c562835a62e1320%2F4e466895-b920-46bf-8b2e-e38861fbf0d7.jpg?alt=media)
* Request Access Page This page has options that require/show/hide the company and license code fields and can be styled using CSS.

  ![](https://2802811211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdFhfexCjZ5JMhwGzzywq%2Fuploads%2Fgit-blob-cb2715eef23e5b7ccd305d7d70e222d11bb31e08%2F3c815cca-7150-4ffd-96c1-67aa8ea9c3a8.jpg?alt=media)
* Portal Page This page displays the published applications and tools allocated to the user via the User Management module. You can style it using CSS.

  ![](https://2802811211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdFhfexCjZ5JMhwGzzywq%2Fuploads%2Fgit-blob-31cebee79efdd46fa54388bc8efa122a50edd2f7%2Fe361d47f-9f8e-49aa-b1ee-9d192b4dcb12.jpg?alt=media)
* User Details Pages Consisting of a view and an edit version of the page, the user details page has an option to lock the company field as display only and can be styled using CSS.

  ![](https://2802811211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdFhfexCjZ5JMhwGzzywq%2Fuploads%2Fgit-blob-c053588d5a3baafbec0d0062a77a37c96287b003%2F372514f4-3543-4252-a590-dcd7f5224a14.jpg?alt=media)

Note that more sophisticated customization of all of the above screens is possible. See the [Customized Logon](/release-9/design-considerations-and-frameworks/frameworks/logon-framework/customized-logon.md) article for more information.

## Project Settings

The following table contains information about the customizable settings.

| General Project Settings                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Title                                        | The system will display text entered in this field as the title in the standard top bar - Item 1 on the screenshot above. This field can include HTML DIVs that specify CSS classes to allow you to create a customized title layout with your corporate look and feel.                                                                                                                                                                                                                                                                                                                                                                                                 |
| Footer Text                                  | The system will display this text at the bottom of the page - see Item 2 on the screenshot at the top of this article showing "powered by LogicNets".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Custom JS                                    | From the /resources/layout/js folder select any JS file containing your custom JavaScript required for form operation (Advanced).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Custom CSS                                   | <p>From the /resources/layout/js select any CSS file folder containing your custom Cascading Style Sheet required for form operation (Advanced).<br>This file can reference any images, such as your corporate logo, and other styling to create the desired effect on the form.</p>                                                                                                                                                                                                                                                                                                                                                                                    |
| <p>Custom Layout Template<br>(advanced)</p>  | A custom layout template may be required for specific use cases. This is an advanced feature and you should discuss it with your LogicNets Account Manager if you would like to know more.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Initialization Net                           | <p>The logicnet listed here will run as part of the start-up initialization of the logon package. This is where you set logic and variables required for the correct operation of your login module.<br>This is also the gateway to a more sophisticated level of customization. See our article on <a href="/release-9/design-considerations-and-frameworks/frameworks/logon-framework/customized-logon.md">Customized Logon</a> for more information on this.</p>                                                                                                                                                                                                     |
| Name of Custom Welcome Form Include          | You can use these fields to display additional tabs and control actions. See Customization Nets/Folders in Assessment for more information about each of these fields.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Local Settings**                           | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Username/password                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Account details requires company information | Use this option to mandate an entry in the "Company" field when the user is completing the *Request Access* form.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Allow company of user details to be modified | <p>Use this option to <strong>lock</strong> the "Company" field so that it cannot be edited by the user.<br>This is useful when your application is used by different departments or organizations and you want to use the "Company" field to control access to a subset of the data.</p>                                                                                                                                                                                                                                                                                                                                                                               |
| Account request promo or license code        | This setting can be *Mandatory*, *Yes* or *No* depending on how you want the Request Access screen to work. Setting it to *Mandatory* will require a license code, while the *Yes* option will make it optional and *No* will remove the input field from the form.                                                                                                                                                                                                                                                                                                                                                                                                     |
| Use Google reCAPTCHA in user request form    | <p>When this option is set to <em>Yes</em> the Google reCAPTCHA is activated in the <em>Request Access</em> form.<br>This is a frictionless fraud detection service that stops bots and other automated attacks while approving valid users.<br>For this security feature to be operational you must provide the public key in the <em>SystemConfiguration</em> package as part of the setup.</p>                                                                                                                                                                                                                                                                       |
| **oAuth Settings**                           | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Smart Health (FHI)                           | This configuration requires changes in the settings files to be functional. Please discuss with your LogicNets Account Manager.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Windows Live                                 | This configuration requires changes in the settings files to be functional. Please discuss with your LogicNets Account Manager.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Google                                       | This configuration requires changes in the settings files to be functional. Please discuss with your LogicNets Account Manager.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Office365                                    | This configuration requires changes in the settings files to be functional. Please discuss with your LogicNets Account Manager.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Custom                                       | This configuration requires changes in the settings files to be functional. Please discuss with your LogicNets Account Manager.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Web Server Authentication**                | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Active Directory                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Custom SSO Handler**                       | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| SSO Handler Net                              | <p>Your logicnet referenced here will run when triggered and can be used to provide additional logic and information to support single sign on.<br>To trigger this logicnet, provide a query parameter in the start URL with "action=custom" as per the example below.<br><em>https\://\[domain]/\[company\_name]/\[custom\_logon\_startcode]?action=custom</em><br>At the end of the logicnet, the user should use a client-side script (JavaScript) to redirect to the right URL. (Back to the original application)<br><em>Note: This is an advanced topic and we therefore suggest discussing your requirements with a LogicNets Technical Representative.</em></p> |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://community-test.logicnets.com/release-9/design-considerations-and-frameworks/frameworks/logon-framework/logon-framework-project-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
