{"id":22868550,"url":"https://github.com/delineaxpm/dsv-sdk-java","last_synced_at":"2025-05-05T19:53:06.113Z","repository":{"id":64674426,"uuid":"495534751","full_name":"DelineaXPM/dsv-sdk-java","owner":"DelineaXPM","description":"A Java SDK for Delinea DevOps Secrets Vault","archived":false,"fork":false,"pushed_at":"2025-02-25T17:59:22.000Z","size":97,"stargazers_count":3,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-30T23:11:54.484Z","etag":null,"topics":["delinea","dsv","java","thycotic"],"latest_commit_sha":null,"homepage":"https://delinea.com/products/devops-secrets-management-vault","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DelineaXPM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-23T18:49:38.000Z","updated_at":"2025-02-25T17:59:25.000Z","dependencies_parsed_at":"2024-07-27T09:26:35.265Z","dependency_job_id":"6b1ddcfd-b690-4cb6-b5f7-3356c72cf136","html_url":"https://github.com/DelineaXPM/dsv-sdk-java","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DelineaXPM%2Fdsv-sdk-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DelineaXPM%2Fdsv-sdk-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DelineaXPM%2Fdsv-sdk-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DelineaXPM%2Fdsv-sdk-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DelineaXPM","download_url":"https://codeload.github.com/DelineaXPM/dsv-sdk-java/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252566782,"owners_count":21769104,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["delinea","dsv","java","thycotic"],"created_at":"2024-12-13T12:36:00.652Z","updated_at":"2025-05-05T19:53:06.094Z","avatar_url":"https://github.com/DelineaXPM.png","language":"Java","readme":"# The Delinea Secrets Java SDK\n\n![Deploy](https://github.com/DelineaXPM/dsv-sdk-java/workflows/Deploy/badge.svg)\n\nThe [Delinea](https://delinea.com/)\n[DevOps Secrets Vault](https://delinea.com/products/devops-secrets-management-vault)\n(DSV) Java SDK contains classes that interact with the DSV via the REST API.\n\nThe SDK contains an API based the [Spring Framework](https://spring.io/projects/spring-framework)\n[RestTemplate](https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/web/client/RestTemplate.html),\nand a simple application based on [Spring Boot](https://spring.io/projects/spring-boot),\nthat calls the API.\n\n\n## Install into your application\n\nYou can use this SDk in your application by adding the following dependency:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.delinea.secrets\u003c/groupId\u003e\n  \u003cartifactId\u003edsv-sdk-java\u003c/artifactId\u003e\n  \u003cversion\u003e1.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Build locally\n\n### Prerequisites\n\nThe SDK builds and runs on Java 8 or later.\n\nApache [Maven](https://maven.apache.org/) is also required to build the SDK.\n\nMaven runs unit and integration tests during the build so the settings in\n`src/main/resources/application.properties` must be configured before the build\nwill succeed.\n\n### Settings\n\nThe API needs a `tenant` to create request URLs that refer to it.\n\n```ini\nsecrets_vault.tenant = mytenant\n```\n\nIt authenticates to DSV using a `client_id` and `client_secret`.\n\n```ini\nsecrets_vault.client_id = 359f8c9f-d555-40ff-a036-ce95432e708b\nsecrets_vault.client_secret = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\nThe API assumes a the top-level domain (TLD) of _com_ but it can be overridden:\n\n```ini\nsecrets_vault.tld = eu\n```\n\nThe base URL template itself can also be explicitly set:\n\n```ini\nsecrets_vault.base_url_template = https://%s.secretsvaultcloud.%s/v1\n```\n\nNote that the template must contain two _conversion specifiers_ for `.tenant` and\n`.base_url_tld` respectively.\n\n## Run the jar\n\nThe SDK example application gets a secret from DSV by it's `path`. The path can\nbe set as a proper\n\n```ini\nsecret.path = path/to/secret\n```\n\nAfter the SDK application settings are configured the jar can be built:\n\n```bash\nmvn package\n```\n\nThe build runs the SDK application, however, the it also produces an executable\njar capable of accepting properties set via the command-line.\n\nFor example:\n\n```bash\njava -jar target/dsv-sdk-java-1.0-SNAPSHOT-exec.jar --secret.path=/path/to/a/secret\n```\n\n## Use the API\n\nConfigure the `SecretsVaultFactoryBean` in the Spring\n[ApplicationContext](https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/context/ApplicationContext.html)\nthen inject a `SecretsVault` where required.\n\n```java\n@Autowired\nprivate SecretsVault secretsVault;\n\npublic static void main(final String[] args) {\n    final Secret secret = secretsVault.getSecret(\"/path/to/secret\");\n\n    System.out.println(String.format(\"The password is %s\", secret.getData().get(\"password\")));\n}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelineaxpm%2Fdsv-sdk-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdelineaxpm%2Fdsv-sdk-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelineaxpm%2Fdsv-sdk-java/lists"}