# How To Onboard to Sandbox ?

**Steps for Onboarding to SahamatiNet Router in Sandbox:** 

**1. What You Need to Provide:**

* **Organisation Details**: For onboarding your organisation as an Entity (FIP, AA, or FIU) in the Central Registry.
  * **Entity ID** for your organisation
  * **Base URL** Endpoint to your application
  * **RSA Public Key**
  * **IP Address**, **inbound and outbound ports** \[optional for UAT, required for Production environment for whitelisting]
* **Designated User**: Provide required contact details of a representative responsible for generating and managing the client secret key for your entity in IAM(Token Service).
  * Name, Email address of the designated email account from your organisation.
  *  It is recommended to use a **service account email** associated with the **participant organisation.** This ensures the account remains under the organisation's control for long-term management, providing consistency and seamless operation over time.

**2. Where to Find Onboarding Details:**

* Full onboarding instructions and required JSON details can be found[ here](/sahamatinet-poc/integration-steps/sandbox-onboarding.md).

**3. Submission Process:**

* For regulated entities in AA ecosystem, do send the required details to **<sandbox@sahamati.org.in>.**
* The Sahamati team will review your submission and provide access credentials to your designated user via an email.&#x20;
* Do note, this step will be moved to a registration page on a self service portal for SahamatiNet Router going forward.&#x20;

**4. Client Secret Token Generation:**

* Once the designated user is onboarded by Sahamati, they will receive an email to set a password.
* Using this email and the newly set password, the designated user can:
  * Generate a user token for the Token Service (IAM) through the [User Token Generate API](/sahamatinet-poc/integration-steps/iam-apis.md#user-token-generate).
  * Reset the secret using the [Secret - Reset API](/sahamatinet-poc/integration-steps/iam-apis.md#entity-secret-reset) to generate a new client secret.
  * Retrieve the existing entity secret using the [Secret - Read API](/sahamatinet-poc/integration-steps/iam-apis.md#entity-secret-read).
  * Using this entity secret, you can [Generate the Entity Secret](/sahamatinet-poc/integration-steps/iam-apis.md#entity-token-generate).&#x20;

Refer to the [API documentation](/sahamatinet-poc/integration-steps/iam-apis.md) for more details.


---

# 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://developer.sahamati.org.in/how-to-guides/how-to-onboard-to-sandbox.md?ask=<question>
```

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.