> 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/platform-documentation/process-node-parts/redirect-session.md).

# Redirect Session

## Description

The Redirect Session part allows you to have your application redirect your users from the current page to a location you specify in the part.

**Node Type:** This part is located in the *Misc* menu of the Process node.

**Used With:** This part can be used with all frameworks as well as with applications built without a framework.

## Editor Fields

| Field Name                  | Description/Use                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Type/Options        | Optional/Mandatory |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ------------------ |
| Mode                        | <p><strong>Session:</strong> Choose this option for redirecting to another existing package.<br><strong>URL:</strong> This option redirects the user to the configured URL.<br><strong>Back:</strong> This option redirects the user to the start of the application. This can be useful if, for example, the user stepped through a logicnet and wants to start from the beginning.</p>                                                                                                                                                 | Options             | Mandatory          |
| Package                     | <p>This is only required when Mode = <em><strong>Session</strong></em>.<br>Specify the name of the published package to which to redirect the user. The name of the package must be the name you gave to the published project.</p>                                                                                                                                                                                                                                                                                                      | Text \| Data Object | Mandatory          |
| Session-id                  | <p>This is only required when Mode = <em><strong>Session</strong></em>.<br>Specify the id of the session. The session must already exist in order to redirect to it. You can find the session id in the URL; for example, the bold text in the following URL is the session id:<br><em><http://application.logicnets.com/[company> name]/users/KnowledgeCenter/logicnets.lns?\_session=<strong>7644057772309D796F3A4AB522781C4E</strong></em>.</p>                                                                                       | Text                | Mandatory          |
| URL                         | <p>This is only required when Mode = <strong>URL</strong>.<br>Specify the location of the website to which to redirect the user; for example: <a href="http://www.logicnets.com">[www.logicnets.com](http://www.logicnets.com)</a>. See the <em>Whitelisting</em> section below for more information on this.</p>                                                                                                                                                                                                                        | Text                | Mandatory          |
| Output dataobject           | Specify the name of the data object in which to store the output.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Text                | Optional           |
| Additional query parameters | <p>By clicking the <em><strong>add</strong></em> button at the end of the table row, you can set the name and the value of the query parameter. For example, when you log on to the LogicNets system, the URL is something like<br><em><http://application.logicnets.com/[company> name]/logicnets.lns?<strong>verb</strong>=start&<strong>code</strong>=logon</em>.<br>In the example above, <em>verb</em> and <em>code</em> are examples of the name of the query and <em>start</em> and <em>logon</em> are examples of the value.</p> | Table               | Optional           |

### Whitelisting

When you redirect to a URL that has a different host name than your application, you must ensure the URL is whitelisted. This keeps your application from being abused as an open redirect proxy. See <https://cwe.mitre.org/data/definitions/601.html> for more information.

You can whitelist an external URL through the System Configuration module, where there are two relevant configuration items located on the Security tab:

**Non-approved Redirect-uris Mode** In this mode, you can select from the following options:

* "log only": When you use a URL that is not whitelisted and the user follows the redirect, the system logs the error "Illegal redirect uri specified" but continues with the redirect.
* "block" (recommended): When you use an external URL that is not approved and the user follows the redirect, the system logs an error and shows the user an error message, such as "the specified redirect\_uri is not whitelisted". The system will not follow the redirect.

**Approved Redirect-uris** This mode specifies that all URIs listed here are whitelisted, and the Redirect URL column can contain the following:

* A full URL: e.g. [*https://sub.mydomain.com/folder/page.html*](https://sub.mydomain.com/folder/page.html), only this page is whitelisted.
* A part of an URL: e.g. [*https://sub.mydomain.com/folder*](https://sub.mydomain.com/folder), all pages with this folders and its sub-folders are whitelisted.
* Or only a host name: e.g. [*https://sub.mydomain.com*](https://sub.mydomain.com), all pages with this hostname are whitelisted; if the schema (in this case "https\://") is omitted a https schema is assumed.

You can use wild cards in the host name; for example, to whitelist all sub-domains you can use the following URI: *https\://\*.mydomain.com*. For security reasons it is better to use full URLs as much as possible.

The *description* and *created by* fields are not mandatory and you can use them for your own information.

## Example

There is no example project available for this part.


---

# 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/platform-documentation/process-node-parts/redirect-session.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.
