> For the complete documentation index, see [llms.txt](https://emca.emudhra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://emca.emudhra.com/integrating-emca/rest-api-support/ca-management.md).

# CA Management

## Prerequisites

Register your application with emCA and obtain credentials. Provide:

* **Username (appCode)**
* **Password**
* **Source IP address** for allowlisting

All API traffic must use HTTPS (TLS 1.2+).

##  Registration

1. Submit **appCode**, **password**, and **IP address**.
2. emCA issues a **ClientID** for your application.
3. Use the ClientID for all subsequent API requests.

## Authentication

CA Management REST APIs require an **AuthKey** on every request.

* Generate a unique **transaction ID (`txn`)** per request.
* Capture a **request timestamp (`ts`)** at call time.
* Compute:

  ```
  iniCopyEditAuthKey = SHA256( ClientID + ts + txn )
  ```

  (Concatenate the values as strings; encode the hash as lowercase hex.)
* Send the following with each request (headers or fields as specified by the API reference):
  * `ClientID`
  * `ts`
  * `txn`
  * `AuthKey`

Ensure `ts` represents the current request time and `txn` is not reused.

## CA Management APIs documentation

All APIs related to CA management functionalities:

* createCA
* createCSR
* createorupdateCRL
* createUpdateCRLProfile
* createUpdateProfile
* getCrl
* importCertificate
* generateCertificate

## emCA Version-Based Postman Links:

* [V5.0.0](https://documenter.getpostman.com/view/40123569/2sBXqDuPtp#bcc10c65-ac6c-4ec9-a2a2-9eb576f75e0d)

{% hint style="info" %}
Please refer in the respective version sections for older API Postman Collections.
{% endhint %}