Skip to content

docs: TLS configuration #1369

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 3 commits into from
Closed

docs: TLS configuration #1369

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ca20c39
docs: TLS configuration
javier-aliaga May 15, 2025
c1390e2
Merge branch 'master' into ssl-examples-docs
javier-aliaga May 20, 2025
1f9db8e
Merge branch 'master' into ssl-examples-docs
artur-ciocanu May 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions daprdocs/content/en/java-sdk-docs/java-client/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,14 @@ If your Dapr instance is configured to require the `DAPR_API_TOKEN` environment
set it in the environment and the client will use it automatically.
You can read more about Dapr API token authentication [here](https://docs.dapr.io/operations/security/api-token/).

Copy link
Contributor

@artur-ciocanu artur-ciocanu May 20, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@javier-aliaga for completeness you should mention that GRPC TLS related configs can be passed either via env vars or Java properties.

Here are the property names corresponding to env vars:

  • dapr.grpc.tls.insecure
  • dapr.grpc.tls.ca.path
  • dapr.grpc.tls.cert.path
  • dapr.grpc.tls.key.path

CC: @cicoyle @salaboy

##### TLS Configuration
For secure gRPC communication, you can configure TLS settings using the following environment variables:

- `DAPR_GRPC_TLS_INSECURE`: When set to "true", enables insecure TLS mode which still uses TLS but doesn't verify certificates. This uses InsecureTrustManagerFactory to trust all certificates. This should only be used for testing or in secure environments.
- `DAPR_GRPC_TLS_CA_PATH`: Specifies the path to the CA certificate file. This is used for TLS connections to servers with self-signed certificates.
- `DAPR_GRPC_TLS_CERT_PATH`: Specifies the path to the TLS certificate file for client authentication.
- `DAPR_GRPC_TLS_KEY_PATH`: Specifies the path to the TLS private key file for client authentication.

#### Error Handling

Initially, errors in Dapr followed the Standard gRPC error model. However, to provide more detailed and informative error
Expand Down
Loading