---
title: "Operations: Server: How to Generate a Client Certificate"
url: "https://docs.ravendb.net/6.2/client-api/operations/server-wide/certificates/create-client-certificate"
version: "6.2"
language: "java"
---

# Operations: Server: How to Generate a Client Certificate

> Client language: Java. Also available for [C#](https://docs.ravendb.net/6.2/client-api/operations/server-wide/certificates/create-client-certificate.md), [Node.js](https://docs.ravendb.net/6.2/client-api/operations/server-wide/certificates/create-client-certificate.nodejs.md).
>
> RavenDB publishes an official agent skill for coding assistants at https://docs.ravendb.net/skills/ravendb/SKILL.md (also installable with `npx skills add ravendb/skills`). The skill describes itself as: "Read this before writing any RavenDB query, client call or /databases/ request. Covers server setup, document modelling, the Node.js, .NET and Python clients, RQL, indexes, vector search and AI agents. Code written from recall tends to run and return the wrong rows, because RQL resembles SQL and the clients take field names as plain strings."

> **Note**
>
> - You can generate a client certificate using **CreateClientCertificateOperation**.
>
> - Learn the rationale needed to properly define client certificates in [The RavenDB Security Authorization Approach](https://docs.ravendb.net/6.2/server/security/authentication/certificate-management.md#the-ravendb-security-authorization-approach)

## Syntax

```java
public CreateClientCertificateOperation(String name,
                                      Map<String, DatabaseAccess> permissions,
                                      SecurityClearance clearance)

public CreateClientCertificateOperation(String name,
                                      Map<String, DatabaseAccess> permissions,
                                      SecurityClearance clearance,
                                      String password)
```

```java
public enum SecurityClearance {
  CLUSTER_ADMIN,
  CLUSTER_NODE,
  OPERATOR,
  VALID_USER
}
```

```java
public enum DatabaseAccess {
  READ,
  READ_WRITE,
  ADMIN
}
```

| Parameters | | |
| - | - | - |
| **name** | String | Name of a certificate |
| **permissions** | Map\<String, DatabaseAccess> | Map with database to access level mapping |
| **clearance** | SecurityClearance | Access level |
| **password** | String | Optional certificate password, default: no password |

| Return Value | |
| - | - |
| **RawData** | client certificate raw data |

## Example I

```java
// With user role set to Cluster Administrator or Operator the user of this certificate
// is going to have access to all databases

CreateClientCertificateOperation operation = new CreateClientCertificateOperation("admin",
  null, SecurityClearance.OPERATOR);
CertificateRawData certificateRawData = store.maintenance().server().send(operation);
byte[] certificatesZipped = certificateRawData.getRawData();
```

## Example II

```java
// when security clearance is ValidUser, you need to specify per database permissions
CreateClientCertificateOperation operation = new CreateClientCertificateOperation("user1",
  Collections.singletonMap("Northwind", DatabaseAccess.ADMIN),
  SecurityClearance.VALID_USER,
  "myPassword");

CertificateRawData certificateRawData = store.maintenance().server().send(operation);
byte[] certificateZipped = certificateRawData.getRawData();
```

## See also

- [How to delete certificate?](https://docs.ravendb.net/6.2/client-api/operations/server-wide/certificates/delete-certificate.java.md)
- [How to put client certificate?](https://docs.ravendb.net/6.2/client-api/operations/server-wide/certificates/put-client-certificate.java.md)
- [Certificates Management](https://docs.ravendb.net/6.2/server/security/authentication/certificate-management.md#enabling-communication-between-servers:-importing-and-exporting-certificates)
- [Client Certificate Usage](https://docs.ravendb.net/6.2/server/security/authentication/client-certificate-usage.md)
