index.html 121 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902
  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="prev" href="../aws-secrets-manager/">
  7. <link rel="next" href="../azure-key-vault/">
  8. <link rel="icon" href="../../pictures/eso-round-logo.svg">
  9. <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.6.22">
  10. <title>AWS Parameter Store - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.84d31ad4.min.css">
  12. <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
  13. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  14. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
  15. <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
  16. <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
  17. <script id="__analytics">function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-QP38TD8K7V"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-QP38TD8K7V",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-QP38TD8K7V",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script>
  18. <script>"undefined"!=typeof __md_analytics&&__md_analytics()</script>
  19. </head>
  20. <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
  21. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  22. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  23. <label class="md-overlay" for="__drawer"></label>
  24. <div data-md-component="skip">
  25. <a href="#parameter-store" class="md-skip">
  26. Skip to content
  27. </a>
  28. </div>
  29. <div data-md-component="announce">
  30. </div>
  31. <div data-md-color-scheme="default" data-md-component="outdated" hidden>
  32. <aside class="md-banner md-banner--warning">
  33. <div class="md-banner__inner md-grid md-typeset">
  34. You're not viewing the latest version.
  35. <a href="../../..">
  36. <strong>Click here to go to latest.</strong>
  37. </a>
  38. </div>
  39. <script>var el=document.querySelector("[data-md-component=outdated]"),base=new URL("../.."),outdated=__md_get("__outdated",sessionStorage,base);!0===outdated&&el&&(el.hidden=!1)</script>
  40. </aside>
  41. </div>
  42. <header class="md-header" data-md-component="header">
  43. <nav class="md-header__inner md-grid" aria-label="Header">
  44. <a href="../.." title="External Secrets Operator" class="md-header__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  45. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  46. </a>
  47. <label class="md-header__button md-icon" for="__drawer">
  48. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
  49. </label>
  50. <div class="md-header__title" data-md-component="header-title">
  51. <div class="md-header__ellipsis">
  52. <div class="md-header__topic">
  53. <span class="md-ellipsis">
  54. External Secrets Operator
  55. </span>
  56. </div>
  57. <div class="md-header__topic" data-md-component="header-topic">
  58. <span class="md-ellipsis">
  59. AWS Parameter Store
  60. </span>
  61. </div>
  62. </div>
  63. </div>
  64. <form class="md-header__option" data-md-component="palette">
  65. <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0">
  66. <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
  67. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
  68. </label>
  69. <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1">
  70. <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
  71. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
  72. </label>
  73. </form>
  74. <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
  75. <label class="md-header__button md-icon" for="__search">
  76. <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.52 6.52 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 5"/></svg>
  77. </label>
  78. <div class="md-search" data-md-component="search" role="dialog">
  79. <label class="md-search__overlay" for="__search"></label>
  80. <div class="md-search__inner" role="search">
  81. <form class="md-search__form" name="search">
  82. <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" required>
  83. <label class="md-search__icon md-icon" for="__search">
  84. <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.52 6.52 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 5"/></svg>
  85. <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 11z"/></svg>
  86. </label>
  87. <nav class="md-search__options" aria-label="Search">
  88. <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
  89. <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 12z"/></svg>
  90. </button>
  91. </nav>
  92. </form>
  93. <div class="md-search__output">
  94. <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
  95. <div class="md-search-result" data-md-component="search-result">
  96. <div class="md-search-result__meta">
  97. Initializing search
  98. </div>
  99. <ol class="md-search-result__list" role="presentation"></ol>
  100. </div>
  101. </div>
  102. </div>
  103. </div>
  104. </div>
  105. <div class="md-header__source">
  106. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  107. <div class="md-source__icon md-icon">
  108. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
  109. </div>
  110. <div class="md-source__repository">
  111. External Secrets Operator
  112. </div>
  113. </a>
  114. </div>
  115. </nav>
  116. </header>
  117. <div class="md-container" data-md-component="container">
  118. <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
  119. <div class="md-grid">
  120. <ul class="md-tabs__list">
  121. <li class="md-tabs__item">
  122. <a href="../.." class="md-tabs__link">
  123. Introduction
  124. </a>
  125. </li>
  126. <li class="md-tabs__item">
  127. <a href="../../api/components/" class="md-tabs__link">
  128. API
  129. </a>
  130. </li>
  131. <li class="md-tabs__item">
  132. <a href="../../guides/introduction/" class="md-tabs__link">
  133. Guides
  134. </a>
  135. </li>
  136. <li class="md-tabs__item md-tabs__item--active">
  137. <a href="../aws-secrets-manager/" class="md-tabs__link">
  138. Provider
  139. </a>
  140. </li>
  141. <li class="md-tabs__item">
  142. <a href="../../examples/gitops-using-fluxcd/" class="md-tabs__link">
  143. Examples
  144. </a>
  145. </li>
  146. <li class="md-tabs__item">
  147. <a href="../../contributing/devguide/" class="md-tabs__link">
  148. Community
  149. </a>
  150. </li>
  151. </ul>
  152. </div>
  153. </nav>
  154. <main class="md-main" data-md-component="main">
  155. <div class="md-main__inner md-grid">
  156. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  157. <div class="md-sidebar__scrollwrap">
  158. <div class="md-sidebar__inner">
  159. <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
  160. <label class="md-nav__title" for="__drawer">
  161. <a href="../.." title="External Secrets Operator" class="md-nav__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  162. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  163. </a>
  164. External Secrets Operator
  165. </label>
  166. <div class="md-nav__source">
  167. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  168. <div class="md-source__icon md-icon">
  169. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
  170. </div>
  171. <div class="md-source__repository">
  172. External Secrets Operator
  173. </div>
  174. </a>
  175. </div>
  176. <ul class="md-nav__list" data-md-scrollfix>
  177. <li class="md-nav__item md-nav__item--nested">
  178. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_1" >
  179. <div class="md-nav__link md-nav__container">
  180. <a href="../.." class="md-nav__link ">
  181. <span class="md-ellipsis">
  182. Introduction
  183. </span>
  184. </a>
  185. <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
  186. <span class="md-nav__icon md-icon"></span>
  187. </label>
  188. </div>
  189. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
  190. <label class="md-nav__title" for="__nav_1">
  191. <span class="md-nav__icon md-icon"></span>
  192. Introduction
  193. </label>
  194. <ul class="md-nav__list" data-md-scrollfix>
  195. <li class="md-nav__item">
  196. <a href="../../introduction/overview/" class="md-nav__link">
  197. <span class="md-ellipsis">
  198. Overview
  199. </span>
  200. </a>
  201. </li>
  202. <li class="md-nav__item">
  203. <a href="../../introduction/glossary/" class="md-nav__link">
  204. <span class="md-ellipsis">
  205. Glossary
  206. </span>
  207. </a>
  208. </li>
  209. <li class="md-nav__item">
  210. <a href="../../introduction/prerequisites/" class="md-nav__link">
  211. <span class="md-ellipsis">
  212. Prerequisites
  213. </span>
  214. </a>
  215. </li>
  216. <li class="md-nav__item">
  217. <a href="../../introduction/getting-started/" class="md-nav__link">
  218. <span class="md-ellipsis">
  219. Getting started
  220. </span>
  221. </a>
  222. </li>
  223. <li class="md-nav__item">
  224. <a href="../../introduction/faq/" class="md-nav__link">
  225. <span class="md-ellipsis">
  226. FAQ
  227. </span>
  228. </a>
  229. </li>
  230. <li class="md-nav__item">
  231. <a href="../../introduction/stability-support/" class="md-nav__link">
  232. <span class="md-ellipsis">
  233. Stability and Support
  234. </span>
  235. </a>
  236. </li>
  237. <li class="md-nav__item">
  238. <a href="../../introduction/deprecation-policy/" class="md-nav__link">
  239. <span class="md-ellipsis">
  240. Deprecation Policy
  241. </span>
  242. </a>
  243. </li>
  244. </ul>
  245. </nav>
  246. </li>
  247. <li class="md-nav__item md-nav__item--nested">
  248. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
  249. <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
  250. <span class="md-ellipsis">
  251. API
  252. </span>
  253. <span class="md-nav__icon md-icon"></span>
  254. </label>
  255. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
  256. <label class="md-nav__title" for="__nav_2">
  257. <span class="md-nav__icon md-icon"></span>
  258. API
  259. </label>
  260. <ul class="md-nav__list" data-md-scrollfix>
  261. <li class="md-nav__item">
  262. <a href="../../api/components/" class="md-nav__link">
  263. <span class="md-ellipsis">
  264. Components
  265. </span>
  266. </a>
  267. </li>
  268. <li class="md-nav__item md-nav__item--nested">
  269. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_2" >
  270. <label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
  271. <span class="md-ellipsis">
  272. Core Resources
  273. </span>
  274. <span class="md-nav__icon md-icon"></span>
  275. </label>
  276. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
  277. <label class="md-nav__title" for="__nav_2_2">
  278. <span class="md-nav__icon md-icon"></span>
  279. Core Resources
  280. </label>
  281. <ul class="md-nav__list" data-md-scrollfix>
  282. <li class="md-nav__item">
  283. <a href="../../api/externalsecret/" class="md-nav__link">
  284. <span class="md-ellipsis">
  285. ExternalSecret
  286. </span>
  287. </a>
  288. </li>
  289. <li class="md-nav__item">
  290. <a href="../../api/secretstore/" class="md-nav__link">
  291. <span class="md-ellipsis">
  292. SecretStore
  293. </span>
  294. </a>
  295. </li>
  296. <li class="md-nav__item">
  297. <a href="../../api/clustersecretstore/" class="md-nav__link">
  298. <span class="md-ellipsis">
  299. ClusterSecretStore
  300. </span>
  301. </a>
  302. </li>
  303. <li class="md-nav__item">
  304. <a href="../../api/clusterexternalsecret/" class="md-nav__link">
  305. <span class="md-ellipsis">
  306. ClusterExternalSecret
  307. </span>
  308. </a>
  309. </li>
  310. <li class="md-nav__item">
  311. <a href="../../api/clusterpushsecret/" class="md-nav__link">
  312. <span class="md-ellipsis">
  313. ClusterPushSecret
  314. </span>
  315. </a>
  316. </li>
  317. <li class="md-nav__item">
  318. <a href="../../api/pushsecret/" class="md-nav__link">
  319. <span class="md-ellipsis">
  320. PushSecret
  321. </span>
  322. </a>
  323. </li>
  324. </ul>
  325. </nav>
  326. </li>
  327. <li class="md-nav__item md-nav__item--nested">
  328. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_3" >
  329. <div class="md-nav__link md-nav__container">
  330. <a href="../../api/generator/" class="md-nav__link ">
  331. <span class="md-ellipsis">
  332. Generators
  333. </span>
  334. </a>
  335. <label class="md-nav__link " for="__nav_2_3" id="__nav_2_3_label" tabindex="0">
  336. <span class="md-nav__icon md-icon"></span>
  337. </label>
  338. </div>
  339. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
  340. <label class="md-nav__title" for="__nav_2_3">
  341. <span class="md-nav__icon md-icon"></span>
  342. Generators
  343. </label>
  344. <ul class="md-nav__list" data-md-scrollfix>
  345. <li class="md-nav__item">
  346. <a href="../../api/generator/acr/" class="md-nav__link">
  347. <span class="md-ellipsis">
  348. Azure Container Registry
  349. </span>
  350. </a>
  351. </li>
  352. <li class="md-nav__item">
  353. <a href="../../api/generator/ecr/" class="md-nav__link">
  354. <span class="md-ellipsis">
  355. AWS Elastic Container Registry
  356. </span>
  357. </a>
  358. </li>
  359. <li class="md-nav__item">
  360. <a href="../../api/generator/sts/" class="md-nav__link">
  361. <span class="md-ellipsis">
  362. AWS STS Session Token
  363. </span>
  364. </a>
  365. </li>
  366. <li class="md-nav__item">
  367. <a href="../../api/generator/cloudsmith/" class="md-nav__link">
  368. <span class="md-ellipsis">
  369. Cloudsmith
  370. </span>
  371. </a>
  372. </li>
  373. <li class="md-nav__item">
  374. <a href="../../api/generator/cluster/" class="md-nav__link">
  375. <span class="md-ellipsis">
  376. Cluster Generator
  377. </span>
  378. </a>
  379. </li>
  380. <li class="md-nav__item">
  381. <a href="../../api/generator/gcr/" class="md-nav__link">
  382. <span class="md-ellipsis">
  383. Google Container Registry
  384. </span>
  385. </a>
  386. </li>
  387. <li class="md-nav__item">
  388. <a href="../../api/generator/quay/" class="md-nav__link">
  389. <span class="md-ellipsis">
  390. Quay
  391. </span>
  392. </a>
  393. </li>
  394. <li class="md-nav__item">
  395. <a href="../../api/generator/vault/" class="md-nav__link">
  396. <span class="md-ellipsis">
  397. Vault Dynamic Secret
  398. </span>
  399. </a>
  400. </li>
  401. <li class="md-nav__item">
  402. <a href="../../api/generator/password/" class="md-nav__link">
  403. <span class="md-ellipsis">
  404. Password
  405. </span>
  406. </a>
  407. </li>
  408. <li class="md-nav__item">
  409. <a href="../../api/generator/fake/" class="md-nav__link">
  410. <span class="md-ellipsis">
  411. Fake
  412. </span>
  413. </a>
  414. </li>
  415. <li class="md-nav__item">
  416. <a href="../../api/generator/webhook/" class="md-nav__link">
  417. <span class="md-ellipsis">
  418. Webhook
  419. </span>
  420. </a>
  421. </li>
  422. <li class="md-nav__item">
  423. <a href="../../api/generator/github/" class="md-nav__link">
  424. <span class="md-ellipsis">
  425. Github
  426. </span>
  427. </a>
  428. </li>
  429. <li class="md-nav__item">
  430. <a href="../../api/generator/uuid/" class="md-nav__link">
  431. <span class="md-ellipsis">
  432. UUID
  433. </span>
  434. </a>
  435. </li>
  436. <li class="md-nav__item">
  437. <a href="../../api/generator/mfa/" class="md-nav__link">
  438. <span class="md-ellipsis">
  439. MFA
  440. </span>
  441. </a>
  442. </li>
  443. <li class="md-nav__item">
  444. <a href="../../api/generator/sshkey/" class="md-nav__link">
  445. <span class="md-ellipsis">
  446. SSHKey
  447. </span>
  448. </a>
  449. </li>
  450. </ul>
  451. </nav>
  452. </li>
  453. <li class="md-nav__item md-nav__item--nested">
  454. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_4" >
  455. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  456. <span class="md-ellipsis">
  457. Reference Docs
  458. </span>
  459. <span class="md-nav__icon md-icon"></span>
  460. </label>
  461. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
  462. <label class="md-nav__title" for="__nav_2_4">
  463. <span class="md-nav__icon md-icon"></span>
  464. Reference Docs
  465. </label>
  466. <ul class="md-nav__list" data-md-scrollfix>
  467. <li class="md-nav__item">
  468. <a href="../../api/spec/" class="md-nav__link">
  469. <span class="md-ellipsis">
  470. API specification
  471. </span>
  472. </a>
  473. </li>
  474. <li class="md-nav__item">
  475. <a href="../../api/controller-options/" class="md-nav__link">
  476. <span class="md-ellipsis">
  477. Controller Options
  478. </span>
  479. </a>
  480. </li>
  481. <li class="md-nav__item">
  482. <a href="../../api/metrics/" class="md-nav__link">
  483. <span class="md-ellipsis">
  484. Metrics
  485. </span>
  486. </a>
  487. </li>
  488. <li class="md-nav__item">
  489. <a href="../../api/selectable-fields/" class="md-nav__link">
  490. <span class="md-ellipsis">
  491. Selectable Fields
  492. </span>
  493. </a>
  494. </li>
  495. </ul>
  496. </nav>
  497. </li>
  498. </ul>
  499. </nav>
  500. </li>
  501. <li class="md-nav__item md-nav__item--nested">
  502. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  503. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  504. <span class="md-ellipsis">
  505. Guides
  506. </span>
  507. <span class="md-nav__icon md-icon"></span>
  508. </label>
  509. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  510. <label class="md-nav__title" for="__nav_3">
  511. <span class="md-nav__icon md-icon"></span>
  512. Guides
  513. </label>
  514. <ul class="md-nav__list" data-md-scrollfix>
  515. <li class="md-nav__item">
  516. <a href="../../guides/introduction/" class="md-nav__link">
  517. <span class="md-ellipsis">
  518. Introduction
  519. </span>
  520. </a>
  521. </li>
  522. <li class="md-nav__item md-nav__item--nested">
  523. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  524. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  525. <span class="md-ellipsis">
  526. External Secrets
  527. </span>
  528. <span class="md-nav__icon md-icon"></span>
  529. </label>
  530. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  531. <label class="md-nav__title" for="__nav_3_2">
  532. <span class="md-nav__icon md-icon"></span>
  533. External Secrets
  534. </label>
  535. <ul class="md-nav__list" data-md-scrollfix>
  536. <li class="md-nav__item">
  537. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  538. <span class="md-ellipsis">
  539. Extract structured data
  540. </span>
  541. </a>
  542. </li>
  543. <li class="md-nav__item">
  544. <a href="../../guides/getallsecrets/" class="md-nav__link">
  545. <span class="md-ellipsis">
  546. Find Secrets by Name or Metadata
  547. </span>
  548. </a>
  549. </li>
  550. <li class="md-nav__item">
  551. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  552. <span class="md-ellipsis">
  553. Rewriting Keys
  554. </span>
  555. </a>
  556. </li>
  557. <li class="md-nav__item md-nav__item--nested">
  558. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  559. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  560. <span class="md-ellipsis">
  561. Advanced Templating
  562. </span>
  563. <span class="md-nav__icon md-icon"></span>
  564. </label>
  565. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  566. <label class="md-nav__title" for="__nav_3_2_4">
  567. <span class="md-nav__icon md-icon"></span>
  568. Advanced Templating
  569. </label>
  570. <ul class="md-nav__list" data-md-scrollfix>
  571. <li class="md-nav__item">
  572. <a href="../../guides/templating/" class="md-nav__link">
  573. <span class="md-ellipsis">
  574. v2
  575. </span>
  576. </a>
  577. </li>
  578. <li class="md-nav__item">
  579. <a href="../../guides/templating-v1/" class="md-nav__link">
  580. <span class="md-ellipsis">
  581. v1
  582. </span>
  583. </a>
  584. </li>
  585. </ul>
  586. </nav>
  587. </li>
  588. <li class="md-nav__item">
  589. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  590. <span class="md-ellipsis">
  591. Kubernetes Secret Types
  592. </span>
  593. </a>
  594. </li>
  595. <li class="md-nav__item">
  596. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  597. <span class="md-ellipsis">
  598. Lifecycle: ownership & deletion
  599. </span>
  600. </a>
  601. </li>
  602. <li class="md-nav__item">
  603. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  604. <span class="md-ellipsis">
  605. Decoding Strategies
  606. </span>
  607. </a>
  608. </li>
  609. <li class="md-nav__item">
  610. <a href="../../guides/controller-class/" class="md-nav__link">
  611. <span class="md-ellipsis">
  612. Controller Classes
  613. </span>
  614. </a>
  615. </li>
  616. </ul>
  617. </nav>
  618. </li>
  619. <li class="md-nav__item">
  620. <a href="../../guides/generator/" class="md-nav__link">
  621. <span class="md-ellipsis">
  622. Generators
  623. </span>
  624. </a>
  625. </li>
  626. <li class="md-nav__item">
  627. <a href="../../guides/pushsecrets/" class="md-nav__link">
  628. <span class="md-ellipsis">
  629. Push Secrets
  630. </span>
  631. </a>
  632. </li>
  633. <li class="md-nav__item md-nav__item--nested">
  634. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_5" >
  635. <label class="md-nav__link" for="__nav_3_5" id="__nav_3_5_label" tabindex="0">
  636. <span class="md-ellipsis">
  637. Operations
  638. </span>
  639. <span class="md-nav__icon md-icon"></span>
  640. </label>
  641. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_5_label" aria-expanded="false">
  642. <label class="md-nav__title" for="__nav_3_5">
  643. <span class="md-nav__icon md-icon"></span>
  644. Operations
  645. </label>
  646. <ul class="md-nav__list" data-md-scrollfix>
  647. <li class="md-nav__item">
  648. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  649. <span class="md-ellipsis">
  650. Multi Tenancy
  651. </span>
  652. </a>
  653. </li>
  654. <li class="md-nav__item">
  655. <a href="../../guides/security-best-practices/" class="md-nav__link">
  656. <span class="md-ellipsis">
  657. Security Best Practices
  658. </span>
  659. </a>
  660. </li>
  661. <li class="md-nav__item">
  662. <a href="../../guides/threat-model/" class="md-nav__link">
  663. <span class="md-ellipsis">
  664. Threat Model
  665. </span>
  666. </a>
  667. </li>
  668. <li class="md-nav__item">
  669. <a href="../../guides/v1beta1/" class="md-nav__link">
  670. <span class="md-ellipsis">
  671. Upgrading to v1beta1
  672. </span>
  673. </a>
  674. </li>
  675. <li class="md-nav__item">
  676. <a href="../../guides/using-latest-image/" class="md-nav__link">
  677. <span class="md-ellipsis">
  678. Using Latest Image
  679. </span>
  680. </a>
  681. </li>
  682. <li class="md-nav__item">
  683. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  684. <span class="md-ellipsis">
  685. Disable Cluster Features
  686. </span>
  687. </a>
  688. </li>
  689. </ul>
  690. </nav>
  691. </li>
  692. <li class="md-nav__item md-nav__item--nested">
  693. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_6" >
  694. <label class="md-nav__link" for="__nav_3_6" id="__nav_3_6_label" tabindex="0">
  695. <span class="md-ellipsis">
  696. Tooling
  697. </span>
  698. <span class="md-nav__icon md-icon"></span>
  699. </label>
  700. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_6_label" aria-expanded="false">
  701. <label class="md-nav__title" for="__nav_3_6">
  702. <span class="md-nav__icon md-icon"></span>
  703. Tooling
  704. </label>
  705. <ul class="md-nav__list" data-md-scrollfix>
  706. <li class="md-nav__item">
  707. <a href="../../guides/using-esoctl-tool/" class="md-nav__link">
  708. <span class="md-ellipsis">
  709. Using the esoctl tool
  710. </span>
  711. </a>
  712. </li>
  713. </ul>
  714. </nav>
  715. </li>
  716. </ul>
  717. </nav>
  718. </li>
  719. <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
  720. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
  721. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="">
  722. <span class="md-ellipsis">
  723. Provider
  724. </span>
  725. <span class="md-nav__icon md-icon"></span>
  726. </label>
  727. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
  728. <label class="md-nav__title" for="__nav_4">
  729. <span class="md-nav__icon md-icon"></span>
  730. Provider
  731. </label>
  732. <ul class="md-nav__list" data-md-scrollfix>
  733. <li class="md-nav__item">
  734. <a href="../aws-secrets-manager/" class="md-nav__link">
  735. <span class="md-ellipsis">
  736. AWS Secrets Manager
  737. </span>
  738. </a>
  739. </li>
  740. <li class="md-nav__item md-nav__item--active">
  741. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  742. <label class="md-nav__link md-nav__link--active" for="__toc">
  743. <span class="md-ellipsis">
  744. AWS Parameter Store
  745. </span>
  746. <span class="md-nav__icon md-icon"></span>
  747. </label>
  748. <a href="./" class="md-nav__link md-nav__link--active">
  749. <span class="md-ellipsis">
  750. AWS Parameter Store
  751. </span>
  752. </a>
  753. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  754. <label class="md-nav__title" for="__toc">
  755. <span class="md-nav__icon md-icon"></span>
  756. Table of contents
  757. </label>
  758. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  759. <li class="md-nav__item">
  760. <a href="#parameter-store" class="md-nav__link">
  761. <span class="md-ellipsis">
  762. Parameter Store
  763. </span>
  764. </a>
  765. <nav class="md-nav" aria-label="Parameter Store">
  766. <ul class="md-nav__list">
  767. <li class="md-nav__item">
  768. <a href="#iam-policy" class="md-nav__link">
  769. <span class="md-ellipsis">
  770. IAM Policy
  771. </span>
  772. </a>
  773. <nav class="md-nav" aria-label="IAM Policy">
  774. <ul class="md-nav__list">
  775. <li class="md-nav__item">
  776. <a href="#fetching-parameters" class="md-nav__link">
  777. <span class="md-ellipsis">
  778. Fetching Parameters
  779. </span>
  780. </a>
  781. </li>
  782. <li class="md-nav__item">
  783. <a href="#pushing-parameters" class="md-nav__link">
  784. <span class="md-ellipsis">
  785. Pushing Parameters
  786. </span>
  787. </a>
  788. </li>
  789. </ul>
  790. </nav>
  791. </li>
  792. <li class="md-nav__item">
  793. <a href="#json-secret-values" class="md-nav__link">
  794. <span class="md-ellipsis">
  795. JSON Secret Values
  796. </span>
  797. </a>
  798. </li>
  799. <li class="md-nav__item">
  800. <a href="#parameter-versions" class="md-nav__link">
  801. <span class="md-ellipsis">
  802. Parameter Versions
  803. </span>
  804. </a>
  805. </li>
  806. </ul>
  807. </nav>
  808. </li>
  809. <li class="md-nav__item">
  810. <a href="#setsecret" class="md-nav__link">
  811. <span class="md-ellipsis">
  812. SetSecret
  813. </span>
  814. </a>
  815. <nav class="md-nav" aria-label="SetSecret">
  816. <ul class="md-nav__list">
  817. <li class="md-nav__item">
  818. <a href="#creating-a-push-secret" class="md-nav__link">
  819. <span class="md-ellipsis">
  820. Creating a Push Secret
  821. </span>
  822. </a>
  823. <nav class="md-nav" aria-label="Creating a Push Secret">
  824. <ul class="md-nav__list">
  825. <li class="md-nav__item">
  826. <a href="#additional-metadata-for-pushsecret" class="md-nav__link">
  827. <span class="md-ellipsis">
  828. Additional Metadata for PushSecret
  829. </span>
  830. </a>
  831. </li>
  832. <li class="md-nav__item">
  833. <a href="#check-successful-secret-sync" class="md-nav__link">
  834. <span class="md-ellipsis">
  835. Check successful secret sync
  836. </span>
  837. </a>
  838. </li>
  839. <li class="md-nav__item">
  840. <a href="#test-new-secret-using-aws-cli" class="md-nav__link">
  841. <span class="md-ellipsis">
  842. Test new secret using AWS CLI
  843. </span>
  844. </a>
  845. </li>
  846. </ul>
  847. </nav>
  848. </li>
  849. </ul>
  850. </nav>
  851. </li>
  852. <li class="md-nav__item">
  853. <a href="#aws-authentication" class="md-nav__link">
  854. <span class="md-ellipsis">
  855. AWS Authentication
  856. </span>
  857. </a>
  858. <nav class="md-nav" aria-label="AWS Authentication">
  859. <ul class="md-nav__list">
  860. <li class="md-nav__item">
  861. <a href="#controllers-pod-identity" class="md-nav__link">
  862. <span class="md-ellipsis">
  863. Controller's Pod Identity
  864. </span>
  865. </a>
  866. </li>
  867. <li class="md-nav__item">
  868. <a href="#access-key-id-secret-access-key" class="md-nav__link">
  869. <span class="md-ellipsis">
  870. Access Key ID &amp; Secret Access Key
  871. </span>
  872. </a>
  873. </li>
  874. <li class="md-nav__item">
  875. <a href="#eks-service-account-credentials" class="md-nav__link">
  876. <span class="md-ellipsis">
  877. EKS Service Account credentials
  878. </span>
  879. </a>
  880. </li>
  881. </ul>
  882. </nav>
  883. </li>
  884. <li class="md-nav__item">
  885. <a href="#eks-pod-identity-setup" class="md-nav__link">
  886. <span class="md-ellipsis">
  887. EKS Pod Identity Setup
  888. </span>
  889. </a>
  890. </li>
  891. <li class="md-nav__item">
  892. <a href="#custom-endpoints" class="md-nav__link">
  893. <span class="md-ellipsis">
  894. Custom Endpoints
  895. </span>
  896. </a>
  897. </li>
  898. </ul>
  899. </nav>
  900. </li>
  901. <li class="md-nav__item">
  902. <a href="../azure-key-vault/" class="md-nav__link">
  903. <span class="md-ellipsis">
  904. Azure Key Vault
  905. </span>
  906. </a>
  907. </li>
  908. <li class="md-nav__item">
  909. <a href="../beyondtrust/" class="md-nav__link">
  910. <span class="md-ellipsis">
  911. BeyondTrust
  912. </span>
  913. </a>
  914. </li>
  915. <li class="md-nav__item">
  916. <a href="../bitwarden-secrets-manager/" class="md-nav__link">
  917. <span class="md-ellipsis">
  918. Bitwarden Secrets Manager
  919. </span>
  920. </a>
  921. </li>
  922. <li class="md-nav__item">
  923. <a href="../chef/" class="md-nav__link">
  924. <span class="md-ellipsis">
  925. Chef
  926. </span>
  927. </a>
  928. </li>
  929. <li class="md-nav__item">
  930. <a href="../cloudru/" class="md-nav__link">
  931. <span class="md-ellipsis">
  932. Cloud.ru Secret Manager
  933. </span>
  934. </a>
  935. </li>
  936. <li class="md-nav__item">
  937. <a href="../conjur/" class="md-nav__link">
  938. <span class="md-ellipsis">
  939. CyberArk Conjur
  940. </span>
  941. </a>
  942. </li>
  943. <li class="md-nav__item">
  944. <a href="../device42/" class="md-nav__link">
  945. <span class="md-ellipsis">
  946. Device42
  947. </span>
  948. </a>
  949. </li>
  950. <li class="md-nav__item">
  951. <a href="../google-secrets-manager/" class="md-nav__link">
  952. <span class="md-ellipsis">
  953. Google Cloud Secret Manager
  954. </span>
  955. </a>
  956. </li>
  957. <li class="md-nav__item">
  958. <a href="../hashicorp-vault/" class="md-nav__link">
  959. <span class="md-ellipsis">
  960. HashiCorp Vault
  961. </span>
  962. </a>
  963. </li>
  964. <li class="md-nav__item">
  965. <a href="../kubernetes/" class="md-nav__link">
  966. <span class="md-ellipsis">
  967. Kubernetes
  968. </span>
  969. </a>
  970. </li>
  971. <li class="md-nav__item">
  972. <a href="../ibm-secrets-manager/" class="md-nav__link">
  973. <span class="md-ellipsis">
  974. IBM Secrets Manager
  975. </span>
  976. </a>
  977. </li>
  978. <li class="md-nav__item">
  979. <a href="../akeyless/" class="md-nav__link">
  980. <span class="md-ellipsis">
  981. Akeyless
  982. </span>
  983. </a>
  984. </li>
  985. <li class="md-nav__item">
  986. <a href="../yandex-certificate-manager/" class="md-nav__link">
  987. <span class="md-ellipsis">
  988. Yandex Certificate Manager
  989. </span>
  990. </a>
  991. </li>
  992. <li class="md-nav__item">
  993. <a href="../yandex-lockbox/" class="md-nav__link">
  994. <span class="md-ellipsis">
  995. Yandex Lockbox
  996. </span>
  997. </a>
  998. </li>
  999. <li class="md-nav__item">
  1000. <a href="../alibaba/" class="md-nav__link">
  1001. <span class="md-ellipsis">
  1002. Alibaba Cloud
  1003. </span>
  1004. </a>
  1005. </li>
  1006. <li class="md-nav__item">
  1007. <a href="../gitlab-variables/" class="md-nav__link">
  1008. <span class="md-ellipsis">
  1009. GitLab Variables
  1010. </span>
  1011. </a>
  1012. </li>
  1013. <li class="md-nav__item">
  1014. <a href="../github/" class="md-nav__link">
  1015. <span class="md-ellipsis">
  1016. Github Actions Secrets
  1017. </span>
  1018. </a>
  1019. </li>
  1020. <li class="md-nav__item">
  1021. <a href="../oracle-vault/" class="md-nav__link">
  1022. <span class="md-ellipsis">
  1023. Oracle Vault
  1024. </span>
  1025. </a>
  1026. </li>
  1027. <li class="md-nav__item">
  1028. <a href="../1password-automation/" class="md-nav__link">
  1029. <span class="md-ellipsis">
  1030. 1Password Connect Server
  1031. </span>
  1032. </a>
  1033. </li>
  1034. <li class="md-nav__item">
  1035. <a href="../1password-sdk/" class="md-nav__link">
  1036. <span class="md-ellipsis">
  1037. 1Password SDK
  1038. </span>
  1039. </a>
  1040. </li>
  1041. <li class="md-nav__item">
  1042. <a href="../webhook/" class="md-nav__link">
  1043. <span class="md-ellipsis">
  1044. Webhook
  1045. </span>
  1046. </a>
  1047. </li>
  1048. <li class="md-nav__item">
  1049. <a href="../fake/" class="md-nav__link">
  1050. <span class="md-ellipsis">
  1051. Fake
  1052. </span>
  1053. </a>
  1054. </li>
  1055. <li class="md-nav__item">
  1056. <a href="../senhasegura-dsm/" class="md-nav__link">
  1057. <span class="md-ellipsis">
  1058. senhasegura DevOps Secrets Management (DSM)
  1059. </span>
  1060. </a>
  1061. </li>
  1062. <li class="md-nav__item">
  1063. <a href="../doppler/" class="md-nav__link">
  1064. <span class="md-ellipsis">
  1065. Doppler
  1066. </span>
  1067. </a>
  1068. </li>
  1069. <li class="md-nav__item">
  1070. <a href="../keeper-security/" class="md-nav__link">
  1071. <span class="md-ellipsis">
  1072. Keeper Security
  1073. </span>
  1074. </a>
  1075. </li>
  1076. <li class="md-nav__item">
  1077. <a href="../cloak/" class="md-nav__link">
  1078. <span class="md-ellipsis">
  1079. Cloak End 2 End Encrypted Secrets
  1080. </span>
  1081. </a>
  1082. </li>
  1083. <li class="md-nav__item">
  1084. <a href="../scaleway/" class="md-nav__link">
  1085. <span class="md-ellipsis">
  1086. Scaleway
  1087. </span>
  1088. </a>
  1089. </li>
  1090. <li class="md-nav__item">
  1091. <a href="../delinea/" class="md-nav__link">
  1092. <span class="md-ellipsis">
  1093. Delinea
  1094. </span>
  1095. </a>
  1096. </li>
  1097. <li class="md-nav__item">
  1098. <a href="../secretserver/" class="md-nav__link">
  1099. <span class="md-ellipsis">
  1100. Secret Server
  1101. </span>
  1102. </a>
  1103. </li>
  1104. <li class="md-nav__item">
  1105. <a href="../passbolt/" class="md-nav__link">
  1106. <span class="md-ellipsis">
  1107. Passbolt
  1108. </span>
  1109. </a>
  1110. </li>
  1111. <li class="md-nav__item">
  1112. <a href="../pulumi/" class="md-nav__link">
  1113. <span class="md-ellipsis">
  1114. Pulumi ESC
  1115. </span>
  1116. </a>
  1117. </li>
  1118. <li class="md-nav__item">
  1119. <a href="../onboardbase/" class="md-nav__link">
  1120. <span class="md-ellipsis">
  1121. Onboardbase
  1122. </span>
  1123. </a>
  1124. </li>
  1125. <li class="md-nav__item">
  1126. <a href="../../provider-passworddepot/" class="md-nav__link">
  1127. <span class="md-ellipsis">
  1128. Password Depot
  1129. </span>
  1130. </a>
  1131. </li>
  1132. <li class="md-nav__item">
  1133. <a href="../fortanix/" class="md-nav__link">
  1134. <span class="md-ellipsis">
  1135. Fortanix
  1136. </span>
  1137. </a>
  1138. </li>
  1139. <li class="md-nav__item">
  1140. <a href="../infisical/" class="md-nav__link">
  1141. <span class="md-ellipsis">
  1142. Infisical
  1143. </span>
  1144. </a>
  1145. </li>
  1146. <li class="md-nav__item">
  1147. <a href="../previder/" class="md-nav__link">
  1148. <span class="md-ellipsis">
  1149. Previder
  1150. </span>
  1151. </a>
  1152. </li>
  1153. <li class="md-nav__item">
  1154. <a href="../openbao/" class="md-nav__link">
  1155. <span class="md-ellipsis">
  1156. OpenBao
  1157. </span>
  1158. </a>
  1159. </li>
  1160. <li class="md-nav__item">
  1161. <a href="../volcengine/" class="md-nav__link">
  1162. <span class="md-ellipsis">
  1163. Volcengine
  1164. </span>
  1165. </a>
  1166. </li>
  1167. <li class="md-nav__item">
  1168. <a href="../ngrok/" class="md-nav__link">
  1169. <span class="md-ellipsis">
  1170. ngrok
  1171. </span>
  1172. </a>
  1173. </li>
  1174. </ul>
  1175. </nav>
  1176. </li>
  1177. <li class="md-nav__item md-nav__item--nested">
  1178. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  1179. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  1180. <span class="md-ellipsis">
  1181. Examples
  1182. </span>
  1183. <span class="md-nav__icon md-icon"></span>
  1184. </label>
  1185. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  1186. <label class="md-nav__title" for="__nav_5">
  1187. <span class="md-nav__icon md-icon"></span>
  1188. Examples
  1189. </label>
  1190. <ul class="md-nav__list" data-md-scrollfix>
  1191. <li class="md-nav__item">
  1192. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  1193. <span class="md-ellipsis">
  1194. FluxCD
  1195. </span>
  1196. </a>
  1197. </li>
  1198. <li class="md-nav__item">
  1199. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  1200. <span class="md-ellipsis">
  1201. Anchore Engine
  1202. </span>
  1203. </a>
  1204. </li>
  1205. <li class="md-nav__item">
  1206. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  1207. <span class="md-ellipsis">
  1208. Jenkins
  1209. </span>
  1210. </a>
  1211. </li>
  1212. <li class="md-nav__item">
  1213. <a href="../../examples/bitwarden/" class="md-nav__link">
  1214. <span class="md-ellipsis">
  1215. Bitwarden
  1216. </span>
  1217. </a>
  1218. </li>
  1219. </ul>
  1220. </nav>
  1221. </li>
  1222. <li class="md-nav__item md-nav__item--nested">
  1223. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  1224. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  1225. <span class="md-ellipsis">
  1226. Community
  1227. </span>
  1228. <span class="md-nav__icon md-icon"></span>
  1229. </label>
  1230. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  1231. <label class="md-nav__title" for="__nav_6">
  1232. <span class="md-nav__icon md-icon"></span>
  1233. Community
  1234. </label>
  1235. <ul class="md-nav__list" data-md-scrollfix>
  1236. <li class="md-nav__item md-nav__item--nested">
  1237. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  1238. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  1239. <span class="md-ellipsis">
  1240. Contributing
  1241. </span>
  1242. <span class="md-nav__icon md-icon"></span>
  1243. </label>
  1244. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  1245. <label class="md-nav__title" for="__nav_6_1">
  1246. <span class="md-nav__icon md-icon"></span>
  1247. Contributing
  1248. </label>
  1249. <ul class="md-nav__list" data-md-scrollfix>
  1250. <li class="md-nav__item">
  1251. <a href="../../contributing/devguide/" class="md-nav__link">
  1252. <span class="md-ellipsis">
  1253. Developer guide
  1254. </span>
  1255. </a>
  1256. </li>
  1257. <li class="md-nav__item">
  1258. <a href="../../contributing/process/" class="md-nav__link">
  1259. <span class="md-ellipsis">
  1260. Contributing Process
  1261. </span>
  1262. </a>
  1263. </li>
  1264. <li class="md-nav__item">
  1265. <a href="../../contributing/release/" class="md-nav__link">
  1266. <span class="md-ellipsis">
  1267. Release Process
  1268. </span>
  1269. </a>
  1270. </li>
  1271. <li class="md-nav__item">
  1272. <a href="../../contributing/coc/" class="md-nav__link">
  1273. <span class="md-ellipsis">
  1274. Code of Conduct
  1275. </span>
  1276. </a>
  1277. </li>
  1278. <li class="md-nav__item">
  1279. <a href="../../contributing/calendar/" class="md-nav__link">
  1280. <span class="md-ellipsis">
  1281. Community meetings calendar
  1282. </span>
  1283. </a>
  1284. </li>
  1285. <li class="md-nav__item">
  1286. <a href="../../contributing/roadmap/" class="md-nav__link">
  1287. <span class="md-ellipsis">
  1288. Roadmap
  1289. </span>
  1290. </a>
  1291. </li>
  1292. <li class="md-nav__item">
  1293. <a href="../../contributing/burnout-mitigation/" class="md-nav__link">
  1294. <span class="md-ellipsis">
  1295. Burnout Prevention
  1296. </span>
  1297. </a>
  1298. </li>
  1299. </ul>
  1300. </nav>
  1301. </li>
  1302. <li class="md-nav__item md-nav__item--nested">
  1303. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1304. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1305. <span class="md-ellipsis">
  1306. External Resources
  1307. </span>
  1308. <span class="md-nav__icon md-icon"></span>
  1309. </label>
  1310. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1311. <label class="md-nav__title" for="__nav_6_2">
  1312. <span class="md-nav__icon md-icon"></span>
  1313. External Resources
  1314. </label>
  1315. <ul class="md-nav__list" data-md-scrollfix>
  1316. <li class="md-nav__item">
  1317. <a href="../../eso-talks/" class="md-nav__link">
  1318. <span class="md-ellipsis">
  1319. Talks
  1320. </span>
  1321. </a>
  1322. </li>
  1323. <li class="md-nav__item">
  1324. <a href="../../eso-demos/" class="md-nav__link">
  1325. <span class="md-ellipsis">
  1326. Demos
  1327. </span>
  1328. </a>
  1329. </li>
  1330. <li class="md-nav__item">
  1331. <a href="../../eso-blogs/" class="md-nav__link">
  1332. <span class="md-ellipsis">
  1333. Blogs
  1334. </span>
  1335. </a>
  1336. </li>
  1337. <li class="md-nav__item">
  1338. <a href="../../eso-tools/" class="md-nav__link">
  1339. <span class="md-ellipsis">
  1340. Tools
  1341. </span>
  1342. </a>
  1343. </li>
  1344. </ul>
  1345. </nav>
  1346. </li>
  1347. </ul>
  1348. </nav>
  1349. </li>
  1350. </ul>
  1351. </nav>
  1352. </div>
  1353. </div>
  1354. </div>
  1355. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1356. <div class="md-sidebar__scrollwrap">
  1357. <div class="md-sidebar__inner">
  1358. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1359. <label class="md-nav__title" for="__toc">
  1360. <span class="md-nav__icon md-icon"></span>
  1361. Table of contents
  1362. </label>
  1363. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  1364. <li class="md-nav__item">
  1365. <a href="#parameter-store" class="md-nav__link">
  1366. <span class="md-ellipsis">
  1367. Parameter Store
  1368. </span>
  1369. </a>
  1370. <nav class="md-nav" aria-label="Parameter Store">
  1371. <ul class="md-nav__list">
  1372. <li class="md-nav__item">
  1373. <a href="#iam-policy" class="md-nav__link">
  1374. <span class="md-ellipsis">
  1375. IAM Policy
  1376. </span>
  1377. </a>
  1378. <nav class="md-nav" aria-label="IAM Policy">
  1379. <ul class="md-nav__list">
  1380. <li class="md-nav__item">
  1381. <a href="#fetching-parameters" class="md-nav__link">
  1382. <span class="md-ellipsis">
  1383. Fetching Parameters
  1384. </span>
  1385. </a>
  1386. </li>
  1387. <li class="md-nav__item">
  1388. <a href="#pushing-parameters" class="md-nav__link">
  1389. <span class="md-ellipsis">
  1390. Pushing Parameters
  1391. </span>
  1392. </a>
  1393. </li>
  1394. </ul>
  1395. </nav>
  1396. </li>
  1397. <li class="md-nav__item">
  1398. <a href="#json-secret-values" class="md-nav__link">
  1399. <span class="md-ellipsis">
  1400. JSON Secret Values
  1401. </span>
  1402. </a>
  1403. </li>
  1404. <li class="md-nav__item">
  1405. <a href="#parameter-versions" class="md-nav__link">
  1406. <span class="md-ellipsis">
  1407. Parameter Versions
  1408. </span>
  1409. </a>
  1410. </li>
  1411. </ul>
  1412. </nav>
  1413. </li>
  1414. <li class="md-nav__item">
  1415. <a href="#setsecret" class="md-nav__link">
  1416. <span class="md-ellipsis">
  1417. SetSecret
  1418. </span>
  1419. </a>
  1420. <nav class="md-nav" aria-label="SetSecret">
  1421. <ul class="md-nav__list">
  1422. <li class="md-nav__item">
  1423. <a href="#creating-a-push-secret" class="md-nav__link">
  1424. <span class="md-ellipsis">
  1425. Creating a Push Secret
  1426. </span>
  1427. </a>
  1428. <nav class="md-nav" aria-label="Creating a Push Secret">
  1429. <ul class="md-nav__list">
  1430. <li class="md-nav__item">
  1431. <a href="#additional-metadata-for-pushsecret" class="md-nav__link">
  1432. <span class="md-ellipsis">
  1433. Additional Metadata for PushSecret
  1434. </span>
  1435. </a>
  1436. </li>
  1437. <li class="md-nav__item">
  1438. <a href="#check-successful-secret-sync" class="md-nav__link">
  1439. <span class="md-ellipsis">
  1440. Check successful secret sync
  1441. </span>
  1442. </a>
  1443. </li>
  1444. <li class="md-nav__item">
  1445. <a href="#test-new-secret-using-aws-cli" class="md-nav__link">
  1446. <span class="md-ellipsis">
  1447. Test new secret using AWS CLI
  1448. </span>
  1449. </a>
  1450. </li>
  1451. </ul>
  1452. </nav>
  1453. </li>
  1454. </ul>
  1455. </nav>
  1456. </li>
  1457. <li class="md-nav__item">
  1458. <a href="#aws-authentication" class="md-nav__link">
  1459. <span class="md-ellipsis">
  1460. AWS Authentication
  1461. </span>
  1462. </a>
  1463. <nav class="md-nav" aria-label="AWS Authentication">
  1464. <ul class="md-nav__list">
  1465. <li class="md-nav__item">
  1466. <a href="#controllers-pod-identity" class="md-nav__link">
  1467. <span class="md-ellipsis">
  1468. Controller's Pod Identity
  1469. </span>
  1470. </a>
  1471. </li>
  1472. <li class="md-nav__item">
  1473. <a href="#access-key-id-secret-access-key" class="md-nav__link">
  1474. <span class="md-ellipsis">
  1475. Access Key ID &amp; Secret Access Key
  1476. </span>
  1477. </a>
  1478. </li>
  1479. <li class="md-nav__item">
  1480. <a href="#eks-service-account-credentials" class="md-nav__link">
  1481. <span class="md-ellipsis">
  1482. EKS Service Account credentials
  1483. </span>
  1484. </a>
  1485. </li>
  1486. </ul>
  1487. </nav>
  1488. </li>
  1489. <li class="md-nav__item">
  1490. <a href="#eks-pod-identity-setup" class="md-nav__link">
  1491. <span class="md-ellipsis">
  1492. EKS Pod Identity Setup
  1493. </span>
  1494. </a>
  1495. </li>
  1496. <li class="md-nav__item">
  1497. <a href="#custom-endpoints" class="md-nav__link">
  1498. <span class="md-ellipsis">
  1499. Custom Endpoints
  1500. </span>
  1501. </a>
  1502. </li>
  1503. </ul>
  1504. </nav>
  1505. </div>
  1506. </div>
  1507. </div>
  1508. <div class="md-content" data-md-component="content">
  1509. <article class="md-content__inner md-typeset">
  1510. <h1>AWS Parameter Store</h1>
  1511. <p><img alt="aws sm" src="../../pictures/diagrams-provider-aws-ssm-parameter-store.png" /></p>
  1512. <h2 id="parameter-store">Parameter Store</h2>
  1513. <p>A <code>ParameterStore</code> points to AWS SSM Parameter Store in a certain account within a
  1514. defined region. You should define Roles that define fine-grained access to
  1515. individual secrets and pass them to ESO using <code>spec.provider.aws.role</code>. This
  1516. way users of the <code>SecretStore</code> can only access the secrets necessary.</p>
  1517. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1518. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1519. <span class="nt">metadata</span><span class="p">:</span>
  1520. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">parameterstore</span>
  1521. <span class="nt">spec</span><span class="p">:</span>
  1522. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1523. <span class="w"> </span><span class="nt">aws</span><span class="p">:</span>
  1524. <span class="w"> </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ParameterStore</span>
  1525. <span class="w"> </span><span class="c1"># define a specific role to limit access</span>
  1526. <span class="w"> </span><span class="c1"># to certain secrets</span>
  1527. <span class="w"> </span><span class="nt">role</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">arn:aws:iam::123456789012:role/external-secrets</span>
  1528. <span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eu-central-1</span>
  1529. <span class="w"> </span><span class="nt">auth</span><span class="p">:</span>
  1530. <span class="w"> </span><span class="nt">secretRef</span><span class="p">:</span>
  1531. <span class="w"> </span><span class="nt">accessKeyIDSecretRef</span><span class="p">:</span>
  1532. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">awssm-secret</span>
  1533. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">access-key</span>
  1534. <span class="w"> </span><span class="nt">secretAccessKeySecretRef</span><span class="p">:</span>
  1535. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">awssm-secret</span>
  1536. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secret-access-key</span>
  1537. </code></pre></div>
  1538. <p><strong>NOTE:</strong> In case of a <code>ClusterSecretStore</code>, Be sure to provide <code>namespace</code> in <code>accessKeyIDSecretRef</code> and <code>secretAccessKeySecretRef</code> with the namespaces where the secrets reside.</p>
  1539. <div class="admonition warning">
  1540. <p class="admonition-title">API Pricing &amp; Throttling</p>
  1541. <p>The SSM Parameter Store API is charged by throughput and
  1542. is available in different tiers, <a href="https://aws.amazon.com/systems-manager/pricing/#Parameter_Store">see pricing</a>.
  1543. Please estimate your costs before using ESO. Cost depends on the RefreshInterval of your ExternalSecrets.</p>
  1544. </div>
  1545. <h3 id="iam-policy">IAM Policy</h3>
  1546. <h4 id="fetching-parameters">Fetching Parameters</h4>
  1547. <p>The example policy below shows the minimum required permissions for fetching SSM parameters. This policy permits pinning down access to secrets with a path matching <code>dev-*</code>. Other operations may require additional permission. For example, finding parameters based on tags will also require <code>ssm:DescribeParameters</code> and <code>tag:GetResources</code> permission with <code>"Resource": "*"</code>. Generally, the specific permission required will be logged as an error if an operation fails.</p>
  1548. <p>For further information see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-access.html">AWS Documentation</a>.</p>
  1549. <div class="highlight"><pre><span></span><code><span class="p">{</span>
  1550. <span class="w"> </span><span class="nt">&quot;Version&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;2012-10-17&quot;</span><span class="p">,</span>
  1551. <span class="w"> </span><span class="nt">&quot;Statement&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1552. <span class="w"> </span><span class="p">{</span>
  1553. <span class="w"> </span><span class="nt">&quot;Effect&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Allow&quot;</span><span class="p">,</span>
  1554. <span class="w"> </span><span class="nt">&quot;Action&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1555. <span class="w"> </span><span class="s2">&quot;ssm:GetParameter*&quot;</span><span class="p">,</span>
  1556. <span class="w"> </span><span class="p">],</span>
  1557. <span class="w"> </span><span class="nt">&quot;Resource&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;arn:aws:ssm:us-east-2:1234567889911:parameter/dev-*&quot;</span>
  1558. <span class="w"> </span><span class="p">}</span>
  1559. <span class="w"> </span><span class="p">]</span>
  1560. <span class="p">}</span>
  1561. </code></pre></div>
  1562. <h4 id="pushing-parameters">Pushing Parameters</h4>
  1563. <p>The example policy below shows the minimum required permissions for pushing SSM parameters. Like with the fetching policy it restricts the path in which it can push secrets too.</p>
  1564. <div class="highlight"><pre><span></span><code><span class="p">{</span>
  1565. <span class="w"> </span><span class="nt">&quot;Action&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1566. <span class="w"> </span><span class="s2">&quot;ssm:GetParameter*&quot;</span><span class="p">,</span>
  1567. <span class="w"> </span><span class="s2">&quot;ssm:PutParameter*&quot;</span><span class="p">,</span>
  1568. <span class="w"> </span><span class="s2">&quot;ssm:AddTagsToResource&quot;</span><span class="p">,</span>
  1569. <span class="w"> </span><span class="s2">&quot;ssm:ListTagsForResource&quot;</span>
  1570. <span class="w"> </span><span class="p">],</span>
  1571. <span class="w"> </span><span class="nt">&quot;Effect&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Allow&quot;</span><span class="p">,</span>
  1572. <span class="w"> </span><span class="nt">&quot;Resource&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;arn:aws:ssm:us-east-2:1234567889911:parameter/dev-*&quot;</span>
  1573. <span class="p">}</span>
  1574. </code></pre></div>
  1575. <h3 id="json-secret-values">JSON Secret Values</h3>
  1576. <p>You can store JSON objects in a parameter. You can access nested values or arrays using <a href="https://github.com/tidwall/gjson/blob/master/SYNTAX.md">gjson syntax</a>:</p>
  1577. <p>Consider the following JSON object that is stored in the Parameter Store key <code>friendslist</code>:</p>
  1578. <div class="highlight"><pre><span></span><code><span class="p">{</span>
  1579. <span class="w"> </span><span class="nt">&quot;name&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="nt">&quot;first&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Tom&quot;</span><span class="p">,</span><span class="w"> </span><span class="nt">&quot;last&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Anderson&quot;</span><span class="p">},</span>
  1580. <span class="w"> </span><span class="nt">&quot;friends&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1581. <span class="w"> </span><span class="p">{</span><span class="nt">&quot;first&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Dale&quot;</span><span class="p">,</span><span class="w"> </span><span class="nt">&quot;last&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Murphy&quot;</span><span class="p">},</span>
  1582. <span class="w"> </span><span class="p">{</span><span class="nt">&quot;first&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Roger&quot;</span><span class="p">,</span><span class="w"> </span><span class="nt">&quot;last&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Craig&quot;</span><span class="p">},</span>
  1583. <span class="w"> </span><span class="p">{</span><span class="nt">&quot;first&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Jane&quot;</span><span class="p">,</span><span class="w"> </span><span class="nt">&quot;last&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Murphy&quot;</span><span class="p">}</span>
  1584. <span class="w"> </span><span class="p">]</span>
  1585. <span class="p">}</span>
  1586. </code></pre></div>
  1587. <p>This is an example on how you would look up nested keys in the above json object:</p>
  1588. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1589. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ExternalSecret</span>
  1590. <span class="nt">metadata</span><span class="p">:</span>
  1591. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">extract-data</span>
  1592. <span class="nt">spec</span><span class="p">:</span>
  1593. <span class="w"> </span><span class="c1"># [omitted for brevity]</span>
  1594. <span class="w"> </span><span class="nt">data</span><span class="p">:</span>
  1595. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">secretKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my_name</span>
  1596. <span class="w"> </span><span class="nt">remoteRef</span><span class="p">:</span>
  1597. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">friendslist</span>
  1598. <span class="w"> </span><span class="nt">property</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">name.first</span><span class="w"> </span><span class="c1"># Tom</span>
  1599. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">secretKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">first_friend</span>
  1600. <span class="w"> </span><span class="nt">remoteRef</span><span class="p">:</span>
  1601. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">friendslist</span>
  1602. <span class="w"> </span><span class="nt">property</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">friends.1.first</span><span class="w"> </span><span class="c1"># Roger</span>
  1603. <span class="w"> </span><span class="c1"># metadataPolicy to fetch all the tags in JSON format</span>
  1604. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">secretKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">tags</span>
  1605. <span class="w"> </span><span class="nt">remoteRef</span><span class="p">:</span>
  1606. <span class="w"> </span><span class="nt">metadataPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Fetch</span>
  1607. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">database-credentials</span>
  1608. <span class="w"> </span><span class="c1"># metadataPolicy to fetch a specific tag (dev) from the source secret</span>
  1609. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">secretKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">developer</span>
  1610. <span class="w"> </span><span class="nt">remoteRef</span><span class="p">:</span>
  1611. <span class="w"> </span><span class="nt">metadataPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Fetch</span>
  1612. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">database-credentials</span>
  1613. <span class="w"> </span><span class="nt">property</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dev</span>
  1614. </code></pre></div>
  1615. <h3 id="parameter-versions">Parameter Versions</h3>
  1616. <p>ParameterStore creates a new version of a parameter every time it is updated with a new value. The parameter can be referenced via the <code>version</code> property</p>
  1617. <h2 id="setsecret">SetSecret</h2>
  1618. <p>The SetSecret method for the Parameter Store allows the user to set the value stored within the Kubernetes cluster to the remote AWS Parameter Store.</p>
  1619. <h3 id="creating-a-push-secret">Creating a Push Secret</h3>
  1620. <div class="highlight"><pre><span></span><code><span class="nn">---</span>
  1621. <span class="c1"># The source secret that will be pushed to the destination secret by PushSecret.</span>
  1622. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
  1623. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
  1624. <span class="nt">metadata</span><span class="p">:</span>
  1625. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pushsecret-example</span>
  1626. <span class="nt">stringData</span><span class="p">:</span>
  1627. <span class="w"> </span><span class="nt">best-pokemon-src</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;Pikachu&quot;</span>
  1628. <span class="nn">---</span>
  1629. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1alpha1</span>
  1630. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PushSecret</span>
  1631. <span class="nt">metadata</span><span class="p">:</span>
  1632. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pushsecret-example</span><span class="w"> </span><span class="c1"># Customisable</span>
  1633. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span><span class="w"> </span><span class="c1"># Same of the SecretStores</span>
  1634. <span class="nt">spec</span><span class="p">:</span>
  1635. <span class="w"> </span><span class="nt">updatePolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Replace</span><span class="w"> </span><span class="c1"># Policy to overwrite existing secrets in the provider on sync</span>
  1636. <span class="w"> </span><span class="nt">deletionPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Delete</span><span class="w"> </span><span class="c1"># the provider&#39; secret will be deleted if the PushSecret is deleted</span>
  1637. <span class="w"> </span><span class="nt">refreshInterval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1h</span><span class="w"> </span><span class="c1"># Refresh interval for which push secret will reconcile</span>
  1638. <span class="w"> </span><span class="nt">secretStoreRefs</span><span class="p">:</span><span class="w"> </span><span class="c1"># A list of secret stores to push secrets to</span>
  1639. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">aws-parameterstore</span>
  1640. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1641. <span class="w"> </span><span class="nt">selector</span><span class="p">:</span>
  1642. <span class="w"> </span><span class="nt">secret</span><span class="p">:</span>
  1643. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pokedex-credentials</span><span class="w"> </span><span class="c1"># Source Kubernetes secret to be pushed</span>
  1644. <span class="w"> </span><span class="c1"># Alternatively, you can point to a generator that produces values to be pushed</span>
  1645. <span class="w"> </span><span class="nt">generatorRef</span><span class="p">:</span>
  1646. <span class="w"> </span><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">generators.external-secrets.io/v1alpha1</span>
  1647. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ECRAuthorizationToken</span>
  1648. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">prod-registry-credentials</span>
  1649. <span class="w"> </span><span class="nt">template</span><span class="p">:</span>
  1650. <span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
  1651. <span class="w"> </span><span class="nt">annotations</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="w"> </span><span class="p p-Indicator">}</span>
  1652. <span class="w"> </span><span class="nt">labels</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="w"> </span><span class="p p-Indicator">}</span>
  1653. <span class="w"> </span><span class="nt">data</span><span class="p">:</span>
  1654. <span class="w"> </span><span class="c1"># If the key source secret key has dashes, then it cannot be accessed directly,</span>
  1655. <span class="w"> </span><span class="c1"># and the &quot;index&quot; function should be used.</span>
  1656. <span class="w"> </span><span class="nt">best-pokemon</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;{{</span><span class="nv"> </span><span class="s">index</span><span class="nv"> </span><span class="s">.</span><span class="nv"> </span><span class="s">\&quot;best-pokemon-src\&quot;</span><span class="nv"> </span><span class="s">|</span><span class="nv"> </span><span class="s">toString</span><span class="nv"> </span><span class="s">|</span><span class="nv"> </span><span class="s">upper</span><span class="nv"> </span><span class="s">}}</span><span class="nv"> </span><span class="s">is</span><span class="nv"> </span><span class="s">the</span><span class="nv"> </span><span class="s">really</span><span class="nv"> </span><span class="s">best!&quot;</span>
  1657. <span class="w"> </span><span class="c1"># Also, it&#39;s possible to use an existing template from configmap where Secret is fetched, </span>
  1658. <span class="w"> </span><span class="c1"># merged and templated within the referenced configMap data.</span>
  1659. <span class="w"> </span><span class="c1"># It does not update the configmap, it creates a secret with: data[&quot;config.yml&quot;] = ...result...</span>
  1660. <span class="w"> </span><span class="nt">templateFrom</span><span class="p">:</span>
  1661. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">configMap</span><span class="p">:</span>
  1662. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">application-config-tmpl</span>
  1663. <span class="w"> </span><span class="nt">items</span><span class="p">:</span>
  1664. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">config.yml</span>
  1665. <span class="w"> </span><span class="nt">data</span><span class="p">:</span>
  1666. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">conversionStrategy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">None</span><span class="w"> </span><span class="c1"># Also supports the ReverseUnicode strategy</span>
  1667. <span class="w"> </span><span class="nt">match</span><span class="p">:</span>
  1668. <span class="w"> </span><span class="c1"># The secretKey is used within PushSecret (it should match key under spec.template.data)</span>
  1669. <span class="w"> </span><span class="nt">secretKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">best-pokemon</span>
  1670. <span class="w"> </span><span class="nt">remoteRef</span><span class="p">:</span>
  1671. <span class="w"> </span><span class="nt">remoteKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">destination-secret</span><span class="w"> </span><span class="c1"># The destination secret object name (where the secret is going to be pushed)</span>
  1672. <span class="w"> </span><span class="nt">property</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">best-pokemon-dst</span><span class="w"> </span><span class="c1"># The key within the destination secret object.</span>
  1673. </code></pre></div>
  1674. <h4 id="additional-metadata-for-pushsecret">Additional Metadata for PushSecret</h4>
  1675. <p>Optionally, it is possible to configure additional options for the parameter. These are as follows:
  1676. - type
  1677. - keyID
  1678. - tier &amp; policies
  1679. - encodeAsDecoded</p>
  1680. <p>To control this behaviour you can set the following provider's <code>metadata</code>:</p>
  1681. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1alpha1</span>
  1682. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PushSecret</span>
  1683. <span class="nt">metadata</span><span class="p">:</span>
  1684. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pushsecret-example</span><span class="w"> </span><span class="c1"># Customisable</span>
  1685. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span><span class="w"> </span><span class="c1"># Same of the SecretStores</span>
  1686. <span class="nt">spec</span><span class="p">:</span>
  1687. <span class="w"> </span><span class="nt">deletionPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Delete</span><span class="w"> </span><span class="c1"># the provider&#39; secret will be deleted if the PushSecret is deleted</span>
  1688. <span class="w"> </span><span class="nt">refreshInterval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1h</span><span class="w"> </span><span class="c1"># Refresh interval for which push secret will reconcile</span>
  1689. <span class="w"> </span><span class="nt">secretStoreRefs</span><span class="p">:</span><span class="w"> </span><span class="c1"># A list of secret stores to push secrets to</span>
  1690. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">aws-parameterstore</span>
  1691. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1692. <span class="w"> </span><span class="nt">selector</span><span class="p">:</span>
  1693. <span class="w"> </span><span class="nt">secret</span><span class="p">:</span>
  1694. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pokedex-credentials</span><span class="w"> </span><span class="c1"># Source Kubernetes secret to be pushed</span>
  1695. <span class="w"> </span><span class="nt">data</span><span class="p">:</span>
  1696. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">match</span><span class="p">:</span>
  1697. <span class="w"> </span><span class="nt">remoteRef</span><span class="p">:</span>
  1698. <span class="w"> </span><span class="nt">remoteKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-first-parameter</span><span class="w"> </span><span class="c1"># Remote reference (where the secret is going to be pushed)</span>
  1699. <span class="w"> </span><span class="nt">metadata</span><span class="p">:</span>
  1700. <span class="w"> </span><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kubernetes.external-secrets.io/v1alpha1</span>
  1701. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PushSecretMetadata</span>
  1702. <span class="w"> </span><span class="nt">spec</span><span class="p">:</span>
  1703. <span class="w"> </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;This</span><span class="nv"> </span><span class="s">is</span><span class="nv"> </span><span class="s">a</span><span class="nv"> </span><span class="s">secret</span><span class="nv"> </span><span class="s">for</span><span class="nv"> </span><span class="s">the</span><span class="nv"> </span><span class="s">API</span><span class="nv"> </span><span class="s">credentials&quot;</span>
  1704. <span class="w"> </span><span class="nt">secretType</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecureString</span>
  1705. <span class="w"> </span><span class="nt">kmsKeyID</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">bb123123-b2b0-4f60-ac3a-44a13f0e6b6c</span>
  1706. <span class="w"> </span><span class="nt">tier</span><span class="p">:</span>
  1707. <span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Advanced</span><span class="w"> </span><span class="c1"># default is Standard</span>
  1708. <span class="w"> </span><span class="nt">policies</span><span class="p">:</span>
  1709. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;Expiration&quot;</span>
  1710. <span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1.0&quot;</span>
  1711. <span class="w"> </span><span class="nt">attributes</span><span class="p">:</span>
  1712. <span class="w"> </span><span class="nt">timestamp</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2024-12-02T21:34:33.000Z&quot;</span>
  1713. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;ExpirationNotification&quot;</span>
  1714. <span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1.0&quot;</span>
  1715. <span class="w"> </span><span class="nt">attributes</span><span class="p">:</span>
  1716. <span class="w"> </span><span class="nt">before</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;2&quot;</span>
  1717. <span class="w"> </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;Days&quot;</span>
  1718. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;ExpirationNotification&quot;</span>
  1719. <span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1.0&quot;</span>
  1720. <span class="w"> </span><span class="nt">attributes</span><span class="p">:</span>
  1721. <span class="w"> </span><span class="nt">before</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;30&quot;</span>
  1722. <span class="w"> </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;Days&quot;</span>
  1723. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;NoChangeNotification&quot;</span>
  1724. <span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;1.0&quot;</span>
  1725. <span class="w"> </span><span class="nt">attributes</span><span class="p">:</span>
  1726. <span class="w"> </span><span class="nt">after</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;30&quot;</span>
  1727. <span class="w"> </span><span class="nt">unit</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;Days&quot;</span>
  1728. <span class="w"> </span><span class="nt">tags</span><span class="p">:</span>
  1729. <span class="w"> </span><span class="nt">environment</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">sandbox</span>
  1730. <span class="w"> </span><span class="nt">team</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pokedex</span>
  1731. <span class="w"> </span><span class="nt">secret-store</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">aws-parameterstore</span>
  1732. <span class="w"> </span><span class="nt">refresh-interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1h</span>
  1733. </code></pre></div>
  1734. <ul>
  1735. <li><code>secretType</code> takes three options. <code>String</code>, <code>StringList</code>, and <code>SecureString</code>, where <code>String</code> is the <em>default</em></li>
  1736. <li><code>kmsKeyID</code> takes a KMS Key <code>$ID</code> or <code>$ARN</code> (in case a key source is created in another account) as a string, where <code>alias/aws/ssm</code> is the <em>default</em>. This property is only used if <code>secretType</code> is set as <code>SecureString</code>.</li>
  1737. <li>tier &amp; policies contains advanced policy configs such as <code>ExpirationNotification</code>.</li>
  1738. <li>encodeAsDecoded if set to true will get the secrets and push them as plain values when pushing the entire secret (instead of encoding them)
  1739. instead of base64 encoding the []byte values from the secret.</li>
  1740. </ul>
  1741. <h4 id="check-successful-secret-sync">Check successful secret sync</h4>
  1742. <p>To be able to check that the secret has been successfully synced you can run the following command:</p>
  1743. <div class="highlight"><pre><span></span><code>kubectl<span class="w"> </span>get<span class="w"> </span>pushsecret<span class="w"> </span>pushsecret-example
  1744. </code></pre></div>
  1745. <p>If the secret has synced successfully it will show the status as "Synced".</p>
  1746. <h4 id="test-new-secret-using-aws-cli">Test new secret using AWS CLI</h4>
  1747. <p>To View your parameter on AWS Parameter Store using the AWS CLI, install and login to the AWS CLI using the following guide: <a href="https://aws.amazon.com/cli/">AWS CLI</a>.</p>
  1748. <p>Run the following commands to get your synchronized parameter from AWS Parameter Store:</p>
  1749. <div class="highlight"><pre><span></span><code>aws<span class="w"> </span>ssm<span class="w"> </span>get-parameter<span class="w"> </span>--name<span class="o">=</span>my-first-parameter<span class="w"> </span>--region<span class="o">=</span>us-east-1
  1750. </code></pre></div>
  1751. <p>You should see something similar to the following output:</p>
  1752. <div class="highlight"><pre><span></span><code><span class="p">{</span>
  1753. <span class="w"> </span><span class="nt">&quot;Parameter&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
  1754. <span class="w"> </span><span class="nt">&quot;Name&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;my-first-parameter&quot;</span><span class="p">,</span>
  1755. <span class="w"> </span><span class="nt">&quot;Type&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;String&quot;</span><span class="p">,</span>
  1756. <span class="w"> </span><span class="nt">&quot;Value&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;charmander&quot;</span><span class="p">,</span>
  1757. <span class="w"> </span><span class="nt">&quot;Version&quot;</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span>
  1758. <span class="w"> </span><span class="nt">&quot;LastModifiedDate&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;2022-09-15T13:04:31.098000-03:00&quot;</span><span class="p">,</span>
  1759. <span class="w"> </span><span class="nt">&quot;ARN&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;arn:aws:ssm:us-east-1:1234567890123:parameter/my-first-parameter&quot;</span><span class="p">,</span>
  1760. <span class="w"> </span><span class="nt">&quot;DataType&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;text&quot;</span>
  1761. <span class="w"> </span><span class="p">}</span>
  1762. <span class="p">}</span>
  1763. </code></pre></div>
  1764. <h2 id="aws-authentication">AWS Authentication</h2>
  1765. <h3 id="controllers-pod-identity">Controller's Pod Identity</h3>
  1766. <p><img alt="Pod Identity Authentication" src="../../pictures/diagrams-provider-aws-auth-pod-identity.png" /></p>
  1767. <p>Note: If you are using Parameter Store replace <code>service: SecretsManager</code> with <code>service: ParameterStore</code> in all examples below.</p>
  1768. <p>This is basically a zero-configuration authentication method that inherits the credentials from the runtime environment using the <a href="https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default">aws sdk default credential chain</a>.</p>
  1769. <p>You can attach a role to the pod using <a href="https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html">IRSA</a>, <a href="https://github.com/uswitch/kiam">kiam</a> or <a href="https://github.com/jtblin/kube2iam">kube2iam</a>. When no other authentication method is configured in the <code>Kind=Secretstore</code> this role is used to make all API calls against AWS Secrets Manager or SSM Parameter Store.</p>
  1770. <p>Based on the Pod's identity you can do a <code>sts:assumeRole</code> before fetching the secrets to limit access to certain keys in your provider. This is optional.</p>
  1771. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1772. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1773. <span class="nt">metadata</span><span class="p">:</span>
  1774. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">team-b-store</span>
  1775. <span class="nt">spec</span><span class="p">:</span>
  1776. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1777. <span class="w"> </span><span class="nt">aws</span><span class="p">:</span>
  1778. <span class="w"> </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretsManager</span>
  1779. <span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eu-central-1</span>
  1780. <span class="w"> </span><span class="c1"># optional: do a sts:assumeRole before fetching secrets</span>
  1781. <span class="w"> </span><span class="nt">role</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">team-b</span>
  1782. </code></pre></div>
  1783. <h3 id="access-key-id-secret-access-key">Access Key ID &amp; Secret Access Key</h3>
  1784. <p><img alt="SecretRef" src="../../pictures/diagrams-provider-aws-auth-secret-ref.png" /></p>
  1785. <p>You can store Access Key ID &amp; Secret Access Key in a <code>Kind=Secret</code> and reference it from a SecretStore.</p>
  1786. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1787. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1788. <span class="nt">metadata</span><span class="p">:</span>
  1789. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">team-b-store</span>
  1790. <span class="nt">spec</span><span class="p">:</span>
  1791. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1792. <span class="w"> </span><span class="nt">aws</span><span class="p">:</span>
  1793. <span class="w"> </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretsManager</span>
  1794. <span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eu-central-1</span>
  1795. <span class="w"> </span><span class="c1"># optional: assume role before fetching secrets</span>
  1796. <span class="w"> </span><span class="nt">role</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">team-b</span>
  1797. <span class="w"> </span><span class="nt">auth</span><span class="p">:</span>
  1798. <span class="w"> </span><span class="nt">secretRef</span><span class="p">:</span>
  1799. <span class="w"> </span><span class="nt">accessKeyIDSecretRef</span><span class="p">:</span>
  1800. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">awssm-secret</span>
  1801. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">access-key</span>
  1802. <span class="w"> </span><span class="nt">secretAccessKeySecretRef</span><span class="p">:</span>
  1803. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">awssm-secret</span>
  1804. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secret-access-key</span>
  1805. </code></pre></div>
  1806. <p><strong>NOTE:</strong> In case of a <code>ClusterSecretStore</code>, Be sure to provide <code>namespace</code> in <code>accessKeyIDSecretRef</code>, <code>secretAccessKeySecretRef</code> with the namespaces where the secrets reside.</p>
  1807. <h3 id="eks-service-account-credentials">EKS Service Account credentials</h3>
  1808. <p><img alt="Service Account" src="../../pictures/diagrams-provider-aws-auth-service-account.png" /></p>
  1809. <p>This feature lets you use short-lived service account tokens to authenticate with AWS.
  1810. You must have <a href="https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#service-account-token-volume-projection">Service Account Volume Projection</a> enabled - it is by default on EKS. See <a href="https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts-technical-overview.html">EKS guide</a> on how to set up IAM roles for service accounts.</p>
  1811. <p>The big advantage of this approach is that ESO runs without any credentials.</p>
  1812. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
  1813. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ServiceAccount</span>
  1814. <span class="nt">metadata</span><span class="p">:</span>
  1815. <span class="w"> </span><span class="nt">annotations</span><span class="p">:</span>
  1816. <span class="w"> </span><span class="nt">eks.amazonaws.com/role-arn</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">arn:aws:iam::123456789012:role/team-a</span>
  1817. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-serviceaccount</span>
  1818. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span>
  1819. </code></pre></div>
  1820. <p>Reference the service account from above in the Secret Store:</p>
  1821. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1822. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1823. <span class="nt">metadata</span><span class="p">:</span>
  1824. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secretstore-sample</span>
  1825. <span class="nt">spec</span><span class="p">:</span>
  1826. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1827. <span class="w"> </span><span class="nt">aws</span><span class="p">:</span>
  1828. <span class="w"> </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretsManager</span>
  1829. <span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eu-central-1</span>
  1830. <span class="w"> </span><span class="nt">auth</span><span class="p">:</span>
  1831. <span class="w"> </span><span class="nt">jwt</span><span class="p">:</span>
  1832. <span class="w"> </span><span class="nt">serviceAccountRef</span><span class="p">:</span>
  1833. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my-serviceaccount</span>
  1834. </code></pre></div>
  1835. <p><strong>NOTE:</strong> In case of a <code>ClusterSecretStore</code>, Be sure to provide <code>namespace</code> for <code>serviceAccountRef</code> with the namespace where the service account resides.</p>
  1836. <h2 id="eks-pod-identity-setup">EKS Pod Identity Setup</h2>
  1837. <p>In order to use EKS Pod Identity Agent, create a role like this:</p>
  1838. <div class="highlight"><pre><span></span><code><span class="p">{</span>
  1839. <span class="w"> </span><span class="nt">&quot;Statement&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1840. <span class="w"> </span><span class="p">{</span>
  1841. <span class="w"> </span><span class="nt">&quot;Action&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1842. <span class="w"> </span><span class="s2">&quot;secretsmanager:GetResourcePolicy&quot;</span><span class="p">,</span>
  1843. <span class="w"> </span><span class="s2">&quot;secretsmanager:GetSecretValue&quot;</span><span class="p">,</span>
  1844. <span class="w"> </span><span class="s2">&quot;secretsmanager:DescribeSecret&quot;</span><span class="p">,</span>
  1845. <span class="w"> </span><span class="s2">&quot;secretsmanager:ListSecretVersionIds&quot;</span>
  1846. <span class="w"> </span><span class="p">],</span>
  1847. <span class="w"> </span><span class="nt">&quot;Effect&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Allow&quot;</span><span class="p">,</span>
  1848. <span class="w"> </span><span class="nt">&quot;Resource&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1849. <span class="w"> </span><span class="s2">&quot;*&quot;</span>
  1850. <span class="w"> </span><span class="p">]</span>
  1851. <span class="w"> </span><span class="p">}</span>
  1852. <span class="w"> </span><span class="p">],</span>
  1853. <span class="w"> </span><span class="nt">&quot;Version&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;2012-10-17&quot;</span>
  1854. <span class="p">}</span>
  1855. </code></pre></div>
  1856. <div class="highlight"><pre><span></span><code><span class="p">{</span>
  1857. <span class="w"> </span><span class="nt">&quot;Version&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;2012-10-17&quot;</span><span class="p">,</span>
  1858. <span class="w"> </span><span class="nt">&quot;Statement&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1859. <span class="w"> </span><span class="p">{</span>
  1860. <span class="w"> </span><span class="nt">&quot;Sid&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;AllowEksAuthToAssumeRoleForPodIdentity&quot;</span><span class="p">,</span>
  1861. <span class="w"> </span><span class="nt">&quot;Effect&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Allow&quot;</span><span class="p">,</span>
  1862. <span class="w"> </span><span class="nt">&quot;Principal&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
  1863. <span class="w"> </span><span class="nt">&quot;Service&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;pods.eks.amazonaws.com&quot;</span>
  1864. <span class="w"> </span><span class="p">},</span>
  1865. <span class="w"> </span><span class="nt">&quot;Action&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
  1866. <span class="w"> </span><span class="s2">&quot;sts:AssumeRole&quot;</span><span class="p">,</span>
  1867. <span class="w"> </span><span class="s2">&quot;sts:TagSession&quot;</span>
  1868. <span class="w"> </span><span class="p">]</span>
  1869. <span class="w"> </span><span class="p">}</span>
  1870. <span class="w"> </span><span class="p">]</span>
  1871. <span class="p">}</span>
  1872. </code></pre></div>
  1873. <p>Install ESO using helm and define these values:</p>
  1874. <div class="highlight"><pre><span></span><code><span class="nt">serviceAccount</span><span class="p">:</span>
  1875. <span class="w"> </span><span class="nt">annotations</span><span class="p">:</span>
  1876. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span>
  1877. </code></pre></div>
  1878. <p>Create a pod association:</p>
  1879. <div class="highlight"><pre><span></span><code>aws eks create-pod-identity-association --cluster-name my-cluster --role-arn arn:aws:iam::111122223333:role/my-role --namespace external-secrets --service-account external-secrets
  1880. </code></pre></div>
  1881. <p>Then create a secret store like this:</p>
  1882. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1883. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1884. <span class="nt">metadata</span><span class="p">:</span>
  1885. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">store</span>
  1886. <span class="nt">spec</span><span class="p">:</span>
  1887. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1888. <span class="w"> </span><span class="nt">aws</span><span class="p">:</span>
  1889. <span class="w"> </span><span class="nt">service</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretsManager</span>
  1890. <span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">eu-central-1</span>
  1891. </code></pre></div>
  1892. <p><em>Note</em>: <code>serviceAccountRef</code> <em>cannot</em> be used together with EKS Pod Identity. That's because ESO can not impersonate
  1893. service accounts which have iam roles bound using pod identity. Doing so will result in an error like this:
  1894. <div class="highlight"><pre><span></span><code>unable to create session: an IAM role must be associated with service account ...
  1895. </code></pre></div></p>
  1896. <p><em>Note:</em> No <code>auth</code> section is defined for the SecretStore.</p>
  1897. <p><em>Note:</em> For even more details you can follow this post for more setup and information using Terraform <a href="https://containscloud.com/2024/03/24/integrating-aws-secrets-manager-to-eks-using-external-secrets/">here</a>.</p>
  1898. <h2 id="custom-endpoints">Custom Endpoints</h2>
  1899. <p>You can define custom AWS endpoints if you want to use regional, vpc or custom endpoints. See List of endpoints for <a href="https://docs.aws.amazon.com/general/latest/gr/asm.html">Secrets Manager</a>, <a href="https://docs.aws.amazon.com/general/latest/gr/ssm.html">Secure Systems Manager</a> and <a href="https://docs.aws.amazon.com/general/latest/gr/sts.html">Security Token Service</a>.</p>
  1900. <p>Use the following environment variables to point the controller to your custom endpoints. Note: All resources managed by this controller are affected.</p>
  1901. <table>
  1902. <thead>
  1903. <tr>
  1904. <th>ENV VAR</th>
  1905. <th>DESCRIPTION</th>
  1906. </tr>
  1907. </thead>
  1908. <tbody>
  1909. <tr>
  1910. <td>AWS_SECRETSMANAGER_ENDPOINT</td>
  1911. <td>Endpoint for the Secrets Manager Service. The controller uses this endpoint to fetch secrets from AWS Secrets Manager.</td>
  1912. </tr>
  1913. <tr>
  1914. <td>AWS_SSM_ENDPOINT</td>
  1915. <td>Endpoint for the AWS Secure Systems Manager. The controller uses this endpoint to fetch secrets from SSM Parameter Store.</td>
  1916. </tr>
  1917. <tr>
  1918. <td>AWS_STS_ENDPOINT</td>
  1919. <td>Endpoint for the Security Token Service. The controller uses this endpoint when creating a session and when doing <code>assumeRole</code> or <code>assumeRoleWithWebIdentity</code> calls.</td>
  1920. </tr>
  1921. <tr>
  1922. <td>AWS_ECR_ENDPOINT</td>
  1923. <td>Endpoint for the ECR Service. The controller uses this endpoint to fetch authorization tokens from ECR.</td>
  1924. </tr>
  1925. <tr>
  1926. <td>AWS_ECR_PUBLIC_ENDPOINT</td>
  1927. <td>Endpoint for the Public ECR Service. The controller uses this endpoint to fetch authorization tokens from ECR.</td>
  1928. </tr>
  1929. </tbody>
  1930. </table>
  1931. </article>
  1932. </div>
  1933. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  1934. </div>
  1935. </main>
  1936. <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""/>
  1937. <footer class="md-footer">
  1938. <div class="md-footer-meta md-typeset">
  1939. <div class="md-footer-meta__inner md-grid">
  1940. <div class="md-copyright">
  1941. <div class="md-copyright__highlight">
  1942. &copy; 2025 The external-secrets Authors.<br/>
  1943. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  1944. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  1945. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  1946. </div>
  1947. Made with
  1948. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  1949. Material for MkDocs
  1950. </a>
  1951. </div>
  1952. </div>
  1953. </div>
  1954. </footer>
  1955. </div>
  1956. <div class="md-dialog" data-md-component="dialog">
  1957. <div class="md-dialog__inner md-typeset"></div>
  1958. </div>
  1959. <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.indexes", "navigation.expand"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"provider": "mike"}}</script>
  1960. <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
  1961. </body>
  1962. </html>