# 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](https://developer.sahamati.org.in/sahamatinet-poc/integration-steps/sandbox-onboarding).

**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](https://developer.sahamati.org.in/sahamatinet-poc/integration-steps/iam-apis#user-token-generate).
  * Reset the secret using the [Secret - Reset API](https://developer.sahamati.org.in/sahamatinet-poc/integration-steps/iam-apis#entity-secret-reset) to generate a new client secret.
  * Retrieve the existing entity secret using the [Secret - Read API](https://developer.sahamati.org.in/sahamatinet-poc/integration-steps/iam-apis#entity-secret-read).
  * Using this entity secret, you can [Generate the Entity Secret](https://developer.sahamati.org.in/sahamatinet-poc/integration-steps/iam-apis#entity-token-generate).&#x20;

Refer to the [API documentation](https://developer.sahamati.org.in/sahamatinet-poc/integration-steps/iam-apis) for more details.