index.html 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940
  1. <!doctype html>
  2. <html lang="en" class="no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <meta http-equiv="x-ua-compatible" content="ie=edge">
  7. <meta name="lang:clipboard.copy" content="Copy to clipboard">
  8. <meta name="lang:clipboard.copied" content="Copied to clipboard">
  9. <meta name="lang:search.language" content="en">
  10. <meta name="lang:search.pipeline.stopwords" content="True">
  11. <meta name="lang:search.pipeline.trimmer" content="True">
  12. <meta name="lang:search.result.none" content="No matching documents">
  13. <meta name="lang:search.result.one" content="1 matching document">
  14. <meta name="lang:search.result.other" content="# matching documents">
  15. <meta name="lang:search.tokenizer" content="[\s\-]+">
  16. <link rel="shortcut icon" href="../assets/images/favicon.png">
  17. <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-4.6.0">
  18. <title>Secrets Manager - External Secrets Operator</title>
  19. <link rel="stylesheet" href="../assets/stylesheets/application.1b62728e.css">
  20. <script src="../assets/javascripts/modernizr.268332fc.js"></script>
  21. <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
  22. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
  23. <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
  24. <link rel="stylesheet" href="../assets/fonts/material-icons.css">
  25. </head>
  26. <body dir="ltr">
  27. <svg class="md-svg">
  28. <defs>
  29. <svg xmlns="http://www.w3.org/2000/svg" width="416" height="448" viewBox="0 0 416 448" id="__github"><path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19T128 352t-18.125-8.5-10.75-19T96 304t3.125-20.5 10.75-19T128 256t18.125 8.5 10.75 19T160 304zm160 0q0 10-3.125 20.5t-10.75 19T288 352t-18.125-8.5-10.75-19T256 304t3.125-20.5 10.75-19T288 256t18.125 8.5 10.75 19T320 304zm40 0q0-30-17.25-51T296 232q-10.25 0-48.75 5.25Q229.5 240 208 240t-39.25-2.75Q130.75 232 120 232q-29.5 0-46.75 21T56 304q0 22 8 38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0 37.25-1.75t35-7.375 30.5-15 20.25-25.75T360 304zm56-44q0 51.75-15.25 82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5T212 416q-19.5 0-35.5-.75t-36.875-3.125-38.125-7.5-34.25-12.875T37 371.5t-21.5-28.75Q0 312 0 260q0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25 30.875Q171.5 96 212 96q37 0 70 8 26.25-20.5 46.75-30.25T376 64q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34 99.5z"/></svg>
  30. </defs>
  31. </svg>
  32. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  33. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  34. <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
  35. <a href="#google-cloud-secret-manager" tabindex="1" class="md-skip">
  36. Skip to content
  37. </a>
  38. <header class="md-header" data-md-component="header">
  39. <nav class="md-header-nav md-grid">
  40. <div class="md-flex">
  41. <div class="md-flex__cell md-flex__cell--shrink">
  42. <a href=".." title="External Secrets Operator" class="md-header-nav__button md-logo">
  43. <i class="md-icon"></i>
  44. </a>
  45. </div>
  46. <div class="md-flex__cell md-flex__cell--shrink">
  47. <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
  48. </div>
  49. <div class="md-flex__cell md-flex__cell--stretch">
  50. <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
  51. <span class="md-header-nav__topic">
  52. External Secrets Operator
  53. </span>
  54. <span class="md-header-nav__topic">
  55. Secrets Manager
  56. </span>
  57. </div>
  58. </div>
  59. <div class="md-flex__cell md-flex__cell--shrink">
  60. <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
  61. <div class="md-search" data-md-component="search" role="dialog">
  62. <label class="md-search__overlay" for="__search"></label>
  63. <div class="md-search__inner" role="search">
  64. <form class="md-search__form" name="search">
  65. <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
  66. <label class="md-icon md-search__icon" for="__search"></label>
  67. <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
  68. &#xE5CD;
  69. </button>
  70. </form>
  71. <div class="md-search__output">
  72. <div class="md-search__scrollwrap" data-md-scrollfix>
  73. <div class="md-search-result" data-md-component="result">
  74. <div class="md-search-result__meta">
  75. Type to start searching
  76. </div>
  77. <ol class="md-search-result__list"></ol>
  78. </div>
  79. </div>
  80. </div>
  81. </div>
  82. </div>
  83. </div>
  84. <div class="md-flex__cell md-flex__cell--shrink">
  85. <div class="md-header-nav__source">
  86. <a href="https://github.com/external-secrets/external-secrets/" title="Go to repository" class="md-source" data-md-source="github">
  87. <div class="md-source__icon">
  88. <svg viewBox="0 0 24 24" width="24" height="24">
  89. <use xlink:href="#__github" width="24" height="24"></use>
  90. </svg>
  91. </div>
  92. <div class="md-source__repository">
  93. External Secrets Operator
  94. </div>
  95. </a>
  96. </div>
  97. </div>
  98. </div>
  99. </nav>
  100. </header>
  101. <div class="md-container">
  102. <main class="md-main" role="main">
  103. <div class="md-main__inner md-grid" data-md-component="container">
  104. <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
  105. <div class="md-sidebar__scrollwrap">
  106. <div class="md-sidebar__inner">
  107. <nav class="md-nav md-nav--primary" data-md-level="0">
  108. <label class="md-nav__title md-nav__title--site" for="__drawer">
  109. <a href=".." title="External Secrets Operator" class="md-nav__button md-logo">
  110. <i class="md-icon"></i>
  111. </a>
  112. External Secrets Operator
  113. </label>
  114. <div class="md-nav__source">
  115. <a href="https://github.com/external-secrets/external-secrets/" title="Go to repository" class="md-source" data-md-source="github">
  116. <div class="md-source__icon">
  117. <svg viewBox="0 0 24 24" width="24" height="24">
  118. <use xlink:href="#__github" width="24" height="24"></use>
  119. </svg>
  120. </div>
  121. <div class="md-source__repository">
  122. External Secrets Operator
  123. </div>
  124. </a>
  125. </div>
  126. <ul class="md-nav__list" data-md-scrollfix>
  127. <li class="md-nav__item">
  128. <a href=".." title="Introduction" class="md-nav__link">
  129. Introduction
  130. </a>
  131. </li>
  132. <li class="md-nav__item">
  133. <a href="../api-overview/" title="Overview" class="md-nav__link">
  134. Overview
  135. </a>
  136. </li>
  137. <li class="md-nav__item md-nav__item--nested">
  138. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
  139. <label class="md-nav__link" for="nav-3">
  140. API Types
  141. </label>
  142. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  143. <label class="md-nav__title" for="nav-3">
  144. API Types
  145. </label>
  146. <ul class="md-nav__list" data-md-scrollfix>
  147. <li class="md-nav__item">
  148. <a href="../api-externalsecret/" title="ExternalSecret" class="md-nav__link">
  149. ExternalSecret
  150. </a>
  151. </li>
  152. <li class="md-nav__item">
  153. <a href="../api-secretstore/" title="SecretStore" class="md-nav__link">
  154. SecretStore
  155. </a>
  156. </li>
  157. <li class="md-nav__item">
  158. <a href="../api-clustersecretstore/" title="ClusterSecretStore" class="md-nav__link">
  159. ClusterSecretStore
  160. </a>
  161. </li>
  162. </ul>
  163. </nav>
  164. </li>
  165. <li class="md-nav__item md-nav__item--nested">
  166. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
  167. <label class="md-nav__link" for="nav-4">
  168. Guides
  169. </label>
  170. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  171. <label class="md-nav__title" for="nav-4">
  172. Guides
  173. </label>
  174. <ul class="md-nav__list" data-md-scrollfix>
  175. <li class="md-nav__item">
  176. <a href="../guides-introduction/" title="Introduction" class="md-nav__link">
  177. Introduction
  178. </a>
  179. </li>
  180. <li class="md-nav__item">
  181. <a href="../guides-getting-started/" title="Getting started" class="md-nav__link">
  182. Getting started
  183. </a>
  184. </li>
  185. <li class="md-nav__item">
  186. <a href="../guides-templating/" title="Advanced Templating" class="md-nav__link">
  187. Advanced Templating
  188. </a>
  189. </li>
  190. <li class="md-nav__item">
  191. <a href="../guides-multi-tenancy/" title="Multi Tenancy" class="md-nav__link">
  192. Multi Tenancy
  193. </a>
  194. </li>
  195. <li class="md-nav__item">
  196. <a href="../guides-metrics/" title="Metrics" class="md-nav__link">
  197. Metrics
  198. </a>
  199. </li>
  200. </ul>
  201. </nav>
  202. </li>
  203. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  204. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5" checked>
  205. <label class="md-nav__link" for="nav-5">
  206. Provider
  207. </label>
  208. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  209. <label class="md-nav__title" for="nav-5">
  210. Provider
  211. </label>
  212. <ul class="md-nav__list" data-md-scrollfix>
  213. <li class="md-nav__item md-nav__item--nested">
  214. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5-1" type="checkbox" id="nav-5-1">
  215. <label class="md-nav__link" for="nav-5-1">
  216. AWS
  217. </label>
  218. <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
  219. <label class="md-nav__title" for="nav-5-1">
  220. AWS
  221. </label>
  222. <ul class="md-nav__list" data-md-scrollfix>
  223. <li class="md-nav__item">
  224. <a href="../provider-aws-secrets-manager/" title="Secrets Manager" class="md-nav__link">
  225. Secrets Manager
  226. </a>
  227. </li>
  228. <li class="md-nav__item">
  229. <a href="../provider-aws-parameter-store/" title="Parameter Store" class="md-nav__link">
  230. Parameter Store
  231. </a>
  232. </li>
  233. </ul>
  234. </nav>
  235. </li>
  236. <li class="md-nav__item md-nav__item--nested">
  237. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5-2" type="checkbox" id="nav-5-2">
  238. <label class="md-nav__link" for="nav-5-2">
  239. Azure
  240. </label>
  241. <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
  242. <label class="md-nav__title" for="nav-5-2">
  243. Azure
  244. </label>
  245. <ul class="md-nav__list" data-md-scrollfix>
  246. <li class="md-nav__item">
  247. <a href="../provider-azure-key-vault/" title="Key Vault" class="md-nav__link">
  248. Key Vault
  249. </a>
  250. </li>
  251. </ul>
  252. </nav>
  253. </li>
  254. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  255. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5-3" type="checkbox" id="nav-5-3" checked>
  256. <label class="md-nav__link" for="nav-5-3">
  257. Google
  258. </label>
  259. <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
  260. <label class="md-nav__title" for="nav-5-3">
  261. Google
  262. </label>
  263. <ul class="md-nav__list" data-md-scrollfix>
  264. <li class="md-nav__item md-nav__item--active">
  265. <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  266. <label class="md-nav__link md-nav__link--active" for="__toc">
  267. Secrets Manager
  268. </label>
  269. <a href="./" title="Secrets Manager" class="md-nav__link md-nav__link--active">
  270. Secrets Manager
  271. </a>
  272. <nav class="md-nav md-nav--secondary">
  273. <label class="md-nav__title" for="__toc">Table of contents</label>
  274. <ul class="md-nav__list" data-md-scrollfix>
  275. <li class="md-nav__item">
  276. <a href="#google-cloud-secret-manager" class="md-nav__link">
  277. Google Cloud Secret Manager
  278. </a>
  279. <nav class="md-nav">
  280. <ul class="md-nav__list">
  281. <li class="md-nav__item">
  282. <a href="#authentication" class="md-nav__link">
  283. Authentication
  284. </a>
  285. <nav class="md-nav">
  286. <ul class="md-nav__list">
  287. <li class="md-nav__item">
  288. <a href="#service-account-key-authentication" class="md-nav__link">
  289. Service account key authentication
  290. </a>
  291. </li>
  292. </ul>
  293. </nav>
  294. </li>
  295. <li class="md-nav__item">
  296. <a href="#update-secret-store" class="md-nav__link">
  297. Update secret store
  298. </a>
  299. </li>
  300. <li class="md-nav__item">
  301. <a href="#creating-external-secret" class="md-nav__link">
  302. Creating external secret
  303. </a>
  304. </li>
  305. </ul>
  306. </nav>
  307. </li>
  308. </ul>
  309. </nav>
  310. </li>
  311. </ul>
  312. </nav>
  313. </li>
  314. <li class="md-nav__item">
  315. <a href="../provider-hashicorp-vault/" title="HashiCorp Vault" class="md-nav__link">
  316. HashiCorp Vault
  317. </a>
  318. </li>
  319. </ul>
  320. </nav>
  321. </li>
  322. <li class="md-nav__item md-nav__item--nested">
  323. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6">
  324. <label class="md-nav__link" for="nav-6">
  325. References
  326. </label>
  327. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  328. <label class="md-nav__title" for="nav-6">
  329. References
  330. </label>
  331. <ul class="md-nav__list" data-md-scrollfix>
  332. <li class="md-nav__item">
  333. <a href="../spec/" title="API specification" class="md-nav__link">
  334. API specification
  335. </a>
  336. </li>
  337. </ul>
  338. </nav>
  339. </li>
  340. <li class="md-nav__item md-nav__item--nested">
  341. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7">
  342. <label class="md-nav__link" for="nav-7">
  343. Contributing
  344. </label>
  345. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  346. <label class="md-nav__title" for="nav-7">
  347. Contributing
  348. </label>
  349. <ul class="md-nav__list" data-md-scrollfix>
  350. <li class="md-nav__item">
  351. <a href="../contributing-devguide/" title="Developer guide" class="md-nav__link">
  352. Developer guide
  353. </a>
  354. </li>
  355. <li class="md-nav__item">
  356. <a href="../contributing-process/" title="Contributing Process" class="md-nav__link">
  357. Contributing Process
  358. </a>
  359. </li>
  360. <li class="md-nav__item">
  361. <a href="../contributing-coc/" title="Code of Conduct" class="md-nav__link">
  362. Code of Conduct
  363. </a>
  364. </li>
  365. </ul>
  366. </nav>
  367. </li>
  368. </ul>
  369. </nav>
  370. </div>
  371. </div>
  372. </div>
  373. <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
  374. <div class="md-sidebar__scrollwrap">
  375. <div class="md-sidebar__inner">
  376. <nav class="md-nav md-nav--secondary">
  377. <label class="md-nav__title" for="__toc">Table of contents</label>
  378. <ul class="md-nav__list" data-md-scrollfix>
  379. <li class="md-nav__item">
  380. <a href="#google-cloud-secret-manager" class="md-nav__link">
  381. Google Cloud Secret Manager
  382. </a>
  383. <nav class="md-nav">
  384. <ul class="md-nav__list">
  385. <li class="md-nav__item">
  386. <a href="#authentication" class="md-nav__link">
  387. Authentication
  388. </a>
  389. <nav class="md-nav">
  390. <ul class="md-nav__list">
  391. <li class="md-nav__item">
  392. <a href="#service-account-key-authentication" class="md-nav__link">
  393. Service account key authentication
  394. </a>
  395. </li>
  396. </ul>
  397. </nav>
  398. </li>
  399. <li class="md-nav__item">
  400. <a href="#update-secret-store" class="md-nav__link">
  401. Update secret store
  402. </a>
  403. </li>
  404. <li class="md-nav__item">
  405. <a href="#creating-external-secret" class="md-nav__link">
  406. Creating external secret
  407. </a>
  408. </li>
  409. </ul>
  410. </nav>
  411. </li>
  412. </ul>
  413. </nav>
  414. </div>
  415. </div>
  416. </div>
  417. <div class="md-content">
  418. <article class="md-content__inner md-typeset">
  419. <a href="https://github.com/external-secrets/external-secrets/edit/master/docs/provider-google-secrets-manager.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
  420. <h1>Secrets Manager</h1>
  421. <h2 id="google-cloud-secret-manager">Google Cloud Secret Manager</h2>
  422. <p>External Secrets Operator integrates with <a href="https://cloud.google.com/secret-manager">GCP Secret Manager</a> for secret management.</p>
  423. <h3 id="authentication">Authentication</h3>
  424. <p>At the moment, we only support <a href="https://cloud.google.com/iam/docs/creating-managing-service-account-keys">service account key</a> authentication.</p>
  425. <h4 id="service-account-key-authentication">Service account key authentication</h4>
  426. <p>A service account key is created and the JSON keyfile is stored in a <code>Kind=Secret</code>. The <code>project_id</code> and <code>private_key</code> should be configured for the project.</p>
  427. <div class="highlight"><pre><span></span><span class="nt">apiVersion</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">v1</span>
  428. <span class="nt">kind</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">Secret</span>
  429. <span class="nt">metadata</span><span class="p">:</span>
  430. <span class="nt">name</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">gcpsm-secret</span>
  431. <span class="nt">labels</span><span class="p">:</span>
  432. <span class="nt">type</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">gcpsm</span>
  433. <span class="nt">type</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">Opaque</span>
  434. <span class="nt">stringData</span><span class="p">:</span>
  435. <span class="nt">secret-access-credentials</span><span class="p">:</span> <span class="p p-Indicator">|-</span>
  436. <span class="no">{</span>
  437. <span class="no">&quot;type&quot;: &quot;service_account&quot;,</span>
  438. <span class="no">&quot;project_id&quot;: &quot;external-secrets-operator&quot;,</span>
  439. <span class="no">&quot;private_key_id&quot;: &quot;&quot;,</span>
  440. <span class="no">&quot;private_key&quot;: &quot;-----BEGIN PRIVATE KEY-----\nA key\n-----END PRIVATE KEY-----\n&quot;,</span>
  441. <span class="no">&quot;client_email&quot;: &quot;test-service-account@external-secrets-operator.iam.gserviceaccount.com&quot;,</span>
  442. <span class="no">&quot;client_id&quot;: &quot;client ID&quot;,</span>
  443. <span class="no">&quot;auth_uri&quot;: &quot;https://accounts.google.com/o/oauth2/auth&quot;,</span>
  444. <span class="no">&quot;token_uri&quot;: &quot;https://oauth2.googleapis.com/token&quot;,</span>
  445. <span class="no">&quot;auth_provider_x509_cert_url&quot;: &quot;https://www.googleapis.com/oauth2/v1/certs&quot;,</span>
  446. <span class="no">&quot;client_x509_cert_url&quot;: &quot;https://www.googleapis.com/robot/v1/metadata/x509/test-service-account%40external-secrets-operator.iam.gserviceaccount.com&quot;</span>
  447. <span class="no">}</span>
  448. </pre></div>
  449. <h3 id="update-secret-store">Update secret store</h3>
  450. <p>Be sure the <code>gcpsm</code> provider is listed in the <code>Kind=SecretStore</code></p>
  451. <div class="highlight"><pre><span></span><span class="nt">apiVersion</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1alpha1</span>
  452. <span class="nt">kind</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  453. <span class="nt">metadata</span><span class="p">:</span>
  454. <span class="nt">name</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">example</span>
  455. <span class="nt">spec</span><span class="p">:</span>
  456. <span class="nt">provider</span><span class="p">:</span>
  457. <span class="nt">gcpsm</span><span class="p">:</span> <span class="c1"># gcpsm provider</span>
  458. <span class="nt">auth</span><span class="p">:</span>
  459. <span class="nt">secretRef</span><span class="p">:</span>
  460. <span class="nt">secretAccessKeySecretRef</span><span class="p">:</span>
  461. <span class="nt">name</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">gcpsm-secret</span> <span class="c1"># secret name containing SA key</span>
  462. <span class="nt">key</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">secret-access-credentials</span> <span class="c1"># key name containing SA key</span>
  463. <span class="nt">projectID</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">myproject</span> <span class="c1"># name of Google Cloud project</span>
  464. </pre></div>
  465. <h3 id="creating-external-secret">Creating external secret</h3>
  466. <p>To create a kubernetes secret from the GCP Secret Manager secret a <code>Kind=ExternalSecret</code> is needed.</p>
  467. <div class="highlight"><pre><span></span><span class="nt">apiVersion</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1alpha1</span>
  468. <span class="nt">kind</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">ExternalSecret</span>
  469. <span class="nt">metadata</span><span class="p">:</span>
  470. <span class="nt">name</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">example</span>
  471. <span class="nt">spec</span><span class="p">:</span>
  472. <span class="nt">refreshInterval</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">1h</span> <span class="c1"># rate SecretManager pulls GCPSM</span>
  473. <span class="nt">secretStoreRef</span><span class="p">:</span>
  474. <span class="nt">kind</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  475. <span class="nt">name</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">example</span> <span class="c1"># name of the SecretStore (or kind specified)</span>
  476. <span class="nt">target</span><span class="p">:</span>
  477. <span class="nt">name</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">secret-to-be-created</span> <span class="c1"># name of the k8s Secret to be created</span>
  478. <span class="nt">creationPolicy</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">Owner</span>
  479. <span class="nt">data</span><span class="p">:</span>
  480. <span class="p p-Indicator">-</span> <span class="nt">secretKey</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">dev-secret-test</span> <span class="c1"># name of the GCPSM secret key</span>
  481. <span class="nt">remoteRef</span><span class="p">:</span>
  482. <span class="nt">key</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">dev-secret-test</span>
  483. </pre></div>
  484. <p>The operator will fetch the GCP Secret Manager secret and inject it as a <code>Kind=Secret</code>
  485. <div class="highlight"><pre><span></span>kubectl get secret secret-to-be-created -n &lt;namespace&gt; | -o jsonpath=&#39;{.data.example-externalsecret-key}&#39; | base64 -d
  486. </pre></div></p>
  487. </article>
  488. </div>
  489. </div>
  490. </main>
  491. <footer class="md-footer">
  492. <div class="md-footer-nav">
  493. <nav class="md-footer-nav__inner md-grid">
  494. <a href="../provider-azure-key-vault/" title="Key Vault" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
  495. <div class="md-flex__cell md-flex__cell--shrink">
  496. <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
  497. </div>
  498. <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
  499. <span class="md-flex__ellipsis">
  500. <span class="md-footer-nav__direction">
  501. Previous
  502. </span>
  503. Key Vault
  504. </span>
  505. </div>
  506. </a>
  507. <a href="../provider-hashicorp-vault/" title="HashiCorp Vault" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
  508. <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
  509. <span class="md-flex__ellipsis">
  510. <span class="md-footer-nav__direction">
  511. Next
  512. </span>
  513. HashiCorp Vault
  514. </span>
  515. </div>
  516. <div class="md-flex__cell md-flex__cell--shrink">
  517. <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
  518. </div>
  519. </a>
  520. </nav>
  521. </div>
  522. <div class="md-footer-meta md-typeset">
  523. <div class="md-footer-meta__inner md-grid">
  524. <div class="md-footer-copyright">
  525. powered by
  526. <a href="https://www.mkdocs.org">MkDocs</a>
  527. and
  528. <a href="https://squidfunk.github.io/mkdocs-material/">
  529. Material for MkDocs</a>
  530. </div>
  531. </div>
  532. </div>
  533. </footer>
  534. </div>
  535. <script src="../assets/javascripts/application.808e90bb.js"></script>
  536. <script>app.initialize({version:"1.0.4",url:{base:".."}})</script>
  537. </body>
  538. </html>