# Connecting to server-to-server APIs

### Environments

We have three environments available for our partners.

- Sandbox - this is shared environment, available as demonstration. You can get access before signing a deal with us - product@sparados.com to get access.
- Beta - This is environment you're going to use during integration with our services.
- Production - This is live environment.

### Authorization

Our APIs are secured with Mutual TLS Authentication. You will need certificate signed by us in order to connect. To get a certificate please send us an Certificate Signing Request (CSR). We will sign it and return a valid certificate in a response.

CSR should have following structure:

#### For Beta/Production

You will need separate certificates for Beta and Production environments, however they can be generated in exactly the same way.

<table id="bkmrk-field-example-value--0" style="width: 84.938272%;"><thead><tr><th style="width: 26.346434%;">Field</th><th style="width: 73.653566%;">Example value</th></tr></thead><tbody><tr><td style="width: 26.346434%;">Common Name (CN)</td><td style="width: 73.653566%;">`V-Sparados`

</td></tr><tr><td style="width: 26.346434%;">Organization (O)</td><td style="width: 73.653566%;">Name of your company  
</td></tr><tr><td style="width: 26.346434%;">Organizational Unit (OU)</td><td style="width: 73.653566%;">\[UUID\] corp\_id sent by Sparados admin</td></tr><tr><td style="width: 26.346434%;">Locality (L)</td><td style="width: 73.653566%;">City where your organization is located</td></tr><tr><td style="width: 26.346434%;">State/County/Region (ST)</td><td style="width: 73.653566%;">State/County where your organization is located  
</td></tr><tr><td style="width: 26.346434%;">Country (C)</td><td style="width: 73.653566%;">Two-letter country code where organization is located (ISO 3166-1 alpha-2)  
</td></tr><tr><td style="width: 26.346434%;">Email Address</td><td style="width: 73.653566%;">Email to be contacted in case of forced renewal  
</td></tr></tbody></table>

##### Example CSR generation command for Beta and Production

<p class="callout info">**Remember to replace parameters and file names with your own data** Commas cannot be used in parameters  
Minimum key length is RSA 2048</p>

```shell
openssl req -new -newkey rsa:4096 -keyout companyName.key -out companyName.csr -nodes -subj '/C=US/ST=Florida/L=Miami/O=SomeCompany/OU=UUID/CN=V-Sparados-CompanyName/emailAddress=example@user.com'
```

---