index.html 53 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643
  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>API specification - 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. <header class="md-header" data-md-component="header">
  36. <nav class="md-header-nav md-grid">
  37. <div class="md-flex">
  38. <div class="md-flex__cell md-flex__cell--shrink">
  39. <a href=".." title="External Secrets Operator" class="md-header-nav__button md-logo">
  40. <i class="md-icon"></i>
  41. </a>
  42. </div>
  43. <div class="md-flex__cell md-flex__cell--shrink">
  44. <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
  45. </div>
  46. <div class="md-flex__cell md-flex__cell--stretch">
  47. <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
  48. <span class="md-header-nav__topic">
  49. External Secrets Operator
  50. </span>
  51. <span class="md-header-nav__topic">
  52. API specification
  53. </span>
  54. </div>
  55. </div>
  56. <div class="md-flex__cell md-flex__cell--shrink">
  57. <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
  58. <div class="md-search" data-md-component="search" role="dialog">
  59. <label class="md-search__overlay" for="__search"></label>
  60. <div class="md-search__inner" role="search">
  61. <form class="md-search__form" name="search">
  62. <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">
  63. <label class="md-icon md-search__icon" for="__search"></label>
  64. <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
  65. &#xE5CD;
  66. </button>
  67. </form>
  68. <div class="md-search__output">
  69. <div class="md-search__scrollwrap" data-md-scrollfix>
  70. <div class="md-search-result" data-md-component="result">
  71. <div class="md-search-result__meta">
  72. Type to start searching
  73. </div>
  74. <ol class="md-search-result__list"></ol>
  75. </div>
  76. </div>
  77. </div>
  78. </div>
  79. </div>
  80. </div>
  81. <div class="md-flex__cell md-flex__cell--shrink">
  82. <div class="md-header-nav__source">
  83. <a href="https://github.com/external-secrets/external-secrets/" title="Go to repository" class="md-source" data-md-source="github">
  84. <div class="md-source__icon">
  85. <svg viewBox="0 0 24 24" width="24" height="24">
  86. <use xlink:href="#__github" width="24" height="24"></use>
  87. </svg>
  88. </div>
  89. <div class="md-source__repository">
  90. External Secrets Operator
  91. </div>
  92. </a>
  93. </div>
  94. </div>
  95. </div>
  96. </nav>
  97. </header>
  98. <div class="md-container">
  99. <main class="md-main" role="main">
  100. <div class="md-main__inner md-grid" data-md-component="container">
  101. <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
  102. <div class="md-sidebar__scrollwrap">
  103. <div class="md-sidebar__inner">
  104. <nav class="md-nav md-nav--primary" data-md-level="0">
  105. <label class="md-nav__title md-nav__title--site" for="__drawer">
  106. <a href=".." title="External Secrets Operator" class="md-nav__button md-logo">
  107. <i class="md-icon"></i>
  108. </a>
  109. External Secrets Operator
  110. </label>
  111. <div class="md-nav__source">
  112. <a href="https://github.com/external-secrets/external-secrets/" title="Go to repository" class="md-source" data-md-source="github">
  113. <div class="md-source__icon">
  114. <svg viewBox="0 0 24 24" width="24" height="24">
  115. <use xlink:href="#__github" width="24" height="24"></use>
  116. </svg>
  117. </div>
  118. <div class="md-source__repository">
  119. External Secrets Operator
  120. </div>
  121. </a>
  122. </div>
  123. <ul class="md-nav__list" data-md-scrollfix>
  124. <li class="md-nav__item">
  125. <a href=".." title="Introduction" class="md-nav__link">
  126. Introduction
  127. </a>
  128. </li>
  129. <li class="md-nav__item">
  130. <a href="../api-overview/" title="Overview" class="md-nav__link">
  131. Overview
  132. </a>
  133. </li>
  134. <li class="md-nav__item md-nav__item--nested">
  135. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
  136. <label class="md-nav__link" for="nav-3">
  137. API Types
  138. </label>
  139. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  140. <label class="md-nav__title" for="nav-3">
  141. API Types
  142. </label>
  143. <ul class="md-nav__list" data-md-scrollfix>
  144. <li class="md-nav__item">
  145. <a href="../api-externalsecret/" title="ExternalSecret" class="md-nav__link">
  146. ExternalSecret
  147. </a>
  148. </li>
  149. <li class="md-nav__item">
  150. <a href="../api-secretstore/" title="SecretStore" class="md-nav__link">
  151. SecretStore
  152. </a>
  153. </li>
  154. <li class="md-nav__item">
  155. <a href="../api-clustersecretstore/" title="ClusterSecretStore" class="md-nav__link">
  156. ClusterSecretStore
  157. </a>
  158. </li>
  159. </ul>
  160. </nav>
  161. </li>
  162. <li class="md-nav__item md-nav__item--nested">
  163. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
  164. <label class="md-nav__link" for="nav-4">
  165. Guides
  166. </label>
  167. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  168. <label class="md-nav__title" for="nav-4">
  169. Guides
  170. </label>
  171. <ul class="md-nav__list" data-md-scrollfix>
  172. <li class="md-nav__item">
  173. <a href="../guides-introduction/" title="Introduction" class="md-nav__link">
  174. Introduction
  175. </a>
  176. </li>
  177. <li class="md-nav__item">
  178. <a href="../guides-getting-started/" title="Getting started" class="md-nav__link">
  179. Getting started
  180. </a>
  181. </li>
  182. <li class="md-nav__item">
  183. <a href="../guides-templating/" title="Advanced Templating" class="md-nav__link">
  184. Advanced Templating
  185. </a>
  186. </li>
  187. <li class="md-nav__item">
  188. <a href="../guides-multi-tenancy/" title="Multi Tenancy" class="md-nav__link">
  189. Multi Tenancy
  190. </a>
  191. </li>
  192. <li class="md-nav__item">
  193. <a href="../guides-metrics/" title="Metrics" class="md-nav__link">
  194. Metrics
  195. </a>
  196. </li>
  197. </ul>
  198. </nav>
  199. </li>
  200. <li class="md-nav__item md-nav__item--nested">
  201. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
  202. <label class="md-nav__link" for="nav-5">
  203. Provider
  204. </label>
  205. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  206. <label class="md-nav__title" for="nav-5">
  207. Provider
  208. </label>
  209. <ul class="md-nav__list" data-md-scrollfix>
  210. <li class="md-nav__item md-nav__item--nested">
  211. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5-1" type="checkbox" id="nav-5-1">
  212. <label class="md-nav__link" for="nav-5-1">
  213. AWS
  214. </label>
  215. <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
  216. <label class="md-nav__title" for="nav-5-1">
  217. AWS
  218. </label>
  219. <ul class="md-nav__list" data-md-scrollfix>
  220. <li class="md-nav__item">
  221. <a href="../provider-aws-secrets-manager/" title="Secrets Manager" class="md-nav__link">
  222. Secrets Manager
  223. </a>
  224. </li>
  225. <li class="md-nav__item">
  226. <a href="../provider-aws-parameter-store/" title="Parameter Store" class="md-nav__link">
  227. Parameter Store
  228. </a>
  229. </li>
  230. </ul>
  231. </nav>
  232. </li>
  233. <li class="md-nav__item md-nav__item--nested">
  234. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5-2" type="checkbox" id="nav-5-2">
  235. <label class="md-nav__link" for="nav-5-2">
  236. Azure
  237. </label>
  238. <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
  239. <label class="md-nav__title" for="nav-5-2">
  240. Azure
  241. </label>
  242. <ul class="md-nav__list" data-md-scrollfix>
  243. <li class="md-nav__item">
  244. <a href="../provider-azure-key-vault/" title="Key Vault" class="md-nav__link">
  245. Key Vault
  246. </a>
  247. </li>
  248. </ul>
  249. </nav>
  250. </li>
  251. <li class="md-nav__item md-nav__item--nested">
  252. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5-3" type="checkbox" id="nav-5-3">
  253. <label class="md-nav__link" for="nav-5-3">
  254. Google
  255. </label>
  256. <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
  257. <label class="md-nav__title" for="nav-5-3">
  258. Google
  259. </label>
  260. <ul class="md-nav__list" data-md-scrollfix>
  261. <li class="md-nav__item">
  262. <a href="../provider-google-secrets-manager/" title="Secrets Manager" class="md-nav__link">
  263. Secrets Manager
  264. </a>
  265. </li>
  266. </ul>
  267. </nav>
  268. </li>
  269. <li class="md-nav__item">
  270. <a href="../provider-hashicorp-vault/" title="HashiCorp Vault" class="md-nav__link">
  271. HashiCorp Vault
  272. </a>
  273. </li>
  274. </ul>
  275. </nav>
  276. </li>
  277. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  278. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6" checked>
  279. <label class="md-nav__link" for="nav-6">
  280. References
  281. </label>
  282. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  283. <label class="md-nav__title" for="nav-6">
  284. References
  285. </label>
  286. <ul class="md-nav__list" data-md-scrollfix>
  287. <li class="md-nav__item md-nav__item--active">
  288. <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  289. <a href="./" title="API specification" class="md-nav__link md-nav__link--active">
  290. API specification
  291. </a>
  292. </li>
  293. </ul>
  294. </nav>
  295. </li>
  296. <li class="md-nav__item md-nav__item--nested">
  297. <input class="md-toggle md-nav__toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7">
  298. <label class="md-nav__link" for="nav-7">
  299. Contributing
  300. </label>
  301. <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
  302. <label class="md-nav__title" for="nav-7">
  303. Contributing
  304. </label>
  305. <ul class="md-nav__list" data-md-scrollfix>
  306. <li class="md-nav__item">
  307. <a href="../contributing-devguide/" title="Developer guide" class="md-nav__link">
  308. Developer guide
  309. </a>
  310. </li>
  311. <li class="md-nav__item">
  312. <a href="../contributing-process/" title="Contributing Process" class="md-nav__link">
  313. Contributing Process
  314. </a>
  315. </li>
  316. <li class="md-nav__item">
  317. <a href="../contributing-coc/" title="Code of Conduct" class="md-nav__link">
  318. Code of Conduct
  319. </a>
  320. </li>
  321. </ul>
  322. </nav>
  323. </li>
  324. </ul>
  325. </nav>
  326. </div>
  327. </div>
  328. </div>
  329. <div class="md-content">
  330. <article class="md-content__inner md-typeset">
  331. <a href="https://github.com/external-secrets/external-secrets/edit/master/docs/spec.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
  332. <h1>API specification</h1>
  333. <p>Packages:</p>
  334. <ul>
  335. <li>
  336. <a href="#external-secrets.io%2fv1alpha1">external-secrets.io/v1alpha1</a>
  337. </li>
  338. </ul>
  339. <h2 id="external-secrets.io/v1alpha1">external-secrets.io/v1alpha1</h2>
  340. <p>
  341. <p>Package v1alpha1 contains resources for external-secrets</p>
  342. </p>
  343. <p>Resource Types:
  344. <ul></ul>
  345. <h3 id="external-secrets.io/v1alpha1.AWSAuth">AWSAuth
  346. </h3>
  347. <p>
  348. (<em>Appears on:</em>
  349. <a href="#external-secrets.io/v1alpha1.AWSProvider">AWSProvider</a>)
  350. </p>
  351. <p>
  352. <p>AWSAuth contains a secretRef for credentials.</p>
  353. </p>
  354. <table>
  355. <thead>
  356. <tr>
  357. <th>Field</th>
  358. <th>Description</th>
  359. </tr>
  360. </thead>
  361. <tbody>
  362. <tr>
  363. <td>
  364. <code>secretRef</code></br>
  365. <em>
  366. <a href="#external-secrets.io/v1alpha1.AWSAuthSecretRef">
  367. AWSAuthSecretRef
  368. </a>
  369. </em>
  370. </td>
  371. <td>
  372. </td>
  373. </tr>
  374. </tbody>
  375. </table>
  376. <h3 id="external-secrets.io/v1alpha1.AWSAuthSecretRef">AWSAuthSecretRef
  377. </h3>
  378. <p>
  379. (<em>Appears on:</em>
  380. <a href="#external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  381. </p>
  382. <p>
  383. <p>AWSAuthSecretRef holds secret references for aws credentials
  384. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  385. </p>
  386. <table>
  387. <thead>
  388. <tr>
  389. <th>Field</th>
  390. <th>Description</th>
  391. </tr>
  392. </thead>
  393. <tbody>
  394. <tr>
  395. <td>
  396. <code>accessKeyIDSecretRef</code></br>
  397. <em>
  398. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  399. </em>
  400. </td>
  401. <td>
  402. <p>The AccessKeyID is used for authentication</p>
  403. </td>
  404. </tr>
  405. <tr>
  406. <td>
  407. <code>secretAccessKeySecretRef</code></br>
  408. <em>
  409. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  410. </em>
  411. </td>
  412. <td>
  413. <p>The SecretAccessKey is used for authentication</p>
  414. </td>
  415. </tr>
  416. </tbody>
  417. </table>
  418. <h3 id="external-secrets.io/v1alpha1.AWSProvider">AWSProvider
  419. </h3>
  420. <p>
  421. (<em>Appears on:</em>
  422. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  423. </p>
  424. <p>
  425. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  426. </p>
  427. <table>
  428. <thead>
  429. <tr>
  430. <th>Field</th>
  431. <th>Description</th>
  432. </tr>
  433. </thead>
  434. <tbody>
  435. <tr>
  436. <td>
  437. <code>service</code></br>
  438. <em>
  439. <a href="#external-secrets.io/v1alpha1.AWSServiceType">
  440. AWSServiceType
  441. </a>
  442. </em>
  443. </td>
  444. <td>
  445. <p>Service defines which service should be used to fetch the secrets</p>
  446. </td>
  447. </tr>
  448. <tr>
  449. <td>
  450. <code>auth</code></br>
  451. <em>
  452. <a href="#external-secrets.io/v1alpha1.AWSAuth">
  453. AWSAuth
  454. </a>
  455. </em>
  456. </td>
  457. <td>
  458. <em>(Optional)</em>
  459. <p>Auth defines the information necessary to authenticate against AWS
  460. if not set aws sdk will infer credentials from your environment
  461. see: <a href="https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials">https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials</a></p>
  462. </td>
  463. </tr>
  464. <tr>
  465. <td>
  466. <code>role</code></br>
  467. <em>
  468. string
  469. </em>
  470. </td>
  471. <td>
  472. <em>(Optional)</em>
  473. <p>Role is a Role ARN which the SecretManager provider will assume</p>
  474. </td>
  475. </tr>
  476. <tr>
  477. <td>
  478. <code>region</code></br>
  479. <em>
  480. string
  481. </em>
  482. </td>
  483. <td>
  484. <p>AWS Region to be used for the provider</p>
  485. </td>
  486. </tr>
  487. </tbody>
  488. </table>
  489. <h3 id="external-secrets.io/v1alpha1.AWSServiceType">AWSServiceType
  490. (<code>string</code> alias)</p></h3>
  491. <p>
  492. (<em>Appears on:</em>
  493. <a href="#external-secrets.io/v1alpha1.AWSProvider">AWSProvider</a>)
  494. </p>
  495. <p>
  496. <p>AWSServiceType is a enum that defines the service/API that is used to fetch the secrets.</p>
  497. </p>
  498. <table>
  499. <thead>
  500. <tr>
  501. <th>Value</th>
  502. <th>Description</th>
  503. </tr>
  504. </thead>
  505. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  506. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore.
  507. see: <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html">https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html</a></p>
  508. </td>
  509. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  510. <td><p>AWSServiceSecretsManager is the AWS SecretsManager.
  511. see: <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html</a></p>
  512. </td>
  513. </tr></tbody>
  514. </table>
  515. <h3 id="external-secrets.io/v1alpha1.AzureKVAuth">AzureKVAuth
  516. </h3>
  517. <p>
  518. (<em>Appears on:</em>
  519. <a href="#external-secrets.io/v1alpha1.AzureKVProvider">AzureKVProvider</a>)
  520. </p>
  521. <p>
  522. <p>Configuration used to authenticate with Azure.</p>
  523. </p>
  524. <table>
  525. <thead>
  526. <tr>
  527. <th>Field</th>
  528. <th>Description</th>
  529. </tr>
  530. </thead>
  531. <tbody>
  532. <tr>
  533. <td>
  534. <code>clientId</code></br>
  535. <em>
  536. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  537. </em>
  538. </td>
  539. <td>
  540. <p>The Azure clientId of the service principle used for authentication.</p>
  541. </td>
  542. </tr>
  543. <tr>
  544. <td>
  545. <code>clientSecret</code></br>
  546. <em>
  547. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  548. </em>
  549. </td>
  550. <td>
  551. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  552. </td>
  553. </tr>
  554. </tbody>
  555. </table>
  556. <h3 id="external-secrets.io/v1alpha1.AzureKVProvider">AzureKVProvider
  557. </h3>
  558. <p>
  559. (<em>Appears on:</em>
  560. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  561. </p>
  562. <p>
  563. <p>Configures an store to sync secrets using Azure KV.</p>
  564. </p>
  565. <table>
  566. <thead>
  567. <tr>
  568. <th>Field</th>
  569. <th>Description</th>
  570. </tr>
  571. </thead>
  572. <tbody>
  573. <tr>
  574. <td>
  575. <code>vaultUrl</code></br>
  576. <em>
  577. string
  578. </em>
  579. </td>
  580. <td>
  581. <p>Vault Url from which the secrets to be fetched from.</p>
  582. </td>
  583. </tr>
  584. <tr>
  585. <td>
  586. <code>tenantId</code></br>
  587. <em>
  588. string
  589. </em>
  590. </td>
  591. <td>
  592. <p>TenantID configures the Azure Tenant to send requests to.</p>
  593. </td>
  594. </tr>
  595. <tr>
  596. <td>
  597. <code>authSecretRef</code></br>
  598. <em>
  599. <a href="#external-secrets.io/v1alpha1.AzureKVAuth">
  600. AzureKVAuth
  601. </a>
  602. </em>
  603. </td>
  604. <td>
  605. <p>Auth configures how the operator authenticates with Azure.</p>
  606. </td>
  607. </tr>
  608. </tbody>
  609. </table>
  610. <h3 id="external-secrets.io/v1alpha1.ClusterSecretStore">ClusterSecretStore
  611. </h3>
  612. <p>
  613. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  614. </p>
  615. <table>
  616. <thead>
  617. <tr>
  618. <th>Field</th>
  619. <th>Description</th>
  620. </tr>
  621. </thead>
  622. <tbody>
  623. <tr>
  624. <td>
  625. <code>metadata</code></br>
  626. <em>
  627. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#objectmeta-v1-meta">
  628. Kubernetes meta/v1.ObjectMeta
  629. </a>
  630. </em>
  631. </td>
  632. <td>
  633. Refer to the Kubernetes API documentation for the fields of the
  634. <code>metadata</code> field.
  635. </td>
  636. </tr>
  637. <tr>
  638. <td>
  639. <code>spec</code></br>
  640. <em>
  641. <a href="#external-secrets.io/v1alpha1.SecretStoreSpec">
  642. SecretStoreSpec
  643. </a>
  644. </em>
  645. </td>
  646. <td>
  647. <br/>
  648. <br/>
  649. <table>
  650. <tr>
  651. <td>
  652. <code>controller</code></br>
  653. <em>
  654. string
  655. </em>
  656. </td>
  657. <td>
  658. <em>(Optional)</em>
  659. <p>Used to select the correct KES controller (think: ingress.ingressClassName)
  660. The KES controller is instantiated with a specific controller name and filters ES based on this property</p>
  661. </td>
  662. </tr>
  663. <tr>
  664. <td>
  665. <code>provider</code></br>
  666. <em>
  667. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">
  668. SecretStoreProvider
  669. </a>
  670. </em>
  671. </td>
  672. <td>
  673. <p>Used to configure the provider. Only one provider may be set</p>
  674. </td>
  675. </tr>
  676. </table>
  677. </td>
  678. </tr>
  679. </tbody>
  680. </table>
  681. <h3 id="external-secrets.io/v1alpha1.ExternalSecret">ExternalSecret
  682. </h3>
  683. <p>
  684. <p>ExternalSecret is the Schema for the external-secrets API.</p>
  685. </p>
  686. <table>
  687. <thead>
  688. <tr>
  689. <th>Field</th>
  690. <th>Description</th>
  691. </tr>
  692. </thead>
  693. <tbody>
  694. <tr>
  695. <td>
  696. <code>metadata</code></br>
  697. <em>
  698. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#objectmeta-v1-meta">
  699. Kubernetes meta/v1.ObjectMeta
  700. </a>
  701. </em>
  702. </td>
  703. <td>
  704. Refer to the Kubernetes API documentation for the fields of the
  705. <code>metadata</code> field.
  706. </td>
  707. </tr>
  708. <tr>
  709. <td>
  710. <code>spec</code></br>
  711. <em>
  712. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">
  713. ExternalSecretSpec
  714. </a>
  715. </em>
  716. </td>
  717. <td>
  718. <br/>
  719. <br/>
  720. <table>
  721. <tr>
  722. <td>
  723. <code>secretStoreRef</code></br>
  724. <em>
  725. <a href="#external-secrets.io/v1alpha1.SecretStoreRef">
  726. SecretStoreRef
  727. </a>
  728. </em>
  729. </td>
  730. <td>
  731. </td>
  732. </tr>
  733. <tr>
  734. <td>
  735. <code>target</code></br>
  736. <em>
  737. <a href="#external-secrets.io/v1alpha1.ExternalSecretTarget">
  738. ExternalSecretTarget
  739. </a>
  740. </em>
  741. </td>
  742. <td>
  743. </td>
  744. </tr>
  745. <tr>
  746. <td>
  747. <code>refreshInterval</code></br>
  748. <em>
  749. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#duration-v1-meta">
  750. Kubernetes meta/v1.Duration
  751. </a>
  752. </em>
  753. </td>
  754. <td>
  755. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider
  756. Valid time units are &ldquo;ns&rdquo;, &ldquo;us&rdquo; (or &ldquo;µs&rdquo;), &ldquo;ms&rdquo;, &ldquo;s&rdquo;, &ldquo;m&rdquo;, &ldquo;h&rdquo;
  757. May be set to zero to fetch and create it once. Defaults to 1h.</p>
  758. </td>
  759. </tr>
  760. <tr>
  761. <td>
  762. <code>data</code></br>
  763. <em>
  764. <a href="#external-secrets.io/v1alpha1.ExternalSecretData">
  765. []ExternalSecretData
  766. </a>
  767. </em>
  768. </td>
  769. <td>
  770. <em>(Optional)</em>
  771. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  772. </td>
  773. </tr>
  774. <tr>
  775. <td>
  776. <code>dataFrom</code></br>
  777. <em>
  778. <a href="#external-secrets.io/v1alpha1.ExternalSecretDataRemoteRef">
  779. []ExternalSecretDataRemoteRef
  780. </a>
  781. </em>
  782. </td>
  783. <td>
  784. <em>(Optional)</em>
  785. <p>DataFrom is used to fetch all properties from a specific Provider data
  786. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  787. </td>
  788. </tr>
  789. </table>
  790. </td>
  791. </tr>
  792. <tr>
  793. <td>
  794. <code>status</code></br>
  795. <em>
  796. <a href="#external-secrets.io/v1alpha1.ExternalSecretStatus">
  797. ExternalSecretStatus
  798. </a>
  799. </em>
  800. </td>
  801. <td>
  802. </td>
  803. </tr>
  804. </tbody>
  805. </table>
  806. <h3 id="external-secrets.io/v1alpha1.ExternalSecretConditionType">ExternalSecretConditionType
  807. (<code>string</code> alias)</p></h3>
  808. <p>
  809. (<em>Appears on:</em>
  810. <a href="#external-secrets.io/v1alpha1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  811. </p>
  812. <p>
  813. </p>
  814. <table>
  815. <thead>
  816. <tr>
  817. <th>Value</th>
  818. <th>Description</th>
  819. </tr>
  820. </thead>
  821. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  822. <td></td>
  823. </tr></tbody>
  824. </table>
  825. <h3 id="external-secrets.io/v1alpha1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  826. (<code>string</code> alias)</p></h3>
  827. <p>
  828. (<em>Appears on:</em>
  829. <a href="#external-secrets.io/v1alpha1.ExternalSecretTarget">ExternalSecretTarget</a>)
  830. </p>
  831. <p>
  832. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  833. </p>
  834. <table>
  835. <thead>
  836. <tr>
  837. <th>Value</th>
  838. <th>Description</th>
  839. </tr>
  840. </thead>
  841. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  842. <td><p>Merge does not create the Secret, but merges the data fields to the Secret.</p>
  843. </td>
  844. </tr><tr><td><p>&#34;None&#34;</p></td>
  845. <td><p>None does not create a Secret (future use with injector).</p>
  846. </td>
  847. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  848. <td><p>Owner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  849. </td>
  850. </tr></tbody>
  851. </table>
  852. <h3 id="external-secrets.io/v1alpha1.ExternalSecretData">ExternalSecretData
  853. </h3>
  854. <p>
  855. (<em>Appears on:</em>
  856. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec</a>)
  857. </p>
  858. <p>
  859. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  860. </p>
  861. <table>
  862. <thead>
  863. <tr>
  864. <th>Field</th>
  865. <th>Description</th>
  866. </tr>
  867. </thead>
  868. <tbody>
  869. <tr>
  870. <td>
  871. <code>secretKey</code></br>
  872. <em>
  873. string
  874. </em>
  875. </td>
  876. <td>
  877. </td>
  878. </tr>
  879. <tr>
  880. <td>
  881. <code>remoteRef</code></br>
  882. <em>
  883. <a href="#external-secrets.io/v1alpha1.ExternalSecretDataRemoteRef">
  884. ExternalSecretDataRemoteRef
  885. </a>
  886. </em>
  887. </td>
  888. <td>
  889. </td>
  890. </tr>
  891. </tbody>
  892. </table>
  893. <h3 id="external-secrets.io/v1alpha1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  894. </h3>
  895. <p>
  896. (<em>Appears on:</em>
  897. <a href="#external-secrets.io/v1alpha1.ExternalSecretData">ExternalSecretData</a>,
  898. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec</a>)
  899. </p>
  900. <p>
  901. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  902. </p>
  903. <table>
  904. <thead>
  905. <tr>
  906. <th>Field</th>
  907. <th>Description</th>
  908. </tr>
  909. </thead>
  910. <tbody>
  911. <tr>
  912. <td>
  913. <code>key</code></br>
  914. <em>
  915. string
  916. </em>
  917. </td>
  918. <td>
  919. <p>Key is the key used in the Provider, mandatory</p>
  920. </td>
  921. </tr>
  922. <tr>
  923. <td>
  924. <code>version</code></br>
  925. <em>
  926. string
  927. </em>
  928. </td>
  929. <td>
  930. <em>(Optional)</em>
  931. <p>Used to select a specific version of the Provider value, if supported</p>
  932. </td>
  933. </tr>
  934. <tr>
  935. <td>
  936. <code>property</code></br>
  937. <em>
  938. string
  939. </em>
  940. </td>
  941. <td>
  942. <em>(Optional)</em>
  943. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  944. </td>
  945. </tr>
  946. </tbody>
  947. </table>
  948. <h3 id="external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec
  949. </h3>
  950. <p>
  951. (<em>Appears on:</em>
  952. <a href="#external-secrets.io/v1alpha1.ExternalSecret">ExternalSecret</a>)
  953. </p>
  954. <p>
  955. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  956. </p>
  957. <table>
  958. <thead>
  959. <tr>
  960. <th>Field</th>
  961. <th>Description</th>
  962. </tr>
  963. </thead>
  964. <tbody>
  965. <tr>
  966. <td>
  967. <code>secretStoreRef</code></br>
  968. <em>
  969. <a href="#external-secrets.io/v1alpha1.SecretStoreRef">
  970. SecretStoreRef
  971. </a>
  972. </em>
  973. </td>
  974. <td>
  975. </td>
  976. </tr>
  977. <tr>
  978. <td>
  979. <code>target</code></br>
  980. <em>
  981. <a href="#external-secrets.io/v1alpha1.ExternalSecretTarget">
  982. ExternalSecretTarget
  983. </a>
  984. </em>
  985. </td>
  986. <td>
  987. </td>
  988. </tr>
  989. <tr>
  990. <td>
  991. <code>refreshInterval</code></br>
  992. <em>
  993. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#duration-v1-meta">
  994. Kubernetes meta/v1.Duration
  995. </a>
  996. </em>
  997. </td>
  998. <td>
  999. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider
  1000. Valid time units are &ldquo;ns&rdquo;, &ldquo;us&rdquo; (or &ldquo;µs&rdquo;), &ldquo;ms&rdquo;, &ldquo;s&rdquo;, &ldquo;m&rdquo;, &ldquo;h&rdquo;
  1001. May be set to zero to fetch and create it once. Defaults to 1h.</p>
  1002. </td>
  1003. </tr>
  1004. <tr>
  1005. <td>
  1006. <code>data</code></br>
  1007. <em>
  1008. <a href="#external-secrets.io/v1alpha1.ExternalSecretData">
  1009. []ExternalSecretData
  1010. </a>
  1011. </em>
  1012. </td>
  1013. <td>
  1014. <em>(Optional)</em>
  1015. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  1016. </td>
  1017. </tr>
  1018. <tr>
  1019. <td>
  1020. <code>dataFrom</code></br>
  1021. <em>
  1022. <a href="#external-secrets.io/v1alpha1.ExternalSecretDataRemoteRef">
  1023. []ExternalSecretDataRemoteRef
  1024. </a>
  1025. </em>
  1026. </td>
  1027. <td>
  1028. <em>(Optional)</em>
  1029. <p>DataFrom is used to fetch all properties from a specific Provider data
  1030. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  1031. </td>
  1032. </tr>
  1033. </tbody>
  1034. </table>
  1035. <h3 id="external-secrets.io/v1alpha1.ExternalSecretStatus">ExternalSecretStatus
  1036. </h3>
  1037. <p>
  1038. (<em>Appears on:</em>
  1039. <a href="#external-secrets.io/v1alpha1.ExternalSecret">ExternalSecret</a>)
  1040. </p>
  1041. <p>
  1042. </p>
  1043. <table>
  1044. <thead>
  1045. <tr>
  1046. <th>Field</th>
  1047. <th>Description</th>
  1048. </tr>
  1049. </thead>
  1050. <tbody>
  1051. <tr>
  1052. <td>
  1053. <code>refreshTime</code></br>
  1054. <em>
  1055. <a href="https://godoc.org/k8s.io/apimachinery/pkg/apis/meta/v1#Time">
  1056. Kubernetes meta/v1.Time
  1057. </a>
  1058. </em>
  1059. </td>
  1060. <td>
  1061. <p>refreshTime is the time and date the external secret was fetched and
  1062. the target secret updated</p>
  1063. </td>
  1064. </tr>
  1065. <tr>
  1066. <td>
  1067. <code>conditions</code></br>
  1068. <em>
  1069. <a href="#external-secrets.io/v1alpha1.ExternalSecretStatusCondition">
  1070. []ExternalSecretStatusCondition
  1071. </a>
  1072. </em>
  1073. </td>
  1074. <td>
  1075. <em>(Optional)</em>
  1076. </td>
  1077. </tr>
  1078. </tbody>
  1079. </table>
  1080. <h3 id="external-secrets.io/v1alpha1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  1081. </h3>
  1082. <p>
  1083. (<em>Appears on:</em>
  1084. <a href="#external-secrets.io/v1alpha1.ExternalSecretStatus">ExternalSecretStatus</a>)
  1085. </p>
  1086. <p>
  1087. </p>
  1088. <table>
  1089. <thead>
  1090. <tr>
  1091. <th>Field</th>
  1092. <th>Description</th>
  1093. </tr>
  1094. </thead>
  1095. <tbody>
  1096. <tr>
  1097. <td>
  1098. <code>type</code></br>
  1099. <em>
  1100. <a href="#external-secrets.io/v1alpha1.ExternalSecretConditionType">
  1101. ExternalSecretConditionType
  1102. </a>
  1103. </em>
  1104. </td>
  1105. <td>
  1106. </td>
  1107. </tr>
  1108. <tr>
  1109. <td>
  1110. <code>status</code></br>
  1111. <em>
  1112. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#conditionstatus-v1-core">
  1113. Kubernetes core/v1.ConditionStatus
  1114. </a>
  1115. </em>
  1116. </td>
  1117. <td>
  1118. </td>
  1119. </tr>
  1120. <tr>
  1121. <td>
  1122. <code>reason</code></br>
  1123. <em>
  1124. string
  1125. </em>
  1126. </td>
  1127. <td>
  1128. <em>(Optional)</em>
  1129. </td>
  1130. </tr>
  1131. <tr>
  1132. <td>
  1133. <code>message</code></br>
  1134. <em>
  1135. string
  1136. </em>
  1137. </td>
  1138. <td>
  1139. <em>(Optional)</em>
  1140. </td>
  1141. </tr>
  1142. <tr>
  1143. <td>
  1144. <code>lastTransitionTime</code></br>
  1145. <em>
  1146. <a href="https://godoc.org/k8s.io/apimachinery/pkg/apis/meta/v1#Time">
  1147. Kubernetes meta/v1.Time
  1148. </a>
  1149. </em>
  1150. </td>
  1151. <td>
  1152. <em>(Optional)</em>
  1153. </td>
  1154. </tr>
  1155. </tbody>
  1156. </table>
  1157. <h3 id="external-secrets.io/v1alpha1.ExternalSecretTarget">ExternalSecretTarget
  1158. </h3>
  1159. <p>
  1160. (<em>Appears on:</em>
  1161. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec</a>)
  1162. </p>
  1163. <p>
  1164. <p>ExternalSecretTarget defines the Kubernetes Secret to be created
  1165. There can be only one target per ExternalSecret.</p>
  1166. </p>
  1167. <table>
  1168. <thead>
  1169. <tr>
  1170. <th>Field</th>
  1171. <th>Description</th>
  1172. </tr>
  1173. </thead>
  1174. <tbody>
  1175. <tr>
  1176. <td>
  1177. <code>name</code></br>
  1178. <em>
  1179. string
  1180. </em>
  1181. </td>
  1182. <td>
  1183. <em>(Optional)</em>
  1184. <p>Name defines the name of the Secret resource to be managed
  1185. This field is immutable
  1186. Defaults to the .metadata.name of the ExternalSecret resource</p>
  1187. </td>
  1188. </tr>
  1189. <tr>
  1190. <td>
  1191. <code>creationPolicy</code></br>
  1192. <em>
  1193. <a href="#external-secrets.io/v1alpha1.ExternalSecretCreationPolicy">
  1194. ExternalSecretCreationPolicy
  1195. </a>
  1196. </em>
  1197. </td>
  1198. <td>
  1199. <em>(Optional)</em>
  1200. <p>CreationPolicy defines rules on how to create the resulting Secret
  1201. Defaults to &lsquo;Owner&rsquo;</p>
  1202. </td>
  1203. </tr>
  1204. <tr>
  1205. <td>
  1206. <code>template</code></br>
  1207. <em>
  1208. <a href="#external-secrets.io/v1alpha1.ExternalSecretTemplate">
  1209. ExternalSecretTemplate
  1210. </a>
  1211. </em>
  1212. </td>
  1213. <td>
  1214. <em>(Optional)</em>
  1215. <p>Template defines a blueprint for the created Secret resource.</p>
  1216. </td>
  1217. </tr>
  1218. </tbody>
  1219. </table>
  1220. <h3 id="external-secrets.io/v1alpha1.ExternalSecretTemplate">ExternalSecretTemplate
  1221. </h3>
  1222. <p>
  1223. (<em>Appears on:</em>
  1224. <a href="#external-secrets.io/v1alpha1.ExternalSecretTarget">ExternalSecretTarget</a>)
  1225. </p>
  1226. <p>
  1227. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  1228. we can not use native corev1.Secret, it will have empty ObjectMeta values: <a href="https://github.com/kubernetes-sigs/controller-tools/issues/448">https://github.com/kubernetes-sigs/controller-tools/issues/448</a></p>
  1229. </p>
  1230. <table>
  1231. <thead>
  1232. <tr>
  1233. <th>Field</th>
  1234. <th>Description</th>
  1235. </tr>
  1236. </thead>
  1237. <tbody>
  1238. <tr>
  1239. <td>
  1240. <code>type</code></br>
  1241. <em>
  1242. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#secrettype-v1-core">
  1243. Kubernetes core/v1.SecretType
  1244. </a>
  1245. </em>
  1246. </td>
  1247. <td>
  1248. <em>(Optional)</em>
  1249. </td>
  1250. </tr>
  1251. <tr>
  1252. <td>
  1253. <code>metadata</code></br>
  1254. <em>
  1255. <a href="#external-secrets.io/v1alpha1.ExternalSecretTemplateMetadata">
  1256. ExternalSecretTemplateMetadata
  1257. </a>
  1258. </em>
  1259. </td>
  1260. <td>
  1261. <em>(Optional)</em>
  1262. </td>
  1263. </tr>
  1264. <tr>
  1265. <td>
  1266. <code>data</code></br>
  1267. <em>
  1268. map[string]string
  1269. </em>
  1270. </td>
  1271. <td>
  1272. <em>(Optional)</em>
  1273. </td>
  1274. </tr>
  1275. </tbody>
  1276. </table>
  1277. <h3 id="external-secrets.io/v1alpha1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  1278. </h3>
  1279. <p>
  1280. (<em>Appears on:</em>
  1281. <a href="#external-secrets.io/v1alpha1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  1282. </p>
  1283. <p>
  1284. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  1285. </p>
  1286. <table>
  1287. <thead>
  1288. <tr>
  1289. <th>Field</th>
  1290. <th>Description</th>
  1291. </tr>
  1292. </thead>
  1293. <tbody>
  1294. <tr>
  1295. <td>
  1296. <code>annotations</code></br>
  1297. <em>
  1298. map[string]string
  1299. </em>
  1300. </td>
  1301. <td>
  1302. <em>(Optional)</em>
  1303. </td>
  1304. </tr>
  1305. <tr>
  1306. <td>
  1307. <code>labels</code></br>
  1308. <em>
  1309. map[string]string
  1310. </em>
  1311. </td>
  1312. <td>
  1313. <em>(Optional)</em>
  1314. </td>
  1315. </tr>
  1316. </tbody>
  1317. </table>
  1318. <h3 id="external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth
  1319. </h3>
  1320. <p>
  1321. (<em>Appears on:</em>
  1322. <a href="#external-secrets.io/v1alpha1.GCPSMProvider">GCPSMProvider</a>)
  1323. </p>
  1324. <p>
  1325. </p>
  1326. <table>
  1327. <thead>
  1328. <tr>
  1329. <th>Field</th>
  1330. <th>Description</th>
  1331. </tr>
  1332. </thead>
  1333. <tbody>
  1334. <tr>
  1335. <td>
  1336. <code>secretRef</code></br>
  1337. <em>
  1338. <a href="#external-secrets.io/v1alpha1.GCPSMAuthSecretRef">
  1339. GCPSMAuthSecretRef
  1340. </a>
  1341. </em>
  1342. </td>
  1343. <td>
  1344. </td>
  1345. </tr>
  1346. </tbody>
  1347. </table>
  1348. <h3 id="external-secrets.io/v1alpha1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  1349. </h3>
  1350. <p>
  1351. (<em>Appears on:</em>
  1352. <a href="#external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  1353. </p>
  1354. <p>
  1355. </p>
  1356. <table>
  1357. <thead>
  1358. <tr>
  1359. <th>Field</th>
  1360. <th>Description</th>
  1361. </tr>
  1362. </thead>
  1363. <tbody>
  1364. <tr>
  1365. <td>
  1366. <code>secretAccessKeySecretRef</code></br>
  1367. <em>
  1368. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  1369. </em>
  1370. </td>
  1371. <td>
  1372. <em>(Optional)</em>
  1373. <p>The SecretAccessKey is used for authentication</p>
  1374. </td>
  1375. </tr>
  1376. </tbody>
  1377. </table>
  1378. <h3 id="external-secrets.io/v1alpha1.GCPSMProvider">GCPSMProvider
  1379. </h3>
  1380. <p>
  1381. (<em>Appears on:</em>
  1382. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  1383. </p>
  1384. <p>
  1385. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  1386. </p>
  1387. <table>
  1388. <thead>
  1389. <tr>
  1390. <th>Field</th>
  1391. <th>Description</th>
  1392. </tr>
  1393. </thead>
  1394. <tbody>
  1395. <tr>
  1396. <td>
  1397. <code>auth</code></br>
  1398. <em>
  1399. <a href="#external-secrets.io/v1alpha1.GCPSMAuth">
  1400. GCPSMAuth
  1401. </a>
  1402. </em>
  1403. </td>
  1404. <td>
  1405. <p>Auth defines the information necessary to authenticate against GCP</p>
  1406. </td>
  1407. </tr>
  1408. <tr>
  1409. <td>
  1410. <code>projectID</code></br>
  1411. <em>
  1412. string
  1413. </em>
  1414. </td>
  1415. <td>
  1416. <p>ProjectID project where secret is located</p>
  1417. </td>
  1418. </tr>
  1419. </tbody>
  1420. </table>
  1421. <h3 id="external-secrets.io/v1alpha1.GenericStore">GenericStore
  1422. </h3>
  1423. <p>
  1424. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  1425. or a namespaced SecretStore.</p>
  1426. </p>
  1427. <h3 id="external-secrets.io/v1alpha1.SecretStore">SecretStore
  1428. </h3>
  1429. <p>
  1430. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  1431. </p>
  1432. <table>
  1433. <thead>
  1434. <tr>
  1435. <th>Field</th>
  1436. <th>Description</th>
  1437. </tr>
  1438. </thead>
  1439. <tbody>
  1440. <tr>
  1441. <td>
  1442. <code>metadata</code></br>
  1443. <em>
  1444. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#objectmeta-v1-meta">
  1445. Kubernetes meta/v1.ObjectMeta
  1446. </a>
  1447. </em>
  1448. </td>
  1449. <td>
  1450. Refer to the Kubernetes API documentation for the fields of the
  1451. <code>metadata</code> field.
  1452. </td>
  1453. </tr>
  1454. <tr>
  1455. <td>
  1456. <code>spec</code></br>
  1457. <em>
  1458. <a href="#external-secrets.io/v1alpha1.SecretStoreSpec">
  1459. SecretStoreSpec
  1460. </a>
  1461. </em>
  1462. </td>
  1463. <td>
  1464. <br/>
  1465. <br/>
  1466. <table>
  1467. <tr>
  1468. <td>
  1469. <code>controller</code></br>
  1470. <em>
  1471. string
  1472. </em>
  1473. </td>
  1474. <td>
  1475. <em>(Optional)</em>
  1476. <p>Used to select the correct KES controller (think: ingress.ingressClassName)
  1477. The KES controller is instantiated with a specific controller name and filters ES based on this property</p>
  1478. </td>
  1479. </tr>
  1480. <tr>
  1481. <td>
  1482. <code>provider</code></br>
  1483. <em>
  1484. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">
  1485. SecretStoreProvider
  1486. </a>
  1487. </em>
  1488. </td>
  1489. <td>
  1490. <p>Used to configure the provider. Only one provider may be set</p>
  1491. </td>
  1492. </tr>
  1493. </table>
  1494. </td>
  1495. </tr>
  1496. <tr>
  1497. <td>
  1498. <code>status</code></br>
  1499. <em>
  1500. <a href="#external-secrets.io/v1alpha1.SecretStoreStatus">
  1501. SecretStoreStatus
  1502. </a>
  1503. </em>
  1504. </td>
  1505. <td>
  1506. </td>
  1507. </tr>
  1508. </tbody>
  1509. </table>
  1510. <h3 id="external-secrets.io/v1alpha1.SecretStoreConditionType">SecretStoreConditionType
  1511. (<code>string</code> alias)</p></h3>
  1512. <p>
  1513. (<em>Appears on:</em>
  1514. <a href="#external-secrets.io/v1alpha1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  1515. </p>
  1516. <p>
  1517. </p>
  1518. <table>
  1519. <thead>
  1520. <tr>
  1521. <th>Value</th>
  1522. <th>Description</th>
  1523. </tr>
  1524. </thead>
  1525. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  1526. <td></td>
  1527. </tr></tbody>
  1528. </table>
  1529. <h3 id="external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider
  1530. </h3>
  1531. <p>
  1532. (<em>Appears on:</em>
  1533. <a href="#external-secrets.io/v1alpha1.SecretStoreSpec">SecretStoreSpec</a>)
  1534. </p>
  1535. <p>
  1536. <p>SecretStoreProvider contains the provider-specific configration.</p>
  1537. </p>
  1538. <table>
  1539. <thead>
  1540. <tr>
  1541. <th>Field</th>
  1542. <th>Description</th>
  1543. </tr>
  1544. </thead>
  1545. <tbody>
  1546. <tr>
  1547. <td>
  1548. <code>aws</code></br>
  1549. <em>
  1550. <a href="#external-secrets.io/v1alpha1.AWSProvider">
  1551. AWSProvider
  1552. </a>
  1553. </em>
  1554. </td>
  1555. <td>
  1556. <em>(Optional)</em>
  1557. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  1558. </td>
  1559. </tr>
  1560. <tr>
  1561. <td>
  1562. <code>azurekv</code></br>
  1563. <em>
  1564. <a href="#external-secrets.io/v1alpha1.AzureKVProvider">
  1565. AzureKVProvider
  1566. </a>
  1567. </em>
  1568. </td>
  1569. <td>
  1570. <em>(Optional)</em>
  1571. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  1572. </td>
  1573. </tr>
  1574. <tr>
  1575. <td>
  1576. <code>vault</code></br>
  1577. <em>
  1578. <a href="#external-secrets.io/v1alpha1.VaultProvider">
  1579. VaultProvider
  1580. </a>
  1581. </em>
  1582. </td>
  1583. <td>
  1584. <em>(Optional)</em>
  1585. <p>Vault configures this store to sync secrets using Hashi provider</p>
  1586. </td>
  1587. </tr>
  1588. <tr>
  1589. <td>
  1590. <code>gcpsm</code></br>
  1591. <em>
  1592. <a href="#external-secrets.io/v1alpha1.GCPSMProvider">
  1593. GCPSMProvider
  1594. </a>
  1595. </em>
  1596. </td>
  1597. <td>
  1598. <em>(Optional)</em>
  1599. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  1600. </td>
  1601. </tr>
  1602. </tbody>
  1603. </table>
  1604. <h3 id="external-secrets.io/v1alpha1.SecretStoreRef">SecretStoreRef
  1605. </h3>
  1606. <p>
  1607. (<em>Appears on:</em>
  1608. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec</a>)
  1609. </p>
  1610. <p>
  1611. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  1612. </p>
  1613. <table>
  1614. <thead>
  1615. <tr>
  1616. <th>Field</th>
  1617. <th>Description</th>
  1618. </tr>
  1619. </thead>
  1620. <tbody>
  1621. <tr>
  1622. <td>
  1623. <code>name</code></br>
  1624. <em>
  1625. string
  1626. </em>
  1627. </td>
  1628. <td>
  1629. <p>Name of the SecretStore resource</p>
  1630. </td>
  1631. </tr>
  1632. <tr>
  1633. <td>
  1634. <code>kind</code></br>
  1635. <em>
  1636. string
  1637. </em>
  1638. </td>
  1639. <td>
  1640. <em>(Optional)</em>
  1641. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  1642. Defaults to <code>SecretStore</code></p>
  1643. </td>
  1644. </tr>
  1645. </tbody>
  1646. </table>
  1647. <h3 id="external-secrets.io/v1alpha1.SecretStoreSpec">SecretStoreSpec
  1648. </h3>
  1649. <p>
  1650. (<em>Appears on:</em>
  1651. <a href="#external-secrets.io/v1alpha1.ClusterSecretStore">ClusterSecretStore</a>,
  1652. <a href="#external-secrets.io/v1alpha1.SecretStore">SecretStore</a>)
  1653. </p>
  1654. <p>
  1655. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  1656. </p>
  1657. <table>
  1658. <thead>
  1659. <tr>
  1660. <th>Field</th>
  1661. <th>Description</th>
  1662. </tr>
  1663. </thead>
  1664. <tbody>
  1665. <tr>
  1666. <td>
  1667. <code>controller</code></br>
  1668. <em>
  1669. string
  1670. </em>
  1671. </td>
  1672. <td>
  1673. <em>(Optional)</em>
  1674. <p>Used to select the correct KES controller (think: ingress.ingressClassName)
  1675. The KES controller is instantiated with a specific controller name and filters ES based on this property</p>
  1676. </td>
  1677. </tr>
  1678. <tr>
  1679. <td>
  1680. <code>provider</code></br>
  1681. <em>
  1682. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">
  1683. SecretStoreProvider
  1684. </a>
  1685. </em>
  1686. </td>
  1687. <td>
  1688. <p>Used to configure the provider. Only one provider may be set</p>
  1689. </td>
  1690. </tr>
  1691. </tbody>
  1692. </table>
  1693. <h3 id="external-secrets.io/v1alpha1.SecretStoreStatus">SecretStoreStatus
  1694. </h3>
  1695. <p>
  1696. (<em>Appears on:</em>
  1697. <a href="#external-secrets.io/v1alpha1.SecretStore">SecretStore</a>)
  1698. </p>
  1699. <p>
  1700. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  1701. </p>
  1702. <table>
  1703. <thead>
  1704. <tr>
  1705. <th>Field</th>
  1706. <th>Description</th>
  1707. </tr>
  1708. </thead>
  1709. <tbody>
  1710. <tr>
  1711. <td>
  1712. <code>conditions</code></br>
  1713. <em>
  1714. <a href="#external-secrets.io/v1alpha1.SecretStoreStatusCondition">
  1715. []SecretStoreStatusCondition
  1716. </a>
  1717. </em>
  1718. </td>
  1719. <td>
  1720. <em>(Optional)</em>
  1721. </td>
  1722. </tr>
  1723. </tbody>
  1724. </table>
  1725. <h3 id="external-secrets.io/v1alpha1.SecretStoreStatusCondition">SecretStoreStatusCondition
  1726. </h3>
  1727. <p>
  1728. (<em>Appears on:</em>
  1729. <a href="#external-secrets.io/v1alpha1.SecretStoreStatus">SecretStoreStatus</a>)
  1730. </p>
  1731. <p>
  1732. </p>
  1733. <table>
  1734. <thead>
  1735. <tr>
  1736. <th>Field</th>
  1737. <th>Description</th>
  1738. </tr>
  1739. </thead>
  1740. <tbody>
  1741. <tr>
  1742. <td>
  1743. <code>type</code></br>
  1744. <em>
  1745. <a href="#external-secrets.io/v1alpha1.SecretStoreConditionType">
  1746. SecretStoreConditionType
  1747. </a>
  1748. </em>
  1749. </td>
  1750. <td>
  1751. </td>
  1752. </tr>
  1753. <tr>
  1754. <td>
  1755. <code>status</code></br>
  1756. <em>
  1757. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#conditionstatus-v1-core">
  1758. Kubernetes core/v1.ConditionStatus
  1759. </a>
  1760. </em>
  1761. </td>
  1762. <td>
  1763. </td>
  1764. </tr>
  1765. <tr>
  1766. <td>
  1767. <code>reason</code></br>
  1768. <em>
  1769. string
  1770. </em>
  1771. </td>
  1772. <td>
  1773. <em>(Optional)</em>
  1774. </td>
  1775. </tr>
  1776. <tr>
  1777. <td>
  1778. <code>message</code></br>
  1779. <em>
  1780. string
  1781. </em>
  1782. </td>
  1783. <td>
  1784. <em>(Optional)</em>
  1785. </td>
  1786. </tr>
  1787. <tr>
  1788. <td>
  1789. <code>lastTransitionTime</code></br>
  1790. <em>
  1791. <a href="https://godoc.org/k8s.io/apimachinery/pkg/apis/meta/v1#Time">
  1792. Kubernetes meta/v1.Time
  1793. </a>
  1794. </em>
  1795. </td>
  1796. <td>
  1797. <em>(Optional)</em>
  1798. </td>
  1799. </tr>
  1800. </tbody>
  1801. </table>
  1802. <h3 id="external-secrets.io/v1alpha1.VaultAppRole">VaultAppRole
  1803. </h3>
  1804. <p>
  1805. (<em>Appears on:</em>
  1806. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  1807. </p>
  1808. <p>
  1809. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  1810. with the role and secret stored in a Kubernetes Secret resource.</p>
  1811. </p>
  1812. <table>
  1813. <thead>
  1814. <tr>
  1815. <th>Field</th>
  1816. <th>Description</th>
  1817. </tr>
  1818. </thead>
  1819. <tbody>
  1820. <tr>
  1821. <td>
  1822. <code>path</code></br>
  1823. <em>
  1824. string
  1825. </em>
  1826. </td>
  1827. <td>
  1828. <p>Path where the App Role authentication backend is mounted
  1829. in Vault, e.g: &ldquo;approle&rdquo;</p>
  1830. </td>
  1831. </tr>
  1832. <tr>
  1833. <td>
  1834. <code>roleId</code></br>
  1835. <em>
  1836. string
  1837. </em>
  1838. </td>
  1839. <td>
  1840. <p>RoleID configured in the App Role authentication backend when setting
  1841. up the authentication backend in Vault.</p>
  1842. </td>
  1843. </tr>
  1844. <tr>
  1845. <td>
  1846. <code>secretRef</code></br>
  1847. <em>
  1848. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  1849. </em>
  1850. </td>
  1851. <td>
  1852. <p>Reference to a key in a Secret that contains the App Role secret used
  1853. to authenticate with Vault.
  1854. The <code>key</code> field must be specified and denotes which entry within the Secret
  1855. resource is used as the app role secret.</p>
  1856. </td>
  1857. </tr>
  1858. </tbody>
  1859. </table>
  1860. <h3 id="external-secrets.io/v1alpha1.VaultAuth">VaultAuth
  1861. </h3>
  1862. <p>
  1863. (<em>Appears on:</em>
  1864. <a href="#external-secrets.io/v1alpha1.VaultProvider">VaultProvider</a>)
  1865. </p>
  1866. <p>
  1867. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  1868. Only one of <code>tokenSecretRef</code>, <code>appRole</code>, <code>kubernetes</code>, <code>ldap</code> or <code>jwt</code>
  1869. can be specified.</p>
  1870. </p>
  1871. <table>
  1872. <thead>
  1873. <tr>
  1874. <th>Field</th>
  1875. <th>Description</th>
  1876. </tr>
  1877. </thead>
  1878. <tbody>
  1879. <tr>
  1880. <td>
  1881. <code>tokenSecretRef</code></br>
  1882. <em>
  1883. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  1884. </em>
  1885. </td>
  1886. <td>
  1887. <em>(Optional)</em>
  1888. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  1889. </td>
  1890. </tr>
  1891. <tr>
  1892. <td>
  1893. <code>appRole</code></br>
  1894. <em>
  1895. <a href="#external-secrets.io/v1alpha1.VaultAppRole">
  1896. VaultAppRole
  1897. </a>
  1898. </em>
  1899. </td>
  1900. <td>
  1901. <em>(Optional)</em>
  1902. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  1903. with the role and secret stored in a Kubernetes Secret resource.</p>
  1904. </td>
  1905. </tr>
  1906. <tr>
  1907. <td>
  1908. <code>kubernetes</code></br>
  1909. <em>
  1910. <a href="#external-secrets.io/v1alpha1.VaultKubernetesAuth">
  1911. VaultKubernetesAuth
  1912. </a>
  1913. </em>
  1914. </td>
  1915. <td>
  1916. <em>(Optional)</em>
  1917. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  1918. token stored in the named Secret resource to the Vault server.</p>
  1919. </td>
  1920. </tr>
  1921. <tr>
  1922. <td>
  1923. <code>ldap</code></br>
  1924. <em>
  1925. <a href="#external-secrets.io/v1alpha1.VaultLdapAuth">
  1926. VaultLdapAuth
  1927. </a>
  1928. </em>
  1929. </td>
  1930. <td>
  1931. <em>(Optional)</em>
  1932. <p>Ldap authenticates with Vault by passing username/password pair using
  1933. the LDAP authentication method</p>
  1934. </td>
  1935. </tr>
  1936. <tr>
  1937. <td>
  1938. <code>jwt</code></br>
  1939. <em>
  1940. <a href="#external-secrets.io/v1alpha1.VaultJwtAuth">
  1941. VaultJwtAuth
  1942. </a>
  1943. </em>
  1944. </td>
  1945. <td>
  1946. <em>(Optional)</em>
  1947. <p>Jwt authenticates with Vault by passing role and JWT token using the
  1948. JWT/OIDC authentication method</p>
  1949. </td>
  1950. </tr>
  1951. </tbody>
  1952. </table>
  1953. <h3 id="external-secrets.io/v1alpha1.VaultJwtAuth">VaultJwtAuth
  1954. </h3>
  1955. <p>
  1956. (<em>Appears on:</em>
  1957. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  1958. </p>
  1959. <p>
  1960. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  1961. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  1962. </p>
  1963. <table>
  1964. <thead>
  1965. <tr>
  1966. <th>Field</th>
  1967. <th>Description</th>
  1968. </tr>
  1969. </thead>
  1970. <tbody>
  1971. <tr>
  1972. <td>
  1973. <code>role</code></br>
  1974. <em>
  1975. string
  1976. </em>
  1977. </td>
  1978. <td>
  1979. <em>(Optional)</em>
  1980. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  1981. authentication method</p>
  1982. </td>
  1983. </tr>
  1984. <tr>
  1985. <td>
  1986. <code>secretRef</code></br>
  1987. <em>
  1988. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  1989. </em>
  1990. </td>
  1991. <td>
  1992. <p>SecretRef to a key in a Secret resource containing JWT token to
  1993. authenticate with Vault using the JWT/OIDC authentication method</p>
  1994. </td>
  1995. </tr>
  1996. </tbody>
  1997. </table>
  1998. <h3 id="external-secrets.io/v1alpha1.VaultKVStoreVersion">VaultKVStoreVersion
  1999. (<code>string</code> alias)</p></h3>
  2000. <p>
  2001. (<em>Appears on:</em>
  2002. <a href="#external-secrets.io/v1alpha1.VaultProvider">VaultProvider</a>)
  2003. </p>
  2004. <p>
  2005. </p>
  2006. <table>
  2007. <thead>
  2008. <tr>
  2009. <th>Value</th>
  2010. <th>Description</th>
  2011. </tr>
  2012. </thead>
  2013. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  2014. <td></td>
  2015. </tr><tr><td><p>&#34;v2&#34;</p></td>
  2016. <td></td>
  2017. </tr></tbody>
  2018. </table>
  2019. <h3 id="external-secrets.io/v1alpha1.VaultKubernetesAuth">VaultKubernetesAuth
  2020. </h3>
  2021. <p>
  2022. (<em>Appears on:</em>
  2023. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  2024. </p>
  2025. <p>
  2026. <p>Authenticate against Vault using a Kubernetes ServiceAccount token stored in
  2027. a Secret.</p>
  2028. </p>
  2029. <table>
  2030. <thead>
  2031. <tr>
  2032. <th>Field</th>
  2033. <th>Description</th>
  2034. </tr>
  2035. </thead>
  2036. <tbody>
  2037. <tr>
  2038. <td>
  2039. <code>mountPath</code></br>
  2040. <em>
  2041. string
  2042. </em>
  2043. </td>
  2044. <td>
  2045. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  2046. &ldquo;kubernetes&rdquo;</p>
  2047. </td>
  2048. </tr>
  2049. <tr>
  2050. <td>
  2051. <code>serviceAccountRef</code></br>
  2052. <em>
  2053. github.com/external-secrets/external-secrets/apis/meta/v1.ServiceAccountSelector
  2054. </em>
  2055. </td>
  2056. <td>
  2057. <em>(Optional)</em>
  2058. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  2059. If the service account is specified, the service account secret token JWT will be used
  2060. for authenticating with Vault. If the service account selector is not supplied,
  2061. the secretRef will be used instead.</p>
  2062. </td>
  2063. </tr>
  2064. <tr>
  2065. <td>
  2066. <code>secretRef</code></br>
  2067. <em>
  2068. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2069. </em>
  2070. </td>
  2071. <td>
  2072. <em>(Optional)</em>
  2073. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  2074. for authenticating with Vault. If a name is specified without a key,
  2075. <code>token</code> is the default. If one is not specified, the one bound to
  2076. the controller will be used.</p>
  2077. </td>
  2078. </tr>
  2079. <tr>
  2080. <td>
  2081. <code>role</code></br>
  2082. <em>
  2083. string
  2084. </em>
  2085. </td>
  2086. <td>
  2087. <p>A required field containing the Vault Role to assume. A Role binds a
  2088. Kubernetes ServiceAccount with a set of Vault policies.</p>
  2089. </td>
  2090. </tr>
  2091. </tbody>
  2092. </table>
  2093. <h3 id="external-secrets.io/v1alpha1.VaultLdapAuth">VaultLdapAuth
  2094. </h3>
  2095. <p>
  2096. (<em>Appears on:</em>
  2097. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  2098. </p>
  2099. <p>
  2100. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  2101. with the username and password stored in a Kubernetes Secret resource.</p>
  2102. </p>
  2103. <table>
  2104. <thead>
  2105. <tr>
  2106. <th>Field</th>
  2107. <th>Description</th>
  2108. </tr>
  2109. </thead>
  2110. <tbody>
  2111. <tr>
  2112. <td>
  2113. <code>username</code></br>
  2114. <em>
  2115. string
  2116. </em>
  2117. </td>
  2118. <td>
  2119. <p>Username is a LDAP user name used to authenticate using the LDAP Vault
  2120. authentication method</p>
  2121. </td>
  2122. </tr>
  2123. <tr>
  2124. <td>
  2125. <code>secretRef</code></br>
  2126. <em>
  2127. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2128. </em>
  2129. </td>
  2130. <td>
  2131. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  2132. user used to authenticate with Vault using the LDAP authentication
  2133. method</p>
  2134. </td>
  2135. </tr>
  2136. </tbody>
  2137. </table>
  2138. <h3 id="external-secrets.io/v1alpha1.VaultProvider">VaultProvider
  2139. </h3>
  2140. <p>
  2141. (<em>Appears on:</em>
  2142. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  2143. </p>
  2144. <p>
  2145. <p>Configures an store to sync secrets using a HashiCorp Vault
  2146. KV backend.</p>
  2147. </p>
  2148. <table>
  2149. <thead>
  2150. <tr>
  2151. <th>Field</th>
  2152. <th>Description</th>
  2153. </tr>
  2154. </thead>
  2155. <tbody>
  2156. <tr>
  2157. <td>
  2158. <code>auth</code></br>
  2159. <em>
  2160. <a href="#external-secrets.io/v1alpha1.VaultAuth">
  2161. VaultAuth
  2162. </a>
  2163. </em>
  2164. </td>
  2165. <td>
  2166. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  2167. </td>
  2168. </tr>
  2169. <tr>
  2170. <td>
  2171. <code>server</code></br>
  2172. <em>
  2173. string
  2174. </em>
  2175. </td>
  2176. <td>
  2177. <p>Server is the connection address for the Vault server, e.g: &ldquo;<a href="https://vault.example.com:8200&quot;">https://vault.example.com:8200&rdquo;</a>.</p>
  2178. </td>
  2179. </tr>
  2180. <tr>
  2181. <td>
  2182. <code>path</code></br>
  2183. <em>
  2184. string
  2185. </em>
  2186. </td>
  2187. <td>
  2188. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  2189. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  2190. for fetching secrets from Vault is optional and will be appended
  2191. if not present in specified path.</p>
  2192. </td>
  2193. </tr>
  2194. <tr>
  2195. <td>
  2196. <code>version</code></br>
  2197. <em>
  2198. <a href="#external-secrets.io/v1alpha1.VaultKVStoreVersion">
  2199. VaultKVStoreVersion
  2200. </a>
  2201. </em>
  2202. </td>
  2203. <td>
  2204. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  2205. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  2206. </td>
  2207. </tr>
  2208. <tr>
  2209. <td>
  2210. <code>namespace</code></br>
  2211. <em>
  2212. string
  2213. </em>
  2214. </td>
  2215. <td>
  2216. <em>(Optional)</em>
  2217. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  2218. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  2219. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a></p>
  2220. </td>
  2221. </tr>
  2222. <tr>
  2223. <td>
  2224. <code>caBundle</code></br>
  2225. <em>
  2226. []byte
  2227. </em>
  2228. </td>
  2229. <td>
  2230. <em>(Optional)</em>
  2231. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  2232. if the Server URL is using HTTPS protocol. This parameter is ignored for
  2233. plain HTTP protocol connection. If not set the system root certificates
  2234. are used to validate the TLS connection.</p>
  2235. </td>
  2236. </tr>
  2237. </tbody>
  2238. </table>
  2239. <hr/>
  2240. <p><em>
  2241. Generated with <code>gen-crd-api-reference-docs</code>.
  2242. </em></p></p>
  2243. </article>
  2244. </div>
  2245. </div>
  2246. </main>
  2247. <footer class="md-footer">
  2248. <div class="md-footer-nav">
  2249. <nav class="md-footer-nav__inner md-grid">
  2250. <a href="../provider-hashicorp-vault/" title="HashiCorp Vault" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
  2251. <div class="md-flex__cell md-flex__cell--shrink">
  2252. <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
  2253. </div>
  2254. <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
  2255. <span class="md-flex__ellipsis">
  2256. <span class="md-footer-nav__direction">
  2257. Previous
  2258. </span>
  2259. HashiCorp Vault
  2260. </span>
  2261. </div>
  2262. </a>
  2263. <a href="../contributing-devguide/" title="Developer guide" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
  2264. <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
  2265. <span class="md-flex__ellipsis">
  2266. <span class="md-footer-nav__direction">
  2267. Next
  2268. </span>
  2269. Developer guide
  2270. </span>
  2271. </div>
  2272. <div class="md-flex__cell md-flex__cell--shrink">
  2273. <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
  2274. </div>
  2275. </a>
  2276. </nav>
  2277. </div>
  2278. <div class="md-footer-meta md-typeset">
  2279. <div class="md-footer-meta__inner md-grid">
  2280. <div class="md-footer-copyright">
  2281. powered by
  2282. <a href="https://www.mkdocs.org">MkDocs</a>
  2283. and
  2284. <a href="https://squidfunk.github.io/mkdocs-material/">
  2285. Material for MkDocs</a>
  2286. </div>
  2287. </div>
  2288. </div>
  2289. </footer>
  2290. </div>
  2291. <script src="../assets/javascripts/application.808e90bb.js"></script>
  2292. <script>app.initialize({version:"1.0.4",url:{base:".."}})</script>
  2293. </body>
  2294. </html>