# Technical Guide ## Configuration ### bfSupportAgent: | Field | Data Type | Description | | ----- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | orgId | String | Set to the company's organization ID, as displayed on the BlueFletch Portal Admin - Organization page[ here](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/organization). | ### appConfig > bfAuth > offline: | Field | Data Type | Description | | ----------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------- | | networkCheckUrls | Array\ | Set as list of urls to check for connection to determine if offline mode should be engaged. | | enableOfflineMode | Boolean | Set as \`true\` if BF Identity Auth should check for connection and use offline mode if network checks fail. | | group | String | The \`group\_inclusion\` app group that should be used in offline mode. Offline mode will only show the apps in this group. | ### appConfig > bfIdentity: | Field | Data Type | Description | | ---------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | apiUrl | String | Set to the BF Identity cloud service url. Currently is “”. | | apiKey | String | Set to a generated API key in the Identity Manager section of BlueFletch Portal. | | enableUserPhoto | Boolean | Set to \`true\` if supporting user image storage. When users activate the Identity Kiosk they will be asked to take a photo that we will store. Currently photos are not supported in BF Identity Auth so this should be set to “false”. | | kioskInactivityAlertInSeconds | Integer | Set to the amount of idle time should be allowed while a user has started the activation flow on the Identity Kiosk. After this much idle time has passed an alert will be presented to the user asking them if they need more time. | | kioskInactivityEndSessionInSeconds | Integer | Set to the amount of time the idle alert dialog should wait until the session is ended and the app returns to the home screen. The alert dialog will show an indicator of how much time the user has to request more time or the app will revert to the home screen. | ### settings: | Field | Data Type | Description | | --------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | useSecondaryAuth | String | Indicates type of secondary auth during re-authorization. Values are "none", "pin", "face", "nfc", and "barcode". Default is "none". Select “pin” if reauthentication should only require the pin and not scanning the qr code credentials with the pin. | | secondaryAuthPinLength | Integer | Set this as the minimum number of digits required for secondary authentication with PIN. Minimum value is 4, default is 6 if not specified. Should be the same as pinMaxLength. | | pinMaxLength | Integer | Set to the desired maximum length of the authentication pin code created by users. This can be set to a number between 4 and 10 inclusive. | | pinAutoSubmit | Boolean | Set to \`true\` if the Identity Kiosk and Auth application should automatically submit a pin when the user has entered a pin of the max length. If \`false\` the user will have to manually press the submit button. | |

pinEnforceSequentialRule

|

Integer

|

Set to `true` if the sequential rule should be applied during pin creation in the Identity Kiosk application. The sequential rule is defined as:

Prevents PINs with 4 or more of the same digit in a row.

Examples:

| |

pinEnforceConsecutiveRule

|

Integer

|

Set to `true` if the consecutive rule should be applied during pin creation in the Identity Kiosk application. The consecutive rule is defined as:

Prevents PINs with 4 or more sequential digits (either ascending or descending)

Examples - Ascending:


Examples - Descending:

| |

pinEnforceBlackList

|

String

|

Set to a comma separated list of specific pin codes that are automatically rejected.


Example blacklist: "0000,1234,1111,9999".

|
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/workforce-identity/bluefletch-identity/technical-guide.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.