{"id":14970257,"url":"https://github.com/hashicorp/vault-plugin-secrets-ad","last_synced_at":"2025-05-15T18:07:14.314Z","repository":{"id":37617188,"uuid":"130398808","full_name":"hashicorp/vault-plugin-secrets-ad","owner":"hashicorp","description":"Active Directory (AD) Secrets Plugin for Vault ","archived":false,"fork":false,"pushed_at":"2025-03-13T02:00:40.000Z","size":6566,"stargazers_count":52,"open_issues_count":6,"forks_count":11,"subscribers_count":275,"default_branch":"main","last_synced_at":"2025-03-31T23:33:40.569Z","etag":null,"topics":["active-directory","hashicorp","microsoft","secrets-management","vault"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hashicorp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-20T18:19:49.000Z","updated_at":"2025-02-14T20:24:59.000Z","dependencies_parsed_at":"2023-01-30T00:46:03.285Z","dependency_job_id":"541f66d5-836e-447a-822e-95e01364c5a6","html_url":"https://github.com/hashicorp/vault-plugin-secrets-ad","commit_stats":{"total_commits":130,"total_committers":28,"mean_commits":4.642857142857143,"dds":0.6461538461538461,"last_synced_commit":"a1be95393a2faf13418bcfce1f4a01c73633387c"},"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fvault-plugin-secrets-ad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fvault-plugin-secrets-ad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fvault-plugin-secrets-ad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fvault-plugin-secrets-ad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hashicorp","download_url":"https://codeload.github.com/hashicorp/vault-plugin-secrets-ad/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247755557,"owners_count":20990620,"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":["active-directory","hashicorp","microsoft","secrets-management","vault"],"created_at":"2024-09-24T13:43:21.514Z","updated_at":"2025-04-08T00:35:05.013Z","avatar_url":"https://github.com/hashicorp.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vault Plugin: Active Directory Secrets Backend\n\nThis is a standalone backend plugin for use with [Hashicorp Vault](https://www.github.com/hashicorp/vault).\nThis plugin provides Active Directory functionality to Vault.\n\n**Please note**: We take Vault's security and our users' trust very seriously. If you believe you have found a security issue in Vault, _please responsibly disclose_ by contacting us at [security@hashicorp.com](mailto:security@hashicorp.com).\n\n## Quick Links\n- Vault Website: https://www.vaultproject.io\n- Active Directory Docs: https://developer.hashicorp.com/vault/docs/secrets/ad\n- Main Project Github: https://www.github.com/hashicorp/vault\n\n## Getting Started\n\nThis is a [Vault plugin](https://developer.hashicorp.com/vault/docs/plugins)\nand is meant to work with Vault. This guide assumes you have already installed Vault\nand have a basic understanding of how Vault works.\n\nOtherwise, first read this guide on how to [get started with Vault](https://developer.hashicorp.com/vault/tutorials/getting-started/getting-started-install).\n\nTo learn specifically about how plugins work, see documentation on [Vault plugins](https://developer.hashicorp.com/vault/docs/plugins).\n\n## Usage\n\nPlease see [documentation for the plugin](https://developer.hashicorp.com/vault/docs/secrets/ad)\non the Vault website.\n\nThis plugin is currently built into Vault and by default is accessed\nat `ad`. To enable this in a running Vault server:\n\n```sh\n$ vault secrets enable ad\nSuccess! Enabled the ad secrets engine at: ad/\n```\n\nAdditionally starting with Vault 0.10 this backend is by default mounted\nat `secret/`.\n\n## Developing\n\nIf you wish to work on this plugin, you'll first need\n[Go](https://www.golang.org) installed on your machine\n(version 1.17+ is *required*).\n\nFor local dev first make sure Go is properly installed, including\nsetting up a [GOPATH](https://golang.org/doc/code.html#GOPATH).\n\nTo compile a development version of this plugin, run `make` or `make dev`.\nThis will put the plugin binary in the `bin` and `$GOPATH/bin` folders. `dev`\nmode will only generate the binary for your platform and is faster:\n\n```sh\n$ make\n$ make dev\n```\n\nPut the plugin binary into a location of your choice. This directory\nwill be specified as the [`plugin_directory`](https://developer.hashicorp.com/vault/docs/configuration#plugin_directory)\nin the Vault config used to start the server.\n\n```hcl\nplugin_directory = \"path/to/plugin/directory\"\n```\n\nStart a Vault server with this config file:\n```sh\n$ vault server -config=path/to/config.json ...\n...\n```\n\nOnce the server is started, register the plugin in the Vault server's [plugin catalog](https://developer.hashicorp.com/vault/docs/plugins/plugin-architecture#plugin-catalog):\n\n```sh\n$ vault plugin register \\\n        -sha256=\u003cSHA256 Hex value of the plugin binary\u003e \\\n        -command=\"vault-plugin-secrets-ad\" \\\n        secret \\\n        custom-ad\n```\n\nNote you should generate a new sha256 checksum if you have made changes\nto the plugin. Example using openssl:\n\n```sh\nopenssl dgst -sha256 $GOPATH/vault-plugin-secrets-ad\n...\nSHA256(.../go/bin/vault-plugin-secrets-ad)= 896c13c0f5305daed381952a128322e02bc28a57d0c862a78cbc2ea66e8c6fa1\n```\n\nEnable the secrets plugin backend using the secrets enable plugin command:\n\n```sh\n$ vault secrets enable custom-ad\n...\n\nSuccessfully enabled 'plugin' at 'custom-ad'!\n```\n\n#### Tests\n\nIf you are developing this plugin and want to verify it is still\nfunctioning (and you haven't broken anything else), we recommend\nrunning the tests.\n\nTo run the tests, run the following:\n\n```sh\n$ make test\n```\n\nYou can also specify a `TESTARGS` variable to filter tests like so:\n\n```sh\n$ make test TESTARGS='--run=TestConfig'\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fvault-plugin-secrets-ad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhashicorp%2Fvault-plugin-secrets-ad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fvault-plugin-secrets-ad/lists"}