index.html 71 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566
  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. <link rel="icon" href="../assets/images/favicon.png">
  7. <meta name="generator" content="mkdocs-1.1, mkdocs-material-7.1.8">
  8. <title>API specification - External Secrets Operator</title>
  9. <link rel="stylesheet" href="../assets/stylesheets/main.ca7ac06f.min.css">
  10. <link rel="stylesheet" href="../assets/stylesheets/palette.f1a3b89f.min.css">
  11. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  12. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
  13. <style>:root{--md-text-font-family:"Roboto";--md-code-font-family:"Roboto Mono"}</style>
  14. <script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","G-QP38TD8K7V"),document.addEventListener("DOMContentLoaded",function(){"undefined"!=typeof location$&&location$.subscribe(function(t){gtag("config","G-QP38TD8K7V",{page_path:t.pathname})})})</script>
  15. <script async src="https://www.googletagmanager.com/gtag/js?id=G-QP38TD8K7V"></script>
  16. </head>
  17. <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none">
  18. <script>function __prefix(e){return new URL("..",location).pathname+"."+e}function __get(e,t=localStorage){return JSON.parse(t.getItem(__prefix(e)))}</script>
  19. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  20. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  21. <label class="md-overlay" for="__drawer"></label>
  22. <div data-md-component="skip">
  23. </div>
  24. <div data-md-component="announce">
  25. </div>
  26. <header class="md-header" data-md-component="header">
  27. <nav class="md-header__inner md-grid" aria-label="Header">
  28. <a href=".." title="External Secrets Operator" class="md-header__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  29. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
  30. </a>
  31. <label class="md-header__button md-icon" for="__drawer">
  32. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
  33. </label>
  34. <div class="md-header__title" data-md-component="header-title">
  35. <div class="md-header__ellipsis">
  36. <div class="md-header__topic">
  37. <span class="md-ellipsis">
  38. External Secrets Operator
  39. </span>
  40. </div>
  41. <div class="md-header__topic" data-md-component="header-topic">
  42. <span class="md-ellipsis">
  43. API specification
  44. </span>
  45. </div>
  46. </div>
  47. </div>
  48. <label class="md-header__button md-icon" for="__search">
  49. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  50. </label>
  51. <div class="md-search" data-md-component="search" role="dialog">
  52. <label class="md-search__overlay" for="__search"></label>
  53. <div class="md-search__inner" role="search">
  54. <form class="md-search__form" name="search">
  55. <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active" required>
  56. <label class="md-search__icon md-icon" for="__search">
  57. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  58. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
  59. </label>
  60. <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1">
  61. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
  62. </button>
  63. </form>
  64. <div class="md-search__output">
  65. <div class="md-search__scrollwrap" data-md-scrollfix>
  66. <div class="md-search-result" data-md-component="search-result">
  67. <div class="md-search-result__meta">
  68. Initializing search
  69. </div>
  70. <ol class="md-search-result__list"></ol>
  71. </div>
  72. </div>
  73. </div>
  74. </div>
  75. </div>
  76. <div class="md-header__source">
  77. <a href="https://github.com/external-secrets/external-secrets/" title="Go to repository" class="md-source" data-md-component="source">
  78. <div class="md-source__icon md-icon">
  79. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
  80. </div>
  81. <div class="md-source__repository">
  82. External Secrets Operator
  83. </div>
  84. </a>
  85. </div>
  86. </nav>
  87. </header>
  88. <div class="md-container" data-md-component="container">
  89. <main class="md-main" data-md-component="main">
  90. <div class="md-main__inner md-grid">
  91. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  92. <div class="md-sidebar__scrollwrap">
  93. <div class="md-sidebar__inner">
  94. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  95. <label class="md-nav__title" for="__drawer">
  96. <a href=".." title="External Secrets Operator" class="md-nav__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  97. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
  98. </a>
  99. External Secrets Operator
  100. </label>
  101. <div class="md-nav__source">
  102. <a href="https://github.com/external-secrets/external-secrets/" title="Go to repository" class="md-source" data-md-component="source">
  103. <div class="md-source__icon md-icon">
  104. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
  105. </div>
  106. <div class="md-source__repository">
  107. External Secrets Operator
  108. </div>
  109. </a>
  110. </div>
  111. <ul class="md-nav__list" data-md-scrollfix>
  112. <li class="md-nav__item">
  113. <a href=".." class="md-nav__link">
  114. Introduction
  115. </a>
  116. </li>
  117. <li class="md-nav__item">
  118. <a href="../api-overview/" class="md-nav__link">
  119. Overview
  120. </a>
  121. </li>
  122. <li class="md-nav__item md-nav__item--nested">
  123. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" >
  124. <label class="md-nav__link" for="__nav_3">
  125. API Types
  126. <span class="md-nav__icon md-icon"></span>
  127. </label>
  128. <nav class="md-nav" aria-label="API Types" data-md-level="1">
  129. <label class="md-nav__title" for="__nav_3">
  130. <span class="md-nav__icon md-icon"></span>
  131. API Types
  132. </label>
  133. <ul class="md-nav__list" data-md-scrollfix>
  134. <li class="md-nav__item">
  135. <a href="../api-externalsecret/" class="md-nav__link">
  136. ExternalSecret
  137. </a>
  138. </li>
  139. <li class="md-nav__item">
  140. <a href="../api-secretstore/" class="md-nav__link">
  141. SecretStore
  142. </a>
  143. </li>
  144. <li class="md-nav__item">
  145. <a href="../api-clustersecretstore/" class="md-nav__link">
  146. ClusterSecretStore
  147. </a>
  148. </li>
  149. </ul>
  150. </nav>
  151. </li>
  152. <li class="md-nav__item md-nav__item--nested">
  153. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" >
  154. <label class="md-nav__link" for="__nav_4">
  155. Guides
  156. <span class="md-nav__icon md-icon"></span>
  157. </label>
  158. <nav class="md-nav" aria-label="Guides" data-md-level="1">
  159. <label class="md-nav__title" for="__nav_4">
  160. <span class="md-nav__icon md-icon"></span>
  161. Guides
  162. </label>
  163. <ul class="md-nav__list" data-md-scrollfix>
  164. <li class="md-nav__item">
  165. <a href="../guides-introduction/" class="md-nav__link">
  166. Introduction
  167. </a>
  168. </li>
  169. <li class="md-nav__item">
  170. <a href="../guides-getting-started/" class="md-nav__link">
  171. Getting started
  172. </a>
  173. </li>
  174. <li class="md-nav__item">
  175. <a href="../guides-templating/" class="md-nav__link">
  176. Advanced Templating
  177. </a>
  178. </li>
  179. <li class="md-nav__item">
  180. <a href="../guides-all-keys-one-secret/" class="md-nav__link">
  181. All keys, One secret
  182. </a>
  183. </li>
  184. <li class="md-nav__item">
  185. <a href="../guides-common-k8s-secret-types/" class="md-nav__link">
  186. Common K8S Secret Types
  187. </a>
  188. </li>
  189. <li class="md-nav__item">
  190. <a href="../guides-multi-tenancy/" class="md-nav__link">
  191. Multi Tenancy
  192. </a>
  193. </li>
  194. <li class="md-nav__item">
  195. <a href="../guides-metrics/" class="md-nav__link">
  196. Metrics
  197. </a>
  198. </li>
  199. </ul>
  200. </nav>
  201. </li>
  202. <li class="md-nav__item md-nav__item--nested">
  203. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
  204. <label class="md-nav__link" for="__nav_5">
  205. Provider
  206. <span class="md-nav__icon md-icon"></span>
  207. </label>
  208. <nav class="md-nav" aria-label="Provider" data-md-level="1">
  209. <label class="md-nav__title" for="__nav_5">
  210. <span class="md-nav__icon md-icon"></span>
  211. Provider
  212. </label>
  213. <ul class="md-nav__list" data-md-scrollfix>
  214. <li class="md-nav__item md-nav__item--nested">
  215. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_1" type="checkbox" id="__nav_5_1" >
  216. <label class="md-nav__link" for="__nav_5_1">
  217. AWS
  218. <span class="md-nav__icon md-icon"></span>
  219. </label>
  220. <nav class="md-nav" aria-label="AWS" data-md-level="2">
  221. <label class="md-nav__title" for="__nav_5_1">
  222. <span class="md-nav__icon md-icon"></span>
  223. AWS
  224. </label>
  225. <ul class="md-nav__list" data-md-scrollfix>
  226. <li class="md-nav__item">
  227. <a href="../provider-aws-secrets-manager/" class="md-nav__link">
  228. Secrets Manager
  229. </a>
  230. </li>
  231. <li class="md-nav__item">
  232. <a href="../provider-aws-parameter-store/" class="md-nav__link">
  233. Parameter Store
  234. </a>
  235. </li>
  236. </ul>
  237. </nav>
  238. </li>
  239. <li class="md-nav__item md-nav__item--nested">
  240. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_2" type="checkbox" id="__nav_5_2" >
  241. <label class="md-nav__link" for="__nav_5_2">
  242. Azure
  243. <span class="md-nav__icon md-icon"></span>
  244. </label>
  245. <nav class="md-nav" aria-label="Azure" data-md-level="2">
  246. <label class="md-nav__title" for="__nav_5_2">
  247. <span class="md-nav__icon md-icon"></span>
  248. Azure
  249. </label>
  250. <ul class="md-nav__list" data-md-scrollfix>
  251. <li class="md-nav__item">
  252. <a href="../provider-azure-key-vault/" class="md-nav__link">
  253. Key Vault
  254. </a>
  255. </li>
  256. </ul>
  257. </nav>
  258. </li>
  259. <li class="md-nav__item md-nav__item--nested">
  260. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_3" type="checkbox" id="__nav_5_3" >
  261. <label class="md-nav__link" for="__nav_5_3">
  262. Google
  263. <span class="md-nav__icon md-icon"></span>
  264. </label>
  265. <nav class="md-nav" aria-label="Google" data-md-level="2">
  266. <label class="md-nav__title" for="__nav_5_3">
  267. <span class="md-nav__icon md-icon"></span>
  268. Google
  269. </label>
  270. <ul class="md-nav__list" data-md-scrollfix>
  271. <li class="md-nav__item">
  272. <a href="../provider-google-secrets-manager/" class="md-nav__link">
  273. Secrets Manager
  274. </a>
  275. </li>
  276. </ul>
  277. </nav>
  278. </li>
  279. <li class="md-nav__item md-nav__item--nested">
  280. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_4" type="checkbox" id="__nav_5_4" >
  281. <label class="md-nav__link" for="__nav_5_4">
  282. IBM
  283. <span class="md-nav__icon md-icon"></span>
  284. </label>
  285. <nav class="md-nav" aria-label="IBM" data-md-level="2">
  286. <label class="md-nav__title" for="__nav_5_4">
  287. <span class="md-nav__icon md-icon"></span>
  288. IBM
  289. </label>
  290. <ul class="md-nav__list" data-md-scrollfix>
  291. <li class="md-nav__item">
  292. <a href="../provider-ibm-secrets-manager/" class="md-nav__link">
  293. Secrets Manager
  294. </a>
  295. </li>
  296. </ul>
  297. </nav>
  298. </li>
  299. <li class="md-nav__item">
  300. <a href="../provider-hashicorp-vault/" class="md-nav__link">
  301. HashiCorp Vault
  302. </a>
  303. </li>
  304. <li class="md-nav__item md-nav__item--nested">
  305. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_6" type="checkbox" id="__nav_5_6" >
  306. <label class="md-nav__link" for="__nav_5_6">
  307. Yandex
  308. <span class="md-nav__icon md-icon"></span>
  309. </label>
  310. <nav class="md-nav" aria-label="Yandex" data-md-level="2">
  311. <label class="md-nav__title" for="__nav_5_6">
  312. <span class="md-nav__icon md-icon"></span>
  313. Yandex
  314. </label>
  315. <ul class="md-nav__list" data-md-scrollfix>
  316. <li class="md-nav__item">
  317. <a href="../provider-yandex-lockbox/" class="md-nav__link">
  318. Lockbox
  319. </a>
  320. </li>
  321. </ul>
  322. </nav>
  323. </li>
  324. <li class="md-nav__item md-nav__item--nested">
  325. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_7" type="checkbox" id="__nav_5_7" >
  326. <label class="md-nav__link" for="__nav_5_7">
  327. Gitlab
  328. <span class="md-nav__icon md-icon"></span>
  329. </label>
  330. <nav class="md-nav" aria-label="Gitlab" data-md-level="2">
  331. <label class="md-nav__title" for="__nav_5_7">
  332. <span class="md-nav__icon md-icon"></span>
  333. Gitlab
  334. </label>
  335. <ul class="md-nav__list" data-md-scrollfix>
  336. <li class="md-nav__item">
  337. <a href="../provider-gitlab-project-variables/" class="md-nav__link">
  338. Gitlab Project Variables
  339. </a>
  340. </li>
  341. </ul>
  342. </nav>
  343. </li>
  344. </ul>
  345. </nav>
  346. </li>
  347. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  348. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" checked>
  349. <label class="md-nav__link" for="__nav_6">
  350. References
  351. <span class="md-nav__icon md-icon"></span>
  352. </label>
  353. <nav class="md-nav" aria-label="References" data-md-level="1">
  354. <label class="md-nav__title" for="__nav_6">
  355. <span class="md-nav__icon md-icon"></span>
  356. References
  357. </label>
  358. <ul class="md-nav__list" data-md-scrollfix>
  359. <li class="md-nav__item md-nav__item--active">
  360. <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  361. <a href="./" class="md-nav__link md-nav__link--active">
  362. API specification
  363. </a>
  364. </li>
  365. </ul>
  366. </nav>
  367. </li>
  368. <li class="md-nav__item md-nav__item--nested">
  369. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" >
  370. <label class="md-nav__link" for="__nav_7">
  371. Contributing
  372. <span class="md-nav__icon md-icon"></span>
  373. </label>
  374. <nav class="md-nav" aria-label="Contributing" data-md-level="1">
  375. <label class="md-nav__title" for="__nav_7">
  376. <span class="md-nav__icon md-icon"></span>
  377. Contributing
  378. </label>
  379. <ul class="md-nav__list" data-md-scrollfix>
  380. <li class="md-nav__item">
  381. <a href="../contributing-devguide/" class="md-nav__link">
  382. Developer guide
  383. </a>
  384. </li>
  385. <li class="md-nav__item">
  386. <a href="../contributing-process/" class="md-nav__link">
  387. Contributing Process
  388. </a>
  389. </li>
  390. <li class="md-nav__item">
  391. <a href="../contributing-coc/" class="md-nav__link">
  392. Code of Conduct
  393. </a>
  394. </li>
  395. </ul>
  396. </nav>
  397. </li>
  398. <li class="md-nav__item">
  399. <a href="../deprecation-policy/" class="md-nav__link">
  400. Deprecation Policy
  401. </a>
  402. </li>
  403. </ul>
  404. </nav>
  405. </div>
  406. </div>
  407. </div>
  408. <div class="md-content" data-md-component="content">
  409. <article class="md-content__inner md-typeset">
  410. <a href="https://github.com/external-secrets/external-secrets/edit/master/docs/spec.md" title="Edit this page" class="md-content__button md-icon">
  411. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg>
  412. </a>
  413. <h1>API specification</h1>
  414. <p>Packages:</p>
  415. <ul>
  416. <li>
  417. <a href="#external-secrets.io%2fv1alpha1">external-secrets.io/v1alpha1</a>
  418. </li>
  419. </ul>
  420. <h2 id="external-secrets.io/v1alpha1">external-secrets.io/v1alpha1</h2>
  421. <p>
  422. <p>Package v1alpha1 contains resources for external-secrets</p>
  423. </p>
  424. <p>Resource Types:
  425. <ul></ul>
  426. <h3 id="external-secrets.io/v1alpha1.AWSAuth">AWSAuth
  427. </h3>
  428. <p>
  429. (<em>Appears on:</em>
  430. <a href="#external-secrets.io/v1alpha1.AWSProvider">AWSProvider</a>)
  431. </p>
  432. <p>
  433. <p>AWSAuth tells the controller how to do authentication with aws.
  434. Only one of secretRef or jwt can be specified.
  435. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  436. </p>
  437. <table>
  438. <thead>
  439. <tr>
  440. <th>Field</th>
  441. <th>Description</th>
  442. </tr>
  443. </thead>
  444. <tbody>
  445. <tr>
  446. <td>
  447. <code>secretRef</code></br>
  448. <em>
  449. <a href="#external-secrets.io/v1alpha1.AWSAuthSecretRef">
  450. AWSAuthSecretRef
  451. </a>
  452. </em>
  453. </td>
  454. <td>
  455. <em>(Optional)</em>
  456. </td>
  457. </tr>
  458. <tr>
  459. <td>
  460. <code>jwt</code></br>
  461. <em>
  462. <a href="#external-secrets.io/v1alpha1.AWSJWTAuth">
  463. AWSJWTAuth
  464. </a>
  465. </em>
  466. </td>
  467. <td>
  468. <em>(Optional)</em>
  469. </td>
  470. </tr>
  471. </tbody>
  472. </table>
  473. <h3 id="external-secrets.io/v1alpha1.AWSAuthSecretRef">AWSAuthSecretRef
  474. </h3>
  475. <p>
  476. (<em>Appears on:</em>
  477. <a href="#external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  478. </p>
  479. <p>
  480. <p>AWSAuthSecretRef holds secret references for AWS credentials
  481. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  482. </p>
  483. <table>
  484. <thead>
  485. <tr>
  486. <th>Field</th>
  487. <th>Description</th>
  488. </tr>
  489. </thead>
  490. <tbody>
  491. <tr>
  492. <td>
  493. <code>accessKeyIDSecretRef</code></br>
  494. <em>
  495. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  496. </em>
  497. </td>
  498. <td>
  499. <p>The AccessKeyID is used for authentication</p>
  500. </td>
  501. </tr>
  502. <tr>
  503. <td>
  504. <code>secretAccessKeySecretRef</code></br>
  505. <em>
  506. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  507. </em>
  508. </td>
  509. <td>
  510. <p>The SecretAccessKey is used for authentication</p>
  511. </td>
  512. </tr>
  513. </tbody>
  514. </table>
  515. <h3 id="external-secrets.io/v1alpha1.AWSJWTAuth">AWSJWTAuth
  516. </h3>
  517. <p>
  518. (<em>Appears on:</em>
  519. <a href="#external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  520. </p>
  521. <p>
  522. <p>Authenticate against AWS using service account tokens.</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>serviceAccountRef</code></br>
  535. <em>
  536. github.com/external-secrets/external-secrets/apis/meta/v1.ServiceAccountSelector
  537. </em>
  538. </td>
  539. <td>
  540. </td>
  541. </tr>
  542. </tbody>
  543. </table>
  544. <h3 id="external-secrets.io/v1alpha1.AWSProvider">AWSProvider
  545. </h3>
  546. <p>
  547. (<em>Appears on:</em>
  548. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  549. </p>
  550. <p>
  551. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  552. </p>
  553. <table>
  554. <thead>
  555. <tr>
  556. <th>Field</th>
  557. <th>Description</th>
  558. </tr>
  559. </thead>
  560. <tbody>
  561. <tr>
  562. <td>
  563. <code>service</code></br>
  564. <em>
  565. <a href="#external-secrets.io/v1alpha1.AWSServiceType">
  566. AWSServiceType
  567. </a>
  568. </em>
  569. </td>
  570. <td>
  571. <p>Service defines which service should be used to fetch the secrets</p>
  572. </td>
  573. </tr>
  574. <tr>
  575. <td>
  576. <code>auth</code></br>
  577. <em>
  578. <a href="#external-secrets.io/v1alpha1.AWSAuth">
  579. AWSAuth
  580. </a>
  581. </em>
  582. </td>
  583. <td>
  584. <em>(Optional)</em>
  585. <p>Auth defines the information necessary to authenticate against AWS
  586. if not set aws sdk will infer credentials from your environment
  587. 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>
  588. </td>
  589. </tr>
  590. <tr>
  591. <td>
  592. <code>role</code></br>
  593. <em>
  594. string
  595. </em>
  596. </td>
  597. <td>
  598. <em>(Optional)</em>
  599. <p>Role is a Role ARN which the SecretManager provider will assume</p>
  600. </td>
  601. </tr>
  602. <tr>
  603. <td>
  604. <code>region</code></br>
  605. <em>
  606. string
  607. </em>
  608. </td>
  609. <td>
  610. <p>AWS Region to be used for the provider</p>
  611. </td>
  612. </tr>
  613. </tbody>
  614. </table>
  615. <h3 id="external-secrets.io/v1alpha1.AWSServiceType">AWSServiceType
  616. (<code>string</code> alias)</p></h3>
  617. <p>
  618. (<em>Appears on:</em>
  619. <a href="#external-secrets.io/v1alpha1.AWSProvider">AWSProvider</a>)
  620. </p>
  621. <p>
  622. <p>AWSServiceType is a enum that defines the service/API that is used to fetch the secrets.</p>
  623. </p>
  624. <table>
  625. <thead>
  626. <tr>
  627. <th>Value</th>
  628. <th>Description</th>
  629. </tr>
  630. </thead>
  631. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  632. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore.
  633. 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>
  634. </td>
  635. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  636. <td><p>AWSServiceSecretsManager is the AWS SecretsManager.
  637. 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>
  638. </td>
  639. </tr></tbody>
  640. </table>
  641. <h3 id="external-secrets.io/v1alpha1.AlibabaAuth">AlibabaAuth
  642. </h3>
  643. <p>
  644. (<em>Appears on:</em>
  645. <a href="#external-secrets.io/v1alpha1.AlibabaProvider">AlibabaProvider</a>)
  646. </p>
  647. <p>
  648. <p>AlibabaAuth contains a secretRef for credentials.</p>
  649. </p>
  650. <table>
  651. <thead>
  652. <tr>
  653. <th>Field</th>
  654. <th>Description</th>
  655. </tr>
  656. </thead>
  657. <tbody>
  658. <tr>
  659. <td>
  660. <code>secretRef</code></br>
  661. <em>
  662. <a href="#external-secrets.io/v1alpha1.AlibabaAuthSecretRef">
  663. AlibabaAuthSecretRef
  664. </a>
  665. </em>
  666. </td>
  667. <td>
  668. </td>
  669. </tr>
  670. </tbody>
  671. </table>
  672. <h3 id="external-secrets.io/v1alpha1.AlibabaAuthSecretRef">AlibabaAuthSecretRef
  673. </h3>
  674. <p>
  675. (<em>Appears on:</em>
  676. <a href="#external-secrets.io/v1alpha1.AlibabaAuth">AlibabaAuth</a>)
  677. </p>
  678. <p>
  679. <p>AlibabaAuthSecretRef holds secret references for Alibaba credentials.</p>
  680. </p>
  681. <table>
  682. <thead>
  683. <tr>
  684. <th>Field</th>
  685. <th>Description</th>
  686. </tr>
  687. </thead>
  688. <tbody>
  689. <tr>
  690. <td>
  691. <code>accessKeyIDSecretRef</code></br>
  692. <em>
  693. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  694. </em>
  695. </td>
  696. <td>
  697. <p>The AccessKeyID is used for authentication</p>
  698. </td>
  699. </tr>
  700. <tr>
  701. <td>
  702. <code>accessKeySecretSecretRef</code></br>
  703. <em>
  704. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  705. </em>
  706. </td>
  707. <td>
  708. <p>The AccessKeySecret is used for authentication</p>
  709. </td>
  710. </tr>
  711. </tbody>
  712. </table>
  713. <h3 id="external-secrets.io/v1alpha1.AlibabaProvider">AlibabaProvider
  714. </h3>
  715. <p>
  716. (<em>Appears on:</em>
  717. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  718. </p>
  719. <p>
  720. <p>AlibabaProvider configures a store to sync secrets using the Alibaba Secret Manager provider.</p>
  721. </p>
  722. <table>
  723. <thead>
  724. <tr>
  725. <th>Field</th>
  726. <th>Description</th>
  727. </tr>
  728. </thead>
  729. <tbody>
  730. <tr>
  731. <td>
  732. <code>auth</code></br>
  733. <em>
  734. <a href="#external-secrets.io/v1alpha1.AlibabaAuth">
  735. AlibabaAuth
  736. </a>
  737. </em>
  738. </td>
  739. <td>
  740. </td>
  741. </tr>
  742. <tr>
  743. <td>
  744. <code>endpoint</code></br>
  745. <em>
  746. string
  747. </em>
  748. </td>
  749. <td>
  750. <em>(Optional)</em>
  751. </td>
  752. </tr>
  753. <tr>
  754. <td>
  755. <code>regionID</code></br>
  756. <em>
  757. string
  758. </em>
  759. </td>
  760. <td>
  761. <p>Alibaba Region to be used for the provider</p>
  762. </td>
  763. </tr>
  764. </tbody>
  765. </table>
  766. <h3 id="external-secrets.io/v1alpha1.AzureKVAuth">AzureKVAuth
  767. </h3>
  768. <p>
  769. (<em>Appears on:</em>
  770. <a href="#external-secrets.io/v1alpha1.AzureKVProvider">AzureKVProvider</a>)
  771. </p>
  772. <p>
  773. <p>Configuration used to authenticate with Azure.</p>
  774. </p>
  775. <table>
  776. <thead>
  777. <tr>
  778. <th>Field</th>
  779. <th>Description</th>
  780. </tr>
  781. </thead>
  782. <tbody>
  783. <tr>
  784. <td>
  785. <code>clientId</code></br>
  786. <em>
  787. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  788. </em>
  789. </td>
  790. <td>
  791. <p>The Azure clientId of the service principle used for authentication.</p>
  792. </td>
  793. </tr>
  794. <tr>
  795. <td>
  796. <code>clientSecret</code></br>
  797. <em>
  798. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  799. </em>
  800. </td>
  801. <td>
  802. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  803. </td>
  804. </tr>
  805. </tbody>
  806. </table>
  807. <h3 id="external-secrets.io/v1alpha1.AzureKVProvider">AzureKVProvider
  808. </h3>
  809. <p>
  810. (<em>Appears on:</em>
  811. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  812. </p>
  813. <p>
  814. <p>Configures an store to sync secrets using Azure KV.</p>
  815. </p>
  816. <table>
  817. <thead>
  818. <tr>
  819. <th>Field</th>
  820. <th>Description</th>
  821. </tr>
  822. </thead>
  823. <tbody>
  824. <tr>
  825. <td>
  826. <code>vaultUrl</code></br>
  827. <em>
  828. string
  829. </em>
  830. </td>
  831. <td>
  832. <p>Vault Url from which the secrets to be fetched from.</p>
  833. </td>
  834. </tr>
  835. <tr>
  836. <td>
  837. <code>tenantId</code></br>
  838. <em>
  839. string
  840. </em>
  841. </td>
  842. <td>
  843. <p>TenantID configures the Azure Tenant to send requests to.</p>
  844. </td>
  845. </tr>
  846. <tr>
  847. <td>
  848. <code>authSecretRef</code></br>
  849. <em>
  850. <a href="#external-secrets.io/v1alpha1.AzureKVAuth">
  851. AzureKVAuth
  852. </a>
  853. </em>
  854. </td>
  855. <td>
  856. <p>Auth configures how the operator authenticates with Azure.</p>
  857. </td>
  858. </tr>
  859. </tbody>
  860. </table>
  861. <h3 id="external-secrets.io/v1alpha1.ClusterSecretStore">ClusterSecretStore
  862. </h3>
  863. <p>
  864. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  865. </p>
  866. <table>
  867. <thead>
  868. <tr>
  869. <th>Field</th>
  870. <th>Description</th>
  871. </tr>
  872. </thead>
  873. <tbody>
  874. <tr>
  875. <td>
  876. <code>metadata</code></br>
  877. <em>
  878. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#objectmeta-v1-meta">
  879. Kubernetes meta/v1.ObjectMeta
  880. </a>
  881. </em>
  882. </td>
  883. <td>
  884. Refer to the Kubernetes API documentation for the fields of the
  885. <code>metadata</code> field.
  886. </td>
  887. </tr>
  888. <tr>
  889. <td>
  890. <code>spec</code></br>
  891. <em>
  892. <a href="#external-secrets.io/v1alpha1.SecretStoreSpec">
  893. SecretStoreSpec
  894. </a>
  895. </em>
  896. </td>
  897. <td>
  898. <br/>
  899. <br/>
  900. <table>
  901. <tr>
  902. <td>
  903. <code>controller</code></br>
  904. <em>
  905. string
  906. </em>
  907. </td>
  908. <td>
  909. <em>(Optional)</em>
  910. <p>Used to select the correct KES controller (think: ingress.ingressClassName)
  911. The KES controller is instantiated with a specific controller name and filters ES based on this property</p>
  912. </td>
  913. </tr>
  914. <tr>
  915. <td>
  916. <code>provider</code></br>
  917. <em>
  918. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">
  919. SecretStoreProvider
  920. </a>
  921. </em>
  922. </td>
  923. <td>
  924. <p>Used to configure the provider. Only one provider may be set</p>
  925. </td>
  926. </tr>
  927. </table>
  928. </td>
  929. </tr>
  930. <tr>
  931. <td>
  932. <code>status</code></br>
  933. <em>
  934. <a href="#external-secrets.io/v1alpha1.SecretStoreStatus">
  935. SecretStoreStatus
  936. </a>
  937. </em>
  938. </td>
  939. <td>
  940. </td>
  941. </tr>
  942. </tbody>
  943. </table>
  944. <h3 id="external-secrets.io/v1alpha1.ExternalSecret">ExternalSecret
  945. </h3>
  946. <p>
  947. <p>ExternalSecret is the Schema for the external-secrets API.</p>
  948. </p>
  949. <table>
  950. <thead>
  951. <tr>
  952. <th>Field</th>
  953. <th>Description</th>
  954. </tr>
  955. </thead>
  956. <tbody>
  957. <tr>
  958. <td>
  959. <code>metadata</code></br>
  960. <em>
  961. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#objectmeta-v1-meta">
  962. Kubernetes meta/v1.ObjectMeta
  963. </a>
  964. </em>
  965. </td>
  966. <td>
  967. Refer to the Kubernetes API documentation for the fields of the
  968. <code>metadata</code> field.
  969. </td>
  970. </tr>
  971. <tr>
  972. <td>
  973. <code>spec</code></br>
  974. <em>
  975. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">
  976. ExternalSecretSpec
  977. </a>
  978. </em>
  979. </td>
  980. <td>
  981. <br/>
  982. <br/>
  983. <table>
  984. <tr>
  985. <td>
  986. <code>secretStoreRef</code></br>
  987. <em>
  988. <a href="#external-secrets.io/v1alpha1.SecretStoreRef">
  989. SecretStoreRef
  990. </a>
  991. </em>
  992. </td>
  993. <td>
  994. </td>
  995. </tr>
  996. <tr>
  997. <td>
  998. <code>target</code></br>
  999. <em>
  1000. <a href="#external-secrets.io/v1alpha1.ExternalSecretTarget">
  1001. ExternalSecretTarget
  1002. </a>
  1003. </em>
  1004. </td>
  1005. <td>
  1006. </td>
  1007. </tr>
  1008. <tr>
  1009. <td>
  1010. <code>refreshInterval</code></br>
  1011. <em>
  1012. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#duration-v1-meta">
  1013. Kubernetes meta/v1.Duration
  1014. </a>
  1015. </em>
  1016. </td>
  1017. <td>
  1018. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider
  1019. 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;
  1020. May be set to zero to fetch and create it once. Defaults to 1h.</p>
  1021. </td>
  1022. </tr>
  1023. <tr>
  1024. <td>
  1025. <code>data</code></br>
  1026. <em>
  1027. <a href="#external-secrets.io/v1alpha1.ExternalSecretData">
  1028. []ExternalSecretData
  1029. </a>
  1030. </em>
  1031. </td>
  1032. <td>
  1033. <em>(Optional)</em>
  1034. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  1035. </td>
  1036. </tr>
  1037. <tr>
  1038. <td>
  1039. <code>dataFrom</code></br>
  1040. <em>
  1041. <a href="#external-secrets.io/v1alpha1.ExternalSecretDataRemoteRef">
  1042. []ExternalSecretDataRemoteRef
  1043. </a>
  1044. </em>
  1045. </td>
  1046. <td>
  1047. <em>(Optional)</em>
  1048. <p>DataFrom is used to fetch all properties from a specific Provider data
  1049. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  1050. </td>
  1051. </tr>
  1052. </table>
  1053. </td>
  1054. </tr>
  1055. <tr>
  1056. <td>
  1057. <code>status</code></br>
  1058. <em>
  1059. <a href="#external-secrets.io/v1alpha1.ExternalSecretStatus">
  1060. ExternalSecretStatus
  1061. </a>
  1062. </em>
  1063. </td>
  1064. <td>
  1065. </td>
  1066. </tr>
  1067. </tbody>
  1068. </table>
  1069. <h3 id="external-secrets.io/v1alpha1.ExternalSecretConditionType">ExternalSecretConditionType
  1070. (<code>string</code> alias)</p></h3>
  1071. <p>
  1072. (<em>Appears on:</em>
  1073. <a href="#external-secrets.io/v1alpha1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  1074. </p>
  1075. <p>
  1076. </p>
  1077. <table>
  1078. <thead>
  1079. <tr>
  1080. <th>Value</th>
  1081. <th>Description</th>
  1082. </tr>
  1083. </thead>
  1084. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  1085. <td></td>
  1086. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  1087. <td></td>
  1088. </tr></tbody>
  1089. </table>
  1090. <h3 id="external-secrets.io/v1alpha1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  1091. (<code>string</code> alias)</p></h3>
  1092. <p>
  1093. (<em>Appears on:</em>
  1094. <a href="#external-secrets.io/v1alpha1.ExternalSecretTarget">ExternalSecretTarget</a>)
  1095. </p>
  1096. <p>
  1097. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  1098. </p>
  1099. <table>
  1100. <thead>
  1101. <tr>
  1102. <th>Value</th>
  1103. <th>Description</th>
  1104. </tr>
  1105. </thead>
  1106. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  1107. <td><p>Merge does not create the Secret, but merges the data fields to the Secret.</p>
  1108. </td>
  1109. </tr><tr><td><p>&#34;None&#34;</p></td>
  1110. <td><p>None does not create a Secret (future use with injector).</p>
  1111. </td>
  1112. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  1113. <td><p>Owner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  1114. </td>
  1115. </tr></tbody>
  1116. </table>
  1117. <h3 id="external-secrets.io/v1alpha1.ExternalSecretData">ExternalSecretData
  1118. </h3>
  1119. <p>
  1120. (<em>Appears on:</em>
  1121. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec</a>)
  1122. </p>
  1123. <p>
  1124. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  1125. </p>
  1126. <table>
  1127. <thead>
  1128. <tr>
  1129. <th>Field</th>
  1130. <th>Description</th>
  1131. </tr>
  1132. </thead>
  1133. <tbody>
  1134. <tr>
  1135. <td>
  1136. <code>secretKey</code></br>
  1137. <em>
  1138. string
  1139. </em>
  1140. </td>
  1141. <td>
  1142. </td>
  1143. </tr>
  1144. <tr>
  1145. <td>
  1146. <code>remoteRef</code></br>
  1147. <em>
  1148. <a href="#external-secrets.io/v1alpha1.ExternalSecretDataRemoteRef">
  1149. ExternalSecretDataRemoteRef
  1150. </a>
  1151. </em>
  1152. </td>
  1153. <td>
  1154. </td>
  1155. </tr>
  1156. </tbody>
  1157. </table>
  1158. <h3 id="external-secrets.io/v1alpha1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  1159. </h3>
  1160. <p>
  1161. (<em>Appears on:</em>
  1162. <a href="#external-secrets.io/v1alpha1.ExternalSecretData">ExternalSecretData</a>,
  1163. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec</a>)
  1164. </p>
  1165. <p>
  1166. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  1167. </p>
  1168. <table>
  1169. <thead>
  1170. <tr>
  1171. <th>Field</th>
  1172. <th>Description</th>
  1173. </tr>
  1174. </thead>
  1175. <tbody>
  1176. <tr>
  1177. <td>
  1178. <code>key</code></br>
  1179. <em>
  1180. string
  1181. </em>
  1182. </td>
  1183. <td>
  1184. <p>Key is the key used in the Provider, mandatory</p>
  1185. </td>
  1186. </tr>
  1187. <tr>
  1188. <td>
  1189. <code>version</code></br>
  1190. <em>
  1191. string
  1192. </em>
  1193. </td>
  1194. <td>
  1195. <em>(Optional)</em>
  1196. <p>Used to select a specific version of the Provider value, if supported</p>
  1197. </td>
  1198. </tr>
  1199. <tr>
  1200. <td>
  1201. <code>property</code></br>
  1202. <em>
  1203. string
  1204. </em>
  1205. </td>
  1206. <td>
  1207. <em>(Optional)</em>
  1208. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  1209. </td>
  1210. </tr>
  1211. </tbody>
  1212. </table>
  1213. <h3 id="external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec
  1214. </h3>
  1215. <p>
  1216. (<em>Appears on:</em>
  1217. <a href="#external-secrets.io/v1alpha1.ExternalSecret">ExternalSecret</a>)
  1218. </p>
  1219. <p>
  1220. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  1221. </p>
  1222. <table>
  1223. <thead>
  1224. <tr>
  1225. <th>Field</th>
  1226. <th>Description</th>
  1227. </tr>
  1228. </thead>
  1229. <tbody>
  1230. <tr>
  1231. <td>
  1232. <code>secretStoreRef</code></br>
  1233. <em>
  1234. <a href="#external-secrets.io/v1alpha1.SecretStoreRef">
  1235. SecretStoreRef
  1236. </a>
  1237. </em>
  1238. </td>
  1239. <td>
  1240. </td>
  1241. </tr>
  1242. <tr>
  1243. <td>
  1244. <code>target</code></br>
  1245. <em>
  1246. <a href="#external-secrets.io/v1alpha1.ExternalSecretTarget">
  1247. ExternalSecretTarget
  1248. </a>
  1249. </em>
  1250. </td>
  1251. <td>
  1252. </td>
  1253. </tr>
  1254. <tr>
  1255. <td>
  1256. <code>refreshInterval</code></br>
  1257. <em>
  1258. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#duration-v1-meta">
  1259. Kubernetes meta/v1.Duration
  1260. </a>
  1261. </em>
  1262. </td>
  1263. <td>
  1264. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider
  1265. 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;
  1266. May be set to zero to fetch and create it once. Defaults to 1h.</p>
  1267. </td>
  1268. </tr>
  1269. <tr>
  1270. <td>
  1271. <code>data</code></br>
  1272. <em>
  1273. <a href="#external-secrets.io/v1alpha1.ExternalSecretData">
  1274. []ExternalSecretData
  1275. </a>
  1276. </em>
  1277. </td>
  1278. <td>
  1279. <em>(Optional)</em>
  1280. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  1281. </td>
  1282. </tr>
  1283. <tr>
  1284. <td>
  1285. <code>dataFrom</code></br>
  1286. <em>
  1287. <a href="#external-secrets.io/v1alpha1.ExternalSecretDataRemoteRef">
  1288. []ExternalSecretDataRemoteRef
  1289. </a>
  1290. </em>
  1291. </td>
  1292. <td>
  1293. <em>(Optional)</em>
  1294. <p>DataFrom is used to fetch all properties from a specific Provider data
  1295. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  1296. </td>
  1297. </tr>
  1298. </tbody>
  1299. </table>
  1300. <h3 id="external-secrets.io/v1alpha1.ExternalSecretStatus">ExternalSecretStatus
  1301. </h3>
  1302. <p>
  1303. (<em>Appears on:</em>
  1304. <a href="#external-secrets.io/v1alpha1.ExternalSecret">ExternalSecret</a>)
  1305. </p>
  1306. <p>
  1307. </p>
  1308. <table>
  1309. <thead>
  1310. <tr>
  1311. <th>Field</th>
  1312. <th>Description</th>
  1313. </tr>
  1314. </thead>
  1315. <tbody>
  1316. <tr>
  1317. <td>
  1318. <code>refreshTime</code></br>
  1319. <em>
  1320. <a href="https://godoc.org/k8s.io/apimachinery/pkg/apis/meta/v1#Time">
  1321. Kubernetes meta/v1.Time
  1322. </a>
  1323. </em>
  1324. </td>
  1325. <td>
  1326. <p>refreshTime is the time and date the external secret was fetched and
  1327. the target secret updated</p>
  1328. </td>
  1329. </tr>
  1330. <tr>
  1331. <td>
  1332. <code>syncedResourceVersion</code></br>
  1333. <em>
  1334. string
  1335. </em>
  1336. </td>
  1337. <td>
  1338. <p>SyncedResourceVersion keeps track of the last synced version</p>
  1339. </td>
  1340. </tr>
  1341. <tr>
  1342. <td>
  1343. <code>conditions</code></br>
  1344. <em>
  1345. <a href="#external-secrets.io/v1alpha1.ExternalSecretStatusCondition">
  1346. []ExternalSecretStatusCondition
  1347. </a>
  1348. </em>
  1349. </td>
  1350. <td>
  1351. <em>(Optional)</em>
  1352. </td>
  1353. </tr>
  1354. </tbody>
  1355. </table>
  1356. <h3 id="external-secrets.io/v1alpha1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  1357. </h3>
  1358. <p>
  1359. (<em>Appears on:</em>
  1360. <a href="#external-secrets.io/v1alpha1.ExternalSecretStatus">ExternalSecretStatus</a>)
  1361. </p>
  1362. <p>
  1363. </p>
  1364. <table>
  1365. <thead>
  1366. <tr>
  1367. <th>Field</th>
  1368. <th>Description</th>
  1369. </tr>
  1370. </thead>
  1371. <tbody>
  1372. <tr>
  1373. <td>
  1374. <code>type</code></br>
  1375. <em>
  1376. <a href="#external-secrets.io/v1alpha1.ExternalSecretConditionType">
  1377. ExternalSecretConditionType
  1378. </a>
  1379. </em>
  1380. </td>
  1381. <td>
  1382. </td>
  1383. </tr>
  1384. <tr>
  1385. <td>
  1386. <code>status</code></br>
  1387. <em>
  1388. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#conditionstatus-v1-core">
  1389. Kubernetes core/v1.ConditionStatus
  1390. </a>
  1391. </em>
  1392. </td>
  1393. <td>
  1394. </td>
  1395. </tr>
  1396. <tr>
  1397. <td>
  1398. <code>reason</code></br>
  1399. <em>
  1400. string
  1401. </em>
  1402. </td>
  1403. <td>
  1404. <em>(Optional)</em>
  1405. </td>
  1406. </tr>
  1407. <tr>
  1408. <td>
  1409. <code>message</code></br>
  1410. <em>
  1411. string
  1412. </em>
  1413. </td>
  1414. <td>
  1415. <em>(Optional)</em>
  1416. </td>
  1417. </tr>
  1418. <tr>
  1419. <td>
  1420. <code>lastTransitionTime</code></br>
  1421. <em>
  1422. <a href="https://godoc.org/k8s.io/apimachinery/pkg/apis/meta/v1#Time">
  1423. Kubernetes meta/v1.Time
  1424. </a>
  1425. </em>
  1426. </td>
  1427. <td>
  1428. <em>(Optional)</em>
  1429. </td>
  1430. </tr>
  1431. </tbody>
  1432. </table>
  1433. <h3 id="external-secrets.io/v1alpha1.ExternalSecretTarget">ExternalSecretTarget
  1434. </h3>
  1435. <p>
  1436. (<em>Appears on:</em>
  1437. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec</a>)
  1438. </p>
  1439. <p>
  1440. <p>ExternalSecretTarget defines the Kubernetes Secret to be created
  1441. There can be only one target per ExternalSecret.</p>
  1442. </p>
  1443. <table>
  1444. <thead>
  1445. <tr>
  1446. <th>Field</th>
  1447. <th>Description</th>
  1448. </tr>
  1449. </thead>
  1450. <tbody>
  1451. <tr>
  1452. <td>
  1453. <code>name</code></br>
  1454. <em>
  1455. string
  1456. </em>
  1457. </td>
  1458. <td>
  1459. <em>(Optional)</em>
  1460. <p>Name defines the name of the Secret resource to be managed
  1461. This field is immutable
  1462. Defaults to the .metadata.name of the ExternalSecret resource</p>
  1463. </td>
  1464. </tr>
  1465. <tr>
  1466. <td>
  1467. <code>creationPolicy</code></br>
  1468. <em>
  1469. <a href="#external-secrets.io/v1alpha1.ExternalSecretCreationPolicy">
  1470. ExternalSecretCreationPolicy
  1471. </a>
  1472. </em>
  1473. </td>
  1474. <td>
  1475. <em>(Optional)</em>
  1476. <p>CreationPolicy defines rules on how to create the resulting Secret
  1477. Defaults to &lsquo;Owner&rsquo;</p>
  1478. </td>
  1479. </tr>
  1480. <tr>
  1481. <td>
  1482. <code>template</code></br>
  1483. <em>
  1484. <a href="#external-secrets.io/v1alpha1.ExternalSecretTemplate">
  1485. ExternalSecretTemplate
  1486. </a>
  1487. </em>
  1488. </td>
  1489. <td>
  1490. <em>(Optional)</em>
  1491. <p>Template defines a blueprint for the created Secret resource.</p>
  1492. </td>
  1493. </tr>
  1494. </tbody>
  1495. </table>
  1496. <h3 id="external-secrets.io/v1alpha1.ExternalSecretTemplate">ExternalSecretTemplate
  1497. </h3>
  1498. <p>
  1499. (<em>Appears on:</em>
  1500. <a href="#external-secrets.io/v1alpha1.ExternalSecretTarget">ExternalSecretTarget</a>)
  1501. </p>
  1502. <p>
  1503. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  1504. 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>
  1505. </p>
  1506. <table>
  1507. <thead>
  1508. <tr>
  1509. <th>Field</th>
  1510. <th>Description</th>
  1511. </tr>
  1512. </thead>
  1513. <tbody>
  1514. <tr>
  1515. <td>
  1516. <code>type</code></br>
  1517. <em>
  1518. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#secrettype-v1-core">
  1519. Kubernetes core/v1.SecretType
  1520. </a>
  1521. </em>
  1522. </td>
  1523. <td>
  1524. <em>(Optional)</em>
  1525. </td>
  1526. </tr>
  1527. <tr>
  1528. <td>
  1529. <code>metadata</code></br>
  1530. <em>
  1531. <a href="#external-secrets.io/v1alpha1.ExternalSecretTemplateMetadata">
  1532. ExternalSecretTemplateMetadata
  1533. </a>
  1534. </em>
  1535. </td>
  1536. <td>
  1537. <em>(Optional)</em>
  1538. </td>
  1539. </tr>
  1540. <tr>
  1541. <td>
  1542. <code>data</code></br>
  1543. <em>
  1544. map[string]string
  1545. </em>
  1546. </td>
  1547. <td>
  1548. <em>(Optional)</em>
  1549. </td>
  1550. </tr>
  1551. <tr>
  1552. <td>
  1553. <code>templateFrom</code></br>
  1554. <em>
  1555. <a href="#external-secrets.io/v1alpha1.TemplateFrom">
  1556. []TemplateFrom
  1557. </a>
  1558. </em>
  1559. </td>
  1560. <td>
  1561. <em>(Optional)</em>
  1562. </td>
  1563. </tr>
  1564. </tbody>
  1565. </table>
  1566. <h3 id="external-secrets.io/v1alpha1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  1567. </h3>
  1568. <p>
  1569. (<em>Appears on:</em>
  1570. <a href="#external-secrets.io/v1alpha1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  1571. </p>
  1572. <p>
  1573. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  1574. </p>
  1575. <table>
  1576. <thead>
  1577. <tr>
  1578. <th>Field</th>
  1579. <th>Description</th>
  1580. </tr>
  1581. </thead>
  1582. <tbody>
  1583. <tr>
  1584. <td>
  1585. <code>annotations</code></br>
  1586. <em>
  1587. map[string]string
  1588. </em>
  1589. </td>
  1590. <td>
  1591. <em>(Optional)</em>
  1592. </td>
  1593. </tr>
  1594. <tr>
  1595. <td>
  1596. <code>labels</code></br>
  1597. <em>
  1598. map[string]string
  1599. </em>
  1600. </td>
  1601. <td>
  1602. <em>(Optional)</em>
  1603. </td>
  1604. </tr>
  1605. </tbody>
  1606. </table>
  1607. <h3 id="external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth
  1608. </h3>
  1609. <p>
  1610. (<em>Appears on:</em>
  1611. <a href="#external-secrets.io/v1alpha1.GCPSMProvider">GCPSMProvider</a>)
  1612. </p>
  1613. <p>
  1614. </p>
  1615. <table>
  1616. <thead>
  1617. <tr>
  1618. <th>Field</th>
  1619. <th>Description</th>
  1620. </tr>
  1621. </thead>
  1622. <tbody>
  1623. <tr>
  1624. <td>
  1625. <code>secretRef</code></br>
  1626. <em>
  1627. <a href="#external-secrets.io/v1alpha1.GCPSMAuthSecretRef">
  1628. GCPSMAuthSecretRef
  1629. </a>
  1630. </em>
  1631. </td>
  1632. <td>
  1633. </td>
  1634. </tr>
  1635. </tbody>
  1636. </table>
  1637. <h3 id="external-secrets.io/v1alpha1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  1638. </h3>
  1639. <p>
  1640. (<em>Appears on:</em>
  1641. <a href="#external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  1642. </p>
  1643. <p>
  1644. </p>
  1645. <table>
  1646. <thead>
  1647. <tr>
  1648. <th>Field</th>
  1649. <th>Description</th>
  1650. </tr>
  1651. </thead>
  1652. <tbody>
  1653. <tr>
  1654. <td>
  1655. <code>secretAccessKeySecretRef</code></br>
  1656. <em>
  1657. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  1658. </em>
  1659. </td>
  1660. <td>
  1661. <em>(Optional)</em>
  1662. <p>The SecretAccessKey is used for authentication</p>
  1663. </td>
  1664. </tr>
  1665. </tbody>
  1666. </table>
  1667. <h3 id="external-secrets.io/v1alpha1.GCPSMProvider">GCPSMProvider
  1668. </h3>
  1669. <p>
  1670. (<em>Appears on:</em>
  1671. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  1672. </p>
  1673. <p>
  1674. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  1675. </p>
  1676. <table>
  1677. <thead>
  1678. <tr>
  1679. <th>Field</th>
  1680. <th>Description</th>
  1681. </tr>
  1682. </thead>
  1683. <tbody>
  1684. <tr>
  1685. <td>
  1686. <code>auth</code></br>
  1687. <em>
  1688. <a href="#external-secrets.io/v1alpha1.GCPSMAuth">
  1689. GCPSMAuth
  1690. </a>
  1691. </em>
  1692. </td>
  1693. <td>
  1694. <em>(Optional)</em>
  1695. <p>Auth defines the information necessary to authenticate against GCP</p>
  1696. </td>
  1697. </tr>
  1698. <tr>
  1699. <td>
  1700. <code>projectID</code></br>
  1701. <em>
  1702. string
  1703. </em>
  1704. </td>
  1705. <td>
  1706. <p>ProjectID project where secret is located</p>
  1707. </td>
  1708. </tr>
  1709. </tbody>
  1710. </table>
  1711. <h3 id="external-secrets.io/v1alpha1.GenericStore">GenericStore
  1712. </h3>
  1713. <p>
  1714. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  1715. or a namespaced SecretStore.</p>
  1716. </p>
  1717. <h3 id="external-secrets.io/v1alpha1.GitlabAuth">GitlabAuth
  1718. </h3>
  1719. <p>
  1720. (<em>Appears on:</em>
  1721. <a href="#external-secrets.io/v1alpha1.GitlabProvider">GitlabProvider</a>)
  1722. </p>
  1723. <p>
  1724. </p>
  1725. <table>
  1726. <thead>
  1727. <tr>
  1728. <th>Field</th>
  1729. <th>Description</th>
  1730. </tr>
  1731. </thead>
  1732. <tbody>
  1733. <tr>
  1734. <td>
  1735. <code>SecretRef</code></br>
  1736. <em>
  1737. <a href="#external-secrets.io/v1alpha1.GitlabSecretRef">
  1738. GitlabSecretRef
  1739. </a>
  1740. </em>
  1741. </td>
  1742. <td>
  1743. </td>
  1744. </tr>
  1745. </tbody>
  1746. </table>
  1747. <h3 id="external-secrets.io/v1alpha1.GitlabProvider">GitlabProvider
  1748. </h3>
  1749. <p>
  1750. (<em>Appears on:</em>
  1751. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  1752. </p>
  1753. <p>
  1754. <p>Configures a store to sync secrets with a GitLab instance.</p>
  1755. </p>
  1756. <table>
  1757. <thead>
  1758. <tr>
  1759. <th>Field</th>
  1760. <th>Description</th>
  1761. </tr>
  1762. </thead>
  1763. <tbody>
  1764. <tr>
  1765. <td>
  1766. <code>url</code></br>
  1767. <em>
  1768. string
  1769. </em>
  1770. </td>
  1771. <td>
  1772. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  1773. </td>
  1774. </tr>
  1775. <tr>
  1776. <td>
  1777. <code>auth</code></br>
  1778. <em>
  1779. <a href="#external-secrets.io/v1alpha1.GitlabAuth">
  1780. GitlabAuth
  1781. </a>
  1782. </em>
  1783. </td>
  1784. <td>
  1785. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  1786. </td>
  1787. </tr>
  1788. <tr>
  1789. <td>
  1790. <code>projectID</code></br>
  1791. <em>
  1792. string
  1793. </em>
  1794. </td>
  1795. <td>
  1796. <p>ProjectID specifies a project where secrets are located.</p>
  1797. </td>
  1798. </tr>
  1799. </tbody>
  1800. </table>
  1801. <h3 id="external-secrets.io/v1alpha1.GitlabSecretRef">GitlabSecretRef
  1802. </h3>
  1803. <p>
  1804. (<em>Appears on:</em>
  1805. <a href="#external-secrets.io/v1alpha1.GitlabAuth">GitlabAuth</a>)
  1806. </p>
  1807. <p>
  1808. </p>
  1809. <table>
  1810. <thead>
  1811. <tr>
  1812. <th>Field</th>
  1813. <th>Description</th>
  1814. </tr>
  1815. </thead>
  1816. <tbody>
  1817. <tr>
  1818. <td>
  1819. <code>accessToken</code></br>
  1820. <em>
  1821. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  1822. </em>
  1823. </td>
  1824. <td>
  1825. <p>AccessToken is used for authentication.</p>
  1826. </td>
  1827. </tr>
  1828. </tbody>
  1829. </table>
  1830. <h3 id="external-secrets.io/v1alpha1.IBMAuth">IBMAuth
  1831. </h3>
  1832. <p>
  1833. (<em>Appears on:</em>
  1834. <a href="#external-secrets.io/v1alpha1.IBMProvider">IBMProvider</a>)
  1835. </p>
  1836. <p>
  1837. </p>
  1838. <table>
  1839. <thead>
  1840. <tr>
  1841. <th>Field</th>
  1842. <th>Description</th>
  1843. </tr>
  1844. </thead>
  1845. <tbody>
  1846. <tr>
  1847. <td>
  1848. <code>secretRef</code></br>
  1849. <em>
  1850. <a href="#external-secrets.io/v1alpha1.IBMAuthSecretRef">
  1851. IBMAuthSecretRef
  1852. </a>
  1853. </em>
  1854. </td>
  1855. <td>
  1856. </td>
  1857. </tr>
  1858. </tbody>
  1859. </table>
  1860. <h3 id="external-secrets.io/v1alpha1.IBMAuthSecretRef">IBMAuthSecretRef
  1861. </h3>
  1862. <p>
  1863. (<em>Appears on:</em>
  1864. <a href="#external-secrets.io/v1alpha1.IBMAuth">IBMAuth</a>)
  1865. </p>
  1866. <p>
  1867. </p>
  1868. <table>
  1869. <thead>
  1870. <tr>
  1871. <th>Field</th>
  1872. <th>Description</th>
  1873. </tr>
  1874. </thead>
  1875. <tbody>
  1876. <tr>
  1877. <td>
  1878. <code>secretApiKeySecretRef</code></br>
  1879. <em>
  1880. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  1881. </em>
  1882. </td>
  1883. <td>
  1884. <em>(Optional)</em>
  1885. <p>The SecretAccessKey is used for authentication</p>
  1886. </td>
  1887. </tr>
  1888. </tbody>
  1889. </table>
  1890. <h3 id="external-secrets.io/v1alpha1.IBMProvider">IBMProvider
  1891. </h3>
  1892. <p>
  1893. (<em>Appears on:</em>
  1894. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  1895. </p>
  1896. <p>
  1897. <p>Configures an store to sync secrets using a IBM Cloud Secrets Manager
  1898. backend.</p>
  1899. </p>
  1900. <table>
  1901. <thead>
  1902. <tr>
  1903. <th>Field</th>
  1904. <th>Description</th>
  1905. </tr>
  1906. </thead>
  1907. <tbody>
  1908. <tr>
  1909. <td>
  1910. <code>auth</code></br>
  1911. <em>
  1912. <a href="#external-secrets.io/v1alpha1.IBMAuth">
  1913. IBMAuth
  1914. </a>
  1915. </em>
  1916. </td>
  1917. <td>
  1918. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  1919. </td>
  1920. </tr>
  1921. <tr>
  1922. <td>
  1923. <code>serviceUrl</code></br>
  1924. <em>
  1925. string
  1926. </em>
  1927. </td>
  1928. <td>
  1929. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  1930. </td>
  1931. </tr>
  1932. </tbody>
  1933. </table>
  1934. <h3 id="external-secrets.io/v1alpha1.SecretStore">SecretStore
  1935. </h3>
  1936. <p>
  1937. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  1938. </p>
  1939. <table>
  1940. <thead>
  1941. <tr>
  1942. <th>Field</th>
  1943. <th>Description</th>
  1944. </tr>
  1945. </thead>
  1946. <tbody>
  1947. <tr>
  1948. <td>
  1949. <code>metadata</code></br>
  1950. <em>
  1951. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#objectmeta-v1-meta">
  1952. Kubernetes meta/v1.ObjectMeta
  1953. </a>
  1954. </em>
  1955. </td>
  1956. <td>
  1957. Refer to the Kubernetes API documentation for the fields of the
  1958. <code>metadata</code> field.
  1959. </td>
  1960. </tr>
  1961. <tr>
  1962. <td>
  1963. <code>spec</code></br>
  1964. <em>
  1965. <a href="#external-secrets.io/v1alpha1.SecretStoreSpec">
  1966. SecretStoreSpec
  1967. </a>
  1968. </em>
  1969. </td>
  1970. <td>
  1971. <br/>
  1972. <br/>
  1973. <table>
  1974. <tr>
  1975. <td>
  1976. <code>controller</code></br>
  1977. <em>
  1978. string
  1979. </em>
  1980. </td>
  1981. <td>
  1982. <em>(Optional)</em>
  1983. <p>Used to select the correct KES controller (think: ingress.ingressClassName)
  1984. The KES controller is instantiated with a specific controller name and filters ES based on this property</p>
  1985. </td>
  1986. </tr>
  1987. <tr>
  1988. <td>
  1989. <code>provider</code></br>
  1990. <em>
  1991. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">
  1992. SecretStoreProvider
  1993. </a>
  1994. </em>
  1995. </td>
  1996. <td>
  1997. <p>Used to configure the provider. Only one provider may be set</p>
  1998. </td>
  1999. </tr>
  2000. </table>
  2001. </td>
  2002. </tr>
  2003. <tr>
  2004. <td>
  2005. <code>status</code></br>
  2006. <em>
  2007. <a href="#external-secrets.io/v1alpha1.SecretStoreStatus">
  2008. SecretStoreStatus
  2009. </a>
  2010. </em>
  2011. </td>
  2012. <td>
  2013. </td>
  2014. </tr>
  2015. </tbody>
  2016. </table>
  2017. <h3 id="external-secrets.io/v1alpha1.SecretStoreConditionType">SecretStoreConditionType
  2018. (<code>string</code> alias)</p></h3>
  2019. <p>
  2020. (<em>Appears on:</em>
  2021. <a href="#external-secrets.io/v1alpha1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  2022. </p>
  2023. <p>
  2024. </p>
  2025. <table>
  2026. <thead>
  2027. <tr>
  2028. <th>Value</th>
  2029. <th>Description</th>
  2030. </tr>
  2031. </thead>
  2032. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  2033. <td></td>
  2034. </tr></tbody>
  2035. </table>
  2036. <h3 id="external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider
  2037. </h3>
  2038. <p>
  2039. (<em>Appears on:</em>
  2040. <a href="#external-secrets.io/v1alpha1.SecretStoreSpec">SecretStoreSpec</a>)
  2041. </p>
  2042. <p>
  2043. <p>SecretStoreProvider contains the provider-specific configration.</p>
  2044. </p>
  2045. <table>
  2046. <thead>
  2047. <tr>
  2048. <th>Field</th>
  2049. <th>Description</th>
  2050. </tr>
  2051. </thead>
  2052. <tbody>
  2053. <tr>
  2054. <td>
  2055. <code>aws</code></br>
  2056. <em>
  2057. <a href="#external-secrets.io/v1alpha1.AWSProvider">
  2058. AWSProvider
  2059. </a>
  2060. </em>
  2061. </td>
  2062. <td>
  2063. <em>(Optional)</em>
  2064. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  2065. </td>
  2066. </tr>
  2067. <tr>
  2068. <td>
  2069. <code>azurekv</code></br>
  2070. <em>
  2071. <a href="#external-secrets.io/v1alpha1.AzureKVProvider">
  2072. AzureKVProvider
  2073. </a>
  2074. </em>
  2075. </td>
  2076. <td>
  2077. <em>(Optional)</em>
  2078. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  2079. </td>
  2080. </tr>
  2081. <tr>
  2082. <td>
  2083. <code>vault</code></br>
  2084. <em>
  2085. <a href="#external-secrets.io/v1alpha1.VaultProvider">
  2086. VaultProvider
  2087. </a>
  2088. </em>
  2089. </td>
  2090. <td>
  2091. <em>(Optional)</em>
  2092. <p>Vault configures this store to sync secrets using Hashi provider</p>
  2093. </td>
  2094. </tr>
  2095. <tr>
  2096. <td>
  2097. <code>gcpsm</code></br>
  2098. <em>
  2099. <a href="#external-secrets.io/v1alpha1.GCPSMProvider">
  2100. GCPSMProvider
  2101. </a>
  2102. </em>
  2103. </td>
  2104. <td>
  2105. <em>(Optional)</em>
  2106. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  2107. </td>
  2108. </tr>
  2109. <tr>
  2110. <td>
  2111. <code>ibm</code></br>
  2112. <em>
  2113. <a href="#external-secrets.io/v1alpha1.IBMProvider">
  2114. IBMProvider
  2115. </a>
  2116. </em>
  2117. </td>
  2118. <td>
  2119. <em>(Optional)</em>
  2120. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  2121. </td>
  2122. </tr>
  2123. <tr>
  2124. <td>
  2125. <code>yandexlockbox</code></br>
  2126. <em>
  2127. <a href="#external-secrets.io/v1alpha1.YandexLockboxProvider">
  2128. YandexLockboxProvider
  2129. </a>
  2130. </em>
  2131. </td>
  2132. <td>
  2133. <em>(Optional)</em>
  2134. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  2135. </td>
  2136. </tr>
  2137. <tr>
  2138. <td>
  2139. <code>gitlab</code></br>
  2140. <em>
  2141. <a href="#external-secrets.io/v1alpha1.GitlabProvider">
  2142. GitlabProvider
  2143. </a>
  2144. </em>
  2145. </td>
  2146. <td>
  2147. <em>(Optional)</em>
  2148. <p>GItlab configures this store to sync secrets using Gitlab Variables provider</p>
  2149. </td>
  2150. </tr>
  2151. <tr>
  2152. <td>
  2153. <code>alibaba</code></br>
  2154. <em>
  2155. <a href="#external-secrets.io/v1alpha1.AlibabaProvider">
  2156. AlibabaProvider
  2157. </a>
  2158. </em>
  2159. </td>
  2160. <td>
  2161. <em>(Optional)</em>
  2162. <p>Alibaba configures this store to sync secrets using Alibaba Cloud provider</p>
  2163. </td>
  2164. </tr>
  2165. </tbody>
  2166. </table>
  2167. <h3 id="external-secrets.io/v1alpha1.SecretStoreRef">SecretStoreRef
  2168. </h3>
  2169. <p>
  2170. (<em>Appears on:</em>
  2171. <a href="#external-secrets.io/v1alpha1.ExternalSecretSpec">ExternalSecretSpec</a>)
  2172. </p>
  2173. <p>
  2174. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  2175. </p>
  2176. <table>
  2177. <thead>
  2178. <tr>
  2179. <th>Field</th>
  2180. <th>Description</th>
  2181. </tr>
  2182. </thead>
  2183. <tbody>
  2184. <tr>
  2185. <td>
  2186. <code>name</code></br>
  2187. <em>
  2188. string
  2189. </em>
  2190. </td>
  2191. <td>
  2192. <p>Name of the SecretStore resource</p>
  2193. </td>
  2194. </tr>
  2195. <tr>
  2196. <td>
  2197. <code>kind</code></br>
  2198. <em>
  2199. string
  2200. </em>
  2201. </td>
  2202. <td>
  2203. <em>(Optional)</em>
  2204. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  2205. Defaults to <code>SecretStore</code></p>
  2206. </td>
  2207. </tr>
  2208. </tbody>
  2209. </table>
  2210. <h3 id="external-secrets.io/v1alpha1.SecretStoreSpec">SecretStoreSpec
  2211. </h3>
  2212. <p>
  2213. (<em>Appears on:</em>
  2214. <a href="#external-secrets.io/v1alpha1.ClusterSecretStore">ClusterSecretStore</a>,
  2215. <a href="#external-secrets.io/v1alpha1.SecretStore">SecretStore</a>)
  2216. </p>
  2217. <p>
  2218. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  2219. </p>
  2220. <table>
  2221. <thead>
  2222. <tr>
  2223. <th>Field</th>
  2224. <th>Description</th>
  2225. </tr>
  2226. </thead>
  2227. <tbody>
  2228. <tr>
  2229. <td>
  2230. <code>controller</code></br>
  2231. <em>
  2232. string
  2233. </em>
  2234. </td>
  2235. <td>
  2236. <em>(Optional)</em>
  2237. <p>Used to select the correct KES controller (think: ingress.ingressClassName)
  2238. The KES controller is instantiated with a specific controller name and filters ES based on this property</p>
  2239. </td>
  2240. </tr>
  2241. <tr>
  2242. <td>
  2243. <code>provider</code></br>
  2244. <em>
  2245. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">
  2246. SecretStoreProvider
  2247. </a>
  2248. </em>
  2249. </td>
  2250. <td>
  2251. <p>Used to configure the provider. Only one provider may be set</p>
  2252. </td>
  2253. </tr>
  2254. </tbody>
  2255. </table>
  2256. <h3 id="external-secrets.io/v1alpha1.SecretStoreStatus">SecretStoreStatus
  2257. </h3>
  2258. <p>
  2259. (<em>Appears on:</em>
  2260. <a href="#external-secrets.io/v1alpha1.ClusterSecretStore">ClusterSecretStore</a>,
  2261. <a href="#external-secrets.io/v1alpha1.SecretStore">SecretStore</a>)
  2262. </p>
  2263. <p>
  2264. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  2265. </p>
  2266. <table>
  2267. <thead>
  2268. <tr>
  2269. <th>Field</th>
  2270. <th>Description</th>
  2271. </tr>
  2272. </thead>
  2273. <tbody>
  2274. <tr>
  2275. <td>
  2276. <code>conditions</code></br>
  2277. <em>
  2278. <a href="#external-secrets.io/v1alpha1.SecretStoreStatusCondition">
  2279. []SecretStoreStatusCondition
  2280. </a>
  2281. </em>
  2282. </td>
  2283. <td>
  2284. <em>(Optional)</em>
  2285. </td>
  2286. </tr>
  2287. </tbody>
  2288. </table>
  2289. <h3 id="external-secrets.io/v1alpha1.SecretStoreStatusCondition">SecretStoreStatusCondition
  2290. </h3>
  2291. <p>
  2292. (<em>Appears on:</em>
  2293. <a href="#external-secrets.io/v1alpha1.SecretStoreStatus">SecretStoreStatus</a>)
  2294. </p>
  2295. <p>
  2296. </p>
  2297. <table>
  2298. <thead>
  2299. <tr>
  2300. <th>Field</th>
  2301. <th>Description</th>
  2302. </tr>
  2303. </thead>
  2304. <tbody>
  2305. <tr>
  2306. <td>
  2307. <code>type</code></br>
  2308. <em>
  2309. <a href="#external-secrets.io/v1alpha1.SecretStoreConditionType">
  2310. SecretStoreConditionType
  2311. </a>
  2312. </em>
  2313. </td>
  2314. <td>
  2315. </td>
  2316. </tr>
  2317. <tr>
  2318. <td>
  2319. <code>status</code></br>
  2320. <em>
  2321. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#conditionstatus-v1-core">
  2322. Kubernetes core/v1.ConditionStatus
  2323. </a>
  2324. </em>
  2325. </td>
  2326. <td>
  2327. </td>
  2328. </tr>
  2329. <tr>
  2330. <td>
  2331. <code>reason</code></br>
  2332. <em>
  2333. string
  2334. </em>
  2335. </td>
  2336. <td>
  2337. <em>(Optional)</em>
  2338. </td>
  2339. </tr>
  2340. <tr>
  2341. <td>
  2342. <code>message</code></br>
  2343. <em>
  2344. string
  2345. </em>
  2346. </td>
  2347. <td>
  2348. <em>(Optional)</em>
  2349. </td>
  2350. </tr>
  2351. <tr>
  2352. <td>
  2353. <code>lastTransitionTime</code></br>
  2354. <em>
  2355. <a href="https://godoc.org/k8s.io/apimachinery/pkg/apis/meta/v1#Time">
  2356. Kubernetes meta/v1.Time
  2357. </a>
  2358. </em>
  2359. </td>
  2360. <td>
  2361. <em>(Optional)</em>
  2362. </td>
  2363. </tr>
  2364. </tbody>
  2365. </table>
  2366. <h3 id="external-secrets.io/v1alpha1.TemplateFrom">TemplateFrom
  2367. </h3>
  2368. <p>
  2369. (<em>Appears on:</em>
  2370. <a href="#external-secrets.io/v1alpha1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  2371. </p>
  2372. <p>
  2373. </p>
  2374. <table>
  2375. <thead>
  2376. <tr>
  2377. <th>Field</th>
  2378. <th>Description</th>
  2379. </tr>
  2380. </thead>
  2381. <tbody>
  2382. <tr>
  2383. <td>
  2384. <code>configMap</code></br>
  2385. <em>
  2386. <a href="#external-secrets.io/v1alpha1.TemplateRef">
  2387. TemplateRef
  2388. </a>
  2389. </em>
  2390. </td>
  2391. <td>
  2392. </td>
  2393. </tr>
  2394. <tr>
  2395. <td>
  2396. <code>secret</code></br>
  2397. <em>
  2398. <a href="#external-secrets.io/v1alpha1.TemplateRef">
  2399. TemplateRef
  2400. </a>
  2401. </em>
  2402. </td>
  2403. <td>
  2404. </td>
  2405. </tr>
  2406. </tbody>
  2407. </table>
  2408. <h3 id="external-secrets.io/v1alpha1.TemplateRef">TemplateRef
  2409. </h3>
  2410. <p>
  2411. (<em>Appears on:</em>
  2412. <a href="#external-secrets.io/v1alpha1.TemplateFrom">TemplateFrom</a>)
  2413. </p>
  2414. <p>
  2415. </p>
  2416. <table>
  2417. <thead>
  2418. <tr>
  2419. <th>Field</th>
  2420. <th>Description</th>
  2421. </tr>
  2422. </thead>
  2423. <tbody>
  2424. <tr>
  2425. <td>
  2426. <code>name</code></br>
  2427. <em>
  2428. string
  2429. </em>
  2430. </td>
  2431. <td>
  2432. </td>
  2433. </tr>
  2434. <tr>
  2435. <td>
  2436. <code>items</code></br>
  2437. <em>
  2438. <a href="#external-secrets.io/v1alpha1.TemplateRefItem">
  2439. []TemplateRefItem
  2440. </a>
  2441. </em>
  2442. </td>
  2443. <td>
  2444. </td>
  2445. </tr>
  2446. </tbody>
  2447. </table>
  2448. <h3 id="external-secrets.io/v1alpha1.TemplateRefItem">TemplateRefItem
  2449. </h3>
  2450. <p>
  2451. (<em>Appears on:</em>
  2452. <a href="#external-secrets.io/v1alpha1.TemplateRef">TemplateRef</a>)
  2453. </p>
  2454. <p>
  2455. </p>
  2456. <table>
  2457. <thead>
  2458. <tr>
  2459. <th>Field</th>
  2460. <th>Description</th>
  2461. </tr>
  2462. </thead>
  2463. <tbody>
  2464. <tr>
  2465. <td>
  2466. <code>key</code></br>
  2467. <em>
  2468. string
  2469. </em>
  2470. </td>
  2471. <td>
  2472. </td>
  2473. </tr>
  2474. </tbody>
  2475. </table>
  2476. <h3 id="external-secrets.io/v1alpha1.VaultAppRole">VaultAppRole
  2477. </h3>
  2478. <p>
  2479. (<em>Appears on:</em>
  2480. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  2481. </p>
  2482. <p>
  2483. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  2484. with the role and secret stored in a Kubernetes Secret resource.</p>
  2485. </p>
  2486. <table>
  2487. <thead>
  2488. <tr>
  2489. <th>Field</th>
  2490. <th>Description</th>
  2491. </tr>
  2492. </thead>
  2493. <tbody>
  2494. <tr>
  2495. <td>
  2496. <code>path</code></br>
  2497. <em>
  2498. string
  2499. </em>
  2500. </td>
  2501. <td>
  2502. <p>Path where the App Role authentication backend is mounted
  2503. in Vault, e.g: &ldquo;approle&rdquo;</p>
  2504. </td>
  2505. </tr>
  2506. <tr>
  2507. <td>
  2508. <code>roleId</code></br>
  2509. <em>
  2510. string
  2511. </em>
  2512. </td>
  2513. <td>
  2514. <p>RoleID configured in the App Role authentication backend when setting
  2515. up the authentication backend in Vault.</p>
  2516. </td>
  2517. </tr>
  2518. <tr>
  2519. <td>
  2520. <code>secretRef</code></br>
  2521. <em>
  2522. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2523. </em>
  2524. </td>
  2525. <td>
  2526. <p>Reference to a key in a Secret that contains the App Role secret used
  2527. to authenticate with Vault.
  2528. The <code>key</code> field must be specified and denotes which entry within the Secret
  2529. resource is used as the app role secret.</p>
  2530. </td>
  2531. </tr>
  2532. </tbody>
  2533. </table>
  2534. <h3 id="external-secrets.io/v1alpha1.VaultAuth">VaultAuth
  2535. </h3>
  2536. <p>
  2537. (<em>Appears on:</em>
  2538. <a href="#external-secrets.io/v1alpha1.VaultProvider">VaultProvider</a>)
  2539. </p>
  2540. <p>
  2541. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  2542. Only one of <code>tokenSecretRef</code>, <code>appRole</code>, <code>kubernetes</code>, <code>ldap</code>, <code>jwt</code> or <code>cert</code>
  2543. can be specified.</p>
  2544. </p>
  2545. <table>
  2546. <thead>
  2547. <tr>
  2548. <th>Field</th>
  2549. <th>Description</th>
  2550. </tr>
  2551. </thead>
  2552. <tbody>
  2553. <tr>
  2554. <td>
  2555. <code>tokenSecretRef</code></br>
  2556. <em>
  2557. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2558. </em>
  2559. </td>
  2560. <td>
  2561. <em>(Optional)</em>
  2562. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  2563. </td>
  2564. </tr>
  2565. <tr>
  2566. <td>
  2567. <code>appRole</code></br>
  2568. <em>
  2569. <a href="#external-secrets.io/v1alpha1.VaultAppRole">
  2570. VaultAppRole
  2571. </a>
  2572. </em>
  2573. </td>
  2574. <td>
  2575. <em>(Optional)</em>
  2576. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  2577. with the role and secret stored in a Kubernetes Secret resource.</p>
  2578. </td>
  2579. </tr>
  2580. <tr>
  2581. <td>
  2582. <code>kubernetes</code></br>
  2583. <em>
  2584. <a href="#external-secrets.io/v1alpha1.VaultKubernetesAuth">
  2585. VaultKubernetesAuth
  2586. </a>
  2587. </em>
  2588. </td>
  2589. <td>
  2590. <em>(Optional)</em>
  2591. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  2592. token stored in the named Secret resource to the Vault server.</p>
  2593. </td>
  2594. </tr>
  2595. <tr>
  2596. <td>
  2597. <code>ldap</code></br>
  2598. <em>
  2599. <a href="#external-secrets.io/v1alpha1.VaultLdapAuth">
  2600. VaultLdapAuth
  2601. </a>
  2602. </em>
  2603. </td>
  2604. <td>
  2605. <em>(Optional)</em>
  2606. <p>Ldap authenticates with Vault by passing username/password pair using
  2607. the LDAP authentication method</p>
  2608. </td>
  2609. </tr>
  2610. <tr>
  2611. <td>
  2612. <code>jwt</code></br>
  2613. <em>
  2614. <a href="#external-secrets.io/v1alpha1.VaultJwtAuth">
  2615. VaultJwtAuth
  2616. </a>
  2617. </em>
  2618. </td>
  2619. <td>
  2620. <em>(Optional)</em>
  2621. <p>Jwt authenticates with Vault by passing role and JWT token using the
  2622. JWT/OIDC authentication method</p>
  2623. </td>
  2624. </tr>
  2625. <tr>
  2626. <td>
  2627. <code>cert</code></br>
  2628. <em>
  2629. <a href="#external-secrets.io/v1alpha1.VaultCertAuth">
  2630. VaultCertAuth
  2631. </a>
  2632. </em>
  2633. </td>
  2634. <td>
  2635. <em>(Optional)</em>
  2636. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  2637. Cert authentication method</p>
  2638. </td>
  2639. </tr>
  2640. </tbody>
  2641. </table>
  2642. <h3 id="external-secrets.io/v1alpha1.VaultCertAuth">VaultCertAuth
  2643. </h3>
  2644. <p>
  2645. (<em>Appears on:</em>
  2646. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  2647. </p>
  2648. <p>
  2649. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  2650. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  2651. </p>
  2652. <table>
  2653. <thead>
  2654. <tr>
  2655. <th>Field</th>
  2656. <th>Description</th>
  2657. </tr>
  2658. </thead>
  2659. <tbody>
  2660. <tr>
  2661. <td>
  2662. <code>clientCert</code></br>
  2663. <em>
  2664. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2665. </em>
  2666. </td>
  2667. <td>
  2668. <em>(Optional)</em>
  2669. <p>ClientCert is a certificate to authenticate using the Cert Vault
  2670. authentication method</p>
  2671. </td>
  2672. </tr>
  2673. <tr>
  2674. <td>
  2675. <code>secretRef</code></br>
  2676. <em>
  2677. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2678. </em>
  2679. </td>
  2680. <td>
  2681. <p>SecretRef to a key in a Secret resource containing client private key to
  2682. authenticate with Vault using the Cert authentication method</p>
  2683. </td>
  2684. </tr>
  2685. </tbody>
  2686. </table>
  2687. <h3 id="external-secrets.io/v1alpha1.VaultJwtAuth">VaultJwtAuth
  2688. </h3>
  2689. <p>
  2690. (<em>Appears on:</em>
  2691. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  2692. </p>
  2693. <p>
  2694. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  2695. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  2696. </p>
  2697. <table>
  2698. <thead>
  2699. <tr>
  2700. <th>Field</th>
  2701. <th>Description</th>
  2702. </tr>
  2703. </thead>
  2704. <tbody>
  2705. <tr>
  2706. <td>
  2707. <code>role</code></br>
  2708. <em>
  2709. string
  2710. </em>
  2711. </td>
  2712. <td>
  2713. <em>(Optional)</em>
  2714. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  2715. authentication method</p>
  2716. </td>
  2717. </tr>
  2718. <tr>
  2719. <td>
  2720. <code>secretRef</code></br>
  2721. <em>
  2722. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2723. </em>
  2724. </td>
  2725. <td>
  2726. <p>SecretRef to a key in a Secret resource containing JWT token to
  2727. authenticate with Vault using the JWT/OIDC authentication method</p>
  2728. </td>
  2729. </tr>
  2730. </tbody>
  2731. </table>
  2732. <h3 id="external-secrets.io/v1alpha1.VaultKVStoreVersion">VaultKVStoreVersion
  2733. (<code>string</code> alias)</p></h3>
  2734. <p>
  2735. (<em>Appears on:</em>
  2736. <a href="#external-secrets.io/v1alpha1.VaultProvider">VaultProvider</a>)
  2737. </p>
  2738. <p>
  2739. </p>
  2740. <table>
  2741. <thead>
  2742. <tr>
  2743. <th>Value</th>
  2744. <th>Description</th>
  2745. </tr>
  2746. </thead>
  2747. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  2748. <td></td>
  2749. </tr><tr><td><p>&#34;v2&#34;</p></td>
  2750. <td></td>
  2751. </tr></tbody>
  2752. </table>
  2753. <h3 id="external-secrets.io/v1alpha1.VaultKubernetesAuth">VaultKubernetesAuth
  2754. </h3>
  2755. <p>
  2756. (<em>Appears on:</em>
  2757. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  2758. </p>
  2759. <p>
  2760. <p>Authenticate against Vault using a Kubernetes ServiceAccount token stored in
  2761. a Secret.</p>
  2762. </p>
  2763. <table>
  2764. <thead>
  2765. <tr>
  2766. <th>Field</th>
  2767. <th>Description</th>
  2768. </tr>
  2769. </thead>
  2770. <tbody>
  2771. <tr>
  2772. <td>
  2773. <code>mountPath</code></br>
  2774. <em>
  2775. string
  2776. </em>
  2777. </td>
  2778. <td>
  2779. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  2780. &ldquo;kubernetes&rdquo;</p>
  2781. </td>
  2782. </tr>
  2783. <tr>
  2784. <td>
  2785. <code>serviceAccountRef</code></br>
  2786. <em>
  2787. github.com/external-secrets/external-secrets/apis/meta/v1.ServiceAccountSelector
  2788. </em>
  2789. </td>
  2790. <td>
  2791. <em>(Optional)</em>
  2792. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  2793. If the service account is specified, the service account secret token JWT will be used
  2794. for authenticating with Vault. If the service account selector is not supplied,
  2795. the secretRef will be used instead.</p>
  2796. </td>
  2797. </tr>
  2798. <tr>
  2799. <td>
  2800. <code>secretRef</code></br>
  2801. <em>
  2802. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2803. </em>
  2804. </td>
  2805. <td>
  2806. <em>(Optional)</em>
  2807. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  2808. for authenticating with Vault. If a name is specified without a key,
  2809. <code>token</code> is the default. If one is not specified, the one bound to
  2810. the controller will be used.</p>
  2811. </td>
  2812. </tr>
  2813. <tr>
  2814. <td>
  2815. <code>role</code></br>
  2816. <em>
  2817. string
  2818. </em>
  2819. </td>
  2820. <td>
  2821. <p>A required field containing the Vault Role to assume. A Role binds a
  2822. Kubernetes ServiceAccount with a set of Vault policies.</p>
  2823. </td>
  2824. </tr>
  2825. </tbody>
  2826. </table>
  2827. <h3 id="external-secrets.io/v1alpha1.VaultLdapAuth">VaultLdapAuth
  2828. </h3>
  2829. <p>
  2830. (<em>Appears on:</em>
  2831. <a href="#external-secrets.io/v1alpha1.VaultAuth">VaultAuth</a>)
  2832. </p>
  2833. <p>
  2834. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  2835. with the username and password stored in a Kubernetes Secret resource.</p>
  2836. </p>
  2837. <table>
  2838. <thead>
  2839. <tr>
  2840. <th>Field</th>
  2841. <th>Description</th>
  2842. </tr>
  2843. </thead>
  2844. <tbody>
  2845. <tr>
  2846. <td>
  2847. <code>username</code></br>
  2848. <em>
  2849. string
  2850. </em>
  2851. </td>
  2852. <td>
  2853. <p>Username is a LDAP user name used to authenticate using the LDAP Vault
  2854. authentication method</p>
  2855. </td>
  2856. </tr>
  2857. <tr>
  2858. <td>
  2859. <code>secretRef</code></br>
  2860. <em>
  2861. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2862. </em>
  2863. </td>
  2864. <td>
  2865. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  2866. user used to authenticate with Vault using the LDAP authentication
  2867. method</p>
  2868. </td>
  2869. </tr>
  2870. </tbody>
  2871. </table>
  2872. <h3 id="external-secrets.io/v1alpha1.VaultProvider">VaultProvider
  2873. </h3>
  2874. <p>
  2875. (<em>Appears on:</em>
  2876. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  2877. </p>
  2878. <p>
  2879. <p>Configures an store to sync secrets using a HashiCorp Vault
  2880. KV backend.</p>
  2881. </p>
  2882. <table>
  2883. <thead>
  2884. <tr>
  2885. <th>Field</th>
  2886. <th>Description</th>
  2887. </tr>
  2888. </thead>
  2889. <tbody>
  2890. <tr>
  2891. <td>
  2892. <code>auth</code></br>
  2893. <em>
  2894. <a href="#external-secrets.io/v1alpha1.VaultAuth">
  2895. VaultAuth
  2896. </a>
  2897. </em>
  2898. </td>
  2899. <td>
  2900. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  2901. </td>
  2902. </tr>
  2903. <tr>
  2904. <td>
  2905. <code>server</code></br>
  2906. <em>
  2907. string
  2908. </em>
  2909. </td>
  2910. <td>
  2911. <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>
  2912. </td>
  2913. </tr>
  2914. <tr>
  2915. <td>
  2916. <code>path</code></br>
  2917. <em>
  2918. string
  2919. </em>
  2920. </td>
  2921. <td>
  2922. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  2923. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  2924. for fetching secrets from Vault is optional and will be appended
  2925. if not present in specified path.</p>
  2926. </td>
  2927. </tr>
  2928. <tr>
  2929. <td>
  2930. <code>version</code></br>
  2931. <em>
  2932. <a href="#external-secrets.io/v1alpha1.VaultKVStoreVersion">
  2933. VaultKVStoreVersion
  2934. </a>
  2935. </em>
  2936. </td>
  2937. <td>
  2938. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  2939. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  2940. </td>
  2941. </tr>
  2942. <tr>
  2943. <td>
  2944. <code>namespace</code></br>
  2945. <em>
  2946. string
  2947. </em>
  2948. </td>
  2949. <td>
  2950. <em>(Optional)</em>
  2951. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  2952. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  2953. 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>
  2954. </td>
  2955. </tr>
  2956. <tr>
  2957. <td>
  2958. <code>caBundle</code></br>
  2959. <em>
  2960. []byte
  2961. </em>
  2962. </td>
  2963. <td>
  2964. <em>(Optional)</em>
  2965. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  2966. if the Server URL is using HTTPS protocol. This parameter is ignored for
  2967. plain HTTP protocol connection. If not set the system root certificates
  2968. are used to validate the TLS connection.</p>
  2969. </td>
  2970. </tr>
  2971. </tbody>
  2972. </table>
  2973. <h3 id="external-secrets.io/v1alpha1.YandexLockboxAuth">YandexLockboxAuth
  2974. </h3>
  2975. <p>
  2976. (<em>Appears on:</em>
  2977. <a href="#external-secrets.io/v1alpha1.YandexLockboxProvider">YandexLockboxProvider</a>)
  2978. </p>
  2979. <p>
  2980. </p>
  2981. <table>
  2982. <thead>
  2983. <tr>
  2984. <th>Field</th>
  2985. <th>Description</th>
  2986. </tr>
  2987. </thead>
  2988. <tbody>
  2989. <tr>
  2990. <td>
  2991. <code>authorizedKeySecretRef</code></br>
  2992. <em>
  2993. github.com/external-secrets/external-secrets/apis/meta/v1.SecretKeySelector
  2994. </em>
  2995. </td>
  2996. <td>
  2997. <em>(Optional)</em>
  2998. <p>The authorized key used for authentication</p>
  2999. </td>
  3000. </tr>
  3001. </tbody>
  3002. </table>
  3003. <h3 id="external-secrets.io/v1alpha1.YandexLockboxProvider">YandexLockboxProvider
  3004. </h3>
  3005. <p>
  3006. (<em>Appears on:</em>
  3007. <a href="#external-secrets.io/v1alpha1.SecretStoreProvider">SecretStoreProvider</a>)
  3008. </p>
  3009. <p>
  3010. <p>YandexLockboxProvider Configures a store to sync secrets using the Yandex Lockbox provider.</p>
  3011. </p>
  3012. <table>
  3013. <thead>
  3014. <tr>
  3015. <th>Field</th>
  3016. <th>Description</th>
  3017. </tr>
  3018. </thead>
  3019. <tbody>
  3020. <tr>
  3021. <td>
  3022. <code>apiEndpoint</code></br>
  3023. <em>
  3024. string
  3025. </em>
  3026. </td>
  3027. <td>
  3028. <em>(Optional)</em>
  3029. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  3030. </td>
  3031. </tr>
  3032. <tr>
  3033. <td>
  3034. <code>auth</code></br>
  3035. <em>
  3036. <a href="#external-secrets.io/v1alpha1.YandexLockboxAuth">
  3037. YandexLockboxAuth
  3038. </a>
  3039. </em>
  3040. </td>
  3041. <td>
  3042. <p>Auth defines the information necessary to authenticate against Yandex Lockbox</p>
  3043. </td>
  3044. </tr>
  3045. </tbody>
  3046. </table>
  3047. <hr/>
  3048. <p><em>
  3049. Generated with <code>gen-crd-api-reference-docs</code>.
  3050. </em></p></p>
  3051. </article>
  3052. </div>
  3053. </div>
  3054. </main>
  3055. <footer class="md-footer">
  3056. <nav class="md-footer__inner md-grid" aria-label="Footer">
  3057. <a href="../provider-gitlab-project-variables/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Gitlab Project Variables" rel="prev">
  3058. <div class="md-footer__button md-icon">
  3059. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
  3060. </div>
  3061. <div class="md-footer__title">
  3062. <div class="md-ellipsis">
  3063. <span class="md-footer__direction">
  3064. Previous
  3065. </span>
  3066. Gitlab Project Variables
  3067. </div>
  3068. </div>
  3069. </a>
  3070. <a href="../contributing-devguide/" class="md-footer__link md-footer__link--next" aria-label="Next: Developer guide" rel="next">
  3071. <div class="md-footer__title">
  3072. <div class="md-ellipsis">
  3073. <span class="md-footer__direction">
  3074. Next
  3075. </span>
  3076. Developer guide
  3077. </div>
  3078. </div>
  3079. <div class="md-footer__button md-icon">
  3080. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
  3081. </div>
  3082. </a>
  3083. </nav>
  3084. <div class="md-footer-meta md-typeset">
  3085. <div class="md-footer-meta__inner md-grid">
  3086. <div class="md-footer-copyright">
  3087. Made with
  3088. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  3089. Material for MkDocs
  3090. </a>
  3091. </div>
  3092. </div>
  3093. </div>
  3094. </footer>
  3095. </div>
  3096. <div class="md-dialog" data-md-component="dialog">
  3097. <div class="md-dialog__inner md-typeset"></div>
  3098. </div>
  3099. <script id="__config" type="application/json">{"base": "..", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "search": "../assets/javascripts/workers/search.b0710199.min.js", "version": null}</script>
  3100. <script src="../assets/javascripts/bundle.76f349be.min.js"></script>
  3101. </body>
  3102. </html>