index.html 673 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180918191829183918491859186918791889189919091919192919391949195919691979198919992009201920292039204920592069207920892099210921192129213921492159216921792189219922092219222922392249225922692279228922992309231923292339234923592369237923892399240924192429243924492459246924792489249925092519252925392549255925692579258925992609261926292639264926592669267926892699270927192729273927492759276927792789279928092819282928392849285928692879288928992909291929292939294929592969297929892999300930193029303930493059306930793089309931093119312931393149315931693179318931993209321932293239324932593269327932893299330933193329333933493359336933793389339934093419342934393449345934693479348934993509351935293539354935593569357935893599360936193629363936493659366936793689369937093719372937393749375937693779378937993809381938293839384938593869387938893899390939193929393939493959396939793989399940094019402940394049405940694079408940994109411941294139414941594169417941894199420942194229423942494259426942794289429943094319432943394349435943694379438943994409441944294439444944594469447944894499450945194529453945494559456945794589459946094619462946394649465946694679468946994709471947294739474947594769477947894799480948194829483948494859486948794889489949094919492949394949495949694979498949995009501950295039504950595069507950895099510951195129513951495159516951795189519952095219522952395249525952695279528952995309531953295339534953595369537953895399540954195429543954495459546954795489549955095519552955395549555955695579558955995609561956295639564956595669567956895699570957195729573957495759576957795789579958095819582958395849585958695879588958995909591959295939594959595969597959895999600960196029603960496059606960796089609961096119612961396149615961696179618961996209621962296239624962596269627962896299630963196329633963496359636963796389639964096419642964396449645964696479648964996509651965296539654965596569657965896599660966196629663966496659666966796689669967096719672967396749675967696779678967996809681968296839684968596869687968896899690969196929693969496959696969796989699970097019702970397049705970697079708970997109711971297139714971597169717971897199720972197229723972497259726972797289729973097319732973397349735973697379738973997409741974297439744974597469747974897499750975197529753975497559756975797589759976097619762976397649765976697679768976997709771977297739774977597769777977897799780978197829783978497859786978797889789979097919792979397949795979697979798979998009801980298039804980598069807980898099810981198129813981498159816981798189819982098219822982398249825982698279828982998309831983298339834983598369837983898399840984198429843984498459846984798489849985098519852985398549855985698579858985998609861986298639864986598669867986898699870987198729873987498759876987798789879988098819882988398849885988698879888988998909891989298939894989598969897989898999900990199029903990499059906990799089909991099119912991399149915991699179918991999209921992299239924992599269927992899299930993199329933993499359936993799389939994099419942994399449945994699479948994999509951995299539954995599569957995899599960996199629963996499659966996799689969997099719972997399749975997699779978997999809981998299839984998599869987998899899990999199929993999499959996999799989999100001000110002100031000410005100061000710008100091001010011100121001310014100151001610017100181001910020100211002210023100241002510026100271002810029100301003110032100331003410035100361003710038100391004010041100421004310044100451004610047100481004910050100511005210053100541005510056100571005810059100601006110062100631006410065100661006710068100691007010071100721007310074100751007610077100781007910080100811008210083100841008510086100871008810089100901009110092100931009410095100961009710098100991010010101101021010310104101051010610107101081010910110101111011210113101141011510116101171011810119101201012110122101231012410125101261012710128101291013010131101321013310134101351013610137101381013910140101411014210143101441014510146101471014810149101501015110152101531015410155101561015710158101591016010161101621016310164101651016610167101681016910170101711017210173101741017510176101771017810179101801018110182101831018410185101861018710188101891019010191101921019310194101951019610197101981019910200102011020210203102041020510206102071020810209102101021110212102131021410215102161021710218102191022010221102221022310224102251022610227102281022910230102311023210233102341023510236102371023810239102401024110242102431024410245102461024710248102491025010251102521025310254102551025610257102581025910260102611026210263102641026510266102671026810269102701027110272102731027410275102761027710278102791028010281102821028310284102851028610287102881028910290102911029210293102941029510296102971029810299103001030110302103031030410305103061030710308103091031010311103121031310314103151031610317103181031910320103211032210323103241032510326103271032810329103301033110332103331033410335103361033710338103391034010341103421034310344103451034610347103481034910350103511035210353103541035510356103571035810359103601036110362103631036410365103661036710368103691037010371103721037310374103751037610377103781037910380103811038210383103841038510386103871038810389103901039110392103931039410395103961039710398103991040010401104021040310404104051040610407104081040910410104111041210413104141041510416104171041810419104201042110422104231042410425104261042710428104291043010431104321043310434104351043610437104381043910440104411044210443104441044510446104471044810449104501045110452104531045410455104561045710458104591046010461104621046310464104651046610467104681046910470104711047210473104741047510476104771047810479104801048110482104831048410485104861048710488104891049010491104921049310494104951049610497104981049910500105011050210503105041050510506105071050810509105101051110512105131051410515105161051710518105191052010521105221052310524105251052610527105281052910530105311053210533105341053510536105371053810539105401054110542105431054410545105461054710548105491055010551105521055310554105551055610557105581055910560105611056210563105641056510566105671056810569105701057110572105731057410575105761057710578105791058010581105821058310584105851058610587105881058910590105911059210593105941059510596105971059810599106001060110602106031060410605106061060710608106091061010611106121061310614106151061610617106181061910620106211062210623106241062510626106271062810629106301063110632106331063410635106361063710638106391064010641106421064310644106451064610647106481064910650106511065210653106541065510656106571065810659106601066110662106631066410665106661066710668106691067010671106721067310674106751067610677106781067910680106811068210683106841068510686106871068810689106901069110692106931069410695106961069710698106991070010701107021070310704107051070610707107081070910710107111071210713107141071510716107171071810719107201072110722107231072410725107261072710728107291073010731107321073310734107351073610737107381073910740107411074210743107441074510746107471074810749107501075110752107531075410755107561075710758107591076010761107621076310764107651076610767107681076910770107711077210773107741077510776107771077810779107801078110782107831078410785107861078710788107891079010791107921079310794107951079610797107981079910800108011080210803108041080510806108071080810809108101081110812108131081410815108161081710818108191082010821108221082310824108251082610827108281082910830108311083210833108341083510836108371083810839108401084110842108431084410845108461084710848108491085010851108521085310854108551085610857108581085910860108611086210863108641086510866108671086810869108701087110872108731087410875108761087710878108791088010881108821088310884108851088610887108881088910890108911089210893108941089510896108971089810899109001090110902109031090410905109061090710908109091091010911109121091310914109151091610917109181091910920109211092210923109241092510926109271092810929109301093110932109331093410935109361093710938109391094010941109421094310944109451094610947109481094910950109511095210953109541095510956109571095810959109601096110962109631096410965109661096710968109691097010971109721097310974109751097610977109781097910980109811098210983109841098510986109871098810989109901099110992109931099410995109961099710998109991100011001110021100311004110051100611007110081100911010110111101211013110141101511016110171101811019110201102111022110231102411025110261102711028110291103011031110321103311034110351103611037110381103911040110411104211043110441104511046110471104811049110501105111052110531105411055110561105711058110591106011061110621106311064110651106611067110681106911070110711107211073110741107511076110771107811079110801108111082110831108411085110861108711088110891109011091110921109311094110951109611097110981109911100111011110211103111041110511106111071110811109111101111111112111131111411115111161111711118111191112011121111221112311124111251112611127111281112911130111311113211133111341113511136111371113811139111401114111142111431114411145111461114711148111491115011151111521115311154111551115611157111581115911160111611116211163111641116511166111671116811169111701117111172111731117411175111761117711178111791118011181111821118311184111851118611187111881118911190111911119211193111941119511196111971119811199112001120111202112031120411205112061120711208112091121011211112121121311214112151121611217112181121911220112211122211223112241122511226112271122811229112301123111232112331123411235112361123711238112391124011241112421124311244112451124611247112481124911250112511125211253112541125511256112571125811259112601126111262112631126411265112661126711268112691127011271112721127311274112751127611277112781127911280112811128211283112841128511286112871128811289112901129111292112931129411295112961129711298112991130011301113021130311304113051130611307113081130911310113111131211313113141131511316113171131811319113201132111322113231132411325113261132711328113291133011331113321133311334113351133611337113381133911340113411134211343113441134511346113471134811349113501135111352113531135411355113561135711358113591136011361113621136311364113651136611367113681136911370113711137211373113741137511376113771137811379113801138111382113831138411385113861138711388113891139011391113921139311394113951139611397113981139911400114011140211403114041140511406114071140811409114101141111412114131141411415114161141711418114191142011421114221142311424114251142611427114281142911430114311143211433114341143511436114371143811439114401144111442114431144411445114461144711448114491145011451114521145311454114551145611457114581145911460114611146211463114641146511466114671146811469114701147111472114731147411475114761147711478114791148011481114821148311484114851148611487114881148911490114911149211493114941149511496114971149811499115001150111502115031150411505115061150711508115091151011511115121151311514115151151611517115181151911520115211152211523115241152511526115271152811529115301153111532115331153411535115361153711538115391154011541115421154311544115451154611547115481154911550115511155211553115541155511556115571155811559115601156111562115631156411565115661156711568115691157011571115721157311574115751157611577115781157911580115811158211583115841158511586115871158811589115901159111592115931159411595115961159711598115991160011601116021160311604116051160611607116081160911610116111161211613116141161511616116171161811619116201162111622116231162411625116261162711628116291163011631116321163311634116351163611637116381163911640116411164211643116441164511646116471164811649116501165111652116531165411655116561165711658116591166011661116621166311664116651166611667116681166911670116711167211673116741167511676116771167811679116801168111682116831168411685116861168711688116891169011691116921169311694116951169611697116981169911700117011170211703117041170511706117071170811709117101171111712117131171411715117161171711718117191172011721117221172311724117251172611727117281172911730117311173211733117341173511736117371173811739117401174111742117431174411745117461174711748117491175011751117521175311754117551175611757117581175911760117611176211763117641176511766117671176811769117701177111772117731177411775117761177711778117791178011781117821178311784117851178611787117881178911790117911179211793117941179511796117971179811799118001180111802118031180411805118061180711808118091181011811118121181311814118151181611817118181181911820118211182211823118241182511826118271182811829118301183111832118331183411835118361183711838118391184011841118421184311844118451184611847118481184911850118511185211853118541185511856118571185811859118601186111862118631186411865118661186711868118691187011871118721187311874118751187611877118781187911880118811188211883118841188511886118871188811889118901189111892118931189411895118961189711898118991190011901119021190311904119051190611907119081190911910119111191211913119141191511916119171191811919119201192111922119231192411925119261192711928119291193011931119321193311934119351193611937119381193911940119411194211943119441194511946119471194811949119501195111952119531195411955119561195711958119591196011961119621196311964119651196611967119681196911970119711197211973119741197511976119771197811979119801198111982119831198411985119861198711988119891199011991119921199311994119951199611997119981199912000120011200212003120041200512006120071200812009120101201112012120131201412015120161201712018120191202012021120221202312024120251202612027120281202912030120311203212033120341203512036120371203812039120401204112042120431204412045120461204712048120491205012051120521205312054120551205612057120581205912060120611206212063120641206512066120671206812069120701207112072120731207412075120761207712078120791208012081120821208312084120851208612087120881208912090120911209212093120941209512096120971209812099121001210112102121031210412105121061210712108121091211012111121121211312114121151211612117121181211912120121211212212123121241212512126121271212812129121301213112132121331213412135121361213712138121391214012141121421214312144121451214612147121481214912150121511215212153121541215512156121571215812159121601216112162121631216412165121661216712168121691217012171121721217312174121751217612177121781217912180121811218212183121841218512186121871218812189121901219112192121931219412195121961219712198121991220012201122021220312204122051220612207122081220912210122111221212213122141221512216122171221812219122201222112222122231222412225122261222712228122291223012231122321223312234122351223612237122381223912240122411224212243122441224512246122471224812249122501225112252122531225412255122561225712258122591226012261122621226312264122651226612267122681226912270122711227212273122741227512276122771227812279122801228112282122831228412285122861228712288122891229012291122921229312294122951229612297122981229912300123011230212303123041230512306123071230812309123101231112312123131231412315123161231712318123191232012321123221232312324123251232612327123281232912330123311233212333123341233512336123371233812339123401234112342123431234412345123461234712348123491235012351123521235312354123551235612357123581235912360123611236212363123641236512366123671236812369123701237112372123731237412375123761237712378123791238012381123821238312384123851238612387123881238912390123911239212393123941239512396123971239812399124001240112402124031240412405124061240712408124091241012411124121241312414124151241612417124181241912420124211242212423124241242512426124271242812429124301243112432124331243412435124361243712438124391244012441124421244312444124451244612447124481244912450124511245212453124541245512456124571245812459124601246112462124631246412465124661246712468124691247012471124721247312474124751247612477124781247912480124811248212483124841248512486124871248812489124901249112492124931249412495124961249712498124991250012501125021250312504125051250612507125081250912510125111251212513125141251512516125171251812519125201252112522125231252412525125261252712528125291253012531125321253312534125351253612537125381253912540125411254212543125441254512546125471254812549125501255112552125531255412555125561255712558125591256012561125621256312564125651256612567125681256912570125711257212573125741257512576125771257812579125801258112582125831258412585125861258712588125891259012591125921259312594125951259612597125981259912600126011260212603126041260512606126071260812609126101261112612126131261412615126161261712618126191262012621126221262312624126251262612627126281262912630126311263212633126341263512636126371263812639126401264112642126431264412645126461264712648126491265012651126521265312654126551265612657126581265912660126611266212663126641266512666126671266812669126701267112672126731267412675126761267712678126791268012681126821268312684126851268612687126881268912690126911269212693126941269512696126971269812699127001270112702127031270412705127061270712708127091271012711127121271312714127151271612717127181271912720127211272212723127241272512726127271272812729127301273112732127331273412735127361273712738127391274012741127421274312744127451274612747127481274912750127511275212753127541275512756127571275812759127601276112762127631276412765127661276712768127691277012771127721277312774127751277612777127781277912780127811278212783127841278512786127871278812789127901279112792127931279412795127961279712798127991280012801128021280312804128051280612807128081280912810128111281212813128141281512816128171281812819128201282112822128231282412825128261282712828128291283012831128321283312834128351283612837128381283912840128411284212843128441284512846128471284812849128501285112852128531285412855128561285712858128591286012861128621286312864128651286612867128681286912870128711287212873128741287512876128771287812879128801288112882128831288412885128861288712888128891289012891128921289312894128951289612897128981289912900129011290212903129041290512906129071290812909129101291112912129131291412915129161291712918129191292012921129221292312924129251292612927129281292912930129311293212933129341293512936129371293812939129401294112942129431294412945129461294712948129491295012951129521295312954129551295612957129581295912960129611296212963129641296512966129671296812969129701297112972129731297412975129761297712978129791298012981129821298312984129851298612987129881298912990129911299212993129941299512996129971299812999130001300113002130031300413005130061300713008130091301013011130121301313014130151301613017130181301913020130211302213023130241302513026130271302813029130301303113032130331303413035130361303713038130391304013041130421304313044130451304613047130481304913050130511305213053130541305513056130571305813059130601306113062130631306413065130661306713068130691307013071130721307313074130751307613077130781307913080130811308213083130841308513086130871308813089130901309113092130931309413095130961309713098130991310013101131021310313104131051310613107131081310913110131111311213113131141311513116131171311813119131201312113122131231312413125131261312713128131291313013131131321313313134131351313613137131381313913140131411314213143131441314513146131471314813149131501315113152131531315413155131561315713158131591316013161131621316313164131651316613167131681316913170131711317213173131741317513176131771317813179131801318113182131831318413185131861318713188131891319013191131921319313194131951319613197131981319913200132011320213203132041320513206132071320813209132101321113212132131321413215132161321713218132191322013221132221322313224132251322613227132281322913230132311323213233132341323513236132371323813239132401324113242132431324413245132461324713248132491325013251132521325313254132551325613257132581325913260132611326213263132641326513266132671326813269132701327113272132731327413275132761327713278132791328013281132821328313284132851328613287132881328913290132911329213293132941329513296132971329813299133001330113302133031330413305133061330713308133091331013311133121331313314133151331613317133181331913320133211332213323133241332513326133271332813329133301333113332133331333413335133361333713338133391334013341133421334313344133451334613347133481334913350133511335213353133541335513356133571335813359133601336113362133631336413365133661336713368133691337013371133721337313374133751337613377133781337913380133811338213383133841338513386133871338813389133901339113392133931339413395133961339713398133991340013401134021340313404134051340613407134081340913410134111341213413134141341513416134171341813419134201342113422134231342413425134261342713428134291343013431134321343313434134351343613437134381343913440134411344213443134441344513446134471344813449134501345113452134531345413455134561345713458134591346013461134621346313464134651346613467134681346913470134711347213473134741347513476134771347813479134801348113482134831348413485134861348713488134891349013491134921349313494134951349613497134981349913500135011350213503135041350513506135071350813509135101351113512135131351413515135161351713518135191352013521135221352313524135251352613527135281352913530135311353213533135341353513536135371353813539135401354113542135431354413545135461354713548135491355013551135521355313554135551355613557135581355913560135611356213563135641356513566135671356813569135701357113572135731357413575135761357713578135791358013581135821358313584135851358613587135881358913590135911359213593135941359513596135971359813599136001360113602136031360413605136061360713608136091361013611136121361313614136151361613617136181361913620136211362213623136241362513626136271362813629136301363113632136331363413635136361363713638136391364013641136421364313644136451364613647136481364913650136511365213653136541365513656136571365813659136601366113662136631366413665136661366713668136691367013671136721367313674136751367613677136781367913680136811368213683136841368513686136871368813689136901369113692136931369413695136961369713698136991370013701137021370313704137051370613707137081370913710137111371213713137141371513716137171371813719137201372113722137231372413725137261372713728137291373013731137321373313734137351373613737137381373913740137411374213743137441374513746137471374813749137501375113752137531375413755137561375713758137591376013761137621376313764137651376613767137681376913770137711377213773137741377513776137771377813779137801378113782137831378413785137861378713788137891379013791137921379313794137951379613797137981379913800138011380213803138041380513806138071380813809138101381113812138131381413815138161381713818138191382013821138221382313824138251382613827138281382913830138311383213833138341383513836138371383813839138401384113842138431384413845138461384713848138491385013851138521385313854138551385613857138581385913860138611386213863138641386513866138671386813869138701387113872138731387413875138761387713878138791388013881138821388313884138851388613887138881388913890138911389213893138941389513896138971389813899139001390113902139031390413905139061390713908139091391013911139121391313914139151391613917139181391913920139211392213923139241392513926139271392813929139301393113932139331393413935139361393713938139391394013941139421394313944139451394613947139481394913950139511395213953139541395513956139571395813959139601396113962139631396413965139661396713968139691397013971139721397313974139751397613977139781397913980139811398213983139841398513986139871398813989139901399113992139931399413995139961399713998139991400014001140021400314004140051400614007140081400914010140111401214013140141401514016140171401814019140201402114022140231402414025140261402714028140291403014031140321403314034140351403614037140381403914040140411404214043140441404514046140471404814049140501405114052140531405414055140561405714058140591406014061140621406314064140651406614067140681406914070140711407214073140741407514076140771407814079140801408114082140831408414085140861408714088140891409014091140921409314094140951409614097140981409914100141011410214103141041410514106141071410814109141101411114112141131411414115141161411714118141191412014121141221412314124141251412614127141281412914130141311413214133141341413514136141371413814139141401414114142141431414414145141461414714148141491415014151141521415314154141551415614157141581415914160141611416214163141641416514166141671416814169141701417114172141731417414175141761417714178141791418014181141821418314184141851418614187141881418914190141911419214193141941419514196141971419814199142001420114202142031420414205142061420714208142091421014211142121421314214142151421614217142181421914220142211422214223142241422514226142271422814229142301423114232142331423414235142361423714238142391424014241142421424314244142451424614247142481424914250142511425214253142541425514256142571425814259142601426114262142631426414265142661426714268142691427014271142721427314274142751427614277142781427914280142811428214283142841428514286142871428814289142901429114292142931429414295142961429714298142991430014301143021430314304143051430614307143081430914310143111431214313143141431514316143171431814319143201432114322143231432414325143261432714328143291433014331143321433314334143351433614337143381433914340143411434214343143441434514346143471434814349143501435114352143531435414355143561435714358143591436014361143621436314364143651436614367143681436914370143711437214373143741437514376143771437814379143801438114382143831438414385143861438714388143891439014391143921439314394143951439614397143981439914400144011440214403144041440514406144071440814409144101441114412144131441414415144161441714418144191442014421144221442314424144251442614427144281442914430144311443214433144341443514436144371443814439144401444114442144431444414445144461444714448144491445014451144521445314454144551445614457144581445914460144611446214463144641446514466144671446814469144701447114472144731447414475144761447714478144791448014481144821448314484144851448614487144881448914490144911449214493144941449514496144971449814499145001450114502145031450414505145061450714508145091451014511145121451314514145151451614517145181451914520145211452214523145241452514526145271452814529145301453114532145331453414535145361453714538145391454014541145421454314544145451454614547145481454914550145511455214553145541455514556145571455814559145601456114562145631456414565145661456714568145691457014571145721457314574145751457614577145781457914580145811458214583145841458514586145871458814589145901459114592145931459414595145961459714598145991460014601146021460314604146051460614607146081460914610146111461214613146141461514616146171461814619146201462114622146231462414625146261462714628146291463014631146321463314634146351463614637146381463914640146411464214643146441464514646146471464814649146501465114652146531465414655146561465714658146591466014661146621466314664146651466614667146681466914670146711467214673146741467514676146771467814679146801468114682146831468414685146861468714688146891469014691146921469314694146951469614697146981469914700147011470214703147041470514706147071470814709147101471114712147131471414715147161471714718147191472014721147221472314724147251472614727147281472914730147311473214733147341473514736147371473814739147401474114742147431474414745147461474714748147491475014751147521475314754147551475614757147581475914760147611476214763147641476514766147671476814769147701477114772147731477414775147761477714778147791478014781147821478314784147851478614787147881478914790147911479214793147941479514796147971479814799148001480114802148031480414805148061480714808148091481014811148121481314814148151481614817148181481914820148211482214823148241482514826148271482814829148301483114832148331483414835148361483714838148391484014841148421484314844148451484614847148481484914850148511485214853148541485514856148571485814859148601486114862148631486414865148661486714868148691487014871148721487314874148751487614877148781487914880148811488214883148841488514886148871488814889148901489114892148931489414895148961489714898148991490014901149021490314904149051490614907149081490914910149111491214913149141491514916149171491814919149201492114922149231492414925149261492714928149291493014931149321493314934149351493614937149381493914940149411494214943149441494514946149471494814949149501495114952149531495414955149561495714958149591496014961149621496314964149651496614967149681496914970149711497214973149741497514976149771497814979149801498114982149831498414985149861498714988149891499014991149921499314994149951499614997149981499915000150011500215003150041500515006150071500815009150101501115012150131501415015150161501715018150191502015021150221502315024150251502615027150281502915030150311503215033150341503515036150371503815039150401504115042150431504415045150461504715048150491505015051150521505315054150551505615057150581505915060150611506215063150641506515066150671506815069150701507115072150731507415075150761507715078150791508015081150821508315084150851508615087150881508915090150911509215093150941509515096150971509815099151001510115102151031510415105151061510715108151091511015111151121511315114151151511615117151181511915120151211512215123151241512515126151271512815129151301513115132151331513415135151361513715138151391514015141151421514315144151451514615147151481514915150151511515215153151541515515156151571515815159151601516115162151631516415165151661516715168151691517015171151721517315174151751517615177151781517915180151811518215183151841518515186151871518815189151901519115192151931519415195151961519715198151991520015201152021520315204152051520615207152081520915210152111521215213152141521515216152171521815219152201522115222152231522415225152261522715228152291523015231152321523315234152351523615237152381523915240152411524215243152441524515246152471524815249152501525115252152531525415255152561525715258152591526015261152621526315264152651526615267152681526915270152711527215273152741527515276152771527815279152801528115282152831528415285152861528715288152891529015291152921529315294152951529615297152981529915300153011530215303153041530515306153071530815309153101531115312153131531415315153161531715318153191532015321153221532315324153251532615327153281532915330153311533215333153341533515336153371533815339153401534115342153431534415345153461534715348153491535015351153521535315354153551535615357153581535915360153611536215363153641536515366153671536815369153701537115372153731537415375153761537715378153791538015381153821538315384153851538615387153881538915390153911539215393153941539515396153971539815399154001540115402154031540415405154061540715408154091541015411154121541315414154151541615417154181541915420154211542215423154241542515426154271542815429154301543115432154331543415435154361543715438154391544015441154421544315444154451544615447154481544915450154511545215453154541545515456154571545815459154601546115462154631546415465154661546715468154691547015471154721547315474154751547615477154781547915480154811548215483154841548515486154871548815489154901549115492154931549415495154961549715498154991550015501155021550315504155051550615507155081550915510155111551215513155141551515516155171551815519155201552115522155231552415525155261552715528155291553015531155321553315534155351553615537155381553915540155411554215543155441554515546155471554815549155501555115552155531555415555155561555715558155591556015561155621556315564155651556615567155681556915570155711557215573155741557515576155771557815579155801558115582155831558415585155861558715588155891559015591155921559315594155951559615597155981559915600156011560215603156041560515606156071560815609156101561115612156131561415615156161561715618156191562015621156221562315624156251562615627156281562915630156311563215633156341563515636156371563815639156401564115642156431564415645156461564715648156491565015651156521565315654156551565615657156581565915660156611566215663156641566515666156671566815669156701567115672156731567415675156761567715678156791568015681156821568315684156851568615687156881568915690156911569215693156941569515696156971569815699157001570115702157031570415705157061570715708157091571015711157121571315714157151571615717157181571915720157211572215723157241572515726157271572815729157301573115732157331573415735157361573715738157391574015741157421574315744157451574615747157481574915750157511575215753157541575515756157571575815759157601576115762157631576415765157661576715768157691577015771157721577315774157751577615777157781577915780157811578215783157841578515786157871578815789157901579115792157931579415795157961579715798157991580015801158021580315804158051580615807158081580915810158111581215813158141581515816158171581815819158201582115822158231582415825158261582715828158291583015831158321583315834158351583615837158381583915840158411584215843158441584515846158471584815849158501585115852158531585415855158561585715858158591586015861158621586315864158651586615867158681586915870158711587215873158741587515876158771587815879158801588115882158831588415885158861588715888158891589015891158921589315894158951589615897158981589915900159011590215903159041590515906159071590815909159101591115912159131591415915159161591715918159191592015921159221592315924159251592615927159281592915930159311593215933159341593515936159371593815939159401594115942159431594415945159461594715948159491595015951159521595315954159551595615957159581595915960159611596215963159641596515966159671596815969159701597115972159731597415975159761597715978159791598015981159821598315984159851598615987159881598915990159911599215993159941599515996159971599815999160001600116002160031600416005160061600716008160091601016011160121601316014160151601616017160181601916020160211602216023160241602516026160271602816029160301603116032160331603416035160361603716038160391604016041160421604316044160451604616047160481604916050160511605216053160541605516056160571605816059160601606116062160631606416065160661606716068160691607016071160721607316074160751607616077160781607916080160811608216083160841608516086160871608816089160901609116092160931609416095160961609716098160991610016101161021610316104161051610616107161081610916110161111611216113161141611516116161171611816119161201612116122161231612416125161261612716128161291613016131161321613316134161351613616137161381613916140161411614216143161441614516146161471614816149161501615116152161531615416155161561615716158161591616016161161621616316164161651616616167161681616916170161711617216173161741617516176161771617816179161801618116182161831618416185161861618716188161891619016191161921619316194161951619616197161981619916200162011620216203162041620516206162071620816209162101621116212162131621416215162161621716218162191622016221162221622316224162251622616227162281622916230162311623216233162341623516236162371623816239162401624116242162431624416245162461624716248162491625016251162521625316254162551625616257162581625916260162611626216263162641626516266162671626816269162701627116272162731627416275162761627716278162791628016281162821628316284162851628616287162881628916290162911629216293162941629516296162971629816299163001630116302163031630416305163061630716308163091631016311163121631316314163151631616317163181631916320163211632216323163241632516326163271632816329163301633116332163331633416335163361633716338163391634016341163421634316344163451634616347163481634916350163511635216353163541635516356163571635816359163601636116362163631636416365163661636716368163691637016371163721637316374163751637616377163781637916380163811638216383163841638516386163871638816389163901639116392163931639416395163961639716398163991640016401164021640316404164051640616407164081640916410164111641216413164141641516416164171641816419164201642116422164231642416425164261642716428164291643016431164321643316434164351643616437164381643916440164411644216443164441644516446164471644816449164501645116452164531645416455164561645716458164591646016461164621646316464164651646616467164681646916470164711647216473164741647516476164771647816479164801648116482164831648416485164861648716488164891649016491164921649316494164951649616497164981649916500165011650216503165041650516506165071650816509165101651116512165131651416515165161651716518165191652016521165221652316524165251652616527165281652916530165311653216533165341653516536165371653816539165401654116542165431654416545165461654716548165491655016551165521655316554165551655616557165581655916560165611656216563165641656516566165671656816569165701657116572165731657416575165761657716578165791658016581165821658316584165851658616587165881658916590165911659216593165941659516596165971659816599166001660116602166031660416605166061660716608166091661016611166121661316614166151661616617166181661916620166211662216623166241662516626166271662816629166301663116632166331663416635166361663716638166391664016641166421664316644166451664616647166481664916650166511665216653166541665516656166571665816659166601666116662166631666416665166661666716668166691667016671166721667316674166751667616677166781667916680166811668216683166841668516686166871668816689166901669116692166931669416695166961669716698166991670016701167021670316704167051670616707167081670916710167111671216713167141671516716167171671816719167201672116722167231672416725167261672716728167291673016731167321673316734167351673616737167381673916740167411674216743167441674516746167471674816749167501675116752167531675416755167561675716758167591676016761167621676316764167651676616767167681676916770167711677216773167741677516776167771677816779167801678116782167831678416785167861678716788167891679016791167921679316794167951679616797167981679916800168011680216803168041680516806168071680816809168101681116812168131681416815168161681716818168191682016821168221682316824168251682616827168281682916830168311683216833168341683516836168371683816839168401684116842168431684416845168461684716848168491685016851168521685316854168551685616857168581685916860168611686216863168641686516866168671686816869168701687116872168731687416875168761687716878168791688016881168821688316884168851688616887168881688916890168911689216893168941689516896168971689816899169001690116902169031690416905169061690716908169091691016911169121691316914169151691616917169181691916920169211692216923169241692516926169271692816929169301693116932169331693416935169361693716938169391694016941169421694316944169451694616947169481694916950169511695216953169541695516956169571695816959169601696116962169631696416965169661696716968169691697016971169721697316974169751697616977169781697916980169811698216983169841698516986169871698816989169901699116992169931699416995169961699716998169991700017001170021700317004170051700617007170081700917010170111701217013170141701517016170171701817019170201702117022170231702417025170261702717028170291703017031170321703317034170351703617037170381703917040170411704217043170441704517046170471704817049170501705117052170531705417055170561705717058170591706017061170621706317064170651706617067170681706917070170711707217073170741707517076170771707817079170801708117082170831708417085170861708717088170891709017091170921709317094170951709617097170981709917100171011710217103171041710517106171071710817109171101711117112171131711417115171161711717118171191712017121171221712317124171251712617127171281712917130171311713217133171341713517136171371713817139171401714117142171431714417145171461714717148171491715017151171521715317154171551715617157171581715917160171611716217163171641716517166171671716817169171701717117172171731717417175171761717717178171791718017181171821718317184171851718617187171881718917190171911719217193171941719517196171971719817199172001720117202172031720417205172061720717208172091721017211172121721317214172151721617217172181721917220172211722217223172241722517226172271722817229172301723117232172331723417235172361723717238172391724017241172421724317244172451724617247172481724917250172511725217253172541725517256172571725817259172601726117262172631726417265172661726717268172691727017271172721727317274172751727617277172781727917280172811728217283172841728517286172871728817289172901729117292172931729417295172961729717298172991730017301173021730317304173051730617307173081730917310173111731217313173141731517316173171731817319173201732117322173231732417325173261732717328173291733017331173321733317334173351733617337173381733917340173411734217343173441734517346173471734817349173501735117352173531735417355173561735717358173591736017361173621736317364173651736617367173681736917370173711737217373173741737517376173771737817379173801738117382173831738417385173861738717388173891739017391173921739317394173951739617397173981739917400174011740217403174041740517406174071740817409174101741117412174131741417415174161741717418174191742017421174221742317424174251742617427174281742917430174311743217433174341743517436174371743817439174401744117442174431744417445174461744717448174491745017451174521745317454174551745617457174581745917460174611746217463174641746517466174671746817469174701747117472174731747417475174761747717478174791748017481174821748317484174851748617487174881748917490174911749217493174941749517496174971749817499175001750117502175031750417505175061750717508175091751017511175121751317514175151751617517175181751917520175211752217523175241752517526175271752817529175301753117532175331753417535175361753717538175391754017541175421754317544175451754617547175481754917550175511755217553175541755517556175571755817559175601756117562175631756417565175661756717568175691757017571175721757317574175751757617577175781757917580175811758217583175841758517586175871758817589175901759117592175931759417595175961759717598175991760017601176021760317604176051760617607176081760917610176111761217613176141761517616176171761817619176201762117622176231762417625176261762717628176291763017631176321763317634176351763617637176381763917640176411764217643176441764517646176471764817649176501765117652176531765417655176561765717658176591766017661176621766317664176651766617667176681766917670176711767217673176741767517676176771767817679176801768117682176831768417685176861768717688176891769017691176921769317694176951769617697176981769917700177011770217703177041770517706177071770817709177101771117712177131771417715177161771717718177191772017721177221772317724177251772617727177281772917730177311773217733177341773517736177371773817739177401774117742177431774417745177461774717748177491775017751177521775317754177551775617757177581775917760177611776217763177641776517766177671776817769177701777117772177731777417775177761777717778177791778017781177821778317784177851778617787177881778917790177911779217793177941779517796177971779817799178001780117802178031780417805178061780717808178091781017811178121781317814178151781617817178181781917820178211782217823178241782517826178271782817829178301783117832178331783417835178361783717838178391784017841178421784317844178451784617847178481784917850178511785217853178541785517856178571785817859178601786117862178631786417865178661786717868178691787017871178721787317874178751787617877178781787917880178811788217883178841788517886178871788817889178901789117892178931789417895178961789717898178991790017901179021790317904179051790617907179081790917910179111791217913179141791517916179171791817919179201792117922179231792417925179261792717928179291793017931179321793317934179351793617937179381793917940179411794217943179441794517946179471794817949179501795117952179531795417955179561795717958179591796017961179621796317964179651796617967179681796917970179711797217973179741797517976179771797817979179801798117982179831798417985179861798717988179891799017991179921799317994179951799617997179981799918000180011800218003180041800518006180071800818009180101801118012180131801418015180161801718018180191802018021180221802318024180251802618027180281802918030180311803218033180341803518036180371803818039180401804118042180431804418045180461804718048180491805018051180521805318054180551805618057180581805918060180611806218063180641806518066180671806818069180701807118072180731807418075180761807718078180791808018081180821808318084180851808618087180881808918090180911809218093180941809518096180971809818099181001810118102181031810418105181061810718108181091811018111181121811318114181151811618117181181811918120181211812218123181241812518126181271812818129181301813118132181331813418135181361813718138181391814018141181421814318144181451814618147181481814918150181511815218153181541815518156181571815818159181601816118162181631816418165181661816718168181691817018171181721817318174181751817618177181781817918180181811818218183181841818518186181871818818189181901819118192181931819418195181961819718198181991820018201182021820318204182051820618207182081820918210182111821218213182141821518216182171821818219182201822118222182231822418225182261822718228182291823018231182321823318234182351823618237182381823918240182411824218243182441824518246182471824818249182501825118252182531825418255182561825718258182591826018261182621826318264182651826618267182681826918270182711827218273182741827518276182771827818279182801828118282182831828418285182861828718288182891829018291182921829318294182951829618297182981829918300183011830218303183041830518306183071830818309183101831118312183131831418315183161831718318183191832018321183221832318324183251832618327183281832918330183311833218333183341833518336183371833818339183401834118342183431834418345183461834718348183491835018351183521835318354183551835618357183581835918360183611836218363183641836518366183671836818369183701837118372183731837418375183761837718378183791838018381183821838318384183851838618387183881838918390183911839218393183941839518396183971839818399184001840118402184031840418405184061840718408184091841018411184121841318414184151841618417184181841918420184211842218423184241842518426184271842818429184301843118432184331843418435184361843718438184391844018441184421844318444184451844618447184481844918450184511845218453184541845518456184571845818459184601846118462184631846418465184661846718468184691847018471184721847318474184751847618477184781847918480184811848218483184841848518486184871848818489184901849118492184931849418495184961849718498184991850018501185021850318504185051850618507185081850918510185111851218513185141851518516185171851818519185201852118522185231852418525185261852718528185291853018531185321853318534185351853618537185381853918540185411854218543185441854518546185471854818549185501855118552185531855418555185561855718558185591856018561185621856318564185651856618567185681856918570185711857218573185741857518576185771857818579185801858118582185831858418585185861858718588185891859018591185921859318594185951859618597185981859918600186011860218603186041860518606186071860818609186101861118612186131861418615186161861718618186191862018621186221862318624186251862618627186281862918630186311863218633186341863518636186371863818639186401864118642186431864418645186461864718648186491865018651186521865318654186551865618657186581865918660186611866218663186641866518666186671866818669186701867118672186731867418675186761867718678186791868018681186821868318684186851868618687186881868918690186911869218693186941869518696186971869818699187001870118702187031870418705187061870718708187091871018711187121871318714187151871618717187181871918720187211872218723187241872518726187271872818729187301873118732187331873418735187361873718738187391874018741187421874318744187451874618747187481874918750187511875218753187541875518756187571875818759187601876118762187631876418765187661876718768187691877018771187721877318774187751877618777187781877918780187811878218783187841878518786187871878818789187901879118792187931879418795187961879718798187991880018801188021880318804188051880618807188081880918810188111881218813188141881518816188171881818819188201882118822188231882418825188261882718828188291883018831188321883318834188351883618837188381883918840188411884218843188441884518846188471884818849188501885118852188531885418855188561885718858188591886018861188621886318864188651886618867188681886918870188711887218873188741887518876188771887818879188801888118882188831888418885188861888718888188891889018891188921889318894188951889618897188981889918900189011890218903189041890518906189071890818909189101891118912189131891418915189161891718918189191892018921189221892318924189251892618927189281892918930189311893218933189341893518936189371893818939189401894118942189431894418945189461894718948189491895018951189521895318954189551895618957189581895918960189611896218963189641896518966189671896818969189701897118972189731897418975189761897718978189791898018981189821898318984189851898618987189881898918990189911899218993189941899518996189971899818999190001900119002190031900419005190061900719008190091901019011190121901319014190151901619017190181901919020190211902219023190241902519026190271902819029190301903119032190331903419035190361903719038190391904019041190421904319044190451904619047190481904919050190511905219053190541905519056190571905819059190601906119062190631906419065190661906719068190691907019071190721907319074190751907619077190781907919080190811908219083190841908519086190871908819089190901909119092190931909419095190961909719098190991910019101191021910319104191051910619107191081910919110191111911219113191141911519116191171911819119191201912119122191231912419125191261912719128191291913019131191321913319134191351913619137191381913919140191411914219143191441914519146191471914819149191501915119152191531915419155191561915719158191591916019161191621916319164191651916619167191681916919170191711917219173191741917519176191771917819179191801918119182191831918419185191861918719188191891919019191191921919319194191951919619197191981919919200192011920219203192041920519206192071920819209192101921119212192131921419215192161921719218192191922019221192221922319224192251922619227192281922919230192311923219233192341923519236192371923819239192401924119242192431924419245192461924719248192491925019251192521925319254192551925619257192581925919260192611926219263192641926519266192671926819269192701927119272192731927419275192761927719278192791928019281192821928319284192851928619287192881928919290192911929219293192941929519296192971929819299193001930119302193031930419305193061930719308193091931019311193121931319314193151931619317193181931919320193211932219323193241932519326193271932819329193301933119332193331933419335193361933719338193391934019341193421934319344193451934619347193481934919350193511935219353193541935519356193571935819359193601936119362193631936419365193661936719368193691937019371193721937319374193751937619377193781937919380193811938219383193841938519386193871938819389193901939119392193931939419395193961939719398193991940019401194021940319404194051940619407194081940919410194111941219413194141941519416194171941819419194201942119422194231942419425194261942719428194291943019431194321943319434194351943619437194381943919440194411944219443194441944519446194471944819449194501945119452194531945419455194561945719458194591946019461194621946319464194651946619467194681946919470194711947219473194741947519476194771947819479194801948119482194831948419485194861948719488194891949019491194921949319494194951949619497194981949919500195011950219503195041950519506195071950819509195101951119512195131951419515195161951719518195191952019521195221952319524195251952619527195281952919530195311953219533195341953519536195371953819539195401954119542195431954419545195461954719548195491955019551195521955319554195551955619557195581955919560195611956219563195641956519566195671956819569195701957119572195731957419575195761957719578195791958019581195821958319584195851958619587195881958919590195911959219593195941959519596195971959819599196001960119602196031960419605196061960719608196091961019611196121961319614196151961619617196181961919620196211962219623196241962519626196271962819629196301963119632196331963419635196361963719638196391964019641196421964319644196451964619647196481964919650196511965219653196541965519656196571965819659196601966119662196631966419665196661966719668196691967019671196721967319674196751967619677196781967919680196811968219683196841968519686196871968819689196901969119692196931969419695196961969719698196991970019701197021970319704197051970619707197081970919710197111971219713197141971519716197171971819719197201972119722197231972419725197261972719728197291973019731197321973319734197351973619737197381973919740197411974219743197441974519746197471974819749197501975119752197531975419755197561975719758197591976019761197621976319764197651976619767197681976919770197711977219773197741977519776197771977819779197801978119782197831978419785197861978719788197891979019791197921979319794197951979619797197981979919800198011980219803198041980519806198071980819809198101981119812198131981419815198161981719818198191982019821198221982319824198251982619827198281982919830198311983219833198341983519836198371983819839198401984119842198431984419845198461984719848198491985019851198521985319854198551985619857198581985919860198611986219863198641986519866198671986819869198701987119872198731987419875198761987719878198791988019881198821988319884198851988619887198881988919890198911989219893198941989519896198971989819899199001990119902199031990419905199061990719908199091991019911199121991319914199151991619917199181991919920199211992219923199241992519926199271992819929199301993119932199331993419935199361993719938199391994019941199421994319944199451994619947199481994919950199511995219953199541995519956199571995819959199601996119962199631996419965199661996719968199691997019971199721997319974199751997619977199781997919980199811998219983199841998519986199871998819989199901999119992199931999419995199961999719998199992000020001200022000320004200052000620007200082000920010200112001220013200142001520016200172001820019200202002120022200232002420025200262002720028200292003020031200322003320034200352003620037200382003920040200412004220043200442004520046200472004820049200502005120052200532005420055200562005720058200592006020061200622006320064200652006620067200682006920070200712007220073200742007520076200772007820079200802008120082200832008420085200862008720088200892009020091200922009320094200952009620097200982009920100201012010220103201042010520106201072010820109201102011120112201132011420115201162011720118201192012020121201222012320124201252012620127201282012920130201312013220133201342013520136201372013820139201402014120142201432014420145201462014720148201492015020151201522015320154201552015620157201582015920160201612016220163201642016520166201672016820169201702017120172201732017420175201762017720178201792018020181201822018320184201852018620187201882018920190201912019220193201942019520196201972019820199202002020120202202032020420205202062020720208202092021020211202122021320214202152021620217202182021920220202212022220223202242022520226202272022820229202302023120232202332023420235202362023720238202392024020241202422024320244202452024620247202482024920250202512025220253202542025520256202572025820259202602026120262202632026420265202662026720268202692027020271202722027320274202752027620277202782027920280202812028220283202842028520286202872028820289202902029120292202932029420295202962029720298202992030020301203022030320304203052030620307203082030920310203112031220313203142031520316203172031820319203202032120322203232032420325203262032720328203292033020331203322033320334203352033620337203382033920340203412034220343203442034520346203472034820349203502035120352203532035420355203562035720358203592036020361203622036320364203652036620367203682036920370203712037220373203742037520376203772037820379203802038120382203832038420385203862038720388203892039020391203922039320394203952039620397203982039920400204012040220403204042040520406204072040820409204102041120412204132041420415204162041720418204192042020421204222042320424204252042620427204282042920430204312043220433204342043520436204372043820439204402044120442204432044420445204462044720448204492045020451204522045320454204552045620457204582045920460204612046220463204642046520466204672046820469204702047120472204732047420475204762047720478204792048020481204822048320484204852048620487204882048920490204912049220493204942049520496204972049820499205002050120502205032050420505205062050720508205092051020511205122051320514205152051620517205182051920520205212052220523205242052520526205272052820529205302053120532205332053420535205362053720538205392054020541205422054320544205452054620547205482054920550205512055220553205542055520556205572055820559205602056120562205632056420565205662056720568205692057020571205722057320574205752057620577205782057920580205812058220583205842058520586205872058820589205902059120592205932059420595205962059720598205992060020601206022060320604206052060620607206082060920610206112061220613206142061520616206172061820619206202062120622206232062420625206262062720628206292063020631206322063320634206352063620637206382063920640206412064220643206442064520646206472064820649206502065120652206532065420655206562065720658206592066020661206622066320664206652066620667206682066920670206712067220673206742067520676206772067820679206802068120682206832068420685206862068720688206892069020691206922069320694206952069620697206982069920700207012070220703207042070520706207072070820709207102071120712207132071420715207162071720718207192072020721207222072320724207252072620727207282072920730207312073220733207342073520736207372073820739207402074120742207432074420745207462074720748207492075020751207522075320754207552075620757207582075920760207612076220763207642076520766207672076820769207702077120772207732077420775207762077720778207792078020781207822078320784207852078620787207882078920790207912079220793207942079520796207972079820799208002080120802208032080420805208062080720808208092081020811208122081320814208152081620817208182081920820208212082220823208242082520826208272082820829208302083120832208332083420835208362083720838208392084020841208422084320844208452084620847208482084920850208512085220853208542085520856208572085820859208602086120862208632086420865208662086720868208692087020871208722087320874208752087620877208782087920880208812088220883208842088520886208872088820889208902089120892208932089420895208962089720898208992090020901209022090320904209052090620907209082090920910209112091220913209142091520916209172091820919209202092120922209232092420925209262092720928209292093020931209322093320934209352093620937209382093920940209412094220943209442094520946209472094820949209502095120952209532095420955209562095720958209592096020961209622096320964209652096620967209682096920970209712097220973209742097520976209772097820979209802098120982209832098420985209862098720988209892099020991209922099320994209952099620997209982099921000210012100221003210042100521006210072100821009210102101121012210132101421015210162101721018210192102021021210222102321024210252102621027210282102921030210312103221033210342103521036210372103821039210402104121042210432104421045210462104721048210492105021051210522105321054210552105621057210582105921060210612106221063210642106521066210672106821069210702107121072210732107421075210762107721078210792108021081210822108321084210852108621087210882108921090210912109221093210942109521096210972109821099211002110121102211032110421105211062110721108211092111021111211122111321114211152111621117211182111921120211212112221123211242112521126211272112821129211302113121132211332113421135211362113721138211392114021141211422114321144211452114621147211482114921150211512115221153211542115521156211572115821159211602116121162211632116421165211662116721168211692117021171211722117321174211752117621177211782117921180211812118221183211842118521186211872118821189211902119121192211932119421195211962119721198211992120021201212022120321204212052120621207212082120921210212112121221213212142121521216212172121821219212202122121222212232122421225212262122721228212292123021231212322123321234212352123621237212382123921240212412124221243212442124521246212472124821249212502125121252212532125421255212562125721258212592126021261212622126321264212652126621267212682126921270212712127221273212742127521276212772127821279212802128121282212832128421285212862128721288212892129021291212922129321294212952129621297212982129921300213012130221303213042130521306213072130821309213102131121312213132131421315213162131721318213192132021321213222132321324213252132621327213282132921330213312133221333213342133521336213372133821339213402134121342213432134421345213462134721348213492135021351213522135321354213552135621357213582135921360213612136221363213642136521366213672136821369213702137121372213732137421375213762137721378213792138021381213822138321384213852138621387213882138921390213912139221393213942139521396213972139821399214002140121402214032140421405214062140721408214092141021411214122141321414214152141621417214182141921420214212142221423214242142521426214272142821429214302143121432214332143421435214362143721438214392144021441214422144321444214452144621447214482144921450214512145221453214542145521456214572145821459214602146121462214632146421465214662146721468214692147021471214722147321474214752147621477214782147921480214812148221483214842148521486214872148821489214902149121492214932149421495214962149721498214992150021501215022150321504215052150621507215082150921510215112151221513215142151521516215172151821519215202152121522215232152421525215262152721528215292153021531215322153321534215352153621537215382153921540215412154221543215442154521546215472154821549215502155121552215532155421555215562155721558215592156021561215622156321564215652156621567215682156921570215712157221573215742157521576215772157821579215802158121582215832158421585215862158721588215892159021591215922159321594215952159621597215982159921600216012160221603216042160521606216072160821609216102161121612216132161421615216162161721618216192162021621216222162321624216252162621627216282162921630216312163221633216342163521636216372163821639216402164121642216432164421645216462164721648216492165021651216522165321654216552165621657216582165921660216612166221663216642166521666216672166821669216702167121672216732167421675216762167721678216792168021681216822168321684216852168621687216882168921690216912169221693216942169521696216972169821699217002170121702217032170421705217062170721708217092171021711217122171321714217152171621717217182171921720217212172221723217242172521726217272172821729217302173121732217332173421735217362173721738217392174021741217422174321744217452174621747217482174921750217512175221753217542175521756217572175821759217602176121762217632176421765217662176721768217692177021771217722177321774217752177621777217782177921780217812178221783217842178521786217872178821789217902179121792217932179421795217962179721798217992180021801218022180321804218052180621807218082180921810218112181221813218142181521816218172181821819218202182121822218232182421825218262182721828218292183021831218322183321834218352183621837218382183921840218412184221843218442184521846218472184821849218502185121852218532185421855218562185721858218592186021861218622186321864218652186621867218682186921870218712187221873218742187521876218772187821879218802188121882218832188421885218862188721888218892189021891218922189321894218952189621897218982189921900219012190221903219042190521906219072190821909219102191121912219132191421915219162191721918219192192021921219222192321924219252192621927219282192921930219312193221933219342193521936219372193821939219402194121942219432194421945219462194721948219492195021951219522195321954219552195621957219582195921960219612196221963219642196521966219672196821969219702197121972219732197421975219762197721978219792198021981219822198321984219852198621987219882198921990219912199221993219942199521996219972199821999220002200122002220032200422005220062200722008220092201022011220122201322014220152201622017220182201922020220212202222023220242202522026220272202822029220302203122032220332203422035220362203722038220392204022041220422204322044220452204622047220482204922050220512205222053220542205522056220572205822059220602206122062220632206422065220662206722068220692207022071220722207322074220752207622077220782207922080220812208222083220842208522086220872208822089220902209122092220932209422095220962209722098220992210022101221022210322104221052210622107221082210922110221112211222113221142211522116221172211822119221202212122122221232212422125221262212722128221292213022131221322213322134221352213622137221382213922140221412214222143221442214522146221472214822149221502215122152221532215422155221562215722158221592216022161221622216322164221652216622167221682216922170221712217222173221742217522176221772217822179221802218122182221832218422185221862218722188221892219022191221922219322194221952219622197221982219922200222012220222203222042220522206222072220822209222102221122212222132221422215222162221722218222192222022221222222222322224222252222622227222282222922230222312223222233222342223522236222372223822239222402224122242222432224422245222462224722248222492225022251222522225322254222552225622257222582225922260222612226222263222642226522266222672226822269222702227122272222732227422275222762227722278222792228022281222822228322284222852228622287222882228922290222912229222293222942229522296222972229822299223002230122302223032230422305223062230722308223092231022311223122231322314223152231622317223182231922320223212232222323223242232522326223272232822329223302233122332223332233422335223362233722338223392234022341223422234322344223452234622347223482234922350223512235222353223542235522356223572235822359223602236122362223632236422365223662236722368223692237022371223722237322374223752237622377223782237922380223812238222383223842238522386223872238822389223902239122392223932239422395223962239722398223992240022401224022240322404224052240622407224082240922410224112241222413224142241522416224172241822419224202242122422224232242422425224262242722428224292243022431224322243322434224352243622437224382243922440224412244222443224442244522446224472244822449224502245122452224532245422455224562245722458224592246022461224622246322464224652246622467224682246922470224712247222473224742247522476224772247822479224802248122482224832248422485224862248722488224892249022491224922249322494224952249622497224982249922500225012250222503225042250522506225072250822509225102251122512225132251422515225162251722518225192252022521225222252322524225252252622527225282252922530225312253222533225342253522536225372253822539225402254122542225432254422545225462254722548225492255022551225522255322554225552255622557225582255922560225612256222563225642256522566225672256822569225702257122572225732257422575225762257722578225792258022581225822258322584225852258622587225882258922590225912259222593225942259522596225972259822599226002260122602226032260422605226062260722608226092261022611226122261322614226152261622617226182261922620226212262222623226242262522626226272262822629226302263122632226332263422635226362263722638226392264022641226422264322644226452264622647226482264922650226512265222653226542265522656226572265822659226602266122662226632266422665226662266722668226692267022671226722267322674226752267622677226782267922680226812268222683226842268522686226872268822689226902269122692226932269422695226962269722698226992270022701227022270322704227052270622707227082270922710227112271222713227142271522716227172271822719227202272122722227232272422725227262272722728227292273022731227322273322734227352273622737227382273922740227412274222743227442274522746227472274822749227502275122752227532275422755227562275722758227592276022761227622276322764227652276622767227682276922770227712277222773227742277522776227772277822779227802278122782227832278422785227862278722788227892279022791227922279322794227952279622797227982279922800228012280222803228042280522806228072280822809228102281122812228132281422815228162281722818228192282022821228222282322824228252282622827228282282922830228312283222833228342283522836228372283822839228402284122842228432284422845228462284722848228492285022851228522285322854228552285622857228582285922860228612286222863228642286522866228672286822869228702287122872228732287422875228762287722878228792288022881228822288322884228852288622887228882288922890228912289222893228942289522896228972289822899229002290122902229032290422905229062290722908229092291022911229122291322914229152291622917229182291922920229212292222923229242292522926229272292822929229302293122932229332293422935229362293722938229392294022941229422294322944229452294622947229482294922950229512295222953229542295522956229572295822959229602296122962229632296422965229662296722968229692297022971229722297322974229752297622977229782297922980229812298222983229842298522986229872298822989229902299122992229932299422995229962299722998229992300023001230022300323004230052300623007230082300923010230112301223013230142301523016230172301823019230202302123022230232302423025230262302723028230292303023031230322303323034230352303623037230382303923040230412304223043230442304523046230472304823049230502305123052230532305423055230562305723058230592306023061230622306323064230652306623067230682306923070230712307223073230742307523076230772307823079230802308123082230832308423085230862308723088230892309023091230922309323094230952309623097230982309923100231012310223103231042310523106231072310823109231102311123112231132311423115231162311723118231192312023121231222312323124231252312623127231282312923130231312313223133231342313523136231372313823139231402314123142231432314423145231462314723148231492315023151231522315323154231552315623157231582315923160231612316223163231642316523166231672316823169231702317123172231732317423175231762317723178231792318023181231822318323184231852318623187231882318923190231912319223193231942319523196231972319823199232002320123202232032320423205232062320723208232092321023211232122321323214232152321623217232182321923220232212322223223232242322523226232272322823229232302323123232232332323423235232362323723238232392324023241232422324323244232452324623247232482324923250232512325223253232542325523256232572325823259232602326123262232632326423265232662326723268232692327023271232722327323274232752327623277232782327923280232812328223283232842328523286232872328823289232902329123292232932329423295232962329723298232992330023301233022330323304233052330623307233082330923310233112331223313233142331523316233172331823319233202332123322233232332423325233262332723328233292333023331233322333323334233352333623337233382333923340233412334223343233442334523346233472334823349233502335123352233532335423355233562335723358233592336023361233622336323364233652336623367233682336923370233712337223373233742337523376233772337823379233802338123382233832338423385233862338723388233892339023391233922339323394233952339623397233982339923400234012340223403234042340523406234072340823409234102341123412234132341423415234162341723418234192342023421234222342323424234252342623427234282342923430234312343223433234342343523436234372343823439234402344123442234432344423445234462344723448234492345023451234522345323454234552345623457234582345923460234612346223463234642346523466234672346823469234702347123472234732347423475234762347723478234792348023481234822348323484234852348623487234882348923490234912349223493234942349523496234972349823499235002350123502235032350423505235062350723508235092351023511235122351323514235152351623517235182351923520235212352223523235242352523526235272352823529235302353123532235332353423535235362353723538235392354023541235422354323544235452354623547235482354923550235512355223553235542355523556235572355823559235602356123562235632356423565235662356723568235692357023571235722357323574235752357623577235782357923580235812358223583235842358523586235872358823589235902359123592235932359423595235962359723598235992360023601236022360323604236052360623607236082360923610236112361223613236142361523616236172361823619236202362123622236232362423625236262362723628236292363023631236322363323634236352363623637236382363923640236412364223643236442364523646236472364823649236502365123652236532365423655236562365723658236592366023661236622366323664236652366623667236682366923670236712367223673236742367523676236772367823679236802368123682236832368423685236862368723688236892369023691236922369323694236952369623697236982369923700237012370223703237042370523706237072370823709237102371123712237132371423715237162371723718237192372023721237222372323724237252372623727237282372923730237312373223733237342373523736237372373823739237402374123742237432374423745237462374723748237492375023751237522375323754237552375623757237582375923760237612376223763237642376523766237672376823769237702377123772237732377423775237762377723778237792378023781237822378323784237852378623787237882378923790237912379223793237942379523796237972379823799238002380123802238032380423805238062380723808238092381023811238122381323814238152381623817238182381923820238212382223823238242382523826238272382823829238302383123832238332383423835238362383723838238392384023841238422384323844238452384623847238482384923850238512385223853238542385523856238572385823859238602386123862238632386423865238662386723868238692387023871238722387323874238752387623877238782387923880238812388223883238842388523886238872388823889238902389123892238932389423895238962389723898238992390023901239022390323904239052390623907239082390923910239112391223913239142391523916239172391823919239202392123922239232392423925239262392723928239292393023931239322393323934239352393623937239382393923940239412394223943239442394523946239472394823949239502395123952239532395423955239562395723958239592396023961239622396323964239652396623967239682396923970239712397223973239742397523976239772397823979239802398123982239832398423985239862398723988239892399023991239922399323994239952399623997239982399924000240012400224003240042400524006240072400824009240102401124012240132401424015240162401724018240192402024021240222402324024240252402624027240282402924030240312403224033240342403524036240372403824039240402404124042240432404424045240462404724048240492405024051240522405324054240552405624057240582405924060240612406224063240642406524066240672406824069240702407124072240732407424075240762407724078240792408024081240822408324084240852408624087240882408924090240912409224093240942409524096240972409824099241002410124102241032410424105241062410724108241092411024111241122411324114241152411624117241182411924120241212412224123241242412524126241272412824129241302413124132241332413424135241362413724138241392414024141241422414324144241452414624147241482414924150241512415224153241542415524156241572415824159241602416124162241632416424165241662416724168241692417024171241722417324174241752417624177241782417924180241812418224183241842418524186241872418824189241902419124192241932419424195241962419724198241992420024201242022420324204242052420624207242082420924210242112421224213242142421524216242172421824219242202422124222242232422424225242262422724228242292423024231242322423324234242352423624237242382423924240242412424224243242442424524246242472424824249242502425124252242532425424255242562425724258242592426024261242622426324264242652426624267242682426924270242712427224273242742427524276242772427824279242802428124282242832428424285242862428724288242892429024291242922429324294242952429624297242982429924300243012430224303243042430524306243072430824309243102431124312243132431424315243162431724318243192432024321243222432324324243252432624327243282432924330243312433224333243342433524336243372433824339243402434124342243432434424345243462434724348243492435024351243522435324354243552435624357243582435924360243612436224363243642436524366243672436824369243702437124372243732437424375243762437724378243792438024381243822438324384243852438624387243882438924390243912439224393243942439524396243972439824399244002440124402244032440424405244062440724408244092441024411244122441324414244152441624417244182441924420244212442224423244242442524426244272442824429244302443124432244332443424435244362443724438244392444024441244422444324444244452444624447244482444924450244512445224453244542445524456244572445824459244602446124462244632446424465244662446724468244692447024471244722447324474244752447624477244782447924480244812448224483244842448524486244872448824489244902449124492244932449424495244962449724498244992450024501245022450324504245052450624507245082450924510245112451224513245142451524516245172451824519245202452124522245232452424525245262452724528245292453024531245322453324534245352453624537245382453924540245412454224543245442454524546245472454824549245502455124552245532455424555245562455724558245592456024561245622456324564245652456624567245682456924570245712457224573245742457524576245772457824579245802458124582245832458424585245862458724588245892459024591245922459324594245952459624597245982459924600246012460224603246042460524606246072460824609246102461124612246132461424615246162461724618246192462024621246222462324624246252462624627246282462924630246312463224633246342463524636246372463824639246402464124642246432464424645246462464724648246492465024651246522465324654246552465624657246582465924660246612466224663246642466524666246672466824669246702467124672246732467424675246762467724678246792468024681246822468324684246852468624687246882468924690246912469224693246942469524696246972469824699247002470124702247032470424705247062470724708247092471024711247122471324714247152471624717247182471924720247212472224723247242472524726247272472824729247302473124732247332473424735247362473724738247392474024741247422474324744247452474624747247482474924750247512475224753247542475524756247572475824759247602476124762247632476424765247662476724768247692477024771247722477324774247752477624777247782477924780247812478224783247842478524786247872478824789247902479124792247932479424795247962479724798247992480024801248022480324804248052480624807248082480924810248112481224813248142481524816248172481824819248202482124822248232482424825248262482724828248292483024831248322483324834248352483624837248382483924840248412484224843248442484524846248472484824849248502485124852248532485424855248562485724858248592486024861248622486324864248652486624867248682486924870248712487224873248742487524876248772487824879248802488124882248832488424885248862488724888248892489024891248922489324894248952489624897248982489924900249012490224903249042490524906249072490824909249102491124912249132491424915249162491724918249192492024921249222492324924249252492624927249282492924930249312493224933249342493524936249372493824939249402494124942249432494424945249462494724948249492495024951249522495324954249552495624957249582495924960249612496224963249642496524966249672496824969249702497124972249732497424975249762497724978249792498024981249822498324984249852498624987249882498924990249912499224993249942499524996249972499824999250002500125002250032500425005250062500725008250092501025011250122501325014250152501625017250182501925020250212502225023250242502525026250272502825029250302503125032250332503425035250362503725038250392504025041250422504325044250452504625047250482504925050250512505225053250542505525056250572505825059250602506125062250632506425065250662506725068250692507025071250722507325074250752507625077250782507925080250812508225083250842508525086250872508825089250902509125092250932509425095250962509725098250992510025101251022510325104251052510625107251082510925110251112511225113251142511525116251172511825119251202512125122251232512425125251262512725128251292513025131251322513325134251352513625137251382513925140251412514225143251442514525146251472514825149251502515125152251532515425155251562515725158251592516025161251622516325164251652516625167251682516925170251712517225173251742517525176251772517825179251802518125182251832518425185251862518725188251892519025191251922519325194251952519625197251982519925200252012520225203252042520525206252072520825209252102521125212252132521425215252162521725218252192522025221252222522325224252252522625227252282522925230252312523225233252342523525236252372523825239252402524125242252432524425245252462524725248252492525025251252522525325254252552525625257252582525925260252612526225263252642526525266252672526825269252702527125272252732527425275252762527725278252792528025281252822528325284252852528625287252882528925290252912529225293252942529525296252972529825299253002530125302253032530425305253062530725308253092531025311253122531325314253152531625317253182531925320253212532225323253242532525326253272532825329253302533125332253332533425335253362533725338253392534025341253422534325344253452534625347253482534925350253512535225353253542535525356253572535825359253602536125362253632536425365253662536725368253692537025371253722537325374253752537625377253782537925380253812538225383253842538525386253872538825389253902539125392253932539425395253962539725398253992540025401254022540325404254052540625407254082540925410254112541225413254142541525416254172541825419254202542125422254232542425425254262542725428254292543025431254322543325434254352543625437254382543925440254412544225443254442544525446254472544825449254502545125452254532545425455254562545725458254592546025461254622546325464254652546625467254682546925470254712547225473254742547525476254772547825479254802548125482254832548425485254862548725488254892549025491254922549325494254952549625497254982549925500255012550225503255042550525506255072550825509255102551125512255132551425515255162551725518255192552025521255222552325524255252552625527255282552925530255312553225533255342553525536255372553825539255402554125542255432554425545255462554725548255492555025551255522555325554255552555625557255582555925560255612556225563255642556525566255672556825569255702557125572255732557425575255762557725578255792558025581255822558325584255852558625587255882558925590255912559225593255942559525596255972559825599256002560125602256032560425605256062560725608256092561025611256122561325614256152561625617256182561925620256212562225623256242562525626256272562825629256302563125632256332563425635256362563725638256392564025641256422564325644256452564625647256482564925650256512565225653256542565525656256572565825659256602566125662256632566425665256662566725668256692567025671256722567325674256752567625677256782567925680256812568225683256842568525686256872568825689256902569125692256932569425695256962569725698256992570025701257022570325704257052570625707257082570925710257112571225713257142571525716257172571825719257202572125722257232572425725257262572725728257292573025731257322573325734257352573625737257382573925740257412574225743257442574525746257472574825749257502575125752257532575425755257562575725758257592576025761257622576325764257652576625767257682576925770257712577225773257742577525776257772577825779257802578125782257832578425785257862578725788257892579025791257922579325794257952579625797257982579925800258012580225803258042580525806258072580825809258102581125812258132581425815258162581725818258192582025821258222582325824258252582625827258282582925830258312583225833258342583525836258372583825839258402584125842258432584425845258462584725848258492585025851258522585325854258552585625857258582585925860258612586225863258642586525866258672586825869258702587125872258732587425875258762587725878258792588025881258822588325884258852588625887258882588925890258912589225893258942589525896258972589825899259002590125902259032590425905259062590725908259092591025911259122591325914259152591625917259182591925920259212592225923259242592525926259272592825929259302593125932259332593425935259362593725938259392594025941259422594325944259452594625947259482594925950259512595225953259542595525956259572595825959259602596125962259632596425965259662596725968259692597025971259722597325974259752597625977259782597925980259812598225983259842598525986259872598825989259902599125992259932599425995259962599725998259992600026001260022600326004260052600626007260082600926010260112601226013260142601526016260172601826019260202602126022260232602426025260262602726028260292603026031260322603326034260352603626037260382603926040260412604226043260442604526046260472604826049260502605126052260532605426055260562605726058260592606026061260622606326064260652606626067260682606926070260712607226073260742607526076260772607826079260802608126082260832608426085260862608726088260892609026091260922609326094260952609626097260982609926100261012610226103261042610526106261072610826109261102611126112261132611426115261162611726118261192612026121261222612326124261252612626127261282612926130261312613226133261342613526136261372613826139261402614126142261432614426145261462614726148261492615026151261522615326154261552615626157261582615926160261612616226163261642616526166261672616826169261702617126172261732617426175261762617726178261792618026181261822618326184261852618626187261882618926190261912619226193261942619526196261972619826199262002620126202262032620426205262062620726208262092621026211262122621326214262152621626217262182621926220262212622226223262242622526226262272622826229262302623126232262332623426235262362623726238262392624026241262422624326244262452624626247262482624926250262512625226253262542625526256262572625826259262602626126262262632626426265262662626726268262692627026271262722627326274262752627626277262782627926280262812628226283262842628526286262872628826289262902629126292262932629426295262962629726298262992630026301263022630326304263052630626307263082630926310263112631226313263142631526316263172631826319263202632126322263232632426325263262632726328263292633026331263322633326334263352633626337263382633926340263412634226343263442634526346263472634826349263502635126352263532635426355263562635726358263592636026361263622636326364263652636626367263682636926370263712637226373263742637526376263772637826379263802638126382263832638426385263862638726388263892639026391263922639326394263952639626397263982639926400264012640226403264042640526406264072640826409264102641126412264132641426415264162641726418264192642026421264222642326424264252642626427264282642926430264312643226433264342643526436264372643826439264402644126442264432644426445264462644726448264492645026451264522645326454264552645626457264582645926460264612646226463264642646526466264672646826469264702647126472264732647426475264762647726478264792648026481264822648326484264852648626487264882648926490264912649226493264942649526496264972649826499265002650126502265032650426505265062650726508265092651026511265122651326514265152651626517265182651926520265212652226523265242652526526265272652826529265302653126532265332653426535265362653726538265392654026541265422654326544265452654626547265482654926550265512655226553265542655526556265572655826559265602656126562265632656426565265662656726568265692657026571265722657326574265752657626577265782657926580265812658226583265842658526586265872658826589265902659126592265932659426595265962659726598265992660026601266022660326604266052660626607266082660926610266112661226613266142661526616266172661826619266202662126622266232662426625266262662726628266292663026631266322663326634266352663626637266382663926640266412664226643266442664526646266472664826649266502665126652266532665426655266562665726658266592666026661266622666326664266652666626667266682666926670266712667226673266742667526676266772667826679266802668126682266832668426685266862668726688266892669026691266922669326694266952669626697266982669926700267012670226703267042670526706267072670826709267102671126712267132671426715267162671726718267192672026721267222672326724267252672626727267282672926730267312673226733267342673526736267372673826739267402674126742267432674426745267462674726748267492675026751267522675326754267552675626757267582675926760267612676226763267642676526766267672676826769267702677126772267732677426775267762677726778267792678026781267822678326784267852678626787267882678926790267912679226793267942679526796267972679826799268002680126802268032680426805268062680726808268092681026811268122681326814268152681626817268182681926820268212682226823268242682526826268272682826829268302683126832268332683426835268362683726838268392684026841268422684326844268452684626847268482684926850268512685226853268542685526856268572685826859268602686126862268632686426865268662686726868268692687026871268722687326874268752687626877268782687926880268812688226883268842688526886268872688826889268902689126892268932689426895268962689726898268992690026901269022690326904269052690626907269082690926910269112691226913269142691526916269172691826919269202692126922269232692426925269262692726928269292693026931269322693326934269352693626937269382693926940269412694226943269442694526946269472694826949269502695126952269532695426955269562695726958269592696026961269622696326964269652696626967269682696926970269712697226973269742697526976269772697826979269802698126982269832698426985269862698726988269892699026991269922699326994269952699626997269982699927000270012700227003270042700527006270072700827009270102701127012270132701427015270162701727018270192702027021270222702327024270252702627027270282702927030270312703227033270342703527036270372703827039270402704127042270432704427045270462704727048270492705027051270522705327054270552705627057270582705927060270612706227063270642706527066270672706827069270702707127072270732707427075270762707727078270792708027081270822708327084270852708627087270882708927090270912709227093270942709527096270972709827099271002710127102271032710427105271062710727108271092711027111271122711327114271152711627117271182711927120271212712227123271242712527126271272712827129271302713127132271332713427135271362713727138271392714027141271422714327144271452714627147271482714927150271512715227153271542715527156271572715827159271602716127162271632716427165271662716727168271692717027171271722717327174271752717627177271782717927180271812718227183271842718527186271872718827189271902719127192271932719427195271962719727198271992720027201272022720327204272052720627207272082720927210272112721227213272142721527216272172721827219272202722127222272232722427225272262722727228272292723027231272322723327234272352723627237272382723927240272412724227243272442724527246272472724827249272502725127252272532725427255272562725727258272592726027261272622726327264272652726627267272682726927270272712727227273272742727527276272772727827279272802728127282272832728427285272862728727288272892729027291272922729327294272952729627297272982729927300273012730227303273042730527306273072730827309273102731127312273132731427315273162731727318273192732027321273222732327324273252732627327273282732927330273312733227333273342733527336273372733827339273402734127342273432734427345273462734727348273492735027351273522735327354273552735627357273582735927360273612736227363273642736527366273672736827369273702737127372273732737427375273762737727378273792738027381273822738327384273852738627387273882738927390273912739227393273942739527396273972739827399274002740127402274032740427405274062740727408274092741027411274122741327414274152741627417274182741927420274212742227423274242742527426274272742827429274302743127432274332743427435274362743727438274392744027441274422744327444274452744627447274482744927450274512745227453274542745527456274572745827459274602746127462274632746427465274662746727468274692747027471274722747327474274752747627477274782747927480274812748227483274842748527486274872748827489274902749127492274932749427495274962749727498274992750027501275022750327504275052750627507275082750927510275112751227513275142751527516275172751827519275202752127522275232752427525275262752727528275292753027531275322753327534275352753627537275382753927540275412754227543275442754527546275472754827549275502755127552275532755427555275562755727558275592756027561275622756327564275652756627567275682756927570275712757227573275742757527576275772757827579275802758127582275832758427585275862758727588275892759027591275922759327594275952759627597275982759927600276012760227603276042760527606276072760827609276102761127612276132761427615276162761727618276192762027621276222762327624276252762627627276282762927630276312763227633276342763527636276372763827639276402764127642276432764427645276462764727648276492765027651276522765327654276552765627657276582765927660276612766227663276642766527666276672766827669276702767127672276732767427675276762767727678276792768027681276822768327684276852768627687276882768927690276912769227693276942769527696276972769827699277002770127702277032770427705277062770727708277092771027711277122771327714277152771627717277182771927720277212772227723277242772527726277272772827729277302773127732277332773427735277362773727738277392774027741277422774327744277452774627747277482774927750277512775227753277542775527756277572775827759277602776127762277632776427765277662776727768277692777027771277722777327774277752777627777277782777927780277812778227783277842778527786277872778827789277902779127792277932779427795277962779727798277992780027801278022780327804278052780627807278082780927810278112781227813278142781527816278172781827819278202782127822278232782427825278262782727828278292783027831278322783327834278352783627837278382783927840278412784227843278442784527846278472784827849278502785127852278532785427855278562785727858278592786027861278622786327864278652786627867278682786927870278712787227873278742787527876278772787827879278802788127882278832788427885278862788727888278892789027891278922789327894278952789627897278982789927900279012790227903279042790527906279072790827909279102791127912279132791427915279162791727918279192792027921279222792327924279252792627927279282792927930279312793227933279342793527936279372793827939279402794127942279432794427945279462794727948279492795027951279522795327954279552795627957279582795927960279612796227963279642796527966279672796827969279702797127972279732797427975279762797727978279792798027981279822798327984279852798627987279882798927990279912799227993279942799527996279972799827999280002800128002280032800428005280062800728008280092801028011280122801328014280152801628017280182801928020280212802228023280242802528026280272802828029280302803128032280332803428035280362803728038280392804028041280422804328044280452804628047280482804928050280512805228053280542805528056280572805828059280602806128062280632806428065280662806728068280692807028071280722807328074280752807628077280782807928080280812808228083280842808528086280872808828089280902809128092280932809428095280962809728098280992810028101281022810328104281052810628107281082810928110281112811228113281142811528116281172811828119281202812128122281232812428125281262812728128281292813028131281322813328134281352813628137281382813928140281412814228143281442814528146281472814828149281502815128152281532815428155281562815728158281592816028161281622816328164281652816628167281682816928170281712817228173281742817528176281772817828179281802818128182281832818428185281862818728188281892819028191281922819328194281952819628197281982819928200282012820228203282042820528206282072820828209282102821128212282132821428215282162821728218282192822028221282222822328224282252822628227282282822928230282312823228233282342823528236282372823828239282402824128242282432824428245282462824728248282492825028251282522825328254282552825628257282582825928260282612826228263282642826528266282672826828269282702827128272282732827428275282762827728278282792828028281282822828328284282852828628287282882828928290282912829228293282942829528296282972829828299283002830128302283032830428305283062830728308283092831028311283122831328314283152831628317283182831928320283212832228323283242832528326283272832828329283302833128332283332833428335283362833728338283392834028341283422834328344283452834628347283482834928350283512835228353283542835528356283572835828359283602836128362283632836428365283662836728368283692837028371283722837328374283752837628377283782837928380283812838228383283842838528386283872838828389283902839128392283932839428395283962839728398283992840028401284022840328404284052840628407284082840928410284112841228413284142841528416284172841828419284202842128422284232842428425284262842728428284292843028431284322843328434284352843628437284382843928440284412844228443284442844528446284472844828449284502845128452284532845428455284562845728458284592846028461284622846328464284652846628467284682846928470284712847228473284742847528476284772847828479284802848128482284832848428485284862848728488284892849028491284922849328494284952849628497284982849928500285012850228503285042850528506285072850828509285102851128512285132851428515285162851728518285192852028521285222852328524285252852628527285282852928530285312853228533285342853528536285372853828539285402854128542285432854428545285462854728548285492855028551285522855328554285552855628557285582855928560285612856228563285642856528566285672856828569285702857128572285732857428575285762857728578285792858028581285822858328584285852858628587285882858928590285912859228593285942859528596285972859828599286002860128602286032860428605286062860728608286092861028611286122861328614286152861628617286182861928620286212862228623286242862528626286272862828629286302863128632286332863428635286362863728638286392864028641286422864328644286452864628647286482864928650286512865228653286542865528656286572865828659286602866128662286632866428665286662866728668286692867028671286722867328674286752867628677286782867928680286812868228683286842868528686286872868828689286902869128692286932869428695286962869728698286992870028701287022870328704287052870628707287082870928710287112871228713287142871528716287172871828719287202872128722287232872428725287262872728728287292873028731287322873328734287352873628737287382873928740287412874228743287442874528746287472874828749287502875128752287532875428755287562875728758287592876028761287622876328764287652876628767287682876928770287712877228773287742877528776287772877828779287802878128782287832878428785287862878728788287892879028791287922879328794287952879628797287982879928800288012880228803288042880528806288072880828809288102881128812288132881428815288162881728818288192882028821288222882328824288252882628827288282882928830288312883228833288342883528836288372883828839288402884128842288432884428845288462884728848288492885028851288522885328854288552885628857288582885928860288612886228863288642886528866288672886828869288702887128872288732887428875288762887728878288792888028881288822888328884288852888628887288882888928890288912889228893288942889528896288972889828899289002890128902289032890428905289062890728908289092891028911289122891328914289152891628917289182891928920289212892228923289242892528926289272892828929289302893128932289332893428935289362893728938289392894028941289422894328944289452894628947289482894928950289512895228953289542895528956289572895828959289602896128962289632896428965289662896728968289692897028971289722897328974289752897628977289782897928980289812898228983289842898528986289872898828989289902899128992289932899428995289962899728998289992900029001290022900329004290052900629007290082900929010290112901229013290142901529016290172901829019290202902129022290232902429025290262902729028290292903029031290322903329034290352903629037290382903929040290412904229043290442904529046290472904829049290502905129052290532905429055290562905729058290592906029061290622906329064290652906629067290682906929070290712907229073290742907529076290772907829079290802908129082290832908429085290862908729088290892909029091290922909329094290952909629097290982909929100291012910229103291042910529106291072910829109291102911129112291132911429115291162911729118291192912029121291222912329124291252912629127291282912929130291312913229133291342913529136291372913829139291402914129142291432914429145291462914729148291492915029151291522915329154291552915629157291582915929160291612916229163291642916529166291672916829169291702917129172291732917429175291762917729178291792918029181291822918329184291852918629187291882918929190291912919229193291942919529196291972919829199292002920129202292032920429205292062920729208292092921029211292122921329214292152921629217292182921929220292212922229223292242922529226292272922829229292302923129232292332923429235292362923729238292392924029241292422924329244292452924629247292482924929250292512925229253292542925529256292572925829259292602926129262292632926429265292662926729268292692927029271292722927329274292752927629277292782927929280292812928229283292842928529286292872928829289292902929129292292932929429295292962929729298292992930029301293022930329304293052930629307293082930929310293112931229313293142931529316293172931829319293202932129322293232932429325293262932729328293292933029331293322933329334293352933629337293382933929340293412934229343293442934529346293472934829349293502935129352293532935429355293562935729358293592936029361293622936329364293652936629367293682936929370293712937229373293742937529376293772937829379293802938129382293832938429385293862938729388293892939029391293922939329394293952939629397293982939929400294012940229403294042940529406294072940829409294102941129412294132941429415294162941729418294192942029421294222942329424294252942629427294282942929430294312943229433294342943529436294372943829439294402944129442294432944429445294462944729448294492945029451294522945329454294552945629457294582945929460294612946229463294642946529466294672946829469294702947129472294732947429475294762947729478294792948029481294822948329484294852948629487294882948929490294912949229493294942949529496294972949829499295002950129502295032950429505295062950729508295092951029511295122951329514295152951629517295182951929520295212952229523295242952529526295272952829529295302953129532295332953429535295362953729538295392954029541295422954329544295452954629547295482954929550295512955229553295542955529556295572955829559295602956129562295632956429565295662956729568295692957029571295722957329574295752957629577295782957929580295812958229583295842958529586295872958829589295902959129592295932959429595295962959729598295992960029601296022960329604296052960629607296082960929610296112961229613296142961529616296172961829619296202962129622296232962429625296262962729628296292963029631296322963329634296352963629637296382963929640296412964229643296442964529646296472964829649296502965129652296532965429655296562965729658296592966029661296622966329664296652966629667296682966929670296712967229673296742967529676296772967829679296802968129682296832968429685296862968729688296892969029691296922969329694296952969629697296982969929700297012970229703297042970529706297072970829709297102971129712297132971429715297162971729718297192972029721297222972329724297252972629727297282972929730297312973229733297342973529736297372973829739297402974129742297432974429745297462974729748297492975029751297522975329754297552975629757297582975929760297612976229763297642976529766297672976829769297702977129772297732977429775297762977729778297792978029781297822978329784297852978629787297882978929790297912979229793297942979529796297972979829799298002980129802298032980429805298062980729808298092981029811298122981329814298152981629817298182981929820298212982229823298242982529826298272982829829298302983129832298332983429835298362983729838298392984029841298422984329844298452984629847298482984929850298512985229853298542985529856298572985829859298602986129862298632986429865298662986729868298692987029871298722987329874298752987629877298782987929880298812988229883298842988529886298872988829889298902989129892298932989429895298962989729898298992990029901299022990329904299052990629907299082990929910299112991229913299142991529916299172991829919299202992129922299232992429925299262992729928299292993029931299322993329934299352993629937299382993929940299412994229943299442994529946299472994829949299502995129952299532995429955299562995729958299592996029961299622996329964299652996629967299682996929970299712997229973299742997529976299772997829979299802998129982299832998429985299862998729988299892999029991299922999329994299952999629997299982999930000300013000230003300043000530006300073000830009300103001130012300133001430015300163001730018300193002030021300223002330024300253002630027300283002930030300313003230033300343003530036300373003830039300403004130042300433004430045300463004730048300493005030051300523005330054300553005630057300583005930060300613006230063300643006530066300673006830069300703007130072300733007430075300763007730078300793008030081300823008330084300853008630087300883008930090300913009230093300943009530096300973009830099301003010130102301033010430105301063010730108301093011030111301123011330114301153011630117301183011930120301213012230123301243012530126301273012830129301303013130132301333013430135301363013730138301393014030141301423014330144301453014630147301483014930150301513015230153301543015530156301573015830159301603016130162301633016430165301663016730168301693017030171301723017330174301753017630177301783017930180301813018230183301843018530186301873018830189301903019130192301933019430195301963019730198301993020030201302023020330204302053020630207302083020930210302113021230213302143021530216302173021830219302203022130222302233022430225302263022730228302293023030231302323023330234302353023630237302383023930240302413024230243302443024530246302473024830249302503025130252302533025430255302563025730258302593026030261302623026330264302653026630267302683026930270302713027230273302743027530276302773027830279302803028130282302833028430285302863028730288302893029030291302923029330294302953029630297302983029930300303013030230303303043030530306303073030830309303103031130312303133031430315303163031730318303193032030321303223032330324303253032630327303283032930330303313033230333303343033530336303373033830339303403034130342303433034430345303463034730348303493035030351303523035330354303553035630357303583035930360303613036230363303643036530366303673036830369303703037130372303733037430375303763037730378303793038030381303823038330384303853038630387303883038930390303913039230393303943039530396303973039830399304003040130402304033040430405304063040730408304093041030411304123041330414304153041630417304183041930420304213042230423304243042530426304273042830429304303043130432304333043430435304363043730438304393044030441304423044330444304453044630447304483044930450304513045230453304543045530456304573045830459304603046130462304633046430465304663046730468304693047030471304723047330474304753047630477304783047930480304813048230483304843048530486304873048830489304903049130492304933049430495304963049730498304993050030501305023050330504305053050630507305083050930510305113051230513305143051530516305173051830519305203052130522305233052430525305263052730528305293053030531305323053330534305353053630537305383053930540305413054230543305443054530546305473054830549305503055130552305533055430555305563055730558305593056030561305623056330564305653056630567305683056930570305713057230573305743057530576305773057830579305803058130582305833058430585305863058730588305893059030591305923059330594305953059630597305983059930600306013060230603306043060530606306073060830609306103061130612306133061430615306163061730618306193062030621306223062330624306253062630627306283062930630306313063230633306343063530636306373063830639306403064130642306433064430645306463064730648306493065030651306523065330654306553065630657306583065930660306613066230663306643066530666306673066830669306703067130672306733067430675306763067730678306793068030681306823068330684306853068630687306883068930690306913069230693306943069530696306973069830699307003070130702307033070430705307063070730708307093071030711307123071330714307153071630717307183071930720307213072230723307243072530726307273072830729307303073130732307333073430735307363073730738307393074030741307423074330744307453074630747307483074930750307513075230753307543075530756307573075830759307603076130762307633076430765307663076730768307693077030771307723077330774307753077630777307783077930780307813078230783307843078530786307873078830789307903079130792307933079430795307963079730798307993080030801308023080330804308053080630807308083080930810308113081230813308143081530816308173081830819308203082130822308233082430825308263082730828308293083030831308323083330834308353083630837308383083930840308413084230843308443084530846308473084830849308503085130852308533085430855308563085730858308593086030861308623086330864308653086630867308683086930870308713087230873308743087530876308773087830879308803088130882308833088430885308863088730888308893089030891308923089330894308953089630897308983089930900309013090230903309043090530906309073090830909309103091130912309133091430915309163091730918309193092030921309223092330924309253092630927309283092930930309313093230933309343093530936309373093830939309403094130942309433094430945309463094730948309493095030951309523095330954309553095630957309583095930960309613096230963309643096530966309673096830969309703097130972309733097430975309763097730978309793098030981309823098330984309853098630987309883098930990309913099230993309943099530996309973099830999310003100131002310033100431005310063100731008310093101031011310123101331014310153101631017310183101931020310213102231023310243102531026310273102831029310303103131032310333103431035310363103731038310393104031041310423104331044310453104631047310483104931050310513105231053310543105531056310573105831059310603106131062310633106431065310663106731068310693107031071310723107331074310753107631077310783107931080310813108231083310843108531086310873108831089310903109131092310933109431095310963109731098310993110031101311023110331104311053110631107311083110931110311113111231113311143111531116311173111831119311203112131122311233112431125311263112731128311293113031131311323113331134311353113631137311383113931140311413114231143311443114531146311473114831149311503115131152311533115431155311563115731158311593116031161311623116331164311653116631167311683116931170311713117231173311743117531176311773117831179311803118131182311833118431185311863118731188311893119031191311923119331194311953119631197311983119931200312013120231203312043120531206312073120831209312103121131212312133121431215312163121731218312193122031221312223122331224312253122631227312283122931230312313123231233312343123531236312373123831239312403124131242312433124431245312463124731248312493125031251312523125331254312553125631257312583125931260312613126231263312643126531266312673126831269312703127131272312733127431275312763127731278312793128031281312823128331284312853128631287312883128931290312913129231293312943129531296312973129831299313003130131302313033130431305313063130731308313093131031311313123131331314313153131631317313183131931320313213132231323313243132531326313273132831329313303133131332313333133431335313363133731338313393134031341313423134331344313453134631347313483134931350313513135231353313543135531356313573135831359313603136131362313633136431365313663136731368313693137031371313723137331374313753137631377313783137931380313813138231383313843138531386313873138831389313903139131392313933139431395313963139731398313993140031401314023140331404314053140631407314083140931410314113141231413314143141531416314173141831419314203142131422314233142431425314263142731428314293143031431314323143331434314353143631437314383143931440314413144231443314443144531446314473144831449314503145131452314533145431455314563145731458314593146031461314623146331464314653146631467314683146931470314713147231473314743147531476314773147831479314803148131482314833148431485314863148731488314893149031491314923149331494314953149631497314983149931500315013150231503315043150531506315073150831509315103151131512315133151431515315163151731518315193152031521315223152331524315253152631527315283152931530315313153231533315343153531536315373153831539315403154131542315433154431545315463154731548315493155031551315523155331554315553155631557315583155931560315613156231563315643156531566315673156831569315703157131572315733157431575315763157731578315793158031581315823158331584315853158631587315883158931590315913159231593315943159531596315973159831599316003160131602316033160431605316063160731608316093161031611316123161331614316153161631617316183161931620316213162231623316243162531626316273162831629316303163131632316333163431635316363163731638316393164031641316423164331644316453164631647316483164931650316513165231653316543165531656316573165831659316603166131662316633166431665316663166731668316693167031671316723167331674316753167631677316783167931680316813168231683316843168531686316873168831689316903169131692316933169431695316963169731698316993170031701317023170331704317053170631707317083170931710317113171231713317143171531716317173171831719317203172131722317233172431725317263172731728317293173031731317323173331734317353173631737317383173931740317413174231743317443174531746317473174831749317503175131752317533175431755317563175731758317593176031761317623176331764317653176631767317683176931770317713177231773317743177531776317773177831779317803178131782317833178431785317863178731788317893179031791317923179331794317953179631797317983179931800318013180231803318043180531806318073180831809318103181131812318133181431815318163181731818318193182031821318223182331824318253182631827318283182931830318313183231833318343183531836318373183831839318403184131842318433184431845318463184731848318493185031851318523185331854318553185631857318583185931860318613186231863318643186531866318673186831869318703187131872318733187431875318763187731878318793188031881318823188331884318853188631887318883188931890318913189231893318943189531896318973189831899319003190131902319033190431905319063190731908319093191031911319123191331914319153191631917319183191931920319213192231923319243192531926319273192831929319303193131932319333193431935319363193731938319393194031941319423194331944319453194631947319483194931950319513195231953319543195531956319573195831959319603196131962319633196431965319663196731968319693197031971319723197331974319753197631977319783197931980319813198231983319843198531986319873198831989319903199131992319933199431995319963199731998319993200032001320023200332004320053200632007320083200932010320113201232013320143201532016320173201832019320203202132022320233202432025320263202732028320293203032031320323203332034320353203632037320383203932040320413204232043320443204532046320473204832049320503205132052320533205432055320563205732058320593206032061320623206332064320653206632067320683206932070320713207232073320743207532076320773207832079320803208132082320833208432085320863208732088320893209032091320923209332094320953209632097320983209932100321013210232103321043210532106321073210832109321103211132112321133211432115321163211732118321193212032121321223212332124321253212632127321283212932130321313213232133321343213532136321373213832139321403214132142321433214432145321463214732148321493215032151321523215332154321553215632157321583215932160321613216232163321643216532166321673216832169321703217132172321733217432175321763217732178321793218032181321823218332184321853218632187321883218932190321913219232193321943219532196321973219832199322003220132202322033220432205322063220732208322093221032211322123221332214322153221632217322183221932220322213222232223322243222532226322273222832229322303223132232322333223432235322363223732238322393224032241322423224332244322453224632247322483224932250322513225232253322543225532256322573225832259322603226132262322633226432265322663226732268322693227032271322723227332274322753227632277322783227932280322813228232283322843228532286322873228832289322903229132292322933229432295322963229732298322993230032301323023230332304323053230632307323083230932310323113231232313323143231532316323173231832319323203232132322323233232432325323263232732328323293233032331323323233332334323353233632337323383233932340323413234232343323443234532346323473234832349323503235132352323533235432355323563235732358323593236032361323623236332364323653236632367323683236932370323713237232373323743237532376323773237832379323803238132382323833238432385323863238732388323893239032391323923239332394323953239632397323983239932400324013240232403324043240532406324073240832409324103241132412324133241432415324163241732418324193242032421324223242332424324253242632427324283242932430324313243232433324343243532436324373243832439324403244132442324433244432445324463244732448324493245032451324523245332454324553245632457324583245932460324613246232463324643246532466324673246832469324703247132472324733247432475324763247732478324793248032481324823248332484324853248632487324883248932490324913249232493324943249532496324973249832499325003250132502325033250432505325063250732508325093251032511325123251332514325153251632517325183251932520325213252232523325243252532526325273252832529325303253132532325333253432535325363253732538325393254032541325423254332544325453254632547325483254932550325513255232553325543255532556325573255832559325603256132562325633256432565325663256732568325693257032571325723257332574325753257632577325783257932580325813258232583325843258532586325873258832589325903259132592325933259432595325963259732598325993260032601326023260332604326053260632607326083260932610326113261232613326143261532616326173261832619326203262132622326233262432625326263262732628326293263032631326323263332634326353263632637326383263932640326413264232643326443264532646326473264832649326503265132652326533265432655326563265732658326593266032661326623266332664326653266632667326683266932670326713267232673326743267532676326773267832679326803268132682326833268432685326863268732688326893269032691326923269332694326953269632697326983269932700327013270232703327043270532706327073270832709327103271132712327133271432715327163271732718327193272032721327223272332724327253272632727327283272932730327313273232733327343273532736327373273832739327403274132742327433274432745327463274732748327493275032751327523275332754327553275632757327583275932760327613276232763327643276532766327673276832769327703277132772327733277432775327763277732778327793278032781327823278332784327853278632787327883278932790327913279232793327943279532796327973279832799328003280132802328033280432805328063280732808328093281032811328123281332814328153281632817328183281932820328213282232823328243282532826328273282832829328303283132832328333283432835328363283732838328393284032841328423284332844328453284632847328483284932850328513285232853328543285532856328573285832859328603286132862328633286432865328663286732868328693287032871328723287332874328753287632877328783287932880328813288232883328843288532886328873288832889328903289132892328933289432895328963289732898328993290032901329023290332904329053290632907329083290932910329113291232913329143291532916329173291832919329203292132922329233292432925329263292732928329293293032931329323293332934329353293632937329383293932940329413294232943329443294532946329473294832949329503295132952329533295432955329563295732958329593296032961329623296332964329653296632967329683296932970329713297232973329743297532976329773297832979329803298132982329833298432985329863298732988329893299032991329923299332994329953299632997329983299933000330013300233003330043300533006330073300833009330103301133012330133301433015330163301733018330193302033021330223302333024330253302633027330283302933030330313303233033330343303533036330373303833039330403304133042330433304433045330463304733048330493305033051330523305333054330553305633057330583305933060330613306233063330643306533066330673306833069330703307133072330733307433075330763307733078330793308033081330823308333084330853308633087330883308933090330913309233093330943309533096330973309833099331003310133102331033310433105331063310733108331093311033111331123311333114331153311633117331183311933120331213312233123331243312533126331273312833129331303313133132331333313433135331363313733138331393314033141331423314333144331453314633147331483314933150331513315233153331543315533156331573315833159331603316133162331633316433165331663316733168331693317033171331723317333174331753317633177331783317933180331813318233183331843318533186331873318833189331903319133192331933319433195331963319733198331993320033201332023320333204332053320633207332083320933210332113321233213332143321533216332173321833219332203322133222332233322433225332263322733228332293323033231332323323333234332353323633237332383323933240332413324233243332443324533246332473324833249332503325133252332533325433255332563325733258332593326033261332623326333264332653326633267332683326933270332713327233273332743327533276332773327833279332803328133282332833328433285332863328733288332893329033291332923329333294332953329633297332983329933300333013330233303333043330533306333073330833309333103331133312333133331433315333163331733318333193332033321333223332333324333253332633327333283332933330333313333233333333343333533336333373333833339333403334133342333433334433345333463334733348333493335033351333523335333354333553335633357333583335933360333613336233363333643336533366333673336833369333703337133372333733337433375333763337733378333793338033381333823338333384333853338633387333883338933390333913339233393333943339533396333973339833399334003340133402334033340433405334063340733408334093341033411334123341333414334153341633417334183341933420334213342233423334243342533426334273342833429334303343133432334333343433435334363343733438334393344033441334423344333444334453344633447334483344933450334513345233453334543345533456334573345833459334603346133462334633346433465334663346733468334693347033471334723347333474334753347633477334783347933480334813348233483334843348533486334873348833489334903349133492334933349433495334963349733498334993350033501335023350333504335053350633507335083350933510335113351233513335143351533516335173351833519335203352133522335233352433525335263352733528335293353033531335323353333534335353353633537335383353933540335413354233543335443354533546335473354833549335503355133552335533355433555335563355733558335593356033561335623356333564335653356633567335683356933570335713357233573335743357533576335773357833579335803358133582335833358433585335863358733588335893359033591335923359333594335953359633597335983359933600336013360233603336043360533606336073360833609336103361133612336133361433615336163361733618336193362033621336223362333624336253362633627336283362933630336313363233633336343363533636336373363833639336403364133642336433364433645336463364733648336493365033651336523365333654336553365633657336583365933660336613366233663336643366533666336673366833669336703367133672336733367433675336763367733678336793368033681336823368333684336853368633687336883368933690336913369233693336943369533696336973369833699337003370133702337033370433705337063370733708337093371033711337123371333714337153371633717337183371933720337213372233723337243372533726337273372833729337303373133732337333373433735337363373733738337393374033741337423374333744337453374633747337483374933750337513375233753337543375533756337573375833759337603376133762337633376433765337663376733768337693377033771337723377333774337753377633777337783377933780337813378233783337843378533786337873378833789337903379133792337933379433795337963379733798337993380033801338023380333804338053380633807338083380933810338113381233813338143381533816338173381833819338203382133822338233382433825338263382733828338293383033831338323383333834338353383633837338383383933840338413384233843338443384533846338473384833849338503385133852338533385433855338563385733858338593386033861338623386333864338653386633867338683386933870338713387233873338743387533876338773387833879338803388133882338833388433885338863388733888338893389033891338923389333894338953389633897338983389933900339013390233903339043390533906339073390833909339103391133912339133391433915339163391733918339193392033921339223392333924339253392633927339283392933930339313393233933339343393533936339373393833939339403394133942339433394433945339463394733948339493395033951339523395333954339553395633957339583395933960339613396233963339643396533966339673396833969339703397133972339733397433975339763397733978339793398033981339823398333984339853398633987339883398933990339913399233993339943399533996339973399833999340003400134002340033400434005340063400734008340093401034011340123401334014340153401634017340183401934020340213402234023340243402534026340273402834029340303403134032340333403434035340363403734038340393404034041340423404334044340453404634047340483404934050340513405234053340543405534056340573405834059340603406134062340633406434065340663406734068340693407034071340723407334074340753407634077340783407934080340813408234083340843408534086340873408834089340903409134092340933409434095340963409734098340993410034101341023410334104341053410634107341083410934110341113411234113341143411534116341173411834119341203412134122341233412434125341263412734128341293413034131341323413334134341353413634137341383413934140341413414234143341443414534146341473414834149341503415134152341533415434155341563415734158341593416034161341623416334164341653416634167341683416934170341713417234173341743417534176341773417834179341803418134182341833418434185341863418734188341893419034191341923419334194341953419634197341983419934200342013420234203342043420534206342073420834209342103421134212342133421434215342163421734218342193422034221342223422334224342253422634227342283422934230342313423234233342343423534236342373423834239342403424134242342433424434245342463424734248342493425034251342523425334254342553425634257342583425934260342613426234263342643426534266342673426834269342703427134272342733427434275342763427734278342793428034281342823428334284342853428634287342883428934290342913429234293342943429534296342973429834299343003430134302343033430434305343063430734308343093431034311343123431334314343153431634317343183431934320343213432234323343243432534326343273432834329343303433134332343333433434335343363433734338343393434034341343423434334344343453434634347343483434934350343513435234353343543435534356343573435834359343603436134362343633436434365343663436734368343693437034371343723437334374343753437634377343783437934380343813438234383343843438534386343873438834389343903439134392343933439434395343963439734398343993440034401344023440334404344053440634407344083440934410344113441234413344143441534416344173441834419344203442134422344233442434425344263442734428344293443034431344323443334434344353443634437344383443934440344413444234443344443444534446344473444834449344503445134452344533445434455344563445734458344593446034461344623446334464344653446634467344683446934470344713447234473344743447534476344773447834479344803448134482344833448434485344863448734488344893449034491344923449334494344953449634497344983449934500345013450234503345043450534506345073450834509345103451134512345133451434515345163451734518345193452034521345223452334524345253452634527345283452934530345313453234533345343453534536345373453834539345403454134542345433454434545345463454734548345493455034551345523455334554345553455634557345583455934560345613456234563345643456534566345673456834569345703457134572345733457434575345763457734578345793458034581345823458334584345853458634587345883458934590345913459234593345943459534596345973459834599346003460134602346033460434605346063460734608346093461034611346123461334614346153461634617346183461934620346213462234623346243462534626346273462834629346303463134632346333463434635346363463734638346393464034641346423464334644346453464634647346483464934650346513465234653346543465534656346573465834659346603466134662346633466434665346663466734668346693467034671346723467334674346753467634677346783467934680346813468234683346843468534686346873468834689346903469134692346933469434695346963469734698346993470034701347023470334704347053470634707347083470934710347113471234713347143471534716347173471834719347203472134722347233472434725347263472734728347293473034731347323473334734347353473634737347383473934740347413474234743347443474534746347473474834749347503475134752347533475434755347563475734758347593476034761347623476334764347653476634767347683476934770347713477234773347743477534776347773477834779347803478134782347833478434785347863478734788347893479034791347923479334794347953479634797347983479934800348013480234803348043480534806348073480834809348103481134812348133481434815348163481734818348193482034821348223482334824348253482634827348283482934830348313483234833348343483534836348373483834839348403484134842348433484434845348463484734848348493485034851348523485334854348553485634857348583485934860348613486234863348643486534866348673486834869348703487134872348733487434875348763487734878348793488034881348823488334884348853488634887348883488934890348913489234893348943489534896348973489834899349003490134902349033490434905349063490734908349093491034911349123491334914349153491634917349183491934920349213492234923349243492534926349273492834929349303493134932349333493434935349363493734938349393494034941349423494334944349453494634947349483494934950349513495234953349543495534956349573495834959349603496134962349633496434965349663496734968349693497034971349723497334974349753497634977349783497934980349813498234983349843498534986349873498834989349903499134992349933499434995349963499734998349993500035001350023500335004350053500635007350083500935010350113501235013350143501535016350173501835019350203502135022350233502435025350263502735028350293503035031350323503335034350353503635037350383503935040350413504235043350443504535046350473504835049350503505135052350533505435055350563505735058350593506035061350623506335064350653506635067350683506935070350713507235073350743507535076350773507835079350803508135082350833508435085350863508735088350893509035091350923509335094350953509635097350983509935100351013510235103351043510535106351073510835109351103511135112351133511435115351163511735118351193512035121351223512335124351253512635127351283512935130351313513235133351343513535136351373513835139351403514135142351433514435145351463514735148351493515035151351523515335154351553515635157351583515935160351613516235163351643516535166351673516835169351703517135172351733517435175351763517735178351793518035181351823518335184351853518635187351883518935190351913519235193351943519535196351973519835199352003520135202352033520435205352063520735208352093521035211352123521335214352153521635217352183521935220352213522235223352243522535226352273522835229352303523135232352333523435235352363523735238352393524035241352423524335244352453524635247352483524935250352513525235253352543525535256352573525835259352603526135262352633526435265352663526735268352693527035271352723527335274352753527635277352783527935280352813528235283352843528535286352873528835289352903529135292352933529435295352963529735298352993530035301353023530335304353053530635307353083530935310353113531235313353143531535316353173531835319353203532135322353233532435325353263532735328353293533035331353323533335334353353533635337353383533935340353413534235343353443534535346353473534835349353503535135352353533535435355353563535735358353593536035361353623536335364353653536635367353683536935370353713537235373353743537535376353773537835379353803538135382353833538435385353863538735388353893539035391353923539335394353953539635397353983539935400354013540235403354043540535406354073540835409354103541135412354133541435415354163541735418354193542035421354223542335424354253542635427354283542935430354313543235433354343543535436354373543835439354403544135442354433544435445354463544735448354493545035451354523545335454354553545635457354583545935460354613546235463354643546535466354673546835469354703547135472354733547435475354763547735478354793548035481354823548335484354853548635487354883548935490354913549235493354943549535496354973549835499355003550135502355033550435505355063550735508355093551035511355123551335514355153551635517355183551935520355213552235523355243552535526355273552835529355303553135532355333553435535355363553735538355393554035541355423554335544355453554635547355483554935550355513555235553355543555535556355573555835559355603556135562355633556435565355663556735568355693557035571355723557335574355753557635577355783557935580355813558235583355843558535586355873558835589355903559135592355933559435595355963559735598355993560035601356023560335604356053560635607356083560935610356113561235613356143561535616356173561835619356203562135622356233562435625356263562735628356293563035631356323563335634356353563635637356383563935640356413564235643356443564535646356473564835649356503565135652356533565435655356563565735658356593566035661356623566335664356653566635667356683566935670356713567235673356743567535676356773567835679356803568135682356833568435685356863568735688356893569035691356923569335694356953569635697356983569935700357013570235703357043570535706357073570835709357103571135712357133571435715357163571735718357193572035721357223572335724357253572635727357283572935730357313573235733357343573535736357373573835739357403574135742357433574435745357463574735748357493575035751357523575335754357553575635757357583575935760357613576235763357643576535766357673576835769357703577135772357733577435775357763577735778357793578035781357823578335784357853578635787357883578935790357913579235793357943579535796357973579835799358003580135802358033580435805358063580735808358093581035811358123581335814358153581635817358183581935820358213582235823358243582535826358273582835829358303583135832358333583435835358363583735838358393584035841358423584335844358453584635847358483584935850358513585235853358543585535856
  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="../generator/sshkey/">
  7. <link rel="next" href="../controller-options/">
  8. <link rel="icon" href="../../pictures/eso-round-logo.svg">
  9. <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
  10. <title>API specification - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
  12. <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.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. </div>
  26. <div data-md-component="announce">
  27. </div>
  28. <div data-md-color-scheme="default" data-md-component="outdated" hidden>
  29. <aside class="md-banner md-banner--warning">
  30. <div class="md-banner__inner md-grid md-typeset">
  31. You're not viewing the latest version.
  32. <a href="../../..">
  33. <strong>Click here to go to latest.</strong>
  34. </a>
  35. </div>
  36. <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>
  37. </aside>
  38. </div>
  39. <header class="md-header" data-md-component="header">
  40. <nav class="md-header__inner md-grid" aria-label="Header">
  41. <a href="../.." title="External Secrets Operator" class="md-header__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  42. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  43. </a>
  44. <label class="md-header__button md-icon" for="__drawer">
  45. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
  46. </label>
  47. <div class="md-header__title" data-md-component="header-title">
  48. <div class="md-header__ellipsis">
  49. <div class="md-header__topic">
  50. <span class="md-ellipsis">
  51. External Secrets Operator
  52. </span>
  53. </div>
  54. <div class="md-header__topic" data-md-component="header-topic">
  55. <span class="md-ellipsis">
  56. API specification
  57. </span>
  58. </div>
  59. </div>
  60. </div>
  61. <form class="md-header__option" data-md-component="palette">
  62. <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">
  63. <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
  64. <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>
  65. </label>
  66. <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">
  67. <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
  68. <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>
  69. </label>
  70. </form>
  71. <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>
  72. <label class="md-header__button md-icon" for="__search">
  73. <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>
  74. </label>
  75. <div class="md-search" data-md-component="search" role="dialog">
  76. <label class="md-search__overlay" for="__search"></label>
  77. <div class="md-search__inner" role="search">
  78. <form class="md-search__form" name="search">
  79. <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>
  80. <label class="md-search__icon md-icon" for="__search">
  81. <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>
  82. <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>
  83. </label>
  84. <nav class="md-search__options" aria-label="Search">
  85. <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
  86. <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>
  87. </button>
  88. </nav>
  89. </form>
  90. <div class="md-search__output">
  91. <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
  92. <div class="md-search-result" data-md-component="search-result">
  93. <div class="md-search-result__meta">
  94. Initializing search
  95. </div>
  96. <ol class="md-search-result__list" role="presentation"></ol>
  97. </div>
  98. </div>
  99. </div>
  100. </div>
  101. </div>
  102. <div class="md-header__source">
  103. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  104. <div class="md-source__icon md-icon">
  105. <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>
  106. </div>
  107. <div class="md-source__repository">
  108. External Secrets Operator
  109. </div>
  110. </a>
  111. </div>
  112. </nav>
  113. </header>
  114. <div class="md-container" data-md-component="container">
  115. <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
  116. <div class="md-grid">
  117. <ul class="md-tabs__list">
  118. <li class="md-tabs__item">
  119. <a href="../.." class="md-tabs__link">
  120. Introduction
  121. </a>
  122. </li>
  123. <li class="md-tabs__item md-tabs__item--active">
  124. <a href="../components/" class="md-tabs__link">
  125. API
  126. </a>
  127. </li>
  128. <li class="md-tabs__item">
  129. <a href="../../guides/introduction/" class="md-tabs__link">
  130. Guides
  131. </a>
  132. </li>
  133. <li class="md-tabs__item">
  134. <a href="../../provider/aws-secrets-manager/" class="md-tabs__link">
  135. Provider
  136. </a>
  137. </li>
  138. <li class="md-tabs__item">
  139. <a href="../../examples/gitops-using-fluxcd/" class="md-tabs__link">
  140. Examples
  141. </a>
  142. </li>
  143. <li class="md-tabs__item">
  144. <a href="../../contributing/devguide/" class="md-tabs__link">
  145. Community
  146. </a>
  147. </li>
  148. </ul>
  149. </div>
  150. </nav>
  151. <main class="md-main" data-md-component="main">
  152. <div class="md-main__inner md-grid">
  153. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  154. <div class="md-sidebar__scrollwrap">
  155. <div class="md-sidebar__inner">
  156. <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
  157. <label class="md-nav__title" for="__drawer">
  158. <a href="../.." title="External Secrets Operator" class="md-nav__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  159. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  160. </a>
  161. External Secrets Operator
  162. </label>
  163. <div class="md-nav__source">
  164. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  165. <div class="md-source__icon md-icon">
  166. <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>
  167. </div>
  168. <div class="md-source__repository">
  169. External Secrets Operator
  170. </div>
  171. </a>
  172. </div>
  173. <ul class="md-nav__list" data-md-scrollfix>
  174. <li class="md-nav__item md-nav__item--nested">
  175. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_1" >
  176. <div class="md-nav__link md-nav__container">
  177. <a href="../.." class="md-nav__link ">
  178. <span class="md-ellipsis">
  179. Introduction
  180. </span>
  181. </a>
  182. <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
  183. <span class="md-nav__icon md-icon"></span>
  184. </label>
  185. </div>
  186. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
  187. <label class="md-nav__title" for="__nav_1">
  188. <span class="md-nav__icon md-icon"></span>
  189. Introduction
  190. </label>
  191. <ul class="md-nav__list" data-md-scrollfix>
  192. <li class="md-nav__item">
  193. <a href="../../introduction/overview/" class="md-nav__link">
  194. <span class="md-ellipsis">
  195. Overview
  196. </span>
  197. </a>
  198. </li>
  199. <li class="md-nav__item">
  200. <a href="../../introduction/glossary/" class="md-nav__link">
  201. <span class="md-ellipsis">
  202. Glossary
  203. </span>
  204. </a>
  205. </li>
  206. <li class="md-nav__item">
  207. <a href="../../introduction/prerequisites/" class="md-nav__link">
  208. <span class="md-ellipsis">
  209. Prerequisites
  210. </span>
  211. </a>
  212. </li>
  213. <li class="md-nav__item">
  214. <a href="../../introduction/getting-started/" class="md-nav__link">
  215. <span class="md-ellipsis">
  216. Getting started
  217. </span>
  218. </a>
  219. </li>
  220. <li class="md-nav__item">
  221. <a href="../../introduction/faq/" class="md-nav__link">
  222. <span class="md-ellipsis">
  223. FAQ
  224. </span>
  225. </a>
  226. </li>
  227. <li class="md-nav__item">
  228. <a href="../../introduction/stability-support/" class="md-nav__link">
  229. <span class="md-ellipsis">
  230. Stability and Support
  231. </span>
  232. </a>
  233. </li>
  234. <li class="md-nav__item">
  235. <a href="../../introduction/deprecation-policy/" class="md-nav__link">
  236. <span class="md-ellipsis">
  237. Deprecation Policy
  238. </span>
  239. </a>
  240. </li>
  241. </ul>
  242. </nav>
  243. </li>
  244. <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
  245. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
  246. <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="">
  247. <span class="md-ellipsis">
  248. API
  249. </span>
  250. <span class="md-nav__icon md-icon"></span>
  251. </label>
  252. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
  253. <label class="md-nav__title" for="__nav_2">
  254. <span class="md-nav__icon md-icon"></span>
  255. API
  256. </label>
  257. <ul class="md-nav__list" data-md-scrollfix>
  258. <li class="md-nav__item">
  259. <a href="../components/" class="md-nav__link">
  260. <span class="md-ellipsis">
  261. Components
  262. </span>
  263. </a>
  264. </li>
  265. <li class="md-nav__item md-nav__item--nested">
  266. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_2" >
  267. <label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
  268. <span class="md-ellipsis">
  269. Core Resources
  270. </span>
  271. <span class="md-nav__icon md-icon"></span>
  272. </label>
  273. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
  274. <label class="md-nav__title" for="__nav_2_2">
  275. <span class="md-nav__icon md-icon"></span>
  276. Core Resources
  277. </label>
  278. <ul class="md-nav__list" data-md-scrollfix>
  279. <li class="md-nav__item">
  280. <a href="../externalsecret/" class="md-nav__link">
  281. <span class="md-ellipsis">
  282. ExternalSecret
  283. </span>
  284. </a>
  285. </li>
  286. <li class="md-nav__item">
  287. <a href="../secretstore/" class="md-nav__link">
  288. <span class="md-ellipsis">
  289. SecretStore
  290. </span>
  291. </a>
  292. </li>
  293. <li class="md-nav__item">
  294. <a href="../clustersecretstore/" class="md-nav__link">
  295. <span class="md-ellipsis">
  296. ClusterSecretStore
  297. </span>
  298. </a>
  299. </li>
  300. <li class="md-nav__item">
  301. <a href="../clusterexternalsecret/" class="md-nav__link">
  302. <span class="md-ellipsis">
  303. ClusterExternalSecret
  304. </span>
  305. </a>
  306. </li>
  307. <li class="md-nav__item">
  308. <a href="../clusterpushsecret/" class="md-nav__link">
  309. <span class="md-ellipsis">
  310. ClusterPushSecret
  311. </span>
  312. </a>
  313. </li>
  314. <li class="md-nav__item">
  315. <a href="../pushsecret/" class="md-nav__link">
  316. <span class="md-ellipsis">
  317. PushSecret
  318. </span>
  319. </a>
  320. </li>
  321. </ul>
  322. </nav>
  323. </li>
  324. <li class="md-nav__item md-nav__item--nested">
  325. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_3" >
  326. <div class="md-nav__link md-nav__container">
  327. <a href="../generator/" class="md-nav__link ">
  328. <span class="md-ellipsis">
  329. Generators
  330. </span>
  331. </a>
  332. <label class="md-nav__link " for="__nav_2_3" id="__nav_2_3_label" tabindex="0">
  333. <span class="md-nav__icon md-icon"></span>
  334. </label>
  335. </div>
  336. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
  337. <label class="md-nav__title" for="__nav_2_3">
  338. <span class="md-nav__icon md-icon"></span>
  339. Generators
  340. </label>
  341. <ul class="md-nav__list" data-md-scrollfix>
  342. <li class="md-nav__item">
  343. <a href="../generator/acr/" class="md-nav__link">
  344. <span class="md-ellipsis">
  345. Azure Container Registry
  346. </span>
  347. </a>
  348. </li>
  349. <li class="md-nav__item">
  350. <a href="../generator/ecr/" class="md-nav__link">
  351. <span class="md-ellipsis">
  352. AWS Elastic Container Registry
  353. </span>
  354. </a>
  355. </li>
  356. <li class="md-nav__item">
  357. <a href="../generator/sts/" class="md-nav__link">
  358. <span class="md-ellipsis">
  359. AWS STS Session Token
  360. </span>
  361. </a>
  362. </li>
  363. <li class="md-nav__item">
  364. <a href="../generator/cloudsmith/" class="md-nav__link">
  365. <span class="md-ellipsis">
  366. Cloudsmith
  367. </span>
  368. </a>
  369. </li>
  370. <li class="md-nav__item">
  371. <a href="../generator/cluster/" class="md-nav__link">
  372. <span class="md-ellipsis">
  373. Cluster Generator
  374. </span>
  375. </a>
  376. </li>
  377. <li class="md-nav__item">
  378. <a href="../generator/gcr/" class="md-nav__link">
  379. <span class="md-ellipsis">
  380. Google Container Registry
  381. </span>
  382. </a>
  383. </li>
  384. <li class="md-nav__item">
  385. <a href="../generator/grafana/" class="md-nav__link">
  386. <span class="md-ellipsis">
  387. Grafana
  388. </span>
  389. </a>
  390. </li>
  391. <li class="md-nav__item">
  392. <a href="../generator/quay/" class="md-nav__link">
  393. <span class="md-ellipsis">
  394. Quay
  395. </span>
  396. </a>
  397. </li>
  398. <li class="md-nav__item">
  399. <a href="../generator/vault/" class="md-nav__link">
  400. <span class="md-ellipsis">
  401. Vault Dynamic Secret
  402. </span>
  403. </a>
  404. </li>
  405. <li class="md-nav__item">
  406. <a href="../generator/password/" class="md-nav__link">
  407. <span class="md-ellipsis">
  408. Password
  409. </span>
  410. </a>
  411. </li>
  412. <li class="md-nav__item">
  413. <a href="../generator/fake/" class="md-nav__link">
  414. <span class="md-ellipsis">
  415. Fake
  416. </span>
  417. </a>
  418. </li>
  419. <li class="md-nav__item">
  420. <a href="../generator/webhook/" class="md-nav__link">
  421. <span class="md-ellipsis">
  422. Webhook
  423. </span>
  424. </a>
  425. </li>
  426. <li class="md-nav__item">
  427. <a href="../generator/github/" class="md-nav__link">
  428. <span class="md-ellipsis">
  429. Github
  430. </span>
  431. </a>
  432. </li>
  433. <li class="md-nav__item">
  434. <a href="../generator/gitlab/" class="md-nav__link">
  435. <span class="md-ellipsis">
  436. Gitlab
  437. </span>
  438. </a>
  439. </li>
  440. <li class="md-nav__item">
  441. <a href="../generator/uuid/" class="md-nav__link">
  442. <span class="md-ellipsis">
  443. UUID
  444. </span>
  445. </a>
  446. </li>
  447. <li class="md-nav__item">
  448. <a href="../generator/mfa/" class="md-nav__link">
  449. <span class="md-ellipsis">
  450. MFA
  451. </span>
  452. </a>
  453. </li>
  454. <li class="md-nav__item">
  455. <a href="../generator/sshkey/" class="md-nav__link">
  456. <span class="md-ellipsis">
  457. SSHKey
  458. </span>
  459. </a>
  460. </li>
  461. </ul>
  462. </nav>
  463. </li>
  464. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  465. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4" checked>
  466. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  467. <span class="md-ellipsis">
  468. Reference Docs
  469. </span>
  470. <span class="md-nav__icon md-icon"></span>
  471. </label>
  472. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="true">
  473. <label class="md-nav__title" for="__nav_2_4">
  474. <span class="md-nav__icon md-icon"></span>
  475. Reference Docs
  476. </label>
  477. <ul class="md-nav__list" data-md-scrollfix>
  478. <li class="md-nav__item md-nav__item--active">
  479. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  480. <a href="./" class="md-nav__link md-nav__link--active">
  481. <span class="md-ellipsis">
  482. API specification
  483. </span>
  484. </a>
  485. </li>
  486. <li class="md-nav__item">
  487. <a href="../controller-options/" class="md-nav__link">
  488. <span class="md-ellipsis">
  489. Controller Options
  490. </span>
  491. </a>
  492. </li>
  493. <li class="md-nav__item">
  494. <a href="../metrics/" class="md-nav__link">
  495. <span class="md-ellipsis">
  496. Metrics
  497. </span>
  498. </a>
  499. </li>
  500. <li class="md-nav__item">
  501. <a href="../selectable-fields/" class="md-nav__link">
  502. <span class="md-ellipsis">
  503. Selectable Fields
  504. </span>
  505. </a>
  506. </li>
  507. </ul>
  508. </nav>
  509. </li>
  510. </ul>
  511. </nav>
  512. </li>
  513. <li class="md-nav__item md-nav__item--nested">
  514. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  515. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  516. <span class="md-ellipsis">
  517. Guides
  518. </span>
  519. <span class="md-nav__icon md-icon"></span>
  520. </label>
  521. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  522. <label class="md-nav__title" for="__nav_3">
  523. <span class="md-nav__icon md-icon"></span>
  524. Guides
  525. </label>
  526. <ul class="md-nav__list" data-md-scrollfix>
  527. <li class="md-nav__item">
  528. <a href="../../guides/introduction/" class="md-nav__link">
  529. <span class="md-ellipsis">
  530. Introduction
  531. </span>
  532. </a>
  533. </li>
  534. <li class="md-nav__item md-nav__item--nested">
  535. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  536. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  537. <span class="md-ellipsis">
  538. External Secrets
  539. </span>
  540. <span class="md-nav__icon md-icon"></span>
  541. </label>
  542. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  543. <label class="md-nav__title" for="__nav_3_2">
  544. <span class="md-nav__icon md-icon"></span>
  545. External Secrets
  546. </label>
  547. <ul class="md-nav__list" data-md-scrollfix>
  548. <li class="md-nav__item">
  549. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  550. <span class="md-ellipsis">
  551. Extract structured data
  552. </span>
  553. </a>
  554. </li>
  555. <li class="md-nav__item">
  556. <a href="../../guides/getallsecrets/" class="md-nav__link">
  557. <span class="md-ellipsis">
  558. Find Secrets by Name or Metadata
  559. </span>
  560. </a>
  561. </li>
  562. <li class="md-nav__item">
  563. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  564. <span class="md-ellipsis">
  565. Rewriting Keys
  566. </span>
  567. </a>
  568. </li>
  569. <li class="md-nav__item md-nav__item--nested">
  570. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  571. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  572. <span class="md-ellipsis">
  573. Advanced Templating
  574. </span>
  575. <span class="md-nav__icon md-icon"></span>
  576. </label>
  577. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  578. <label class="md-nav__title" for="__nav_3_2_4">
  579. <span class="md-nav__icon md-icon"></span>
  580. Advanced Templating
  581. </label>
  582. <ul class="md-nav__list" data-md-scrollfix>
  583. <li class="md-nav__item">
  584. <a href="../../guides/templating/" class="md-nav__link">
  585. <span class="md-ellipsis">
  586. v2
  587. </span>
  588. </a>
  589. </li>
  590. <li class="md-nav__item">
  591. <a href="../../guides/templating-v1/" class="md-nav__link">
  592. <span class="md-ellipsis">
  593. v1
  594. </span>
  595. </a>
  596. </li>
  597. </ul>
  598. </nav>
  599. </li>
  600. <li class="md-nav__item">
  601. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  602. <span class="md-ellipsis">
  603. Kubernetes Secret Types
  604. </span>
  605. </a>
  606. </li>
  607. <li class="md-nav__item">
  608. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  609. <span class="md-ellipsis">
  610. Lifecycle: ownership & deletion
  611. </span>
  612. </a>
  613. </li>
  614. <li class="md-nav__item">
  615. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  616. <span class="md-ellipsis">
  617. Decoding Strategies
  618. </span>
  619. </a>
  620. </li>
  621. <li class="md-nav__item">
  622. <a href="../../guides/controller-class/" class="md-nav__link">
  623. <span class="md-ellipsis">
  624. Controller Classes
  625. </span>
  626. </a>
  627. </li>
  628. </ul>
  629. </nav>
  630. </li>
  631. <li class="md-nav__item">
  632. <a href="../../guides/targeting-custom-resources/" class="md-nav__link">
  633. <span class="md-ellipsis">
  634. Targeting Custom Resources
  635. </span>
  636. </a>
  637. </li>
  638. <li class="md-nav__item">
  639. <a href="../../guides/generator/" class="md-nav__link">
  640. <span class="md-ellipsis">
  641. Generators
  642. </span>
  643. </a>
  644. </li>
  645. <li class="md-nav__item">
  646. <a href="../../guides/pushsecrets/" class="md-nav__link">
  647. <span class="md-ellipsis">
  648. Push Secrets
  649. </span>
  650. </a>
  651. </li>
  652. <li class="md-nav__item md-nav__item--nested">
  653. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_6" >
  654. <label class="md-nav__link" for="__nav_3_6" id="__nav_3_6_label" tabindex="0">
  655. <span class="md-ellipsis">
  656. Operations
  657. </span>
  658. <span class="md-nav__icon md-icon"></span>
  659. </label>
  660. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_6_label" aria-expanded="false">
  661. <label class="md-nav__title" for="__nav_3_6">
  662. <span class="md-nav__icon md-icon"></span>
  663. Operations
  664. </label>
  665. <ul class="md-nav__list" data-md-scrollfix>
  666. <li class="md-nav__item">
  667. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  668. <span class="md-ellipsis">
  669. Multi Tenancy
  670. </span>
  671. </a>
  672. </li>
  673. <li class="md-nav__item">
  674. <a href="../../guides/security-best-practices/" class="md-nav__link">
  675. <span class="md-ellipsis">
  676. Security Best Practices
  677. </span>
  678. </a>
  679. </li>
  680. <li class="md-nav__item">
  681. <a href="../../guides/threat-model/" class="md-nav__link">
  682. <span class="md-ellipsis">
  683. Threat Model
  684. </span>
  685. </a>
  686. </li>
  687. <li class="md-nav__item">
  688. <a href="../../guides/v1beta1/" class="md-nav__link">
  689. <span class="md-ellipsis">
  690. Upgrading to v1beta1
  691. </span>
  692. </a>
  693. </li>
  694. <li class="md-nav__item">
  695. <a href="../../guides/using-latest-image/" class="md-nav__link">
  696. <span class="md-ellipsis">
  697. Using Latest Image
  698. </span>
  699. </a>
  700. </li>
  701. <li class="md-nav__item">
  702. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  703. <span class="md-ellipsis">
  704. Disable Cluster Features
  705. </span>
  706. </a>
  707. </li>
  708. </ul>
  709. </nav>
  710. </li>
  711. <li class="md-nav__item md-nav__item--nested">
  712. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_7" >
  713. <label class="md-nav__link" for="__nav_3_7" id="__nav_3_7_label" tabindex="0">
  714. <span class="md-ellipsis">
  715. Tooling
  716. </span>
  717. <span class="md-nav__icon md-icon"></span>
  718. </label>
  719. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_7_label" aria-expanded="false">
  720. <label class="md-nav__title" for="__nav_3_7">
  721. <span class="md-nav__icon md-icon"></span>
  722. Tooling
  723. </label>
  724. <ul class="md-nav__list" data-md-scrollfix>
  725. <li class="md-nav__item">
  726. <a href="../../guides/using-esoctl-tool/" class="md-nav__link">
  727. <span class="md-ellipsis">
  728. Using the esoctl tool
  729. </span>
  730. </a>
  731. </li>
  732. </ul>
  733. </nav>
  734. </li>
  735. </ul>
  736. </nav>
  737. </li>
  738. <li class="md-nav__item md-nav__item--nested">
  739. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
  740. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  741. <span class="md-ellipsis">
  742. Provider
  743. </span>
  744. <span class="md-nav__icon md-icon"></span>
  745. </label>
  746. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  747. <label class="md-nav__title" for="__nav_4">
  748. <span class="md-nav__icon md-icon"></span>
  749. Provider
  750. </label>
  751. <ul class="md-nav__list" data-md-scrollfix>
  752. <li class="md-nav__item">
  753. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  754. <span class="md-ellipsis">
  755. AWS Secrets Manager
  756. </span>
  757. </a>
  758. </li>
  759. <li class="md-nav__item">
  760. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  761. <span class="md-ellipsis">
  762. AWS Parameter Store
  763. </span>
  764. </a>
  765. </li>
  766. <li class="md-nav__item">
  767. <a href="../../provider/aws-access/" class="md-nav__link">
  768. <span class="md-ellipsis">
  769. AWS Access
  770. </span>
  771. </a>
  772. </li>
  773. <li class="md-nav__item">
  774. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  775. <span class="md-ellipsis">
  776. Azure Key Vault
  777. </span>
  778. </a>
  779. </li>
  780. <li class="md-nav__item">
  781. <a href="../../provider/barbican/" class="md-nav__link">
  782. <span class="md-ellipsis">
  783. Barbican
  784. </span>
  785. </a>
  786. </li>
  787. <li class="md-nav__item">
  788. <a href="../../provider/beyondtrust/" class="md-nav__link">
  789. <span class="md-ellipsis">
  790. BeyondTrust
  791. </span>
  792. </a>
  793. </li>
  794. <li class="md-nav__item">
  795. <a href="../../provider/bitwarden-secrets-manager/" class="md-nav__link">
  796. <span class="md-ellipsis">
  797. Bitwarden Secrets Manager
  798. </span>
  799. </a>
  800. </li>
  801. <li class="md-nav__item">
  802. <a href="../../provider/chef/" class="md-nav__link">
  803. <span class="md-ellipsis">
  804. Chef
  805. </span>
  806. </a>
  807. </li>
  808. <li class="md-nav__item">
  809. <a href="../../provider/cloudru/" class="md-nav__link">
  810. <span class="md-ellipsis">
  811. Cloud.ru Secret Manager
  812. </span>
  813. </a>
  814. </li>
  815. <li class="md-nav__item">
  816. <a href="../../provider/conjur/" class="md-nav__link">
  817. <span class="md-ellipsis">
  818. CyberArk Conjur
  819. </span>
  820. </a>
  821. </li>
  822. <li class="md-nav__item">
  823. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  824. <span class="md-ellipsis">
  825. Google Cloud Secret Manager
  826. </span>
  827. </a>
  828. </li>
  829. <li class="md-nav__item">
  830. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  831. <span class="md-ellipsis">
  832. HashiCorp Vault
  833. </span>
  834. </a>
  835. </li>
  836. <li class="md-nav__item">
  837. <a href="../../provider/kubernetes/" class="md-nav__link">
  838. <span class="md-ellipsis">
  839. Kubernetes
  840. </span>
  841. </a>
  842. </li>
  843. <li class="md-nav__item">
  844. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  845. <span class="md-ellipsis">
  846. IBM Secrets Manager
  847. </span>
  848. </a>
  849. </li>
  850. <li class="md-nav__item">
  851. <a href="../../provider/akeyless/" class="md-nav__link">
  852. <span class="md-ellipsis">
  853. Akeyless
  854. </span>
  855. </a>
  856. </li>
  857. <li class="md-nav__item">
  858. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  859. <span class="md-ellipsis">
  860. Yandex Certificate Manager
  861. </span>
  862. </a>
  863. </li>
  864. <li class="md-nav__item">
  865. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  866. <span class="md-ellipsis">
  867. Yandex Lockbox
  868. </span>
  869. </a>
  870. </li>
  871. <li class="md-nav__item">
  872. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  873. <span class="md-ellipsis">
  874. GitLab Variables
  875. </span>
  876. </a>
  877. </li>
  878. <li class="md-nav__item">
  879. <a href="../../provider/github/" class="md-nav__link">
  880. <span class="md-ellipsis">
  881. Github Actions Secrets
  882. </span>
  883. </a>
  884. </li>
  885. <li class="md-nav__item">
  886. <a href="../../provider/oracle-vault/" class="md-nav__link">
  887. <span class="md-ellipsis">
  888. Oracle Vault
  889. </span>
  890. </a>
  891. </li>
  892. <li class="md-nav__item">
  893. <a href="../../provider/ovhcloud/" class="md-nav__link">
  894. <span class="md-ellipsis">
  895. OVHcloud
  896. </span>
  897. </a>
  898. </li>
  899. <li class="md-nav__item">
  900. <a href="../../provider/1password-automation/" class="md-nav__link">
  901. <span class="md-ellipsis">
  902. 1Password Connect Server
  903. </span>
  904. </a>
  905. </li>
  906. <li class="md-nav__item">
  907. <a href="../../provider/1password-sdk/" class="md-nav__link">
  908. <span class="md-ellipsis">
  909. 1Password SDK
  910. </span>
  911. </a>
  912. </li>
  913. <li class="md-nav__item">
  914. <a href="../../provider/webhook/" class="md-nav__link">
  915. <span class="md-ellipsis">
  916. Webhook
  917. </span>
  918. </a>
  919. </li>
  920. <li class="md-nav__item">
  921. <a href="../../provider/fake/" class="md-nav__link">
  922. <span class="md-ellipsis">
  923. Fake
  924. </span>
  925. </a>
  926. </li>
  927. <li class="md-nav__item">
  928. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  929. <span class="md-ellipsis">
  930. senhasegura DevOps Secrets Management (DSM)
  931. </span>
  932. </a>
  933. </li>
  934. <li class="md-nav__item">
  935. <a href="../../provider/doppler/" class="md-nav__link">
  936. <span class="md-ellipsis">
  937. Doppler
  938. </span>
  939. </a>
  940. </li>
  941. <li class="md-nav__item">
  942. <a href="../../provider/keeper-security/" class="md-nav__link">
  943. <span class="md-ellipsis">
  944. Keeper Security
  945. </span>
  946. </a>
  947. </li>
  948. <li class="md-nav__item">
  949. <a href="../../provider/cloak/" class="md-nav__link">
  950. <span class="md-ellipsis">
  951. Cloak End 2 End Encrypted Secrets
  952. </span>
  953. </a>
  954. </li>
  955. <li class="md-nav__item">
  956. <a href="../../provider/scaleway/" class="md-nav__link">
  957. <span class="md-ellipsis">
  958. Scaleway
  959. </span>
  960. </a>
  961. </li>
  962. <li class="md-nav__item">
  963. <a href="../../provider/delinea/" class="md-nav__link">
  964. <span class="md-ellipsis">
  965. Delinea
  966. </span>
  967. </a>
  968. </li>
  969. <li class="md-nav__item">
  970. <a href="../../provider/secretserver/" class="md-nav__link">
  971. <span class="md-ellipsis">
  972. Secret Server
  973. </span>
  974. </a>
  975. </li>
  976. <li class="md-nav__item">
  977. <a href="../../provider/passbolt/" class="md-nav__link">
  978. <span class="md-ellipsis">
  979. Passbolt
  980. </span>
  981. </a>
  982. </li>
  983. <li class="md-nav__item">
  984. <a href="../../provider/pulumi/" class="md-nav__link">
  985. <span class="md-ellipsis">
  986. Pulumi ESC
  987. </span>
  988. </a>
  989. </li>
  990. <li class="md-nav__item">
  991. <a href="../../provider/onboardbase/" class="md-nav__link">
  992. <span class="md-ellipsis">
  993. Onboardbase
  994. </span>
  995. </a>
  996. </li>
  997. <li class="md-nav__item">
  998. <a href="../../provider-passworddepot/" class="md-nav__link">
  999. <span class="md-ellipsis">
  1000. Password Depot
  1001. </span>
  1002. </a>
  1003. </li>
  1004. <li class="md-nav__item">
  1005. <a href="../../provider/fortanix/" class="md-nav__link">
  1006. <span class="md-ellipsis">
  1007. Fortanix
  1008. </span>
  1009. </a>
  1010. </li>
  1011. <li class="md-nav__item">
  1012. <a href="../../provider/infisical/" class="md-nav__link">
  1013. <span class="md-ellipsis">
  1014. Infisical
  1015. </span>
  1016. </a>
  1017. </li>
  1018. <li class="md-nav__item">
  1019. <a href="../../provider/previder/" class="md-nav__link">
  1020. <span class="md-ellipsis">
  1021. Previder
  1022. </span>
  1023. </a>
  1024. </li>
  1025. <li class="md-nav__item">
  1026. <a href="../../provider/openbao/" class="md-nav__link">
  1027. <span class="md-ellipsis">
  1028. OpenBao
  1029. </span>
  1030. </a>
  1031. </li>
  1032. <li class="md-nav__item">
  1033. <a href="../../provider/volcengine/" class="md-nav__link">
  1034. <span class="md-ellipsis">
  1035. Volcengine
  1036. </span>
  1037. </a>
  1038. </li>
  1039. <li class="md-nav__item">
  1040. <a href="../../provider/ngrok/" class="md-nav__link">
  1041. <span class="md-ellipsis">
  1042. ngrok
  1043. </span>
  1044. </a>
  1045. </li>
  1046. <li class="md-nav__item">
  1047. <a href="../../provider/devolutions-server/" class="md-nav__link">
  1048. <span class="md-ellipsis">
  1049. Devolutions Server
  1050. </span>
  1051. </a>
  1052. </li>
  1053. <li class="md-nav__item">
  1054. <a href="../../provider/nebius-mysterybox/" class="md-nav__link">
  1055. <span class="md-ellipsis">
  1056. Nebius MysteryBox
  1057. </span>
  1058. </a>
  1059. </li>
  1060. </ul>
  1061. </nav>
  1062. </li>
  1063. <li class="md-nav__item md-nav__item--nested">
  1064. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  1065. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  1066. <span class="md-ellipsis">
  1067. Examples
  1068. </span>
  1069. <span class="md-nav__icon md-icon"></span>
  1070. </label>
  1071. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  1072. <label class="md-nav__title" for="__nav_5">
  1073. <span class="md-nav__icon md-icon"></span>
  1074. Examples
  1075. </label>
  1076. <ul class="md-nav__list" data-md-scrollfix>
  1077. <li class="md-nav__item">
  1078. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  1079. <span class="md-ellipsis">
  1080. FluxCD
  1081. </span>
  1082. </a>
  1083. </li>
  1084. <li class="md-nav__item">
  1085. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  1086. <span class="md-ellipsis">
  1087. Anchore Engine
  1088. </span>
  1089. </a>
  1090. </li>
  1091. <li class="md-nav__item">
  1092. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  1093. <span class="md-ellipsis">
  1094. Jenkins
  1095. </span>
  1096. </a>
  1097. </li>
  1098. <li class="md-nav__item">
  1099. <a href="../../examples/bitwarden/" class="md-nav__link">
  1100. <span class="md-ellipsis">
  1101. Bitwarden
  1102. </span>
  1103. </a>
  1104. </li>
  1105. </ul>
  1106. </nav>
  1107. </li>
  1108. <li class="md-nav__item md-nav__item--nested">
  1109. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  1110. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  1111. <span class="md-ellipsis">
  1112. Community
  1113. </span>
  1114. <span class="md-nav__icon md-icon"></span>
  1115. </label>
  1116. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  1117. <label class="md-nav__title" for="__nav_6">
  1118. <span class="md-nav__icon md-icon"></span>
  1119. Community
  1120. </label>
  1121. <ul class="md-nav__list" data-md-scrollfix>
  1122. <li class="md-nav__item md-nav__item--nested">
  1123. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  1124. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  1125. <span class="md-ellipsis">
  1126. Contributing
  1127. </span>
  1128. <span class="md-nav__icon md-icon"></span>
  1129. </label>
  1130. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  1131. <label class="md-nav__title" for="__nav_6_1">
  1132. <span class="md-nav__icon md-icon"></span>
  1133. Contributing
  1134. </label>
  1135. <ul class="md-nav__list" data-md-scrollfix>
  1136. <li class="md-nav__item">
  1137. <a href="../../contributing/devguide/" class="md-nav__link">
  1138. <span class="md-ellipsis">
  1139. Developer guide
  1140. </span>
  1141. </a>
  1142. </li>
  1143. <li class="md-nav__item">
  1144. <a href="../../contributing/process/" class="md-nav__link">
  1145. <span class="md-ellipsis">
  1146. Contributing Process
  1147. </span>
  1148. </a>
  1149. </li>
  1150. <li class="md-nav__item">
  1151. <a href="../../contributing/release/" class="md-nav__link">
  1152. <span class="md-ellipsis">
  1153. Release Process
  1154. </span>
  1155. </a>
  1156. </li>
  1157. <li class="md-nav__item">
  1158. <a href="../../contributing/coc/" class="md-nav__link">
  1159. <span class="md-ellipsis">
  1160. Code of Conduct
  1161. </span>
  1162. </a>
  1163. </li>
  1164. <li class="md-nav__item">
  1165. <a href="../../contributing/calendar/" class="md-nav__link">
  1166. <span class="md-ellipsis">
  1167. Community meetings calendar
  1168. </span>
  1169. </a>
  1170. </li>
  1171. <li class="md-nav__item">
  1172. <a href="../../contributing/roadmap/" class="md-nav__link">
  1173. <span class="md-ellipsis">
  1174. Roadmap
  1175. </span>
  1176. </a>
  1177. </li>
  1178. <li class="md-nav__item">
  1179. <a href="../../contributing/burnout-mitigation/" class="md-nav__link">
  1180. <span class="md-ellipsis">
  1181. Burnout Prevention
  1182. </span>
  1183. </a>
  1184. </li>
  1185. <li class="md-nav__item">
  1186. <a href="../../contributing/llm-policy/" class="md-nav__link">
  1187. <span class="md-ellipsis">
  1188. LLM Policy
  1189. </span>
  1190. </a>
  1191. </li>
  1192. </ul>
  1193. </nav>
  1194. </li>
  1195. <li class="md-nav__item md-nav__item--nested">
  1196. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1197. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1198. <span class="md-ellipsis">
  1199. External Resources
  1200. </span>
  1201. <span class="md-nav__icon md-icon"></span>
  1202. </label>
  1203. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1204. <label class="md-nav__title" for="__nav_6_2">
  1205. <span class="md-nav__icon md-icon"></span>
  1206. External Resources
  1207. </label>
  1208. <ul class="md-nav__list" data-md-scrollfix>
  1209. <li class="md-nav__item">
  1210. <a href="../../eso-talks/" class="md-nav__link">
  1211. <span class="md-ellipsis">
  1212. Talks
  1213. </span>
  1214. </a>
  1215. </li>
  1216. <li class="md-nav__item">
  1217. <a href="../../eso-demos/" class="md-nav__link">
  1218. <span class="md-ellipsis">
  1219. Demos
  1220. </span>
  1221. </a>
  1222. </li>
  1223. <li class="md-nav__item">
  1224. <a href="../../eso-blogs/" class="md-nav__link">
  1225. <span class="md-ellipsis">
  1226. Blogs
  1227. </span>
  1228. </a>
  1229. </li>
  1230. <li class="md-nav__item">
  1231. <a href="../../eso-tools/" class="md-nav__link">
  1232. <span class="md-ellipsis">
  1233. Tools
  1234. </span>
  1235. </a>
  1236. </li>
  1237. </ul>
  1238. </nav>
  1239. </li>
  1240. </ul>
  1241. </nav>
  1242. </li>
  1243. </ul>
  1244. </nav>
  1245. </div>
  1246. </div>
  1247. </div>
  1248. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1249. <div class="md-sidebar__scrollwrap">
  1250. <div class="md-sidebar__inner">
  1251. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1252. </nav>
  1253. </div>
  1254. </div>
  1255. </div>
  1256. <div class="md-content" data-md-component="content">
  1257. <article class="md-content__inner md-typeset">
  1258. <h1>API specification</h1>
  1259. <p>Packages:</p>
  1260. <ul>
  1261. <li>
  1262. <a href="#external-secrets.io%2fv1">external-secrets.io/v1</a>
  1263. </li>
  1264. <li>
  1265. <a href="#external-secrets.io%2fv1alpha1">external-secrets.io/v1alpha1</a>
  1266. </li>
  1267. <li>
  1268. <a href="#external-secrets.io%2fv1beta1">external-secrets.io/v1beta1</a>
  1269. </li>
  1270. <li>
  1271. <a href="#generators.external-secrets.io%2fv1alpha1">generators.external-secrets.io/v1alpha1</a>
  1272. </li>
  1273. </ul>
  1274. <h2 id="external-secrets.io/v1">external-secrets.io/v1</h2>
  1275. <p>
  1276. <p>Package v1 contains resources for external-secrets</p>
  1277. </p>
  1278. <p>Resource Types:</p>
  1279. <ul></ul>
  1280. <h3 id="external-secrets.io/v1.AWSAuth">AWSAuth
  1281. </h3>
  1282. <p>
  1283. (<em>Appears on:</em>
  1284. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1285. </p>
  1286. <p>
  1287. <p>AWSAuth tells the controller how to do authentication with aws.
  1288. Only one of secretRef or jwt can be specified.
  1289. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  1290. </p>
  1291. <table>
  1292. <thead>
  1293. <tr>
  1294. <th>Field</th>
  1295. <th>Description</th>
  1296. </tr>
  1297. </thead>
  1298. <tbody>
  1299. <tr>
  1300. <td>
  1301. <code>secretRef</code></br>
  1302. <em>
  1303. <a href="#external-secrets.io/v1.AWSAuthSecretRef">
  1304. AWSAuthSecretRef
  1305. </a>
  1306. </em>
  1307. </td>
  1308. <td>
  1309. <em>(Optional)</em>
  1310. </td>
  1311. </tr>
  1312. <tr>
  1313. <td>
  1314. <code>jwt</code></br>
  1315. <em>
  1316. <a href="#external-secrets.io/v1.AWSJWTAuth">
  1317. AWSJWTAuth
  1318. </a>
  1319. </em>
  1320. </td>
  1321. <td>
  1322. <em>(Optional)</em>
  1323. </td>
  1324. </tr>
  1325. </tbody>
  1326. </table>
  1327. <h3 id="external-secrets.io/v1.AWSAuthSecretRef">AWSAuthSecretRef
  1328. </h3>
  1329. <p>
  1330. (<em>Appears on:</em>
  1331. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1332. </p>
  1333. <p>
  1334. <p>AWSAuthSecretRef holds secret references for AWS credentials
  1335. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  1336. </p>
  1337. <table>
  1338. <thead>
  1339. <tr>
  1340. <th>Field</th>
  1341. <th>Description</th>
  1342. </tr>
  1343. </thead>
  1344. <tbody>
  1345. <tr>
  1346. <td>
  1347. <code>accessKeyIDSecretRef</code></br>
  1348. <em>
  1349. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1350. External Secrets meta/v1.SecretKeySelector
  1351. </a>
  1352. </em>
  1353. </td>
  1354. <td>
  1355. <p>The AccessKeyID is used for authentication</p>
  1356. </td>
  1357. </tr>
  1358. <tr>
  1359. <td>
  1360. <code>secretAccessKeySecretRef</code></br>
  1361. <em>
  1362. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1363. External Secrets meta/v1.SecretKeySelector
  1364. </a>
  1365. </em>
  1366. </td>
  1367. <td>
  1368. <p>The SecretAccessKey is used for authentication</p>
  1369. </td>
  1370. </tr>
  1371. <tr>
  1372. <td>
  1373. <code>sessionTokenSecretRef</code></br>
  1374. <em>
  1375. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1376. External Secrets meta/v1.SecretKeySelector
  1377. </a>
  1378. </em>
  1379. </td>
  1380. <td>
  1381. <p>The SessionToken used for authentication
  1382. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  1383. see: <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html">https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html</a></p>
  1384. </td>
  1385. </tr>
  1386. </tbody>
  1387. </table>
  1388. <h3 id="external-secrets.io/v1.AWSJWTAuth">AWSJWTAuth
  1389. </h3>
  1390. <p>
  1391. (<em>Appears on:</em>
  1392. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1393. </p>
  1394. <p>
  1395. <p>AWSJWTAuth stores reference to Authenticate against AWS using service account tokens.</p>
  1396. </p>
  1397. <table>
  1398. <thead>
  1399. <tr>
  1400. <th>Field</th>
  1401. <th>Description</th>
  1402. </tr>
  1403. </thead>
  1404. <tbody>
  1405. <tr>
  1406. <td>
  1407. <code>serviceAccountRef</code></br>
  1408. <em>
  1409. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1410. External Secrets meta/v1.ServiceAccountSelector
  1411. </a>
  1412. </em>
  1413. </td>
  1414. <td>
  1415. </td>
  1416. </tr>
  1417. </tbody>
  1418. </table>
  1419. <h3 id="external-secrets.io/v1.AWSProvider">AWSProvider
  1420. </h3>
  1421. <p>
  1422. (<em>Appears on:</em>
  1423. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1424. </p>
  1425. <p>
  1426. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  1427. </p>
  1428. <table>
  1429. <thead>
  1430. <tr>
  1431. <th>Field</th>
  1432. <th>Description</th>
  1433. </tr>
  1434. </thead>
  1435. <tbody>
  1436. <tr>
  1437. <td>
  1438. <code>service</code></br>
  1439. <em>
  1440. <a href="#external-secrets.io/v1.AWSServiceType">
  1441. AWSServiceType
  1442. </a>
  1443. </em>
  1444. </td>
  1445. <td>
  1446. <p>Service defines which service should be used to fetch the secrets</p>
  1447. </td>
  1448. </tr>
  1449. <tr>
  1450. <td>
  1451. <code>auth</code></br>
  1452. <em>
  1453. <a href="#external-secrets.io/v1.AWSAuth">
  1454. AWSAuth
  1455. </a>
  1456. </em>
  1457. </td>
  1458. <td>
  1459. <em>(Optional)</em>
  1460. <p>Auth defines the information necessary to authenticate against AWS
  1461. if not set aws sdk will infer credentials from your environment
  1462. see: <a href="https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials">https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials</a></p>
  1463. </td>
  1464. </tr>
  1465. <tr>
  1466. <td>
  1467. <code>role</code></br>
  1468. <em>
  1469. string
  1470. </em>
  1471. </td>
  1472. <td>
  1473. <em>(Optional)</em>
  1474. <p>Role is a Role ARN which the provider will assume</p>
  1475. </td>
  1476. </tr>
  1477. <tr>
  1478. <td>
  1479. <code>region</code></br>
  1480. <em>
  1481. string
  1482. </em>
  1483. </td>
  1484. <td>
  1485. <p>AWS Region to be used for the provider</p>
  1486. </td>
  1487. </tr>
  1488. <tr>
  1489. <td>
  1490. <code>additionalRoles</code></br>
  1491. <em>
  1492. []string
  1493. </em>
  1494. </td>
  1495. <td>
  1496. <em>(Optional)</em>
  1497. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  1498. </td>
  1499. </tr>
  1500. <tr>
  1501. <td>
  1502. <code>externalID</code></br>
  1503. <em>
  1504. string
  1505. </em>
  1506. </td>
  1507. <td>
  1508. <p>AWS External ID set on assumed IAM roles</p>
  1509. </td>
  1510. </tr>
  1511. <tr>
  1512. <td>
  1513. <code>sessionTags</code></br>
  1514. <em>
  1515. <a href="#external-secrets.io/v1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag">
  1516. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag
  1517. </a>
  1518. </em>
  1519. </td>
  1520. <td>
  1521. <em>(Optional)</em>
  1522. <p>AWS STS assume role session tags</p>
  1523. </td>
  1524. </tr>
  1525. <tr>
  1526. <td>
  1527. <code>secretsManager</code></br>
  1528. <em>
  1529. <a href="#external-secrets.io/v1.SecretsManager">
  1530. SecretsManager
  1531. </a>
  1532. </em>
  1533. </td>
  1534. <td>
  1535. <em>(Optional)</em>
  1536. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  1537. </td>
  1538. </tr>
  1539. <tr>
  1540. <td>
  1541. <code>transitiveTagKeys</code></br>
  1542. <em>
  1543. []string
  1544. </em>
  1545. </td>
  1546. <td>
  1547. <em>(Optional)</em>
  1548. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  1549. </td>
  1550. </tr>
  1551. <tr>
  1552. <td>
  1553. <code>sessionTagsPolicy</code></br>
  1554. <em>
  1555. <a href="#external-secrets.io/v1.SessionTagsPolicy">
  1556. SessionTagsPolicy
  1557. </a>
  1558. </em>
  1559. </td>
  1560. <td>
  1561. <em>(Optional)</em>
  1562. <p>SessionTagsPolicy controls whether and how STS session tags are added when assuming roles.
  1563. None (default): no tags are added.
  1564. Simple: automatically adds esoNamespace (from the ExternalSecret), esoStoreName, and esoStoreKind tags.
  1565. Custom: adds esoNamespace, esoStoreName, and esoStoreKind plus any tags defined in CustomSessionTags.
  1566. Note: the IAM role must have sts:TagSession permission when using Simple or Custom.</p>
  1567. </td>
  1568. </tr>
  1569. <tr>
  1570. <td>
  1571. <code>customSessionTags</code></br>
  1572. <em>
  1573. map[string]string
  1574. </em>
  1575. </td>
  1576. <td>
  1577. <em>(Optional)</em>
  1578. <p>CustomSessionTags defines additional STS session tags to include when SessionTagsPolicy is Custom.
  1579. These are merged with the automatically injected esoNamespace, esoStoreName, and esoStoreKind tags.</p>
  1580. </td>
  1581. </tr>
  1582. <tr>
  1583. <td>
  1584. <code>prefix</code></br>
  1585. <em>
  1586. string
  1587. </em>
  1588. </td>
  1589. <td>
  1590. <em>(Optional)</em>
  1591. <p>Prefix adds a prefix to all retrieved values.</p>
  1592. </td>
  1593. </tr>
  1594. </tbody>
  1595. </table>
  1596. <h3 id="external-secrets.io/v1.AWSServiceType">AWSServiceType
  1597. (<code>string</code> alias)</p></h3>
  1598. <p>
  1599. (<em>Appears on:</em>
  1600. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1601. </p>
  1602. <p>
  1603. <p>AWSServiceType is a enum that defines the service/API that is used to fetch the secrets.</p>
  1604. </p>
  1605. <table>
  1606. <thead>
  1607. <tr>
  1608. <th>Value</th>
  1609. <th>Description</th>
  1610. </tr>
  1611. </thead>
  1612. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  1613. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  1614. see: <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html">https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html</a></p>
  1615. </td>
  1616. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  1617. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  1618. see: <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html</a></p>
  1619. </td>
  1620. </tr></tbody>
  1621. </table>
  1622. <h3 id="external-secrets.io/v1.AkeylessAuth">AkeylessAuth
  1623. </h3>
  1624. <p>
  1625. (<em>Appears on:</em>
  1626. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>)
  1627. </p>
  1628. <p>
  1629. <p>AkeylessAuth configures how the operator authenticates with Akeyless.</p>
  1630. </p>
  1631. <table>
  1632. <thead>
  1633. <tr>
  1634. <th>Field</th>
  1635. <th>Description</th>
  1636. </tr>
  1637. </thead>
  1638. <tbody>
  1639. <tr>
  1640. <td>
  1641. <code>secretRef</code></br>
  1642. <em>
  1643. <a href="#external-secrets.io/v1.AkeylessAuthSecretRef">
  1644. AkeylessAuthSecretRef
  1645. </a>
  1646. </em>
  1647. </td>
  1648. <td>
  1649. <em>(Optional)</em>
  1650. <p>Reference to a Secret that contains the details
  1651. to authenticate with Akeyless.</p>
  1652. </td>
  1653. </tr>
  1654. <tr>
  1655. <td>
  1656. <code>kubernetesAuth</code></br>
  1657. <em>
  1658. <a href="#external-secrets.io/v1.AkeylessKubernetesAuth">
  1659. AkeylessKubernetesAuth
  1660. </a>
  1661. </em>
  1662. </td>
  1663. <td>
  1664. <em>(Optional)</em>
  1665. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  1666. token stored in the named Secret resource.</p>
  1667. </td>
  1668. </tr>
  1669. </tbody>
  1670. </table>
  1671. <h3 id="external-secrets.io/v1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  1672. </h3>
  1673. <p>
  1674. (<em>Appears on:</em>
  1675. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1676. </p>
  1677. <p>
  1678. <p>AkeylessAuthSecretRef references a Secret that contains the details
  1679. to authenticate with Akeyless.
  1680. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  1681. </p>
  1682. <table>
  1683. <thead>
  1684. <tr>
  1685. <th>Field</th>
  1686. <th>Description</th>
  1687. </tr>
  1688. </thead>
  1689. <tbody>
  1690. <tr>
  1691. <td>
  1692. <code>accessID</code></br>
  1693. <em>
  1694. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1695. External Secrets meta/v1.SecretKeySelector
  1696. </a>
  1697. </em>
  1698. </td>
  1699. <td>
  1700. <p>The SecretAccessID is used for authentication</p>
  1701. </td>
  1702. </tr>
  1703. <tr>
  1704. <td>
  1705. <code>accessType</code></br>
  1706. <em>
  1707. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1708. External Secrets meta/v1.SecretKeySelector
  1709. </a>
  1710. </em>
  1711. </td>
  1712. <td>
  1713. </td>
  1714. </tr>
  1715. <tr>
  1716. <td>
  1717. <code>accessTypeParam</code></br>
  1718. <em>
  1719. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1720. External Secrets meta/v1.SecretKeySelector
  1721. </a>
  1722. </em>
  1723. </td>
  1724. <td>
  1725. </td>
  1726. </tr>
  1727. </tbody>
  1728. </table>
  1729. <h3 id="external-secrets.io/v1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  1730. </h3>
  1731. <p>
  1732. (<em>Appears on:</em>
  1733. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1734. </p>
  1735. <p>
  1736. <p>AkeylessKubernetesAuth configures Kubernetes authentication with Akeyless.
  1737. It authenticates with Kubernetes ServiceAccount token stored.</p>
  1738. </p>
  1739. <table>
  1740. <thead>
  1741. <tr>
  1742. <th>Field</th>
  1743. <th>Description</th>
  1744. </tr>
  1745. </thead>
  1746. <tbody>
  1747. <tr>
  1748. <td>
  1749. <code>accessID</code></br>
  1750. <em>
  1751. string
  1752. </em>
  1753. </td>
  1754. <td>
  1755. <p>the Akeyless Kubernetes auth-method access-id</p>
  1756. </td>
  1757. </tr>
  1758. <tr>
  1759. <td>
  1760. <code>k8sConfName</code></br>
  1761. <em>
  1762. string
  1763. </em>
  1764. </td>
  1765. <td>
  1766. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  1767. </td>
  1768. </tr>
  1769. <tr>
  1770. <td>
  1771. <code>serviceAccountRef</code></br>
  1772. <em>
  1773. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1774. External Secrets meta/v1.ServiceAccountSelector
  1775. </a>
  1776. </em>
  1777. </td>
  1778. <td>
  1779. <em>(Optional)</em>
  1780. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  1781. If the service account is specified, the service account secret token JWT will be used
  1782. for authenticating with Akeyless. If the service account selector is not supplied,
  1783. the secretRef will be used instead.</p>
  1784. </td>
  1785. </tr>
  1786. <tr>
  1787. <td>
  1788. <code>secretRef</code></br>
  1789. <em>
  1790. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1791. External Secrets meta/v1.SecretKeySelector
  1792. </a>
  1793. </em>
  1794. </td>
  1795. <td>
  1796. <em>(Optional)</em>
  1797. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  1798. for authenticating with Akeyless. If a name is specified without a key,
  1799. <code>token</code> is the default. If one is not specified, the one bound to
  1800. the controller will be used.</p>
  1801. </td>
  1802. </tr>
  1803. </tbody>
  1804. </table>
  1805. <h3 id="external-secrets.io/v1.AkeylessProvider">AkeylessProvider
  1806. </h3>
  1807. <p>
  1808. (<em>Appears on:</em>
  1809. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1810. </p>
  1811. <p>
  1812. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  1813. </p>
  1814. <table>
  1815. <thead>
  1816. <tr>
  1817. <th>Field</th>
  1818. <th>Description</th>
  1819. </tr>
  1820. </thead>
  1821. <tbody>
  1822. <tr>
  1823. <td>
  1824. <code>akeylessGWApiURL</code></br>
  1825. <em>
  1826. string
  1827. </em>
  1828. </td>
  1829. <td>
  1830. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  1831. </td>
  1832. </tr>
  1833. <tr>
  1834. <td>
  1835. <code>authSecretRef</code></br>
  1836. <em>
  1837. <a href="#external-secrets.io/v1.AkeylessAuth">
  1838. AkeylessAuth
  1839. </a>
  1840. </em>
  1841. </td>
  1842. <td>
  1843. <p>Auth configures how the operator authenticates with Akeyless.</p>
  1844. </td>
  1845. </tr>
  1846. <tr>
  1847. <td>
  1848. <code>caBundle</code></br>
  1849. <em>
  1850. []byte
  1851. </em>
  1852. </td>
  1853. <td>
  1854. <em>(Optional)</em>
  1855. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  1856. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  1857. are used to validate the TLS connection.</p>
  1858. </td>
  1859. </tr>
  1860. <tr>
  1861. <td>
  1862. <code>caProvider</code></br>
  1863. <em>
  1864. <a href="#external-secrets.io/v1.CAProvider">
  1865. CAProvider
  1866. </a>
  1867. </em>
  1868. </td>
  1869. <td>
  1870. <em>(Optional)</em>
  1871. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  1872. </td>
  1873. </tr>
  1874. </tbody>
  1875. </table>
  1876. <h3 id="external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol
  1877. </h3>
  1878. <p>
  1879. (<em>Appears on:</em>
  1880. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  1881. </p>
  1882. <p>
  1883. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  1884. </p>
  1885. <table>
  1886. <thead>
  1887. <tr>
  1888. <th>Field</th>
  1889. <th>Description</th>
  1890. </tr>
  1891. </thead>
  1892. <tbody>
  1893. <tr>
  1894. <td>
  1895. <code>ntlm</code></br>
  1896. <em>
  1897. <a href="#external-secrets.io/v1.NTLMProtocol">
  1898. NTLMProtocol
  1899. </a>
  1900. </em>
  1901. </td>
  1902. <td>
  1903. <em>(Optional)</em>
  1904. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  1905. </td>
  1906. </tr>
  1907. </tbody>
  1908. </table>
  1909. <h3 id="external-secrets.io/v1.AwsAuthCredentials">AwsAuthCredentials
  1910. </h3>
  1911. <p>
  1912. (<em>Appears on:</em>
  1913. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1914. </p>
  1915. <p>
  1916. <p>AwsAuthCredentials represents the credentials for AWS authentication.</p>
  1917. </p>
  1918. <table>
  1919. <thead>
  1920. <tr>
  1921. <th>Field</th>
  1922. <th>Description</th>
  1923. </tr>
  1924. </thead>
  1925. <tbody>
  1926. <tr>
  1927. <td>
  1928. <code>identityId</code></br>
  1929. <em>
  1930. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1931. External Secrets meta/v1.SecretKeySelector
  1932. </a>
  1933. </em>
  1934. </td>
  1935. <td>
  1936. </td>
  1937. </tr>
  1938. </tbody>
  1939. </table>
  1940. <h3 id="external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig
  1941. </h3>
  1942. <p>
  1943. (<em>Appears on:</em>
  1944. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  1945. </p>
  1946. <p>
  1947. <p>AwsCredentialsConfig holds the region and the Secret reference which contains the AWS credentials.</p>
  1948. </p>
  1949. <table>
  1950. <thead>
  1951. <tr>
  1952. <th>Field</th>
  1953. <th>Description</th>
  1954. </tr>
  1955. </thead>
  1956. <tbody>
  1957. <tr>
  1958. <td>
  1959. <code>region</code></br>
  1960. <em>
  1961. string
  1962. </em>
  1963. </td>
  1964. <td>
  1965. <p>region is for configuring the AWS region to be used.</p>
  1966. </td>
  1967. </tr>
  1968. <tr>
  1969. <td>
  1970. <code>awsCredentialsSecretRef</code></br>
  1971. <em>
  1972. <a href="#external-secrets.io/v1.SecretReference">
  1973. SecretReference
  1974. </a>
  1975. </em>
  1976. </td>
  1977. <td>
  1978. <p>awsCredentialsSecretRef is the reference to the secret which holds the AWS credentials.
  1979. Secret should be created with below names for keys
  1980. - aws_access_key_id: Access Key ID, which is the unique identifier for the AWS account or the IAM user.
  1981. - aws_secret_access_key: Secret Access Key, which is used to authenticate requests made to AWS services.
  1982. - aws_session_token: Session Token, is the short-lived token to authenticate requests made to AWS services.</p>
  1983. </td>
  1984. </tr>
  1985. </tbody>
  1986. </table>
  1987. <h3 id="external-secrets.io/v1.AzureAuthCredentials">AzureAuthCredentials
  1988. </h3>
  1989. <p>
  1990. (<em>Appears on:</em>
  1991. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1992. </p>
  1993. <p>
  1994. <p>AzureAuthCredentials represents the credentials for Azure authentication.</p>
  1995. </p>
  1996. <table>
  1997. <thead>
  1998. <tr>
  1999. <th>Field</th>
  2000. <th>Description</th>
  2001. </tr>
  2002. </thead>
  2003. <tbody>
  2004. <tr>
  2005. <td>
  2006. <code>identityId</code></br>
  2007. <em>
  2008. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2009. External Secrets meta/v1.SecretKeySelector
  2010. </a>
  2011. </em>
  2012. </td>
  2013. <td>
  2014. </td>
  2015. </tr>
  2016. <tr>
  2017. <td>
  2018. <code>resource</code></br>
  2019. <em>
  2020. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2021. External Secrets meta/v1.SecretKeySelector
  2022. </a>
  2023. </em>
  2024. </td>
  2025. <td>
  2026. <em>(Optional)</em>
  2027. </td>
  2028. </tr>
  2029. </tbody>
  2030. </table>
  2031. <h3 id="external-secrets.io/v1.AzureAuthType">AzureAuthType
  2032. (<code>string</code> alias)</p></h3>
  2033. <p>
  2034. (<em>Appears on:</em>
  2035. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2036. </p>
  2037. <p>
  2038. <p>AzureAuthType describes how to authenticate to the Azure Keyvault
  2039. Only one of the following auth types may be specified.
  2040. If none of the following auth type is specified, the default one
  2041. is ServicePrincipal.</p>
  2042. </p>
  2043. <table>
  2044. <thead>
  2045. <tr>
  2046. <th>Value</th>
  2047. <th>Description</th>
  2048. </tr>
  2049. </thead>
  2050. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  2051. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  2052. </td>
  2053. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  2054. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  2055. </td>
  2056. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  2057. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  2058. </td>
  2059. </tr></tbody>
  2060. </table>
  2061. <h3 id="external-secrets.io/v1.AzureCustomCloudConfig">AzureCustomCloudConfig
  2062. </h3>
  2063. <p>
  2064. (<em>Appears on:</em>
  2065. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2066. </p>
  2067. <p>
  2068. <p>AzureCustomCloudConfig specifies custom cloud configuration for private Azure environments
  2069. IMPORTANT: Custom cloud configuration is ONLY supported when UseAzureSDK is true.
  2070. The legacy go-autorest SDK does not support custom cloud endpoints.</p>
  2071. </p>
  2072. <table>
  2073. <thead>
  2074. <tr>
  2075. <th>Field</th>
  2076. <th>Description</th>
  2077. </tr>
  2078. </thead>
  2079. <tbody>
  2080. <tr>
  2081. <td>
  2082. <code>activeDirectoryEndpoint</code></br>
  2083. <em>
  2084. string
  2085. </em>
  2086. </td>
  2087. <td>
  2088. <p>ActiveDirectoryEndpoint is the AAD endpoint for authentication
  2089. Required when using custom cloud configuration</p>
  2090. </td>
  2091. </tr>
  2092. <tr>
  2093. <td>
  2094. <code>keyVaultEndpoint</code></br>
  2095. <em>
  2096. string
  2097. </em>
  2098. </td>
  2099. <td>
  2100. <em>(Optional)</em>
  2101. <p>KeyVaultEndpoint is the Key Vault service endpoint</p>
  2102. </td>
  2103. </tr>
  2104. <tr>
  2105. <td>
  2106. <code>keyVaultDNSSuffix</code></br>
  2107. <em>
  2108. string
  2109. </em>
  2110. </td>
  2111. <td>
  2112. <em>(Optional)</em>
  2113. <p>KeyVaultDNSSuffix is the DNS suffix for Key Vault URLs</p>
  2114. </td>
  2115. </tr>
  2116. <tr>
  2117. <td>
  2118. <code>resourceManagerEndpoint</code></br>
  2119. <em>
  2120. string
  2121. </em>
  2122. </td>
  2123. <td>
  2124. <em>(Optional)</em>
  2125. <p>ResourceManagerEndpoint is the Azure Resource Manager endpoint</p>
  2126. </td>
  2127. </tr>
  2128. </tbody>
  2129. </table>
  2130. <h3 id="external-secrets.io/v1.AzureEnvironmentType">AzureEnvironmentType
  2131. (<code>string</code> alias)</p></h3>
  2132. <p>
  2133. (<em>Appears on:</em>
  2134. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>,
  2135. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  2136. </p>
  2137. <p>
  2138. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  2139. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  2140. The following endpoints are available, also see here: <a href="https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152">https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152</a>
  2141. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud</p>
  2142. </p>
  2143. <table>
  2144. <thead>
  2145. <tr>
  2146. <th>Value</th>
  2147. <th>Description</th>
  2148. </tr>
  2149. </thead>
  2150. <tbody><tr><td><p>&#34;AzureStackCloud&#34;</p></td>
  2151. <td></td>
  2152. </tr><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  2153. <td></td>
  2154. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  2155. <td></td>
  2156. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  2157. <td></td>
  2158. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  2159. <td></td>
  2160. </tr></tbody>
  2161. </table>
  2162. <h3 id="external-secrets.io/v1.AzureKVAuth">AzureKVAuth
  2163. </h3>
  2164. <p>
  2165. (<em>Appears on:</em>
  2166. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2167. </p>
  2168. <p>
  2169. <p>AzureKVAuth is the configuration used to authenticate with Azure.</p>
  2170. </p>
  2171. <table>
  2172. <thead>
  2173. <tr>
  2174. <th>Field</th>
  2175. <th>Description</th>
  2176. </tr>
  2177. </thead>
  2178. <tbody>
  2179. <tr>
  2180. <td>
  2181. <code>clientId</code></br>
  2182. <em>
  2183. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2184. External Secrets meta/v1.SecretKeySelector
  2185. </a>
  2186. </em>
  2187. </td>
  2188. <td>
  2189. <em>(Optional)</em>
  2190. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  2191. </td>
  2192. </tr>
  2193. <tr>
  2194. <td>
  2195. <code>tenantId</code></br>
  2196. <em>
  2197. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2198. External Secrets meta/v1.SecretKeySelector
  2199. </a>
  2200. </em>
  2201. </td>
  2202. <td>
  2203. <em>(Optional)</em>
  2204. <p>The Azure tenantId of the managed identity used for authentication.</p>
  2205. </td>
  2206. </tr>
  2207. <tr>
  2208. <td>
  2209. <code>clientSecret</code></br>
  2210. <em>
  2211. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2212. External Secrets meta/v1.SecretKeySelector
  2213. </a>
  2214. </em>
  2215. </td>
  2216. <td>
  2217. <em>(Optional)</em>
  2218. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  2219. </td>
  2220. </tr>
  2221. <tr>
  2222. <td>
  2223. <code>clientCertificate</code></br>
  2224. <em>
  2225. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2226. External Secrets meta/v1.SecretKeySelector
  2227. </a>
  2228. </em>
  2229. </td>
  2230. <td>
  2231. <em>(Optional)</em>
  2232. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  2233. </td>
  2234. </tr>
  2235. </tbody>
  2236. </table>
  2237. <h3 id="external-secrets.io/v1.AzureKVProvider">AzureKVProvider
  2238. </h3>
  2239. <p>
  2240. (<em>Appears on:</em>
  2241. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2242. </p>
  2243. <p>
  2244. <p>AzureKVProvider configures a store to sync secrets using Azure KV.</p>
  2245. </p>
  2246. <table>
  2247. <thead>
  2248. <tr>
  2249. <th>Field</th>
  2250. <th>Description</th>
  2251. </tr>
  2252. </thead>
  2253. <tbody>
  2254. <tr>
  2255. <td>
  2256. <code>authType</code></br>
  2257. <em>
  2258. <a href="#external-secrets.io/v1.AzureAuthType">
  2259. AzureAuthType
  2260. </a>
  2261. </em>
  2262. </td>
  2263. <td>
  2264. <em>(Optional)</em>
  2265. <p>Auth type defines how to authenticate to the keyvault service.
  2266. Valid values are:
  2267. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  2268. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)
  2269. - &ldquo;WorkloadIdentity&rdquo;: Using a Kubernetes ServiceAccount federated with Entra ID</p>
  2270. </td>
  2271. </tr>
  2272. <tr>
  2273. <td>
  2274. <code>vaultUrl</code></br>
  2275. <em>
  2276. string
  2277. </em>
  2278. </td>
  2279. <td>
  2280. <p>Vault Url from which the secrets to be fetched from.</p>
  2281. </td>
  2282. </tr>
  2283. <tr>
  2284. <td>
  2285. <code>tenantId</code></br>
  2286. <em>
  2287. string
  2288. </em>
  2289. </td>
  2290. <td>
  2291. <em>(Optional)</em>
  2292. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2293. </td>
  2294. </tr>
  2295. <tr>
  2296. <td>
  2297. <code>environmentType</code></br>
  2298. <em>
  2299. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  2300. AzureEnvironmentType
  2301. </a>
  2302. </em>
  2303. </td>
  2304. <td>
  2305. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  2306. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  2307. The following endpoints are available, also see here: <a href="https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152">https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152</a>
  2308. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud
  2309. Use AzureStackCloud when you need to configure custom Azure Stack Hub or Azure Stack Edge endpoints.</p>
  2310. </td>
  2311. </tr>
  2312. <tr>
  2313. <td>
  2314. <code>authSecretRef</code></br>
  2315. <em>
  2316. <a href="#external-secrets.io/v1.AzureKVAuth">
  2317. AzureKVAuth
  2318. </a>
  2319. </em>
  2320. </td>
  2321. <td>
  2322. <em>(Optional)</em>
  2323. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2324. </td>
  2325. </tr>
  2326. <tr>
  2327. <td>
  2328. <code>serviceAccountRef</code></br>
  2329. <em>
  2330. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  2331. External Secrets meta/v1.ServiceAccountSelector
  2332. </a>
  2333. </em>
  2334. </td>
  2335. <td>
  2336. <em>(Optional)</em>
  2337. <p>ServiceAccountRef specified the service account
  2338. that should be used when authenticating with WorkloadIdentity.</p>
  2339. </td>
  2340. </tr>
  2341. <tr>
  2342. <td>
  2343. <code>identityId</code></br>
  2344. <em>
  2345. string
  2346. </em>
  2347. </td>
  2348. <td>
  2349. <em>(Optional)</em>
  2350. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  2351. </td>
  2352. </tr>
  2353. <tr>
  2354. <td>
  2355. <code>useAzureSDK</code></br>
  2356. <em>
  2357. bool
  2358. </em>
  2359. </td>
  2360. <td>
  2361. <em>(Optional)</em>
  2362. <p>UseAzureSDK enables the use of the new Azure SDK for Go (azcore-based) instead of the legacy go-autorest SDK.
  2363. This is experimental and may have behavioral differences. Defaults to false (legacy SDK).</p>
  2364. </td>
  2365. </tr>
  2366. <tr>
  2367. <td>
  2368. <code>customCloudConfig</code></br>
  2369. <em>
  2370. <a href="#external-secrets.io/v1.AzureCustomCloudConfig">
  2371. AzureCustomCloudConfig
  2372. </a>
  2373. </em>
  2374. </td>
  2375. <td>
  2376. <em>(Optional)</em>
  2377. <p>CustomCloudConfig defines custom Azure endpoints for non-standard clouds.
  2378. Required when EnvironmentType is AzureStackCloud.
  2379. Optional for other environment types - useful for Azure China when using Workload Identity
  2380. with AKS, where the OIDC issuer (login.partner.microsoftonline.cn) differs from the
  2381. standard China Cloud endpoint (login.chinacloudapi.cn).
  2382. IMPORTANT: This feature REQUIRES UseAzureSDK to be set to true. Custom cloud
  2383. configuration is not supported with the legacy go-autorest SDK.</p>
  2384. </td>
  2385. </tr>
  2386. </tbody>
  2387. </table>
  2388. <h3 id="external-secrets.io/v1.BarbicanAuth">BarbicanAuth
  2389. </h3>
  2390. <p>
  2391. (<em>Appears on:</em>
  2392. <a href="#external-secrets.io/v1.BarbicanProvider">BarbicanProvider</a>)
  2393. </p>
  2394. <p>
  2395. <p>BarbicanAuth contains the authentication information for Barbican.</p>
  2396. </p>
  2397. <table>
  2398. <thead>
  2399. <tr>
  2400. <th>Field</th>
  2401. <th>Description</th>
  2402. </tr>
  2403. </thead>
  2404. <tbody>
  2405. <tr>
  2406. <td>
  2407. <code>username</code></br>
  2408. <em>
  2409. <a href="#external-secrets.io/v1.BarbicanProviderUsernameRef">
  2410. BarbicanProviderUsernameRef
  2411. </a>
  2412. </em>
  2413. </td>
  2414. <td>
  2415. </td>
  2416. </tr>
  2417. <tr>
  2418. <td>
  2419. <code>password</code></br>
  2420. <em>
  2421. <a href="#external-secrets.io/v1.BarbicanProviderPasswordRef">
  2422. BarbicanProviderPasswordRef
  2423. </a>
  2424. </em>
  2425. </td>
  2426. <td>
  2427. </td>
  2428. </tr>
  2429. </tbody>
  2430. </table>
  2431. <h3 id="external-secrets.io/v1.BarbicanProvider">BarbicanProvider
  2432. </h3>
  2433. <p>
  2434. (<em>Appears on:</em>
  2435. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2436. </p>
  2437. <p>
  2438. <p>BarbicanProvider setup a store to sync secrets with barbican.</p>
  2439. </p>
  2440. <table>
  2441. <thead>
  2442. <tr>
  2443. <th>Field</th>
  2444. <th>Description</th>
  2445. </tr>
  2446. </thead>
  2447. <tbody>
  2448. <tr>
  2449. <td>
  2450. <code>authURL</code></br>
  2451. <em>
  2452. string
  2453. </em>
  2454. </td>
  2455. <td>
  2456. </td>
  2457. </tr>
  2458. <tr>
  2459. <td>
  2460. <code>tenantName</code></br>
  2461. <em>
  2462. string
  2463. </em>
  2464. </td>
  2465. <td>
  2466. </td>
  2467. </tr>
  2468. <tr>
  2469. <td>
  2470. <code>domainName</code></br>
  2471. <em>
  2472. string
  2473. </em>
  2474. </td>
  2475. <td>
  2476. </td>
  2477. </tr>
  2478. <tr>
  2479. <td>
  2480. <code>region</code></br>
  2481. <em>
  2482. string
  2483. </em>
  2484. </td>
  2485. <td>
  2486. </td>
  2487. </tr>
  2488. <tr>
  2489. <td>
  2490. <code>auth</code></br>
  2491. <em>
  2492. <a href="#external-secrets.io/v1.BarbicanAuth">
  2493. BarbicanAuth
  2494. </a>
  2495. </em>
  2496. </td>
  2497. <td>
  2498. </td>
  2499. </tr>
  2500. </tbody>
  2501. </table>
  2502. <h3 id="external-secrets.io/v1.BarbicanProviderPasswordRef">BarbicanProviderPasswordRef
  2503. </h3>
  2504. <p>
  2505. (<em>Appears on:</em>
  2506. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2507. </p>
  2508. <p>
  2509. <p>BarbicanProviderPasswordRef defines a reference to a secret containing password for the Barbican provider.</p>
  2510. </p>
  2511. <table>
  2512. <thead>
  2513. <tr>
  2514. <th>Field</th>
  2515. <th>Description</th>
  2516. </tr>
  2517. </thead>
  2518. <tbody>
  2519. <tr>
  2520. <td>
  2521. <code>secretRef</code></br>
  2522. <em>
  2523. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2524. External Secrets meta/v1.SecretKeySelector
  2525. </a>
  2526. </em>
  2527. </td>
  2528. <td>
  2529. </td>
  2530. </tr>
  2531. </tbody>
  2532. </table>
  2533. <h3 id="external-secrets.io/v1.BarbicanProviderUsernameRef">BarbicanProviderUsernameRef
  2534. </h3>
  2535. <p>
  2536. (<em>Appears on:</em>
  2537. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2538. </p>
  2539. <p>
  2540. <p>BarbicanProviderUsernameRef defines a reference to a secret containing username for the Barbican provider.</p>
  2541. </p>
  2542. <table>
  2543. <thead>
  2544. <tr>
  2545. <th>Field</th>
  2546. <th>Description</th>
  2547. </tr>
  2548. </thead>
  2549. <tbody>
  2550. <tr>
  2551. <td>
  2552. <code>value</code></br>
  2553. <em>
  2554. string
  2555. </em>
  2556. </td>
  2557. <td>
  2558. </td>
  2559. </tr>
  2560. <tr>
  2561. <td>
  2562. <code>secretRef</code></br>
  2563. <em>
  2564. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2565. External Secrets meta/v1.SecretKeySelector
  2566. </a>
  2567. </em>
  2568. </td>
  2569. <td>
  2570. </td>
  2571. </tr>
  2572. </tbody>
  2573. </table>
  2574. <h3 id="external-secrets.io/v1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  2575. </h3>
  2576. <p>
  2577. (<em>Appears on:</em>
  2578. <a href="#external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth</a>)
  2579. </p>
  2580. <p>
  2581. <p>BeyondTrustProviderSecretRef references a value that can be specified directly or via a secret
  2582. for a BeyondTrustProvider.</p>
  2583. </p>
  2584. <table>
  2585. <thead>
  2586. <tr>
  2587. <th>Field</th>
  2588. <th>Description</th>
  2589. </tr>
  2590. </thead>
  2591. <tbody>
  2592. <tr>
  2593. <td>
  2594. <code>value</code></br>
  2595. <em>
  2596. string
  2597. </em>
  2598. </td>
  2599. <td>
  2600. <em>(Optional)</em>
  2601. <p>Value can be specified directly to set a value without using a secret.</p>
  2602. </td>
  2603. </tr>
  2604. <tr>
  2605. <td>
  2606. <code>secretRef</code></br>
  2607. <em>
  2608. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2609. External Secrets meta/v1.SecretKeySelector
  2610. </a>
  2611. </em>
  2612. </td>
  2613. <td>
  2614. <em>(Optional)</em>
  2615. <p>SecretRef references a key in a secret that will be used as value.</p>
  2616. </td>
  2617. </tr>
  2618. </tbody>
  2619. </table>
  2620. <h3 id="external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth
  2621. </h3>
  2622. <p>
  2623. (<em>Appears on:</em>
  2624. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2625. </p>
  2626. <p>
  2627. <p>BeyondtrustAuth provides different ways to authenticate to a BeyondtrustProvider server.</p>
  2628. </p>
  2629. <table>
  2630. <thead>
  2631. <tr>
  2632. <th>Field</th>
  2633. <th>Description</th>
  2634. </tr>
  2635. </thead>
  2636. <tbody>
  2637. <tr>
  2638. <td>
  2639. <code>apiKey</code></br>
  2640. <em>
  2641. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2642. BeyondTrustProviderSecretRef
  2643. </a>
  2644. </em>
  2645. </td>
  2646. <td>
  2647. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  2648. </td>
  2649. </tr>
  2650. <tr>
  2651. <td>
  2652. <code>clientId</code></br>
  2653. <em>
  2654. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2655. BeyondTrustProviderSecretRef
  2656. </a>
  2657. </em>
  2658. </td>
  2659. <td>
  2660. <p>ClientID is the API OAuth Client ID.</p>
  2661. </td>
  2662. </tr>
  2663. <tr>
  2664. <td>
  2665. <code>clientSecret</code></br>
  2666. <em>
  2667. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2668. BeyondTrustProviderSecretRef
  2669. </a>
  2670. </em>
  2671. </td>
  2672. <td>
  2673. <p>ClientSecret is the API OAuth Client Secret.</p>
  2674. </td>
  2675. </tr>
  2676. <tr>
  2677. <td>
  2678. <code>certificate</code></br>
  2679. <em>
  2680. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2681. BeyondTrustProviderSecretRef
  2682. </a>
  2683. </em>
  2684. </td>
  2685. <td>
  2686. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  2687. </td>
  2688. </tr>
  2689. <tr>
  2690. <td>
  2691. <code>certificateKey</code></br>
  2692. <em>
  2693. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2694. BeyondTrustProviderSecretRef
  2695. </a>
  2696. </em>
  2697. </td>
  2698. <td>
  2699. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  2700. </td>
  2701. </tr>
  2702. </tbody>
  2703. </table>
  2704. <h3 id="external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider
  2705. </h3>
  2706. <p>
  2707. (<em>Appears on:</em>
  2708. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2709. </p>
  2710. <p>
  2711. <p>BeyondtrustProvider provides access to a BeyondTrust secrets provider.</p>
  2712. </p>
  2713. <table>
  2714. <thead>
  2715. <tr>
  2716. <th>Field</th>
  2717. <th>Description</th>
  2718. </tr>
  2719. </thead>
  2720. <tbody>
  2721. <tr>
  2722. <td>
  2723. <code>auth</code></br>
  2724. <em>
  2725. <a href="#external-secrets.io/v1.BeyondtrustAuth">
  2726. BeyondtrustAuth
  2727. </a>
  2728. </em>
  2729. </td>
  2730. <td>
  2731. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  2732. </td>
  2733. </tr>
  2734. <tr>
  2735. <td>
  2736. <code>server</code></br>
  2737. <em>
  2738. <a href="#external-secrets.io/v1.BeyondtrustServer">
  2739. BeyondtrustServer
  2740. </a>
  2741. </em>
  2742. </td>
  2743. <td>
  2744. <p>Auth configures how API server works.</p>
  2745. </td>
  2746. </tr>
  2747. </tbody>
  2748. </table>
  2749. <h3 id="external-secrets.io/v1.BeyondtrustServer">BeyondtrustServer
  2750. </h3>
  2751. <p>
  2752. (<em>Appears on:</em>
  2753. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2754. </p>
  2755. <p>
  2756. <p>BeyondtrustServer configures a store to sync secrets using BeyondTrust Password Safe.</p>
  2757. </p>
  2758. <table>
  2759. <thead>
  2760. <tr>
  2761. <th>Field</th>
  2762. <th>Description</th>
  2763. </tr>
  2764. </thead>
  2765. <tbody>
  2766. <tr>
  2767. <td>
  2768. <code>apiUrl</code></br>
  2769. <em>
  2770. string
  2771. </em>
  2772. </td>
  2773. <td>
  2774. </td>
  2775. </tr>
  2776. <tr>
  2777. <td>
  2778. <code>apiVersion</code></br>
  2779. <em>
  2780. string
  2781. </em>
  2782. </td>
  2783. <td>
  2784. </td>
  2785. </tr>
  2786. <tr>
  2787. <td>
  2788. <code>retrievalType</code></br>
  2789. <em>
  2790. string
  2791. </em>
  2792. </td>
  2793. <td>
  2794. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  2795. </td>
  2796. </tr>
  2797. <tr>
  2798. <td>
  2799. <code>separator</code></br>
  2800. <em>
  2801. string
  2802. </em>
  2803. </td>
  2804. <td>
  2805. <p>A character that separates the folder names.</p>
  2806. </td>
  2807. </tr>
  2808. <tr>
  2809. <td>
  2810. <code>decrypt</code></br>
  2811. <em>
  2812. bool
  2813. </em>
  2814. </td>
  2815. <td>
  2816. <em>(Optional)</em>
  2817. <p>When true, the response includes the decrypted password. When false, the password field is omitted. This option only applies to the SECRET retrieval type. Default: true.</p>
  2818. </td>
  2819. </tr>
  2820. <tr>
  2821. <td>
  2822. <code>verifyCA</code></br>
  2823. <em>
  2824. bool
  2825. </em>
  2826. </td>
  2827. <td>
  2828. </td>
  2829. </tr>
  2830. <tr>
  2831. <td>
  2832. <code>clientTimeOutSeconds</code></br>
  2833. <em>
  2834. int
  2835. </em>
  2836. </td>
  2837. <td>
  2838. <p>Timeout specifies a time limit for requests made by this Client. The timeout includes connection time, any redirects, and reading the response body. Defaults to 45 seconds.</p>
  2839. </td>
  2840. </tr>
  2841. </tbody>
  2842. </table>
  2843. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">BeyondtrustWorkloadCredentialsAuth
  2844. </h3>
  2845. <p>
  2846. (<em>Appears on:</em>
  2847. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>)
  2848. </p>
  2849. <p>
  2850. <p>BeyondtrustWorkloadCredentialsAuth defines the authentication method for the BeyondTrust Workload Credentials provider.
  2851. Currently supports API key authentication via Kubernetes secret reference.
  2852. For authentication documentation, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api#authentication">https://docs.beyondtrust.com/bt-docs/docs/secrets-api#authentication</a></p>
  2853. </p>
  2854. <table>
  2855. <thead>
  2856. <tr>
  2857. <th>Field</th>
  2858. <th>Description</th>
  2859. </tr>
  2860. </thead>
  2861. <tbody>
  2862. <tr>
  2863. <td>
  2864. <code>apikey</code></br>
  2865. <em>
  2866. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuthSecretRef">
  2867. BeyondtrustWorkloadCredentialsAuthSecretRef
  2868. </a>
  2869. </em>
  2870. </td>
  2871. <td>
  2872. <p>APIKey configures API token authentication for BeyondTrust Workload Credentials.
  2873. The token is retrieved from a Kubernetes secret and used as a Bearer token for API requests.</p>
  2874. </td>
  2875. </tr>
  2876. </tbody>
  2877. </table>
  2878. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuthSecretRef">BeyondtrustWorkloadCredentialsAuthSecretRef
  2879. </h3>
  2880. <p>
  2881. (<em>Appears on:</em>
  2882. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">BeyondtrustWorkloadCredentialsAuth</a>)
  2883. </p>
  2884. <p>
  2885. <p>BeyondtrustWorkloadCredentialsAuthSecretRef defines a reference to a secret containing credentials for the BeyondTrust Workload Credentials provider.
  2886. The nested structure supports multiple authentication methods (currently only API token is supported).
  2887. For more information on authentication, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api#authentication">https://docs.beyondtrust.com/bt-docs/docs/secrets-api#authentication</a></p>
  2888. </p>
  2889. <table>
  2890. <thead>
  2891. <tr>
  2892. <th>Field</th>
  2893. <th>Description</th>
  2894. </tr>
  2895. </thead>
  2896. <tbody>
  2897. <tr>
  2898. <td>
  2899. <code>token</code></br>
  2900. <em>
  2901. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2902. External Secrets meta/v1.SecretKeySelector
  2903. </a>
  2904. </em>
  2905. </td>
  2906. <td>
  2907. <p>Token references the Kubernetes secret containing the BeyondTrust Workload Credentials API token.
  2908. The secret should contain the API key used to authenticate with BeyondTrust Workload Credentials.
  2909. Create an API token in your BeyondTrust Workload Credentials console and store it in a Kubernetes secret.
  2910. For details on creating API tokens, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api#authentication">https://docs.beyondtrust.com/bt-docs/docs/secrets-api#authentication</a></p>
  2911. </td>
  2912. </tr>
  2913. </tbody>
  2914. </table>
  2915. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider
  2916. </h3>
  2917. <p>
  2918. (<em>Appears on:</em>
  2919. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  2920. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec</a>)
  2921. </p>
  2922. <p>
  2923. <p>BeyondtrustWorkloadCredentialsProvider configures a store to sync secrets using the BeyondTrust Workload Credentials provider.
  2924. BeyondTrust Workload Credentials provides secure storage for static secrets and dynamic credential generation.
  2925. This provider supports reading secrets and generating dynamic credentials (e.g., temporary AWS credentials).
  2926. For complete documentation, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api">https://docs.beyondtrust.com/bt-docs/docs/secrets-api</a></p>
  2927. </p>
  2928. <table>
  2929. <thead>
  2930. <tr>
  2931. <th>Field</th>
  2932. <th>Description</th>
  2933. </tr>
  2934. </thead>
  2935. <tbody>
  2936. <tr>
  2937. <td>
  2938. <code>auth</code></br>
  2939. <em>
  2940. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">
  2941. BeyondtrustWorkloadCredentialsAuth
  2942. </a>
  2943. </em>
  2944. </td>
  2945. <td>
  2946. <p>Auth configures how the Operator authenticates with the BeyondTrust Workload Credentials API.
  2947. Currently supports API key authentication via Kubernetes secret reference.
  2948. For authentication setup, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api#authentication">https://docs.beyondtrust.com/bt-docs/docs/secrets-api#authentication</a></p>
  2949. </td>
  2950. </tr>
  2951. <tr>
  2952. <td>
  2953. <code>server</code></br>
  2954. <em>
  2955. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsServer">
  2956. BeyondtrustWorkloadCredentialsServer
  2957. </a>
  2958. </em>
  2959. </td>
  2960. <td>
  2961. <p>Server configures the BeyondTrust Workload Credentials server connection details.
  2962. Includes the API URL and Site ID for your BeyondTrust instance.
  2963. For API reference, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api">https://docs.beyondtrust.com/bt-docs/docs/secrets-api</a></p>
  2964. </td>
  2965. </tr>
  2966. <tr>
  2967. <td>
  2968. <code>folderPath</code></br>
  2969. <em>
  2970. string
  2971. </em>
  2972. </td>
  2973. <td>
  2974. <em>(Optional)</em>
  2975. <p>FolderPath specifies the default folder path for secret retrieval.
  2976. Secrets will be fetched from this folder unless overridden in the ExternalSecret spec.
  2977. Example: &ldquo;production/database&rdquo; or &ldquo;dev/api-keys&rdquo;
  2978. Leave empty to retrieve secrets from the root folder.
  2979. For folder organization, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api#folders">https://docs.beyondtrust.com/bt-docs/docs/secrets-api#folders</a></p>
  2980. </td>
  2981. </tr>
  2982. <tr>
  2983. <td>
  2984. <code>caBundle</code></br>
  2985. <em>
  2986. []byte
  2987. </em>
  2988. </td>
  2989. <td>
  2990. <em>(Optional)</em>
  2991. <p>CABundle is a base64-encoded CA certificate used to validate the BeyondTrust Workload Credentials API TLS certificate.
  2992. Use this when your BeyondTrust instance uses a self-signed certificate or internal CA.
  2993. If not set, the system&rsquo;s trusted root certificates are used.</p>
  2994. </td>
  2995. </tr>
  2996. <tr>
  2997. <td>
  2998. <code>caProvider</code></br>
  2999. <em>
  3000. <a href="#external-secrets.io/v1.CAProvider">
  3001. CAProvider
  3002. </a>
  3003. </em>
  3004. </td>
  3005. <td>
  3006. <em>(Optional)</em>
  3007. <p>CAProvider points to a Secret or ConfigMap containing a PEM-encoded CA certificate.
  3008. This is used to validate the BeyondTrust Workload Credentials API TLS certificate.
  3009. Use this as an alternative to CABundle when you want to reference an existing Kubernetes resource.</p>
  3010. </td>
  3011. </tr>
  3012. </tbody>
  3013. </table>
  3014. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsServer">BeyondtrustWorkloadCredentialsServer
  3015. </h3>
  3016. <p>
  3017. (<em>Appears on:</em>
  3018. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>)
  3019. </p>
  3020. <p>
  3021. <p>BeyondtrustWorkloadCredentialsServer defines connection configuration for BeyondTrust Workload Credentials.
  3022. For API reference documentation, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api">https://docs.beyondtrust.com/bt-docs/docs/secrets-api</a></p>
  3023. </p>
  3024. <table>
  3025. <thead>
  3026. <tr>
  3027. <th>Field</th>
  3028. <th>Description</th>
  3029. </tr>
  3030. </thead>
  3031. <tbody>
  3032. <tr>
  3033. <td>
  3034. <code>apiUrl</code></br>
  3035. <em>
  3036. string
  3037. </em>
  3038. </td>
  3039. <td>
  3040. <p>APIURL is the base URL of your BeyondTrust Workload Credentials API server.
  3041. This should be the full URL to your BeyondTrust instance.
  3042. Example: <a href="https://api.beyondtrust.io/siie">https://api.beyondtrust.io/siie</a>
  3043. For more information, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api#base-url">https://docs.beyondtrust.com/bt-docs/docs/secrets-api#base-url</a></p>
  3044. </td>
  3045. </tr>
  3046. <tr>
  3047. <td>
  3048. <code>siteId</code></br>
  3049. <em>
  3050. string
  3051. </em>
  3052. </td>
  3053. <td>
  3054. <p>SiteID is your BeyondTrust Workload Credentials site identifier (UUID format).
  3055. This identifier is unique to your BeyondTrust Workload Credentials instance.
  3056. You can find your Site ID in the BeyondTrust Workload Credentials admin console.
  3057. Example: a1b2c3d4-e5f6-4890-abcd-ef1234567890
  3058. For more information, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api">https://docs.beyondtrust.com/bt-docs/docs/secrets-api</a></p>
  3059. </td>
  3060. </tr>
  3061. </tbody>
  3062. </table>
  3063. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  3064. </h3>
  3065. <p>
  3066. (<em>Appears on:</em>
  3067. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  3068. </p>
  3069. <p>
  3070. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  3071. </p>
  3072. <table>
  3073. <thead>
  3074. <tr>
  3075. <th>Field</th>
  3076. <th>Description</th>
  3077. </tr>
  3078. </thead>
  3079. <tbody>
  3080. <tr>
  3081. <td>
  3082. <code>secretRef</code></br>
  3083. <em>
  3084. <a href="#external-secrets.io/v1.BitwardenSecretsManagerSecretRef">
  3085. BitwardenSecretsManagerSecretRef
  3086. </a>
  3087. </em>
  3088. </td>
  3089. <td>
  3090. </td>
  3091. </tr>
  3092. </tbody>
  3093. </table>
  3094. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  3095. </h3>
  3096. <p>
  3097. (<em>Appears on:</em>
  3098. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3099. </p>
  3100. <p>
  3101. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  3102. </p>
  3103. <table>
  3104. <thead>
  3105. <tr>
  3106. <th>Field</th>
  3107. <th>Description</th>
  3108. </tr>
  3109. </thead>
  3110. <tbody>
  3111. <tr>
  3112. <td>
  3113. <code>apiURL</code></br>
  3114. <em>
  3115. string
  3116. </em>
  3117. </td>
  3118. <td>
  3119. </td>
  3120. </tr>
  3121. <tr>
  3122. <td>
  3123. <code>identityURL</code></br>
  3124. <em>
  3125. string
  3126. </em>
  3127. </td>
  3128. <td>
  3129. </td>
  3130. </tr>
  3131. <tr>
  3132. <td>
  3133. <code>bitwardenServerSDKURL</code></br>
  3134. <em>
  3135. string
  3136. </em>
  3137. </td>
  3138. <td>
  3139. </td>
  3140. </tr>
  3141. <tr>
  3142. <td>
  3143. <code>caBundle</code></br>
  3144. <em>
  3145. string
  3146. </em>
  3147. </td>
  3148. <td>
  3149. <em>(Optional)</em>
  3150. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  3151. can be performed.</p>
  3152. </td>
  3153. </tr>
  3154. <tr>
  3155. <td>
  3156. <code>caProvider</code></br>
  3157. <em>
  3158. <a href="#external-secrets.io/v1.CAProvider">
  3159. CAProvider
  3160. </a>
  3161. </em>
  3162. </td>
  3163. <td>
  3164. <em>(Optional)</em>
  3165. <p>see: <a href="https://external-secrets.io/latest/spec/#external-secrets.io/v1alpha1.CAProvider">https://external-secrets.io/latest/spec/#external-secrets.io/v1alpha1.CAProvider</a></p>
  3166. </td>
  3167. </tr>
  3168. <tr>
  3169. <td>
  3170. <code>organizationID</code></br>
  3171. <em>
  3172. string
  3173. </em>
  3174. </td>
  3175. <td>
  3176. <p>OrganizationID determines which organization this secret store manages.</p>
  3177. </td>
  3178. </tr>
  3179. <tr>
  3180. <td>
  3181. <code>projectID</code></br>
  3182. <em>
  3183. string
  3184. </em>
  3185. </td>
  3186. <td>
  3187. <p>ProjectID determines which project this secret store manages.</p>
  3188. </td>
  3189. </tr>
  3190. <tr>
  3191. <td>
  3192. <code>auth</code></br>
  3193. <em>
  3194. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">
  3195. BitwardenSecretsManagerAuth
  3196. </a>
  3197. </em>
  3198. </td>
  3199. <td>
  3200. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  3201. Make sure that the token being used has permissions on the given secret.</p>
  3202. </td>
  3203. </tr>
  3204. </tbody>
  3205. </table>
  3206. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  3207. </h3>
  3208. <p>
  3209. (<em>Appears on:</em>
  3210. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  3211. </p>
  3212. <p>
  3213. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  3214. </p>
  3215. <table>
  3216. <thead>
  3217. <tr>
  3218. <th>Field</th>
  3219. <th>Description</th>
  3220. </tr>
  3221. </thead>
  3222. <tbody>
  3223. <tr>
  3224. <td>
  3225. <code>credentials</code></br>
  3226. <em>
  3227. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3228. External Secrets meta/v1.SecretKeySelector
  3229. </a>
  3230. </em>
  3231. </td>
  3232. <td>
  3233. <p>AccessToken used for the bitwarden instance.</p>
  3234. </td>
  3235. </tr>
  3236. </tbody>
  3237. </table>
  3238. <h3 id="external-secrets.io/v1.ByID">ByID
  3239. </h3>
  3240. <p>
  3241. (<em>Appears on:</em>
  3242. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  3243. </p>
  3244. <p>
  3245. <p>ByID configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID.</p>
  3246. </p>
  3247. <h3 id="external-secrets.io/v1.ByName">ByName
  3248. </h3>
  3249. <p>
  3250. (<em>Appears on:</em>
  3251. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  3252. </p>
  3253. <p>
  3254. <p>ByName configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret name.</p>
  3255. </p>
  3256. <table>
  3257. <thead>
  3258. <tr>
  3259. <th>Field</th>
  3260. <th>Description</th>
  3261. </tr>
  3262. </thead>
  3263. <tbody>
  3264. <tr>
  3265. <td>
  3266. <code>folderID</code></br>
  3267. <em>
  3268. string
  3269. </em>
  3270. </td>
  3271. <td>
  3272. <p>The folder to fetch secrets from</p>
  3273. </td>
  3274. </tr>
  3275. </tbody>
  3276. </table>
  3277. <h3 id="external-secrets.io/v1.CAProvider">CAProvider
  3278. </h3>
  3279. <p>
  3280. (<em>Appears on:</em>
  3281. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>,
  3282. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>,
  3283. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  3284. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>,
  3285. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>,
  3286. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>,
  3287. <a href="#external-secrets.io/v1.KubernetesServer">KubernetesServer</a>,
  3288. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>,
  3289. <a href="#external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS</a>,
  3290. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>,
  3291. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>,
  3292. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  3293. </p>
  3294. <p>
  3295. <p>CAProvider provides a custom certificate authority for accessing the provider&rsquo;s store.
  3296. The CAProvider points to a Secret or ConfigMap resource that contains a PEM-encoded certificate.</p>
  3297. </p>
  3298. <table>
  3299. <thead>
  3300. <tr>
  3301. <th>Field</th>
  3302. <th>Description</th>
  3303. </tr>
  3304. </thead>
  3305. <tbody>
  3306. <tr>
  3307. <td>
  3308. <code>type</code></br>
  3309. <em>
  3310. <a href="#external-secrets.io/v1.CAProviderType">
  3311. CAProviderType
  3312. </a>
  3313. </em>
  3314. </td>
  3315. <td>
  3316. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  3317. </td>
  3318. </tr>
  3319. <tr>
  3320. <td>
  3321. <code>name</code></br>
  3322. <em>
  3323. string
  3324. </em>
  3325. </td>
  3326. <td>
  3327. <p>The name of the object located at the provider type.</p>
  3328. </td>
  3329. </tr>
  3330. <tr>
  3331. <td>
  3332. <code>key</code></br>
  3333. <em>
  3334. string
  3335. </em>
  3336. </td>
  3337. <td>
  3338. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  3339. </td>
  3340. </tr>
  3341. <tr>
  3342. <td>
  3343. <code>namespace</code></br>
  3344. <em>
  3345. string
  3346. </em>
  3347. </td>
  3348. <td>
  3349. <em>(Optional)</em>
  3350. <p>The namespace the Provider type is in.
  3351. Can only be defined when used in a ClusterSecretStore.</p>
  3352. </td>
  3353. </tr>
  3354. </tbody>
  3355. </table>
  3356. <h3 id="external-secrets.io/v1.CAProviderType">CAProviderType
  3357. (<code>string</code> alias)</p></h3>
  3358. <p>
  3359. (<em>Appears on:</em>
  3360. <a href="#external-secrets.io/v1.CAProvider">CAProvider</a>)
  3361. </p>
  3362. <p>
  3363. <p>CAProviderType defines the type of provider for certificate authority.</p>
  3364. </p>
  3365. <table>
  3366. <thead>
  3367. <tr>
  3368. <th>Value</th>
  3369. <th>Description</th>
  3370. </tr>
  3371. </thead>
  3372. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  3373. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  3374. </td>
  3375. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  3376. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  3377. </td>
  3378. </tr></tbody>
  3379. </table>
  3380. <h3 id="external-secrets.io/v1.CSMAuth">CSMAuth
  3381. </h3>
  3382. <p>
  3383. (<em>Appears on:</em>
  3384. <a href="#external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider</a>)
  3385. </p>
  3386. <p>
  3387. <p>CSMAuth contains a secretRef for credentials.</p>
  3388. </p>
  3389. <table>
  3390. <thead>
  3391. <tr>
  3392. <th>Field</th>
  3393. <th>Description</th>
  3394. </tr>
  3395. </thead>
  3396. <tbody>
  3397. <tr>
  3398. <td>
  3399. <code>secretRef</code></br>
  3400. <em>
  3401. <a href="#external-secrets.io/v1.CSMAuthSecretRef">
  3402. CSMAuthSecretRef
  3403. </a>
  3404. </em>
  3405. </td>
  3406. <td>
  3407. <em>(Optional)</em>
  3408. </td>
  3409. </tr>
  3410. </tbody>
  3411. </table>
  3412. <h3 id="external-secrets.io/v1.CSMAuthSecretRef">CSMAuthSecretRef
  3413. </h3>
  3414. <p>
  3415. (<em>Appears on:</em>
  3416. <a href="#external-secrets.io/v1.CSMAuth">CSMAuth</a>)
  3417. </p>
  3418. <p>
  3419. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  3420. </p>
  3421. <table>
  3422. <thead>
  3423. <tr>
  3424. <th>Field</th>
  3425. <th>Description</th>
  3426. </tr>
  3427. </thead>
  3428. <tbody>
  3429. <tr>
  3430. <td>
  3431. <code>accessKeyIDSecretRef</code></br>
  3432. <em>
  3433. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3434. External Secrets meta/v1.SecretKeySelector
  3435. </a>
  3436. </em>
  3437. </td>
  3438. <td>
  3439. <p>The AccessKeyID is used for authentication</p>
  3440. </td>
  3441. </tr>
  3442. <tr>
  3443. <td>
  3444. <code>accessKeySecretSecretRef</code></br>
  3445. <em>
  3446. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3447. External Secrets meta/v1.SecretKeySelector
  3448. </a>
  3449. </em>
  3450. </td>
  3451. <td>
  3452. <p>The AccessKeySecret is used for authentication</p>
  3453. </td>
  3454. </tr>
  3455. </tbody>
  3456. </table>
  3457. <h3 id="external-secrets.io/v1.CacheConfig">CacheConfig
  3458. </h3>
  3459. <p>
  3460. (<em>Appears on:</em>
  3461. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  3462. </p>
  3463. <p>
  3464. <p>CacheConfig configures client-side caching for read operations.</p>
  3465. </p>
  3466. <table>
  3467. <thead>
  3468. <tr>
  3469. <th>Field</th>
  3470. <th>Description</th>
  3471. </tr>
  3472. </thead>
  3473. <tbody>
  3474. <tr>
  3475. <td>
  3476. <code>ttl</code></br>
  3477. <em>
  3478. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3479. Kubernetes meta/v1.Duration
  3480. </a>
  3481. </em>
  3482. </td>
  3483. <td>
  3484. <em>(Optional)</em>
  3485. <p>TTL is the time-to-live for cached secrets.
  3486. Format: duration string (e.g., &ldquo;5m&rdquo;, &ldquo;1h&rdquo;, &ldquo;30s&rdquo;)</p>
  3487. </td>
  3488. </tr>
  3489. <tr>
  3490. <td>
  3491. <code>maxSize</code></br>
  3492. <em>
  3493. int
  3494. </em>
  3495. </td>
  3496. <td>
  3497. <em>(Optional)</em>
  3498. <p>MaxSize is the maximum number of secrets to cache.
  3499. When the cache is full, least-recently-used entries are evicted.</p>
  3500. </td>
  3501. </tr>
  3502. </tbody>
  3503. </table>
  3504. <h3 id="external-secrets.io/v1.CertAuth">CertAuth
  3505. </h3>
  3506. <p>
  3507. (<em>Appears on:</em>
  3508. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  3509. </p>
  3510. <p>
  3511. <p>CertAuth defines certificate-based authentication configuration for Kubernetes.</p>
  3512. </p>
  3513. <table>
  3514. <thead>
  3515. <tr>
  3516. <th>Field</th>
  3517. <th>Description</th>
  3518. </tr>
  3519. </thead>
  3520. <tbody>
  3521. <tr>
  3522. <td>
  3523. <code>clientCert</code></br>
  3524. <em>
  3525. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3526. External Secrets meta/v1.SecretKeySelector
  3527. </a>
  3528. </em>
  3529. </td>
  3530. <td>
  3531. </td>
  3532. </tr>
  3533. <tr>
  3534. <td>
  3535. <code>clientKey</code></br>
  3536. <em>
  3537. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3538. External Secrets meta/v1.SecretKeySelector
  3539. </a>
  3540. </em>
  3541. </td>
  3542. <td>
  3543. </td>
  3544. </tr>
  3545. </tbody>
  3546. </table>
  3547. <h3 id="external-secrets.io/v1.ChefAuth">ChefAuth
  3548. </h3>
  3549. <p>
  3550. (<em>Appears on:</em>
  3551. <a href="#external-secrets.io/v1.ChefProvider">ChefProvider</a>)
  3552. </p>
  3553. <p>
  3554. <p>ChefAuth contains a secretRef for credentials.</p>
  3555. </p>
  3556. <table>
  3557. <thead>
  3558. <tr>
  3559. <th>Field</th>
  3560. <th>Description</th>
  3561. </tr>
  3562. </thead>
  3563. <tbody>
  3564. <tr>
  3565. <td>
  3566. <code>secretRef</code></br>
  3567. <em>
  3568. <a href="#external-secrets.io/v1.ChefAuthSecretRef">
  3569. ChefAuthSecretRef
  3570. </a>
  3571. </em>
  3572. </td>
  3573. <td>
  3574. </td>
  3575. </tr>
  3576. </tbody>
  3577. </table>
  3578. <h3 id="external-secrets.io/v1.ChefAuthSecretRef">ChefAuthSecretRef
  3579. </h3>
  3580. <p>
  3581. (<em>Appears on:</em>
  3582. <a href="#external-secrets.io/v1.ChefAuth">ChefAuth</a>)
  3583. </p>
  3584. <p>
  3585. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  3586. </p>
  3587. <table>
  3588. <thead>
  3589. <tr>
  3590. <th>Field</th>
  3591. <th>Description</th>
  3592. </tr>
  3593. </thead>
  3594. <tbody>
  3595. <tr>
  3596. <td>
  3597. <code>privateKeySecretRef</code></br>
  3598. <em>
  3599. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3600. External Secrets meta/v1.SecretKeySelector
  3601. </a>
  3602. </em>
  3603. </td>
  3604. <td>
  3605. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  3606. </td>
  3607. </tr>
  3608. </tbody>
  3609. </table>
  3610. <h3 id="external-secrets.io/v1.ChefProvider">ChefProvider
  3611. </h3>
  3612. <p>
  3613. (<em>Appears on:</em>
  3614. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3615. </p>
  3616. <p>
  3617. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  3618. </p>
  3619. <table>
  3620. <thead>
  3621. <tr>
  3622. <th>Field</th>
  3623. <th>Description</th>
  3624. </tr>
  3625. </thead>
  3626. <tbody>
  3627. <tr>
  3628. <td>
  3629. <code>auth</code></br>
  3630. <em>
  3631. <a href="#external-secrets.io/v1.ChefAuth">
  3632. ChefAuth
  3633. </a>
  3634. </em>
  3635. </td>
  3636. <td>
  3637. <p>Auth defines the information necessary to authenticate against chef Server</p>
  3638. </td>
  3639. </tr>
  3640. <tr>
  3641. <td>
  3642. <code>username</code></br>
  3643. <em>
  3644. string
  3645. </em>
  3646. </td>
  3647. <td>
  3648. <p>UserName should be the user ID on the chef server</p>
  3649. </td>
  3650. </tr>
  3651. <tr>
  3652. <td>
  3653. <code>serverUrl</code></br>
  3654. <em>
  3655. string
  3656. </em>
  3657. </td>
  3658. <td>
  3659. <p>ServerURL is the chef server URL used to connect to. If using orgs you should include your org in the url and terminate the url with a &ldquo;/&rdquo;</p>
  3660. </td>
  3661. </tr>
  3662. </tbody>
  3663. </table>
  3664. <h3 id="external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider
  3665. </h3>
  3666. <p>
  3667. (<em>Appears on:</em>
  3668. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3669. </p>
  3670. <p>
  3671. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  3672. </p>
  3673. <table>
  3674. <thead>
  3675. <tr>
  3676. <th>Field</th>
  3677. <th>Description</th>
  3678. </tr>
  3679. </thead>
  3680. <tbody>
  3681. <tr>
  3682. <td>
  3683. <code>auth</code></br>
  3684. <em>
  3685. <a href="#external-secrets.io/v1.CSMAuth">
  3686. CSMAuth
  3687. </a>
  3688. </em>
  3689. </td>
  3690. <td>
  3691. </td>
  3692. </tr>
  3693. <tr>
  3694. <td>
  3695. <code>projectID</code></br>
  3696. <em>
  3697. string
  3698. </em>
  3699. </td>
  3700. <td>
  3701. <p>ProjectID is the project, which the secrets are stored in.</p>
  3702. </td>
  3703. </tr>
  3704. </tbody>
  3705. </table>
  3706. <h3 id="external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret
  3707. </h3>
  3708. <p>
  3709. <p>ClusterExternalSecret is the Schema for the clusterexternalsecrets API.</p>
  3710. </p>
  3711. <table>
  3712. <thead>
  3713. <tr>
  3714. <th>Field</th>
  3715. <th>Description</th>
  3716. </tr>
  3717. </thead>
  3718. <tbody>
  3719. <tr>
  3720. <td>
  3721. <code>metadata</code></br>
  3722. <em>
  3723. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  3724. Kubernetes meta/v1.ObjectMeta
  3725. </a>
  3726. </em>
  3727. </td>
  3728. <td>
  3729. Refer to the Kubernetes API documentation for the fields of the
  3730. <code>metadata</code> field.
  3731. </td>
  3732. </tr>
  3733. <tr>
  3734. <td>
  3735. <code>spec</code></br>
  3736. <em>
  3737. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">
  3738. ClusterExternalSecretSpec
  3739. </a>
  3740. </em>
  3741. </td>
  3742. <td>
  3743. <br/>
  3744. <br/>
  3745. <table>
  3746. <tr>
  3747. <td>
  3748. <code>externalSecretSpec</code></br>
  3749. <em>
  3750. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3751. ExternalSecretSpec
  3752. </a>
  3753. </em>
  3754. </td>
  3755. <td>
  3756. <p>The spec for the ExternalSecrets to be created</p>
  3757. </td>
  3758. </tr>
  3759. <tr>
  3760. <td>
  3761. <code>externalSecretName</code></br>
  3762. <em>
  3763. string
  3764. </em>
  3765. </td>
  3766. <td>
  3767. <em>(Optional)</em>
  3768. <p>The name of the external secrets to be created.
  3769. Defaults to the name of the ClusterExternalSecret</p>
  3770. </td>
  3771. </tr>
  3772. <tr>
  3773. <td>
  3774. <code>externalSecretMetadata</code></br>
  3775. <em>
  3776. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3777. ExternalSecretMetadata
  3778. </a>
  3779. </em>
  3780. </td>
  3781. <td>
  3782. <em>(Optional)</em>
  3783. <p>The metadata of the external secrets to be created</p>
  3784. </td>
  3785. </tr>
  3786. <tr>
  3787. <td>
  3788. <code>namespaceSelector</code></br>
  3789. <em>
  3790. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3791. Kubernetes meta/v1.LabelSelector
  3792. </a>
  3793. </em>
  3794. </td>
  3795. <td>
  3796. <em>(Optional)</em>
  3797. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3798. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3799. </td>
  3800. </tr>
  3801. <tr>
  3802. <td>
  3803. <code>namespaceSelectors</code></br>
  3804. <em>
  3805. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3806. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3807. </a>
  3808. </em>
  3809. </td>
  3810. <td>
  3811. <em>(Optional)</em>
  3812. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  3813. </td>
  3814. </tr>
  3815. <tr>
  3816. <td>
  3817. <code>namespaces</code></br>
  3818. <em>
  3819. []string
  3820. </em>
  3821. </td>
  3822. <td>
  3823. <em>(Optional)</em>
  3824. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  3825. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3826. </td>
  3827. </tr>
  3828. <tr>
  3829. <td>
  3830. <code>refreshTime</code></br>
  3831. <em>
  3832. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3833. Kubernetes meta/v1.Duration
  3834. </a>
  3835. </em>
  3836. </td>
  3837. <td>
  3838. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  3839. </td>
  3840. </tr>
  3841. </table>
  3842. </td>
  3843. </tr>
  3844. <tr>
  3845. <td>
  3846. <code>status</code></br>
  3847. <em>
  3848. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">
  3849. ClusterExternalSecretStatus
  3850. </a>
  3851. </em>
  3852. </td>
  3853. <td>
  3854. </td>
  3855. </tr>
  3856. </tbody>
  3857. </table>
  3858. <h3 id="external-secrets.io/v1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  3859. (<code>string</code> alias)</p></h3>
  3860. <p>
  3861. (<em>Appears on:</em>
  3862. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  3863. </p>
  3864. <p>
  3865. <p>ClusterExternalSecretConditionType defines a value type for ClusterExternalSecret conditions.</p>
  3866. </p>
  3867. <table>
  3868. <thead>
  3869. <tr>
  3870. <th>Value</th>
  3871. <th>Description</th>
  3872. </tr>
  3873. </thead>
  3874. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  3875. <td><p>ClusterExternalSecretReady is a ClusterExternalSecretConditionType set when the ClusterExternalSecret is ready.</p>
  3876. </td>
  3877. </tr></tbody>
  3878. </table>
  3879. <h3 id="external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  3880. </h3>
  3881. <p>
  3882. (<em>Appears on:</em>
  3883. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  3884. </p>
  3885. <p>
  3886. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  3887. </p>
  3888. <table>
  3889. <thead>
  3890. <tr>
  3891. <th>Field</th>
  3892. <th>Description</th>
  3893. </tr>
  3894. </thead>
  3895. <tbody>
  3896. <tr>
  3897. <td>
  3898. <code>namespace</code></br>
  3899. <em>
  3900. string
  3901. </em>
  3902. </td>
  3903. <td>
  3904. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  3905. </td>
  3906. </tr>
  3907. <tr>
  3908. <td>
  3909. <code>reason</code></br>
  3910. <em>
  3911. string
  3912. </em>
  3913. </td>
  3914. <td>
  3915. <em>(Optional)</em>
  3916. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  3917. </td>
  3918. </tr>
  3919. </tbody>
  3920. </table>
  3921. <h3 id="external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  3922. </h3>
  3923. <p>
  3924. (<em>Appears on:</em>
  3925. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  3926. </p>
  3927. <p>
  3928. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  3929. </p>
  3930. <table>
  3931. <thead>
  3932. <tr>
  3933. <th>Field</th>
  3934. <th>Description</th>
  3935. </tr>
  3936. </thead>
  3937. <tbody>
  3938. <tr>
  3939. <td>
  3940. <code>externalSecretSpec</code></br>
  3941. <em>
  3942. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3943. ExternalSecretSpec
  3944. </a>
  3945. </em>
  3946. </td>
  3947. <td>
  3948. <p>The spec for the ExternalSecrets to be created</p>
  3949. </td>
  3950. </tr>
  3951. <tr>
  3952. <td>
  3953. <code>externalSecretName</code></br>
  3954. <em>
  3955. string
  3956. </em>
  3957. </td>
  3958. <td>
  3959. <em>(Optional)</em>
  3960. <p>The name of the external secrets to be created.
  3961. Defaults to the name of the ClusterExternalSecret</p>
  3962. </td>
  3963. </tr>
  3964. <tr>
  3965. <td>
  3966. <code>externalSecretMetadata</code></br>
  3967. <em>
  3968. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3969. ExternalSecretMetadata
  3970. </a>
  3971. </em>
  3972. </td>
  3973. <td>
  3974. <em>(Optional)</em>
  3975. <p>The metadata of the external secrets to be created</p>
  3976. </td>
  3977. </tr>
  3978. <tr>
  3979. <td>
  3980. <code>namespaceSelector</code></br>
  3981. <em>
  3982. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3983. Kubernetes meta/v1.LabelSelector
  3984. </a>
  3985. </em>
  3986. </td>
  3987. <td>
  3988. <em>(Optional)</em>
  3989. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3990. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3991. </td>
  3992. </tr>
  3993. <tr>
  3994. <td>
  3995. <code>namespaceSelectors</code></br>
  3996. <em>
  3997. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3998. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3999. </a>
  4000. </em>
  4001. </td>
  4002. <td>
  4003. <em>(Optional)</em>
  4004. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  4005. </td>
  4006. </tr>
  4007. <tr>
  4008. <td>
  4009. <code>namespaces</code></br>
  4010. <em>
  4011. []string
  4012. </em>
  4013. </td>
  4014. <td>
  4015. <em>(Optional)</em>
  4016. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  4017. <p>Deprecated: Use NamespaceSelectors instead.</p>
  4018. </td>
  4019. </tr>
  4020. <tr>
  4021. <td>
  4022. <code>refreshTime</code></br>
  4023. <em>
  4024. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  4025. Kubernetes meta/v1.Duration
  4026. </a>
  4027. </em>
  4028. </td>
  4029. <td>
  4030. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  4031. </td>
  4032. </tr>
  4033. </tbody>
  4034. </table>
  4035. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  4036. </h3>
  4037. <p>
  4038. (<em>Appears on:</em>
  4039. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  4040. </p>
  4041. <p>
  4042. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  4043. </p>
  4044. <table>
  4045. <thead>
  4046. <tr>
  4047. <th>Field</th>
  4048. <th>Description</th>
  4049. </tr>
  4050. </thead>
  4051. <tbody>
  4052. <tr>
  4053. <td>
  4054. <code>externalSecretName</code></br>
  4055. <em>
  4056. string
  4057. </em>
  4058. </td>
  4059. <td>
  4060. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  4061. </td>
  4062. </tr>
  4063. <tr>
  4064. <td>
  4065. <code>failedNamespaces</code></br>
  4066. <em>
  4067. <a href="#external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">
  4068. []ClusterExternalSecretNamespaceFailure
  4069. </a>
  4070. </em>
  4071. </td>
  4072. <td>
  4073. <em>(Optional)</em>
  4074. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  4075. </td>
  4076. </tr>
  4077. <tr>
  4078. <td>
  4079. <code>provisionedNamespaces</code></br>
  4080. <em>
  4081. []string
  4082. </em>
  4083. </td>
  4084. <td>
  4085. <em>(Optional)</em>
  4086. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  4087. </td>
  4088. </tr>
  4089. <tr>
  4090. <td>
  4091. <code>conditions</code></br>
  4092. <em>
  4093. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">
  4094. []ClusterExternalSecretStatusCondition
  4095. </a>
  4096. </em>
  4097. </td>
  4098. <td>
  4099. <em>(Optional)</em>
  4100. </td>
  4101. </tr>
  4102. </tbody>
  4103. </table>
  4104. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  4105. </h3>
  4106. <p>
  4107. (<em>Appears on:</em>
  4108. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  4109. </p>
  4110. <p>
  4111. <p>ClusterExternalSecretStatusCondition defines the observed state of a ClusterExternalSecret resource.</p>
  4112. </p>
  4113. <table>
  4114. <thead>
  4115. <tr>
  4116. <th>Field</th>
  4117. <th>Description</th>
  4118. </tr>
  4119. </thead>
  4120. <tbody>
  4121. <tr>
  4122. <td>
  4123. <code>type</code></br>
  4124. <em>
  4125. <a href="#external-secrets.io/v1.ClusterExternalSecretConditionType">
  4126. ClusterExternalSecretConditionType
  4127. </a>
  4128. </em>
  4129. </td>
  4130. <td>
  4131. </td>
  4132. </tr>
  4133. <tr>
  4134. <td>
  4135. <code>status</code></br>
  4136. <em>
  4137. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  4138. Kubernetes core/v1.ConditionStatus
  4139. </a>
  4140. </em>
  4141. </td>
  4142. <td>
  4143. </td>
  4144. </tr>
  4145. <tr>
  4146. <td>
  4147. <code>message</code></br>
  4148. <em>
  4149. string
  4150. </em>
  4151. </td>
  4152. <td>
  4153. <em>(Optional)</em>
  4154. </td>
  4155. </tr>
  4156. </tbody>
  4157. </table>
  4158. <h3 id="external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore
  4159. </h3>
  4160. <p>
  4161. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  4162. </p>
  4163. <table>
  4164. <thead>
  4165. <tr>
  4166. <th>Field</th>
  4167. <th>Description</th>
  4168. </tr>
  4169. </thead>
  4170. <tbody>
  4171. <tr>
  4172. <td>
  4173. <code>metadata</code></br>
  4174. <em>
  4175. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  4176. Kubernetes meta/v1.ObjectMeta
  4177. </a>
  4178. </em>
  4179. </td>
  4180. <td>
  4181. Refer to the Kubernetes API documentation for the fields of the
  4182. <code>metadata</code> field.
  4183. </td>
  4184. </tr>
  4185. <tr>
  4186. <td>
  4187. <code>spec</code></br>
  4188. <em>
  4189. <a href="#external-secrets.io/v1.SecretStoreSpec">
  4190. SecretStoreSpec
  4191. </a>
  4192. </em>
  4193. </td>
  4194. <td>
  4195. <br/>
  4196. <br/>
  4197. <table>
  4198. <tr>
  4199. <td>
  4200. <code>controller</code></br>
  4201. <em>
  4202. string
  4203. </em>
  4204. </td>
  4205. <td>
  4206. <em>(Optional)</em>
  4207. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  4208. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  4209. </td>
  4210. </tr>
  4211. <tr>
  4212. <td>
  4213. <code>provider</code></br>
  4214. <em>
  4215. <a href="#external-secrets.io/v1.SecretStoreProvider">
  4216. SecretStoreProvider
  4217. </a>
  4218. </em>
  4219. </td>
  4220. <td>
  4221. <p>Used to configure the provider. Only one provider may be set</p>
  4222. </td>
  4223. </tr>
  4224. <tr>
  4225. <td>
  4226. <code>retrySettings</code></br>
  4227. <em>
  4228. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  4229. SecretStoreRetrySettings
  4230. </a>
  4231. </em>
  4232. </td>
  4233. <td>
  4234. <em>(Optional)</em>
  4235. <p>Used to configure HTTP retries on failures.</p>
  4236. </td>
  4237. </tr>
  4238. <tr>
  4239. <td>
  4240. <code>refreshInterval</code></br>
  4241. <em>
  4242. int
  4243. </em>
  4244. </td>
  4245. <td>
  4246. <em>(Optional)</em>
  4247. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  4248. </td>
  4249. </tr>
  4250. <tr>
  4251. <td>
  4252. <code>conditions</code></br>
  4253. <em>
  4254. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  4255. []ClusterSecretStoreCondition
  4256. </a>
  4257. </em>
  4258. </td>
  4259. <td>
  4260. <em>(Optional)</em>
  4261. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  4262. </td>
  4263. </tr>
  4264. </table>
  4265. </td>
  4266. </tr>
  4267. <tr>
  4268. <td>
  4269. <code>status</code></br>
  4270. <em>
  4271. <a href="#external-secrets.io/v1.SecretStoreStatus">
  4272. SecretStoreStatus
  4273. </a>
  4274. </em>
  4275. </td>
  4276. <td>
  4277. </td>
  4278. </tr>
  4279. </tbody>
  4280. </table>
  4281. <h3 id="external-secrets.io/v1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  4282. </h3>
  4283. <p>
  4284. (<em>Appears on:</em>
  4285. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  4286. </p>
  4287. <p>
  4288. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  4289. for a ClusterSecretStore instance.</p>
  4290. </p>
  4291. <table>
  4292. <thead>
  4293. <tr>
  4294. <th>Field</th>
  4295. <th>Description</th>
  4296. </tr>
  4297. </thead>
  4298. <tbody>
  4299. <tr>
  4300. <td>
  4301. <code>namespaceSelector</code></br>
  4302. <em>
  4303. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4304. Kubernetes meta/v1.LabelSelector
  4305. </a>
  4306. </em>
  4307. </td>
  4308. <td>
  4309. <em>(Optional)</em>
  4310. <p>Choose namespace using a labelSelector</p>
  4311. </td>
  4312. </tr>
  4313. <tr>
  4314. <td>
  4315. <code>namespaces</code></br>
  4316. <em>
  4317. []string
  4318. </em>
  4319. </td>
  4320. <td>
  4321. <em>(Optional)</em>
  4322. <p>Choose namespaces by name</p>
  4323. </td>
  4324. </tr>
  4325. <tr>
  4326. <td>
  4327. <code>namespaceRegexes</code></br>
  4328. <em>
  4329. []string
  4330. </em>
  4331. </td>
  4332. <td>
  4333. <em>(Optional)</em>
  4334. <p>Choose namespaces by using regex matching</p>
  4335. </td>
  4336. </tr>
  4337. </tbody>
  4338. </table>
  4339. <h3 id="external-secrets.io/v1.ConfigMapReference">ConfigMapReference
  4340. </h3>
  4341. <p>
  4342. (<em>Appears on:</em>
  4343. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  4344. </p>
  4345. <p>
  4346. <p>ConfigMapReference holds the details of a configmap.</p>
  4347. </p>
  4348. <table>
  4349. <thead>
  4350. <tr>
  4351. <th>Field</th>
  4352. <th>Description</th>
  4353. </tr>
  4354. </thead>
  4355. <tbody>
  4356. <tr>
  4357. <td>
  4358. <code>name</code></br>
  4359. <em>
  4360. string
  4361. </em>
  4362. </td>
  4363. <td>
  4364. <p>name of the configmap.</p>
  4365. </td>
  4366. </tr>
  4367. <tr>
  4368. <td>
  4369. <code>namespace</code></br>
  4370. <em>
  4371. string
  4372. </em>
  4373. </td>
  4374. <td>
  4375. <p>namespace in which the configmap exists. If empty, configmap will looked up in local namespace.</p>
  4376. </td>
  4377. </tr>
  4378. <tr>
  4379. <td>
  4380. <code>key</code></br>
  4381. <em>
  4382. string
  4383. </em>
  4384. </td>
  4385. <td>
  4386. <p>key name holding the external account credential config.</p>
  4387. </td>
  4388. </tr>
  4389. </tbody>
  4390. </table>
  4391. <h3 id="external-secrets.io/v1.ConjurAPIKey">ConjurAPIKey
  4392. </h3>
  4393. <p>
  4394. (<em>Appears on:</em>
  4395. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4396. </p>
  4397. <p>
  4398. <p>ConjurAPIKey contains references to a Secret resource that holds
  4399. the Conjur username and API key.</p>
  4400. </p>
  4401. <table>
  4402. <thead>
  4403. <tr>
  4404. <th>Field</th>
  4405. <th>Description</th>
  4406. </tr>
  4407. </thead>
  4408. <tbody>
  4409. <tr>
  4410. <td>
  4411. <code>account</code></br>
  4412. <em>
  4413. string
  4414. </em>
  4415. </td>
  4416. <td>
  4417. <p>Account is the Conjur organization account name.</p>
  4418. </td>
  4419. </tr>
  4420. <tr>
  4421. <td>
  4422. <code>userRef</code></br>
  4423. <em>
  4424. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4425. External Secrets meta/v1.SecretKeySelector
  4426. </a>
  4427. </em>
  4428. </td>
  4429. <td>
  4430. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  4431. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4432. </td>
  4433. </tr>
  4434. <tr>
  4435. <td>
  4436. <code>apiKeyRef</code></br>
  4437. <em>
  4438. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4439. External Secrets meta/v1.SecretKeySelector
  4440. </a>
  4441. </em>
  4442. </td>
  4443. <td>
  4444. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  4445. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4446. </td>
  4447. </tr>
  4448. </tbody>
  4449. </table>
  4450. <h3 id="external-secrets.io/v1.ConjurAuth">ConjurAuth
  4451. </h3>
  4452. <p>
  4453. (<em>Appears on:</em>
  4454. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>)
  4455. </p>
  4456. <p>
  4457. <p>ConjurAuth is the way to provide authentication credentials to the ConjurProvider.</p>
  4458. </p>
  4459. <table>
  4460. <thead>
  4461. <tr>
  4462. <th>Field</th>
  4463. <th>Description</th>
  4464. </tr>
  4465. </thead>
  4466. <tbody>
  4467. <tr>
  4468. <td>
  4469. <code>apikey</code></br>
  4470. <em>
  4471. <a href="#external-secrets.io/v1.ConjurAPIKey">
  4472. ConjurAPIKey
  4473. </a>
  4474. </em>
  4475. </td>
  4476. <td>
  4477. <em>(Optional)</em>
  4478. <p>Authenticates with Conjur using an API key.</p>
  4479. </td>
  4480. </tr>
  4481. <tr>
  4482. <td>
  4483. <code>jwt</code></br>
  4484. <em>
  4485. <a href="#external-secrets.io/v1.ConjurJWT">
  4486. ConjurJWT
  4487. </a>
  4488. </em>
  4489. </td>
  4490. <td>
  4491. <em>(Optional)</em>
  4492. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  4493. </td>
  4494. </tr>
  4495. </tbody>
  4496. </table>
  4497. <h3 id="external-secrets.io/v1.ConjurJWT">ConjurJWT
  4498. </h3>
  4499. <p>
  4500. (<em>Appears on:</em>
  4501. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4502. </p>
  4503. <p>
  4504. <p>ConjurJWT defines the JWT authentication configuration for Conjur provider.</p>
  4505. </p>
  4506. <table>
  4507. <thead>
  4508. <tr>
  4509. <th>Field</th>
  4510. <th>Description</th>
  4511. </tr>
  4512. </thead>
  4513. <tbody>
  4514. <tr>
  4515. <td>
  4516. <code>account</code></br>
  4517. <em>
  4518. string
  4519. </em>
  4520. </td>
  4521. <td>
  4522. <p>Account is the Conjur organization account name.</p>
  4523. </td>
  4524. </tr>
  4525. <tr>
  4526. <td>
  4527. <code>serviceID</code></br>
  4528. <em>
  4529. string
  4530. </em>
  4531. </td>
  4532. <td>
  4533. <p>The conjur authn jwt webservice id</p>
  4534. </td>
  4535. </tr>
  4536. <tr>
  4537. <td>
  4538. <code>hostId</code></br>
  4539. <em>
  4540. string
  4541. </em>
  4542. </td>
  4543. <td>
  4544. <em>(Optional)</em>
  4545. <p>Optional HostID for JWT authentication. This may be used depending
  4546. on how the Conjur JWT authenticator policy is configured.</p>
  4547. </td>
  4548. </tr>
  4549. <tr>
  4550. <td>
  4551. <code>secretRef</code></br>
  4552. <em>
  4553. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4554. External Secrets meta/v1.SecretKeySelector
  4555. </a>
  4556. </em>
  4557. </td>
  4558. <td>
  4559. <em>(Optional)</em>
  4560. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  4561. authenticate with Conjur using the JWT authentication method.</p>
  4562. </td>
  4563. </tr>
  4564. <tr>
  4565. <td>
  4566. <code>serviceAccountRef</code></br>
  4567. <em>
  4568. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  4569. External Secrets meta/v1.ServiceAccountSelector
  4570. </a>
  4571. </em>
  4572. </td>
  4573. <td>
  4574. <em>(Optional)</em>
  4575. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  4576. a token for with the <code>TokenRequest</code> API.</p>
  4577. </td>
  4578. </tr>
  4579. </tbody>
  4580. </table>
  4581. <h3 id="external-secrets.io/v1.ConjurProvider">ConjurProvider
  4582. </h3>
  4583. <p>
  4584. (<em>Appears on:</em>
  4585. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4586. </p>
  4587. <p>
  4588. <p>ConjurProvider provides access to a Conjur provider.</p>
  4589. </p>
  4590. <table>
  4591. <thead>
  4592. <tr>
  4593. <th>Field</th>
  4594. <th>Description</th>
  4595. </tr>
  4596. </thead>
  4597. <tbody>
  4598. <tr>
  4599. <td>
  4600. <code>url</code></br>
  4601. <em>
  4602. string
  4603. </em>
  4604. </td>
  4605. <td>
  4606. <p>URL is the endpoint of the Conjur instance.</p>
  4607. </td>
  4608. </tr>
  4609. <tr>
  4610. <td>
  4611. <code>caBundle</code></br>
  4612. <em>
  4613. string
  4614. </em>
  4615. </td>
  4616. <td>
  4617. <em>(Optional)</em>
  4618. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  4619. </td>
  4620. </tr>
  4621. <tr>
  4622. <td>
  4623. <code>caProvider</code></br>
  4624. <em>
  4625. <a href="#external-secrets.io/v1.CAProvider">
  4626. CAProvider
  4627. </a>
  4628. </em>
  4629. </td>
  4630. <td>
  4631. <em>(Optional)</em>
  4632. <p>Used to provide custom certificate authority (CA) certificates
  4633. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  4634. that contains a PEM-encoded certificate.</p>
  4635. </td>
  4636. </tr>
  4637. <tr>
  4638. <td>
  4639. <code>auth</code></br>
  4640. <em>
  4641. <a href="#external-secrets.io/v1.ConjurAuth">
  4642. ConjurAuth
  4643. </a>
  4644. </em>
  4645. </td>
  4646. <td>
  4647. <p>Defines authentication settings for connecting to Conjur.</p>
  4648. </td>
  4649. </tr>
  4650. </tbody>
  4651. </table>
  4652. <h3 id="external-secrets.io/v1.DVLSAuth">DVLSAuth
  4653. </h3>
  4654. <p>
  4655. (<em>Appears on:</em>
  4656. <a href="#external-secrets.io/v1.DVLSProvider">DVLSProvider</a>)
  4657. </p>
  4658. <p>
  4659. <p>DVLSAuth defines the authentication method for the DVLS provider.</p>
  4660. </p>
  4661. <table>
  4662. <thead>
  4663. <tr>
  4664. <th>Field</th>
  4665. <th>Description</th>
  4666. </tr>
  4667. </thead>
  4668. <tbody>
  4669. <tr>
  4670. <td>
  4671. <code>secretRef</code></br>
  4672. <em>
  4673. <a href="#external-secrets.io/v1.DVLSAuthSecretRef">
  4674. DVLSAuthSecretRef
  4675. </a>
  4676. </em>
  4677. </td>
  4678. <td>
  4679. <p>SecretRef contains the Application ID and Application Secret for authentication.</p>
  4680. </td>
  4681. </tr>
  4682. </tbody>
  4683. </table>
  4684. <h3 id="external-secrets.io/v1.DVLSAuthSecretRef">DVLSAuthSecretRef
  4685. </h3>
  4686. <p>
  4687. (<em>Appears on:</em>
  4688. <a href="#external-secrets.io/v1.DVLSAuth">DVLSAuth</a>)
  4689. </p>
  4690. <p>
  4691. <p>DVLSAuthSecretRef defines the secret references for DVLS authentication credentials.</p>
  4692. </p>
  4693. <table>
  4694. <thead>
  4695. <tr>
  4696. <th>Field</th>
  4697. <th>Description</th>
  4698. </tr>
  4699. </thead>
  4700. <tbody>
  4701. <tr>
  4702. <td>
  4703. <code>appId</code></br>
  4704. <em>
  4705. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4706. External Secrets meta/v1.SecretKeySelector
  4707. </a>
  4708. </em>
  4709. </td>
  4710. <td>
  4711. <p>AppID is the reference to the secret containing the Application ID.</p>
  4712. </td>
  4713. </tr>
  4714. <tr>
  4715. <td>
  4716. <code>appSecret</code></br>
  4717. <em>
  4718. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4719. External Secrets meta/v1.SecretKeySelector
  4720. </a>
  4721. </em>
  4722. </td>
  4723. <td>
  4724. <p>AppSecret is the reference to the secret containing the Application Secret.</p>
  4725. </td>
  4726. </tr>
  4727. </tbody>
  4728. </table>
  4729. <h3 id="external-secrets.io/v1.DVLSProvider">DVLSProvider
  4730. </h3>
  4731. <p>
  4732. (<em>Appears on:</em>
  4733. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4734. </p>
  4735. <p>
  4736. <p>DVLSProvider configures a store to sync secrets using Devolutions Server.</p>
  4737. </p>
  4738. <table>
  4739. <thead>
  4740. <tr>
  4741. <th>Field</th>
  4742. <th>Description</th>
  4743. </tr>
  4744. </thead>
  4745. <tbody>
  4746. <tr>
  4747. <td>
  4748. <code>serverUrl</code></br>
  4749. <em>
  4750. string
  4751. </em>
  4752. </td>
  4753. <td>
  4754. <p>ServerURL is the DVLS instance URL (e.g., <a href="https://dvls.example.com">https://dvls.example.com</a>).</p>
  4755. </td>
  4756. </tr>
  4757. <tr>
  4758. <td>
  4759. <code>vault</code></br>
  4760. <em>
  4761. string
  4762. </em>
  4763. </td>
  4764. <td>
  4765. <em>(Optional)</em>
  4766. <p>Vault is the name or UUID of the vault to fetch secrets from.
  4767. When omitted, the vault must be specified in the secret key using the legacy format &ldquo;<vault-id>/<entry-id>&rdquo;.</p>
  4768. </td>
  4769. </tr>
  4770. <tr>
  4771. <td>
  4772. <code>insecure</code></br>
  4773. <em>
  4774. bool
  4775. </em>
  4776. </td>
  4777. <td>
  4778. <em>(Optional)</em>
  4779. <p>Insecure allows connecting to DVLS over plain HTTP.
  4780. This is NOT RECOMMENDED for production use.
  4781. Set to true only if you understand the security implications.</p>
  4782. </td>
  4783. </tr>
  4784. <tr>
  4785. <td>
  4786. <code>auth</code></br>
  4787. <em>
  4788. <a href="#external-secrets.io/v1.DVLSAuth">
  4789. DVLSAuth
  4790. </a>
  4791. </em>
  4792. </td>
  4793. <td>
  4794. <p>Auth defines the authentication method to use.</p>
  4795. </td>
  4796. </tr>
  4797. </tbody>
  4798. </table>
  4799. <h3 id="external-secrets.io/v1.DelineaProvider">DelineaProvider
  4800. </h3>
  4801. <p>
  4802. (<em>Appears on:</em>
  4803. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4804. </p>
  4805. <p>
  4806. <p>DelineaProvider provides access to Delinea secrets vault Server.
  4807. See: <a href="https://github.com/DelineaXPM/dsv-sdk-go/blob/main/vault/vault.go">https://github.com/DelineaXPM/dsv-sdk-go/blob/main/vault/vault.go</a>.</p>
  4808. </p>
  4809. <table>
  4810. <thead>
  4811. <tr>
  4812. <th>Field</th>
  4813. <th>Description</th>
  4814. </tr>
  4815. </thead>
  4816. <tbody>
  4817. <tr>
  4818. <td>
  4819. <code>clientId</code></br>
  4820. <em>
  4821. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4822. DelineaProviderSecretRef
  4823. </a>
  4824. </em>
  4825. </td>
  4826. <td>
  4827. <p>ClientID is the non-secret part of the credential.</p>
  4828. </td>
  4829. </tr>
  4830. <tr>
  4831. <td>
  4832. <code>clientSecret</code></br>
  4833. <em>
  4834. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4835. DelineaProviderSecretRef
  4836. </a>
  4837. </em>
  4838. </td>
  4839. <td>
  4840. <p>ClientSecret is the secret part of the credential.</p>
  4841. </td>
  4842. </tr>
  4843. <tr>
  4844. <td>
  4845. <code>tenant</code></br>
  4846. <em>
  4847. string
  4848. </em>
  4849. </td>
  4850. <td>
  4851. <p>Tenant is the chosen hostname / site name.</p>
  4852. </td>
  4853. </tr>
  4854. <tr>
  4855. <td>
  4856. <code>urlTemplate</code></br>
  4857. <em>
  4858. string
  4859. </em>
  4860. </td>
  4861. <td>
  4862. <em>(Optional)</em>
  4863. <p>URLTemplate
  4864. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  4865. </td>
  4866. </tr>
  4867. <tr>
  4868. <td>
  4869. <code>tld</code></br>
  4870. <em>
  4871. string
  4872. </em>
  4873. </td>
  4874. <td>
  4875. <em>(Optional)</em>
  4876. <p>TLD is based on the server location that was chosen during provisioning.
  4877. If unset, defaults to &ldquo;com&rdquo;.</p>
  4878. </td>
  4879. </tr>
  4880. </tbody>
  4881. </table>
  4882. <h3 id="external-secrets.io/v1.DelineaProviderSecretRef">DelineaProviderSecretRef
  4883. </h3>
  4884. <p>
  4885. (<em>Appears on:</em>
  4886. <a href="#external-secrets.io/v1.DelineaProvider">DelineaProvider</a>)
  4887. </p>
  4888. <p>
  4889. <p>DelineaProviderSecretRef is a secret reference containing either a direct value or a reference to a secret key.</p>
  4890. </p>
  4891. <table>
  4892. <thead>
  4893. <tr>
  4894. <th>Field</th>
  4895. <th>Description</th>
  4896. </tr>
  4897. </thead>
  4898. <tbody>
  4899. <tr>
  4900. <td>
  4901. <code>value</code></br>
  4902. <em>
  4903. string
  4904. </em>
  4905. </td>
  4906. <td>
  4907. <em>(Optional)</em>
  4908. <p>Value can be specified directly to set a value without using a secret.</p>
  4909. </td>
  4910. </tr>
  4911. <tr>
  4912. <td>
  4913. <code>secretRef</code></br>
  4914. <em>
  4915. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4916. External Secrets meta/v1.SecretKeySelector
  4917. </a>
  4918. </em>
  4919. </td>
  4920. <td>
  4921. <em>(Optional)</em>
  4922. <p>SecretRef references a key in a secret that will be used as value.</p>
  4923. </td>
  4924. </tr>
  4925. </tbody>
  4926. </table>
  4927. <h3 id="external-secrets.io/v1.DopplerAuth">DopplerAuth
  4928. </h3>
  4929. <p>
  4930. (<em>Appears on:</em>
  4931. <a href="#external-secrets.io/v1.DopplerProvider">DopplerProvider</a>)
  4932. </p>
  4933. <p>
  4934. <p>DopplerAuth configures authentication with the Doppler API.
  4935. Exactly one of secretRef or oidcConfig must be specified.</p>
  4936. </p>
  4937. <table>
  4938. <thead>
  4939. <tr>
  4940. <th>Field</th>
  4941. <th>Description</th>
  4942. </tr>
  4943. </thead>
  4944. <tbody>
  4945. <tr>
  4946. <td>
  4947. <code>secretRef</code></br>
  4948. <em>
  4949. <a href="#external-secrets.io/v1.DopplerAuthSecretRef">
  4950. DopplerAuthSecretRef
  4951. </a>
  4952. </em>
  4953. </td>
  4954. <td>
  4955. <em>(Optional)</em>
  4956. <p>SecretRef authenticates using a Doppler service token stored in a Kubernetes Secret.</p>
  4957. </td>
  4958. </tr>
  4959. <tr>
  4960. <td>
  4961. <code>oidcConfig</code></br>
  4962. <em>
  4963. <a href="#external-secrets.io/v1.DopplerOIDCAuth">
  4964. DopplerOIDCAuth
  4965. </a>
  4966. </em>
  4967. </td>
  4968. <td>
  4969. <em>(Optional)</em>
  4970. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  4971. </td>
  4972. </tr>
  4973. </tbody>
  4974. </table>
  4975. <h3 id="external-secrets.io/v1.DopplerAuthSecretRef">DopplerAuthSecretRef
  4976. </h3>
  4977. <p>
  4978. (<em>Appears on:</em>
  4979. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  4980. </p>
  4981. <p>
  4982. <p>DopplerAuthSecretRef contains the secret reference for accessing the Doppler API.</p>
  4983. </p>
  4984. <table>
  4985. <thead>
  4986. <tr>
  4987. <th>Field</th>
  4988. <th>Description</th>
  4989. </tr>
  4990. </thead>
  4991. <tbody>
  4992. <tr>
  4993. <td>
  4994. <code>dopplerToken</code></br>
  4995. <em>
  4996. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4997. External Secrets meta/v1.SecretKeySelector
  4998. </a>
  4999. </em>
  5000. </td>
  5001. <td>
  5002. <p>The DopplerToken is used for authentication.
  5003. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  5004. The Key attribute defaults to dopplerToken if not specified.</p>
  5005. </td>
  5006. </tr>
  5007. </tbody>
  5008. </table>
  5009. <h3 id="external-secrets.io/v1.DopplerOIDCAuth">DopplerOIDCAuth
  5010. </h3>
  5011. <p>
  5012. (<em>Appears on:</em>
  5013. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  5014. </p>
  5015. <p>
  5016. <p>DopplerOIDCAuth configures OIDC authentication with Doppler using Kubernetes ServiceAccount tokens.</p>
  5017. </p>
  5018. <table>
  5019. <thead>
  5020. <tr>
  5021. <th>Field</th>
  5022. <th>Description</th>
  5023. </tr>
  5024. </thead>
  5025. <tbody>
  5026. <tr>
  5027. <td>
  5028. <code>identity</code></br>
  5029. <em>
  5030. string
  5031. </em>
  5032. </td>
  5033. <td>
  5034. <p>Identity is the Doppler Service Account Identity ID configured for OIDC authentication.</p>
  5035. </td>
  5036. </tr>
  5037. <tr>
  5038. <td>
  5039. <code>serviceAccountRef</code></br>
  5040. <em>
  5041. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  5042. External Secrets meta/v1.ServiceAccountSelector
  5043. </a>
  5044. </em>
  5045. </td>
  5046. <td>
  5047. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  5048. </td>
  5049. </tr>
  5050. <tr>
  5051. <td>
  5052. <code>expirationSeconds</code></br>
  5053. <em>
  5054. int64
  5055. </em>
  5056. </td>
  5057. <td>
  5058. <em>(Optional)</em>
  5059. <p>ExpirationSeconds sets the ServiceAccount token validity duration.
  5060. Defaults to 10 minutes.</p>
  5061. </td>
  5062. </tr>
  5063. </tbody>
  5064. </table>
  5065. <h3 id="external-secrets.io/v1.DopplerProvider">DopplerProvider
  5066. </h3>
  5067. <p>
  5068. (<em>Appears on:</em>
  5069. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  5070. </p>
  5071. <p>
  5072. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  5073. Project and Config are required if not using a Service Token.</p>
  5074. </p>
  5075. <table>
  5076. <thead>
  5077. <tr>
  5078. <th>Field</th>
  5079. <th>Description</th>
  5080. </tr>
  5081. </thead>
  5082. <tbody>
  5083. <tr>
  5084. <td>
  5085. <code>auth</code></br>
  5086. <em>
  5087. <a href="#external-secrets.io/v1.DopplerAuth">
  5088. DopplerAuth
  5089. </a>
  5090. </em>
  5091. </td>
  5092. <td>
  5093. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  5094. </td>
  5095. </tr>
  5096. <tr>
  5097. <td>
  5098. <code>project</code></br>
  5099. <em>
  5100. string
  5101. </em>
  5102. </td>
  5103. <td>
  5104. <em>(Optional)</em>
  5105. <p>Doppler project (required if not using a Service Token)</p>
  5106. </td>
  5107. </tr>
  5108. <tr>
  5109. <td>
  5110. <code>config</code></br>
  5111. <em>
  5112. string
  5113. </em>
  5114. </td>
  5115. <td>
  5116. <em>(Optional)</em>
  5117. <p>Doppler config (required if not using a Service Token)</p>
  5118. </td>
  5119. </tr>
  5120. <tr>
  5121. <td>
  5122. <code>nameTransformer</code></br>
  5123. <em>
  5124. string
  5125. </em>
  5126. </td>
  5127. <td>
  5128. <em>(Optional)</em>
  5129. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  5130. </td>
  5131. </tr>
  5132. <tr>
  5133. <td>
  5134. <code>format</code></br>
  5135. <em>
  5136. string
  5137. </em>
  5138. </td>
  5139. <td>
  5140. <em>(Optional)</em>
  5141. <p>Format enables the downloading of secrets as a file (string)</p>
  5142. </td>
  5143. </tr>
  5144. </tbody>
  5145. </table>
  5146. <h3 id="external-secrets.io/v1.ExternalSecret">ExternalSecret
  5147. </h3>
  5148. <p>
  5149. <p>ExternalSecret is the Schema for the external-secrets API.
  5150. It defines how to fetch data from external APIs and make it available as Kubernetes Secrets.</p>
  5151. </p>
  5152. <table>
  5153. <thead>
  5154. <tr>
  5155. <th>Field</th>
  5156. <th>Description</th>
  5157. </tr>
  5158. </thead>
  5159. <tbody>
  5160. <tr>
  5161. <td>
  5162. <code>metadata</code></br>
  5163. <em>
  5164. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  5165. Kubernetes meta/v1.ObjectMeta
  5166. </a>
  5167. </em>
  5168. </td>
  5169. <td>
  5170. Refer to the Kubernetes API documentation for the fields of the
  5171. <code>metadata</code> field.
  5172. </td>
  5173. </tr>
  5174. <tr>
  5175. <td>
  5176. <code>spec</code></br>
  5177. <em>
  5178. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  5179. ExternalSecretSpec
  5180. </a>
  5181. </em>
  5182. </td>
  5183. <td>
  5184. <br/>
  5185. <br/>
  5186. <table>
  5187. <tr>
  5188. <td>
  5189. <code>secretStoreRef</code></br>
  5190. <em>
  5191. <a href="#external-secrets.io/v1.SecretStoreRef">
  5192. SecretStoreRef
  5193. </a>
  5194. </em>
  5195. </td>
  5196. <td>
  5197. <em>(Optional)</em>
  5198. </td>
  5199. </tr>
  5200. <tr>
  5201. <td>
  5202. <code>target</code></br>
  5203. <em>
  5204. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  5205. ExternalSecretTarget
  5206. </a>
  5207. </em>
  5208. </td>
  5209. <td>
  5210. <em>(Optional)</em>
  5211. </td>
  5212. </tr>
  5213. <tr>
  5214. <td>
  5215. <code>refreshPolicy</code></br>
  5216. <em>
  5217. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  5218. ExternalSecretRefreshPolicy
  5219. </a>
  5220. </em>
  5221. </td>
  5222. <td>
  5223. <em>(Optional)</em>
  5224. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  5225. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  5226. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  5227. No periodic updates occur if refreshInterval is 0.
  5228. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  5229. </td>
  5230. </tr>
  5231. <tr>
  5232. <td>
  5233. <code>refreshInterval</code></br>
  5234. <em>
  5235. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  5236. Kubernetes meta/v1.Duration
  5237. </a>
  5238. </em>
  5239. </td>
  5240. <td>
  5241. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  5242. specified as Golang Duration strings.
  5243. Valid time units are &ldquo;ns&rdquo;, &ldquo;us&rdquo; (or &ldquo;µs&rdquo;), &ldquo;ms&rdquo;, &ldquo;s&rdquo;, &ldquo;m&rdquo;, &ldquo;h&rdquo;
  5244. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  5245. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  5246. </td>
  5247. </tr>
  5248. <tr>
  5249. <td>
  5250. <code>syncWindows</code></br>
  5251. <em>
  5252. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">
  5253. ExternalSecretSyncWindows
  5254. </a>
  5255. </em>
  5256. </td>
  5257. <td>
  5258. <em>(Optional)</em>
  5259. <p>SyncWindows optionally restricts when periodic refreshes may occur.
  5260. Evaluated in UTC, only for Periodic refresh policy (or when refreshPolicy is unset).</p>
  5261. </td>
  5262. </tr>
  5263. <tr>
  5264. <td>
  5265. <code>data</code></br>
  5266. <em>
  5267. <a href="#external-secrets.io/v1.ExternalSecretData">
  5268. []ExternalSecretData
  5269. </a>
  5270. </em>
  5271. </td>
  5272. <td>
  5273. <em>(Optional)</em>
  5274. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  5275. </td>
  5276. </tr>
  5277. <tr>
  5278. <td>
  5279. <code>dataFrom</code></br>
  5280. <em>
  5281. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  5282. []ExternalSecretDataFromRemoteRef
  5283. </a>
  5284. </em>
  5285. </td>
  5286. <td>
  5287. <em>(Optional)</em>
  5288. <p>DataFrom is used to fetch all properties from a specific Provider data
  5289. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  5290. </td>
  5291. </tr>
  5292. </table>
  5293. </td>
  5294. </tr>
  5295. <tr>
  5296. <td>
  5297. <code>status</code></br>
  5298. <em>
  5299. <a href="#external-secrets.io/v1.ExternalSecretStatus">
  5300. ExternalSecretStatus
  5301. </a>
  5302. </em>
  5303. </td>
  5304. <td>
  5305. </td>
  5306. </tr>
  5307. </tbody>
  5308. </table>
  5309. <h3 id="external-secrets.io/v1.ExternalSecretConditionType">ExternalSecretConditionType
  5310. (<code>string</code> alias)</p></h3>
  5311. <p>
  5312. (<em>Appears on:</em>
  5313. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  5314. </p>
  5315. <p>
  5316. <p>ExternalSecretConditionType defines a value type for ExternalSecret conditions.</p>
  5317. </p>
  5318. <table>
  5319. <thead>
  5320. <tr>
  5321. <th>Value</th>
  5322. <th>Description</th>
  5323. </tr>
  5324. </thead>
  5325. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  5326. <td><p>ExternalSecretDeleted indicates that the external secret has been deleted.</p>
  5327. </td>
  5328. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  5329. <td><p>ExternalSecretReady indicates that the external secret is ready and synced.</p>
  5330. </td>
  5331. </tr></tbody>
  5332. </table>
  5333. <h3 id="external-secrets.io/v1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  5334. (<code>string</code> alias)</p></h3>
  5335. <p>
  5336. (<em>Appears on:</em>
  5337. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5338. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5339. </p>
  5340. <p>
  5341. <p>ExternalSecretConversionStrategy defines strategies for converting secret values.</p>
  5342. </p>
  5343. <table>
  5344. <thead>
  5345. <tr>
  5346. <th>Value</th>
  5347. <th>Description</th>
  5348. </tr>
  5349. </thead>
  5350. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  5351. <td><p>ExternalSecretConversionDefault specifies the default conversion strategy.</p>
  5352. </td>
  5353. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  5354. <td><p>ExternalSecretConversionUnicode specifies that values should be treated as Unicode.</p>
  5355. </td>
  5356. </tr></tbody>
  5357. </table>
  5358. <h3 id="external-secrets.io/v1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  5359. (<code>string</code> alias)</p></h3>
  5360. <p>
  5361. (<em>Appears on:</em>
  5362. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5363. </p>
  5364. <p>
  5365. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  5366. </p>
  5367. <table>
  5368. <thead>
  5369. <tr>
  5370. <th>Value</th>
  5371. <th>Description</th>
  5372. </tr>
  5373. </thead>
  5374. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  5375. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  5376. </td>
  5377. </tr><tr><td><p>&#34;None&#34;</p></td>
  5378. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  5379. </td>
  5380. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  5381. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  5382. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  5383. </td>
  5384. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  5385. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  5386. </td>
  5387. </tr></tbody>
  5388. </table>
  5389. <h3 id="external-secrets.io/v1.ExternalSecretData">ExternalSecretData
  5390. </h3>
  5391. <p>
  5392. (<em>Appears on:</em>
  5393. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5394. </p>
  5395. <p>
  5396. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  5397. </p>
  5398. <table>
  5399. <thead>
  5400. <tr>
  5401. <th>Field</th>
  5402. <th>Description</th>
  5403. </tr>
  5404. </thead>
  5405. <tbody>
  5406. <tr>
  5407. <td>
  5408. <code>secretKey</code></br>
  5409. <em>
  5410. string
  5411. </em>
  5412. </td>
  5413. <td>
  5414. <p>The key in the Kubernetes Secret to store the value.</p>
  5415. </td>
  5416. </tr>
  5417. <tr>
  5418. <td>
  5419. <code>remoteRef</code></br>
  5420. <em>
  5421. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5422. ExternalSecretDataRemoteRef
  5423. </a>
  5424. </em>
  5425. </td>
  5426. <td>
  5427. <p>RemoteRef points to the remote secret and defines
  5428. which secret (version/property/..) to fetch.</p>
  5429. </td>
  5430. </tr>
  5431. <tr>
  5432. <td>
  5433. <code>sourceRef</code></br>
  5434. <em>
  5435. <a href="#external-secrets.io/v1.StoreSourceRef">
  5436. StoreSourceRef
  5437. </a>
  5438. </em>
  5439. </td>
  5440. <td>
  5441. <p>SourceRef allows you to override the source
  5442. from which the value will be pulled.</p>
  5443. </td>
  5444. </tr>
  5445. </tbody>
  5446. </table>
  5447. <h3 id="external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  5448. </h3>
  5449. <p>
  5450. (<em>Appears on:</em>
  5451. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5452. </p>
  5453. <p>
  5454. <p>ExternalSecretDataFromRemoteRef defines the connection between the Kubernetes Secret keys and the Provider data
  5455. when using DataFrom to fetch multiple values from a Provider.</p>
  5456. </p>
  5457. <table>
  5458. <thead>
  5459. <tr>
  5460. <th>Field</th>
  5461. <th>Description</th>
  5462. </tr>
  5463. </thead>
  5464. <tbody>
  5465. <tr>
  5466. <td>
  5467. <code>extract</code></br>
  5468. <em>
  5469. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5470. ExternalSecretDataRemoteRef
  5471. </a>
  5472. </em>
  5473. </td>
  5474. <td>
  5475. <em>(Optional)</em>
  5476. <p>Used to extract multiple key/value pairs from one secret
  5477. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5478. </td>
  5479. </tr>
  5480. <tr>
  5481. <td>
  5482. <code>find</code></br>
  5483. <em>
  5484. <a href="#external-secrets.io/v1.ExternalSecretFind">
  5485. ExternalSecretFind
  5486. </a>
  5487. </em>
  5488. </td>
  5489. <td>
  5490. <em>(Optional)</em>
  5491. <p>Used to find secrets based on tags or regular expressions
  5492. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5493. </td>
  5494. </tr>
  5495. <tr>
  5496. <td>
  5497. <code>rewrite</code></br>
  5498. <em>
  5499. <a href="#external-secrets.io/v1.ExternalSecretRewrite">
  5500. []ExternalSecretRewrite
  5501. </a>
  5502. </em>
  5503. </td>
  5504. <td>
  5505. <em>(Optional)</em>
  5506. <p>Used to rewrite secret Keys after getting them from the secret Provider
  5507. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  5508. </td>
  5509. </tr>
  5510. <tr>
  5511. <td>
  5512. <code>sourceRef</code></br>
  5513. <em>
  5514. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">
  5515. StoreGeneratorSourceRef
  5516. </a>
  5517. </em>
  5518. </td>
  5519. <td>
  5520. <p>SourceRef points to a store or generator
  5521. which contains secret values ready to use.
  5522. Use this in combination with Extract or Find pull values out of
  5523. a specific SecretStore.
  5524. When sourceRef points to a generator Extract or Find is not supported.
  5525. The generator returns a static map of values</p>
  5526. </td>
  5527. </tr>
  5528. </tbody>
  5529. </table>
  5530. <h3 id="external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  5531. </h3>
  5532. <p>
  5533. (<em>Appears on:</em>
  5534. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>,
  5535. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5536. </p>
  5537. <p>
  5538. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  5539. </p>
  5540. <table>
  5541. <thead>
  5542. <tr>
  5543. <th>Field</th>
  5544. <th>Description</th>
  5545. </tr>
  5546. </thead>
  5547. <tbody>
  5548. <tr>
  5549. <td>
  5550. <code>key</code></br>
  5551. <em>
  5552. string
  5553. </em>
  5554. </td>
  5555. <td>
  5556. <p>Key is the key used in the Provider, mandatory</p>
  5557. </td>
  5558. </tr>
  5559. <tr>
  5560. <td>
  5561. <code>metadataPolicy</code></br>
  5562. <em>
  5563. <a href="#external-secrets.io/v1.ExternalSecretMetadataPolicy">
  5564. ExternalSecretMetadataPolicy
  5565. </a>
  5566. </em>
  5567. </td>
  5568. <td>
  5569. <em>(Optional)</em>
  5570. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  5571. </td>
  5572. </tr>
  5573. <tr>
  5574. <td>
  5575. <code>property</code></br>
  5576. <em>
  5577. string
  5578. </em>
  5579. </td>
  5580. <td>
  5581. <em>(Optional)</em>
  5582. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  5583. </td>
  5584. </tr>
  5585. <tr>
  5586. <td>
  5587. <code>version</code></br>
  5588. <em>
  5589. string
  5590. </em>
  5591. </td>
  5592. <td>
  5593. <em>(Optional)</em>
  5594. <p>Used to select a specific version of the Provider value, if supported</p>
  5595. </td>
  5596. </tr>
  5597. <tr>
  5598. <td>
  5599. <code>conversionStrategy</code></br>
  5600. <em>
  5601. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5602. ExternalSecretConversionStrategy
  5603. </a>
  5604. </em>
  5605. </td>
  5606. <td>
  5607. <em>(Optional)</em>
  5608. <p>Used to define a conversion Strategy</p>
  5609. </td>
  5610. </tr>
  5611. <tr>
  5612. <td>
  5613. <code>decodingStrategy</code></br>
  5614. <em>
  5615. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5616. ExternalSecretDecodingStrategy
  5617. </a>
  5618. </em>
  5619. </td>
  5620. <td>
  5621. <em>(Optional)</em>
  5622. <p>Used to define a decoding Strategy</p>
  5623. </td>
  5624. </tr>
  5625. <tr>
  5626. <td>
  5627. <code>nullBytePolicy</code></br>
  5628. <em>
  5629. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  5630. ExternalSecretNullBytePolicy
  5631. </a>
  5632. </em>
  5633. </td>
  5634. <td>
  5635. <em>(Optional)</em>
  5636. <p>Controls how ESO handles fetched secret data containing NUL bytes for this source.</p>
  5637. </td>
  5638. </tr>
  5639. </tbody>
  5640. </table>
  5641. <h3 id="external-secrets.io/v1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  5642. (<code>string</code> alias)</p></h3>
  5643. <p>
  5644. (<em>Appears on:</em>
  5645. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5646. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>,
  5647. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  5648. </p>
  5649. <p>
  5650. <p>ExternalSecretDecodingStrategy defines strategies for decoding secret values.</p>
  5651. </p>
  5652. <table>
  5653. <thead>
  5654. <tr>
  5655. <th>Value</th>
  5656. <th>Description</th>
  5657. </tr>
  5658. </thead>
  5659. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  5660. <td><p>ExternalSecretDecodeAuto specifies automatic detection of the decoding method.</p>
  5661. </td>
  5662. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  5663. <td><p>ExternalSecretDecodeBase64 specifies that values should be decoded using Base64.</p>
  5664. </td>
  5665. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  5666. <td><p>ExternalSecretDecodeBase64URL specifies that values should be decoded using Base64URL.</p>
  5667. </td>
  5668. </tr><tr><td><p>&#34;None&#34;</p></td>
  5669. <td><p>ExternalSecretDecodeNone specifies that no decoding should be performed.</p>
  5670. </td>
  5671. </tr></tbody>
  5672. </table>
  5673. <h3 id="external-secrets.io/v1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  5674. (<code>string</code> alias)</p></h3>
  5675. <p>
  5676. (<em>Appears on:</em>
  5677. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5678. </p>
  5679. <p>
  5680. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  5681. </p>
  5682. <table>
  5683. <thead>
  5684. <tr>
  5685. <th>Value</th>
  5686. <th>Description</th>
  5687. </tr>
  5688. </thead>
  5689. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  5690. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  5691. If a secret gets deleted on the provider side and is not accessible
  5692. anymore this is not considered an error and the ExternalSecret
  5693. does not go into SecretSyncedError status.</p>
  5694. </td>
  5695. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  5696. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  5697. If a secret gets deleted on the provider side and is not accessible
  5698. anymore this is not considered an error and the ExternalSecret
  5699. does not go into SecretSyncedError status.</p>
  5700. </td>
  5701. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  5702. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  5703. If a provider secret does not exist the ExternalSecret gets into the
  5704. SecretSyncedError status.</p>
  5705. </td>
  5706. </tr></tbody>
  5707. </table>
  5708. <h3 id="external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind
  5709. </h3>
  5710. <p>
  5711. (<em>Appears on:</em>
  5712. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5713. </p>
  5714. <p>
  5715. <p>ExternalSecretFind defines configuration for finding secrets in the provider.</p>
  5716. </p>
  5717. <table>
  5718. <thead>
  5719. <tr>
  5720. <th>Field</th>
  5721. <th>Description</th>
  5722. </tr>
  5723. </thead>
  5724. <tbody>
  5725. <tr>
  5726. <td>
  5727. <code>path</code></br>
  5728. <em>
  5729. string
  5730. </em>
  5731. </td>
  5732. <td>
  5733. <em>(Optional)</em>
  5734. <p>A root path to start the find operations.</p>
  5735. </td>
  5736. </tr>
  5737. <tr>
  5738. <td>
  5739. <code>name</code></br>
  5740. <em>
  5741. <a href="#external-secrets.io/v1.FindName">
  5742. FindName
  5743. </a>
  5744. </em>
  5745. </td>
  5746. <td>
  5747. <em>(Optional)</em>
  5748. <p>Finds secrets based on the name.</p>
  5749. </td>
  5750. </tr>
  5751. <tr>
  5752. <td>
  5753. <code>tags</code></br>
  5754. <em>
  5755. map[string]string
  5756. </em>
  5757. </td>
  5758. <td>
  5759. <em>(Optional)</em>
  5760. <p>Find secrets based on tags.</p>
  5761. </td>
  5762. </tr>
  5763. <tr>
  5764. <td>
  5765. <code>conversionStrategy</code></br>
  5766. <em>
  5767. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5768. ExternalSecretConversionStrategy
  5769. </a>
  5770. </em>
  5771. </td>
  5772. <td>
  5773. <em>(Optional)</em>
  5774. <p>Used to define a conversion Strategy</p>
  5775. </td>
  5776. </tr>
  5777. <tr>
  5778. <td>
  5779. <code>decodingStrategy</code></br>
  5780. <em>
  5781. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5782. ExternalSecretDecodingStrategy
  5783. </a>
  5784. </em>
  5785. </td>
  5786. <td>
  5787. <em>(Optional)</em>
  5788. <p>Used to define a decoding Strategy</p>
  5789. </td>
  5790. </tr>
  5791. <tr>
  5792. <td>
  5793. <code>nullBytePolicy</code></br>
  5794. <em>
  5795. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  5796. ExternalSecretNullBytePolicy
  5797. </a>
  5798. </em>
  5799. </td>
  5800. <td>
  5801. <em>(Optional)</em>
  5802. <p>Controls how ESO handles fetched secret data containing NUL bytes for this find source.</p>
  5803. </td>
  5804. </tr>
  5805. </tbody>
  5806. </table>
  5807. <h3 id="external-secrets.io/v1.ExternalSecretMetadata">ExternalSecretMetadata
  5808. </h3>
  5809. <p>
  5810. (<em>Appears on:</em>
  5811. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  5812. </p>
  5813. <p>
  5814. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  5815. </p>
  5816. <table>
  5817. <thead>
  5818. <tr>
  5819. <th>Field</th>
  5820. <th>Description</th>
  5821. </tr>
  5822. </thead>
  5823. <tbody>
  5824. <tr>
  5825. <td>
  5826. <code>annotations</code></br>
  5827. <em>
  5828. map[string]string
  5829. </em>
  5830. </td>
  5831. <td>
  5832. <em>(Optional)</em>
  5833. </td>
  5834. </tr>
  5835. <tr>
  5836. <td>
  5837. <code>labels</code></br>
  5838. <em>
  5839. map[string]string
  5840. </em>
  5841. </td>
  5842. <td>
  5843. <em>(Optional)</em>
  5844. </td>
  5845. </tr>
  5846. </tbody>
  5847. </table>
  5848. <h3 id="external-secrets.io/v1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  5849. (<code>string</code> alias)</p></h3>
  5850. <p>
  5851. (<em>Appears on:</em>
  5852. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  5853. </p>
  5854. <p>
  5855. <p>ExternalSecretMetadataPolicy defines policies for fetching metadata from provider secrets.</p>
  5856. </p>
  5857. <table>
  5858. <thead>
  5859. <tr>
  5860. <th>Value</th>
  5861. <th>Description</th>
  5862. </tr>
  5863. </thead>
  5864. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  5865. <td><p>ExternalSecretMetadataPolicyFetch specifies that metadata should be fetched from the provider.</p>
  5866. </td>
  5867. </tr><tr><td><p>&#34;None&#34;</p></td>
  5868. <td><p>ExternalSecretMetadataPolicyNone specifies that no metadata should be fetched from the provider.</p>
  5869. </td>
  5870. </tr></tbody>
  5871. </table>
  5872. <h3 id="external-secrets.io/v1.ExternalSecretNullBytePolicy">ExternalSecretNullBytePolicy
  5873. (<code>string</code> alias)</p></h3>
  5874. <p>
  5875. (<em>Appears on:</em>
  5876. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5877. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5878. </p>
  5879. <p>
  5880. <p>ExternalSecretNullBytePolicy defines how fetched secret data containing NUL bytes should be handled.</p>
  5881. </p>
  5882. <table>
  5883. <thead>
  5884. <tr>
  5885. <th>Value</th>
  5886. <th>Description</th>
  5887. </tr>
  5888. </thead>
  5889. <tbody><tr><td><p>&#34;Fail&#34;</p></td>
  5890. <td><p>ExternalSecretNullBytePolicyFail fails reconciliation if fetched secret data contains NUL bytes.</p>
  5891. </td>
  5892. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  5893. <td><p>ExternalSecretNullBytePolicyIgnore allows fetched secret data to contain NUL bytes.</p>
  5894. </td>
  5895. </tr></tbody>
  5896. </table>
  5897. <h3 id="external-secrets.io/v1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  5898. (<code>string</code> alias)</p></h3>
  5899. <p>
  5900. (<em>Appears on:</em>
  5901. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5902. </p>
  5903. <p>
  5904. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  5905. </p>
  5906. <table>
  5907. <thead>
  5908. <tr>
  5909. <th>Value</th>
  5910. <th>Description</th>
  5911. </tr>
  5912. </thead>
  5913. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  5914. <td><p>RefreshPolicyCreatedOnce creates the Secret once and does not update it thereafter.</p>
  5915. </td>
  5916. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  5917. <td><p>RefreshPolicyOnChange only synchronizes when the ExternalSecret&rsquo;s metadata or spec changes.</p>
  5918. </td>
  5919. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  5920. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the provider at regular intervals.</p>
  5921. </td>
  5922. </tr></tbody>
  5923. </table>
  5924. <h3 id="external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite
  5925. </h3>
  5926. <p>
  5927. (<em>Appears on:</em>
  5928. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5929. </p>
  5930. <p>
  5931. <p>ExternalSecretRewrite defines how to rewrite secret data values before they are written to the Secret.</p>
  5932. </p>
  5933. <table>
  5934. <thead>
  5935. <tr>
  5936. <th>Field</th>
  5937. <th>Description</th>
  5938. </tr>
  5939. </thead>
  5940. <tbody>
  5941. <tr>
  5942. <td>
  5943. <code>merge</code></br>
  5944. <em>
  5945. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">
  5946. ExternalSecretRewriteMerge
  5947. </a>
  5948. </em>
  5949. </td>
  5950. <td>
  5951. <em>(Optional)</em>
  5952. <p>Used to merge key/values in one single Secret
  5953. The resulting key will contain all values from the specified secrets</p>
  5954. </td>
  5955. </tr>
  5956. <tr>
  5957. <td>
  5958. <code>regexp</code></br>
  5959. <em>
  5960. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  5961. ExternalSecretRewriteRegexp
  5962. </a>
  5963. </em>
  5964. </td>
  5965. <td>
  5966. <em>(Optional)</em>
  5967. <p>Used to rewrite with regular expressions.
  5968. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  5969. </td>
  5970. </tr>
  5971. <tr>
  5972. <td>
  5973. <code>transform</code></br>
  5974. <em>
  5975. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  5976. ExternalSecretRewriteTransform
  5977. </a>
  5978. </em>
  5979. </td>
  5980. <td>
  5981. <em>(Optional)</em>
  5982. <p>Used to apply string transformation on the secrets.
  5983. The resulting key will be the output of the template applied by the operation.</p>
  5984. </td>
  5985. </tr>
  5986. </tbody>
  5987. </table>
  5988. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge
  5989. </h3>
  5990. <p>
  5991. (<em>Appears on:</em>
  5992. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  5993. </p>
  5994. <p>
  5995. <p>ExternalSecretRewriteMerge defines configuration for merging secret values.</p>
  5996. </p>
  5997. <table>
  5998. <thead>
  5999. <tr>
  6000. <th>Field</th>
  6001. <th>Description</th>
  6002. </tr>
  6003. </thead>
  6004. <tbody>
  6005. <tr>
  6006. <td>
  6007. <code>into</code></br>
  6008. <em>
  6009. string
  6010. </em>
  6011. </td>
  6012. <td>
  6013. <em>(Optional)</em>
  6014. <p>Used to define the target key of the merge operation.
  6015. Required if strategy is JSON. Ignored otherwise.</p>
  6016. </td>
  6017. </tr>
  6018. <tr>
  6019. <td>
  6020. <code>priority</code></br>
  6021. <em>
  6022. []string
  6023. </em>
  6024. </td>
  6025. <td>
  6026. <em>(Optional)</em>
  6027. <p>Used to define key priority in conflict resolution.</p>
  6028. </td>
  6029. </tr>
  6030. <tr>
  6031. <td>
  6032. <code>priorityPolicy</code></br>
  6033. <em>
  6034. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">
  6035. ExternalSecretRewriteMergePriorityPolicy
  6036. </a>
  6037. </em>
  6038. </td>
  6039. <td>
  6040. <em>(Optional)</em>
  6041. <p>Used to define the policy when a key in the priority list does not exist in the input.</p>
  6042. </td>
  6043. </tr>
  6044. <tr>
  6045. <td>
  6046. <code>conflictPolicy</code></br>
  6047. <em>
  6048. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">
  6049. ExternalSecretRewriteMergeConflictPolicy
  6050. </a>
  6051. </em>
  6052. </td>
  6053. <td>
  6054. <em>(Optional)</em>
  6055. <p>Used to define the policy to use in conflict resolution.</p>
  6056. </td>
  6057. </tr>
  6058. <tr>
  6059. <td>
  6060. <code>strategy</code></br>
  6061. <em>
  6062. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">
  6063. ExternalSecretRewriteMergeStrategy
  6064. </a>
  6065. </em>
  6066. </td>
  6067. <td>
  6068. <em>(Optional)</em>
  6069. <p>Used to define the strategy to use in the merge operation.</p>
  6070. </td>
  6071. </tr>
  6072. </tbody>
  6073. </table>
  6074. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">ExternalSecretRewriteMergeConflictPolicy
  6075. (<code>string</code> alias)</p></h3>
  6076. <p>
  6077. (<em>Appears on:</em>
  6078. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6079. </p>
  6080. <p>
  6081. <p>ExternalSecretRewriteMergeConflictPolicy defines the policy for resolving conflicts when merging secrets.</p>
  6082. </p>
  6083. <table>
  6084. <thead>
  6085. <tr>
  6086. <th>Value</th>
  6087. <th>Description</th>
  6088. </tr>
  6089. </thead>
  6090. <tbody><tr><td><p>&#34;Error&#34;</p></td>
  6091. <td><p>ExternalSecretRewriteMergeConflictPolicyError returns an error when conflicts occur during merge.</p>
  6092. </td>
  6093. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  6094. <td><p>ExternalSecretRewriteMergeConflictPolicyIgnore ignores conflicts when merging secret values.</p>
  6095. </td>
  6096. </tr></tbody>
  6097. </table>
  6098. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">ExternalSecretRewriteMergePriorityPolicy
  6099. (<code>string</code> alias)</p></h3>
  6100. <p>
  6101. (<em>Appears on:</em>
  6102. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6103. </p>
  6104. <p>
  6105. <p>ExternalSecretRewriteMergePriorityPolicy defines the policy for handling missing keys in the priority
  6106. list during merge operations.</p>
  6107. </p>
  6108. <table>
  6109. <thead>
  6110. <tr>
  6111. <th>Value</th>
  6112. <th>Description</th>
  6113. </tr>
  6114. </thead>
  6115. <tbody><tr><td><p>&#34;IgnoreNotFound&#34;</p></td>
  6116. <td></td>
  6117. </tr><tr><td><p>&#34;Strict&#34;</p></td>
  6118. <td></td>
  6119. </tr></tbody>
  6120. </table>
  6121. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">ExternalSecretRewriteMergeStrategy
  6122. (<code>string</code> alias)</p></h3>
  6123. <p>
  6124. (<em>Appears on:</em>
  6125. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6126. </p>
  6127. <p>
  6128. <p>ExternalSecretRewriteMergeStrategy defines the strategy for merging secrets.</p>
  6129. </p>
  6130. <table>
  6131. <thead>
  6132. <tr>
  6133. <th>Value</th>
  6134. <th>Description</th>
  6135. </tr>
  6136. </thead>
  6137. <tbody><tr><td><p>&#34;Extract&#34;</p></td>
  6138. <td><p>ExternalSecretRewriteMergeStrategyExtract merges secrets by extracting values.</p>
  6139. </td>
  6140. </tr><tr><td><p>&#34;JSON&#34;</p></td>
  6141. <td><p>ExternalSecretRewriteMergeStrategyJSON merges secrets using JSON merge strategy.</p>
  6142. </td>
  6143. </tr></tbody>
  6144. </table>
  6145. <h3 id="external-secrets.io/v1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  6146. </h3>
  6147. <p>
  6148. (<em>Appears on:</em>
  6149. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  6150. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  6151. </p>
  6152. <p>
  6153. <p>ExternalSecretRewriteRegexp defines configuration for rewriting secrets using regular expressions.</p>
  6154. </p>
  6155. <table>
  6156. <thead>
  6157. <tr>
  6158. <th>Field</th>
  6159. <th>Description</th>
  6160. </tr>
  6161. </thead>
  6162. <tbody>
  6163. <tr>
  6164. <td>
  6165. <code>source</code></br>
  6166. <em>
  6167. string
  6168. </em>
  6169. </td>
  6170. <td>
  6171. <p>Used to define the regular expression of a re.Compiler.</p>
  6172. </td>
  6173. </tr>
  6174. <tr>
  6175. <td>
  6176. <code>target</code></br>
  6177. <em>
  6178. string
  6179. </em>
  6180. </td>
  6181. <td>
  6182. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  6183. </td>
  6184. </tr>
  6185. </tbody>
  6186. </table>
  6187. <h3 id="external-secrets.io/v1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  6188. </h3>
  6189. <p>
  6190. (<em>Appears on:</em>
  6191. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  6192. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  6193. </p>
  6194. <p>
  6195. <p>ExternalSecretRewriteTransform defines configuration for transforming secrets using templates.</p>
  6196. </p>
  6197. <table>
  6198. <thead>
  6199. <tr>
  6200. <th>Field</th>
  6201. <th>Description</th>
  6202. </tr>
  6203. </thead>
  6204. <tbody>
  6205. <tr>
  6206. <td>
  6207. <code>template</code></br>
  6208. <em>
  6209. string
  6210. </em>
  6211. </td>
  6212. <td>
  6213. <p>Used to define the template to apply on the secret name.
  6214. <code>.value</code> will specify the secret name in the template.</p>
  6215. </td>
  6216. </tr>
  6217. </tbody>
  6218. </table>
  6219. <h3 id="external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec
  6220. </h3>
  6221. <p>
  6222. (<em>Appears on:</em>
  6223. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  6224. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6225. </p>
  6226. <p>
  6227. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  6228. </p>
  6229. <table>
  6230. <thead>
  6231. <tr>
  6232. <th>Field</th>
  6233. <th>Description</th>
  6234. </tr>
  6235. </thead>
  6236. <tbody>
  6237. <tr>
  6238. <td>
  6239. <code>secretStoreRef</code></br>
  6240. <em>
  6241. <a href="#external-secrets.io/v1.SecretStoreRef">
  6242. SecretStoreRef
  6243. </a>
  6244. </em>
  6245. </td>
  6246. <td>
  6247. <em>(Optional)</em>
  6248. </td>
  6249. </tr>
  6250. <tr>
  6251. <td>
  6252. <code>target</code></br>
  6253. <em>
  6254. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  6255. ExternalSecretTarget
  6256. </a>
  6257. </em>
  6258. </td>
  6259. <td>
  6260. <em>(Optional)</em>
  6261. </td>
  6262. </tr>
  6263. <tr>
  6264. <td>
  6265. <code>refreshPolicy</code></br>
  6266. <em>
  6267. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  6268. ExternalSecretRefreshPolicy
  6269. </a>
  6270. </em>
  6271. </td>
  6272. <td>
  6273. <em>(Optional)</em>
  6274. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  6275. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  6276. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  6277. No periodic updates occur if refreshInterval is 0.
  6278. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  6279. </td>
  6280. </tr>
  6281. <tr>
  6282. <td>
  6283. <code>refreshInterval</code></br>
  6284. <em>
  6285. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6286. Kubernetes meta/v1.Duration
  6287. </a>
  6288. </em>
  6289. </td>
  6290. <td>
  6291. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  6292. specified as Golang Duration strings.
  6293. Valid time units are &ldquo;ns&rdquo;, &ldquo;us&rdquo; (or &ldquo;µs&rdquo;), &ldquo;ms&rdquo;, &ldquo;s&rdquo;, &ldquo;m&rdquo;, &ldquo;h&rdquo;
  6294. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  6295. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  6296. </td>
  6297. </tr>
  6298. <tr>
  6299. <td>
  6300. <code>syncWindows</code></br>
  6301. <em>
  6302. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">
  6303. ExternalSecretSyncWindows
  6304. </a>
  6305. </em>
  6306. </td>
  6307. <td>
  6308. <em>(Optional)</em>
  6309. <p>SyncWindows optionally restricts when periodic refreshes may occur.
  6310. Evaluated in UTC, only for Periodic refresh policy (or when refreshPolicy is unset).</p>
  6311. </td>
  6312. </tr>
  6313. <tr>
  6314. <td>
  6315. <code>data</code></br>
  6316. <em>
  6317. <a href="#external-secrets.io/v1.ExternalSecretData">
  6318. []ExternalSecretData
  6319. </a>
  6320. </em>
  6321. </td>
  6322. <td>
  6323. <em>(Optional)</em>
  6324. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  6325. </td>
  6326. </tr>
  6327. <tr>
  6328. <td>
  6329. <code>dataFrom</code></br>
  6330. <em>
  6331. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  6332. []ExternalSecretDataFromRemoteRef
  6333. </a>
  6334. </em>
  6335. </td>
  6336. <td>
  6337. <em>(Optional)</em>
  6338. <p>DataFrom is used to fetch all properties from a specific Provider data
  6339. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  6340. </td>
  6341. </tr>
  6342. </tbody>
  6343. </table>
  6344. <h3 id="external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus
  6345. </h3>
  6346. <p>
  6347. (<em>Appears on:</em>
  6348. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6349. </p>
  6350. <p>
  6351. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  6352. </p>
  6353. <table>
  6354. <thead>
  6355. <tr>
  6356. <th>Field</th>
  6357. <th>Description</th>
  6358. </tr>
  6359. </thead>
  6360. <tbody>
  6361. <tr>
  6362. <td>
  6363. <code>refreshTime</code></br>
  6364. <em>
  6365. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6366. Kubernetes meta/v1.Time
  6367. </a>
  6368. </em>
  6369. </td>
  6370. <td>
  6371. <p>refreshTime is the time and date the external secret was fetched and
  6372. the target secret updated</p>
  6373. </td>
  6374. </tr>
  6375. <tr>
  6376. <td>
  6377. <code>syncedResourceVersion</code></br>
  6378. <em>
  6379. string
  6380. </em>
  6381. </td>
  6382. <td>
  6383. <p>SyncedResourceVersion keeps track of the last synced version</p>
  6384. </td>
  6385. </tr>
  6386. <tr>
  6387. <td>
  6388. <code>conditions</code></br>
  6389. <em>
  6390. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">
  6391. []ExternalSecretStatusCondition
  6392. </a>
  6393. </em>
  6394. </td>
  6395. <td>
  6396. <em>(Optional)</em>
  6397. </td>
  6398. </tr>
  6399. <tr>
  6400. <td>
  6401. <code>binding</code></br>
  6402. <em>
  6403. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  6404. Kubernetes core/v1.LocalObjectReference
  6405. </a>
  6406. </em>
  6407. </td>
  6408. <td>
  6409. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  6410. </td>
  6411. </tr>
  6412. </tbody>
  6413. </table>
  6414. <h3 id="external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  6415. </h3>
  6416. <p>
  6417. (<em>Appears on:</em>
  6418. <a href="#external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus</a>)
  6419. </p>
  6420. <p>
  6421. <p>ExternalSecretStatusCondition defines a status condition of an ExternalSecret resource.</p>
  6422. </p>
  6423. <table>
  6424. <thead>
  6425. <tr>
  6426. <th>Field</th>
  6427. <th>Description</th>
  6428. </tr>
  6429. </thead>
  6430. <tbody>
  6431. <tr>
  6432. <td>
  6433. <code>type</code></br>
  6434. <em>
  6435. <a href="#external-secrets.io/v1.ExternalSecretConditionType">
  6436. ExternalSecretConditionType
  6437. </a>
  6438. </em>
  6439. </td>
  6440. <td>
  6441. </td>
  6442. </tr>
  6443. <tr>
  6444. <td>
  6445. <code>status</code></br>
  6446. <em>
  6447. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  6448. Kubernetes core/v1.ConditionStatus
  6449. </a>
  6450. </em>
  6451. </td>
  6452. <td>
  6453. </td>
  6454. </tr>
  6455. <tr>
  6456. <td>
  6457. <code>reason</code></br>
  6458. <em>
  6459. string
  6460. </em>
  6461. </td>
  6462. <td>
  6463. <em>(Optional)</em>
  6464. </td>
  6465. </tr>
  6466. <tr>
  6467. <td>
  6468. <code>message</code></br>
  6469. <em>
  6470. string
  6471. </em>
  6472. </td>
  6473. <td>
  6474. <em>(Optional)</em>
  6475. </td>
  6476. </tr>
  6477. <tr>
  6478. <td>
  6479. <code>lastTransitionTime</code></br>
  6480. <em>
  6481. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6482. Kubernetes meta/v1.Time
  6483. </a>
  6484. </em>
  6485. </td>
  6486. <td>
  6487. <em>(Optional)</em>
  6488. </td>
  6489. </tr>
  6490. </tbody>
  6491. </table>
  6492. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindowEntry">ExternalSecretSyncWindowEntry
  6493. </h3>
  6494. <p>
  6495. (<em>Appears on:</em>
  6496. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows</a>)
  6497. </p>
  6498. <p>
  6499. <p>ExternalSecretSyncWindowEntry defines a single cron-schedule + duration pair
  6500. within a SyncWindows block.</p>
  6501. </p>
  6502. <table>
  6503. <thead>
  6504. <tr>
  6505. <th>Field</th>
  6506. <th>Description</th>
  6507. </tr>
  6508. </thead>
  6509. <tbody>
  6510. <tr>
  6511. <td>
  6512. <code>schedule</code></br>
  6513. <em>
  6514. string
  6515. </em>
  6516. </td>
  6517. <td>
  6518. <p>Schedule is a standard 5-field cron expression evaluated in UTC, or a
  6519. named shorthand such as @daily or @every 1h. It marks the start time of
  6520. each window occurrence.
  6521. Example: &ldquo;0 22 * * 1-5&rdquo; opens a window every weekday at 22:00 UTC.</p>
  6522. </td>
  6523. </tr>
  6524. <tr>
  6525. <td>
  6526. <code>duration</code></br>
  6527. <em>
  6528. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6529. Kubernetes meta/v1.Duration
  6530. </a>
  6531. </em>
  6532. </td>
  6533. <td>
  6534. <p>Duration specifies how long the window stays open after each Schedule
  6535. firing. Example: &ldquo;8h&rdquo;.</p>
  6536. </td>
  6537. </tr>
  6538. </tbody>
  6539. </table>
  6540. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindowKind">ExternalSecretSyncWindowKind
  6541. (<code>string</code> alias)</p></h3>
  6542. <p>
  6543. (<em>Appears on:</em>
  6544. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows</a>)
  6545. </p>
  6546. <p>
  6547. <p>ExternalSecretSyncWindowKind defines whether a SyncWindow permits or
  6548. blocks periodic refreshes.</p>
  6549. </p>
  6550. <table>
  6551. <thead>
  6552. <tr>
  6553. <th>Value</th>
  6554. <th>Description</th>
  6555. </tr>
  6556. </thead>
  6557. <tbody><tr><td><p>&#34;allow&#34;</p></td>
  6558. <td><p>SyncWindowAllow allows periodic refreshes only while at least one window
  6559. in the list is active. Refreshes are blocked at all other times.</p>
  6560. </td>
  6561. </tr><tr><td><p>&#34;deny&#34;</p></td>
  6562. <td><p>SyncWindowDeny blocks periodic refreshes while any window in the list is
  6563. active. Refreshes proceed normally at all other times.</p>
  6564. </td>
  6565. </tr></tbody>
  6566. </table>
  6567. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows
  6568. </h3>
  6569. <p>
  6570. (<em>Appears on:</em>
  6571. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6572. </p>
  6573. <p>
  6574. <p>ExternalSecretSyncWindows optionally restricts when periodic syncs may occur.
  6575. All windows in the list share the same Kind.</p>
  6576. </p>
  6577. <table>
  6578. <thead>
  6579. <tr>
  6580. <th>Field</th>
  6581. <th>Description</th>
  6582. </tr>
  6583. </thead>
  6584. <tbody>
  6585. <tr>
  6586. <td>
  6587. <code>kind</code></br>
  6588. <em>
  6589. <a href="#external-secrets.io/v1.ExternalSecretSyncWindowKind">
  6590. ExternalSecretSyncWindowKind
  6591. </a>
  6592. </em>
  6593. </td>
  6594. <td>
  6595. <p>Kind applies to every window in the list.
  6596. &ldquo;allow&rdquo; &ndash; syncs are permitted only while at least one window is active;
  6597. all other times are blocked.
  6598. &ldquo;deny&rdquo; &ndash; syncs are blocked while any window is active;
  6599. all other times are permitted.</p>
  6600. </td>
  6601. </tr>
  6602. <tr>
  6603. <td>
  6604. <code>windows</code></br>
  6605. <em>
  6606. <a href="#external-secrets.io/v1.ExternalSecretSyncWindowEntry">
  6607. []ExternalSecretSyncWindowEntry
  6608. </a>
  6609. </em>
  6610. </td>
  6611. <td>
  6612. <p>Windows is the list of schedule+duration pairs.</p>
  6613. </td>
  6614. </tr>
  6615. </tbody>
  6616. </table>
  6617. <h3 id="external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget
  6618. </h3>
  6619. <p>
  6620. (<em>Appears on:</em>
  6621. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6622. </p>
  6623. <p>
  6624. <p>ExternalSecretTarget defines the Kubernetes Secret to be created,
  6625. there can be only one target per ExternalSecret.</p>
  6626. </p>
  6627. <table>
  6628. <thead>
  6629. <tr>
  6630. <th>Field</th>
  6631. <th>Description</th>
  6632. </tr>
  6633. </thead>
  6634. <tbody>
  6635. <tr>
  6636. <td>
  6637. <code>name</code></br>
  6638. <em>
  6639. string
  6640. </em>
  6641. </td>
  6642. <td>
  6643. <em>(Optional)</em>
  6644. <p>The name of the Secret resource to be managed.
  6645. Defaults to the .metadata.name of the ExternalSecret resource</p>
  6646. </td>
  6647. </tr>
  6648. <tr>
  6649. <td>
  6650. <code>creationPolicy</code></br>
  6651. <em>
  6652. <a href="#external-secrets.io/v1.ExternalSecretCreationPolicy">
  6653. ExternalSecretCreationPolicy
  6654. </a>
  6655. </em>
  6656. </td>
  6657. <td>
  6658. <em>(Optional)</em>
  6659. <p>CreationPolicy defines rules on how to create the resulting Secret.
  6660. Defaults to &ldquo;Owner&rdquo;</p>
  6661. </td>
  6662. </tr>
  6663. <tr>
  6664. <td>
  6665. <code>deletionPolicy</code></br>
  6666. <em>
  6667. <a href="#external-secrets.io/v1.ExternalSecretDeletionPolicy">
  6668. ExternalSecretDeletionPolicy
  6669. </a>
  6670. </em>
  6671. </td>
  6672. <td>
  6673. <em>(Optional)</em>
  6674. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  6675. Defaults to &ldquo;Retain&rdquo;</p>
  6676. </td>
  6677. </tr>
  6678. <tr>
  6679. <td>
  6680. <code>template</code></br>
  6681. <em>
  6682. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  6683. ExternalSecretTemplate
  6684. </a>
  6685. </em>
  6686. </td>
  6687. <td>
  6688. <em>(Optional)</em>
  6689. <p>Template defines a blueprint for the created Secret resource.</p>
  6690. </td>
  6691. </tr>
  6692. <tr>
  6693. <td>
  6694. <code>manifest</code></br>
  6695. <em>
  6696. <a href="#external-secrets.io/v1.ManifestReference">
  6697. ManifestReference
  6698. </a>
  6699. </em>
  6700. </td>
  6701. <td>
  6702. <em>(Optional)</em>
  6703. <p>Manifest defines a custom Kubernetes resource to create instead of a Secret.
  6704. When specified, ExternalSecret will create the resource type defined here
  6705. (e.g., ConfigMap, Custom Resource) instead of a Secret.
  6706. Warning: Using Generic target. Make sure access policies and encryption are properly configured.</p>
  6707. </td>
  6708. </tr>
  6709. <tr>
  6710. <td>
  6711. <code>immutable</code></br>
  6712. <em>
  6713. bool
  6714. </em>
  6715. </td>
  6716. <td>
  6717. <em>(Optional)</em>
  6718. <p>Immutable defines if the final secret will be immutable</p>
  6719. </td>
  6720. </tr>
  6721. </tbody>
  6722. </table>
  6723. <h3 id="external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate
  6724. </h3>
  6725. <p>
  6726. (<em>Appears on:</em>
  6727. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>,
  6728. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  6729. </p>
  6730. <p>
  6731. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  6732. we can not use native corev1.Secret, it will have empty ObjectMeta values: <a href="https://github.com/kubernetes-sigs/controller-tools/issues/448">https://github.com/kubernetes-sigs/controller-tools/issues/448</a></p>
  6733. </p>
  6734. <table>
  6735. <thead>
  6736. <tr>
  6737. <th>Field</th>
  6738. <th>Description</th>
  6739. </tr>
  6740. </thead>
  6741. <tbody>
  6742. <tr>
  6743. <td>
  6744. <code>type</code></br>
  6745. <em>
  6746. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  6747. Kubernetes core/v1.SecretType
  6748. </a>
  6749. </em>
  6750. </td>
  6751. <td>
  6752. <em>(Optional)</em>
  6753. </td>
  6754. </tr>
  6755. <tr>
  6756. <td>
  6757. <code>engineVersion</code></br>
  6758. <em>
  6759. <a href="#external-secrets.io/v1.TemplateEngineVersion">
  6760. TemplateEngineVersion
  6761. </a>
  6762. </em>
  6763. </td>
  6764. <td>
  6765. <p>EngineVersion specifies the template engine version
  6766. that should be used to compile/execute the
  6767. template specified in .data and .templateFrom[].</p>
  6768. </td>
  6769. </tr>
  6770. <tr>
  6771. <td>
  6772. <code>metadata</code></br>
  6773. <em>
  6774. <a href="#external-secrets.io/v1.ExternalSecretTemplateMetadata">
  6775. ExternalSecretTemplateMetadata
  6776. </a>
  6777. </em>
  6778. </td>
  6779. <td>
  6780. <em>(Optional)</em>
  6781. </td>
  6782. </tr>
  6783. <tr>
  6784. <td>
  6785. <code>mergePolicy</code></br>
  6786. <em>
  6787. <a href="#external-secrets.io/v1.TemplateMergePolicy">
  6788. TemplateMergePolicy
  6789. </a>
  6790. </em>
  6791. </td>
  6792. <td>
  6793. </td>
  6794. </tr>
  6795. <tr>
  6796. <td>
  6797. <code>data</code></br>
  6798. <em>
  6799. map[string]string
  6800. </em>
  6801. </td>
  6802. <td>
  6803. <em>(Optional)</em>
  6804. </td>
  6805. </tr>
  6806. <tr>
  6807. <td>
  6808. <code>templateFrom</code></br>
  6809. <em>
  6810. <a href="#external-secrets.io/v1.TemplateFrom">
  6811. []TemplateFrom
  6812. </a>
  6813. </em>
  6814. </td>
  6815. <td>
  6816. <em>(Optional)</em>
  6817. </td>
  6818. </tr>
  6819. </tbody>
  6820. </table>
  6821. <h3 id="external-secrets.io/v1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  6822. </h3>
  6823. <p>
  6824. (<em>Appears on:</em>
  6825. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  6826. </p>
  6827. <p>
  6828. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  6829. </p>
  6830. <table>
  6831. <thead>
  6832. <tr>
  6833. <th>Field</th>
  6834. <th>Description</th>
  6835. </tr>
  6836. </thead>
  6837. <tbody>
  6838. <tr>
  6839. <td>
  6840. <code>annotations</code></br>
  6841. <em>
  6842. map[string]string
  6843. </em>
  6844. </td>
  6845. <td>
  6846. <em>(Optional)</em>
  6847. </td>
  6848. </tr>
  6849. <tr>
  6850. <td>
  6851. <code>labels</code></br>
  6852. <em>
  6853. map[string]string
  6854. </em>
  6855. </td>
  6856. <td>
  6857. <em>(Optional)</em>
  6858. </td>
  6859. </tr>
  6860. <tr>
  6861. <td>
  6862. <code>finalizers</code></br>
  6863. <em>
  6864. []string
  6865. </em>
  6866. </td>
  6867. <td>
  6868. <em>(Optional)</em>
  6869. </td>
  6870. </tr>
  6871. </tbody>
  6872. </table>
  6873. <h3 id="external-secrets.io/v1.ExternalSecretValidator">ExternalSecretValidator
  6874. </h3>
  6875. <p>
  6876. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  6877. </p>
  6878. <h3 id="external-secrets.io/v1.FakeProvider">FakeProvider
  6879. </h3>
  6880. <p>
  6881. (<em>Appears on:</em>
  6882. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  6883. </p>
  6884. <p>
  6885. <p>FakeProvider configures a fake provider that returns static values.</p>
  6886. </p>
  6887. <table>
  6888. <thead>
  6889. <tr>
  6890. <th>Field</th>
  6891. <th>Description</th>
  6892. </tr>
  6893. </thead>
  6894. <tbody>
  6895. <tr>
  6896. <td>
  6897. <code>data</code></br>
  6898. <em>
  6899. <a href="#external-secrets.io/v1.FakeProviderData">
  6900. []FakeProviderData
  6901. </a>
  6902. </em>
  6903. </td>
  6904. <td>
  6905. </td>
  6906. </tr>
  6907. <tr>
  6908. <td>
  6909. <code>validationResult</code></br>
  6910. <em>
  6911. <a href="#external-secrets.io/v1.ValidationResult">
  6912. ValidationResult
  6913. </a>
  6914. </em>
  6915. </td>
  6916. <td>
  6917. </td>
  6918. </tr>
  6919. </tbody>
  6920. </table>
  6921. <h3 id="external-secrets.io/v1.FakeProviderData">FakeProviderData
  6922. </h3>
  6923. <p>
  6924. (<em>Appears on:</em>
  6925. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  6926. </p>
  6927. <p>
  6928. <p>FakeProviderData defines a key-value pair with optional version for the fake provider.</p>
  6929. </p>
  6930. <table>
  6931. <thead>
  6932. <tr>
  6933. <th>Field</th>
  6934. <th>Description</th>
  6935. </tr>
  6936. </thead>
  6937. <tbody>
  6938. <tr>
  6939. <td>
  6940. <code>key</code></br>
  6941. <em>
  6942. string
  6943. </em>
  6944. </td>
  6945. <td>
  6946. </td>
  6947. </tr>
  6948. <tr>
  6949. <td>
  6950. <code>value</code></br>
  6951. <em>
  6952. string
  6953. </em>
  6954. </td>
  6955. <td>
  6956. </td>
  6957. </tr>
  6958. <tr>
  6959. <td>
  6960. <code>version</code></br>
  6961. <em>
  6962. string
  6963. </em>
  6964. </td>
  6965. <td>
  6966. </td>
  6967. </tr>
  6968. </tbody>
  6969. </table>
  6970. <h3 id="external-secrets.io/v1.FetchingPolicy">FetchingPolicy
  6971. </h3>
  6972. <p>
  6973. (<em>Appears on:</em>
  6974. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  6975. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  6976. </p>
  6977. <p>
  6978. <p>FetchingPolicy configures how the provider interprets the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret.</p>
  6979. </p>
  6980. <table>
  6981. <thead>
  6982. <tr>
  6983. <th>Field</th>
  6984. <th>Description</th>
  6985. </tr>
  6986. </thead>
  6987. <tbody>
  6988. <tr>
  6989. <td>
  6990. <code>byID</code></br>
  6991. <em>
  6992. <a href="#external-secrets.io/v1.ByID">
  6993. ByID
  6994. </a>
  6995. </em>
  6996. </td>
  6997. <td>
  6998. </td>
  6999. </tr>
  7000. <tr>
  7001. <td>
  7002. <code>byName</code></br>
  7003. <em>
  7004. <a href="#external-secrets.io/v1.ByName">
  7005. ByName
  7006. </a>
  7007. </em>
  7008. </td>
  7009. <td>
  7010. </td>
  7011. </tr>
  7012. </tbody>
  7013. </table>
  7014. <h3 id="external-secrets.io/v1.FindName">FindName
  7015. </h3>
  7016. <p>
  7017. (<em>Appears on:</em>
  7018. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  7019. </p>
  7020. <p>
  7021. <p>FindName defines criteria for finding secrets by name patterns.</p>
  7022. </p>
  7023. <table>
  7024. <thead>
  7025. <tr>
  7026. <th>Field</th>
  7027. <th>Description</th>
  7028. </tr>
  7029. </thead>
  7030. <tbody>
  7031. <tr>
  7032. <td>
  7033. <code>regexp</code></br>
  7034. <em>
  7035. string
  7036. </em>
  7037. </td>
  7038. <td>
  7039. <em>(Optional)</em>
  7040. <p>Finds secrets base</p>
  7041. </td>
  7042. </tr>
  7043. </tbody>
  7044. </table>
  7045. <h3 id="external-secrets.io/v1.FortanixProvider">FortanixProvider
  7046. </h3>
  7047. <p>
  7048. (<em>Appears on:</em>
  7049. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7050. </p>
  7051. <p>
  7052. <p>FortanixProvider provides access to Fortanix SDKMS API using the provided credentials.</p>
  7053. </p>
  7054. <table>
  7055. <thead>
  7056. <tr>
  7057. <th>Field</th>
  7058. <th>Description</th>
  7059. </tr>
  7060. </thead>
  7061. <tbody>
  7062. <tr>
  7063. <td>
  7064. <code>apiUrl</code></br>
  7065. <em>
  7066. string
  7067. </em>
  7068. </td>
  7069. <td>
  7070. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  7071. </td>
  7072. </tr>
  7073. <tr>
  7074. <td>
  7075. <code>apiKey</code></br>
  7076. <em>
  7077. <a href="#external-secrets.io/v1.FortanixProviderSecretRef">
  7078. FortanixProviderSecretRef
  7079. </a>
  7080. </em>
  7081. </td>
  7082. <td>
  7083. <p>APIKey is the API token to access SDKMS Applications.</p>
  7084. </td>
  7085. </tr>
  7086. </tbody>
  7087. </table>
  7088. <h3 id="external-secrets.io/v1.FortanixProviderSecretRef">FortanixProviderSecretRef
  7089. </h3>
  7090. <p>
  7091. (<em>Appears on:</em>
  7092. <a href="#external-secrets.io/v1.FortanixProvider">FortanixProvider</a>)
  7093. </p>
  7094. <p>
  7095. <p>FortanixProviderSecretRef is a secret reference containing the SDKMS API Key.</p>
  7096. </p>
  7097. <table>
  7098. <thead>
  7099. <tr>
  7100. <th>Field</th>
  7101. <th>Description</th>
  7102. </tr>
  7103. </thead>
  7104. <tbody>
  7105. <tr>
  7106. <td>
  7107. <code>secretRef</code></br>
  7108. <em>
  7109. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7110. External Secrets meta/v1.SecretKeySelector
  7111. </a>
  7112. </em>
  7113. </td>
  7114. <td>
  7115. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  7116. </td>
  7117. </tr>
  7118. </tbody>
  7119. </table>
  7120. <h3 id="external-secrets.io/v1.GCPSMAuth">GCPSMAuth
  7121. </h3>
  7122. <p>
  7123. (<em>Appears on:</em>
  7124. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  7125. </p>
  7126. <p>
  7127. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform Secret Manager.</p>
  7128. </p>
  7129. <table>
  7130. <thead>
  7131. <tr>
  7132. <th>Field</th>
  7133. <th>Description</th>
  7134. </tr>
  7135. </thead>
  7136. <tbody>
  7137. <tr>
  7138. <td>
  7139. <code>secretRef</code></br>
  7140. <em>
  7141. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  7142. GCPSMAuthSecretRef
  7143. </a>
  7144. </em>
  7145. </td>
  7146. <td>
  7147. <em>(Optional)</em>
  7148. </td>
  7149. </tr>
  7150. <tr>
  7151. <td>
  7152. <code>workloadIdentity</code></br>
  7153. <em>
  7154. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  7155. GCPWorkloadIdentity
  7156. </a>
  7157. </em>
  7158. </td>
  7159. <td>
  7160. <em>(Optional)</em>
  7161. </td>
  7162. </tr>
  7163. <tr>
  7164. <td>
  7165. <code>workloadIdentityFederation</code></br>
  7166. <em>
  7167. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  7168. GCPWorkloadIdentityFederation
  7169. </a>
  7170. </em>
  7171. </td>
  7172. <td>
  7173. <em>(Optional)</em>
  7174. </td>
  7175. </tr>
  7176. </tbody>
  7177. </table>
  7178. <h3 id="external-secrets.io/v1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  7179. </h3>
  7180. <p>
  7181. (<em>Appears on:</em>
  7182. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7183. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  7184. </p>
  7185. <p>
  7186. <p>GCPSMAuthSecretRef contains the secret references for GCP Secret Manager authentication.</p>
  7187. </p>
  7188. <table>
  7189. <thead>
  7190. <tr>
  7191. <th>Field</th>
  7192. <th>Description</th>
  7193. </tr>
  7194. </thead>
  7195. <tbody>
  7196. <tr>
  7197. <td>
  7198. <code>secretAccessKeySecretRef</code></br>
  7199. <em>
  7200. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7201. External Secrets meta/v1.SecretKeySelector
  7202. </a>
  7203. </em>
  7204. </td>
  7205. <td>
  7206. <em>(Optional)</em>
  7207. <p>The SecretAccessKey is used for authentication</p>
  7208. </td>
  7209. </tr>
  7210. </tbody>
  7211. </table>
  7212. <h3 id="external-secrets.io/v1.GCPSMProvider">GCPSMProvider
  7213. </h3>
  7214. <p>
  7215. (<em>Appears on:</em>
  7216. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7217. </p>
  7218. <p>
  7219. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  7220. </p>
  7221. <table>
  7222. <thead>
  7223. <tr>
  7224. <th>Field</th>
  7225. <th>Description</th>
  7226. </tr>
  7227. </thead>
  7228. <tbody>
  7229. <tr>
  7230. <td>
  7231. <code>auth</code></br>
  7232. <em>
  7233. <a href="#external-secrets.io/v1.GCPSMAuth">
  7234. GCPSMAuth
  7235. </a>
  7236. </em>
  7237. </td>
  7238. <td>
  7239. <em>(Optional)</em>
  7240. <p>Auth defines the information necessary to authenticate against GCP</p>
  7241. </td>
  7242. </tr>
  7243. <tr>
  7244. <td>
  7245. <code>projectID</code></br>
  7246. <em>
  7247. string
  7248. </em>
  7249. </td>
  7250. <td>
  7251. <p>ProjectID project where secret is located</p>
  7252. </td>
  7253. </tr>
  7254. <tr>
  7255. <td>
  7256. <code>location</code></br>
  7257. <em>
  7258. string
  7259. </em>
  7260. </td>
  7261. <td>
  7262. <p>Location optionally defines a location for a secret</p>
  7263. </td>
  7264. </tr>
  7265. <tr>
  7266. <td>
  7267. <code>secretVersionSelectionPolicy</code></br>
  7268. <em>
  7269. <a href="#external-secrets.io/v1.SecretVersionSelectionPolicy">
  7270. SecretVersionSelectionPolicy
  7271. </a>
  7272. </em>
  7273. </td>
  7274. <td>
  7275. <em>(Optional)</em>
  7276. <p>SecretVersionSelectionPolicy specifies how the provider selects a secret version
  7277. when &ldquo;latest&rdquo; is disabled or destroyed.
  7278. Possible values are:
  7279. - LatestOrFail: the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.
  7280. - LatestOrFetch: the provider falls back to fetching the latest version if the version is DESTROYED or DISABLED</p>
  7281. </td>
  7282. </tr>
  7283. </tbody>
  7284. </table>
  7285. <h3 id="external-secrets.io/v1.GCPWorkloadIdentity">GCPWorkloadIdentity
  7286. </h3>
  7287. <p>
  7288. (<em>Appears on:</em>
  7289. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7290. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  7291. </p>
  7292. <p>
  7293. <p>GCPWorkloadIdentity defines configuration for workload identity authentication to GCP.</p>
  7294. </p>
  7295. <table>
  7296. <thead>
  7297. <tr>
  7298. <th>Field</th>
  7299. <th>Description</th>
  7300. </tr>
  7301. </thead>
  7302. <tbody>
  7303. <tr>
  7304. <td>
  7305. <code>serviceAccountRef</code></br>
  7306. <em>
  7307. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7308. External Secrets meta/v1.ServiceAccountSelector
  7309. </a>
  7310. </em>
  7311. </td>
  7312. <td>
  7313. </td>
  7314. </tr>
  7315. <tr>
  7316. <td>
  7317. <code>clusterLocation</code></br>
  7318. <em>
  7319. string
  7320. </em>
  7321. </td>
  7322. <td>
  7323. <em>(Optional)</em>
  7324. <p>ClusterLocation is the location of the cluster
  7325. If not specified, it fetches information from the metadata server</p>
  7326. </td>
  7327. </tr>
  7328. <tr>
  7329. <td>
  7330. <code>clusterName</code></br>
  7331. <em>
  7332. string
  7333. </em>
  7334. </td>
  7335. <td>
  7336. <em>(Optional)</em>
  7337. <p>ClusterName is the name of the cluster
  7338. If not specified, it fetches information from the metadata server</p>
  7339. </td>
  7340. </tr>
  7341. <tr>
  7342. <td>
  7343. <code>clusterProjectID</code></br>
  7344. <em>
  7345. string
  7346. </em>
  7347. </td>
  7348. <td>
  7349. <em>(Optional)</em>
  7350. <p>ClusterProjectID is the project ID of the cluster
  7351. If not specified, it fetches information from the metadata server</p>
  7352. </td>
  7353. </tr>
  7354. </tbody>
  7355. </table>
  7356. <h3 id="external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation
  7357. </h3>
  7358. <p>
  7359. (<em>Appears on:</em>
  7360. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7361. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  7362. </p>
  7363. <p>
  7364. <p>GCPWorkloadIdentityFederation holds the configurations required for generating federated access tokens.</p>
  7365. </p>
  7366. <table>
  7367. <thead>
  7368. <tr>
  7369. <th>Field</th>
  7370. <th>Description</th>
  7371. </tr>
  7372. </thead>
  7373. <tbody>
  7374. <tr>
  7375. <td>
  7376. <code>credConfig</code></br>
  7377. <em>
  7378. <a href="#external-secrets.io/v1.ConfigMapReference">
  7379. ConfigMapReference
  7380. </a>
  7381. </em>
  7382. </td>
  7383. <td>
  7384. <p>credConfig holds the configmap reference containing the GCP external account credential configuration in JSON format and the key name containing the json data.
  7385. For using Kubernetes cluster as the identity provider, use serviceAccountRef instead. Operators mounted serviceaccount token cannot be used as the token source, instead
  7386. serviceAccountRef must be used by providing operators service account details.</p>
  7387. </td>
  7388. </tr>
  7389. <tr>
  7390. <td>
  7391. <code>serviceAccountRef</code></br>
  7392. <em>
  7393. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7394. External Secrets meta/v1.ServiceAccountSelector
  7395. </a>
  7396. </em>
  7397. </td>
  7398. <td>
  7399. <p>serviceAccountRef is the reference to the kubernetes ServiceAccount to be used for obtaining the tokens,
  7400. when Kubernetes is configured as provider in workload identity pool.</p>
  7401. </td>
  7402. </tr>
  7403. <tr>
  7404. <td>
  7405. <code>awsSecurityCredentials</code></br>
  7406. <em>
  7407. <a href="#external-secrets.io/v1.AwsCredentialsConfig">
  7408. AwsCredentialsConfig
  7409. </a>
  7410. </em>
  7411. </td>
  7412. <td>
  7413. <p>awsSecurityCredentials is for configuring AWS region and credentials to use for obtaining the access token,
  7414. when using the AWS metadata server is not an option.</p>
  7415. </td>
  7416. </tr>
  7417. <tr>
  7418. <td>
  7419. <code>audience</code></br>
  7420. <em>
  7421. string
  7422. </em>
  7423. </td>
  7424. <td>
  7425. <p>audience is the Secure Token Service (STS) audience which contains the resource name for the workload identity pool and the provider identifier in that pool.
  7426. If specified, Audience found in the external account credential config will be overridden with the configured value.
  7427. audience must be provided when serviceAccountRef or awsSecurityCredentials is configured.</p>
  7428. </td>
  7429. </tr>
  7430. <tr>
  7431. <td>
  7432. <code>externalTokenEndpoint</code></br>
  7433. <em>
  7434. string
  7435. </em>
  7436. </td>
  7437. <td>
  7438. <p>externalTokenEndpoint is the endpoint explicitly set up to provide tokens, which will be matched against the
  7439. credential_source.url in the provided credConfig. This field is merely to double-check the external token source
  7440. URL is having the expected value.</p>
  7441. </td>
  7442. </tr>
  7443. <tr>
  7444. <td>
  7445. <code>gcpServiceAccountEmail</code></br>
  7446. <em>
  7447. string
  7448. </em>
  7449. </td>
  7450. <td>
  7451. <p>GCPServiceAccountEmail is the email of the Google Cloud service account to impersonate
  7452. after Workload Identity Federation. Use this to grant access through the service account&rsquo;s
  7453. IAM bindings (for example roles/secretmanager.secretAccessor). When set, it overrides
  7454. service_account_impersonation_url in the external account JSON from credConfig;
  7455. when serviceAccountRef is set, it also overrides the &ldquo;iam.gke.io/gcp-service-account&rdquo; annotation
  7456. on that ServiceAccount.</p>
  7457. </td>
  7458. </tr>
  7459. </tbody>
  7460. </table>
  7461. <h3 id="external-secrets.io/v1.GcpIDTokenAuthCredentials">GcpIDTokenAuthCredentials
  7462. </h3>
  7463. <p>
  7464. (<em>Appears on:</em>
  7465. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7466. </p>
  7467. <p>
  7468. <p>GcpIDTokenAuthCredentials represents the credentials for GCP ID token authentication.</p>
  7469. </p>
  7470. <table>
  7471. <thead>
  7472. <tr>
  7473. <th>Field</th>
  7474. <th>Description</th>
  7475. </tr>
  7476. </thead>
  7477. <tbody>
  7478. <tr>
  7479. <td>
  7480. <code>identityId</code></br>
  7481. <em>
  7482. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7483. External Secrets meta/v1.SecretKeySelector
  7484. </a>
  7485. </em>
  7486. </td>
  7487. <td>
  7488. </td>
  7489. </tr>
  7490. </tbody>
  7491. </table>
  7492. <h3 id="external-secrets.io/v1.GcpIamAuthCredentials">GcpIamAuthCredentials
  7493. </h3>
  7494. <p>
  7495. (<em>Appears on:</em>
  7496. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7497. </p>
  7498. <p>
  7499. <p>GcpIamAuthCredentials represents the credentials for GCP IAM authentication.</p>
  7500. </p>
  7501. <table>
  7502. <thead>
  7503. <tr>
  7504. <th>Field</th>
  7505. <th>Description</th>
  7506. </tr>
  7507. </thead>
  7508. <tbody>
  7509. <tr>
  7510. <td>
  7511. <code>identityId</code></br>
  7512. <em>
  7513. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7514. External Secrets meta/v1.SecretKeySelector
  7515. </a>
  7516. </em>
  7517. </td>
  7518. <td>
  7519. </td>
  7520. </tr>
  7521. <tr>
  7522. <td>
  7523. <code>serviceAccountKeyFilePath</code></br>
  7524. <em>
  7525. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7526. External Secrets meta/v1.SecretKeySelector
  7527. </a>
  7528. </em>
  7529. </td>
  7530. <td>
  7531. </td>
  7532. </tr>
  7533. </tbody>
  7534. </table>
  7535. <h3 id="external-secrets.io/v1.GeneratorRef">GeneratorRef
  7536. </h3>
  7537. <p>
  7538. (<em>Appears on:</em>
  7539. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  7540. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>,
  7541. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  7542. </p>
  7543. <p>
  7544. <p>GeneratorRef points to a generator custom resource.</p>
  7545. </p>
  7546. <table>
  7547. <thead>
  7548. <tr>
  7549. <th>Field</th>
  7550. <th>Description</th>
  7551. </tr>
  7552. </thead>
  7553. <tbody>
  7554. <tr>
  7555. <td>
  7556. <code>apiVersion</code></br>
  7557. <em>
  7558. string
  7559. </em>
  7560. </td>
  7561. <td>
  7562. <p>Specify the apiVersion of the generator resource</p>
  7563. </td>
  7564. </tr>
  7565. <tr>
  7566. <td>
  7567. <code>kind</code></br>
  7568. <em>
  7569. string
  7570. </em>
  7571. </td>
  7572. <td>
  7573. <p>Specify the Kind of the generator resource</p>
  7574. </td>
  7575. </tr>
  7576. <tr>
  7577. <td>
  7578. <code>name</code></br>
  7579. <em>
  7580. string
  7581. </em>
  7582. </td>
  7583. <td>
  7584. <p>Specify the name of the generator resource</p>
  7585. </td>
  7586. </tr>
  7587. </tbody>
  7588. </table>
  7589. <h3 id="external-secrets.io/v1.GenericClusterStoreValidator">GenericClusterStoreValidator
  7590. </h3>
  7591. <p>
  7592. <p>GenericClusterStoreValidator implements webhook validation for ClusterSecretStore resources.</p>
  7593. </p>
  7594. <h3 id="external-secrets.io/v1.GenericStore">GenericStore
  7595. </h3>
  7596. <p>
  7597. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  7598. or a namespaced SecretStore.</p>
  7599. </p>
  7600. <h3 id="external-secrets.io/v1.GenericStoreValidator">GenericStoreValidator
  7601. </h3>
  7602. <p>
  7603. <p>GenericStoreValidator implements webhook validation for SecretStore resources.</p>
  7604. </p>
  7605. <h3 id="external-secrets.io/v1.GithubAppAuth">GithubAppAuth
  7606. </h3>
  7607. <p>
  7608. (<em>Appears on:</em>
  7609. <a href="#external-secrets.io/v1.GithubProvider">GithubProvider</a>)
  7610. </p>
  7611. <p>
  7612. <p>GithubAppAuth defines authentication configuration using a GitHub App for accessing GitHub API.</p>
  7613. </p>
  7614. <table>
  7615. <thead>
  7616. <tr>
  7617. <th>Field</th>
  7618. <th>Description</th>
  7619. </tr>
  7620. </thead>
  7621. <tbody>
  7622. <tr>
  7623. <td>
  7624. <code>privateKey</code></br>
  7625. <em>
  7626. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7627. External Secrets meta/v1.SecretKeySelector
  7628. </a>
  7629. </em>
  7630. </td>
  7631. <td>
  7632. </td>
  7633. </tr>
  7634. </tbody>
  7635. </table>
  7636. <h3 id="external-secrets.io/v1.GithubProvider">GithubProvider
  7637. </h3>
  7638. <p>
  7639. (<em>Appears on:</em>
  7640. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7641. </p>
  7642. <p>
  7643. <p>GithubProvider provides access and authentication to a GitHub instance .</p>
  7644. </p>
  7645. <table>
  7646. <thead>
  7647. <tr>
  7648. <th>Field</th>
  7649. <th>Description</th>
  7650. </tr>
  7651. </thead>
  7652. <tbody>
  7653. <tr>
  7654. <td>
  7655. <code>url</code></br>
  7656. <em>
  7657. string
  7658. </em>
  7659. </td>
  7660. <td>
  7661. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  7662. </td>
  7663. </tr>
  7664. <tr>
  7665. <td>
  7666. <code>uploadURL</code></br>
  7667. <em>
  7668. string
  7669. </em>
  7670. </td>
  7671. <td>
  7672. <em>(Optional)</em>
  7673. <p>Upload URL for enterprise instances. Default to URL.</p>
  7674. </td>
  7675. </tr>
  7676. <tr>
  7677. <td>
  7678. <code>auth</code></br>
  7679. <em>
  7680. <a href="#external-secrets.io/v1.GithubAppAuth">
  7681. GithubAppAuth
  7682. </a>
  7683. </em>
  7684. </td>
  7685. <td>
  7686. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  7687. </td>
  7688. </tr>
  7689. <tr>
  7690. <td>
  7691. <code>appID</code></br>
  7692. <em>
  7693. int64
  7694. </em>
  7695. </td>
  7696. <td>
  7697. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  7698. </td>
  7699. </tr>
  7700. <tr>
  7701. <td>
  7702. <code>installationID</code></br>
  7703. <em>
  7704. int64
  7705. </em>
  7706. </td>
  7707. <td>
  7708. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  7709. </td>
  7710. </tr>
  7711. <tr>
  7712. <td>
  7713. <code>organization</code></br>
  7714. <em>
  7715. string
  7716. </em>
  7717. </td>
  7718. <td>
  7719. <p>organization will be used to fetch secrets from the Github organization</p>
  7720. </td>
  7721. </tr>
  7722. <tr>
  7723. <td>
  7724. <code>repository</code></br>
  7725. <em>
  7726. string
  7727. </em>
  7728. </td>
  7729. <td>
  7730. <em>(Optional)</em>
  7731. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  7732. </td>
  7733. </tr>
  7734. <tr>
  7735. <td>
  7736. <code>environment</code></br>
  7737. <em>
  7738. string
  7739. </em>
  7740. </td>
  7741. <td>
  7742. <em>(Optional)</em>
  7743. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  7744. </td>
  7745. </tr>
  7746. <tr>
  7747. <td>
  7748. <code>orgSecretVisibility</code></br>
  7749. <em>
  7750. string
  7751. </em>
  7752. </td>
  7753. <td>
  7754. <em>(Optional)</em>
  7755. <p>orgSecretVisibility controls the visibility of organization secrets pushed via PushSecret.
  7756. Valid values are &ldquo;all&rdquo; or &ldquo;private&rdquo;.
  7757. When unset, new secrets are created with visibility &ldquo;all&rdquo; and existing secrets preserve
  7758. whatever visibility they already have in GitHub.</p>
  7759. </td>
  7760. </tr>
  7761. </tbody>
  7762. </table>
  7763. <h3 id="external-secrets.io/v1.GitlabAuth">GitlabAuth
  7764. </h3>
  7765. <p>
  7766. (<em>Appears on:</em>
  7767. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>)
  7768. </p>
  7769. <p>
  7770. <p>GitlabAuth defines the authentication method for accessing GitLab API.</p>
  7771. </p>
  7772. <table>
  7773. <thead>
  7774. <tr>
  7775. <th>Field</th>
  7776. <th>Description</th>
  7777. </tr>
  7778. </thead>
  7779. <tbody>
  7780. <tr>
  7781. <td>
  7782. <code>SecretRef</code></br>
  7783. <em>
  7784. <a href="#external-secrets.io/v1.GitlabSecretRef">
  7785. GitlabSecretRef
  7786. </a>
  7787. </em>
  7788. </td>
  7789. <td>
  7790. </td>
  7791. </tr>
  7792. </tbody>
  7793. </table>
  7794. <h3 id="external-secrets.io/v1.GitlabProvider">GitlabProvider
  7795. </h3>
  7796. <p>
  7797. (<em>Appears on:</em>
  7798. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7799. </p>
  7800. <p>
  7801. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  7802. </p>
  7803. <table>
  7804. <thead>
  7805. <tr>
  7806. <th>Field</th>
  7807. <th>Description</th>
  7808. </tr>
  7809. </thead>
  7810. <tbody>
  7811. <tr>
  7812. <td>
  7813. <code>url</code></br>
  7814. <em>
  7815. string
  7816. </em>
  7817. </td>
  7818. <td>
  7819. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  7820. </td>
  7821. </tr>
  7822. <tr>
  7823. <td>
  7824. <code>auth</code></br>
  7825. <em>
  7826. <a href="#external-secrets.io/v1.GitlabAuth">
  7827. GitlabAuth
  7828. </a>
  7829. </em>
  7830. </td>
  7831. <td>
  7832. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  7833. </td>
  7834. </tr>
  7835. <tr>
  7836. <td>
  7837. <code>projectID</code></br>
  7838. <em>
  7839. string
  7840. </em>
  7841. </td>
  7842. <td>
  7843. <p>ProjectID specifies a project where secrets are located.</p>
  7844. </td>
  7845. </tr>
  7846. <tr>
  7847. <td>
  7848. <code>inheritFromGroups</code></br>
  7849. <em>
  7850. bool
  7851. </em>
  7852. </td>
  7853. <td>
  7854. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  7855. </td>
  7856. </tr>
  7857. <tr>
  7858. <td>
  7859. <code>groupIDs</code></br>
  7860. <em>
  7861. []string
  7862. </em>
  7863. </td>
  7864. <td>
  7865. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  7866. </td>
  7867. </tr>
  7868. <tr>
  7869. <td>
  7870. <code>environment</code></br>
  7871. <em>
  7872. string
  7873. </em>
  7874. </td>
  7875. <td>
  7876. <p>Environment environment_scope of gitlab CI/CD variables (Please see <a href="https://docs.gitlab.com/ee/ci/environments/#create-a-static-environment">https://docs.gitlab.com/ee/ci/environments/#create-a-static-environment</a> on how to create environments)</p>
  7877. </td>
  7878. </tr>
  7879. <tr>
  7880. <td>
  7881. <code>caBundle</code></br>
  7882. <em>
  7883. []byte
  7884. </em>
  7885. </td>
  7886. <td>
  7887. <em>(Optional)</em>
  7888. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  7889. can be performed.</p>
  7890. </td>
  7891. </tr>
  7892. <tr>
  7893. <td>
  7894. <code>caProvider</code></br>
  7895. <em>
  7896. <a href="#external-secrets.io/v1.CAProvider">
  7897. CAProvider
  7898. </a>
  7899. </em>
  7900. </td>
  7901. <td>
  7902. <em>(Optional)</em>
  7903. <p>see: <a href="https://external-secrets.io/latest/spec/#external-secrets.io/v1alpha1.CAProvider">https://external-secrets.io/latest/spec/#external-secrets.io/v1alpha1.CAProvider</a></p>
  7904. </td>
  7905. </tr>
  7906. </tbody>
  7907. </table>
  7908. <h3 id="external-secrets.io/v1.GitlabSecretRef">GitlabSecretRef
  7909. </h3>
  7910. <p>
  7911. (<em>Appears on:</em>
  7912. <a href="#external-secrets.io/v1.GitlabAuth">GitlabAuth</a>)
  7913. </p>
  7914. <p>
  7915. <p>GitlabSecretRef contains the secret reference for GitLab authentication credentials.</p>
  7916. </p>
  7917. <table>
  7918. <thead>
  7919. <tr>
  7920. <th>Field</th>
  7921. <th>Description</th>
  7922. </tr>
  7923. </thead>
  7924. <tbody>
  7925. <tr>
  7926. <td>
  7927. <code>accessToken</code></br>
  7928. <em>
  7929. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7930. External Secrets meta/v1.SecretKeySelector
  7931. </a>
  7932. </em>
  7933. </td>
  7934. <td>
  7935. <p>AccessToken is used for authentication.</p>
  7936. </td>
  7937. </tr>
  7938. </tbody>
  7939. </table>
  7940. <h3 id="external-secrets.io/v1.IBMAuth">IBMAuth
  7941. </h3>
  7942. <p>
  7943. (<em>Appears on:</em>
  7944. <a href="#external-secrets.io/v1.IBMProvider">IBMProvider</a>)
  7945. </p>
  7946. <p>
  7947. <p>IBMAuth defines authentication options for connecting to IBM Cloud Secrets Manager.</p>
  7948. </p>
  7949. <table>
  7950. <thead>
  7951. <tr>
  7952. <th>Field</th>
  7953. <th>Description</th>
  7954. </tr>
  7955. </thead>
  7956. <tbody>
  7957. <tr>
  7958. <td>
  7959. <code>secretRef</code></br>
  7960. <em>
  7961. <a href="#external-secrets.io/v1.IBMAuthSecretRef">
  7962. IBMAuthSecretRef
  7963. </a>
  7964. </em>
  7965. </td>
  7966. <td>
  7967. </td>
  7968. </tr>
  7969. <tr>
  7970. <td>
  7971. <code>containerAuth</code></br>
  7972. <em>
  7973. <a href="#external-secrets.io/v1.IBMAuthContainerAuth">
  7974. IBMAuthContainerAuth
  7975. </a>
  7976. </em>
  7977. </td>
  7978. <td>
  7979. </td>
  7980. </tr>
  7981. </tbody>
  7982. </table>
  7983. <h3 id="external-secrets.io/v1.IBMAuthContainerAuth">IBMAuthContainerAuth
  7984. </h3>
  7985. <p>
  7986. (<em>Appears on:</em>
  7987. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  7988. </p>
  7989. <p>
  7990. <p>IBMAuthContainerAuth defines container-based authentication with IAM Trusted Profile.</p>
  7991. </p>
  7992. <table>
  7993. <thead>
  7994. <tr>
  7995. <th>Field</th>
  7996. <th>Description</th>
  7997. </tr>
  7998. </thead>
  7999. <tbody>
  8000. <tr>
  8001. <td>
  8002. <code>profile</code></br>
  8003. <em>
  8004. string
  8005. </em>
  8006. </td>
  8007. <td>
  8008. <p>the IBM Trusted Profile</p>
  8009. </td>
  8010. </tr>
  8011. <tr>
  8012. <td>
  8013. <code>tokenLocation</code></br>
  8014. <em>
  8015. string
  8016. </em>
  8017. </td>
  8018. <td>
  8019. <p>Location the token is mounted on the pod</p>
  8020. </td>
  8021. </tr>
  8022. <tr>
  8023. <td>
  8024. <code>iamEndpoint</code></br>
  8025. <em>
  8026. string
  8027. </em>
  8028. </td>
  8029. <td>
  8030. </td>
  8031. </tr>
  8032. </tbody>
  8033. </table>
  8034. <h3 id="external-secrets.io/v1.IBMAuthSecretRef">IBMAuthSecretRef
  8035. </h3>
  8036. <p>
  8037. (<em>Appears on:</em>
  8038. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  8039. </p>
  8040. <p>
  8041. <p>IBMAuthSecretRef contains the secret reference for IBM Cloud API key authentication.</p>
  8042. </p>
  8043. <table>
  8044. <thead>
  8045. <tr>
  8046. <th>Field</th>
  8047. <th>Description</th>
  8048. </tr>
  8049. </thead>
  8050. <tbody>
  8051. <tr>
  8052. <td>
  8053. <code>secretApiKeySecretRef</code></br>
  8054. <em>
  8055. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8056. External Secrets meta/v1.SecretKeySelector
  8057. </a>
  8058. </em>
  8059. </td>
  8060. <td>
  8061. <p>The SecretAccessKey is used for authentication</p>
  8062. </td>
  8063. </tr>
  8064. <tr>
  8065. <td>
  8066. <code>iamEndpoint</code></br>
  8067. <em>
  8068. string
  8069. </em>
  8070. </td>
  8071. <td>
  8072. <p>The IAM endpoint used to obain a token</p>
  8073. </td>
  8074. </tr>
  8075. </tbody>
  8076. </table>
  8077. <h3 id="external-secrets.io/v1.IBMProvider">IBMProvider
  8078. </h3>
  8079. <p>
  8080. (<em>Appears on:</em>
  8081. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8082. </p>
  8083. <p>
  8084. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager
  8085. backend.</p>
  8086. </p>
  8087. <table>
  8088. <thead>
  8089. <tr>
  8090. <th>Field</th>
  8091. <th>Description</th>
  8092. </tr>
  8093. </thead>
  8094. <tbody>
  8095. <tr>
  8096. <td>
  8097. <code>auth</code></br>
  8098. <em>
  8099. <a href="#external-secrets.io/v1.IBMAuth">
  8100. IBMAuth
  8101. </a>
  8102. </em>
  8103. </td>
  8104. <td>
  8105. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  8106. </td>
  8107. </tr>
  8108. <tr>
  8109. <td>
  8110. <code>serviceUrl</code></br>
  8111. <em>
  8112. string
  8113. </em>
  8114. </td>
  8115. <td>
  8116. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  8117. </td>
  8118. </tr>
  8119. </tbody>
  8120. </table>
  8121. <h3 id="external-secrets.io/v1.InfisicalAuth">InfisicalAuth
  8122. </h3>
  8123. <p>
  8124. (<em>Appears on:</em>
  8125. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8126. </p>
  8127. <p>
  8128. <p>InfisicalAuth specifies the authentication configuration for Infisical.</p>
  8129. </p>
  8130. <table>
  8131. <thead>
  8132. <tr>
  8133. <th>Field</th>
  8134. <th>Description</th>
  8135. </tr>
  8136. </thead>
  8137. <tbody>
  8138. <tr>
  8139. <td>
  8140. <code>universalAuthCredentials</code></br>
  8141. <em>
  8142. <a href="#external-secrets.io/v1.UniversalAuthCredentials">
  8143. UniversalAuthCredentials
  8144. </a>
  8145. </em>
  8146. </td>
  8147. <td>
  8148. <em>(Optional)</em>
  8149. </td>
  8150. </tr>
  8151. <tr>
  8152. <td>
  8153. <code>azureAuthCredentials</code></br>
  8154. <em>
  8155. <a href="#external-secrets.io/v1.AzureAuthCredentials">
  8156. AzureAuthCredentials
  8157. </a>
  8158. </em>
  8159. </td>
  8160. <td>
  8161. <em>(Optional)</em>
  8162. </td>
  8163. </tr>
  8164. <tr>
  8165. <td>
  8166. <code>gcpIdTokenAuthCredentials</code></br>
  8167. <em>
  8168. <a href="#external-secrets.io/v1.GcpIDTokenAuthCredentials">
  8169. GcpIDTokenAuthCredentials
  8170. </a>
  8171. </em>
  8172. </td>
  8173. <td>
  8174. <em>(Optional)</em>
  8175. </td>
  8176. </tr>
  8177. <tr>
  8178. <td>
  8179. <code>gcpIamAuthCredentials</code></br>
  8180. <em>
  8181. <a href="#external-secrets.io/v1.GcpIamAuthCredentials">
  8182. GcpIamAuthCredentials
  8183. </a>
  8184. </em>
  8185. </td>
  8186. <td>
  8187. <em>(Optional)</em>
  8188. </td>
  8189. </tr>
  8190. <tr>
  8191. <td>
  8192. <code>jwtAuthCredentials</code></br>
  8193. <em>
  8194. <a href="#external-secrets.io/v1.JwtAuthCredentials">
  8195. JwtAuthCredentials
  8196. </a>
  8197. </em>
  8198. </td>
  8199. <td>
  8200. <em>(Optional)</em>
  8201. </td>
  8202. </tr>
  8203. <tr>
  8204. <td>
  8205. <code>ldapAuthCredentials</code></br>
  8206. <em>
  8207. <a href="#external-secrets.io/v1.LdapAuthCredentials">
  8208. LdapAuthCredentials
  8209. </a>
  8210. </em>
  8211. </td>
  8212. <td>
  8213. <em>(Optional)</em>
  8214. </td>
  8215. </tr>
  8216. <tr>
  8217. <td>
  8218. <code>ociAuthCredentials</code></br>
  8219. <em>
  8220. <a href="#external-secrets.io/v1.OciAuthCredentials">
  8221. OciAuthCredentials
  8222. </a>
  8223. </em>
  8224. </td>
  8225. <td>
  8226. <em>(Optional)</em>
  8227. </td>
  8228. </tr>
  8229. <tr>
  8230. <td>
  8231. <code>kubernetesAuthCredentials</code></br>
  8232. <em>
  8233. <a href="#external-secrets.io/v1.KubernetesAuthCredentials">
  8234. KubernetesAuthCredentials
  8235. </a>
  8236. </em>
  8237. </td>
  8238. <td>
  8239. <em>(Optional)</em>
  8240. </td>
  8241. </tr>
  8242. <tr>
  8243. <td>
  8244. <code>awsAuthCredentials</code></br>
  8245. <em>
  8246. <a href="#external-secrets.io/v1.AwsAuthCredentials">
  8247. AwsAuthCredentials
  8248. </a>
  8249. </em>
  8250. </td>
  8251. <td>
  8252. <em>(Optional)</em>
  8253. </td>
  8254. </tr>
  8255. <tr>
  8256. <td>
  8257. <code>tokenAuthCredentials</code></br>
  8258. <em>
  8259. <a href="#external-secrets.io/v1.TokenAuthCredentials">
  8260. TokenAuthCredentials
  8261. </a>
  8262. </em>
  8263. </td>
  8264. <td>
  8265. <em>(Optional)</em>
  8266. </td>
  8267. </tr>
  8268. </tbody>
  8269. </table>
  8270. <h3 id="external-secrets.io/v1.InfisicalProvider">InfisicalProvider
  8271. </h3>
  8272. <p>
  8273. (<em>Appears on:</em>
  8274. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8275. </p>
  8276. <p>
  8277. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  8278. </p>
  8279. <table>
  8280. <thead>
  8281. <tr>
  8282. <th>Field</th>
  8283. <th>Description</th>
  8284. </tr>
  8285. </thead>
  8286. <tbody>
  8287. <tr>
  8288. <td>
  8289. <code>auth</code></br>
  8290. <em>
  8291. <a href="#external-secrets.io/v1.InfisicalAuth">
  8292. InfisicalAuth
  8293. </a>
  8294. </em>
  8295. </td>
  8296. <td>
  8297. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  8298. </td>
  8299. </tr>
  8300. <tr>
  8301. <td>
  8302. <code>secretsScope</code></br>
  8303. <em>
  8304. <a href="#external-secrets.io/v1.MachineIdentityScopeInWorkspace">
  8305. MachineIdentityScopeInWorkspace
  8306. </a>
  8307. </em>
  8308. </td>
  8309. <td>
  8310. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  8311. </td>
  8312. </tr>
  8313. <tr>
  8314. <td>
  8315. <code>hostAPI</code></br>
  8316. <em>
  8317. string
  8318. </em>
  8319. </td>
  8320. <td>
  8321. <em>(Optional)</em>
  8322. <p>HostAPI specifies the base URL of the Infisical API. If not provided, it defaults to &ldquo;<a href="https://app.infisical.com/api&quot;">https://app.infisical.com/api&rdquo;</a>.</p>
  8323. </td>
  8324. </tr>
  8325. <tr>
  8326. <td>
  8327. <code>caBundle</code></br>
  8328. <em>
  8329. []byte
  8330. </em>
  8331. </td>
  8332. <td>
  8333. <em>(Optional)</em>
  8334. <p>CABundle is a PEM-encoded CA certificate bundle used to validate
  8335. the Infisical server&rsquo;s TLS certificate. Mutually exclusive with CAProvider.</p>
  8336. </td>
  8337. </tr>
  8338. <tr>
  8339. <td>
  8340. <code>caProvider</code></br>
  8341. <em>
  8342. <a href="#external-secrets.io/v1.CAProvider">
  8343. CAProvider
  8344. </a>
  8345. </em>
  8346. </td>
  8347. <td>
  8348. <em>(Optional)</em>
  8349. <p>CAProvider is a reference to a Secret or ConfigMap that contains a CA certificate.
  8350. The certificate is used to validate the Infisical server&rsquo;s TLS certificate.
  8351. Mutually exclusive with CABundle.</p>
  8352. </td>
  8353. </tr>
  8354. </tbody>
  8355. </table>
  8356. <h3 id="external-secrets.io/v1.IntegrationInfo">IntegrationInfo
  8357. </h3>
  8358. <p>
  8359. (<em>Appears on:</em>
  8360. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  8361. </p>
  8362. <p>
  8363. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.</p>
  8364. </p>
  8365. <table>
  8366. <thead>
  8367. <tr>
  8368. <th>Field</th>
  8369. <th>Description</th>
  8370. </tr>
  8371. </thead>
  8372. <tbody>
  8373. <tr>
  8374. <td>
  8375. <code>name</code></br>
  8376. <em>
  8377. string
  8378. </em>
  8379. </td>
  8380. <td>
  8381. <p>Name defaults to &ldquo;1Password SDK&rdquo;.</p>
  8382. </td>
  8383. </tr>
  8384. <tr>
  8385. <td>
  8386. <code>version</code></br>
  8387. <em>
  8388. string
  8389. </em>
  8390. </td>
  8391. <td>
  8392. <p>Version defaults to &ldquo;v1.0.0&rdquo;.</p>
  8393. </td>
  8394. </tr>
  8395. </tbody>
  8396. </table>
  8397. <h3 id="external-secrets.io/v1.JwtAuthCredentials">JwtAuthCredentials
  8398. </h3>
  8399. <p>
  8400. (<em>Appears on:</em>
  8401. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8402. </p>
  8403. <p>
  8404. <p>JwtAuthCredentials represents the credentials for JWT authentication.</p>
  8405. </p>
  8406. <table>
  8407. <thead>
  8408. <tr>
  8409. <th>Field</th>
  8410. <th>Description</th>
  8411. </tr>
  8412. </thead>
  8413. <tbody>
  8414. <tr>
  8415. <td>
  8416. <code>identityId</code></br>
  8417. <em>
  8418. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8419. External Secrets meta/v1.SecretKeySelector
  8420. </a>
  8421. </em>
  8422. </td>
  8423. <td>
  8424. </td>
  8425. </tr>
  8426. <tr>
  8427. <td>
  8428. <code>jwt</code></br>
  8429. <em>
  8430. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8431. External Secrets meta/v1.SecretKeySelector
  8432. </a>
  8433. </em>
  8434. </td>
  8435. <td>
  8436. </td>
  8437. </tr>
  8438. </tbody>
  8439. </table>
  8440. <h3 id="external-secrets.io/v1.KeeperSecurityProvider">KeeperSecurityProvider
  8441. </h3>
  8442. <p>
  8443. (<em>Appears on:</em>
  8444. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8445. </p>
  8446. <p>
  8447. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  8448. </p>
  8449. <table>
  8450. <thead>
  8451. <tr>
  8452. <th>Field</th>
  8453. <th>Description</th>
  8454. </tr>
  8455. </thead>
  8456. <tbody>
  8457. <tr>
  8458. <td>
  8459. <code>authRef</code></br>
  8460. <em>
  8461. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8462. External Secrets meta/v1.SecretKeySelector
  8463. </a>
  8464. </em>
  8465. </td>
  8466. <td>
  8467. </td>
  8468. </tr>
  8469. <tr>
  8470. <td>
  8471. <code>folderID</code></br>
  8472. <em>
  8473. string
  8474. </em>
  8475. </td>
  8476. <td>
  8477. </td>
  8478. </tr>
  8479. <tr>
  8480. <td>
  8481. <code>getByTitleFallback</code></br>
  8482. <em>
  8483. bool
  8484. </em>
  8485. </td>
  8486. <td>
  8487. </td>
  8488. </tr>
  8489. </tbody>
  8490. </table>
  8491. <h3 id="external-secrets.io/v1.KubernetesAuth">KubernetesAuth
  8492. </h3>
  8493. <p>
  8494. (<em>Appears on:</em>
  8495. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8496. </p>
  8497. <p>
  8498. <p>KubernetesAuth defines authentication options for connecting to a Kubernetes cluster.</p>
  8499. </p>
  8500. <table>
  8501. <thead>
  8502. <tr>
  8503. <th>Field</th>
  8504. <th>Description</th>
  8505. </tr>
  8506. </thead>
  8507. <tbody>
  8508. <tr>
  8509. <td>
  8510. <code>cert</code></br>
  8511. <em>
  8512. <a href="#external-secrets.io/v1.CertAuth">
  8513. CertAuth
  8514. </a>
  8515. </em>
  8516. </td>
  8517. <td>
  8518. <em>(Optional)</em>
  8519. <p>has both clientCert and clientKey as secretKeySelector</p>
  8520. </td>
  8521. </tr>
  8522. <tr>
  8523. <td>
  8524. <code>token</code></br>
  8525. <em>
  8526. <a href="#external-secrets.io/v1.TokenAuth">
  8527. TokenAuth
  8528. </a>
  8529. </em>
  8530. </td>
  8531. <td>
  8532. <em>(Optional)</em>
  8533. <p>use static token to authenticate with</p>
  8534. </td>
  8535. </tr>
  8536. <tr>
  8537. <td>
  8538. <code>serviceAccount</code></br>
  8539. <em>
  8540. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  8541. External Secrets meta/v1.ServiceAccountSelector
  8542. </a>
  8543. </em>
  8544. </td>
  8545. <td>
  8546. <em>(Optional)</em>
  8547. <p>points to a service account that should be used for authentication</p>
  8548. </td>
  8549. </tr>
  8550. </tbody>
  8551. </table>
  8552. <h3 id="external-secrets.io/v1.KubernetesAuthCredentials">KubernetesAuthCredentials
  8553. </h3>
  8554. <p>
  8555. (<em>Appears on:</em>
  8556. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8557. </p>
  8558. <p>
  8559. <p>KubernetesAuthCredentials represents the credentials for Kubernetes authentication.</p>
  8560. </p>
  8561. <table>
  8562. <thead>
  8563. <tr>
  8564. <th>Field</th>
  8565. <th>Description</th>
  8566. </tr>
  8567. </thead>
  8568. <tbody>
  8569. <tr>
  8570. <td>
  8571. <code>identityId</code></br>
  8572. <em>
  8573. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8574. External Secrets meta/v1.SecretKeySelector
  8575. </a>
  8576. </em>
  8577. </td>
  8578. <td>
  8579. </td>
  8580. </tr>
  8581. <tr>
  8582. <td>
  8583. <code>serviceAccountTokenPath</code></br>
  8584. <em>
  8585. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8586. External Secrets meta/v1.SecretKeySelector
  8587. </a>
  8588. </em>
  8589. </td>
  8590. <td>
  8591. <em>(Optional)</em>
  8592. </td>
  8593. </tr>
  8594. </tbody>
  8595. </table>
  8596. <h3 id="external-secrets.io/v1.KubernetesProvider">KubernetesProvider
  8597. </h3>
  8598. <p>
  8599. (<em>Appears on:</em>
  8600. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8601. </p>
  8602. <p>
  8603. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  8604. </p>
  8605. <table>
  8606. <thead>
  8607. <tr>
  8608. <th>Field</th>
  8609. <th>Description</th>
  8610. </tr>
  8611. </thead>
  8612. <tbody>
  8613. <tr>
  8614. <td>
  8615. <code>server</code></br>
  8616. <em>
  8617. <a href="#external-secrets.io/v1.KubernetesServer">
  8618. KubernetesServer
  8619. </a>
  8620. </em>
  8621. </td>
  8622. <td>
  8623. <em>(Optional)</em>
  8624. <p>configures the Kubernetes server Address.</p>
  8625. </td>
  8626. </tr>
  8627. <tr>
  8628. <td>
  8629. <code>auth</code></br>
  8630. <em>
  8631. <a href="#external-secrets.io/v1.KubernetesAuth">
  8632. KubernetesAuth
  8633. </a>
  8634. </em>
  8635. </td>
  8636. <td>
  8637. <em>(Optional)</em>
  8638. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  8639. </td>
  8640. </tr>
  8641. <tr>
  8642. <td>
  8643. <code>authRef</code></br>
  8644. <em>
  8645. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8646. External Secrets meta/v1.SecretKeySelector
  8647. </a>
  8648. </em>
  8649. </td>
  8650. <td>
  8651. <em>(Optional)</em>
  8652. <p>A reference to a secret that contains the auth information.</p>
  8653. </td>
  8654. </tr>
  8655. <tr>
  8656. <td>
  8657. <code>remoteNamespace</code></br>
  8658. <em>
  8659. string
  8660. </em>
  8661. </td>
  8662. <td>
  8663. <em>(Optional)</em>
  8664. <p>Remote namespace to fetch the secrets from</p>
  8665. </td>
  8666. </tr>
  8667. </tbody>
  8668. </table>
  8669. <h3 id="external-secrets.io/v1.KubernetesServer">KubernetesServer
  8670. </h3>
  8671. <p>
  8672. (<em>Appears on:</em>
  8673. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8674. </p>
  8675. <p>
  8676. <p>KubernetesServer defines configuration for connecting to a Kubernetes API server.</p>
  8677. </p>
  8678. <table>
  8679. <thead>
  8680. <tr>
  8681. <th>Field</th>
  8682. <th>Description</th>
  8683. </tr>
  8684. </thead>
  8685. <tbody>
  8686. <tr>
  8687. <td>
  8688. <code>url</code></br>
  8689. <em>
  8690. string
  8691. </em>
  8692. </td>
  8693. <td>
  8694. <em>(Optional)</em>
  8695. <p>configures the Kubernetes server Address.</p>
  8696. </td>
  8697. </tr>
  8698. <tr>
  8699. <td>
  8700. <code>caBundle</code></br>
  8701. <em>
  8702. []byte
  8703. </em>
  8704. </td>
  8705. <td>
  8706. <em>(Optional)</em>
  8707. <p>CABundle is a base64-encoded CA certificate</p>
  8708. </td>
  8709. </tr>
  8710. <tr>
  8711. <td>
  8712. <code>caProvider</code></br>
  8713. <em>
  8714. <a href="#external-secrets.io/v1.CAProvider">
  8715. CAProvider
  8716. </a>
  8717. </em>
  8718. </td>
  8719. <td>
  8720. <em>(Optional)</em>
  8721. <p>see: <a href="https://external-secrets.io/v0.4.1/spec/#external-secrets.io/v1alpha1.CAProvider">https://external-secrets.io/v0.4.1/spec/#external-secrets.io/v1alpha1.CAProvider</a></p>
  8722. </td>
  8723. </tr>
  8724. </tbody>
  8725. </table>
  8726. <h3 id="external-secrets.io/v1.LdapAuthCredentials">LdapAuthCredentials
  8727. </h3>
  8728. <p>
  8729. (<em>Appears on:</em>
  8730. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8731. </p>
  8732. <p>
  8733. <p>LdapAuthCredentials represents the credentials for LDAP authentication.</p>
  8734. </p>
  8735. <table>
  8736. <thead>
  8737. <tr>
  8738. <th>Field</th>
  8739. <th>Description</th>
  8740. </tr>
  8741. </thead>
  8742. <tbody>
  8743. <tr>
  8744. <td>
  8745. <code>identityId</code></br>
  8746. <em>
  8747. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8748. External Secrets meta/v1.SecretKeySelector
  8749. </a>
  8750. </em>
  8751. </td>
  8752. <td>
  8753. </td>
  8754. </tr>
  8755. <tr>
  8756. <td>
  8757. <code>ldapPassword</code></br>
  8758. <em>
  8759. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8760. External Secrets meta/v1.SecretKeySelector
  8761. </a>
  8762. </em>
  8763. </td>
  8764. <td>
  8765. </td>
  8766. </tr>
  8767. <tr>
  8768. <td>
  8769. <code>ldapUsername</code></br>
  8770. <em>
  8771. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8772. External Secrets meta/v1.SecretKeySelector
  8773. </a>
  8774. </em>
  8775. </td>
  8776. <td>
  8777. </td>
  8778. </tr>
  8779. </tbody>
  8780. </table>
  8781. <h3 id="external-secrets.io/v1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  8782. </h3>
  8783. <p>
  8784. (<em>Appears on:</em>
  8785. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8786. </p>
  8787. <p>
  8788. <p>MachineIdentityScopeInWorkspace defines the scope for machine identity within a workspace.</p>
  8789. </p>
  8790. <table>
  8791. <thead>
  8792. <tr>
  8793. <th>Field</th>
  8794. <th>Description</th>
  8795. </tr>
  8796. </thead>
  8797. <tbody>
  8798. <tr>
  8799. <td>
  8800. <code>secretsPath</code></br>
  8801. <em>
  8802. string
  8803. </em>
  8804. </td>
  8805. <td>
  8806. <em>(Optional)</em>
  8807. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  8808. </td>
  8809. </tr>
  8810. <tr>
  8811. <td>
  8812. <code>recursive</code></br>
  8813. <em>
  8814. bool
  8815. </em>
  8816. </td>
  8817. <td>
  8818. <em>(Optional)</em>
  8819. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  8820. </td>
  8821. </tr>
  8822. <tr>
  8823. <td>
  8824. <code>environmentSlug</code></br>
  8825. <em>
  8826. string
  8827. </em>
  8828. </td>
  8829. <td>
  8830. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  8831. </td>
  8832. </tr>
  8833. <tr>
  8834. <td>
  8835. <code>projectSlug</code></br>
  8836. <em>
  8837. string
  8838. </em>
  8839. </td>
  8840. <td>
  8841. <p>ProjectSlug is the required slug identifier for the project.</p>
  8842. </td>
  8843. </tr>
  8844. <tr>
  8845. <td>
  8846. <code>organizationSlug</code></br>
  8847. <em>
  8848. string
  8849. </em>
  8850. </td>
  8851. <td>
  8852. <p>OrganizationSlug is the optional slug that identifies the organization that will be used
  8853. during authentication. Useful for sub-organization setups</p>
  8854. </td>
  8855. </tr>
  8856. <tr>
  8857. <td>
  8858. <code>expandSecretReferences</code></br>
  8859. <em>
  8860. bool
  8861. </em>
  8862. </td>
  8863. <td>
  8864. <em>(Optional)</em>
  8865. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  8866. </td>
  8867. </tr>
  8868. </tbody>
  8869. </table>
  8870. <h3 id="external-secrets.io/v1.MaintenanceStatus">MaintenanceStatus
  8871. (<code>string</code> alias)</p></h3>
  8872. <p>
  8873. <p>MaintenanceStatus defines a type for different maintenance states of a provider schema.</p>
  8874. </p>
  8875. <table>
  8876. <thead>
  8877. <tr>
  8878. <th>Value</th>
  8879. <th>Description</th>
  8880. </tr>
  8881. </thead>
  8882. <tbody><tr><td><p>&#34;Deprecated&#34;</p></td>
  8883. <td></td>
  8884. </tr><tr><td><p>&#34;Maintained&#34;</p></td>
  8885. <td></td>
  8886. </tr><tr><td><p>&#34;NotMaintained&#34;</p></td>
  8887. <td></td>
  8888. </tr></tbody>
  8889. </table>
  8890. <h3 id="external-secrets.io/v1.ManifestReference">ManifestReference
  8891. </h3>
  8892. <p>
  8893. (<em>Appears on:</em>
  8894. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  8895. </p>
  8896. <p>
  8897. <p>ManifestReference defines a custom Kubernetes resource type to be created
  8898. instead of a Secret. This allows ExternalSecret to create ConfigMaps,
  8899. Custom Resources, or any other Kubernetes resource type.</p>
  8900. </p>
  8901. <table>
  8902. <thead>
  8903. <tr>
  8904. <th>Field</th>
  8905. <th>Description</th>
  8906. </tr>
  8907. </thead>
  8908. <tbody>
  8909. <tr>
  8910. <td>
  8911. <code>apiVersion</code></br>
  8912. <em>
  8913. string
  8914. </em>
  8915. </td>
  8916. <td>
  8917. <p>APIVersion of the target resource (e.g., &ldquo;v1&rdquo; for ConfigMap, &ldquo;argoproj.io/v1alpha1&rdquo; for ArgoCD Application)</p>
  8918. </td>
  8919. </tr>
  8920. <tr>
  8921. <td>
  8922. <code>kind</code></br>
  8923. <em>
  8924. string
  8925. </em>
  8926. </td>
  8927. <td>
  8928. <p>Kind of the target resource (e.g., &ldquo;ConfigMap&rdquo;, &ldquo;Application&rdquo;)</p>
  8929. </td>
  8930. </tr>
  8931. </tbody>
  8932. </table>
  8933. <h3 id="external-secrets.io/v1.NTLMProtocol">NTLMProtocol
  8934. </h3>
  8935. <p>
  8936. (<em>Appears on:</em>
  8937. <a href="#external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol</a>)
  8938. </p>
  8939. <p>
  8940. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  8941. </p>
  8942. <table>
  8943. <thead>
  8944. <tr>
  8945. <th>Field</th>
  8946. <th>Description</th>
  8947. </tr>
  8948. </thead>
  8949. <tbody>
  8950. <tr>
  8951. <td>
  8952. <code>usernameSecret</code></br>
  8953. <em>
  8954. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8955. External Secrets meta/v1.SecretKeySelector
  8956. </a>
  8957. </em>
  8958. </td>
  8959. <td>
  8960. </td>
  8961. </tr>
  8962. <tr>
  8963. <td>
  8964. <code>passwordSecret</code></br>
  8965. <em>
  8966. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8967. External Secrets meta/v1.SecretKeySelector
  8968. </a>
  8969. </em>
  8970. </td>
  8971. <td>
  8972. </td>
  8973. </tr>
  8974. </tbody>
  8975. </table>
  8976. <h3 id="external-secrets.io/v1.NebiusAuth">NebiusAuth
  8977. </h3>
  8978. <p>
  8979. (<em>Appears on:</em>
  8980. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  8981. </p>
  8982. <p>
  8983. <p>NebiusAuth defines the authentication method for the Nebius provider.</p>
  8984. </p>
  8985. <table>
  8986. <thead>
  8987. <tr>
  8988. <th>Field</th>
  8989. <th>Description</th>
  8990. </tr>
  8991. </thead>
  8992. <tbody>
  8993. <tr>
  8994. <td>
  8995. <code>serviceAccountCredsSecretRef</code></br>
  8996. <em>
  8997. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8998. External Secrets meta/v1.SecretKeySelector
  8999. </a>
  9000. </em>
  9001. </td>
  9002. <td>
  9003. <em>(Optional)</em>
  9004. <p>ServiceAccountCreds references a Kubernetes Secret key that contains a JSON
  9005. document with service account credentials used to get an IAM token.</p>
  9006. <p>Expected JSON structure:
  9007. {
  9008. &ldquo;subject-credentials&rdquo;: {
  9009. &ldquo;alg&rdquo;: &ldquo;RS256&rdquo;,
  9010. &ldquo;private-key&rdquo;: &ldquo;&mdash;&ndash;BEGIN PRIVATE KEY&mdash;&ndash;\n<private-key>\n&mdash;&ndash;END PRIVATE KEY&mdash;&ndash;\n&rdquo;,
  9011. &ldquo;kid&rdquo;: &ldquo;<public-key-id>&rdquo;,
  9012. &ldquo;iss&rdquo;: &ldquo;<issuer-service-account-id>&rdquo;,
  9013. &ldquo;sub&rdquo;: &ldquo;<subject-service-account-id>&rdquo;
  9014. }
  9015. }</p>
  9016. </td>
  9017. </tr>
  9018. <tr>
  9019. <td>
  9020. <code>tokenSecretRef</code></br>
  9021. <em>
  9022. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9023. External Secrets meta/v1.SecretKeySelector
  9024. </a>
  9025. </em>
  9026. </td>
  9027. <td>
  9028. <em>(Optional)</em>
  9029. <p>Token authenticates with Nebius Mysterybox by presenting a token.</p>
  9030. </td>
  9031. </tr>
  9032. </tbody>
  9033. </table>
  9034. <h3 id="external-secrets.io/v1.NebiusCAProvider">NebiusCAProvider
  9035. </h3>
  9036. <p>
  9037. (<em>Appears on:</em>
  9038. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  9039. </p>
  9040. <p>
  9041. <p>NebiusCAProvider The provider for the CA bundle to use to validate Nebius server certificate.</p>
  9042. </p>
  9043. <table>
  9044. <thead>
  9045. <tr>
  9046. <th>Field</th>
  9047. <th>Description</th>
  9048. </tr>
  9049. </thead>
  9050. <tbody>
  9051. <tr>
  9052. <td>
  9053. <code>certSecretRef</code></br>
  9054. <em>
  9055. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9056. External Secrets meta/v1.SecretKeySelector
  9057. </a>
  9058. </em>
  9059. </td>
  9060. <td>
  9061. <em>(Optional)</em>
  9062. </td>
  9063. </tr>
  9064. </tbody>
  9065. </table>
  9066. <h3 id="external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider
  9067. </h3>
  9068. <p>
  9069. (<em>Appears on:</em>
  9070. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9071. </p>
  9072. <p>
  9073. <p>NebiusMysteryboxProvider Configures a store to sync secrets using the Nebius Mysterybox provider.</p>
  9074. </p>
  9075. <table>
  9076. <thead>
  9077. <tr>
  9078. <th>Field</th>
  9079. <th>Description</th>
  9080. </tr>
  9081. </thead>
  9082. <tbody>
  9083. <tr>
  9084. <td>
  9085. <code>apiDomain</code></br>
  9086. <em>
  9087. string
  9088. </em>
  9089. </td>
  9090. <td>
  9091. <p>NebiusMysterybox API endpoint</p>
  9092. </td>
  9093. </tr>
  9094. <tr>
  9095. <td>
  9096. <code>auth</code></br>
  9097. <em>
  9098. <a href="#external-secrets.io/v1.NebiusAuth">
  9099. NebiusAuth
  9100. </a>
  9101. </em>
  9102. </td>
  9103. <td>
  9104. <p>Auth defines parameters to authenticate in MysteryBox</p>
  9105. </td>
  9106. </tr>
  9107. <tr>
  9108. <td>
  9109. <code>caProvider</code></br>
  9110. <em>
  9111. <a href="#external-secrets.io/v1.NebiusCAProvider">
  9112. NebiusCAProvider
  9113. </a>
  9114. </em>
  9115. </td>
  9116. <td>
  9117. <em>(Optional)</em>
  9118. <p>The provider for the CA bundle to use to validate NebiusMysterybox server certificate.</p>
  9119. </td>
  9120. </tr>
  9121. </tbody>
  9122. </table>
  9123. <h3 id="external-secrets.io/v1.NgrokAuth">NgrokAuth
  9124. </h3>
  9125. <p>
  9126. (<em>Appears on:</em>
  9127. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  9128. </p>
  9129. <p>
  9130. <p>NgrokAuth configures the authentication method for the ngrok provider.</p>
  9131. </p>
  9132. <table>
  9133. <thead>
  9134. <tr>
  9135. <th>Field</th>
  9136. <th>Description</th>
  9137. </tr>
  9138. </thead>
  9139. <tbody>
  9140. <tr>
  9141. <td>
  9142. <code>apiKey</code></br>
  9143. <em>
  9144. <a href="#external-secrets.io/v1.NgrokProviderSecretRef">
  9145. NgrokProviderSecretRef
  9146. </a>
  9147. </em>
  9148. </td>
  9149. <td>
  9150. <em>(Optional)</em>
  9151. <p>APIKey is the API Key used to authenticate with ngrok. See <a href="https://ngrok.com/docs/api/#authentication">https://ngrok.com/docs/api/#authentication</a></p>
  9152. </td>
  9153. </tr>
  9154. </tbody>
  9155. </table>
  9156. <h3 id="external-secrets.io/v1.NgrokProvider">NgrokProvider
  9157. </h3>
  9158. <p>
  9159. (<em>Appears on:</em>
  9160. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9161. </p>
  9162. <p>
  9163. <p>NgrokProvider configures a store to sync secrets with a ngrok vault to use in traffic policies.
  9164. See: <a href="https://ngrok.com/blog-post/secrets-for-traffic-policy">https://ngrok.com/blog-post/secrets-for-traffic-policy</a></p>
  9165. </p>
  9166. <table>
  9167. <thead>
  9168. <tr>
  9169. <th>Field</th>
  9170. <th>Description</th>
  9171. </tr>
  9172. </thead>
  9173. <tbody>
  9174. <tr>
  9175. <td>
  9176. <code>apiUrl</code></br>
  9177. <em>
  9178. string
  9179. </em>
  9180. </td>
  9181. <td>
  9182. <p>APIURL is the URL of the ngrok API.</p>
  9183. </td>
  9184. </tr>
  9185. <tr>
  9186. <td>
  9187. <code>auth</code></br>
  9188. <em>
  9189. <a href="#external-secrets.io/v1.NgrokAuth">
  9190. NgrokAuth
  9191. </a>
  9192. </em>
  9193. </td>
  9194. <td>
  9195. <p>Auth configures how the ngrok provider authenticates with the ngrok API.</p>
  9196. </td>
  9197. </tr>
  9198. <tr>
  9199. <td>
  9200. <code>vault</code></br>
  9201. <em>
  9202. <a href="#external-secrets.io/v1.NgrokVault">
  9203. NgrokVault
  9204. </a>
  9205. </em>
  9206. </td>
  9207. <td>
  9208. <p>Vault configures the ngrok vault to sync secrets with.</p>
  9209. </td>
  9210. </tr>
  9211. </tbody>
  9212. </table>
  9213. <h3 id="external-secrets.io/v1.NgrokProviderSecretRef">NgrokProviderSecretRef
  9214. </h3>
  9215. <p>
  9216. (<em>Appears on:</em>
  9217. <a href="#external-secrets.io/v1.NgrokAuth">NgrokAuth</a>)
  9218. </p>
  9219. <p>
  9220. <p>NgrokProviderSecretRef contains the secret reference for the ngrok provider.</p>
  9221. </p>
  9222. <table>
  9223. <thead>
  9224. <tr>
  9225. <th>Field</th>
  9226. <th>Description</th>
  9227. </tr>
  9228. </thead>
  9229. <tbody>
  9230. <tr>
  9231. <td>
  9232. <code>secretRef</code></br>
  9233. <em>
  9234. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9235. External Secrets meta/v1.SecretKeySelector
  9236. </a>
  9237. </em>
  9238. </td>
  9239. <td>
  9240. <em>(Optional)</em>
  9241. <p>SecretRef is a reference to a secret containing the ngrok API key.</p>
  9242. </td>
  9243. </tr>
  9244. </tbody>
  9245. </table>
  9246. <h3 id="external-secrets.io/v1.NgrokVault">NgrokVault
  9247. </h3>
  9248. <p>
  9249. (<em>Appears on:</em>
  9250. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  9251. </p>
  9252. <p>
  9253. <p>NgrokVault configures the ngrok vault to sync secrets with.</p>
  9254. </p>
  9255. <table>
  9256. <thead>
  9257. <tr>
  9258. <th>Field</th>
  9259. <th>Description</th>
  9260. </tr>
  9261. </thead>
  9262. <tbody>
  9263. <tr>
  9264. <td>
  9265. <code>name</code></br>
  9266. <em>
  9267. string
  9268. </em>
  9269. </td>
  9270. <td>
  9271. <p>Name is the name of the ngrok vault to sync secrets with.</p>
  9272. </td>
  9273. </tr>
  9274. </tbody>
  9275. </table>
  9276. <h3 id="external-secrets.io/v1.NoSecretError">NoSecretError
  9277. </h3>
  9278. <p>
  9279. <p>NoSecretError shall be returned when a GetSecret can not find the
  9280. desired secret. This is used for deletionPolicy.</p>
  9281. </p>
  9282. <h3 id="external-secrets.io/v1.NotModifiedError">NotModifiedError
  9283. </h3>
  9284. <p>
  9285. <p>NotModifiedError to signal that the webhook received no changes,
  9286. and it should just return without doing anything.</p>
  9287. </p>
  9288. <h3 id="external-secrets.io/v1.OciAuthCredentials">OciAuthCredentials
  9289. </h3>
  9290. <p>
  9291. (<em>Appears on:</em>
  9292. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  9293. </p>
  9294. <p>
  9295. <p>OciAuthCredentials represents the credentials for OCI authentication.</p>
  9296. </p>
  9297. <table>
  9298. <thead>
  9299. <tr>
  9300. <th>Field</th>
  9301. <th>Description</th>
  9302. </tr>
  9303. </thead>
  9304. <tbody>
  9305. <tr>
  9306. <td>
  9307. <code>identityId</code></br>
  9308. <em>
  9309. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9310. External Secrets meta/v1.SecretKeySelector
  9311. </a>
  9312. </em>
  9313. </td>
  9314. <td>
  9315. </td>
  9316. </tr>
  9317. <tr>
  9318. <td>
  9319. <code>privateKey</code></br>
  9320. <em>
  9321. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9322. External Secrets meta/v1.SecretKeySelector
  9323. </a>
  9324. </em>
  9325. </td>
  9326. <td>
  9327. </td>
  9328. </tr>
  9329. <tr>
  9330. <td>
  9331. <code>privateKeyPassphrase</code></br>
  9332. <em>
  9333. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9334. External Secrets meta/v1.SecretKeySelector
  9335. </a>
  9336. </em>
  9337. </td>
  9338. <td>
  9339. <em>(Optional)</em>
  9340. </td>
  9341. </tr>
  9342. <tr>
  9343. <td>
  9344. <code>fingerprint</code></br>
  9345. <em>
  9346. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9347. External Secrets meta/v1.SecretKeySelector
  9348. </a>
  9349. </em>
  9350. </td>
  9351. <td>
  9352. </td>
  9353. </tr>
  9354. <tr>
  9355. <td>
  9356. <code>userId</code></br>
  9357. <em>
  9358. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9359. External Secrets meta/v1.SecretKeySelector
  9360. </a>
  9361. </em>
  9362. </td>
  9363. <td>
  9364. </td>
  9365. </tr>
  9366. <tr>
  9367. <td>
  9368. <code>tenancyId</code></br>
  9369. <em>
  9370. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9371. External Secrets meta/v1.SecretKeySelector
  9372. </a>
  9373. </em>
  9374. </td>
  9375. <td>
  9376. </td>
  9377. </tr>
  9378. <tr>
  9379. <td>
  9380. <code>region</code></br>
  9381. <em>
  9382. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9383. External Secrets meta/v1.SecretKeySelector
  9384. </a>
  9385. </em>
  9386. </td>
  9387. <td>
  9388. </td>
  9389. </tr>
  9390. </tbody>
  9391. </table>
  9392. <h3 id="external-secrets.io/v1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  9393. </h3>
  9394. <p>
  9395. (<em>Appears on:</em>
  9396. <a href="#external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider</a>)
  9397. </p>
  9398. <p>
  9399. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  9400. </p>
  9401. <table>
  9402. <thead>
  9403. <tr>
  9404. <th>Field</th>
  9405. <th>Description</th>
  9406. </tr>
  9407. </thead>
  9408. <tbody>
  9409. <tr>
  9410. <td>
  9411. <code>apiKeyRef</code></br>
  9412. <em>
  9413. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9414. External Secrets meta/v1.SecretKeySelector
  9415. </a>
  9416. </em>
  9417. </td>
  9418. <td>
  9419. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  9420. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  9421. </td>
  9422. </tr>
  9423. <tr>
  9424. <td>
  9425. <code>passcodeRef</code></br>
  9426. <em>
  9427. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9428. External Secrets meta/v1.SecretKeySelector
  9429. </a>
  9430. </em>
  9431. </td>
  9432. <td>
  9433. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  9434. </td>
  9435. </tr>
  9436. </tbody>
  9437. </table>
  9438. <h3 id="external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider
  9439. </h3>
  9440. <p>
  9441. (<em>Appears on:</em>
  9442. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9443. </p>
  9444. <p>
  9445. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  9446. Project and Config are required if not using a Service Token.</p>
  9447. </p>
  9448. <table>
  9449. <thead>
  9450. <tr>
  9451. <th>Field</th>
  9452. <th>Description</th>
  9453. </tr>
  9454. </thead>
  9455. <tbody>
  9456. <tr>
  9457. <td>
  9458. <code>auth</code></br>
  9459. <em>
  9460. <a href="#external-secrets.io/v1.OnboardbaseAuthSecretRef">
  9461. OnboardbaseAuthSecretRef
  9462. </a>
  9463. </em>
  9464. </td>
  9465. <td>
  9466. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  9467. </td>
  9468. </tr>
  9469. <tr>
  9470. <td>
  9471. <code>apiHost</code></br>
  9472. <em>
  9473. string
  9474. </em>
  9475. </td>
  9476. <td>
  9477. <p>APIHost use this to configure the host url for the API for selfhosted installation, default is <a href="https://public.onboardbase.com/api/v1/">https://public.onboardbase.com/api/v1/</a></p>
  9478. </td>
  9479. </tr>
  9480. <tr>
  9481. <td>
  9482. <code>project</code></br>
  9483. <em>
  9484. string
  9485. </em>
  9486. </td>
  9487. <td>
  9488. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  9489. </td>
  9490. </tr>
  9491. <tr>
  9492. <td>
  9493. <code>environment</code></br>
  9494. <em>
  9495. string
  9496. </em>
  9497. </td>
  9498. <td>
  9499. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  9500. </td>
  9501. </tr>
  9502. </tbody>
  9503. </table>
  9504. <h3 id="external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth
  9505. </h3>
  9506. <p>
  9507. (<em>Appears on:</em>
  9508. <a href="#external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider</a>)
  9509. </p>
  9510. <p>
  9511. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  9512. </p>
  9513. <table>
  9514. <thead>
  9515. <tr>
  9516. <th>Field</th>
  9517. <th>Description</th>
  9518. </tr>
  9519. </thead>
  9520. <tbody>
  9521. <tr>
  9522. <td>
  9523. <code>secretRef</code></br>
  9524. <em>
  9525. <a href="#external-secrets.io/v1.OnePasswordAuthSecretRef">
  9526. OnePasswordAuthSecretRef
  9527. </a>
  9528. </em>
  9529. </td>
  9530. <td>
  9531. </td>
  9532. </tr>
  9533. </tbody>
  9534. </table>
  9535. <h3 id="external-secrets.io/v1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  9536. </h3>
  9537. <p>
  9538. (<em>Appears on:</em>
  9539. <a href="#external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth</a>)
  9540. </p>
  9541. <p>
  9542. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  9543. </p>
  9544. <table>
  9545. <thead>
  9546. <tr>
  9547. <th>Field</th>
  9548. <th>Description</th>
  9549. </tr>
  9550. </thead>
  9551. <tbody>
  9552. <tr>
  9553. <td>
  9554. <code>connectTokenSecretRef</code></br>
  9555. <em>
  9556. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9557. External Secrets meta/v1.SecretKeySelector
  9558. </a>
  9559. </em>
  9560. </td>
  9561. <td>
  9562. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  9563. </td>
  9564. </tr>
  9565. </tbody>
  9566. </table>
  9567. <h3 id="external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider
  9568. </h3>
  9569. <p>
  9570. (<em>Appears on:</em>
  9571. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9572. </p>
  9573. <p>
  9574. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  9575. </p>
  9576. <table>
  9577. <thead>
  9578. <tr>
  9579. <th>Field</th>
  9580. <th>Description</th>
  9581. </tr>
  9582. </thead>
  9583. <tbody>
  9584. <tr>
  9585. <td>
  9586. <code>auth</code></br>
  9587. <em>
  9588. <a href="#external-secrets.io/v1.OnePasswordAuth">
  9589. OnePasswordAuth
  9590. </a>
  9591. </em>
  9592. </td>
  9593. <td>
  9594. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  9595. </td>
  9596. </tr>
  9597. <tr>
  9598. <td>
  9599. <code>connectHost</code></br>
  9600. <em>
  9601. string
  9602. </em>
  9603. </td>
  9604. <td>
  9605. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  9606. </td>
  9607. </tr>
  9608. <tr>
  9609. <td>
  9610. <code>vaults</code></br>
  9611. <em>
  9612. map[string]int
  9613. </em>
  9614. </td>
  9615. <td>
  9616. <p>Vaults defines which OnePassword vaults to search in which order</p>
  9617. </td>
  9618. </tr>
  9619. </tbody>
  9620. </table>
  9621. <h3 id="external-secrets.io/v1.OnePasswordSDKAuth">OnePasswordSDKAuth
  9622. </h3>
  9623. <p>
  9624. (<em>Appears on:</em>
  9625. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  9626. </p>
  9627. <p>
  9628. <p>OnePasswordSDKAuth contains a secretRef for the service account token.</p>
  9629. </p>
  9630. <table>
  9631. <thead>
  9632. <tr>
  9633. <th>Field</th>
  9634. <th>Description</th>
  9635. </tr>
  9636. </thead>
  9637. <tbody>
  9638. <tr>
  9639. <td>
  9640. <code>serviceAccountSecretRef</code></br>
  9641. <em>
  9642. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9643. External Secrets meta/v1.SecretKeySelector
  9644. </a>
  9645. </em>
  9646. </td>
  9647. <td>
  9648. <p>ServiceAccountSecretRef points to the secret containing the token to access 1Password vault.</p>
  9649. </td>
  9650. </tr>
  9651. </tbody>
  9652. </table>
  9653. <h3 id="external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider
  9654. </h3>
  9655. <p>
  9656. (<em>Appears on:</em>
  9657. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9658. </p>
  9659. <p>
  9660. <p>OnePasswordSDKProvider configures a store to sync secrets using the 1Password sdk.</p>
  9661. </p>
  9662. <table>
  9663. <thead>
  9664. <tr>
  9665. <th>Field</th>
  9666. <th>Description</th>
  9667. </tr>
  9668. </thead>
  9669. <tbody>
  9670. <tr>
  9671. <td>
  9672. <code>vault</code></br>
  9673. <em>
  9674. string
  9675. </em>
  9676. </td>
  9677. <td>
  9678. <p>Vault defines the vault&rsquo;s name or uuid to access. Do NOT add op:// prefix. This will be done automatically.</p>
  9679. </td>
  9680. </tr>
  9681. <tr>
  9682. <td>
  9683. <code>integrationInfo</code></br>
  9684. <em>
  9685. <a href="#external-secrets.io/v1.IntegrationInfo">
  9686. IntegrationInfo
  9687. </a>
  9688. </em>
  9689. </td>
  9690. <td>
  9691. <em>(Optional)</em>
  9692. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.
  9693. If you don&rsquo;t know which name and version to use, use <code>DefaultIntegrationName</code> and <code>DefaultIntegrationVersion</code>, respectively.</p>
  9694. </td>
  9695. </tr>
  9696. <tr>
  9697. <td>
  9698. <code>auth</code></br>
  9699. <em>
  9700. <a href="#external-secrets.io/v1.OnePasswordSDKAuth">
  9701. OnePasswordSDKAuth
  9702. </a>
  9703. </em>
  9704. </td>
  9705. <td>
  9706. <p>Auth defines the information necessary to authenticate against OnePassword API.</p>
  9707. </td>
  9708. </tr>
  9709. <tr>
  9710. <td>
  9711. <code>cache</code></br>
  9712. <em>
  9713. <a href="#external-secrets.io/v1.CacheConfig">
  9714. CacheConfig
  9715. </a>
  9716. </em>
  9717. </td>
  9718. <td>
  9719. <em>(Optional)</em>
  9720. <p>Cache configures client-side caching for read operations (GetSecret, GetSecretMap).
  9721. When enabled, secrets are cached with the specified TTL.
  9722. Write operations (PushSecret, DeleteSecret) automatically invalidate relevant cache entries.
  9723. If omitted, caching is disabled (default).
  9724. cache: {} is a valid option to set.</p>
  9725. </td>
  9726. </tr>
  9727. </tbody>
  9728. </table>
  9729. <h3 id="external-secrets.io/v1.OpenBaoAppRole">OpenBaoAppRole
  9730. </h3>
  9731. <p>
  9732. (<em>Appears on:</em>
  9733. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  9734. </p>
  9735. <p>
  9736. <p>OpenBaoAppRole authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/approle/">App Role auth
  9737. mechanism</a>, with the role and secret stored in a Kubernetes Secret resource.
  9738. The role ID has to be specified either inline via <code>roleId</code> or by referencing
  9739. a secret via <code>roleRef</code>.</p>
  9740. </p>
  9741. <table>
  9742. <thead>
  9743. <tr>
  9744. <th>Field</th>
  9745. <th>Description</th>
  9746. </tr>
  9747. </thead>
  9748. <tbody>
  9749. <tr>
  9750. <td>
  9751. <code>path</code></br>
  9752. <em>
  9753. string
  9754. </em>
  9755. </td>
  9756. <td>
  9757. <p>Path where the App Role authentication backend is mounted
  9758. in OpenBao, e.g: &ldquo;approle&rdquo;</p>
  9759. </td>
  9760. </tr>
  9761. <tr>
  9762. <td>
  9763. <code>roleId</code></br>
  9764. <em>
  9765. string
  9766. </em>
  9767. </td>
  9768. <td>
  9769. <em>(Optional)</em>
  9770. <p>RoleID configured in the App Role authentication backend when setting
  9771. up the authentication backend in OpenBao.</p>
  9772. </td>
  9773. </tr>
  9774. <tr>
  9775. <td>
  9776. <code>roleRef</code></br>
  9777. <em>
  9778. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9779. External Secrets meta/v1.SecretKeySelector
  9780. </a>
  9781. </em>
  9782. </td>
  9783. <td>
  9784. <em>(Optional)</em>
  9785. <p>Reference to a key in a Secret that contains the App Role ID used
  9786. to authenticate with OpenBao.
  9787. The <code>key</code> field must be specified and denotes which entry within the Secret
  9788. resource is used as the app role id.</p>
  9789. </td>
  9790. </tr>
  9791. <tr>
  9792. <td>
  9793. <code>secretRef</code></br>
  9794. <em>
  9795. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9796. External Secrets meta/v1.SecretKeySelector
  9797. </a>
  9798. </em>
  9799. </td>
  9800. <td>
  9801. <p>Reference to a key in a Secret that contains the App Role secret used
  9802. to authenticate with OpenBao.
  9803. The <code>key</code> field must be specified and denotes which entry within the Secret
  9804. resource is used as the app role secret.</p>
  9805. </td>
  9806. </tr>
  9807. </tbody>
  9808. </table>
  9809. <h3 id="external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth
  9810. </h3>
  9811. <p>
  9812. (<em>Appears on:</em>
  9813. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>)
  9814. </p>
  9815. <p>
  9816. <p>OpenBaoAuth is the configuration used to authenticate with an OpenBao server.
  9817. Currently the following authentication methods are supported: <a href="https://openbao.org/docs/auth/approle/">AppRole</a>,
  9818. <a href="https://openbao.org/docs/auth/token/">Token</a> and <a href="https://openbao.org/docs/auth/userpass/">UserPass</a></p>
  9819. <p>Additional authentication methods are planned for future releases.</p>
  9820. </p>
  9821. <table>
  9822. <thead>
  9823. <tr>
  9824. <th>Field</th>
  9825. <th>Description</th>
  9826. </tr>
  9827. </thead>
  9828. <tbody>
  9829. <tr>
  9830. <td>
  9831. <code>appRole</code></br>
  9832. <em>
  9833. <a href="#external-secrets.io/v1.OpenBaoAppRole">
  9834. OpenBaoAppRole
  9835. </a>
  9836. </em>
  9837. </td>
  9838. <td>
  9839. <em>(Optional)</em>
  9840. <p>AppRole authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/approle/">App Role auth mechanism</a>,
  9841. with the role and secret stored in a Kubernetes Secret resource.</p>
  9842. </td>
  9843. </tr>
  9844. <tr>
  9845. <td>
  9846. <code>namespace</code></br>
  9847. <em>
  9848. string
  9849. </em>
  9850. </td>
  9851. <td>
  9852. <em>(Optional)</em>
  9853. <p>Name of the <a href="https://openbao.org/docs/concepts/namespaces/">OpenBao Namespace</a> to authenticate to. This can be different
  9854. than the namespace your secret is in. Namespaces is a set of features
  9855. within OpenBao that allows OpenBao environments to support secure
  9856. multi-tenancy. e.g: &ldquo;ns1&rdquo;. This will default to OpenBao.Namespace field
  9857. if set, or empty otherwise</p>
  9858. </td>
  9859. </tr>
  9860. <tr>
  9861. <td>
  9862. <code>tokenSecretRef</code></br>
  9863. <em>
  9864. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9865. External Secrets meta/v1.SecretKeySelector
  9866. </a>
  9867. </em>
  9868. </td>
  9869. <td>
  9870. <em>(Optional)</em>
  9871. <p>TokenSecretRef authenticates with OpenBao by presenting a token.</p>
  9872. </td>
  9873. </tr>
  9874. <tr>
  9875. <td>
  9876. <code>userPass</code></br>
  9877. <em>
  9878. <a href="#external-secrets.io/v1.OpenBaoUserPassAuth">
  9879. OpenBaoUserPassAuth
  9880. </a>
  9881. </em>
  9882. </td>
  9883. <td>
  9884. <em>(Optional)</em>
  9885. <p>UserPass authenticates with OpenBao by passing a username/password pair</p>
  9886. </td>
  9887. </tr>
  9888. </tbody>
  9889. </table>
  9890. <h3 id="external-secrets.io/v1.OpenBaoKVStoreVersion">OpenBaoKVStoreVersion
  9891. (<code>string</code> alias)</p></h3>
  9892. <p>
  9893. (<em>Appears on:</em>
  9894. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>)
  9895. </p>
  9896. <p>
  9897. <p>OpenBaoKVStoreVersion represents the version of the OpenBao KV secret engine.</p>
  9898. </p>
  9899. <table>
  9900. <thead>
  9901. <tr>
  9902. <th>Value</th>
  9903. <th>Description</th>
  9904. </tr>
  9905. </thead>
  9906. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  9907. <td></td>
  9908. </tr><tr><td><p>&#34;v2&#34;</p></td>
  9909. <td></td>
  9910. </tr></tbody>
  9911. </table>
  9912. <h3 id="external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider
  9913. </h3>
  9914. <p>
  9915. (<em>Appears on:</em>
  9916. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9917. </p>
  9918. <p>
  9919. <p>OpenBaoProvider configures a store to sync secrets using an OpenBao KV backend.</p>
  9920. </p>
  9921. <table>
  9922. <thead>
  9923. <tr>
  9924. <th>Field</th>
  9925. <th>Description</th>
  9926. </tr>
  9927. </thead>
  9928. <tbody>
  9929. <tr>
  9930. <td>
  9931. <code>auth</code></br>
  9932. <em>
  9933. <a href="#external-secrets.io/v1.OpenBaoAuth">
  9934. OpenBaoAuth
  9935. </a>
  9936. </em>
  9937. </td>
  9938. <td>
  9939. <em>(Optional)</em>
  9940. <p>Auth configures how secret-manager authenticates with the OpenBao server.</p>
  9941. </td>
  9942. </tr>
  9943. <tr>
  9944. <td>
  9945. <code>caBundle</code></br>
  9946. <em>
  9947. []byte
  9948. </em>
  9949. </td>
  9950. <td>
  9951. <em>(Optional)</em>
  9952. <p>PEM encoded CA bundle used to validate the OpenBao server certificate. If
  9953. this and <code>caProvider</code> are not set the system root certificates are used
  9954. to validate the TLS connection.</p>
  9955. </td>
  9956. </tr>
  9957. <tr>
  9958. <td>
  9959. <code>caProvider</code></br>
  9960. <em>
  9961. <a href="#external-secrets.io/v1.CAProvider">
  9962. CAProvider
  9963. </a>
  9964. </em>
  9965. </td>
  9966. <td>
  9967. <em>(Optional)</em>
  9968. <p>The provider for the CA bundle to use to validate OpenBao server
  9969. certificate. If this and <code>caBundle</code> are not set the system root
  9970. certificates are used to validate the TLS connection.</p>
  9971. </td>
  9972. </tr>
  9973. <tr>
  9974. <td>
  9975. <code>namespace</code></br>
  9976. <em>
  9977. string
  9978. </em>
  9979. </td>
  9980. <td>
  9981. <em>(Optional)</em>
  9982. <p>Name of the <a href="https://openbao.org/docs/concepts/namespaces/">OpenBao Namespace</a>. Namespaces is a set of features within
  9983. OpenBao that allows OpenBao environments to support secure multi-tenancy.
  9984. e.g: &ldquo;ns1&rdquo;.</p>
  9985. </td>
  9986. </tr>
  9987. <tr>
  9988. <td>
  9989. <code>server</code></br>
  9990. <em>
  9991. string
  9992. </em>
  9993. </td>
  9994. <td>
  9995. <p>Server is the connection address for the OpenBao server, e.g: <code>https://openbao.example.com:8200</code>.</p>
  9996. </td>
  9997. </tr>
  9998. <tr>
  9999. <td>
  10000. <code>path</code></br>
  10001. <em>
  10002. string
  10003. </em>
  10004. </td>
  10005. <td>
  10006. <em>(Optional)</em>
  10007. <p>Path is the mount path of the OpenBao KV backend endpoint, e.g:
  10008. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  10009. for fetching secrets from OpenBao is optional and will be appended
  10010. if not present in specified path.</p>
  10011. </td>
  10012. </tr>
  10013. <tr>
  10014. <td>
  10015. <code>version</code></br>
  10016. <em>
  10017. <a href="#external-secrets.io/v1.OpenBaoKVStoreVersion">
  10018. OpenBaoKVStoreVersion
  10019. </a>
  10020. </em>
  10021. </td>
  10022. <td>
  10023. <p>Version is the OpenBao KV secret engine version. This can be either &ldquo;v1&rdquo; or
  10024. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  10025. </td>
  10026. </tr>
  10027. </tbody>
  10028. </table>
  10029. <h3 id="external-secrets.io/v1.OpenBaoUserPassAuth">OpenBaoUserPassAuth
  10030. </h3>
  10031. <p>
  10032. (<em>Appears on:</em>
  10033. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  10034. </p>
  10035. <p>
  10036. <p>OpenBaoUserPassAuth authenticates with OpenBao using <a href="https://openbao.org/docs/auth/userpass/">UserPass authentication
  10037. method</a>, with the username and password stored in a Kubernetes Secret
  10038. resource.</p>
  10039. </p>
  10040. <table>
  10041. <thead>
  10042. <tr>
  10043. <th>Field</th>
  10044. <th>Description</th>
  10045. </tr>
  10046. </thead>
  10047. <tbody>
  10048. <tr>
  10049. <td>
  10050. <code>path</code></br>
  10051. <em>
  10052. string
  10053. </em>
  10054. </td>
  10055. <td>
  10056. <p>Path where the UserPassword authentication backend is mounted
  10057. in OpenBao, e.g: &ldquo;userpass&rdquo;</p>
  10058. </td>
  10059. </tr>
  10060. <tr>
  10061. <td>
  10062. <code>username</code></br>
  10063. <em>
  10064. string
  10065. </em>
  10066. </td>
  10067. <td>
  10068. <p>Username is a username used to authenticate using the <a href="https://openbao.org/docs/auth/userpass/">UserPass
  10069. authentication method</a></p>
  10070. </td>
  10071. </tr>
  10072. <tr>
  10073. <td>
  10074. <code>secretRef</code></br>
  10075. <em>
  10076. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10077. External Secrets meta/v1.SecretKeySelector
  10078. </a>
  10079. </em>
  10080. </td>
  10081. <td>
  10082. <p>SecretRef to a key in a Secret resource containing password for the user
  10083. used to authenticate with OpenBao using the <a href="https://openbao.org/docs/auth/userpass/">UserPass authentication
  10084. method</a></p>
  10085. </td>
  10086. </tr>
  10087. </tbody>
  10088. </table>
  10089. <h3 id="external-secrets.io/v1.OracleAuth">OracleAuth
  10090. </h3>
  10091. <p>
  10092. (<em>Appears on:</em>
  10093. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  10094. </p>
  10095. <p>
  10096. <p>OracleAuth defines the authentication method for the Oracle Vault provider.</p>
  10097. </p>
  10098. <table>
  10099. <thead>
  10100. <tr>
  10101. <th>Field</th>
  10102. <th>Description</th>
  10103. </tr>
  10104. </thead>
  10105. <tbody>
  10106. <tr>
  10107. <td>
  10108. <code>tenancy</code></br>
  10109. <em>
  10110. string
  10111. </em>
  10112. </td>
  10113. <td>
  10114. <p>Tenancy is the tenancy OCID where user is located.</p>
  10115. </td>
  10116. </tr>
  10117. <tr>
  10118. <td>
  10119. <code>user</code></br>
  10120. <em>
  10121. string
  10122. </em>
  10123. </td>
  10124. <td>
  10125. <p>User is an access OCID specific to the account.</p>
  10126. </td>
  10127. </tr>
  10128. <tr>
  10129. <td>
  10130. <code>secretRef</code></br>
  10131. <em>
  10132. <a href="#external-secrets.io/v1.OracleSecretRef">
  10133. OracleSecretRef
  10134. </a>
  10135. </em>
  10136. </td>
  10137. <td>
  10138. <p>SecretRef to pass through sensitive information.</p>
  10139. </td>
  10140. </tr>
  10141. </tbody>
  10142. </table>
  10143. <h3 id="external-secrets.io/v1.OraclePrincipalType">OraclePrincipalType
  10144. (<code>string</code> alias)</p></h3>
  10145. <p>
  10146. (<em>Appears on:</em>
  10147. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  10148. </p>
  10149. <p>
  10150. <p>OraclePrincipalType defines the type of principal used for authentication with Oracle Vault.</p>
  10151. </p>
  10152. <table>
  10153. <thead>
  10154. <tr>
  10155. <th>Value</th>
  10156. <th>Description</th>
  10157. </tr>
  10158. </thead>
  10159. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  10160. <td><p>InstancePrincipal represents a instance principal.</p>
  10161. </td>
  10162. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  10163. <td><p>UserPrincipal represents a user principal.</p>
  10164. </td>
  10165. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  10166. <td><p>WorkloadPrincipal represents a workload principal.</p>
  10167. </td>
  10168. </tr></tbody>
  10169. </table>
  10170. <h3 id="external-secrets.io/v1.OracleProvider">OracleProvider
  10171. </h3>
  10172. <p>
  10173. (<em>Appears on:</em>
  10174. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10175. </p>
  10176. <p>
  10177. <p>OracleProvider configures a store to sync secrets using an Oracle Vault
  10178. backend.</p>
  10179. </p>
  10180. <table>
  10181. <thead>
  10182. <tr>
  10183. <th>Field</th>
  10184. <th>Description</th>
  10185. </tr>
  10186. </thead>
  10187. <tbody>
  10188. <tr>
  10189. <td>
  10190. <code>region</code></br>
  10191. <em>
  10192. string
  10193. </em>
  10194. </td>
  10195. <td>
  10196. <p>Region is the region where vault is located.</p>
  10197. </td>
  10198. </tr>
  10199. <tr>
  10200. <td>
  10201. <code>vault</code></br>
  10202. <em>
  10203. string
  10204. </em>
  10205. </td>
  10206. <td>
  10207. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  10208. </td>
  10209. </tr>
  10210. <tr>
  10211. <td>
  10212. <code>compartment</code></br>
  10213. <em>
  10214. string
  10215. </em>
  10216. </td>
  10217. <td>
  10218. <em>(Optional)</em>
  10219. <p>Compartment is the vault compartment OCID.
  10220. Required for PushSecret</p>
  10221. </td>
  10222. </tr>
  10223. <tr>
  10224. <td>
  10225. <code>encryptionKey</code></br>
  10226. <em>
  10227. string
  10228. </em>
  10229. </td>
  10230. <td>
  10231. <em>(Optional)</em>
  10232. <p>EncryptionKey is the OCID of the encryption key within the vault.
  10233. Required for PushSecret</p>
  10234. </td>
  10235. </tr>
  10236. <tr>
  10237. <td>
  10238. <code>principalType</code></br>
  10239. <em>
  10240. <a href="#external-secrets.io/v1.OraclePrincipalType">
  10241. OraclePrincipalType
  10242. </a>
  10243. </em>
  10244. </td>
  10245. <td>
  10246. <em>(Optional)</em>
  10247. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  10248. determine the principal type. This optional field must be specified if using
  10249. workload identity.</p>
  10250. </td>
  10251. </tr>
  10252. <tr>
  10253. <td>
  10254. <code>auth</code></br>
  10255. <em>
  10256. <a href="#external-secrets.io/v1.OracleAuth">
  10257. OracleAuth
  10258. </a>
  10259. </em>
  10260. </td>
  10261. <td>
  10262. <em>(Optional)</em>
  10263. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  10264. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  10265. </td>
  10266. </tr>
  10267. <tr>
  10268. <td>
  10269. <code>serviceAccountRef</code></br>
  10270. <em>
  10271. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  10272. External Secrets meta/v1.ServiceAccountSelector
  10273. </a>
  10274. </em>
  10275. </td>
  10276. <td>
  10277. <em>(Optional)</em>
  10278. <p>ServiceAccountRef specified the service account
  10279. that should be used when authenticating with WorkloadIdentity.</p>
  10280. </td>
  10281. </tr>
  10282. </tbody>
  10283. </table>
  10284. <h3 id="external-secrets.io/v1.OracleSecretRef">OracleSecretRef
  10285. </h3>
  10286. <p>
  10287. (<em>Appears on:</em>
  10288. <a href="#external-secrets.io/v1.OracleAuth">OracleAuth</a>)
  10289. </p>
  10290. <p>
  10291. <p>OracleSecretRef contains the secret reference for Oracle Vault authentication credentials.</p>
  10292. </p>
  10293. <table>
  10294. <thead>
  10295. <tr>
  10296. <th>Field</th>
  10297. <th>Description</th>
  10298. </tr>
  10299. </thead>
  10300. <tbody>
  10301. <tr>
  10302. <td>
  10303. <code>privatekey</code></br>
  10304. <em>
  10305. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10306. External Secrets meta/v1.SecretKeySelector
  10307. </a>
  10308. </em>
  10309. </td>
  10310. <td>
  10311. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  10312. </td>
  10313. </tr>
  10314. <tr>
  10315. <td>
  10316. <code>fingerprint</code></br>
  10317. <em>
  10318. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10319. External Secrets meta/v1.SecretKeySelector
  10320. </a>
  10321. </em>
  10322. </td>
  10323. <td>
  10324. <p>Fingerprint is the fingerprint of the API private key.</p>
  10325. </td>
  10326. </tr>
  10327. </tbody>
  10328. </table>
  10329. <h3 id="external-secrets.io/v1.OvhAuth">OvhAuth
  10330. </h3>
  10331. <p>
  10332. (<em>Appears on:</em>
  10333. <a href="#external-secrets.io/v1.OvhProvider">OvhProvider</a>)
  10334. </p>
  10335. <p>
  10336. <p>OvhAuth tells the controller how to authenticate to OVHcloud&rsquo;s Secret Manager, either using mTLS or a token.</p>
  10337. </p>
  10338. <table>
  10339. <thead>
  10340. <tr>
  10341. <th>Field</th>
  10342. <th>Description</th>
  10343. </tr>
  10344. </thead>
  10345. <tbody>
  10346. <tr>
  10347. <td>
  10348. <code>mtls</code></br>
  10349. <em>
  10350. <a href="#external-secrets.io/v1.OvhClientMTLS">
  10351. OvhClientMTLS
  10352. </a>
  10353. </em>
  10354. </td>
  10355. <td>
  10356. <em>(Optional)</em>
  10357. </td>
  10358. </tr>
  10359. <tr>
  10360. <td>
  10361. <code>token</code></br>
  10362. <em>
  10363. <a href="#external-secrets.io/v1.OvhClientToken">
  10364. OvhClientToken
  10365. </a>
  10366. </em>
  10367. </td>
  10368. <td>
  10369. <em>(Optional)</em>
  10370. </td>
  10371. </tr>
  10372. </tbody>
  10373. </table>
  10374. <h3 id="external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS
  10375. </h3>
  10376. <p>
  10377. (<em>Appears on:</em>
  10378. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  10379. </p>
  10380. <p>
  10381. <p>OvhClientMTLS defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using mTLS.</p>
  10382. </p>
  10383. <table>
  10384. <thead>
  10385. <tr>
  10386. <th>Field</th>
  10387. <th>Description</th>
  10388. </tr>
  10389. </thead>
  10390. <tbody>
  10391. <tr>
  10392. <td>
  10393. <code>certSecretRef</code></br>
  10394. <em>
  10395. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10396. External Secrets meta/v1.SecretKeySelector
  10397. </a>
  10398. </em>
  10399. </td>
  10400. <td>
  10401. </td>
  10402. </tr>
  10403. <tr>
  10404. <td>
  10405. <code>keySecretRef</code></br>
  10406. <em>
  10407. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10408. External Secrets meta/v1.SecretKeySelector
  10409. </a>
  10410. </em>
  10411. </td>
  10412. <td>
  10413. </td>
  10414. </tr>
  10415. <tr>
  10416. <td>
  10417. <code>caBundle</code></br>
  10418. <em>
  10419. []byte
  10420. </em>
  10421. </td>
  10422. <td>
  10423. <em>(Optional)</em>
  10424. </td>
  10425. </tr>
  10426. <tr>
  10427. <td>
  10428. <code>caProvider</code></br>
  10429. <em>
  10430. <a href="#external-secrets.io/v1.CAProvider">
  10431. CAProvider
  10432. </a>
  10433. </em>
  10434. </td>
  10435. <td>
  10436. <em>(Optional)</em>
  10437. </td>
  10438. </tr>
  10439. </tbody>
  10440. </table>
  10441. <h3 id="external-secrets.io/v1.OvhClientToken">OvhClientToken
  10442. </h3>
  10443. <p>
  10444. (<em>Appears on:</em>
  10445. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  10446. </p>
  10447. <p>
  10448. <p>OvhClientToken defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using a token.</p>
  10449. </p>
  10450. <table>
  10451. <thead>
  10452. <tr>
  10453. <th>Field</th>
  10454. <th>Description</th>
  10455. </tr>
  10456. </thead>
  10457. <tbody>
  10458. <tr>
  10459. <td>
  10460. <code>tokenSecretRef</code></br>
  10461. <em>
  10462. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10463. External Secrets meta/v1.SecretKeySelector
  10464. </a>
  10465. </em>
  10466. </td>
  10467. <td>
  10468. </td>
  10469. </tr>
  10470. </tbody>
  10471. </table>
  10472. <h3 id="external-secrets.io/v1.OvhProvider">OvhProvider
  10473. </h3>
  10474. <p>
  10475. (<em>Appears on:</em>
  10476. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10477. </p>
  10478. <p>
  10479. <p>OvhProvider holds the configuration to synchronize secrets with OVHcloud&rsquo;s Secret Manager.</p>
  10480. </p>
  10481. <table>
  10482. <thead>
  10483. <tr>
  10484. <th>Field</th>
  10485. <th>Description</th>
  10486. </tr>
  10487. </thead>
  10488. <tbody>
  10489. <tr>
  10490. <td>
  10491. <code>server</code></br>
  10492. <em>
  10493. string
  10494. </em>
  10495. </td>
  10496. <td>
  10497. <p>specifies the OKMS server endpoint.</p>
  10498. </td>
  10499. </tr>
  10500. <tr>
  10501. <td>
  10502. <code>okmsid</code></br>
  10503. <em>
  10504. string
  10505. </em>
  10506. </td>
  10507. <td>
  10508. <p>specifies the OKMS ID.</p>
  10509. </td>
  10510. </tr>
  10511. <tr>
  10512. <td>
  10513. <code>casRequired</code></br>
  10514. <em>
  10515. bool
  10516. </em>
  10517. </td>
  10518. <td>
  10519. <em>(Optional)</em>
  10520. <p>Enables or disables check-and-set (CAS) (default: false).</p>
  10521. </td>
  10522. </tr>
  10523. <tr>
  10524. <td>
  10525. <code>okmsTimeout</code></br>
  10526. <em>
  10527. uint32
  10528. </em>
  10529. </td>
  10530. <td>
  10531. <em>(Optional)</em>
  10532. <p>Setup a timeout in seconds when requests to the KMS are made (default: 30).</p>
  10533. </td>
  10534. </tr>
  10535. <tr>
  10536. <td>
  10537. <code>auth</code></br>
  10538. <em>
  10539. <a href="#external-secrets.io/v1.OvhAuth">
  10540. OvhAuth
  10541. </a>
  10542. </em>
  10543. </td>
  10544. <td>
  10545. <p>Authentication method (mtls or token).</p>
  10546. </td>
  10547. </tr>
  10548. </tbody>
  10549. </table>
  10550. <h3 id="external-secrets.io/v1.PassboltAuth">PassboltAuth
  10551. </h3>
  10552. <p>
  10553. (<em>Appears on:</em>
  10554. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>)
  10555. </p>
  10556. <p>
  10557. <p>PassboltAuth contains a secretRef for the passbolt credentials.</p>
  10558. </p>
  10559. <table>
  10560. <thead>
  10561. <tr>
  10562. <th>Field</th>
  10563. <th>Description</th>
  10564. </tr>
  10565. </thead>
  10566. <tbody>
  10567. <tr>
  10568. <td>
  10569. <code>passwordSecretRef</code></br>
  10570. <em>
  10571. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10572. External Secrets meta/v1.SecretKeySelector
  10573. </a>
  10574. </em>
  10575. </td>
  10576. <td>
  10577. </td>
  10578. </tr>
  10579. <tr>
  10580. <td>
  10581. <code>privateKeySecretRef</code></br>
  10582. <em>
  10583. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10584. External Secrets meta/v1.SecretKeySelector
  10585. </a>
  10586. </em>
  10587. </td>
  10588. <td>
  10589. </td>
  10590. </tr>
  10591. </tbody>
  10592. </table>
  10593. <h3 id="external-secrets.io/v1.PassboltProvider">PassboltProvider
  10594. </h3>
  10595. <p>
  10596. (<em>Appears on:</em>
  10597. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10598. </p>
  10599. <p>
  10600. <p>PassboltProvider provides access to Passbolt secrets manager.
  10601. See: <a href="https://www.passbolt.com">https://www.passbolt.com</a>.</p>
  10602. </p>
  10603. <table>
  10604. <thead>
  10605. <tr>
  10606. <th>Field</th>
  10607. <th>Description</th>
  10608. </tr>
  10609. </thead>
  10610. <tbody>
  10611. <tr>
  10612. <td>
  10613. <code>auth</code></br>
  10614. <em>
  10615. <a href="#external-secrets.io/v1.PassboltAuth">
  10616. PassboltAuth
  10617. </a>
  10618. </em>
  10619. </td>
  10620. <td>
  10621. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  10622. </td>
  10623. </tr>
  10624. <tr>
  10625. <td>
  10626. <code>host</code></br>
  10627. <em>
  10628. string
  10629. </em>
  10630. </td>
  10631. <td>
  10632. <p>Host defines the Passbolt Server to connect to</p>
  10633. </td>
  10634. </tr>
  10635. <tr>
  10636. <td>
  10637. <code>caBundle</code></br>
  10638. <em>
  10639. []byte
  10640. </em>
  10641. </td>
  10642. <td>
  10643. <em>(Optional)</em>
  10644. <p>PEM encoded CA bundle used to validate Passbolt server certificate. Only used
  10645. if the Host URL is using HTTPS protocol. If not set the system root certificates
  10646. are used to validate the TLS connection.</p>
  10647. </td>
  10648. </tr>
  10649. <tr>
  10650. <td>
  10651. <code>caProvider</code></br>
  10652. <em>
  10653. <a href="#external-secrets.io/v1.CAProvider">
  10654. CAProvider
  10655. </a>
  10656. </em>
  10657. </td>
  10658. <td>
  10659. <em>(Optional)</em>
  10660. <p>The provider for the CA bundle to use to validate Passbolt server certificate.</p>
  10661. </td>
  10662. </tr>
  10663. </tbody>
  10664. </table>
  10665. <h3 id="external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth
  10666. </h3>
  10667. <p>
  10668. (<em>Appears on:</em>
  10669. <a href="#external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider</a>)
  10670. </p>
  10671. <p>
  10672. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  10673. </p>
  10674. <table>
  10675. <thead>
  10676. <tr>
  10677. <th>Field</th>
  10678. <th>Description</th>
  10679. </tr>
  10680. </thead>
  10681. <tbody>
  10682. <tr>
  10683. <td>
  10684. <code>secretRef</code></br>
  10685. <em>
  10686. <a href="#external-secrets.io/v1.PasswordDepotSecretRef">
  10687. PasswordDepotSecretRef
  10688. </a>
  10689. </em>
  10690. </td>
  10691. <td>
  10692. </td>
  10693. </tr>
  10694. </tbody>
  10695. </table>
  10696. <h3 id="external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider
  10697. </h3>
  10698. <p>
  10699. (<em>Appears on:</em>
  10700. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10701. </p>
  10702. <p>
  10703. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  10704. </p>
  10705. <table>
  10706. <thead>
  10707. <tr>
  10708. <th>Field</th>
  10709. <th>Description</th>
  10710. </tr>
  10711. </thead>
  10712. <tbody>
  10713. <tr>
  10714. <td>
  10715. <code>host</code></br>
  10716. <em>
  10717. string
  10718. </em>
  10719. </td>
  10720. <td>
  10721. <p>URL configures the Password Depot instance URL.</p>
  10722. </td>
  10723. </tr>
  10724. <tr>
  10725. <td>
  10726. <code>database</code></br>
  10727. <em>
  10728. string
  10729. </em>
  10730. </td>
  10731. <td>
  10732. <p>Database to use as source</p>
  10733. </td>
  10734. </tr>
  10735. <tr>
  10736. <td>
  10737. <code>auth</code></br>
  10738. <em>
  10739. <a href="#external-secrets.io/v1.PasswordDepotAuth">
  10740. PasswordDepotAuth
  10741. </a>
  10742. </em>
  10743. </td>
  10744. <td>
  10745. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  10746. </td>
  10747. </tr>
  10748. </tbody>
  10749. </table>
  10750. <h3 id="external-secrets.io/v1.PasswordDepotSecretRef">PasswordDepotSecretRef
  10751. </h3>
  10752. <p>
  10753. (<em>Appears on:</em>
  10754. <a href="#external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth</a>)
  10755. </p>
  10756. <p>
  10757. <p>PasswordDepotSecretRef contains the secret reference for Password Depot authentication.</p>
  10758. </p>
  10759. <table>
  10760. <thead>
  10761. <tr>
  10762. <th>Field</th>
  10763. <th>Description</th>
  10764. </tr>
  10765. </thead>
  10766. <tbody>
  10767. <tr>
  10768. <td>
  10769. <code>credentials</code></br>
  10770. <em>
  10771. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10772. External Secrets meta/v1.SecretKeySelector
  10773. </a>
  10774. </em>
  10775. </td>
  10776. <td>
  10777. <em>(Optional)</em>
  10778. <p>Username / Password is used for authentication.</p>
  10779. </td>
  10780. </tr>
  10781. </tbody>
  10782. </table>
  10783. <h3 id="external-secrets.io/v1.PreviderAuth">PreviderAuth
  10784. </h3>
  10785. <p>
  10786. (<em>Appears on:</em>
  10787. <a href="#external-secrets.io/v1.PreviderProvider">PreviderProvider</a>)
  10788. </p>
  10789. <p>
  10790. <p>PreviderAuth contains a secretRef for credentials.</p>
  10791. </p>
  10792. <table>
  10793. <thead>
  10794. <tr>
  10795. <th>Field</th>
  10796. <th>Description</th>
  10797. </tr>
  10798. </thead>
  10799. <tbody>
  10800. <tr>
  10801. <td>
  10802. <code>secretRef</code></br>
  10803. <em>
  10804. <a href="#external-secrets.io/v1.PreviderAuthSecretRef">
  10805. PreviderAuthSecretRef
  10806. </a>
  10807. </em>
  10808. </td>
  10809. <td>
  10810. <em>(Optional)</em>
  10811. </td>
  10812. </tr>
  10813. </tbody>
  10814. </table>
  10815. <h3 id="external-secrets.io/v1.PreviderAuthSecretRef">PreviderAuthSecretRef
  10816. </h3>
  10817. <p>
  10818. (<em>Appears on:</em>
  10819. <a href="#external-secrets.io/v1.PreviderAuth">PreviderAuth</a>)
  10820. </p>
  10821. <p>
  10822. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  10823. </p>
  10824. <table>
  10825. <thead>
  10826. <tr>
  10827. <th>Field</th>
  10828. <th>Description</th>
  10829. </tr>
  10830. </thead>
  10831. <tbody>
  10832. <tr>
  10833. <td>
  10834. <code>accessToken</code></br>
  10835. <em>
  10836. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10837. External Secrets meta/v1.SecretKeySelector
  10838. </a>
  10839. </em>
  10840. </td>
  10841. <td>
  10842. <p>The AccessToken is used for authentication</p>
  10843. </td>
  10844. </tr>
  10845. </tbody>
  10846. </table>
  10847. <h3 id="external-secrets.io/v1.PreviderProvider">PreviderProvider
  10848. </h3>
  10849. <p>
  10850. (<em>Appears on:</em>
  10851. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10852. </p>
  10853. <p>
  10854. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  10855. </p>
  10856. <table>
  10857. <thead>
  10858. <tr>
  10859. <th>Field</th>
  10860. <th>Description</th>
  10861. </tr>
  10862. </thead>
  10863. <tbody>
  10864. <tr>
  10865. <td>
  10866. <code>auth</code></br>
  10867. <em>
  10868. <a href="#external-secrets.io/v1.PreviderAuth">
  10869. PreviderAuth
  10870. </a>
  10871. </em>
  10872. </td>
  10873. <td>
  10874. </td>
  10875. </tr>
  10876. <tr>
  10877. <td>
  10878. <code>baseUri</code></br>
  10879. <em>
  10880. string
  10881. </em>
  10882. </td>
  10883. <td>
  10884. <em>(Optional)</em>
  10885. </td>
  10886. </tr>
  10887. </tbody>
  10888. </table>
  10889. <h3 id="external-secrets.io/v1.Provider">Provider
  10890. </h3>
  10891. <p>
  10892. <p>Provider is a common interface for interacting with secret backends.</p>
  10893. </p>
  10894. <h3 id="external-secrets.io/v1.PulumiAuth">PulumiAuth
  10895. </h3>
  10896. <p>
  10897. (<em>Appears on:</em>
  10898. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  10899. </p>
  10900. <p>
  10901. <p>PulumiAuth configures authentication with the Pulumi API.
  10902. Exactly one of accessToken or oidcConfig must be specified.</p>
  10903. </p>
  10904. <table>
  10905. <thead>
  10906. <tr>
  10907. <th>Field</th>
  10908. <th>Description</th>
  10909. </tr>
  10910. </thead>
  10911. <tbody>
  10912. <tr>
  10913. <td>
  10914. <code>accessToken</code></br>
  10915. <em>
  10916. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  10917. PulumiProviderSecretRef
  10918. </a>
  10919. </em>
  10920. </td>
  10921. <td>
  10922. <em>(Optional)</em>
  10923. <p>AccessToken authenticates using a Pulumi access token stored in a Kubernetes Secret.</p>
  10924. </td>
  10925. </tr>
  10926. <tr>
  10927. <td>
  10928. <code>oidcConfig</code></br>
  10929. <em>
  10930. <a href="#external-secrets.io/v1.PulumiOIDCAuth">
  10931. PulumiOIDCAuth
  10932. </a>
  10933. </em>
  10934. </td>
  10935. <td>
  10936. <em>(Optional)</em>
  10937. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  10938. </td>
  10939. </tr>
  10940. </tbody>
  10941. </table>
  10942. <h3 id="external-secrets.io/v1.PulumiOIDCAuth">PulumiOIDCAuth
  10943. </h3>
  10944. <p>
  10945. (<em>Appears on:</em>
  10946. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>)
  10947. </p>
  10948. <p>
  10949. <p>PulumiOIDCAuth configures OIDC authentication with Pulumi using Kubernetes ServiceAccount tokens.</p>
  10950. </p>
  10951. <table>
  10952. <thead>
  10953. <tr>
  10954. <th>Field</th>
  10955. <th>Description</th>
  10956. </tr>
  10957. </thead>
  10958. <tbody>
  10959. <tr>
  10960. <td>
  10961. <code>organization</code></br>
  10962. <em>
  10963. string
  10964. </em>
  10965. </td>
  10966. <td>
  10967. <p>Organization is the name of the Pulumi organization configured for OIDC authentication.</p>
  10968. </td>
  10969. </tr>
  10970. <tr>
  10971. <td>
  10972. <code>serviceAccountRef</code></br>
  10973. <em>
  10974. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  10975. External Secrets meta/v1.ServiceAccountSelector
  10976. </a>
  10977. </em>
  10978. </td>
  10979. <td>
  10980. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  10981. </td>
  10982. </tr>
  10983. <tr>
  10984. <td>
  10985. <code>expirationSeconds</code></br>
  10986. <em>
  10987. int64
  10988. </em>
  10989. </td>
  10990. <td>
  10991. <em>(Optional)</em>
  10992. <p>ExpirationSeconds sets the token validity duration for service account and OIDC token.
  10993. Defaults to 10 minutes.</p>
  10994. </td>
  10995. </tr>
  10996. </tbody>
  10997. </table>
  10998. <h3 id="external-secrets.io/v1.PulumiProvider">PulumiProvider
  10999. </h3>
  11000. <p>
  11001. (<em>Appears on:</em>
  11002. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11003. </p>
  11004. <p>
  11005. <p>PulumiProvider defines configuration for accessing secrets from Pulumi ESC.</p>
  11006. </p>
  11007. <table>
  11008. <thead>
  11009. <tr>
  11010. <th>Field</th>
  11011. <th>Description</th>
  11012. </tr>
  11013. </thead>
  11014. <tbody>
  11015. <tr>
  11016. <td>
  11017. <code>apiUrl</code></br>
  11018. <em>
  11019. string
  11020. </em>
  11021. </td>
  11022. <td>
  11023. <p>APIURL is the URL of the Pulumi API.</p>
  11024. </td>
  11025. </tr>
  11026. <tr>
  11027. <td>
  11028. <code>auth</code></br>
  11029. <em>
  11030. <a href="#external-secrets.io/v1.PulumiAuth">
  11031. PulumiAuth
  11032. </a>
  11033. </em>
  11034. </td>
  11035. <td>
  11036. <em>(Optional)</em>
  11037. <p>Auth configures how the Operator authenticates with the Pulumi API.
  11038. Either auth or the deprecated accessToken field must be specified.</p>
  11039. </td>
  11040. </tr>
  11041. <tr>
  11042. <td>
  11043. <code>organization</code></br>
  11044. <em>
  11045. string
  11046. </em>
  11047. </td>
  11048. <td>
  11049. <p>Organization are a space to collaborate on shared projects and stacks.
  11050. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  11051. </td>
  11052. </tr>
  11053. <tr>
  11054. <td>
  11055. <code>project</code></br>
  11056. <em>
  11057. string
  11058. </em>
  11059. </td>
  11060. <td>
  11061. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  11062. </td>
  11063. </tr>
  11064. <tr>
  11065. <td>
  11066. <code>environment</code></br>
  11067. <em>
  11068. string
  11069. </em>
  11070. </td>
  11071. <td>
  11072. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  11073. dynamically retrieved values from supported providers including all major clouds,
  11074. and other Pulumi ESC environments.
  11075. To create a new environment, visit <a href="https://www.pulumi.com/docs/esc/environments/">https://www.pulumi.com/docs/esc/environments/</a> for more information.</p>
  11076. </td>
  11077. </tr>
  11078. <tr>
  11079. <td>
  11080. <code>accessToken</code></br>
  11081. <em>
  11082. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  11083. PulumiProviderSecretRef
  11084. </a>
  11085. </em>
  11086. </td>
  11087. <td>
  11088. <em>(Optional)</em>
  11089. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  11090. <p>Deprecated: Use auth.accessToken instead.</p>
  11091. </td>
  11092. </tr>
  11093. </tbody>
  11094. </table>
  11095. <h3 id="external-secrets.io/v1.PulumiProviderSecretRef">PulumiProviderSecretRef
  11096. </h3>
  11097. <p>
  11098. (<em>Appears on:</em>
  11099. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>,
  11100. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  11101. </p>
  11102. <p>
  11103. <p>PulumiProviderSecretRef contains the secret reference for Pulumi authentication.</p>
  11104. </p>
  11105. <table>
  11106. <thead>
  11107. <tr>
  11108. <th>Field</th>
  11109. <th>Description</th>
  11110. </tr>
  11111. </thead>
  11112. <tbody>
  11113. <tr>
  11114. <td>
  11115. <code>secretRef</code></br>
  11116. <em>
  11117. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11118. External Secrets meta/v1.SecretKeySelector
  11119. </a>
  11120. </em>
  11121. </td>
  11122. <td>
  11123. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  11124. </td>
  11125. </tr>
  11126. </tbody>
  11127. </table>
  11128. <h3 id="external-secrets.io/v1.PushSecretData">PushSecretData
  11129. </h3>
  11130. <p>
  11131. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1.</p>
  11132. </p>
  11133. <h3 id="external-secrets.io/v1.PushSecretRemoteRef">PushSecretRemoteRef
  11134. </h3>
  11135. <p>
  11136. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1.</p>
  11137. </p>
  11138. <h3 id="external-secrets.io/v1.ScalewayProvider">ScalewayProvider
  11139. </h3>
  11140. <p>
  11141. (<em>Appears on:</em>
  11142. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11143. </p>
  11144. <p>
  11145. <p>ScalewayProvider defines the configuration for the Scaleway Secret Manager provider.</p>
  11146. </p>
  11147. <table>
  11148. <thead>
  11149. <tr>
  11150. <th>Field</th>
  11151. <th>Description</th>
  11152. </tr>
  11153. </thead>
  11154. <tbody>
  11155. <tr>
  11156. <td>
  11157. <code>apiUrl</code></br>
  11158. <em>
  11159. string
  11160. </em>
  11161. </td>
  11162. <td>
  11163. <em>(Optional)</em>
  11164. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  11165. </td>
  11166. </tr>
  11167. <tr>
  11168. <td>
  11169. <code>region</code></br>
  11170. <em>
  11171. string
  11172. </em>
  11173. </td>
  11174. <td>
  11175. <p>Region where your secrets are located: <a href="https://developers.scaleway.com/en/quickstart/#region-and-zone">https://developers.scaleway.com/en/quickstart/#region-and-zone</a></p>
  11176. </td>
  11177. </tr>
  11178. <tr>
  11179. <td>
  11180. <code>projectId</code></br>
  11181. <em>
  11182. string
  11183. </em>
  11184. </td>
  11185. <td>
  11186. <p>ProjectID is the id of your project, which you can find in the console: <a href="https://console.scaleway.com/project/settings">https://console.scaleway.com/project/settings</a></p>
  11187. </td>
  11188. </tr>
  11189. <tr>
  11190. <td>
  11191. <code>accessKey</code></br>
  11192. <em>
  11193. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  11194. ScalewayProviderSecretRef
  11195. </a>
  11196. </em>
  11197. </td>
  11198. <td>
  11199. <p>AccessKey is the non-secret part of the api key.</p>
  11200. </td>
  11201. </tr>
  11202. <tr>
  11203. <td>
  11204. <code>secretKey</code></br>
  11205. <em>
  11206. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  11207. ScalewayProviderSecretRef
  11208. </a>
  11209. </em>
  11210. </td>
  11211. <td>
  11212. <p>SecretKey is the non-secret part of the api key.</p>
  11213. </td>
  11214. </tr>
  11215. </tbody>
  11216. </table>
  11217. <h3 id="external-secrets.io/v1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  11218. </h3>
  11219. <p>
  11220. (<em>Appears on:</em>
  11221. <a href="#external-secrets.io/v1.ScalewayProvider">ScalewayProvider</a>)
  11222. </p>
  11223. <p>
  11224. <p>ScalewayProviderSecretRef defines the configuration for Scaleway secret references.</p>
  11225. </p>
  11226. <table>
  11227. <thead>
  11228. <tr>
  11229. <th>Field</th>
  11230. <th>Description</th>
  11231. </tr>
  11232. </thead>
  11233. <tbody>
  11234. <tr>
  11235. <td>
  11236. <code>value</code></br>
  11237. <em>
  11238. string
  11239. </em>
  11240. </td>
  11241. <td>
  11242. <em>(Optional)</em>
  11243. <p>Value can be specified directly to set a value without using a secret.</p>
  11244. </td>
  11245. </tr>
  11246. <tr>
  11247. <td>
  11248. <code>secretRef</code></br>
  11249. <em>
  11250. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11251. External Secrets meta/v1.SecretKeySelector
  11252. </a>
  11253. </em>
  11254. </td>
  11255. <td>
  11256. <em>(Optional)</em>
  11257. <p>SecretRef references a key in a secret that will be used as value.</p>
  11258. </td>
  11259. </tr>
  11260. </tbody>
  11261. </table>
  11262. <h3 id="external-secrets.io/v1.SecretReference">SecretReference
  11263. </h3>
  11264. <p>
  11265. (<em>Appears on:</em>
  11266. <a href="#external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig</a>)
  11267. </p>
  11268. <p>
  11269. <p>SecretReference holds the details of a secret.</p>
  11270. </p>
  11271. <table>
  11272. <thead>
  11273. <tr>
  11274. <th>Field</th>
  11275. <th>Description</th>
  11276. </tr>
  11277. </thead>
  11278. <tbody>
  11279. <tr>
  11280. <td>
  11281. <code>name</code></br>
  11282. <em>
  11283. string
  11284. </em>
  11285. </td>
  11286. <td>
  11287. <p>name of the secret.</p>
  11288. </td>
  11289. </tr>
  11290. <tr>
  11291. <td>
  11292. <code>namespace</code></br>
  11293. <em>
  11294. string
  11295. </em>
  11296. </td>
  11297. <td>
  11298. <p>namespace in which the secret exists. If empty, secret will looked up in local namespace.</p>
  11299. </td>
  11300. </tr>
  11301. </tbody>
  11302. </table>
  11303. <h3 id="external-secrets.io/v1.SecretServerProvider">SecretServerProvider
  11304. </h3>
  11305. <p>
  11306. (<em>Appears on:</em>
  11307. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11308. </p>
  11309. <p>
  11310. <p>SecretServerProvider provides access to authenticate to a secrets provider server.
  11311. See: <a href="https://github.com/DelineaXPM/tss-sdk-go/blob/main/server/server.go">https://github.com/DelineaXPM/tss-sdk-go/blob/main/server/server.go</a>.</p>
  11312. </p>
  11313. <table>
  11314. <thead>
  11315. <tr>
  11316. <th>Field</th>
  11317. <th>Description</th>
  11318. </tr>
  11319. </thead>
  11320. <tbody>
  11321. <tr>
  11322. <td>
  11323. <code>username</code></br>
  11324. <em>
  11325. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11326. SecretServerProviderRef
  11327. </a>
  11328. </em>
  11329. </td>
  11330. <td>
  11331. <p>Username is the secret server account username.</p>
  11332. </td>
  11333. </tr>
  11334. <tr>
  11335. <td>
  11336. <code>password</code></br>
  11337. <em>
  11338. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11339. SecretServerProviderRef
  11340. </a>
  11341. </em>
  11342. </td>
  11343. <td>
  11344. <p>Password is the secret server account password.</p>
  11345. </td>
  11346. </tr>
  11347. <tr>
  11348. <td>
  11349. <code>domain</code></br>
  11350. <em>
  11351. string
  11352. </em>
  11353. </td>
  11354. <td>
  11355. <em>(Optional)</em>
  11356. <p>Domain is the secret server domain.</p>
  11357. </td>
  11358. </tr>
  11359. <tr>
  11360. <td>
  11361. <code>serverURL</code></br>
  11362. <em>
  11363. string
  11364. </em>
  11365. </td>
  11366. <td>
  11367. <p>ServerURL
  11368. URL to your secret server installation</p>
  11369. </td>
  11370. </tr>
  11371. <tr>
  11372. <td>
  11373. <code>caBundle</code></br>
  11374. <em>
  11375. []byte
  11376. </em>
  11377. </td>
  11378. <td>
  11379. <em>(Optional)</em>
  11380. <p>PEM/base64 encoded CA bundle used to validate Secret ServerURL. Only used
  11381. if the ServerURL URL is using HTTPS protocol. If not set the system root certificates
  11382. are used to validate the TLS connection.</p>
  11383. </td>
  11384. </tr>
  11385. <tr>
  11386. <td>
  11387. <code>caProvider</code></br>
  11388. <em>
  11389. <a href="#external-secrets.io/v1.CAProvider">
  11390. CAProvider
  11391. </a>
  11392. </em>
  11393. </td>
  11394. <td>
  11395. <em>(Optional)</em>
  11396. <p>The provider for the CA bundle to use to validate Secret ServerURL certificate.</p>
  11397. </td>
  11398. </tr>
  11399. </tbody>
  11400. </table>
  11401. <h3 id="external-secrets.io/v1.SecretServerProviderRef">SecretServerProviderRef
  11402. </h3>
  11403. <p>
  11404. (<em>Appears on:</em>
  11405. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>)
  11406. </p>
  11407. <p>
  11408. <p>SecretServerProviderRef references a value that can be specified directly or via a secret
  11409. for a SecretServerProvider.</p>
  11410. </p>
  11411. <table>
  11412. <thead>
  11413. <tr>
  11414. <th>Field</th>
  11415. <th>Description</th>
  11416. </tr>
  11417. </thead>
  11418. <tbody>
  11419. <tr>
  11420. <td>
  11421. <code>value</code></br>
  11422. <em>
  11423. string
  11424. </em>
  11425. </td>
  11426. <td>
  11427. <em>(Optional)</em>
  11428. <p>Value can be specified directly to set a value without using a secret.</p>
  11429. </td>
  11430. </tr>
  11431. <tr>
  11432. <td>
  11433. <code>secretRef</code></br>
  11434. <em>
  11435. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11436. External Secrets meta/v1.SecretKeySelector
  11437. </a>
  11438. </em>
  11439. </td>
  11440. <td>
  11441. <em>(Optional)</em>
  11442. <p>SecretRef references a key in a secret that will be used as value.</p>
  11443. </td>
  11444. </tr>
  11445. </tbody>
  11446. </table>
  11447. <h3 id="external-secrets.io/v1.SecretStore">SecretStore
  11448. </h3>
  11449. <p>
  11450. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  11451. </p>
  11452. <table>
  11453. <thead>
  11454. <tr>
  11455. <th>Field</th>
  11456. <th>Description</th>
  11457. </tr>
  11458. </thead>
  11459. <tbody>
  11460. <tr>
  11461. <td>
  11462. <code>metadata</code></br>
  11463. <em>
  11464. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  11465. Kubernetes meta/v1.ObjectMeta
  11466. </a>
  11467. </em>
  11468. </td>
  11469. <td>
  11470. Refer to the Kubernetes API documentation for the fields of the
  11471. <code>metadata</code> field.
  11472. </td>
  11473. </tr>
  11474. <tr>
  11475. <td>
  11476. <code>spec</code></br>
  11477. <em>
  11478. <a href="#external-secrets.io/v1.SecretStoreSpec">
  11479. SecretStoreSpec
  11480. </a>
  11481. </em>
  11482. </td>
  11483. <td>
  11484. <br/>
  11485. <br/>
  11486. <table>
  11487. <tr>
  11488. <td>
  11489. <code>controller</code></br>
  11490. <em>
  11491. string
  11492. </em>
  11493. </td>
  11494. <td>
  11495. <em>(Optional)</em>
  11496. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  11497. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  11498. </td>
  11499. </tr>
  11500. <tr>
  11501. <td>
  11502. <code>provider</code></br>
  11503. <em>
  11504. <a href="#external-secrets.io/v1.SecretStoreProvider">
  11505. SecretStoreProvider
  11506. </a>
  11507. </em>
  11508. </td>
  11509. <td>
  11510. <p>Used to configure the provider. Only one provider may be set</p>
  11511. </td>
  11512. </tr>
  11513. <tr>
  11514. <td>
  11515. <code>retrySettings</code></br>
  11516. <em>
  11517. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  11518. SecretStoreRetrySettings
  11519. </a>
  11520. </em>
  11521. </td>
  11522. <td>
  11523. <em>(Optional)</em>
  11524. <p>Used to configure HTTP retries on failures.</p>
  11525. </td>
  11526. </tr>
  11527. <tr>
  11528. <td>
  11529. <code>refreshInterval</code></br>
  11530. <em>
  11531. int
  11532. </em>
  11533. </td>
  11534. <td>
  11535. <em>(Optional)</em>
  11536. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  11537. </td>
  11538. </tr>
  11539. <tr>
  11540. <td>
  11541. <code>conditions</code></br>
  11542. <em>
  11543. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  11544. []ClusterSecretStoreCondition
  11545. </a>
  11546. </em>
  11547. </td>
  11548. <td>
  11549. <em>(Optional)</em>
  11550. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  11551. </td>
  11552. </tr>
  11553. </table>
  11554. </td>
  11555. </tr>
  11556. <tr>
  11557. <td>
  11558. <code>status</code></br>
  11559. <em>
  11560. <a href="#external-secrets.io/v1.SecretStoreStatus">
  11561. SecretStoreStatus
  11562. </a>
  11563. </em>
  11564. </td>
  11565. <td>
  11566. </td>
  11567. </tr>
  11568. </tbody>
  11569. </table>
  11570. <h3 id="external-secrets.io/v1.SecretStoreCapabilities">SecretStoreCapabilities
  11571. (<code>string</code> alias)</p></h3>
  11572. <p>
  11573. (<em>Appears on:</em>
  11574. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  11575. </p>
  11576. <p>
  11577. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  11578. </p>
  11579. <table>
  11580. <thead>
  11581. <tr>
  11582. <th>Value</th>
  11583. <th>Description</th>
  11584. </tr>
  11585. </thead>
  11586. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  11587. <td><p>SecretStoreReadOnly indicates that the store can only read secrets.</p>
  11588. </td>
  11589. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  11590. <td><p>SecretStoreReadWrite indicates that the store can both read and write secrets.</p>
  11591. </td>
  11592. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  11593. <td><p>SecretStoreWriteOnly indicates that the store can only write secrets.</p>
  11594. </td>
  11595. </tr></tbody>
  11596. </table>
  11597. <h3 id="external-secrets.io/v1.SecretStoreConditionType">SecretStoreConditionType
  11598. (<code>string</code> alias)</p></h3>
  11599. <p>
  11600. (<em>Appears on:</em>
  11601. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  11602. </p>
  11603. <p>
  11604. <p>SecretStoreConditionType represents the condition of the SecretStore.</p>
  11605. </p>
  11606. <table>
  11607. <thead>
  11608. <tr>
  11609. <th>Value</th>
  11610. <th>Description</th>
  11611. </tr>
  11612. </thead>
  11613. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  11614. <td><p>SecretStoreReady indicates that the store is ready and able to serve requests.</p>
  11615. </td>
  11616. </tr></tbody>
  11617. </table>
  11618. <h3 id="external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider
  11619. </h3>
  11620. <p>
  11621. (<em>Appears on:</em>
  11622. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  11623. </p>
  11624. <p>
  11625. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  11626. </p>
  11627. <table>
  11628. <thead>
  11629. <tr>
  11630. <th>Field</th>
  11631. <th>Description</th>
  11632. </tr>
  11633. </thead>
  11634. <tbody>
  11635. <tr>
  11636. <td>
  11637. <code>aws</code></br>
  11638. <em>
  11639. <a href="#external-secrets.io/v1.AWSProvider">
  11640. AWSProvider
  11641. </a>
  11642. </em>
  11643. </td>
  11644. <td>
  11645. <em>(Optional)</em>
  11646. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  11647. </td>
  11648. </tr>
  11649. <tr>
  11650. <td>
  11651. <code>azurekv</code></br>
  11652. <em>
  11653. <a href="#external-secrets.io/v1.AzureKVProvider">
  11654. AzureKVProvider
  11655. </a>
  11656. </em>
  11657. </td>
  11658. <td>
  11659. <em>(Optional)</em>
  11660. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  11661. </td>
  11662. </tr>
  11663. <tr>
  11664. <td>
  11665. <code>akeyless</code></br>
  11666. <em>
  11667. <a href="#external-secrets.io/v1.AkeylessProvider">
  11668. AkeylessProvider
  11669. </a>
  11670. </em>
  11671. </td>
  11672. <td>
  11673. <em>(Optional)</em>
  11674. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  11675. </td>
  11676. </tr>
  11677. <tr>
  11678. <td>
  11679. <code>bitwardensecretsmanager</code></br>
  11680. <em>
  11681. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">
  11682. BitwardenSecretsManagerProvider
  11683. </a>
  11684. </em>
  11685. </td>
  11686. <td>
  11687. <em>(Optional)</em>
  11688. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  11689. </td>
  11690. </tr>
  11691. <tr>
  11692. <td>
  11693. <code>vault</code></br>
  11694. <em>
  11695. <a href="#external-secrets.io/v1.VaultProvider">
  11696. VaultProvider
  11697. </a>
  11698. </em>
  11699. </td>
  11700. <td>
  11701. <em>(Optional)</em>
  11702. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  11703. </td>
  11704. </tr>
  11705. <tr>
  11706. <td>
  11707. <code>ovh</code></br>
  11708. <em>
  11709. <a href="#external-secrets.io/v1.OvhProvider">
  11710. OvhProvider
  11711. </a>
  11712. </em>
  11713. </td>
  11714. <td>
  11715. <em>(Optional)</em>
  11716. <p>OVHcloud configures this store to sync secrets using the OVHcloud provider.</p>
  11717. </td>
  11718. </tr>
  11719. <tr>
  11720. <td>
  11721. <code>gcpsm</code></br>
  11722. <em>
  11723. <a href="#external-secrets.io/v1.GCPSMProvider">
  11724. GCPSMProvider
  11725. </a>
  11726. </em>
  11727. </td>
  11728. <td>
  11729. <em>(Optional)</em>
  11730. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  11731. </td>
  11732. </tr>
  11733. <tr>
  11734. <td>
  11735. <code>oracle</code></br>
  11736. <em>
  11737. <a href="#external-secrets.io/v1.OracleProvider">
  11738. OracleProvider
  11739. </a>
  11740. </em>
  11741. </td>
  11742. <td>
  11743. <em>(Optional)</em>
  11744. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  11745. </td>
  11746. </tr>
  11747. <tr>
  11748. <td>
  11749. <code>ibm</code></br>
  11750. <em>
  11751. <a href="#external-secrets.io/v1.IBMProvider">
  11752. IBMProvider
  11753. </a>
  11754. </em>
  11755. </td>
  11756. <td>
  11757. <em>(Optional)</em>
  11758. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  11759. </td>
  11760. </tr>
  11761. <tr>
  11762. <td>
  11763. <code>yandexcertificatemanager</code></br>
  11764. <em>
  11765. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">
  11766. YandexCertificateManagerProvider
  11767. </a>
  11768. </em>
  11769. </td>
  11770. <td>
  11771. <em>(Optional)</em>
  11772. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  11773. </td>
  11774. </tr>
  11775. <tr>
  11776. <td>
  11777. <code>yandexlockbox</code></br>
  11778. <em>
  11779. <a href="#external-secrets.io/v1.YandexLockboxProvider">
  11780. YandexLockboxProvider
  11781. </a>
  11782. </em>
  11783. </td>
  11784. <td>
  11785. <em>(Optional)</em>
  11786. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  11787. </td>
  11788. </tr>
  11789. <tr>
  11790. <td>
  11791. <code>github</code></br>
  11792. <em>
  11793. <a href="#external-secrets.io/v1.GithubProvider">
  11794. GithubProvider
  11795. </a>
  11796. </em>
  11797. </td>
  11798. <td>
  11799. <em>(Optional)</em>
  11800. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.
  11801. Note: This provider only supports write operations (PushSecret) and cannot fetch secrets from GitHub</p>
  11802. </td>
  11803. </tr>
  11804. <tr>
  11805. <td>
  11806. <code>gitlab</code></br>
  11807. <em>
  11808. <a href="#external-secrets.io/v1.GitlabProvider">
  11809. GitlabProvider
  11810. </a>
  11811. </em>
  11812. </td>
  11813. <td>
  11814. <em>(Optional)</em>
  11815. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  11816. </td>
  11817. </tr>
  11818. <tr>
  11819. <td>
  11820. <code>onepassword</code></br>
  11821. <em>
  11822. <a href="#external-secrets.io/v1.OnePasswordProvider">
  11823. OnePasswordProvider
  11824. </a>
  11825. </em>
  11826. </td>
  11827. <td>
  11828. <em>(Optional)</em>
  11829. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  11830. </td>
  11831. </tr>
  11832. <tr>
  11833. <td>
  11834. <code>onepasswordSDK</code></br>
  11835. <em>
  11836. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">
  11837. OnePasswordSDKProvider
  11838. </a>
  11839. </em>
  11840. </td>
  11841. <td>
  11842. <em>(Optional)</em>
  11843. <p>OnePasswordSDK configures this store to use 1Password&rsquo;s new Go SDK to sync secrets.</p>
  11844. </td>
  11845. </tr>
  11846. <tr>
  11847. <td>
  11848. <code>webhook</code></br>
  11849. <em>
  11850. <a href="#external-secrets.io/v1.WebhookProvider">
  11851. WebhookProvider
  11852. </a>
  11853. </em>
  11854. </td>
  11855. <td>
  11856. <em>(Optional)</em>
  11857. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  11858. </td>
  11859. </tr>
  11860. <tr>
  11861. <td>
  11862. <code>kubernetes</code></br>
  11863. <em>
  11864. <a href="#external-secrets.io/v1.KubernetesProvider">
  11865. KubernetesProvider
  11866. </a>
  11867. </em>
  11868. </td>
  11869. <td>
  11870. <em>(Optional)</em>
  11871. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  11872. </td>
  11873. </tr>
  11874. <tr>
  11875. <td>
  11876. <code>fake</code></br>
  11877. <em>
  11878. <a href="#external-secrets.io/v1.FakeProvider">
  11879. FakeProvider
  11880. </a>
  11881. </em>
  11882. </td>
  11883. <td>
  11884. <em>(Optional)</em>
  11885. <p>Fake configures a store with static key/value pairs</p>
  11886. </td>
  11887. </tr>
  11888. <tr>
  11889. <td>
  11890. <code>senhasegura</code></br>
  11891. <em>
  11892. <a href="#external-secrets.io/v1.SenhaseguraProvider">
  11893. SenhaseguraProvider
  11894. </a>
  11895. </em>
  11896. </td>
  11897. <td>
  11898. <em>(Optional)</em>
  11899. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  11900. </td>
  11901. </tr>
  11902. <tr>
  11903. <td>
  11904. <code>scaleway</code></br>
  11905. <em>
  11906. <a href="#external-secrets.io/v1.ScalewayProvider">
  11907. ScalewayProvider
  11908. </a>
  11909. </em>
  11910. </td>
  11911. <td>
  11912. <em>(Optional)</em>
  11913. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  11914. </td>
  11915. </tr>
  11916. <tr>
  11917. <td>
  11918. <code>doppler</code></br>
  11919. <em>
  11920. <a href="#external-secrets.io/v1.DopplerProvider">
  11921. DopplerProvider
  11922. </a>
  11923. </em>
  11924. </td>
  11925. <td>
  11926. <em>(Optional)</em>
  11927. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  11928. </td>
  11929. </tr>
  11930. <tr>
  11931. <td>
  11932. <code>previder</code></br>
  11933. <em>
  11934. <a href="#external-secrets.io/v1.PreviderProvider">
  11935. PreviderProvider
  11936. </a>
  11937. </em>
  11938. </td>
  11939. <td>
  11940. <em>(Optional)</em>
  11941. <p>Previder configures this store to sync secrets using the Previder provider</p>
  11942. </td>
  11943. </tr>
  11944. <tr>
  11945. <td>
  11946. <code>onboardbase</code></br>
  11947. <em>
  11948. <a href="#external-secrets.io/v1.OnboardbaseProvider">
  11949. OnboardbaseProvider
  11950. </a>
  11951. </em>
  11952. </td>
  11953. <td>
  11954. <em>(Optional)</em>
  11955. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  11956. </td>
  11957. </tr>
  11958. <tr>
  11959. <td>
  11960. <code>keepersecurity</code></br>
  11961. <em>
  11962. <a href="#external-secrets.io/v1.KeeperSecurityProvider">
  11963. KeeperSecurityProvider
  11964. </a>
  11965. </em>
  11966. </td>
  11967. <td>
  11968. <em>(Optional)</em>
  11969. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  11970. </td>
  11971. </tr>
  11972. <tr>
  11973. <td>
  11974. <code>conjur</code></br>
  11975. <em>
  11976. <a href="#external-secrets.io/v1.ConjurProvider">
  11977. ConjurProvider
  11978. </a>
  11979. </em>
  11980. </td>
  11981. <td>
  11982. <em>(Optional)</em>
  11983. <p>Conjur configures this store to sync secrets using conjur provider</p>
  11984. </td>
  11985. </tr>
  11986. <tr>
  11987. <td>
  11988. <code>delinea</code></br>
  11989. <em>
  11990. <a href="#external-secrets.io/v1.DelineaProvider">
  11991. DelineaProvider
  11992. </a>
  11993. </em>
  11994. </td>
  11995. <td>
  11996. <em>(Optional)</em>
  11997. <p>Delinea DevOps Secrets Vault
  11998. <a href="https://docs.delinea.com/online-help/products/devops-secrets-vault/current">https://docs.delinea.com/online-help/products/devops-secrets-vault/current</a></p>
  11999. </td>
  12000. </tr>
  12001. <tr>
  12002. <td>
  12003. <code>secretserver</code></br>
  12004. <em>
  12005. <a href="#external-secrets.io/v1.SecretServerProvider">
  12006. SecretServerProvider
  12007. </a>
  12008. </em>
  12009. </td>
  12010. <td>
  12011. <em>(Optional)</em>
  12012. <p>SecretServer configures this store to sync secrets using SecretServer provider
  12013. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  12014. </td>
  12015. </tr>
  12016. <tr>
  12017. <td>
  12018. <code>chef</code></br>
  12019. <em>
  12020. <a href="#external-secrets.io/v1.ChefProvider">
  12021. ChefProvider
  12022. </a>
  12023. </em>
  12024. </td>
  12025. <td>
  12026. <em>(Optional)</em>
  12027. <p>Chef configures this store to sync secrets with chef server</p>
  12028. </td>
  12029. </tr>
  12030. <tr>
  12031. <td>
  12032. <code>pulumi</code></br>
  12033. <em>
  12034. <a href="#external-secrets.io/v1.PulumiProvider">
  12035. PulumiProvider
  12036. </a>
  12037. </em>
  12038. </td>
  12039. <td>
  12040. <em>(Optional)</em>
  12041. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  12042. </td>
  12043. </tr>
  12044. <tr>
  12045. <td>
  12046. <code>fortanix</code></br>
  12047. <em>
  12048. <a href="#external-secrets.io/v1.FortanixProvider">
  12049. FortanixProvider
  12050. </a>
  12051. </em>
  12052. </td>
  12053. <td>
  12054. <em>(Optional)</em>
  12055. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  12056. </td>
  12057. </tr>
  12058. <tr>
  12059. <td>
  12060. <code>passworddepot</code></br>
  12061. <em>
  12062. <a href="#external-secrets.io/v1.PasswordDepotProvider">
  12063. PasswordDepotProvider
  12064. </a>
  12065. </em>
  12066. </td>
  12067. <td>
  12068. <em>(Optional)</em>
  12069. </td>
  12070. </tr>
  12071. <tr>
  12072. <td>
  12073. <code>passbolt</code></br>
  12074. <em>
  12075. <a href="#external-secrets.io/v1.PassboltProvider">
  12076. PassboltProvider
  12077. </a>
  12078. </em>
  12079. </td>
  12080. <td>
  12081. <em>(Optional)</em>
  12082. </td>
  12083. </tr>
  12084. <tr>
  12085. <td>
  12086. <code>dvls</code></br>
  12087. <em>
  12088. <a href="#external-secrets.io/v1.DVLSProvider">
  12089. DVLSProvider
  12090. </a>
  12091. </em>
  12092. </td>
  12093. <td>
  12094. <em>(Optional)</em>
  12095. <p>DVLS configures this store to sync secrets using Devolutions Server provider</p>
  12096. </td>
  12097. </tr>
  12098. <tr>
  12099. <td>
  12100. <code>infisical</code></br>
  12101. <em>
  12102. <a href="#external-secrets.io/v1.InfisicalProvider">
  12103. InfisicalProvider
  12104. </a>
  12105. </em>
  12106. </td>
  12107. <td>
  12108. <em>(Optional)</em>
  12109. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  12110. </td>
  12111. </tr>
  12112. <tr>
  12113. <td>
  12114. <code>beyondtrust</code></br>
  12115. <em>
  12116. <a href="#external-secrets.io/v1.BeyondtrustProvider">
  12117. BeyondtrustProvider
  12118. </a>
  12119. </em>
  12120. </td>
  12121. <td>
  12122. <em>(Optional)</em>
  12123. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  12124. </td>
  12125. </tr>
  12126. <tr>
  12127. <td>
  12128. <code>beyondtrustworkloadcredentials</code></br>
  12129. <em>
  12130. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  12131. BeyondtrustWorkloadCredentialsProvider
  12132. </a>
  12133. </em>
  12134. </td>
  12135. <td>
  12136. <em>(Optional)</em>
  12137. <p>BeyondtrustWorkloadCredentials configures this store to sync secrets using the BeyondTrust Workload Credentials provider.</p>
  12138. </td>
  12139. </tr>
  12140. <tr>
  12141. <td>
  12142. <code>cloudrusm</code></br>
  12143. <em>
  12144. <a href="#external-secrets.io/v1.CloudruSMProvider">
  12145. CloudruSMProvider
  12146. </a>
  12147. </em>
  12148. </td>
  12149. <td>
  12150. <em>(Optional)</em>
  12151. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  12152. </td>
  12153. </tr>
  12154. <tr>
  12155. <td>
  12156. <code>volcengine</code></br>
  12157. <em>
  12158. <a href="#external-secrets.io/v1.VolcengineProvider">
  12159. VolcengineProvider
  12160. </a>
  12161. </em>
  12162. </td>
  12163. <td>
  12164. <em>(Optional)</em>
  12165. <p>Volcengine configures this store to sync secrets using the Volcengine provider</p>
  12166. </td>
  12167. </tr>
  12168. <tr>
  12169. <td>
  12170. <code>ngrok</code></br>
  12171. <em>
  12172. <a href="#external-secrets.io/v1.NgrokProvider">
  12173. NgrokProvider
  12174. </a>
  12175. </em>
  12176. </td>
  12177. <td>
  12178. <em>(Optional)</em>
  12179. <p>Ngrok configures this store to sync secrets using the ngrok provider.</p>
  12180. </td>
  12181. </tr>
  12182. <tr>
  12183. <td>
  12184. <code>barbican</code></br>
  12185. <em>
  12186. <a href="#external-secrets.io/v1.BarbicanProvider">
  12187. BarbicanProvider
  12188. </a>
  12189. </em>
  12190. </td>
  12191. <td>
  12192. <em>(Optional)</em>
  12193. <p>Barbican configures this store to sync secrets using the OpenStack Barbican provider</p>
  12194. </td>
  12195. </tr>
  12196. <tr>
  12197. <td>
  12198. <code>nebiusmysterybox</code></br>
  12199. <em>
  12200. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">
  12201. NebiusMysteryboxProvider
  12202. </a>
  12203. </em>
  12204. </td>
  12205. <td>
  12206. <em>(Optional)</em>
  12207. <p>NebiusMysterybox configures this store to sync secrets using NebiusMysterybox provider</p>
  12208. </td>
  12209. </tr>
  12210. <tr>
  12211. <td>
  12212. <code>openBao</code></br>
  12213. <em>
  12214. <a href="#external-secrets.io/v1.OpenBaoProvider">
  12215. OpenBaoProvider
  12216. </a>
  12217. </em>
  12218. </td>
  12219. <td>
  12220. <em>(Optional)</em>
  12221. <p>OpenBao configures this store to sync secrets using the OpenBao provider.</p>
  12222. </td>
  12223. </tr>
  12224. </tbody>
  12225. </table>
  12226. <h3 id="external-secrets.io/v1.SecretStoreRef">SecretStoreRef
  12227. </h3>
  12228. <p>
  12229. (<em>Appears on:</em>
  12230. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>,
  12231. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  12232. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>)
  12233. </p>
  12234. <p>
  12235. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  12236. </p>
  12237. <table>
  12238. <thead>
  12239. <tr>
  12240. <th>Field</th>
  12241. <th>Description</th>
  12242. </tr>
  12243. </thead>
  12244. <tbody>
  12245. <tr>
  12246. <td>
  12247. <code>name</code></br>
  12248. <em>
  12249. string
  12250. </em>
  12251. </td>
  12252. <td>
  12253. <p>Name of the SecretStore resource</p>
  12254. </td>
  12255. </tr>
  12256. <tr>
  12257. <td>
  12258. <code>kind</code></br>
  12259. <em>
  12260. string
  12261. </em>
  12262. </td>
  12263. <td>
  12264. <em>(Optional)</em>
  12265. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  12266. Defaults to <code>SecretStore</code></p>
  12267. </td>
  12268. </tr>
  12269. </tbody>
  12270. </table>
  12271. <h3 id="external-secrets.io/v1.SecretStoreRetrySettings">SecretStoreRetrySettings
  12272. </h3>
  12273. <p>
  12274. (<em>Appears on:</em>
  12275. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>,
  12276. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec</a>,
  12277. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  12278. </p>
  12279. <p>
  12280. <p>SecretStoreRetrySettings defines the retry settings for accessing external secrets manager stores.</p>
  12281. </p>
  12282. <table>
  12283. <thead>
  12284. <tr>
  12285. <th>Field</th>
  12286. <th>Description</th>
  12287. </tr>
  12288. </thead>
  12289. <tbody>
  12290. <tr>
  12291. <td>
  12292. <code>maxRetries</code></br>
  12293. <em>
  12294. int32
  12295. </em>
  12296. </td>
  12297. <td>
  12298. </td>
  12299. </tr>
  12300. <tr>
  12301. <td>
  12302. <code>retryInterval</code></br>
  12303. <em>
  12304. string
  12305. </em>
  12306. </td>
  12307. <td>
  12308. </td>
  12309. </tr>
  12310. </tbody>
  12311. </table>
  12312. <h3 id="external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec
  12313. </h3>
  12314. <p>
  12315. (<em>Appears on:</em>
  12316. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  12317. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  12318. </p>
  12319. <p>
  12320. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  12321. </p>
  12322. <table>
  12323. <thead>
  12324. <tr>
  12325. <th>Field</th>
  12326. <th>Description</th>
  12327. </tr>
  12328. </thead>
  12329. <tbody>
  12330. <tr>
  12331. <td>
  12332. <code>controller</code></br>
  12333. <em>
  12334. string
  12335. </em>
  12336. </td>
  12337. <td>
  12338. <em>(Optional)</em>
  12339. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  12340. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  12341. </td>
  12342. </tr>
  12343. <tr>
  12344. <td>
  12345. <code>provider</code></br>
  12346. <em>
  12347. <a href="#external-secrets.io/v1.SecretStoreProvider">
  12348. SecretStoreProvider
  12349. </a>
  12350. </em>
  12351. </td>
  12352. <td>
  12353. <p>Used to configure the provider. Only one provider may be set</p>
  12354. </td>
  12355. </tr>
  12356. <tr>
  12357. <td>
  12358. <code>retrySettings</code></br>
  12359. <em>
  12360. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  12361. SecretStoreRetrySettings
  12362. </a>
  12363. </em>
  12364. </td>
  12365. <td>
  12366. <em>(Optional)</em>
  12367. <p>Used to configure HTTP retries on failures.</p>
  12368. </td>
  12369. </tr>
  12370. <tr>
  12371. <td>
  12372. <code>refreshInterval</code></br>
  12373. <em>
  12374. int
  12375. </em>
  12376. </td>
  12377. <td>
  12378. <em>(Optional)</em>
  12379. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  12380. </td>
  12381. </tr>
  12382. <tr>
  12383. <td>
  12384. <code>conditions</code></br>
  12385. <em>
  12386. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  12387. []ClusterSecretStoreCondition
  12388. </a>
  12389. </em>
  12390. </td>
  12391. <td>
  12392. <em>(Optional)</em>
  12393. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  12394. </td>
  12395. </tr>
  12396. </tbody>
  12397. </table>
  12398. <h3 id="external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus
  12399. </h3>
  12400. <p>
  12401. (<em>Appears on:</em>
  12402. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  12403. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  12404. </p>
  12405. <p>
  12406. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  12407. </p>
  12408. <table>
  12409. <thead>
  12410. <tr>
  12411. <th>Field</th>
  12412. <th>Description</th>
  12413. </tr>
  12414. </thead>
  12415. <tbody>
  12416. <tr>
  12417. <td>
  12418. <code>conditions</code></br>
  12419. <em>
  12420. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">
  12421. []SecretStoreStatusCondition
  12422. </a>
  12423. </em>
  12424. </td>
  12425. <td>
  12426. <em>(Optional)</em>
  12427. </td>
  12428. </tr>
  12429. <tr>
  12430. <td>
  12431. <code>capabilities</code></br>
  12432. <em>
  12433. <a href="#external-secrets.io/v1.SecretStoreCapabilities">
  12434. SecretStoreCapabilities
  12435. </a>
  12436. </em>
  12437. </td>
  12438. <td>
  12439. <em>(Optional)</em>
  12440. </td>
  12441. </tr>
  12442. </tbody>
  12443. </table>
  12444. <h3 id="external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition
  12445. </h3>
  12446. <p>
  12447. (<em>Appears on:</em>
  12448. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  12449. </p>
  12450. <p>
  12451. <p>SecretStoreStatusCondition contains condition information for a SecretStore.</p>
  12452. </p>
  12453. <table>
  12454. <thead>
  12455. <tr>
  12456. <th>Field</th>
  12457. <th>Description</th>
  12458. </tr>
  12459. </thead>
  12460. <tbody>
  12461. <tr>
  12462. <td>
  12463. <code>type</code></br>
  12464. <em>
  12465. <a href="#external-secrets.io/v1.SecretStoreConditionType">
  12466. SecretStoreConditionType
  12467. </a>
  12468. </em>
  12469. </td>
  12470. <td>
  12471. </td>
  12472. </tr>
  12473. <tr>
  12474. <td>
  12475. <code>status</code></br>
  12476. <em>
  12477. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  12478. Kubernetes core/v1.ConditionStatus
  12479. </a>
  12480. </em>
  12481. </td>
  12482. <td>
  12483. </td>
  12484. </tr>
  12485. <tr>
  12486. <td>
  12487. <code>reason</code></br>
  12488. <em>
  12489. string
  12490. </em>
  12491. </td>
  12492. <td>
  12493. <em>(Optional)</em>
  12494. </td>
  12495. </tr>
  12496. <tr>
  12497. <td>
  12498. <code>message</code></br>
  12499. <em>
  12500. string
  12501. </em>
  12502. </td>
  12503. <td>
  12504. <em>(Optional)</em>
  12505. </td>
  12506. </tr>
  12507. <tr>
  12508. <td>
  12509. <code>lastTransitionTime</code></br>
  12510. <em>
  12511. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  12512. Kubernetes meta/v1.Time
  12513. </a>
  12514. </em>
  12515. </td>
  12516. <td>
  12517. <em>(Optional)</em>
  12518. </td>
  12519. </tr>
  12520. </tbody>
  12521. </table>
  12522. <h3 id="external-secrets.io/v1.SecretVersionSelectionPolicy">SecretVersionSelectionPolicy
  12523. (<code>string</code> alias)</p></h3>
  12524. <p>
  12525. (<em>Appears on:</em>
  12526. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  12527. </p>
  12528. <p>
  12529. <p>SecretVersionSelectionPolicy defines the policy for selecting secret versions in GCP Secret Manager.</p>
  12530. </p>
  12531. <table>
  12532. <thead>
  12533. <tr>
  12534. <th>Value</th>
  12535. <th>Description</th>
  12536. </tr>
  12537. </thead>
  12538. <tbody><tr><td><p>&#34;LatestOrFail&#34;</p></td>
  12539. <td><p>SecretVersionSelectionPolicyLatestOrFail means the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.</p>
  12540. </td>
  12541. </tr><tr><td><p>&#34;LatestOrFetch&#34;</p></td>
  12542. <td><p>SecretVersionSelectionPolicyLatestOrFetch behaves like SecretVersionSelectionPolicyLatestOrFail but falls back to fetching the latest version if the version is DESTROYED or DISABLED.</p>
  12543. </td>
  12544. </tr></tbody>
  12545. </table>
  12546. <h3 id="external-secrets.io/v1.SecretsClient">SecretsClient
  12547. </h3>
  12548. <p>
  12549. <p>SecretsClient provides access to secrets.</p>
  12550. </p>
  12551. <h3 id="external-secrets.io/v1.SecretsManager">SecretsManager
  12552. </h3>
  12553. <p>
  12554. (<em>Appears on:</em>
  12555. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  12556. </p>
  12557. <p>
  12558. <p>SecretsManager defines how the provider behaves when interacting with AWS
  12559. SecretsManager. Some of these settings are only applicable to controlling how
  12560. secrets are deleted, and hence only apply to PushSecret (and only when
  12561. deletionPolicy is set to Delete).</p>
  12562. </p>
  12563. <table>
  12564. <thead>
  12565. <tr>
  12566. <th>Field</th>
  12567. <th>Description</th>
  12568. </tr>
  12569. </thead>
  12570. <tbody>
  12571. <tr>
  12572. <td>
  12573. <code>forceDeleteWithoutRecovery</code></br>
  12574. <em>
  12575. bool
  12576. </em>
  12577. </td>
  12578. <td>
  12579. <em>(Optional)</em>
  12580. <p>Specifies whether to delete the secret without any recovery window. You
  12581. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  12582. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  12583. recovery window.
  12584. see: <a href="https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.html#SecretsManager-DeleteSecret-request-ForceDeleteWithoutRecovery">https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.html#SecretsManager-DeleteSecret-request-ForceDeleteWithoutRecovery</a></p>
  12585. </td>
  12586. </tr>
  12587. <tr>
  12588. <td>
  12589. <code>recoveryWindowInDays</code></br>
  12590. <em>
  12591. int64
  12592. </em>
  12593. </td>
  12594. <td>
  12595. <em>(Optional)</em>
  12596. <p>The number of days from 7 to 30 that Secrets Manager waits before
  12597. permanently deleting the secret. You can&rsquo;t use both this parameter and
  12598. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  12599. then by default Secrets Manager uses a 30-day recovery window.
  12600. see: <a href="https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.html#SecretsManager-DeleteSecret-request-RecoveryWindowInDays">https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.html#SecretsManager-DeleteSecret-request-RecoveryWindowInDays</a></p>
  12601. </td>
  12602. </tr>
  12603. </tbody>
  12604. </table>
  12605. <h3 id="external-secrets.io/v1.SenhaseguraAuth">SenhaseguraAuth
  12606. </h3>
  12607. <p>
  12608. (<em>Appears on:</em>
  12609. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  12610. </p>
  12611. <p>
  12612. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  12613. </p>
  12614. <table>
  12615. <thead>
  12616. <tr>
  12617. <th>Field</th>
  12618. <th>Description</th>
  12619. </tr>
  12620. </thead>
  12621. <tbody>
  12622. <tr>
  12623. <td>
  12624. <code>clientId</code></br>
  12625. <em>
  12626. string
  12627. </em>
  12628. </td>
  12629. <td>
  12630. </td>
  12631. </tr>
  12632. <tr>
  12633. <td>
  12634. <code>clientSecretSecretRef</code></br>
  12635. <em>
  12636. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12637. External Secrets meta/v1.SecretKeySelector
  12638. </a>
  12639. </em>
  12640. </td>
  12641. <td>
  12642. </td>
  12643. </tr>
  12644. </tbody>
  12645. </table>
  12646. <h3 id="external-secrets.io/v1.SenhaseguraModuleType">SenhaseguraModuleType
  12647. (<code>string</code> alias)</p></h3>
  12648. <p>
  12649. (<em>Appears on:</em>
  12650. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  12651. </p>
  12652. <p>
  12653. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  12654. </p>
  12655. <table>
  12656. <thead>
  12657. <tr>
  12658. <th>Value</th>
  12659. <th>Description</th>
  12660. </tr>
  12661. </thead>
  12662. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  12663. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  12664. see: https://senhasegura.com/devops
  12665. </code></pre>
  12666. </td>
  12667. </tr></tbody>
  12668. </table>
  12669. <h3 id="external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider
  12670. </h3>
  12671. <p>
  12672. (<em>Appears on:</em>
  12673. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  12674. </p>
  12675. <p>
  12676. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  12677. </p>
  12678. <table>
  12679. <thead>
  12680. <tr>
  12681. <th>Field</th>
  12682. <th>Description</th>
  12683. </tr>
  12684. </thead>
  12685. <tbody>
  12686. <tr>
  12687. <td>
  12688. <code>url</code></br>
  12689. <em>
  12690. string
  12691. </em>
  12692. </td>
  12693. <td>
  12694. <p>URL of senhasegura</p>
  12695. </td>
  12696. </tr>
  12697. <tr>
  12698. <td>
  12699. <code>module</code></br>
  12700. <em>
  12701. <a href="#external-secrets.io/v1.SenhaseguraModuleType">
  12702. SenhaseguraModuleType
  12703. </a>
  12704. </em>
  12705. </td>
  12706. <td>
  12707. <p>Module defines which senhasegura module should be used to get secrets</p>
  12708. </td>
  12709. </tr>
  12710. <tr>
  12711. <td>
  12712. <code>auth</code></br>
  12713. <em>
  12714. <a href="#external-secrets.io/v1.SenhaseguraAuth">
  12715. SenhaseguraAuth
  12716. </a>
  12717. </em>
  12718. </td>
  12719. <td>
  12720. <p>Auth defines parameters to authenticate in senhasegura</p>
  12721. </td>
  12722. </tr>
  12723. <tr>
  12724. <td>
  12725. <code>ignoreSslCertificate</code></br>
  12726. <em>
  12727. bool
  12728. </em>
  12729. </td>
  12730. <td>
  12731. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  12732. </td>
  12733. </tr>
  12734. </tbody>
  12735. </table>
  12736. <h3 id="external-secrets.io/v1.SessionTagsPolicy">SessionTagsPolicy
  12737. (<code>string</code> alias)</p></h3>
  12738. <p>
  12739. (<em>Appears on:</em>
  12740. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  12741. </p>
  12742. <p>
  12743. <p>SessionTagsPolicy defines how STS session tags are handled.</p>
  12744. </p>
  12745. <table>
  12746. <thead>
  12747. <tr>
  12748. <th>Value</th>
  12749. <th>Description</th>
  12750. </tr>
  12751. </thead>
  12752. <tbody><tr><td><p>&#34;Custom&#34;</p></td>
  12753. <td><p>SessionTagsPolicyCustom adds the tags defined in CustomSessionTags in addition to
  12754. the esoNamespace, esoStoreName, and esoStoreKind tags.</p>
  12755. </td>
  12756. </tr><tr><td><p>&#34;None&#34;</p></td>
  12757. <td><p>SessionTagsPolicyNone is the default behavior - no session tags are added.</p>
  12758. </td>
  12759. </tr><tr><td><p>&#34;Simple&#34;</p></td>
  12760. <td><p>SessionTagsPolicySimple automatically adds esoNamespace, esoStoreName, and esoStoreKind
  12761. session tags.</p>
  12762. </td>
  12763. </tr></tbody>
  12764. </table>
  12765. <h3 id="external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  12766. </h3>
  12767. <p>
  12768. (<em>Appears on:</em>
  12769. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  12770. </p>
  12771. <p>
  12772. <p>StoreGeneratorSourceRef allows you to override the source
  12773. from which the secret will be pulled from.
  12774. You can define at maximum one property.</p>
  12775. </p>
  12776. <table>
  12777. <thead>
  12778. <tr>
  12779. <th>Field</th>
  12780. <th>Description</th>
  12781. </tr>
  12782. </thead>
  12783. <tbody>
  12784. <tr>
  12785. <td>
  12786. <code>storeRef</code></br>
  12787. <em>
  12788. <a href="#external-secrets.io/v1.SecretStoreRef">
  12789. SecretStoreRef
  12790. </a>
  12791. </em>
  12792. </td>
  12793. <td>
  12794. <em>(Optional)</em>
  12795. </td>
  12796. </tr>
  12797. <tr>
  12798. <td>
  12799. <code>generatorRef</code></br>
  12800. <em>
  12801. <a href="#external-secrets.io/v1.GeneratorRef">
  12802. GeneratorRef
  12803. </a>
  12804. </em>
  12805. </td>
  12806. <td>
  12807. <em>(Optional)</em>
  12808. <p>GeneratorRef points to a generator custom resource.</p>
  12809. </td>
  12810. </tr>
  12811. </tbody>
  12812. </table>
  12813. <h3 id="external-secrets.io/v1.StoreSourceRef">StoreSourceRef
  12814. </h3>
  12815. <p>
  12816. (<em>Appears on:</em>
  12817. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>)
  12818. </p>
  12819. <p>
  12820. <p>StoreSourceRef allows you to override the SecretStore source
  12821. from which the secret will be pulled from.
  12822. You can define at maximum one property.</p>
  12823. </p>
  12824. <table>
  12825. <thead>
  12826. <tr>
  12827. <th>Field</th>
  12828. <th>Description</th>
  12829. </tr>
  12830. </thead>
  12831. <tbody>
  12832. <tr>
  12833. <td>
  12834. <code>storeRef</code></br>
  12835. <em>
  12836. <a href="#external-secrets.io/v1.SecretStoreRef">
  12837. SecretStoreRef
  12838. </a>
  12839. </em>
  12840. </td>
  12841. <td>
  12842. <em>(Optional)</em>
  12843. </td>
  12844. </tr>
  12845. <tr>
  12846. <td>
  12847. <code>generatorRef</code></br>
  12848. <em>
  12849. <a href="#external-secrets.io/v1.GeneratorRef">
  12850. GeneratorRef
  12851. </a>
  12852. </em>
  12853. </td>
  12854. <td>
  12855. <p>GeneratorRef points to a generator custom resource.</p>
  12856. <p>Deprecated: The generatorRef is not implemented in .data[].
  12857. this will be removed with v1.</p>
  12858. </td>
  12859. </tr>
  12860. </tbody>
  12861. </table>
  12862. <h3 id="external-secrets.io/v1.Tag">Tag
  12863. </h3>
  12864. <p>
  12865. <p>Tag is a key-value pair that can be attached to an AWS resource.
  12866. see: <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html</a></p>
  12867. </p>
  12868. <table>
  12869. <thead>
  12870. <tr>
  12871. <th>Field</th>
  12872. <th>Description</th>
  12873. </tr>
  12874. </thead>
  12875. <tbody>
  12876. <tr>
  12877. <td>
  12878. <code>key</code></br>
  12879. <em>
  12880. string
  12881. </em>
  12882. </td>
  12883. <td>
  12884. </td>
  12885. </tr>
  12886. <tr>
  12887. <td>
  12888. <code>value</code></br>
  12889. <em>
  12890. string
  12891. </em>
  12892. </td>
  12893. <td>
  12894. </td>
  12895. </tr>
  12896. </tbody>
  12897. </table>
  12898. <h3 id="external-secrets.io/v1.TemplateEngineVersion">TemplateEngineVersion
  12899. (<code>string</code> alias)</p></h3>
  12900. <p>
  12901. (<em>Appears on:</em>
  12902. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  12903. </p>
  12904. <p>
  12905. <p>TemplateEngineVersion specifies the template engine version that should be used to
  12906. compile/execute the template.</p>
  12907. </p>
  12908. <table>
  12909. <thead>
  12910. <tr>
  12911. <th>Value</th>
  12912. <th>Description</th>
  12913. </tr>
  12914. </thead>
  12915. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  12916. <td><p>TemplateEngineV2 is the currently supported template engine version.</p>
  12917. </td>
  12918. </tr></tbody>
  12919. </table>
  12920. <h3 id="external-secrets.io/v1.TemplateFrom">TemplateFrom
  12921. </h3>
  12922. <p>
  12923. (<em>Appears on:</em>
  12924. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  12925. </p>
  12926. <p>
  12927. <p>TemplateFrom specifies a source for templates.
  12928. Each item in the list can either reference a ConfigMap or a Secret resource.</p>
  12929. </p>
  12930. <table>
  12931. <thead>
  12932. <tr>
  12933. <th>Field</th>
  12934. <th>Description</th>
  12935. </tr>
  12936. </thead>
  12937. <tbody>
  12938. <tr>
  12939. <td>
  12940. <code>configMap</code></br>
  12941. <em>
  12942. <a href="#external-secrets.io/v1.TemplateRef">
  12943. TemplateRef
  12944. </a>
  12945. </em>
  12946. </td>
  12947. <td>
  12948. </td>
  12949. </tr>
  12950. <tr>
  12951. <td>
  12952. <code>secret</code></br>
  12953. <em>
  12954. <a href="#external-secrets.io/v1.TemplateRef">
  12955. TemplateRef
  12956. </a>
  12957. </em>
  12958. </td>
  12959. <td>
  12960. </td>
  12961. </tr>
  12962. <tr>
  12963. <td>
  12964. <code>target</code></br>
  12965. <em>
  12966. string
  12967. </em>
  12968. </td>
  12969. <td>
  12970. <em>(Optional)</em>
  12971. <p>Target specifies where to place the template result.
  12972. For Secret resources, common values are: &ldquo;Data&rdquo;, &ldquo;Annotations&rdquo;, &ldquo;Labels&rdquo;.
  12973. For custom resources (when spec.target.manifest is set), this supports
  12974. nested paths like &ldquo;spec.database.config&rdquo; or &ldquo;data&rdquo;.</p>
  12975. </td>
  12976. </tr>
  12977. <tr>
  12978. <td>
  12979. <code>literal</code></br>
  12980. <em>
  12981. string
  12982. </em>
  12983. </td>
  12984. <td>
  12985. <em>(Optional)</em>
  12986. </td>
  12987. </tr>
  12988. <tr>
  12989. <td>
  12990. <code>valuesDecodingStrategy</code></br>
  12991. <em>
  12992. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  12993. ExternalSecretDecodingStrategy
  12994. </a>
  12995. </em>
  12996. </td>
  12997. <td>
  12998. <em>(Optional)</em>
  12999. <p>Used to define a decoding Strategy for the rendered template values.</p>
  13000. </td>
  13001. </tr>
  13002. </tbody>
  13003. </table>
  13004. <h3 id="external-secrets.io/v1.TemplateMergePolicy">TemplateMergePolicy
  13005. (<code>string</code> alias)</p></h3>
  13006. <p>
  13007. (<em>Appears on:</em>
  13008. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  13009. </p>
  13010. <p>
  13011. <p>TemplateMergePolicy defines how the rendered template should be merged with the existing Secret data.</p>
  13012. </p>
  13013. <table>
  13014. <thead>
  13015. <tr>
  13016. <th>Value</th>
  13017. <th>Description</th>
  13018. </tr>
  13019. </thead>
  13020. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  13021. <td></td>
  13022. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  13023. <td></td>
  13024. </tr></tbody>
  13025. </table>
  13026. <h3 id="external-secrets.io/v1.TemplateRef">TemplateRef
  13027. </h3>
  13028. <p>
  13029. (<em>Appears on:</em>
  13030. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  13031. </p>
  13032. <p>
  13033. <p>TemplateRef specifies a reference to either a ConfigMap or a Secret resource.</p>
  13034. </p>
  13035. <table>
  13036. <thead>
  13037. <tr>
  13038. <th>Field</th>
  13039. <th>Description</th>
  13040. </tr>
  13041. </thead>
  13042. <tbody>
  13043. <tr>
  13044. <td>
  13045. <code>name</code></br>
  13046. <em>
  13047. string
  13048. </em>
  13049. </td>
  13050. <td>
  13051. <p>The name of the ConfigMap/Secret resource</p>
  13052. </td>
  13053. </tr>
  13054. <tr>
  13055. <td>
  13056. <code>items</code></br>
  13057. <em>
  13058. <a href="#external-secrets.io/v1.TemplateRefItem">
  13059. []TemplateRefItem
  13060. </a>
  13061. </em>
  13062. </td>
  13063. <td>
  13064. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  13065. </td>
  13066. </tr>
  13067. </tbody>
  13068. </table>
  13069. <h3 id="external-secrets.io/v1.TemplateRefItem">TemplateRefItem
  13070. </h3>
  13071. <p>
  13072. (<em>Appears on:</em>
  13073. <a href="#external-secrets.io/v1.TemplateRef">TemplateRef</a>)
  13074. </p>
  13075. <p>
  13076. <p>TemplateRefItem specifies a key in the ConfigMap/Secret to use as a template for Secret data.</p>
  13077. </p>
  13078. <table>
  13079. <thead>
  13080. <tr>
  13081. <th>Field</th>
  13082. <th>Description</th>
  13083. </tr>
  13084. </thead>
  13085. <tbody>
  13086. <tr>
  13087. <td>
  13088. <code>key</code></br>
  13089. <em>
  13090. string
  13091. </em>
  13092. </td>
  13093. <td>
  13094. <p>A key in the ConfigMap/Secret</p>
  13095. </td>
  13096. </tr>
  13097. <tr>
  13098. <td>
  13099. <code>templateAs</code></br>
  13100. <em>
  13101. <a href="#external-secrets.io/v1.TemplateScope">
  13102. TemplateScope
  13103. </a>
  13104. </em>
  13105. </td>
  13106. <td>
  13107. </td>
  13108. </tr>
  13109. </tbody>
  13110. </table>
  13111. <h3 id="external-secrets.io/v1.TemplateScope">TemplateScope
  13112. (<code>string</code> alias)</p></h3>
  13113. <p>
  13114. (<em>Appears on:</em>
  13115. <a href="#external-secrets.io/v1.TemplateRefItem">TemplateRefItem</a>)
  13116. </p>
  13117. <p>
  13118. <p>TemplateScope specifies how the template keys should be interpreted.</p>
  13119. </p>
  13120. <table>
  13121. <thead>
  13122. <tr>
  13123. <th>Value</th>
  13124. <th>Description</th>
  13125. </tr>
  13126. </thead>
  13127. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  13128. <td></td>
  13129. </tr><tr><td><p>&#34;Values&#34;</p></td>
  13130. <td></td>
  13131. </tr></tbody>
  13132. </table>
  13133. <h3 id="external-secrets.io/v1.TokenAuth">TokenAuth
  13134. </h3>
  13135. <p>
  13136. (<em>Appears on:</em>
  13137. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  13138. </p>
  13139. <p>
  13140. <p>TokenAuth defines token-based authentication configuration for Kubernetes.</p>
  13141. </p>
  13142. <table>
  13143. <thead>
  13144. <tr>
  13145. <th>Field</th>
  13146. <th>Description</th>
  13147. </tr>
  13148. </thead>
  13149. <tbody>
  13150. <tr>
  13151. <td>
  13152. <code>bearerToken</code></br>
  13153. <em>
  13154. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13155. External Secrets meta/v1.SecretKeySelector
  13156. </a>
  13157. </em>
  13158. </td>
  13159. <td>
  13160. </td>
  13161. </tr>
  13162. </tbody>
  13163. </table>
  13164. <h3 id="external-secrets.io/v1.TokenAuthCredentials">TokenAuthCredentials
  13165. </h3>
  13166. <p>
  13167. (<em>Appears on:</em>
  13168. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  13169. </p>
  13170. <p>
  13171. <p>TokenAuthCredentials represents the credentials for access token-based authentication.</p>
  13172. </p>
  13173. <table>
  13174. <thead>
  13175. <tr>
  13176. <th>Field</th>
  13177. <th>Description</th>
  13178. </tr>
  13179. </thead>
  13180. <tbody>
  13181. <tr>
  13182. <td>
  13183. <code>accessToken</code></br>
  13184. <em>
  13185. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13186. External Secrets meta/v1.SecretKeySelector
  13187. </a>
  13188. </em>
  13189. </td>
  13190. <td>
  13191. </td>
  13192. </tr>
  13193. </tbody>
  13194. </table>
  13195. <h3 id="external-secrets.io/v1.UniversalAuthCredentials">UniversalAuthCredentials
  13196. </h3>
  13197. <p>
  13198. (<em>Appears on:</em>
  13199. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  13200. </p>
  13201. <p>
  13202. <p>UniversalAuthCredentials represents the client credentials for universal authentication.</p>
  13203. </p>
  13204. <table>
  13205. <thead>
  13206. <tr>
  13207. <th>Field</th>
  13208. <th>Description</th>
  13209. </tr>
  13210. </thead>
  13211. <tbody>
  13212. <tr>
  13213. <td>
  13214. <code>clientId</code></br>
  13215. <em>
  13216. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13217. External Secrets meta/v1.SecretKeySelector
  13218. </a>
  13219. </em>
  13220. </td>
  13221. <td>
  13222. </td>
  13223. </tr>
  13224. <tr>
  13225. <td>
  13226. <code>clientSecret</code></br>
  13227. <em>
  13228. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13229. External Secrets meta/v1.SecretKeySelector
  13230. </a>
  13231. </em>
  13232. </td>
  13233. <td>
  13234. </td>
  13235. </tr>
  13236. </tbody>
  13237. </table>
  13238. <h3 id="external-secrets.io/v1.ValidationResult">ValidationResult
  13239. (<code>byte</code> alias)</p></h3>
  13240. <p>
  13241. (<em>Appears on:</em>
  13242. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  13243. </p>
  13244. <p>
  13245. <p>ValidationResult is defined type for the number of validation results.</p>
  13246. </p>
  13247. <table>
  13248. <thead>
  13249. <tr>
  13250. <th>Value</th>
  13251. <th>Description</th>
  13252. </tr>
  13253. </thead>
  13254. <tbody><tr><td><p>2</p></td>
  13255. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  13256. </td>
  13257. </tr><tr><td><p>0</p></td>
  13258. <td><p>ValidationResultReady indicates that the client is configured correctly
  13259. and can be used.</p>
  13260. </td>
  13261. </tr><tr><td><p>1</p></td>
  13262. <td><p>ValidationResultUnknown indicates that the client can be used
  13263. but information is missing, and it can not be validated.</p>
  13264. </td>
  13265. </tr></tbody>
  13266. </table>
  13267. <h3 id="external-secrets.io/v1.VaultAppRole">VaultAppRole
  13268. </h3>
  13269. <p>
  13270. (<em>Appears on:</em>
  13271. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13272. </p>
  13273. <p>
  13274. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  13275. with the role and secret stored in a Kubernetes Secret resource.</p>
  13276. </p>
  13277. <table>
  13278. <thead>
  13279. <tr>
  13280. <th>Field</th>
  13281. <th>Description</th>
  13282. </tr>
  13283. </thead>
  13284. <tbody>
  13285. <tr>
  13286. <td>
  13287. <code>path</code></br>
  13288. <em>
  13289. string
  13290. </em>
  13291. </td>
  13292. <td>
  13293. <p>Path where the App Role authentication backend is mounted
  13294. in Vault, e.g: &ldquo;approle&rdquo;</p>
  13295. </td>
  13296. </tr>
  13297. <tr>
  13298. <td>
  13299. <code>roleId</code></br>
  13300. <em>
  13301. string
  13302. </em>
  13303. </td>
  13304. <td>
  13305. <em>(Optional)</em>
  13306. <p>RoleID configured in the App Role authentication backend when setting
  13307. up the authentication backend in Vault.</p>
  13308. </td>
  13309. </tr>
  13310. <tr>
  13311. <td>
  13312. <code>roleRef</code></br>
  13313. <em>
  13314. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13315. External Secrets meta/v1.SecretKeySelector
  13316. </a>
  13317. </em>
  13318. </td>
  13319. <td>
  13320. <em>(Optional)</em>
  13321. <p>Reference to a key in a Secret that contains the App Role ID used
  13322. to authenticate with Vault.
  13323. The <code>key</code> field must be specified and denotes which entry within the Secret
  13324. resource is used as the app role id.</p>
  13325. </td>
  13326. </tr>
  13327. <tr>
  13328. <td>
  13329. <code>secretRef</code></br>
  13330. <em>
  13331. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13332. External Secrets meta/v1.SecretKeySelector
  13333. </a>
  13334. </em>
  13335. </td>
  13336. <td>
  13337. <p>Reference to a key in a Secret that contains the App Role secret used
  13338. to authenticate with Vault.
  13339. The <code>key</code> field must be specified and denotes which entry within the Secret
  13340. resource is used as the app role secret.</p>
  13341. </td>
  13342. </tr>
  13343. </tbody>
  13344. </table>
  13345. <h3 id="external-secrets.io/v1.VaultAuth">VaultAuth
  13346. </h3>
  13347. <p>
  13348. (<em>Appears on:</em>
  13349. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13350. </p>
  13351. <p>
  13352. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  13353. Only one of <code>tokenSecretRef</code>, <code>appRole</code>, <code>kubernetes</code>, <code>ldap</code>, <code>userPass</code>, <code>jwt</code>, <code>cert</code>, <code>iam</code> or <code>gcp</code>
  13354. can be specified. A namespace to authenticate against can optionally be specified.</p>
  13355. </p>
  13356. <table>
  13357. <thead>
  13358. <tr>
  13359. <th>Field</th>
  13360. <th>Description</th>
  13361. </tr>
  13362. </thead>
  13363. <tbody>
  13364. <tr>
  13365. <td>
  13366. <code>namespace</code></br>
  13367. <em>
  13368. string
  13369. </em>
  13370. </td>
  13371. <td>
  13372. <em>(Optional)</em>
  13373. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  13374. Namespaces is a set of features within Vault Enterprise that allows
  13375. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  13376. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  13377. This will default to Vault.Namespace field if set, or empty otherwise</p>
  13378. </td>
  13379. </tr>
  13380. <tr>
  13381. <td>
  13382. <code>tokenSecretRef</code></br>
  13383. <em>
  13384. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13385. External Secrets meta/v1.SecretKeySelector
  13386. </a>
  13387. </em>
  13388. </td>
  13389. <td>
  13390. <em>(Optional)</em>
  13391. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  13392. </td>
  13393. </tr>
  13394. <tr>
  13395. <td>
  13396. <code>appRole</code></br>
  13397. <em>
  13398. <a href="#external-secrets.io/v1.VaultAppRole">
  13399. VaultAppRole
  13400. </a>
  13401. </em>
  13402. </td>
  13403. <td>
  13404. <em>(Optional)</em>
  13405. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  13406. with the role and secret stored in a Kubernetes Secret resource.</p>
  13407. </td>
  13408. </tr>
  13409. <tr>
  13410. <td>
  13411. <code>kubernetes</code></br>
  13412. <em>
  13413. <a href="#external-secrets.io/v1.VaultKubernetesAuth">
  13414. VaultKubernetesAuth
  13415. </a>
  13416. </em>
  13417. </td>
  13418. <td>
  13419. <em>(Optional)</em>
  13420. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  13421. token stored in the named Secret resource to the Vault server.</p>
  13422. </td>
  13423. </tr>
  13424. <tr>
  13425. <td>
  13426. <code>ldap</code></br>
  13427. <em>
  13428. <a href="#external-secrets.io/v1.VaultLdapAuth">
  13429. VaultLdapAuth
  13430. </a>
  13431. </em>
  13432. </td>
  13433. <td>
  13434. <em>(Optional)</em>
  13435. <p>Ldap authenticates with Vault by passing username/password pair using
  13436. the LDAP authentication method</p>
  13437. </td>
  13438. </tr>
  13439. <tr>
  13440. <td>
  13441. <code>jwt</code></br>
  13442. <em>
  13443. <a href="#external-secrets.io/v1.VaultJwtAuth">
  13444. VaultJwtAuth
  13445. </a>
  13446. </em>
  13447. </td>
  13448. <td>
  13449. <em>(Optional)</em>
  13450. <p>Jwt authenticates with Vault by passing role and JWT token using the
  13451. JWT/OIDC authentication method</p>
  13452. </td>
  13453. </tr>
  13454. <tr>
  13455. <td>
  13456. <code>cert</code></br>
  13457. <em>
  13458. <a href="#external-secrets.io/v1.VaultCertAuth">
  13459. VaultCertAuth
  13460. </a>
  13461. </em>
  13462. </td>
  13463. <td>
  13464. <em>(Optional)</em>
  13465. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  13466. Cert authentication method</p>
  13467. </td>
  13468. </tr>
  13469. <tr>
  13470. <td>
  13471. <code>iam</code></br>
  13472. <em>
  13473. <a href="#external-secrets.io/v1.VaultIamAuth">
  13474. VaultIamAuth
  13475. </a>
  13476. </em>
  13477. </td>
  13478. <td>
  13479. <em>(Optional)</em>
  13480. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  13481. AWS IAM authentication method</p>
  13482. </td>
  13483. </tr>
  13484. <tr>
  13485. <td>
  13486. <code>userPass</code></br>
  13487. <em>
  13488. <a href="#external-secrets.io/v1.VaultUserPassAuth">
  13489. VaultUserPassAuth
  13490. </a>
  13491. </em>
  13492. </td>
  13493. <td>
  13494. <em>(Optional)</em>
  13495. <p>UserPass authenticates with Vault by passing username/password pair</p>
  13496. </td>
  13497. </tr>
  13498. <tr>
  13499. <td>
  13500. <code>gcp</code></br>
  13501. <em>
  13502. <a href="#external-secrets.io/v1.VaultGCPAuth">
  13503. VaultGCPAuth
  13504. </a>
  13505. </em>
  13506. </td>
  13507. <td>
  13508. <em>(Optional)</em>
  13509. <p>Gcp authenticates with Vault using Google Cloud Platform authentication method
  13510. GCP authentication method</p>
  13511. </td>
  13512. </tr>
  13513. </tbody>
  13514. </table>
  13515. <h3 id="external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth
  13516. </h3>
  13517. <p>
  13518. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  13519. Only one of secretRef or jwt can be specified.
  13520. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  13521. </p>
  13522. <table>
  13523. <thead>
  13524. <tr>
  13525. <th>Field</th>
  13526. <th>Description</th>
  13527. </tr>
  13528. </thead>
  13529. <tbody>
  13530. <tr>
  13531. <td>
  13532. <code>secretRef</code></br>
  13533. <em>
  13534. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  13535. VaultAwsAuthSecretRef
  13536. </a>
  13537. </em>
  13538. </td>
  13539. <td>
  13540. <em>(Optional)</em>
  13541. </td>
  13542. </tr>
  13543. <tr>
  13544. <td>
  13545. <code>jwt</code></br>
  13546. <em>
  13547. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  13548. VaultAwsJWTAuth
  13549. </a>
  13550. </em>
  13551. </td>
  13552. <td>
  13553. <em>(Optional)</em>
  13554. </td>
  13555. </tr>
  13556. </tbody>
  13557. </table>
  13558. <h3 id="external-secrets.io/v1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  13559. </h3>
  13560. <p>
  13561. (<em>Appears on:</em>
  13562. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  13563. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  13564. </p>
  13565. <p>
  13566. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  13567. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  13568. </p>
  13569. <table>
  13570. <thead>
  13571. <tr>
  13572. <th>Field</th>
  13573. <th>Description</th>
  13574. </tr>
  13575. </thead>
  13576. <tbody>
  13577. <tr>
  13578. <td>
  13579. <code>accessKeyIDSecretRef</code></br>
  13580. <em>
  13581. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13582. External Secrets meta/v1.SecretKeySelector
  13583. </a>
  13584. </em>
  13585. </td>
  13586. <td>
  13587. <em>(Optional)</em>
  13588. <p>The AccessKeyID is used for authentication</p>
  13589. </td>
  13590. </tr>
  13591. <tr>
  13592. <td>
  13593. <code>secretAccessKeySecretRef</code></br>
  13594. <em>
  13595. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13596. External Secrets meta/v1.SecretKeySelector
  13597. </a>
  13598. </em>
  13599. </td>
  13600. <td>
  13601. <em>(Optional)</em>
  13602. <p>The SecretAccessKey is used for authentication</p>
  13603. </td>
  13604. </tr>
  13605. <tr>
  13606. <td>
  13607. <code>sessionTokenSecretRef</code></br>
  13608. <em>
  13609. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13610. External Secrets meta/v1.SecretKeySelector
  13611. </a>
  13612. </em>
  13613. </td>
  13614. <td>
  13615. <em>(Optional)</em>
  13616. <p>The SessionToken used for authentication
  13617. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  13618. see: <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html">https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html</a></p>
  13619. </td>
  13620. </tr>
  13621. </tbody>
  13622. </table>
  13623. <h3 id="external-secrets.io/v1.VaultAwsJWTAuth">VaultAwsJWTAuth
  13624. </h3>
  13625. <p>
  13626. (<em>Appears on:</em>
  13627. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  13628. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  13629. </p>
  13630. <p>
  13631. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  13632. </p>
  13633. <table>
  13634. <thead>
  13635. <tr>
  13636. <th>Field</th>
  13637. <th>Description</th>
  13638. </tr>
  13639. </thead>
  13640. <tbody>
  13641. <tr>
  13642. <td>
  13643. <code>serviceAccountRef</code></br>
  13644. <em>
  13645. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  13646. External Secrets meta/v1.ServiceAccountSelector
  13647. </a>
  13648. </em>
  13649. </td>
  13650. <td>
  13651. <em>(Optional)</em>
  13652. </td>
  13653. </tr>
  13654. </tbody>
  13655. </table>
  13656. <h3 id="external-secrets.io/v1.VaultCertAuth">VaultCertAuth
  13657. </h3>
  13658. <p>
  13659. (<em>Appears on:</em>
  13660. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13661. </p>
  13662. <p>
  13663. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  13664. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  13665. </p>
  13666. <table>
  13667. <thead>
  13668. <tr>
  13669. <th>Field</th>
  13670. <th>Description</th>
  13671. </tr>
  13672. </thead>
  13673. <tbody>
  13674. <tr>
  13675. <td>
  13676. <code>path</code></br>
  13677. <em>
  13678. string
  13679. </em>
  13680. </td>
  13681. <td>
  13682. <em>(Optional)</em>
  13683. <p>Path where the Certificate authentication backend is mounted
  13684. in Vault, e.g: &ldquo;cert&rdquo;</p>
  13685. </td>
  13686. </tr>
  13687. <tr>
  13688. <td>
  13689. <code>vaultRole</code></br>
  13690. <em>
  13691. string
  13692. </em>
  13693. </td>
  13694. <td>
  13695. <em>(Optional)</em>
  13696. <p>VaultRole specifies the Vault role to use for TLS certificate authentication.</p>
  13697. </td>
  13698. </tr>
  13699. <tr>
  13700. <td>
  13701. <code>clientCert</code></br>
  13702. <em>
  13703. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13704. External Secrets meta/v1.SecretKeySelector
  13705. </a>
  13706. </em>
  13707. </td>
  13708. <td>
  13709. <em>(Optional)</em>
  13710. <p>ClientCert is a certificate to authenticate using the Cert Vault
  13711. authentication method</p>
  13712. </td>
  13713. </tr>
  13714. <tr>
  13715. <td>
  13716. <code>secretRef</code></br>
  13717. <em>
  13718. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13719. External Secrets meta/v1.SecretKeySelector
  13720. </a>
  13721. </em>
  13722. </td>
  13723. <td>
  13724. <em>(Optional)</em>
  13725. <p>SecretRef to a key in a Secret resource containing client private key to
  13726. authenticate with Vault using the Cert authentication method</p>
  13727. </td>
  13728. </tr>
  13729. </tbody>
  13730. </table>
  13731. <h3 id="external-secrets.io/v1.VaultCheckAndSet">VaultCheckAndSet
  13732. </h3>
  13733. <p>
  13734. (<em>Appears on:</em>
  13735. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13736. </p>
  13737. <p>
  13738. <p>VaultCheckAndSet defines the Check-And-Set (CAS) settings for Vault KV v2 PushSecret operations.</p>
  13739. </p>
  13740. <table>
  13741. <thead>
  13742. <tr>
  13743. <th>Field</th>
  13744. <th>Description</th>
  13745. </tr>
  13746. </thead>
  13747. <tbody>
  13748. <tr>
  13749. <td>
  13750. <code>required</code></br>
  13751. <em>
  13752. bool
  13753. </em>
  13754. </td>
  13755. <td>
  13756. <em>(Optional)</em>
  13757. <p>Required when true, all write operations must include a check-and-set parameter.
  13758. This helps prevent unintentional overwrites of secrets.</p>
  13759. </td>
  13760. </tr>
  13761. </tbody>
  13762. </table>
  13763. <h3 id="external-secrets.io/v1.VaultClientTLS">VaultClientTLS
  13764. </h3>
  13765. <p>
  13766. (<em>Appears on:</em>
  13767. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13768. </p>
  13769. <p>
  13770. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  13771. when the Vault server requires mutual authentication.</p>
  13772. </p>
  13773. <table>
  13774. <thead>
  13775. <tr>
  13776. <th>Field</th>
  13777. <th>Description</th>
  13778. </tr>
  13779. </thead>
  13780. <tbody>
  13781. <tr>
  13782. <td>
  13783. <code>certSecretRef</code></br>
  13784. <em>
  13785. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13786. External Secrets meta/v1.SecretKeySelector
  13787. </a>
  13788. </em>
  13789. </td>
  13790. <td>
  13791. <em>(Optional)</em>
  13792. <p>CertSecretRef is a certificate added to the transport layer
  13793. when communicating with the Vault server.
  13794. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  13795. </td>
  13796. </tr>
  13797. <tr>
  13798. <td>
  13799. <code>keySecretRef</code></br>
  13800. <em>
  13801. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13802. External Secrets meta/v1.SecretKeySelector
  13803. </a>
  13804. </em>
  13805. </td>
  13806. <td>
  13807. <em>(Optional)</em>
  13808. <p>KeySecretRef to a key in a Secret resource containing client private key
  13809. added to the transport layer when communicating with the Vault server.
  13810. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  13811. </td>
  13812. </tr>
  13813. </tbody>
  13814. </table>
  13815. <h3 id="external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth
  13816. </h3>
  13817. <p>
  13818. (<em>Appears on:</em>
  13819. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13820. </p>
  13821. <p>
  13822. <p>VaultGCPAuth authenticates with Vault using Google Cloud Platform authentication method.
  13823. Refer: <a href="https://developer.hashicorp.com/vault/docs/auth/gcp">https://developer.hashicorp.com/vault/docs/auth/gcp</a></p>
  13824. <p>When ServiceAccountRef, SecretRef and WorkloadIdentity are not specified, the provider will use the controller pod&rsquo;s
  13825. identity to authenticate with GCP. This supports both GKE Workload Identity and service account keys.</p>
  13826. </p>
  13827. <table>
  13828. <thead>
  13829. <tr>
  13830. <th>Field</th>
  13831. <th>Description</th>
  13832. </tr>
  13833. </thead>
  13834. <tbody>
  13835. <tr>
  13836. <td>
  13837. <code>path</code></br>
  13838. <em>
  13839. string
  13840. </em>
  13841. </td>
  13842. <td>
  13843. <em>(Optional)</em>
  13844. <p>Path where the GCP auth method is enabled in Vault, e.g: &ldquo;gcp&rdquo;</p>
  13845. </td>
  13846. </tr>
  13847. <tr>
  13848. <td>
  13849. <code>role</code></br>
  13850. <em>
  13851. string
  13852. </em>
  13853. </td>
  13854. <td>
  13855. <p>Vault Role. In Vault, a role describes an identity with a set of permissions, groups, or policies you want to attach to a user of the secrets engine.</p>
  13856. </td>
  13857. </tr>
  13858. <tr>
  13859. <td>
  13860. <code>projectID</code></br>
  13861. <em>
  13862. string
  13863. </em>
  13864. </td>
  13865. <td>
  13866. <em>(Optional)</em>
  13867. <p>Project ID of the Google Cloud Platform project</p>
  13868. </td>
  13869. </tr>
  13870. <tr>
  13871. <td>
  13872. <code>location</code></br>
  13873. <em>
  13874. string
  13875. </em>
  13876. </td>
  13877. <td>
  13878. <em>(Optional)</em>
  13879. <p>Location optionally defines a location/region for the secret</p>
  13880. </td>
  13881. </tr>
  13882. <tr>
  13883. <td>
  13884. <code>secretRef</code></br>
  13885. <em>
  13886. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  13887. GCPSMAuthSecretRef
  13888. </a>
  13889. </em>
  13890. </td>
  13891. <td>
  13892. <em>(Optional)</em>
  13893. <p>Specify credentials in a Secret object</p>
  13894. </td>
  13895. </tr>
  13896. <tr>
  13897. <td>
  13898. <code>workloadIdentity</code></br>
  13899. <em>
  13900. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  13901. GCPWorkloadIdentity
  13902. </a>
  13903. </em>
  13904. </td>
  13905. <td>
  13906. <em>(Optional)</em>
  13907. <p>Specify a service account with Workload Identity</p>
  13908. </td>
  13909. </tr>
  13910. <tr>
  13911. <td>
  13912. <code>serviceAccountRef</code></br>
  13913. <em>
  13914. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  13915. External Secrets meta/v1.ServiceAccountSelector
  13916. </a>
  13917. </em>
  13918. </td>
  13919. <td>
  13920. <em>(Optional)</em>
  13921. <p>ServiceAccountRef to a service account for impersonation</p>
  13922. </td>
  13923. </tr>
  13924. </tbody>
  13925. </table>
  13926. <h3 id="external-secrets.io/v1.VaultIamAuth">VaultIamAuth
  13927. </h3>
  13928. <p>
  13929. (<em>Appears on:</em>
  13930. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13931. </p>
  13932. <p>
  13933. <p>VaultIamAuth authenticates with Vault using the Vault&rsquo;s AWS IAM authentication method. Refer: <a href="https://developer.hashicorp.com/vault/docs/auth/aws">https://developer.hashicorp.com/vault/docs/auth/aws</a></p>
  13934. <p>When JWTAuth and SecretRef are not specified, the provider will use the controller pod&rsquo;s
  13935. identity to authenticate with AWS. This supports both IRSA and EKS Pod Identity.</p>
  13936. </p>
  13937. <table>
  13938. <thead>
  13939. <tr>
  13940. <th>Field</th>
  13941. <th>Description</th>
  13942. </tr>
  13943. </thead>
  13944. <tbody>
  13945. <tr>
  13946. <td>
  13947. <code>path</code></br>
  13948. <em>
  13949. string
  13950. </em>
  13951. </td>
  13952. <td>
  13953. <em>(Optional)</em>
  13954. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  13955. </td>
  13956. </tr>
  13957. <tr>
  13958. <td>
  13959. <code>region</code></br>
  13960. <em>
  13961. string
  13962. </em>
  13963. </td>
  13964. <td>
  13965. <em>(Optional)</em>
  13966. <p>AWS region</p>
  13967. </td>
  13968. </tr>
  13969. <tr>
  13970. <td>
  13971. <code>role</code></br>
  13972. <em>
  13973. string
  13974. </em>
  13975. </td>
  13976. <td>
  13977. <em>(Optional)</em>
  13978. <p>This is the AWS role to be assumed before talking to vault</p>
  13979. </td>
  13980. </tr>
  13981. <tr>
  13982. <td>
  13983. <code>vaultRole</code></br>
  13984. <em>
  13985. string
  13986. </em>
  13987. </td>
  13988. <td>
  13989. <p>Vault Role. In vault, a role describes an identity with a set of permissions, groups, or policies you want to attach a user of the secrets engine</p>
  13990. </td>
  13991. </tr>
  13992. <tr>
  13993. <td>
  13994. <code>externalID</code></br>
  13995. <em>
  13996. string
  13997. </em>
  13998. </td>
  13999. <td>
  14000. <p>AWS External ID set on assumed IAM roles</p>
  14001. </td>
  14002. </tr>
  14003. <tr>
  14004. <td>
  14005. <code>vaultAwsIamServerID</code></br>
  14006. <em>
  14007. string
  14008. </em>
  14009. </td>
  14010. <td>
  14011. <em>(Optional)</em>
  14012. <p>X-Vault-AWS-IAM-Server-ID is an additional header used by Vault IAM auth method to mitigate against different types of replay attacks. More details here: <a href="https://developer.hashicorp.com/vault/docs/auth/aws">https://developer.hashicorp.com/vault/docs/auth/aws</a></p>
  14013. </td>
  14014. </tr>
  14015. <tr>
  14016. <td>
  14017. <code>secretRef</code></br>
  14018. <em>
  14019. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  14020. VaultAwsAuthSecretRef
  14021. </a>
  14022. </em>
  14023. </td>
  14024. <td>
  14025. <em>(Optional)</em>
  14026. <p>Specify credentials in a Secret object</p>
  14027. </td>
  14028. </tr>
  14029. <tr>
  14030. <td>
  14031. <code>jwt</code></br>
  14032. <em>
  14033. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  14034. VaultAwsJWTAuth
  14035. </a>
  14036. </em>
  14037. </td>
  14038. <td>
  14039. <em>(Optional)</em>
  14040. <p>Specify a service account with IRSA enabled</p>
  14041. </td>
  14042. </tr>
  14043. </tbody>
  14044. </table>
  14045. <h3 id="external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth
  14046. </h3>
  14047. <p>
  14048. (<em>Appears on:</em>
  14049. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14050. </p>
  14051. <p>
  14052. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  14053. method, with the role name and a token stored in a Kubernetes Secret resource or
  14054. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  14055. </p>
  14056. <table>
  14057. <thead>
  14058. <tr>
  14059. <th>Field</th>
  14060. <th>Description</th>
  14061. </tr>
  14062. </thead>
  14063. <tbody>
  14064. <tr>
  14065. <td>
  14066. <code>path</code></br>
  14067. <em>
  14068. string
  14069. </em>
  14070. </td>
  14071. <td>
  14072. <p>Path where the JWT authentication backend is mounted
  14073. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  14074. </td>
  14075. </tr>
  14076. <tr>
  14077. <td>
  14078. <code>role</code></br>
  14079. <em>
  14080. string
  14081. </em>
  14082. </td>
  14083. <td>
  14084. <em>(Optional)</em>
  14085. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  14086. authentication method</p>
  14087. </td>
  14088. </tr>
  14089. <tr>
  14090. <td>
  14091. <code>secretRef</code></br>
  14092. <em>
  14093. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14094. External Secrets meta/v1.SecretKeySelector
  14095. </a>
  14096. </em>
  14097. </td>
  14098. <td>
  14099. <em>(Optional)</em>
  14100. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  14101. authenticate with Vault using the JWT/OIDC authentication method.</p>
  14102. </td>
  14103. </tr>
  14104. <tr>
  14105. <td>
  14106. <code>kubernetesServiceAccountToken</code></br>
  14107. <em>
  14108. <a href="#external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">
  14109. VaultKubernetesServiceAccountTokenAuth
  14110. </a>
  14111. </em>
  14112. </td>
  14113. <td>
  14114. <em>(Optional)</em>
  14115. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  14116. a token for with the <code>TokenRequest</code> API.</p>
  14117. </td>
  14118. </tr>
  14119. </tbody>
  14120. </table>
  14121. <h3 id="external-secrets.io/v1.VaultKVStoreVersion">VaultKVStoreVersion
  14122. (<code>string</code> alias)</p></h3>
  14123. <p>
  14124. (<em>Appears on:</em>
  14125. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  14126. </p>
  14127. <p>
  14128. <p>VaultKVStoreVersion represents the version of the Vault KV secret engine.</p>
  14129. </p>
  14130. <table>
  14131. <thead>
  14132. <tr>
  14133. <th>Value</th>
  14134. <th>Description</th>
  14135. </tr>
  14136. </thead>
  14137. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  14138. <td></td>
  14139. </tr><tr><td><p>&#34;v2&#34;</p></td>
  14140. <td></td>
  14141. </tr></tbody>
  14142. </table>
  14143. <h3 id="external-secrets.io/v1.VaultKubernetesAuth">VaultKubernetesAuth
  14144. </h3>
  14145. <p>
  14146. (<em>Appears on:</em>
  14147. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14148. </p>
  14149. <p>
  14150. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in
  14151. a Secret.</p>
  14152. </p>
  14153. <table>
  14154. <thead>
  14155. <tr>
  14156. <th>Field</th>
  14157. <th>Description</th>
  14158. </tr>
  14159. </thead>
  14160. <tbody>
  14161. <tr>
  14162. <td>
  14163. <code>mountPath</code></br>
  14164. <em>
  14165. string
  14166. </em>
  14167. </td>
  14168. <td>
  14169. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  14170. &ldquo;kubernetes&rdquo;</p>
  14171. </td>
  14172. </tr>
  14173. <tr>
  14174. <td>
  14175. <code>serviceAccountRef</code></br>
  14176. <em>
  14177. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14178. External Secrets meta/v1.ServiceAccountSelector
  14179. </a>
  14180. </em>
  14181. </td>
  14182. <td>
  14183. <em>(Optional)</em>
  14184. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  14185. If the service account is specified, the service account secret token JWT will be used
  14186. for authenticating with Vault. If the service account selector is not supplied,
  14187. the secretRef will be used instead.</p>
  14188. </td>
  14189. </tr>
  14190. <tr>
  14191. <td>
  14192. <code>secretRef</code></br>
  14193. <em>
  14194. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14195. External Secrets meta/v1.SecretKeySelector
  14196. </a>
  14197. </em>
  14198. </td>
  14199. <td>
  14200. <em>(Optional)</em>
  14201. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  14202. for authenticating with Vault. If a name is specified without a key,
  14203. <code>token</code> is the default. If one is not specified, the one bound to
  14204. the controller will be used.</p>
  14205. </td>
  14206. </tr>
  14207. <tr>
  14208. <td>
  14209. <code>role</code></br>
  14210. <em>
  14211. string
  14212. </em>
  14213. </td>
  14214. <td>
  14215. <p>A required field containing the Vault Role to assume. A Role binds a
  14216. Kubernetes ServiceAccount with a set of Vault policies.</p>
  14217. </td>
  14218. </tr>
  14219. </tbody>
  14220. </table>
  14221. <h3 id="external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  14222. </h3>
  14223. <p>
  14224. (<em>Appears on:</em>
  14225. <a href="#external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth</a>)
  14226. </p>
  14227. <p>
  14228. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  14229. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  14230. </p>
  14231. <table>
  14232. <thead>
  14233. <tr>
  14234. <th>Field</th>
  14235. <th>Description</th>
  14236. </tr>
  14237. </thead>
  14238. <tbody>
  14239. <tr>
  14240. <td>
  14241. <code>serviceAccountRef</code></br>
  14242. <em>
  14243. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14244. External Secrets meta/v1.ServiceAccountSelector
  14245. </a>
  14246. </em>
  14247. </td>
  14248. <td>
  14249. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  14250. </td>
  14251. </tr>
  14252. <tr>
  14253. <td>
  14254. <code>audiences</code></br>
  14255. <em>
  14256. []string
  14257. </em>
  14258. </td>
  14259. <td>
  14260. <em>(Optional)</em>
  14261. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  14262. account token for the service account referenced by <code>serviceAccountRef</code>.
  14263. Defaults to a single audience <code>vault</code> it not specified.</p>
  14264. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  14265. </td>
  14266. </tr>
  14267. <tr>
  14268. <td>
  14269. <code>expirationSeconds</code></br>
  14270. <em>
  14271. int64
  14272. </em>
  14273. </td>
  14274. <td>
  14275. <em>(Optional)</em>
  14276. <p>Optional expiration time in seconds that will be used to request a temporary
  14277. Kubernetes service account token for the service account referenced by
  14278. <code>serviceAccountRef</code>.</p>
  14279. <p>Deprecated: this will be removed in the future.
  14280. Defaults to 10 minutes.</p>
  14281. </td>
  14282. </tr>
  14283. </tbody>
  14284. </table>
  14285. <h3 id="external-secrets.io/v1.VaultLdapAuth">VaultLdapAuth
  14286. </h3>
  14287. <p>
  14288. (<em>Appears on:</em>
  14289. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14290. </p>
  14291. <p>
  14292. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  14293. with the username and password stored in a Kubernetes Secret resource.</p>
  14294. </p>
  14295. <table>
  14296. <thead>
  14297. <tr>
  14298. <th>Field</th>
  14299. <th>Description</th>
  14300. </tr>
  14301. </thead>
  14302. <tbody>
  14303. <tr>
  14304. <td>
  14305. <code>path</code></br>
  14306. <em>
  14307. string
  14308. </em>
  14309. </td>
  14310. <td>
  14311. <p>Path where the LDAP authentication backend is mounted
  14312. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  14313. </td>
  14314. </tr>
  14315. <tr>
  14316. <td>
  14317. <code>username</code></br>
  14318. <em>
  14319. string
  14320. </em>
  14321. </td>
  14322. <td>
  14323. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  14324. authentication method</p>
  14325. </td>
  14326. </tr>
  14327. <tr>
  14328. <td>
  14329. <code>secretRef</code></br>
  14330. <em>
  14331. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14332. External Secrets meta/v1.SecretKeySelector
  14333. </a>
  14334. </em>
  14335. </td>
  14336. <td>
  14337. <em>(Optional)</em>
  14338. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  14339. user used to authenticate with Vault using the LDAP authentication
  14340. method</p>
  14341. </td>
  14342. </tr>
  14343. </tbody>
  14344. </table>
  14345. <h3 id="external-secrets.io/v1.VaultProvider">VaultProvider
  14346. </h3>
  14347. <p>
  14348. (<em>Appears on:</em>
  14349. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  14350. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  14351. </p>
  14352. <p>
  14353. <p>VaultProvider configures a store to sync secrets using a Hashicorp Vault KV backend.</p>
  14354. </p>
  14355. <table>
  14356. <thead>
  14357. <tr>
  14358. <th>Field</th>
  14359. <th>Description</th>
  14360. </tr>
  14361. </thead>
  14362. <tbody>
  14363. <tr>
  14364. <td>
  14365. <code>auth</code></br>
  14366. <em>
  14367. <a href="#external-secrets.io/v1.VaultAuth">
  14368. VaultAuth
  14369. </a>
  14370. </em>
  14371. </td>
  14372. <td>
  14373. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  14374. </td>
  14375. </tr>
  14376. <tr>
  14377. <td>
  14378. <code>server</code></br>
  14379. <em>
  14380. string
  14381. </em>
  14382. </td>
  14383. <td>
  14384. <p>Server is the connection address for the Vault server, e.g: &ldquo;<a href="https://vault.example.com:8200&quot;">https://vault.example.com:8200&rdquo;</a>.</p>
  14385. </td>
  14386. </tr>
  14387. <tr>
  14388. <td>
  14389. <code>path</code></br>
  14390. <em>
  14391. string
  14392. </em>
  14393. </td>
  14394. <td>
  14395. <em>(Optional)</em>
  14396. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  14397. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  14398. for fetching secrets from Vault is optional and will be appended
  14399. if not present in specified path.</p>
  14400. </td>
  14401. </tr>
  14402. <tr>
  14403. <td>
  14404. <code>version</code></br>
  14405. <em>
  14406. <a href="#external-secrets.io/v1.VaultKVStoreVersion">
  14407. VaultKVStoreVersion
  14408. </a>
  14409. </em>
  14410. </td>
  14411. <td>
  14412. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  14413. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  14414. </td>
  14415. </tr>
  14416. <tr>
  14417. <td>
  14418. <code>namespace</code></br>
  14419. <em>
  14420. string
  14421. </em>
  14422. </td>
  14423. <td>
  14424. <em>(Optional)</em>
  14425. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  14426. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  14427. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a></p>
  14428. </td>
  14429. </tr>
  14430. <tr>
  14431. <td>
  14432. <code>caBundle</code></br>
  14433. <em>
  14434. []byte
  14435. </em>
  14436. </td>
  14437. <td>
  14438. <em>(Optional)</em>
  14439. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  14440. if the Server URL is using HTTPS protocol. This parameter is ignored for
  14441. plain HTTP protocol connection. If not set the system root certificates
  14442. are used to validate the TLS connection.</p>
  14443. </td>
  14444. </tr>
  14445. <tr>
  14446. <td>
  14447. <code>tls</code></br>
  14448. <em>
  14449. <a href="#external-secrets.io/v1.VaultClientTLS">
  14450. VaultClientTLS
  14451. </a>
  14452. </em>
  14453. </td>
  14454. <td>
  14455. <em>(Optional)</em>
  14456. <p>The configuration used for client side related TLS communication, when the Vault server
  14457. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  14458. This parameter is ignored for plain HTTP protocol connection.
  14459. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  14460. which is available under the <code>auth.cert</code> section.</p>
  14461. </td>
  14462. </tr>
  14463. <tr>
  14464. <td>
  14465. <code>caProvider</code></br>
  14466. <em>
  14467. <a href="#external-secrets.io/v1.CAProvider">
  14468. CAProvider
  14469. </a>
  14470. </em>
  14471. </td>
  14472. <td>
  14473. <em>(Optional)</em>
  14474. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  14475. </td>
  14476. </tr>
  14477. <tr>
  14478. <td>
  14479. <code>readYourWrites</code></br>
  14480. <em>
  14481. bool
  14482. </em>
  14483. </td>
  14484. <td>
  14485. <em>(Optional)</em>
  14486. <p>ReadYourWrites ensures isolated read-after-write semantics by
  14487. providing discovered cluster replication states in each request.
  14488. More information about eventual consistency in Vault can be found here
  14489. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  14490. </td>
  14491. </tr>
  14492. <tr>
  14493. <td>
  14494. <code>forwardInconsistent</code></br>
  14495. <em>
  14496. bool
  14497. </em>
  14498. </td>
  14499. <td>
  14500. <em>(Optional)</em>
  14501. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  14502. leader instead of simply retrying within a loop. This can increase performance if
  14503. the option is enabled serverside.
  14504. <a href="https://www.vaultproject.io/docs/configuration/replication#allow_forwarding_via_header">https://www.vaultproject.io/docs/configuration/replication#allow_forwarding_via_header</a></p>
  14505. </td>
  14506. </tr>
  14507. <tr>
  14508. <td>
  14509. <code>headers</code></br>
  14510. <em>
  14511. map[string]string
  14512. </em>
  14513. </td>
  14514. <td>
  14515. <em>(Optional)</em>
  14516. <p>Headers to be added in Vault request</p>
  14517. </td>
  14518. </tr>
  14519. <tr>
  14520. <td>
  14521. <code>checkAndSet</code></br>
  14522. <em>
  14523. <a href="#external-secrets.io/v1.VaultCheckAndSet">
  14524. VaultCheckAndSet
  14525. </a>
  14526. </em>
  14527. </td>
  14528. <td>
  14529. <em>(Optional)</em>
  14530. <p>CheckAndSet defines the Check-And-Set (CAS) settings for PushSecret operations.
  14531. Only applies to Vault KV v2 stores. When enabled, write operations must include
  14532. the current version of the secret to prevent unintentional overwrites.</p>
  14533. </td>
  14534. </tr>
  14535. </tbody>
  14536. </table>
  14537. <h3 id="external-secrets.io/v1.VaultUserPassAuth">VaultUserPassAuth
  14538. </h3>
  14539. <p>
  14540. (<em>Appears on:</em>
  14541. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14542. </p>
  14543. <p>
  14544. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  14545. with the username and password stored in a Kubernetes Secret resource.</p>
  14546. </p>
  14547. <table>
  14548. <thead>
  14549. <tr>
  14550. <th>Field</th>
  14551. <th>Description</th>
  14552. </tr>
  14553. </thead>
  14554. <tbody>
  14555. <tr>
  14556. <td>
  14557. <code>path</code></br>
  14558. <em>
  14559. string
  14560. </em>
  14561. </td>
  14562. <td>
  14563. <p>Path where the UserPassword authentication backend is mounted
  14564. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  14565. </td>
  14566. </tr>
  14567. <tr>
  14568. <td>
  14569. <code>username</code></br>
  14570. <em>
  14571. string
  14572. </em>
  14573. </td>
  14574. <td>
  14575. <p>Username is a username used to authenticate using the UserPass Vault
  14576. authentication method</p>
  14577. </td>
  14578. </tr>
  14579. <tr>
  14580. <td>
  14581. <code>secretRef</code></br>
  14582. <em>
  14583. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14584. External Secrets meta/v1.SecretKeySelector
  14585. </a>
  14586. </em>
  14587. </td>
  14588. <td>
  14589. <em>(Optional)</em>
  14590. <p>SecretRef to a key in a Secret resource containing password for the
  14591. user used to authenticate with Vault using the UserPass authentication
  14592. method</p>
  14593. </td>
  14594. </tr>
  14595. </tbody>
  14596. </table>
  14597. <h3 id="external-secrets.io/v1.VolcengineAuth">VolcengineAuth
  14598. </h3>
  14599. <p>
  14600. (<em>Appears on:</em>
  14601. <a href="#external-secrets.io/v1.VolcengineProvider">VolcengineProvider</a>)
  14602. </p>
  14603. <p>
  14604. <p>VolcengineAuth defines the authentication method for the Volcengine provider.
  14605. Only one of the fields should be set.</p>
  14606. </p>
  14607. <table>
  14608. <thead>
  14609. <tr>
  14610. <th>Field</th>
  14611. <th>Description</th>
  14612. </tr>
  14613. </thead>
  14614. <tbody>
  14615. <tr>
  14616. <td>
  14617. <code>secretRef</code></br>
  14618. <em>
  14619. <a href="#external-secrets.io/v1.VolcengineAuthSecretRef">
  14620. VolcengineAuthSecretRef
  14621. </a>
  14622. </em>
  14623. </td>
  14624. <td>
  14625. <em>(Optional)</em>
  14626. <p>SecretRef defines the static credentials to use for authentication.
  14627. If not set, IRSA is used.</p>
  14628. </td>
  14629. </tr>
  14630. </tbody>
  14631. </table>
  14632. <h3 id="external-secrets.io/v1.VolcengineAuthSecretRef">VolcengineAuthSecretRef
  14633. </h3>
  14634. <p>
  14635. (<em>Appears on:</em>
  14636. <a href="#external-secrets.io/v1.VolcengineAuth">VolcengineAuth</a>)
  14637. </p>
  14638. <p>
  14639. <p>VolcengineAuthSecretRef defines the secret reference for static credentials.</p>
  14640. </p>
  14641. <table>
  14642. <thead>
  14643. <tr>
  14644. <th>Field</th>
  14645. <th>Description</th>
  14646. </tr>
  14647. </thead>
  14648. <tbody>
  14649. <tr>
  14650. <td>
  14651. <code>accessKeyID</code></br>
  14652. <em>
  14653. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14654. External Secrets meta/v1.SecretKeySelector
  14655. </a>
  14656. </em>
  14657. </td>
  14658. <td>
  14659. <p>AccessKeyID is the reference to the secret containing the Access Key ID.</p>
  14660. </td>
  14661. </tr>
  14662. <tr>
  14663. <td>
  14664. <code>secretAccessKey</code></br>
  14665. <em>
  14666. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14667. External Secrets meta/v1.SecretKeySelector
  14668. </a>
  14669. </em>
  14670. </td>
  14671. <td>
  14672. <p>SecretAccessKey is the reference to the secret containing the Secret Access Key.</p>
  14673. </td>
  14674. </tr>
  14675. <tr>
  14676. <td>
  14677. <code>token</code></br>
  14678. <em>
  14679. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14680. External Secrets meta/v1.SecretKeySelector
  14681. </a>
  14682. </em>
  14683. </td>
  14684. <td>
  14685. <em>(Optional)</em>
  14686. <p>Token is the reference to the secret containing the STS(Security Token Service) Token.</p>
  14687. </td>
  14688. </tr>
  14689. </tbody>
  14690. </table>
  14691. <h3 id="external-secrets.io/v1.VolcengineProvider">VolcengineProvider
  14692. </h3>
  14693. <p>
  14694. (<em>Appears on:</em>
  14695. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  14696. </p>
  14697. <p>
  14698. <p>VolcengineProvider defines the configuration for the Volcengine provider.</p>
  14699. </p>
  14700. <table>
  14701. <thead>
  14702. <tr>
  14703. <th>Field</th>
  14704. <th>Description</th>
  14705. </tr>
  14706. </thead>
  14707. <tbody>
  14708. <tr>
  14709. <td>
  14710. <code>region</code></br>
  14711. <em>
  14712. string
  14713. </em>
  14714. </td>
  14715. <td>
  14716. <p>Region specifies the Volcengine region to connect to.</p>
  14717. </td>
  14718. </tr>
  14719. <tr>
  14720. <td>
  14721. <code>auth</code></br>
  14722. <em>
  14723. <a href="#external-secrets.io/v1.VolcengineAuth">
  14724. VolcengineAuth
  14725. </a>
  14726. </em>
  14727. </td>
  14728. <td>
  14729. <em>(Optional)</em>
  14730. <p>Auth defines the authentication method to use.
  14731. If not specified, the provider will try to use IRSA (IAM Role for Service Account).</p>
  14732. </td>
  14733. </tr>
  14734. </tbody>
  14735. </table>
  14736. <h3 id="external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider
  14737. </h3>
  14738. <p>
  14739. (<em>Appears on:</em>
  14740. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  14741. </p>
  14742. <p>
  14743. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  14744. </p>
  14745. <table>
  14746. <thead>
  14747. <tr>
  14748. <th>Field</th>
  14749. <th>Description</th>
  14750. </tr>
  14751. </thead>
  14752. <tbody>
  14753. <tr>
  14754. <td>
  14755. <code>type</code></br>
  14756. <em>
  14757. <a href="#external-secrets.io/v1.WebhookCAProviderType">
  14758. WebhookCAProviderType
  14759. </a>
  14760. </em>
  14761. </td>
  14762. <td>
  14763. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  14764. </td>
  14765. </tr>
  14766. <tr>
  14767. <td>
  14768. <code>name</code></br>
  14769. <em>
  14770. string
  14771. </em>
  14772. </td>
  14773. <td>
  14774. <p>The name of the object located at the provider type.</p>
  14775. </td>
  14776. </tr>
  14777. <tr>
  14778. <td>
  14779. <code>key</code></br>
  14780. <em>
  14781. string
  14782. </em>
  14783. </td>
  14784. <td>
  14785. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  14786. </td>
  14787. </tr>
  14788. <tr>
  14789. <td>
  14790. <code>namespace</code></br>
  14791. <em>
  14792. string
  14793. </em>
  14794. </td>
  14795. <td>
  14796. <em>(Optional)</em>
  14797. <p>The namespace the Provider type is in.</p>
  14798. </td>
  14799. </tr>
  14800. </tbody>
  14801. </table>
  14802. <h3 id="external-secrets.io/v1.WebhookCAProviderType">WebhookCAProviderType
  14803. (<code>string</code> alias)</p></h3>
  14804. <p>
  14805. (<em>Appears on:</em>
  14806. <a href="#external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider</a>)
  14807. </p>
  14808. <p>
  14809. <p>WebhookCAProviderType defines the type of provider for certificate authority in webhook connections.</p>
  14810. </p>
  14811. <table>
  14812. <thead>
  14813. <tr>
  14814. <th>Value</th>
  14815. <th>Description</th>
  14816. </tr>
  14817. </thead>
  14818. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  14819. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  14820. </td>
  14821. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  14822. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  14823. </td>
  14824. </tr></tbody>
  14825. </table>
  14826. <h3 id="external-secrets.io/v1.WebhookProvider">WebhookProvider
  14827. </h3>
  14828. <p>
  14829. (<em>Appears on:</em>
  14830. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  14831. </p>
  14832. <p>
  14833. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  14834. </p>
  14835. <table>
  14836. <thead>
  14837. <tr>
  14838. <th>Field</th>
  14839. <th>Description</th>
  14840. </tr>
  14841. </thead>
  14842. <tbody>
  14843. <tr>
  14844. <td>
  14845. <code>method</code></br>
  14846. <em>
  14847. string
  14848. </em>
  14849. </td>
  14850. <td>
  14851. <p>Webhook Method</p>
  14852. </td>
  14853. </tr>
  14854. <tr>
  14855. <td>
  14856. <code>url</code></br>
  14857. <em>
  14858. string
  14859. </em>
  14860. </td>
  14861. <td>
  14862. <p>Webhook url to call</p>
  14863. </td>
  14864. </tr>
  14865. <tr>
  14866. <td>
  14867. <code>headers</code></br>
  14868. <em>
  14869. map[string]string
  14870. </em>
  14871. </td>
  14872. <td>
  14873. <em>(Optional)</em>
  14874. <p>Headers</p>
  14875. </td>
  14876. </tr>
  14877. <tr>
  14878. <td>
  14879. <code>auth</code></br>
  14880. <em>
  14881. <a href="#external-secrets.io/v1.AuthorizationProtocol">
  14882. AuthorizationProtocol
  14883. </a>
  14884. </em>
  14885. </td>
  14886. <td>
  14887. <em>(Optional)</em>
  14888. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  14889. </td>
  14890. </tr>
  14891. <tr>
  14892. <td>
  14893. <code>body</code></br>
  14894. <em>
  14895. string
  14896. </em>
  14897. </td>
  14898. <td>
  14899. <em>(Optional)</em>
  14900. <p>Body</p>
  14901. </td>
  14902. </tr>
  14903. <tr>
  14904. <td>
  14905. <code>timeout</code></br>
  14906. <em>
  14907. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14908. Kubernetes meta/v1.Duration
  14909. </a>
  14910. </em>
  14911. </td>
  14912. <td>
  14913. <em>(Optional)</em>
  14914. <p>Timeout</p>
  14915. </td>
  14916. </tr>
  14917. <tr>
  14918. <td>
  14919. <code>result</code></br>
  14920. <em>
  14921. <a href="#external-secrets.io/v1.WebhookResult">
  14922. WebhookResult
  14923. </a>
  14924. </em>
  14925. </td>
  14926. <td>
  14927. <em>(Optional)</em>
  14928. <p>Result formatting</p>
  14929. </td>
  14930. </tr>
  14931. <tr>
  14932. <td>
  14933. <code>secrets</code></br>
  14934. <em>
  14935. <a href="#external-secrets.io/v1.WebhookSecret">
  14936. []WebhookSecret
  14937. </a>
  14938. </em>
  14939. </td>
  14940. <td>
  14941. <em>(Optional)</em>
  14942. <p>Secrets to fill in templates
  14943. These secrets will be passed to the templating function as key value pairs under the given name</p>
  14944. </td>
  14945. </tr>
  14946. <tr>
  14947. <td>
  14948. <code>caBundle</code></br>
  14949. <em>
  14950. []byte
  14951. </em>
  14952. </td>
  14953. <td>
  14954. <em>(Optional)</em>
  14955. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  14956. if the Server URL is using HTTPS protocol. This parameter is ignored for
  14957. plain HTTP protocol connection. If not set the system root certificates
  14958. are used to validate the TLS connection.</p>
  14959. </td>
  14960. </tr>
  14961. <tr>
  14962. <td>
  14963. <code>caProvider</code></br>
  14964. <em>
  14965. <a href="#external-secrets.io/v1.WebhookCAProvider">
  14966. WebhookCAProvider
  14967. </a>
  14968. </em>
  14969. </td>
  14970. <td>
  14971. <em>(Optional)</em>
  14972. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  14973. </td>
  14974. </tr>
  14975. </tbody>
  14976. </table>
  14977. <h3 id="external-secrets.io/v1.WebhookResult">WebhookResult
  14978. </h3>
  14979. <p>
  14980. (<em>Appears on:</em>
  14981. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  14982. </p>
  14983. <p>
  14984. <p>WebhookResult defines how to process and extract secrets from the webhook response.</p>
  14985. </p>
  14986. <table>
  14987. <thead>
  14988. <tr>
  14989. <th>Field</th>
  14990. <th>Description</th>
  14991. </tr>
  14992. </thead>
  14993. <tbody>
  14994. <tr>
  14995. <td>
  14996. <code>jsonPath</code></br>
  14997. <em>
  14998. string
  14999. </em>
  15000. </td>
  15001. <td>
  15002. <em>(Optional)</em>
  15003. <p>Json path of return value</p>
  15004. </td>
  15005. </tr>
  15006. </tbody>
  15007. </table>
  15008. <h3 id="external-secrets.io/v1.WebhookSecret">WebhookSecret
  15009. </h3>
  15010. <p>
  15011. (<em>Appears on:</em>
  15012. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  15013. </p>
  15014. <p>
  15015. <p>WebhookSecret defines a secret that will be passed to the webhook request.</p>
  15016. </p>
  15017. <table>
  15018. <thead>
  15019. <tr>
  15020. <th>Field</th>
  15021. <th>Description</th>
  15022. </tr>
  15023. </thead>
  15024. <tbody>
  15025. <tr>
  15026. <td>
  15027. <code>name</code></br>
  15028. <em>
  15029. string
  15030. </em>
  15031. </td>
  15032. <td>
  15033. <p>Name of this secret in templates</p>
  15034. </td>
  15035. </tr>
  15036. <tr>
  15037. <td>
  15038. <code>secretRef</code></br>
  15039. <em>
  15040. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15041. External Secrets meta/v1.SecretKeySelector
  15042. </a>
  15043. </em>
  15044. </td>
  15045. <td>
  15046. <p>Secret ref to fill in credentials</p>
  15047. </td>
  15048. </tr>
  15049. </tbody>
  15050. </table>
  15051. <h3 id="external-secrets.io/v1.YandexAuth">YandexAuth
  15052. </h3>
  15053. <p>
  15054. (<em>Appears on:</em>
  15055. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  15056. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  15057. </p>
  15058. <p>
  15059. <p>YandexAuth defines the authentication method for the Yandex provider.</p>
  15060. </p>
  15061. <table>
  15062. <thead>
  15063. <tr>
  15064. <th>Field</th>
  15065. <th>Description</th>
  15066. </tr>
  15067. </thead>
  15068. <tbody>
  15069. <tr>
  15070. <td>
  15071. <code>authorizedKeySecretRef</code></br>
  15072. <em>
  15073. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15074. External Secrets meta/v1.SecretKeySelector
  15075. </a>
  15076. </em>
  15077. </td>
  15078. <td>
  15079. <em>(Optional)</em>
  15080. <p>The authorized key used for authentication</p>
  15081. </td>
  15082. </tr>
  15083. </tbody>
  15084. </table>
  15085. <h3 id="external-secrets.io/v1.YandexCAProvider">YandexCAProvider
  15086. </h3>
  15087. <p>
  15088. (<em>Appears on:</em>
  15089. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  15090. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  15091. </p>
  15092. <p>
  15093. <p>YandexCAProvider defines the configuration for Yandex custom certificate authority.</p>
  15094. </p>
  15095. <table>
  15096. <thead>
  15097. <tr>
  15098. <th>Field</th>
  15099. <th>Description</th>
  15100. </tr>
  15101. </thead>
  15102. <tbody>
  15103. <tr>
  15104. <td>
  15105. <code>certSecretRef</code></br>
  15106. <em>
  15107. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15108. External Secrets meta/v1.SecretKeySelector
  15109. </a>
  15110. </em>
  15111. </td>
  15112. <td>
  15113. </td>
  15114. </tr>
  15115. </tbody>
  15116. </table>
  15117. <h3 id="external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  15118. </h3>
  15119. <p>
  15120. (<em>Appears on:</em>
  15121. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15122. </p>
  15123. <p>
  15124. <p>YandexCertificateManagerProvider Configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  15125. </p>
  15126. <table>
  15127. <thead>
  15128. <tr>
  15129. <th>Field</th>
  15130. <th>Description</th>
  15131. </tr>
  15132. </thead>
  15133. <tbody>
  15134. <tr>
  15135. <td>
  15136. <code>apiEndpoint</code></br>
  15137. <em>
  15138. string
  15139. </em>
  15140. </td>
  15141. <td>
  15142. <em>(Optional)</em>
  15143. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  15144. </td>
  15145. </tr>
  15146. <tr>
  15147. <td>
  15148. <code>auth</code></br>
  15149. <em>
  15150. <a href="#external-secrets.io/v1.YandexAuth">
  15151. YandexAuth
  15152. </a>
  15153. </em>
  15154. </td>
  15155. <td>
  15156. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  15157. </td>
  15158. </tr>
  15159. <tr>
  15160. <td>
  15161. <code>caProvider</code></br>
  15162. <em>
  15163. <a href="#external-secrets.io/v1.YandexCAProvider">
  15164. YandexCAProvider
  15165. </a>
  15166. </em>
  15167. </td>
  15168. <td>
  15169. <em>(Optional)</em>
  15170. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  15171. </td>
  15172. </tr>
  15173. <tr>
  15174. <td>
  15175. <code>fetching</code></br>
  15176. <em>
  15177. <a href="#external-secrets.io/v1.FetchingPolicy">
  15178. FetchingPolicy
  15179. </a>
  15180. </em>
  15181. </td>
  15182. <td>
  15183. <em>(Optional)</em>
  15184. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as certificate ID or certificate name</p>
  15185. </td>
  15186. </tr>
  15187. </tbody>
  15188. </table>
  15189. <h3 id="external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider
  15190. </h3>
  15191. <p>
  15192. (<em>Appears on:</em>
  15193. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15194. </p>
  15195. <p>
  15196. <p>YandexLockboxProvider Configures a store to sync secrets using the Yandex Lockbox provider.</p>
  15197. </p>
  15198. <table>
  15199. <thead>
  15200. <tr>
  15201. <th>Field</th>
  15202. <th>Description</th>
  15203. </tr>
  15204. </thead>
  15205. <tbody>
  15206. <tr>
  15207. <td>
  15208. <code>apiEndpoint</code></br>
  15209. <em>
  15210. string
  15211. </em>
  15212. </td>
  15213. <td>
  15214. <em>(Optional)</em>
  15215. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  15216. </td>
  15217. </tr>
  15218. <tr>
  15219. <td>
  15220. <code>auth</code></br>
  15221. <em>
  15222. <a href="#external-secrets.io/v1.YandexAuth">
  15223. YandexAuth
  15224. </a>
  15225. </em>
  15226. </td>
  15227. <td>
  15228. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  15229. </td>
  15230. </tr>
  15231. <tr>
  15232. <td>
  15233. <code>caProvider</code></br>
  15234. <em>
  15235. <a href="#external-secrets.io/v1.YandexCAProvider">
  15236. YandexCAProvider
  15237. </a>
  15238. </em>
  15239. </td>
  15240. <td>
  15241. <em>(Optional)</em>
  15242. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  15243. </td>
  15244. </tr>
  15245. <tr>
  15246. <td>
  15247. <code>fetching</code></br>
  15248. <em>
  15249. <a href="#external-secrets.io/v1.FetchingPolicy">
  15250. FetchingPolicy
  15251. </a>
  15252. </em>
  15253. </td>
  15254. <td>
  15255. <em>(Optional)</em>
  15256. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID or secret name</p>
  15257. </td>
  15258. </tr>
  15259. </tbody>
  15260. </table>
  15261. <hr/>
  15262. <h2 id="external-secrets.io/v1alpha1">external-secrets.io/v1alpha1</h2>
  15263. <p>
  15264. <p>Package v1alpha1 contains resources for external-secrets</p>
  15265. </p>
  15266. <p>Resource Types:</p>
  15267. <ul></ul>
  15268. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret
  15269. </h3>
  15270. <p>
  15271. <p>ClusterPushSecret is the Schema for the ClusterPushSecrets API that enables cluster-wide management of pushing Kubernetes secrets to external providers.</p>
  15272. </p>
  15273. <table>
  15274. <thead>
  15275. <tr>
  15276. <th>Field</th>
  15277. <th>Description</th>
  15278. </tr>
  15279. </thead>
  15280. <tbody>
  15281. <tr>
  15282. <td>
  15283. <code>metadata</code></br>
  15284. <em>
  15285. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  15286. Kubernetes meta/v1.ObjectMeta
  15287. </a>
  15288. </em>
  15289. </td>
  15290. <td>
  15291. Refer to the Kubernetes API documentation for the fields of the
  15292. <code>metadata</code> field.
  15293. </td>
  15294. </tr>
  15295. <tr>
  15296. <td>
  15297. <code>spec</code></br>
  15298. <em>
  15299. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">
  15300. ClusterPushSecretSpec
  15301. </a>
  15302. </em>
  15303. </td>
  15304. <td>
  15305. <br/>
  15306. <br/>
  15307. <table>
  15308. <tr>
  15309. <td>
  15310. <code>pushSecretSpec</code></br>
  15311. <em>
  15312. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15313. PushSecretSpec
  15314. </a>
  15315. </em>
  15316. </td>
  15317. <td>
  15318. <p>PushSecretSpec defines what to do with the secrets.</p>
  15319. </td>
  15320. </tr>
  15321. <tr>
  15322. <td>
  15323. <code>refreshTime</code></br>
  15324. <em>
  15325. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15326. Kubernetes meta/v1.Duration
  15327. </a>
  15328. </em>
  15329. </td>
  15330. <td>
  15331. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  15332. </td>
  15333. </tr>
  15334. <tr>
  15335. <td>
  15336. <code>pushSecretName</code></br>
  15337. <em>
  15338. string
  15339. </em>
  15340. </td>
  15341. <td>
  15342. <em>(Optional)</em>
  15343. <p>The name of the push secrets to be created.
  15344. Defaults to the name of the ClusterPushSecret</p>
  15345. </td>
  15346. </tr>
  15347. <tr>
  15348. <td>
  15349. <code>pushSecretMetadata</code></br>
  15350. <em>
  15351. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  15352. PushSecretMetadata
  15353. </a>
  15354. </em>
  15355. </td>
  15356. <td>
  15357. <em>(Optional)</em>
  15358. <p>The metadata of the external secrets to be created</p>
  15359. </td>
  15360. </tr>
  15361. <tr>
  15362. <td>
  15363. <code>namespaceSelectors</code></br>
  15364. <em>
  15365. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  15366. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  15367. </a>
  15368. </em>
  15369. </td>
  15370. <td>
  15371. <em>(Optional)</em>
  15372. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  15373. </td>
  15374. </tr>
  15375. </table>
  15376. </td>
  15377. </tr>
  15378. <tr>
  15379. <td>
  15380. <code>status</code></br>
  15381. <em>
  15382. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">
  15383. ClusterPushSecretStatus
  15384. </a>
  15385. </em>
  15386. </td>
  15387. <td>
  15388. </td>
  15389. </tr>
  15390. </tbody>
  15391. </table>
  15392. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretCondition">ClusterPushSecretCondition
  15393. </h3>
  15394. <p>
  15395. <p>ClusterPushSecretCondition used to refine PushSecrets to specific namespaces and names.</p>
  15396. </p>
  15397. <table>
  15398. <thead>
  15399. <tr>
  15400. <th>Field</th>
  15401. <th>Description</th>
  15402. </tr>
  15403. </thead>
  15404. <tbody>
  15405. <tr>
  15406. <td>
  15407. <code>namespaceSelector</code></br>
  15408. <em>
  15409. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  15410. Kubernetes meta/v1.LabelSelector
  15411. </a>
  15412. </em>
  15413. </td>
  15414. <td>
  15415. <em>(Optional)</em>
  15416. <p>Choose namespace using a labelSelector</p>
  15417. </td>
  15418. </tr>
  15419. <tr>
  15420. <td>
  15421. <code>namespaces</code></br>
  15422. <em>
  15423. []string
  15424. </em>
  15425. </td>
  15426. <td>
  15427. <em>(Optional)</em>
  15428. <p>Choose namespaces by name</p>
  15429. </td>
  15430. </tr>
  15431. </tbody>
  15432. </table>
  15433. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">ClusterPushSecretNamespaceFailure
  15434. </h3>
  15435. <p>
  15436. (<em>Appears on:</em>
  15437. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>)
  15438. </p>
  15439. <p>
  15440. <p>ClusterPushSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  15441. </p>
  15442. <table>
  15443. <thead>
  15444. <tr>
  15445. <th>Field</th>
  15446. <th>Description</th>
  15447. </tr>
  15448. </thead>
  15449. <tbody>
  15450. <tr>
  15451. <td>
  15452. <code>namespace</code></br>
  15453. <em>
  15454. string
  15455. </em>
  15456. </td>
  15457. <td>
  15458. <p>Namespace is the namespace that failed when trying to apply an PushSecret</p>
  15459. </td>
  15460. </tr>
  15461. <tr>
  15462. <td>
  15463. <code>reason</code></br>
  15464. <em>
  15465. string
  15466. </em>
  15467. </td>
  15468. <td>
  15469. <em>(Optional)</em>
  15470. <p>Reason is why the PushSecret failed to apply to the namespace</p>
  15471. </td>
  15472. </tr>
  15473. </tbody>
  15474. </table>
  15475. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec
  15476. </h3>
  15477. <p>
  15478. (<em>Appears on:</em>
  15479. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  15480. </p>
  15481. <p>
  15482. <p>ClusterPushSecretSpec defines the configuration for a ClusterPushSecret resource.</p>
  15483. </p>
  15484. <table>
  15485. <thead>
  15486. <tr>
  15487. <th>Field</th>
  15488. <th>Description</th>
  15489. </tr>
  15490. </thead>
  15491. <tbody>
  15492. <tr>
  15493. <td>
  15494. <code>pushSecretSpec</code></br>
  15495. <em>
  15496. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15497. PushSecretSpec
  15498. </a>
  15499. </em>
  15500. </td>
  15501. <td>
  15502. <p>PushSecretSpec defines what to do with the secrets.</p>
  15503. </td>
  15504. </tr>
  15505. <tr>
  15506. <td>
  15507. <code>refreshTime</code></br>
  15508. <em>
  15509. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15510. Kubernetes meta/v1.Duration
  15511. </a>
  15512. </em>
  15513. </td>
  15514. <td>
  15515. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  15516. </td>
  15517. </tr>
  15518. <tr>
  15519. <td>
  15520. <code>pushSecretName</code></br>
  15521. <em>
  15522. string
  15523. </em>
  15524. </td>
  15525. <td>
  15526. <em>(Optional)</em>
  15527. <p>The name of the push secrets to be created.
  15528. Defaults to the name of the ClusterPushSecret</p>
  15529. </td>
  15530. </tr>
  15531. <tr>
  15532. <td>
  15533. <code>pushSecretMetadata</code></br>
  15534. <em>
  15535. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  15536. PushSecretMetadata
  15537. </a>
  15538. </em>
  15539. </td>
  15540. <td>
  15541. <em>(Optional)</em>
  15542. <p>The metadata of the external secrets to be created</p>
  15543. </td>
  15544. </tr>
  15545. <tr>
  15546. <td>
  15547. <code>namespaceSelectors</code></br>
  15548. <em>
  15549. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  15550. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  15551. </a>
  15552. </em>
  15553. </td>
  15554. <td>
  15555. <em>(Optional)</em>
  15556. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  15557. </td>
  15558. </tr>
  15559. </tbody>
  15560. </table>
  15561. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus
  15562. </h3>
  15563. <p>
  15564. (<em>Appears on:</em>
  15565. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  15566. </p>
  15567. <p>
  15568. <p>ClusterPushSecretStatus contains the status information for the ClusterPushSecret resource.</p>
  15569. </p>
  15570. <table>
  15571. <thead>
  15572. <tr>
  15573. <th>Field</th>
  15574. <th>Description</th>
  15575. </tr>
  15576. </thead>
  15577. <tbody>
  15578. <tr>
  15579. <td>
  15580. <code>failedNamespaces</code></br>
  15581. <em>
  15582. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">
  15583. []ClusterPushSecretNamespaceFailure
  15584. </a>
  15585. </em>
  15586. </td>
  15587. <td>
  15588. <em>(Optional)</em>
  15589. <p>Failed namespaces are the namespaces that failed to apply an PushSecret</p>
  15590. </td>
  15591. </tr>
  15592. <tr>
  15593. <td>
  15594. <code>provisionedNamespaces</code></br>
  15595. <em>
  15596. []string
  15597. </em>
  15598. </td>
  15599. <td>
  15600. <em>(Optional)</em>
  15601. <p>ProvisionedNamespaces are the namespaces where the ClusterPushSecret has secrets</p>
  15602. </td>
  15603. </tr>
  15604. <tr>
  15605. <td>
  15606. <code>pushSecretName</code></br>
  15607. <em>
  15608. string
  15609. </em>
  15610. </td>
  15611. <td>
  15612. </td>
  15613. </tr>
  15614. <tr>
  15615. <td>
  15616. <code>conditions</code></br>
  15617. <em>
  15618. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  15619. []PushSecretStatusCondition
  15620. </a>
  15621. </em>
  15622. </td>
  15623. <td>
  15624. <em>(Optional)</em>
  15625. </td>
  15626. </tr>
  15627. </tbody>
  15628. </table>
  15629. <h3 id="external-secrets.io/v1alpha1.PushSecret">PushSecret
  15630. </h3>
  15631. <p>
  15632. <p>PushSecret is the Schema for the PushSecrets API that enables pushing Kubernetes secrets to external secret providers.</p>
  15633. </p>
  15634. <table>
  15635. <thead>
  15636. <tr>
  15637. <th>Field</th>
  15638. <th>Description</th>
  15639. </tr>
  15640. </thead>
  15641. <tbody>
  15642. <tr>
  15643. <td>
  15644. <code>metadata</code></br>
  15645. <em>
  15646. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  15647. Kubernetes meta/v1.ObjectMeta
  15648. </a>
  15649. </em>
  15650. </td>
  15651. <td>
  15652. Refer to the Kubernetes API documentation for the fields of the
  15653. <code>metadata</code> field.
  15654. </td>
  15655. </tr>
  15656. <tr>
  15657. <td>
  15658. <code>spec</code></br>
  15659. <em>
  15660. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15661. PushSecretSpec
  15662. </a>
  15663. </em>
  15664. </td>
  15665. <td>
  15666. <br/>
  15667. <br/>
  15668. <table>
  15669. <tr>
  15670. <td>
  15671. <code>refreshInterval</code></br>
  15672. <em>
  15673. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15674. Kubernetes meta/v1.Duration
  15675. </a>
  15676. </em>
  15677. </td>
  15678. <td>
  15679. <p>The Interval to which External Secrets will try to push a secret definition</p>
  15680. </td>
  15681. </tr>
  15682. <tr>
  15683. <td>
  15684. <code>secretStoreRefs</code></br>
  15685. <em>
  15686. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  15687. []PushSecretStoreRef
  15688. </a>
  15689. </em>
  15690. </td>
  15691. <td>
  15692. </td>
  15693. </tr>
  15694. <tr>
  15695. <td>
  15696. <code>updatePolicy</code></br>
  15697. <em>
  15698. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  15699. PushSecretUpdatePolicy
  15700. </a>
  15701. </em>
  15702. </td>
  15703. <td>
  15704. <em>(Optional)</em>
  15705. <p>UpdatePolicy to handle Secrets in the provider.</p>
  15706. </td>
  15707. </tr>
  15708. <tr>
  15709. <td>
  15710. <code>deletionPolicy</code></br>
  15711. <em>
  15712. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  15713. PushSecretDeletionPolicy
  15714. </a>
  15715. </em>
  15716. </td>
  15717. <td>
  15718. <em>(Optional)</em>
  15719. <p>Deletion Policy to handle Secrets in the provider.</p>
  15720. </td>
  15721. </tr>
  15722. <tr>
  15723. <td>
  15724. <code>selector</code></br>
  15725. <em>
  15726. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  15727. PushSecretSelector
  15728. </a>
  15729. </em>
  15730. </td>
  15731. <td>
  15732. <p>The Secret Selector (k8s source) for the Push Secret</p>
  15733. </td>
  15734. </tr>
  15735. <tr>
  15736. <td>
  15737. <code>data</code></br>
  15738. <em>
  15739. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  15740. []PushSecretData
  15741. </a>
  15742. </em>
  15743. </td>
  15744. <td>
  15745. <em>(Optional)</em>
  15746. <p>Secret Data that should be pushed to providers</p>
  15747. </td>
  15748. </tr>
  15749. <tr>
  15750. <td>
  15751. <code>dataTo</code></br>
  15752. <em>
  15753. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  15754. []PushSecretDataTo
  15755. </a>
  15756. </em>
  15757. </td>
  15758. <td>
  15759. <em>(Optional)</em>
  15760. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  15761. </td>
  15762. </tr>
  15763. <tr>
  15764. <td>
  15765. <code>template</code></br>
  15766. <em>
  15767. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  15768. ExternalSecretTemplate
  15769. </a>
  15770. </em>
  15771. </td>
  15772. <td>
  15773. <em>(Optional)</em>
  15774. <p>Template defines a blueprint for the created Secret resource.</p>
  15775. </td>
  15776. </tr>
  15777. </table>
  15778. </td>
  15779. </tr>
  15780. <tr>
  15781. <td>
  15782. <code>status</code></br>
  15783. <em>
  15784. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">
  15785. PushSecretStatus
  15786. </a>
  15787. </em>
  15788. </td>
  15789. <td>
  15790. </td>
  15791. </tr>
  15792. </tbody>
  15793. </table>
  15794. <h3 id="external-secrets.io/v1alpha1.PushSecretConditionType">PushSecretConditionType
  15795. (<code>string</code> alias)</p></h3>
  15796. <p>
  15797. (<em>Appears on:</em>
  15798. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition</a>)
  15799. </p>
  15800. <p>
  15801. <p>PushSecretConditionType indicates the condition of the PushSecret.</p>
  15802. </p>
  15803. <table>
  15804. <thead>
  15805. <tr>
  15806. <th>Value</th>
  15807. <th>Description</th>
  15808. </tr>
  15809. </thead>
  15810. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  15811. <td><p>PushSecretReady indicates the PushSecret resource is ready.</p>
  15812. </td>
  15813. </tr></tbody>
  15814. </table>
  15815. <h3 id="external-secrets.io/v1alpha1.PushSecretConversionStrategy">PushSecretConversionStrategy
  15816. (<code>string</code> alias)</p></h3>
  15817. <p>
  15818. (<em>Appears on:</em>
  15819. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>,
  15820. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  15821. </p>
  15822. <p>
  15823. <p>PushSecretConversionStrategy defines how secret values are converted when pushed to providers.</p>
  15824. </p>
  15825. <table>
  15826. <thead>
  15827. <tr>
  15828. <th>Value</th>
  15829. <th>Description</th>
  15830. </tr>
  15831. </thead>
  15832. <tbody><tr><td><p>&#34;None&#34;</p></td>
  15833. <td><p>PushSecretConversionNone indicates no conversion will be performed on the secret value.</p>
  15834. </td>
  15835. </tr><tr><td><p>&#34;ReverseUnicode&#34;</p></td>
  15836. <td><p>PushSecretConversionReverseUnicode indicates that unicode escape sequences will be reversed.</p>
  15837. </td>
  15838. </tr></tbody>
  15839. </table>
  15840. <h3 id="external-secrets.io/v1alpha1.PushSecretData">PushSecretData
  15841. </h3>
  15842. <p>
  15843. (<em>Appears on:</em>
  15844. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15845. </p>
  15846. <p>
  15847. <p>PushSecretData defines data to be pushed to the provider and associated metadata.</p>
  15848. </p>
  15849. <table>
  15850. <thead>
  15851. <tr>
  15852. <th>Field</th>
  15853. <th>Description</th>
  15854. </tr>
  15855. </thead>
  15856. <tbody>
  15857. <tr>
  15858. <td>
  15859. <code>match</code></br>
  15860. <em>
  15861. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">
  15862. PushSecretMatch
  15863. </a>
  15864. </em>
  15865. </td>
  15866. <td>
  15867. <p>Match a given Secret Key to be pushed to the provider.</p>
  15868. </td>
  15869. </tr>
  15870. <tr>
  15871. <td>
  15872. <code>metadata</code></br>
  15873. <em>
  15874. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  15875. </em>
  15876. </td>
  15877. <td>
  15878. <em>(Optional)</em>
  15879. <p>Metadata is metadata attached to the secret.
  15880. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  15881. </td>
  15882. </tr>
  15883. <tr>
  15884. <td>
  15885. <code>conversionStrategy</code></br>
  15886. <em>
  15887. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  15888. PushSecretConversionStrategy
  15889. </a>
  15890. </em>
  15891. </td>
  15892. <td>
  15893. <em>(Optional)</em>
  15894. <p>Used to define a conversion Strategy for the secret keys</p>
  15895. </td>
  15896. </tr>
  15897. </tbody>
  15898. </table>
  15899. <h3 id="external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo
  15900. </h3>
  15901. <p>
  15902. (<em>Appears on:</em>
  15903. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15904. </p>
  15905. <p>
  15906. <p>PushSecretDataTo defines how to bulk-push secrets to providers without explicit per-key mappings.</p>
  15907. </p>
  15908. <table>
  15909. <thead>
  15910. <tr>
  15911. <th>Field</th>
  15912. <th>Description</th>
  15913. </tr>
  15914. </thead>
  15915. <tbody>
  15916. <tr>
  15917. <td>
  15918. <code>storeRef</code></br>
  15919. <em>
  15920. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  15921. PushSecretStoreRef
  15922. </a>
  15923. </em>
  15924. </td>
  15925. <td>
  15926. <p>StoreRef specifies which SecretStore to push to. Required.</p>
  15927. </td>
  15928. </tr>
  15929. <tr>
  15930. <td>
  15931. <code>remoteKey</code></br>
  15932. <em>
  15933. string
  15934. </em>
  15935. </td>
  15936. <td>
  15937. <em>(Optional)</em>
  15938. <p>RemoteKey is the name of the single provider secret that will receive ALL
  15939. matched keys bundled as a JSON object (e.g. {&ldquo;DB_HOST&rdquo;:&ldquo;&hellip;&rdquo;,&ldquo;DB_USER&rdquo;:&ldquo;&hellip;&rdquo;}).
  15940. When set, per-key expansion is skipped and a single push is performed.
  15941. The provider&rsquo;s store prefix (if any) is still prepended to this value.
  15942. When not set, each matched key is pushed as its own individual provider secret.</p>
  15943. </td>
  15944. </tr>
  15945. <tr>
  15946. <td>
  15947. <code>match</code></br>
  15948. <em>
  15949. <a href="#external-secrets.io/v1alpha1.PushSecretDataToMatch">
  15950. PushSecretDataToMatch
  15951. </a>
  15952. </em>
  15953. </td>
  15954. <td>
  15955. <em>(Optional)</em>
  15956. <p>Match pattern for selecting keys from the source Secret.
  15957. If not specified, all keys are selected.</p>
  15958. </td>
  15959. </tr>
  15960. <tr>
  15961. <td>
  15962. <code>rewrite</code></br>
  15963. <em>
  15964. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">
  15965. []PushSecretRewrite
  15966. </a>
  15967. </em>
  15968. </td>
  15969. <td>
  15970. <em>(Optional)</em>
  15971. <p>Rewrite operations to transform keys before pushing to the provider.
  15972. Operations are applied sequentially.</p>
  15973. </td>
  15974. </tr>
  15975. <tr>
  15976. <td>
  15977. <code>metadata</code></br>
  15978. <em>
  15979. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  15980. </em>
  15981. </td>
  15982. <td>
  15983. <em>(Optional)</em>
  15984. <p>Metadata is metadata attached to the secret.
  15985. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  15986. </td>
  15987. </tr>
  15988. <tr>
  15989. <td>
  15990. <code>conversionStrategy</code></br>
  15991. <em>
  15992. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  15993. PushSecretConversionStrategy
  15994. </a>
  15995. </em>
  15996. </td>
  15997. <td>
  15998. <em>(Optional)</em>
  15999. <p>Used to define a conversion Strategy for the secret keys</p>
  16000. </td>
  16001. </tr>
  16002. </tbody>
  16003. </table>
  16004. <h3 id="external-secrets.io/v1alpha1.PushSecretDataToMatch">PushSecretDataToMatch
  16005. </h3>
  16006. <p>
  16007. (<em>Appears on:</em>
  16008. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16009. </p>
  16010. <p>
  16011. <p>PushSecretDataToMatch defines pattern matching for key selection.</p>
  16012. </p>
  16013. <table>
  16014. <thead>
  16015. <tr>
  16016. <th>Field</th>
  16017. <th>Description</th>
  16018. </tr>
  16019. </thead>
  16020. <tbody>
  16021. <tr>
  16022. <td>
  16023. <code>regexp</code></br>
  16024. <em>
  16025. string
  16026. </em>
  16027. </td>
  16028. <td>
  16029. <em>(Optional)</em>
  16030. <p>Regexp matches keys by regular expression.
  16031. If not specified, all keys are matched.</p>
  16032. </td>
  16033. </tr>
  16034. </tbody>
  16035. </table>
  16036. <h3 id="external-secrets.io/v1alpha1.PushSecretDeletionPolicy">PushSecretDeletionPolicy
  16037. (<code>string</code> alias)</p></h3>
  16038. <p>
  16039. (<em>Appears on:</em>
  16040. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16041. </p>
  16042. <p>
  16043. <p>PushSecretDeletionPolicy defines how push secrets are deleted in the provider.</p>
  16044. </p>
  16045. <table>
  16046. <thead>
  16047. <tr>
  16048. <th>Value</th>
  16049. <th>Description</th>
  16050. </tr>
  16051. </thead>
  16052. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  16053. <td><p>PushSecretDeletionPolicyDelete deletes secrets from the provider when the PushSecret is deleted.</p>
  16054. </td>
  16055. </tr><tr><td><p>&#34;None&#34;</p></td>
  16056. <td><p>PushSecretDeletionPolicyNone keeps secrets in the provider when the PushSecret is deleted.</p>
  16057. </td>
  16058. </tr></tbody>
  16059. </table>
  16060. <h3 id="external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch
  16061. </h3>
  16062. <p>
  16063. (<em>Appears on:</em>
  16064. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>)
  16065. </p>
  16066. <p>
  16067. <p>PushSecretMatch defines how a source Secret key maps to a destination in the provider.</p>
  16068. </p>
  16069. <table>
  16070. <thead>
  16071. <tr>
  16072. <th>Field</th>
  16073. <th>Description</th>
  16074. </tr>
  16075. </thead>
  16076. <tbody>
  16077. <tr>
  16078. <td>
  16079. <code>secretKey</code></br>
  16080. <em>
  16081. string
  16082. </em>
  16083. </td>
  16084. <td>
  16085. <em>(Optional)</em>
  16086. <p>Secret Key to be pushed</p>
  16087. </td>
  16088. </tr>
  16089. <tr>
  16090. <td>
  16091. <code>remoteRef</code></br>
  16092. <em>
  16093. <a href="#external-secrets.io/v1alpha1.PushSecretRemoteRef">
  16094. PushSecretRemoteRef
  16095. </a>
  16096. </em>
  16097. </td>
  16098. <td>
  16099. <p>Remote Refs to push to providers.</p>
  16100. </td>
  16101. </tr>
  16102. </tbody>
  16103. </table>
  16104. <h3 id="external-secrets.io/v1alpha1.PushSecretMetadata">PushSecretMetadata
  16105. </h3>
  16106. <p>
  16107. (<em>Appears on:</em>
  16108. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>)
  16109. </p>
  16110. <p>
  16111. <p>PushSecretMetadata defines metadata fields for the PushSecret generated by the ClusterPushSecret.</p>
  16112. </p>
  16113. <table>
  16114. <thead>
  16115. <tr>
  16116. <th>Field</th>
  16117. <th>Description</th>
  16118. </tr>
  16119. </thead>
  16120. <tbody>
  16121. <tr>
  16122. <td>
  16123. <code>annotations</code></br>
  16124. <em>
  16125. map[string]string
  16126. </em>
  16127. </td>
  16128. <td>
  16129. <em>(Optional)</em>
  16130. </td>
  16131. </tr>
  16132. <tr>
  16133. <td>
  16134. <code>labels</code></br>
  16135. <em>
  16136. map[string]string
  16137. </em>
  16138. </td>
  16139. <td>
  16140. <em>(Optional)</em>
  16141. </td>
  16142. </tr>
  16143. </tbody>
  16144. </table>
  16145. <h3 id="external-secrets.io/v1alpha1.PushSecretRemoteRef">PushSecretRemoteRef
  16146. </h3>
  16147. <p>
  16148. (<em>Appears on:</em>
  16149. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch</a>)
  16150. </p>
  16151. <p>
  16152. <p>PushSecretRemoteRef defines the location of the secret in the provider.</p>
  16153. </p>
  16154. <table>
  16155. <thead>
  16156. <tr>
  16157. <th>Field</th>
  16158. <th>Description</th>
  16159. </tr>
  16160. </thead>
  16161. <tbody>
  16162. <tr>
  16163. <td>
  16164. <code>remoteKey</code></br>
  16165. <em>
  16166. string
  16167. </em>
  16168. </td>
  16169. <td>
  16170. <p>Name of the resulting provider secret.</p>
  16171. </td>
  16172. </tr>
  16173. <tr>
  16174. <td>
  16175. <code>property</code></br>
  16176. <em>
  16177. string
  16178. </em>
  16179. </td>
  16180. <td>
  16181. <em>(Optional)</em>
  16182. <p>Name of the property in the resulting secret</p>
  16183. </td>
  16184. </tr>
  16185. </tbody>
  16186. </table>
  16187. <h3 id="external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite
  16188. </h3>
  16189. <p>
  16190. (<em>Appears on:</em>
  16191. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16192. </p>
  16193. <p>
  16194. <p>PushSecretRewrite defines how to transform secret keys before pushing.</p>
  16195. </p>
  16196. <table>
  16197. <thead>
  16198. <tr>
  16199. <th>Field</th>
  16200. <th>Description</th>
  16201. </tr>
  16202. </thead>
  16203. <tbody>
  16204. <tr>
  16205. <td>
  16206. <code>regexp</code></br>
  16207. <em>
  16208. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  16209. ExternalSecretRewriteRegexp
  16210. </a>
  16211. </em>
  16212. </td>
  16213. <td>
  16214. <em>(Optional)</em>
  16215. <p>Used to rewrite with regular expressions.</p>
  16216. </td>
  16217. </tr>
  16218. <tr>
  16219. <td>
  16220. <code>transform</code></br>
  16221. <em>
  16222. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  16223. ExternalSecretRewriteTransform
  16224. </a>
  16225. </em>
  16226. </td>
  16227. <td>
  16228. <em>(Optional)</em>
  16229. <p>Used to apply string transformation on the secrets.</p>
  16230. </td>
  16231. </tr>
  16232. </tbody>
  16233. </table>
  16234. <h3 id="external-secrets.io/v1alpha1.PushSecretSecret">PushSecretSecret
  16235. </h3>
  16236. <p>
  16237. (<em>Appears on:</em>
  16238. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  16239. </p>
  16240. <p>
  16241. <p>PushSecretSecret defines a Secret that will be used as a source for pushing to providers.</p>
  16242. </p>
  16243. <table>
  16244. <thead>
  16245. <tr>
  16246. <th>Field</th>
  16247. <th>Description</th>
  16248. </tr>
  16249. </thead>
  16250. <tbody>
  16251. <tr>
  16252. <td>
  16253. <code>name</code></br>
  16254. <em>
  16255. string
  16256. </em>
  16257. </td>
  16258. <td>
  16259. <em>(Optional)</em>
  16260. <p>Name of the Secret.
  16261. The Secret must exist in the same namespace as the PushSecret manifest.</p>
  16262. </td>
  16263. </tr>
  16264. <tr>
  16265. <td>
  16266. <code>selector</code></br>
  16267. <em>
  16268. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  16269. Kubernetes meta/v1.LabelSelector
  16270. </a>
  16271. </em>
  16272. </td>
  16273. <td>
  16274. <em>(Optional)</em>
  16275. <p>Selector chooses secrets using a labelSelector.</p>
  16276. </td>
  16277. </tr>
  16278. </tbody>
  16279. </table>
  16280. <h3 id="external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector
  16281. </h3>
  16282. <p>
  16283. (<em>Appears on:</em>
  16284. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16285. </p>
  16286. <p>
  16287. <p>PushSecretSelector defines criteria for selecting the source Secret for pushing to providers.</p>
  16288. </p>
  16289. <table>
  16290. <thead>
  16291. <tr>
  16292. <th>Field</th>
  16293. <th>Description</th>
  16294. </tr>
  16295. </thead>
  16296. <tbody>
  16297. <tr>
  16298. <td>
  16299. <code>secret</code></br>
  16300. <em>
  16301. <a href="#external-secrets.io/v1alpha1.PushSecretSecret">
  16302. PushSecretSecret
  16303. </a>
  16304. </em>
  16305. </td>
  16306. <td>
  16307. <em>(Optional)</em>
  16308. <p>Select a Secret to Push.</p>
  16309. </td>
  16310. </tr>
  16311. <tr>
  16312. <td>
  16313. <code>generatorRef</code></br>
  16314. <em>
  16315. <a href="#external-secrets.io/v1.GeneratorRef">
  16316. GeneratorRef
  16317. </a>
  16318. </em>
  16319. </td>
  16320. <td>
  16321. <em>(Optional)</em>
  16322. <p>Point to a generator to create a Secret.</p>
  16323. </td>
  16324. </tr>
  16325. </tbody>
  16326. </table>
  16327. <h3 id="external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec
  16328. </h3>
  16329. <p>
  16330. (<em>Appears on:</em>
  16331. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>,
  16332. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  16333. </p>
  16334. <p>
  16335. <p>PushSecretSpec configures the behavior of the PushSecret.</p>
  16336. </p>
  16337. <table>
  16338. <thead>
  16339. <tr>
  16340. <th>Field</th>
  16341. <th>Description</th>
  16342. </tr>
  16343. </thead>
  16344. <tbody>
  16345. <tr>
  16346. <td>
  16347. <code>refreshInterval</code></br>
  16348. <em>
  16349. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  16350. Kubernetes meta/v1.Duration
  16351. </a>
  16352. </em>
  16353. </td>
  16354. <td>
  16355. <p>The Interval to which External Secrets will try to push a secret definition</p>
  16356. </td>
  16357. </tr>
  16358. <tr>
  16359. <td>
  16360. <code>secretStoreRefs</code></br>
  16361. <em>
  16362. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  16363. []PushSecretStoreRef
  16364. </a>
  16365. </em>
  16366. </td>
  16367. <td>
  16368. </td>
  16369. </tr>
  16370. <tr>
  16371. <td>
  16372. <code>updatePolicy</code></br>
  16373. <em>
  16374. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  16375. PushSecretUpdatePolicy
  16376. </a>
  16377. </em>
  16378. </td>
  16379. <td>
  16380. <em>(Optional)</em>
  16381. <p>UpdatePolicy to handle Secrets in the provider.</p>
  16382. </td>
  16383. </tr>
  16384. <tr>
  16385. <td>
  16386. <code>deletionPolicy</code></br>
  16387. <em>
  16388. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  16389. PushSecretDeletionPolicy
  16390. </a>
  16391. </em>
  16392. </td>
  16393. <td>
  16394. <em>(Optional)</em>
  16395. <p>Deletion Policy to handle Secrets in the provider.</p>
  16396. </td>
  16397. </tr>
  16398. <tr>
  16399. <td>
  16400. <code>selector</code></br>
  16401. <em>
  16402. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  16403. PushSecretSelector
  16404. </a>
  16405. </em>
  16406. </td>
  16407. <td>
  16408. <p>The Secret Selector (k8s source) for the Push Secret</p>
  16409. </td>
  16410. </tr>
  16411. <tr>
  16412. <td>
  16413. <code>data</code></br>
  16414. <em>
  16415. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  16416. []PushSecretData
  16417. </a>
  16418. </em>
  16419. </td>
  16420. <td>
  16421. <em>(Optional)</em>
  16422. <p>Secret Data that should be pushed to providers</p>
  16423. </td>
  16424. </tr>
  16425. <tr>
  16426. <td>
  16427. <code>dataTo</code></br>
  16428. <em>
  16429. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  16430. []PushSecretDataTo
  16431. </a>
  16432. </em>
  16433. </td>
  16434. <td>
  16435. <em>(Optional)</em>
  16436. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  16437. </td>
  16438. </tr>
  16439. <tr>
  16440. <td>
  16441. <code>template</code></br>
  16442. <em>
  16443. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  16444. ExternalSecretTemplate
  16445. </a>
  16446. </em>
  16447. </td>
  16448. <td>
  16449. <em>(Optional)</em>
  16450. <p>Template defines a blueprint for the created Secret resource.</p>
  16451. </td>
  16452. </tr>
  16453. </tbody>
  16454. </table>
  16455. <h3 id="external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus
  16456. </h3>
  16457. <p>
  16458. (<em>Appears on:</em>
  16459. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  16460. </p>
  16461. <p>
  16462. <p>PushSecretStatus indicates the history of the status of PushSecret.</p>
  16463. </p>
  16464. <table>
  16465. <thead>
  16466. <tr>
  16467. <th>Field</th>
  16468. <th>Description</th>
  16469. </tr>
  16470. </thead>
  16471. <tbody>
  16472. <tr>
  16473. <td>
  16474. <code>refreshTime</code></br>
  16475. <em>
  16476. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  16477. Kubernetes meta/v1.Time
  16478. </a>
  16479. </em>
  16480. </td>
  16481. <td>
  16482. <p>refreshTime is the time and date the external secret was fetched and
  16483. the target secret updated</p>
  16484. </td>
  16485. </tr>
  16486. <tr>
  16487. <td>
  16488. <code>syncedResourceVersion</code></br>
  16489. <em>
  16490. string
  16491. </em>
  16492. </td>
  16493. <td>
  16494. <p>SyncedResourceVersion keeps track of the last synced version.</p>
  16495. </td>
  16496. </tr>
  16497. <tr>
  16498. <td>
  16499. <code>syncedPushSecrets</code></br>
  16500. <em>
  16501. <a href="#external-secrets.io/v1alpha1.SyncedPushSecretsMap">
  16502. SyncedPushSecretsMap
  16503. </a>
  16504. </em>
  16505. </td>
  16506. <td>
  16507. <em>(Optional)</em>
  16508. <p>Synced PushSecrets, including secrets that already exist in provider.
  16509. Matches secret stores to PushSecretData that was stored to that secret store.</p>
  16510. </td>
  16511. </tr>
  16512. <tr>
  16513. <td>
  16514. <code>conditions</code></br>
  16515. <em>
  16516. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  16517. []PushSecretStatusCondition
  16518. </a>
  16519. </em>
  16520. </td>
  16521. <td>
  16522. <em>(Optional)</em>
  16523. </td>
  16524. </tr>
  16525. </tbody>
  16526. </table>
  16527. <h3 id="external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition
  16528. </h3>
  16529. <p>
  16530. (<em>Appears on:</em>
  16531. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>,
  16532. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  16533. </p>
  16534. <p>
  16535. <p>PushSecretStatusCondition indicates the status of the PushSecret.</p>
  16536. </p>
  16537. <table>
  16538. <thead>
  16539. <tr>
  16540. <th>Field</th>
  16541. <th>Description</th>
  16542. </tr>
  16543. </thead>
  16544. <tbody>
  16545. <tr>
  16546. <td>
  16547. <code>type</code></br>
  16548. <em>
  16549. <a href="#external-secrets.io/v1alpha1.PushSecretConditionType">
  16550. PushSecretConditionType
  16551. </a>
  16552. </em>
  16553. </td>
  16554. <td>
  16555. </td>
  16556. </tr>
  16557. <tr>
  16558. <td>
  16559. <code>status</code></br>
  16560. <em>
  16561. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  16562. Kubernetes core/v1.ConditionStatus
  16563. </a>
  16564. </em>
  16565. </td>
  16566. <td>
  16567. </td>
  16568. </tr>
  16569. <tr>
  16570. <td>
  16571. <code>reason</code></br>
  16572. <em>
  16573. string
  16574. </em>
  16575. </td>
  16576. <td>
  16577. <em>(Optional)</em>
  16578. </td>
  16579. </tr>
  16580. <tr>
  16581. <td>
  16582. <code>message</code></br>
  16583. <em>
  16584. string
  16585. </em>
  16586. </td>
  16587. <td>
  16588. <em>(Optional)</em>
  16589. </td>
  16590. </tr>
  16591. <tr>
  16592. <td>
  16593. <code>lastTransitionTime</code></br>
  16594. <em>
  16595. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  16596. Kubernetes meta/v1.Time
  16597. </a>
  16598. </em>
  16599. </td>
  16600. <td>
  16601. <em>(Optional)</em>
  16602. </td>
  16603. </tr>
  16604. </tbody>
  16605. </table>
  16606. <h3 id="external-secrets.io/v1alpha1.PushSecretStoreRef">PushSecretStoreRef
  16607. </h3>
  16608. <p>
  16609. (<em>Appears on:</em>
  16610. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>,
  16611. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16612. </p>
  16613. <p>
  16614. <p>PushSecretStoreRef contains a reference on how to sync to a SecretStore.</p>
  16615. </p>
  16616. <table>
  16617. <thead>
  16618. <tr>
  16619. <th>Field</th>
  16620. <th>Description</th>
  16621. </tr>
  16622. </thead>
  16623. <tbody>
  16624. <tr>
  16625. <td>
  16626. <code>name</code></br>
  16627. <em>
  16628. string
  16629. </em>
  16630. </td>
  16631. <td>
  16632. <em>(Optional)</em>
  16633. <p>Optionally, sync to the SecretStore of the given name</p>
  16634. </td>
  16635. </tr>
  16636. <tr>
  16637. <td>
  16638. <code>labelSelector</code></br>
  16639. <em>
  16640. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  16641. Kubernetes meta/v1.LabelSelector
  16642. </a>
  16643. </em>
  16644. </td>
  16645. <td>
  16646. <em>(Optional)</em>
  16647. <p>Optionally, sync to secret stores with label selector</p>
  16648. </td>
  16649. </tr>
  16650. <tr>
  16651. <td>
  16652. <code>kind</code></br>
  16653. <em>
  16654. string
  16655. </em>
  16656. </td>
  16657. <td>
  16658. <em>(Optional)</em>
  16659. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)</p>
  16660. </td>
  16661. </tr>
  16662. </tbody>
  16663. </table>
  16664. <h3 id="external-secrets.io/v1alpha1.PushSecretUpdatePolicy">PushSecretUpdatePolicy
  16665. (<code>string</code> alias)</p></h3>
  16666. <p>
  16667. (<em>Appears on:</em>
  16668. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16669. </p>
  16670. <p>
  16671. <p>PushSecretUpdatePolicy defines how push secrets are updated in the provider.</p>
  16672. </p>
  16673. <table>
  16674. <thead>
  16675. <tr>
  16676. <th>Value</th>
  16677. <th>Description</th>
  16678. </tr>
  16679. </thead>
  16680. <tbody><tr><td><p>&#34;IfNotExists&#34;</p></td>
  16681. <td><p>PushSecretUpdatePolicyIfNotExists only creates secrets that don&rsquo;t exist in the provider.</p>
  16682. </td>
  16683. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  16684. <td><p>PushSecretUpdatePolicyReplace replaces existing secrets in the provider.</p>
  16685. </td>
  16686. </tr></tbody>
  16687. </table>
  16688. <h3 id="external-secrets.io/v1alpha1.SyncedPushSecretsMap">SyncedPushSecretsMap
  16689. (<code>map[string]map[string]github.com/external-secrets/external-secrets/apis/externalsecrets/v1alpha1.PushSecretData</code> alias)</p></h3>
  16690. <p>
  16691. (<em>Appears on:</em>
  16692. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  16693. </p>
  16694. <p>
  16695. <p>SyncedPushSecretsMap is a map that tracks which PushSecretData was stored to which secret store.
  16696. The outer map&rsquo;s key is the secret store name, and the inner map&rsquo;s key is the remote key name.</p>
  16697. </p>
  16698. <hr/>
  16699. <h2 id="external-secrets.io/v1beta1">external-secrets.io/v1beta1</h2>
  16700. <p>
  16701. <p>Package v1beta1 contains resources for external-secrets</p>
  16702. </p>
  16703. <p>Resource Types:</p>
  16704. <ul></ul>
  16705. <h3 id="external-secrets.io/v1beta1.AWSAuth">AWSAuth
  16706. </h3>
  16707. <p>
  16708. (<em>Appears on:</em>
  16709. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  16710. </p>
  16711. <p>
  16712. <p>AWSAuth tells the controller how to do authentication with aws.
  16713. Only one of secretRef or jwt can be specified.
  16714. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  16715. </p>
  16716. <table>
  16717. <thead>
  16718. <tr>
  16719. <th>Field</th>
  16720. <th>Description</th>
  16721. </tr>
  16722. </thead>
  16723. <tbody>
  16724. <tr>
  16725. <td>
  16726. <code>secretRef</code></br>
  16727. <em>
  16728. <a href="#external-secrets.io/v1beta1.AWSAuthSecretRef">
  16729. AWSAuthSecretRef
  16730. </a>
  16731. </em>
  16732. </td>
  16733. <td>
  16734. <em>(Optional)</em>
  16735. </td>
  16736. </tr>
  16737. <tr>
  16738. <td>
  16739. <code>jwt</code></br>
  16740. <em>
  16741. <a href="#external-secrets.io/v1beta1.AWSJWTAuth">
  16742. AWSJWTAuth
  16743. </a>
  16744. </em>
  16745. </td>
  16746. <td>
  16747. <em>(Optional)</em>
  16748. </td>
  16749. </tr>
  16750. </tbody>
  16751. </table>
  16752. <h3 id="external-secrets.io/v1beta1.AWSAuthSecretRef">AWSAuthSecretRef
  16753. </h3>
  16754. <p>
  16755. (<em>Appears on:</em>
  16756. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  16757. </p>
  16758. <p>
  16759. <p>AWSAuthSecretRef holds secret references for AWS credentials
  16760. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  16761. </p>
  16762. <table>
  16763. <thead>
  16764. <tr>
  16765. <th>Field</th>
  16766. <th>Description</th>
  16767. </tr>
  16768. </thead>
  16769. <tbody>
  16770. <tr>
  16771. <td>
  16772. <code>accessKeyIDSecretRef</code></br>
  16773. <em>
  16774. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16775. External Secrets meta/v1.SecretKeySelector
  16776. </a>
  16777. </em>
  16778. </td>
  16779. <td>
  16780. <p>The AccessKeyID is used for authentication</p>
  16781. </td>
  16782. </tr>
  16783. <tr>
  16784. <td>
  16785. <code>secretAccessKeySecretRef</code></br>
  16786. <em>
  16787. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16788. External Secrets meta/v1.SecretKeySelector
  16789. </a>
  16790. </em>
  16791. </td>
  16792. <td>
  16793. <p>The SecretAccessKey is used for authentication</p>
  16794. </td>
  16795. </tr>
  16796. <tr>
  16797. <td>
  16798. <code>sessionTokenSecretRef</code></br>
  16799. <em>
  16800. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16801. External Secrets meta/v1.SecretKeySelector
  16802. </a>
  16803. </em>
  16804. </td>
  16805. <td>
  16806. <p>The SessionToken used for authentication
  16807. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  16808. see: <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html">https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html</a></p>
  16809. </td>
  16810. </tr>
  16811. </tbody>
  16812. </table>
  16813. <h3 id="external-secrets.io/v1beta1.AWSJWTAuth">AWSJWTAuth
  16814. </h3>
  16815. <p>
  16816. (<em>Appears on:</em>
  16817. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  16818. </p>
  16819. <p>
  16820. <p>AWSJWTAuth authenticates against AWS using service account tokens from the Kubernetes cluster.</p>
  16821. </p>
  16822. <table>
  16823. <thead>
  16824. <tr>
  16825. <th>Field</th>
  16826. <th>Description</th>
  16827. </tr>
  16828. </thead>
  16829. <tbody>
  16830. <tr>
  16831. <td>
  16832. <code>serviceAccountRef</code></br>
  16833. <em>
  16834. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  16835. External Secrets meta/v1.ServiceAccountSelector
  16836. </a>
  16837. </em>
  16838. </td>
  16839. <td>
  16840. </td>
  16841. </tr>
  16842. </tbody>
  16843. </table>
  16844. <h3 id="external-secrets.io/v1beta1.AWSProvider">AWSProvider
  16845. </h3>
  16846. <p>
  16847. (<em>Appears on:</em>
  16848. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16849. </p>
  16850. <p>
  16851. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  16852. </p>
  16853. <table>
  16854. <thead>
  16855. <tr>
  16856. <th>Field</th>
  16857. <th>Description</th>
  16858. </tr>
  16859. </thead>
  16860. <tbody>
  16861. <tr>
  16862. <td>
  16863. <code>service</code></br>
  16864. <em>
  16865. <a href="#external-secrets.io/v1beta1.AWSServiceType">
  16866. AWSServiceType
  16867. </a>
  16868. </em>
  16869. </td>
  16870. <td>
  16871. <p>Service defines which service should be used to fetch the secrets</p>
  16872. </td>
  16873. </tr>
  16874. <tr>
  16875. <td>
  16876. <code>auth</code></br>
  16877. <em>
  16878. <a href="#external-secrets.io/v1beta1.AWSAuth">
  16879. AWSAuth
  16880. </a>
  16881. </em>
  16882. </td>
  16883. <td>
  16884. <em>(Optional)</em>
  16885. <p>Auth defines the information necessary to authenticate against AWS
  16886. if not set aws sdk will infer credentials from your environment
  16887. see: <a href="https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials">https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials</a></p>
  16888. </td>
  16889. </tr>
  16890. <tr>
  16891. <td>
  16892. <code>role</code></br>
  16893. <em>
  16894. string
  16895. </em>
  16896. </td>
  16897. <td>
  16898. <em>(Optional)</em>
  16899. <p>Role is a Role ARN which the provider will assume</p>
  16900. </td>
  16901. </tr>
  16902. <tr>
  16903. <td>
  16904. <code>region</code></br>
  16905. <em>
  16906. string
  16907. </em>
  16908. </td>
  16909. <td>
  16910. <p>AWS Region to be used for the provider</p>
  16911. </td>
  16912. </tr>
  16913. <tr>
  16914. <td>
  16915. <code>additionalRoles</code></br>
  16916. <em>
  16917. []string
  16918. </em>
  16919. </td>
  16920. <td>
  16921. <em>(Optional)</em>
  16922. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  16923. </td>
  16924. </tr>
  16925. <tr>
  16926. <td>
  16927. <code>externalID</code></br>
  16928. <em>
  16929. string
  16930. </em>
  16931. </td>
  16932. <td>
  16933. <p>AWS External ID set on assumed IAM roles</p>
  16934. </td>
  16935. </tr>
  16936. <tr>
  16937. <td>
  16938. <code>sessionTags</code></br>
  16939. <em>
  16940. <a href="#external-secrets.io/v1beta1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag">
  16941. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag
  16942. </a>
  16943. </em>
  16944. </td>
  16945. <td>
  16946. <em>(Optional)</em>
  16947. <p>AWS STS assume role session tags</p>
  16948. </td>
  16949. </tr>
  16950. <tr>
  16951. <td>
  16952. <code>secretsManager</code></br>
  16953. <em>
  16954. <a href="#external-secrets.io/v1beta1.SecretsManager">
  16955. SecretsManager
  16956. </a>
  16957. </em>
  16958. </td>
  16959. <td>
  16960. <em>(Optional)</em>
  16961. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  16962. </td>
  16963. </tr>
  16964. <tr>
  16965. <td>
  16966. <code>transitiveTagKeys</code></br>
  16967. <em>
  16968. []*string
  16969. </em>
  16970. </td>
  16971. <td>
  16972. <em>(Optional)</em>
  16973. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  16974. </td>
  16975. </tr>
  16976. <tr>
  16977. <td>
  16978. <code>prefix</code></br>
  16979. <em>
  16980. string
  16981. </em>
  16982. </td>
  16983. <td>
  16984. <em>(Optional)</em>
  16985. <p>Prefix adds a prefix to all retrieved values.</p>
  16986. </td>
  16987. </tr>
  16988. </tbody>
  16989. </table>
  16990. <h3 id="external-secrets.io/v1beta1.AWSServiceType">AWSServiceType
  16991. (<code>string</code> alias)</p></h3>
  16992. <p>
  16993. (<em>Appears on:</em>
  16994. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  16995. </p>
  16996. <p>
  16997. <p>AWSServiceType is an enum that defines the service/API that is used to fetch the secrets.</p>
  16998. </p>
  16999. <table>
  17000. <thead>
  17001. <tr>
  17002. <th>Value</th>
  17003. <th>Description</th>
  17004. </tr>
  17005. </thead>
  17006. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  17007. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  17008. see: <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html">https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html</a></p>
  17009. </td>
  17010. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  17011. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  17012. see: <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html</a></p>
  17013. </td>
  17014. </tr></tbody>
  17015. </table>
  17016. <h3 id="external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth
  17017. </h3>
  17018. <p>
  17019. (<em>Appears on:</em>
  17020. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>)
  17021. </p>
  17022. <p>
  17023. <p>AkeylessAuth defines methods of authentication with Akeyless Vault.</p>
  17024. </p>
  17025. <table>
  17026. <thead>
  17027. <tr>
  17028. <th>Field</th>
  17029. <th>Description</th>
  17030. </tr>
  17031. </thead>
  17032. <tbody>
  17033. <tr>
  17034. <td>
  17035. <code>secretRef</code></br>
  17036. <em>
  17037. <a href="#external-secrets.io/v1beta1.AkeylessAuthSecretRef">
  17038. AkeylessAuthSecretRef
  17039. </a>
  17040. </em>
  17041. </td>
  17042. <td>
  17043. <em>(Optional)</em>
  17044. <p>Reference to a Secret that contains the details
  17045. to authenticate with Akeyless.</p>
  17046. </td>
  17047. </tr>
  17048. <tr>
  17049. <td>
  17050. <code>kubernetesAuth</code></br>
  17051. <em>
  17052. <a href="#external-secrets.io/v1beta1.AkeylessKubernetesAuth">
  17053. AkeylessKubernetesAuth
  17054. </a>
  17055. </em>
  17056. </td>
  17057. <td>
  17058. <em>(Optional)</em>
  17059. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  17060. token stored in the named Secret resource.</p>
  17061. </td>
  17062. </tr>
  17063. </tbody>
  17064. </table>
  17065. <h3 id="external-secrets.io/v1beta1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  17066. </h3>
  17067. <p>
  17068. (<em>Appears on:</em>
  17069. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  17070. </p>
  17071. <p>
  17072. <p>AkeylessAuthSecretRef defines how to authenticate using a secret reference.
  17073. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  17074. </p>
  17075. <table>
  17076. <thead>
  17077. <tr>
  17078. <th>Field</th>
  17079. <th>Description</th>
  17080. </tr>
  17081. </thead>
  17082. <tbody>
  17083. <tr>
  17084. <td>
  17085. <code>accessID</code></br>
  17086. <em>
  17087. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17088. External Secrets meta/v1.SecretKeySelector
  17089. </a>
  17090. </em>
  17091. </td>
  17092. <td>
  17093. <p>The SecretAccessID is used for authentication</p>
  17094. </td>
  17095. </tr>
  17096. <tr>
  17097. <td>
  17098. <code>accessType</code></br>
  17099. <em>
  17100. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17101. External Secrets meta/v1.SecretKeySelector
  17102. </a>
  17103. </em>
  17104. </td>
  17105. <td>
  17106. </td>
  17107. </tr>
  17108. <tr>
  17109. <td>
  17110. <code>accessTypeParam</code></br>
  17111. <em>
  17112. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17113. External Secrets meta/v1.SecretKeySelector
  17114. </a>
  17115. </em>
  17116. </td>
  17117. <td>
  17118. </td>
  17119. </tr>
  17120. </tbody>
  17121. </table>
  17122. <h3 id="external-secrets.io/v1beta1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  17123. </h3>
  17124. <p>
  17125. (<em>Appears on:</em>
  17126. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  17127. </p>
  17128. <p>
  17129. <p>AkeylessKubernetesAuth authenticates with Akeyless using a Kubernetes ServiceAccount token.</p>
  17130. </p>
  17131. <table>
  17132. <thead>
  17133. <tr>
  17134. <th>Field</th>
  17135. <th>Description</th>
  17136. </tr>
  17137. </thead>
  17138. <tbody>
  17139. <tr>
  17140. <td>
  17141. <code>accessID</code></br>
  17142. <em>
  17143. string
  17144. </em>
  17145. </td>
  17146. <td>
  17147. <p>the Akeyless Kubernetes auth-method access-id</p>
  17148. </td>
  17149. </tr>
  17150. <tr>
  17151. <td>
  17152. <code>k8sConfName</code></br>
  17153. <em>
  17154. string
  17155. </em>
  17156. </td>
  17157. <td>
  17158. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  17159. </td>
  17160. </tr>
  17161. <tr>
  17162. <td>
  17163. <code>serviceAccountRef</code></br>
  17164. <em>
  17165. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17166. External Secrets meta/v1.ServiceAccountSelector
  17167. </a>
  17168. </em>
  17169. </td>
  17170. <td>
  17171. <em>(Optional)</em>
  17172. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  17173. If the service account is specified, the service account secret token JWT will be used
  17174. for authenticating with Akeyless. If the service account selector is not supplied,
  17175. the secretRef will be used instead.</p>
  17176. </td>
  17177. </tr>
  17178. <tr>
  17179. <td>
  17180. <code>secretRef</code></br>
  17181. <em>
  17182. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17183. External Secrets meta/v1.SecretKeySelector
  17184. </a>
  17185. </em>
  17186. </td>
  17187. <td>
  17188. <em>(Optional)</em>
  17189. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  17190. for authenticating with Akeyless. If a name is specified without a key,
  17191. <code>token</code> is the default. If one is not specified, the one bound to
  17192. the controller will be used.</p>
  17193. </td>
  17194. </tr>
  17195. </tbody>
  17196. </table>
  17197. <h3 id="external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider
  17198. </h3>
  17199. <p>
  17200. (<em>Appears on:</em>
  17201. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17202. </p>
  17203. <p>
  17204. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  17205. </p>
  17206. <table>
  17207. <thead>
  17208. <tr>
  17209. <th>Field</th>
  17210. <th>Description</th>
  17211. </tr>
  17212. </thead>
  17213. <tbody>
  17214. <tr>
  17215. <td>
  17216. <code>akeylessGWApiURL</code></br>
  17217. <em>
  17218. string
  17219. </em>
  17220. </td>
  17221. <td>
  17222. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  17223. </td>
  17224. </tr>
  17225. <tr>
  17226. <td>
  17227. <code>authSecretRef</code></br>
  17228. <em>
  17229. <a href="#external-secrets.io/v1beta1.AkeylessAuth">
  17230. AkeylessAuth
  17231. </a>
  17232. </em>
  17233. </td>
  17234. <td>
  17235. <p>Auth configures how the operator authenticates with Akeyless.</p>
  17236. </td>
  17237. </tr>
  17238. <tr>
  17239. <td>
  17240. <code>caBundle</code></br>
  17241. <em>
  17242. []byte
  17243. </em>
  17244. </td>
  17245. <td>
  17246. <em>(Optional)</em>
  17247. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  17248. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  17249. are used to validate the TLS connection.</p>
  17250. </td>
  17251. </tr>
  17252. <tr>
  17253. <td>
  17254. <code>caProvider</code></br>
  17255. <em>
  17256. <a href="#external-secrets.io/v1beta1.CAProvider">
  17257. CAProvider
  17258. </a>
  17259. </em>
  17260. </td>
  17261. <td>
  17262. <em>(Optional)</em>
  17263. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  17264. </td>
  17265. </tr>
  17266. </tbody>
  17267. </table>
  17268. <h3 id="external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth
  17269. </h3>
  17270. <p>
  17271. (<em>Appears on:</em>
  17272. <a href="#external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider</a>)
  17273. </p>
  17274. <p>
  17275. <p>AlibabaAuth contains a secretRef for credentials.</p>
  17276. </p>
  17277. <table>
  17278. <thead>
  17279. <tr>
  17280. <th>Field</th>
  17281. <th>Description</th>
  17282. </tr>
  17283. </thead>
  17284. <tbody>
  17285. <tr>
  17286. <td>
  17287. <code>secretRef</code></br>
  17288. <em>
  17289. <a href="#external-secrets.io/v1beta1.AlibabaAuthSecretRef">
  17290. AlibabaAuthSecretRef
  17291. </a>
  17292. </em>
  17293. </td>
  17294. <td>
  17295. <em>(Optional)</em>
  17296. </td>
  17297. </tr>
  17298. <tr>
  17299. <td>
  17300. <code>rrsa</code></br>
  17301. <em>
  17302. <a href="#external-secrets.io/v1beta1.AlibabaRRSAAuth">
  17303. AlibabaRRSAAuth
  17304. </a>
  17305. </em>
  17306. </td>
  17307. <td>
  17308. <em>(Optional)</em>
  17309. </td>
  17310. </tr>
  17311. </tbody>
  17312. </table>
  17313. <h3 id="external-secrets.io/v1beta1.AlibabaAuthSecretRef">AlibabaAuthSecretRef
  17314. </h3>
  17315. <p>
  17316. (<em>Appears on:</em>
  17317. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  17318. </p>
  17319. <p>
  17320. <p>AlibabaAuthSecretRef holds secret references for Alibaba credentials.</p>
  17321. </p>
  17322. <table>
  17323. <thead>
  17324. <tr>
  17325. <th>Field</th>
  17326. <th>Description</th>
  17327. </tr>
  17328. </thead>
  17329. <tbody>
  17330. <tr>
  17331. <td>
  17332. <code>accessKeyIDSecretRef</code></br>
  17333. <em>
  17334. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17335. External Secrets meta/v1.SecretKeySelector
  17336. </a>
  17337. </em>
  17338. </td>
  17339. <td>
  17340. <p>The AccessKeyID is used for authentication</p>
  17341. </td>
  17342. </tr>
  17343. <tr>
  17344. <td>
  17345. <code>accessKeySecretSecretRef</code></br>
  17346. <em>
  17347. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17348. External Secrets meta/v1.SecretKeySelector
  17349. </a>
  17350. </em>
  17351. </td>
  17352. <td>
  17353. <p>The AccessKeySecret is used for authentication</p>
  17354. </td>
  17355. </tr>
  17356. </tbody>
  17357. </table>
  17358. <h3 id="external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider
  17359. </h3>
  17360. <p>
  17361. (<em>Appears on:</em>
  17362. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17363. </p>
  17364. <p>
  17365. <p>AlibabaProvider configures a store to sync secrets using the Alibaba Secret Manager provider.</p>
  17366. </p>
  17367. <table>
  17368. <thead>
  17369. <tr>
  17370. <th>Field</th>
  17371. <th>Description</th>
  17372. </tr>
  17373. </thead>
  17374. <tbody>
  17375. <tr>
  17376. <td>
  17377. <code>auth</code></br>
  17378. <em>
  17379. <a href="#external-secrets.io/v1beta1.AlibabaAuth">
  17380. AlibabaAuth
  17381. </a>
  17382. </em>
  17383. </td>
  17384. <td>
  17385. </td>
  17386. </tr>
  17387. <tr>
  17388. <td>
  17389. <code>regionID</code></br>
  17390. <em>
  17391. string
  17392. </em>
  17393. </td>
  17394. <td>
  17395. <p>Alibaba Region to be used for the provider</p>
  17396. </td>
  17397. </tr>
  17398. </tbody>
  17399. </table>
  17400. <h3 id="external-secrets.io/v1beta1.AlibabaRRSAAuth">AlibabaRRSAAuth
  17401. </h3>
  17402. <p>
  17403. (<em>Appears on:</em>
  17404. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  17405. </p>
  17406. <p>
  17407. <p>AlibabaRRSAAuth authenticates against Alibaba using RRSA (Resource-oriented RAM-based Service Authentication).</p>
  17408. </p>
  17409. <table>
  17410. <thead>
  17411. <tr>
  17412. <th>Field</th>
  17413. <th>Description</th>
  17414. </tr>
  17415. </thead>
  17416. <tbody>
  17417. <tr>
  17418. <td>
  17419. <code>oidcProviderArn</code></br>
  17420. <em>
  17421. string
  17422. </em>
  17423. </td>
  17424. <td>
  17425. </td>
  17426. </tr>
  17427. <tr>
  17428. <td>
  17429. <code>oidcTokenFilePath</code></br>
  17430. <em>
  17431. string
  17432. </em>
  17433. </td>
  17434. <td>
  17435. </td>
  17436. </tr>
  17437. <tr>
  17438. <td>
  17439. <code>roleArn</code></br>
  17440. <em>
  17441. string
  17442. </em>
  17443. </td>
  17444. <td>
  17445. </td>
  17446. </tr>
  17447. <tr>
  17448. <td>
  17449. <code>sessionName</code></br>
  17450. <em>
  17451. string
  17452. </em>
  17453. </td>
  17454. <td>
  17455. </td>
  17456. </tr>
  17457. </tbody>
  17458. </table>
  17459. <h3 id="external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol
  17460. </h3>
  17461. <p>
  17462. (<em>Appears on:</em>
  17463. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  17464. </p>
  17465. <p>
  17466. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  17467. </p>
  17468. <table>
  17469. <thead>
  17470. <tr>
  17471. <th>Field</th>
  17472. <th>Description</th>
  17473. </tr>
  17474. </thead>
  17475. <tbody>
  17476. <tr>
  17477. <td>
  17478. <code>ntlm</code></br>
  17479. <em>
  17480. <a href="#external-secrets.io/v1beta1.NTLMProtocol">
  17481. NTLMProtocol
  17482. </a>
  17483. </em>
  17484. </td>
  17485. <td>
  17486. <em>(Optional)</em>
  17487. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  17488. </td>
  17489. </tr>
  17490. </tbody>
  17491. </table>
  17492. <h3 id="external-secrets.io/v1beta1.AzureAuthType">AzureAuthType
  17493. (<code>string</code> alias)</p></h3>
  17494. <p>
  17495. (<em>Appears on:</em>
  17496. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17497. </p>
  17498. <p>
  17499. <p>AzureAuthType describes how to authenticate to the Azure Keyvault.
  17500. Only one of the following auth types may be specified.
  17501. If none of the following auth type is specified, the default one
  17502. is ServicePrincipal.</p>
  17503. </p>
  17504. <table>
  17505. <thead>
  17506. <tr>
  17507. <th>Value</th>
  17508. <th>Description</th>
  17509. </tr>
  17510. </thead>
  17511. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  17512. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  17513. </td>
  17514. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  17515. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  17516. </td>
  17517. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  17518. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  17519. </td>
  17520. </tr></tbody>
  17521. </table>
  17522. <h3 id="external-secrets.io/v1beta1.AzureEnvironmentType">AzureEnvironmentType
  17523. (<code>string</code> alias)</p></h3>
  17524. <p>
  17525. (<em>Appears on:</em>
  17526. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17527. </p>
  17528. <p>
  17529. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  17530. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  17531. The following endpoints are available, also see here: <a href="https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152">https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152</a>
  17532. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  17533. </p>
  17534. <table>
  17535. <thead>
  17536. <tr>
  17537. <th>Value</th>
  17538. <th>Description</th>
  17539. </tr>
  17540. </thead>
  17541. <tbody><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  17542. <td><p>AzureEnvironmentChinaCloud represents the Azure China cloud environment.</p>
  17543. </td>
  17544. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  17545. <td><p>AzureEnvironmentGermanCloud represents the Azure German cloud environment.</p>
  17546. </td>
  17547. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  17548. <td><p>AzureEnvironmentPublicCloud represents the Azure public cloud environment.</p>
  17549. </td>
  17550. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  17551. <td><p>AzureEnvironmentUSGovernmentCloud represents the Azure US government cloud environment.</p>
  17552. </td>
  17553. </tr></tbody>
  17554. </table>
  17555. <h3 id="external-secrets.io/v1beta1.AzureKVAuth">AzureKVAuth
  17556. </h3>
  17557. <p>
  17558. (<em>Appears on:</em>
  17559. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17560. </p>
  17561. <p>
  17562. <p>AzureKVAuth defines configuration for authentication with Azure Key Vault.</p>
  17563. </p>
  17564. <table>
  17565. <thead>
  17566. <tr>
  17567. <th>Field</th>
  17568. <th>Description</th>
  17569. </tr>
  17570. </thead>
  17571. <tbody>
  17572. <tr>
  17573. <td>
  17574. <code>clientId</code></br>
  17575. <em>
  17576. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17577. External Secrets meta/v1.SecretKeySelector
  17578. </a>
  17579. </em>
  17580. </td>
  17581. <td>
  17582. <em>(Optional)</em>
  17583. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  17584. </td>
  17585. </tr>
  17586. <tr>
  17587. <td>
  17588. <code>tenantId</code></br>
  17589. <em>
  17590. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17591. External Secrets meta/v1.SecretKeySelector
  17592. </a>
  17593. </em>
  17594. </td>
  17595. <td>
  17596. <em>(Optional)</em>
  17597. <p>The Azure tenantId of the managed identity used for authentication.</p>
  17598. </td>
  17599. </tr>
  17600. <tr>
  17601. <td>
  17602. <code>clientSecret</code></br>
  17603. <em>
  17604. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17605. External Secrets meta/v1.SecretKeySelector
  17606. </a>
  17607. </em>
  17608. </td>
  17609. <td>
  17610. <em>(Optional)</em>
  17611. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  17612. </td>
  17613. </tr>
  17614. <tr>
  17615. <td>
  17616. <code>clientCertificate</code></br>
  17617. <em>
  17618. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17619. External Secrets meta/v1.SecretKeySelector
  17620. </a>
  17621. </em>
  17622. </td>
  17623. <td>
  17624. <em>(Optional)</em>
  17625. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  17626. </td>
  17627. </tr>
  17628. </tbody>
  17629. </table>
  17630. <h3 id="external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider
  17631. </h3>
  17632. <p>
  17633. (<em>Appears on:</em>
  17634. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17635. </p>
  17636. <p>
  17637. <p>AzureKVProvider configures a store to sync secrets using Azure Key Vault.</p>
  17638. </p>
  17639. <table>
  17640. <thead>
  17641. <tr>
  17642. <th>Field</th>
  17643. <th>Description</th>
  17644. </tr>
  17645. </thead>
  17646. <tbody>
  17647. <tr>
  17648. <td>
  17649. <code>authType</code></br>
  17650. <em>
  17651. <a href="#external-secrets.io/v1beta1.AzureAuthType">
  17652. AzureAuthType
  17653. </a>
  17654. </em>
  17655. </td>
  17656. <td>
  17657. <em>(Optional)</em>
  17658. <p>Auth type defines how to authenticate to the keyvault service.
  17659. Valid values are:
  17660. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  17661. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)</p>
  17662. </td>
  17663. </tr>
  17664. <tr>
  17665. <td>
  17666. <code>vaultUrl</code></br>
  17667. <em>
  17668. string
  17669. </em>
  17670. </td>
  17671. <td>
  17672. <p>Vault Url from which the secrets to be fetched from.</p>
  17673. </td>
  17674. </tr>
  17675. <tr>
  17676. <td>
  17677. <code>tenantId</code></br>
  17678. <em>
  17679. string
  17680. </em>
  17681. </td>
  17682. <td>
  17683. <em>(Optional)</em>
  17684. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  17685. </td>
  17686. </tr>
  17687. <tr>
  17688. <td>
  17689. <code>environmentType</code></br>
  17690. <em>
  17691. <a href="#external-secrets.io/v1beta1.AzureEnvironmentType">
  17692. AzureEnvironmentType
  17693. </a>
  17694. </em>
  17695. </td>
  17696. <td>
  17697. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  17698. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  17699. The following endpoints are available, also see here: <a href="https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152">https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152</a>
  17700. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  17701. </td>
  17702. </tr>
  17703. <tr>
  17704. <td>
  17705. <code>authSecretRef</code></br>
  17706. <em>
  17707. <a href="#external-secrets.io/v1beta1.AzureKVAuth">
  17708. AzureKVAuth
  17709. </a>
  17710. </em>
  17711. </td>
  17712. <td>
  17713. <em>(Optional)</em>
  17714. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  17715. </td>
  17716. </tr>
  17717. <tr>
  17718. <td>
  17719. <code>serviceAccountRef</code></br>
  17720. <em>
  17721. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17722. External Secrets meta/v1.ServiceAccountSelector
  17723. </a>
  17724. </em>
  17725. </td>
  17726. <td>
  17727. <em>(Optional)</em>
  17728. <p>ServiceAccountRef specified the service account
  17729. that should be used when authenticating with WorkloadIdentity.</p>
  17730. </td>
  17731. </tr>
  17732. <tr>
  17733. <td>
  17734. <code>identityId</code></br>
  17735. <em>
  17736. string
  17737. </em>
  17738. </td>
  17739. <td>
  17740. <em>(Optional)</em>
  17741. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  17742. </td>
  17743. </tr>
  17744. </tbody>
  17745. </table>
  17746. <h3 id="external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  17747. </h3>
  17748. <p>
  17749. (<em>Appears on:</em>
  17750. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth</a>)
  17751. </p>
  17752. <p>
  17753. <p>BeyondTrustProviderSecretRef defines a reference to a secret containing credentials for the BeyondTrust provider.</p>
  17754. </p>
  17755. <table>
  17756. <thead>
  17757. <tr>
  17758. <th>Field</th>
  17759. <th>Description</th>
  17760. </tr>
  17761. </thead>
  17762. <tbody>
  17763. <tr>
  17764. <td>
  17765. <code>value</code></br>
  17766. <em>
  17767. string
  17768. </em>
  17769. </td>
  17770. <td>
  17771. <em>(Optional)</em>
  17772. <p>Value can be specified directly to set a value without using a secret.</p>
  17773. </td>
  17774. </tr>
  17775. <tr>
  17776. <td>
  17777. <code>secretRef</code></br>
  17778. <em>
  17779. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17780. External Secrets meta/v1.SecretKeySelector
  17781. </a>
  17782. </em>
  17783. </td>
  17784. <td>
  17785. <em>(Optional)</em>
  17786. <p>SecretRef references a key in a secret that will be used as value.</p>
  17787. </td>
  17788. </tr>
  17789. </tbody>
  17790. </table>
  17791. <h3 id="external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth
  17792. </h3>
  17793. <p>
  17794. (<em>Appears on:</em>
  17795. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  17796. </p>
  17797. <p>
  17798. <p>BeyondtrustAuth configures authentication for BeyondTrust Password Safe.</p>
  17799. </p>
  17800. <table>
  17801. <thead>
  17802. <tr>
  17803. <th>Field</th>
  17804. <th>Description</th>
  17805. </tr>
  17806. </thead>
  17807. <tbody>
  17808. <tr>
  17809. <td>
  17810. <code>apiKey</code></br>
  17811. <em>
  17812. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17813. BeyondTrustProviderSecretRef
  17814. </a>
  17815. </em>
  17816. </td>
  17817. <td>
  17818. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  17819. </td>
  17820. </tr>
  17821. <tr>
  17822. <td>
  17823. <code>clientId</code></br>
  17824. <em>
  17825. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17826. BeyondTrustProviderSecretRef
  17827. </a>
  17828. </em>
  17829. </td>
  17830. <td>
  17831. <p>ClientID is the API OAuth Client ID.</p>
  17832. </td>
  17833. </tr>
  17834. <tr>
  17835. <td>
  17836. <code>clientSecret</code></br>
  17837. <em>
  17838. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17839. BeyondTrustProviderSecretRef
  17840. </a>
  17841. </em>
  17842. </td>
  17843. <td>
  17844. <p>ClientSecret is the API OAuth Client Secret.</p>
  17845. </td>
  17846. </tr>
  17847. <tr>
  17848. <td>
  17849. <code>certificate</code></br>
  17850. <em>
  17851. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17852. BeyondTrustProviderSecretRef
  17853. </a>
  17854. </em>
  17855. </td>
  17856. <td>
  17857. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  17858. </td>
  17859. </tr>
  17860. <tr>
  17861. <td>
  17862. <code>certificateKey</code></br>
  17863. <em>
  17864. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17865. BeyondTrustProviderSecretRef
  17866. </a>
  17867. </em>
  17868. </td>
  17869. <td>
  17870. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  17871. </td>
  17872. </tr>
  17873. </tbody>
  17874. </table>
  17875. <h3 id="external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider
  17876. </h3>
  17877. <p>
  17878. (<em>Appears on:</em>
  17879. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17880. </p>
  17881. <p>
  17882. <p>BeyondtrustProvider defines configuration for the BeyondTrust Password Safe provider.</p>
  17883. </p>
  17884. <table>
  17885. <thead>
  17886. <tr>
  17887. <th>Field</th>
  17888. <th>Description</th>
  17889. </tr>
  17890. </thead>
  17891. <tbody>
  17892. <tr>
  17893. <td>
  17894. <code>auth</code></br>
  17895. <em>
  17896. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">
  17897. BeyondtrustAuth
  17898. </a>
  17899. </em>
  17900. </td>
  17901. <td>
  17902. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  17903. </td>
  17904. </tr>
  17905. <tr>
  17906. <td>
  17907. <code>server</code></br>
  17908. <em>
  17909. <a href="#external-secrets.io/v1beta1.BeyondtrustServer">
  17910. BeyondtrustServer
  17911. </a>
  17912. </em>
  17913. </td>
  17914. <td>
  17915. <p>Auth configures how API server works.</p>
  17916. </td>
  17917. </tr>
  17918. </tbody>
  17919. </table>
  17920. <h3 id="external-secrets.io/v1beta1.BeyondtrustServer">BeyondtrustServer
  17921. </h3>
  17922. <p>
  17923. (<em>Appears on:</em>
  17924. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  17925. </p>
  17926. <p>
  17927. <p>BeyondtrustServer defines configuration for connecting to BeyondTrust Password Safe server.</p>
  17928. </p>
  17929. <table>
  17930. <thead>
  17931. <tr>
  17932. <th>Field</th>
  17933. <th>Description</th>
  17934. </tr>
  17935. </thead>
  17936. <tbody>
  17937. <tr>
  17938. <td>
  17939. <code>apiUrl</code></br>
  17940. <em>
  17941. string
  17942. </em>
  17943. </td>
  17944. <td>
  17945. </td>
  17946. </tr>
  17947. <tr>
  17948. <td>
  17949. <code>apiVersion</code></br>
  17950. <em>
  17951. string
  17952. </em>
  17953. </td>
  17954. <td>
  17955. </td>
  17956. </tr>
  17957. <tr>
  17958. <td>
  17959. <code>retrievalType</code></br>
  17960. <em>
  17961. string
  17962. </em>
  17963. </td>
  17964. <td>
  17965. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  17966. </td>
  17967. </tr>
  17968. <tr>
  17969. <td>
  17970. <code>separator</code></br>
  17971. <em>
  17972. string
  17973. </em>
  17974. </td>
  17975. <td>
  17976. <p>A character that separates the folder names.</p>
  17977. </td>
  17978. </tr>
  17979. <tr>
  17980. <td>
  17981. <code>decrypt</code></br>
  17982. <em>
  17983. bool
  17984. </em>
  17985. </td>
  17986. <td>
  17987. <em>(Optional)</em>
  17988. <p>When true, the response includes the decrypted password. When false, the password field is omitted. This option only applies to the SECRET retrieval type. Default: true.</p>
  17989. </td>
  17990. </tr>
  17991. <tr>
  17992. <td>
  17993. <code>verifyCA</code></br>
  17994. <em>
  17995. bool
  17996. </em>
  17997. </td>
  17998. <td>
  17999. </td>
  18000. </tr>
  18001. <tr>
  18002. <td>
  18003. <code>clientTimeOutSeconds</code></br>
  18004. <em>
  18005. int
  18006. </em>
  18007. </td>
  18008. <td>
  18009. <p>Timeout specifies a time limit for requests made by this Client. The timeout includes connection time, any redirects, and reading the response body. Defaults to 45 seconds.</p>
  18010. </td>
  18011. </tr>
  18012. </tbody>
  18013. </table>
  18014. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  18015. </h3>
  18016. <p>
  18017. (<em>Appears on:</em>
  18018. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  18019. </p>
  18020. <p>
  18021. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  18022. </p>
  18023. <table>
  18024. <thead>
  18025. <tr>
  18026. <th>Field</th>
  18027. <th>Description</th>
  18028. </tr>
  18029. </thead>
  18030. <tbody>
  18031. <tr>
  18032. <td>
  18033. <code>secretRef</code></br>
  18034. <em>
  18035. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">
  18036. BitwardenSecretsManagerSecretRef
  18037. </a>
  18038. </em>
  18039. </td>
  18040. <td>
  18041. </td>
  18042. </tr>
  18043. </tbody>
  18044. </table>
  18045. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  18046. </h3>
  18047. <p>
  18048. (<em>Appears on:</em>
  18049. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18050. </p>
  18051. <p>
  18052. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  18053. </p>
  18054. <table>
  18055. <thead>
  18056. <tr>
  18057. <th>Field</th>
  18058. <th>Description</th>
  18059. </tr>
  18060. </thead>
  18061. <tbody>
  18062. <tr>
  18063. <td>
  18064. <code>apiURL</code></br>
  18065. <em>
  18066. string
  18067. </em>
  18068. </td>
  18069. <td>
  18070. </td>
  18071. </tr>
  18072. <tr>
  18073. <td>
  18074. <code>identityURL</code></br>
  18075. <em>
  18076. string
  18077. </em>
  18078. </td>
  18079. <td>
  18080. </td>
  18081. </tr>
  18082. <tr>
  18083. <td>
  18084. <code>bitwardenServerSDKURL</code></br>
  18085. <em>
  18086. string
  18087. </em>
  18088. </td>
  18089. <td>
  18090. </td>
  18091. </tr>
  18092. <tr>
  18093. <td>
  18094. <code>caBundle</code></br>
  18095. <em>
  18096. string
  18097. </em>
  18098. </td>
  18099. <td>
  18100. <em>(Optional)</em>
  18101. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  18102. can be performed.</p>
  18103. </td>
  18104. </tr>
  18105. <tr>
  18106. <td>
  18107. <code>caProvider</code></br>
  18108. <em>
  18109. <a href="#external-secrets.io/v1beta1.CAProvider">
  18110. CAProvider
  18111. </a>
  18112. </em>
  18113. </td>
  18114. <td>
  18115. <em>(Optional)</em>
  18116. <p>see: <a href="https://external-secrets.io/latest/spec/#external-secrets.io/v1alpha1.CAProvider">https://external-secrets.io/latest/spec/#external-secrets.io/v1alpha1.CAProvider</a></p>
  18117. </td>
  18118. </tr>
  18119. <tr>
  18120. <td>
  18121. <code>organizationID</code></br>
  18122. <em>
  18123. string
  18124. </em>
  18125. </td>
  18126. <td>
  18127. <p>OrganizationID determines which organization this secret store manages.</p>
  18128. </td>
  18129. </tr>
  18130. <tr>
  18131. <td>
  18132. <code>projectID</code></br>
  18133. <em>
  18134. string
  18135. </em>
  18136. </td>
  18137. <td>
  18138. <p>ProjectID determines which project this secret store manages.</p>
  18139. </td>
  18140. </tr>
  18141. <tr>
  18142. <td>
  18143. <code>auth</code></br>
  18144. <em>
  18145. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">
  18146. BitwardenSecretsManagerAuth
  18147. </a>
  18148. </em>
  18149. </td>
  18150. <td>
  18151. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  18152. Make sure that the token being used has permissions on the given secret.</p>
  18153. </td>
  18154. </tr>
  18155. </tbody>
  18156. </table>
  18157. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  18158. </h3>
  18159. <p>
  18160. (<em>Appears on:</em>
  18161. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  18162. </p>
  18163. <p>
  18164. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  18165. </p>
  18166. <table>
  18167. <thead>
  18168. <tr>
  18169. <th>Field</th>
  18170. <th>Description</th>
  18171. </tr>
  18172. </thead>
  18173. <tbody>
  18174. <tr>
  18175. <td>
  18176. <code>credentials</code></br>
  18177. <em>
  18178. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18179. External Secrets meta/v1.SecretKeySelector
  18180. </a>
  18181. </em>
  18182. </td>
  18183. <td>
  18184. <p>AccessToken used for the bitwarden instance.</p>
  18185. </td>
  18186. </tr>
  18187. </tbody>
  18188. </table>
  18189. <h3 id="external-secrets.io/v1beta1.CAProvider">CAProvider
  18190. </h3>
  18191. <p>
  18192. (<em>Appears on:</em>
  18193. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>,
  18194. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  18195. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>,
  18196. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>,
  18197. <a href="#external-secrets.io/v1beta1.KubernetesServer">KubernetesServer</a>,
  18198. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  18199. </p>
  18200. <p>
  18201. <p>CAProvider provides custom certificate authority (CA) certificates
  18202. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  18203. that contains a PEM-encoded certificate.</p>
  18204. </p>
  18205. <table>
  18206. <thead>
  18207. <tr>
  18208. <th>Field</th>
  18209. <th>Description</th>
  18210. </tr>
  18211. </thead>
  18212. <tbody>
  18213. <tr>
  18214. <td>
  18215. <code>type</code></br>
  18216. <em>
  18217. <a href="#external-secrets.io/v1beta1.CAProviderType">
  18218. CAProviderType
  18219. </a>
  18220. </em>
  18221. </td>
  18222. <td>
  18223. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  18224. </td>
  18225. </tr>
  18226. <tr>
  18227. <td>
  18228. <code>name</code></br>
  18229. <em>
  18230. string
  18231. </em>
  18232. </td>
  18233. <td>
  18234. <p>The name of the object located at the provider type.</p>
  18235. </td>
  18236. </tr>
  18237. <tr>
  18238. <td>
  18239. <code>key</code></br>
  18240. <em>
  18241. string
  18242. </em>
  18243. </td>
  18244. <td>
  18245. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  18246. </td>
  18247. </tr>
  18248. <tr>
  18249. <td>
  18250. <code>namespace</code></br>
  18251. <em>
  18252. string
  18253. </em>
  18254. </td>
  18255. <td>
  18256. <em>(Optional)</em>
  18257. <p>The namespace the Provider type is in.
  18258. Can only be defined when used in a ClusterSecretStore.</p>
  18259. </td>
  18260. </tr>
  18261. </tbody>
  18262. </table>
  18263. <h3 id="external-secrets.io/v1beta1.CAProviderType">CAProviderType
  18264. (<code>string</code> alias)</p></h3>
  18265. <p>
  18266. (<em>Appears on:</em>
  18267. <a href="#external-secrets.io/v1beta1.CAProvider">CAProvider</a>)
  18268. </p>
  18269. <p>
  18270. <p>CAProviderType defines the type of provider to use for CA certificates.</p>
  18271. </p>
  18272. <table>
  18273. <thead>
  18274. <tr>
  18275. <th>Value</th>
  18276. <th>Description</th>
  18277. </tr>
  18278. </thead>
  18279. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  18280. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  18281. </td>
  18282. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  18283. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  18284. </td>
  18285. </tr></tbody>
  18286. </table>
  18287. <h3 id="external-secrets.io/v1beta1.CSMAuth">CSMAuth
  18288. </h3>
  18289. <p>
  18290. (<em>Appears on:</em>
  18291. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider</a>)
  18292. </p>
  18293. <p>
  18294. <p>CSMAuth contains a secretRef for credentials.</p>
  18295. </p>
  18296. <table>
  18297. <thead>
  18298. <tr>
  18299. <th>Field</th>
  18300. <th>Description</th>
  18301. </tr>
  18302. </thead>
  18303. <tbody>
  18304. <tr>
  18305. <td>
  18306. <code>secretRef</code></br>
  18307. <em>
  18308. <a href="#external-secrets.io/v1beta1.CSMAuthSecretRef">
  18309. CSMAuthSecretRef
  18310. </a>
  18311. </em>
  18312. </td>
  18313. <td>
  18314. <em>(Optional)</em>
  18315. </td>
  18316. </tr>
  18317. </tbody>
  18318. </table>
  18319. <h3 id="external-secrets.io/v1beta1.CSMAuthSecretRef">CSMAuthSecretRef
  18320. </h3>
  18321. <p>
  18322. (<em>Appears on:</em>
  18323. <a href="#external-secrets.io/v1beta1.CSMAuth">CSMAuth</a>)
  18324. </p>
  18325. <p>
  18326. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  18327. </p>
  18328. <table>
  18329. <thead>
  18330. <tr>
  18331. <th>Field</th>
  18332. <th>Description</th>
  18333. </tr>
  18334. </thead>
  18335. <tbody>
  18336. <tr>
  18337. <td>
  18338. <code>accessKeyIDSecretRef</code></br>
  18339. <em>
  18340. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18341. External Secrets meta/v1.SecretKeySelector
  18342. </a>
  18343. </em>
  18344. </td>
  18345. <td>
  18346. <p>The AccessKeyID is used for authentication</p>
  18347. </td>
  18348. </tr>
  18349. <tr>
  18350. <td>
  18351. <code>accessKeySecretSecretRef</code></br>
  18352. <em>
  18353. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18354. External Secrets meta/v1.SecretKeySelector
  18355. </a>
  18356. </em>
  18357. </td>
  18358. <td>
  18359. <p>The AccessKeySecret is used for authentication</p>
  18360. </td>
  18361. </tr>
  18362. </tbody>
  18363. </table>
  18364. <h3 id="external-secrets.io/v1beta1.CertAuth">CertAuth
  18365. </h3>
  18366. <p>
  18367. (<em>Appears on:</em>
  18368. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  18369. </p>
  18370. <p>
  18371. <p>CertAuth defines certificate-based authentication for the Kubernetes provider.</p>
  18372. </p>
  18373. <table>
  18374. <thead>
  18375. <tr>
  18376. <th>Field</th>
  18377. <th>Description</th>
  18378. </tr>
  18379. </thead>
  18380. <tbody>
  18381. <tr>
  18382. <td>
  18383. <code>clientCert</code></br>
  18384. <em>
  18385. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18386. External Secrets meta/v1.SecretKeySelector
  18387. </a>
  18388. </em>
  18389. </td>
  18390. <td>
  18391. </td>
  18392. </tr>
  18393. <tr>
  18394. <td>
  18395. <code>clientKey</code></br>
  18396. <em>
  18397. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18398. External Secrets meta/v1.SecretKeySelector
  18399. </a>
  18400. </em>
  18401. </td>
  18402. <td>
  18403. </td>
  18404. </tr>
  18405. </tbody>
  18406. </table>
  18407. <h3 id="external-secrets.io/v1beta1.ChefAuth">ChefAuth
  18408. </h3>
  18409. <p>
  18410. (<em>Appears on:</em>
  18411. <a href="#external-secrets.io/v1beta1.ChefProvider">ChefProvider</a>)
  18412. </p>
  18413. <p>
  18414. <p>ChefAuth contains a secretRef for credentials.</p>
  18415. </p>
  18416. <table>
  18417. <thead>
  18418. <tr>
  18419. <th>Field</th>
  18420. <th>Description</th>
  18421. </tr>
  18422. </thead>
  18423. <tbody>
  18424. <tr>
  18425. <td>
  18426. <code>secretRef</code></br>
  18427. <em>
  18428. <a href="#external-secrets.io/v1beta1.ChefAuthSecretRef">
  18429. ChefAuthSecretRef
  18430. </a>
  18431. </em>
  18432. </td>
  18433. <td>
  18434. </td>
  18435. </tr>
  18436. </tbody>
  18437. </table>
  18438. <h3 id="external-secrets.io/v1beta1.ChefAuthSecretRef">ChefAuthSecretRef
  18439. </h3>
  18440. <p>
  18441. (<em>Appears on:</em>
  18442. <a href="#external-secrets.io/v1beta1.ChefAuth">ChefAuth</a>)
  18443. </p>
  18444. <p>
  18445. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  18446. </p>
  18447. <table>
  18448. <thead>
  18449. <tr>
  18450. <th>Field</th>
  18451. <th>Description</th>
  18452. </tr>
  18453. </thead>
  18454. <tbody>
  18455. <tr>
  18456. <td>
  18457. <code>privateKeySecretRef</code></br>
  18458. <em>
  18459. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18460. External Secrets meta/v1.SecretKeySelector
  18461. </a>
  18462. </em>
  18463. </td>
  18464. <td>
  18465. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  18466. </td>
  18467. </tr>
  18468. </tbody>
  18469. </table>
  18470. <h3 id="external-secrets.io/v1beta1.ChefProvider">ChefProvider
  18471. </h3>
  18472. <p>
  18473. (<em>Appears on:</em>
  18474. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18475. </p>
  18476. <p>
  18477. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  18478. </p>
  18479. <table>
  18480. <thead>
  18481. <tr>
  18482. <th>Field</th>
  18483. <th>Description</th>
  18484. </tr>
  18485. </thead>
  18486. <tbody>
  18487. <tr>
  18488. <td>
  18489. <code>auth</code></br>
  18490. <em>
  18491. <a href="#external-secrets.io/v1beta1.ChefAuth">
  18492. ChefAuth
  18493. </a>
  18494. </em>
  18495. </td>
  18496. <td>
  18497. <p>Auth defines the information necessary to authenticate against chef Server</p>
  18498. </td>
  18499. </tr>
  18500. <tr>
  18501. <td>
  18502. <code>username</code></br>
  18503. <em>
  18504. string
  18505. </em>
  18506. </td>
  18507. <td>
  18508. <p>UserName should be the user ID on the chef server</p>
  18509. </td>
  18510. </tr>
  18511. <tr>
  18512. <td>
  18513. <code>serverUrl</code></br>
  18514. <em>
  18515. string
  18516. </em>
  18517. </td>
  18518. <td>
  18519. <p>ServerURL is the chef server URL used to connect to. If using orgs you should include your org in the url and terminate the url with a &ldquo;/&rdquo;</p>
  18520. </td>
  18521. </tr>
  18522. </tbody>
  18523. </table>
  18524. <h3 id="external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider
  18525. </h3>
  18526. <p>
  18527. (<em>Appears on:</em>
  18528. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18529. </p>
  18530. <p>
  18531. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  18532. </p>
  18533. <table>
  18534. <thead>
  18535. <tr>
  18536. <th>Field</th>
  18537. <th>Description</th>
  18538. </tr>
  18539. </thead>
  18540. <tbody>
  18541. <tr>
  18542. <td>
  18543. <code>auth</code></br>
  18544. <em>
  18545. <a href="#external-secrets.io/v1beta1.CSMAuth">
  18546. CSMAuth
  18547. </a>
  18548. </em>
  18549. </td>
  18550. <td>
  18551. </td>
  18552. </tr>
  18553. <tr>
  18554. <td>
  18555. <code>projectID</code></br>
  18556. <em>
  18557. string
  18558. </em>
  18559. </td>
  18560. <td>
  18561. <p>ProjectID is the project, which the secrets are stored in.</p>
  18562. </td>
  18563. </tr>
  18564. </tbody>
  18565. </table>
  18566. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret
  18567. </h3>
  18568. <p>
  18569. <p>ClusterExternalSecret is the schema for the clusterexternalsecrets API.</p>
  18570. </p>
  18571. <table>
  18572. <thead>
  18573. <tr>
  18574. <th>Field</th>
  18575. <th>Description</th>
  18576. </tr>
  18577. </thead>
  18578. <tbody>
  18579. <tr>
  18580. <td>
  18581. <code>metadata</code></br>
  18582. <em>
  18583. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  18584. Kubernetes meta/v1.ObjectMeta
  18585. </a>
  18586. </em>
  18587. </td>
  18588. <td>
  18589. Refer to the Kubernetes API documentation for the fields of the
  18590. <code>metadata</code> field.
  18591. </td>
  18592. </tr>
  18593. <tr>
  18594. <td>
  18595. <code>spec</code></br>
  18596. <em>
  18597. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">
  18598. ClusterExternalSecretSpec
  18599. </a>
  18600. </em>
  18601. </td>
  18602. <td>
  18603. <br/>
  18604. <br/>
  18605. <table>
  18606. <tr>
  18607. <td>
  18608. <code>externalSecretSpec</code></br>
  18609. <em>
  18610. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  18611. ExternalSecretSpec
  18612. </a>
  18613. </em>
  18614. </td>
  18615. <td>
  18616. <p>The spec for the ExternalSecrets to be created</p>
  18617. </td>
  18618. </tr>
  18619. <tr>
  18620. <td>
  18621. <code>externalSecretName</code></br>
  18622. <em>
  18623. string
  18624. </em>
  18625. </td>
  18626. <td>
  18627. <em>(Optional)</em>
  18628. <p>The name of the external secrets to be created.
  18629. Defaults to the name of the ClusterExternalSecret</p>
  18630. </td>
  18631. </tr>
  18632. <tr>
  18633. <td>
  18634. <code>externalSecretMetadata</code></br>
  18635. <em>
  18636. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  18637. ExternalSecretMetadata
  18638. </a>
  18639. </em>
  18640. </td>
  18641. <td>
  18642. <em>(Optional)</em>
  18643. <p>The metadata of the external secrets to be created</p>
  18644. </td>
  18645. </tr>
  18646. <tr>
  18647. <td>
  18648. <code>namespaceSelector</code></br>
  18649. <em>
  18650. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  18651. Kubernetes meta/v1.LabelSelector
  18652. </a>
  18653. </em>
  18654. </td>
  18655. <td>
  18656. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  18657. </td>
  18658. </tr>
  18659. <tr>
  18660. <td>
  18661. <code>namespaceSelectors</code></br>
  18662. <em>
  18663. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  18664. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  18665. </a>
  18666. </em>
  18667. </td>
  18668. <td>
  18669. <em>(Optional)</em>
  18670. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  18671. </td>
  18672. </tr>
  18673. <tr>
  18674. <td>
  18675. <code>namespaces</code></br>
  18676. <em>
  18677. []string
  18678. </em>
  18679. </td>
  18680. <td>
  18681. <em>(Optional)</em>
  18682. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  18683. <p>Deprecated: Use NamespaceSelectors instead.</p>
  18684. </td>
  18685. </tr>
  18686. <tr>
  18687. <td>
  18688. <code>refreshTime</code></br>
  18689. <em>
  18690. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  18691. Kubernetes meta/v1.Duration
  18692. </a>
  18693. </em>
  18694. </td>
  18695. <td>
  18696. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  18697. </td>
  18698. </tr>
  18699. </table>
  18700. </td>
  18701. </tr>
  18702. <tr>
  18703. <td>
  18704. <code>status</code></br>
  18705. <em>
  18706. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">
  18707. ClusterExternalSecretStatus
  18708. </a>
  18709. </em>
  18710. </td>
  18711. <td>
  18712. </td>
  18713. </tr>
  18714. </tbody>
  18715. </table>
  18716. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  18717. (<code>string</code> alias)</p></h3>
  18718. <p>
  18719. (<em>Appears on:</em>
  18720. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  18721. </p>
  18722. <p>
  18723. <p>ClusterExternalSecretConditionType indicates the condition of the ClusterExternalSecret.</p>
  18724. </p>
  18725. <table>
  18726. <thead>
  18727. <tr>
  18728. <th>Value</th>
  18729. <th>Description</th>
  18730. </tr>
  18731. </thead>
  18732. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  18733. <td><p>ClusterExternalSecretReady indicates the ClusterExternalSecret resource is ready.</p>
  18734. </td>
  18735. </tr></tbody>
  18736. </table>
  18737. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  18738. </h3>
  18739. <p>
  18740. (<em>Appears on:</em>
  18741. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  18742. </p>
  18743. <p>
  18744. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  18745. </p>
  18746. <table>
  18747. <thead>
  18748. <tr>
  18749. <th>Field</th>
  18750. <th>Description</th>
  18751. </tr>
  18752. </thead>
  18753. <tbody>
  18754. <tr>
  18755. <td>
  18756. <code>namespace</code></br>
  18757. <em>
  18758. string
  18759. </em>
  18760. </td>
  18761. <td>
  18762. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  18763. </td>
  18764. </tr>
  18765. <tr>
  18766. <td>
  18767. <code>reason</code></br>
  18768. <em>
  18769. string
  18770. </em>
  18771. </td>
  18772. <td>
  18773. <em>(Optional)</em>
  18774. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  18775. </td>
  18776. </tr>
  18777. </tbody>
  18778. </table>
  18779. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  18780. </h3>
  18781. <p>
  18782. (<em>Appears on:</em>
  18783. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  18784. </p>
  18785. <p>
  18786. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  18787. </p>
  18788. <table>
  18789. <thead>
  18790. <tr>
  18791. <th>Field</th>
  18792. <th>Description</th>
  18793. </tr>
  18794. </thead>
  18795. <tbody>
  18796. <tr>
  18797. <td>
  18798. <code>externalSecretSpec</code></br>
  18799. <em>
  18800. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  18801. ExternalSecretSpec
  18802. </a>
  18803. </em>
  18804. </td>
  18805. <td>
  18806. <p>The spec for the ExternalSecrets to be created</p>
  18807. </td>
  18808. </tr>
  18809. <tr>
  18810. <td>
  18811. <code>externalSecretName</code></br>
  18812. <em>
  18813. string
  18814. </em>
  18815. </td>
  18816. <td>
  18817. <em>(Optional)</em>
  18818. <p>The name of the external secrets to be created.
  18819. Defaults to the name of the ClusterExternalSecret</p>
  18820. </td>
  18821. </tr>
  18822. <tr>
  18823. <td>
  18824. <code>externalSecretMetadata</code></br>
  18825. <em>
  18826. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  18827. ExternalSecretMetadata
  18828. </a>
  18829. </em>
  18830. </td>
  18831. <td>
  18832. <em>(Optional)</em>
  18833. <p>The metadata of the external secrets to be created</p>
  18834. </td>
  18835. </tr>
  18836. <tr>
  18837. <td>
  18838. <code>namespaceSelector</code></br>
  18839. <em>
  18840. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  18841. Kubernetes meta/v1.LabelSelector
  18842. </a>
  18843. </em>
  18844. </td>
  18845. <td>
  18846. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  18847. </td>
  18848. </tr>
  18849. <tr>
  18850. <td>
  18851. <code>namespaceSelectors</code></br>
  18852. <em>
  18853. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  18854. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  18855. </a>
  18856. </em>
  18857. </td>
  18858. <td>
  18859. <em>(Optional)</em>
  18860. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  18861. </td>
  18862. </tr>
  18863. <tr>
  18864. <td>
  18865. <code>namespaces</code></br>
  18866. <em>
  18867. []string
  18868. </em>
  18869. </td>
  18870. <td>
  18871. <em>(Optional)</em>
  18872. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  18873. <p>Deprecated: Use NamespaceSelectors instead.</p>
  18874. </td>
  18875. </tr>
  18876. <tr>
  18877. <td>
  18878. <code>refreshTime</code></br>
  18879. <em>
  18880. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  18881. Kubernetes meta/v1.Duration
  18882. </a>
  18883. </em>
  18884. </td>
  18885. <td>
  18886. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  18887. </td>
  18888. </tr>
  18889. </tbody>
  18890. </table>
  18891. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  18892. </h3>
  18893. <p>
  18894. (<em>Appears on:</em>
  18895. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  18896. </p>
  18897. <p>
  18898. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  18899. </p>
  18900. <table>
  18901. <thead>
  18902. <tr>
  18903. <th>Field</th>
  18904. <th>Description</th>
  18905. </tr>
  18906. </thead>
  18907. <tbody>
  18908. <tr>
  18909. <td>
  18910. <code>externalSecretName</code></br>
  18911. <em>
  18912. string
  18913. </em>
  18914. </td>
  18915. <td>
  18916. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  18917. </td>
  18918. </tr>
  18919. <tr>
  18920. <td>
  18921. <code>failedNamespaces</code></br>
  18922. <em>
  18923. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">
  18924. []ClusterExternalSecretNamespaceFailure
  18925. </a>
  18926. </em>
  18927. </td>
  18928. <td>
  18929. <em>(Optional)</em>
  18930. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  18931. </td>
  18932. </tr>
  18933. <tr>
  18934. <td>
  18935. <code>provisionedNamespaces</code></br>
  18936. <em>
  18937. []string
  18938. </em>
  18939. </td>
  18940. <td>
  18941. <em>(Optional)</em>
  18942. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  18943. </td>
  18944. </tr>
  18945. <tr>
  18946. <td>
  18947. <code>conditions</code></br>
  18948. <em>
  18949. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">
  18950. []ClusterExternalSecretStatusCondition
  18951. </a>
  18952. </em>
  18953. </td>
  18954. <td>
  18955. <em>(Optional)</em>
  18956. </td>
  18957. </tr>
  18958. </tbody>
  18959. </table>
  18960. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  18961. </h3>
  18962. <p>
  18963. (<em>Appears on:</em>
  18964. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  18965. </p>
  18966. <p>
  18967. <p>ClusterExternalSecretStatusCondition indicates the status of the ClusterExternalSecret.</p>
  18968. </p>
  18969. <table>
  18970. <thead>
  18971. <tr>
  18972. <th>Field</th>
  18973. <th>Description</th>
  18974. </tr>
  18975. </thead>
  18976. <tbody>
  18977. <tr>
  18978. <td>
  18979. <code>type</code></br>
  18980. <em>
  18981. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretConditionType">
  18982. ClusterExternalSecretConditionType
  18983. </a>
  18984. </em>
  18985. </td>
  18986. <td>
  18987. </td>
  18988. </tr>
  18989. <tr>
  18990. <td>
  18991. <code>status</code></br>
  18992. <em>
  18993. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  18994. Kubernetes core/v1.ConditionStatus
  18995. </a>
  18996. </em>
  18997. </td>
  18998. <td>
  18999. </td>
  19000. </tr>
  19001. <tr>
  19002. <td>
  19003. <code>message</code></br>
  19004. <em>
  19005. string
  19006. </em>
  19007. </td>
  19008. <td>
  19009. <em>(Optional)</em>
  19010. </td>
  19011. </tr>
  19012. </tbody>
  19013. </table>
  19014. <h3 id="external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore
  19015. </h3>
  19016. <p>
  19017. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  19018. </p>
  19019. <table>
  19020. <thead>
  19021. <tr>
  19022. <th>Field</th>
  19023. <th>Description</th>
  19024. </tr>
  19025. </thead>
  19026. <tbody>
  19027. <tr>
  19028. <td>
  19029. <code>metadata</code></br>
  19030. <em>
  19031. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  19032. Kubernetes meta/v1.ObjectMeta
  19033. </a>
  19034. </em>
  19035. </td>
  19036. <td>
  19037. Refer to the Kubernetes API documentation for the fields of the
  19038. <code>metadata</code> field.
  19039. </td>
  19040. </tr>
  19041. <tr>
  19042. <td>
  19043. <code>spec</code></br>
  19044. <em>
  19045. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  19046. SecretStoreSpec
  19047. </a>
  19048. </em>
  19049. </td>
  19050. <td>
  19051. <br/>
  19052. <br/>
  19053. <table>
  19054. <tr>
  19055. <td>
  19056. <code>controller</code></br>
  19057. <em>
  19058. string
  19059. </em>
  19060. </td>
  19061. <td>
  19062. <em>(Optional)</em>
  19063. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  19064. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  19065. </td>
  19066. </tr>
  19067. <tr>
  19068. <td>
  19069. <code>provider</code></br>
  19070. <em>
  19071. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  19072. SecretStoreProvider
  19073. </a>
  19074. </em>
  19075. </td>
  19076. <td>
  19077. <p>Used to configure the provider. Only one provider may be set</p>
  19078. </td>
  19079. </tr>
  19080. <tr>
  19081. <td>
  19082. <code>retrySettings</code></br>
  19083. <em>
  19084. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  19085. SecretStoreRetrySettings
  19086. </a>
  19087. </em>
  19088. </td>
  19089. <td>
  19090. <em>(Optional)</em>
  19091. <p>Used to configure HTTP retries on failures.</p>
  19092. </td>
  19093. </tr>
  19094. <tr>
  19095. <td>
  19096. <code>refreshInterval</code></br>
  19097. <em>
  19098. int
  19099. </em>
  19100. </td>
  19101. <td>
  19102. <em>(Optional)</em>
  19103. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  19104. </td>
  19105. </tr>
  19106. <tr>
  19107. <td>
  19108. <code>conditions</code></br>
  19109. <em>
  19110. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  19111. []ClusterSecretStoreCondition
  19112. </a>
  19113. </em>
  19114. </td>
  19115. <td>
  19116. <em>(Optional)</em>
  19117. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  19118. </td>
  19119. </tr>
  19120. </table>
  19121. </td>
  19122. </tr>
  19123. <tr>
  19124. <td>
  19125. <code>status</code></br>
  19126. <em>
  19127. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  19128. SecretStoreStatus
  19129. </a>
  19130. </em>
  19131. </td>
  19132. <td>
  19133. </td>
  19134. </tr>
  19135. </tbody>
  19136. </table>
  19137. <h3 id="external-secrets.io/v1beta1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  19138. </h3>
  19139. <p>
  19140. (<em>Appears on:</em>
  19141. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  19142. </p>
  19143. <p>
  19144. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  19145. for a ClusterSecretStore instance.</p>
  19146. </p>
  19147. <table>
  19148. <thead>
  19149. <tr>
  19150. <th>Field</th>
  19151. <th>Description</th>
  19152. </tr>
  19153. </thead>
  19154. <tbody>
  19155. <tr>
  19156. <td>
  19157. <code>namespaceSelector</code></br>
  19158. <em>
  19159. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  19160. Kubernetes meta/v1.LabelSelector
  19161. </a>
  19162. </em>
  19163. </td>
  19164. <td>
  19165. <em>(Optional)</em>
  19166. <p>Choose namespace using a labelSelector</p>
  19167. </td>
  19168. </tr>
  19169. <tr>
  19170. <td>
  19171. <code>namespaces</code></br>
  19172. <em>
  19173. []string
  19174. </em>
  19175. </td>
  19176. <td>
  19177. <em>(Optional)</em>
  19178. <p>Choose namespaces by name</p>
  19179. </td>
  19180. </tr>
  19181. <tr>
  19182. <td>
  19183. <code>namespaceRegexes</code></br>
  19184. <em>
  19185. []string
  19186. </em>
  19187. </td>
  19188. <td>
  19189. <em>(Optional)</em>
  19190. <p>Choose namespaces by using regex matching</p>
  19191. </td>
  19192. </tr>
  19193. </tbody>
  19194. </table>
  19195. <h3 id="external-secrets.io/v1beta1.ConjurAPIKey">ConjurAPIKey
  19196. </h3>
  19197. <p>
  19198. (<em>Appears on:</em>
  19199. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  19200. </p>
  19201. <p>
  19202. <p>ConjurAPIKey defines authentication using a Conjur API key.</p>
  19203. </p>
  19204. <table>
  19205. <thead>
  19206. <tr>
  19207. <th>Field</th>
  19208. <th>Description</th>
  19209. </tr>
  19210. </thead>
  19211. <tbody>
  19212. <tr>
  19213. <td>
  19214. <code>account</code></br>
  19215. <em>
  19216. string
  19217. </em>
  19218. </td>
  19219. <td>
  19220. <p>Account is the Conjur organization account name.</p>
  19221. </td>
  19222. </tr>
  19223. <tr>
  19224. <td>
  19225. <code>userRef</code></br>
  19226. <em>
  19227. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19228. External Secrets meta/v1.SecretKeySelector
  19229. </a>
  19230. </em>
  19231. </td>
  19232. <td>
  19233. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  19234. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  19235. </td>
  19236. </tr>
  19237. <tr>
  19238. <td>
  19239. <code>apiKeyRef</code></br>
  19240. <em>
  19241. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19242. External Secrets meta/v1.SecretKeySelector
  19243. </a>
  19244. </em>
  19245. </td>
  19246. <td>
  19247. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  19248. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  19249. </td>
  19250. </tr>
  19251. </tbody>
  19252. </table>
  19253. <h3 id="external-secrets.io/v1beta1.ConjurAuth">ConjurAuth
  19254. </h3>
  19255. <p>
  19256. (<em>Appears on:</em>
  19257. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>)
  19258. </p>
  19259. <p>
  19260. <p>ConjurAuth defines the methods of authentication with Conjur.</p>
  19261. </p>
  19262. <table>
  19263. <thead>
  19264. <tr>
  19265. <th>Field</th>
  19266. <th>Description</th>
  19267. </tr>
  19268. </thead>
  19269. <tbody>
  19270. <tr>
  19271. <td>
  19272. <code>apikey</code></br>
  19273. <em>
  19274. <a href="#external-secrets.io/v1beta1.ConjurAPIKey">
  19275. ConjurAPIKey
  19276. </a>
  19277. </em>
  19278. </td>
  19279. <td>
  19280. <em>(Optional)</em>
  19281. <p>Authenticates with Conjur using an API key.</p>
  19282. </td>
  19283. </tr>
  19284. <tr>
  19285. <td>
  19286. <code>jwt</code></br>
  19287. <em>
  19288. <a href="#external-secrets.io/v1beta1.ConjurJWT">
  19289. ConjurJWT
  19290. </a>
  19291. </em>
  19292. </td>
  19293. <td>
  19294. <em>(Optional)</em>
  19295. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  19296. </td>
  19297. </tr>
  19298. </tbody>
  19299. </table>
  19300. <h3 id="external-secrets.io/v1beta1.ConjurJWT">ConjurJWT
  19301. </h3>
  19302. <p>
  19303. (<em>Appears on:</em>
  19304. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  19305. </p>
  19306. <p>
  19307. <p>ConjurJWT defines authentication using a JWT service account token.</p>
  19308. </p>
  19309. <table>
  19310. <thead>
  19311. <tr>
  19312. <th>Field</th>
  19313. <th>Description</th>
  19314. </tr>
  19315. </thead>
  19316. <tbody>
  19317. <tr>
  19318. <td>
  19319. <code>account</code></br>
  19320. <em>
  19321. string
  19322. </em>
  19323. </td>
  19324. <td>
  19325. <p>Account is the Conjur organization account name.</p>
  19326. </td>
  19327. </tr>
  19328. <tr>
  19329. <td>
  19330. <code>serviceID</code></br>
  19331. <em>
  19332. string
  19333. </em>
  19334. </td>
  19335. <td>
  19336. <p>The conjur authn jwt webservice id</p>
  19337. </td>
  19338. </tr>
  19339. <tr>
  19340. <td>
  19341. <code>hostId</code></br>
  19342. <em>
  19343. string
  19344. </em>
  19345. </td>
  19346. <td>
  19347. <em>(Optional)</em>
  19348. <p>Optional HostID for JWT authentication. This may be used depending
  19349. on how the Conjur JWT authenticator policy is configured.</p>
  19350. </td>
  19351. </tr>
  19352. <tr>
  19353. <td>
  19354. <code>secretRef</code></br>
  19355. <em>
  19356. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19357. External Secrets meta/v1.SecretKeySelector
  19358. </a>
  19359. </em>
  19360. </td>
  19361. <td>
  19362. <em>(Optional)</em>
  19363. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  19364. authenticate with Conjur using the JWT authentication method.</p>
  19365. </td>
  19366. </tr>
  19367. <tr>
  19368. <td>
  19369. <code>serviceAccountRef</code></br>
  19370. <em>
  19371. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  19372. External Secrets meta/v1.ServiceAccountSelector
  19373. </a>
  19374. </em>
  19375. </td>
  19376. <td>
  19377. <em>(Optional)</em>
  19378. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  19379. a token for with the <code>TokenRequest</code> API.</p>
  19380. </td>
  19381. </tr>
  19382. </tbody>
  19383. </table>
  19384. <h3 id="external-secrets.io/v1beta1.ConjurProvider">ConjurProvider
  19385. </h3>
  19386. <p>
  19387. (<em>Appears on:</em>
  19388. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19389. </p>
  19390. <p>
  19391. <p>ConjurProvider defines configuration for the CyberArk Conjur provider.</p>
  19392. </p>
  19393. <table>
  19394. <thead>
  19395. <tr>
  19396. <th>Field</th>
  19397. <th>Description</th>
  19398. </tr>
  19399. </thead>
  19400. <tbody>
  19401. <tr>
  19402. <td>
  19403. <code>url</code></br>
  19404. <em>
  19405. string
  19406. </em>
  19407. </td>
  19408. <td>
  19409. <p>URL is the endpoint of the Conjur instance.</p>
  19410. </td>
  19411. </tr>
  19412. <tr>
  19413. <td>
  19414. <code>caBundle</code></br>
  19415. <em>
  19416. string
  19417. </em>
  19418. </td>
  19419. <td>
  19420. <em>(Optional)</em>
  19421. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  19422. </td>
  19423. </tr>
  19424. <tr>
  19425. <td>
  19426. <code>caProvider</code></br>
  19427. <em>
  19428. <a href="#external-secrets.io/v1beta1.CAProvider">
  19429. CAProvider
  19430. </a>
  19431. </em>
  19432. </td>
  19433. <td>
  19434. <em>(Optional)</em>
  19435. <p>Used to provide custom certificate authority (CA) certificates
  19436. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  19437. that contains a PEM-encoded certificate.</p>
  19438. </td>
  19439. </tr>
  19440. <tr>
  19441. <td>
  19442. <code>auth</code></br>
  19443. <em>
  19444. <a href="#external-secrets.io/v1beta1.ConjurAuth">
  19445. ConjurAuth
  19446. </a>
  19447. </em>
  19448. </td>
  19449. <td>
  19450. <p>Defines authentication settings for connecting to Conjur.</p>
  19451. </td>
  19452. </tr>
  19453. </tbody>
  19454. </table>
  19455. <h3 id="external-secrets.io/v1beta1.DelineaProvider">DelineaProvider
  19456. </h3>
  19457. <p>
  19458. (<em>Appears on:</em>
  19459. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19460. </p>
  19461. <p>
  19462. <p>DelineaProvider defines configuration for the Delinea DevOps Secrets Vault provider.
  19463. See <a href="https://github.com/DelineaXPM/dsv-sdk-go/blob/main/vault/vault.go">https://github.com/DelineaXPM/dsv-sdk-go/blob/main/vault/vault.go</a>.</p>
  19464. </p>
  19465. <table>
  19466. <thead>
  19467. <tr>
  19468. <th>Field</th>
  19469. <th>Description</th>
  19470. </tr>
  19471. </thead>
  19472. <tbody>
  19473. <tr>
  19474. <td>
  19475. <code>clientId</code></br>
  19476. <em>
  19477. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  19478. DelineaProviderSecretRef
  19479. </a>
  19480. </em>
  19481. </td>
  19482. <td>
  19483. <p>ClientID is the non-secret part of the credential.</p>
  19484. </td>
  19485. </tr>
  19486. <tr>
  19487. <td>
  19488. <code>clientSecret</code></br>
  19489. <em>
  19490. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  19491. DelineaProviderSecretRef
  19492. </a>
  19493. </em>
  19494. </td>
  19495. <td>
  19496. <p>ClientSecret is the secret part of the credential.</p>
  19497. </td>
  19498. </tr>
  19499. <tr>
  19500. <td>
  19501. <code>tenant</code></br>
  19502. <em>
  19503. string
  19504. </em>
  19505. </td>
  19506. <td>
  19507. <p>Tenant is the chosen hostname / site name.</p>
  19508. </td>
  19509. </tr>
  19510. <tr>
  19511. <td>
  19512. <code>urlTemplate</code></br>
  19513. <em>
  19514. string
  19515. </em>
  19516. </td>
  19517. <td>
  19518. <em>(Optional)</em>
  19519. <p>URLTemplate
  19520. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  19521. </td>
  19522. </tr>
  19523. <tr>
  19524. <td>
  19525. <code>tld</code></br>
  19526. <em>
  19527. string
  19528. </em>
  19529. </td>
  19530. <td>
  19531. <em>(Optional)</em>
  19532. <p>TLD is based on the server location that was chosen during provisioning.
  19533. If unset, defaults to &ldquo;com&rdquo;.</p>
  19534. </td>
  19535. </tr>
  19536. </tbody>
  19537. </table>
  19538. <h3 id="external-secrets.io/v1beta1.DelineaProviderSecretRef">DelineaProviderSecretRef
  19539. </h3>
  19540. <p>
  19541. (<em>Appears on:</em>
  19542. <a href="#external-secrets.io/v1beta1.DelineaProvider">DelineaProvider</a>)
  19543. </p>
  19544. <p>
  19545. <p>DelineaProviderSecretRef defines a reference to a secret containing credentials for the Delinea provider.</p>
  19546. </p>
  19547. <table>
  19548. <thead>
  19549. <tr>
  19550. <th>Field</th>
  19551. <th>Description</th>
  19552. </tr>
  19553. </thead>
  19554. <tbody>
  19555. <tr>
  19556. <td>
  19557. <code>value</code></br>
  19558. <em>
  19559. string
  19560. </em>
  19561. </td>
  19562. <td>
  19563. <em>(Optional)</em>
  19564. <p>Value can be specified directly to set a value without using a secret.</p>
  19565. </td>
  19566. </tr>
  19567. <tr>
  19568. <td>
  19569. <code>secretRef</code></br>
  19570. <em>
  19571. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19572. External Secrets meta/v1.SecretKeySelector
  19573. </a>
  19574. </em>
  19575. </td>
  19576. <td>
  19577. <em>(Optional)</em>
  19578. <p>SecretRef references a key in a secret that will be used as value.</p>
  19579. </td>
  19580. </tr>
  19581. </tbody>
  19582. </table>
  19583. <h3 id="external-secrets.io/v1beta1.Device42Auth">Device42Auth
  19584. </h3>
  19585. <p>
  19586. (<em>Appears on:</em>
  19587. <a href="#external-secrets.io/v1beta1.Device42Provider">Device42Provider</a>)
  19588. </p>
  19589. <p>
  19590. <p>Device42Auth defines the authentication method for the Device42 provider.</p>
  19591. </p>
  19592. <table>
  19593. <thead>
  19594. <tr>
  19595. <th>Field</th>
  19596. <th>Description</th>
  19597. </tr>
  19598. </thead>
  19599. <tbody>
  19600. <tr>
  19601. <td>
  19602. <code>secretRef</code></br>
  19603. <em>
  19604. <a href="#external-secrets.io/v1beta1.Device42SecretRef">
  19605. Device42SecretRef
  19606. </a>
  19607. </em>
  19608. </td>
  19609. <td>
  19610. </td>
  19611. </tr>
  19612. </tbody>
  19613. </table>
  19614. <h3 id="external-secrets.io/v1beta1.Device42Provider">Device42Provider
  19615. </h3>
  19616. <p>
  19617. (<em>Appears on:</em>
  19618. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19619. </p>
  19620. <p>
  19621. <p>Device42Provider configures a store to sync secrets with a Device42 instance.</p>
  19622. </p>
  19623. <table>
  19624. <thead>
  19625. <tr>
  19626. <th>Field</th>
  19627. <th>Description</th>
  19628. </tr>
  19629. </thead>
  19630. <tbody>
  19631. <tr>
  19632. <td>
  19633. <code>host</code></br>
  19634. <em>
  19635. string
  19636. </em>
  19637. </td>
  19638. <td>
  19639. <p>URL configures the Device42 instance URL.</p>
  19640. </td>
  19641. </tr>
  19642. <tr>
  19643. <td>
  19644. <code>auth</code></br>
  19645. <em>
  19646. <a href="#external-secrets.io/v1beta1.Device42Auth">
  19647. Device42Auth
  19648. </a>
  19649. </em>
  19650. </td>
  19651. <td>
  19652. <p>Auth configures how secret-manager authenticates with a Device42 instance.</p>
  19653. </td>
  19654. </tr>
  19655. </tbody>
  19656. </table>
  19657. <h3 id="external-secrets.io/v1beta1.Device42SecretRef">Device42SecretRef
  19658. </h3>
  19659. <p>
  19660. (<em>Appears on:</em>
  19661. <a href="#external-secrets.io/v1beta1.Device42Auth">Device42Auth</a>)
  19662. </p>
  19663. <p>
  19664. <p>Device42SecretRef defines a reference to a secret containing credentials for the Device42 provider.</p>
  19665. </p>
  19666. <table>
  19667. <thead>
  19668. <tr>
  19669. <th>Field</th>
  19670. <th>Description</th>
  19671. </tr>
  19672. </thead>
  19673. <tbody>
  19674. <tr>
  19675. <td>
  19676. <code>credentials</code></br>
  19677. <em>
  19678. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19679. External Secrets meta/v1.SecretKeySelector
  19680. </a>
  19681. </em>
  19682. </td>
  19683. <td>
  19684. <em>(Optional)</em>
  19685. <p>Username / Password is used for authentication.</p>
  19686. </td>
  19687. </tr>
  19688. </tbody>
  19689. </table>
  19690. <h3 id="external-secrets.io/v1beta1.DopplerAuth">DopplerAuth
  19691. </h3>
  19692. <p>
  19693. (<em>Appears on:</em>
  19694. <a href="#external-secrets.io/v1beta1.DopplerProvider">DopplerProvider</a>)
  19695. </p>
  19696. <p>
  19697. <p>DopplerAuth defines the authentication method for the Doppler provider.</p>
  19698. </p>
  19699. <table>
  19700. <thead>
  19701. <tr>
  19702. <th>Field</th>
  19703. <th>Description</th>
  19704. </tr>
  19705. </thead>
  19706. <tbody>
  19707. <tr>
  19708. <td>
  19709. <code>secretRef</code></br>
  19710. <em>
  19711. <a href="#external-secrets.io/v1beta1.DopplerAuthSecretRef">
  19712. DopplerAuthSecretRef
  19713. </a>
  19714. </em>
  19715. </td>
  19716. <td>
  19717. </td>
  19718. </tr>
  19719. </tbody>
  19720. </table>
  19721. <h3 id="external-secrets.io/v1beta1.DopplerAuthSecretRef">DopplerAuthSecretRef
  19722. </h3>
  19723. <p>
  19724. (<em>Appears on:</em>
  19725. <a href="#external-secrets.io/v1beta1.DopplerAuth">DopplerAuth</a>)
  19726. </p>
  19727. <p>
  19728. <p>DopplerAuthSecretRef defines a reference to a secret containing credentials for the Doppler provider.</p>
  19729. </p>
  19730. <table>
  19731. <thead>
  19732. <tr>
  19733. <th>Field</th>
  19734. <th>Description</th>
  19735. </tr>
  19736. </thead>
  19737. <tbody>
  19738. <tr>
  19739. <td>
  19740. <code>dopplerToken</code></br>
  19741. <em>
  19742. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19743. External Secrets meta/v1.SecretKeySelector
  19744. </a>
  19745. </em>
  19746. </td>
  19747. <td>
  19748. <p>The DopplerToken is used for authentication.
  19749. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  19750. The Key attribute defaults to dopplerToken if not specified.</p>
  19751. </td>
  19752. </tr>
  19753. </tbody>
  19754. </table>
  19755. <h3 id="external-secrets.io/v1beta1.DopplerProvider">DopplerProvider
  19756. </h3>
  19757. <p>
  19758. (<em>Appears on:</em>
  19759. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19760. </p>
  19761. <p>
  19762. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  19763. Project and Config are required if not using a Service Token.</p>
  19764. </p>
  19765. <table>
  19766. <thead>
  19767. <tr>
  19768. <th>Field</th>
  19769. <th>Description</th>
  19770. </tr>
  19771. </thead>
  19772. <tbody>
  19773. <tr>
  19774. <td>
  19775. <code>auth</code></br>
  19776. <em>
  19777. <a href="#external-secrets.io/v1beta1.DopplerAuth">
  19778. DopplerAuth
  19779. </a>
  19780. </em>
  19781. </td>
  19782. <td>
  19783. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  19784. </td>
  19785. </tr>
  19786. <tr>
  19787. <td>
  19788. <code>project</code></br>
  19789. <em>
  19790. string
  19791. </em>
  19792. </td>
  19793. <td>
  19794. <em>(Optional)</em>
  19795. <p>Doppler project (required if not using a Service Token)</p>
  19796. </td>
  19797. </tr>
  19798. <tr>
  19799. <td>
  19800. <code>config</code></br>
  19801. <em>
  19802. string
  19803. </em>
  19804. </td>
  19805. <td>
  19806. <em>(Optional)</em>
  19807. <p>Doppler config (required if not using a Service Token)</p>
  19808. </td>
  19809. </tr>
  19810. <tr>
  19811. <td>
  19812. <code>nameTransformer</code></br>
  19813. <em>
  19814. string
  19815. </em>
  19816. </td>
  19817. <td>
  19818. <em>(Optional)</em>
  19819. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  19820. </td>
  19821. </tr>
  19822. <tr>
  19823. <td>
  19824. <code>format</code></br>
  19825. <em>
  19826. string
  19827. </em>
  19828. </td>
  19829. <td>
  19830. <em>(Optional)</em>
  19831. <p>Format enables the downloading of secrets as a file (string)</p>
  19832. </td>
  19833. </tr>
  19834. </tbody>
  19835. </table>
  19836. <h3 id="external-secrets.io/v1beta1.ExternalSecret">ExternalSecret
  19837. </h3>
  19838. <p>
  19839. <p>ExternalSecret is the schema for the external-secrets API.</p>
  19840. </p>
  19841. <table>
  19842. <thead>
  19843. <tr>
  19844. <th>Field</th>
  19845. <th>Description</th>
  19846. </tr>
  19847. </thead>
  19848. <tbody>
  19849. <tr>
  19850. <td>
  19851. <code>metadata</code></br>
  19852. <em>
  19853. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  19854. Kubernetes meta/v1.ObjectMeta
  19855. </a>
  19856. </em>
  19857. </td>
  19858. <td>
  19859. Refer to the Kubernetes API documentation for the fields of the
  19860. <code>metadata</code> field.
  19861. </td>
  19862. </tr>
  19863. <tr>
  19864. <td>
  19865. <code>spec</code></br>
  19866. <em>
  19867. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  19868. ExternalSecretSpec
  19869. </a>
  19870. </em>
  19871. </td>
  19872. <td>
  19873. <br/>
  19874. <br/>
  19875. <table>
  19876. <tr>
  19877. <td>
  19878. <code>secretStoreRef</code></br>
  19879. <em>
  19880. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  19881. SecretStoreRef
  19882. </a>
  19883. </em>
  19884. </td>
  19885. <td>
  19886. <em>(Optional)</em>
  19887. </td>
  19888. </tr>
  19889. <tr>
  19890. <td>
  19891. <code>target</code></br>
  19892. <em>
  19893. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  19894. ExternalSecretTarget
  19895. </a>
  19896. </em>
  19897. </td>
  19898. <td>
  19899. <em>(Optional)</em>
  19900. </td>
  19901. </tr>
  19902. <tr>
  19903. <td>
  19904. <code>refreshPolicy</code></br>
  19905. <em>
  19906. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  19907. ExternalSecretRefreshPolicy
  19908. </a>
  19909. </em>
  19910. </td>
  19911. <td>
  19912. <em>(Optional)</em>
  19913. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  19914. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  19915. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  19916. No periodic updates occur if refreshInterval is 0.
  19917. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  19918. </td>
  19919. </tr>
  19920. <tr>
  19921. <td>
  19922. <code>refreshInterval</code></br>
  19923. <em>
  19924. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  19925. Kubernetes meta/v1.Duration
  19926. </a>
  19927. </em>
  19928. </td>
  19929. <td>
  19930. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  19931. specified as Golang Duration strings.
  19932. Valid time units are &ldquo;ns&rdquo;, &ldquo;us&rdquo; (or &ldquo;µs&rdquo;), &ldquo;ms&rdquo;, &ldquo;s&rdquo;, &ldquo;m&rdquo;, &ldquo;h&rdquo;
  19933. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  19934. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  19935. </td>
  19936. </tr>
  19937. <tr>
  19938. <td>
  19939. <code>data</code></br>
  19940. <em>
  19941. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  19942. []ExternalSecretData
  19943. </a>
  19944. </em>
  19945. </td>
  19946. <td>
  19947. <em>(Optional)</em>
  19948. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  19949. </td>
  19950. </tr>
  19951. <tr>
  19952. <td>
  19953. <code>dataFrom</code></br>
  19954. <em>
  19955. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  19956. []ExternalSecretDataFromRemoteRef
  19957. </a>
  19958. </em>
  19959. </td>
  19960. <td>
  19961. <em>(Optional)</em>
  19962. <p>DataFrom is used to fetch all properties from a specific Provider data
  19963. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  19964. </td>
  19965. </tr>
  19966. </table>
  19967. </td>
  19968. </tr>
  19969. <tr>
  19970. <td>
  19971. <code>status</code></br>
  19972. <em>
  19973. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">
  19974. ExternalSecretStatus
  19975. </a>
  19976. </em>
  19977. </td>
  19978. <td>
  19979. </td>
  19980. </tr>
  19981. </tbody>
  19982. </table>
  19983. <h3 id="external-secrets.io/v1beta1.ExternalSecretConditionType">ExternalSecretConditionType
  19984. (<code>string</code> alias)</p></h3>
  19985. <p>
  19986. (<em>Appears on:</em>
  19987. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  19988. </p>
  19989. <p>
  19990. <p>ExternalSecretConditionType defines the condition type for an ExternalSecret.</p>
  19991. </p>
  19992. <table>
  19993. <thead>
  19994. <tr>
  19995. <th>Value</th>
  19996. <th>Description</th>
  19997. </tr>
  19998. </thead>
  19999. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  20000. <td><p>ExternalSecretDeleted indicates the ExternalSecret has been deleted.</p>
  20001. </td>
  20002. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  20003. <td><p>ExternalSecretReady indicates the ExternalSecret has been successfully reconciled.</p>
  20004. </td>
  20005. </tr></tbody>
  20006. </table>
  20007. <h3 id="external-secrets.io/v1beta1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  20008. (<code>string</code> alias)</p></h3>
  20009. <p>
  20010. (<em>Appears on:</em>
  20011. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  20012. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  20013. </p>
  20014. <p>
  20015. <p>ExternalSecretConversionStrategy defines how secret values are converted.</p>
  20016. </p>
  20017. <table>
  20018. <thead>
  20019. <tr>
  20020. <th>Value</th>
  20021. <th>Description</th>
  20022. </tr>
  20023. </thead>
  20024. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  20025. <td><p>ExternalSecretConversionDefault indicates the default conversion strategy.</p>
  20026. </td>
  20027. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  20028. <td><p>ExternalSecretConversionUnicode indicates that unicode conversion will be performed.</p>
  20029. </td>
  20030. </tr></tbody>
  20031. </table>
  20032. <h3 id="external-secrets.io/v1beta1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  20033. (<code>string</code> alias)</p></h3>
  20034. <p>
  20035. (<em>Appears on:</em>
  20036. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  20037. </p>
  20038. <p>
  20039. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  20040. </p>
  20041. <table>
  20042. <thead>
  20043. <tr>
  20044. <th>Value</th>
  20045. <th>Description</th>
  20046. </tr>
  20047. </thead>
  20048. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  20049. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  20050. </td>
  20051. </tr><tr><td><p>&#34;None&#34;</p></td>
  20052. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  20053. </td>
  20054. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  20055. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  20056. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  20057. </td>
  20058. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  20059. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  20060. </td>
  20061. </tr></tbody>
  20062. </table>
  20063. <h3 id="external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData
  20064. </h3>
  20065. <p>
  20066. (<em>Appears on:</em>
  20067. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20068. </p>
  20069. <p>
  20070. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  20071. </p>
  20072. <table>
  20073. <thead>
  20074. <tr>
  20075. <th>Field</th>
  20076. <th>Description</th>
  20077. </tr>
  20078. </thead>
  20079. <tbody>
  20080. <tr>
  20081. <td>
  20082. <code>secretKey</code></br>
  20083. <em>
  20084. string
  20085. </em>
  20086. </td>
  20087. <td>
  20088. <p>The key in the Kubernetes Secret to store the value.</p>
  20089. </td>
  20090. </tr>
  20091. <tr>
  20092. <td>
  20093. <code>remoteRef</code></br>
  20094. <em>
  20095. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  20096. ExternalSecretDataRemoteRef
  20097. </a>
  20098. </em>
  20099. </td>
  20100. <td>
  20101. <p>RemoteRef points to the remote secret and defines
  20102. which secret (version/property/..) to fetch.</p>
  20103. </td>
  20104. </tr>
  20105. <tr>
  20106. <td>
  20107. <code>sourceRef</code></br>
  20108. <em>
  20109. <a href="#external-secrets.io/v1beta1.StoreSourceRef">
  20110. StoreSourceRef
  20111. </a>
  20112. </em>
  20113. </td>
  20114. <td>
  20115. <p>SourceRef allows you to override the source
  20116. from which the value will be pulled.</p>
  20117. </td>
  20118. </tr>
  20119. </tbody>
  20120. </table>
  20121. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  20122. </h3>
  20123. <p>
  20124. (<em>Appears on:</em>
  20125. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20126. </p>
  20127. <p>
  20128. <p>ExternalSecretDataFromRemoteRef defines a reference to multiple secrets in the provider to be fetched using options.</p>
  20129. </p>
  20130. <table>
  20131. <thead>
  20132. <tr>
  20133. <th>Field</th>
  20134. <th>Description</th>
  20135. </tr>
  20136. </thead>
  20137. <tbody>
  20138. <tr>
  20139. <td>
  20140. <code>extract</code></br>
  20141. <em>
  20142. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  20143. ExternalSecretDataRemoteRef
  20144. </a>
  20145. </em>
  20146. </td>
  20147. <td>
  20148. <em>(Optional)</em>
  20149. <p>Used to extract multiple key/value pairs from one secret
  20150. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  20151. </td>
  20152. </tr>
  20153. <tr>
  20154. <td>
  20155. <code>find</code></br>
  20156. <em>
  20157. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">
  20158. ExternalSecretFind
  20159. </a>
  20160. </em>
  20161. </td>
  20162. <td>
  20163. <em>(Optional)</em>
  20164. <p>Used to find secrets based on tags or regular expressions
  20165. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  20166. </td>
  20167. </tr>
  20168. <tr>
  20169. <td>
  20170. <code>rewrite</code></br>
  20171. <em>
  20172. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">
  20173. []ExternalSecretRewrite
  20174. </a>
  20175. </em>
  20176. </td>
  20177. <td>
  20178. <em>(Optional)</em>
  20179. <p>Used to rewrite secret Keys after getting them from the secret Provider
  20180. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  20181. </td>
  20182. </tr>
  20183. <tr>
  20184. <td>
  20185. <code>sourceRef</code></br>
  20186. <em>
  20187. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">
  20188. StoreGeneratorSourceRef
  20189. </a>
  20190. </em>
  20191. </td>
  20192. <td>
  20193. <p>SourceRef points to a store or generator
  20194. which contains secret values ready to use.
  20195. Use this in combination with Extract or Find pull values out of
  20196. a specific SecretStore.
  20197. When sourceRef points to a generator Extract or Find is not supported.
  20198. The generator returns a static map of values</p>
  20199. </td>
  20200. </tr>
  20201. </tbody>
  20202. </table>
  20203. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  20204. </h3>
  20205. <p>
  20206. (<em>Appears on:</em>
  20207. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>,
  20208. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20209. </p>
  20210. <p>
  20211. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  20212. </p>
  20213. <table>
  20214. <thead>
  20215. <tr>
  20216. <th>Field</th>
  20217. <th>Description</th>
  20218. </tr>
  20219. </thead>
  20220. <tbody>
  20221. <tr>
  20222. <td>
  20223. <code>key</code></br>
  20224. <em>
  20225. string
  20226. </em>
  20227. </td>
  20228. <td>
  20229. <p>Key is the key used in the Provider, mandatory</p>
  20230. </td>
  20231. </tr>
  20232. <tr>
  20233. <td>
  20234. <code>metadataPolicy</code></br>
  20235. <em>
  20236. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">
  20237. ExternalSecretMetadataPolicy
  20238. </a>
  20239. </em>
  20240. </td>
  20241. <td>
  20242. <em>(Optional)</em>
  20243. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  20244. </td>
  20245. </tr>
  20246. <tr>
  20247. <td>
  20248. <code>property</code></br>
  20249. <em>
  20250. string
  20251. </em>
  20252. </td>
  20253. <td>
  20254. <em>(Optional)</em>
  20255. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  20256. </td>
  20257. </tr>
  20258. <tr>
  20259. <td>
  20260. <code>version</code></br>
  20261. <em>
  20262. string
  20263. </em>
  20264. </td>
  20265. <td>
  20266. <em>(Optional)</em>
  20267. <p>Used to select a specific version of the Provider value, if supported</p>
  20268. </td>
  20269. </tr>
  20270. <tr>
  20271. <td>
  20272. <code>conversionStrategy</code></br>
  20273. <em>
  20274. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  20275. ExternalSecretConversionStrategy
  20276. </a>
  20277. </em>
  20278. </td>
  20279. <td>
  20280. <em>(Optional)</em>
  20281. <p>Used to define a conversion Strategy</p>
  20282. </td>
  20283. </tr>
  20284. <tr>
  20285. <td>
  20286. <code>decodingStrategy</code></br>
  20287. <em>
  20288. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  20289. ExternalSecretDecodingStrategy
  20290. </a>
  20291. </em>
  20292. </td>
  20293. <td>
  20294. <em>(Optional)</em>
  20295. <p>Used to define a decoding Strategy</p>
  20296. </td>
  20297. </tr>
  20298. </tbody>
  20299. </table>
  20300. <h3 id="external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  20301. (<code>string</code> alias)</p></h3>
  20302. <p>
  20303. (<em>Appears on:</em>
  20304. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  20305. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  20306. </p>
  20307. <p>
  20308. <p>ExternalSecretDecodingStrategy defines how secret values are decoded.</p>
  20309. </p>
  20310. <table>
  20311. <thead>
  20312. <tr>
  20313. <th>Value</th>
  20314. <th>Description</th>
  20315. </tr>
  20316. </thead>
  20317. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  20318. <td><p>ExternalSecretDecodeAuto indicates that the decoding strategy will be automatically determined.</p>
  20319. </td>
  20320. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  20321. <td><p>ExternalSecretDecodeBase64 indicates that base64 decoding will be used.</p>
  20322. </td>
  20323. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  20324. <td><p>ExternalSecretDecodeBase64URL indicates that base64url decoding will be used.</p>
  20325. </td>
  20326. </tr><tr><td><p>&#34;None&#34;</p></td>
  20327. <td><p>ExternalSecretDecodeNone indicates that no decoding will be performed.</p>
  20328. </td>
  20329. </tr></tbody>
  20330. </table>
  20331. <h3 id="external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  20332. (<code>string</code> alias)</p></h3>
  20333. <p>
  20334. (<em>Appears on:</em>
  20335. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  20336. </p>
  20337. <p>
  20338. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  20339. </p>
  20340. <table>
  20341. <thead>
  20342. <tr>
  20343. <th>Value</th>
  20344. <th>Description</th>
  20345. </tr>
  20346. </thead>
  20347. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  20348. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  20349. If a secret gets deleted on the provider side and is not accessible
  20350. anymore this is not considered an error and the ExternalSecret
  20351. does not go into SecretSyncedError status.</p>
  20352. </td>
  20353. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  20354. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  20355. If a secret gets deleted on the provider side and is not accessible
  20356. anymore this is not considered an error and the ExternalSecret
  20357. does not go into SecretSyncedError status.</p>
  20358. </td>
  20359. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  20360. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  20361. If a provider secret does not exist the ExternalSecret gets into the
  20362. SecretSyncedError status.</p>
  20363. </td>
  20364. </tr></tbody>
  20365. </table>
  20366. <h3 id="external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind
  20367. </h3>
  20368. <p>
  20369. (<em>Appears on:</em>
  20370. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20371. </p>
  20372. <p>
  20373. <p>ExternalSecretFind defines criteria for finding secrets in the provider.</p>
  20374. </p>
  20375. <table>
  20376. <thead>
  20377. <tr>
  20378. <th>Field</th>
  20379. <th>Description</th>
  20380. </tr>
  20381. </thead>
  20382. <tbody>
  20383. <tr>
  20384. <td>
  20385. <code>path</code></br>
  20386. <em>
  20387. string
  20388. </em>
  20389. </td>
  20390. <td>
  20391. <em>(Optional)</em>
  20392. <p>A root path to start the find operations.</p>
  20393. </td>
  20394. </tr>
  20395. <tr>
  20396. <td>
  20397. <code>name</code></br>
  20398. <em>
  20399. <a href="#external-secrets.io/v1beta1.FindName">
  20400. FindName
  20401. </a>
  20402. </em>
  20403. </td>
  20404. <td>
  20405. <em>(Optional)</em>
  20406. <p>Finds secrets based on the name.</p>
  20407. </td>
  20408. </tr>
  20409. <tr>
  20410. <td>
  20411. <code>tags</code></br>
  20412. <em>
  20413. map[string]string
  20414. </em>
  20415. </td>
  20416. <td>
  20417. <em>(Optional)</em>
  20418. <p>Find secrets based on tags.</p>
  20419. </td>
  20420. </tr>
  20421. <tr>
  20422. <td>
  20423. <code>conversionStrategy</code></br>
  20424. <em>
  20425. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  20426. ExternalSecretConversionStrategy
  20427. </a>
  20428. </em>
  20429. </td>
  20430. <td>
  20431. <em>(Optional)</em>
  20432. <p>Used to define a conversion Strategy</p>
  20433. </td>
  20434. </tr>
  20435. <tr>
  20436. <td>
  20437. <code>decodingStrategy</code></br>
  20438. <em>
  20439. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  20440. ExternalSecretDecodingStrategy
  20441. </a>
  20442. </em>
  20443. </td>
  20444. <td>
  20445. <em>(Optional)</em>
  20446. <p>Used to define a decoding Strategy</p>
  20447. </td>
  20448. </tr>
  20449. </tbody>
  20450. </table>
  20451. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadata">ExternalSecretMetadata
  20452. </h3>
  20453. <p>
  20454. (<em>Appears on:</em>
  20455. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  20456. </p>
  20457. <p>
  20458. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  20459. </p>
  20460. <table>
  20461. <thead>
  20462. <tr>
  20463. <th>Field</th>
  20464. <th>Description</th>
  20465. </tr>
  20466. </thead>
  20467. <tbody>
  20468. <tr>
  20469. <td>
  20470. <code>annotations</code></br>
  20471. <em>
  20472. map[string]string
  20473. </em>
  20474. </td>
  20475. <td>
  20476. <em>(Optional)</em>
  20477. </td>
  20478. </tr>
  20479. <tr>
  20480. <td>
  20481. <code>labels</code></br>
  20482. <em>
  20483. map[string]string
  20484. </em>
  20485. </td>
  20486. <td>
  20487. <em>(Optional)</em>
  20488. </td>
  20489. </tr>
  20490. </tbody>
  20491. </table>
  20492. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  20493. (<code>string</code> alias)</p></h3>
  20494. <p>
  20495. (<em>Appears on:</em>
  20496. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  20497. </p>
  20498. <p>
  20499. <p>ExternalSecretMetadataPolicy defines the policy for fetching tags/labels from provider secrets.</p>
  20500. </p>
  20501. <table>
  20502. <thead>
  20503. <tr>
  20504. <th>Value</th>
  20505. <th>Description</th>
  20506. </tr>
  20507. </thead>
  20508. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  20509. <td><p>ExternalSecretMetadataPolicyFetch indicates that metadata will be fetched from the provider.</p>
  20510. </td>
  20511. </tr><tr><td><p>&#34;None&#34;</p></td>
  20512. <td><p>ExternalSecretMetadataPolicyNone indicates that no metadata will be fetched.</p>
  20513. </td>
  20514. </tr></tbody>
  20515. </table>
  20516. <h3 id="external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  20517. (<code>string</code> alias)</p></h3>
  20518. <p>
  20519. (<em>Appears on:</em>
  20520. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20521. </p>
  20522. <p>
  20523. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  20524. </p>
  20525. <table>
  20526. <thead>
  20527. <tr>
  20528. <th>Value</th>
  20529. <th>Description</th>
  20530. </tr>
  20531. </thead>
  20532. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  20533. <td><p>RefreshPolicyCreatedOnce creates the Secret only if it does not exist and does not update it thereafter.</p>
  20534. </td>
  20535. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  20536. <td><p>RefreshPolicyOnChange only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes.</p>
  20537. </td>
  20538. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  20539. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the external source at regular intervals.</p>
  20540. </td>
  20541. </tr></tbody>
  20542. </table>
  20543. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite
  20544. </h3>
  20545. <p>
  20546. (<em>Appears on:</em>
  20547. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20548. </p>
  20549. <p>
  20550. <p>ExternalSecretRewrite defines rules on how to rewrite secret keys.</p>
  20551. </p>
  20552. <table>
  20553. <thead>
  20554. <tr>
  20555. <th>Field</th>
  20556. <th>Description</th>
  20557. </tr>
  20558. </thead>
  20559. <tbody>
  20560. <tr>
  20561. <td>
  20562. <code>regexp</code></br>
  20563. <em>
  20564. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">
  20565. ExternalSecretRewriteRegexp
  20566. </a>
  20567. </em>
  20568. </td>
  20569. <td>
  20570. <em>(Optional)</em>
  20571. <p>Used to rewrite with regular expressions.
  20572. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  20573. </td>
  20574. </tr>
  20575. <tr>
  20576. <td>
  20577. <code>transform</code></br>
  20578. <em>
  20579. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteTransform">
  20580. ExternalSecretRewriteTransform
  20581. </a>
  20582. </em>
  20583. </td>
  20584. <td>
  20585. <em>(Optional)</em>
  20586. <p>Used to apply string transformation on the secrets.
  20587. The resulting key will be the output of the template applied by the operation.</p>
  20588. </td>
  20589. </tr>
  20590. </tbody>
  20591. </table>
  20592. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  20593. </h3>
  20594. <p>
  20595. (<em>Appears on:</em>
  20596. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  20597. </p>
  20598. <p>
  20599. <p>ExternalSecretRewriteRegexp defines how to use regular expressions for rewriting secret keys.</p>
  20600. </p>
  20601. <table>
  20602. <thead>
  20603. <tr>
  20604. <th>Field</th>
  20605. <th>Description</th>
  20606. </tr>
  20607. </thead>
  20608. <tbody>
  20609. <tr>
  20610. <td>
  20611. <code>source</code></br>
  20612. <em>
  20613. string
  20614. </em>
  20615. </td>
  20616. <td>
  20617. <p>Used to define the regular expression of a re.Compiler.</p>
  20618. </td>
  20619. </tr>
  20620. <tr>
  20621. <td>
  20622. <code>target</code></br>
  20623. <em>
  20624. string
  20625. </em>
  20626. </td>
  20627. <td>
  20628. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  20629. </td>
  20630. </tr>
  20631. </tbody>
  20632. </table>
  20633. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  20634. </h3>
  20635. <p>
  20636. (<em>Appears on:</em>
  20637. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  20638. </p>
  20639. <p>
  20640. <p>ExternalSecretRewriteTransform defines how to use string templates for transforming secret keys.</p>
  20641. </p>
  20642. <table>
  20643. <thead>
  20644. <tr>
  20645. <th>Field</th>
  20646. <th>Description</th>
  20647. </tr>
  20648. </thead>
  20649. <tbody>
  20650. <tr>
  20651. <td>
  20652. <code>template</code></br>
  20653. <em>
  20654. string
  20655. </em>
  20656. </td>
  20657. <td>
  20658. <p>Used to define the template to apply on the secret name.
  20659. <code>.value</code> will specify the secret name in the template.</p>
  20660. </td>
  20661. </tr>
  20662. </tbody>
  20663. </table>
  20664. <h3 id="external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec
  20665. </h3>
  20666. <p>
  20667. (<em>Appears on:</em>
  20668. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  20669. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  20670. </p>
  20671. <p>
  20672. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  20673. </p>
  20674. <table>
  20675. <thead>
  20676. <tr>
  20677. <th>Field</th>
  20678. <th>Description</th>
  20679. </tr>
  20680. </thead>
  20681. <tbody>
  20682. <tr>
  20683. <td>
  20684. <code>secretStoreRef</code></br>
  20685. <em>
  20686. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  20687. SecretStoreRef
  20688. </a>
  20689. </em>
  20690. </td>
  20691. <td>
  20692. <em>(Optional)</em>
  20693. </td>
  20694. </tr>
  20695. <tr>
  20696. <td>
  20697. <code>target</code></br>
  20698. <em>
  20699. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  20700. ExternalSecretTarget
  20701. </a>
  20702. </em>
  20703. </td>
  20704. <td>
  20705. <em>(Optional)</em>
  20706. </td>
  20707. </tr>
  20708. <tr>
  20709. <td>
  20710. <code>refreshPolicy</code></br>
  20711. <em>
  20712. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  20713. ExternalSecretRefreshPolicy
  20714. </a>
  20715. </em>
  20716. </td>
  20717. <td>
  20718. <em>(Optional)</em>
  20719. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  20720. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  20721. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  20722. No periodic updates occur if refreshInterval is 0.
  20723. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  20724. </td>
  20725. </tr>
  20726. <tr>
  20727. <td>
  20728. <code>refreshInterval</code></br>
  20729. <em>
  20730. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  20731. Kubernetes meta/v1.Duration
  20732. </a>
  20733. </em>
  20734. </td>
  20735. <td>
  20736. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  20737. specified as Golang Duration strings.
  20738. Valid time units are &ldquo;ns&rdquo;, &ldquo;us&rdquo; (or &ldquo;µs&rdquo;), &ldquo;ms&rdquo;, &ldquo;s&rdquo;, &ldquo;m&rdquo;, &ldquo;h&rdquo;
  20739. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  20740. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  20741. </td>
  20742. </tr>
  20743. <tr>
  20744. <td>
  20745. <code>data</code></br>
  20746. <em>
  20747. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  20748. []ExternalSecretData
  20749. </a>
  20750. </em>
  20751. </td>
  20752. <td>
  20753. <em>(Optional)</em>
  20754. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  20755. </td>
  20756. </tr>
  20757. <tr>
  20758. <td>
  20759. <code>dataFrom</code></br>
  20760. <em>
  20761. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  20762. []ExternalSecretDataFromRemoteRef
  20763. </a>
  20764. </em>
  20765. </td>
  20766. <td>
  20767. <em>(Optional)</em>
  20768. <p>DataFrom is used to fetch all properties from a specific Provider data
  20769. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  20770. </td>
  20771. </tr>
  20772. </tbody>
  20773. </table>
  20774. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus
  20775. </h3>
  20776. <p>
  20777. (<em>Appears on:</em>
  20778. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  20779. </p>
  20780. <p>
  20781. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  20782. </p>
  20783. <table>
  20784. <thead>
  20785. <tr>
  20786. <th>Field</th>
  20787. <th>Description</th>
  20788. </tr>
  20789. </thead>
  20790. <tbody>
  20791. <tr>
  20792. <td>
  20793. <code>refreshTime</code></br>
  20794. <em>
  20795. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  20796. Kubernetes meta/v1.Time
  20797. </a>
  20798. </em>
  20799. </td>
  20800. <td>
  20801. <p>refreshTime is the time and date the external secret was fetched and
  20802. the target secret updated</p>
  20803. </td>
  20804. </tr>
  20805. <tr>
  20806. <td>
  20807. <code>syncedResourceVersion</code></br>
  20808. <em>
  20809. string
  20810. </em>
  20811. </td>
  20812. <td>
  20813. <p>SyncedResourceVersion keeps track of the last synced version</p>
  20814. </td>
  20815. </tr>
  20816. <tr>
  20817. <td>
  20818. <code>conditions</code></br>
  20819. <em>
  20820. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">
  20821. []ExternalSecretStatusCondition
  20822. </a>
  20823. </em>
  20824. </td>
  20825. <td>
  20826. <em>(Optional)</em>
  20827. </td>
  20828. </tr>
  20829. <tr>
  20830. <td>
  20831. <code>binding</code></br>
  20832. <em>
  20833. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  20834. Kubernetes core/v1.LocalObjectReference
  20835. </a>
  20836. </em>
  20837. </td>
  20838. <td>
  20839. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  20840. </td>
  20841. </tr>
  20842. </tbody>
  20843. </table>
  20844. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  20845. </h3>
  20846. <p>
  20847. (<em>Appears on:</em>
  20848. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus</a>)
  20849. </p>
  20850. <p>
  20851. <p>ExternalSecretStatusCondition contains condition information for an ExternalSecret.</p>
  20852. </p>
  20853. <table>
  20854. <thead>
  20855. <tr>
  20856. <th>Field</th>
  20857. <th>Description</th>
  20858. </tr>
  20859. </thead>
  20860. <tbody>
  20861. <tr>
  20862. <td>
  20863. <code>type</code></br>
  20864. <em>
  20865. <a href="#external-secrets.io/v1beta1.ExternalSecretConditionType">
  20866. ExternalSecretConditionType
  20867. </a>
  20868. </em>
  20869. </td>
  20870. <td>
  20871. </td>
  20872. </tr>
  20873. <tr>
  20874. <td>
  20875. <code>status</code></br>
  20876. <em>
  20877. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  20878. Kubernetes core/v1.ConditionStatus
  20879. </a>
  20880. </em>
  20881. </td>
  20882. <td>
  20883. </td>
  20884. </tr>
  20885. <tr>
  20886. <td>
  20887. <code>reason</code></br>
  20888. <em>
  20889. string
  20890. </em>
  20891. </td>
  20892. <td>
  20893. <em>(Optional)</em>
  20894. </td>
  20895. </tr>
  20896. <tr>
  20897. <td>
  20898. <code>message</code></br>
  20899. <em>
  20900. string
  20901. </em>
  20902. </td>
  20903. <td>
  20904. <em>(Optional)</em>
  20905. </td>
  20906. </tr>
  20907. <tr>
  20908. <td>
  20909. <code>lastTransitionTime</code></br>
  20910. <em>
  20911. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  20912. Kubernetes meta/v1.Time
  20913. </a>
  20914. </em>
  20915. </td>
  20916. <td>
  20917. <em>(Optional)</em>
  20918. </td>
  20919. </tr>
  20920. </tbody>
  20921. </table>
  20922. <h3 id="external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget
  20923. </h3>
  20924. <p>
  20925. (<em>Appears on:</em>
  20926. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20927. </p>
  20928. <p>
  20929. <p>ExternalSecretTarget defines the Kubernetes Secret to be created
  20930. There can be only one target per ExternalSecret.</p>
  20931. </p>
  20932. <table>
  20933. <thead>
  20934. <tr>
  20935. <th>Field</th>
  20936. <th>Description</th>
  20937. </tr>
  20938. </thead>
  20939. <tbody>
  20940. <tr>
  20941. <td>
  20942. <code>name</code></br>
  20943. <em>
  20944. string
  20945. </em>
  20946. </td>
  20947. <td>
  20948. <em>(Optional)</em>
  20949. <p>The name of the Secret resource to be managed.
  20950. Defaults to the .metadata.name of the ExternalSecret resource</p>
  20951. </td>
  20952. </tr>
  20953. <tr>
  20954. <td>
  20955. <code>creationPolicy</code></br>
  20956. <em>
  20957. <a href="#external-secrets.io/v1beta1.ExternalSecretCreationPolicy">
  20958. ExternalSecretCreationPolicy
  20959. </a>
  20960. </em>
  20961. </td>
  20962. <td>
  20963. <em>(Optional)</em>
  20964. <p>CreationPolicy defines rules on how to create the resulting Secret.
  20965. Defaults to &ldquo;Owner&rdquo;</p>
  20966. </td>
  20967. </tr>
  20968. <tr>
  20969. <td>
  20970. <code>deletionPolicy</code></br>
  20971. <em>
  20972. <a href="#external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">
  20973. ExternalSecretDeletionPolicy
  20974. </a>
  20975. </em>
  20976. </td>
  20977. <td>
  20978. <em>(Optional)</em>
  20979. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  20980. Defaults to &ldquo;Retain&rdquo;</p>
  20981. </td>
  20982. </tr>
  20983. <tr>
  20984. <td>
  20985. <code>template</code></br>
  20986. <em>
  20987. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">
  20988. ExternalSecretTemplate
  20989. </a>
  20990. </em>
  20991. </td>
  20992. <td>
  20993. <em>(Optional)</em>
  20994. <p>Template defines a blueprint for the created Secret resource.</p>
  20995. </td>
  20996. </tr>
  20997. <tr>
  20998. <td>
  20999. <code>immutable</code></br>
  21000. <em>
  21001. bool
  21002. </em>
  21003. </td>
  21004. <td>
  21005. <em>(Optional)</em>
  21006. <p>Immutable defines if the final secret will be immutable</p>
  21007. </td>
  21008. </tr>
  21009. </tbody>
  21010. </table>
  21011. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate
  21012. </h3>
  21013. <p>
  21014. (<em>Appears on:</em>
  21015. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  21016. </p>
  21017. <p>
  21018. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  21019. we can not use native corev1.Secret, it will have empty ObjectMeta values: <a href="https://github.com/kubernetes-sigs/controller-tools/issues/448">https://github.com/kubernetes-sigs/controller-tools/issues/448</a></p>
  21020. </p>
  21021. <table>
  21022. <thead>
  21023. <tr>
  21024. <th>Field</th>
  21025. <th>Description</th>
  21026. </tr>
  21027. </thead>
  21028. <tbody>
  21029. <tr>
  21030. <td>
  21031. <code>type</code></br>
  21032. <em>
  21033. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  21034. Kubernetes core/v1.SecretType
  21035. </a>
  21036. </em>
  21037. </td>
  21038. <td>
  21039. <em>(Optional)</em>
  21040. </td>
  21041. </tr>
  21042. <tr>
  21043. <td>
  21044. <code>engineVersion</code></br>
  21045. <em>
  21046. <a href="#external-secrets.io/v1beta1.TemplateEngineVersion">
  21047. TemplateEngineVersion
  21048. </a>
  21049. </em>
  21050. </td>
  21051. <td>
  21052. <p>EngineVersion specifies the template engine version
  21053. that should be used to compile/execute the
  21054. template specified in .data and .templateFrom[].</p>
  21055. </td>
  21056. </tr>
  21057. <tr>
  21058. <td>
  21059. <code>metadata</code></br>
  21060. <em>
  21061. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">
  21062. ExternalSecretTemplateMetadata
  21063. </a>
  21064. </em>
  21065. </td>
  21066. <td>
  21067. <em>(Optional)</em>
  21068. </td>
  21069. </tr>
  21070. <tr>
  21071. <td>
  21072. <code>mergePolicy</code></br>
  21073. <em>
  21074. <a href="#external-secrets.io/v1beta1.TemplateMergePolicy">
  21075. TemplateMergePolicy
  21076. </a>
  21077. </em>
  21078. </td>
  21079. <td>
  21080. </td>
  21081. </tr>
  21082. <tr>
  21083. <td>
  21084. <code>data</code></br>
  21085. <em>
  21086. map[string]string
  21087. </em>
  21088. </td>
  21089. <td>
  21090. <em>(Optional)</em>
  21091. </td>
  21092. </tr>
  21093. <tr>
  21094. <td>
  21095. <code>templateFrom</code></br>
  21096. <em>
  21097. <a href="#external-secrets.io/v1beta1.TemplateFrom">
  21098. []TemplateFrom
  21099. </a>
  21100. </em>
  21101. </td>
  21102. <td>
  21103. <em>(Optional)</em>
  21104. </td>
  21105. </tr>
  21106. </tbody>
  21107. </table>
  21108. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  21109. </h3>
  21110. <p>
  21111. (<em>Appears on:</em>
  21112. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  21113. </p>
  21114. <p>
  21115. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  21116. </p>
  21117. <table>
  21118. <thead>
  21119. <tr>
  21120. <th>Field</th>
  21121. <th>Description</th>
  21122. </tr>
  21123. </thead>
  21124. <tbody>
  21125. <tr>
  21126. <td>
  21127. <code>annotations</code></br>
  21128. <em>
  21129. map[string]string
  21130. </em>
  21131. </td>
  21132. <td>
  21133. <em>(Optional)</em>
  21134. </td>
  21135. </tr>
  21136. <tr>
  21137. <td>
  21138. <code>labels</code></br>
  21139. <em>
  21140. map[string]string
  21141. </em>
  21142. </td>
  21143. <td>
  21144. <em>(Optional)</em>
  21145. </td>
  21146. </tr>
  21147. </tbody>
  21148. </table>
  21149. <h3 id="external-secrets.io/v1beta1.ExternalSecretValidator">ExternalSecretValidator
  21150. </h3>
  21151. <p>
  21152. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  21153. </p>
  21154. <h3 id="external-secrets.io/v1beta1.FakeProvider">FakeProvider
  21155. </h3>
  21156. <p>
  21157. (<em>Appears on:</em>
  21158. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21159. </p>
  21160. <p>
  21161. <p>FakeProvider configures a fake provider that returns static values.</p>
  21162. </p>
  21163. <table>
  21164. <thead>
  21165. <tr>
  21166. <th>Field</th>
  21167. <th>Description</th>
  21168. </tr>
  21169. </thead>
  21170. <tbody>
  21171. <tr>
  21172. <td>
  21173. <code>data</code></br>
  21174. <em>
  21175. <a href="#external-secrets.io/v1beta1.FakeProviderData">
  21176. []FakeProviderData
  21177. </a>
  21178. </em>
  21179. </td>
  21180. <td>
  21181. </td>
  21182. </tr>
  21183. </tbody>
  21184. </table>
  21185. <h3 id="external-secrets.io/v1beta1.FakeProviderData">FakeProviderData
  21186. </h3>
  21187. <p>
  21188. (<em>Appears on:</em>
  21189. <a href="#external-secrets.io/v1beta1.FakeProvider">FakeProvider</a>)
  21190. </p>
  21191. <p>
  21192. <p>FakeProviderData defines a key-value pair for the fake provider used in testing.</p>
  21193. </p>
  21194. <table>
  21195. <thead>
  21196. <tr>
  21197. <th>Field</th>
  21198. <th>Description</th>
  21199. </tr>
  21200. </thead>
  21201. <tbody>
  21202. <tr>
  21203. <td>
  21204. <code>key</code></br>
  21205. <em>
  21206. string
  21207. </em>
  21208. </td>
  21209. <td>
  21210. </td>
  21211. </tr>
  21212. <tr>
  21213. <td>
  21214. <code>value</code></br>
  21215. <em>
  21216. string
  21217. </em>
  21218. </td>
  21219. <td>
  21220. </td>
  21221. </tr>
  21222. <tr>
  21223. <td>
  21224. <code>version</code></br>
  21225. <em>
  21226. string
  21227. </em>
  21228. </td>
  21229. <td>
  21230. </td>
  21231. </tr>
  21232. </tbody>
  21233. </table>
  21234. <h3 id="external-secrets.io/v1beta1.FindName">FindName
  21235. </h3>
  21236. <p>
  21237. (<em>Appears on:</em>
  21238. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  21239. </p>
  21240. <p>
  21241. <p>FindName defines name matching criteria for finding secrets.</p>
  21242. </p>
  21243. <table>
  21244. <thead>
  21245. <tr>
  21246. <th>Field</th>
  21247. <th>Description</th>
  21248. </tr>
  21249. </thead>
  21250. <tbody>
  21251. <tr>
  21252. <td>
  21253. <code>regexp</code></br>
  21254. <em>
  21255. string
  21256. </em>
  21257. </td>
  21258. <td>
  21259. <em>(Optional)</em>
  21260. <p>Finds secrets base</p>
  21261. </td>
  21262. </tr>
  21263. </tbody>
  21264. </table>
  21265. <h3 id="external-secrets.io/v1beta1.FortanixProvider">FortanixProvider
  21266. </h3>
  21267. <p>
  21268. (<em>Appears on:</em>
  21269. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21270. </p>
  21271. <p>
  21272. <p>FortanixProvider configures a store to sync secrets using the Fortanix SDKMS provider.</p>
  21273. </p>
  21274. <table>
  21275. <thead>
  21276. <tr>
  21277. <th>Field</th>
  21278. <th>Description</th>
  21279. </tr>
  21280. </thead>
  21281. <tbody>
  21282. <tr>
  21283. <td>
  21284. <code>apiUrl</code></br>
  21285. <em>
  21286. string
  21287. </em>
  21288. </td>
  21289. <td>
  21290. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  21291. </td>
  21292. </tr>
  21293. <tr>
  21294. <td>
  21295. <code>apiKey</code></br>
  21296. <em>
  21297. <a href="#external-secrets.io/v1beta1.FortanixProviderSecretRef">
  21298. FortanixProviderSecretRef
  21299. </a>
  21300. </em>
  21301. </td>
  21302. <td>
  21303. <p>APIKey is the API token to access SDKMS Applications.</p>
  21304. </td>
  21305. </tr>
  21306. </tbody>
  21307. </table>
  21308. <h3 id="external-secrets.io/v1beta1.FortanixProviderSecretRef">FortanixProviderSecretRef
  21309. </h3>
  21310. <p>
  21311. (<em>Appears on:</em>
  21312. <a href="#external-secrets.io/v1beta1.FortanixProvider">FortanixProvider</a>)
  21313. </p>
  21314. <p>
  21315. <p>FortanixProviderSecretRef defines a reference to a secret containing credentials for the Fortanix provider.</p>
  21316. </p>
  21317. <table>
  21318. <thead>
  21319. <tr>
  21320. <th>Field</th>
  21321. <th>Description</th>
  21322. </tr>
  21323. </thead>
  21324. <tbody>
  21325. <tr>
  21326. <td>
  21327. <code>secretRef</code></br>
  21328. <em>
  21329. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21330. External Secrets meta/v1.SecretKeySelector
  21331. </a>
  21332. </em>
  21333. </td>
  21334. <td>
  21335. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  21336. </td>
  21337. </tr>
  21338. </tbody>
  21339. </table>
  21340. <h3 id="external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth
  21341. </h3>
  21342. <p>
  21343. (<em>Appears on:</em>
  21344. <a href="#external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider</a>)
  21345. </p>
  21346. <p>
  21347. <p>GCPSMAuth defines the authentication methods for the GCP Secret Manager provider.</p>
  21348. </p>
  21349. <table>
  21350. <thead>
  21351. <tr>
  21352. <th>Field</th>
  21353. <th>Description</th>
  21354. </tr>
  21355. </thead>
  21356. <tbody>
  21357. <tr>
  21358. <td>
  21359. <code>secretRef</code></br>
  21360. <em>
  21361. <a href="#external-secrets.io/v1beta1.GCPSMAuthSecretRef">
  21362. GCPSMAuthSecretRef
  21363. </a>
  21364. </em>
  21365. </td>
  21366. <td>
  21367. <em>(Optional)</em>
  21368. </td>
  21369. </tr>
  21370. <tr>
  21371. <td>
  21372. <code>workloadIdentity</code></br>
  21373. <em>
  21374. <a href="#external-secrets.io/v1beta1.GCPWorkloadIdentity">
  21375. GCPWorkloadIdentity
  21376. </a>
  21377. </em>
  21378. </td>
  21379. <td>
  21380. <em>(Optional)</em>
  21381. </td>
  21382. </tr>
  21383. </tbody>
  21384. </table>
  21385. <h3 id="external-secrets.io/v1beta1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  21386. </h3>
  21387. <p>
  21388. (<em>Appears on:</em>
  21389. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  21390. </p>
  21391. <p>
  21392. <p>GCPSMAuthSecretRef defines a reference to a secret containing credentials for the GCP Secret Manager provider.</p>
  21393. </p>
  21394. <table>
  21395. <thead>
  21396. <tr>
  21397. <th>Field</th>
  21398. <th>Description</th>
  21399. </tr>
  21400. </thead>
  21401. <tbody>
  21402. <tr>
  21403. <td>
  21404. <code>secretAccessKeySecretRef</code></br>
  21405. <em>
  21406. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21407. External Secrets meta/v1.SecretKeySelector
  21408. </a>
  21409. </em>
  21410. </td>
  21411. <td>
  21412. <em>(Optional)</em>
  21413. <p>The SecretAccessKey is used for authentication</p>
  21414. </td>
  21415. </tr>
  21416. </tbody>
  21417. </table>
  21418. <h3 id="external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider
  21419. </h3>
  21420. <p>
  21421. (<em>Appears on:</em>
  21422. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21423. </p>
  21424. <p>
  21425. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  21426. </p>
  21427. <table>
  21428. <thead>
  21429. <tr>
  21430. <th>Field</th>
  21431. <th>Description</th>
  21432. </tr>
  21433. </thead>
  21434. <tbody>
  21435. <tr>
  21436. <td>
  21437. <code>auth</code></br>
  21438. <em>
  21439. <a href="#external-secrets.io/v1beta1.GCPSMAuth">
  21440. GCPSMAuth
  21441. </a>
  21442. </em>
  21443. </td>
  21444. <td>
  21445. <em>(Optional)</em>
  21446. <p>Auth defines the information necessary to authenticate against GCP</p>
  21447. </td>
  21448. </tr>
  21449. <tr>
  21450. <td>
  21451. <code>projectID</code></br>
  21452. <em>
  21453. string
  21454. </em>
  21455. </td>
  21456. <td>
  21457. <p>ProjectID project where secret is located</p>
  21458. </td>
  21459. </tr>
  21460. <tr>
  21461. <td>
  21462. <code>location</code></br>
  21463. <em>
  21464. string
  21465. </em>
  21466. </td>
  21467. <td>
  21468. <p>Location optionally defines a location for a secret</p>
  21469. </td>
  21470. </tr>
  21471. </tbody>
  21472. </table>
  21473. <h3 id="external-secrets.io/v1beta1.GCPWorkloadIdentity">GCPWorkloadIdentity
  21474. </h3>
  21475. <p>
  21476. (<em>Appears on:</em>
  21477. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  21478. </p>
  21479. <p>
  21480. <p>GCPWorkloadIdentity defines configuration for using GCP Workload Identity authentication.</p>
  21481. </p>
  21482. <table>
  21483. <thead>
  21484. <tr>
  21485. <th>Field</th>
  21486. <th>Description</th>
  21487. </tr>
  21488. </thead>
  21489. <tbody>
  21490. <tr>
  21491. <td>
  21492. <code>serviceAccountRef</code></br>
  21493. <em>
  21494. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  21495. External Secrets meta/v1.ServiceAccountSelector
  21496. </a>
  21497. </em>
  21498. </td>
  21499. <td>
  21500. </td>
  21501. </tr>
  21502. <tr>
  21503. <td>
  21504. <code>clusterLocation</code></br>
  21505. <em>
  21506. string
  21507. </em>
  21508. </td>
  21509. <td>
  21510. <em>(Optional)</em>
  21511. <p>ClusterLocation is the location of the cluster
  21512. If not specified, it fetches information from the metadata server</p>
  21513. </td>
  21514. </tr>
  21515. <tr>
  21516. <td>
  21517. <code>clusterName</code></br>
  21518. <em>
  21519. string
  21520. </em>
  21521. </td>
  21522. <td>
  21523. <em>(Optional)</em>
  21524. <p>ClusterName is the name of the cluster
  21525. If not specified, it fetches information from the metadata server</p>
  21526. </td>
  21527. </tr>
  21528. <tr>
  21529. <td>
  21530. <code>clusterProjectID</code></br>
  21531. <em>
  21532. string
  21533. </em>
  21534. </td>
  21535. <td>
  21536. <em>(Optional)</em>
  21537. <p>ClusterProjectID is the project ID of the cluster
  21538. If not specified, it fetches information from the metadata server</p>
  21539. </td>
  21540. </tr>
  21541. </tbody>
  21542. </table>
  21543. <h3 id="external-secrets.io/v1beta1.GeneratorRef">GeneratorRef
  21544. </h3>
  21545. <p>
  21546. (<em>Appears on:</em>
  21547. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  21548. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  21549. </p>
  21550. <p>
  21551. <p>GeneratorRef points to a generator custom resource.</p>
  21552. </p>
  21553. <table>
  21554. <thead>
  21555. <tr>
  21556. <th>Field</th>
  21557. <th>Description</th>
  21558. </tr>
  21559. </thead>
  21560. <tbody>
  21561. <tr>
  21562. <td>
  21563. <code>apiVersion</code></br>
  21564. <em>
  21565. string
  21566. </em>
  21567. </td>
  21568. <td>
  21569. <p>Specify the apiVersion of the generator resource</p>
  21570. </td>
  21571. </tr>
  21572. <tr>
  21573. <td>
  21574. <code>kind</code></br>
  21575. <em>
  21576. string
  21577. </em>
  21578. </td>
  21579. <td>
  21580. <p>Specify the Kind of the generator resource</p>
  21581. </td>
  21582. </tr>
  21583. <tr>
  21584. <td>
  21585. <code>name</code></br>
  21586. <em>
  21587. string
  21588. </em>
  21589. </td>
  21590. <td>
  21591. <p>Specify the name of the generator resource</p>
  21592. </td>
  21593. </tr>
  21594. </tbody>
  21595. </table>
  21596. <h3 id="external-secrets.io/v1beta1.GenericClusterStoreValidator">GenericClusterStoreValidator
  21597. </h3>
  21598. <p>
  21599. <p>GenericClusterStoreValidator provides validation for ClusterSecretStore resources.</p>
  21600. </p>
  21601. <h3 id="external-secrets.io/v1beta1.GenericStore">GenericStore
  21602. </h3>
  21603. <p>
  21604. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  21605. or a namespaced SecretStore.</p>
  21606. </p>
  21607. <h3 id="external-secrets.io/v1beta1.GenericStoreValidator">GenericStoreValidator
  21608. </h3>
  21609. <p>
  21610. <p>GenericStoreValidator provides validation for SecretStore resources.</p>
  21611. </p>
  21612. <h3 id="external-secrets.io/v1beta1.GithubAppAuth">GithubAppAuth
  21613. </h3>
  21614. <p>
  21615. (<em>Appears on:</em>
  21616. <a href="#external-secrets.io/v1beta1.GithubProvider">GithubProvider</a>)
  21617. </p>
  21618. <p>
  21619. <p>GithubAppAuth defines the GitHub App authentication mechanism for the GitHub provider.</p>
  21620. </p>
  21621. <table>
  21622. <thead>
  21623. <tr>
  21624. <th>Field</th>
  21625. <th>Description</th>
  21626. </tr>
  21627. </thead>
  21628. <tbody>
  21629. <tr>
  21630. <td>
  21631. <code>privateKey</code></br>
  21632. <em>
  21633. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21634. External Secrets meta/v1.SecretKeySelector
  21635. </a>
  21636. </em>
  21637. </td>
  21638. <td>
  21639. </td>
  21640. </tr>
  21641. </tbody>
  21642. </table>
  21643. <h3 id="external-secrets.io/v1beta1.GithubProvider">GithubProvider
  21644. </h3>
  21645. <p>
  21646. (<em>Appears on:</em>
  21647. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21648. </p>
  21649. <p>
  21650. <p>GithubProvider configures a store to push secrets to Github Actions.</p>
  21651. </p>
  21652. <table>
  21653. <thead>
  21654. <tr>
  21655. <th>Field</th>
  21656. <th>Description</th>
  21657. </tr>
  21658. </thead>
  21659. <tbody>
  21660. <tr>
  21661. <td>
  21662. <code>url</code></br>
  21663. <em>
  21664. string
  21665. </em>
  21666. </td>
  21667. <td>
  21668. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  21669. </td>
  21670. </tr>
  21671. <tr>
  21672. <td>
  21673. <code>uploadURL</code></br>
  21674. <em>
  21675. string
  21676. </em>
  21677. </td>
  21678. <td>
  21679. <em>(Optional)</em>
  21680. <p>Upload URL for enterprise instances. Default to URL.</p>
  21681. </td>
  21682. </tr>
  21683. <tr>
  21684. <td>
  21685. <code>auth</code></br>
  21686. <em>
  21687. <a href="#external-secrets.io/v1beta1.GithubAppAuth">
  21688. GithubAppAuth
  21689. </a>
  21690. </em>
  21691. </td>
  21692. <td>
  21693. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  21694. </td>
  21695. </tr>
  21696. <tr>
  21697. <td>
  21698. <code>appID</code></br>
  21699. <em>
  21700. int64
  21701. </em>
  21702. </td>
  21703. <td>
  21704. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  21705. </td>
  21706. </tr>
  21707. <tr>
  21708. <td>
  21709. <code>installationID</code></br>
  21710. <em>
  21711. int64
  21712. </em>
  21713. </td>
  21714. <td>
  21715. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  21716. </td>
  21717. </tr>
  21718. <tr>
  21719. <td>
  21720. <code>organization</code></br>
  21721. <em>
  21722. string
  21723. </em>
  21724. </td>
  21725. <td>
  21726. <p>organization will be used to fetch secrets from the Github organization</p>
  21727. </td>
  21728. </tr>
  21729. <tr>
  21730. <td>
  21731. <code>repository</code></br>
  21732. <em>
  21733. string
  21734. </em>
  21735. </td>
  21736. <td>
  21737. <em>(Optional)</em>
  21738. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  21739. </td>
  21740. </tr>
  21741. <tr>
  21742. <td>
  21743. <code>environment</code></br>
  21744. <em>
  21745. string
  21746. </em>
  21747. </td>
  21748. <td>
  21749. <em>(Optional)</em>
  21750. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  21751. </td>
  21752. </tr>
  21753. </tbody>
  21754. </table>
  21755. <h3 id="external-secrets.io/v1beta1.GitlabAuth">GitlabAuth
  21756. </h3>
  21757. <p>
  21758. (<em>Appears on:</em>
  21759. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>)
  21760. </p>
  21761. <p>
  21762. <p>GitlabAuth defines the authentication method for the GitLab provider.</p>
  21763. </p>
  21764. <table>
  21765. <thead>
  21766. <tr>
  21767. <th>Field</th>
  21768. <th>Description</th>
  21769. </tr>
  21770. </thead>
  21771. <tbody>
  21772. <tr>
  21773. <td>
  21774. <code>SecretRef</code></br>
  21775. <em>
  21776. <a href="#external-secrets.io/v1beta1.GitlabSecretRef">
  21777. GitlabSecretRef
  21778. </a>
  21779. </em>
  21780. </td>
  21781. <td>
  21782. </td>
  21783. </tr>
  21784. </tbody>
  21785. </table>
  21786. <h3 id="external-secrets.io/v1beta1.GitlabProvider">GitlabProvider
  21787. </h3>
  21788. <p>
  21789. (<em>Appears on:</em>
  21790. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21791. </p>
  21792. <p>
  21793. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  21794. </p>
  21795. <table>
  21796. <thead>
  21797. <tr>
  21798. <th>Field</th>
  21799. <th>Description</th>
  21800. </tr>
  21801. </thead>
  21802. <tbody>
  21803. <tr>
  21804. <td>
  21805. <code>url</code></br>
  21806. <em>
  21807. string
  21808. </em>
  21809. </td>
  21810. <td>
  21811. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  21812. </td>
  21813. </tr>
  21814. <tr>
  21815. <td>
  21816. <code>auth</code></br>
  21817. <em>
  21818. <a href="#external-secrets.io/v1beta1.GitlabAuth">
  21819. GitlabAuth
  21820. </a>
  21821. </em>
  21822. </td>
  21823. <td>
  21824. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  21825. </td>
  21826. </tr>
  21827. <tr>
  21828. <td>
  21829. <code>projectID</code></br>
  21830. <em>
  21831. string
  21832. </em>
  21833. </td>
  21834. <td>
  21835. <p>ProjectID specifies a project where secrets are located.</p>
  21836. </td>
  21837. </tr>
  21838. <tr>
  21839. <td>
  21840. <code>inheritFromGroups</code></br>
  21841. <em>
  21842. bool
  21843. </em>
  21844. </td>
  21845. <td>
  21846. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  21847. </td>
  21848. </tr>
  21849. <tr>
  21850. <td>
  21851. <code>groupIDs</code></br>
  21852. <em>
  21853. []string
  21854. </em>
  21855. </td>
  21856. <td>
  21857. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  21858. </td>
  21859. </tr>
  21860. <tr>
  21861. <td>
  21862. <code>environment</code></br>
  21863. <em>
  21864. string
  21865. </em>
  21866. </td>
  21867. <td>
  21868. <p>Environment environment_scope of gitlab CI/CD variables (Please see <a href="https://docs.gitlab.com/ee/ci/environments/#create-a-static-environment">https://docs.gitlab.com/ee/ci/environments/#create-a-static-environment</a> on how to create environments)</p>
  21869. </td>
  21870. </tr>
  21871. <tr>
  21872. <td>
  21873. <code>caBundle</code></br>
  21874. <em>
  21875. []byte
  21876. </em>
  21877. </td>
  21878. <td>
  21879. <em>(Optional)</em>
  21880. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  21881. can be performed.</p>
  21882. </td>
  21883. </tr>
  21884. <tr>
  21885. <td>
  21886. <code>caProvider</code></br>
  21887. <em>
  21888. <a href="#external-secrets.io/v1beta1.CAProvider">
  21889. CAProvider
  21890. </a>
  21891. </em>
  21892. </td>
  21893. <td>
  21894. <em>(Optional)</em>
  21895. <p>see: <a href="https://external-secrets.io/latest/spec/#external-secrets.io/v1alpha1.CAProvider">https://external-secrets.io/latest/spec/#external-secrets.io/v1alpha1.CAProvider</a></p>
  21896. </td>
  21897. </tr>
  21898. </tbody>
  21899. </table>
  21900. <h3 id="external-secrets.io/v1beta1.GitlabSecretRef">GitlabSecretRef
  21901. </h3>
  21902. <p>
  21903. (<em>Appears on:</em>
  21904. <a href="#external-secrets.io/v1beta1.GitlabAuth">GitlabAuth</a>)
  21905. </p>
  21906. <p>
  21907. <p>GitlabSecretRef defines a reference to a secret containing credentials for the GitLab provider.</p>
  21908. </p>
  21909. <table>
  21910. <thead>
  21911. <tr>
  21912. <th>Field</th>
  21913. <th>Description</th>
  21914. </tr>
  21915. </thead>
  21916. <tbody>
  21917. <tr>
  21918. <td>
  21919. <code>accessToken</code></br>
  21920. <em>
  21921. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21922. External Secrets meta/v1.SecretKeySelector
  21923. </a>
  21924. </em>
  21925. </td>
  21926. <td>
  21927. <p>AccessToken is used for authentication.</p>
  21928. </td>
  21929. </tr>
  21930. </tbody>
  21931. </table>
  21932. <h3 id="external-secrets.io/v1beta1.IBMAuth">IBMAuth
  21933. </h3>
  21934. <p>
  21935. (<em>Appears on:</em>
  21936. <a href="#external-secrets.io/v1beta1.IBMProvider">IBMProvider</a>)
  21937. </p>
  21938. <p>
  21939. <p>IBMAuth defines the authentication methods for the IBM Cloud Secrets Manager provider.</p>
  21940. </p>
  21941. <table>
  21942. <thead>
  21943. <tr>
  21944. <th>Field</th>
  21945. <th>Description</th>
  21946. </tr>
  21947. </thead>
  21948. <tbody>
  21949. <tr>
  21950. <td>
  21951. <code>secretRef</code></br>
  21952. <em>
  21953. <a href="#external-secrets.io/v1beta1.IBMAuthSecretRef">
  21954. IBMAuthSecretRef
  21955. </a>
  21956. </em>
  21957. </td>
  21958. <td>
  21959. </td>
  21960. </tr>
  21961. <tr>
  21962. <td>
  21963. <code>containerAuth</code></br>
  21964. <em>
  21965. <a href="#external-secrets.io/v1beta1.IBMAuthContainerAuth">
  21966. IBMAuthContainerAuth
  21967. </a>
  21968. </em>
  21969. </td>
  21970. <td>
  21971. </td>
  21972. </tr>
  21973. </tbody>
  21974. </table>
  21975. <h3 id="external-secrets.io/v1beta1.IBMAuthContainerAuth">IBMAuthContainerAuth
  21976. </h3>
  21977. <p>
  21978. (<em>Appears on:</em>
  21979. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  21980. </p>
  21981. <p>
  21982. <p>IBMAuthContainerAuth defines authentication using IBM Container-based auth with IAM Trusted Profile.</p>
  21983. </p>
  21984. <table>
  21985. <thead>
  21986. <tr>
  21987. <th>Field</th>
  21988. <th>Description</th>
  21989. </tr>
  21990. </thead>
  21991. <tbody>
  21992. <tr>
  21993. <td>
  21994. <code>profile</code></br>
  21995. <em>
  21996. string
  21997. </em>
  21998. </td>
  21999. <td>
  22000. <p>the IBM Trusted Profile</p>
  22001. </td>
  22002. </tr>
  22003. <tr>
  22004. <td>
  22005. <code>tokenLocation</code></br>
  22006. <em>
  22007. string
  22008. </em>
  22009. </td>
  22010. <td>
  22011. <p>Location the token is mounted on the pod</p>
  22012. </td>
  22013. </tr>
  22014. <tr>
  22015. <td>
  22016. <code>iamEndpoint</code></br>
  22017. <em>
  22018. string
  22019. </em>
  22020. </td>
  22021. <td>
  22022. </td>
  22023. </tr>
  22024. </tbody>
  22025. </table>
  22026. <h3 id="external-secrets.io/v1beta1.IBMAuthSecretRef">IBMAuthSecretRef
  22027. </h3>
  22028. <p>
  22029. (<em>Appears on:</em>
  22030. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  22031. </p>
  22032. <p>
  22033. <p>IBMAuthSecretRef defines a reference to a secret containing credentials for the IBM provider.</p>
  22034. </p>
  22035. <table>
  22036. <thead>
  22037. <tr>
  22038. <th>Field</th>
  22039. <th>Description</th>
  22040. </tr>
  22041. </thead>
  22042. <tbody>
  22043. <tr>
  22044. <td>
  22045. <code>secretApiKeySecretRef</code></br>
  22046. <em>
  22047. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22048. External Secrets meta/v1.SecretKeySelector
  22049. </a>
  22050. </em>
  22051. </td>
  22052. <td>
  22053. <p>The SecretAccessKey is used for authentication</p>
  22054. </td>
  22055. </tr>
  22056. </tbody>
  22057. </table>
  22058. <h3 id="external-secrets.io/v1beta1.IBMProvider">IBMProvider
  22059. </h3>
  22060. <p>
  22061. (<em>Appears on:</em>
  22062. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22063. </p>
  22064. <p>
  22065. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager backend.</p>
  22066. </p>
  22067. <table>
  22068. <thead>
  22069. <tr>
  22070. <th>Field</th>
  22071. <th>Description</th>
  22072. </tr>
  22073. </thead>
  22074. <tbody>
  22075. <tr>
  22076. <td>
  22077. <code>auth</code></br>
  22078. <em>
  22079. <a href="#external-secrets.io/v1beta1.IBMAuth">
  22080. IBMAuth
  22081. </a>
  22082. </em>
  22083. </td>
  22084. <td>
  22085. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  22086. </td>
  22087. </tr>
  22088. <tr>
  22089. <td>
  22090. <code>serviceUrl</code></br>
  22091. <em>
  22092. string
  22093. </em>
  22094. </td>
  22095. <td>
  22096. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  22097. </td>
  22098. </tr>
  22099. </tbody>
  22100. </table>
  22101. <h3 id="external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth
  22102. </h3>
  22103. <p>
  22104. (<em>Appears on:</em>
  22105. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  22106. </p>
  22107. <p>
  22108. <p>InfisicalAuth defines the authentication methods for the Infisical provider.</p>
  22109. </p>
  22110. <table>
  22111. <thead>
  22112. <tr>
  22113. <th>Field</th>
  22114. <th>Description</th>
  22115. </tr>
  22116. </thead>
  22117. <tbody>
  22118. <tr>
  22119. <td>
  22120. <code>universalAuthCredentials</code></br>
  22121. <em>
  22122. <a href="#external-secrets.io/v1beta1.UniversalAuthCredentials">
  22123. UniversalAuthCredentials
  22124. </a>
  22125. </em>
  22126. </td>
  22127. <td>
  22128. <em>(Optional)</em>
  22129. </td>
  22130. </tr>
  22131. </tbody>
  22132. </table>
  22133. <h3 id="external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider
  22134. </h3>
  22135. <p>
  22136. (<em>Appears on:</em>
  22137. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22138. </p>
  22139. <p>
  22140. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  22141. </p>
  22142. <table>
  22143. <thead>
  22144. <tr>
  22145. <th>Field</th>
  22146. <th>Description</th>
  22147. </tr>
  22148. </thead>
  22149. <tbody>
  22150. <tr>
  22151. <td>
  22152. <code>auth</code></br>
  22153. <em>
  22154. <a href="#external-secrets.io/v1beta1.InfisicalAuth">
  22155. InfisicalAuth
  22156. </a>
  22157. </em>
  22158. </td>
  22159. <td>
  22160. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  22161. </td>
  22162. </tr>
  22163. <tr>
  22164. <td>
  22165. <code>secretsScope</code></br>
  22166. <em>
  22167. <a href="#external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">
  22168. MachineIdentityScopeInWorkspace
  22169. </a>
  22170. </em>
  22171. </td>
  22172. <td>
  22173. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  22174. </td>
  22175. </tr>
  22176. <tr>
  22177. <td>
  22178. <code>hostAPI</code></br>
  22179. <em>
  22180. string
  22181. </em>
  22182. </td>
  22183. <td>
  22184. <em>(Optional)</em>
  22185. <p>HostAPI specifies the base URL of the Infisical API. If not provided, it defaults to &ldquo;<a href="https://app.infisical.com/api&quot;">https://app.infisical.com/api&rdquo;</a>.</p>
  22186. </td>
  22187. </tr>
  22188. </tbody>
  22189. </table>
  22190. <h3 id="external-secrets.io/v1beta1.KeeperSecurityProvider">KeeperSecurityProvider
  22191. </h3>
  22192. <p>
  22193. (<em>Appears on:</em>
  22194. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22195. </p>
  22196. <p>
  22197. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  22198. </p>
  22199. <table>
  22200. <thead>
  22201. <tr>
  22202. <th>Field</th>
  22203. <th>Description</th>
  22204. </tr>
  22205. </thead>
  22206. <tbody>
  22207. <tr>
  22208. <td>
  22209. <code>authRef</code></br>
  22210. <em>
  22211. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22212. External Secrets meta/v1.SecretKeySelector
  22213. </a>
  22214. </em>
  22215. </td>
  22216. <td>
  22217. </td>
  22218. </tr>
  22219. <tr>
  22220. <td>
  22221. <code>folderID</code></br>
  22222. <em>
  22223. string
  22224. </em>
  22225. </td>
  22226. <td>
  22227. </td>
  22228. </tr>
  22229. </tbody>
  22230. </table>
  22231. <h3 id="external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth
  22232. </h3>
  22233. <p>
  22234. (<em>Appears on:</em>
  22235. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  22236. </p>
  22237. <p>
  22238. <p>KubernetesAuth defines authentication methods for the Kubernetes provider.</p>
  22239. </p>
  22240. <table>
  22241. <thead>
  22242. <tr>
  22243. <th>Field</th>
  22244. <th>Description</th>
  22245. </tr>
  22246. </thead>
  22247. <tbody>
  22248. <tr>
  22249. <td>
  22250. <code>cert</code></br>
  22251. <em>
  22252. <a href="#external-secrets.io/v1beta1.CertAuth">
  22253. CertAuth
  22254. </a>
  22255. </em>
  22256. </td>
  22257. <td>
  22258. <em>(Optional)</em>
  22259. <p>has both clientCert and clientKey as secretKeySelector</p>
  22260. </td>
  22261. </tr>
  22262. <tr>
  22263. <td>
  22264. <code>token</code></br>
  22265. <em>
  22266. <a href="#external-secrets.io/v1beta1.TokenAuth">
  22267. TokenAuth
  22268. </a>
  22269. </em>
  22270. </td>
  22271. <td>
  22272. <em>(Optional)</em>
  22273. <p>use static token to authenticate with</p>
  22274. </td>
  22275. </tr>
  22276. <tr>
  22277. <td>
  22278. <code>serviceAccount</code></br>
  22279. <em>
  22280. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  22281. External Secrets meta/v1.ServiceAccountSelector
  22282. </a>
  22283. </em>
  22284. </td>
  22285. <td>
  22286. <em>(Optional)</em>
  22287. <p>points to a service account that should be used for authentication</p>
  22288. </td>
  22289. </tr>
  22290. </tbody>
  22291. </table>
  22292. <h3 id="external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider
  22293. </h3>
  22294. <p>
  22295. (<em>Appears on:</em>
  22296. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22297. </p>
  22298. <p>
  22299. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  22300. </p>
  22301. <table>
  22302. <thead>
  22303. <tr>
  22304. <th>Field</th>
  22305. <th>Description</th>
  22306. </tr>
  22307. </thead>
  22308. <tbody>
  22309. <tr>
  22310. <td>
  22311. <code>server</code></br>
  22312. <em>
  22313. <a href="#external-secrets.io/v1beta1.KubernetesServer">
  22314. KubernetesServer
  22315. </a>
  22316. </em>
  22317. </td>
  22318. <td>
  22319. <em>(Optional)</em>
  22320. <p>configures the Kubernetes server Address.</p>
  22321. </td>
  22322. </tr>
  22323. <tr>
  22324. <td>
  22325. <code>auth</code></br>
  22326. <em>
  22327. <a href="#external-secrets.io/v1beta1.KubernetesAuth">
  22328. KubernetesAuth
  22329. </a>
  22330. </em>
  22331. </td>
  22332. <td>
  22333. <em>(Optional)</em>
  22334. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  22335. </td>
  22336. </tr>
  22337. <tr>
  22338. <td>
  22339. <code>authRef</code></br>
  22340. <em>
  22341. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22342. External Secrets meta/v1.SecretKeySelector
  22343. </a>
  22344. </em>
  22345. </td>
  22346. <td>
  22347. <em>(Optional)</em>
  22348. <p>A reference to a secret that contains the auth information.</p>
  22349. </td>
  22350. </tr>
  22351. <tr>
  22352. <td>
  22353. <code>remoteNamespace</code></br>
  22354. <em>
  22355. string
  22356. </em>
  22357. </td>
  22358. <td>
  22359. <em>(Optional)</em>
  22360. <p>Remote namespace to fetch the secrets from</p>
  22361. </td>
  22362. </tr>
  22363. </tbody>
  22364. </table>
  22365. <h3 id="external-secrets.io/v1beta1.KubernetesServer">KubernetesServer
  22366. </h3>
  22367. <p>
  22368. (<em>Appears on:</em>
  22369. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  22370. </p>
  22371. <p>
  22372. <p>KubernetesServer defines the Kubernetes server connection configuration.</p>
  22373. </p>
  22374. <table>
  22375. <thead>
  22376. <tr>
  22377. <th>Field</th>
  22378. <th>Description</th>
  22379. </tr>
  22380. </thead>
  22381. <tbody>
  22382. <tr>
  22383. <td>
  22384. <code>url</code></br>
  22385. <em>
  22386. string
  22387. </em>
  22388. </td>
  22389. <td>
  22390. <em>(Optional)</em>
  22391. <p>configures the Kubernetes server Address.</p>
  22392. </td>
  22393. </tr>
  22394. <tr>
  22395. <td>
  22396. <code>caBundle</code></br>
  22397. <em>
  22398. []byte
  22399. </em>
  22400. </td>
  22401. <td>
  22402. <em>(Optional)</em>
  22403. <p>CABundle is a base64-encoded CA certificate</p>
  22404. </td>
  22405. </tr>
  22406. <tr>
  22407. <td>
  22408. <code>caProvider</code></br>
  22409. <em>
  22410. <a href="#external-secrets.io/v1beta1.CAProvider">
  22411. CAProvider
  22412. </a>
  22413. </em>
  22414. </td>
  22415. <td>
  22416. <em>(Optional)</em>
  22417. <p>see: <a href="https://external-secrets.io/v0.4.1/spec/#external-secrets.io/v1alpha1.CAProvider">https://external-secrets.io/v0.4.1/spec/#external-secrets.io/v1alpha1.CAProvider</a></p>
  22418. </td>
  22419. </tr>
  22420. </tbody>
  22421. </table>
  22422. <h3 id="external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  22423. </h3>
  22424. <p>
  22425. (<em>Appears on:</em>
  22426. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  22427. </p>
  22428. <p>
  22429. <p>MachineIdentityScopeInWorkspace defines the scope of a machine identity in an Infisical workspace.</p>
  22430. </p>
  22431. <table>
  22432. <thead>
  22433. <tr>
  22434. <th>Field</th>
  22435. <th>Description</th>
  22436. </tr>
  22437. </thead>
  22438. <tbody>
  22439. <tr>
  22440. <td>
  22441. <code>secretsPath</code></br>
  22442. <em>
  22443. string
  22444. </em>
  22445. </td>
  22446. <td>
  22447. <em>(Optional)</em>
  22448. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  22449. </td>
  22450. </tr>
  22451. <tr>
  22452. <td>
  22453. <code>recursive</code></br>
  22454. <em>
  22455. bool
  22456. </em>
  22457. </td>
  22458. <td>
  22459. <em>(Optional)</em>
  22460. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  22461. </td>
  22462. </tr>
  22463. <tr>
  22464. <td>
  22465. <code>environmentSlug</code></br>
  22466. <em>
  22467. string
  22468. </em>
  22469. </td>
  22470. <td>
  22471. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  22472. </td>
  22473. </tr>
  22474. <tr>
  22475. <td>
  22476. <code>projectSlug</code></br>
  22477. <em>
  22478. string
  22479. </em>
  22480. </td>
  22481. <td>
  22482. <p>ProjectSlug is the required slug identifier for the project.</p>
  22483. </td>
  22484. </tr>
  22485. <tr>
  22486. <td>
  22487. <code>expandSecretReferences</code></br>
  22488. <em>
  22489. bool
  22490. </em>
  22491. </td>
  22492. <td>
  22493. <em>(Optional)</em>
  22494. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  22495. </td>
  22496. </tr>
  22497. </tbody>
  22498. </table>
  22499. <h3 id="external-secrets.io/v1beta1.NTLMProtocol">NTLMProtocol
  22500. </h3>
  22501. <p>
  22502. (<em>Appears on:</em>
  22503. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol</a>)
  22504. </p>
  22505. <p>
  22506. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  22507. </p>
  22508. <table>
  22509. <thead>
  22510. <tr>
  22511. <th>Field</th>
  22512. <th>Description</th>
  22513. </tr>
  22514. </thead>
  22515. <tbody>
  22516. <tr>
  22517. <td>
  22518. <code>usernameSecret</code></br>
  22519. <em>
  22520. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22521. External Secrets meta/v1.SecretKeySelector
  22522. </a>
  22523. </em>
  22524. </td>
  22525. <td>
  22526. </td>
  22527. </tr>
  22528. <tr>
  22529. <td>
  22530. <code>passwordSecret</code></br>
  22531. <em>
  22532. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22533. External Secrets meta/v1.SecretKeySelector
  22534. </a>
  22535. </em>
  22536. </td>
  22537. <td>
  22538. </td>
  22539. </tr>
  22540. </tbody>
  22541. </table>
  22542. <h3 id="external-secrets.io/v1beta1.NoSecretError">NoSecretError
  22543. </h3>
  22544. <p>
  22545. <p>NoSecretError shall be returned when a GetSecret can not find the
  22546. desired secret. This is used for deletionPolicy.</p>
  22547. </p>
  22548. <h3 id="external-secrets.io/v1beta1.NotModifiedError">NotModifiedError
  22549. </h3>
  22550. <p>
  22551. <p>NotModifiedError to signal that the webhook received no changes,
  22552. and it should just return without doing anything.</p>
  22553. </p>
  22554. <h3 id="external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  22555. </h3>
  22556. <p>
  22557. (<em>Appears on:</em>
  22558. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider</a>)
  22559. </p>
  22560. <p>
  22561. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  22562. </p>
  22563. <table>
  22564. <thead>
  22565. <tr>
  22566. <th>Field</th>
  22567. <th>Description</th>
  22568. </tr>
  22569. </thead>
  22570. <tbody>
  22571. <tr>
  22572. <td>
  22573. <code>apiKeyRef</code></br>
  22574. <em>
  22575. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22576. External Secrets meta/v1.SecretKeySelector
  22577. </a>
  22578. </em>
  22579. </td>
  22580. <td>
  22581. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  22582. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  22583. </td>
  22584. </tr>
  22585. <tr>
  22586. <td>
  22587. <code>passcodeRef</code></br>
  22588. <em>
  22589. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22590. External Secrets meta/v1.SecretKeySelector
  22591. </a>
  22592. </em>
  22593. </td>
  22594. <td>
  22595. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  22596. </td>
  22597. </tr>
  22598. </tbody>
  22599. </table>
  22600. <h3 id="external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider
  22601. </h3>
  22602. <p>
  22603. (<em>Appears on:</em>
  22604. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22605. </p>
  22606. <p>
  22607. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  22608. Project and Config are required if not using a Service Token.</p>
  22609. </p>
  22610. <table>
  22611. <thead>
  22612. <tr>
  22613. <th>Field</th>
  22614. <th>Description</th>
  22615. </tr>
  22616. </thead>
  22617. <tbody>
  22618. <tr>
  22619. <td>
  22620. <code>auth</code></br>
  22621. <em>
  22622. <a href="#external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">
  22623. OnboardbaseAuthSecretRef
  22624. </a>
  22625. </em>
  22626. </td>
  22627. <td>
  22628. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  22629. </td>
  22630. </tr>
  22631. <tr>
  22632. <td>
  22633. <code>apiHost</code></br>
  22634. <em>
  22635. string
  22636. </em>
  22637. </td>
  22638. <td>
  22639. <p>APIHost use this to configure the host url for the API for selfhosted installation, default is <a href="https://public.onboardbase.com/api/v1/">https://public.onboardbase.com/api/v1/</a></p>
  22640. </td>
  22641. </tr>
  22642. <tr>
  22643. <td>
  22644. <code>project</code></br>
  22645. <em>
  22646. string
  22647. </em>
  22648. </td>
  22649. <td>
  22650. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  22651. </td>
  22652. </tr>
  22653. <tr>
  22654. <td>
  22655. <code>environment</code></br>
  22656. <em>
  22657. string
  22658. </em>
  22659. </td>
  22660. <td>
  22661. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  22662. </td>
  22663. </tr>
  22664. </tbody>
  22665. </table>
  22666. <h3 id="external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth
  22667. </h3>
  22668. <p>
  22669. (<em>Appears on:</em>
  22670. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider</a>)
  22671. </p>
  22672. <p>
  22673. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  22674. </p>
  22675. <table>
  22676. <thead>
  22677. <tr>
  22678. <th>Field</th>
  22679. <th>Description</th>
  22680. </tr>
  22681. </thead>
  22682. <tbody>
  22683. <tr>
  22684. <td>
  22685. <code>secretRef</code></br>
  22686. <em>
  22687. <a href="#external-secrets.io/v1beta1.OnePasswordAuthSecretRef">
  22688. OnePasswordAuthSecretRef
  22689. </a>
  22690. </em>
  22691. </td>
  22692. <td>
  22693. </td>
  22694. </tr>
  22695. </tbody>
  22696. </table>
  22697. <h3 id="external-secrets.io/v1beta1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  22698. </h3>
  22699. <p>
  22700. (<em>Appears on:</em>
  22701. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth</a>)
  22702. </p>
  22703. <p>
  22704. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  22705. </p>
  22706. <table>
  22707. <thead>
  22708. <tr>
  22709. <th>Field</th>
  22710. <th>Description</th>
  22711. </tr>
  22712. </thead>
  22713. <tbody>
  22714. <tr>
  22715. <td>
  22716. <code>connectTokenSecretRef</code></br>
  22717. <em>
  22718. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22719. External Secrets meta/v1.SecretKeySelector
  22720. </a>
  22721. </em>
  22722. </td>
  22723. <td>
  22724. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  22725. </td>
  22726. </tr>
  22727. </tbody>
  22728. </table>
  22729. <h3 id="external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider
  22730. </h3>
  22731. <p>
  22732. (<em>Appears on:</em>
  22733. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22734. </p>
  22735. <p>
  22736. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  22737. </p>
  22738. <table>
  22739. <thead>
  22740. <tr>
  22741. <th>Field</th>
  22742. <th>Description</th>
  22743. </tr>
  22744. </thead>
  22745. <tbody>
  22746. <tr>
  22747. <td>
  22748. <code>auth</code></br>
  22749. <em>
  22750. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">
  22751. OnePasswordAuth
  22752. </a>
  22753. </em>
  22754. </td>
  22755. <td>
  22756. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  22757. </td>
  22758. </tr>
  22759. <tr>
  22760. <td>
  22761. <code>connectHost</code></br>
  22762. <em>
  22763. string
  22764. </em>
  22765. </td>
  22766. <td>
  22767. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  22768. </td>
  22769. </tr>
  22770. <tr>
  22771. <td>
  22772. <code>vaults</code></br>
  22773. <em>
  22774. map[string]int
  22775. </em>
  22776. </td>
  22777. <td>
  22778. <p>Vaults defines which OnePassword vaults to search in which order</p>
  22779. </td>
  22780. </tr>
  22781. </tbody>
  22782. </table>
  22783. <h3 id="external-secrets.io/v1beta1.OracleAuth">OracleAuth
  22784. </h3>
  22785. <p>
  22786. (<em>Appears on:</em>
  22787. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  22788. </p>
  22789. <p>
  22790. <p>OracleAuth defines authentication configuration for the Oracle Vault provider.</p>
  22791. </p>
  22792. <table>
  22793. <thead>
  22794. <tr>
  22795. <th>Field</th>
  22796. <th>Description</th>
  22797. </tr>
  22798. </thead>
  22799. <tbody>
  22800. <tr>
  22801. <td>
  22802. <code>tenancy</code></br>
  22803. <em>
  22804. string
  22805. </em>
  22806. </td>
  22807. <td>
  22808. <p>Tenancy is the tenancy OCID where user is located.</p>
  22809. </td>
  22810. </tr>
  22811. <tr>
  22812. <td>
  22813. <code>user</code></br>
  22814. <em>
  22815. string
  22816. </em>
  22817. </td>
  22818. <td>
  22819. <p>User is an access OCID specific to the account.</p>
  22820. </td>
  22821. </tr>
  22822. <tr>
  22823. <td>
  22824. <code>secretRef</code></br>
  22825. <em>
  22826. <a href="#external-secrets.io/v1beta1.OracleSecretRef">
  22827. OracleSecretRef
  22828. </a>
  22829. </em>
  22830. </td>
  22831. <td>
  22832. <p>SecretRef to pass through sensitive information.</p>
  22833. </td>
  22834. </tr>
  22835. </tbody>
  22836. </table>
  22837. <h3 id="external-secrets.io/v1beta1.OraclePrincipalType">OraclePrincipalType
  22838. (<code>string</code> alias)</p></h3>
  22839. <p>
  22840. (<em>Appears on:</em>
  22841. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  22842. </p>
  22843. <p>
  22844. <p>OraclePrincipalType defines the type of principal used for authentication to Oracle Vault.</p>
  22845. </p>
  22846. <table>
  22847. <thead>
  22848. <tr>
  22849. <th>Value</th>
  22850. <th>Description</th>
  22851. </tr>
  22852. </thead>
  22853. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  22854. <td><p>InstancePrincipal represents a instance principal.</p>
  22855. </td>
  22856. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  22857. <td><p>UserPrincipal represents a user principal.</p>
  22858. </td>
  22859. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  22860. <td><p>WorkloadPrincipal represents a workload principal.</p>
  22861. </td>
  22862. </tr></tbody>
  22863. </table>
  22864. <h3 id="external-secrets.io/v1beta1.OracleProvider">OracleProvider
  22865. </h3>
  22866. <p>
  22867. (<em>Appears on:</em>
  22868. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22869. </p>
  22870. <p>
  22871. <p>OracleProvider configures a store to sync secrets using an Oracle Vault backend.</p>
  22872. </p>
  22873. <table>
  22874. <thead>
  22875. <tr>
  22876. <th>Field</th>
  22877. <th>Description</th>
  22878. </tr>
  22879. </thead>
  22880. <tbody>
  22881. <tr>
  22882. <td>
  22883. <code>region</code></br>
  22884. <em>
  22885. string
  22886. </em>
  22887. </td>
  22888. <td>
  22889. <p>Region is the region where vault is located.</p>
  22890. </td>
  22891. </tr>
  22892. <tr>
  22893. <td>
  22894. <code>vault</code></br>
  22895. <em>
  22896. string
  22897. </em>
  22898. </td>
  22899. <td>
  22900. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  22901. </td>
  22902. </tr>
  22903. <tr>
  22904. <td>
  22905. <code>compartment</code></br>
  22906. <em>
  22907. string
  22908. </em>
  22909. </td>
  22910. <td>
  22911. <em>(Optional)</em>
  22912. <p>Compartment is the vault compartment OCID.
  22913. Required for PushSecret</p>
  22914. </td>
  22915. </tr>
  22916. <tr>
  22917. <td>
  22918. <code>encryptionKey</code></br>
  22919. <em>
  22920. string
  22921. </em>
  22922. </td>
  22923. <td>
  22924. <em>(Optional)</em>
  22925. <p>EncryptionKey is the OCID of the encryption key within the vault.
  22926. Required for PushSecret</p>
  22927. </td>
  22928. </tr>
  22929. <tr>
  22930. <td>
  22931. <code>principalType</code></br>
  22932. <em>
  22933. <a href="#external-secrets.io/v1beta1.OraclePrincipalType">
  22934. OraclePrincipalType
  22935. </a>
  22936. </em>
  22937. </td>
  22938. <td>
  22939. <em>(Optional)</em>
  22940. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  22941. determine the principal type. This optional field must be specified if using
  22942. workload identity.</p>
  22943. </td>
  22944. </tr>
  22945. <tr>
  22946. <td>
  22947. <code>auth</code></br>
  22948. <em>
  22949. <a href="#external-secrets.io/v1beta1.OracleAuth">
  22950. OracleAuth
  22951. </a>
  22952. </em>
  22953. </td>
  22954. <td>
  22955. <em>(Optional)</em>
  22956. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  22957. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  22958. </td>
  22959. </tr>
  22960. <tr>
  22961. <td>
  22962. <code>serviceAccountRef</code></br>
  22963. <em>
  22964. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  22965. External Secrets meta/v1.ServiceAccountSelector
  22966. </a>
  22967. </em>
  22968. </td>
  22969. <td>
  22970. <em>(Optional)</em>
  22971. <p>ServiceAccountRef specified the service account
  22972. that should be used when authenticating with WorkloadIdentity.</p>
  22973. </td>
  22974. </tr>
  22975. </tbody>
  22976. </table>
  22977. <h3 id="external-secrets.io/v1beta1.OracleSecretRef">OracleSecretRef
  22978. </h3>
  22979. <p>
  22980. (<em>Appears on:</em>
  22981. <a href="#external-secrets.io/v1beta1.OracleAuth">OracleAuth</a>)
  22982. </p>
  22983. <p>
  22984. <p>OracleSecretRef defines references to secrets containing Oracle credentials.</p>
  22985. </p>
  22986. <table>
  22987. <thead>
  22988. <tr>
  22989. <th>Field</th>
  22990. <th>Description</th>
  22991. </tr>
  22992. </thead>
  22993. <tbody>
  22994. <tr>
  22995. <td>
  22996. <code>privatekey</code></br>
  22997. <em>
  22998. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22999. External Secrets meta/v1.SecretKeySelector
  23000. </a>
  23001. </em>
  23002. </td>
  23003. <td>
  23004. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  23005. </td>
  23006. </tr>
  23007. <tr>
  23008. <td>
  23009. <code>fingerprint</code></br>
  23010. <em>
  23011. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23012. External Secrets meta/v1.SecretKeySelector
  23013. </a>
  23014. </em>
  23015. </td>
  23016. <td>
  23017. <p>Fingerprint is the fingerprint of the API private key.</p>
  23018. </td>
  23019. </tr>
  23020. </tbody>
  23021. </table>
  23022. <h3 id="external-secrets.io/v1beta1.PassboltAuth">PassboltAuth
  23023. </h3>
  23024. <p>
  23025. (<em>Appears on:</em>
  23026. <a href="#external-secrets.io/v1beta1.PassboltProvider">PassboltProvider</a>)
  23027. </p>
  23028. <p>
  23029. <p>PassboltAuth contains credentials and configuration for authenticating with the Passbolt server.</p>
  23030. </p>
  23031. <table>
  23032. <thead>
  23033. <tr>
  23034. <th>Field</th>
  23035. <th>Description</th>
  23036. </tr>
  23037. </thead>
  23038. <tbody>
  23039. <tr>
  23040. <td>
  23041. <code>passwordSecretRef</code></br>
  23042. <em>
  23043. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23044. External Secrets meta/v1.SecretKeySelector
  23045. </a>
  23046. </em>
  23047. </td>
  23048. <td>
  23049. <p>PasswordSecretRef is a reference to the secret containing the Passbolt password</p>
  23050. </td>
  23051. </tr>
  23052. <tr>
  23053. <td>
  23054. <code>privateKeySecretRef</code></br>
  23055. <em>
  23056. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23057. External Secrets meta/v1.SecretKeySelector
  23058. </a>
  23059. </em>
  23060. </td>
  23061. <td>
  23062. <p>PrivateKeySecretRef is a reference to the secret containing the Passbolt private key</p>
  23063. </td>
  23064. </tr>
  23065. </tbody>
  23066. </table>
  23067. <h3 id="external-secrets.io/v1beta1.PassboltProvider">PassboltProvider
  23068. </h3>
  23069. <p>
  23070. (<em>Appears on:</em>
  23071. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23072. </p>
  23073. <p>
  23074. <p>PassboltProvider defines configuration for the Passbolt provider.</p>
  23075. </p>
  23076. <table>
  23077. <thead>
  23078. <tr>
  23079. <th>Field</th>
  23080. <th>Description</th>
  23081. </tr>
  23082. </thead>
  23083. <tbody>
  23084. <tr>
  23085. <td>
  23086. <code>auth</code></br>
  23087. <em>
  23088. <a href="#external-secrets.io/v1beta1.PassboltAuth">
  23089. PassboltAuth
  23090. </a>
  23091. </em>
  23092. </td>
  23093. <td>
  23094. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  23095. </td>
  23096. </tr>
  23097. <tr>
  23098. <td>
  23099. <code>host</code></br>
  23100. <em>
  23101. string
  23102. </em>
  23103. </td>
  23104. <td>
  23105. <p>Host defines the Passbolt Server to connect to</p>
  23106. </td>
  23107. </tr>
  23108. </tbody>
  23109. </table>
  23110. <h3 id="external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth
  23111. </h3>
  23112. <p>
  23113. (<em>Appears on:</em>
  23114. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider</a>)
  23115. </p>
  23116. <p>
  23117. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  23118. </p>
  23119. <table>
  23120. <thead>
  23121. <tr>
  23122. <th>Field</th>
  23123. <th>Description</th>
  23124. </tr>
  23125. </thead>
  23126. <tbody>
  23127. <tr>
  23128. <td>
  23129. <code>secretRef</code></br>
  23130. <em>
  23131. <a href="#external-secrets.io/v1beta1.PasswordDepotSecretRef">
  23132. PasswordDepotSecretRef
  23133. </a>
  23134. </em>
  23135. </td>
  23136. <td>
  23137. </td>
  23138. </tr>
  23139. </tbody>
  23140. </table>
  23141. <h3 id="external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider
  23142. </h3>
  23143. <p>
  23144. (<em>Appears on:</em>
  23145. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23146. </p>
  23147. <p>
  23148. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  23149. </p>
  23150. <table>
  23151. <thead>
  23152. <tr>
  23153. <th>Field</th>
  23154. <th>Description</th>
  23155. </tr>
  23156. </thead>
  23157. <tbody>
  23158. <tr>
  23159. <td>
  23160. <code>host</code></br>
  23161. <em>
  23162. string
  23163. </em>
  23164. </td>
  23165. <td>
  23166. <p>URL configures the Password Depot instance URL.</p>
  23167. </td>
  23168. </tr>
  23169. <tr>
  23170. <td>
  23171. <code>database</code></br>
  23172. <em>
  23173. string
  23174. </em>
  23175. </td>
  23176. <td>
  23177. <p>Database to use as source</p>
  23178. </td>
  23179. </tr>
  23180. <tr>
  23181. <td>
  23182. <code>auth</code></br>
  23183. <em>
  23184. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">
  23185. PasswordDepotAuth
  23186. </a>
  23187. </em>
  23188. </td>
  23189. <td>
  23190. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  23191. </td>
  23192. </tr>
  23193. </tbody>
  23194. </table>
  23195. <h3 id="external-secrets.io/v1beta1.PasswordDepotSecretRef">PasswordDepotSecretRef
  23196. </h3>
  23197. <p>
  23198. (<em>Appears on:</em>
  23199. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth</a>)
  23200. </p>
  23201. <p>
  23202. <p>PasswordDepotSecretRef defines a reference to a secret containing credentials for the Password Depot provider.</p>
  23203. </p>
  23204. <table>
  23205. <thead>
  23206. <tr>
  23207. <th>Field</th>
  23208. <th>Description</th>
  23209. </tr>
  23210. </thead>
  23211. <tbody>
  23212. <tr>
  23213. <td>
  23214. <code>credentials</code></br>
  23215. <em>
  23216. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23217. External Secrets meta/v1.SecretKeySelector
  23218. </a>
  23219. </em>
  23220. </td>
  23221. <td>
  23222. <em>(Optional)</em>
  23223. <p>Username / Password is used for authentication.</p>
  23224. </td>
  23225. </tr>
  23226. </tbody>
  23227. </table>
  23228. <h3 id="external-secrets.io/v1beta1.PreviderAuth">PreviderAuth
  23229. </h3>
  23230. <p>
  23231. (<em>Appears on:</em>
  23232. <a href="#external-secrets.io/v1beta1.PreviderProvider">PreviderProvider</a>)
  23233. </p>
  23234. <p>
  23235. <p>PreviderAuth contains a secretRef for credentials.</p>
  23236. </p>
  23237. <table>
  23238. <thead>
  23239. <tr>
  23240. <th>Field</th>
  23241. <th>Description</th>
  23242. </tr>
  23243. </thead>
  23244. <tbody>
  23245. <tr>
  23246. <td>
  23247. <code>secretRef</code></br>
  23248. <em>
  23249. <a href="#external-secrets.io/v1beta1.PreviderAuthSecretRef">
  23250. PreviderAuthSecretRef
  23251. </a>
  23252. </em>
  23253. </td>
  23254. <td>
  23255. <em>(Optional)</em>
  23256. </td>
  23257. </tr>
  23258. </tbody>
  23259. </table>
  23260. <h3 id="external-secrets.io/v1beta1.PreviderAuthSecretRef">PreviderAuthSecretRef
  23261. </h3>
  23262. <p>
  23263. (<em>Appears on:</em>
  23264. <a href="#external-secrets.io/v1beta1.PreviderAuth">PreviderAuth</a>)
  23265. </p>
  23266. <p>
  23267. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  23268. </p>
  23269. <table>
  23270. <thead>
  23271. <tr>
  23272. <th>Field</th>
  23273. <th>Description</th>
  23274. </tr>
  23275. </thead>
  23276. <tbody>
  23277. <tr>
  23278. <td>
  23279. <code>accessToken</code></br>
  23280. <em>
  23281. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23282. External Secrets meta/v1.SecretKeySelector
  23283. </a>
  23284. </em>
  23285. </td>
  23286. <td>
  23287. <p>The AccessToken is used for authentication</p>
  23288. </td>
  23289. </tr>
  23290. </tbody>
  23291. </table>
  23292. <h3 id="external-secrets.io/v1beta1.PreviderProvider">PreviderProvider
  23293. </h3>
  23294. <p>
  23295. (<em>Appears on:</em>
  23296. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23297. </p>
  23298. <p>
  23299. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  23300. </p>
  23301. <table>
  23302. <thead>
  23303. <tr>
  23304. <th>Field</th>
  23305. <th>Description</th>
  23306. </tr>
  23307. </thead>
  23308. <tbody>
  23309. <tr>
  23310. <td>
  23311. <code>auth</code></br>
  23312. <em>
  23313. <a href="#external-secrets.io/v1beta1.PreviderAuth">
  23314. PreviderAuth
  23315. </a>
  23316. </em>
  23317. </td>
  23318. <td>
  23319. </td>
  23320. </tr>
  23321. <tr>
  23322. <td>
  23323. <code>baseUri</code></br>
  23324. <em>
  23325. string
  23326. </em>
  23327. </td>
  23328. <td>
  23329. <em>(Optional)</em>
  23330. </td>
  23331. </tr>
  23332. </tbody>
  23333. </table>
  23334. <h3 id="external-secrets.io/v1beta1.Provider">Provider
  23335. </h3>
  23336. <p>
  23337. <p>Provider is a common interface for interacting with secret backends.</p>
  23338. </p>
  23339. <h3 id="external-secrets.io/v1beta1.PulumiProvider">PulumiProvider
  23340. </h3>
  23341. <p>
  23342. (<em>Appears on:</em>
  23343. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23344. </p>
  23345. <p>
  23346. <p>PulumiProvider defines configuration for the Pulumi provider.</p>
  23347. </p>
  23348. <table>
  23349. <thead>
  23350. <tr>
  23351. <th>Field</th>
  23352. <th>Description</th>
  23353. </tr>
  23354. </thead>
  23355. <tbody>
  23356. <tr>
  23357. <td>
  23358. <code>apiUrl</code></br>
  23359. <em>
  23360. string
  23361. </em>
  23362. </td>
  23363. <td>
  23364. <p>APIURL is the URL of the Pulumi API.</p>
  23365. </td>
  23366. </tr>
  23367. <tr>
  23368. <td>
  23369. <code>accessToken</code></br>
  23370. <em>
  23371. <a href="#external-secrets.io/v1beta1.PulumiProviderSecretRef">
  23372. PulumiProviderSecretRef
  23373. </a>
  23374. </em>
  23375. </td>
  23376. <td>
  23377. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  23378. </td>
  23379. </tr>
  23380. <tr>
  23381. <td>
  23382. <code>organization</code></br>
  23383. <em>
  23384. string
  23385. </em>
  23386. </td>
  23387. <td>
  23388. <p>Organization are a space to collaborate on shared projects and stacks.
  23389. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  23390. </td>
  23391. </tr>
  23392. <tr>
  23393. <td>
  23394. <code>project</code></br>
  23395. <em>
  23396. string
  23397. </em>
  23398. </td>
  23399. <td>
  23400. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  23401. </td>
  23402. </tr>
  23403. <tr>
  23404. <td>
  23405. <code>environment</code></br>
  23406. <em>
  23407. string
  23408. </em>
  23409. </td>
  23410. <td>
  23411. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  23412. dynamically retrieved values from supported providers including all major clouds,
  23413. and other Pulumi ESC environments.
  23414. To create a new environment, visit <a href="https://www.pulumi.com/docs/esc/environments/">https://www.pulumi.com/docs/esc/environments/</a> for more information.</p>
  23415. </td>
  23416. </tr>
  23417. </tbody>
  23418. </table>
  23419. <h3 id="external-secrets.io/v1beta1.PulumiProviderSecretRef">PulumiProviderSecretRef
  23420. </h3>
  23421. <p>
  23422. (<em>Appears on:</em>
  23423. <a href="#external-secrets.io/v1beta1.PulumiProvider">PulumiProvider</a>)
  23424. </p>
  23425. <p>
  23426. <p>PulumiProviderSecretRef defines a reference to a secret containing credentials for the Pulumi provider.</p>
  23427. </p>
  23428. <table>
  23429. <thead>
  23430. <tr>
  23431. <th>Field</th>
  23432. <th>Description</th>
  23433. </tr>
  23434. </thead>
  23435. <tbody>
  23436. <tr>
  23437. <td>
  23438. <code>secretRef</code></br>
  23439. <em>
  23440. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23441. External Secrets meta/v1.SecretKeySelector
  23442. </a>
  23443. </em>
  23444. </td>
  23445. <td>
  23446. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  23447. </td>
  23448. </tr>
  23449. </tbody>
  23450. </table>
  23451. <h3 id="external-secrets.io/v1beta1.PushSecretData">PushSecretData
  23452. </h3>
  23453. <p>
  23454. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1beta1.</p>
  23455. </p>
  23456. <h3 id="external-secrets.io/v1beta1.PushSecretRemoteRef">PushSecretRemoteRef
  23457. </h3>
  23458. <p>
  23459. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1beta1.</p>
  23460. </p>
  23461. <h3 id="external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider
  23462. </h3>
  23463. <p>
  23464. (<em>Appears on:</em>
  23465. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23466. </p>
  23467. <p>
  23468. <p>ScalewayProvider defines configuration for the Scaleway provider.</p>
  23469. </p>
  23470. <table>
  23471. <thead>
  23472. <tr>
  23473. <th>Field</th>
  23474. <th>Description</th>
  23475. </tr>
  23476. </thead>
  23477. <tbody>
  23478. <tr>
  23479. <td>
  23480. <code>apiUrl</code></br>
  23481. <em>
  23482. string
  23483. </em>
  23484. </td>
  23485. <td>
  23486. <em>(Optional)</em>
  23487. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  23488. </td>
  23489. </tr>
  23490. <tr>
  23491. <td>
  23492. <code>region</code></br>
  23493. <em>
  23494. string
  23495. </em>
  23496. </td>
  23497. <td>
  23498. <p>Region where your secrets are located: <a href="https://developers.scaleway.com/en/quickstart/#region-and-zone">https://developers.scaleway.com/en/quickstart/#region-and-zone</a></p>
  23499. </td>
  23500. </tr>
  23501. <tr>
  23502. <td>
  23503. <code>projectId</code></br>
  23504. <em>
  23505. string
  23506. </em>
  23507. </td>
  23508. <td>
  23509. <p>ProjectID is the id of your project, which you can find in the console: <a href="https://console.scaleway.com/project/settings">https://console.scaleway.com/project/settings</a></p>
  23510. </td>
  23511. </tr>
  23512. <tr>
  23513. <td>
  23514. <code>accessKey</code></br>
  23515. <em>
  23516. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  23517. ScalewayProviderSecretRef
  23518. </a>
  23519. </em>
  23520. </td>
  23521. <td>
  23522. <p>AccessKey is the non-secret part of the api key.</p>
  23523. </td>
  23524. </tr>
  23525. <tr>
  23526. <td>
  23527. <code>secretKey</code></br>
  23528. <em>
  23529. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  23530. ScalewayProviderSecretRef
  23531. </a>
  23532. </em>
  23533. </td>
  23534. <td>
  23535. <p>SecretKey is the non-secret part of the api key.</p>
  23536. </td>
  23537. </tr>
  23538. </tbody>
  23539. </table>
  23540. <h3 id="external-secrets.io/v1beta1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  23541. </h3>
  23542. <p>
  23543. (<em>Appears on:</em>
  23544. <a href="#external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider</a>)
  23545. </p>
  23546. <p>
  23547. <p>ScalewayProviderSecretRef defines a reference to a secret containing credentials for the Scaleway provider.</p>
  23548. </p>
  23549. <table>
  23550. <thead>
  23551. <tr>
  23552. <th>Field</th>
  23553. <th>Description</th>
  23554. </tr>
  23555. </thead>
  23556. <tbody>
  23557. <tr>
  23558. <td>
  23559. <code>value</code></br>
  23560. <em>
  23561. string
  23562. </em>
  23563. </td>
  23564. <td>
  23565. <em>(Optional)</em>
  23566. <p>Value can be specified directly to set a value without using a secret.</p>
  23567. </td>
  23568. </tr>
  23569. <tr>
  23570. <td>
  23571. <code>secretRef</code></br>
  23572. <em>
  23573. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23574. External Secrets meta/v1.SecretKeySelector
  23575. </a>
  23576. </em>
  23577. </td>
  23578. <td>
  23579. <em>(Optional)</em>
  23580. <p>SecretRef references a key in a secret that will be used as value.</p>
  23581. </td>
  23582. </tr>
  23583. </tbody>
  23584. </table>
  23585. <h3 id="external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider
  23586. </h3>
  23587. <p>
  23588. (<em>Appears on:</em>
  23589. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23590. </p>
  23591. <p>
  23592. <p>SecretServerProvider defines configuration for the Delinea Secret Server provider.
  23593. See <a href="https://github.com/DelineaXPM/tss-sdk-go/blob/main/server/server.go">https://github.com/DelineaXPM/tss-sdk-go/blob/main/server/server.go</a>.</p>
  23594. </p>
  23595. <table>
  23596. <thead>
  23597. <tr>
  23598. <th>Field</th>
  23599. <th>Description</th>
  23600. </tr>
  23601. </thead>
  23602. <tbody>
  23603. <tr>
  23604. <td>
  23605. <code>username</code></br>
  23606. <em>
  23607. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  23608. SecretServerProviderRef
  23609. </a>
  23610. </em>
  23611. </td>
  23612. <td>
  23613. <p>Username is the secret server account username.</p>
  23614. </td>
  23615. </tr>
  23616. <tr>
  23617. <td>
  23618. <code>password</code></br>
  23619. <em>
  23620. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  23621. SecretServerProviderRef
  23622. </a>
  23623. </em>
  23624. </td>
  23625. <td>
  23626. <p>Password is the secret server account password.</p>
  23627. </td>
  23628. </tr>
  23629. <tr>
  23630. <td>
  23631. <code>serverURL</code></br>
  23632. <em>
  23633. string
  23634. </em>
  23635. </td>
  23636. <td>
  23637. <p>ServerURL
  23638. URL to your secret server installation</p>
  23639. </td>
  23640. </tr>
  23641. </tbody>
  23642. </table>
  23643. <h3 id="external-secrets.io/v1beta1.SecretServerProviderRef">SecretServerProviderRef
  23644. </h3>
  23645. <p>
  23646. (<em>Appears on:</em>
  23647. <a href="#external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider</a>)
  23648. </p>
  23649. <p>
  23650. <p>SecretServerProviderRef defines a reference to a secret containing credentials for the Secret Server provider.</p>
  23651. </p>
  23652. <table>
  23653. <thead>
  23654. <tr>
  23655. <th>Field</th>
  23656. <th>Description</th>
  23657. </tr>
  23658. </thead>
  23659. <tbody>
  23660. <tr>
  23661. <td>
  23662. <code>value</code></br>
  23663. <em>
  23664. string
  23665. </em>
  23666. </td>
  23667. <td>
  23668. <em>(Optional)</em>
  23669. <p>Value can be specified directly to set a value without using a secret.</p>
  23670. </td>
  23671. </tr>
  23672. <tr>
  23673. <td>
  23674. <code>secretRef</code></br>
  23675. <em>
  23676. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23677. External Secrets meta/v1.SecretKeySelector
  23678. </a>
  23679. </em>
  23680. </td>
  23681. <td>
  23682. <em>(Optional)</em>
  23683. <p>SecretRef references a key in a secret that will be used as value.</p>
  23684. </td>
  23685. </tr>
  23686. </tbody>
  23687. </table>
  23688. <h3 id="external-secrets.io/v1beta1.SecretStore">SecretStore
  23689. </h3>
  23690. <p>
  23691. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  23692. </p>
  23693. <table>
  23694. <thead>
  23695. <tr>
  23696. <th>Field</th>
  23697. <th>Description</th>
  23698. </tr>
  23699. </thead>
  23700. <tbody>
  23701. <tr>
  23702. <td>
  23703. <code>metadata</code></br>
  23704. <em>
  23705. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  23706. Kubernetes meta/v1.ObjectMeta
  23707. </a>
  23708. </em>
  23709. </td>
  23710. <td>
  23711. Refer to the Kubernetes API documentation for the fields of the
  23712. <code>metadata</code> field.
  23713. </td>
  23714. </tr>
  23715. <tr>
  23716. <td>
  23717. <code>spec</code></br>
  23718. <em>
  23719. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  23720. SecretStoreSpec
  23721. </a>
  23722. </em>
  23723. </td>
  23724. <td>
  23725. <br/>
  23726. <br/>
  23727. <table>
  23728. <tr>
  23729. <td>
  23730. <code>controller</code></br>
  23731. <em>
  23732. string
  23733. </em>
  23734. </td>
  23735. <td>
  23736. <em>(Optional)</em>
  23737. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  23738. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  23739. </td>
  23740. </tr>
  23741. <tr>
  23742. <td>
  23743. <code>provider</code></br>
  23744. <em>
  23745. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  23746. SecretStoreProvider
  23747. </a>
  23748. </em>
  23749. </td>
  23750. <td>
  23751. <p>Used to configure the provider. Only one provider may be set</p>
  23752. </td>
  23753. </tr>
  23754. <tr>
  23755. <td>
  23756. <code>retrySettings</code></br>
  23757. <em>
  23758. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  23759. SecretStoreRetrySettings
  23760. </a>
  23761. </em>
  23762. </td>
  23763. <td>
  23764. <em>(Optional)</em>
  23765. <p>Used to configure HTTP retries on failures.</p>
  23766. </td>
  23767. </tr>
  23768. <tr>
  23769. <td>
  23770. <code>refreshInterval</code></br>
  23771. <em>
  23772. int
  23773. </em>
  23774. </td>
  23775. <td>
  23776. <em>(Optional)</em>
  23777. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  23778. </td>
  23779. </tr>
  23780. <tr>
  23781. <td>
  23782. <code>conditions</code></br>
  23783. <em>
  23784. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  23785. []ClusterSecretStoreCondition
  23786. </a>
  23787. </em>
  23788. </td>
  23789. <td>
  23790. <em>(Optional)</em>
  23791. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  23792. </td>
  23793. </tr>
  23794. </table>
  23795. </td>
  23796. </tr>
  23797. <tr>
  23798. <td>
  23799. <code>status</code></br>
  23800. <em>
  23801. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  23802. SecretStoreStatus
  23803. </a>
  23804. </em>
  23805. </td>
  23806. <td>
  23807. </td>
  23808. </tr>
  23809. </tbody>
  23810. </table>
  23811. <h3 id="external-secrets.io/v1beta1.SecretStoreCapabilities">SecretStoreCapabilities
  23812. (<code>string</code> alias)</p></h3>
  23813. <p>
  23814. (<em>Appears on:</em>
  23815. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  23816. </p>
  23817. <p>
  23818. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  23819. </p>
  23820. <table>
  23821. <thead>
  23822. <tr>
  23823. <th>Value</th>
  23824. <th>Description</th>
  23825. </tr>
  23826. </thead>
  23827. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  23828. <td><p>SecretStoreReadOnly indicates that the SecretStore only supports reading secrets.</p>
  23829. </td>
  23830. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  23831. <td><p>SecretStoreReadWrite indicates that the SecretStore supports both reading and writing secrets.</p>
  23832. </td>
  23833. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  23834. <td><p>SecretStoreWriteOnly indicates that the SecretStore only supports writing secrets.</p>
  23835. </td>
  23836. </tr></tbody>
  23837. </table>
  23838. <h3 id="external-secrets.io/v1beta1.SecretStoreConditionType">SecretStoreConditionType
  23839. (<code>string</code> alias)</p></h3>
  23840. <p>
  23841. (<em>Appears on:</em>
  23842. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  23843. </p>
  23844. <p>
  23845. <p>SecretStoreConditionType represents the condition type of the SecretStore.</p>
  23846. </p>
  23847. <table>
  23848. <thead>
  23849. <tr>
  23850. <th>Value</th>
  23851. <th>Description</th>
  23852. </tr>
  23853. </thead>
  23854. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  23855. <td><p>SecretStoreReady indicates that the SecretStore has been successfully configured.</p>
  23856. </td>
  23857. </tr></tbody>
  23858. </table>
  23859. <h3 id="external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider
  23860. </h3>
  23861. <p>
  23862. (<em>Appears on:</em>
  23863. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  23864. </p>
  23865. <p>
  23866. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  23867. </p>
  23868. <table>
  23869. <thead>
  23870. <tr>
  23871. <th>Field</th>
  23872. <th>Description</th>
  23873. </tr>
  23874. </thead>
  23875. <tbody>
  23876. <tr>
  23877. <td>
  23878. <code>aws</code></br>
  23879. <em>
  23880. <a href="#external-secrets.io/v1beta1.AWSProvider">
  23881. AWSProvider
  23882. </a>
  23883. </em>
  23884. </td>
  23885. <td>
  23886. <em>(Optional)</em>
  23887. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  23888. </td>
  23889. </tr>
  23890. <tr>
  23891. <td>
  23892. <code>azurekv</code></br>
  23893. <em>
  23894. <a href="#external-secrets.io/v1beta1.AzureKVProvider">
  23895. AzureKVProvider
  23896. </a>
  23897. </em>
  23898. </td>
  23899. <td>
  23900. <em>(Optional)</em>
  23901. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  23902. </td>
  23903. </tr>
  23904. <tr>
  23905. <td>
  23906. <code>akeyless</code></br>
  23907. <em>
  23908. <a href="#external-secrets.io/v1beta1.AkeylessProvider">
  23909. AkeylessProvider
  23910. </a>
  23911. </em>
  23912. </td>
  23913. <td>
  23914. <em>(Optional)</em>
  23915. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  23916. </td>
  23917. </tr>
  23918. <tr>
  23919. <td>
  23920. <code>bitwardensecretsmanager</code></br>
  23921. <em>
  23922. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">
  23923. BitwardenSecretsManagerProvider
  23924. </a>
  23925. </em>
  23926. </td>
  23927. <td>
  23928. <em>(Optional)</em>
  23929. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  23930. </td>
  23931. </tr>
  23932. <tr>
  23933. <td>
  23934. <code>vault</code></br>
  23935. <em>
  23936. <a href="#external-secrets.io/v1beta1.VaultProvider">
  23937. VaultProvider
  23938. </a>
  23939. </em>
  23940. </td>
  23941. <td>
  23942. <em>(Optional)</em>
  23943. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  23944. </td>
  23945. </tr>
  23946. <tr>
  23947. <td>
  23948. <code>gcpsm</code></br>
  23949. <em>
  23950. <a href="#external-secrets.io/v1beta1.GCPSMProvider">
  23951. GCPSMProvider
  23952. </a>
  23953. </em>
  23954. </td>
  23955. <td>
  23956. <em>(Optional)</em>
  23957. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  23958. </td>
  23959. </tr>
  23960. <tr>
  23961. <td>
  23962. <code>oracle</code></br>
  23963. <em>
  23964. <a href="#external-secrets.io/v1beta1.OracleProvider">
  23965. OracleProvider
  23966. </a>
  23967. </em>
  23968. </td>
  23969. <td>
  23970. <em>(Optional)</em>
  23971. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  23972. </td>
  23973. </tr>
  23974. <tr>
  23975. <td>
  23976. <code>ibm</code></br>
  23977. <em>
  23978. <a href="#external-secrets.io/v1beta1.IBMProvider">
  23979. IBMProvider
  23980. </a>
  23981. </em>
  23982. </td>
  23983. <td>
  23984. <em>(Optional)</em>
  23985. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  23986. </td>
  23987. </tr>
  23988. <tr>
  23989. <td>
  23990. <code>yandexcertificatemanager</code></br>
  23991. <em>
  23992. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">
  23993. YandexCertificateManagerProvider
  23994. </a>
  23995. </em>
  23996. </td>
  23997. <td>
  23998. <em>(Optional)</em>
  23999. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  24000. </td>
  24001. </tr>
  24002. <tr>
  24003. <td>
  24004. <code>yandexlockbox</code></br>
  24005. <em>
  24006. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">
  24007. YandexLockboxProvider
  24008. </a>
  24009. </em>
  24010. </td>
  24011. <td>
  24012. <em>(Optional)</em>
  24013. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  24014. </td>
  24015. </tr>
  24016. <tr>
  24017. <td>
  24018. <code>github</code></br>
  24019. <em>
  24020. <a href="#external-secrets.io/v1beta1.GithubProvider">
  24021. GithubProvider
  24022. </a>
  24023. </em>
  24024. </td>
  24025. <td>
  24026. <em>(Optional)</em>
  24027. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.</p>
  24028. </td>
  24029. </tr>
  24030. <tr>
  24031. <td>
  24032. <code>gitlab</code></br>
  24033. <em>
  24034. <a href="#external-secrets.io/v1beta1.GitlabProvider">
  24035. GitlabProvider
  24036. </a>
  24037. </em>
  24038. </td>
  24039. <td>
  24040. <em>(Optional)</em>
  24041. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  24042. </td>
  24043. </tr>
  24044. <tr>
  24045. <td>
  24046. <code>alibaba</code></br>
  24047. <em>
  24048. <a href="#external-secrets.io/v1beta1.AlibabaProvider">
  24049. AlibabaProvider
  24050. </a>
  24051. </em>
  24052. </td>
  24053. <td>
  24054. <em>(Optional)</em>
  24055. <p>Alibaba configures this store to sync secrets using Alibaba Cloud provider</p>
  24056. </td>
  24057. </tr>
  24058. <tr>
  24059. <td>
  24060. <code>onepassword</code></br>
  24061. <em>
  24062. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">
  24063. OnePasswordProvider
  24064. </a>
  24065. </em>
  24066. </td>
  24067. <td>
  24068. <em>(Optional)</em>
  24069. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  24070. </td>
  24071. </tr>
  24072. <tr>
  24073. <td>
  24074. <code>webhook</code></br>
  24075. <em>
  24076. <a href="#external-secrets.io/v1beta1.WebhookProvider">
  24077. WebhookProvider
  24078. </a>
  24079. </em>
  24080. </td>
  24081. <td>
  24082. <em>(Optional)</em>
  24083. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  24084. </td>
  24085. </tr>
  24086. <tr>
  24087. <td>
  24088. <code>kubernetes</code></br>
  24089. <em>
  24090. <a href="#external-secrets.io/v1beta1.KubernetesProvider">
  24091. KubernetesProvider
  24092. </a>
  24093. </em>
  24094. </td>
  24095. <td>
  24096. <em>(Optional)</em>
  24097. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  24098. </td>
  24099. </tr>
  24100. <tr>
  24101. <td>
  24102. <code>fake</code></br>
  24103. <em>
  24104. <a href="#external-secrets.io/v1beta1.FakeProvider">
  24105. FakeProvider
  24106. </a>
  24107. </em>
  24108. </td>
  24109. <td>
  24110. <em>(Optional)</em>
  24111. <p>Fake configures a store with static key/value pairs</p>
  24112. </td>
  24113. </tr>
  24114. <tr>
  24115. <td>
  24116. <code>senhasegura</code></br>
  24117. <em>
  24118. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">
  24119. SenhaseguraProvider
  24120. </a>
  24121. </em>
  24122. </td>
  24123. <td>
  24124. <em>(Optional)</em>
  24125. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  24126. </td>
  24127. </tr>
  24128. <tr>
  24129. <td>
  24130. <code>scaleway</code></br>
  24131. <em>
  24132. <a href="#external-secrets.io/v1beta1.ScalewayProvider">
  24133. ScalewayProvider
  24134. </a>
  24135. </em>
  24136. </td>
  24137. <td>
  24138. <em>(Optional)</em>
  24139. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  24140. </td>
  24141. </tr>
  24142. <tr>
  24143. <td>
  24144. <code>doppler</code></br>
  24145. <em>
  24146. <a href="#external-secrets.io/v1beta1.DopplerProvider">
  24147. DopplerProvider
  24148. </a>
  24149. </em>
  24150. </td>
  24151. <td>
  24152. <em>(Optional)</em>
  24153. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  24154. </td>
  24155. </tr>
  24156. <tr>
  24157. <td>
  24158. <code>previder</code></br>
  24159. <em>
  24160. <a href="#external-secrets.io/v1beta1.PreviderProvider">
  24161. PreviderProvider
  24162. </a>
  24163. </em>
  24164. </td>
  24165. <td>
  24166. <em>(Optional)</em>
  24167. <p>Previder configures this store to sync secrets using the Previder provider</p>
  24168. </td>
  24169. </tr>
  24170. <tr>
  24171. <td>
  24172. <code>onboardbase</code></br>
  24173. <em>
  24174. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">
  24175. OnboardbaseProvider
  24176. </a>
  24177. </em>
  24178. </td>
  24179. <td>
  24180. <em>(Optional)</em>
  24181. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  24182. </td>
  24183. </tr>
  24184. <tr>
  24185. <td>
  24186. <code>keepersecurity</code></br>
  24187. <em>
  24188. <a href="#external-secrets.io/v1beta1.KeeperSecurityProvider">
  24189. KeeperSecurityProvider
  24190. </a>
  24191. </em>
  24192. </td>
  24193. <td>
  24194. <em>(Optional)</em>
  24195. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  24196. </td>
  24197. </tr>
  24198. <tr>
  24199. <td>
  24200. <code>conjur</code></br>
  24201. <em>
  24202. <a href="#external-secrets.io/v1beta1.ConjurProvider">
  24203. ConjurProvider
  24204. </a>
  24205. </em>
  24206. </td>
  24207. <td>
  24208. <em>(Optional)</em>
  24209. <p>Conjur configures this store to sync secrets using conjur provider</p>
  24210. </td>
  24211. </tr>
  24212. <tr>
  24213. <td>
  24214. <code>delinea</code></br>
  24215. <em>
  24216. <a href="#external-secrets.io/v1beta1.DelineaProvider">
  24217. DelineaProvider
  24218. </a>
  24219. </em>
  24220. </td>
  24221. <td>
  24222. <em>(Optional)</em>
  24223. <p>Delinea DevOps Secrets Vault
  24224. <a href="https://docs.delinea.com/online-help/products/devops-secrets-vault/current">https://docs.delinea.com/online-help/products/devops-secrets-vault/current</a></p>
  24225. </td>
  24226. </tr>
  24227. <tr>
  24228. <td>
  24229. <code>secretserver</code></br>
  24230. <em>
  24231. <a href="#external-secrets.io/v1beta1.SecretServerProvider">
  24232. SecretServerProvider
  24233. </a>
  24234. </em>
  24235. </td>
  24236. <td>
  24237. <em>(Optional)</em>
  24238. <p>SecretServer configures this store to sync secrets using SecretServer provider
  24239. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  24240. </td>
  24241. </tr>
  24242. <tr>
  24243. <td>
  24244. <code>chef</code></br>
  24245. <em>
  24246. <a href="#external-secrets.io/v1beta1.ChefProvider">
  24247. ChefProvider
  24248. </a>
  24249. </em>
  24250. </td>
  24251. <td>
  24252. <em>(Optional)</em>
  24253. <p>Chef configures this store to sync secrets with chef server</p>
  24254. </td>
  24255. </tr>
  24256. <tr>
  24257. <td>
  24258. <code>pulumi</code></br>
  24259. <em>
  24260. <a href="#external-secrets.io/v1beta1.PulumiProvider">
  24261. PulumiProvider
  24262. </a>
  24263. </em>
  24264. </td>
  24265. <td>
  24266. <em>(Optional)</em>
  24267. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  24268. </td>
  24269. </tr>
  24270. <tr>
  24271. <td>
  24272. <code>fortanix</code></br>
  24273. <em>
  24274. <a href="#external-secrets.io/v1beta1.FortanixProvider">
  24275. FortanixProvider
  24276. </a>
  24277. </em>
  24278. </td>
  24279. <td>
  24280. <em>(Optional)</em>
  24281. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  24282. </td>
  24283. </tr>
  24284. <tr>
  24285. <td>
  24286. <code>passworddepot</code></br>
  24287. <em>
  24288. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">
  24289. PasswordDepotProvider
  24290. </a>
  24291. </em>
  24292. </td>
  24293. <td>
  24294. <em>(Optional)</em>
  24295. </td>
  24296. </tr>
  24297. <tr>
  24298. <td>
  24299. <code>passbolt</code></br>
  24300. <em>
  24301. <a href="#external-secrets.io/v1beta1.PassboltProvider">
  24302. PassboltProvider
  24303. </a>
  24304. </em>
  24305. </td>
  24306. <td>
  24307. <em>(Optional)</em>
  24308. </td>
  24309. </tr>
  24310. <tr>
  24311. <td>
  24312. <code>device42</code></br>
  24313. <em>
  24314. <a href="#external-secrets.io/v1beta1.Device42Provider">
  24315. Device42Provider
  24316. </a>
  24317. </em>
  24318. </td>
  24319. <td>
  24320. <em>(Optional)</em>
  24321. <p>Device42 configures this store to sync secrets using the Device42 provider</p>
  24322. </td>
  24323. </tr>
  24324. <tr>
  24325. <td>
  24326. <code>infisical</code></br>
  24327. <em>
  24328. <a href="#external-secrets.io/v1beta1.InfisicalProvider">
  24329. InfisicalProvider
  24330. </a>
  24331. </em>
  24332. </td>
  24333. <td>
  24334. <em>(Optional)</em>
  24335. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  24336. </td>
  24337. </tr>
  24338. <tr>
  24339. <td>
  24340. <code>beyondtrust</code></br>
  24341. <em>
  24342. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">
  24343. BeyondtrustProvider
  24344. </a>
  24345. </em>
  24346. </td>
  24347. <td>
  24348. <em>(Optional)</em>
  24349. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  24350. </td>
  24351. </tr>
  24352. <tr>
  24353. <td>
  24354. <code>cloudrusm</code></br>
  24355. <em>
  24356. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">
  24357. CloudruSMProvider
  24358. </a>
  24359. </em>
  24360. </td>
  24361. <td>
  24362. <em>(Optional)</em>
  24363. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  24364. </td>
  24365. </tr>
  24366. </tbody>
  24367. </table>
  24368. <h3 id="external-secrets.io/v1beta1.SecretStoreRef">SecretStoreRef
  24369. </h3>
  24370. <p>
  24371. (<em>Appears on:</em>
  24372. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>,
  24373. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  24374. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  24375. </p>
  24376. <p>
  24377. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  24378. </p>
  24379. <table>
  24380. <thead>
  24381. <tr>
  24382. <th>Field</th>
  24383. <th>Description</th>
  24384. </tr>
  24385. </thead>
  24386. <tbody>
  24387. <tr>
  24388. <td>
  24389. <code>name</code></br>
  24390. <em>
  24391. string
  24392. </em>
  24393. </td>
  24394. <td>
  24395. <p>Name of the SecretStore resource</p>
  24396. </td>
  24397. </tr>
  24398. <tr>
  24399. <td>
  24400. <code>kind</code></br>
  24401. <em>
  24402. string
  24403. </em>
  24404. </td>
  24405. <td>
  24406. <em>(Optional)</em>
  24407. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  24408. Defaults to <code>SecretStore</code></p>
  24409. </td>
  24410. </tr>
  24411. </tbody>
  24412. </table>
  24413. <h3 id="external-secrets.io/v1beta1.SecretStoreRetrySettings">SecretStoreRetrySettings
  24414. </h3>
  24415. <p>
  24416. (<em>Appears on:</em>
  24417. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  24418. </p>
  24419. <p>
  24420. <p>SecretStoreRetrySettings defines configuration for retrying failed requests to the provider.</p>
  24421. </p>
  24422. <table>
  24423. <thead>
  24424. <tr>
  24425. <th>Field</th>
  24426. <th>Description</th>
  24427. </tr>
  24428. </thead>
  24429. <tbody>
  24430. <tr>
  24431. <td>
  24432. <code>maxRetries</code></br>
  24433. <em>
  24434. int32
  24435. </em>
  24436. </td>
  24437. <td>
  24438. <p>MaxRetries is the maximum number of retry attempts.</p>
  24439. </td>
  24440. </tr>
  24441. <tr>
  24442. <td>
  24443. <code>retryInterval</code></br>
  24444. <em>
  24445. string
  24446. </em>
  24447. </td>
  24448. <td>
  24449. <p>RetryInterval is the interval between retry attempts.</p>
  24450. </td>
  24451. </tr>
  24452. </tbody>
  24453. </table>
  24454. <h3 id="external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec
  24455. </h3>
  24456. <p>
  24457. (<em>Appears on:</em>
  24458. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  24459. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  24460. </p>
  24461. <p>
  24462. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  24463. </p>
  24464. <table>
  24465. <thead>
  24466. <tr>
  24467. <th>Field</th>
  24468. <th>Description</th>
  24469. </tr>
  24470. </thead>
  24471. <tbody>
  24472. <tr>
  24473. <td>
  24474. <code>controller</code></br>
  24475. <em>
  24476. string
  24477. </em>
  24478. </td>
  24479. <td>
  24480. <em>(Optional)</em>
  24481. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  24482. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  24483. </td>
  24484. </tr>
  24485. <tr>
  24486. <td>
  24487. <code>provider</code></br>
  24488. <em>
  24489. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  24490. SecretStoreProvider
  24491. </a>
  24492. </em>
  24493. </td>
  24494. <td>
  24495. <p>Used to configure the provider. Only one provider may be set</p>
  24496. </td>
  24497. </tr>
  24498. <tr>
  24499. <td>
  24500. <code>retrySettings</code></br>
  24501. <em>
  24502. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  24503. SecretStoreRetrySettings
  24504. </a>
  24505. </em>
  24506. </td>
  24507. <td>
  24508. <em>(Optional)</em>
  24509. <p>Used to configure HTTP retries on failures.</p>
  24510. </td>
  24511. </tr>
  24512. <tr>
  24513. <td>
  24514. <code>refreshInterval</code></br>
  24515. <em>
  24516. int
  24517. </em>
  24518. </td>
  24519. <td>
  24520. <em>(Optional)</em>
  24521. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  24522. </td>
  24523. </tr>
  24524. <tr>
  24525. <td>
  24526. <code>conditions</code></br>
  24527. <em>
  24528. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  24529. []ClusterSecretStoreCondition
  24530. </a>
  24531. </em>
  24532. </td>
  24533. <td>
  24534. <em>(Optional)</em>
  24535. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  24536. </td>
  24537. </tr>
  24538. </tbody>
  24539. </table>
  24540. <h3 id="external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus
  24541. </h3>
  24542. <p>
  24543. (<em>Appears on:</em>
  24544. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  24545. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  24546. </p>
  24547. <p>
  24548. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  24549. </p>
  24550. <table>
  24551. <thead>
  24552. <tr>
  24553. <th>Field</th>
  24554. <th>Description</th>
  24555. </tr>
  24556. </thead>
  24557. <tbody>
  24558. <tr>
  24559. <td>
  24560. <code>conditions</code></br>
  24561. <em>
  24562. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">
  24563. []SecretStoreStatusCondition
  24564. </a>
  24565. </em>
  24566. </td>
  24567. <td>
  24568. <em>(Optional)</em>
  24569. </td>
  24570. </tr>
  24571. <tr>
  24572. <td>
  24573. <code>capabilities</code></br>
  24574. <em>
  24575. <a href="#external-secrets.io/v1beta1.SecretStoreCapabilities">
  24576. SecretStoreCapabilities
  24577. </a>
  24578. </em>
  24579. </td>
  24580. <td>
  24581. <em>(Optional)</em>
  24582. </td>
  24583. </tr>
  24584. </tbody>
  24585. </table>
  24586. <h3 id="external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition
  24587. </h3>
  24588. <p>
  24589. (<em>Appears on:</em>
  24590. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  24591. </p>
  24592. <p>
  24593. <p>SecretStoreStatusCondition defines the observed condition of the SecretStore.</p>
  24594. </p>
  24595. <table>
  24596. <thead>
  24597. <tr>
  24598. <th>Field</th>
  24599. <th>Description</th>
  24600. </tr>
  24601. </thead>
  24602. <tbody>
  24603. <tr>
  24604. <td>
  24605. <code>type</code></br>
  24606. <em>
  24607. <a href="#external-secrets.io/v1beta1.SecretStoreConditionType">
  24608. SecretStoreConditionType
  24609. </a>
  24610. </em>
  24611. </td>
  24612. <td>
  24613. </td>
  24614. </tr>
  24615. <tr>
  24616. <td>
  24617. <code>status</code></br>
  24618. <em>
  24619. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  24620. Kubernetes core/v1.ConditionStatus
  24621. </a>
  24622. </em>
  24623. </td>
  24624. <td>
  24625. </td>
  24626. </tr>
  24627. <tr>
  24628. <td>
  24629. <code>reason</code></br>
  24630. <em>
  24631. string
  24632. </em>
  24633. </td>
  24634. <td>
  24635. <em>(Optional)</em>
  24636. </td>
  24637. </tr>
  24638. <tr>
  24639. <td>
  24640. <code>message</code></br>
  24641. <em>
  24642. string
  24643. </em>
  24644. </td>
  24645. <td>
  24646. <em>(Optional)</em>
  24647. </td>
  24648. </tr>
  24649. <tr>
  24650. <td>
  24651. <code>lastTransitionTime</code></br>
  24652. <em>
  24653. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  24654. Kubernetes meta/v1.Time
  24655. </a>
  24656. </em>
  24657. </td>
  24658. <td>
  24659. <em>(Optional)</em>
  24660. </td>
  24661. </tr>
  24662. </tbody>
  24663. </table>
  24664. <h3 id="external-secrets.io/v1beta1.SecretsClient">SecretsClient
  24665. </h3>
  24666. <p>
  24667. <p>SecretsClient provides access to secrets.</p>
  24668. </p>
  24669. <h3 id="external-secrets.io/v1beta1.SecretsManager">SecretsManager
  24670. </h3>
  24671. <p>
  24672. (<em>Appears on:</em>
  24673. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  24674. </p>
  24675. <p>
  24676. <p>SecretsManager defines how the provider behaves when interacting with AWS
  24677. SecretsManager. Some of these settings are only applicable to controlling how
  24678. secrets are deleted, and hence only apply to PushSecret (and only when
  24679. deletionPolicy is set to Delete).</p>
  24680. </p>
  24681. <table>
  24682. <thead>
  24683. <tr>
  24684. <th>Field</th>
  24685. <th>Description</th>
  24686. </tr>
  24687. </thead>
  24688. <tbody>
  24689. <tr>
  24690. <td>
  24691. <code>forceDeleteWithoutRecovery</code></br>
  24692. <em>
  24693. bool
  24694. </em>
  24695. </td>
  24696. <td>
  24697. <em>(Optional)</em>
  24698. <p>Specifies whether to delete the secret without any recovery window. You
  24699. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  24700. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  24701. recovery window.
  24702. see: <a href="https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.html#SecretsManager-DeleteSecret-request-ForceDeleteWithoutRecovery">https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.html#SecretsManager-DeleteSecret-request-ForceDeleteWithoutRecovery</a></p>
  24703. </td>
  24704. </tr>
  24705. <tr>
  24706. <td>
  24707. <code>recoveryWindowInDays</code></br>
  24708. <em>
  24709. int64
  24710. </em>
  24711. </td>
  24712. <td>
  24713. <em>(Optional)</em>
  24714. <p>The number of days from 7 to 30 that Secrets Manager waits before
  24715. permanently deleting the secret. You can&rsquo;t use both this parameter and
  24716. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  24717. then by default Secrets Manager uses a 30 day recovery window.
  24718. see: <a href="https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.html#SecretsManager-DeleteSecret-request-RecoveryWindowInDays">https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.html#SecretsManager-DeleteSecret-request-RecoveryWindowInDays</a></p>
  24719. </td>
  24720. </tr>
  24721. </tbody>
  24722. </table>
  24723. <h3 id="external-secrets.io/v1beta1.SenhaseguraAuth">SenhaseguraAuth
  24724. </h3>
  24725. <p>
  24726. (<em>Appears on:</em>
  24727. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  24728. </p>
  24729. <p>
  24730. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  24731. </p>
  24732. <table>
  24733. <thead>
  24734. <tr>
  24735. <th>Field</th>
  24736. <th>Description</th>
  24737. </tr>
  24738. </thead>
  24739. <tbody>
  24740. <tr>
  24741. <td>
  24742. <code>clientId</code></br>
  24743. <em>
  24744. string
  24745. </em>
  24746. </td>
  24747. <td>
  24748. </td>
  24749. </tr>
  24750. <tr>
  24751. <td>
  24752. <code>clientSecretSecretRef</code></br>
  24753. <em>
  24754. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24755. External Secrets meta/v1.SecretKeySelector
  24756. </a>
  24757. </em>
  24758. </td>
  24759. <td>
  24760. </td>
  24761. </tr>
  24762. </tbody>
  24763. </table>
  24764. <h3 id="external-secrets.io/v1beta1.SenhaseguraModuleType">SenhaseguraModuleType
  24765. (<code>string</code> alias)</p></h3>
  24766. <p>
  24767. (<em>Appears on:</em>
  24768. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  24769. </p>
  24770. <p>
  24771. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  24772. </p>
  24773. <table>
  24774. <thead>
  24775. <tr>
  24776. <th>Value</th>
  24777. <th>Description</th>
  24778. </tr>
  24779. </thead>
  24780. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  24781. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  24782. see: https://senhasegura.com/devops
  24783. </code></pre>
  24784. </td>
  24785. </tr></tbody>
  24786. </table>
  24787. <h3 id="external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider
  24788. </h3>
  24789. <p>
  24790. (<em>Appears on:</em>
  24791. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24792. </p>
  24793. <p>
  24794. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  24795. </p>
  24796. <table>
  24797. <thead>
  24798. <tr>
  24799. <th>Field</th>
  24800. <th>Description</th>
  24801. </tr>
  24802. </thead>
  24803. <tbody>
  24804. <tr>
  24805. <td>
  24806. <code>url</code></br>
  24807. <em>
  24808. string
  24809. </em>
  24810. </td>
  24811. <td>
  24812. <p>URL of senhasegura</p>
  24813. </td>
  24814. </tr>
  24815. <tr>
  24816. <td>
  24817. <code>module</code></br>
  24818. <em>
  24819. <a href="#external-secrets.io/v1beta1.SenhaseguraModuleType">
  24820. SenhaseguraModuleType
  24821. </a>
  24822. </em>
  24823. </td>
  24824. <td>
  24825. <p>Module defines which senhasegura module should be used to get secrets</p>
  24826. </td>
  24827. </tr>
  24828. <tr>
  24829. <td>
  24830. <code>auth</code></br>
  24831. <em>
  24832. <a href="#external-secrets.io/v1beta1.SenhaseguraAuth">
  24833. SenhaseguraAuth
  24834. </a>
  24835. </em>
  24836. </td>
  24837. <td>
  24838. <p>Auth defines parameters to authenticate in senhasegura</p>
  24839. </td>
  24840. </tr>
  24841. <tr>
  24842. <td>
  24843. <code>ignoreSslCertificate</code></br>
  24844. <em>
  24845. bool
  24846. </em>
  24847. </td>
  24848. <td>
  24849. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  24850. </td>
  24851. </tr>
  24852. </tbody>
  24853. </table>
  24854. <h3 id="external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  24855. </h3>
  24856. <p>
  24857. (<em>Appears on:</em>
  24858. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  24859. </p>
  24860. <p>
  24861. <p>StoreGeneratorSourceRef allows you to override the source
  24862. from which the secret will be pulled from.
  24863. You can define at maximum one property.</p>
  24864. </p>
  24865. <table>
  24866. <thead>
  24867. <tr>
  24868. <th>Field</th>
  24869. <th>Description</th>
  24870. </tr>
  24871. </thead>
  24872. <tbody>
  24873. <tr>
  24874. <td>
  24875. <code>storeRef</code></br>
  24876. <em>
  24877. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  24878. SecretStoreRef
  24879. </a>
  24880. </em>
  24881. </td>
  24882. <td>
  24883. <em>(Optional)</em>
  24884. </td>
  24885. </tr>
  24886. <tr>
  24887. <td>
  24888. <code>generatorRef</code></br>
  24889. <em>
  24890. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  24891. GeneratorRef
  24892. </a>
  24893. </em>
  24894. </td>
  24895. <td>
  24896. <em>(Optional)</em>
  24897. <p>GeneratorRef points to a generator custom resource.</p>
  24898. </td>
  24899. </tr>
  24900. </tbody>
  24901. </table>
  24902. <h3 id="external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef
  24903. </h3>
  24904. <p>
  24905. (<em>Appears on:</em>
  24906. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>)
  24907. </p>
  24908. <p>
  24909. <p>StoreSourceRef allows you to override the SecretStore source
  24910. from which the secret will be pulled from.
  24911. You can define at maximum one property.</p>
  24912. </p>
  24913. <table>
  24914. <thead>
  24915. <tr>
  24916. <th>Field</th>
  24917. <th>Description</th>
  24918. </tr>
  24919. </thead>
  24920. <tbody>
  24921. <tr>
  24922. <td>
  24923. <code>storeRef</code></br>
  24924. <em>
  24925. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  24926. SecretStoreRef
  24927. </a>
  24928. </em>
  24929. </td>
  24930. <td>
  24931. <em>(Optional)</em>
  24932. </td>
  24933. </tr>
  24934. <tr>
  24935. <td>
  24936. <code>generatorRef</code></br>
  24937. <em>
  24938. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  24939. GeneratorRef
  24940. </a>
  24941. </em>
  24942. </td>
  24943. <td>
  24944. <p>GeneratorRef points to a generator custom resource.</p>
  24945. <p>Deprecated: The generatorRef is not implemented in .data[].
  24946. this will be removed with v1.</p>
  24947. </td>
  24948. </tr>
  24949. </tbody>
  24950. </table>
  24951. <h3 id="external-secrets.io/v1beta1.Tag">Tag
  24952. </h3>
  24953. <p>
  24954. <p>Tag defines a tag key and value for AWS resources.</p>
  24955. </p>
  24956. <table>
  24957. <thead>
  24958. <tr>
  24959. <th>Field</th>
  24960. <th>Description</th>
  24961. </tr>
  24962. </thead>
  24963. <tbody>
  24964. <tr>
  24965. <td>
  24966. <code>key</code></br>
  24967. <em>
  24968. string
  24969. </em>
  24970. </td>
  24971. <td>
  24972. </td>
  24973. </tr>
  24974. <tr>
  24975. <td>
  24976. <code>value</code></br>
  24977. <em>
  24978. string
  24979. </em>
  24980. </td>
  24981. <td>
  24982. </td>
  24983. </tr>
  24984. </tbody>
  24985. </table>
  24986. <h3 id="external-secrets.io/v1beta1.TemplateEngineVersion">TemplateEngineVersion
  24987. (<code>string</code> alias)</p></h3>
  24988. <p>
  24989. (<em>Appears on:</em>
  24990. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  24991. </p>
  24992. <p>
  24993. <p>TemplateEngineVersion defines the version of the template engine to use.</p>
  24994. </p>
  24995. <table>
  24996. <thead>
  24997. <tr>
  24998. <th>Value</th>
  24999. <th>Description</th>
  25000. </tr>
  25001. </thead>
  25002. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  25003. <td><p>TemplateEngineV2 specifies the v2 template engine version.</p>
  25004. </td>
  25005. </tr></tbody>
  25006. </table>
  25007. <h3 id="external-secrets.io/v1beta1.TemplateFrom">TemplateFrom
  25008. </h3>
  25009. <p>
  25010. (<em>Appears on:</em>
  25011. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25012. </p>
  25013. <p>
  25014. <p>TemplateFrom defines a source for template data.</p>
  25015. </p>
  25016. <table>
  25017. <thead>
  25018. <tr>
  25019. <th>Field</th>
  25020. <th>Description</th>
  25021. </tr>
  25022. </thead>
  25023. <tbody>
  25024. <tr>
  25025. <td>
  25026. <code>configMap</code></br>
  25027. <em>
  25028. <a href="#external-secrets.io/v1beta1.TemplateRef">
  25029. TemplateRef
  25030. </a>
  25031. </em>
  25032. </td>
  25033. <td>
  25034. </td>
  25035. </tr>
  25036. <tr>
  25037. <td>
  25038. <code>secret</code></br>
  25039. <em>
  25040. <a href="#external-secrets.io/v1beta1.TemplateRef">
  25041. TemplateRef
  25042. </a>
  25043. </em>
  25044. </td>
  25045. <td>
  25046. </td>
  25047. </tr>
  25048. <tr>
  25049. <td>
  25050. <code>target</code></br>
  25051. <em>
  25052. <a href="#external-secrets.io/v1beta1.TemplateTarget">
  25053. TemplateTarget
  25054. </a>
  25055. </em>
  25056. </td>
  25057. <td>
  25058. <em>(Optional)</em>
  25059. </td>
  25060. </tr>
  25061. <tr>
  25062. <td>
  25063. <code>literal</code></br>
  25064. <em>
  25065. string
  25066. </em>
  25067. </td>
  25068. <td>
  25069. <em>(Optional)</em>
  25070. </td>
  25071. </tr>
  25072. </tbody>
  25073. </table>
  25074. <h3 id="external-secrets.io/v1beta1.TemplateMergePolicy">TemplateMergePolicy
  25075. (<code>string</code> alias)</p></h3>
  25076. <p>
  25077. (<em>Appears on:</em>
  25078. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25079. </p>
  25080. <p>
  25081. <p>TemplateMergePolicy defines how template values should be merged when generating a secret.</p>
  25082. </p>
  25083. <table>
  25084. <thead>
  25085. <tr>
  25086. <th>Value</th>
  25087. <th>Description</th>
  25088. </tr>
  25089. </thead>
  25090. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  25091. <td><p>MergePolicyMerge merges the template content with existing values.</p>
  25092. </td>
  25093. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  25094. <td><p>MergePolicyReplace replaces the entire template content during merge operations.</p>
  25095. </td>
  25096. </tr></tbody>
  25097. </table>
  25098. <h3 id="external-secrets.io/v1beta1.TemplateRef">TemplateRef
  25099. </h3>
  25100. <p>
  25101. (<em>Appears on:</em>
  25102. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  25103. </p>
  25104. <p>
  25105. <p>TemplateRef defines a reference to a template source in a ConfigMap or Secret.</p>
  25106. </p>
  25107. <table>
  25108. <thead>
  25109. <tr>
  25110. <th>Field</th>
  25111. <th>Description</th>
  25112. </tr>
  25113. </thead>
  25114. <tbody>
  25115. <tr>
  25116. <td>
  25117. <code>name</code></br>
  25118. <em>
  25119. string
  25120. </em>
  25121. </td>
  25122. <td>
  25123. <p>The name of the ConfigMap/Secret resource</p>
  25124. </td>
  25125. </tr>
  25126. <tr>
  25127. <td>
  25128. <code>items</code></br>
  25129. <em>
  25130. <a href="#external-secrets.io/v1beta1.TemplateRefItem">
  25131. []TemplateRefItem
  25132. </a>
  25133. </em>
  25134. </td>
  25135. <td>
  25136. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  25137. </td>
  25138. </tr>
  25139. </tbody>
  25140. </table>
  25141. <h3 id="external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem
  25142. </h3>
  25143. <p>
  25144. (<em>Appears on:</em>
  25145. <a href="#external-secrets.io/v1beta1.TemplateRef">TemplateRef</a>)
  25146. </p>
  25147. <p>
  25148. <p>TemplateRefItem defines which key in the referenced ConfigMap or Secret to use as a template.</p>
  25149. </p>
  25150. <table>
  25151. <thead>
  25152. <tr>
  25153. <th>Field</th>
  25154. <th>Description</th>
  25155. </tr>
  25156. </thead>
  25157. <tbody>
  25158. <tr>
  25159. <td>
  25160. <code>key</code></br>
  25161. <em>
  25162. string
  25163. </em>
  25164. </td>
  25165. <td>
  25166. <p>A key in the ConfigMap/Secret</p>
  25167. </td>
  25168. </tr>
  25169. <tr>
  25170. <td>
  25171. <code>templateAs</code></br>
  25172. <em>
  25173. <a href="#external-secrets.io/v1beta1.TemplateScope">
  25174. TemplateScope
  25175. </a>
  25176. </em>
  25177. </td>
  25178. <td>
  25179. </td>
  25180. </tr>
  25181. </tbody>
  25182. </table>
  25183. <h3 id="external-secrets.io/v1beta1.TemplateScope">TemplateScope
  25184. (<code>string</code> alias)</p></h3>
  25185. <p>
  25186. (<em>Appears on:</em>
  25187. <a href="#external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem</a>)
  25188. </p>
  25189. <p>
  25190. <p>TemplateScope defines the scope of the template when processing template data.</p>
  25191. </p>
  25192. <table>
  25193. <thead>
  25194. <tr>
  25195. <th>Value</th>
  25196. <th>Description</th>
  25197. </tr>
  25198. </thead>
  25199. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  25200. <td><p>TemplateScopeKeysAndValues processes both keys and values of the data.</p>
  25201. </td>
  25202. </tr><tr><td><p>&#34;Values&#34;</p></td>
  25203. <td><p>TemplateScopeValues processes only the values of the data.</p>
  25204. </td>
  25205. </tr></tbody>
  25206. </table>
  25207. <h3 id="external-secrets.io/v1beta1.TemplateTarget">TemplateTarget
  25208. (<code>string</code> alias)</p></h3>
  25209. <p>
  25210. (<em>Appears on:</em>
  25211. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  25212. </p>
  25213. <p>
  25214. <p>TemplateTarget defines the target field where the template result will be stored.</p>
  25215. </p>
  25216. <table>
  25217. <thead>
  25218. <tr>
  25219. <th>Value</th>
  25220. <th>Description</th>
  25221. </tr>
  25222. </thead>
  25223. <tbody><tr><td><p>&#34;Annotations&#34;</p></td>
  25224. <td><p>TemplateTargetAnnotations stores template results in the annotations field of the secret.</p>
  25225. </td>
  25226. </tr><tr><td><p>&#34;Data&#34;</p></td>
  25227. <td><p>TemplateTargetData stores template results in the data field of the secret.</p>
  25228. </td>
  25229. </tr><tr><td><p>&#34;Labels&#34;</p></td>
  25230. <td><p>TemplateTargetLabels stores template results in the labels field of the secret.</p>
  25231. </td>
  25232. </tr></tbody>
  25233. </table>
  25234. <h3 id="external-secrets.io/v1beta1.TokenAuth">TokenAuth
  25235. </h3>
  25236. <p>
  25237. (<em>Appears on:</em>
  25238. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  25239. </p>
  25240. <p>
  25241. <p>TokenAuth defines token-based authentication for the Kubernetes provider.</p>
  25242. </p>
  25243. <table>
  25244. <thead>
  25245. <tr>
  25246. <th>Field</th>
  25247. <th>Description</th>
  25248. </tr>
  25249. </thead>
  25250. <tbody>
  25251. <tr>
  25252. <td>
  25253. <code>bearerToken</code></br>
  25254. <em>
  25255. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25256. External Secrets meta/v1.SecretKeySelector
  25257. </a>
  25258. </em>
  25259. </td>
  25260. <td>
  25261. </td>
  25262. </tr>
  25263. </tbody>
  25264. </table>
  25265. <h3 id="external-secrets.io/v1beta1.UniversalAuthCredentials">UniversalAuthCredentials
  25266. </h3>
  25267. <p>
  25268. (<em>Appears on:</em>
  25269. <a href="#external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth</a>)
  25270. </p>
  25271. <p>
  25272. <p>UniversalAuthCredentials defines the credentials for Infisical Universal Auth.</p>
  25273. </p>
  25274. <table>
  25275. <thead>
  25276. <tr>
  25277. <th>Field</th>
  25278. <th>Description</th>
  25279. </tr>
  25280. </thead>
  25281. <tbody>
  25282. <tr>
  25283. <td>
  25284. <code>clientId</code></br>
  25285. <em>
  25286. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25287. External Secrets meta/v1.SecretKeySelector
  25288. </a>
  25289. </em>
  25290. </td>
  25291. <td>
  25292. </td>
  25293. </tr>
  25294. <tr>
  25295. <td>
  25296. <code>clientSecret</code></br>
  25297. <em>
  25298. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25299. External Secrets meta/v1.SecretKeySelector
  25300. </a>
  25301. </em>
  25302. </td>
  25303. <td>
  25304. </td>
  25305. </tr>
  25306. </tbody>
  25307. </table>
  25308. <h3 id="external-secrets.io/v1beta1.ValidationResult">ValidationResult
  25309. (<code>byte</code> alias)</p></h3>
  25310. <p>
  25311. <p>ValidationResult represents the result of validating a provider client configuration.</p>
  25312. </p>
  25313. <table>
  25314. <thead>
  25315. <tr>
  25316. <th>Value</th>
  25317. <th>Description</th>
  25318. </tr>
  25319. </thead>
  25320. <tbody><tr><td><p>2</p></td>
  25321. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  25322. </td>
  25323. </tr><tr><td><p>0</p></td>
  25324. <td><p>ValidationResultReady indicates that the client is configured correctly and can be used.</p>
  25325. </td>
  25326. </tr><tr><td><p>1</p></td>
  25327. <td><p>ValidationResultUnknown indicates that the client can be used but information is missing and it can not be validated.</p>
  25328. </td>
  25329. </tr></tbody>
  25330. </table>
  25331. <h3 id="external-secrets.io/v1beta1.VaultAppRole">VaultAppRole
  25332. </h3>
  25333. <p>
  25334. (<em>Appears on:</em>
  25335. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25336. </p>
  25337. <p>
  25338. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  25339. with the role and secret stored in a Kubernetes Secret resource.</p>
  25340. </p>
  25341. <table>
  25342. <thead>
  25343. <tr>
  25344. <th>Field</th>
  25345. <th>Description</th>
  25346. </tr>
  25347. </thead>
  25348. <tbody>
  25349. <tr>
  25350. <td>
  25351. <code>path</code></br>
  25352. <em>
  25353. string
  25354. </em>
  25355. </td>
  25356. <td>
  25357. <p>Path where the App Role authentication backend is mounted
  25358. in Vault, e.g: &ldquo;approle&rdquo;</p>
  25359. </td>
  25360. </tr>
  25361. <tr>
  25362. <td>
  25363. <code>roleId</code></br>
  25364. <em>
  25365. string
  25366. </em>
  25367. </td>
  25368. <td>
  25369. <em>(Optional)</em>
  25370. <p>RoleID configured in the App Role authentication backend when setting
  25371. up the authentication backend in Vault.</p>
  25372. </td>
  25373. </tr>
  25374. <tr>
  25375. <td>
  25376. <code>roleRef</code></br>
  25377. <em>
  25378. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25379. External Secrets meta/v1.SecretKeySelector
  25380. </a>
  25381. </em>
  25382. </td>
  25383. <td>
  25384. <em>(Optional)</em>
  25385. <p>Reference to a key in a Secret that contains the App Role ID used
  25386. to authenticate with Vault.
  25387. The <code>key</code> field must be specified and denotes which entry within the Secret
  25388. resource is used as the app role id.</p>
  25389. </td>
  25390. </tr>
  25391. <tr>
  25392. <td>
  25393. <code>secretRef</code></br>
  25394. <em>
  25395. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25396. External Secrets meta/v1.SecretKeySelector
  25397. </a>
  25398. </em>
  25399. </td>
  25400. <td>
  25401. <p>Reference to a key in a Secret that contains the App Role secret used
  25402. to authenticate with Vault.
  25403. The <code>key</code> field must be specified and denotes which entry within the Secret
  25404. resource is used as the app role secret.</p>
  25405. </td>
  25406. </tr>
  25407. </tbody>
  25408. </table>
  25409. <h3 id="external-secrets.io/v1beta1.VaultAuth">VaultAuth
  25410. </h3>
  25411. <p>
  25412. (<em>Appears on:</em>
  25413. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  25414. </p>
  25415. <p>
  25416. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  25417. Only one of <code>tokenSecretRef</code>, <code>appRole</code>, <code>kubernetes</code>, <code>ldap</code>, <code>userPass</code>, <code>jwt</code> or <code>cert</code>
  25418. can be specified. A namespace to authenticate against can optionally be specified.</p>
  25419. </p>
  25420. <table>
  25421. <thead>
  25422. <tr>
  25423. <th>Field</th>
  25424. <th>Description</th>
  25425. </tr>
  25426. </thead>
  25427. <tbody>
  25428. <tr>
  25429. <td>
  25430. <code>namespace</code></br>
  25431. <em>
  25432. string
  25433. </em>
  25434. </td>
  25435. <td>
  25436. <em>(Optional)</em>
  25437. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  25438. Namespaces is a set of features within Vault Enterprise that allows
  25439. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  25440. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  25441. This will default to Vault.Namespace field if set, or empty otherwise</p>
  25442. </td>
  25443. </tr>
  25444. <tr>
  25445. <td>
  25446. <code>tokenSecretRef</code></br>
  25447. <em>
  25448. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25449. External Secrets meta/v1.SecretKeySelector
  25450. </a>
  25451. </em>
  25452. </td>
  25453. <td>
  25454. <em>(Optional)</em>
  25455. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  25456. </td>
  25457. </tr>
  25458. <tr>
  25459. <td>
  25460. <code>appRole</code></br>
  25461. <em>
  25462. <a href="#external-secrets.io/v1beta1.VaultAppRole">
  25463. VaultAppRole
  25464. </a>
  25465. </em>
  25466. </td>
  25467. <td>
  25468. <em>(Optional)</em>
  25469. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  25470. with the role and secret stored in a Kubernetes Secret resource.</p>
  25471. </td>
  25472. </tr>
  25473. <tr>
  25474. <td>
  25475. <code>kubernetes</code></br>
  25476. <em>
  25477. <a href="#external-secrets.io/v1beta1.VaultKubernetesAuth">
  25478. VaultKubernetesAuth
  25479. </a>
  25480. </em>
  25481. </td>
  25482. <td>
  25483. <em>(Optional)</em>
  25484. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  25485. token stored in the named Secret resource to the Vault server.</p>
  25486. </td>
  25487. </tr>
  25488. <tr>
  25489. <td>
  25490. <code>ldap</code></br>
  25491. <em>
  25492. <a href="#external-secrets.io/v1beta1.VaultLdapAuth">
  25493. VaultLdapAuth
  25494. </a>
  25495. </em>
  25496. </td>
  25497. <td>
  25498. <em>(Optional)</em>
  25499. <p>Ldap authenticates with Vault by passing username/password pair using
  25500. the LDAP authentication method</p>
  25501. </td>
  25502. </tr>
  25503. <tr>
  25504. <td>
  25505. <code>jwt</code></br>
  25506. <em>
  25507. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">
  25508. VaultJwtAuth
  25509. </a>
  25510. </em>
  25511. </td>
  25512. <td>
  25513. <em>(Optional)</em>
  25514. <p>Jwt authenticates with Vault by passing role and JWT token using the
  25515. JWT/OIDC authentication method</p>
  25516. </td>
  25517. </tr>
  25518. <tr>
  25519. <td>
  25520. <code>cert</code></br>
  25521. <em>
  25522. <a href="#external-secrets.io/v1beta1.VaultCertAuth">
  25523. VaultCertAuth
  25524. </a>
  25525. </em>
  25526. </td>
  25527. <td>
  25528. <em>(Optional)</em>
  25529. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  25530. Cert authentication method</p>
  25531. </td>
  25532. </tr>
  25533. <tr>
  25534. <td>
  25535. <code>iam</code></br>
  25536. <em>
  25537. <a href="#external-secrets.io/v1beta1.VaultIamAuth">
  25538. VaultIamAuth
  25539. </a>
  25540. </em>
  25541. </td>
  25542. <td>
  25543. <em>(Optional)</em>
  25544. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  25545. AWS IAM authentication method</p>
  25546. </td>
  25547. </tr>
  25548. <tr>
  25549. <td>
  25550. <code>userPass</code></br>
  25551. <em>
  25552. <a href="#external-secrets.io/v1beta1.VaultUserPassAuth">
  25553. VaultUserPassAuth
  25554. </a>
  25555. </em>
  25556. </td>
  25557. <td>
  25558. <em>(Optional)</em>
  25559. <p>UserPass authenticates with Vault by passing username/password pair</p>
  25560. </td>
  25561. </tr>
  25562. </tbody>
  25563. </table>
  25564. <h3 id="external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth
  25565. </h3>
  25566. <p>
  25567. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  25568. Only one of secretRef or jwt can be specified.
  25569. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  25570. </p>
  25571. <table>
  25572. <thead>
  25573. <tr>
  25574. <th>Field</th>
  25575. <th>Description</th>
  25576. </tr>
  25577. </thead>
  25578. <tbody>
  25579. <tr>
  25580. <td>
  25581. <code>secretRef</code></br>
  25582. <em>
  25583. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  25584. VaultAwsAuthSecretRef
  25585. </a>
  25586. </em>
  25587. </td>
  25588. <td>
  25589. <em>(Optional)</em>
  25590. </td>
  25591. </tr>
  25592. <tr>
  25593. <td>
  25594. <code>jwt</code></br>
  25595. <em>
  25596. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  25597. VaultAwsJWTAuth
  25598. </a>
  25599. </em>
  25600. </td>
  25601. <td>
  25602. <em>(Optional)</em>
  25603. </td>
  25604. </tr>
  25605. </tbody>
  25606. </table>
  25607. <h3 id="external-secrets.io/v1beta1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  25608. </h3>
  25609. <p>
  25610. (<em>Appears on:</em>
  25611. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  25612. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  25613. </p>
  25614. <p>
  25615. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  25616. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  25617. </p>
  25618. <table>
  25619. <thead>
  25620. <tr>
  25621. <th>Field</th>
  25622. <th>Description</th>
  25623. </tr>
  25624. </thead>
  25625. <tbody>
  25626. <tr>
  25627. <td>
  25628. <code>accessKeyIDSecretRef</code></br>
  25629. <em>
  25630. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25631. External Secrets meta/v1.SecretKeySelector
  25632. </a>
  25633. </em>
  25634. </td>
  25635. <td>
  25636. <em>(Optional)</em>
  25637. <p>The AccessKeyID is used for authentication</p>
  25638. </td>
  25639. </tr>
  25640. <tr>
  25641. <td>
  25642. <code>secretAccessKeySecretRef</code></br>
  25643. <em>
  25644. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25645. External Secrets meta/v1.SecretKeySelector
  25646. </a>
  25647. </em>
  25648. </td>
  25649. <td>
  25650. <em>(Optional)</em>
  25651. <p>The SecretAccessKey is used for authentication</p>
  25652. </td>
  25653. </tr>
  25654. <tr>
  25655. <td>
  25656. <code>sessionTokenSecretRef</code></br>
  25657. <em>
  25658. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25659. External Secrets meta/v1.SecretKeySelector
  25660. </a>
  25661. </em>
  25662. </td>
  25663. <td>
  25664. <em>(Optional)</em>
  25665. <p>The SessionToken used for authentication
  25666. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  25667. see: <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html">https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html</a></p>
  25668. </td>
  25669. </tr>
  25670. </tbody>
  25671. </table>
  25672. <h3 id="external-secrets.io/v1beta1.VaultAwsJWTAuth">VaultAwsJWTAuth
  25673. </h3>
  25674. <p>
  25675. (<em>Appears on:</em>
  25676. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  25677. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  25678. </p>
  25679. <p>
  25680. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  25681. </p>
  25682. <table>
  25683. <thead>
  25684. <tr>
  25685. <th>Field</th>
  25686. <th>Description</th>
  25687. </tr>
  25688. </thead>
  25689. <tbody>
  25690. <tr>
  25691. <td>
  25692. <code>serviceAccountRef</code></br>
  25693. <em>
  25694. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  25695. External Secrets meta/v1.ServiceAccountSelector
  25696. </a>
  25697. </em>
  25698. </td>
  25699. <td>
  25700. <em>(Optional)</em>
  25701. </td>
  25702. </tr>
  25703. </tbody>
  25704. </table>
  25705. <h3 id="external-secrets.io/v1beta1.VaultCertAuth">VaultCertAuth
  25706. </h3>
  25707. <p>
  25708. (<em>Appears on:</em>
  25709. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25710. </p>
  25711. <p>
  25712. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  25713. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  25714. </p>
  25715. <table>
  25716. <thead>
  25717. <tr>
  25718. <th>Field</th>
  25719. <th>Description</th>
  25720. </tr>
  25721. </thead>
  25722. <tbody>
  25723. <tr>
  25724. <td>
  25725. <code>clientCert</code></br>
  25726. <em>
  25727. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25728. External Secrets meta/v1.SecretKeySelector
  25729. </a>
  25730. </em>
  25731. </td>
  25732. <td>
  25733. <em>(Optional)</em>
  25734. <p>ClientCert is a certificate to authenticate using the Cert Vault
  25735. authentication method</p>
  25736. </td>
  25737. </tr>
  25738. <tr>
  25739. <td>
  25740. <code>secretRef</code></br>
  25741. <em>
  25742. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25743. External Secrets meta/v1.SecretKeySelector
  25744. </a>
  25745. </em>
  25746. </td>
  25747. <td>
  25748. <em>(Optional)</em>
  25749. <p>SecretRef to a key in a Secret resource containing client private key to
  25750. authenticate with Vault using the Cert authentication method</p>
  25751. </td>
  25752. </tr>
  25753. </tbody>
  25754. </table>
  25755. <h3 id="external-secrets.io/v1beta1.VaultClientTLS">VaultClientTLS
  25756. </h3>
  25757. <p>
  25758. (<em>Appears on:</em>
  25759. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  25760. </p>
  25761. <p>
  25762. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  25763. when the Vault server requires mutual authentication.</p>
  25764. </p>
  25765. <table>
  25766. <thead>
  25767. <tr>
  25768. <th>Field</th>
  25769. <th>Description</th>
  25770. </tr>
  25771. </thead>
  25772. <tbody>
  25773. <tr>
  25774. <td>
  25775. <code>certSecretRef</code></br>
  25776. <em>
  25777. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25778. External Secrets meta/v1.SecretKeySelector
  25779. </a>
  25780. </em>
  25781. </td>
  25782. <td>
  25783. <em>(Optional)</em>
  25784. <p>CertSecretRef is a certificate added to the transport layer
  25785. when communicating with the Vault server.
  25786. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  25787. </td>
  25788. </tr>
  25789. <tr>
  25790. <td>
  25791. <code>keySecretRef</code></br>
  25792. <em>
  25793. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25794. External Secrets meta/v1.SecretKeySelector
  25795. </a>
  25796. </em>
  25797. </td>
  25798. <td>
  25799. <em>(Optional)</em>
  25800. <p>KeySecretRef to a key in a Secret resource containing client private key
  25801. added to the transport layer when communicating with the Vault server.
  25802. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  25803. </td>
  25804. </tr>
  25805. </tbody>
  25806. </table>
  25807. <h3 id="external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth
  25808. </h3>
  25809. <p>
  25810. (<em>Appears on:</em>
  25811. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25812. </p>
  25813. <p>
  25814. <p>VaultIamAuth authenticates with Vault using the Vault&rsquo;s AWS IAM authentication method. Refer: <a href="https://developer.hashicorp.com/vault/docs/auth/aws">https://developer.hashicorp.com/vault/docs/auth/aws</a></p>
  25815. </p>
  25816. <table>
  25817. <thead>
  25818. <tr>
  25819. <th>Field</th>
  25820. <th>Description</th>
  25821. </tr>
  25822. </thead>
  25823. <tbody>
  25824. <tr>
  25825. <td>
  25826. <code>path</code></br>
  25827. <em>
  25828. string
  25829. </em>
  25830. </td>
  25831. <td>
  25832. <em>(Optional)</em>
  25833. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  25834. </td>
  25835. </tr>
  25836. <tr>
  25837. <td>
  25838. <code>region</code></br>
  25839. <em>
  25840. string
  25841. </em>
  25842. </td>
  25843. <td>
  25844. <em>(Optional)</em>
  25845. <p>AWS region</p>
  25846. </td>
  25847. </tr>
  25848. <tr>
  25849. <td>
  25850. <code>role</code></br>
  25851. <em>
  25852. string
  25853. </em>
  25854. </td>
  25855. <td>
  25856. <em>(Optional)</em>
  25857. <p>This is the AWS role to be assumed before talking to vault</p>
  25858. </td>
  25859. </tr>
  25860. <tr>
  25861. <td>
  25862. <code>vaultRole</code></br>
  25863. <em>
  25864. string
  25865. </em>
  25866. </td>
  25867. <td>
  25868. <p>Vault Role. In vault, a role describes an identity with a set of permissions, groups, or policies you want to attach a user of the secrets engine</p>
  25869. </td>
  25870. </tr>
  25871. <tr>
  25872. <td>
  25873. <code>externalID</code></br>
  25874. <em>
  25875. string
  25876. </em>
  25877. </td>
  25878. <td>
  25879. <p>AWS External ID set on assumed IAM roles</p>
  25880. </td>
  25881. </tr>
  25882. <tr>
  25883. <td>
  25884. <code>vaultAwsIamServerID</code></br>
  25885. <em>
  25886. string
  25887. </em>
  25888. </td>
  25889. <td>
  25890. <em>(Optional)</em>
  25891. <p>X-Vault-AWS-IAM-Server-ID is an additional header used by Vault IAM auth method to mitigate against different types of replay attacks. More details here: <a href="https://developer.hashicorp.com/vault/docs/auth/aws">https://developer.hashicorp.com/vault/docs/auth/aws</a></p>
  25892. </td>
  25893. </tr>
  25894. <tr>
  25895. <td>
  25896. <code>secretRef</code></br>
  25897. <em>
  25898. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  25899. VaultAwsAuthSecretRef
  25900. </a>
  25901. </em>
  25902. </td>
  25903. <td>
  25904. <em>(Optional)</em>
  25905. <p>Specify credentials in a Secret object</p>
  25906. </td>
  25907. </tr>
  25908. <tr>
  25909. <td>
  25910. <code>jwt</code></br>
  25911. <em>
  25912. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  25913. VaultAwsJWTAuth
  25914. </a>
  25915. </em>
  25916. </td>
  25917. <td>
  25918. <em>(Optional)</em>
  25919. <p>Specify a service account with IRSA enabled</p>
  25920. </td>
  25921. </tr>
  25922. </tbody>
  25923. </table>
  25924. <h3 id="external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth
  25925. </h3>
  25926. <p>
  25927. (<em>Appears on:</em>
  25928. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25929. </p>
  25930. <p>
  25931. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  25932. method, with the role name and a token stored in a Kubernetes Secret resource or
  25933. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  25934. </p>
  25935. <table>
  25936. <thead>
  25937. <tr>
  25938. <th>Field</th>
  25939. <th>Description</th>
  25940. </tr>
  25941. </thead>
  25942. <tbody>
  25943. <tr>
  25944. <td>
  25945. <code>path</code></br>
  25946. <em>
  25947. string
  25948. </em>
  25949. </td>
  25950. <td>
  25951. <p>Path where the JWT authentication backend is mounted
  25952. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  25953. </td>
  25954. </tr>
  25955. <tr>
  25956. <td>
  25957. <code>role</code></br>
  25958. <em>
  25959. string
  25960. </em>
  25961. </td>
  25962. <td>
  25963. <em>(Optional)</em>
  25964. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  25965. authentication method</p>
  25966. </td>
  25967. </tr>
  25968. <tr>
  25969. <td>
  25970. <code>secretRef</code></br>
  25971. <em>
  25972. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25973. External Secrets meta/v1.SecretKeySelector
  25974. </a>
  25975. </em>
  25976. </td>
  25977. <td>
  25978. <em>(Optional)</em>
  25979. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  25980. authenticate with Vault using the JWT/OIDC authentication method.</p>
  25981. </td>
  25982. </tr>
  25983. <tr>
  25984. <td>
  25985. <code>kubernetesServiceAccountToken</code></br>
  25986. <em>
  25987. <a href="#external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">
  25988. VaultKubernetesServiceAccountTokenAuth
  25989. </a>
  25990. </em>
  25991. </td>
  25992. <td>
  25993. <em>(Optional)</em>
  25994. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  25995. a token for with the <code>TokenRequest</code> API.</p>
  25996. </td>
  25997. </tr>
  25998. </tbody>
  25999. </table>
  26000. <h3 id="external-secrets.io/v1beta1.VaultKVStoreVersion">VaultKVStoreVersion
  26001. (<code>string</code> alias)</p></h3>
  26002. <p>
  26003. (<em>Appears on:</em>
  26004. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  26005. </p>
  26006. <p>
  26007. <p>VaultKVStoreVersion defines the version of the KV store in Vault.</p>
  26008. </p>
  26009. <table>
  26010. <thead>
  26011. <tr>
  26012. <th>Value</th>
  26013. <th>Description</th>
  26014. </tr>
  26015. </thead>
  26016. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  26017. <td><p>VaultKVStoreV1 represents version 1 of the Vault KV store.</p>
  26018. </td>
  26019. </tr><tr><td><p>&#34;v2&#34;</p></td>
  26020. <td><p>VaultKVStoreV2 represents version 2 of the Vault KV store.</p>
  26021. </td>
  26022. </tr></tbody>
  26023. </table>
  26024. <h3 id="external-secrets.io/v1beta1.VaultKubernetesAuth">VaultKubernetesAuth
  26025. </h3>
  26026. <p>
  26027. (<em>Appears on:</em>
  26028. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26029. </p>
  26030. <p>
  26031. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in a Secret.</p>
  26032. </p>
  26033. <table>
  26034. <thead>
  26035. <tr>
  26036. <th>Field</th>
  26037. <th>Description</th>
  26038. </tr>
  26039. </thead>
  26040. <tbody>
  26041. <tr>
  26042. <td>
  26043. <code>mountPath</code></br>
  26044. <em>
  26045. string
  26046. </em>
  26047. </td>
  26048. <td>
  26049. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  26050. &ldquo;kubernetes&rdquo;</p>
  26051. </td>
  26052. </tr>
  26053. <tr>
  26054. <td>
  26055. <code>serviceAccountRef</code></br>
  26056. <em>
  26057. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26058. External Secrets meta/v1.ServiceAccountSelector
  26059. </a>
  26060. </em>
  26061. </td>
  26062. <td>
  26063. <em>(Optional)</em>
  26064. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  26065. If the service account is specified, the service account secret token JWT will be used
  26066. for authenticating with Vault. If the service account selector is not supplied,
  26067. the secretRef will be used instead.</p>
  26068. </td>
  26069. </tr>
  26070. <tr>
  26071. <td>
  26072. <code>secretRef</code></br>
  26073. <em>
  26074. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26075. External Secrets meta/v1.SecretKeySelector
  26076. </a>
  26077. </em>
  26078. </td>
  26079. <td>
  26080. <em>(Optional)</em>
  26081. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  26082. for authenticating with Vault. If a name is specified without a key,
  26083. <code>token</code> is the default. If one is not specified, the one bound to
  26084. the controller will be used.</p>
  26085. </td>
  26086. </tr>
  26087. <tr>
  26088. <td>
  26089. <code>role</code></br>
  26090. <em>
  26091. string
  26092. </em>
  26093. </td>
  26094. <td>
  26095. <p>A required field containing the Vault Role to assume. A Role binds a
  26096. Kubernetes ServiceAccount with a set of Vault policies.</p>
  26097. </td>
  26098. </tr>
  26099. </tbody>
  26100. </table>
  26101. <h3 id="external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  26102. </h3>
  26103. <p>
  26104. (<em>Appears on:</em>
  26105. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth</a>)
  26106. </p>
  26107. <p>
  26108. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  26109. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  26110. </p>
  26111. <table>
  26112. <thead>
  26113. <tr>
  26114. <th>Field</th>
  26115. <th>Description</th>
  26116. </tr>
  26117. </thead>
  26118. <tbody>
  26119. <tr>
  26120. <td>
  26121. <code>serviceAccountRef</code></br>
  26122. <em>
  26123. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26124. External Secrets meta/v1.ServiceAccountSelector
  26125. </a>
  26126. </em>
  26127. </td>
  26128. <td>
  26129. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  26130. </td>
  26131. </tr>
  26132. <tr>
  26133. <td>
  26134. <code>audiences</code></br>
  26135. <em>
  26136. []string
  26137. </em>
  26138. </td>
  26139. <td>
  26140. <em>(Optional)</em>
  26141. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  26142. account token for the service account referenced by <code>serviceAccountRef</code>.
  26143. Defaults to a single audience <code>vault</code> it not specified.</p>
  26144. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  26145. </td>
  26146. </tr>
  26147. <tr>
  26148. <td>
  26149. <code>expirationSeconds</code></br>
  26150. <em>
  26151. int64
  26152. </em>
  26153. </td>
  26154. <td>
  26155. <em>(Optional)</em>
  26156. <p>Optional expiration time in seconds that will be used to request a temporary
  26157. Kubernetes service account token for the service account referenced by
  26158. <code>serviceAccountRef</code>.</p>
  26159. <p>Deprecated: this will be removed in the future.
  26160. Defaults to 10 minutes.</p>
  26161. </td>
  26162. </tr>
  26163. </tbody>
  26164. </table>
  26165. <h3 id="external-secrets.io/v1beta1.VaultLdapAuth">VaultLdapAuth
  26166. </h3>
  26167. <p>
  26168. (<em>Appears on:</em>
  26169. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26170. </p>
  26171. <p>
  26172. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  26173. with the username and password stored in a Kubernetes Secret resource.</p>
  26174. </p>
  26175. <table>
  26176. <thead>
  26177. <tr>
  26178. <th>Field</th>
  26179. <th>Description</th>
  26180. </tr>
  26181. </thead>
  26182. <tbody>
  26183. <tr>
  26184. <td>
  26185. <code>path</code></br>
  26186. <em>
  26187. string
  26188. </em>
  26189. </td>
  26190. <td>
  26191. <p>Path where the LDAP authentication backend is mounted
  26192. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  26193. </td>
  26194. </tr>
  26195. <tr>
  26196. <td>
  26197. <code>username</code></br>
  26198. <em>
  26199. string
  26200. </em>
  26201. </td>
  26202. <td>
  26203. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  26204. authentication method</p>
  26205. </td>
  26206. </tr>
  26207. <tr>
  26208. <td>
  26209. <code>secretRef</code></br>
  26210. <em>
  26211. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26212. External Secrets meta/v1.SecretKeySelector
  26213. </a>
  26214. </em>
  26215. </td>
  26216. <td>
  26217. <em>(Optional)</em>
  26218. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  26219. user used to authenticate with Vault using the LDAP authentication
  26220. method</p>
  26221. </td>
  26222. </tr>
  26223. </tbody>
  26224. </table>
  26225. <h3 id="external-secrets.io/v1beta1.VaultProvider">VaultProvider
  26226. </h3>
  26227. <p>
  26228. (<em>Appears on:</em>
  26229. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26230. </p>
  26231. <p>
  26232. <p>VaultProvider configures a store to sync secrets using a HashiCorp Vault KV backend.</p>
  26233. </p>
  26234. <table>
  26235. <thead>
  26236. <tr>
  26237. <th>Field</th>
  26238. <th>Description</th>
  26239. </tr>
  26240. </thead>
  26241. <tbody>
  26242. <tr>
  26243. <td>
  26244. <code>auth</code></br>
  26245. <em>
  26246. <a href="#external-secrets.io/v1beta1.VaultAuth">
  26247. VaultAuth
  26248. </a>
  26249. </em>
  26250. </td>
  26251. <td>
  26252. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  26253. </td>
  26254. </tr>
  26255. <tr>
  26256. <td>
  26257. <code>server</code></br>
  26258. <em>
  26259. string
  26260. </em>
  26261. </td>
  26262. <td>
  26263. <p>Server is the connection address for the Vault server, e.g: &ldquo;<a href="https://vault.example.com:8200&quot;">https://vault.example.com:8200&rdquo;</a>.</p>
  26264. </td>
  26265. </tr>
  26266. <tr>
  26267. <td>
  26268. <code>path</code></br>
  26269. <em>
  26270. string
  26271. </em>
  26272. </td>
  26273. <td>
  26274. <em>(Optional)</em>
  26275. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  26276. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  26277. for fetching secrets from Vault is optional and will be appended
  26278. if not present in specified path.</p>
  26279. </td>
  26280. </tr>
  26281. <tr>
  26282. <td>
  26283. <code>version</code></br>
  26284. <em>
  26285. <a href="#external-secrets.io/v1beta1.VaultKVStoreVersion">
  26286. VaultKVStoreVersion
  26287. </a>
  26288. </em>
  26289. </td>
  26290. <td>
  26291. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  26292. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  26293. </td>
  26294. </tr>
  26295. <tr>
  26296. <td>
  26297. <code>namespace</code></br>
  26298. <em>
  26299. string
  26300. </em>
  26301. </td>
  26302. <td>
  26303. <em>(Optional)</em>
  26304. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  26305. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  26306. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a></p>
  26307. </td>
  26308. </tr>
  26309. <tr>
  26310. <td>
  26311. <code>caBundle</code></br>
  26312. <em>
  26313. []byte
  26314. </em>
  26315. </td>
  26316. <td>
  26317. <em>(Optional)</em>
  26318. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  26319. if the Server URL is using HTTPS protocol. This parameter is ignored for
  26320. plain HTTP protocol connection. If not set the system root certificates
  26321. are used to validate the TLS connection.</p>
  26322. </td>
  26323. </tr>
  26324. <tr>
  26325. <td>
  26326. <code>tls</code></br>
  26327. <em>
  26328. <a href="#external-secrets.io/v1beta1.VaultClientTLS">
  26329. VaultClientTLS
  26330. </a>
  26331. </em>
  26332. </td>
  26333. <td>
  26334. <em>(Optional)</em>
  26335. <p>The configuration used for client side related TLS communication, when the Vault server
  26336. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  26337. This parameter is ignored for plain HTTP protocol connection.
  26338. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  26339. which is available under the <code>auth.cert</code> section.</p>
  26340. </td>
  26341. </tr>
  26342. <tr>
  26343. <td>
  26344. <code>caProvider</code></br>
  26345. <em>
  26346. <a href="#external-secrets.io/v1beta1.CAProvider">
  26347. CAProvider
  26348. </a>
  26349. </em>
  26350. </td>
  26351. <td>
  26352. <em>(Optional)</em>
  26353. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  26354. </td>
  26355. </tr>
  26356. <tr>
  26357. <td>
  26358. <code>readYourWrites</code></br>
  26359. <em>
  26360. bool
  26361. </em>
  26362. </td>
  26363. <td>
  26364. <em>(Optional)</em>
  26365. <p>ReadYourWrites ensures isolated read-after-write semantics by
  26366. providing discovered cluster replication states in each request.
  26367. More information about eventual consistency in Vault can be found here
  26368. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  26369. </td>
  26370. </tr>
  26371. <tr>
  26372. <td>
  26373. <code>forwardInconsistent</code></br>
  26374. <em>
  26375. bool
  26376. </em>
  26377. </td>
  26378. <td>
  26379. <em>(Optional)</em>
  26380. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  26381. leader instead of simply retrying within a loop. This can increase performance if
  26382. the option is enabled serverside.
  26383. <a href="https://www.vaultproject.io/docs/configuration/replication#allow_forwarding_via_header">https://www.vaultproject.io/docs/configuration/replication#allow_forwarding_via_header</a></p>
  26384. </td>
  26385. </tr>
  26386. <tr>
  26387. <td>
  26388. <code>headers</code></br>
  26389. <em>
  26390. map[string]string
  26391. </em>
  26392. </td>
  26393. <td>
  26394. <em>(Optional)</em>
  26395. <p>Headers to be added in Vault request</p>
  26396. </td>
  26397. </tr>
  26398. </tbody>
  26399. </table>
  26400. <h3 id="external-secrets.io/v1beta1.VaultUserPassAuth">VaultUserPassAuth
  26401. </h3>
  26402. <p>
  26403. (<em>Appears on:</em>
  26404. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26405. </p>
  26406. <p>
  26407. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  26408. with the username and password stored in a Kubernetes Secret resource.</p>
  26409. </p>
  26410. <table>
  26411. <thead>
  26412. <tr>
  26413. <th>Field</th>
  26414. <th>Description</th>
  26415. </tr>
  26416. </thead>
  26417. <tbody>
  26418. <tr>
  26419. <td>
  26420. <code>path</code></br>
  26421. <em>
  26422. string
  26423. </em>
  26424. </td>
  26425. <td>
  26426. <p>Path where the UserPassword authentication backend is mounted
  26427. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  26428. </td>
  26429. </tr>
  26430. <tr>
  26431. <td>
  26432. <code>username</code></br>
  26433. <em>
  26434. string
  26435. </em>
  26436. </td>
  26437. <td>
  26438. <p>Username is a username used to authenticate using the UserPass Vault
  26439. authentication method</p>
  26440. </td>
  26441. </tr>
  26442. <tr>
  26443. <td>
  26444. <code>secretRef</code></br>
  26445. <em>
  26446. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26447. External Secrets meta/v1.SecretKeySelector
  26448. </a>
  26449. </em>
  26450. </td>
  26451. <td>
  26452. <em>(Optional)</em>
  26453. <p>SecretRef to a key in a Secret resource containing password for the
  26454. user used to authenticate with Vault using the UserPass authentication
  26455. method</p>
  26456. </td>
  26457. </tr>
  26458. </tbody>
  26459. </table>
  26460. <h3 id="external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider
  26461. </h3>
  26462. <p>
  26463. (<em>Appears on:</em>
  26464. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26465. </p>
  26466. <p>
  26467. <p>WebhookCAProvider defines a location to fetch the certificate for the webhook provider.</p>
  26468. </p>
  26469. <table>
  26470. <thead>
  26471. <tr>
  26472. <th>Field</th>
  26473. <th>Description</th>
  26474. </tr>
  26475. </thead>
  26476. <tbody>
  26477. <tr>
  26478. <td>
  26479. <code>type</code></br>
  26480. <em>
  26481. <a href="#external-secrets.io/v1beta1.WebhookCAProviderType">
  26482. WebhookCAProviderType
  26483. </a>
  26484. </em>
  26485. </td>
  26486. <td>
  26487. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  26488. </td>
  26489. </tr>
  26490. <tr>
  26491. <td>
  26492. <code>name</code></br>
  26493. <em>
  26494. string
  26495. </em>
  26496. </td>
  26497. <td>
  26498. <p>The name of the object located at the provider type.</p>
  26499. </td>
  26500. </tr>
  26501. <tr>
  26502. <td>
  26503. <code>key</code></br>
  26504. <em>
  26505. string
  26506. </em>
  26507. </td>
  26508. <td>
  26509. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  26510. </td>
  26511. </tr>
  26512. <tr>
  26513. <td>
  26514. <code>namespace</code></br>
  26515. <em>
  26516. string
  26517. </em>
  26518. </td>
  26519. <td>
  26520. <em>(Optional)</em>
  26521. <p>The namespace the Provider type is in.</p>
  26522. </td>
  26523. </tr>
  26524. </tbody>
  26525. </table>
  26526. <h3 id="external-secrets.io/v1beta1.WebhookCAProviderType">WebhookCAProviderType
  26527. (<code>string</code> alias)</p></h3>
  26528. <p>
  26529. (<em>Appears on:</em>
  26530. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider</a>)
  26531. </p>
  26532. <p>
  26533. <p>WebhookCAProviderType defines the type of provider to use for CA certificates with Webhook providers.</p>
  26534. </p>
  26535. <table>
  26536. <thead>
  26537. <tr>
  26538. <th>Value</th>
  26539. <th>Description</th>
  26540. </tr>
  26541. </thead>
  26542. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  26543. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  26544. </td>
  26545. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  26546. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  26547. </td>
  26548. </tr></tbody>
  26549. </table>
  26550. <h3 id="external-secrets.io/v1beta1.WebhookProvider">WebhookProvider
  26551. </h3>
  26552. <p>
  26553. (<em>Appears on:</em>
  26554. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26555. </p>
  26556. <p>
  26557. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  26558. </p>
  26559. <table>
  26560. <thead>
  26561. <tr>
  26562. <th>Field</th>
  26563. <th>Description</th>
  26564. </tr>
  26565. </thead>
  26566. <tbody>
  26567. <tr>
  26568. <td>
  26569. <code>method</code></br>
  26570. <em>
  26571. string
  26572. </em>
  26573. </td>
  26574. <td>
  26575. <p>Webhook Method</p>
  26576. </td>
  26577. </tr>
  26578. <tr>
  26579. <td>
  26580. <code>url</code></br>
  26581. <em>
  26582. string
  26583. </em>
  26584. </td>
  26585. <td>
  26586. <p>Webhook url to call</p>
  26587. </td>
  26588. </tr>
  26589. <tr>
  26590. <td>
  26591. <code>headers</code></br>
  26592. <em>
  26593. map[string]string
  26594. </em>
  26595. </td>
  26596. <td>
  26597. <em>(Optional)</em>
  26598. <p>Headers</p>
  26599. </td>
  26600. </tr>
  26601. <tr>
  26602. <td>
  26603. <code>auth</code></br>
  26604. <em>
  26605. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">
  26606. AuthorizationProtocol
  26607. </a>
  26608. </em>
  26609. </td>
  26610. <td>
  26611. <em>(Optional)</em>
  26612. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  26613. </td>
  26614. </tr>
  26615. <tr>
  26616. <td>
  26617. <code>body</code></br>
  26618. <em>
  26619. string
  26620. </em>
  26621. </td>
  26622. <td>
  26623. <em>(Optional)</em>
  26624. <p>Body</p>
  26625. </td>
  26626. </tr>
  26627. <tr>
  26628. <td>
  26629. <code>timeout</code></br>
  26630. <em>
  26631. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  26632. Kubernetes meta/v1.Duration
  26633. </a>
  26634. </em>
  26635. </td>
  26636. <td>
  26637. <em>(Optional)</em>
  26638. <p>Timeout</p>
  26639. </td>
  26640. </tr>
  26641. <tr>
  26642. <td>
  26643. <code>result</code></br>
  26644. <em>
  26645. <a href="#external-secrets.io/v1beta1.WebhookResult">
  26646. WebhookResult
  26647. </a>
  26648. </em>
  26649. </td>
  26650. <td>
  26651. <p>Result formatting</p>
  26652. </td>
  26653. </tr>
  26654. <tr>
  26655. <td>
  26656. <code>secrets</code></br>
  26657. <em>
  26658. <a href="#external-secrets.io/v1beta1.WebhookSecret">
  26659. []WebhookSecret
  26660. </a>
  26661. </em>
  26662. </td>
  26663. <td>
  26664. <em>(Optional)</em>
  26665. <p>Secrets to fill in templates
  26666. These secrets will be passed to the templating function as key value pairs under the given name</p>
  26667. </td>
  26668. </tr>
  26669. <tr>
  26670. <td>
  26671. <code>caBundle</code></br>
  26672. <em>
  26673. []byte
  26674. </em>
  26675. </td>
  26676. <td>
  26677. <em>(Optional)</em>
  26678. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  26679. if the Server URL is using HTTPS protocol. This parameter is ignored for
  26680. plain HTTP protocol connection. If not set the system root certificates
  26681. are used to validate the TLS connection.</p>
  26682. </td>
  26683. </tr>
  26684. <tr>
  26685. <td>
  26686. <code>caProvider</code></br>
  26687. <em>
  26688. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">
  26689. WebhookCAProvider
  26690. </a>
  26691. </em>
  26692. </td>
  26693. <td>
  26694. <em>(Optional)</em>
  26695. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  26696. </td>
  26697. </tr>
  26698. </tbody>
  26699. </table>
  26700. <h3 id="external-secrets.io/v1beta1.WebhookResult">WebhookResult
  26701. </h3>
  26702. <p>
  26703. (<em>Appears on:</em>
  26704. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26705. </p>
  26706. <p>
  26707. <p>WebhookResult defines how to extract and format the result from the webhook response.</p>
  26708. </p>
  26709. <table>
  26710. <thead>
  26711. <tr>
  26712. <th>Field</th>
  26713. <th>Description</th>
  26714. </tr>
  26715. </thead>
  26716. <tbody>
  26717. <tr>
  26718. <td>
  26719. <code>jsonPath</code></br>
  26720. <em>
  26721. string
  26722. </em>
  26723. </td>
  26724. <td>
  26725. <em>(Optional)</em>
  26726. <p>Json path of return value</p>
  26727. </td>
  26728. </tr>
  26729. </tbody>
  26730. </table>
  26731. <h3 id="external-secrets.io/v1beta1.WebhookSecret">WebhookSecret
  26732. </h3>
  26733. <p>
  26734. (<em>Appears on:</em>
  26735. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26736. </p>
  26737. <p>
  26738. <p>WebhookSecret defines a secret to be used in webhook templates.</p>
  26739. </p>
  26740. <table>
  26741. <thead>
  26742. <tr>
  26743. <th>Field</th>
  26744. <th>Description</th>
  26745. </tr>
  26746. </thead>
  26747. <tbody>
  26748. <tr>
  26749. <td>
  26750. <code>name</code></br>
  26751. <em>
  26752. string
  26753. </em>
  26754. </td>
  26755. <td>
  26756. <p>Name of this secret in templates</p>
  26757. </td>
  26758. </tr>
  26759. <tr>
  26760. <td>
  26761. <code>secretRef</code></br>
  26762. <em>
  26763. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26764. External Secrets meta/v1.SecretKeySelector
  26765. </a>
  26766. </em>
  26767. </td>
  26768. <td>
  26769. <p>Secret ref to fill in credentials</p>
  26770. </td>
  26771. </tr>
  26772. </tbody>
  26773. </table>
  26774. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerAuth">YandexCertificateManagerAuth
  26775. </h3>
  26776. <p>
  26777. (<em>Appears on:</em>
  26778. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  26779. </p>
  26780. <p>
  26781. <p>YandexCertificateManagerAuth defines authentication configuration for the Yandex Certificate Manager provider.</p>
  26782. </p>
  26783. <table>
  26784. <thead>
  26785. <tr>
  26786. <th>Field</th>
  26787. <th>Description</th>
  26788. </tr>
  26789. </thead>
  26790. <tbody>
  26791. <tr>
  26792. <td>
  26793. <code>authorizedKeySecretRef</code></br>
  26794. <em>
  26795. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26796. External Secrets meta/v1.SecretKeySelector
  26797. </a>
  26798. </em>
  26799. </td>
  26800. <td>
  26801. <em>(Optional)</em>
  26802. <p>The authorized key used for authentication</p>
  26803. </td>
  26804. </tr>
  26805. </tbody>
  26806. </table>
  26807. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">YandexCertificateManagerCAProvider
  26808. </h3>
  26809. <p>
  26810. (<em>Appears on:</em>
  26811. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  26812. </p>
  26813. <p>
  26814. <p>YandexCertificateManagerCAProvider defines CA certificate configuration for Yandex Certificate Manager.</p>
  26815. </p>
  26816. <table>
  26817. <thead>
  26818. <tr>
  26819. <th>Field</th>
  26820. <th>Description</th>
  26821. </tr>
  26822. </thead>
  26823. <tbody>
  26824. <tr>
  26825. <td>
  26826. <code>certSecretRef</code></br>
  26827. <em>
  26828. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26829. External Secrets meta/v1.SecretKeySelector
  26830. </a>
  26831. </em>
  26832. </td>
  26833. <td>
  26834. </td>
  26835. </tr>
  26836. </tbody>
  26837. </table>
  26838. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  26839. </h3>
  26840. <p>
  26841. (<em>Appears on:</em>
  26842. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26843. </p>
  26844. <p>
  26845. <p>YandexCertificateManagerProvider configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  26846. </p>
  26847. <table>
  26848. <thead>
  26849. <tr>
  26850. <th>Field</th>
  26851. <th>Description</th>
  26852. </tr>
  26853. </thead>
  26854. <tbody>
  26855. <tr>
  26856. <td>
  26857. <code>apiEndpoint</code></br>
  26858. <em>
  26859. string
  26860. </em>
  26861. </td>
  26862. <td>
  26863. <em>(Optional)</em>
  26864. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  26865. </td>
  26866. </tr>
  26867. <tr>
  26868. <td>
  26869. <code>auth</code></br>
  26870. <em>
  26871. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerAuth">
  26872. YandexCertificateManagerAuth
  26873. </a>
  26874. </em>
  26875. </td>
  26876. <td>
  26877. <p>Auth defines the information necessary to authenticate against Yandex Certificate Manager</p>
  26878. </td>
  26879. </tr>
  26880. <tr>
  26881. <td>
  26882. <code>caProvider</code></br>
  26883. <em>
  26884. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">
  26885. YandexCertificateManagerCAProvider
  26886. </a>
  26887. </em>
  26888. </td>
  26889. <td>
  26890. <em>(Optional)</em>
  26891. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  26892. </td>
  26893. </tr>
  26894. </tbody>
  26895. </table>
  26896. <h3 id="external-secrets.io/v1beta1.YandexLockboxAuth">YandexLockboxAuth
  26897. </h3>
  26898. <p>
  26899. (<em>Appears on:</em>
  26900. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  26901. </p>
  26902. <p>
  26903. <p>YandexLockboxAuth defines authentication configuration for the Yandex Lockbox provider.</p>
  26904. </p>
  26905. <table>
  26906. <thead>
  26907. <tr>
  26908. <th>Field</th>
  26909. <th>Description</th>
  26910. </tr>
  26911. </thead>
  26912. <tbody>
  26913. <tr>
  26914. <td>
  26915. <code>authorizedKeySecretRef</code></br>
  26916. <em>
  26917. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26918. External Secrets meta/v1.SecretKeySelector
  26919. </a>
  26920. </em>
  26921. </td>
  26922. <td>
  26923. <em>(Optional)</em>
  26924. <p>The authorized key used for authentication</p>
  26925. </td>
  26926. </tr>
  26927. </tbody>
  26928. </table>
  26929. <h3 id="external-secrets.io/v1beta1.YandexLockboxCAProvider">YandexLockboxCAProvider
  26930. </h3>
  26931. <p>
  26932. (<em>Appears on:</em>
  26933. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  26934. </p>
  26935. <p>
  26936. <p>YandexLockboxCAProvider defines CA certificate configuration for Yandex Lockbox.</p>
  26937. </p>
  26938. <table>
  26939. <thead>
  26940. <tr>
  26941. <th>Field</th>
  26942. <th>Description</th>
  26943. </tr>
  26944. </thead>
  26945. <tbody>
  26946. <tr>
  26947. <td>
  26948. <code>certSecretRef</code></br>
  26949. <em>
  26950. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26951. External Secrets meta/v1.SecretKeySelector
  26952. </a>
  26953. </em>
  26954. </td>
  26955. <td>
  26956. </td>
  26957. </tr>
  26958. </tbody>
  26959. </table>
  26960. <h3 id="external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider
  26961. </h3>
  26962. <p>
  26963. (<em>Appears on:</em>
  26964. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26965. </p>
  26966. <p>
  26967. <p>YandexLockboxProvider configures a store to sync secrets using the Yandex Lockbox provider.</p>
  26968. </p>
  26969. <table>
  26970. <thead>
  26971. <tr>
  26972. <th>Field</th>
  26973. <th>Description</th>
  26974. </tr>
  26975. </thead>
  26976. <tbody>
  26977. <tr>
  26978. <td>
  26979. <code>apiEndpoint</code></br>
  26980. <em>
  26981. string
  26982. </em>
  26983. </td>
  26984. <td>
  26985. <em>(Optional)</em>
  26986. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  26987. </td>
  26988. </tr>
  26989. <tr>
  26990. <td>
  26991. <code>auth</code></br>
  26992. <em>
  26993. <a href="#external-secrets.io/v1beta1.YandexLockboxAuth">
  26994. YandexLockboxAuth
  26995. </a>
  26996. </em>
  26997. </td>
  26998. <td>
  26999. <p>Auth defines the information necessary to authenticate against Yandex Lockbox</p>
  27000. </td>
  27001. </tr>
  27002. <tr>
  27003. <td>
  27004. <code>caProvider</code></br>
  27005. <em>
  27006. <a href="#external-secrets.io/v1beta1.YandexLockboxCAProvider">
  27007. YandexLockboxCAProvider
  27008. </a>
  27009. </em>
  27010. </td>
  27011. <td>
  27012. <em>(Optional)</em>
  27013. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  27014. </td>
  27015. </tr>
  27016. </tbody>
  27017. </table>
  27018. <hr/>
  27019. <h2 id="generators.external-secrets.io/v1alpha1">generators.external-secrets.io/v1alpha1</h2>
  27020. <p>
  27021. <p>Package v1alpha1 contains resources for generators</p>
  27022. </p>
  27023. <p>Resource Types:</p>
  27024. <ul></ul>
  27025. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken
  27026. </h3>
  27027. <p>
  27028. <p>ACRAccessToken returns an Azure Container Registry token
  27029. that can be used for pushing/pulling images.
  27030. Note: by default it will return an ACR Refresh Token with full access
  27031. (depending on the identity).
  27032. This can be scoped down to the repository level using .spec.scope.
  27033. In case scope is defined it will return an ACR Access Token.</p>
  27034. <p>See docs: <a href="https://github.com/Azure/acr/blob/main/docs/AAD-OAuth.md">https://github.com/Azure/acr/blob/main/docs/AAD-OAuth.md</a></p>
  27035. </p>
  27036. <table>
  27037. <thead>
  27038. <tr>
  27039. <th>Field</th>
  27040. <th>Description</th>
  27041. </tr>
  27042. </thead>
  27043. <tbody>
  27044. <tr>
  27045. <td>
  27046. <code>metadata</code></br>
  27047. <em>
  27048. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27049. Kubernetes meta/v1.ObjectMeta
  27050. </a>
  27051. </em>
  27052. </td>
  27053. <td>
  27054. Refer to the Kubernetes API documentation for the fields of the
  27055. <code>metadata</code> field.
  27056. </td>
  27057. </tr>
  27058. <tr>
  27059. <td>
  27060. <code>spec</code></br>
  27061. <em>
  27062. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  27063. ACRAccessTokenSpec
  27064. </a>
  27065. </em>
  27066. </td>
  27067. <td>
  27068. <br/>
  27069. <br/>
  27070. <table>
  27071. <tr>
  27072. <td>
  27073. <code>auth</code></br>
  27074. <em>
  27075. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  27076. ACRAuth
  27077. </a>
  27078. </em>
  27079. </td>
  27080. <td>
  27081. </td>
  27082. </tr>
  27083. <tr>
  27084. <td>
  27085. <code>tenantId</code></br>
  27086. <em>
  27087. string
  27088. </em>
  27089. </td>
  27090. <td>
  27091. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  27092. </td>
  27093. </tr>
  27094. <tr>
  27095. <td>
  27096. <code>registry</code></br>
  27097. <em>
  27098. string
  27099. </em>
  27100. </td>
  27101. <td>
  27102. <p>the domain name of the ACR registry
  27103. e.g. foobarexample.azurecr.io</p>
  27104. </td>
  27105. </tr>
  27106. <tr>
  27107. <td>
  27108. <code>scope</code></br>
  27109. <em>
  27110. string
  27111. </em>
  27112. </td>
  27113. <td>
  27114. <em>(Optional)</em>
  27115. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  27116. if not provided it will return a refresh token that has full scope.
  27117. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  27118. <p>examples:
  27119. repository:my-repository:pull,push
  27120. repository:my-repository:pull</p>
  27121. <p>see docs for details: <a href="https://docs.docker.com/registry/spec/auth/scope/">https://docs.docker.com/registry/spec/auth/scope/</a></p>
  27122. </td>
  27123. </tr>
  27124. <tr>
  27125. <td>
  27126. <code>environmentType</code></br>
  27127. <em>
  27128. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  27129. AzureEnvironmentType
  27130. </a>
  27131. </em>
  27132. </td>
  27133. <td>
  27134. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  27135. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  27136. The following endpoints are available, also see here: <a href="https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152">https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152</a>
  27137. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  27138. </td>
  27139. </tr>
  27140. </table>
  27141. </td>
  27142. </tr>
  27143. </tbody>
  27144. </table>
  27145. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec
  27146. </h3>
  27147. <p>
  27148. (<em>Appears on:</em>
  27149. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken</a>,
  27150. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27151. </p>
  27152. <p>
  27153. <p>ACRAccessTokenSpec defines how to generate the access token
  27154. e.g. how to authenticate and which registry to use.
  27155. see: <a href="https://github.com/Azure/acr/blob/main/docs/AAD-OAuth.md#overview">https://github.com/Azure/acr/blob/main/docs/AAD-OAuth.md#overview</a></p>
  27156. </p>
  27157. <table>
  27158. <thead>
  27159. <tr>
  27160. <th>Field</th>
  27161. <th>Description</th>
  27162. </tr>
  27163. </thead>
  27164. <tbody>
  27165. <tr>
  27166. <td>
  27167. <code>auth</code></br>
  27168. <em>
  27169. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  27170. ACRAuth
  27171. </a>
  27172. </em>
  27173. </td>
  27174. <td>
  27175. </td>
  27176. </tr>
  27177. <tr>
  27178. <td>
  27179. <code>tenantId</code></br>
  27180. <em>
  27181. string
  27182. </em>
  27183. </td>
  27184. <td>
  27185. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  27186. </td>
  27187. </tr>
  27188. <tr>
  27189. <td>
  27190. <code>registry</code></br>
  27191. <em>
  27192. string
  27193. </em>
  27194. </td>
  27195. <td>
  27196. <p>the domain name of the ACR registry
  27197. e.g. foobarexample.azurecr.io</p>
  27198. </td>
  27199. </tr>
  27200. <tr>
  27201. <td>
  27202. <code>scope</code></br>
  27203. <em>
  27204. string
  27205. </em>
  27206. </td>
  27207. <td>
  27208. <em>(Optional)</em>
  27209. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  27210. if not provided it will return a refresh token that has full scope.
  27211. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  27212. <p>examples:
  27213. repository:my-repository:pull,push
  27214. repository:my-repository:pull</p>
  27215. <p>see docs for details: <a href="https://docs.docker.com/registry/spec/auth/scope/">https://docs.docker.com/registry/spec/auth/scope/</a></p>
  27216. </td>
  27217. </tr>
  27218. <tr>
  27219. <td>
  27220. <code>environmentType</code></br>
  27221. <em>
  27222. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  27223. AzureEnvironmentType
  27224. </a>
  27225. </em>
  27226. </td>
  27227. <td>
  27228. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  27229. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  27230. The following endpoints are available, also see here: <a href="https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152">https://github.com/Azure/go-autorest/blob/main/autorest/azure/environments.go#L152</a>
  27231. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  27232. </td>
  27233. </tr>
  27234. </tbody>
  27235. </table>
  27236. <h3 id="generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth
  27237. </h3>
  27238. <p>
  27239. (<em>Appears on:</em>
  27240. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  27241. </p>
  27242. <p>
  27243. <p>ACRAuth defines the authentication methods for Azure Container Registry.</p>
  27244. </p>
  27245. <table>
  27246. <thead>
  27247. <tr>
  27248. <th>Field</th>
  27249. <th>Description</th>
  27250. </tr>
  27251. </thead>
  27252. <tbody>
  27253. <tr>
  27254. <td>
  27255. <code>servicePrincipal</code></br>
  27256. <em>
  27257. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">
  27258. AzureACRServicePrincipalAuth
  27259. </a>
  27260. </em>
  27261. </td>
  27262. <td>
  27263. <em>(Optional)</em>
  27264. <p>ServicePrincipal uses Azure Service Principal credentials to authenticate with Azure.</p>
  27265. </td>
  27266. </tr>
  27267. <tr>
  27268. <td>
  27269. <code>managedIdentity</code></br>
  27270. <em>
  27271. <a href="#generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">
  27272. AzureACRManagedIdentityAuth
  27273. </a>
  27274. </em>
  27275. </td>
  27276. <td>
  27277. <em>(Optional)</em>
  27278. <p>ManagedIdentity uses Azure Managed Identity to authenticate with Azure.</p>
  27279. </td>
  27280. </tr>
  27281. <tr>
  27282. <td>
  27283. <code>workloadIdentity</code></br>
  27284. <em>
  27285. <a href="#generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">
  27286. AzureACRWorkloadIdentityAuth
  27287. </a>
  27288. </em>
  27289. </td>
  27290. <td>
  27291. <em>(Optional)</em>
  27292. <p>WorkloadIdentity uses Azure Workload Identity to authenticate with Azure.</p>
  27293. </td>
  27294. </tr>
  27295. </tbody>
  27296. </table>
  27297. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth
  27298. </h3>
  27299. <p>
  27300. (<em>Appears on:</em>
  27301. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec</a>,
  27302. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  27303. </p>
  27304. <p>
  27305. <p>AWSAuth tells the controller how to do authentication with aws.
  27306. Only one of secretRef or jwt can be specified.
  27307. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  27308. </p>
  27309. <table>
  27310. <thead>
  27311. <tr>
  27312. <th>Field</th>
  27313. <th>Description</th>
  27314. </tr>
  27315. </thead>
  27316. <tbody>
  27317. <tr>
  27318. <td>
  27319. <code>secretRef</code></br>
  27320. <em>
  27321. <a href="#generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">
  27322. AWSAuthSecretRef
  27323. </a>
  27324. </em>
  27325. </td>
  27326. <td>
  27327. <em>(Optional)</em>
  27328. </td>
  27329. </tr>
  27330. <tr>
  27331. <td>
  27332. <code>jwt</code></br>
  27333. <em>
  27334. <a href="#generators.external-secrets.io/v1alpha1.AWSJWTAuth">
  27335. AWSJWTAuth
  27336. </a>
  27337. </em>
  27338. </td>
  27339. <td>
  27340. <em>(Optional)</em>
  27341. </td>
  27342. </tr>
  27343. </tbody>
  27344. </table>
  27345. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">AWSAuthSecretRef
  27346. </h3>
  27347. <p>
  27348. (<em>Appears on:</em>
  27349. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  27350. </p>
  27351. <p>
  27352. <p>AWSAuthSecretRef holds secret references for AWS credentials
  27353. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  27354. </p>
  27355. <table>
  27356. <thead>
  27357. <tr>
  27358. <th>Field</th>
  27359. <th>Description</th>
  27360. </tr>
  27361. </thead>
  27362. <tbody>
  27363. <tr>
  27364. <td>
  27365. <code>accessKeyIDSecretRef</code></br>
  27366. <em>
  27367. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27368. External Secrets meta/v1.SecretKeySelector
  27369. </a>
  27370. </em>
  27371. </td>
  27372. <td>
  27373. <p>The AccessKeyID is used for authentication</p>
  27374. </td>
  27375. </tr>
  27376. <tr>
  27377. <td>
  27378. <code>secretAccessKeySecretRef</code></br>
  27379. <em>
  27380. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27381. External Secrets meta/v1.SecretKeySelector
  27382. </a>
  27383. </em>
  27384. </td>
  27385. <td>
  27386. <p>The SecretAccessKey is used for authentication</p>
  27387. </td>
  27388. </tr>
  27389. <tr>
  27390. <td>
  27391. <code>sessionTokenSecretRef</code></br>
  27392. <em>
  27393. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27394. External Secrets meta/v1.SecretKeySelector
  27395. </a>
  27396. </em>
  27397. </td>
  27398. <td>
  27399. <p>The SessionToken used for authentication
  27400. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  27401. see: <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html">https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html</a></p>
  27402. </td>
  27403. </tr>
  27404. </tbody>
  27405. </table>
  27406. <h3 id="generators.external-secrets.io/v1alpha1.AWSJWTAuth">AWSJWTAuth
  27407. </h3>
  27408. <p>
  27409. (<em>Appears on:</em>
  27410. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  27411. </p>
  27412. <p>
  27413. <p>AWSJWTAuth provides configuration to authenticate against AWS using service account tokens.</p>
  27414. </p>
  27415. <table>
  27416. <thead>
  27417. <tr>
  27418. <th>Field</th>
  27419. <th>Description</th>
  27420. </tr>
  27421. </thead>
  27422. <tbody>
  27423. <tr>
  27424. <td>
  27425. <code>serviceAccountRef</code></br>
  27426. <em>
  27427. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27428. External Secrets meta/v1.ServiceAccountSelector
  27429. </a>
  27430. </em>
  27431. </td>
  27432. <td>
  27433. </td>
  27434. </tr>
  27435. </tbody>
  27436. </table>
  27437. <h3 id="generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol
  27438. </h3>
  27439. <p>
  27440. (<em>Appears on:</em>
  27441. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  27442. </p>
  27443. <p>
  27444. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  27445. </p>
  27446. <table>
  27447. <thead>
  27448. <tr>
  27449. <th>Field</th>
  27450. <th>Description</th>
  27451. </tr>
  27452. </thead>
  27453. <tbody>
  27454. <tr>
  27455. <td>
  27456. <code>ntlm</code></br>
  27457. <em>
  27458. <a href="#generators.external-secrets.io/v1alpha1.NTLMProtocol">
  27459. NTLMProtocol
  27460. </a>
  27461. </em>
  27462. </td>
  27463. <td>
  27464. <em>(Optional)</em>
  27465. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  27466. </td>
  27467. </tr>
  27468. </tbody>
  27469. </table>
  27470. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">AzureACRManagedIdentityAuth
  27471. </h3>
  27472. <p>
  27473. (<em>Appears on:</em>
  27474. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27475. </p>
  27476. <p>
  27477. <p>AzureACRManagedIdentityAuth defines the configuration for using Azure Managed Identity authentication.</p>
  27478. </p>
  27479. <table>
  27480. <thead>
  27481. <tr>
  27482. <th>Field</th>
  27483. <th>Description</th>
  27484. </tr>
  27485. </thead>
  27486. <tbody>
  27487. <tr>
  27488. <td>
  27489. <code>identityId</code></br>
  27490. <em>
  27491. string
  27492. </em>
  27493. </td>
  27494. <td>
  27495. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  27496. </td>
  27497. </tr>
  27498. </tbody>
  27499. </table>
  27500. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth
  27501. </h3>
  27502. <p>
  27503. (<em>Appears on:</em>
  27504. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27505. </p>
  27506. <p>
  27507. <p>AzureACRServicePrincipalAuth defines the configuration for using Azure Service Principal authentication.</p>
  27508. </p>
  27509. <table>
  27510. <thead>
  27511. <tr>
  27512. <th>Field</th>
  27513. <th>Description</th>
  27514. </tr>
  27515. </thead>
  27516. <tbody>
  27517. <tr>
  27518. <td>
  27519. <code>secretRef</code></br>
  27520. <em>
  27521. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">
  27522. AzureACRServicePrincipalAuthSecretRef
  27523. </a>
  27524. </em>
  27525. </td>
  27526. <td>
  27527. </td>
  27528. </tr>
  27529. </tbody>
  27530. </table>
  27531. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">AzureACRServicePrincipalAuthSecretRef
  27532. </h3>
  27533. <p>
  27534. (<em>Appears on:</em>
  27535. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth</a>)
  27536. </p>
  27537. <p>
  27538. <p>AzureACRServicePrincipalAuthSecretRef defines the secret references for Azure Service Principal authentication.
  27539. It uses static credentials stored in a Kind=Secret.</p>
  27540. </p>
  27541. <table>
  27542. <thead>
  27543. <tr>
  27544. <th>Field</th>
  27545. <th>Description</th>
  27546. </tr>
  27547. </thead>
  27548. <tbody>
  27549. <tr>
  27550. <td>
  27551. <code>clientId</code></br>
  27552. <em>
  27553. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27554. External Secrets meta/v1.SecretKeySelector
  27555. </a>
  27556. </em>
  27557. </td>
  27558. <td>
  27559. <p>The Azure clientId of the service principle used for authentication.</p>
  27560. </td>
  27561. </tr>
  27562. <tr>
  27563. <td>
  27564. <code>clientSecret</code></br>
  27565. <em>
  27566. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27567. External Secrets meta/v1.SecretKeySelector
  27568. </a>
  27569. </em>
  27570. </td>
  27571. <td>
  27572. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  27573. </td>
  27574. </tr>
  27575. </tbody>
  27576. </table>
  27577. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">AzureACRWorkloadIdentityAuth
  27578. </h3>
  27579. <p>
  27580. (<em>Appears on:</em>
  27581. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27582. </p>
  27583. <p>
  27584. <p>AzureACRWorkloadIdentityAuth defines the configuration for using Azure Workload Identity authentication.</p>
  27585. </p>
  27586. <table>
  27587. <thead>
  27588. <tr>
  27589. <th>Field</th>
  27590. <th>Description</th>
  27591. </tr>
  27592. </thead>
  27593. <tbody>
  27594. <tr>
  27595. <td>
  27596. <code>serviceAccountRef</code></br>
  27597. <em>
  27598. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27599. External Secrets meta/v1.ServiceAccountSelector
  27600. </a>
  27601. </em>
  27602. </td>
  27603. <td>
  27604. <em>(Optional)</em>
  27605. <p>ServiceAccountRef specified the service account
  27606. that should be used when authenticating with WorkloadIdentity.</p>
  27607. </td>
  27608. </tr>
  27609. </tbody>
  27610. </table>
  27611. <h3 id="generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecret">BeyondtrustWorkloadCredentialsDynamicSecret
  27612. </h3>
  27613. <p>
  27614. <p>BeyondtrustWorkloadCredentialsDynamicSecret represents a generator that requests dynamic credentials from BeyondTrust Workload Credentials.
  27615. This generator calls the BeyondTrust Workload Credentials API to generate fresh, temporary credentials
  27616. (such as AWS STS credentials) each time an ExternalSecret is refreshed.
  27617. Dynamic secret definitions must be created in BeyondTrust Workload Credentials before they can be referenced.
  27618. For complete documentation, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api">https://docs.beyondtrust.com/bt-docs/docs/secrets-api</a></p>
  27619. </p>
  27620. <table>
  27621. <thead>
  27622. <tr>
  27623. <th>Field</th>
  27624. <th>Description</th>
  27625. </tr>
  27626. </thead>
  27627. <tbody>
  27628. <tr>
  27629. <td>
  27630. <code>metadata</code></br>
  27631. <em>
  27632. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27633. Kubernetes meta/v1.ObjectMeta
  27634. </a>
  27635. </em>
  27636. </td>
  27637. <td>
  27638. Refer to the Kubernetes API documentation for the fields of the
  27639. <code>metadata</code> field.
  27640. </td>
  27641. </tr>
  27642. <tr>
  27643. <td>
  27644. <code>spec</code></br>
  27645. <em>
  27646. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">
  27647. BeyondtrustWorkloadCredentialsDynamicSecretSpec
  27648. </a>
  27649. </em>
  27650. </td>
  27651. <td>
  27652. <br/>
  27653. <br/>
  27654. <table>
  27655. <tr>
  27656. <td>
  27657. <code>controller</code></br>
  27658. <em>
  27659. string
  27660. </em>
  27661. </td>
  27662. <td>
  27663. <em>(Optional)</em>
  27664. <p>Controller selects the controller that should handle this generator.
  27665. Leave empty to use the default controller.</p>
  27666. </td>
  27667. </tr>
  27668. <tr>
  27669. <td>
  27670. <code>provider</code></br>
  27671. <em>
  27672. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  27673. BeyondtrustWorkloadCredentialsProvider
  27674. </a>
  27675. </em>
  27676. </td>
  27677. <td>
  27678. <p>Provider contains the BeyondtrustWorkloadCredentials provider configuration including authentication,
  27679. server connection details, and the folder path to the dynamic secret definition.
  27680. The folderPath should point to a dynamic secret definition that has been created in
  27681. BeyondTrust Workload Credentials (e.g., &ldquo;production/aws-temp&rdquo;).
  27682. For setup details, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api">https://docs.beyondtrust.com/bt-docs/docs/secrets-api</a></p>
  27683. </td>
  27684. </tr>
  27685. <tr>
  27686. <td>
  27687. <code>retrySettings</code></br>
  27688. <em>
  27689. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  27690. SecretStoreRetrySettings
  27691. </a>
  27692. </em>
  27693. </td>
  27694. <td>
  27695. <em>(Optional)</em>
  27696. <p>RetrySettings configures exponential backoff for failed API requests.
  27697. If not specified, uses the default retry settings.</p>
  27698. </td>
  27699. </tr>
  27700. </table>
  27701. </td>
  27702. </tr>
  27703. </tbody>
  27704. </table>
  27705. <h3 id="generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec
  27706. </h3>
  27707. <p>
  27708. (<em>Appears on:</em>
  27709. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecret">BeyondtrustWorkloadCredentialsDynamicSecret</a>,
  27710. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27711. </p>
  27712. <p>
  27713. <p>BeyondtrustWorkloadCredentialsDynamicSecretSpec defines the desired spec for BeyondtrustWorkloadCredentials dynamic generator.
  27714. This generator enables obtaining temporary, short-lived credentials from BeyondTrust Workload Credentials.
  27715. For more information, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api">https://docs.beyondtrust.com/bt-docs/docs/secrets-api</a></p>
  27716. </p>
  27717. <table>
  27718. <thead>
  27719. <tr>
  27720. <th>Field</th>
  27721. <th>Description</th>
  27722. </tr>
  27723. </thead>
  27724. <tbody>
  27725. <tr>
  27726. <td>
  27727. <code>controller</code></br>
  27728. <em>
  27729. string
  27730. </em>
  27731. </td>
  27732. <td>
  27733. <em>(Optional)</em>
  27734. <p>Controller selects the controller that should handle this generator.
  27735. Leave empty to use the default controller.</p>
  27736. </td>
  27737. </tr>
  27738. <tr>
  27739. <td>
  27740. <code>provider</code></br>
  27741. <em>
  27742. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  27743. BeyondtrustWorkloadCredentialsProvider
  27744. </a>
  27745. </em>
  27746. </td>
  27747. <td>
  27748. <p>Provider contains the BeyondtrustWorkloadCredentials provider configuration including authentication,
  27749. server connection details, and the folder path to the dynamic secret definition.
  27750. The folderPath should point to a dynamic secret definition that has been created in
  27751. BeyondTrust Workload Credentials (e.g., &ldquo;production/aws-temp&rdquo;).
  27752. For setup details, see: <a href="https://docs.beyondtrust.com/bt-docs/docs/secrets-api">https://docs.beyondtrust.com/bt-docs/docs/secrets-api</a></p>
  27753. </td>
  27754. </tr>
  27755. <tr>
  27756. <td>
  27757. <code>retrySettings</code></br>
  27758. <em>
  27759. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  27760. SecretStoreRetrySettings
  27761. </a>
  27762. </em>
  27763. </td>
  27764. <td>
  27765. <em>(Optional)</em>
  27766. <p>RetrySettings configures exponential backoff for failed API requests.
  27767. If not specified, uses the default retry settings.</p>
  27768. </td>
  27769. </tr>
  27770. </tbody>
  27771. </table>
  27772. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken
  27773. </h3>
  27774. <p>
  27775. <p>CloudsmithAccessToken generates Cloudsmith access token using OIDC authentication</p>
  27776. </p>
  27777. <table>
  27778. <thead>
  27779. <tr>
  27780. <th>Field</th>
  27781. <th>Description</th>
  27782. </tr>
  27783. </thead>
  27784. <tbody>
  27785. <tr>
  27786. <td>
  27787. <code>metadata</code></br>
  27788. <em>
  27789. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27790. Kubernetes meta/v1.ObjectMeta
  27791. </a>
  27792. </em>
  27793. </td>
  27794. <td>
  27795. Refer to the Kubernetes API documentation for the fields of the
  27796. <code>metadata</code> field.
  27797. </td>
  27798. </tr>
  27799. <tr>
  27800. <td>
  27801. <code>spec</code></br>
  27802. <em>
  27803. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  27804. CloudsmithAccessTokenSpec
  27805. </a>
  27806. </em>
  27807. </td>
  27808. <td>
  27809. <br/>
  27810. <br/>
  27811. <table>
  27812. <tr>
  27813. <td>
  27814. <code>apiUrl</code></br>
  27815. <em>
  27816. string
  27817. </em>
  27818. </td>
  27819. <td>
  27820. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  27821. </td>
  27822. </tr>
  27823. <tr>
  27824. <td>
  27825. <code>orgSlug</code></br>
  27826. <em>
  27827. string
  27828. </em>
  27829. </td>
  27830. <td>
  27831. <p>OrgSlug is the organization slug in Cloudsmith</p>
  27832. </td>
  27833. </tr>
  27834. <tr>
  27835. <td>
  27836. <code>serviceSlug</code></br>
  27837. <em>
  27838. string
  27839. </em>
  27840. </td>
  27841. <td>
  27842. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  27843. </td>
  27844. </tr>
  27845. <tr>
  27846. <td>
  27847. <code>serviceAccountRef</code></br>
  27848. <em>
  27849. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27850. External Secrets meta/v1.ServiceAccountSelector
  27851. </a>
  27852. </em>
  27853. </td>
  27854. <td>
  27855. <p>Name of the service account you are federating with</p>
  27856. </td>
  27857. </tr>
  27858. </table>
  27859. </td>
  27860. </tr>
  27861. </tbody>
  27862. </table>
  27863. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">CloudsmithAccessTokenSpec
  27864. </h3>
  27865. <p>
  27866. (<em>Appears on:</em>
  27867. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken</a>,
  27868. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27869. </p>
  27870. <p>
  27871. <p>CloudsmithAccessTokenSpec defines the configuration for generating a Cloudsmith access token using OIDC authentication.</p>
  27872. </p>
  27873. <table>
  27874. <thead>
  27875. <tr>
  27876. <th>Field</th>
  27877. <th>Description</th>
  27878. </tr>
  27879. </thead>
  27880. <tbody>
  27881. <tr>
  27882. <td>
  27883. <code>apiUrl</code></br>
  27884. <em>
  27885. string
  27886. </em>
  27887. </td>
  27888. <td>
  27889. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  27890. </td>
  27891. </tr>
  27892. <tr>
  27893. <td>
  27894. <code>orgSlug</code></br>
  27895. <em>
  27896. string
  27897. </em>
  27898. </td>
  27899. <td>
  27900. <p>OrgSlug is the organization slug in Cloudsmith</p>
  27901. </td>
  27902. </tr>
  27903. <tr>
  27904. <td>
  27905. <code>serviceSlug</code></br>
  27906. <em>
  27907. string
  27908. </em>
  27909. </td>
  27910. <td>
  27911. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  27912. </td>
  27913. </tr>
  27914. <tr>
  27915. <td>
  27916. <code>serviceAccountRef</code></br>
  27917. <em>
  27918. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27919. External Secrets meta/v1.ServiceAccountSelector
  27920. </a>
  27921. </em>
  27922. </td>
  27923. <td>
  27924. <p>Name of the service account you are federating with</p>
  27925. </td>
  27926. </tr>
  27927. </tbody>
  27928. </table>
  27929. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator
  27930. </h3>
  27931. <p>
  27932. <p>ClusterGenerator represents a cluster-wide generator which can be referenced as part of <code>generatorRef</code> fields.</p>
  27933. </p>
  27934. <table>
  27935. <thead>
  27936. <tr>
  27937. <th>Field</th>
  27938. <th>Description</th>
  27939. </tr>
  27940. </thead>
  27941. <tbody>
  27942. <tr>
  27943. <td>
  27944. <code>metadata</code></br>
  27945. <em>
  27946. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27947. Kubernetes meta/v1.ObjectMeta
  27948. </a>
  27949. </em>
  27950. </td>
  27951. <td>
  27952. Refer to the Kubernetes API documentation for the fields of the
  27953. <code>metadata</code> field.
  27954. </td>
  27955. </tr>
  27956. <tr>
  27957. <td>
  27958. <code>spec</code></br>
  27959. <em>
  27960. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">
  27961. ClusterGeneratorSpec
  27962. </a>
  27963. </em>
  27964. </td>
  27965. <td>
  27966. <br/>
  27967. <br/>
  27968. <table>
  27969. <tr>
  27970. <td>
  27971. <code>kind</code></br>
  27972. <em>
  27973. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  27974. GeneratorKind
  27975. </a>
  27976. </em>
  27977. </td>
  27978. <td>
  27979. <p>Kind the kind of this generator.</p>
  27980. </td>
  27981. </tr>
  27982. <tr>
  27983. <td>
  27984. <code>generator</code></br>
  27985. <em>
  27986. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  27987. GeneratorSpec
  27988. </a>
  27989. </em>
  27990. </td>
  27991. <td>
  27992. <p>Generator the spec for this generator, must match the kind.</p>
  27993. </td>
  27994. </tr>
  27995. </table>
  27996. </td>
  27997. </tr>
  27998. </tbody>
  27999. </table>
  28000. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec
  28001. </h3>
  28002. <p>
  28003. (<em>Appears on:</em>
  28004. <a href="#generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator</a>)
  28005. </p>
  28006. <p>
  28007. <p>ClusterGeneratorSpec defines the desired state of a ClusterGenerator.</p>
  28008. </p>
  28009. <table>
  28010. <thead>
  28011. <tr>
  28012. <th>Field</th>
  28013. <th>Description</th>
  28014. </tr>
  28015. </thead>
  28016. <tbody>
  28017. <tr>
  28018. <td>
  28019. <code>kind</code></br>
  28020. <em>
  28021. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  28022. GeneratorKind
  28023. </a>
  28024. </em>
  28025. </td>
  28026. <td>
  28027. <p>Kind the kind of this generator.</p>
  28028. </td>
  28029. </tr>
  28030. <tr>
  28031. <td>
  28032. <code>generator</code></br>
  28033. <em>
  28034. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  28035. GeneratorSpec
  28036. </a>
  28037. </em>
  28038. </td>
  28039. <td>
  28040. <p>Generator the spec for this generator, must match the kind.</p>
  28041. </td>
  28042. </tr>
  28043. </tbody>
  28044. </table>
  28045. <h3 id="generators.external-secrets.io/v1alpha1.ControllerClassResource">ControllerClassResource
  28046. </h3>
  28047. <p>
  28048. <p>ControllerClassResource defines a resource that can be assigned to a specific controller class.</p>
  28049. </p>
  28050. <table>
  28051. <thead>
  28052. <tr>
  28053. <th>Field</th>
  28054. <th>Description</th>
  28055. </tr>
  28056. </thead>
  28057. <tbody>
  28058. <tr>
  28059. <td>
  28060. <code>spec</code></br>
  28061. <em>
  28062. struct{ControllerClass string &#34;json:\&#34;controller\&#34;&#34;}
  28063. </em>
  28064. </td>
  28065. <td>
  28066. <br/>
  28067. <br/>
  28068. <table>
  28069. <tr>
  28070. <td>
  28071. <code>controller</code></br>
  28072. <em>
  28073. string
  28074. </em>
  28075. </td>
  28076. <td>
  28077. </td>
  28078. </tr>
  28079. </table>
  28080. </td>
  28081. </tr>
  28082. </tbody>
  28083. </table>
  28084. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken
  28085. </h3>
  28086. <p>
  28087. <p>ECRAuthorizationToken uses the GetAuthorizationToken API to retrieve an authorization token.
  28088. The authorization token is valid for 12 hours.
  28089. The authorizationToken returned is a base64 encoded string that can be decoded
  28090. and used in a docker login command to authenticate to a registry.
  28091. For more information, see Registry authentication (<a href="https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth">https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth</a>) in the Amazon Elastic Container Registry User Guide.</p>
  28092. </p>
  28093. <table>
  28094. <thead>
  28095. <tr>
  28096. <th>Field</th>
  28097. <th>Description</th>
  28098. </tr>
  28099. </thead>
  28100. <tbody>
  28101. <tr>
  28102. <td>
  28103. <code>metadata</code></br>
  28104. <em>
  28105. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28106. Kubernetes meta/v1.ObjectMeta
  28107. </a>
  28108. </em>
  28109. </td>
  28110. <td>
  28111. Refer to the Kubernetes API documentation for the fields of the
  28112. <code>metadata</code> field.
  28113. </td>
  28114. </tr>
  28115. <tr>
  28116. <td>
  28117. <code>spec</code></br>
  28118. <em>
  28119. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  28120. ECRAuthorizationTokenSpec
  28121. </a>
  28122. </em>
  28123. </td>
  28124. <td>
  28125. <br/>
  28126. <br/>
  28127. <table>
  28128. <tr>
  28129. <td>
  28130. <code>region</code></br>
  28131. <em>
  28132. string
  28133. </em>
  28134. </td>
  28135. <td>
  28136. <p>Region specifies the region to operate in.</p>
  28137. </td>
  28138. </tr>
  28139. <tr>
  28140. <td>
  28141. <code>auth</code></br>
  28142. <em>
  28143. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28144. AWSAuth
  28145. </a>
  28146. </em>
  28147. </td>
  28148. <td>
  28149. <em>(Optional)</em>
  28150. <p>Auth defines how to authenticate with AWS</p>
  28151. </td>
  28152. </tr>
  28153. <tr>
  28154. <td>
  28155. <code>role</code></br>
  28156. <em>
  28157. string
  28158. </em>
  28159. </td>
  28160. <td>
  28161. <em>(Optional)</em>
  28162. <p>You can assume a role before making calls to the
  28163. desired AWS service.</p>
  28164. </td>
  28165. </tr>
  28166. <tr>
  28167. <td>
  28168. <code>scope</code></br>
  28169. <em>
  28170. string
  28171. </em>
  28172. </td>
  28173. <td>
  28174. <em>(Optional)</em>
  28175. <p>Scope specifies the ECR service scope.
  28176. Valid options are private and public.</p>
  28177. </td>
  28178. </tr>
  28179. </table>
  28180. </td>
  28181. </tr>
  28182. </tbody>
  28183. </table>
  28184. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec
  28185. </h3>
  28186. <p>
  28187. (<em>Appears on:</em>
  28188. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken</a>,
  28189. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28190. </p>
  28191. <p>
  28192. <p>ECRAuthorizationTokenSpec defines the desired state to generate an AWS ECR authorization token.</p>
  28193. </p>
  28194. <table>
  28195. <thead>
  28196. <tr>
  28197. <th>Field</th>
  28198. <th>Description</th>
  28199. </tr>
  28200. </thead>
  28201. <tbody>
  28202. <tr>
  28203. <td>
  28204. <code>region</code></br>
  28205. <em>
  28206. string
  28207. </em>
  28208. </td>
  28209. <td>
  28210. <p>Region specifies the region to operate in.</p>
  28211. </td>
  28212. </tr>
  28213. <tr>
  28214. <td>
  28215. <code>auth</code></br>
  28216. <em>
  28217. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28218. AWSAuth
  28219. </a>
  28220. </em>
  28221. </td>
  28222. <td>
  28223. <em>(Optional)</em>
  28224. <p>Auth defines how to authenticate with AWS</p>
  28225. </td>
  28226. </tr>
  28227. <tr>
  28228. <td>
  28229. <code>role</code></br>
  28230. <em>
  28231. string
  28232. </em>
  28233. </td>
  28234. <td>
  28235. <em>(Optional)</em>
  28236. <p>You can assume a role before making calls to the
  28237. desired AWS service.</p>
  28238. </td>
  28239. </tr>
  28240. <tr>
  28241. <td>
  28242. <code>scope</code></br>
  28243. <em>
  28244. string
  28245. </em>
  28246. </td>
  28247. <td>
  28248. <em>(Optional)</em>
  28249. <p>Scope specifies the ECR service scope.
  28250. Valid options are private and public.</p>
  28251. </td>
  28252. </tr>
  28253. </tbody>
  28254. </table>
  28255. <h3 id="generators.external-secrets.io/v1alpha1.Fake">Fake
  28256. </h3>
  28257. <p>
  28258. <p>Fake generator is used for testing. It lets you define
  28259. a static set of credentials that is always returned.</p>
  28260. </p>
  28261. <table>
  28262. <thead>
  28263. <tr>
  28264. <th>Field</th>
  28265. <th>Description</th>
  28266. </tr>
  28267. </thead>
  28268. <tbody>
  28269. <tr>
  28270. <td>
  28271. <code>metadata</code></br>
  28272. <em>
  28273. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28274. Kubernetes meta/v1.ObjectMeta
  28275. </a>
  28276. </em>
  28277. </td>
  28278. <td>
  28279. Refer to the Kubernetes API documentation for the fields of the
  28280. <code>metadata</code> field.
  28281. </td>
  28282. </tr>
  28283. <tr>
  28284. <td>
  28285. <code>spec</code></br>
  28286. <em>
  28287. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  28288. FakeSpec
  28289. </a>
  28290. </em>
  28291. </td>
  28292. <td>
  28293. <br/>
  28294. <br/>
  28295. <table>
  28296. <tr>
  28297. <td>
  28298. <code>controller</code></br>
  28299. <em>
  28300. string
  28301. </em>
  28302. </td>
  28303. <td>
  28304. <em>(Optional)</em>
  28305. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  28306. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  28307. </td>
  28308. </tr>
  28309. <tr>
  28310. <td>
  28311. <code>data</code></br>
  28312. <em>
  28313. map[string]string
  28314. </em>
  28315. </td>
  28316. <td>
  28317. <p>Data defines the static data returned
  28318. by this generator.</p>
  28319. </td>
  28320. </tr>
  28321. </table>
  28322. </td>
  28323. </tr>
  28324. </tbody>
  28325. </table>
  28326. <h3 id="generators.external-secrets.io/v1alpha1.FakeSpec">FakeSpec
  28327. </h3>
  28328. <p>
  28329. (<em>Appears on:</em>
  28330. <a href="#generators.external-secrets.io/v1alpha1.Fake">Fake</a>,
  28331. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28332. </p>
  28333. <p>
  28334. <p>FakeSpec contains the static data.</p>
  28335. </p>
  28336. <table>
  28337. <thead>
  28338. <tr>
  28339. <th>Field</th>
  28340. <th>Description</th>
  28341. </tr>
  28342. </thead>
  28343. <tbody>
  28344. <tr>
  28345. <td>
  28346. <code>controller</code></br>
  28347. <em>
  28348. string
  28349. </em>
  28350. </td>
  28351. <td>
  28352. <em>(Optional)</em>
  28353. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  28354. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  28355. </td>
  28356. </tr>
  28357. <tr>
  28358. <td>
  28359. <code>data</code></br>
  28360. <em>
  28361. map[string]string
  28362. </em>
  28363. </td>
  28364. <td>
  28365. <p>Data defines the static data returned
  28366. by this generator.</p>
  28367. </td>
  28368. </tr>
  28369. </tbody>
  28370. </table>
  28371. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth
  28372. </h3>
  28373. <p>
  28374. (<em>Appears on:</em>
  28375. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec</a>)
  28376. </p>
  28377. <p>
  28378. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform.</p>
  28379. </p>
  28380. <table>
  28381. <thead>
  28382. <tr>
  28383. <th>Field</th>
  28384. <th>Description</th>
  28385. </tr>
  28386. </thead>
  28387. <tbody>
  28388. <tr>
  28389. <td>
  28390. <code>secretRef</code></br>
  28391. <em>
  28392. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">
  28393. GCPSMAuthSecretRef
  28394. </a>
  28395. </em>
  28396. </td>
  28397. <td>
  28398. <em>(Optional)</em>
  28399. </td>
  28400. </tr>
  28401. <tr>
  28402. <td>
  28403. <code>workloadIdentity</code></br>
  28404. <em>
  28405. <a href="#generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">
  28406. GCPWorkloadIdentity
  28407. </a>
  28408. </em>
  28409. </td>
  28410. <td>
  28411. <em>(Optional)</em>
  28412. </td>
  28413. </tr>
  28414. <tr>
  28415. <td>
  28416. <code>workloadIdentityFederation</code></br>
  28417. <em>
  28418. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  28419. GCPWorkloadIdentityFederation
  28420. </a>
  28421. </em>
  28422. </td>
  28423. <td>
  28424. <em>(Optional)</em>
  28425. </td>
  28426. </tr>
  28427. </tbody>
  28428. </table>
  28429. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  28430. </h3>
  28431. <p>
  28432. (<em>Appears on:</em>
  28433. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  28434. </p>
  28435. <p>
  28436. <p>GCPSMAuthSecretRef defines the reference to a secret containing Google Cloud Platform credentials.</p>
  28437. </p>
  28438. <table>
  28439. <thead>
  28440. <tr>
  28441. <th>Field</th>
  28442. <th>Description</th>
  28443. </tr>
  28444. </thead>
  28445. <tbody>
  28446. <tr>
  28447. <td>
  28448. <code>secretAccessKeySecretRef</code></br>
  28449. <em>
  28450. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28451. External Secrets meta/v1.SecretKeySelector
  28452. </a>
  28453. </em>
  28454. </td>
  28455. <td>
  28456. <em>(Optional)</em>
  28457. <p>The SecretAccessKey is used for authentication</p>
  28458. </td>
  28459. </tr>
  28460. </tbody>
  28461. </table>
  28462. <h3 id="generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">GCPWorkloadIdentity
  28463. </h3>
  28464. <p>
  28465. (<em>Appears on:</em>
  28466. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  28467. </p>
  28468. <p>
  28469. <p>GCPWorkloadIdentity defines the configuration for using GCP Workload Identity authentication.</p>
  28470. </p>
  28471. <table>
  28472. <thead>
  28473. <tr>
  28474. <th>Field</th>
  28475. <th>Description</th>
  28476. </tr>
  28477. </thead>
  28478. <tbody>
  28479. <tr>
  28480. <td>
  28481. <code>serviceAccountRef</code></br>
  28482. <em>
  28483. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28484. External Secrets meta/v1.ServiceAccountSelector
  28485. </a>
  28486. </em>
  28487. </td>
  28488. <td>
  28489. </td>
  28490. </tr>
  28491. <tr>
  28492. <td>
  28493. <code>clusterLocation</code></br>
  28494. <em>
  28495. string
  28496. </em>
  28497. </td>
  28498. <td>
  28499. </td>
  28500. </tr>
  28501. <tr>
  28502. <td>
  28503. <code>clusterName</code></br>
  28504. <em>
  28505. string
  28506. </em>
  28507. </td>
  28508. <td>
  28509. </td>
  28510. </tr>
  28511. <tr>
  28512. <td>
  28513. <code>clusterProjectID</code></br>
  28514. <em>
  28515. string
  28516. </em>
  28517. </td>
  28518. <td>
  28519. </td>
  28520. </tr>
  28521. </tbody>
  28522. </table>
  28523. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken
  28524. </h3>
  28525. <p>
  28526. <p>GCRAccessToken generates an GCP access token
  28527. that can be used to authenticate with GCR.</p>
  28528. </p>
  28529. <table>
  28530. <thead>
  28531. <tr>
  28532. <th>Field</th>
  28533. <th>Description</th>
  28534. </tr>
  28535. </thead>
  28536. <tbody>
  28537. <tr>
  28538. <td>
  28539. <code>metadata</code></br>
  28540. <em>
  28541. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28542. Kubernetes meta/v1.ObjectMeta
  28543. </a>
  28544. </em>
  28545. </td>
  28546. <td>
  28547. Refer to the Kubernetes API documentation for the fields of the
  28548. <code>metadata</code> field.
  28549. </td>
  28550. </tr>
  28551. <tr>
  28552. <td>
  28553. <code>spec</code></br>
  28554. <em>
  28555. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  28556. GCRAccessTokenSpec
  28557. </a>
  28558. </em>
  28559. </td>
  28560. <td>
  28561. <br/>
  28562. <br/>
  28563. <table>
  28564. <tr>
  28565. <td>
  28566. <code>auth</code></br>
  28567. <em>
  28568. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  28569. GCPSMAuth
  28570. </a>
  28571. </em>
  28572. </td>
  28573. <td>
  28574. <p>Auth defines the means for authenticating with GCP</p>
  28575. </td>
  28576. </tr>
  28577. <tr>
  28578. <td>
  28579. <code>projectID</code></br>
  28580. <em>
  28581. string
  28582. </em>
  28583. </td>
  28584. <td>
  28585. <p>ProjectID defines which project to use to authenticate with</p>
  28586. </td>
  28587. </tr>
  28588. </table>
  28589. </td>
  28590. </tr>
  28591. </tbody>
  28592. </table>
  28593. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec
  28594. </h3>
  28595. <p>
  28596. (<em>Appears on:</em>
  28597. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken</a>,
  28598. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28599. </p>
  28600. <p>
  28601. <p>GCRAccessTokenSpec defines the desired state to generate a Google Container Registry access token.</p>
  28602. </p>
  28603. <table>
  28604. <thead>
  28605. <tr>
  28606. <th>Field</th>
  28607. <th>Description</th>
  28608. </tr>
  28609. </thead>
  28610. <tbody>
  28611. <tr>
  28612. <td>
  28613. <code>auth</code></br>
  28614. <em>
  28615. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  28616. GCPSMAuth
  28617. </a>
  28618. </em>
  28619. </td>
  28620. <td>
  28621. <p>Auth defines the means for authenticating with GCP</p>
  28622. </td>
  28623. </tr>
  28624. <tr>
  28625. <td>
  28626. <code>projectID</code></br>
  28627. <em>
  28628. string
  28629. </em>
  28630. </td>
  28631. <td>
  28632. <p>ProjectID defines which project to use to authenticate with</p>
  28633. </td>
  28634. </tr>
  28635. </tbody>
  28636. </table>
  28637. <h3 id="generators.external-secrets.io/v1alpha1.Generator">Generator
  28638. </h3>
  28639. <p>
  28640. <p>Generator is the common interface for all generators that is actually used to generate whatever is needed.</p>
  28641. </p>
  28642. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorKind">GeneratorKind
  28643. (<code>string</code> alias)</p></h3>
  28644. <p>
  28645. (<em>Appears on:</em>
  28646. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  28647. </p>
  28648. <p>
  28649. <p>GeneratorKind represents a kind of generator.</p>
  28650. </p>
  28651. <table>
  28652. <thead>
  28653. <tr>
  28654. <th>Value</th>
  28655. <th>Description</th>
  28656. </tr>
  28657. </thead>
  28658. <tbody><tr><td><p>&#34;ACRAccessToken&#34;</p></td>
  28659. <td><p>GeneratorKindACRAccessToken represents an Azure Container Registry access token generator.</p>
  28660. </td>
  28661. </tr><tr><td><p>&#34;BeyondtrustWorkloadCredentialsDynamicSecret&#34;</p></td>
  28662. <td><p>GeneratorKindBeyondtrustWorkloadCredentialsDynamicSecret represents a BeyondTrust Workload Credentials dynamic secret generator.</p>
  28663. </td>
  28664. </tr><tr><td><p>&#34;CloudsmithAccessToken&#34;</p></td>
  28665. <td><p>GeneratorKindCloudsmithAccessToken represents a Cloudsmith access token generator.</p>
  28666. </td>
  28667. </tr><tr><td><p>&#34;ECRAuthorizationToken&#34;</p></td>
  28668. <td><p>GeneratorKindECRAuthorizationToken represents an AWS ECR authorization token generator.</p>
  28669. </td>
  28670. </tr><tr><td><p>&#34;Fake&#34;</p></td>
  28671. <td><p>GeneratorKindFake represents a fake generator for testing purposes.</p>
  28672. </td>
  28673. </tr><tr><td><p>&#34;GCRAccessToken&#34;</p></td>
  28674. <td><p>GeneratorKindGCRAccessToken represents a Google Container Registry access token generator.</p>
  28675. </td>
  28676. </tr><tr><td><p>&#34;GithubAccessToken&#34;</p></td>
  28677. <td><p>GeneratorKindGithubAccessToken represents a GitHub access token generator.</p>
  28678. </td>
  28679. </tr><tr><td><p>&#34;GitlabDeployToken&#34;</p></td>
  28680. <td><p>GeneratorKindGitlabDeployToken represents a GitLab deploy token generator.</p>
  28681. </td>
  28682. </tr><tr><td><p>&#34;Grafana&#34;</p></td>
  28683. <td><p>GeneratorKindGrafana represents a Grafana token generator.</p>
  28684. </td>
  28685. </tr><tr><td><p>&#34;MFA&#34;</p></td>
  28686. <td><p>GeneratorKindMFA represents a Multi-Factor Authentication generator.</p>
  28687. </td>
  28688. </tr><tr><td><p>&#34;Password&#34;</p></td>
  28689. <td><p>GeneratorKindPassword represents a password generator.</p>
  28690. </td>
  28691. </tr><tr><td><p>&#34;QuayAccessToken&#34;</p></td>
  28692. <td><p>GeneratorKindQuayAccessToken represents a Quay access token generator.</p>
  28693. </td>
  28694. </tr><tr><td><p>&#34;SSHKey&#34;</p></td>
  28695. <td><p>GeneratorKindSSHKey represents an SSH key generator.</p>
  28696. </td>
  28697. </tr><tr><td><p>&#34;STSSessionToken&#34;</p></td>
  28698. <td><p>GeneratorKindSTSSessionToken represents an AWS STS session token generator.</p>
  28699. </td>
  28700. </tr><tr><td><p>&#34;UUID&#34;</p></td>
  28701. <td><p>GeneratorKindUUID represents a UUID generator.</p>
  28702. </td>
  28703. </tr><tr><td><p>&#34;VaultDynamicSecret&#34;</p></td>
  28704. <td><p>GeneratorKindVaultDynamicSecret represents a HashiCorp Vault dynamic secret generator.</p>
  28705. </td>
  28706. </tr><tr><td><p>&#34;Webhook&#34;</p></td>
  28707. <td><p>GeneratorKindWebhook represents a webhook-based generator.</p>
  28708. </td>
  28709. </tr></tbody>
  28710. </table>
  28711. <h3 id="&lt;UNKNOWN_API_GROUP&gt;.GeneratorProviderState">GeneratorProviderState
  28712. </h3>
  28713. <p>
  28714. <p>GeneratorProviderState represents the state of a generator provider that can be stored and retrieved.</p>
  28715. </p>
  28716. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec
  28717. </h3>
  28718. <p>
  28719. (<em>Appears on:</em>
  28720. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  28721. </p>
  28722. <p>
  28723. <p>GeneratorSpec defines the configuration for various supported generator types.</p>
  28724. </p>
  28725. <table>
  28726. <thead>
  28727. <tr>
  28728. <th>Field</th>
  28729. <th>Description</th>
  28730. </tr>
  28731. </thead>
  28732. <tbody>
  28733. <tr>
  28734. <td>
  28735. <code>acrAccessTokenSpec</code></br>
  28736. <em>
  28737. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  28738. ACRAccessTokenSpec
  28739. </a>
  28740. </em>
  28741. </td>
  28742. <td>
  28743. </td>
  28744. </tr>
  28745. <tr>
  28746. <td>
  28747. <code>beyondtrustWorkloadCredentialsDynamicSecretSpec</code></br>
  28748. <em>
  28749. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">
  28750. BeyondtrustWorkloadCredentialsDynamicSecretSpec
  28751. </a>
  28752. </em>
  28753. </td>
  28754. <td>
  28755. </td>
  28756. </tr>
  28757. <tr>
  28758. <td>
  28759. <code>cloudsmithAccessTokenSpec</code></br>
  28760. <em>
  28761. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  28762. CloudsmithAccessTokenSpec
  28763. </a>
  28764. </em>
  28765. </td>
  28766. <td>
  28767. </td>
  28768. </tr>
  28769. <tr>
  28770. <td>
  28771. <code>ecrAuthorizationTokenSpec</code></br>
  28772. <em>
  28773. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  28774. ECRAuthorizationTokenSpec
  28775. </a>
  28776. </em>
  28777. </td>
  28778. <td>
  28779. </td>
  28780. </tr>
  28781. <tr>
  28782. <td>
  28783. <code>fakeSpec</code></br>
  28784. <em>
  28785. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  28786. FakeSpec
  28787. </a>
  28788. </em>
  28789. </td>
  28790. <td>
  28791. </td>
  28792. </tr>
  28793. <tr>
  28794. <td>
  28795. <code>gcrAccessTokenSpec</code></br>
  28796. <em>
  28797. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  28798. GCRAccessTokenSpec
  28799. </a>
  28800. </em>
  28801. </td>
  28802. <td>
  28803. </td>
  28804. </tr>
  28805. <tr>
  28806. <td>
  28807. <code>githubAccessTokenSpec</code></br>
  28808. <em>
  28809. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  28810. GithubAccessTokenSpec
  28811. </a>
  28812. </em>
  28813. </td>
  28814. <td>
  28815. </td>
  28816. </tr>
  28817. <tr>
  28818. <td>
  28819. <code>gitlabDeployTokenSpec</code></br>
  28820. <em>
  28821. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">
  28822. GitlabDeployTokenSpec
  28823. </a>
  28824. </em>
  28825. </td>
  28826. <td>
  28827. </td>
  28828. </tr>
  28829. <tr>
  28830. <td>
  28831. <code>quayAccessTokenSpec</code></br>
  28832. <em>
  28833. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  28834. QuayAccessTokenSpec
  28835. </a>
  28836. </em>
  28837. </td>
  28838. <td>
  28839. </td>
  28840. </tr>
  28841. <tr>
  28842. <td>
  28843. <code>passwordSpec</code></br>
  28844. <em>
  28845. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  28846. PasswordSpec
  28847. </a>
  28848. </em>
  28849. </td>
  28850. <td>
  28851. </td>
  28852. </tr>
  28853. <tr>
  28854. <td>
  28855. <code>sshKeySpec</code></br>
  28856. <em>
  28857. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  28858. SSHKeySpec
  28859. </a>
  28860. </em>
  28861. </td>
  28862. <td>
  28863. </td>
  28864. </tr>
  28865. <tr>
  28866. <td>
  28867. <code>stsSessionTokenSpec</code></br>
  28868. <em>
  28869. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  28870. STSSessionTokenSpec
  28871. </a>
  28872. </em>
  28873. </td>
  28874. <td>
  28875. </td>
  28876. </tr>
  28877. <tr>
  28878. <td>
  28879. <code>uuidSpec</code></br>
  28880. <em>
  28881. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  28882. UUIDSpec
  28883. </a>
  28884. </em>
  28885. </td>
  28886. <td>
  28887. </td>
  28888. </tr>
  28889. <tr>
  28890. <td>
  28891. <code>vaultDynamicSecretSpec</code></br>
  28892. <em>
  28893. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  28894. VaultDynamicSecretSpec
  28895. </a>
  28896. </em>
  28897. </td>
  28898. <td>
  28899. </td>
  28900. </tr>
  28901. <tr>
  28902. <td>
  28903. <code>webhookSpec</code></br>
  28904. <em>
  28905. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  28906. WebhookSpec
  28907. </a>
  28908. </em>
  28909. </td>
  28910. <td>
  28911. </td>
  28912. </tr>
  28913. <tr>
  28914. <td>
  28915. <code>grafanaSpec</code></br>
  28916. <em>
  28917. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  28918. GrafanaSpec
  28919. </a>
  28920. </em>
  28921. </td>
  28922. <td>
  28923. </td>
  28924. </tr>
  28925. <tr>
  28926. <td>
  28927. <code>mfaSpec</code></br>
  28928. <em>
  28929. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  28930. MFASpec
  28931. </a>
  28932. </em>
  28933. </td>
  28934. <td>
  28935. </td>
  28936. </tr>
  28937. </tbody>
  28938. </table>
  28939. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState
  28940. </h3>
  28941. <p>
  28942. <p>GeneratorState represents the state created and managed by a generator resource.</p>
  28943. </p>
  28944. <table>
  28945. <thead>
  28946. <tr>
  28947. <th>Field</th>
  28948. <th>Description</th>
  28949. </tr>
  28950. </thead>
  28951. <tbody>
  28952. <tr>
  28953. <td>
  28954. <code>metadata</code></br>
  28955. <em>
  28956. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28957. Kubernetes meta/v1.ObjectMeta
  28958. </a>
  28959. </em>
  28960. </td>
  28961. <td>
  28962. Refer to the Kubernetes API documentation for the fields of the
  28963. <code>metadata</code> field.
  28964. </td>
  28965. </tr>
  28966. <tr>
  28967. <td>
  28968. <code>spec</code></br>
  28969. <em>
  28970. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateSpec">
  28971. GeneratorStateSpec
  28972. </a>
  28973. </em>
  28974. </td>
  28975. <td>
  28976. <br/>
  28977. <br/>
  28978. <table>
  28979. <tr>
  28980. <td>
  28981. <code>garbageCollectionDeadline</code></br>
  28982. <em>
  28983. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  28984. Kubernetes meta/v1.Time
  28985. </a>
  28986. </em>
  28987. </td>
  28988. <td>
  28989. <p>GarbageCollectionDeadline is the time after which the generator state
  28990. will be deleted.
  28991. It is set by the controller which creates the generator state and
  28992. can be set configured by the user.
  28993. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  28994. </td>
  28995. </tr>
  28996. <tr>
  28997. <td>
  28998. <code>resource</code></br>
  28999. <em>
  29000. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29001. </em>
  29002. </td>
  29003. <td>
  29004. <p>Resource is the generator manifest that produced the state.
  29005. It is a snapshot of the generator manifest at the time the state was produced.
  29006. This manifest will be used to delete the resource. Any configuration that is referenced
  29007. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  29008. be blocked by a finalizer.</p>
  29009. </td>
  29010. </tr>
  29011. <tr>
  29012. <td>
  29013. <code>state</code></br>
  29014. <em>
  29015. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29016. </em>
  29017. </td>
  29018. <td>
  29019. <p>State is the state that was produced by the generator implementation.</p>
  29020. </td>
  29021. </tr>
  29022. </table>
  29023. </td>
  29024. </tr>
  29025. <tr>
  29026. <td>
  29027. <code>status</code></br>
  29028. <em>
  29029. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">
  29030. GeneratorStateStatus
  29031. </a>
  29032. </em>
  29033. </td>
  29034. <td>
  29035. </td>
  29036. </tr>
  29037. </tbody>
  29038. </table>
  29039. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">GeneratorStateConditionType
  29040. (<code>string</code> alias)</p></h3>
  29041. <p>
  29042. (<em>Appears on:</em>
  29043. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition</a>)
  29044. </p>
  29045. <p>
  29046. <p>GeneratorStateConditionType represents the type of condition for a generator state.</p>
  29047. </p>
  29048. <table>
  29049. <thead>
  29050. <tr>
  29051. <th>Value</th>
  29052. <th>Description</th>
  29053. </tr>
  29054. </thead>
  29055. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  29056. <td><p>GeneratorStateReady indicates the generator state is ready and available.</p>
  29057. </td>
  29058. </tr></tbody>
  29059. </table>
  29060. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateSpec">GeneratorStateSpec
  29061. </h3>
  29062. <p>
  29063. (<em>Appears on:</em>
  29064. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  29065. </p>
  29066. <p>
  29067. <p>GeneratorStateSpec defines the desired state of a generator state resource.</p>
  29068. </p>
  29069. <table>
  29070. <thead>
  29071. <tr>
  29072. <th>Field</th>
  29073. <th>Description</th>
  29074. </tr>
  29075. </thead>
  29076. <tbody>
  29077. <tr>
  29078. <td>
  29079. <code>garbageCollectionDeadline</code></br>
  29080. <em>
  29081. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29082. Kubernetes meta/v1.Time
  29083. </a>
  29084. </em>
  29085. </td>
  29086. <td>
  29087. <p>GarbageCollectionDeadline is the time after which the generator state
  29088. will be deleted.
  29089. It is set by the controller which creates the generator state and
  29090. can be set configured by the user.
  29091. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  29092. </td>
  29093. </tr>
  29094. <tr>
  29095. <td>
  29096. <code>resource</code></br>
  29097. <em>
  29098. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29099. </em>
  29100. </td>
  29101. <td>
  29102. <p>Resource is the generator manifest that produced the state.
  29103. It is a snapshot of the generator manifest at the time the state was produced.
  29104. This manifest will be used to delete the resource. Any configuration that is referenced
  29105. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  29106. be blocked by a finalizer.</p>
  29107. </td>
  29108. </tr>
  29109. <tr>
  29110. <td>
  29111. <code>state</code></br>
  29112. <em>
  29113. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29114. </em>
  29115. </td>
  29116. <td>
  29117. <p>State is the state that was produced by the generator implementation.</p>
  29118. </td>
  29119. </tr>
  29120. </tbody>
  29121. </table>
  29122. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus
  29123. </h3>
  29124. <p>
  29125. (<em>Appears on:</em>
  29126. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  29127. </p>
  29128. <p>
  29129. <p>GeneratorStateStatus defines the observed state of a generator state resource.</p>
  29130. </p>
  29131. <table>
  29132. <thead>
  29133. <tr>
  29134. <th>Field</th>
  29135. <th>Description</th>
  29136. </tr>
  29137. </thead>
  29138. <tbody>
  29139. <tr>
  29140. <td>
  29141. <code>conditions</code></br>
  29142. <em>
  29143. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">
  29144. []GeneratorStateStatusCondition
  29145. </a>
  29146. </em>
  29147. </td>
  29148. <td>
  29149. </td>
  29150. </tr>
  29151. </tbody>
  29152. </table>
  29153. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition
  29154. </h3>
  29155. <p>
  29156. (<em>Appears on:</em>
  29157. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus</a>)
  29158. </p>
  29159. <p>
  29160. <p>GeneratorStateStatusCondition represents the observed condition of a generator state.</p>
  29161. </p>
  29162. <table>
  29163. <thead>
  29164. <tr>
  29165. <th>Field</th>
  29166. <th>Description</th>
  29167. </tr>
  29168. </thead>
  29169. <tbody>
  29170. <tr>
  29171. <td>
  29172. <code>type</code></br>
  29173. <em>
  29174. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">
  29175. GeneratorStateConditionType
  29176. </a>
  29177. </em>
  29178. </td>
  29179. <td>
  29180. </td>
  29181. </tr>
  29182. <tr>
  29183. <td>
  29184. <code>status</code></br>
  29185. <em>
  29186. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  29187. Kubernetes core/v1.ConditionStatus
  29188. </a>
  29189. </em>
  29190. </td>
  29191. <td>
  29192. </td>
  29193. </tr>
  29194. <tr>
  29195. <td>
  29196. <code>reason</code></br>
  29197. <em>
  29198. string
  29199. </em>
  29200. </td>
  29201. <td>
  29202. <em>(Optional)</em>
  29203. </td>
  29204. </tr>
  29205. <tr>
  29206. <td>
  29207. <code>message</code></br>
  29208. <em>
  29209. string
  29210. </em>
  29211. </td>
  29212. <td>
  29213. <em>(Optional)</em>
  29214. </td>
  29215. </tr>
  29216. <tr>
  29217. <td>
  29218. <code>lastTransitionTime</code></br>
  29219. <em>
  29220. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29221. Kubernetes meta/v1.Time
  29222. </a>
  29223. </em>
  29224. </td>
  29225. <td>
  29226. <em>(Optional)</em>
  29227. </td>
  29228. </tr>
  29229. </tbody>
  29230. </table>
  29231. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken
  29232. </h3>
  29233. <p>
  29234. <p>GithubAccessToken generates ghs_ accessToken</p>
  29235. </p>
  29236. <table>
  29237. <thead>
  29238. <tr>
  29239. <th>Field</th>
  29240. <th>Description</th>
  29241. </tr>
  29242. </thead>
  29243. <tbody>
  29244. <tr>
  29245. <td>
  29246. <code>metadata</code></br>
  29247. <em>
  29248. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29249. Kubernetes meta/v1.ObjectMeta
  29250. </a>
  29251. </em>
  29252. </td>
  29253. <td>
  29254. Refer to the Kubernetes API documentation for the fields of the
  29255. <code>metadata</code> field.
  29256. </td>
  29257. </tr>
  29258. <tr>
  29259. <td>
  29260. <code>spec</code></br>
  29261. <em>
  29262. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  29263. GithubAccessTokenSpec
  29264. </a>
  29265. </em>
  29266. </td>
  29267. <td>
  29268. <br/>
  29269. <br/>
  29270. <table>
  29271. <tr>
  29272. <td>
  29273. <code>url</code></br>
  29274. <em>
  29275. string
  29276. </em>
  29277. </td>
  29278. <td>
  29279. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  29280. </td>
  29281. </tr>
  29282. <tr>
  29283. <td>
  29284. <code>appID</code></br>
  29285. <em>
  29286. string
  29287. </em>
  29288. </td>
  29289. <td>
  29290. </td>
  29291. </tr>
  29292. <tr>
  29293. <td>
  29294. <code>installID</code></br>
  29295. <em>
  29296. string
  29297. </em>
  29298. </td>
  29299. <td>
  29300. </td>
  29301. </tr>
  29302. <tr>
  29303. <td>
  29304. <code>repositories</code></br>
  29305. <em>
  29306. []string
  29307. </em>
  29308. </td>
  29309. <td>
  29310. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  29311. is installed to.</p>
  29312. </td>
  29313. </tr>
  29314. <tr>
  29315. <td>
  29316. <code>permissions</code></br>
  29317. <em>
  29318. map[string]string
  29319. </em>
  29320. </td>
  29321. <td>
  29322. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  29323. </td>
  29324. </tr>
  29325. <tr>
  29326. <td>
  29327. <code>auth</code></br>
  29328. <em>
  29329. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  29330. GithubAuth
  29331. </a>
  29332. </em>
  29333. </td>
  29334. <td>
  29335. <p>Auth configures how ESO authenticates with a Github instance.</p>
  29336. </td>
  29337. </tr>
  29338. </table>
  29339. </td>
  29340. </tr>
  29341. </tbody>
  29342. </table>
  29343. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec
  29344. </h3>
  29345. <p>
  29346. (<em>Appears on:</em>
  29347. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29348. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken</a>)
  29349. </p>
  29350. <p>
  29351. <p>GithubAccessTokenSpec defines the desired state to generate a GitHub access token.</p>
  29352. </p>
  29353. <table>
  29354. <thead>
  29355. <tr>
  29356. <th>Field</th>
  29357. <th>Description</th>
  29358. </tr>
  29359. </thead>
  29360. <tbody>
  29361. <tr>
  29362. <td>
  29363. <code>url</code></br>
  29364. <em>
  29365. string
  29366. </em>
  29367. </td>
  29368. <td>
  29369. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  29370. </td>
  29371. </tr>
  29372. <tr>
  29373. <td>
  29374. <code>appID</code></br>
  29375. <em>
  29376. string
  29377. </em>
  29378. </td>
  29379. <td>
  29380. </td>
  29381. </tr>
  29382. <tr>
  29383. <td>
  29384. <code>installID</code></br>
  29385. <em>
  29386. string
  29387. </em>
  29388. </td>
  29389. <td>
  29390. </td>
  29391. </tr>
  29392. <tr>
  29393. <td>
  29394. <code>repositories</code></br>
  29395. <em>
  29396. []string
  29397. </em>
  29398. </td>
  29399. <td>
  29400. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  29401. is installed to.</p>
  29402. </td>
  29403. </tr>
  29404. <tr>
  29405. <td>
  29406. <code>permissions</code></br>
  29407. <em>
  29408. map[string]string
  29409. </em>
  29410. </td>
  29411. <td>
  29412. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  29413. </td>
  29414. </tr>
  29415. <tr>
  29416. <td>
  29417. <code>auth</code></br>
  29418. <em>
  29419. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  29420. GithubAuth
  29421. </a>
  29422. </em>
  29423. </td>
  29424. <td>
  29425. <p>Auth configures how ESO authenticates with a Github instance.</p>
  29426. </td>
  29427. </tr>
  29428. </tbody>
  29429. </table>
  29430. <h3 id="generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth
  29431. </h3>
  29432. <p>
  29433. (<em>Appears on:</em>
  29434. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec</a>)
  29435. </p>
  29436. <p>
  29437. <p>GithubAuth defines the authentication configuration for GitHub access.</p>
  29438. </p>
  29439. <table>
  29440. <thead>
  29441. <tr>
  29442. <th>Field</th>
  29443. <th>Description</th>
  29444. </tr>
  29445. </thead>
  29446. <tbody>
  29447. <tr>
  29448. <td>
  29449. <code>privateKey</code></br>
  29450. <em>
  29451. <a href="#generators.external-secrets.io/v1alpha1.GithubSecretRef">
  29452. GithubSecretRef
  29453. </a>
  29454. </em>
  29455. </td>
  29456. <td>
  29457. </td>
  29458. </tr>
  29459. </tbody>
  29460. </table>
  29461. <h3 id="generators.external-secrets.io/v1alpha1.GithubSecretRef">GithubSecretRef
  29462. </h3>
  29463. <p>
  29464. (<em>Appears on:</em>
  29465. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth</a>)
  29466. </p>
  29467. <p>
  29468. <p>GithubSecretRef references a secret containing GitHub credentials.</p>
  29469. </p>
  29470. <table>
  29471. <thead>
  29472. <tr>
  29473. <th>Field</th>
  29474. <th>Description</th>
  29475. </tr>
  29476. </thead>
  29477. <tbody>
  29478. <tr>
  29479. <td>
  29480. <code>secretRef</code></br>
  29481. <em>
  29482. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29483. External Secrets meta/v1.SecretKeySelector
  29484. </a>
  29485. </em>
  29486. </td>
  29487. <td>
  29488. </td>
  29489. </tr>
  29490. </tbody>
  29491. </table>
  29492. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployToken">GitlabDeployToken
  29493. </h3>
  29494. <p>
  29495. <p>GitlabDeployToken generates a GitLab deploy token.</p>
  29496. </p>
  29497. <table>
  29498. <thead>
  29499. <tr>
  29500. <th>Field</th>
  29501. <th>Description</th>
  29502. </tr>
  29503. </thead>
  29504. <tbody>
  29505. <tr>
  29506. <td>
  29507. <code>metadata</code></br>
  29508. <em>
  29509. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29510. Kubernetes meta/v1.ObjectMeta
  29511. </a>
  29512. </em>
  29513. </td>
  29514. <td>
  29515. Refer to the Kubernetes API documentation for the fields of the
  29516. <code>metadata</code> field.
  29517. </td>
  29518. </tr>
  29519. <tr>
  29520. <td>
  29521. <code>spec</code></br>
  29522. <em>
  29523. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">
  29524. GitlabDeployTokenSpec
  29525. </a>
  29526. </em>
  29527. </td>
  29528. <td>
  29529. <br/>
  29530. <br/>
  29531. <table>
  29532. <tr>
  29533. <td>
  29534. <code>url</code></br>
  29535. <em>
  29536. string
  29537. </em>
  29538. </td>
  29539. <td>
  29540. <em>(Optional)</em>
  29541. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com">https://gitlab.com</a>.</p>
  29542. </td>
  29543. </tr>
  29544. <tr>
  29545. <td>
  29546. <code>projectID</code></br>
  29547. <em>
  29548. string
  29549. </em>
  29550. </td>
  29551. <td>
  29552. <em>(Optional)</em>
  29553. <p>ProjectID is the numeric ID or unescaped path (e.g. group/project) of the
  29554. project to create the deploy token in. The generator URL-escapes paths before
  29555. calling the GitLab API, so do not pre-encode. Mutually exclusive with groupID.</p>
  29556. </td>
  29557. </tr>
  29558. <tr>
  29559. <td>
  29560. <code>groupID</code></br>
  29561. <em>
  29562. string
  29563. </em>
  29564. </td>
  29565. <td>
  29566. <em>(Optional)</em>
  29567. <p>GroupID is the numeric ID or unescaped path (e.g. parent/group) of the group to
  29568. create the deploy token in. The generator URL-escapes paths before calling the
  29569. GitLab API, so do not pre-encode. Mutually exclusive with projectID.</p>
  29570. </td>
  29571. </tr>
  29572. <tr>
  29573. <td>
  29574. <code>name</code></br>
  29575. <em>
  29576. string
  29577. </em>
  29578. </td>
  29579. <td>
  29580. <p>Name of the deploy token.</p>
  29581. </td>
  29582. </tr>
  29583. <tr>
  29584. <td>
  29585. <code>scopes</code></br>
  29586. <em>
  29587. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">
  29588. []GitlabDeployTokenScope
  29589. </a>
  29590. </em>
  29591. </td>
  29592. <td>
  29593. <p>Scopes granted to the deploy token. At least one scope is required.</p>
  29594. </td>
  29595. </tr>
  29596. <tr>
  29597. <td>
  29598. <code>expiresAt</code></br>
  29599. <em>
  29600. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29601. Kubernetes meta/v1.Time
  29602. </a>
  29603. </em>
  29604. </td>
  29605. <td>
  29606. <em>(Optional)</em>
  29607. <p>ExpiresAt is an optional expiry for the deploy token. If omitted the token does
  29608. not expire on the GitLab side and is revoked only when the generator state is
  29609. cleaned up (on regeneration or when the consuming ExternalSecret is deleted).</p>
  29610. </td>
  29611. </tr>
  29612. <tr>
  29613. <td>
  29614. <code>username</code></br>
  29615. <em>
  29616. string
  29617. </em>
  29618. </td>
  29619. <td>
  29620. <em>(Optional)</em>
  29621. <p>Username is an optional username for the deploy token. GitLab defaults it to
  29622. gitlab+deploy-token-{n} when omitted.</p>
  29623. </td>
  29624. </tr>
  29625. <tr>
  29626. <td>
  29627. <code>auth</code></br>
  29628. <em>
  29629. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">
  29630. GitlabDeployTokenAuth
  29631. </a>
  29632. </em>
  29633. </td>
  29634. <td>
  29635. <p>Auth configures how ESO authenticates with the GitLab API.</p>
  29636. </td>
  29637. </tr>
  29638. </table>
  29639. </td>
  29640. </tr>
  29641. </tbody>
  29642. </table>
  29643. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">GitlabDeployTokenAuth
  29644. </h3>
  29645. <p>
  29646. (<em>Appears on:</em>
  29647. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec</a>)
  29648. </p>
  29649. <p>
  29650. <p>GitlabDeployTokenAuth defines the authentication configuration for the GitLab API.</p>
  29651. </p>
  29652. <table>
  29653. <thead>
  29654. <tr>
  29655. <th>Field</th>
  29656. <th>Description</th>
  29657. </tr>
  29658. </thead>
  29659. <tbody>
  29660. <tr>
  29661. <td>
  29662. <code>token</code></br>
  29663. <em>
  29664. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSecretRef">
  29665. GitlabDeployTokenSecretRef
  29666. </a>
  29667. </em>
  29668. </td>
  29669. <td>
  29670. <p>Token references a secret containing a GitLab access token (personal, group, or
  29671. project) with the api scope and at least the Maintainer role on the target.</p>
  29672. </td>
  29673. </tr>
  29674. </tbody>
  29675. </table>
  29676. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">GitlabDeployTokenScope
  29677. (<code>string</code> alias)</p></h3>
  29678. <p>
  29679. (<em>Appears on:</em>
  29680. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec</a>)
  29681. </p>
  29682. <p>
  29683. <p>GitlabDeployTokenScope is a scope that can be granted to a GitLab deploy token.</p>
  29684. </p>
  29685. <table>
  29686. <thead>
  29687. <tr>
  29688. <th>Value</th>
  29689. <th>Description</th>
  29690. </tr>
  29691. </thead>
  29692. <tbody><tr><td><p>&#34;read_package_registry&#34;</p></td>
  29693. <td><p>GitlabDeployTokenScopeReadPackageRegistry allows read access to the package registry.</p>
  29694. </td>
  29695. </tr><tr><td><p>&#34;read_registry&#34;</p></td>
  29696. <td><p>GitlabDeployTokenScopeReadRegistry allows read access to the container registry.</p>
  29697. </td>
  29698. </tr><tr><td><p>&#34;read_repository&#34;</p></td>
  29699. <td><p>GitlabDeployTokenScopeReadRepository allows read access to the repository.</p>
  29700. </td>
  29701. </tr><tr><td><p>&#34;read_virtual_registry&#34;</p></td>
  29702. <td><p>GitlabDeployTokenScopeReadVirtualRegistry allows read access to the virtual registry (projects only).</p>
  29703. </td>
  29704. </tr><tr><td><p>&#34;write_package_registry&#34;</p></td>
  29705. <td><p>GitlabDeployTokenScopeWritePackageRegistry allows write access to the package registry.</p>
  29706. </td>
  29707. </tr><tr><td><p>&#34;write_registry&#34;</p></td>
  29708. <td><p>GitlabDeployTokenScopeWriteRegistry allows write access to the container registry.</p>
  29709. </td>
  29710. </tr><tr><td><p>&#34;write_virtual_registry&#34;</p></td>
  29711. <td><p>GitlabDeployTokenScopeWriteVirtualRegistry allows write access to the virtual registry (projects only).</p>
  29712. </td>
  29713. </tr></tbody>
  29714. </table>
  29715. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenSecretRef">GitlabDeployTokenSecretRef
  29716. </h3>
  29717. <p>
  29718. (<em>Appears on:</em>
  29719. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">GitlabDeployTokenAuth</a>)
  29720. </p>
  29721. <p>
  29722. <p>GitlabDeployTokenSecretRef references a secret containing a GitLab access token.</p>
  29723. </p>
  29724. <table>
  29725. <thead>
  29726. <tr>
  29727. <th>Field</th>
  29728. <th>Description</th>
  29729. </tr>
  29730. </thead>
  29731. <tbody>
  29732. <tr>
  29733. <td>
  29734. <code>secretRef</code></br>
  29735. <em>
  29736. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29737. External Secrets meta/v1.SecretKeySelector
  29738. </a>
  29739. </em>
  29740. </td>
  29741. <td>
  29742. </td>
  29743. </tr>
  29744. </tbody>
  29745. </table>
  29746. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec
  29747. </h3>
  29748. <p>
  29749. (<em>Appears on:</em>
  29750. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29751. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployToken">GitlabDeployToken</a>)
  29752. </p>
  29753. <p>
  29754. <p>GitlabDeployTokenSpec defines the desired state to generate a GitLab deploy token.</p>
  29755. </p>
  29756. <table>
  29757. <thead>
  29758. <tr>
  29759. <th>Field</th>
  29760. <th>Description</th>
  29761. </tr>
  29762. </thead>
  29763. <tbody>
  29764. <tr>
  29765. <td>
  29766. <code>url</code></br>
  29767. <em>
  29768. string
  29769. </em>
  29770. </td>
  29771. <td>
  29772. <em>(Optional)</em>
  29773. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com">https://gitlab.com</a>.</p>
  29774. </td>
  29775. </tr>
  29776. <tr>
  29777. <td>
  29778. <code>projectID</code></br>
  29779. <em>
  29780. string
  29781. </em>
  29782. </td>
  29783. <td>
  29784. <em>(Optional)</em>
  29785. <p>ProjectID is the numeric ID or unescaped path (e.g. group/project) of the
  29786. project to create the deploy token in. The generator URL-escapes paths before
  29787. calling the GitLab API, so do not pre-encode. Mutually exclusive with groupID.</p>
  29788. </td>
  29789. </tr>
  29790. <tr>
  29791. <td>
  29792. <code>groupID</code></br>
  29793. <em>
  29794. string
  29795. </em>
  29796. </td>
  29797. <td>
  29798. <em>(Optional)</em>
  29799. <p>GroupID is the numeric ID or unescaped path (e.g. parent/group) of the group to
  29800. create the deploy token in. The generator URL-escapes paths before calling the
  29801. GitLab API, so do not pre-encode. Mutually exclusive with projectID.</p>
  29802. </td>
  29803. </tr>
  29804. <tr>
  29805. <td>
  29806. <code>name</code></br>
  29807. <em>
  29808. string
  29809. </em>
  29810. </td>
  29811. <td>
  29812. <p>Name of the deploy token.</p>
  29813. </td>
  29814. </tr>
  29815. <tr>
  29816. <td>
  29817. <code>scopes</code></br>
  29818. <em>
  29819. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">
  29820. []GitlabDeployTokenScope
  29821. </a>
  29822. </em>
  29823. </td>
  29824. <td>
  29825. <p>Scopes granted to the deploy token. At least one scope is required.</p>
  29826. </td>
  29827. </tr>
  29828. <tr>
  29829. <td>
  29830. <code>expiresAt</code></br>
  29831. <em>
  29832. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29833. Kubernetes meta/v1.Time
  29834. </a>
  29835. </em>
  29836. </td>
  29837. <td>
  29838. <em>(Optional)</em>
  29839. <p>ExpiresAt is an optional expiry for the deploy token. If omitted the token does
  29840. not expire on the GitLab side and is revoked only when the generator state is
  29841. cleaned up (on regeneration or when the consuming ExternalSecret is deleted).</p>
  29842. </td>
  29843. </tr>
  29844. <tr>
  29845. <td>
  29846. <code>username</code></br>
  29847. <em>
  29848. string
  29849. </em>
  29850. </td>
  29851. <td>
  29852. <em>(Optional)</em>
  29853. <p>Username is an optional username for the deploy token. GitLab defaults it to
  29854. gitlab+deploy-token-{n} when omitted.</p>
  29855. </td>
  29856. </tr>
  29857. <tr>
  29858. <td>
  29859. <code>auth</code></br>
  29860. <em>
  29861. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">
  29862. GitlabDeployTokenAuth
  29863. </a>
  29864. </em>
  29865. </td>
  29866. <td>
  29867. <p>Auth configures how ESO authenticates with the GitLab API.</p>
  29868. </td>
  29869. </tr>
  29870. </tbody>
  29871. </table>
  29872. <h3 id="generators.external-secrets.io/v1alpha1.Grafana">Grafana
  29873. </h3>
  29874. <p>
  29875. <p>Grafana represents a generator for Grafana service account tokens.</p>
  29876. </p>
  29877. <table>
  29878. <thead>
  29879. <tr>
  29880. <th>Field</th>
  29881. <th>Description</th>
  29882. </tr>
  29883. </thead>
  29884. <tbody>
  29885. <tr>
  29886. <td>
  29887. <code>metadata</code></br>
  29888. <em>
  29889. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29890. Kubernetes meta/v1.ObjectMeta
  29891. </a>
  29892. </em>
  29893. </td>
  29894. <td>
  29895. Refer to the Kubernetes API documentation for the fields of the
  29896. <code>metadata</code> field.
  29897. </td>
  29898. </tr>
  29899. <tr>
  29900. <td>
  29901. <code>spec</code></br>
  29902. <em>
  29903. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  29904. GrafanaSpec
  29905. </a>
  29906. </em>
  29907. </td>
  29908. <td>
  29909. <br/>
  29910. <br/>
  29911. <table>
  29912. <tr>
  29913. <td>
  29914. <code>url</code></br>
  29915. <em>
  29916. string
  29917. </em>
  29918. </td>
  29919. <td>
  29920. <p>URL is the URL of the Grafana instance.</p>
  29921. </td>
  29922. </tr>
  29923. <tr>
  29924. <td>
  29925. <code>auth</code></br>
  29926. <em>
  29927. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  29928. GrafanaAuth
  29929. </a>
  29930. </em>
  29931. </td>
  29932. <td>
  29933. <p>Auth is the authentication configuration to authenticate
  29934. against the Grafana instance.</p>
  29935. </td>
  29936. </tr>
  29937. <tr>
  29938. <td>
  29939. <code>serviceAccount</code></br>
  29940. <em>
  29941. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  29942. GrafanaServiceAccount
  29943. </a>
  29944. </em>
  29945. </td>
  29946. <td>
  29947. <p>ServiceAccount is the configuration for the service account that
  29948. is supposed to be generated by the generator.</p>
  29949. </td>
  29950. </tr>
  29951. </table>
  29952. </td>
  29953. </tr>
  29954. </tbody>
  29955. </table>
  29956. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth
  29957. </h3>
  29958. <p>
  29959. (<em>Appears on:</em>
  29960. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  29961. </p>
  29962. <p>
  29963. <p>GrafanaAuth defines the authentication methods for connecting to a Grafana instance.</p>
  29964. </p>
  29965. <table>
  29966. <thead>
  29967. <tr>
  29968. <th>Field</th>
  29969. <th>Description</th>
  29970. </tr>
  29971. </thead>
  29972. <tbody>
  29973. <tr>
  29974. <td>
  29975. <code>token</code></br>
  29976. <em>
  29977. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  29978. SecretKeySelector
  29979. </a>
  29980. </em>
  29981. </td>
  29982. <td>
  29983. <em>(Optional)</em>
  29984. <p>A service account token used to authenticate against the Grafana instance.
  29985. Note: you need a token which has elevated permissions to create service accounts.
  29986. See here for the documentation on basic roles offered by Grafana:
  29987. <a href="https://grafana.com/docs/grafana/latest/administration/roles-and-permissions/access-control/rbac-fixed-basic-role-definitions/">https://grafana.com/docs/grafana/latest/administration/roles-and-permissions/access-control/rbac-fixed-basic-role-definitions/</a></p>
  29988. </td>
  29989. </tr>
  29990. <tr>
  29991. <td>
  29992. <code>basic</code></br>
  29993. <em>
  29994. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">
  29995. GrafanaBasicAuth
  29996. </a>
  29997. </em>
  29998. </td>
  29999. <td>
  30000. <em>(Optional)</em>
  30001. <p>Basic auth credentials used to authenticate against the Grafana instance.
  30002. Note: you need a token which has elevated permissions to create service accounts.
  30003. See here for the documentation on basic roles offered by Grafana:
  30004. <a href="https://grafana.com/docs/grafana/latest/administration/roles-and-permissions/access-control/rbac-fixed-basic-role-definitions/">https://grafana.com/docs/grafana/latest/administration/roles-and-permissions/access-control/rbac-fixed-basic-role-definitions/</a></p>
  30005. </td>
  30006. </tr>
  30007. </tbody>
  30008. </table>
  30009. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth
  30010. </h3>
  30011. <p>
  30012. (<em>Appears on:</em>
  30013. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>)
  30014. </p>
  30015. <p>
  30016. <p>GrafanaBasicAuth defines the credentials for basic authentication with Grafana.</p>
  30017. </p>
  30018. <table>
  30019. <thead>
  30020. <tr>
  30021. <th>Field</th>
  30022. <th>Description</th>
  30023. </tr>
  30024. </thead>
  30025. <tbody>
  30026. <tr>
  30027. <td>
  30028. <code>username</code></br>
  30029. <em>
  30030. string
  30031. </em>
  30032. </td>
  30033. <td>
  30034. <p>A basic auth username used to authenticate against the Grafana instance.</p>
  30035. </td>
  30036. </tr>
  30037. <tr>
  30038. <td>
  30039. <code>password</code></br>
  30040. <em>
  30041. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  30042. SecretKeySelector
  30043. </a>
  30044. </em>
  30045. </td>
  30046. <td>
  30047. <p>A basic auth password used to authenticate against the Grafana instance.</p>
  30048. </td>
  30049. </tr>
  30050. </tbody>
  30051. </table>
  30052. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">GrafanaServiceAccount
  30053. </h3>
  30054. <p>
  30055. (<em>Appears on:</em>
  30056. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  30057. </p>
  30058. <p>
  30059. <p>GrafanaServiceAccount defines the configuration for a Grafana service account to be created.</p>
  30060. </p>
  30061. <table>
  30062. <thead>
  30063. <tr>
  30064. <th>Field</th>
  30065. <th>Description</th>
  30066. </tr>
  30067. </thead>
  30068. <tbody>
  30069. <tr>
  30070. <td>
  30071. <code>name</code></br>
  30072. <em>
  30073. string
  30074. </em>
  30075. </td>
  30076. <td>
  30077. <p>Name is the name of the service account that will be created by ESO.</p>
  30078. </td>
  30079. </tr>
  30080. <tr>
  30081. <td>
  30082. <code>role</code></br>
  30083. <em>
  30084. string
  30085. </em>
  30086. </td>
  30087. <td>
  30088. <p>Role is the role of the service account.
  30089. See here for the documentation on basic roles offered by Grafana:
  30090. <a href="https://grafana.com/docs/grafana/latest/administration/roles-and-permissions/access-control/rbac-fixed-basic-role-definitions/">https://grafana.com/docs/grafana/latest/administration/roles-and-permissions/access-control/rbac-fixed-basic-role-definitions/</a></p>
  30091. </td>
  30092. </tr>
  30093. </tbody>
  30094. </table>
  30095. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState
  30096. </h3>
  30097. <p>
  30098. <p>GrafanaServiceAccountTokenState is the state type produced by the Grafana generator.
  30099. It contains the service account ID, login and token ID which is enough to
  30100. identify the service account.</p>
  30101. </p>
  30102. <table>
  30103. <thead>
  30104. <tr>
  30105. <th>Field</th>
  30106. <th>Description</th>
  30107. </tr>
  30108. </thead>
  30109. <tbody>
  30110. <tr>
  30111. <td>
  30112. <code>serviceAccount</code></br>
  30113. <em>
  30114. <a href="#generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">
  30115. GrafanaStateServiceAccount
  30116. </a>
  30117. </em>
  30118. </td>
  30119. <td>
  30120. </td>
  30121. </tr>
  30122. </tbody>
  30123. </table>
  30124. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec
  30125. </h3>
  30126. <p>
  30127. (<em>Appears on:</em>
  30128. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30129. <a href="#generators.external-secrets.io/v1alpha1.Grafana">Grafana</a>)
  30130. </p>
  30131. <p>
  30132. <p>GrafanaSpec controls the behavior of the grafana generator.</p>
  30133. </p>
  30134. <table>
  30135. <thead>
  30136. <tr>
  30137. <th>Field</th>
  30138. <th>Description</th>
  30139. </tr>
  30140. </thead>
  30141. <tbody>
  30142. <tr>
  30143. <td>
  30144. <code>url</code></br>
  30145. <em>
  30146. string
  30147. </em>
  30148. </td>
  30149. <td>
  30150. <p>URL is the URL of the Grafana instance.</p>
  30151. </td>
  30152. </tr>
  30153. <tr>
  30154. <td>
  30155. <code>auth</code></br>
  30156. <em>
  30157. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  30158. GrafanaAuth
  30159. </a>
  30160. </em>
  30161. </td>
  30162. <td>
  30163. <p>Auth is the authentication configuration to authenticate
  30164. against the Grafana instance.</p>
  30165. </td>
  30166. </tr>
  30167. <tr>
  30168. <td>
  30169. <code>serviceAccount</code></br>
  30170. <em>
  30171. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  30172. GrafanaServiceAccount
  30173. </a>
  30174. </em>
  30175. </td>
  30176. <td>
  30177. <p>ServiceAccount is the configuration for the service account that
  30178. is supposed to be generated by the generator.</p>
  30179. </td>
  30180. </tr>
  30181. </tbody>
  30182. </table>
  30183. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">GrafanaStateServiceAccount
  30184. </h3>
  30185. <p>
  30186. (<em>Appears on:</em>
  30187. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState</a>)
  30188. </p>
  30189. <p>
  30190. <p>GrafanaStateServiceAccount contains the service account ID, login and token ID.</p>
  30191. </p>
  30192. <table>
  30193. <thead>
  30194. <tr>
  30195. <th>Field</th>
  30196. <th>Description</th>
  30197. </tr>
  30198. </thead>
  30199. <tbody>
  30200. <tr>
  30201. <td>
  30202. <code>id</code></br>
  30203. <em>
  30204. int64
  30205. </em>
  30206. </td>
  30207. <td>
  30208. </td>
  30209. </tr>
  30210. <tr>
  30211. <td>
  30212. <code>login</code></br>
  30213. <em>
  30214. string
  30215. </em>
  30216. </td>
  30217. <td>
  30218. </td>
  30219. </tr>
  30220. <tr>
  30221. <td>
  30222. <code>tokenID</code></br>
  30223. <em>
  30224. int64
  30225. </em>
  30226. </td>
  30227. <td>
  30228. </td>
  30229. </tr>
  30230. </tbody>
  30231. </table>
  30232. <h3 id="generators.external-secrets.io/v1alpha1.MFA">MFA
  30233. </h3>
  30234. <p>
  30235. <p>MFA generates a new TOTP token that is compliant with RFC 6238.</p>
  30236. </p>
  30237. <table>
  30238. <thead>
  30239. <tr>
  30240. <th>Field</th>
  30241. <th>Description</th>
  30242. </tr>
  30243. </thead>
  30244. <tbody>
  30245. <tr>
  30246. <td>
  30247. <code>metadata</code></br>
  30248. <em>
  30249. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30250. Kubernetes meta/v1.ObjectMeta
  30251. </a>
  30252. </em>
  30253. </td>
  30254. <td>
  30255. Refer to the Kubernetes API documentation for the fields of the
  30256. <code>metadata</code> field.
  30257. </td>
  30258. </tr>
  30259. <tr>
  30260. <td>
  30261. <code>spec</code></br>
  30262. <em>
  30263. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  30264. MFASpec
  30265. </a>
  30266. </em>
  30267. </td>
  30268. <td>
  30269. <br/>
  30270. <br/>
  30271. <table>
  30272. <tr>
  30273. <td>
  30274. <code>secret</code></br>
  30275. <em>
  30276. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30277. External Secrets meta/v1.SecretKeySelector
  30278. </a>
  30279. </em>
  30280. </td>
  30281. <td>
  30282. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  30283. </td>
  30284. </tr>
  30285. <tr>
  30286. <td>
  30287. <code>length</code></br>
  30288. <em>
  30289. int
  30290. </em>
  30291. </td>
  30292. <td>
  30293. <p>Length defines the token length. Defaults to 6 characters.</p>
  30294. </td>
  30295. </tr>
  30296. <tr>
  30297. <td>
  30298. <code>timePeriod</code></br>
  30299. <em>
  30300. int
  30301. </em>
  30302. </td>
  30303. <td>
  30304. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  30305. </td>
  30306. </tr>
  30307. <tr>
  30308. <td>
  30309. <code>algorithm</code></br>
  30310. <em>
  30311. string
  30312. </em>
  30313. </td>
  30314. <td>
  30315. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  30316. </td>
  30317. </tr>
  30318. <tr>
  30319. <td>
  30320. <code>when</code></br>
  30321. <em>
  30322. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  30323. Kubernetes meta/v1.Time
  30324. </a>
  30325. </em>
  30326. </td>
  30327. <td>
  30328. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  30329. </td>
  30330. </tr>
  30331. </table>
  30332. </td>
  30333. </tr>
  30334. </tbody>
  30335. </table>
  30336. <h3 id="generators.external-secrets.io/v1alpha1.MFASpec">MFASpec
  30337. </h3>
  30338. <p>
  30339. (<em>Appears on:</em>
  30340. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30341. <a href="#generators.external-secrets.io/v1alpha1.MFA">MFA</a>)
  30342. </p>
  30343. <p>
  30344. <p>MFASpec controls the behavior of the mfa generator.</p>
  30345. </p>
  30346. <table>
  30347. <thead>
  30348. <tr>
  30349. <th>Field</th>
  30350. <th>Description</th>
  30351. </tr>
  30352. </thead>
  30353. <tbody>
  30354. <tr>
  30355. <td>
  30356. <code>secret</code></br>
  30357. <em>
  30358. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30359. External Secrets meta/v1.SecretKeySelector
  30360. </a>
  30361. </em>
  30362. </td>
  30363. <td>
  30364. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  30365. </td>
  30366. </tr>
  30367. <tr>
  30368. <td>
  30369. <code>length</code></br>
  30370. <em>
  30371. int
  30372. </em>
  30373. </td>
  30374. <td>
  30375. <p>Length defines the token length. Defaults to 6 characters.</p>
  30376. </td>
  30377. </tr>
  30378. <tr>
  30379. <td>
  30380. <code>timePeriod</code></br>
  30381. <em>
  30382. int
  30383. </em>
  30384. </td>
  30385. <td>
  30386. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  30387. </td>
  30388. </tr>
  30389. <tr>
  30390. <td>
  30391. <code>algorithm</code></br>
  30392. <em>
  30393. string
  30394. </em>
  30395. </td>
  30396. <td>
  30397. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  30398. </td>
  30399. </tr>
  30400. <tr>
  30401. <td>
  30402. <code>when</code></br>
  30403. <em>
  30404. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  30405. Kubernetes meta/v1.Time
  30406. </a>
  30407. </em>
  30408. </td>
  30409. <td>
  30410. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  30411. </td>
  30412. </tr>
  30413. </tbody>
  30414. </table>
  30415. <h3 id="generators.external-secrets.io/v1alpha1.NTLMProtocol">NTLMProtocol
  30416. </h3>
  30417. <p>
  30418. (<em>Appears on:</em>
  30419. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol</a>)
  30420. </p>
  30421. <p>
  30422. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  30423. </p>
  30424. <table>
  30425. <thead>
  30426. <tr>
  30427. <th>Field</th>
  30428. <th>Description</th>
  30429. </tr>
  30430. </thead>
  30431. <tbody>
  30432. <tr>
  30433. <td>
  30434. <code>usernameSecret</code></br>
  30435. <em>
  30436. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30437. External Secrets meta/v1.SecretKeySelector
  30438. </a>
  30439. </em>
  30440. </td>
  30441. <td>
  30442. </td>
  30443. </tr>
  30444. <tr>
  30445. <td>
  30446. <code>passwordSecret</code></br>
  30447. <em>
  30448. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30449. External Secrets meta/v1.SecretKeySelector
  30450. </a>
  30451. </em>
  30452. </td>
  30453. <td>
  30454. </td>
  30455. </tr>
  30456. </tbody>
  30457. </table>
  30458. <h3 id="generators.external-secrets.io/v1alpha1.Password">Password
  30459. </h3>
  30460. <p>
  30461. <p>Password generates a random password based on the
  30462. configuration parameters in spec.
  30463. You can specify the length, characterset and other attributes.</p>
  30464. </p>
  30465. <table>
  30466. <thead>
  30467. <tr>
  30468. <th>Field</th>
  30469. <th>Description</th>
  30470. </tr>
  30471. </thead>
  30472. <tbody>
  30473. <tr>
  30474. <td>
  30475. <code>metadata</code></br>
  30476. <em>
  30477. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30478. Kubernetes meta/v1.ObjectMeta
  30479. </a>
  30480. </em>
  30481. </td>
  30482. <td>
  30483. Refer to the Kubernetes API documentation for the fields of the
  30484. <code>metadata</code> field.
  30485. </td>
  30486. </tr>
  30487. <tr>
  30488. <td>
  30489. <code>spec</code></br>
  30490. <em>
  30491. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  30492. PasswordSpec
  30493. </a>
  30494. </em>
  30495. </td>
  30496. <td>
  30497. <br/>
  30498. <br/>
  30499. <table>
  30500. <tr>
  30501. <td>
  30502. <code>length</code></br>
  30503. <em>
  30504. int
  30505. </em>
  30506. </td>
  30507. <td>
  30508. <p>Length of the password to be generated.
  30509. Defaults to 24</p>
  30510. </td>
  30511. </tr>
  30512. <tr>
  30513. <td>
  30514. <code>digits</code></br>
  30515. <em>
  30516. int
  30517. </em>
  30518. </td>
  30519. <td>
  30520. <p>Digits specifies the number of digits in the generated
  30521. password. If omitted it defaults to 25% of the length of the password</p>
  30522. </td>
  30523. </tr>
  30524. <tr>
  30525. <td>
  30526. <code>symbols</code></br>
  30527. <em>
  30528. int
  30529. </em>
  30530. </td>
  30531. <td>
  30532. <p>Symbols specifies the number of symbol characters in the generated
  30533. password. If omitted it defaults to 25% of the length of the password</p>
  30534. </td>
  30535. </tr>
  30536. <tr>
  30537. <td>
  30538. <code>symbolCharacters</code></br>
  30539. <em>
  30540. string
  30541. </em>
  30542. </td>
  30543. <td>
  30544. <p>SymbolCharacters specifies the special characters that should be used
  30545. in the generated password.</p>
  30546. </td>
  30547. </tr>
  30548. <tr>
  30549. <td>
  30550. <code>noUpper</code></br>
  30551. <em>
  30552. bool
  30553. </em>
  30554. </td>
  30555. <td>
  30556. <p>Set NoUpper to disable uppercase characters</p>
  30557. </td>
  30558. </tr>
  30559. <tr>
  30560. <td>
  30561. <code>allowRepeat</code></br>
  30562. <em>
  30563. bool
  30564. </em>
  30565. </td>
  30566. <td>
  30567. <p>set AllowRepeat to true to allow repeating characters.</p>
  30568. </td>
  30569. </tr>
  30570. <tr>
  30571. <td>
  30572. <code>secretKeys</code></br>
  30573. <em>
  30574. []string
  30575. </em>
  30576. </td>
  30577. <td>
  30578. <em>(Optional)</em>
  30579. <p>SecretKeys defines the keys that will be populated with generated passwords.
  30580. Defaults to &ldquo;password&rdquo; when not set.</p>
  30581. </td>
  30582. </tr>
  30583. <tr>
  30584. <td>
  30585. <code>encoding</code></br>
  30586. <em>
  30587. string
  30588. </em>
  30589. </td>
  30590. <td>
  30591. <p>Encoding specifies the encoding of the generated password.
  30592. Valid values are:
  30593. - &ldquo;raw&rdquo; (default): no encoding
  30594. - &ldquo;base64&rdquo;: standard base64 encoding
  30595. - &ldquo;base64url&rdquo;: base64url encoding
  30596. - &ldquo;base32&rdquo;: base32 encoding
  30597. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  30598. </td>
  30599. </tr>
  30600. </table>
  30601. </td>
  30602. </tr>
  30603. </tbody>
  30604. </table>
  30605. <h3 id="generators.external-secrets.io/v1alpha1.PasswordSpec">PasswordSpec
  30606. </h3>
  30607. <p>
  30608. (<em>Appears on:</em>
  30609. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30610. <a href="#generators.external-secrets.io/v1alpha1.Password">Password</a>)
  30611. </p>
  30612. <p>
  30613. <p>PasswordSpec controls the behavior of the password generator.</p>
  30614. </p>
  30615. <table>
  30616. <thead>
  30617. <tr>
  30618. <th>Field</th>
  30619. <th>Description</th>
  30620. </tr>
  30621. </thead>
  30622. <tbody>
  30623. <tr>
  30624. <td>
  30625. <code>length</code></br>
  30626. <em>
  30627. int
  30628. </em>
  30629. </td>
  30630. <td>
  30631. <p>Length of the password to be generated.
  30632. Defaults to 24</p>
  30633. </td>
  30634. </tr>
  30635. <tr>
  30636. <td>
  30637. <code>digits</code></br>
  30638. <em>
  30639. int
  30640. </em>
  30641. </td>
  30642. <td>
  30643. <p>Digits specifies the number of digits in the generated
  30644. password. If omitted it defaults to 25% of the length of the password</p>
  30645. </td>
  30646. </tr>
  30647. <tr>
  30648. <td>
  30649. <code>symbols</code></br>
  30650. <em>
  30651. int
  30652. </em>
  30653. </td>
  30654. <td>
  30655. <p>Symbols specifies the number of symbol characters in the generated
  30656. password. If omitted it defaults to 25% of the length of the password</p>
  30657. </td>
  30658. </tr>
  30659. <tr>
  30660. <td>
  30661. <code>symbolCharacters</code></br>
  30662. <em>
  30663. string
  30664. </em>
  30665. </td>
  30666. <td>
  30667. <p>SymbolCharacters specifies the special characters that should be used
  30668. in the generated password.</p>
  30669. </td>
  30670. </tr>
  30671. <tr>
  30672. <td>
  30673. <code>noUpper</code></br>
  30674. <em>
  30675. bool
  30676. </em>
  30677. </td>
  30678. <td>
  30679. <p>Set NoUpper to disable uppercase characters</p>
  30680. </td>
  30681. </tr>
  30682. <tr>
  30683. <td>
  30684. <code>allowRepeat</code></br>
  30685. <em>
  30686. bool
  30687. </em>
  30688. </td>
  30689. <td>
  30690. <p>set AllowRepeat to true to allow repeating characters.</p>
  30691. </td>
  30692. </tr>
  30693. <tr>
  30694. <td>
  30695. <code>secretKeys</code></br>
  30696. <em>
  30697. []string
  30698. </em>
  30699. </td>
  30700. <td>
  30701. <em>(Optional)</em>
  30702. <p>SecretKeys defines the keys that will be populated with generated passwords.
  30703. Defaults to &ldquo;password&rdquo; when not set.</p>
  30704. </td>
  30705. </tr>
  30706. <tr>
  30707. <td>
  30708. <code>encoding</code></br>
  30709. <em>
  30710. string
  30711. </em>
  30712. </td>
  30713. <td>
  30714. <p>Encoding specifies the encoding of the generated password.
  30715. Valid values are:
  30716. - &ldquo;raw&rdquo; (default): no encoding
  30717. - &ldquo;base64&rdquo;: standard base64 encoding
  30718. - &ldquo;base64url&rdquo;: base64url encoding
  30719. - &ldquo;base32&rdquo;: base32 encoding
  30720. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  30721. </td>
  30722. </tr>
  30723. </tbody>
  30724. </table>
  30725. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken
  30726. </h3>
  30727. <p>
  30728. <p>QuayAccessToken generates Quay oauth token for pulling/pushing images</p>
  30729. </p>
  30730. <table>
  30731. <thead>
  30732. <tr>
  30733. <th>Field</th>
  30734. <th>Description</th>
  30735. </tr>
  30736. </thead>
  30737. <tbody>
  30738. <tr>
  30739. <td>
  30740. <code>metadata</code></br>
  30741. <em>
  30742. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30743. Kubernetes meta/v1.ObjectMeta
  30744. </a>
  30745. </em>
  30746. </td>
  30747. <td>
  30748. Refer to the Kubernetes API documentation for the fields of the
  30749. <code>metadata</code> field.
  30750. </td>
  30751. </tr>
  30752. <tr>
  30753. <td>
  30754. <code>spec</code></br>
  30755. <em>
  30756. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  30757. QuayAccessTokenSpec
  30758. </a>
  30759. </em>
  30760. </td>
  30761. <td>
  30762. <br/>
  30763. <br/>
  30764. <table>
  30765. <tr>
  30766. <td>
  30767. <code>url</code></br>
  30768. <em>
  30769. string
  30770. </em>
  30771. </td>
  30772. <td>
  30773. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  30774. </td>
  30775. </tr>
  30776. <tr>
  30777. <td>
  30778. <code>robotAccount</code></br>
  30779. <em>
  30780. string
  30781. </em>
  30782. </td>
  30783. <td>
  30784. <p>Name of the robot account you are federating with</p>
  30785. </td>
  30786. </tr>
  30787. <tr>
  30788. <td>
  30789. <code>serviceAccountRef</code></br>
  30790. <em>
  30791. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  30792. External Secrets meta/v1.ServiceAccountSelector
  30793. </a>
  30794. </em>
  30795. </td>
  30796. <td>
  30797. <p>Name of the service account you are federating with</p>
  30798. </td>
  30799. </tr>
  30800. </table>
  30801. </td>
  30802. </tr>
  30803. </tbody>
  30804. </table>
  30805. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">QuayAccessTokenSpec
  30806. </h3>
  30807. <p>
  30808. (<em>Appears on:</em>
  30809. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30810. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken</a>)
  30811. </p>
  30812. <p>
  30813. <p>QuayAccessTokenSpec defines the desired state to generate a Quay access token.</p>
  30814. </p>
  30815. <table>
  30816. <thead>
  30817. <tr>
  30818. <th>Field</th>
  30819. <th>Description</th>
  30820. </tr>
  30821. </thead>
  30822. <tbody>
  30823. <tr>
  30824. <td>
  30825. <code>url</code></br>
  30826. <em>
  30827. string
  30828. </em>
  30829. </td>
  30830. <td>
  30831. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  30832. </td>
  30833. </tr>
  30834. <tr>
  30835. <td>
  30836. <code>robotAccount</code></br>
  30837. <em>
  30838. string
  30839. </em>
  30840. </td>
  30841. <td>
  30842. <p>Name of the robot account you are federating with</p>
  30843. </td>
  30844. </tr>
  30845. <tr>
  30846. <td>
  30847. <code>serviceAccountRef</code></br>
  30848. <em>
  30849. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  30850. External Secrets meta/v1.ServiceAccountSelector
  30851. </a>
  30852. </em>
  30853. </td>
  30854. <td>
  30855. <p>Name of the service account you are federating with</p>
  30856. </td>
  30857. </tr>
  30858. </tbody>
  30859. </table>
  30860. <h3 id="generators.external-secrets.io/v1alpha1.RequestParameters">RequestParameters
  30861. </h3>
  30862. <p>
  30863. (<em>Appears on:</em>
  30864. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  30865. </p>
  30866. <p>
  30867. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  30868. </p>
  30869. <table>
  30870. <thead>
  30871. <tr>
  30872. <th>Field</th>
  30873. <th>Description</th>
  30874. </tr>
  30875. </thead>
  30876. <tbody>
  30877. <tr>
  30878. <td>
  30879. <code>sessionDuration</code></br>
  30880. <em>
  30881. int32
  30882. </em>
  30883. </td>
  30884. <td>
  30885. <em>(Optional)</em>
  30886. </td>
  30887. </tr>
  30888. <tr>
  30889. <td>
  30890. <code>serialNumber</code></br>
  30891. <em>
  30892. string
  30893. </em>
  30894. </td>
  30895. <td>
  30896. <em>(Optional)</em>
  30897. <p>SerialNumber is the identification number of the MFA device that is associated with the IAM user who is making
  30898. the GetSessionToken call.
  30899. Possible values: hardware device (such as GAHT12345678) or an Amazon Resource Name (ARN) for a virtual device
  30900. (such as arn:aws:iam::123456789012:mfa/user)</p>
  30901. </td>
  30902. </tr>
  30903. <tr>
  30904. <td>
  30905. <code>tokenCode</code></br>
  30906. <em>
  30907. string
  30908. </em>
  30909. </td>
  30910. <td>
  30911. <em>(Optional)</em>
  30912. <p>TokenCode is the value provided by the MFA device, if MFA is required.</p>
  30913. </td>
  30914. </tr>
  30915. </tbody>
  30916. </table>
  30917. <h3 id="generators.external-secrets.io/v1alpha1.SSHKey">SSHKey
  30918. </h3>
  30919. <p>
  30920. <p>SSHKey generates SSH key pairs.</p>
  30921. </p>
  30922. <table>
  30923. <thead>
  30924. <tr>
  30925. <th>Field</th>
  30926. <th>Description</th>
  30927. </tr>
  30928. </thead>
  30929. <tbody>
  30930. <tr>
  30931. <td>
  30932. <code>metadata</code></br>
  30933. <em>
  30934. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30935. Kubernetes meta/v1.ObjectMeta
  30936. </a>
  30937. </em>
  30938. </td>
  30939. <td>
  30940. Refer to the Kubernetes API documentation for the fields of the
  30941. <code>metadata</code> field.
  30942. </td>
  30943. </tr>
  30944. <tr>
  30945. <td>
  30946. <code>spec</code></br>
  30947. <em>
  30948. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  30949. SSHKeySpec
  30950. </a>
  30951. </em>
  30952. </td>
  30953. <td>
  30954. <br/>
  30955. <br/>
  30956. <table>
  30957. <tr>
  30958. <td>
  30959. <code>keyType</code></br>
  30960. <em>
  30961. string
  30962. </em>
  30963. </td>
  30964. <td>
  30965. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  30966. </td>
  30967. </tr>
  30968. <tr>
  30969. <td>
  30970. <code>keySize</code></br>
  30971. <em>
  30972. int
  30973. </em>
  30974. </td>
  30975. <td>
  30976. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  30977. For RSA keys: 2048, 3072, 4096
  30978. For ECDSA keys: 256, 384, 521
  30979. Ignored for ed25519 keys</p>
  30980. </td>
  30981. </tr>
  30982. <tr>
  30983. <td>
  30984. <code>comment</code></br>
  30985. <em>
  30986. string
  30987. </em>
  30988. </td>
  30989. <td>
  30990. <p>Comment specifies an optional comment for the SSH key</p>
  30991. </td>
  30992. </tr>
  30993. </table>
  30994. </td>
  30995. </tr>
  30996. </tbody>
  30997. </table>
  30998. <h3 id="generators.external-secrets.io/v1alpha1.SSHKeySpec">SSHKeySpec
  30999. </h3>
  31000. <p>
  31001. (<em>Appears on:</em>
  31002. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31003. <a href="#generators.external-secrets.io/v1alpha1.SSHKey">SSHKey</a>)
  31004. </p>
  31005. <p>
  31006. <p>SSHKeySpec controls the behavior of the ssh key generator.</p>
  31007. </p>
  31008. <table>
  31009. <thead>
  31010. <tr>
  31011. <th>Field</th>
  31012. <th>Description</th>
  31013. </tr>
  31014. </thead>
  31015. <tbody>
  31016. <tr>
  31017. <td>
  31018. <code>keyType</code></br>
  31019. <em>
  31020. string
  31021. </em>
  31022. </td>
  31023. <td>
  31024. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  31025. </td>
  31026. </tr>
  31027. <tr>
  31028. <td>
  31029. <code>keySize</code></br>
  31030. <em>
  31031. int
  31032. </em>
  31033. </td>
  31034. <td>
  31035. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  31036. For RSA keys: 2048, 3072, 4096
  31037. For ECDSA keys: 256, 384, 521
  31038. Ignored for ed25519 keys</p>
  31039. </td>
  31040. </tr>
  31041. <tr>
  31042. <td>
  31043. <code>comment</code></br>
  31044. <em>
  31045. string
  31046. </em>
  31047. </td>
  31048. <td>
  31049. <p>Comment specifies an optional comment for the SSH key</p>
  31050. </td>
  31051. </tr>
  31052. </tbody>
  31053. </table>
  31054. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken
  31055. </h3>
  31056. <p>
  31057. <p>STSSessionToken uses the GetSessionToken API to retrieve an authorization token.
  31058. The authorization token is valid for 12 hours.
  31059. The authorizationToken returned is a base64 encoded string that can be decoded.
  31060. For more information, see GetSessionToken (<a href="https://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html">https://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html</a>).</p>
  31061. </p>
  31062. <table>
  31063. <thead>
  31064. <tr>
  31065. <th>Field</th>
  31066. <th>Description</th>
  31067. </tr>
  31068. </thead>
  31069. <tbody>
  31070. <tr>
  31071. <td>
  31072. <code>metadata</code></br>
  31073. <em>
  31074. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31075. Kubernetes meta/v1.ObjectMeta
  31076. </a>
  31077. </em>
  31078. </td>
  31079. <td>
  31080. Refer to the Kubernetes API documentation for the fields of the
  31081. <code>metadata</code> field.
  31082. </td>
  31083. </tr>
  31084. <tr>
  31085. <td>
  31086. <code>spec</code></br>
  31087. <em>
  31088. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  31089. STSSessionTokenSpec
  31090. </a>
  31091. </em>
  31092. </td>
  31093. <td>
  31094. <br/>
  31095. <br/>
  31096. <table>
  31097. <tr>
  31098. <td>
  31099. <code>region</code></br>
  31100. <em>
  31101. string
  31102. </em>
  31103. </td>
  31104. <td>
  31105. <p>Region specifies the region to operate in.</p>
  31106. </td>
  31107. </tr>
  31108. <tr>
  31109. <td>
  31110. <code>auth</code></br>
  31111. <em>
  31112. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  31113. AWSAuth
  31114. </a>
  31115. </em>
  31116. </td>
  31117. <td>
  31118. <em>(Optional)</em>
  31119. <p>Auth defines how to authenticate with AWS</p>
  31120. </td>
  31121. </tr>
  31122. <tr>
  31123. <td>
  31124. <code>role</code></br>
  31125. <em>
  31126. string
  31127. </em>
  31128. </td>
  31129. <td>
  31130. <em>(Optional)</em>
  31131. <p>You can assume a role before making calls to the
  31132. desired AWS service.</p>
  31133. </td>
  31134. </tr>
  31135. <tr>
  31136. <td>
  31137. <code>requestParameters</code></br>
  31138. <em>
  31139. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  31140. RequestParameters
  31141. </a>
  31142. </em>
  31143. </td>
  31144. <td>
  31145. <em>(Optional)</em>
  31146. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  31147. </td>
  31148. </tr>
  31149. </table>
  31150. </td>
  31151. </tr>
  31152. </tbody>
  31153. </table>
  31154. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec
  31155. </h3>
  31156. <p>
  31157. (<em>Appears on:</em>
  31158. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31159. <a href="#generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken</a>)
  31160. </p>
  31161. <p>
  31162. <p>STSSessionTokenSpec defines the desired state to generate an AWS STS session token.</p>
  31163. </p>
  31164. <table>
  31165. <thead>
  31166. <tr>
  31167. <th>Field</th>
  31168. <th>Description</th>
  31169. </tr>
  31170. </thead>
  31171. <tbody>
  31172. <tr>
  31173. <td>
  31174. <code>region</code></br>
  31175. <em>
  31176. string
  31177. </em>
  31178. </td>
  31179. <td>
  31180. <p>Region specifies the region to operate in.</p>
  31181. </td>
  31182. </tr>
  31183. <tr>
  31184. <td>
  31185. <code>auth</code></br>
  31186. <em>
  31187. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  31188. AWSAuth
  31189. </a>
  31190. </em>
  31191. </td>
  31192. <td>
  31193. <em>(Optional)</em>
  31194. <p>Auth defines how to authenticate with AWS</p>
  31195. </td>
  31196. </tr>
  31197. <tr>
  31198. <td>
  31199. <code>role</code></br>
  31200. <em>
  31201. string
  31202. </em>
  31203. </td>
  31204. <td>
  31205. <em>(Optional)</em>
  31206. <p>You can assume a role before making calls to the
  31207. desired AWS service.</p>
  31208. </td>
  31209. </tr>
  31210. <tr>
  31211. <td>
  31212. <code>requestParameters</code></br>
  31213. <em>
  31214. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  31215. RequestParameters
  31216. </a>
  31217. </em>
  31218. </td>
  31219. <td>
  31220. <em>(Optional)</em>
  31221. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  31222. </td>
  31223. </tr>
  31224. </tbody>
  31225. </table>
  31226. <h3 id="generators.external-secrets.io/v1alpha1.SecretKeySelector">SecretKeySelector
  31227. </h3>
  31228. <p>
  31229. (<em>Appears on:</em>
  31230. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>,
  31231. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth</a>,
  31232. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret</a>)
  31233. </p>
  31234. <p>
  31235. <p>SecretKeySelector defines a reference to a specific key within a Kubernetes Secret.</p>
  31236. </p>
  31237. <table>
  31238. <thead>
  31239. <tr>
  31240. <th>Field</th>
  31241. <th>Description</th>
  31242. </tr>
  31243. </thead>
  31244. <tbody>
  31245. <tr>
  31246. <td>
  31247. <code>name</code></br>
  31248. <em>
  31249. string
  31250. </em>
  31251. </td>
  31252. <td>
  31253. <p>The name of the Secret resource being referred to.</p>
  31254. </td>
  31255. </tr>
  31256. <tr>
  31257. <td>
  31258. <code>key</code></br>
  31259. <em>
  31260. string
  31261. </em>
  31262. </td>
  31263. <td>
  31264. <p>The key where the token is found.</p>
  31265. </td>
  31266. </tr>
  31267. </tbody>
  31268. </table>
  31269. <h3 id="generators.external-secrets.io/v1alpha1.StatefulResource">StatefulResource
  31270. </h3>
  31271. <p>
  31272. <p>StatefulResource represents a Kubernetes resource that has state which can be tracked.</p>
  31273. </p>
  31274. <h3 id="generators.external-secrets.io/v1alpha1.UUID">UUID
  31275. </h3>
  31276. <p>
  31277. <p>UUID generates a version 1 UUID (e56657e3-764f-11ef-a397-65231a88c216).</p>
  31278. </p>
  31279. <table>
  31280. <thead>
  31281. <tr>
  31282. <th>Field</th>
  31283. <th>Description</th>
  31284. </tr>
  31285. </thead>
  31286. <tbody>
  31287. <tr>
  31288. <td>
  31289. <code>metadata</code></br>
  31290. <em>
  31291. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31292. Kubernetes meta/v1.ObjectMeta
  31293. </a>
  31294. </em>
  31295. </td>
  31296. <td>
  31297. Refer to the Kubernetes API documentation for the fields of the
  31298. <code>metadata</code> field.
  31299. </td>
  31300. </tr>
  31301. <tr>
  31302. <td>
  31303. <code>spec</code></br>
  31304. <em>
  31305. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  31306. UUIDSpec
  31307. </a>
  31308. </em>
  31309. </td>
  31310. <td>
  31311. <br/>
  31312. <br/>
  31313. <table>
  31314. </table>
  31315. </td>
  31316. </tr>
  31317. </tbody>
  31318. </table>
  31319. <h3 id="generators.external-secrets.io/v1alpha1.UUIDSpec">UUIDSpec
  31320. </h3>
  31321. <p>
  31322. (<em>Appears on:</em>
  31323. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31324. <a href="#generators.external-secrets.io/v1alpha1.UUID">UUID</a>)
  31325. </p>
  31326. <p>
  31327. <p>UUIDSpec controls the behavior of the uuid generator.</p>
  31328. </p>
  31329. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret
  31330. </h3>
  31331. <p>
  31332. <p>VaultDynamicSecret represents a generator that can create dynamic secrets from HashiCorp Vault.</p>
  31333. </p>
  31334. <table>
  31335. <thead>
  31336. <tr>
  31337. <th>Field</th>
  31338. <th>Description</th>
  31339. </tr>
  31340. </thead>
  31341. <tbody>
  31342. <tr>
  31343. <td>
  31344. <code>metadata</code></br>
  31345. <em>
  31346. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31347. Kubernetes meta/v1.ObjectMeta
  31348. </a>
  31349. </em>
  31350. </td>
  31351. <td>
  31352. Refer to the Kubernetes API documentation for the fields of the
  31353. <code>metadata</code> field.
  31354. </td>
  31355. </tr>
  31356. <tr>
  31357. <td>
  31358. <code>spec</code></br>
  31359. <em>
  31360. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  31361. VaultDynamicSecretSpec
  31362. </a>
  31363. </em>
  31364. </td>
  31365. <td>
  31366. <br/>
  31367. <br/>
  31368. <table>
  31369. <tr>
  31370. <td>
  31371. <code>controller</code></br>
  31372. <em>
  31373. string
  31374. </em>
  31375. </td>
  31376. <td>
  31377. <em>(Optional)</em>
  31378. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  31379. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  31380. </td>
  31381. </tr>
  31382. <tr>
  31383. <td>
  31384. <code>method</code></br>
  31385. <em>
  31386. string
  31387. </em>
  31388. </td>
  31389. <td>
  31390. <p>Vault API method to use (GET/POST/other)</p>
  31391. </td>
  31392. </tr>
  31393. <tr>
  31394. <td>
  31395. <code>parameters</code></br>
  31396. <em>
  31397. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  31398. </em>
  31399. </td>
  31400. <td>
  31401. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  31402. </td>
  31403. </tr>
  31404. <tr>
  31405. <td>
  31406. <code>getParameters</code></br>
  31407. <em>
  31408. map[string][]string
  31409. </em>
  31410. </td>
  31411. <td>
  31412. <em>(Optional)</em>
  31413. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  31414. Each key may map to multiple values, matching HTTP query-string semantics.
  31415. Ignored for non-GET methods; use Parameters for write bodies.</p>
  31416. </td>
  31417. </tr>
  31418. <tr>
  31419. <td>
  31420. <code>resultType</code></br>
  31421. <em>
  31422. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  31423. VaultDynamicSecretResultType
  31424. </a>
  31425. </em>
  31426. </td>
  31427. <td>
  31428. <p>Result type defines which data is returned from the generator.
  31429. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  31430. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  31431. the &ldquo;auth&rdquo; section contains the generated token.
  31432. Please refer to the vault docs regarding the result data structure.
  31433. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  31434. </td>
  31435. </tr>
  31436. <tr>
  31437. <td>
  31438. <code>retrySettings</code></br>
  31439. <em>
  31440. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  31441. SecretStoreRetrySettings
  31442. </a>
  31443. </em>
  31444. </td>
  31445. <td>
  31446. <em>(Optional)</em>
  31447. <p>Used to configure http retries if failed</p>
  31448. </td>
  31449. </tr>
  31450. <tr>
  31451. <td>
  31452. <code>provider</code></br>
  31453. <em>
  31454. <a href="#external-secrets.io/v1.VaultProvider">
  31455. VaultProvider
  31456. </a>
  31457. </em>
  31458. </td>
  31459. <td>
  31460. <p>Vault provider common spec</p>
  31461. </td>
  31462. </tr>
  31463. <tr>
  31464. <td>
  31465. <code>path</code></br>
  31466. <em>
  31467. string
  31468. </em>
  31469. </td>
  31470. <td>
  31471. <p>Vault path to obtain the dynamic secret from</p>
  31472. </td>
  31473. </tr>
  31474. <tr>
  31475. <td>
  31476. <code>allowEmptyResponse</code></br>
  31477. <em>
  31478. bool
  31479. </em>
  31480. </td>
  31481. <td>
  31482. <em>(Optional)</em>
  31483. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  31484. </td>
  31485. </tr>
  31486. </table>
  31487. </td>
  31488. </tr>
  31489. </tbody>
  31490. </table>
  31491. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">VaultDynamicSecretResultType
  31492. (<code>string</code> alias)</p></h3>
  31493. <p>
  31494. (<em>Appears on:</em>
  31495. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  31496. </p>
  31497. <p>
  31498. <p>VaultDynamicSecretResultType defines which part of the Vault API response should be returned.</p>
  31499. </p>
  31500. <table>
  31501. <thead>
  31502. <tr>
  31503. <th>Value</th>
  31504. <th>Description</th>
  31505. </tr>
  31506. </thead>
  31507. <tbody><tr><td><p>&#34;Auth&#34;</p></td>
  31508. <td><p>VaultDynamicSecretResultTypeAuth specifies to return the &ldquo;auth&rdquo; section of the Vault API response.</p>
  31509. </td>
  31510. </tr><tr><td><p>&#34;Data&#34;</p></td>
  31511. <td><p>VaultDynamicSecretResultTypeData specifies to return the &ldquo;data&rdquo; section of the Vault API response.</p>
  31512. </td>
  31513. </tr><tr><td><p>&#34;Raw&#34;</p></td>
  31514. <td><p>VaultDynamicSecretResultTypeRaw specifies to return the raw response from the Vault API.</p>
  31515. </td>
  31516. </tr></tbody>
  31517. </table>
  31518. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec
  31519. </h3>
  31520. <p>
  31521. (<em>Appears on:</em>
  31522. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31523. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret</a>)
  31524. </p>
  31525. <p>
  31526. <p>VaultDynamicSecretSpec defines the desired spec of VaultDynamicSecret.</p>
  31527. </p>
  31528. <table>
  31529. <thead>
  31530. <tr>
  31531. <th>Field</th>
  31532. <th>Description</th>
  31533. </tr>
  31534. </thead>
  31535. <tbody>
  31536. <tr>
  31537. <td>
  31538. <code>controller</code></br>
  31539. <em>
  31540. string
  31541. </em>
  31542. </td>
  31543. <td>
  31544. <em>(Optional)</em>
  31545. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  31546. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  31547. </td>
  31548. </tr>
  31549. <tr>
  31550. <td>
  31551. <code>method</code></br>
  31552. <em>
  31553. string
  31554. </em>
  31555. </td>
  31556. <td>
  31557. <p>Vault API method to use (GET/POST/other)</p>
  31558. </td>
  31559. </tr>
  31560. <tr>
  31561. <td>
  31562. <code>parameters</code></br>
  31563. <em>
  31564. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  31565. </em>
  31566. </td>
  31567. <td>
  31568. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  31569. </td>
  31570. </tr>
  31571. <tr>
  31572. <td>
  31573. <code>getParameters</code></br>
  31574. <em>
  31575. map[string][]string
  31576. </em>
  31577. </td>
  31578. <td>
  31579. <em>(Optional)</em>
  31580. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  31581. Each key may map to multiple values, matching HTTP query-string semantics.
  31582. Ignored for non-GET methods; use Parameters for write bodies.</p>
  31583. </td>
  31584. </tr>
  31585. <tr>
  31586. <td>
  31587. <code>resultType</code></br>
  31588. <em>
  31589. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  31590. VaultDynamicSecretResultType
  31591. </a>
  31592. </em>
  31593. </td>
  31594. <td>
  31595. <p>Result type defines which data is returned from the generator.
  31596. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  31597. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  31598. the &ldquo;auth&rdquo; section contains the generated token.
  31599. Please refer to the vault docs regarding the result data structure.
  31600. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  31601. </td>
  31602. </tr>
  31603. <tr>
  31604. <td>
  31605. <code>retrySettings</code></br>
  31606. <em>
  31607. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  31608. SecretStoreRetrySettings
  31609. </a>
  31610. </em>
  31611. </td>
  31612. <td>
  31613. <em>(Optional)</em>
  31614. <p>Used to configure http retries if failed</p>
  31615. </td>
  31616. </tr>
  31617. <tr>
  31618. <td>
  31619. <code>provider</code></br>
  31620. <em>
  31621. <a href="#external-secrets.io/v1.VaultProvider">
  31622. VaultProvider
  31623. </a>
  31624. </em>
  31625. </td>
  31626. <td>
  31627. <p>Vault provider common spec</p>
  31628. </td>
  31629. </tr>
  31630. <tr>
  31631. <td>
  31632. <code>path</code></br>
  31633. <em>
  31634. string
  31635. </em>
  31636. </td>
  31637. <td>
  31638. <p>Vault path to obtain the dynamic secret from</p>
  31639. </td>
  31640. </tr>
  31641. <tr>
  31642. <td>
  31643. <code>allowEmptyResponse</code></br>
  31644. <em>
  31645. bool
  31646. </em>
  31647. </td>
  31648. <td>
  31649. <em>(Optional)</em>
  31650. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  31651. </td>
  31652. </tr>
  31653. </tbody>
  31654. </table>
  31655. <h3 id="generators.external-secrets.io/v1alpha1.Webhook">Webhook
  31656. </h3>
  31657. <p>
  31658. <p>Webhook connects to a third party API server to handle the secrets generation
  31659. configuration parameters in spec.
  31660. You can specify the server, the token, and additional body parameters.
  31661. See documentation for the full API specification for requests and responses.</p>
  31662. </p>
  31663. <table>
  31664. <thead>
  31665. <tr>
  31666. <th>Field</th>
  31667. <th>Description</th>
  31668. </tr>
  31669. </thead>
  31670. <tbody>
  31671. <tr>
  31672. <td>
  31673. <code>metadata</code></br>
  31674. <em>
  31675. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31676. Kubernetes meta/v1.ObjectMeta
  31677. </a>
  31678. </em>
  31679. </td>
  31680. <td>
  31681. Refer to the Kubernetes API documentation for the fields of the
  31682. <code>metadata</code> field.
  31683. </td>
  31684. </tr>
  31685. <tr>
  31686. <td>
  31687. <code>spec</code></br>
  31688. <em>
  31689. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  31690. WebhookSpec
  31691. </a>
  31692. </em>
  31693. </td>
  31694. <td>
  31695. <br/>
  31696. <br/>
  31697. <table>
  31698. <tr>
  31699. <td>
  31700. <code>method</code></br>
  31701. <em>
  31702. string
  31703. </em>
  31704. </td>
  31705. <td>
  31706. <p>Webhook Method</p>
  31707. </td>
  31708. </tr>
  31709. <tr>
  31710. <td>
  31711. <code>url</code></br>
  31712. <em>
  31713. string
  31714. </em>
  31715. </td>
  31716. <td>
  31717. <p>Webhook url to call</p>
  31718. </td>
  31719. </tr>
  31720. <tr>
  31721. <td>
  31722. <code>headers</code></br>
  31723. <em>
  31724. map[string]string
  31725. </em>
  31726. </td>
  31727. <td>
  31728. <em>(Optional)</em>
  31729. <p>Headers</p>
  31730. </td>
  31731. </tr>
  31732. <tr>
  31733. <td>
  31734. <code>auth</code></br>
  31735. <em>
  31736. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  31737. AuthorizationProtocol
  31738. </a>
  31739. </em>
  31740. </td>
  31741. <td>
  31742. <em>(Optional)</em>
  31743. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  31744. </td>
  31745. </tr>
  31746. <tr>
  31747. <td>
  31748. <code>body</code></br>
  31749. <em>
  31750. string
  31751. </em>
  31752. </td>
  31753. <td>
  31754. <em>(Optional)</em>
  31755. <p>Body</p>
  31756. </td>
  31757. </tr>
  31758. <tr>
  31759. <td>
  31760. <code>timeout</code></br>
  31761. <em>
  31762. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  31763. Kubernetes meta/v1.Duration
  31764. </a>
  31765. </em>
  31766. </td>
  31767. <td>
  31768. <em>(Optional)</em>
  31769. <p>Timeout</p>
  31770. </td>
  31771. </tr>
  31772. <tr>
  31773. <td>
  31774. <code>result</code></br>
  31775. <em>
  31776. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  31777. WebhookResult
  31778. </a>
  31779. </em>
  31780. </td>
  31781. <td>
  31782. <p>Result formatting</p>
  31783. </td>
  31784. </tr>
  31785. <tr>
  31786. <td>
  31787. <code>secrets</code></br>
  31788. <em>
  31789. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  31790. []WebhookSecret
  31791. </a>
  31792. </em>
  31793. </td>
  31794. <td>
  31795. <em>(Optional)</em>
  31796. <p>Secrets to fill in templates
  31797. These secrets will be passed to the templating function as key value pairs under the given name</p>
  31798. </td>
  31799. </tr>
  31800. <tr>
  31801. <td>
  31802. <code>caBundle</code></br>
  31803. <em>
  31804. []byte
  31805. </em>
  31806. </td>
  31807. <td>
  31808. <em>(Optional)</em>
  31809. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  31810. if the Server URL is using HTTPS protocol. This parameter is ignored for
  31811. plain HTTP protocol connection. If not set the system root certificates
  31812. are used to validate the TLS connection.</p>
  31813. </td>
  31814. </tr>
  31815. <tr>
  31816. <td>
  31817. <code>caProvider</code></br>
  31818. <em>
  31819. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  31820. WebhookCAProvider
  31821. </a>
  31822. </em>
  31823. </td>
  31824. <td>
  31825. <em>(Optional)</em>
  31826. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  31827. </td>
  31828. </tr>
  31829. </table>
  31830. </td>
  31831. </tr>
  31832. </tbody>
  31833. </table>
  31834. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider
  31835. </h3>
  31836. <p>
  31837. (<em>Appears on:</em>
  31838. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  31839. </p>
  31840. <p>
  31841. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  31842. </p>
  31843. <table>
  31844. <thead>
  31845. <tr>
  31846. <th>Field</th>
  31847. <th>Description</th>
  31848. </tr>
  31849. </thead>
  31850. <tbody>
  31851. <tr>
  31852. <td>
  31853. <code>type</code></br>
  31854. <em>
  31855. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProviderType">
  31856. WebhookCAProviderType
  31857. </a>
  31858. </em>
  31859. </td>
  31860. <td>
  31861. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  31862. </td>
  31863. </tr>
  31864. <tr>
  31865. <td>
  31866. <code>name</code></br>
  31867. <em>
  31868. string
  31869. </em>
  31870. </td>
  31871. <td>
  31872. <p>The name of the object located at the provider type.</p>
  31873. </td>
  31874. </tr>
  31875. <tr>
  31876. <td>
  31877. <code>key</code></br>
  31878. <em>
  31879. string
  31880. </em>
  31881. </td>
  31882. <td>
  31883. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  31884. </td>
  31885. </tr>
  31886. <tr>
  31887. <td>
  31888. <code>namespace</code></br>
  31889. <em>
  31890. string
  31891. </em>
  31892. </td>
  31893. <td>
  31894. <em>(Optional)</em>
  31895. <p>The namespace the Provider type is in.</p>
  31896. </td>
  31897. </tr>
  31898. </tbody>
  31899. </table>
  31900. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProviderType">WebhookCAProviderType
  31901. (<code>string</code> alias)</p></h3>
  31902. <p>
  31903. (<em>Appears on:</em>
  31904. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider</a>)
  31905. </p>
  31906. <p>
  31907. <p>WebhookCAProviderType defines the type of provider for webhook CA certificates.</p>
  31908. </p>
  31909. <table>
  31910. <thead>
  31911. <tr>
  31912. <th>Value</th>
  31913. <th>Description</th>
  31914. </tr>
  31915. </thead>
  31916. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  31917. <td><p>WebhookCAProviderTypeConfigMap indicates the CA provider is a ConfigMap resource.</p>
  31918. </td>
  31919. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  31920. <td><p>WebhookCAProviderTypeSecret indicates the CA provider is a Secret resource.</p>
  31921. </td>
  31922. </tr></tbody>
  31923. </table>
  31924. <h3 id="generators.external-secrets.io/v1alpha1.WebhookResult">WebhookResult
  31925. </h3>
  31926. <p>
  31927. (<em>Appears on:</em>
  31928. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  31929. </p>
  31930. <p>
  31931. <p>WebhookResult defines how to format and extract results from the webhook response.</p>
  31932. </p>
  31933. <table>
  31934. <thead>
  31935. <tr>
  31936. <th>Field</th>
  31937. <th>Description</th>
  31938. </tr>
  31939. </thead>
  31940. <tbody>
  31941. <tr>
  31942. <td>
  31943. <code>jsonPath</code></br>
  31944. <em>
  31945. string
  31946. </em>
  31947. </td>
  31948. <td>
  31949. <em>(Optional)</em>
  31950. <p>Json path of return value</p>
  31951. </td>
  31952. </tr>
  31953. </tbody>
  31954. </table>
  31955. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret
  31956. </h3>
  31957. <p>
  31958. (<em>Appears on:</em>
  31959. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  31960. </p>
  31961. <p>
  31962. <p>WebhookSecret defines a secret reference that will be used in webhook templates.</p>
  31963. </p>
  31964. <table>
  31965. <thead>
  31966. <tr>
  31967. <th>Field</th>
  31968. <th>Description</th>
  31969. </tr>
  31970. </thead>
  31971. <tbody>
  31972. <tr>
  31973. <td>
  31974. <code>name</code></br>
  31975. <em>
  31976. string
  31977. </em>
  31978. </td>
  31979. <td>
  31980. <p>Name of this secret in templates</p>
  31981. </td>
  31982. </tr>
  31983. <tr>
  31984. <td>
  31985. <code>secretRef</code></br>
  31986. <em>
  31987. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  31988. SecretKeySelector
  31989. </a>
  31990. </em>
  31991. </td>
  31992. <td>
  31993. <p>Secret ref to fill in credentials</p>
  31994. </td>
  31995. </tr>
  31996. </tbody>
  31997. </table>
  31998. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec
  31999. </h3>
  32000. <p>
  32001. (<em>Appears on:</em>
  32002. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  32003. <a href="#generators.external-secrets.io/v1alpha1.Webhook">Webhook</a>)
  32004. </p>
  32005. <p>
  32006. <p>WebhookSpec controls the behavior of the external generator. Any body parameters should be passed to the server through the parameters field.</p>
  32007. </p>
  32008. <table>
  32009. <thead>
  32010. <tr>
  32011. <th>Field</th>
  32012. <th>Description</th>
  32013. </tr>
  32014. </thead>
  32015. <tbody>
  32016. <tr>
  32017. <td>
  32018. <code>method</code></br>
  32019. <em>
  32020. string
  32021. </em>
  32022. </td>
  32023. <td>
  32024. <p>Webhook Method</p>
  32025. </td>
  32026. </tr>
  32027. <tr>
  32028. <td>
  32029. <code>url</code></br>
  32030. <em>
  32031. string
  32032. </em>
  32033. </td>
  32034. <td>
  32035. <p>Webhook url to call</p>
  32036. </td>
  32037. </tr>
  32038. <tr>
  32039. <td>
  32040. <code>headers</code></br>
  32041. <em>
  32042. map[string]string
  32043. </em>
  32044. </td>
  32045. <td>
  32046. <em>(Optional)</em>
  32047. <p>Headers</p>
  32048. </td>
  32049. </tr>
  32050. <tr>
  32051. <td>
  32052. <code>auth</code></br>
  32053. <em>
  32054. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  32055. AuthorizationProtocol
  32056. </a>
  32057. </em>
  32058. </td>
  32059. <td>
  32060. <em>(Optional)</em>
  32061. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  32062. </td>
  32063. </tr>
  32064. <tr>
  32065. <td>
  32066. <code>body</code></br>
  32067. <em>
  32068. string
  32069. </em>
  32070. </td>
  32071. <td>
  32072. <em>(Optional)</em>
  32073. <p>Body</p>
  32074. </td>
  32075. </tr>
  32076. <tr>
  32077. <td>
  32078. <code>timeout</code></br>
  32079. <em>
  32080. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  32081. Kubernetes meta/v1.Duration
  32082. </a>
  32083. </em>
  32084. </td>
  32085. <td>
  32086. <em>(Optional)</em>
  32087. <p>Timeout</p>
  32088. </td>
  32089. </tr>
  32090. <tr>
  32091. <td>
  32092. <code>result</code></br>
  32093. <em>
  32094. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  32095. WebhookResult
  32096. </a>
  32097. </em>
  32098. </td>
  32099. <td>
  32100. <p>Result formatting</p>
  32101. </td>
  32102. </tr>
  32103. <tr>
  32104. <td>
  32105. <code>secrets</code></br>
  32106. <em>
  32107. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  32108. []WebhookSecret
  32109. </a>
  32110. </em>
  32111. </td>
  32112. <td>
  32113. <em>(Optional)</em>
  32114. <p>Secrets to fill in templates
  32115. These secrets will be passed to the templating function as key value pairs under the given name</p>
  32116. </td>
  32117. </tr>
  32118. <tr>
  32119. <td>
  32120. <code>caBundle</code></br>
  32121. <em>
  32122. []byte
  32123. </em>
  32124. </td>
  32125. <td>
  32126. <em>(Optional)</em>
  32127. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  32128. if the Server URL is using HTTPS protocol. This parameter is ignored for
  32129. plain HTTP protocol connection. If not set the system root certificates
  32130. are used to validate the TLS connection.</p>
  32131. </td>
  32132. </tr>
  32133. <tr>
  32134. <td>
  32135. <code>caProvider</code></br>
  32136. <em>
  32137. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  32138. WebhookCAProvider
  32139. </a>
  32140. </em>
  32141. </td>
  32142. <td>
  32143. <em>(Optional)</em>
  32144. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  32145. </td>
  32146. </tr>
  32147. </tbody>
  32148. </table>
  32149. <hr/>
  32150. <p><em>
  32151. Generated with <code>gen-crd-api-reference-docs</code>.
  32152. </em></p>
  32153. </article>
  32154. </div>
  32155. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  32156. </div>
  32157. </main>
  32158. <img referrerpolicy="no-referrer-when-downgrade"
  32159. src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""
  32160. hidden />
  32161. <footer class="md-footer">
  32162. <div class="md-footer-meta md-typeset">
  32163. <div class="md-footer-meta__inner md-grid">
  32164. <div class="md-copyright">
  32165. <div class="md-copyright__highlight">
  32166. &copy; 2025 The external-secrets Authors.<br/>
  32167. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  32168. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  32169. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  32170. </div>
  32171. Made with
  32172. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  32173. Material for MkDocs
  32174. </a>
  32175. </div>
  32176. </div>
  32177. </div>
  32178. </footer>
  32179. </div>
  32180. <div class="md-dialog" data-md-component="dialog">
  32181. <div class="md-dialog__inner md-typeset"></div>
  32182. </div>
  32183. <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.indexes", "navigation.expand"], "search": "../../assets/javascripts/workers/search.2c215733.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>
  32184. <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
  32185. </body>
  32186. </html>