index.html 677 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511185121851318514185151851618517185181851918520185211852218523185241852518526185271852818529185301853118532185331853418535185361853718538185391854018541185421854318544185451854618547185481854918550185511855218553185541855518556185571855818559185601856118562185631856418565185661856718568185691857018571185721857318574185751857618577185781857918580185811858218583185841858518586185871858818589185901859118592185931859418595185961859718598185991860018601186021860318604186051860618607186081860918610186111861218613186141861518616186171861818619186201862118622186231862418625186261862718628186291863018631186321863318634186351863618637186381863918640186411864218643186441864518646186471864818649186501865118652186531865418655186561865718658186591866018661186621866318664186651866618667186681866918670186711867218673186741867518676186771867818679186801868118682186831868418685186861868718688186891869018691186921869318694186951869618697186981869918700187011870218703187041870518706187071870818709187101871118712187131871418715187161871718718187191872018721187221872318724187251872618727187281872918730187311873218733187341873518736187371873818739187401874118742187431874418745187461874718748187491875018751187521875318754187551875618757187581875918760187611876218763187641876518766187671876818769187701877118772187731877418775187761877718778187791878018781187821878318784187851878618787187881878918790187911879218793187941879518796187971879818799188001880118802188031880418805188061880718808188091881018811188121881318814188151881618817188181881918820188211882218823188241882518826188271882818829188301883118832188331883418835188361883718838188391884018841188421884318844188451884618847188481884918850188511885218853188541885518856188571885818859188601886118862188631886418865188661886718868188691887018871188721887318874188751887618877188781887918880188811888218883188841888518886188871888818889188901889118892188931889418895188961889718898188991890018901189021890318904189051890618907189081890918910189111891218913189141891518916189171891818919189201892118922189231892418925189261892718928189291893018931189321893318934189351893618937189381893918940189411894218943189441894518946189471894818949189501895118952189531895418955189561895718958189591896018961189621896318964189651896618967189681896918970189711897218973189741897518976189771897818979189801898118982189831898418985189861898718988189891899018991189921899318994189951899618997189981899919000190011900219003190041900519006190071900819009190101901119012190131901419015190161901719018190191902019021190221902319024190251902619027190281902919030190311903219033190341903519036190371903819039190401904119042190431904419045190461904719048190491905019051190521905319054190551905619057190581905919060190611906219063190641906519066190671906819069190701907119072190731907419075190761907719078190791908019081190821908319084190851908619087190881908919090190911909219093190941909519096190971909819099191001910119102191031910419105191061910719108191091911019111191121911319114191151911619117191181911919120191211912219123191241912519126191271912819129191301913119132191331913419135191361913719138191391914019141191421914319144191451914619147191481914919150191511915219153191541915519156191571915819159191601916119162191631916419165191661916719168191691917019171191721917319174191751917619177191781917919180191811918219183191841918519186191871918819189191901919119192191931919419195191961919719198191991920019201192021920319204192051920619207192081920919210192111921219213192141921519216192171921819219192201922119222192231922419225192261922719228192291923019231192321923319234192351923619237192381923919240192411924219243192441924519246192471924819249192501925119252192531925419255192561925719258192591926019261192621926319264192651926619267192681926919270192711927219273192741927519276192771927819279192801928119282192831928419285192861928719288192891929019291192921929319294192951929619297192981929919300193011930219303193041930519306193071930819309193101931119312193131931419315193161931719318193191932019321193221932319324193251932619327193281932919330193311933219333193341933519336193371933819339193401934119342193431934419345193461934719348193491935019351193521935319354193551935619357193581935919360193611936219363193641936519366193671936819369193701937119372193731937419375193761937719378193791938019381193821938319384193851938619387193881938919390193911939219393193941939519396193971939819399194001940119402194031940419405194061940719408194091941019411194121941319414194151941619417194181941919420194211942219423194241942519426194271942819429194301943119432194331943419435194361943719438194391944019441194421944319444194451944619447194481944919450194511945219453194541945519456194571945819459194601946119462194631946419465194661946719468194691947019471194721947319474194751947619477194781947919480194811948219483194841948519486194871948819489194901949119492194931949419495194961949719498194991950019501195021950319504195051950619507195081950919510195111951219513195141951519516195171951819519195201952119522195231952419525195261952719528195291953019531195321953319534195351953619537195381953919540195411954219543195441954519546195471954819549195501955119552195531955419555195561955719558195591956019561195621956319564195651956619567195681956919570195711957219573195741957519576195771957819579195801958119582195831958419585195861958719588195891959019591195921959319594195951959619597195981959919600196011960219603196041960519606196071960819609196101961119612196131961419615196161961719618196191962019621196221962319624196251962619627196281962919630196311963219633196341963519636196371963819639196401964119642196431964419645196461964719648196491965019651196521965319654196551965619657196581965919660196611966219663196641966519666196671966819669196701967119672196731967419675196761967719678196791968019681196821968319684196851968619687196881968919690196911969219693196941969519696196971969819699197001970119702197031970419705197061970719708197091971019711197121971319714197151971619717197181971919720197211972219723197241972519726197271972819729197301973119732197331973419735197361973719738197391974019741197421974319744197451974619747197481974919750197511975219753197541975519756197571975819759197601976119762197631976419765197661976719768197691977019771197721977319774197751977619777197781977919780197811978219783197841978519786197871978819789197901979119792197931979419795197961979719798197991980019801198021980319804198051980619807198081980919810198111981219813198141981519816198171981819819198201982119822198231982419825198261982719828198291983019831198321983319834198351983619837198381983919840198411984219843198441984519846198471984819849198501985119852198531985419855198561985719858198591986019861198621986319864198651986619867198681986919870198711987219873198741987519876198771987819879198801988119882198831988419885198861988719888198891989019891198921989319894198951989619897198981989919900199011990219903199041990519906199071990819909199101991119912199131991419915199161991719918199191992019921199221992319924199251992619927199281992919930199311993219933199341993519936199371993819939199401994119942199431994419945199461994719948199491995019951199521995319954199551995619957199581995919960199611996219963199641996519966199671996819969199701997119972199731997419975199761997719978199791998019981199821998319984199851998619987199881998919990199911999219993199941999519996199971999819999200002000120002200032000420005200062000720008200092001020011200122001320014200152001620017200182001920020200212002220023200242002520026200272002820029200302003120032200332003420035200362003720038200392004020041200422004320044200452004620047200482004920050200512005220053200542005520056200572005820059200602006120062200632006420065200662006720068200692007020071200722007320074200752007620077200782007920080200812008220083200842008520086200872008820089200902009120092200932009420095200962009720098200992010020101201022010320104201052010620107201082010920110201112011220113201142011520116201172011820119201202012120122201232012420125201262012720128201292013020131201322013320134201352013620137201382013920140201412014220143201442014520146201472014820149201502015120152201532015420155201562015720158201592016020161201622016320164201652016620167201682016920170201712017220173201742017520176201772017820179201802018120182201832018420185201862018720188201892019020191201922019320194201952019620197201982019920200202012020220203202042020520206202072020820209202102021120212202132021420215202162021720218202192022020221202222022320224202252022620227202282022920230202312023220233202342023520236202372023820239202402024120242202432024420245202462024720248202492025020251202522025320254202552025620257202582025920260202612026220263202642026520266202672026820269202702027120272202732027420275202762027720278202792028020281202822028320284202852028620287202882028920290202912029220293202942029520296202972029820299203002030120302203032030420305203062030720308203092031020311203122031320314203152031620317203182031920320203212032220323203242032520326203272032820329203302033120332203332033420335203362033720338203392034020341203422034320344203452034620347203482034920350203512035220353203542035520356203572035820359203602036120362203632036420365203662036720368203692037020371203722037320374203752037620377203782037920380203812038220383203842038520386203872038820389203902039120392203932039420395203962039720398203992040020401204022040320404204052040620407204082040920410204112041220413204142041520416204172041820419204202042120422204232042420425204262042720428204292043020431204322043320434204352043620437204382043920440204412044220443204442044520446204472044820449204502045120452204532045420455204562045720458204592046020461204622046320464204652046620467204682046920470204712047220473204742047520476204772047820479204802048120482204832048420485204862048720488204892049020491204922049320494204952049620497204982049920500205012050220503205042050520506205072050820509205102051120512205132051420515205162051720518205192052020521205222052320524205252052620527205282052920530205312053220533205342053520536205372053820539205402054120542205432054420545205462054720548205492055020551205522055320554205552055620557205582055920560205612056220563205642056520566205672056820569205702057120572205732057420575205762057720578205792058020581205822058320584205852058620587205882058920590205912059220593205942059520596205972059820599206002060120602206032060420605206062060720608206092061020611206122061320614206152061620617206182061920620206212062220623206242062520626206272062820629206302063120632206332063420635206362063720638206392064020641206422064320644206452064620647206482064920650206512065220653206542065520656206572065820659206602066120662206632066420665206662066720668206692067020671206722067320674206752067620677206782067920680206812068220683206842068520686206872068820689206902069120692206932069420695206962069720698206992070020701207022070320704207052070620707207082070920710207112071220713207142071520716207172071820719207202072120722207232072420725207262072720728207292073020731207322073320734207352073620737207382073920740207412074220743207442074520746207472074820749207502075120752207532075420755207562075720758207592076020761207622076320764207652076620767207682076920770207712077220773207742077520776207772077820779207802078120782207832078420785207862078720788207892079020791207922079320794207952079620797207982079920800208012080220803208042080520806208072080820809208102081120812208132081420815208162081720818208192082020821208222082320824208252082620827208282082920830208312083220833208342083520836208372083820839208402084120842208432084420845208462084720848208492085020851208522085320854208552085620857208582085920860208612086220863208642086520866208672086820869208702087120872208732087420875208762087720878208792088020881208822088320884208852088620887208882088920890208912089220893208942089520896208972089820899209002090120902209032090420905209062090720908209092091020911209122091320914209152091620917209182091920920209212092220923209242092520926209272092820929209302093120932209332093420935209362093720938209392094020941209422094320944209452094620947209482094920950209512095220953209542095520956209572095820959209602096120962209632096420965209662096720968209692097020971209722097320974209752097620977209782097920980209812098220983209842098520986209872098820989209902099120992209932099420995209962099720998209992100021001210022100321004210052100621007210082100921010210112101221013210142101521016210172101821019210202102121022210232102421025210262102721028210292103021031210322103321034210352103621037210382103921040210412104221043210442104521046210472104821049210502105121052210532105421055210562105721058210592106021061210622106321064210652106621067210682106921070210712107221073210742107521076210772107821079210802108121082210832108421085210862108721088210892109021091210922109321094210952109621097210982109921100211012110221103211042110521106211072110821109211102111121112211132111421115211162111721118211192112021121211222112321124211252112621127211282112921130211312113221133211342113521136211372113821139211402114121142211432114421145211462114721148211492115021151211522115321154211552115621157211582115921160211612116221163211642116521166211672116821169211702117121172211732117421175211762117721178211792118021181211822118321184211852118621187211882118921190211912119221193211942119521196211972119821199212002120121202212032120421205212062120721208212092121021211212122121321214212152121621217212182121921220212212122221223212242122521226212272122821229212302123121232212332123421235212362123721238212392124021241212422124321244212452124621247212482124921250212512125221253212542125521256212572125821259212602126121262212632126421265212662126721268212692127021271212722127321274212752127621277212782127921280212812128221283212842128521286212872128821289212902129121292212932129421295212962129721298212992130021301213022130321304213052130621307213082130921310213112131221313213142131521316213172131821319213202132121322213232132421325213262132721328213292133021331213322133321334213352133621337213382133921340213412134221343213442134521346213472134821349213502135121352213532135421355213562135721358213592136021361213622136321364213652136621367213682136921370213712137221373213742137521376213772137821379213802138121382213832138421385213862138721388213892139021391213922139321394213952139621397213982139921400214012140221403214042140521406214072140821409214102141121412214132141421415214162141721418214192142021421214222142321424214252142621427214282142921430214312143221433214342143521436214372143821439214402144121442214432144421445214462144721448214492145021451214522145321454214552145621457214582145921460214612146221463214642146521466214672146821469214702147121472214732147421475214762147721478214792148021481214822148321484214852148621487214882148921490214912149221493214942149521496214972149821499215002150121502215032150421505215062150721508215092151021511215122151321514215152151621517215182151921520215212152221523215242152521526215272152821529215302153121532215332153421535215362153721538215392154021541215422154321544215452154621547215482154921550215512155221553215542155521556215572155821559215602156121562215632156421565215662156721568215692157021571215722157321574215752157621577215782157921580215812158221583215842158521586215872158821589215902159121592215932159421595215962159721598215992160021601216022160321604216052160621607216082160921610216112161221613216142161521616216172161821619216202162121622216232162421625216262162721628216292163021631216322163321634216352163621637216382163921640216412164221643216442164521646216472164821649216502165121652216532165421655216562165721658216592166021661216622166321664216652166621667216682166921670216712167221673216742167521676216772167821679216802168121682216832168421685216862168721688216892169021691216922169321694216952169621697216982169921700217012170221703217042170521706217072170821709217102171121712217132171421715217162171721718217192172021721217222172321724217252172621727217282172921730217312173221733217342173521736217372173821739217402174121742217432174421745217462174721748217492175021751217522175321754217552175621757217582175921760217612176221763217642176521766217672176821769217702177121772217732177421775217762177721778217792178021781217822178321784217852178621787217882178921790217912179221793217942179521796217972179821799218002180121802218032180421805218062180721808218092181021811218122181321814218152181621817218182181921820218212182221823218242182521826218272182821829218302183121832218332183421835218362183721838218392184021841218422184321844218452184621847218482184921850218512185221853218542185521856218572185821859218602186121862218632186421865218662186721868218692187021871218722187321874218752187621877218782187921880218812188221883218842188521886218872188821889218902189121892218932189421895218962189721898218992190021901219022190321904219052190621907219082190921910219112191221913219142191521916219172191821919219202192121922219232192421925219262192721928219292193021931219322193321934219352193621937219382193921940219412194221943219442194521946219472194821949219502195121952219532195421955219562195721958219592196021961219622196321964219652196621967219682196921970219712197221973219742197521976219772197821979219802198121982219832198421985219862198721988219892199021991219922199321994219952199621997219982199922000220012200222003220042200522006220072200822009220102201122012220132201422015220162201722018220192202022021220222202322024220252202622027220282202922030220312203222033220342203522036220372203822039220402204122042220432204422045220462204722048220492205022051220522205322054220552205622057220582205922060220612206222063220642206522066220672206822069220702207122072220732207422075220762207722078220792208022081220822208322084220852208622087220882208922090220912209222093220942209522096220972209822099221002210122102221032210422105221062210722108221092211022111221122211322114221152211622117221182211922120221212212222123221242212522126221272212822129221302213122132221332213422135221362213722138221392214022141221422214322144221452214622147221482214922150221512215222153221542215522156221572215822159221602216122162221632216422165221662216722168221692217022171221722217322174221752217622177221782217922180221812218222183221842218522186221872218822189221902219122192221932219422195221962219722198221992220022201222022220322204222052220622207222082220922210222112221222213222142221522216222172221822219222202222122222222232222422225222262222722228222292223022231222322223322234222352223622237222382223922240222412224222243222442224522246222472224822249222502225122252222532225422255222562225722258222592226022261222622226322264222652226622267222682226922270222712227222273222742227522276222772227822279222802228122282222832228422285222862228722288222892229022291222922229322294222952229622297222982229922300223012230222303223042230522306223072230822309223102231122312223132231422315223162231722318223192232022321223222232322324223252232622327223282232922330223312233222333223342233522336223372233822339223402234122342223432234422345223462234722348223492235022351223522235322354223552235622357223582235922360223612236222363223642236522366223672236822369223702237122372223732237422375223762237722378223792238022381223822238322384223852238622387223882238922390223912239222393223942239522396223972239822399224002240122402224032240422405224062240722408224092241022411224122241322414224152241622417224182241922420224212242222423224242242522426224272242822429224302243122432224332243422435224362243722438224392244022441224422244322444224452244622447224482244922450224512245222453224542245522456224572245822459224602246122462224632246422465224662246722468224692247022471224722247322474224752247622477224782247922480224812248222483224842248522486224872248822489224902249122492224932249422495224962249722498224992250022501225022250322504225052250622507225082250922510225112251222513225142251522516225172251822519225202252122522225232252422525225262252722528225292253022531225322253322534225352253622537225382253922540225412254222543225442254522546225472254822549225502255122552225532255422555225562255722558225592256022561225622256322564225652256622567225682256922570225712257222573225742257522576225772257822579225802258122582225832258422585225862258722588225892259022591225922259322594225952259622597225982259922600226012260222603226042260522606226072260822609226102261122612226132261422615226162261722618226192262022621226222262322624226252262622627226282262922630226312263222633226342263522636226372263822639226402264122642226432264422645226462264722648226492265022651226522265322654226552265622657226582265922660226612266222663226642266522666226672266822669226702267122672226732267422675226762267722678226792268022681226822268322684226852268622687226882268922690226912269222693226942269522696226972269822699227002270122702227032270422705227062270722708227092271022711227122271322714227152271622717227182271922720227212272222723227242272522726227272272822729227302273122732227332273422735227362273722738227392274022741227422274322744227452274622747227482274922750227512275222753227542275522756227572275822759227602276122762227632276422765227662276722768227692277022771227722277322774227752277622777227782277922780227812278222783227842278522786227872278822789227902279122792227932279422795227962279722798227992280022801228022280322804228052280622807228082280922810228112281222813228142281522816228172281822819228202282122822228232282422825228262282722828228292283022831228322283322834228352283622837228382283922840228412284222843228442284522846228472284822849228502285122852228532285422855228562285722858228592286022861228622286322864228652286622867228682286922870228712287222873228742287522876228772287822879228802288122882228832288422885228862288722888228892289022891228922289322894228952289622897228982289922900229012290222903229042290522906229072290822909229102291122912229132291422915229162291722918229192292022921229222292322924229252292622927229282292922930229312293222933229342293522936229372293822939229402294122942229432294422945229462294722948229492295022951229522295322954229552295622957229582295922960229612296222963229642296522966229672296822969229702297122972229732297422975229762297722978229792298022981229822298322984229852298622987229882298922990229912299222993229942299522996229972299822999230002300123002230032300423005230062300723008230092301023011230122301323014230152301623017230182301923020230212302223023230242302523026230272302823029230302303123032230332303423035230362303723038230392304023041230422304323044230452304623047230482304923050230512305223053230542305523056230572305823059230602306123062230632306423065230662306723068230692307023071230722307323074230752307623077230782307923080230812308223083230842308523086230872308823089230902309123092230932309423095230962309723098230992310023101231022310323104231052310623107231082310923110231112311223113231142311523116231172311823119231202312123122231232312423125231262312723128231292313023131231322313323134231352313623137231382313923140231412314223143231442314523146231472314823149231502315123152231532315423155231562315723158231592316023161231622316323164231652316623167231682316923170231712317223173231742317523176231772317823179231802318123182231832318423185231862318723188231892319023191231922319323194231952319623197231982319923200232012320223203232042320523206232072320823209232102321123212232132321423215232162321723218232192322023221232222322323224232252322623227232282322923230232312323223233232342323523236232372323823239232402324123242232432324423245232462324723248232492325023251232522325323254232552325623257232582325923260232612326223263232642326523266232672326823269232702327123272232732327423275232762327723278232792328023281232822328323284232852328623287232882328923290232912329223293232942329523296232972329823299233002330123302233032330423305233062330723308233092331023311233122331323314233152331623317233182331923320233212332223323233242332523326233272332823329233302333123332233332333423335233362333723338233392334023341233422334323344233452334623347233482334923350233512335223353233542335523356233572335823359233602336123362233632336423365233662336723368233692337023371233722337323374233752337623377233782337923380233812338223383233842338523386233872338823389233902339123392233932339423395233962339723398233992340023401234022340323404234052340623407234082340923410234112341223413234142341523416234172341823419234202342123422234232342423425234262342723428234292343023431234322343323434234352343623437234382343923440234412344223443234442344523446234472344823449234502345123452234532345423455234562345723458234592346023461234622346323464234652346623467234682346923470234712347223473234742347523476234772347823479234802348123482234832348423485234862348723488234892349023491234922349323494234952349623497234982349923500235012350223503235042350523506235072350823509235102351123512235132351423515235162351723518235192352023521235222352323524235252352623527235282352923530235312353223533235342353523536235372353823539235402354123542235432354423545235462354723548235492355023551235522355323554235552355623557235582355923560235612356223563235642356523566235672356823569235702357123572235732357423575235762357723578235792358023581235822358323584235852358623587235882358923590235912359223593235942359523596235972359823599236002360123602236032360423605236062360723608236092361023611236122361323614236152361623617236182361923620236212362223623236242362523626236272362823629236302363123632236332363423635236362363723638236392364023641236422364323644236452364623647236482364923650236512365223653236542365523656236572365823659236602366123662236632366423665236662366723668236692367023671236722367323674236752367623677236782367923680236812368223683236842368523686236872368823689236902369123692236932369423695236962369723698236992370023701237022370323704237052370623707237082370923710237112371223713237142371523716237172371823719237202372123722237232372423725237262372723728237292373023731237322373323734237352373623737237382373923740237412374223743237442374523746237472374823749237502375123752237532375423755237562375723758237592376023761237622376323764237652376623767237682376923770237712377223773237742377523776237772377823779237802378123782237832378423785237862378723788237892379023791237922379323794237952379623797237982379923800238012380223803238042380523806238072380823809238102381123812238132381423815238162381723818238192382023821238222382323824238252382623827238282382923830238312383223833238342383523836238372383823839238402384123842238432384423845238462384723848238492385023851238522385323854238552385623857238582385923860238612386223863238642386523866238672386823869238702387123872238732387423875238762387723878238792388023881238822388323884238852388623887238882388923890238912389223893238942389523896238972389823899239002390123902239032390423905239062390723908239092391023911239122391323914239152391623917239182391923920239212392223923239242392523926239272392823929239302393123932239332393423935239362393723938239392394023941239422394323944239452394623947239482394923950239512395223953239542395523956239572395823959239602396123962239632396423965239662396723968239692397023971239722397323974239752397623977239782397923980239812398223983239842398523986239872398823989239902399123992239932399423995239962399723998239992400024001240022400324004240052400624007240082400924010240112401224013240142401524016240172401824019240202402124022240232402424025240262402724028240292403024031240322403324034240352403624037240382403924040240412404224043240442404524046240472404824049240502405124052240532405424055240562405724058240592406024061240622406324064240652406624067240682406924070240712407224073240742407524076240772407824079240802408124082240832408424085240862408724088240892409024091240922409324094240952409624097240982409924100241012410224103241042410524106241072410824109241102411124112241132411424115241162411724118241192412024121241222412324124241252412624127241282412924130241312413224133241342413524136241372413824139241402414124142241432414424145241462414724148241492415024151241522415324154241552415624157241582415924160241612416224163241642416524166241672416824169241702417124172241732417424175241762417724178241792418024181241822418324184241852418624187241882418924190241912419224193241942419524196241972419824199242002420124202242032420424205242062420724208242092421024211242122421324214242152421624217242182421924220242212422224223242242422524226242272422824229242302423124232242332423424235242362423724238242392424024241242422424324244242452424624247242482424924250242512425224253242542425524256242572425824259242602426124262242632426424265242662426724268242692427024271242722427324274242752427624277242782427924280242812428224283242842428524286242872428824289242902429124292242932429424295242962429724298242992430024301243022430324304243052430624307243082430924310243112431224313243142431524316243172431824319243202432124322243232432424325243262432724328243292433024331243322433324334243352433624337243382433924340243412434224343243442434524346243472434824349243502435124352243532435424355243562435724358243592436024361243622436324364243652436624367243682436924370243712437224373243742437524376243772437824379243802438124382243832438424385243862438724388243892439024391243922439324394243952439624397243982439924400244012440224403244042440524406244072440824409244102441124412244132441424415244162441724418244192442024421244222442324424244252442624427244282442924430244312443224433244342443524436244372443824439244402444124442244432444424445244462444724448244492445024451244522445324454244552445624457244582445924460244612446224463244642446524466244672446824469244702447124472244732447424475244762447724478244792448024481244822448324484244852448624487244882448924490244912449224493244942449524496244972449824499245002450124502245032450424505245062450724508245092451024511245122451324514245152451624517245182451924520245212452224523245242452524526245272452824529245302453124532245332453424535245362453724538245392454024541245422454324544245452454624547245482454924550245512455224553245542455524556245572455824559245602456124562245632456424565245662456724568245692457024571245722457324574245752457624577245782457924580245812458224583245842458524586245872458824589245902459124592245932459424595245962459724598245992460024601246022460324604246052460624607246082460924610246112461224613246142461524616246172461824619246202462124622246232462424625246262462724628246292463024631246322463324634246352463624637246382463924640246412464224643246442464524646246472464824649246502465124652246532465424655246562465724658246592466024661246622466324664246652466624667246682466924670246712467224673246742467524676246772467824679246802468124682246832468424685246862468724688246892469024691246922469324694246952469624697246982469924700247012470224703247042470524706247072470824709247102471124712247132471424715247162471724718247192472024721247222472324724247252472624727247282472924730247312473224733247342473524736247372473824739247402474124742247432474424745247462474724748247492475024751247522475324754247552475624757247582475924760247612476224763247642476524766247672476824769247702477124772247732477424775247762477724778247792478024781247822478324784247852478624787247882478924790247912479224793247942479524796247972479824799248002480124802248032480424805248062480724808248092481024811248122481324814248152481624817248182481924820248212482224823248242482524826248272482824829248302483124832248332483424835248362483724838248392484024841248422484324844248452484624847248482484924850248512485224853248542485524856248572485824859248602486124862248632486424865248662486724868248692487024871248722487324874248752487624877248782487924880248812488224883248842488524886248872488824889248902489124892248932489424895248962489724898248992490024901249022490324904249052490624907249082490924910249112491224913249142491524916249172491824919249202492124922249232492424925249262492724928249292493024931249322493324934249352493624937249382493924940249412494224943249442494524946249472494824949249502495124952249532495424955249562495724958249592496024961249622496324964249652496624967249682496924970249712497224973249742497524976249772497824979249802498124982249832498424985249862498724988249892499024991249922499324994249952499624997249982499925000250012500225003250042500525006250072500825009250102501125012250132501425015250162501725018250192502025021250222502325024250252502625027250282502925030250312503225033250342503525036250372503825039250402504125042250432504425045250462504725048250492505025051250522505325054250552505625057250582505925060250612506225063250642506525066250672506825069250702507125072250732507425075250762507725078250792508025081250822508325084250852508625087250882508925090250912509225093250942509525096250972509825099251002510125102251032510425105251062510725108251092511025111251122511325114251152511625117251182511925120251212512225123251242512525126251272512825129251302513125132251332513425135251362513725138251392514025141251422514325144251452514625147251482514925150251512515225153251542515525156251572515825159251602516125162251632516425165251662516725168251692517025171251722517325174251752517625177251782517925180251812518225183251842518525186251872518825189251902519125192251932519425195251962519725198251992520025201252022520325204252052520625207252082520925210252112521225213252142521525216252172521825219252202522125222252232522425225252262522725228252292523025231252322523325234252352523625237252382523925240252412524225243252442524525246252472524825249252502525125252252532525425255252562525725258252592526025261252622526325264252652526625267252682526925270252712527225273252742527525276252772527825279252802528125282252832528425285252862528725288252892529025291252922529325294252952529625297252982529925300253012530225303253042530525306253072530825309253102531125312253132531425315253162531725318253192532025321253222532325324253252532625327253282532925330253312533225333253342533525336253372533825339253402534125342253432534425345253462534725348253492535025351253522535325354253552535625357253582535925360253612536225363253642536525366253672536825369253702537125372253732537425375253762537725378253792538025381253822538325384253852538625387253882538925390253912539225393253942539525396253972539825399254002540125402254032540425405254062540725408254092541025411254122541325414254152541625417254182541925420254212542225423254242542525426254272542825429254302543125432254332543425435254362543725438254392544025441254422544325444254452544625447254482544925450254512545225453254542545525456254572545825459254602546125462254632546425465254662546725468254692547025471254722547325474254752547625477254782547925480254812548225483254842548525486254872548825489254902549125492254932549425495254962549725498254992550025501255022550325504255052550625507255082550925510255112551225513255142551525516255172551825519255202552125522255232552425525255262552725528255292553025531255322553325534255352553625537255382553925540255412554225543255442554525546255472554825549255502555125552255532555425555255562555725558255592556025561255622556325564255652556625567255682556925570255712557225573255742557525576255772557825579255802558125582255832558425585255862558725588255892559025591255922559325594255952559625597255982559925600256012560225603256042560525606256072560825609256102561125612256132561425615256162561725618256192562025621256222562325624256252562625627256282562925630256312563225633256342563525636256372563825639256402564125642256432564425645256462564725648256492565025651256522565325654256552565625657256582565925660256612566225663256642566525666256672566825669256702567125672256732567425675256762567725678256792568025681256822568325684256852568625687256882568925690256912569225693256942569525696256972569825699257002570125702257032570425705257062570725708257092571025711257122571325714257152571625717257182571925720257212572225723257242572525726257272572825729257302573125732257332573425735257362573725738257392574025741257422574325744257452574625747257482574925750257512575225753257542575525756257572575825759257602576125762257632576425765257662576725768257692577025771257722577325774257752577625777257782577925780257812578225783257842578525786257872578825789257902579125792257932579425795257962579725798257992580025801258022580325804258052580625807258082580925810258112581225813258142581525816258172581825819258202582125822258232582425825258262582725828258292583025831258322583325834258352583625837258382583925840258412584225843258442584525846258472584825849258502585125852258532585425855258562585725858258592586025861258622586325864258652586625867258682586925870258712587225873258742587525876258772587825879258802588125882258832588425885258862588725888258892589025891258922589325894258952589625897258982589925900259012590225903259042590525906259072590825909259102591125912259132591425915259162591725918259192592025921259222592325924259252592625927259282592925930259312593225933259342593525936259372593825939259402594125942259432594425945259462594725948259492595025951259522595325954259552595625957259582595925960259612596225963259642596525966259672596825969259702597125972259732597425975259762597725978259792598025981259822598325984259852598625987259882598925990259912599225993259942599525996259972599825999260002600126002260032600426005260062600726008260092601026011260122601326014260152601626017260182601926020260212602226023260242602526026260272602826029260302603126032260332603426035260362603726038260392604026041260422604326044260452604626047260482604926050260512605226053260542605526056260572605826059260602606126062260632606426065260662606726068260692607026071260722607326074260752607626077260782607926080260812608226083260842608526086260872608826089260902609126092260932609426095260962609726098260992610026101261022610326104261052610626107261082610926110261112611226113261142611526116261172611826119261202612126122261232612426125261262612726128261292613026131261322613326134261352613626137261382613926140261412614226143261442614526146261472614826149261502615126152261532615426155261562615726158261592616026161261622616326164261652616626167261682616926170261712617226173261742617526176261772617826179261802618126182261832618426185261862618726188261892619026191261922619326194261952619626197261982619926200262012620226203262042620526206262072620826209262102621126212262132621426215262162621726218262192622026221262222622326224262252622626227262282622926230262312623226233262342623526236262372623826239262402624126242262432624426245262462624726248262492625026251262522625326254262552625626257262582625926260262612626226263262642626526266262672626826269262702627126272262732627426275262762627726278262792628026281262822628326284262852628626287262882628926290262912629226293262942629526296262972629826299263002630126302263032630426305263062630726308263092631026311263122631326314263152631626317263182631926320263212632226323263242632526326263272632826329263302633126332263332633426335263362633726338263392634026341263422634326344263452634626347263482634926350263512635226353263542635526356263572635826359263602636126362263632636426365263662636726368263692637026371263722637326374263752637626377263782637926380263812638226383263842638526386263872638826389263902639126392263932639426395263962639726398263992640026401264022640326404264052640626407264082640926410264112641226413264142641526416264172641826419264202642126422264232642426425264262642726428264292643026431264322643326434264352643626437264382643926440264412644226443264442644526446264472644826449264502645126452264532645426455264562645726458264592646026461264622646326464264652646626467264682646926470264712647226473264742647526476264772647826479264802648126482264832648426485264862648726488264892649026491264922649326494264952649626497264982649926500265012650226503265042650526506265072650826509265102651126512265132651426515265162651726518265192652026521265222652326524265252652626527265282652926530265312653226533265342653526536265372653826539265402654126542265432654426545265462654726548265492655026551265522655326554265552655626557265582655926560265612656226563265642656526566265672656826569265702657126572265732657426575265762657726578265792658026581265822658326584265852658626587265882658926590265912659226593265942659526596265972659826599266002660126602266032660426605266062660726608266092661026611266122661326614266152661626617266182661926620266212662226623266242662526626266272662826629266302663126632266332663426635266362663726638266392664026641266422664326644266452664626647266482664926650266512665226653266542665526656266572665826659266602666126662266632666426665266662666726668266692667026671266722667326674266752667626677266782667926680266812668226683266842668526686266872668826689266902669126692266932669426695266962669726698266992670026701267022670326704267052670626707267082670926710267112671226713267142671526716267172671826719267202672126722267232672426725267262672726728267292673026731267322673326734267352673626737267382673926740267412674226743267442674526746267472674826749267502675126752267532675426755267562675726758267592676026761267622676326764267652676626767267682676926770267712677226773267742677526776267772677826779267802678126782267832678426785267862678726788267892679026791267922679326794267952679626797267982679926800268012680226803268042680526806268072680826809268102681126812268132681426815268162681726818268192682026821268222682326824268252682626827268282682926830268312683226833268342683526836268372683826839268402684126842268432684426845268462684726848268492685026851268522685326854268552685626857268582685926860268612686226863268642686526866268672686826869268702687126872268732687426875268762687726878268792688026881268822688326884268852688626887268882688926890268912689226893268942689526896268972689826899269002690126902269032690426905269062690726908269092691026911269122691326914269152691626917269182691926920269212692226923269242692526926269272692826929269302693126932269332693426935269362693726938269392694026941269422694326944269452694626947269482694926950269512695226953269542695526956269572695826959269602696126962269632696426965269662696726968269692697026971269722697326974269752697626977269782697926980269812698226983269842698526986269872698826989269902699126992269932699426995269962699726998269992700027001270022700327004270052700627007270082700927010270112701227013270142701527016270172701827019270202702127022270232702427025270262702727028270292703027031270322703327034270352703627037270382703927040270412704227043270442704527046270472704827049270502705127052270532705427055270562705727058270592706027061270622706327064270652706627067270682706927070270712707227073270742707527076270772707827079270802708127082270832708427085270862708727088270892709027091270922709327094270952709627097270982709927100271012710227103271042710527106271072710827109271102711127112271132711427115271162711727118271192712027121271222712327124271252712627127271282712927130271312713227133271342713527136271372713827139271402714127142271432714427145271462714727148271492715027151271522715327154271552715627157271582715927160271612716227163271642716527166271672716827169271702717127172271732717427175271762717727178271792718027181271822718327184271852718627187271882718927190271912719227193271942719527196271972719827199272002720127202272032720427205272062720727208272092721027211272122721327214272152721627217272182721927220272212722227223272242722527226272272722827229272302723127232272332723427235272362723727238272392724027241272422724327244272452724627247272482724927250272512725227253272542725527256272572725827259272602726127262272632726427265272662726727268272692727027271272722727327274272752727627277272782727927280272812728227283272842728527286272872728827289272902729127292272932729427295272962729727298272992730027301273022730327304273052730627307273082730927310273112731227313273142731527316273172731827319273202732127322273232732427325273262732727328273292733027331273322733327334273352733627337273382733927340273412734227343273442734527346273472734827349273502735127352273532735427355273562735727358273592736027361273622736327364273652736627367273682736927370273712737227373273742737527376273772737827379273802738127382273832738427385273862738727388273892739027391273922739327394273952739627397273982739927400274012740227403274042740527406274072740827409274102741127412274132741427415274162741727418274192742027421274222742327424274252742627427274282742927430274312743227433274342743527436274372743827439274402744127442274432744427445274462744727448274492745027451274522745327454274552745627457274582745927460274612746227463274642746527466274672746827469274702747127472274732747427475274762747727478274792748027481274822748327484274852748627487274882748927490274912749227493274942749527496274972749827499275002750127502275032750427505275062750727508275092751027511275122751327514275152751627517275182751927520275212752227523275242752527526275272752827529275302753127532275332753427535275362753727538275392754027541275422754327544275452754627547275482754927550275512755227553275542755527556275572755827559275602756127562275632756427565275662756727568275692757027571275722757327574275752757627577275782757927580275812758227583275842758527586275872758827589275902759127592275932759427595275962759727598275992760027601276022760327604276052760627607276082760927610276112761227613276142761527616276172761827619276202762127622276232762427625276262762727628276292763027631276322763327634276352763627637276382763927640276412764227643276442764527646276472764827649276502765127652276532765427655276562765727658276592766027661276622766327664276652766627667276682766927670276712767227673276742767527676276772767827679276802768127682276832768427685276862768727688276892769027691276922769327694276952769627697276982769927700277012770227703277042770527706277072770827709277102771127712277132771427715277162771727718277192772027721277222772327724277252772627727277282772927730277312773227733277342773527736277372773827739277402774127742277432774427745277462774727748277492775027751277522775327754277552775627757277582775927760277612776227763277642776527766277672776827769277702777127772277732777427775277762777727778277792778027781277822778327784277852778627787277882778927790277912779227793277942779527796277972779827799278002780127802278032780427805278062780727808278092781027811278122781327814278152781627817278182781927820278212782227823278242782527826278272782827829278302783127832278332783427835278362783727838278392784027841278422784327844278452784627847278482784927850278512785227853278542785527856278572785827859278602786127862278632786427865278662786727868278692787027871278722787327874278752787627877278782787927880278812788227883278842788527886278872788827889278902789127892278932789427895278962789727898278992790027901279022790327904279052790627907279082790927910279112791227913279142791527916279172791827919279202792127922279232792427925279262792727928279292793027931279322793327934279352793627937279382793927940279412794227943279442794527946279472794827949279502795127952279532795427955279562795727958279592796027961279622796327964279652796627967279682796927970279712797227973279742797527976279772797827979279802798127982279832798427985279862798727988279892799027991279922799327994279952799627997279982799928000280012800228003280042800528006280072800828009280102801128012280132801428015280162801728018280192802028021280222802328024280252802628027280282802928030280312803228033280342803528036280372803828039280402804128042280432804428045280462804728048280492805028051280522805328054280552805628057280582805928060280612806228063280642806528066280672806828069280702807128072280732807428075280762807728078280792808028081280822808328084280852808628087280882808928090280912809228093280942809528096280972809828099281002810128102281032810428105281062810728108281092811028111281122811328114281152811628117281182811928120281212812228123281242812528126281272812828129281302813128132281332813428135281362813728138281392814028141281422814328144281452814628147281482814928150281512815228153281542815528156281572815828159281602816128162281632816428165281662816728168281692817028171281722817328174281752817628177281782817928180281812818228183281842818528186281872818828189281902819128192281932819428195281962819728198281992820028201282022820328204282052820628207282082820928210282112821228213282142821528216282172821828219282202822128222282232822428225282262822728228282292823028231282322823328234282352823628237282382823928240282412824228243282442824528246282472824828249282502825128252282532825428255282562825728258282592826028261282622826328264282652826628267282682826928270282712827228273282742827528276282772827828279282802828128282282832828428285282862828728288282892829028291282922829328294282952829628297282982829928300283012830228303283042830528306283072830828309283102831128312283132831428315283162831728318283192832028321283222832328324283252832628327283282832928330283312833228333283342833528336283372833828339283402834128342283432834428345283462834728348283492835028351283522835328354283552835628357283582835928360283612836228363283642836528366283672836828369283702837128372283732837428375283762837728378283792838028381283822838328384283852838628387283882838928390283912839228393283942839528396283972839828399284002840128402284032840428405284062840728408284092841028411284122841328414284152841628417284182841928420284212842228423284242842528426284272842828429284302843128432284332843428435284362843728438284392844028441284422844328444284452844628447284482844928450284512845228453284542845528456284572845828459284602846128462284632846428465284662846728468284692847028471284722847328474284752847628477284782847928480284812848228483284842848528486284872848828489284902849128492284932849428495284962849728498284992850028501285022850328504285052850628507285082850928510285112851228513285142851528516285172851828519285202852128522285232852428525285262852728528285292853028531285322853328534285352853628537285382853928540285412854228543285442854528546285472854828549285502855128552285532855428555285562855728558285592856028561285622856328564285652856628567285682856928570285712857228573285742857528576285772857828579285802858128582285832858428585285862858728588285892859028591285922859328594285952859628597285982859928600286012860228603286042860528606286072860828609286102861128612286132861428615286162861728618286192862028621286222862328624286252862628627286282862928630286312863228633286342863528636286372863828639286402864128642286432864428645286462864728648286492865028651286522865328654286552865628657286582865928660286612866228663286642866528666286672866828669286702867128672286732867428675286762867728678286792868028681286822868328684286852868628687286882868928690286912869228693286942869528696286972869828699287002870128702287032870428705287062870728708287092871028711287122871328714287152871628717287182871928720287212872228723287242872528726287272872828729287302873128732287332873428735287362873728738287392874028741287422874328744287452874628747287482874928750287512875228753287542875528756287572875828759287602876128762287632876428765287662876728768287692877028771287722877328774287752877628777287782877928780287812878228783287842878528786287872878828789287902879128792287932879428795287962879728798287992880028801288022880328804288052880628807288082880928810288112881228813288142881528816288172881828819288202882128822288232882428825288262882728828288292883028831288322883328834288352883628837288382883928840288412884228843288442884528846288472884828849288502885128852288532885428855288562885728858288592886028861288622886328864288652886628867288682886928870288712887228873288742887528876288772887828879288802888128882288832888428885288862888728888288892889028891288922889328894288952889628897288982889928900289012890228903289042890528906289072890828909289102891128912289132891428915289162891728918289192892028921289222892328924289252892628927289282892928930289312893228933289342893528936289372893828939289402894128942289432894428945289462894728948289492895028951289522895328954289552895628957289582895928960289612896228963289642896528966289672896828969289702897128972289732897428975289762897728978289792898028981289822898328984289852898628987289882898928990289912899228993289942899528996289972899828999290002900129002290032900429005290062900729008290092901029011290122901329014290152901629017290182901929020290212902229023290242902529026290272902829029290302903129032290332903429035290362903729038290392904029041290422904329044290452904629047290482904929050290512905229053290542905529056290572905829059290602906129062290632906429065290662906729068290692907029071290722907329074290752907629077290782907929080290812908229083290842908529086290872908829089290902909129092290932909429095290962909729098290992910029101291022910329104291052910629107291082910929110291112911229113291142911529116291172911829119291202912129122291232912429125291262912729128291292913029131291322913329134291352913629137291382913929140291412914229143291442914529146291472914829149291502915129152291532915429155291562915729158291592916029161291622916329164291652916629167291682916929170291712917229173291742917529176291772917829179291802918129182291832918429185291862918729188291892919029191291922919329194291952919629197291982919929200292012920229203292042920529206292072920829209292102921129212292132921429215292162921729218292192922029221292222922329224292252922629227292282922929230292312923229233292342923529236292372923829239292402924129242292432924429245292462924729248292492925029251292522925329254292552925629257292582925929260292612926229263292642926529266292672926829269292702927129272292732927429275292762927729278292792928029281292822928329284292852928629287292882928929290292912929229293292942929529296292972929829299293002930129302293032930429305293062930729308293092931029311293122931329314293152931629317293182931929320293212932229323293242932529326293272932829329293302933129332293332933429335293362933729338293392934029341293422934329344293452934629347293482934929350293512935229353293542935529356293572935829359293602936129362293632936429365293662936729368293692937029371293722937329374293752937629377293782937929380293812938229383293842938529386293872938829389293902939129392293932939429395293962939729398293992940029401294022940329404294052940629407294082940929410294112941229413294142941529416294172941829419294202942129422294232942429425294262942729428294292943029431294322943329434294352943629437294382943929440294412944229443294442944529446294472944829449294502945129452294532945429455294562945729458294592946029461294622946329464294652946629467294682946929470294712947229473294742947529476294772947829479294802948129482294832948429485294862948729488294892949029491294922949329494294952949629497294982949929500295012950229503295042950529506295072950829509295102951129512295132951429515295162951729518295192952029521295222952329524295252952629527295282952929530295312953229533295342953529536295372953829539295402954129542295432954429545295462954729548295492955029551295522955329554295552955629557295582955929560295612956229563295642956529566295672956829569295702957129572295732957429575295762957729578295792958029581295822958329584295852958629587295882958929590295912959229593295942959529596295972959829599296002960129602296032960429605296062960729608296092961029611296122961329614296152961629617296182961929620296212962229623296242962529626296272962829629296302963129632296332963429635296362963729638296392964029641296422964329644296452964629647296482964929650296512965229653296542965529656296572965829659296602966129662296632966429665296662966729668296692967029671296722967329674296752967629677296782967929680296812968229683296842968529686296872968829689296902969129692296932969429695296962969729698296992970029701297022970329704297052970629707297082970929710297112971229713297142971529716297172971829719297202972129722297232972429725297262972729728297292973029731297322973329734297352973629737297382973929740297412974229743297442974529746297472974829749297502975129752297532975429755297562975729758297592976029761297622976329764297652976629767297682976929770297712977229773297742977529776297772977829779297802978129782297832978429785297862978729788297892979029791297922979329794297952979629797297982979929800298012980229803298042980529806298072980829809298102981129812298132981429815298162981729818298192982029821298222982329824298252982629827298282982929830298312983229833298342983529836298372983829839298402984129842298432984429845298462984729848298492985029851298522985329854298552985629857298582985929860298612986229863298642986529866298672986829869298702987129872298732987429875298762987729878298792988029881298822988329884298852988629887298882988929890298912989229893298942989529896298972989829899299002990129902299032990429905299062990729908299092991029911299122991329914299152991629917299182991929920299212992229923299242992529926299272992829929299302993129932299332993429935299362993729938299392994029941299422994329944299452994629947299482994929950299512995229953299542995529956299572995829959299602996129962299632996429965299662996729968299692997029971299722997329974299752997629977299782997929980299812998229983299842998529986299872998829989299902999129992299932999429995299962999729998299993000030001300023000330004300053000630007300083000930010300113001230013300143001530016300173001830019300203002130022300233002430025300263002730028300293003030031300323003330034300353003630037300383003930040300413004230043300443004530046300473004830049300503005130052300533005430055300563005730058300593006030061300623006330064300653006630067300683006930070300713007230073300743007530076300773007830079300803008130082300833008430085300863008730088300893009030091300923009330094300953009630097300983009930100301013010230103301043010530106301073010830109301103011130112301133011430115301163011730118301193012030121301223012330124301253012630127301283012930130301313013230133301343013530136301373013830139301403014130142301433014430145301463014730148301493015030151301523015330154301553015630157301583015930160301613016230163301643016530166301673016830169301703017130172301733017430175301763017730178301793018030181301823018330184301853018630187301883018930190301913019230193301943019530196301973019830199302003020130202302033020430205302063020730208302093021030211302123021330214302153021630217302183021930220302213022230223302243022530226302273022830229302303023130232302333023430235302363023730238302393024030241302423024330244302453024630247302483024930250302513025230253302543025530256302573025830259302603026130262302633026430265302663026730268302693027030271302723027330274302753027630277302783027930280302813028230283302843028530286302873028830289302903029130292302933029430295302963029730298302993030030301303023030330304303053030630307303083030930310303113031230313303143031530316303173031830319303203032130322303233032430325303263032730328303293033030331303323033330334303353033630337303383033930340303413034230343303443034530346303473034830349303503035130352303533035430355303563035730358303593036030361303623036330364303653036630367303683036930370303713037230373303743037530376303773037830379303803038130382303833038430385303863038730388303893039030391303923039330394303953039630397303983039930400304013040230403304043040530406304073040830409304103041130412304133041430415304163041730418304193042030421304223042330424304253042630427304283042930430304313043230433304343043530436304373043830439304403044130442304433044430445304463044730448304493045030451304523045330454304553045630457304583045930460304613046230463304643046530466304673046830469304703047130472304733047430475304763047730478304793048030481304823048330484304853048630487304883048930490304913049230493304943049530496304973049830499305003050130502305033050430505305063050730508305093051030511305123051330514305153051630517305183051930520305213052230523305243052530526305273052830529305303053130532305333053430535305363053730538305393054030541305423054330544305453054630547305483054930550305513055230553305543055530556305573055830559305603056130562305633056430565305663056730568305693057030571305723057330574305753057630577305783057930580305813058230583305843058530586305873058830589305903059130592305933059430595305963059730598305993060030601306023060330604306053060630607306083060930610306113061230613306143061530616306173061830619306203062130622306233062430625306263062730628306293063030631306323063330634306353063630637306383063930640306413064230643306443064530646306473064830649306503065130652306533065430655306563065730658306593066030661306623066330664306653066630667306683066930670306713067230673306743067530676306773067830679306803068130682306833068430685306863068730688306893069030691306923069330694306953069630697306983069930700307013070230703307043070530706307073070830709307103071130712307133071430715307163071730718307193072030721307223072330724307253072630727307283072930730307313073230733307343073530736307373073830739307403074130742307433074430745307463074730748307493075030751307523075330754307553075630757307583075930760307613076230763307643076530766307673076830769307703077130772307733077430775307763077730778307793078030781307823078330784307853078630787307883078930790307913079230793307943079530796307973079830799308003080130802308033080430805308063080730808308093081030811308123081330814308153081630817308183081930820308213082230823308243082530826308273082830829308303083130832308333083430835308363083730838308393084030841308423084330844308453084630847308483084930850308513085230853308543085530856308573085830859308603086130862308633086430865308663086730868308693087030871308723087330874308753087630877308783087930880308813088230883308843088530886308873088830889308903089130892308933089430895308963089730898308993090030901309023090330904309053090630907309083090930910309113091230913309143091530916309173091830919309203092130922309233092430925309263092730928309293093030931309323093330934309353093630937309383093930940309413094230943309443094530946309473094830949309503095130952309533095430955309563095730958309593096030961309623096330964309653096630967309683096930970309713097230973309743097530976309773097830979309803098130982309833098430985309863098730988309893099030991309923099330994309953099630997309983099931000310013100231003310043100531006310073100831009310103101131012310133101431015310163101731018310193102031021310223102331024310253102631027310283102931030310313103231033310343103531036310373103831039310403104131042310433104431045310463104731048310493105031051310523105331054310553105631057310583105931060310613106231063310643106531066310673106831069310703107131072310733107431075310763107731078310793108031081310823108331084310853108631087310883108931090310913109231093310943109531096310973109831099311003110131102311033110431105311063110731108311093111031111311123111331114311153111631117311183111931120311213112231123311243112531126311273112831129311303113131132311333113431135311363113731138311393114031141311423114331144311453114631147311483114931150311513115231153311543115531156311573115831159311603116131162311633116431165311663116731168311693117031171311723117331174311753117631177311783117931180311813118231183311843118531186311873118831189311903119131192311933119431195311963119731198311993120031201312023120331204312053120631207312083120931210312113121231213312143121531216312173121831219312203122131222312233122431225312263122731228312293123031231312323123331234312353123631237312383123931240312413124231243312443124531246312473124831249312503125131252312533125431255312563125731258312593126031261312623126331264312653126631267312683126931270312713127231273312743127531276312773127831279312803128131282312833128431285312863128731288312893129031291312923129331294312953129631297312983129931300313013130231303313043130531306313073130831309313103131131312313133131431315313163131731318313193132031321313223132331324313253132631327313283132931330313313133231333313343133531336313373133831339313403134131342313433134431345313463134731348313493135031351313523135331354313553135631357313583135931360313613136231363313643136531366313673136831369313703137131372313733137431375313763137731378313793138031381313823138331384313853138631387313883138931390313913139231393313943139531396313973139831399314003140131402314033140431405314063140731408314093141031411314123141331414314153141631417314183141931420314213142231423314243142531426314273142831429314303143131432314333143431435314363143731438314393144031441314423144331444314453144631447314483144931450314513145231453314543145531456314573145831459314603146131462314633146431465314663146731468314693147031471314723147331474314753147631477314783147931480314813148231483314843148531486314873148831489314903149131492314933149431495314963149731498314993150031501315023150331504315053150631507315083150931510315113151231513315143151531516315173151831519315203152131522315233152431525315263152731528315293153031531315323153331534315353153631537315383153931540315413154231543315443154531546315473154831549315503155131552315533155431555315563155731558315593156031561315623156331564315653156631567315683156931570315713157231573315743157531576315773157831579315803158131582315833158431585315863158731588315893159031591315923159331594315953159631597315983159931600316013160231603316043160531606316073160831609316103161131612316133161431615316163161731618316193162031621316223162331624316253162631627316283162931630316313163231633316343163531636316373163831639316403164131642316433164431645316463164731648316493165031651316523165331654316553165631657316583165931660316613166231663316643166531666316673166831669316703167131672316733167431675316763167731678316793168031681316823168331684316853168631687316883168931690316913169231693316943169531696316973169831699317003170131702317033170431705317063170731708317093171031711317123171331714317153171631717317183171931720317213172231723317243172531726317273172831729317303173131732317333173431735317363173731738317393174031741317423174331744317453174631747317483174931750317513175231753317543175531756317573175831759317603176131762317633176431765317663176731768317693177031771317723177331774317753177631777317783177931780317813178231783317843178531786317873178831789317903179131792317933179431795317963179731798317993180031801318023180331804318053180631807318083180931810318113181231813318143181531816318173181831819318203182131822318233182431825318263182731828318293183031831318323183331834318353183631837318383183931840318413184231843318443184531846318473184831849318503185131852318533185431855318563185731858318593186031861318623186331864318653186631867318683186931870318713187231873318743187531876318773187831879318803188131882318833188431885318863188731888318893189031891318923189331894318953189631897318983189931900319013190231903319043190531906319073190831909319103191131912319133191431915319163191731918319193192031921319223192331924319253192631927319283192931930319313193231933319343193531936319373193831939319403194131942319433194431945319463194731948319493195031951319523195331954319553195631957319583195931960319613196231963319643196531966319673196831969319703197131972319733197431975319763197731978319793198031981319823198331984319853198631987319883198931990319913199231993319943199531996319973199831999320003200132002320033200432005320063200732008320093201032011320123201332014320153201632017320183201932020320213202232023320243202532026320273202832029320303203132032320333203432035320363203732038320393204032041320423204332044320453204632047320483204932050320513205232053320543205532056320573205832059320603206132062320633206432065320663206732068320693207032071320723207332074320753207632077320783207932080320813208232083320843208532086320873208832089320903209132092320933209432095320963209732098320993210032101321023210332104321053210632107321083210932110321113211232113321143211532116321173211832119321203212132122321233212432125321263212732128321293213032131321323213332134321353213632137321383213932140321413214232143321443214532146321473214832149321503215132152321533215432155321563215732158321593216032161321623216332164321653216632167321683216932170321713217232173321743217532176321773217832179321803218132182321833218432185321863218732188321893219032191321923219332194321953219632197321983219932200322013220232203322043220532206322073220832209322103221132212322133221432215322163221732218322193222032221322223222332224322253222632227322283222932230322313223232233322343223532236322373223832239322403224132242322433224432245322463224732248322493225032251322523225332254322553225632257322583225932260322613226232263322643226532266322673226832269322703227132272322733227432275322763227732278322793228032281322823228332284322853228632287322883228932290322913229232293322943229532296322973229832299323003230132302323033230432305323063230732308323093231032311323123231332314323153231632317323183231932320323213232232323323243232532326323273232832329323303233132332323333233432335323363233732338323393234032341323423234332344323453234632347323483234932350323513235232353323543235532356323573235832359323603236132362323633236432365323663236732368323693237032371323723237332374323753237632377323783237932380323813238232383323843238532386323873238832389323903239132392323933239432395323963239732398323993240032401324023240332404324053240632407324083240932410324113241232413324143241532416324173241832419324203242132422324233242432425324263242732428324293243032431324323243332434324353243632437324383243932440324413244232443324443244532446324473244832449324503245132452324533245432455324563245732458324593246032461324623246332464324653246632467324683246932470324713247232473324743247532476324773247832479324803248132482324833248432485324863248732488324893249032491324923249332494324953249632497324983249932500325013250232503325043250532506325073250832509325103251132512325133251432515325163251732518325193252032521325223252332524325253252632527325283252932530325313253232533325343253532536325373253832539325403254132542325433254432545325463254732548325493255032551325523255332554325553255632557325583255932560325613256232563325643256532566325673256832569325703257132572325733257432575325763257732578325793258032581325823258332584325853258632587325883258932590325913259232593325943259532596325973259832599326003260132602326033260432605326063260732608326093261032611326123261332614326153261632617326183261932620326213262232623326243262532626326273262832629326303263132632326333263432635326363263732638326393264032641326423264332644326453264632647326483264932650326513265232653326543265532656326573265832659326603266132662326633266432665326663266732668326693267032671326723267332674326753267632677326783267932680326813268232683326843268532686326873268832689326903269132692326933269432695326963269732698326993270032701327023270332704327053270632707327083270932710327113271232713327143271532716327173271832719327203272132722327233272432725327263272732728327293273032731327323273332734327353273632737327383273932740327413274232743327443274532746327473274832749327503275132752327533275432755327563275732758327593276032761327623276332764327653276632767327683276932770327713277232773327743277532776327773277832779327803278132782327833278432785327863278732788327893279032791327923279332794327953279632797327983279932800328013280232803328043280532806328073280832809328103281132812328133281432815328163281732818328193282032821328223282332824328253282632827328283282932830328313283232833328343283532836328373283832839328403284132842328433284432845328463284732848328493285032851328523285332854328553285632857328583285932860328613286232863328643286532866328673286832869328703287132872328733287432875328763287732878328793288032881328823288332884328853288632887328883288932890328913289232893328943289532896328973289832899329003290132902329033290432905329063290732908329093291032911329123291332914329153291632917329183291932920329213292232923329243292532926329273292832929329303293132932329333293432935329363293732938329393294032941329423294332944329453294632947329483294932950329513295232953329543295532956329573295832959329603296132962329633296432965329663296732968329693297032971329723297332974329753297632977329783297932980329813298232983329843298532986329873298832989329903299132992329933299432995329963299732998329993300033001330023300333004330053300633007330083300933010330113301233013330143301533016330173301833019330203302133022330233302433025330263302733028330293303033031330323303333034330353303633037330383303933040330413304233043330443304533046330473304833049330503305133052330533305433055330563305733058330593306033061330623306333064330653306633067330683306933070330713307233073330743307533076330773307833079330803308133082330833308433085330863308733088330893309033091330923309333094330953309633097330983309933100331013310233103331043310533106331073310833109331103311133112331133311433115331163311733118331193312033121331223312333124331253312633127331283312933130331313313233133331343313533136331373313833139331403314133142331433314433145331463314733148331493315033151331523315333154331553315633157331583315933160331613316233163331643316533166331673316833169331703317133172331733317433175331763317733178331793318033181331823318333184331853318633187331883318933190331913319233193331943319533196331973319833199332003320133202332033320433205332063320733208332093321033211332123321333214332153321633217332183321933220332213322233223332243322533226332273322833229332303323133232332333323433235332363323733238332393324033241332423324333244332453324633247332483324933250332513325233253332543325533256332573325833259332603326133262332633326433265332663326733268332693327033271332723327333274332753327633277332783327933280332813328233283332843328533286332873328833289332903329133292332933329433295332963329733298332993330033301333023330333304333053330633307333083330933310333113331233313333143331533316333173331833319333203332133322333233332433325333263332733328333293333033331333323333333334333353333633337333383333933340333413334233343333443334533346333473334833349333503335133352333533335433355333563335733358333593336033361333623336333364333653336633367333683336933370333713337233373333743337533376333773337833379333803338133382333833338433385333863338733388333893339033391333923339333394333953339633397333983339933400334013340233403334043340533406334073340833409334103341133412334133341433415334163341733418334193342033421334223342333424334253342633427334283342933430334313343233433334343343533436334373343833439334403344133442334433344433445334463344733448334493345033451334523345333454334553345633457334583345933460334613346233463334643346533466334673346833469334703347133472334733347433475334763347733478334793348033481334823348333484334853348633487334883348933490334913349233493334943349533496334973349833499335003350133502335033350433505335063350733508335093351033511335123351333514335153351633517335183351933520335213352233523335243352533526335273352833529335303353133532335333353433535335363353733538335393354033541335423354333544335453354633547335483354933550335513355233553335543355533556335573355833559335603356133562335633356433565335663356733568335693357033571335723357333574335753357633577335783357933580335813358233583335843358533586335873358833589335903359133592335933359433595335963359733598335993360033601336023360333604336053360633607336083360933610336113361233613336143361533616336173361833619336203362133622336233362433625336263362733628336293363033631336323363333634336353363633637336383363933640336413364233643336443364533646336473364833649336503365133652336533365433655336563365733658336593366033661336623366333664336653366633667336683366933670336713367233673336743367533676336773367833679336803368133682336833368433685336863368733688336893369033691336923369333694336953369633697336983369933700337013370233703337043370533706337073370833709337103371133712337133371433715337163371733718337193372033721337223372333724337253372633727337283372933730337313373233733337343373533736337373373833739337403374133742337433374433745337463374733748337493375033751337523375333754337553375633757337583375933760337613376233763337643376533766337673376833769337703377133772337733377433775337763377733778337793378033781337823378333784337853378633787337883378933790337913379233793337943379533796337973379833799338003380133802338033380433805338063380733808338093381033811338123381333814338153381633817338183381933820338213382233823338243382533826338273382833829338303383133832338333383433835338363383733838338393384033841338423384333844338453384633847338483384933850338513385233853338543385533856338573385833859338603386133862338633386433865338663386733868338693387033871338723387333874338753387633877338783387933880338813388233883338843388533886338873388833889338903389133892338933389433895338963389733898338993390033901339023390333904339053390633907339083390933910339113391233913339143391533916339173391833919339203392133922339233392433925339263392733928339293393033931339323393333934339353393633937339383393933940339413394233943339443394533946339473394833949339503395133952339533395433955339563395733958339593396033961339623396333964339653396633967339683396933970339713397233973339743397533976339773397833979339803398133982339833398433985339863398733988339893399033991339923399333994339953399633997339983399934000340013400234003340043400534006340073400834009340103401134012340133401434015340163401734018340193402034021340223402334024340253402634027340283402934030340313403234033340343403534036340373403834039340403404134042340433404434045340463404734048340493405034051340523405334054340553405634057340583405934060340613406234063340643406534066340673406834069340703407134072340733407434075340763407734078340793408034081340823408334084340853408634087340883408934090340913409234093340943409534096340973409834099341003410134102341033410434105341063410734108341093411034111341123411334114341153411634117341183411934120341213412234123341243412534126341273412834129341303413134132341333413434135341363413734138341393414034141341423414334144341453414634147341483414934150341513415234153341543415534156341573415834159341603416134162341633416434165341663416734168341693417034171341723417334174341753417634177341783417934180341813418234183341843418534186341873418834189341903419134192341933419434195341963419734198341993420034201342023420334204342053420634207342083420934210342113421234213342143421534216342173421834219342203422134222342233422434225342263422734228342293423034231342323423334234342353423634237342383423934240342413424234243342443424534246342473424834249342503425134252342533425434255342563425734258342593426034261342623426334264342653426634267342683426934270342713427234273342743427534276342773427834279342803428134282342833428434285342863428734288342893429034291342923429334294342953429634297342983429934300343013430234303343043430534306343073430834309343103431134312343133431434315343163431734318343193432034321343223432334324343253432634327343283432934330343313433234333343343433534336343373433834339343403434134342343433434434345343463434734348343493435034351343523435334354343553435634357343583435934360343613436234363343643436534366343673436834369343703437134372343733437434375343763437734378343793438034381343823438334384343853438634387343883438934390343913439234393343943439534396343973439834399344003440134402344033440434405344063440734408344093441034411344123441334414344153441634417344183441934420344213442234423344243442534426344273442834429344303443134432344333443434435344363443734438344393444034441344423444334444344453444634447344483444934450344513445234453344543445534456344573445834459344603446134462344633446434465344663446734468344693447034471344723447334474344753447634477344783447934480344813448234483344843448534486344873448834489344903449134492344933449434495344963449734498344993450034501345023450334504345053450634507345083450934510345113451234513345143451534516345173451834519345203452134522345233452434525345263452734528345293453034531345323453334534345353453634537345383453934540345413454234543345443454534546345473454834549345503455134552345533455434555345563455734558345593456034561345623456334564345653456634567345683456934570345713457234573345743457534576345773457834579345803458134582345833458434585345863458734588345893459034591345923459334594345953459634597345983459934600346013460234603346043460534606346073460834609346103461134612346133461434615346163461734618346193462034621346223462334624346253462634627346283462934630346313463234633346343463534636346373463834639346403464134642346433464434645346463464734648346493465034651346523465334654346553465634657346583465934660346613466234663346643466534666346673466834669346703467134672346733467434675346763467734678346793468034681346823468334684346853468634687346883468934690346913469234693346943469534696346973469834699347003470134702347033470434705347063470734708347093471034711347123471334714347153471634717347183471934720347213472234723347243472534726347273472834729347303473134732347333473434735347363473734738347393474034741347423474334744347453474634747347483474934750347513475234753347543475534756347573475834759347603476134762347633476434765347663476734768347693477034771347723477334774347753477634777347783477934780347813478234783347843478534786347873478834789347903479134792347933479434795347963479734798347993480034801348023480334804348053480634807348083480934810348113481234813348143481534816348173481834819348203482134822348233482434825348263482734828348293483034831348323483334834348353483634837348383483934840348413484234843348443484534846348473484834849348503485134852348533485434855348563485734858348593486034861348623486334864348653486634867348683486934870348713487234873348743487534876348773487834879348803488134882348833488434885348863488734888348893489034891348923489334894348953489634897348983489934900349013490234903349043490534906349073490834909349103491134912349133491434915349163491734918349193492034921349223492334924349253492634927349283492934930349313493234933349343493534936349373493834939349403494134942349433494434945349463494734948349493495034951349523495334954349553495634957349583495934960349613496234963349643496534966349673496834969349703497134972349733497434975349763497734978349793498034981349823498334984349853498634987349883498934990349913499234993349943499534996349973499834999350003500135002350033500435005350063500735008350093501035011350123501335014350153501635017350183501935020350213502235023350243502535026350273502835029350303503135032350333503435035350363503735038350393504035041350423504335044350453504635047350483504935050350513505235053350543505535056350573505835059350603506135062350633506435065350663506735068350693507035071350723507335074350753507635077350783507935080350813508235083350843508535086350873508835089350903509135092350933509435095350963509735098350993510035101351023510335104351053510635107351083510935110351113511235113351143511535116351173511835119351203512135122351233512435125351263512735128351293513035131351323513335134351353513635137351383513935140351413514235143351443514535146351473514835149351503515135152351533515435155351563515735158351593516035161351623516335164351653516635167351683516935170351713517235173351743517535176351773517835179351803518135182351833518435185351863518735188351893519035191351923519335194351953519635197351983519935200352013520235203352043520535206352073520835209352103521135212352133521435215352163521735218352193522035221352223522335224352253522635227352283522935230352313523235233352343523535236352373523835239352403524135242352433524435245352463524735248352493525035251352523525335254352553525635257352583525935260352613526235263352643526535266352673526835269352703527135272352733527435275352763527735278352793528035281352823528335284352853528635287352883528935290352913529235293352943529535296352973529835299353003530135302353033530435305353063530735308353093531035311353123531335314353153531635317353183531935320353213532235323353243532535326353273532835329353303533135332353333533435335353363533735338353393534035341353423534335344353453534635347353483534935350353513535235353353543535535356353573535835359353603536135362353633536435365353663536735368353693537035371353723537335374353753537635377353783537935380353813538235383353843538535386353873538835389353903539135392353933539435395353963539735398353993540035401354023540335404354053540635407354083540935410354113541235413354143541535416354173541835419354203542135422354233542435425354263542735428354293543035431354323543335434354353543635437354383543935440354413544235443354443544535446354473544835449354503545135452354533545435455354563545735458354593546035461354623546335464354653546635467354683546935470354713547235473354743547535476354773547835479354803548135482354833548435485354863548735488354893549035491354923549335494354953549635497354983549935500355013550235503355043550535506355073550835509355103551135512355133551435515355163551735518355193552035521355223552335524355253552635527355283552935530355313553235533355343553535536355373553835539355403554135542355433554435545355463554735548355493555035551355523555335554355553555635557355583555935560355613556235563355643556535566355673556835569355703557135572355733557435575355763557735578355793558035581355823558335584355853558635587355883558935590355913559235593355943559535596355973559835599356003560135602356033560435605356063560735608356093561035611356123561335614356153561635617356183561935620356213562235623356243562535626356273562835629356303563135632356333563435635356363563735638356393564035641356423564335644356453564635647356483564935650356513565235653356543565535656356573565835659356603566135662356633566435665356663566735668356693567035671356723567335674356753567635677356783567935680356813568235683356843568535686356873568835689356903569135692356933569435695356963569735698356993570035701357023570335704357053570635707357083570935710357113571235713357143571535716357173571835719357203572135722357233572435725357263572735728357293573035731357323573335734357353573635737357383573935740357413574235743357443574535746357473574835749357503575135752357533575435755357563575735758357593576035761357623576335764357653576635767357683576935770357713577235773357743577535776357773577835779357803578135782357833578435785357863578735788357893579035791357923579335794357953579635797357983579935800358013580235803358043580535806358073580835809358103581135812358133581435815358163581735818358193582035821358223582335824358253582635827358283582935830358313583235833358343583535836358373583835839358403584135842358433584435845358463584735848358493585035851358523585335854358553585635857358583585935860358613586235863358643586535866358673586835869358703587135872358733587435875358763587735878358793588035881358823588335884358853588635887358883588935890358913589235893358943589535896358973589835899359003590135902359033590435905359063590735908359093591035911359123591335914359153591635917359183591935920359213592235923359243592535926359273592835929359303593135932359333593435935359363593735938359393594035941359423594335944359453594635947359483594935950359513595235953359543595535956359573595835959359603596135962359633596435965359663596735968359693597035971359723597335974359753597635977359783597935980359813598235983359843598535986359873598835989359903599135992359933599435995359963599735998359993600036001360023600336004360053600636007360083600936010360113601236013360143601536016360173601836019360203602136022360233602436025360263602736028360293603036031360323603336034360353603636037360383603936040360413604236043360443604536046360473604836049360503605136052360533605436055360563605736058360593606036061360623606336064360653606636067360683606936070360713607236073360743607536076360773607836079360803608136082360833608436085360863608736088
  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/beyondtrustworkloadcredentials/" class="md-nav__link">
  407. <span class="md-ellipsis">
  408. BeyondTrust Workload Credentials
  409. </span>
  410. </a>
  411. </li>
  412. <li class="md-nav__item">
  413. <a href="../generator/password/" class="md-nav__link">
  414. <span class="md-ellipsis">
  415. Password
  416. </span>
  417. </a>
  418. </li>
  419. <li class="md-nav__item">
  420. <a href="../generator/fake/" class="md-nav__link">
  421. <span class="md-ellipsis">
  422. Fake
  423. </span>
  424. </a>
  425. </li>
  426. <li class="md-nav__item">
  427. <a href="../generator/webhook/" class="md-nav__link">
  428. <span class="md-ellipsis">
  429. Webhook
  430. </span>
  431. </a>
  432. </li>
  433. <li class="md-nav__item">
  434. <a href="../generator/github/" class="md-nav__link">
  435. <span class="md-ellipsis">
  436. Github
  437. </span>
  438. </a>
  439. </li>
  440. <li class="md-nav__item">
  441. <a href="../generator/gitlab/" class="md-nav__link">
  442. <span class="md-ellipsis">
  443. Gitlab
  444. </span>
  445. </a>
  446. </li>
  447. <li class="md-nav__item">
  448. <a href="../generator/uuid/" class="md-nav__link">
  449. <span class="md-ellipsis">
  450. UUID
  451. </span>
  452. </a>
  453. </li>
  454. <li class="md-nav__item">
  455. <a href="../generator/mfa/" class="md-nav__link">
  456. <span class="md-ellipsis">
  457. MFA
  458. </span>
  459. </a>
  460. </li>
  461. <li class="md-nav__item">
  462. <a href="../generator/sshkey/" class="md-nav__link">
  463. <span class="md-ellipsis">
  464. SSHKey
  465. </span>
  466. </a>
  467. </li>
  468. </ul>
  469. </nav>
  470. </li>
  471. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  472. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4" checked>
  473. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  474. <span class="md-ellipsis">
  475. Reference Docs
  476. </span>
  477. <span class="md-nav__icon md-icon"></span>
  478. </label>
  479. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="true">
  480. <label class="md-nav__title" for="__nav_2_4">
  481. <span class="md-nav__icon md-icon"></span>
  482. Reference Docs
  483. </label>
  484. <ul class="md-nav__list" data-md-scrollfix>
  485. <li class="md-nav__item md-nav__item--active">
  486. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  487. <a href="./" class="md-nav__link md-nav__link--active">
  488. <span class="md-ellipsis">
  489. API specification
  490. </span>
  491. </a>
  492. </li>
  493. <li class="md-nav__item">
  494. <a href="../controller-options/" class="md-nav__link">
  495. <span class="md-ellipsis">
  496. Controller Options
  497. </span>
  498. </a>
  499. </li>
  500. <li class="md-nav__item">
  501. <a href="../metrics/" class="md-nav__link">
  502. <span class="md-ellipsis">
  503. Metrics
  504. </span>
  505. </a>
  506. </li>
  507. <li class="md-nav__item">
  508. <a href="../selectable-fields/" class="md-nav__link">
  509. <span class="md-ellipsis">
  510. Selectable Fields
  511. </span>
  512. </a>
  513. </li>
  514. </ul>
  515. </nav>
  516. </li>
  517. </ul>
  518. </nav>
  519. </li>
  520. <li class="md-nav__item md-nav__item--nested">
  521. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  522. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  523. <span class="md-ellipsis">
  524. Guides
  525. </span>
  526. <span class="md-nav__icon md-icon"></span>
  527. </label>
  528. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  529. <label class="md-nav__title" for="__nav_3">
  530. <span class="md-nav__icon md-icon"></span>
  531. Guides
  532. </label>
  533. <ul class="md-nav__list" data-md-scrollfix>
  534. <li class="md-nav__item">
  535. <a href="../../guides/introduction/" class="md-nav__link">
  536. <span class="md-ellipsis">
  537. Introduction
  538. </span>
  539. </a>
  540. </li>
  541. <li class="md-nav__item md-nav__item--nested">
  542. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  543. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  544. <span class="md-ellipsis">
  545. External Secrets
  546. </span>
  547. <span class="md-nav__icon md-icon"></span>
  548. </label>
  549. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  550. <label class="md-nav__title" for="__nav_3_2">
  551. <span class="md-nav__icon md-icon"></span>
  552. External Secrets
  553. </label>
  554. <ul class="md-nav__list" data-md-scrollfix>
  555. <li class="md-nav__item">
  556. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  557. <span class="md-ellipsis">
  558. Extract structured data
  559. </span>
  560. </a>
  561. </li>
  562. <li class="md-nav__item">
  563. <a href="../../guides/getallsecrets/" class="md-nav__link">
  564. <span class="md-ellipsis">
  565. Find Secrets by Name or Metadata
  566. </span>
  567. </a>
  568. </li>
  569. <li class="md-nav__item">
  570. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  571. <span class="md-ellipsis">
  572. Rewriting Keys
  573. </span>
  574. </a>
  575. </li>
  576. <li class="md-nav__item md-nav__item--nested">
  577. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  578. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  579. <span class="md-ellipsis">
  580. Advanced Templating
  581. </span>
  582. <span class="md-nav__icon md-icon"></span>
  583. </label>
  584. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  585. <label class="md-nav__title" for="__nav_3_2_4">
  586. <span class="md-nav__icon md-icon"></span>
  587. Advanced Templating
  588. </label>
  589. <ul class="md-nav__list" data-md-scrollfix>
  590. <li class="md-nav__item">
  591. <a href="../../guides/templating/" class="md-nav__link">
  592. <span class="md-ellipsis">
  593. v2
  594. </span>
  595. </a>
  596. </li>
  597. <li class="md-nav__item">
  598. <a href="../../guides/templating-v1/" class="md-nav__link">
  599. <span class="md-ellipsis">
  600. v1
  601. </span>
  602. </a>
  603. </li>
  604. </ul>
  605. </nav>
  606. </li>
  607. <li class="md-nav__item">
  608. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  609. <span class="md-ellipsis">
  610. Kubernetes Secret Types
  611. </span>
  612. </a>
  613. </li>
  614. <li class="md-nav__item">
  615. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  616. <span class="md-ellipsis">
  617. Lifecycle: ownership & deletion
  618. </span>
  619. </a>
  620. </li>
  621. <li class="md-nav__item">
  622. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  623. <span class="md-ellipsis">
  624. Decoding Strategies
  625. </span>
  626. </a>
  627. </li>
  628. <li class="md-nav__item">
  629. <a href="../../guides/controller-class/" class="md-nav__link">
  630. <span class="md-ellipsis">
  631. Controller Classes
  632. </span>
  633. </a>
  634. </li>
  635. </ul>
  636. </nav>
  637. </li>
  638. <li class="md-nav__item">
  639. <a href="../../guides/targeting-custom-resources/" class="md-nav__link">
  640. <span class="md-ellipsis">
  641. Targeting Custom Resources
  642. </span>
  643. </a>
  644. </li>
  645. <li class="md-nav__item">
  646. <a href="../../guides/generator/" class="md-nav__link">
  647. <span class="md-ellipsis">
  648. Generators
  649. </span>
  650. </a>
  651. </li>
  652. <li class="md-nav__item">
  653. <a href="../../guides/pushsecrets/" class="md-nav__link">
  654. <span class="md-ellipsis">
  655. Push Secrets
  656. </span>
  657. </a>
  658. </li>
  659. <li class="md-nav__item md-nav__item--nested">
  660. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_6" >
  661. <label class="md-nav__link" for="__nav_3_6" id="__nav_3_6_label" tabindex="0">
  662. <span class="md-ellipsis">
  663. Operations
  664. </span>
  665. <span class="md-nav__icon md-icon"></span>
  666. </label>
  667. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_6_label" aria-expanded="false">
  668. <label class="md-nav__title" for="__nav_3_6">
  669. <span class="md-nav__icon md-icon"></span>
  670. Operations
  671. </label>
  672. <ul class="md-nav__list" data-md-scrollfix>
  673. <li class="md-nav__item">
  674. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  675. <span class="md-ellipsis">
  676. Multi Tenancy
  677. </span>
  678. </a>
  679. </li>
  680. <li class="md-nav__item">
  681. <a href="../../guides/security-best-practices/" class="md-nav__link">
  682. <span class="md-ellipsis">
  683. Security Best Practices
  684. </span>
  685. </a>
  686. </li>
  687. <li class="md-nav__item">
  688. <a href="../../guides/threat-model/" class="md-nav__link">
  689. <span class="md-ellipsis">
  690. Threat Model
  691. </span>
  692. </a>
  693. </li>
  694. <li class="md-nav__item">
  695. <a href="../../guides/v1beta1/" class="md-nav__link">
  696. <span class="md-ellipsis">
  697. Upgrading to v1beta1
  698. </span>
  699. </a>
  700. </li>
  701. <li class="md-nav__item">
  702. <a href="../../guides/using-latest-image/" class="md-nav__link">
  703. <span class="md-ellipsis">
  704. Using Latest Image
  705. </span>
  706. </a>
  707. </li>
  708. <li class="md-nav__item">
  709. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  710. <span class="md-ellipsis">
  711. Disable Cluster Features
  712. </span>
  713. </a>
  714. </li>
  715. </ul>
  716. </nav>
  717. </li>
  718. <li class="md-nav__item md-nav__item--nested">
  719. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_7" >
  720. <label class="md-nav__link" for="__nav_3_7" id="__nav_3_7_label" tabindex="0">
  721. <span class="md-ellipsis">
  722. Tooling
  723. </span>
  724. <span class="md-nav__icon md-icon"></span>
  725. </label>
  726. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_7_label" aria-expanded="false">
  727. <label class="md-nav__title" for="__nav_3_7">
  728. <span class="md-nav__icon md-icon"></span>
  729. Tooling
  730. </label>
  731. <ul class="md-nav__list" data-md-scrollfix>
  732. <li class="md-nav__item">
  733. <a href="../../guides/using-esoctl-tool/" class="md-nav__link">
  734. <span class="md-ellipsis">
  735. Using the esoctl tool
  736. </span>
  737. </a>
  738. </li>
  739. </ul>
  740. </nav>
  741. </li>
  742. </ul>
  743. </nav>
  744. </li>
  745. <li class="md-nav__item md-nav__item--nested">
  746. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
  747. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  748. <span class="md-ellipsis">
  749. Provider
  750. </span>
  751. <span class="md-nav__icon md-icon"></span>
  752. </label>
  753. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  754. <label class="md-nav__title" for="__nav_4">
  755. <span class="md-nav__icon md-icon"></span>
  756. Provider
  757. </label>
  758. <ul class="md-nav__list" data-md-scrollfix>
  759. <li class="md-nav__item">
  760. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  761. <span class="md-ellipsis">
  762. AWS Secrets Manager
  763. </span>
  764. </a>
  765. </li>
  766. <li class="md-nav__item">
  767. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  768. <span class="md-ellipsis">
  769. AWS Parameter Store
  770. </span>
  771. </a>
  772. </li>
  773. <li class="md-nav__item">
  774. <a href="../../provider/aws-certificate-manager/" class="md-nav__link">
  775. <span class="md-ellipsis">
  776. AWS Certificate Manager
  777. </span>
  778. </a>
  779. </li>
  780. <li class="md-nav__item">
  781. <a href="../../provider/aws-access/" class="md-nav__link">
  782. <span class="md-ellipsis">
  783. AWS Access
  784. </span>
  785. </a>
  786. </li>
  787. <li class="md-nav__item">
  788. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  789. <span class="md-ellipsis">
  790. Azure Key Vault
  791. </span>
  792. </a>
  793. </li>
  794. <li class="md-nav__item">
  795. <a href="../../provider/barbican/" class="md-nav__link">
  796. <span class="md-ellipsis">
  797. Barbican
  798. </span>
  799. </a>
  800. </li>
  801. <li class="md-nav__item">
  802. <a href="../../provider/beyondtrust/" class="md-nav__link">
  803. <span class="md-ellipsis">
  804. BeyondTrust
  805. </span>
  806. </a>
  807. </li>
  808. <li class="md-nav__item">
  809. <a href="../../provider/beyondtrustworkloadcredentials/" class="md-nav__link">
  810. <span class="md-ellipsis">
  811. BeyondTrust Workload Credentials
  812. </span>
  813. </a>
  814. </li>
  815. <li class="md-nav__item">
  816. <a href="../../provider/bitwarden-secrets-manager/" class="md-nav__link">
  817. <span class="md-ellipsis">
  818. Bitwarden Secrets Manager
  819. </span>
  820. </a>
  821. </li>
  822. <li class="md-nav__item">
  823. <a href="../../provider/chef/" class="md-nav__link">
  824. <span class="md-ellipsis">
  825. Chef
  826. </span>
  827. </a>
  828. </li>
  829. <li class="md-nav__item">
  830. <a href="../../provider/cloudru/" class="md-nav__link">
  831. <span class="md-ellipsis">
  832. Cloud.ru Secret Manager
  833. </span>
  834. </a>
  835. </li>
  836. <li class="md-nav__item">
  837. <a href="../../provider/conjur/" class="md-nav__link">
  838. <span class="md-ellipsis">
  839. CyberArk Conjur
  840. </span>
  841. </a>
  842. </li>
  843. <li class="md-nav__item">
  844. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  845. <span class="md-ellipsis">
  846. Google Cloud Secret Manager
  847. </span>
  848. </a>
  849. </li>
  850. <li class="md-nav__item">
  851. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  852. <span class="md-ellipsis">
  853. HashiCorp Vault
  854. </span>
  855. </a>
  856. </li>
  857. <li class="md-nav__item">
  858. <a href="../../provider/kubernetes/" class="md-nav__link">
  859. <span class="md-ellipsis">
  860. Kubernetes
  861. </span>
  862. </a>
  863. </li>
  864. <li class="md-nav__item">
  865. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  866. <span class="md-ellipsis">
  867. IBM Secrets Manager
  868. </span>
  869. </a>
  870. </li>
  871. <li class="md-nav__item">
  872. <a href="../../provider/akeyless/" class="md-nav__link">
  873. <span class="md-ellipsis">
  874. Akeyless
  875. </span>
  876. </a>
  877. </li>
  878. <li class="md-nav__item">
  879. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  880. <span class="md-ellipsis">
  881. Yandex Certificate Manager
  882. </span>
  883. </a>
  884. </li>
  885. <li class="md-nav__item">
  886. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  887. <span class="md-ellipsis">
  888. Yandex Lockbox
  889. </span>
  890. </a>
  891. </li>
  892. <li class="md-nav__item">
  893. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  894. <span class="md-ellipsis">
  895. GitLab Variables
  896. </span>
  897. </a>
  898. </li>
  899. <li class="md-nav__item">
  900. <a href="../../provider/github/" class="md-nav__link">
  901. <span class="md-ellipsis">
  902. Github Actions Secrets
  903. </span>
  904. </a>
  905. </li>
  906. <li class="md-nav__item">
  907. <a href="../../provider/oracle-vault/" class="md-nav__link">
  908. <span class="md-ellipsis">
  909. Oracle Vault
  910. </span>
  911. </a>
  912. </li>
  913. <li class="md-nav__item">
  914. <a href="../../provider/ovhcloud/" class="md-nav__link">
  915. <span class="md-ellipsis">
  916. OVHcloud
  917. </span>
  918. </a>
  919. </li>
  920. <li class="md-nav__item">
  921. <a href="../../provider/1password-automation/" class="md-nav__link">
  922. <span class="md-ellipsis">
  923. 1Password Connect Server
  924. </span>
  925. </a>
  926. </li>
  927. <li class="md-nav__item">
  928. <a href="../../provider/1password-sdk/" class="md-nav__link">
  929. <span class="md-ellipsis">
  930. 1Password SDK
  931. </span>
  932. </a>
  933. </li>
  934. <li class="md-nav__item">
  935. <a href="../../provider/webhook/" class="md-nav__link">
  936. <span class="md-ellipsis">
  937. Webhook
  938. </span>
  939. </a>
  940. </li>
  941. <li class="md-nav__item">
  942. <a href="../../provider/fake/" class="md-nav__link">
  943. <span class="md-ellipsis">
  944. Fake
  945. </span>
  946. </a>
  947. </li>
  948. <li class="md-nav__item">
  949. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  950. <span class="md-ellipsis">
  951. senhasegura DevOps Secrets Management (DSM)
  952. </span>
  953. </a>
  954. </li>
  955. <li class="md-nav__item">
  956. <a href="../../provider/doppler/" class="md-nav__link">
  957. <span class="md-ellipsis">
  958. Doppler
  959. </span>
  960. </a>
  961. </li>
  962. <li class="md-nav__item">
  963. <a href="../../provider/keeper-security/" class="md-nav__link">
  964. <span class="md-ellipsis">
  965. Keeper Security
  966. </span>
  967. </a>
  968. </li>
  969. <li class="md-nav__item">
  970. <a href="../../provider/cloak/" class="md-nav__link">
  971. <span class="md-ellipsis">
  972. Cloak End 2 End Encrypted Secrets
  973. </span>
  974. </a>
  975. </li>
  976. <li class="md-nav__item">
  977. <a href="../../provider/scaleway/" class="md-nav__link">
  978. <span class="md-ellipsis">
  979. Scaleway
  980. </span>
  981. </a>
  982. </li>
  983. <li class="md-nav__item">
  984. <a href="../../provider/delinea/" class="md-nav__link">
  985. <span class="md-ellipsis">
  986. Delinea
  987. </span>
  988. </a>
  989. </li>
  990. <li class="md-nav__item">
  991. <a href="../../provider/secretserver/" class="md-nav__link">
  992. <span class="md-ellipsis">
  993. Secret Server
  994. </span>
  995. </a>
  996. </li>
  997. <li class="md-nav__item">
  998. <a href="../../provider/passbolt/" class="md-nav__link">
  999. <span class="md-ellipsis">
  1000. Passbolt
  1001. </span>
  1002. </a>
  1003. </li>
  1004. <li class="md-nav__item">
  1005. <a href="../../provider/pulumi/" class="md-nav__link">
  1006. <span class="md-ellipsis">
  1007. Pulumi ESC
  1008. </span>
  1009. </a>
  1010. </li>
  1011. <li class="md-nav__item">
  1012. <a href="../../provider/onboardbase/" class="md-nav__link">
  1013. <span class="md-ellipsis">
  1014. Onboardbase
  1015. </span>
  1016. </a>
  1017. </li>
  1018. <li class="md-nav__item">
  1019. <a href="../../provider-passworddepot/" class="md-nav__link">
  1020. <span class="md-ellipsis">
  1021. Password Depot
  1022. </span>
  1023. </a>
  1024. </li>
  1025. <li class="md-nav__item">
  1026. <a href="../../provider/fortanix/" class="md-nav__link">
  1027. <span class="md-ellipsis">
  1028. Fortanix
  1029. </span>
  1030. </a>
  1031. </li>
  1032. <li class="md-nav__item">
  1033. <a href="../../provider/infisical/" class="md-nav__link">
  1034. <span class="md-ellipsis">
  1035. Infisical
  1036. </span>
  1037. </a>
  1038. </li>
  1039. <li class="md-nav__item">
  1040. <a href="../../provider/previder/" class="md-nav__link">
  1041. <span class="md-ellipsis">
  1042. Previder
  1043. </span>
  1044. </a>
  1045. </li>
  1046. <li class="md-nav__item">
  1047. <a href="../../provider/openbao/" class="md-nav__link">
  1048. <span class="md-ellipsis">
  1049. OpenBao
  1050. </span>
  1051. </a>
  1052. </li>
  1053. <li class="md-nav__item">
  1054. <a href="../../provider/volcengine/" class="md-nav__link">
  1055. <span class="md-ellipsis">
  1056. Volcengine
  1057. </span>
  1058. </a>
  1059. </li>
  1060. <li class="md-nav__item">
  1061. <a href="../../provider/ngrok/" class="md-nav__link">
  1062. <span class="md-ellipsis">
  1063. ngrok
  1064. </span>
  1065. </a>
  1066. </li>
  1067. <li class="md-nav__item">
  1068. <a href="../../provider/devolutions-server/" class="md-nav__link">
  1069. <span class="md-ellipsis">
  1070. Devolutions Server
  1071. </span>
  1072. </a>
  1073. </li>
  1074. <li class="md-nav__item">
  1075. <a href="../../provider/nebius-mysterybox/" class="md-nav__link">
  1076. <span class="md-ellipsis">
  1077. Nebius MysteryBox
  1078. </span>
  1079. </a>
  1080. </li>
  1081. </ul>
  1082. </nav>
  1083. </li>
  1084. <li class="md-nav__item md-nav__item--nested">
  1085. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  1086. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  1087. <span class="md-ellipsis">
  1088. Examples
  1089. </span>
  1090. <span class="md-nav__icon md-icon"></span>
  1091. </label>
  1092. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  1093. <label class="md-nav__title" for="__nav_5">
  1094. <span class="md-nav__icon md-icon"></span>
  1095. Examples
  1096. </label>
  1097. <ul class="md-nav__list" data-md-scrollfix>
  1098. <li class="md-nav__item">
  1099. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  1100. <span class="md-ellipsis">
  1101. FluxCD
  1102. </span>
  1103. </a>
  1104. </li>
  1105. <li class="md-nav__item">
  1106. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  1107. <span class="md-ellipsis">
  1108. Anchore Engine
  1109. </span>
  1110. </a>
  1111. </li>
  1112. <li class="md-nav__item">
  1113. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  1114. <span class="md-ellipsis">
  1115. Jenkins
  1116. </span>
  1117. </a>
  1118. </li>
  1119. <li class="md-nav__item">
  1120. <a href="../../examples/bitwarden/" class="md-nav__link">
  1121. <span class="md-ellipsis">
  1122. Bitwarden
  1123. </span>
  1124. </a>
  1125. </li>
  1126. </ul>
  1127. </nav>
  1128. </li>
  1129. <li class="md-nav__item md-nav__item--nested">
  1130. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  1131. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  1132. <span class="md-ellipsis">
  1133. Community
  1134. </span>
  1135. <span class="md-nav__icon md-icon"></span>
  1136. </label>
  1137. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  1138. <label class="md-nav__title" for="__nav_6">
  1139. <span class="md-nav__icon md-icon"></span>
  1140. Community
  1141. </label>
  1142. <ul class="md-nav__list" data-md-scrollfix>
  1143. <li class="md-nav__item md-nav__item--nested">
  1144. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  1145. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  1146. <span class="md-ellipsis">
  1147. Contributing
  1148. </span>
  1149. <span class="md-nav__icon md-icon"></span>
  1150. </label>
  1151. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  1152. <label class="md-nav__title" for="__nav_6_1">
  1153. <span class="md-nav__icon md-icon"></span>
  1154. Contributing
  1155. </label>
  1156. <ul class="md-nav__list" data-md-scrollfix>
  1157. <li class="md-nav__item">
  1158. <a href="../../contributing/devguide/" class="md-nav__link">
  1159. <span class="md-ellipsis">
  1160. Developer guide
  1161. </span>
  1162. </a>
  1163. </li>
  1164. <li class="md-nav__item">
  1165. <a href="../../contributing/process/" class="md-nav__link">
  1166. <span class="md-ellipsis">
  1167. Contributing Process
  1168. </span>
  1169. </a>
  1170. </li>
  1171. <li class="md-nav__item">
  1172. <a href="../../contributing/release/" class="md-nav__link">
  1173. <span class="md-ellipsis">
  1174. Release Process
  1175. </span>
  1176. </a>
  1177. </li>
  1178. <li class="md-nav__item">
  1179. <a href="../../contributing/coc/" class="md-nav__link">
  1180. <span class="md-ellipsis">
  1181. Code of Conduct
  1182. </span>
  1183. </a>
  1184. </li>
  1185. <li class="md-nav__item">
  1186. <a href="../../contributing/calendar/" class="md-nav__link">
  1187. <span class="md-ellipsis">
  1188. Community meetings calendar
  1189. </span>
  1190. </a>
  1191. </li>
  1192. <li class="md-nav__item">
  1193. <a href="../../contributing/roadmap/" class="md-nav__link">
  1194. <span class="md-ellipsis">
  1195. Roadmap
  1196. </span>
  1197. </a>
  1198. </li>
  1199. <li class="md-nav__item">
  1200. <a href="../../contributing/burnout-mitigation/" class="md-nav__link">
  1201. <span class="md-ellipsis">
  1202. Burnout Prevention
  1203. </span>
  1204. </a>
  1205. </li>
  1206. <li class="md-nav__item">
  1207. <a href="../../contributing/llm-policy/" class="md-nav__link">
  1208. <span class="md-ellipsis">
  1209. LLM Policy
  1210. </span>
  1211. </a>
  1212. </li>
  1213. </ul>
  1214. </nav>
  1215. </li>
  1216. <li class="md-nav__item md-nav__item--nested">
  1217. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1218. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1219. <span class="md-ellipsis">
  1220. External Resources
  1221. </span>
  1222. <span class="md-nav__icon md-icon"></span>
  1223. </label>
  1224. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1225. <label class="md-nav__title" for="__nav_6_2">
  1226. <span class="md-nav__icon md-icon"></span>
  1227. External Resources
  1228. </label>
  1229. <ul class="md-nav__list" data-md-scrollfix>
  1230. <li class="md-nav__item">
  1231. <a href="../../eso-talks/" class="md-nav__link">
  1232. <span class="md-ellipsis">
  1233. Talks
  1234. </span>
  1235. </a>
  1236. </li>
  1237. <li class="md-nav__item">
  1238. <a href="../../eso-demos/" class="md-nav__link">
  1239. <span class="md-ellipsis">
  1240. Demos
  1241. </span>
  1242. </a>
  1243. </li>
  1244. <li class="md-nav__item">
  1245. <a href="../../eso-blogs/" class="md-nav__link">
  1246. <span class="md-ellipsis">
  1247. Blogs
  1248. </span>
  1249. </a>
  1250. </li>
  1251. <li class="md-nav__item">
  1252. <a href="../../eso-tools/" class="md-nav__link">
  1253. <span class="md-ellipsis">
  1254. Tools
  1255. </span>
  1256. </a>
  1257. </li>
  1258. </ul>
  1259. </nav>
  1260. </li>
  1261. </ul>
  1262. </nav>
  1263. </li>
  1264. </ul>
  1265. </nav>
  1266. </div>
  1267. </div>
  1268. </div>
  1269. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1270. <div class="md-sidebar__scrollwrap">
  1271. <div class="md-sidebar__inner">
  1272. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1273. </nav>
  1274. </div>
  1275. </div>
  1276. </div>
  1277. <div class="md-content" data-md-component="content">
  1278. <article class="md-content__inner md-typeset">
  1279. <h1>API specification</h1>
  1280. <p>Packages:</p>
  1281. <ul>
  1282. <li>
  1283. <a href="#external-secrets.io%2fv1">external-secrets.io/v1</a>
  1284. </li>
  1285. <li>
  1286. <a href="#external-secrets.io%2fv1alpha1">external-secrets.io/v1alpha1</a>
  1287. </li>
  1288. <li>
  1289. <a href="#external-secrets.io%2fv1beta1">external-secrets.io/v1beta1</a>
  1290. </li>
  1291. <li>
  1292. <a href="#generators.external-secrets.io%2fv1alpha1">generators.external-secrets.io/v1alpha1</a>
  1293. </li>
  1294. </ul>
  1295. <h2 id="external-secrets.io/v1">external-secrets.io/v1</h2>
  1296. <p>
  1297. <p>Package v1 contains resources for external-secrets</p>
  1298. </p>
  1299. <p>Resource Types:</p>
  1300. <ul></ul>
  1301. <h3 id="external-secrets.io/v1.AWSAuth">AWSAuth
  1302. </h3>
  1303. <p>
  1304. (<em>Appears on:</em>
  1305. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1306. </p>
  1307. <p>
  1308. <p>AWSAuth tells the controller how to do authentication with aws.
  1309. Only one of secretRef or jwt can be specified.
  1310. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  1311. </p>
  1312. <table>
  1313. <thead>
  1314. <tr>
  1315. <th>Field</th>
  1316. <th>Description</th>
  1317. </tr>
  1318. </thead>
  1319. <tbody>
  1320. <tr>
  1321. <td>
  1322. <code>secretRef</code></br>
  1323. <em>
  1324. <a href="#external-secrets.io/v1.AWSAuthSecretRef">
  1325. AWSAuthSecretRef
  1326. </a>
  1327. </em>
  1328. </td>
  1329. <td>
  1330. <em>(Optional)</em>
  1331. </td>
  1332. </tr>
  1333. <tr>
  1334. <td>
  1335. <code>jwt</code></br>
  1336. <em>
  1337. <a href="#external-secrets.io/v1.AWSJWTAuth">
  1338. AWSJWTAuth
  1339. </a>
  1340. </em>
  1341. </td>
  1342. <td>
  1343. <em>(Optional)</em>
  1344. </td>
  1345. </tr>
  1346. </tbody>
  1347. </table>
  1348. <h3 id="external-secrets.io/v1.AWSAuthSecretRef">AWSAuthSecretRef
  1349. </h3>
  1350. <p>
  1351. (<em>Appears on:</em>
  1352. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1353. </p>
  1354. <p>
  1355. <p>AWSAuthSecretRef holds secret references for AWS credentials
  1356. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  1357. </p>
  1358. <table>
  1359. <thead>
  1360. <tr>
  1361. <th>Field</th>
  1362. <th>Description</th>
  1363. </tr>
  1364. </thead>
  1365. <tbody>
  1366. <tr>
  1367. <td>
  1368. <code>accessKeyIDSecretRef</code></br>
  1369. <em>
  1370. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1371. External Secrets meta/v1.SecretKeySelector
  1372. </a>
  1373. </em>
  1374. </td>
  1375. <td>
  1376. <p>The AccessKeyID is used for authentication</p>
  1377. </td>
  1378. </tr>
  1379. <tr>
  1380. <td>
  1381. <code>secretAccessKeySecretRef</code></br>
  1382. <em>
  1383. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1384. External Secrets meta/v1.SecretKeySelector
  1385. </a>
  1386. </em>
  1387. </td>
  1388. <td>
  1389. <p>The SecretAccessKey is used for authentication</p>
  1390. </td>
  1391. </tr>
  1392. <tr>
  1393. <td>
  1394. <code>sessionTokenSecretRef</code></br>
  1395. <em>
  1396. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1397. External Secrets meta/v1.SecretKeySelector
  1398. </a>
  1399. </em>
  1400. </td>
  1401. <td>
  1402. <p>The SessionToken used for authentication
  1403. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  1404. 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>
  1405. </td>
  1406. </tr>
  1407. </tbody>
  1408. </table>
  1409. <h3 id="external-secrets.io/v1.AWSJWTAuth">AWSJWTAuth
  1410. </h3>
  1411. <p>
  1412. (<em>Appears on:</em>
  1413. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1414. </p>
  1415. <p>
  1416. <p>AWSJWTAuth stores reference to Authenticate against AWS using service account tokens.</p>
  1417. </p>
  1418. <table>
  1419. <thead>
  1420. <tr>
  1421. <th>Field</th>
  1422. <th>Description</th>
  1423. </tr>
  1424. </thead>
  1425. <tbody>
  1426. <tr>
  1427. <td>
  1428. <code>serviceAccountRef</code></br>
  1429. <em>
  1430. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1431. External Secrets meta/v1.ServiceAccountSelector
  1432. </a>
  1433. </em>
  1434. </td>
  1435. <td>
  1436. </td>
  1437. </tr>
  1438. </tbody>
  1439. </table>
  1440. <h3 id="external-secrets.io/v1.AWSProvider">AWSProvider
  1441. </h3>
  1442. <p>
  1443. (<em>Appears on:</em>
  1444. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1445. </p>
  1446. <p>
  1447. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  1448. </p>
  1449. <table>
  1450. <thead>
  1451. <tr>
  1452. <th>Field</th>
  1453. <th>Description</th>
  1454. </tr>
  1455. </thead>
  1456. <tbody>
  1457. <tr>
  1458. <td>
  1459. <code>service</code></br>
  1460. <em>
  1461. <a href="#external-secrets.io/v1.AWSServiceType">
  1462. AWSServiceType
  1463. </a>
  1464. </em>
  1465. </td>
  1466. <td>
  1467. <p>Service defines which service should be used to fetch the secrets</p>
  1468. </td>
  1469. </tr>
  1470. <tr>
  1471. <td>
  1472. <code>auth</code></br>
  1473. <em>
  1474. <a href="#external-secrets.io/v1.AWSAuth">
  1475. AWSAuth
  1476. </a>
  1477. </em>
  1478. </td>
  1479. <td>
  1480. <em>(Optional)</em>
  1481. <p>Auth defines the information necessary to authenticate against AWS
  1482. if not set aws sdk will infer credentials from your environment
  1483. 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>
  1484. </td>
  1485. </tr>
  1486. <tr>
  1487. <td>
  1488. <code>role</code></br>
  1489. <em>
  1490. string
  1491. </em>
  1492. </td>
  1493. <td>
  1494. <em>(Optional)</em>
  1495. <p>Role is a Role ARN which the provider will assume</p>
  1496. </td>
  1497. </tr>
  1498. <tr>
  1499. <td>
  1500. <code>region</code></br>
  1501. <em>
  1502. string
  1503. </em>
  1504. </td>
  1505. <td>
  1506. <p>AWS Region to be used for the provider</p>
  1507. </td>
  1508. </tr>
  1509. <tr>
  1510. <td>
  1511. <code>additionalRoles</code></br>
  1512. <em>
  1513. []string
  1514. </em>
  1515. </td>
  1516. <td>
  1517. <em>(Optional)</em>
  1518. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  1519. </td>
  1520. </tr>
  1521. <tr>
  1522. <td>
  1523. <code>externalID</code></br>
  1524. <em>
  1525. string
  1526. </em>
  1527. </td>
  1528. <td>
  1529. <p>AWS External ID set on assumed IAM roles</p>
  1530. </td>
  1531. </tr>
  1532. <tr>
  1533. <td>
  1534. <code>sessionTags</code></br>
  1535. <em>
  1536. <a href="#external-secrets.io/v1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag">
  1537. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag
  1538. </a>
  1539. </em>
  1540. </td>
  1541. <td>
  1542. <em>(Optional)</em>
  1543. <p>AWS STS assume role session tags</p>
  1544. </td>
  1545. </tr>
  1546. <tr>
  1547. <td>
  1548. <code>secretsManager</code></br>
  1549. <em>
  1550. <a href="#external-secrets.io/v1.SecretsManager">
  1551. SecretsManager
  1552. </a>
  1553. </em>
  1554. </td>
  1555. <td>
  1556. <em>(Optional)</em>
  1557. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  1558. </td>
  1559. </tr>
  1560. <tr>
  1561. <td>
  1562. <code>transitiveTagKeys</code></br>
  1563. <em>
  1564. []string
  1565. </em>
  1566. </td>
  1567. <td>
  1568. <em>(Optional)</em>
  1569. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  1570. </td>
  1571. </tr>
  1572. <tr>
  1573. <td>
  1574. <code>sessionTagsPolicy</code></br>
  1575. <em>
  1576. <a href="#external-secrets.io/v1.SessionTagsPolicy">
  1577. SessionTagsPolicy
  1578. </a>
  1579. </em>
  1580. </td>
  1581. <td>
  1582. <em>(Optional)</em>
  1583. <p>SessionTagsPolicy controls whether and how STS session tags are added when assuming roles.
  1584. None (default): no tags are added.
  1585. Simple: automatically adds esoNamespace (from the ExternalSecret), esoStoreName, and esoStoreKind tags.
  1586. Custom: adds esoNamespace, esoStoreName, and esoStoreKind plus any tags defined in CustomSessionTags.
  1587. Note: the IAM role must have sts:TagSession permission when using Simple or Custom.</p>
  1588. </td>
  1589. </tr>
  1590. <tr>
  1591. <td>
  1592. <code>customSessionTags</code></br>
  1593. <em>
  1594. map[string]string
  1595. </em>
  1596. </td>
  1597. <td>
  1598. <em>(Optional)</em>
  1599. <p>CustomSessionTags defines additional STS session tags to include when SessionTagsPolicy is Custom.
  1600. These are merged with the automatically injected esoNamespace, esoStoreName, and esoStoreKind tags.</p>
  1601. </td>
  1602. </tr>
  1603. <tr>
  1604. <td>
  1605. <code>prefix</code></br>
  1606. <em>
  1607. string
  1608. </em>
  1609. </td>
  1610. <td>
  1611. <em>(Optional)</em>
  1612. <p>Prefix adds a prefix to all retrieved values.</p>
  1613. </td>
  1614. </tr>
  1615. </tbody>
  1616. </table>
  1617. <h3 id="external-secrets.io/v1.AWSServiceType">AWSServiceType
  1618. (<code>string</code> alias)</p></h3>
  1619. <p>
  1620. (<em>Appears on:</em>
  1621. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1622. </p>
  1623. <p>
  1624. <p>AWSServiceType is a enum that defines the service/API that is used to fetch the secrets.</p>
  1625. </p>
  1626. <table>
  1627. <thead>
  1628. <tr>
  1629. <th>Value</th>
  1630. <th>Description</th>
  1631. </tr>
  1632. </thead>
  1633. <tbody><tr><td><p>&#34;CertificateManager&#34;</p></td>
  1634. <td><p>AWSServiceCertificateManager is the AWS Certificate Manager service.
  1635. see: <a href="https://docs.aws.amazon.com/acm/latest/userguide/acm-overview.html">https://docs.aws.amazon.com/acm/latest/userguide/acm-overview.html</a></p>
  1636. </td>
  1637. </tr><tr><td><p>&#34;ParameterStore&#34;</p></td>
  1638. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  1639. 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>
  1640. </td>
  1641. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  1642. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  1643. 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>
  1644. </td>
  1645. </tr></tbody>
  1646. </table>
  1647. <h3 id="external-secrets.io/v1.AkeylessAuth">AkeylessAuth
  1648. </h3>
  1649. <p>
  1650. (<em>Appears on:</em>
  1651. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>)
  1652. </p>
  1653. <p>
  1654. <p>AkeylessAuth configures how the operator authenticates with Akeyless.</p>
  1655. </p>
  1656. <table>
  1657. <thead>
  1658. <tr>
  1659. <th>Field</th>
  1660. <th>Description</th>
  1661. </tr>
  1662. </thead>
  1663. <tbody>
  1664. <tr>
  1665. <td>
  1666. <code>secretRef</code></br>
  1667. <em>
  1668. <a href="#external-secrets.io/v1.AkeylessAuthSecretRef">
  1669. AkeylessAuthSecretRef
  1670. </a>
  1671. </em>
  1672. </td>
  1673. <td>
  1674. <em>(Optional)</em>
  1675. <p>Reference to a Secret that contains the details
  1676. to authenticate with Akeyless.</p>
  1677. </td>
  1678. </tr>
  1679. <tr>
  1680. <td>
  1681. <code>kubernetesAuth</code></br>
  1682. <em>
  1683. <a href="#external-secrets.io/v1.AkeylessKubernetesAuth">
  1684. AkeylessKubernetesAuth
  1685. </a>
  1686. </em>
  1687. </td>
  1688. <td>
  1689. <em>(Optional)</em>
  1690. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  1691. token stored in the named Secret resource.</p>
  1692. </td>
  1693. </tr>
  1694. <tr>
  1695. <td>
  1696. <code>serviceAccountRef</code></br>
  1697. <em>
  1698. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1699. External Secrets meta/v1.ServiceAccountSelector
  1700. </a>
  1701. </em>
  1702. </td>
  1703. <td>
  1704. <em>(Optional)</em>
  1705. <p>ServiceAccountRef specifies a Kubernetes ServiceAccount used for azure_ad
  1706. authentication on AKS Workload Identity. The operator obtains a federated
  1707. identity token from this ServiceAccount via the TokenRequest API instead
  1708. of using the ESO controller pod identity. Ignored for other access types.</p>
  1709. </td>
  1710. </tr>
  1711. </tbody>
  1712. </table>
  1713. <h3 id="external-secrets.io/v1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  1714. </h3>
  1715. <p>
  1716. (<em>Appears on:</em>
  1717. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1718. </p>
  1719. <p>
  1720. <p>AkeylessAuthSecretRef references a Secret that contains the details
  1721. to authenticate with Akeyless.
  1722. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  1723. </p>
  1724. <table>
  1725. <thead>
  1726. <tr>
  1727. <th>Field</th>
  1728. <th>Description</th>
  1729. </tr>
  1730. </thead>
  1731. <tbody>
  1732. <tr>
  1733. <td>
  1734. <code>accessID</code></br>
  1735. <em>
  1736. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1737. External Secrets meta/v1.SecretKeySelector
  1738. </a>
  1739. </em>
  1740. </td>
  1741. <td>
  1742. <p>The SecretAccessID is used for authentication</p>
  1743. </td>
  1744. </tr>
  1745. <tr>
  1746. <td>
  1747. <code>accessType</code></br>
  1748. <em>
  1749. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1750. External Secrets meta/v1.SecretKeySelector
  1751. </a>
  1752. </em>
  1753. </td>
  1754. <td>
  1755. </td>
  1756. </tr>
  1757. <tr>
  1758. <td>
  1759. <code>accessTypeParam</code></br>
  1760. <em>
  1761. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1762. External Secrets meta/v1.SecretKeySelector
  1763. </a>
  1764. </em>
  1765. </td>
  1766. <td>
  1767. </td>
  1768. </tr>
  1769. </tbody>
  1770. </table>
  1771. <h3 id="external-secrets.io/v1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  1772. </h3>
  1773. <p>
  1774. (<em>Appears on:</em>
  1775. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1776. </p>
  1777. <p>
  1778. <p>AkeylessKubernetesAuth configures Kubernetes authentication with Akeyless.
  1779. It authenticates with Kubernetes ServiceAccount token stored.</p>
  1780. </p>
  1781. <table>
  1782. <thead>
  1783. <tr>
  1784. <th>Field</th>
  1785. <th>Description</th>
  1786. </tr>
  1787. </thead>
  1788. <tbody>
  1789. <tr>
  1790. <td>
  1791. <code>accessID</code></br>
  1792. <em>
  1793. string
  1794. </em>
  1795. </td>
  1796. <td>
  1797. <p>the Akeyless Kubernetes auth-method access-id</p>
  1798. </td>
  1799. </tr>
  1800. <tr>
  1801. <td>
  1802. <code>k8sConfName</code></br>
  1803. <em>
  1804. string
  1805. </em>
  1806. </td>
  1807. <td>
  1808. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  1809. </td>
  1810. </tr>
  1811. <tr>
  1812. <td>
  1813. <code>serviceAccountRef</code></br>
  1814. <em>
  1815. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1816. External Secrets meta/v1.ServiceAccountSelector
  1817. </a>
  1818. </em>
  1819. </td>
  1820. <td>
  1821. <em>(Optional)</em>
  1822. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  1823. If the service account is specified, the service account secret token JWT will be used
  1824. for authenticating with Akeyless. If the service account selector is not supplied,
  1825. the secretRef will be used instead.</p>
  1826. </td>
  1827. </tr>
  1828. <tr>
  1829. <td>
  1830. <code>secretRef</code></br>
  1831. <em>
  1832. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1833. External Secrets meta/v1.SecretKeySelector
  1834. </a>
  1835. </em>
  1836. </td>
  1837. <td>
  1838. <em>(Optional)</em>
  1839. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  1840. for authenticating with Akeyless. If a name is specified without a key,
  1841. <code>token</code> is the default. If one is not specified, the one bound to
  1842. the controller will be used.</p>
  1843. </td>
  1844. </tr>
  1845. </tbody>
  1846. </table>
  1847. <h3 id="external-secrets.io/v1.AkeylessProvider">AkeylessProvider
  1848. </h3>
  1849. <p>
  1850. (<em>Appears on:</em>
  1851. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1852. </p>
  1853. <p>
  1854. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  1855. </p>
  1856. <table>
  1857. <thead>
  1858. <tr>
  1859. <th>Field</th>
  1860. <th>Description</th>
  1861. </tr>
  1862. </thead>
  1863. <tbody>
  1864. <tr>
  1865. <td>
  1866. <code>akeylessGWApiURL</code></br>
  1867. <em>
  1868. string
  1869. </em>
  1870. </td>
  1871. <td>
  1872. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  1873. </td>
  1874. </tr>
  1875. <tr>
  1876. <td>
  1877. <code>ignoreCache</code></br>
  1878. <em>
  1879. bool
  1880. </em>
  1881. </td>
  1882. <td>
  1883. <em>(Optional)</em>
  1884. <p>IgnoreCache bypasses the Gateway cache for secret reads when true.
  1885. Only relevant when akeylessGWApiURL points to an Akeyless Gateway.</p>
  1886. </td>
  1887. </tr>
  1888. <tr>
  1889. <td>
  1890. <code>authSecretRef</code></br>
  1891. <em>
  1892. <a href="#external-secrets.io/v1.AkeylessAuth">
  1893. AkeylessAuth
  1894. </a>
  1895. </em>
  1896. </td>
  1897. <td>
  1898. <p>Auth configures how the operator authenticates with Akeyless.</p>
  1899. </td>
  1900. </tr>
  1901. <tr>
  1902. <td>
  1903. <code>caBundle</code></br>
  1904. <em>
  1905. []byte
  1906. </em>
  1907. </td>
  1908. <td>
  1909. <em>(Optional)</em>
  1910. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  1911. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  1912. are used to validate the TLS connection.</p>
  1913. </td>
  1914. </tr>
  1915. <tr>
  1916. <td>
  1917. <code>caProvider</code></br>
  1918. <em>
  1919. <a href="#external-secrets.io/v1.CAProvider">
  1920. CAProvider
  1921. </a>
  1922. </em>
  1923. </td>
  1924. <td>
  1925. <em>(Optional)</em>
  1926. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  1927. </td>
  1928. </tr>
  1929. </tbody>
  1930. </table>
  1931. <h3 id="external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol
  1932. </h3>
  1933. <p>
  1934. (<em>Appears on:</em>
  1935. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  1936. </p>
  1937. <p>
  1938. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  1939. </p>
  1940. <table>
  1941. <thead>
  1942. <tr>
  1943. <th>Field</th>
  1944. <th>Description</th>
  1945. </tr>
  1946. </thead>
  1947. <tbody>
  1948. <tr>
  1949. <td>
  1950. <code>ntlm</code></br>
  1951. <em>
  1952. <a href="#external-secrets.io/v1.NTLMProtocol">
  1953. NTLMProtocol
  1954. </a>
  1955. </em>
  1956. </td>
  1957. <td>
  1958. <em>(Optional)</em>
  1959. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  1960. </td>
  1961. </tr>
  1962. </tbody>
  1963. </table>
  1964. <h3 id="external-secrets.io/v1.AwsAuthCredentials">AwsAuthCredentials
  1965. </h3>
  1966. <p>
  1967. (<em>Appears on:</em>
  1968. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1969. </p>
  1970. <p>
  1971. <p>AwsAuthCredentials represents the credentials for AWS authentication.</p>
  1972. </p>
  1973. <table>
  1974. <thead>
  1975. <tr>
  1976. <th>Field</th>
  1977. <th>Description</th>
  1978. </tr>
  1979. </thead>
  1980. <tbody>
  1981. <tr>
  1982. <td>
  1983. <code>identityId</code></br>
  1984. <em>
  1985. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1986. External Secrets meta/v1.SecretKeySelector
  1987. </a>
  1988. </em>
  1989. </td>
  1990. <td>
  1991. </td>
  1992. </tr>
  1993. </tbody>
  1994. </table>
  1995. <h3 id="external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig
  1996. </h3>
  1997. <p>
  1998. (<em>Appears on:</em>
  1999. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  2000. </p>
  2001. <p>
  2002. <p>AwsCredentialsConfig holds the region and the Secret reference which contains the AWS credentials.</p>
  2003. </p>
  2004. <table>
  2005. <thead>
  2006. <tr>
  2007. <th>Field</th>
  2008. <th>Description</th>
  2009. </tr>
  2010. </thead>
  2011. <tbody>
  2012. <tr>
  2013. <td>
  2014. <code>region</code></br>
  2015. <em>
  2016. string
  2017. </em>
  2018. </td>
  2019. <td>
  2020. <p>region is for configuring the AWS region to be used.</p>
  2021. </td>
  2022. </tr>
  2023. <tr>
  2024. <td>
  2025. <code>awsCredentialsSecretRef</code></br>
  2026. <em>
  2027. <a href="#external-secrets.io/v1.SecretReference">
  2028. SecretReference
  2029. </a>
  2030. </em>
  2031. </td>
  2032. <td>
  2033. <p>awsCredentialsSecretRef is the reference to the secret which holds the AWS credentials.
  2034. Secret should be created with below names for keys
  2035. - aws_access_key_id: Access Key ID, which is the unique identifier for the AWS account or the IAM user.
  2036. - aws_secret_access_key: Secret Access Key, which is used to authenticate requests made to AWS services.
  2037. - aws_session_token: Session Token, is the short-lived token to authenticate requests made to AWS services.</p>
  2038. </td>
  2039. </tr>
  2040. </tbody>
  2041. </table>
  2042. <h3 id="external-secrets.io/v1.AzureAuthCredentials">AzureAuthCredentials
  2043. </h3>
  2044. <p>
  2045. (<em>Appears on:</em>
  2046. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  2047. </p>
  2048. <p>
  2049. <p>AzureAuthCredentials represents the credentials for Azure authentication.</p>
  2050. </p>
  2051. <table>
  2052. <thead>
  2053. <tr>
  2054. <th>Field</th>
  2055. <th>Description</th>
  2056. </tr>
  2057. </thead>
  2058. <tbody>
  2059. <tr>
  2060. <td>
  2061. <code>identityId</code></br>
  2062. <em>
  2063. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2064. External Secrets meta/v1.SecretKeySelector
  2065. </a>
  2066. </em>
  2067. </td>
  2068. <td>
  2069. </td>
  2070. </tr>
  2071. <tr>
  2072. <td>
  2073. <code>resource</code></br>
  2074. <em>
  2075. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2076. External Secrets meta/v1.SecretKeySelector
  2077. </a>
  2078. </em>
  2079. </td>
  2080. <td>
  2081. <em>(Optional)</em>
  2082. </td>
  2083. </tr>
  2084. </tbody>
  2085. </table>
  2086. <h3 id="external-secrets.io/v1.AzureAuthType">AzureAuthType
  2087. (<code>string</code> alias)</p></h3>
  2088. <p>
  2089. (<em>Appears on:</em>
  2090. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2091. </p>
  2092. <p>
  2093. <p>AzureAuthType describes how to authenticate to the Azure Keyvault
  2094. Only one of the following auth types may be specified.
  2095. If none of the following auth type is specified, the default one
  2096. is ServicePrincipal.</p>
  2097. </p>
  2098. <table>
  2099. <thead>
  2100. <tr>
  2101. <th>Value</th>
  2102. <th>Description</th>
  2103. </tr>
  2104. </thead>
  2105. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  2106. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  2107. </td>
  2108. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  2109. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  2110. </td>
  2111. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  2112. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  2113. </td>
  2114. </tr></tbody>
  2115. </table>
  2116. <h3 id="external-secrets.io/v1.AzureCustomCloudConfig">AzureCustomCloudConfig
  2117. </h3>
  2118. <p>
  2119. (<em>Appears on:</em>
  2120. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2121. </p>
  2122. <p>
  2123. <p>AzureCustomCloudConfig specifies custom cloud configuration for private Azure environments
  2124. IMPORTANT: Custom cloud configuration is ONLY supported when UseAzureSDK is true.
  2125. The legacy go-autorest SDK does not support custom cloud endpoints.</p>
  2126. </p>
  2127. <table>
  2128. <thead>
  2129. <tr>
  2130. <th>Field</th>
  2131. <th>Description</th>
  2132. </tr>
  2133. </thead>
  2134. <tbody>
  2135. <tr>
  2136. <td>
  2137. <code>activeDirectoryEndpoint</code></br>
  2138. <em>
  2139. string
  2140. </em>
  2141. </td>
  2142. <td>
  2143. <p>ActiveDirectoryEndpoint is the AAD endpoint for authentication
  2144. Required when using custom cloud configuration</p>
  2145. </td>
  2146. </tr>
  2147. <tr>
  2148. <td>
  2149. <code>keyVaultEndpoint</code></br>
  2150. <em>
  2151. string
  2152. </em>
  2153. </td>
  2154. <td>
  2155. <em>(Optional)</em>
  2156. <p>KeyVaultEndpoint is the Key Vault service endpoint</p>
  2157. </td>
  2158. </tr>
  2159. <tr>
  2160. <td>
  2161. <code>keyVaultDNSSuffix</code></br>
  2162. <em>
  2163. string
  2164. </em>
  2165. </td>
  2166. <td>
  2167. <em>(Optional)</em>
  2168. <p>KeyVaultDNSSuffix is the DNS suffix for Key Vault URLs</p>
  2169. </td>
  2170. </tr>
  2171. <tr>
  2172. <td>
  2173. <code>resourceManagerEndpoint</code></br>
  2174. <em>
  2175. string
  2176. </em>
  2177. </td>
  2178. <td>
  2179. <em>(Optional)</em>
  2180. <p>ResourceManagerEndpoint is the Azure Resource Manager endpoint</p>
  2181. </td>
  2182. </tr>
  2183. </tbody>
  2184. </table>
  2185. <h3 id="external-secrets.io/v1.AzureEnvironmentType">AzureEnvironmentType
  2186. (<code>string</code> alias)</p></h3>
  2187. <p>
  2188. (<em>Appears on:</em>
  2189. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>,
  2190. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  2191. </p>
  2192. <p>
  2193. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  2194. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  2195. 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>
  2196. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud</p>
  2197. </p>
  2198. <table>
  2199. <thead>
  2200. <tr>
  2201. <th>Value</th>
  2202. <th>Description</th>
  2203. </tr>
  2204. </thead>
  2205. <tbody><tr><td><p>&#34;AzureStackCloud&#34;</p></td>
  2206. <td></td>
  2207. </tr><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  2208. <td></td>
  2209. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  2210. <td></td>
  2211. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  2212. <td></td>
  2213. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  2214. <td></td>
  2215. </tr></tbody>
  2216. </table>
  2217. <h3 id="external-secrets.io/v1.AzureKVAuth">AzureKVAuth
  2218. </h3>
  2219. <p>
  2220. (<em>Appears on:</em>
  2221. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2222. </p>
  2223. <p>
  2224. <p>AzureKVAuth is the configuration used to authenticate with Azure.</p>
  2225. </p>
  2226. <table>
  2227. <thead>
  2228. <tr>
  2229. <th>Field</th>
  2230. <th>Description</th>
  2231. </tr>
  2232. </thead>
  2233. <tbody>
  2234. <tr>
  2235. <td>
  2236. <code>clientId</code></br>
  2237. <em>
  2238. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2239. External Secrets meta/v1.SecretKeySelector
  2240. </a>
  2241. </em>
  2242. </td>
  2243. <td>
  2244. <em>(Optional)</em>
  2245. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  2246. </td>
  2247. </tr>
  2248. <tr>
  2249. <td>
  2250. <code>tenantId</code></br>
  2251. <em>
  2252. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2253. External Secrets meta/v1.SecretKeySelector
  2254. </a>
  2255. </em>
  2256. </td>
  2257. <td>
  2258. <em>(Optional)</em>
  2259. <p>The Azure tenantId of the managed identity used for authentication.</p>
  2260. </td>
  2261. </tr>
  2262. <tr>
  2263. <td>
  2264. <code>clientSecret</code></br>
  2265. <em>
  2266. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2267. External Secrets meta/v1.SecretKeySelector
  2268. </a>
  2269. </em>
  2270. </td>
  2271. <td>
  2272. <em>(Optional)</em>
  2273. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  2274. </td>
  2275. </tr>
  2276. <tr>
  2277. <td>
  2278. <code>clientCertificate</code></br>
  2279. <em>
  2280. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2281. External Secrets meta/v1.SecretKeySelector
  2282. </a>
  2283. </em>
  2284. </td>
  2285. <td>
  2286. <em>(Optional)</em>
  2287. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  2288. </td>
  2289. </tr>
  2290. </tbody>
  2291. </table>
  2292. <h3 id="external-secrets.io/v1.AzureKVProvider">AzureKVProvider
  2293. </h3>
  2294. <p>
  2295. (<em>Appears on:</em>
  2296. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2297. </p>
  2298. <p>
  2299. <p>AzureKVProvider configures a store to sync secrets using Azure KV.</p>
  2300. </p>
  2301. <table>
  2302. <thead>
  2303. <tr>
  2304. <th>Field</th>
  2305. <th>Description</th>
  2306. </tr>
  2307. </thead>
  2308. <tbody>
  2309. <tr>
  2310. <td>
  2311. <code>authType</code></br>
  2312. <em>
  2313. <a href="#external-secrets.io/v1.AzureAuthType">
  2314. AzureAuthType
  2315. </a>
  2316. </em>
  2317. </td>
  2318. <td>
  2319. <em>(Optional)</em>
  2320. <p>Auth type defines how to authenticate to the keyvault service.
  2321. Valid values are:
  2322. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  2323. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)
  2324. - &ldquo;WorkloadIdentity&rdquo;: Using a Kubernetes ServiceAccount federated with Entra ID</p>
  2325. </td>
  2326. </tr>
  2327. <tr>
  2328. <td>
  2329. <code>vaultUrl</code></br>
  2330. <em>
  2331. string
  2332. </em>
  2333. </td>
  2334. <td>
  2335. <p>Vault Url from which the secrets to be fetched from.</p>
  2336. </td>
  2337. </tr>
  2338. <tr>
  2339. <td>
  2340. <code>tenantId</code></br>
  2341. <em>
  2342. string
  2343. </em>
  2344. </td>
  2345. <td>
  2346. <em>(Optional)</em>
  2347. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2348. </td>
  2349. </tr>
  2350. <tr>
  2351. <td>
  2352. <code>environmentType</code></br>
  2353. <em>
  2354. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  2355. AzureEnvironmentType
  2356. </a>
  2357. </em>
  2358. </td>
  2359. <td>
  2360. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  2361. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  2362. 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>
  2363. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud
  2364. Use AzureStackCloud when you need to configure custom Azure Stack Hub or Azure Stack Edge endpoints.</p>
  2365. </td>
  2366. </tr>
  2367. <tr>
  2368. <td>
  2369. <code>authSecretRef</code></br>
  2370. <em>
  2371. <a href="#external-secrets.io/v1.AzureKVAuth">
  2372. AzureKVAuth
  2373. </a>
  2374. </em>
  2375. </td>
  2376. <td>
  2377. <em>(Optional)</em>
  2378. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2379. </td>
  2380. </tr>
  2381. <tr>
  2382. <td>
  2383. <code>serviceAccountRef</code></br>
  2384. <em>
  2385. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  2386. External Secrets meta/v1.ServiceAccountSelector
  2387. </a>
  2388. </em>
  2389. </td>
  2390. <td>
  2391. <em>(Optional)</em>
  2392. <p>ServiceAccountRef specified the service account
  2393. that should be used when authenticating with WorkloadIdentity.</p>
  2394. </td>
  2395. </tr>
  2396. <tr>
  2397. <td>
  2398. <code>identityId</code></br>
  2399. <em>
  2400. string
  2401. </em>
  2402. </td>
  2403. <td>
  2404. <em>(Optional)</em>
  2405. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  2406. </td>
  2407. </tr>
  2408. <tr>
  2409. <td>
  2410. <code>useAzureSDK</code></br>
  2411. <em>
  2412. bool
  2413. </em>
  2414. </td>
  2415. <td>
  2416. <em>(Optional)</em>
  2417. <p>UseAzureSDK enables the use of the new Azure SDK for Go (azcore-based) instead of the legacy go-autorest SDK.
  2418. This is experimental and may have behavioral differences. Defaults to false (legacy SDK).</p>
  2419. </td>
  2420. </tr>
  2421. <tr>
  2422. <td>
  2423. <code>customCloudConfig</code></br>
  2424. <em>
  2425. <a href="#external-secrets.io/v1.AzureCustomCloudConfig">
  2426. AzureCustomCloudConfig
  2427. </a>
  2428. </em>
  2429. </td>
  2430. <td>
  2431. <em>(Optional)</em>
  2432. <p>CustomCloudConfig defines custom Azure endpoints for non-standard clouds.
  2433. Required when EnvironmentType is AzureStackCloud.
  2434. Optional for other environment types - useful for Azure China when using Workload Identity
  2435. with AKS, where the OIDC issuer (login.partner.microsoftonline.cn) differs from the
  2436. standard China Cloud endpoint (login.chinacloudapi.cn).
  2437. IMPORTANT: This feature REQUIRES UseAzureSDK to be set to true. Custom cloud
  2438. configuration is not supported with the legacy go-autorest SDK.</p>
  2439. </td>
  2440. </tr>
  2441. </tbody>
  2442. </table>
  2443. <h3 id="external-secrets.io/v1.BarbicanAuth">BarbicanAuth
  2444. </h3>
  2445. <p>
  2446. (<em>Appears on:</em>
  2447. <a href="#external-secrets.io/v1.BarbicanProvider">BarbicanProvider</a>)
  2448. </p>
  2449. <p>
  2450. <p>BarbicanAuth contains the authentication information for Barbican.</p>
  2451. </p>
  2452. <table>
  2453. <thead>
  2454. <tr>
  2455. <th>Field</th>
  2456. <th>Description</th>
  2457. </tr>
  2458. </thead>
  2459. <tbody>
  2460. <tr>
  2461. <td>
  2462. <code>username</code></br>
  2463. <em>
  2464. <a href="#external-secrets.io/v1.BarbicanProviderUsernameRef">
  2465. BarbicanProviderUsernameRef
  2466. </a>
  2467. </em>
  2468. </td>
  2469. <td>
  2470. </td>
  2471. </tr>
  2472. <tr>
  2473. <td>
  2474. <code>password</code></br>
  2475. <em>
  2476. <a href="#external-secrets.io/v1.BarbicanProviderPasswordRef">
  2477. BarbicanProviderPasswordRef
  2478. </a>
  2479. </em>
  2480. </td>
  2481. <td>
  2482. </td>
  2483. </tr>
  2484. </tbody>
  2485. </table>
  2486. <h3 id="external-secrets.io/v1.BarbicanProvider">BarbicanProvider
  2487. </h3>
  2488. <p>
  2489. (<em>Appears on:</em>
  2490. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2491. </p>
  2492. <p>
  2493. <p>BarbicanProvider setup a store to sync secrets with barbican.</p>
  2494. </p>
  2495. <table>
  2496. <thead>
  2497. <tr>
  2498. <th>Field</th>
  2499. <th>Description</th>
  2500. </tr>
  2501. </thead>
  2502. <tbody>
  2503. <tr>
  2504. <td>
  2505. <code>authURL</code></br>
  2506. <em>
  2507. string
  2508. </em>
  2509. </td>
  2510. <td>
  2511. </td>
  2512. </tr>
  2513. <tr>
  2514. <td>
  2515. <code>tenantName</code></br>
  2516. <em>
  2517. string
  2518. </em>
  2519. </td>
  2520. <td>
  2521. </td>
  2522. </tr>
  2523. <tr>
  2524. <td>
  2525. <code>domainName</code></br>
  2526. <em>
  2527. string
  2528. </em>
  2529. </td>
  2530. <td>
  2531. </td>
  2532. </tr>
  2533. <tr>
  2534. <td>
  2535. <code>region</code></br>
  2536. <em>
  2537. string
  2538. </em>
  2539. </td>
  2540. <td>
  2541. </td>
  2542. </tr>
  2543. <tr>
  2544. <td>
  2545. <code>auth</code></br>
  2546. <em>
  2547. <a href="#external-secrets.io/v1.BarbicanAuth">
  2548. BarbicanAuth
  2549. </a>
  2550. </em>
  2551. </td>
  2552. <td>
  2553. </td>
  2554. </tr>
  2555. </tbody>
  2556. </table>
  2557. <h3 id="external-secrets.io/v1.BarbicanProviderPasswordRef">BarbicanProviderPasswordRef
  2558. </h3>
  2559. <p>
  2560. (<em>Appears on:</em>
  2561. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2562. </p>
  2563. <p>
  2564. <p>BarbicanProviderPasswordRef defines a reference to a secret containing password for the Barbican provider.</p>
  2565. </p>
  2566. <table>
  2567. <thead>
  2568. <tr>
  2569. <th>Field</th>
  2570. <th>Description</th>
  2571. </tr>
  2572. </thead>
  2573. <tbody>
  2574. <tr>
  2575. <td>
  2576. <code>secretRef</code></br>
  2577. <em>
  2578. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2579. External Secrets meta/v1.SecretKeySelector
  2580. </a>
  2581. </em>
  2582. </td>
  2583. <td>
  2584. </td>
  2585. </tr>
  2586. </tbody>
  2587. </table>
  2588. <h3 id="external-secrets.io/v1.BarbicanProviderUsernameRef">BarbicanProviderUsernameRef
  2589. </h3>
  2590. <p>
  2591. (<em>Appears on:</em>
  2592. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2593. </p>
  2594. <p>
  2595. <p>BarbicanProviderUsernameRef defines a reference to a secret containing username for the Barbican provider.</p>
  2596. </p>
  2597. <table>
  2598. <thead>
  2599. <tr>
  2600. <th>Field</th>
  2601. <th>Description</th>
  2602. </tr>
  2603. </thead>
  2604. <tbody>
  2605. <tr>
  2606. <td>
  2607. <code>value</code></br>
  2608. <em>
  2609. string
  2610. </em>
  2611. </td>
  2612. <td>
  2613. </td>
  2614. </tr>
  2615. <tr>
  2616. <td>
  2617. <code>secretRef</code></br>
  2618. <em>
  2619. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2620. External Secrets meta/v1.SecretKeySelector
  2621. </a>
  2622. </em>
  2623. </td>
  2624. <td>
  2625. </td>
  2626. </tr>
  2627. </tbody>
  2628. </table>
  2629. <h3 id="external-secrets.io/v1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  2630. </h3>
  2631. <p>
  2632. (<em>Appears on:</em>
  2633. <a href="#external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth</a>)
  2634. </p>
  2635. <p>
  2636. <p>BeyondTrustProviderSecretRef references a value that can be specified directly or via a secret
  2637. for a BeyondTrustProvider.</p>
  2638. </p>
  2639. <table>
  2640. <thead>
  2641. <tr>
  2642. <th>Field</th>
  2643. <th>Description</th>
  2644. </tr>
  2645. </thead>
  2646. <tbody>
  2647. <tr>
  2648. <td>
  2649. <code>value</code></br>
  2650. <em>
  2651. string
  2652. </em>
  2653. </td>
  2654. <td>
  2655. <em>(Optional)</em>
  2656. <p>Value can be specified directly to set a value without using a secret.</p>
  2657. </td>
  2658. </tr>
  2659. <tr>
  2660. <td>
  2661. <code>secretRef</code></br>
  2662. <em>
  2663. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2664. External Secrets meta/v1.SecretKeySelector
  2665. </a>
  2666. </em>
  2667. </td>
  2668. <td>
  2669. <em>(Optional)</em>
  2670. <p>SecretRef references a key in a secret that will be used as value.</p>
  2671. </td>
  2672. </tr>
  2673. </tbody>
  2674. </table>
  2675. <h3 id="external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth
  2676. </h3>
  2677. <p>
  2678. (<em>Appears on:</em>
  2679. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2680. </p>
  2681. <p>
  2682. <p>BeyondtrustAuth provides different ways to authenticate to a BeyondtrustProvider server.</p>
  2683. </p>
  2684. <table>
  2685. <thead>
  2686. <tr>
  2687. <th>Field</th>
  2688. <th>Description</th>
  2689. </tr>
  2690. </thead>
  2691. <tbody>
  2692. <tr>
  2693. <td>
  2694. <code>apiKey</code></br>
  2695. <em>
  2696. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2697. BeyondTrustProviderSecretRef
  2698. </a>
  2699. </em>
  2700. </td>
  2701. <td>
  2702. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  2703. </td>
  2704. </tr>
  2705. <tr>
  2706. <td>
  2707. <code>clientId</code></br>
  2708. <em>
  2709. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2710. BeyondTrustProviderSecretRef
  2711. </a>
  2712. </em>
  2713. </td>
  2714. <td>
  2715. <p>ClientID is the API OAuth Client ID.</p>
  2716. </td>
  2717. </tr>
  2718. <tr>
  2719. <td>
  2720. <code>clientSecret</code></br>
  2721. <em>
  2722. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2723. BeyondTrustProviderSecretRef
  2724. </a>
  2725. </em>
  2726. </td>
  2727. <td>
  2728. <p>ClientSecret is the API OAuth Client Secret.</p>
  2729. </td>
  2730. </tr>
  2731. <tr>
  2732. <td>
  2733. <code>certificate</code></br>
  2734. <em>
  2735. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2736. BeyondTrustProviderSecretRef
  2737. </a>
  2738. </em>
  2739. </td>
  2740. <td>
  2741. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  2742. </td>
  2743. </tr>
  2744. <tr>
  2745. <td>
  2746. <code>certificateKey</code></br>
  2747. <em>
  2748. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2749. BeyondTrustProviderSecretRef
  2750. </a>
  2751. </em>
  2752. </td>
  2753. <td>
  2754. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  2755. </td>
  2756. </tr>
  2757. </tbody>
  2758. </table>
  2759. <h3 id="external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider
  2760. </h3>
  2761. <p>
  2762. (<em>Appears on:</em>
  2763. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2764. </p>
  2765. <p>
  2766. <p>BeyondtrustProvider provides access to a BeyondTrust secrets provider.</p>
  2767. </p>
  2768. <table>
  2769. <thead>
  2770. <tr>
  2771. <th>Field</th>
  2772. <th>Description</th>
  2773. </tr>
  2774. </thead>
  2775. <tbody>
  2776. <tr>
  2777. <td>
  2778. <code>auth</code></br>
  2779. <em>
  2780. <a href="#external-secrets.io/v1.BeyondtrustAuth">
  2781. BeyondtrustAuth
  2782. </a>
  2783. </em>
  2784. </td>
  2785. <td>
  2786. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  2787. </td>
  2788. </tr>
  2789. <tr>
  2790. <td>
  2791. <code>server</code></br>
  2792. <em>
  2793. <a href="#external-secrets.io/v1.BeyondtrustServer">
  2794. BeyondtrustServer
  2795. </a>
  2796. </em>
  2797. </td>
  2798. <td>
  2799. <p>Auth configures how API server works.</p>
  2800. </td>
  2801. </tr>
  2802. </tbody>
  2803. </table>
  2804. <h3 id="external-secrets.io/v1.BeyondtrustServer">BeyondtrustServer
  2805. </h3>
  2806. <p>
  2807. (<em>Appears on:</em>
  2808. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2809. </p>
  2810. <p>
  2811. <p>BeyondtrustServer configures a store to sync secrets using BeyondTrust Password Safe.</p>
  2812. </p>
  2813. <table>
  2814. <thead>
  2815. <tr>
  2816. <th>Field</th>
  2817. <th>Description</th>
  2818. </tr>
  2819. </thead>
  2820. <tbody>
  2821. <tr>
  2822. <td>
  2823. <code>apiUrl</code></br>
  2824. <em>
  2825. string
  2826. </em>
  2827. </td>
  2828. <td>
  2829. </td>
  2830. </tr>
  2831. <tr>
  2832. <td>
  2833. <code>apiVersion</code></br>
  2834. <em>
  2835. string
  2836. </em>
  2837. </td>
  2838. <td>
  2839. </td>
  2840. </tr>
  2841. <tr>
  2842. <td>
  2843. <code>retrievalType</code></br>
  2844. <em>
  2845. string
  2846. </em>
  2847. </td>
  2848. <td>
  2849. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  2850. </td>
  2851. </tr>
  2852. <tr>
  2853. <td>
  2854. <code>separator</code></br>
  2855. <em>
  2856. string
  2857. </em>
  2858. </td>
  2859. <td>
  2860. <p>A character that separates the folder names.</p>
  2861. </td>
  2862. </tr>
  2863. <tr>
  2864. <td>
  2865. <code>decrypt</code></br>
  2866. <em>
  2867. bool
  2868. </em>
  2869. </td>
  2870. <td>
  2871. <em>(Optional)</em>
  2872. <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>
  2873. </td>
  2874. </tr>
  2875. <tr>
  2876. <td>
  2877. <code>verifyCA</code></br>
  2878. <em>
  2879. bool
  2880. </em>
  2881. </td>
  2882. <td>
  2883. </td>
  2884. </tr>
  2885. <tr>
  2886. <td>
  2887. <code>clientTimeOutSeconds</code></br>
  2888. <em>
  2889. int
  2890. </em>
  2891. </td>
  2892. <td>
  2893. <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>
  2894. </td>
  2895. </tr>
  2896. </tbody>
  2897. </table>
  2898. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">BeyondtrustWorkloadCredentialsAuth
  2899. </h3>
  2900. <p>
  2901. (<em>Appears on:</em>
  2902. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>)
  2903. </p>
  2904. <p>
  2905. <p>BeyondtrustWorkloadCredentialsAuth defines the authentication method for the BeyondTrust Workload Credentials provider.
  2906. Currently supports API key authentication via Kubernetes secret reference.
  2907. 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>
  2908. </p>
  2909. <table>
  2910. <thead>
  2911. <tr>
  2912. <th>Field</th>
  2913. <th>Description</th>
  2914. </tr>
  2915. </thead>
  2916. <tbody>
  2917. <tr>
  2918. <td>
  2919. <code>apikey</code></br>
  2920. <em>
  2921. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuthSecretRef">
  2922. BeyondtrustWorkloadCredentialsAuthSecretRef
  2923. </a>
  2924. </em>
  2925. </td>
  2926. <td>
  2927. <p>APIKey configures API token authentication for BeyondTrust Workload Credentials.
  2928. The token is retrieved from a Kubernetes secret and used as a Bearer token for API requests.</p>
  2929. </td>
  2930. </tr>
  2931. </tbody>
  2932. </table>
  2933. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuthSecretRef">BeyondtrustWorkloadCredentialsAuthSecretRef
  2934. </h3>
  2935. <p>
  2936. (<em>Appears on:</em>
  2937. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">BeyondtrustWorkloadCredentialsAuth</a>)
  2938. </p>
  2939. <p>
  2940. <p>BeyondtrustWorkloadCredentialsAuthSecretRef defines a reference to a secret containing credentials for the BeyondTrust Workload Credentials provider.
  2941. The nested structure supports multiple authentication methods (currently only API token is supported).
  2942. 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>
  2943. </p>
  2944. <table>
  2945. <thead>
  2946. <tr>
  2947. <th>Field</th>
  2948. <th>Description</th>
  2949. </tr>
  2950. </thead>
  2951. <tbody>
  2952. <tr>
  2953. <td>
  2954. <code>token</code></br>
  2955. <em>
  2956. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2957. External Secrets meta/v1.SecretKeySelector
  2958. </a>
  2959. </em>
  2960. </td>
  2961. <td>
  2962. <p>Token references the Kubernetes secret containing the BeyondTrust Workload Credentials API token.
  2963. The secret should contain the API key used to authenticate with BeyondTrust Workload Credentials.
  2964. Create an API token in your BeyondTrust Workload Credentials console and store it in a Kubernetes secret.
  2965. 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>
  2966. </td>
  2967. </tr>
  2968. </tbody>
  2969. </table>
  2970. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider
  2971. </h3>
  2972. <p>
  2973. (<em>Appears on:</em>
  2974. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  2975. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec</a>)
  2976. </p>
  2977. <p>
  2978. <p>BeyondtrustWorkloadCredentialsProvider configures a store to sync secrets using the BeyondTrust Workload Credentials provider.
  2979. BeyondTrust Workload Credentials provides secure storage for static secrets and dynamic credential generation.
  2980. This provider supports reading secrets and generating dynamic credentials (e.g., temporary AWS credentials).
  2981. 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>
  2982. </p>
  2983. <table>
  2984. <thead>
  2985. <tr>
  2986. <th>Field</th>
  2987. <th>Description</th>
  2988. </tr>
  2989. </thead>
  2990. <tbody>
  2991. <tr>
  2992. <td>
  2993. <code>auth</code></br>
  2994. <em>
  2995. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">
  2996. BeyondtrustWorkloadCredentialsAuth
  2997. </a>
  2998. </em>
  2999. </td>
  3000. <td>
  3001. <p>Auth configures how the Operator authenticates with the BeyondTrust Workload Credentials API.
  3002. Currently supports API key authentication via Kubernetes secret reference.
  3003. 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>
  3004. </td>
  3005. </tr>
  3006. <tr>
  3007. <td>
  3008. <code>server</code></br>
  3009. <em>
  3010. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsServer">
  3011. BeyondtrustWorkloadCredentialsServer
  3012. </a>
  3013. </em>
  3014. </td>
  3015. <td>
  3016. <p>Server configures the BeyondTrust Workload Credentials server connection details.
  3017. Includes the API URL and Site ID for your BeyondTrust instance.
  3018. 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>
  3019. </td>
  3020. </tr>
  3021. <tr>
  3022. <td>
  3023. <code>folderPath</code></br>
  3024. <em>
  3025. string
  3026. </em>
  3027. </td>
  3028. <td>
  3029. <em>(Optional)</em>
  3030. <p>FolderPath specifies the default folder path for secret retrieval.
  3031. Secrets will be fetched from this folder unless overridden in the ExternalSecret spec.
  3032. Example: &ldquo;production/database&rdquo; or &ldquo;dev/api-keys&rdquo;
  3033. Leave empty to retrieve secrets from the root folder.
  3034. 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>
  3035. </td>
  3036. </tr>
  3037. <tr>
  3038. <td>
  3039. <code>caBundle</code></br>
  3040. <em>
  3041. []byte
  3042. </em>
  3043. </td>
  3044. <td>
  3045. <em>(Optional)</em>
  3046. <p>CABundle is a base64-encoded CA certificate used to validate the BeyondTrust Workload Credentials API TLS certificate.
  3047. Use this when your BeyondTrust instance uses a self-signed certificate or internal CA.
  3048. If not set, the system&rsquo;s trusted root certificates are used.</p>
  3049. </td>
  3050. </tr>
  3051. <tr>
  3052. <td>
  3053. <code>caProvider</code></br>
  3054. <em>
  3055. <a href="#external-secrets.io/v1.CAProvider">
  3056. CAProvider
  3057. </a>
  3058. </em>
  3059. </td>
  3060. <td>
  3061. <em>(Optional)</em>
  3062. <p>CAProvider points to a Secret or ConfigMap containing a PEM-encoded CA certificate.
  3063. This is used to validate the BeyondTrust Workload Credentials API TLS certificate.
  3064. Use this as an alternative to CABundle when you want to reference an existing Kubernetes resource.</p>
  3065. </td>
  3066. </tr>
  3067. </tbody>
  3068. </table>
  3069. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsServer">BeyondtrustWorkloadCredentialsServer
  3070. </h3>
  3071. <p>
  3072. (<em>Appears on:</em>
  3073. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>)
  3074. </p>
  3075. <p>
  3076. <p>BeyondtrustWorkloadCredentialsServer defines connection configuration for BeyondTrust Workload Credentials.
  3077. 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>
  3078. </p>
  3079. <table>
  3080. <thead>
  3081. <tr>
  3082. <th>Field</th>
  3083. <th>Description</th>
  3084. </tr>
  3085. </thead>
  3086. <tbody>
  3087. <tr>
  3088. <td>
  3089. <code>apiUrl</code></br>
  3090. <em>
  3091. string
  3092. </em>
  3093. </td>
  3094. <td>
  3095. <p>APIURL is the base URL of your BeyondTrust Workload Credentials API server.
  3096. This should be the full URL to your BeyondTrust instance.
  3097. Example: <a href="https://api.beyondtrust.io/siie">https://api.beyondtrust.io/siie</a>
  3098. 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>
  3099. </td>
  3100. </tr>
  3101. <tr>
  3102. <td>
  3103. <code>siteId</code></br>
  3104. <em>
  3105. string
  3106. </em>
  3107. </td>
  3108. <td>
  3109. <p>SiteID is your BeyondTrust Workload Credentials site identifier (UUID format).
  3110. This identifier is unique to your BeyondTrust Workload Credentials instance.
  3111. You can find your Site ID in the BeyondTrust Workload Credentials admin console.
  3112. Example: a1b2c3d4-e5f6-4890-abcd-ef1234567890
  3113. 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>
  3114. </td>
  3115. </tr>
  3116. </tbody>
  3117. </table>
  3118. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  3119. </h3>
  3120. <p>
  3121. (<em>Appears on:</em>
  3122. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  3123. </p>
  3124. <p>
  3125. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  3126. </p>
  3127. <table>
  3128. <thead>
  3129. <tr>
  3130. <th>Field</th>
  3131. <th>Description</th>
  3132. </tr>
  3133. </thead>
  3134. <tbody>
  3135. <tr>
  3136. <td>
  3137. <code>secretRef</code></br>
  3138. <em>
  3139. <a href="#external-secrets.io/v1.BitwardenSecretsManagerSecretRef">
  3140. BitwardenSecretsManagerSecretRef
  3141. </a>
  3142. </em>
  3143. </td>
  3144. <td>
  3145. </td>
  3146. </tr>
  3147. </tbody>
  3148. </table>
  3149. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  3150. </h3>
  3151. <p>
  3152. (<em>Appears on:</em>
  3153. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3154. </p>
  3155. <p>
  3156. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  3157. </p>
  3158. <table>
  3159. <thead>
  3160. <tr>
  3161. <th>Field</th>
  3162. <th>Description</th>
  3163. </tr>
  3164. </thead>
  3165. <tbody>
  3166. <tr>
  3167. <td>
  3168. <code>apiURL</code></br>
  3169. <em>
  3170. string
  3171. </em>
  3172. </td>
  3173. <td>
  3174. </td>
  3175. </tr>
  3176. <tr>
  3177. <td>
  3178. <code>identityURL</code></br>
  3179. <em>
  3180. string
  3181. </em>
  3182. </td>
  3183. <td>
  3184. </td>
  3185. </tr>
  3186. <tr>
  3187. <td>
  3188. <code>bitwardenServerSDKURL</code></br>
  3189. <em>
  3190. string
  3191. </em>
  3192. </td>
  3193. <td>
  3194. </td>
  3195. </tr>
  3196. <tr>
  3197. <td>
  3198. <code>caBundle</code></br>
  3199. <em>
  3200. string
  3201. </em>
  3202. </td>
  3203. <td>
  3204. <em>(Optional)</em>
  3205. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  3206. can be performed.</p>
  3207. </td>
  3208. </tr>
  3209. <tr>
  3210. <td>
  3211. <code>caProvider</code></br>
  3212. <em>
  3213. <a href="#external-secrets.io/v1.CAProvider">
  3214. CAProvider
  3215. </a>
  3216. </em>
  3217. </td>
  3218. <td>
  3219. <em>(Optional)</em>
  3220. <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>
  3221. </td>
  3222. </tr>
  3223. <tr>
  3224. <td>
  3225. <code>organizationID</code></br>
  3226. <em>
  3227. string
  3228. </em>
  3229. </td>
  3230. <td>
  3231. <p>OrganizationID determines which organization this secret store manages.</p>
  3232. </td>
  3233. </tr>
  3234. <tr>
  3235. <td>
  3236. <code>projectID</code></br>
  3237. <em>
  3238. string
  3239. </em>
  3240. </td>
  3241. <td>
  3242. <p>ProjectID determines which project this secret store manages.</p>
  3243. </td>
  3244. </tr>
  3245. <tr>
  3246. <td>
  3247. <code>auth</code></br>
  3248. <em>
  3249. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">
  3250. BitwardenSecretsManagerAuth
  3251. </a>
  3252. </em>
  3253. </td>
  3254. <td>
  3255. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  3256. Make sure that the token being used has permissions on the given secret.</p>
  3257. </td>
  3258. </tr>
  3259. </tbody>
  3260. </table>
  3261. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  3262. </h3>
  3263. <p>
  3264. (<em>Appears on:</em>
  3265. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  3266. </p>
  3267. <p>
  3268. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  3269. </p>
  3270. <table>
  3271. <thead>
  3272. <tr>
  3273. <th>Field</th>
  3274. <th>Description</th>
  3275. </tr>
  3276. </thead>
  3277. <tbody>
  3278. <tr>
  3279. <td>
  3280. <code>credentials</code></br>
  3281. <em>
  3282. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3283. External Secrets meta/v1.SecretKeySelector
  3284. </a>
  3285. </em>
  3286. </td>
  3287. <td>
  3288. <p>AccessToken used for the bitwarden instance.</p>
  3289. </td>
  3290. </tr>
  3291. </tbody>
  3292. </table>
  3293. <h3 id="external-secrets.io/v1.ByID">ByID
  3294. </h3>
  3295. <p>
  3296. (<em>Appears on:</em>
  3297. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  3298. </p>
  3299. <p>
  3300. <p>ByID configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID.</p>
  3301. </p>
  3302. <h3 id="external-secrets.io/v1.ByName">ByName
  3303. </h3>
  3304. <p>
  3305. (<em>Appears on:</em>
  3306. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  3307. </p>
  3308. <p>
  3309. <p>ByName configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret name.</p>
  3310. </p>
  3311. <table>
  3312. <thead>
  3313. <tr>
  3314. <th>Field</th>
  3315. <th>Description</th>
  3316. </tr>
  3317. </thead>
  3318. <tbody>
  3319. <tr>
  3320. <td>
  3321. <code>folderID</code></br>
  3322. <em>
  3323. string
  3324. </em>
  3325. </td>
  3326. <td>
  3327. <p>The folder to fetch secrets from</p>
  3328. </td>
  3329. </tr>
  3330. </tbody>
  3331. </table>
  3332. <h3 id="external-secrets.io/v1.CAProvider">CAProvider
  3333. </h3>
  3334. <p>
  3335. (<em>Appears on:</em>
  3336. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>,
  3337. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>,
  3338. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  3339. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>,
  3340. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>,
  3341. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>,
  3342. <a href="#external-secrets.io/v1.KubernetesServer">KubernetesServer</a>,
  3343. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>,
  3344. <a href="#external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS</a>,
  3345. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>,
  3346. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>,
  3347. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  3348. </p>
  3349. <p>
  3350. <p>CAProvider provides a custom certificate authority for accessing the provider&rsquo;s store.
  3351. The CAProvider points to a Secret or ConfigMap resource that contains a PEM-encoded certificate.</p>
  3352. </p>
  3353. <table>
  3354. <thead>
  3355. <tr>
  3356. <th>Field</th>
  3357. <th>Description</th>
  3358. </tr>
  3359. </thead>
  3360. <tbody>
  3361. <tr>
  3362. <td>
  3363. <code>type</code></br>
  3364. <em>
  3365. <a href="#external-secrets.io/v1.CAProviderType">
  3366. CAProviderType
  3367. </a>
  3368. </em>
  3369. </td>
  3370. <td>
  3371. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  3372. </td>
  3373. </tr>
  3374. <tr>
  3375. <td>
  3376. <code>name</code></br>
  3377. <em>
  3378. string
  3379. </em>
  3380. </td>
  3381. <td>
  3382. <p>The name of the object located at the provider type.</p>
  3383. </td>
  3384. </tr>
  3385. <tr>
  3386. <td>
  3387. <code>key</code></br>
  3388. <em>
  3389. string
  3390. </em>
  3391. </td>
  3392. <td>
  3393. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  3394. </td>
  3395. </tr>
  3396. <tr>
  3397. <td>
  3398. <code>namespace</code></br>
  3399. <em>
  3400. string
  3401. </em>
  3402. </td>
  3403. <td>
  3404. <em>(Optional)</em>
  3405. <p>The namespace the Provider type is in.
  3406. Can only be defined when used in a ClusterSecretStore.</p>
  3407. </td>
  3408. </tr>
  3409. </tbody>
  3410. </table>
  3411. <h3 id="external-secrets.io/v1.CAProviderType">CAProviderType
  3412. (<code>string</code> alias)</p></h3>
  3413. <p>
  3414. (<em>Appears on:</em>
  3415. <a href="#external-secrets.io/v1.CAProvider">CAProvider</a>)
  3416. </p>
  3417. <p>
  3418. <p>CAProviderType defines the type of provider for certificate authority.</p>
  3419. </p>
  3420. <table>
  3421. <thead>
  3422. <tr>
  3423. <th>Value</th>
  3424. <th>Description</th>
  3425. </tr>
  3426. </thead>
  3427. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  3428. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  3429. </td>
  3430. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  3431. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  3432. </td>
  3433. </tr></tbody>
  3434. </table>
  3435. <h3 id="external-secrets.io/v1.CSMAuth">CSMAuth
  3436. </h3>
  3437. <p>
  3438. (<em>Appears on:</em>
  3439. <a href="#external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider</a>)
  3440. </p>
  3441. <p>
  3442. <p>CSMAuth contains a secretRef for credentials.</p>
  3443. </p>
  3444. <table>
  3445. <thead>
  3446. <tr>
  3447. <th>Field</th>
  3448. <th>Description</th>
  3449. </tr>
  3450. </thead>
  3451. <tbody>
  3452. <tr>
  3453. <td>
  3454. <code>secretRef</code></br>
  3455. <em>
  3456. <a href="#external-secrets.io/v1.CSMAuthSecretRef">
  3457. CSMAuthSecretRef
  3458. </a>
  3459. </em>
  3460. </td>
  3461. <td>
  3462. <em>(Optional)</em>
  3463. </td>
  3464. </tr>
  3465. </tbody>
  3466. </table>
  3467. <h3 id="external-secrets.io/v1.CSMAuthSecretRef">CSMAuthSecretRef
  3468. </h3>
  3469. <p>
  3470. (<em>Appears on:</em>
  3471. <a href="#external-secrets.io/v1.CSMAuth">CSMAuth</a>)
  3472. </p>
  3473. <p>
  3474. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  3475. </p>
  3476. <table>
  3477. <thead>
  3478. <tr>
  3479. <th>Field</th>
  3480. <th>Description</th>
  3481. </tr>
  3482. </thead>
  3483. <tbody>
  3484. <tr>
  3485. <td>
  3486. <code>accessKeyIDSecretRef</code></br>
  3487. <em>
  3488. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3489. External Secrets meta/v1.SecretKeySelector
  3490. </a>
  3491. </em>
  3492. </td>
  3493. <td>
  3494. <p>The AccessKeyID is used for authentication</p>
  3495. </td>
  3496. </tr>
  3497. <tr>
  3498. <td>
  3499. <code>accessKeySecretSecretRef</code></br>
  3500. <em>
  3501. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3502. External Secrets meta/v1.SecretKeySelector
  3503. </a>
  3504. </em>
  3505. </td>
  3506. <td>
  3507. <p>The AccessKeySecret is used for authentication</p>
  3508. </td>
  3509. </tr>
  3510. </tbody>
  3511. </table>
  3512. <h3 id="external-secrets.io/v1.CacheConfig">CacheConfig
  3513. </h3>
  3514. <p>
  3515. (<em>Appears on:</em>
  3516. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  3517. </p>
  3518. <p>
  3519. <p>CacheConfig configures client-side caching for read operations.</p>
  3520. </p>
  3521. <table>
  3522. <thead>
  3523. <tr>
  3524. <th>Field</th>
  3525. <th>Description</th>
  3526. </tr>
  3527. </thead>
  3528. <tbody>
  3529. <tr>
  3530. <td>
  3531. <code>ttl</code></br>
  3532. <em>
  3533. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3534. Kubernetes meta/v1.Duration
  3535. </a>
  3536. </em>
  3537. </td>
  3538. <td>
  3539. <em>(Optional)</em>
  3540. <p>TTL is the time-to-live for cached secrets.
  3541. Format: duration string (e.g., &ldquo;5m&rdquo;, &ldquo;1h&rdquo;, &ldquo;30s&rdquo;)</p>
  3542. </td>
  3543. </tr>
  3544. <tr>
  3545. <td>
  3546. <code>maxSize</code></br>
  3547. <em>
  3548. int
  3549. </em>
  3550. </td>
  3551. <td>
  3552. <em>(Optional)</em>
  3553. <p>MaxSize is the maximum number of secrets to cache.
  3554. When the cache is full, least-recently-used entries are evicted.</p>
  3555. </td>
  3556. </tr>
  3557. </tbody>
  3558. </table>
  3559. <h3 id="external-secrets.io/v1.CertAuth">CertAuth
  3560. </h3>
  3561. <p>
  3562. (<em>Appears on:</em>
  3563. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  3564. </p>
  3565. <p>
  3566. <p>CertAuth defines certificate-based authentication configuration for Kubernetes.</p>
  3567. </p>
  3568. <table>
  3569. <thead>
  3570. <tr>
  3571. <th>Field</th>
  3572. <th>Description</th>
  3573. </tr>
  3574. </thead>
  3575. <tbody>
  3576. <tr>
  3577. <td>
  3578. <code>clientCert</code></br>
  3579. <em>
  3580. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3581. External Secrets meta/v1.SecretKeySelector
  3582. </a>
  3583. </em>
  3584. </td>
  3585. <td>
  3586. </td>
  3587. </tr>
  3588. <tr>
  3589. <td>
  3590. <code>clientKey</code></br>
  3591. <em>
  3592. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3593. External Secrets meta/v1.SecretKeySelector
  3594. </a>
  3595. </em>
  3596. </td>
  3597. <td>
  3598. </td>
  3599. </tr>
  3600. </tbody>
  3601. </table>
  3602. <h3 id="external-secrets.io/v1.ChefAuth">ChefAuth
  3603. </h3>
  3604. <p>
  3605. (<em>Appears on:</em>
  3606. <a href="#external-secrets.io/v1.ChefProvider">ChefProvider</a>)
  3607. </p>
  3608. <p>
  3609. <p>ChefAuth contains a secretRef for credentials.</p>
  3610. </p>
  3611. <table>
  3612. <thead>
  3613. <tr>
  3614. <th>Field</th>
  3615. <th>Description</th>
  3616. </tr>
  3617. </thead>
  3618. <tbody>
  3619. <tr>
  3620. <td>
  3621. <code>secretRef</code></br>
  3622. <em>
  3623. <a href="#external-secrets.io/v1.ChefAuthSecretRef">
  3624. ChefAuthSecretRef
  3625. </a>
  3626. </em>
  3627. </td>
  3628. <td>
  3629. </td>
  3630. </tr>
  3631. </tbody>
  3632. </table>
  3633. <h3 id="external-secrets.io/v1.ChefAuthSecretRef">ChefAuthSecretRef
  3634. </h3>
  3635. <p>
  3636. (<em>Appears on:</em>
  3637. <a href="#external-secrets.io/v1.ChefAuth">ChefAuth</a>)
  3638. </p>
  3639. <p>
  3640. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  3641. </p>
  3642. <table>
  3643. <thead>
  3644. <tr>
  3645. <th>Field</th>
  3646. <th>Description</th>
  3647. </tr>
  3648. </thead>
  3649. <tbody>
  3650. <tr>
  3651. <td>
  3652. <code>privateKeySecretRef</code></br>
  3653. <em>
  3654. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3655. External Secrets meta/v1.SecretKeySelector
  3656. </a>
  3657. </em>
  3658. </td>
  3659. <td>
  3660. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  3661. </td>
  3662. </tr>
  3663. </tbody>
  3664. </table>
  3665. <h3 id="external-secrets.io/v1.ChefProvider">ChefProvider
  3666. </h3>
  3667. <p>
  3668. (<em>Appears on:</em>
  3669. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3670. </p>
  3671. <p>
  3672. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  3673. </p>
  3674. <table>
  3675. <thead>
  3676. <tr>
  3677. <th>Field</th>
  3678. <th>Description</th>
  3679. </tr>
  3680. </thead>
  3681. <tbody>
  3682. <tr>
  3683. <td>
  3684. <code>auth</code></br>
  3685. <em>
  3686. <a href="#external-secrets.io/v1.ChefAuth">
  3687. ChefAuth
  3688. </a>
  3689. </em>
  3690. </td>
  3691. <td>
  3692. <p>Auth defines the information necessary to authenticate against chef Server</p>
  3693. </td>
  3694. </tr>
  3695. <tr>
  3696. <td>
  3697. <code>username</code></br>
  3698. <em>
  3699. string
  3700. </em>
  3701. </td>
  3702. <td>
  3703. <p>UserName should be the user ID on the chef server</p>
  3704. </td>
  3705. </tr>
  3706. <tr>
  3707. <td>
  3708. <code>serverUrl</code></br>
  3709. <em>
  3710. string
  3711. </em>
  3712. </td>
  3713. <td>
  3714. <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>
  3715. </td>
  3716. </tr>
  3717. </tbody>
  3718. </table>
  3719. <h3 id="external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider
  3720. </h3>
  3721. <p>
  3722. (<em>Appears on:</em>
  3723. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3724. </p>
  3725. <p>
  3726. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  3727. </p>
  3728. <table>
  3729. <thead>
  3730. <tr>
  3731. <th>Field</th>
  3732. <th>Description</th>
  3733. </tr>
  3734. </thead>
  3735. <tbody>
  3736. <tr>
  3737. <td>
  3738. <code>auth</code></br>
  3739. <em>
  3740. <a href="#external-secrets.io/v1.CSMAuth">
  3741. CSMAuth
  3742. </a>
  3743. </em>
  3744. </td>
  3745. <td>
  3746. </td>
  3747. </tr>
  3748. <tr>
  3749. <td>
  3750. <code>projectID</code></br>
  3751. <em>
  3752. string
  3753. </em>
  3754. </td>
  3755. <td>
  3756. <p>ProjectID is the project, which the secrets are stored in.</p>
  3757. </td>
  3758. </tr>
  3759. </tbody>
  3760. </table>
  3761. <h3 id="external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret
  3762. </h3>
  3763. <p>
  3764. <p>ClusterExternalSecret is the Schema for the clusterexternalsecrets API.</p>
  3765. </p>
  3766. <table>
  3767. <thead>
  3768. <tr>
  3769. <th>Field</th>
  3770. <th>Description</th>
  3771. </tr>
  3772. </thead>
  3773. <tbody>
  3774. <tr>
  3775. <td>
  3776. <code>metadata</code></br>
  3777. <em>
  3778. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  3779. Kubernetes meta/v1.ObjectMeta
  3780. </a>
  3781. </em>
  3782. </td>
  3783. <td>
  3784. Refer to the Kubernetes API documentation for the fields of the
  3785. <code>metadata</code> field.
  3786. </td>
  3787. </tr>
  3788. <tr>
  3789. <td>
  3790. <code>spec</code></br>
  3791. <em>
  3792. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">
  3793. ClusterExternalSecretSpec
  3794. </a>
  3795. </em>
  3796. </td>
  3797. <td>
  3798. <br/>
  3799. <br/>
  3800. <table>
  3801. <tr>
  3802. <td>
  3803. <code>externalSecretSpec</code></br>
  3804. <em>
  3805. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3806. ExternalSecretSpec
  3807. </a>
  3808. </em>
  3809. </td>
  3810. <td>
  3811. <p>The spec for the ExternalSecrets to be created</p>
  3812. </td>
  3813. </tr>
  3814. <tr>
  3815. <td>
  3816. <code>externalSecretName</code></br>
  3817. <em>
  3818. string
  3819. </em>
  3820. </td>
  3821. <td>
  3822. <em>(Optional)</em>
  3823. <p>The name of the external secrets to be created.
  3824. Defaults to the name of the ClusterExternalSecret</p>
  3825. </td>
  3826. </tr>
  3827. <tr>
  3828. <td>
  3829. <code>externalSecretMetadata</code></br>
  3830. <em>
  3831. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3832. ExternalSecretMetadata
  3833. </a>
  3834. </em>
  3835. </td>
  3836. <td>
  3837. <em>(Optional)</em>
  3838. <p>The metadata of the external secrets to be created</p>
  3839. </td>
  3840. </tr>
  3841. <tr>
  3842. <td>
  3843. <code>namespaceSelector</code></br>
  3844. <em>
  3845. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3846. Kubernetes meta/v1.LabelSelector
  3847. </a>
  3848. </em>
  3849. </td>
  3850. <td>
  3851. <em>(Optional)</em>
  3852. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3853. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3854. </td>
  3855. </tr>
  3856. <tr>
  3857. <td>
  3858. <code>namespaceSelectors</code></br>
  3859. <em>
  3860. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3861. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3862. </a>
  3863. </em>
  3864. </td>
  3865. <td>
  3866. <em>(Optional)</em>
  3867. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  3868. </td>
  3869. </tr>
  3870. <tr>
  3871. <td>
  3872. <code>namespaces</code></br>
  3873. <em>
  3874. []string
  3875. </em>
  3876. </td>
  3877. <td>
  3878. <em>(Optional)</em>
  3879. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  3880. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3881. </td>
  3882. </tr>
  3883. <tr>
  3884. <td>
  3885. <code>refreshTime</code></br>
  3886. <em>
  3887. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3888. Kubernetes meta/v1.Duration
  3889. </a>
  3890. </em>
  3891. </td>
  3892. <td>
  3893. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  3894. </td>
  3895. </tr>
  3896. </table>
  3897. </td>
  3898. </tr>
  3899. <tr>
  3900. <td>
  3901. <code>status</code></br>
  3902. <em>
  3903. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">
  3904. ClusterExternalSecretStatus
  3905. </a>
  3906. </em>
  3907. </td>
  3908. <td>
  3909. </td>
  3910. </tr>
  3911. </tbody>
  3912. </table>
  3913. <h3 id="external-secrets.io/v1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  3914. (<code>string</code> alias)</p></h3>
  3915. <p>
  3916. (<em>Appears on:</em>
  3917. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  3918. </p>
  3919. <p>
  3920. <p>ClusterExternalSecretConditionType defines a value type for ClusterExternalSecret conditions.</p>
  3921. </p>
  3922. <table>
  3923. <thead>
  3924. <tr>
  3925. <th>Value</th>
  3926. <th>Description</th>
  3927. </tr>
  3928. </thead>
  3929. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  3930. <td><p>ClusterExternalSecretReady is a ClusterExternalSecretConditionType set when the ClusterExternalSecret is ready.</p>
  3931. </td>
  3932. </tr></tbody>
  3933. </table>
  3934. <h3 id="external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  3935. </h3>
  3936. <p>
  3937. (<em>Appears on:</em>
  3938. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  3939. </p>
  3940. <p>
  3941. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  3942. </p>
  3943. <table>
  3944. <thead>
  3945. <tr>
  3946. <th>Field</th>
  3947. <th>Description</th>
  3948. </tr>
  3949. </thead>
  3950. <tbody>
  3951. <tr>
  3952. <td>
  3953. <code>namespace</code></br>
  3954. <em>
  3955. string
  3956. </em>
  3957. </td>
  3958. <td>
  3959. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  3960. </td>
  3961. </tr>
  3962. <tr>
  3963. <td>
  3964. <code>reason</code></br>
  3965. <em>
  3966. string
  3967. </em>
  3968. </td>
  3969. <td>
  3970. <em>(Optional)</em>
  3971. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  3972. </td>
  3973. </tr>
  3974. </tbody>
  3975. </table>
  3976. <h3 id="external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  3977. </h3>
  3978. <p>
  3979. (<em>Appears on:</em>
  3980. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  3981. </p>
  3982. <p>
  3983. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  3984. </p>
  3985. <table>
  3986. <thead>
  3987. <tr>
  3988. <th>Field</th>
  3989. <th>Description</th>
  3990. </tr>
  3991. </thead>
  3992. <tbody>
  3993. <tr>
  3994. <td>
  3995. <code>externalSecretSpec</code></br>
  3996. <em>
  3997. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3998. ExternalSecretSpec
  3999. </a>
  4000. </em>
  4001. </td>
  4002. <td>
  4003. <p>The spec for the ExternalSecrets to be created</p>
  4004. </td>
  4005. </tr>
  4006. <tr>
  4007. <td>
  4008. <code>externalSecretName</code></br>
  4009. <em>
  4010. string
  4011. </em>
  4012. </td>
  4013. <td>
  4014. <em>(Optional)</em>
  4015. <p>The name of the external secrets to be created.
  4016. Defaults to the name of the ClusterExternalSecret</p>
  4017. </td>
  4018. </tr>
  4019. <tr>
  4020. <td>
  4021. <code>externalSecretMetadata</code></br>
  4022. <em>
  4023. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  4024. ExternalSecretMetadata
  4025. </a>
  4026. </em>
  4027. </td>
  4028. <td>
  4029. <em>(Optional)</em>
  4030. <p>The metadata of the external secrets to be created</p>
  4031. </td>
  4032. </tr>
  4033. <tr>
  4034. <td>
  4035. <code>namespaceSelector</code></br>
  4036. <em>
  4037. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4038. Kubernetes meta/v1.LabelSelector
  4039. </a>
  4040. </em>
  4041. </td>
  4042. <td>
  4043. <em>(Optional)</em>
  4044. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  4045. <p>Deprecated: Use NamespaceSelectors instead.</p>
  4046. </td>
  4047. </tr>
  4048. <tr>
  4049. <td>
  4050. <code>namespaceSelectors</code></br>
  4051. <em>
  4052. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  4053. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  4054. </a>
  4055. </em>
  4056. </td>
  4057. <td>
  4058. <em>(Optional)</em>
  4059. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  4060. </td>
  4061. </tr>
  4062. <tr>
  4063. <td>
  4064. <code>namespaces</code></br>
  4065. <em>
  4066. []string
  4067. </em>
  4068. </td>
  4069. <td>
  4070. <em>(Optional)</em>
  4071. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  4072. <p>Deprecated: Use NamespaceSelectors instead.</p>
  4073. </td>
  4074. </tr>
  4075. <tr>
  4076. <td>
  4077. <code>refreshTime</code></br>
  4078. <em>
  4079. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  4080. Kubernetes meta/v1.Duration
  4081. </a>
  4082. </em>
  4083. </td>
  4084. <td>
  4085. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  4086. </td>
  4087. </tr>
  4088. </tbody>
  4089. </table>
  4090. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  4091. </h3>
  4092. <p>
  4093. (<em>Appears on:</em>
  4094. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  4095. </p>
  4096. <p>
  4097. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  4098. </p>
  4099. <table>
  4100. <thead>
  4101. <tr>
  4102. <th>Field</th>
  4103. <th>Description</th>
  4104. </tr>
  4105. </thead>
  4106. <tbody>
  4107. <tr>
  4108. <td>
  4109. <code>externalSecretName</code></br>
  4110. <em>
  4111. string
  4112. </em>
  4113. </td>
  4114. <td>
  4115. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  4116. </td>
  4117. </tr>
  4118. <tr>
  4119. <td>
  4120. <code>failedNamespaces</code></br>
  4121. <em>
  4122. <a href="#external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">
  4123. []ClusterExternalSecretNamespaceFailure
  4124. </a>
  4125. </em>
  4126. </td>
  4127. <td>
  4128. <em>(Optional)</em>
  4129. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  4130. </td>
  4131. </tr>
  4132. <tr>
  4133. <td>
  4134. <code>provisionedNamespaces</code></br>
  4135. <em>
  4136. []string
  4137. </em>
  4138. </td>
  4139. <td>
  4140. <em>(Optional)</em>
  4141. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  4142. </td>
  4143. </tr>
  4144. <tr>
  4145. <td>
  4146. <code>conditions</code></br>
  4147. <em>
  4148. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">
  4149. []ClusterExternalSecretStatusCondition
  4150. </a>
  4151. </em>
  4152. </td>
  4153. <td>
  4154. <em>(Optional)</em>
  4155. </td>
  4156. </tr>
  4157. </tbody>
  4158. </table>
  4159. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  4160. </h3>
  4161. <p>
  4162. (<em>Appears on:</em>
  4163. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  4164. </p>
  4165. <p>
  4166. <p>ClusterExternalSecretStatusCondition defines the observed state of a ClusterExternalSecret resource.</p>
  4167. </p>
  4168. <table>
  4169. <thead>
  4170. <tr>
  4171. <th>Field</th>
  4172. <th>Description</th>
  4173. </tr>
  4174. </thead>
  4175. <tbody>
  4176. <tr>
  4177. <td>
  4178. <code>type</code></br>
  4179. <em>
  4180. <a href="#external-secrets.io/v1.ClusterExternalSecretConditionType">
  4181. ClusterExternalSecretConditionType
  4182. </a>
  4183. </em>
  4184. </td>
  4185. <td>
  4186. </td>
  4187. </tr>
  4188. <tr>
  4189. <td>
  4190. <code>status</code></br>
  4191. <em>
  4192. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  4193. Kubernetes core/v1.ConditionStatus
  4194. </a>
  4195. </em>
  4196. </td>
  4197. <td>
  4198. </td>
  4199. </tr>
  4200. <tr>
  4201. <td>
  4202. <code>message</code></br>
  4203. <em>
  4204. string
  4205. </em>
  4206. </td>
  4207. <td>
  4208. <em>(Optional)</em>
  4209. </td>
  4210. </tr>
  4211. </tbody>
  4212. </table>
  4213. <h3 id="external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore
  4214. </h3>
  4215. <p>
  4216. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  4217. </p>
  4218. <table>
  4219. <thead>
  4220. <tr>
  4221. <th>Field</th>
  4222. <th>Description</th>
  4223. </tr>
  4224. </thead>
  4225. <tbody>
  4226. <tr>
  4227. <td>
  4228. <code>metadata</code></br>
  4229. <em>
  4230. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  4231. Kubernetes meta/v1.ObjectMeta
  4232. </a>
  4233. </em>
  4234. </td>
  4235. <td>
  4236. Refer to the Kubernetes API documentation for the fields of the
  4237. <code>metadata</code> field.
  4238. </td>
  4239. </tr>
  4240. <tr>
  4241. <td>
  4242. <code>spec</code></br>
  4243. <em>
  4244. <a href="#external-secrets.io/v1.SecretStoreSpec">
  4245. SecretStoreSpec
  4246. </a>
  4247. </em>
  4248. </td>
  4249. <td>
  4250. <br/>
  4251. <br/>
  4252. <table>
  4253. <tr>
  4254. <td>
  4255. <code>controller</code></br>
  4256. <em>
  4257. string
  4258. </em>
  4259. </td>
  4260. <td>
  4261. <em>(Optional)</em>
  4262. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  4263. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  4264. </td>
  4265. </tr>
  4266. <tr>
  4267. <td>
  4268. <code>provider</code></br>
  4269. <em>
  4270. <a href="#external-secrets.io/v1.SecretStoreProvider">
  4271. SecretStoreProvider
  4272. </a>
  4273. </em>
  4274. </td>
  4275. <td>
  4276. <p>Used to configure the provider. Only one provider may be set</p>
  4277. </td>
  4278. </tr>
  4279. <tr>
  4280. <td>
  4281. <code>retrySettings</code></br>
  4282. <em>
  4283. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  4284. SecretStoreRetrySettings
  4285. </a>
  4286. </em>
  4287. </td>
  4288. <td>
  4289. <em>(Optional)</em>
  4290. <p>Used to configure HTTP retries on failures.</p>
  4291. </td>
  4292. </tr>
  4293. <tr>
  4294. <td>
  4295. <code>refreshInterval</code></br>
  4296. <em>
  4297. int
  4298. </em>
  4299. </td>
  4300. <td>
  4301. <em>(Optional)</em>
  4302. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  4303. </td>
  4304. </tr>
  4305. <tr>
  4306. <td>
  4307. <code>conditions</code></br>
  4308. <em>
  4309. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  4310. []ClusterSecretStoreCondition
  4311. </a>
  4312. </em>
  4313. </td>
  4314. <td>
  4315. <em>(Optional)</em>
  4316. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  4317. </td>
  4318. </tr>
  4319. </table>
  4320. </td>
  4321. </tr>
  4322. <tr>
  4323. <td>
  4324. <code>status</code></br>
  4325. <em>
  4326. <a href="#external-secrets.io/v1.SecretStoreStatus">
  4327. SecretStoreStatus
  4328. </a>
  4329. </em>
  4330. </td>
  4331. <td>
  4332. </td>
  4333. </tr>
  4334. </tbody>
  4335. </table>
  4336. <h3 id="external-secrets.io/v1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  4337. </h3>
  4338. <p>
  4339. (<em>Appears on:</em>
  4340. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  4341. </p>
  4342. <p>
  4343. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  4344. for a ClusterSecretStore instance.</p>
  4345. </p>
  4346. <table>
  4347. <thead>
  4348. <tr>
  4349. <th>Field</th>
  4350. <th>Description</th>
  4351. </tr>
  4352. </thead>
  4353. <tbody>
  4354. <tr>
  4355. <td>
  4356. <code>namespaceSelector</code></br>
  4357. <em>
  4358. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4359. Kubernetes meta/v1.LabelSelector
  4360. </a>
  4361. </em>
  4362. </td>
  4363. <td>
  4364. <em>(Optional)</em>
  4365. <p>Choose namespace using a labelSelector</p>
  4366. </td>
  4367. </tr>
  4368. <tr>
  4369. <td>
  4370. <code>namespaces</code></br>
  4371. <em>
  4372. []string
  4373. </em>
  4374. </td>
  4375. <td>
  4376. <em>(Optional)</em>
  4377. <p>Choose namespaces by name</p>
  4378. </td>
  4379. </tr>
  4380. <tr>
  4381. <td>
  4382. <code>namespaceRegexes</code></br>
  4383. <em>
  4384. []string
  4385. </em>
  4386. </td>
  4387. <td>
  4388. <em>(Optional)</em>
  4389. <p>Choose namespaces by using regex matching</p>
  4390. </td>
  4391. </tr>
  4392. </tbody>
  4393. </table>
  4394. <h3 id="external-secrets.io/v1.ConfigMapReference">ConfigMapReference
  4395. </h3>
  4396. <p>
  4397. (<em>Appears on:</em>
  4398. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  4399. </p>
  4400. <p>
  4401. <p>ConfigMapReference holds the details of a configmap.</p>
  4402. </p>
  4403. <table>
  4404. <thead>
  4405. <tr>
  4406. <th>Field</th>
  4407. <th>Description</th>
  4408. </tr>
  4409. </thead>
  4410. <tbody>
  4411. <tr>
  4412. <td>
  4413. <code>name</code></br>
  4414. <em>
  4415. string
  4416. </em>
  4417. </td>
  4418. <td>
  4419. <p>name of the configmap.</p>
  4420. </td>
  4421. </tr>
  4422. <tr>
  4423. <td>
  4424. <code>namespace</code></br>
  4425. <em>
  4426. string
  4427. </em>
  4428. </td>
  4429. <td>
  4430. <p>namespace in which the configmap exists. If empty, configmap will looked up in local namespace.</p>
  4431. </td>
  4432. </tr>
  4433. <tr>
  4434. <td>
  4435. <code>key</code></br>
  4436. <em>
  4437. string
  4438. </em>
  4439. </td>
  4440. <td>
  4441. <p>key name holding the external account credential config.</p>
  4442. </td>
  4443. </tr>
  4444. </tbody>
  4445. </table>
  4446. <h3 id="external-secrets.io/v1.ConjurAPIKey">ConjurAPIKey
  4447. </h3>
  4448. <p>
  4449. (<em>Appears on:</em>
  4450. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4451. </p>
  4452. <p>
  4453. <p>ConjurAPIKey contains references to a Secret resource that holds
  4454. the Conjur username and API key.</p>
  4455. </p>
  4456. <table>
  4457. <thead>
  4458. <tr>
  4459. <th>Field</th>
  4460. <th>Description</th>
  4461. </tr>
  4462. </thead>
  4463. <tbody>
  4464. <tr>
  4465. <td>
  4466. <code>account</code></br>
  4467. <em>
  4468. string
  4469. </em>
  4470. </td>
  4471. <td>
  4472. <p>Account is the Conjur organization account name.</p>
  4473. </td>
  4474. </tr>
  4475. <tr>
  4476. <td>
  4477. <code>userRef</code></br>
  4478. <em>
  4479. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4480. External Secrets meta/v1.SecretKeySelector
  4481. </a>
  4482. </em>
  4483. </td>
  4484. <td>
  4485. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  4486. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4487. </td>
  4488. </tr>
  4489. <tr>
  4490. <td>
  4491. <code>apiKeyRef</code></br>
  4492. <em>
  4493. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4494. External Secrets meta/v1.SecretKeySelector
  4495. </a>
  4496. </em>
  4497. </td>
  4498. <td>
  4499. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  4500. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4501. </td>
  4502. </tr>
  4503. </tbody>
  4504. </table>
  4505. <h3 id="external-secrets.io/v1.ConjurAuth">ConjurAuth
  4506. </h3>
  4507. <p>
  4508. (<em>Appears on:</em>
  4509. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>)
  4510. </p>
  4511. <p>
  4512. <p>ConjurAuth is the way to provide authentication credentials to the ConjurProvider.</p>
  4513. </p>
  4514. <table>
  4515. <thead>
  4516. <tr>
  4517. <th>Field</th>
  4518. <th>Description</th>
  4519. </tr>
  4520. </thead>
  4521. <tbody>
  4522. <tr>
  4523. <td>
  4524. <code>apikey</code></br>
  4525. <em>
  4526. <a href="#external-secrets.io/v1.ConjurAPIKey">
  4527. ConjurAPIKey
  4528. </a>
  4529. </em>
  4530. </td>
  4531. <td>
  4532. <em>(Optional)</em>
  4533. <p>Authenticates with Conjur using an API key.</p>
  4534. </td>
  4535. </tr>
  4536. <tr>
  4537. <td>
  4538. <code>jwt</code></br>
  4539. <em>
  4540. <a href="#external-secrets.io/v1.ConjurJWT">
  4541. ConjurJWT
  4542. </a>
  4543. </em>
  4544. </td>
  4545. <td>
  4546. <em>(Optional)</em>
  4547. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  4548. </td>
  4549. </tr>
  4550. <tr>
  4551. <td>
  4552. <code>cert</code></br>
  4553. <em>
  4554. <a href="#external-secrets.io/v1.ConjurCert">
  4555. ConjurCert
  4556. </a>
  4557. </em>
  4558. </td>
  4559. <td>
  4560. <em>(Optional)</em>
  4561. <p>Cert enables certificate-based authentication using a client certificate and key.</p>
  4562. </td>
  4563. </tr>
  4564. </tbody>
  4565. </table>
  4566. <h3 id="external-secrets.io/v1.ConjurCert">ConjurCert
  4567. </h3>
  4568. <p>
  4569. (<em>Appears on:</em>
  4570. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4571. </p>
  4572. <p>
  4573. <p>ConjurCert defines the Cert authentication configuration for Conjur provider.</p>
  4574. </p>
  4575. <table>
  4576. <thead>
  4577. <tr>
  4578. <th>Field</th>
  4579. <th>Description</th>
  4580. </tr>
  4581. </thead>
  4582. <tbody>
  4583. <tr>
  4584. <td>
  4585. <code>account</code></br>
  4586. <em>
  4587. string
  4588. </em>
  4589. </td>
  4590. <td>
  4591. <p>Account is the Conjur organization account name.</p>
  4592. </td>
  4593. </tr>
  4594. <tr>
  4595. <td>
  4596. <code>serviceID</code></br>
  4597. <em>
  4598. string
  4599. </em>
  4600. </td>
  4601. <td>
  4602. <p>The conjur authn cert webservice id</p>
  4603. </td>
  4604. </tr>
  4605. <tr>
  4606. <td>
  4607. <code>hostId</code></br>
  4608. <em>
  4609. string
  4610. </em>
  4611. </td>
  4612. <td>
  4613. <em>(Optional)</em>
  4614. <p>Optional HostID for cert authentication (can be omitted when using &lsquo;spiffe&rsquo; mode).</p>
  4615. </td>
  4616. </tr>
  4617. <tr>
  4618. <td>
  4619. <code>clientCertRef</code></br>
  4620. <em>
  4621. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4622. External Secrets meta/v1.SecretKeySelector
  4623. </a>
  4624. </em>
  4625. </td>
  4626. <td>
  4627. <p>ClientCertRef is a reference to a specific &lsquo;key&rsquo; containing the client certificate
  4628. within a Secret resource. The certificate must be PEM-encoded.</p>
  4629. </td>
  4630. </tr>
  4631. <tr>
  4632. <td>
  4633. <code>clientKeyRef</code></br>
  4634. <em>
  4635. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4636. External Secrets meta/v1.SecretKeySelector
  4637. </a>
  4638. </em>
  4639. </td>
  4640. <td>
  4641. <p>ClientKeyRef is a reference to a specific &lsquo;key&rsquo; containing the private RSA client key
  4642. within a Secret resource. The key must be PEM-encoded.</p>
  4643. </td>
  4644. </tr>
  4645. </tbody>
  4646. </table>
  4647. <h3 id="external-secrets.io/v1.ConjurJWT">ConjurJWT
  4648. </h3>
  4649. <p>
  4650. (<em>Appears on:</em>
  4651. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4652. </p>
  4653. <p>
  4654. <p>ConjurJWT defines the JWT authentication configuration for Conjur provider.</p>
  4655. </p>
  4656. <table>
  4657. <thead>
  4658. <tr>
  4659. <th>Field</th>
  4660. <th>Description</th>
  4661. </tr>
  4662. </thead>
  4663. <tbody>
  4664. <tr>
  4665. <td>
  4666. <code>account</code></br>
  4667. <em>
  4668. string
  4669. </em>
  4670. </td>
  4671. <td>
  4672. <p>Account is the Conjur organization account name.</p>
  4673. </td>
  4674. </tr>
  4675. <tr>
  4676. <td>
  4677. <code>serviceID</code></br>
  4678. <em>
  4679. string
  4680. </em>
  4681. </td>
  4682. <td>
  4683. <p>The conjur authn jwt webservice id</p>
  4684. </td>
  4685. </tr>
  4686. <tr>
  4687. <td>
  4688. <code>hostId</code></br>
  4689. <em>
  4690. string
  4691. </em>
  4692. </td>
  4693. <td>
  4694. <em>(Optional)</em>
  4695. <p>Optional HostID for JWT authentication. This may be used depending
  4696. on how the Conjur JWT authenticator policy is configured.</p>
  4697. </td>
  4698. </tr>
  4699. <tr>
  4700. <td>
  4701. <code>secretRef</code></br>
  4702. <em>
  4703. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4704. External Secrets meta/v1.SecretKeySelector
  4705. </a>
  4706. </em>
  4707. </td>
  4708. <td>
  4709. <em>(Optional)</em>
  4710. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  4711. authenticate with Conjur using the JWT authentication method.</p>
  4712. </td>
  4713. </tr>
  4714. <tr>
  4715. <td>
  4716. <code>serviceAccountRef</code></br>
  4717. <em>
  4718. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  4719. External Secrets meta/v1.ServiceAccountSelector
  4720. </a>
  4721. </em>
  4722. </td>
  4723. <td>
  4724. <em>(Optional)</em>
  4725. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  4726. a token for with the <code>TokenRequest</code> API.</p>
  4727. </td>
  4728. </tr>
  4729. </tbody>
  4730. </table>
  4731. <h3 id="external-secrets.io/v1.ConjurProvider">ConjurProvider
  4732. </h3>
  4733. <p>
  4734. (<em>Appears on:</em>
  4735. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4736. </p>
  4737. <p>
  4738. <p>ConjurProvider provides access to a Conjur provider.</p>
  4739. </p>
  4740. <table>
  4741. <thead>
  4742. <tr>
  4743. <th>Field</th>
  4744. <th>Description</th>
  4745. </tr>
  4746. </thead>
  4747. <tbody>
  4748. <tr>
  4749. <td>
  4750. <code>url</code></br>
  4751. <em>
  4752. string
  4753. </em>
  4754. </td>
  4755. <td>
  4756. <p>URL is the endpoint of the Conjur instance.</p>
  4757. </td>
  4758. </tr>
  4759. <tr>
  4760. <td>
  4761. <code>caBundle</code></br>
  4762. <em>
  4763. string
  4764. </em>
  4765. </td>
  4766. <td>
  4767. <em>(Optional)</em>
  4768. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  4769. </td>
  4770. </tr>
  4771. <tr>
  4772. <td>
  4773. <code>caProvider</code></br>
  4774. <em>
  4775. <a href="#external-secrets.io/v1.CAProvider">
  4776. CAProvider
  4777. </a>
  4778. </em>
  4779. </td>
  4780. <td>
  4781. <em>(Optional)</em>
  4782. <p>Used to provide custom certificate authority (CA) certificates
  4783. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  4784. that contains a PEM-encoded certificate.</p>
  4785. </td>
  4786. </tr>
  4787. <tr>
  4788. <td>
  4789. <code>auth</code></br>
  4790. <em>
  4791. <a href="#external-secrets.io/v1.ConjurAuth">
  4792. ConjurAuth
  4793. </a>
  4794. </em>
  4795. </td>
  4796. <td>
  4797. <p>Defines authentication settings for connecting to Conjur.</p>
  4798. </td>
  4799. </tr>
  4800. </tbody>
  4801. </table>
  4802. <h3 id="external-secrets.io/v1.DVLSAuth">DVLSAuth
  4803. </h3>
  4804. <p>
  4805. (<em>Appears on:</em>
  4806. <a href="#external-secrets.io/v1.DVLSProvider">DVLSProvider</a>)
  4807. </p>
  4808. <p>
  4809. <p>DVLSAuth defines the authentication method for the DVLS provider.</p>
  4810. </p>
  4811. <table>
  4812. <thead>
  4813. <tr>
  4814. <th>Field</th>
  4815. <th>Description</th>
  4816. </tr>
  4817. </thead>
  4818. <tbody>
  4819. <tr>
  4820. <td>
  4821. <code>secretRef</code></br>
  4822. <em>
  4823. <a href="#external-secrets.io/v1.DVLSAuthSecretRef">
  4824. DVLSAuthSecretRef
  4825. </a>
  4826. </em>
  4827. </td>
  4828. <td>
  4829. <p>SecretRef contains the Application ID and Application Secret for authentication.</p>
  4830. </td>
  4831. </tr>
  4832. </tbody>
  4833. </table>
  4834. <h3 id="external-secrets.io/v1.DVLSAuthSecretRef">DVLSAuthSecretRef
  4835. </h3>
  4836. <p>
  4837. (<em>Appears on:</em>
  4838. <a href="#external-secrets.io/v1.DVLSAuth">DVLSAuth</a>)
  4839. </p>
  4840. <p>
  4841. <p>DVLSAuthSecretRef defines the secret references for DVLS authentication credentials.</p>
  4842. </p>
  4843. <table>
  4844. <thead>
  4845. <tr>
  4846. <th>Field</th>
  4847. <th>Description</th>
  4848. </tr>
  4849. </thead>
  4850. <tbody>
  4851. <tr>
  4852. <td>
  4853. <code>appId</code></br>
  4854. <em>
  4855. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4856. External Secrets meta/v1.SecretKeySelector
  4857. </a>
  4858. </em>
  4859. </td>
  4860. <td>
  4861. <p>AppID is the reference to the secret containing the Application ID.</p>
  4862. </td>
  4863. </tr>
  4864. <tr>
  4865. <td>
  4866. <code>appSecret</code></br>
  4867. <em>
  4868. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4869. External Secrets meta/v1.SecretKeySelector
  4870. </a>
  4871. </em>
  4872. </td>
  4873. <td>
  4874. <p>AppSecret is the reference to the secret containing the Application Secret.</p>
  4875. </td>
  4876. </tr>
  4877. </tbody>
  4878. </table>
  4879. <h3 id="external-secrets.io/v1.DVLSProvider">DVLSProvider
  4880. </h3>
  4881. <p>
  4882. (<em>Appears on:</em>
  4883. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4884. </p>
  4885. <p>
  4886. <p>DVLSProvider configures a store to sync secrets using Devolutions Server.</p>
  4887. </p>
  4888. <table>
  4889. <thead>
  4890. <tr>
  4891. <th>Field</th>
  4892. <th>Description</th>
  4893. </tr>
  4894. </thead>
  4895. <tbody>
  4896. <tr>
  4897. <td>
  4898. <code>serverUrl</code></br>
  4899. <em>
  4900. string
  4901. </em>
  4902. </td>
  4903. <td>
  4904. <p>ServerURL is the DVLS instance URL (e.g., <a href="https://dvls.example.com">https://dvls.example.com</a>).</p>
  4905. </td>
  4906. </tr>
  4907. <tr>
  4908. <td>
  4909. <code>vault</code></br>
  4910. <em>
  4911. string
  4912. </em>
  4913. </td>
  4914. <td>
  4915. <em>(Optional)</em>
  4916. <p>Vault is the name or UUID of the vault to fetch secrets from.
  4917. When omitted, the vault must be specified in the secret key using the legacy format &ldquo;<vault-id>/<entry-id>&rdquo;.</p>
  4918. </td>
  4919. </tr>
  4920. <tr>
  4921. <td>
  4922. <code>insecure</code></br>
  4923. <em>
  4924. bool
  4925. </em>
  4926. </td>
  4927. <td>
  4928. <em>(Optional)</em>
  4929. <p>Insecure allows connecting to DVLS over plain HTTP.
  4930. This is NOT RECOMMENDED for production use.
  4931. Set to true only if you understand the security implications.</p>
  4932. </td>
  4933. </tr>
  4934. <tr>
  4935. <td>
  4936. <code>auth</code></br>
  4937. <em>
  4938. <a href="#external-secrets.io/v1.DVLSAuth">
  4939. DVLSAuth
  4940. </a>
  4941. </em>
  4942. </td>
  4943. <td>
  4944. <p>Auth defines the authentication method to use.</p>
  4945. </td>
  4946. </tr>
  4947. </tbody>
  4948. </table>
  4949. <h3 id="external-secrets.io/v1.DelineaProvider">DelineaProvider
  4950. </h3>
  4951. <p>
  4952. (<em>Appears on:</em>
  4953. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4954. </p>
  4955. <p>
  4956. <p>DelineaProvider provides access to Delinea secrets vault Server.
  4957. 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>
  4958. </p>
  4959. <table>
  4960. <thead>
  4961. <tr>
  4962. <th>Field</th>
  4963. <th>Description</th>
  4964. </tr>
  4965. </thead>
  4966. <tbody>
  4967. <tr>
  4968. <td>
  4969. <code>clientId</code></br>
  4970. <em>
  4971. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4972. DelineaProviderSecretRef
  4973. </a>
  4974. </em>
  4975. </td>
  4976. <td>
  4977. <p>ClientID is the non-secret part of the credential.</p>
  4978. </td>
  4979. </tr>
  4980. <tr>
  4981. <td>
  4982. <code>clientSecret</code></br>
  4983. <em>
  4984. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4985. DelineaProviderSecretRef
  4986. </a>
  4987. </em>
  4988. </td>
  4989. <td>
  4990. <p>ClientSecret is the secret part of the credential.</p>
  4991. </td>
  4992. </tr>
  4993. <tr>
  4994. <td>
  4995. <code>tenant</code></br>
  4996. <em>
  4997. string
  4998. </em>
  4999. </td>
  5000. <td>
  5001. <p>Tenant is the chosen hostname / site name.</p>
  5002. </td>
  5003. </tr>
  5004. <tr>
  5005. <td>
  5006. <code>urlTemplate</code></br>
  5007. <em>
  5008. string
  5009. </em>
  5010. </td>
  5011. <td>
  5012. <em>(Optional)</em>
  5013. <p>URLTemplate
  5014. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  5015. </td>
  5016. </tr>
  5017. <tr>
  5018. <td>
  5019. <code>tld</code></br>
  5020. <em>
  5021. string
  5022. </em>
  5023. </td>
  5024. <td>
  5025. <em>(Optional)</em>
  5026. <p>TLD is based on the server location that was chosen during provisioning.
  5027. If unset, defaults to &ldquo;com&rdquo;.</p>
  5028. </td>
  5029. </tr>
  5030. </tbody>
  5031. </table>
  5032. <h3 id="external-secrets.io/v1.DelineaProviderSecretRef">DelineaProviderSecretRef
  5033. </h3>
  5034. <p>
  5035. (<em>Appears on:</em>
  5036. <a href="#external-secrets.io/v1.DelineaProvider">DelineaProvider</a>)
  5037. </p>
  5038. <p>
  5039. <p>DelineaProviderSecretRef is a secret reference containing either a direct value or a reference to a secret key.</p>
  5040. </p>
  5041. <table>
  5042. <thead>
  5043. <tr>
  5044. <th>Field</th>
  5045. <th>Description</th>
  5046. </tr>
  5047. </thead>
  5048. <tbody>
  5049. <tr>
  5050. <td>
  5051. <code>value</code></br>
  5052. <em>
  5053. string
  5054. </em>
  5055. </td>
  5056. <td>
  5057. <em>(Optional)</em>
  5058. <p>Value can be specified directly to set a value without using a secret.</p>
  5059. </td>
  5060. </tr>
  5061. <tr>
  5062. <td>
  5063. <code>secretRef</code></br>
  5064. <em>
  5065. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  5066. External Secrets meta/v1.SecretKeySelector
  5067. </a>
  5068. </em>
  5069. </td>
  5070. <td>
  5071. <em>(Optional)</em>
  5072. <p>SecretRef references a key in a secret that will be used as value.</p>
  5073. </td>
  5074. </tr>
  5075. </tbody>
  5076. </table>
  5077. <h3 id="external-secrets.io/v1.DopplerAuth">DopplerAuth
  5078. </h3>
  5079. <p>
  5080. (<em>Appears on:</em>
  5081. <a href="#external-secrets.io/v1.DopplerProvider">DopplerProvider</a>)
  5082. </p>
  5083. <p>
  5084. <p>DopplerAuth configures authentication with the Doppler API.
  5085. Exactly one of secretRef or oidcConfig must be specified.</p>
  5086. </p>
  5087. <table>
  5088. <thead>
  5089. <tr>
  5090. <th>Field</th>
  5091. <th>Description</th>
  5092. </tr>
  5093. </thead>
  5094. <tbody>
  5095. <tr>
  5096. <td>
  5097. <code>secretRef</code></br>
  5098. <em>
  5099. <a href="#external-secrets.io/v1.DopplerAuthSecretRef">
  5100. DopplerAuthSecretRef
  5101. </a>
  5102. </em>
  5103. </td>
  5104. <td>
  5105. <em>(Optional)</em>
  5106. <p>SecretRef authenticates using a Doppler service token stored in a Kubernetes Secret.</p>
  5107. </td>
  5108. </tr>
  5109. <tr>
  5110. <td>
  5111. <code>oidcConfig</code></br>
  5112. <em>
  5113. <a href="#external-secrets.io/v1.DopplerOIDCAuth">
  5114. DopplerOIDCAuth
  5115. </a>
  5116. </em>
  5117. </td>
  5118. <td>
  5119. <em>(Optional)</em>
  5120. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  5121. </td>
  5122. </tr>
  5123. </tbody>
  5124. </table>
  5125. <h3 id="external-secrets.io/v1.DopplerAuthSecretRef">DopplerAuthSecretRef
  5126. </h3>
  5127. <p>
  5128. (<em>Appears on:</em>
  5129. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  5130. </p>
  5131. <p>
  5132. <p>DopplerAuthSecretRef contains the secret reference for accessing the Doppler API.</p>
  5133. </p>
  5134. <table>
  5135. <thead>
  5136. <tr>
  5137. <th>Field</th>
  5138. <th>Description</th>
  5139. </tr>
  5140. </thead>
  5141. <tbody>
  5142. <tr>
  5143. <td>
  5144. <code>dopplerToken</code></br>
  5145. <em>
  5146. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  5147. External Secrets meta/v1.SecretKeySelector
  5148. </a>
  5149. </em>
  5150. </td>
  5151. <td>
  5152. <p>The DopplerToken is used for authentication.
  5153. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  5154. The Key attribute defaults to dopplerToken if not specified.</p>
  5155. </td>
  5156. </tr>
  5157. </tbody>
  5158. </table>
  5159. <h3 id="external-secrets.io/v1.DopplerOIDCAuth">DopplerOIDCAuth
  5160. </h3>
  5161. <p>
  5162. (<em>Appears on:</em>
  5163. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  5164. </p>
  5165. <p>
  5166. <p>DopplerOIDCAuth configures OIDC authentication with Doppler using Kubernetes ServiceAccount tokens.</p>
  5167. </p>
  5168. <table>
  5169. <thead>
  5170. <tr>
  5171. <th>Field</th>
  5172. <th>Description</th>
  5173. </tr>
  5174. </thead>
  5175. <tbody>
  5176. <tr>
  5177. <td>
  5178. <code>identity</code></br>
  5179. <em>
  5180. string
  5181. </em>
  5182. </td>
  5183. <td>
  5184. <p>Identity is the Doppler Service Account Identity ID configured for OIDC authentication.</p>
  5185. </td>
  5186. </tr>
  5187. <tr>
  5188. <td>
  5189. <code>serviceAccountRef</code></br>
  5190. <em>
  5191. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  5192. External Secrets meta/v1.ServiceAccountSelector
  5193. </a>
  5194. </em>
  5195. </td>
  5196. <td>
  5197. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  5198. </td>
  5199. </tr>
  5200. <tr>
  5201. <td>
  5202. <code>expirationSeconds</code></br>
  5203. <em>
  5204. int64
  5205. </em>
  5206. </td>
  5207. <td>
  5208. <em>(Optional)</em>
  5209. <p>ExpirationSeconds sets the ServiceAccount token validity duration.
  5210. Defaults to 10 minutes.</p>
  5211. </td>
  5212. </tr>
  5213. </tbody>
  5214. </table>
  5215. <h3 id="external-secrets.io/v1.DopplerProvider">DopplerProvider
  5216. </h3>
  5217. <p>
  5218. (<em>Appears on:</em>
  5219. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  5220. </p>
  5221. <p>
  5222. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  5223. Project and Config are required if not using a Service Token.</p>
  5224. </p>
  5225. <table>
  5226. <thead>
  5227. <tr>
  5228. <th>Field</th>
  5229. <th>Description</th>
  5230. </tr>
  5231. </thead>
  5232. <tbody>
  5233. <tr>
  5234. <td>
  5235. <code>auth</code></br>
  5236. <em>
  5237. <a href="#external-secrets.io/v1.DopplerAuth">
  5238. DopplerAuth
  5239. </a>
  5240. </em>
  5241. </td>
  5242. <td>
  5243. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  5244. </td>
  5245. </tr>
  5246. <tr>
  5247. <td>
  5248. <code>project</code></br>
  5249. <em>
  5250. string
  5251. </em>
  5252. </td>
  5253. <td>
  5254. <em>(Optional)</em>
  5255. <p>Doppler project (required if not using a Service Token)</p>
  5256. </td>
  5257. </tr>
  5258. <tr>
  5259. <td>
  5260. <code>config</code></br>
  5261. <em>
  5262. string
  5263. </em>
  5264. </td>
  5265. <td>
  5266. <em>(Optional)</em>
  5267. <p>Doppler config (required if not using a Service Token)</p>
  5268. </td>
  5269. </tr>
  5270. <tr>
  5271. <td>
  5272. <code>nameTransformer</code></br>
  5273. <em>
  5274. string
  5275. </em>
  5276. </td>
  5277. <td>
  5278. <em>(Optional)</em>
  5279. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  5280. </td>
  5281. </tr>
  5282. <tr>
  5283. <td>
  5284. <code>format</code></br>
  5285. <em>
  5286. string
  5287. </em>
  5288. </td>
  5289. <td>
  5290. <em>(Optional)</em>
  5291. <p>Format enables the downloading of secrets as a file (string)</p>
  5292. </td>
  5293. </tr>
  5294. </tbody>
  5295. </table>
  5296. <h3 id="external-secrets.io/v1.ExternalSecret">ExternalSecret
  5297. </h3>
  5298. <p>
  5299. <p>ExternalSecret is the Schema for the external-secrets API.
  5300. It defines how to fetch data from external APIs and make it available as Kubernetes Secrets.</p>
  5301. </p>
  5302. <table>
  5303. <thead>
  5304. <tr>
  5305. <th>Field</th>
  5306. <th>Description</th>
  5307. </tr>
  5308. </thead>
  5309. <tbody>
  5310. <tr>
  5311. <td>
  5312. <code>metadata</code></br>
  5313. <em>
  5314. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  5315. Kubernetes meta/v1.ObjectMeta
  5316. </a>
  5317. </em>
  5318. </td>
  5319. <td>
  5320. Refer to the Kubernetes API documentation for the fields of the
  5321. <code>metadata</code> field.
  5322. </td>
  5323. </tr>
  5324. <tr>
  5325. <td>
  5326. <code>spec</code></br>
  5327. <em>
  5328. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  5329. ExternalSecretSpec
  5330. </a>
  5331. </em>
  5332. </td>
  5333. <td>
  5334. <br/>
  5335. <br/>
  5336. <table>
  5337. <tr>
  5338. <td>
  5339. <code>secretStoreRef</code></br>
  5340. <em>
  5341. <a href="#external-secrets.io/v1.SecretStoreRef">
  5342. SecretStoreRef
  5343. </a>
  5344. </em>
  5345. </td>
  5346. <td>
  5347. <em>(Optional)</em>
  5348. </td>
  5349. </tr>
  5350. <tr>
  5351. <td>
  5352. <code>target</code></br>
  5353. <em>
  5354. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  5355. ExternalSecretTarget
  5356. </a>
  5357. </em>
  5358. </td>
  5359. <td>
  5360. <em>(Optional)</em>
  5361. </td>
  5362. </tr>
  5363. <tr>
  5364. <td>
  5365. <code>refreshPolicy</code></br>
  5366. <em>
  5367. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  5368. ExternalSecretRefreshPolicy
  5369. </a>
  5370. </em>
  5371. </td>
  5372. <td>
  5373. <em>(Optional)</em>
  5374. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  5375. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  5376. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  5377. No periodic updates occur if refreshInterval is 0.
  5378. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  5379. </td>
  5380. </tr>
  5381. <tr>
  5382. <td>
  5383. <code>refreshInterval</code></br>
  5384. <em>
  5385. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  5386. Kubernetes meta/v1.Duration
  5387. </a>
  5388. </em>
  5389. </td>
  5390. <td>
  5391. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  5392. specified as Golang Duration strings.
  5393. 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;
  5394. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  5395. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  5396. </td>
  5397. </tr>
  5398. <tr>
  5399. <td>
  5400. <code>syncWindows</code></br>
  5401. <em>
  5402. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">
  5403. ExternalSecretSyncWindows
  5404. </a>
  5405. </em>
  5406. </td>
  5407. <td>
  5408. <em>(Optional)</em>
  5409. <p>SyncWindows optionally restricts when periodic refreshes may occur.
  5410. Evaluated in UTC, only for Periodic refresh policy (or when refreshPolicy is unset).</p>
  5411. </td>
  5412. </tr>
  5413. <tr>
  5414. <td>
  5415. <code>data</code></br>
  5416. <em>
  5417. <a href="#external-secrets.io/v1.ExternalSecretData">
  5418. []ExternalSecretData
  5419. </a>
  5420. </em>
  5421. </td>
  5422. <td>
  5423. <em>(Optional)</em>
  5424. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  5425. </td>
  5426. </tr>
  5427. <tr>
  5428. <td>
  5429. <code>dataFrom</code></br>
  5430. <em>
  5431. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  5432. []ExternalSecretDataFromRemoteRef
  5433. </a>
  5434. </em>
  5435. </td>
  5436. <td>
  5437. <em>(Optional)</em>
  5438. <p>DataFrom is used to fetch all properties from a specific Provider data
  5439. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  5440. </td>
  5441. </tr>
  5442. </table>
  5443. </td>
  5444. </tr>
  5445. <tr>
  5446. <td>
  5447. <code>status</code></br>
  5448. <em>
  5449. <a href="#external-secrets.io/v1.ExternalSecretStatus">
  5450. ExternalSecretStatus
  5451. </a>
  5452. </em>
  5453. </td>
  5454. <td>
  5455. </td>
  5456. </tr>
  5457. </tbody>
  5458. </table>
  5459. <h3 id="external-secrets.io/v1.ExternalSecretConditionType">ExternalSecretConditionType
  5460. (<code>string</code> alias)</p></h3>
  5461. <p>
  5462. (<em>Appears on:</em>
  5463. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  5464. </p>
  5465. <p>
  5466. <p>ExternalSecretConditionType defines a value type for ExternalSecret conditions.</p>
  5467. </p>
  5468. <table>
  5469. <thead>
  5470. <tr>
  5471. <th>Value</th>
  5472. <th>Description</th>
  5473. </tr>
  5474. </thead>
  5475. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  5476. <td><p>ExternalSecretDeleted indicates that the external secret has been deleted.</p>
  5477. </td>
  5478. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  5479. <td><p>ExternalSecretReady indicates that the external secret is ready and synced.</p>
  5480. </td>
  5481. </tr></tbody>
  5482. </table>
  5483. <h3 id="external-secrets.io/v1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  5484. (<code>string</code> alias)</p></h3>
  5485. <p>
  5486. (<em>Appears on:</em>
  5487. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5488. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5489. </p>
  5490. <p>
  5491. <p>ExternalSecretConversionStrategy defines strategies for converting secret values.</p>
  5492. </p>
  5493. <table>
  5494. <thead>
  5495. <tr>
  5496. <th>Value</th>
  5497. <th>Description</th>
  5498. </tr>
  5499. </thead>
  5500. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  5501. <td><p>ExternalSecretConversionDefault specifies the default conversion strategy.</p>
  5502. </td>
  5503. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  5504. <td><p>ExternalSecretConversionUnicode specifies that values should be treated as Unicode.</p>
  5505. </td>
  5506. </tr></tbody>
  5507. </table>
  5508. <h3 id="external-secrets.io/v1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  5509. (<code>string</code> alias)</p></h3>
  5510. <p>
  5511. (<em>Appears on:</em>
  5512. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5513. </p>
  5514. <p>
  5515. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  5516. </p>
  5517. <table>
  5518. <thead>
  5519. <tr>
  5520. <th>Value</th>
  5521. <th>Description</th>
  5522. </tr>
  5523. </thead>
  5524. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  5525. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  5526. </td>
  5527. </tr><tr><td><p>&#34;None&#34;</p></td>
  5528. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  5529. </td>
  5530. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  5531. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  5532. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  5533. </td>
  5534. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  5535. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  5536. </td>
  5537. </tr></tbody>
  5538. </table>
  5539. <h3 id="external-secrets.io/v1.ExternalSecretData">ExternalSecretData
  5540. </h3>
  5541. <p>
  5542. (<em>Appears on:</em>
  5543. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5544. </p>
  5545. <p>
  5546. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  5547. </p>
  5548. <table>
  5549. <thead>
  5550. <tr>
  5551. <th>Field</th>
  5552. <th>Description</th>
  5553. </tr>
  5554. </thead>
  5555. <tbody>
  5556. <tr>
  5557. <td>
  5558. <code>secretKey</code></br>
  5559. <em>
  5560. string
  5561. </em>
  5562. </td>
  5563. <td>
  5564. <p>The key in the Kubernetes Secret to store the value.</p>
  5565. </td>
  5566. </tr>
  5567. <tr>
  5568. <td>
  5569. <code>remoteRef</code></br>
  5570. <em>
  5571. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5572. ExternalSecretDataRemoteRef
  5573. </a>
  5574. </em>
  5575. </td>
  5576. <td>
  5577. <p>RemoteRef points to the remote secret and defines
  5578. which secret (version/property/..) to fetch.</p>
  5579. </td>
  5580. </tr>
  5581. <tr>
  5582. <td>
  5583. <code>sourceRef</code></br>
  5584. <em>
  5585. <a href="#external-secrets.io/v1.StoreSourceRef">
  5586. StoreSourceRef
  5587. </a>
  5588. </em>
  5589. </td>
  5590. <td>
  5591. <p>SourceRef allows you to override the source
  5592. from which the value will be pulled.</p>
  5593. </td>
  5594. </tr>
  5595. </tbody>
  5596. </table>
  5597. <h3 id="external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  5598. </h3>
  5599. <p>
  5600. (<em>Appears on:</em>
  5601. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5602. </p>
  5603. <p>
  5604. <p>ExternalSecretDataFromRemoteRef defines the connection between the Kubernetes Secret keys and the Provider data
  5605. when using DataFrom to fetch multiple values from a Provider.</p>
  5606. </p>
  5607. <table>
  5608. <thead>
  5609. <tr>
  5610. <th>Field</th>
  5611. <th>Description</th>
  5612. </tr>
  5613. </thead>
  5614. <tbody>
  5615. <tr>
  5616. <td>
  5617. <code>extract</code></br>
  5618. <em>
  5619. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5620. ExternalSecretDataRemoteRef
  5621. </a>
  5622. </em>
  5623. </td>
  5624. <td>
  5625. <em>(Optional)</em>
  5626. <p>Used to extract multiple key/value pairs from one secret
  5627. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5628. </td>
  5629. </tr>
  5630. <tr>
  5631. <td>
  5632. <code>find</code></br>
  5633. <em>
  5634. <a href="#external-secrets.io/v1.ExternalSecretFind">
  5635. ExternalSecretFind
  5636. </a>
  5637. </em>
  5638. </td>
  5639. <td>
  5640. <em>(Optional)</em>
  5641. <p>Used to find secrets based on tags or regular expressions
  5642. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5643. </td>
  5644. </tr>
  5645. <tr>
  5646. <td>
  5647. <code>rewrite</code></br>
  5648. <em>
  5649. <a href="#external-secrets.io/v1.ExternalSecretRewrite">
  5650. []ExternalSecretRewrite
  5651. </a>
  5652. </em>
  5653. </td>
  5654. <td>
  5655. <em>(Optional)</em>
  5656. <p>Used to rewrite secret Keys after getting them from the secret Provider
  5657. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  5658. </td>
  5659. </tr>
  5660. <tr>
  5661. <td>
  5662. <code>sourceRef</code></br>
  5663. <em>
  5664. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">
  5665. StoreGeneratorSourceRef
  5666. </a>
  5667. </em>
  5668. </td>
  5669. <td>
  5670. <p>SourceRef points to a store or generator
  5671. which contains secret values ready to use.
  5672. Use this in combination with Extract or Find pull values out of
  5673. a specific SecretStore.
  5674. When sourceRef points to a generator Extract or Find is not supported.
  5675. The generator returns a static map of values</p>
  5676. </td>
  5677. </tr>
  5678. </tbody>
  5679. </table>
  5680. <h3 id="external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  5681. </h3>
  5682. <p>
  5683. (<em>Appears on:</em>
  5684. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>,
  5685. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5686. </p>
  5687. <p>
  5688. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  5689. </p>
  5690. <table>
  5691. <thead>
  5692. <tr>
  5693. <th>Field</th>
  5694. <th>Description</th>
  5695. </tr>
  5696. </thead>
  5697. <tbody>
  5698. <tr>
  5699. <td>
  5700. <code>key</code></br>
  5701. <em>
  5702. string
  5703. </em>
  5704. </td>
  5705. <td>
  5706. <p>Key is the key used in the Provider, mandatory</p>
  5707. </td>
  5708. </tr>
  5709. <tr>
  5710. <td>
  5711. <code>metadataPolicy</code></br>
  5712. <em>
  5713. <a href="#external-secrets.io/v1.ExternalSecretMetadataPolicy">
  5714. ExternalSecretMetadataPolicy
  5715. </a>
  5716. </em>
  5717. </td>
  5718. <td>
  5719. <em>(Optional)</em>
  5720. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  5721. </td>
  5722. </tr>
  5723. <tr>
  5724. <td>
  5725. <code>property</code></br>
  5726. <em>
  5727. string
  5728. </em>
  5729. </td>
  5730. <td>
  5731. <em>(Optional)</em>
  5732. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  5733. </td>
  5734. </tr>
  5735. <tr>
  5736. <td>
  5737. <code>version</code></br>
  5738. <em>
  5739. string
  5740. </em>
  5741. </td>
  5742. <td>
  5743. <em>(Optional)</em>
  5744. <p>Used to select a specific version of the Provider value, if supported</p>
  5745. </td>
  5746. </tr>
  5747. <tr>
  5748. <td>
  5749. <code>conversionStrategy</code></br>
  5750. <em>
  5751. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5752. ExternalSecretConversionStrategy
  5753. </a>
  5754. </em>
  5755. </td>
  5756. <td>
  5757. <em>(Optional)</em>
  5758. <p>Used to define a conversion Strategy</p>
  5759. </td>
  5760. </tr>
  5761. <tr>
  5762. <td>
  5763. <code>decodingStrategy</code></br>
  5764. <em>
  5765. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5766. ExternalSecretDecodingStrategy
  5767. </a>
  5768. </em>
  5769. </td>
  5770. <td>
  5771. <em>(Optional)</em>
  5772. <p>Used to define a decoding Strategy</p>
  5773. </td>
  5774. </tr>
  5775. <tr>
  5776. <td>
  5777. <code>nullBytePolicy</code></br>
  5778. <em>
  5779. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  5780. ExternalSecretNullBytePolicy
  5781. </a>
  5782. </em>
  5783. </td>
  5784. <td>
  5785. <em>(Optional)</em>
  5786. <p>Controls how ESO handles fetched secret data containing NUL bytes for this source.</p>
  5787. </td>
  5788. </tr>
  5789. </tbody>
  5790. </table>
  5791. <h3 id="external-secrets.io/v1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  5792. (<code>string</code> alias)</p></h3>
  5793. <p>
  5794. (<em>Appears on:</em>
  5795. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5796. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>,
  5797. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  5798. </p>
  5799. <p>
  5800. <p>ExternalSecretDecodingStrategy defines strategies for decoding secret values.</p>
  5801. </p>
  5802. <table>
  5803. <thead>
  5804. <tr>
  5805. <th>Value</th>
  5806. <th>Description</th>
  5807. </tr>
  5808. </thead>
  5809. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  5810. <td><p>ExternalSecretDecodeAuto specifies automatic detection of the decoding method.</p>
  5811. </td>
  5812. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  5813. <td><p>ExternalSecretDecodeBase64 specifies that values should be decoded using Base64.</p>
  5814. </td>
  5815. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  5816. <td><p>ExternalSecretDecodeBase64URL specifies that values should be decoded using Base64URL.</p>
  5817. </td>
  5818. </tr><tr><td><p>&#34;None&#34;</p></td>
  5819. <td><p>ExternalSecretDecodeNone specifies that no decoding should be performed.</p>
  5820. </td>
  5821. </tr></tbody>
  5822. </table>
  5823. <h3 id="external-secrets.io/v1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  5824. (<code>string</code> alias)</p></h3>
  5825. <p>
  5826. (<em>Appears on:</em>
  5827. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5828. </p>
  5829. <p>
  5830. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  5831. </p>
  5832. <table>
  5833. <thead>
  5834. <tr>
  5835. <th>Value</th>
  5836. <th>Description</th>
  5837. </tr>
  5838. </thead>
  5839. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  5840. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  5841. If a secret gets deleted on the provider side and is not accessible
  5842. anymore this is not considered an error and the ExternalSecret
  5843. does not go into SecretSyncedError status.</p>
  5844. </td>
  5845. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  5846. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  5847. If a secret gets deleted on the provider side and is not accessible
  5848. anymore this is not considered an error and the ExternalSecret
  5849. does not go into SecretSyncedError status.</p>
  5850. </td>
  5851. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  5852. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  5853. If a provider secret does not exist the ExternalSecret gets into the
  5854. SecretSyncedError status.</p>
  5855. </td>
  5856. </tr></tbody>
  5857. </table>
  5858. <h3 id="external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind
  5859. </h3>
  5860. <p>
  5861. (<em>Appears on:</em>
  5862. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5863. </p>
  5864. <p>
  5865. <p>ExternalSecretFind defines configuration for finding secrets in the provider.</p>
  5866. </p>
  5867. <table>
  5868. <thead>
  5869. <tr>
  5870. <th>Field</th>
  5871. <th>Description</th>
  5872. </tr>
  5873. </thead>
  5874. <tbody>
  5875. <tr>
  5876. <td>
  5877. <code>path</code></br>
  5878. <em>
  5879. string
  5880. </em>
  5881. </td>
  5882. <td>
  5883. <em>(Optional)</em>
  5884. <p>A root path to start the find operations.</p>
  5885. </td>
  5886. </tr>
  5887. <tr>
  5888. <td>
  5889. <code>name</code></br>
  5890. <em>
  5891. <a href="#external-secrets.io/v1.FindName">
  5892. FindName
  5893. </a>
  5894. </em>
  5895. </td>
  5896. <td>
  5897. <em>(Optional)</em>
  5898. <p>Finds secrets based on the name.</p>
  5899. </td>
  5900. </tr>
  5901. <tr>
  5902. <td>
  5903. <code>tags</code></br>
  5904. <em>
  5905. map[string]string
  5906. </em>
  5907. </td>
  5908. <td>
  5909. <em>(Optional)</em>
  5910. <p>Find secrets based on tags.</p>
  5911. </td>
  5912. </tr>
  5913. <tr>
  5914. <td>
  5915. <code>conversionStrategy</code></br>
  5916. <em>
  5917. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5918. ExternalSecretConversionStrategy
  5919. </a>
  5920. </em>
  5921. </td>
  5922. <td>
  5923. <em>(Optional)</em>
  5924. <p>Used to define a conversion Strategy</p>
  5925. </td>
  5926. </tr>
  5927. <tr>
  5928. <td>
  5929. <code>decodingStrategy</code></br>
  5930. <em>
  5931. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5932. ExternalSecretDecodingStrategy
  5933. </a>
  5934. </em>
  5935. </td>
  5936. <td>
  5937. <em>(Optional)</em>
  5938. <p>Used to define a decoding Strategy</p>
  5939. </td>
  5940. </tr>
  5941. <tr>
  5942. <td>
  5943. <code>nullBytePolicy</code></br>
  5944. <em>
  5945. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  5946. ExternalSecretNullBytePolicy
  5947. </a>
  5948. </em>
  5949. </td>
  5950. <td>
  5951. <em>(Optional)</em>
  5952. <p>Controls how ESO handles fetched secret data containing NUL bytes for this find source.</p>
  5953. </td>
  5954. </tr>
  5955. </tbody>
  5956. </table>
  5957. <h3 id="external-secrets.io/v1.ExternalSecretMetadata">ExternalSecretMetadata
  5958. </h3>
  5959. <p>
  5960. (<em>Appears on:</em>
  5961. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  5962. </p>
  5963. <p>
  5964. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  5965. </p>
  5966. <table>
  5967. <thead>
  5968. <tr>
  5969. <th>Field</th>
  5970. <th>Description</th>
  5971. </tr>
  5972. </thead>
  5973. <tbody>
  5974. <tr>
  5975. <td>
  5976. <code>annotations</code></br>
  5977. <em>
  5978. map[string]string
  5979. </em>
  5980. </td>
  5981. <td>
  5982. <em>(Optional)</em>
  5983. </td>
  5984. </tr>
  5985. <tr>
  5986. <td>
  5987. <code>labels</code></br>
  5988. <em>
  5989. map[string]string
  5990. </em>
  5991. </td>
  5992. <td>
  5993. <em>(Optional)</em>
  5994. </td>
  5995. </tr>
  5996. </tbody>
  5997. </table>
  5998. <h3 id="external-secrets.io/v1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  5999. (<code>string</code> alias)</p></h3>
  6000. <p>
  6001. (<em>Appears on:</em>
  6002. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  6003. </p>
  6004. <p>
  6005. <p>ExternalSecretMetadataPolicy defines policies for fetching metadata from provider secrets.</p>
  6006. </p>
  6007. <table>
  6008. <thead>
  6009. <tr>
  6010. <th>Value</th>
  6011. <th>Description</th>
  6012. </tr>
  6013. </thead>
  6014. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  6015. <td><p>ExternalSecretMetadataPolicyFetch specifies that metadata should be fetched from the provider.</p>
  6016. </td>
  6017. </tr><tr><td><p>&#34;None&#34;</p></td>
  6018. <td><p>ExternalSecretMetadataPolicyNone specifies that no metadata should be fetched from the provider.</p>
  6019. </td>
  6020. </tr></tbody>
  6021. </table>
  6022. <h3 id="external-secrets.io/v1.ExternalSecretNullBytePolicy">ExternalSecretNullBytePolicy
  6023. (<code>string</code> alias)</p></h3>
  6024. <p>
  6025. (<em>Appears on:</em>
  6026. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  6027. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  6028. </p>
  6029. <p>
  6030. <p>ExternalSecretNullBytePolicy defines how fetched secret data containing NUL bytes should be handled.</p>
  6031. </p>
  6032. <table>
  6033. <thead>
  6034. <tr>
  6035. <th>Value</th>
  6036. <th>Description</th>
  6037. </tr>
  6038. </thead>
  6039. <tbody><tr><td><p>&#34;Fail&#34;</p></td>
  6040. <td><p>ExternalSecretNullBytePolicyFail fails reconciliation if fetched secret data contains NUL bytes.</p>
  6041. </td>
  6042. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  6043. <td><p>ExternalSecretNullBytePolicyIgnore allows fetched secret data to contain NUL bytes.</p>
  6044. </td>
  6045. </tr></tbody>
  6046. </table>
  6047. <h3 id="external-secrets.io/v1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  6048. (<code>string</code> alias)</p></h3>
  6049. <p>
  6050. (<em>Appears on:</em>
  6051. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6052. </p>
  6053. <p>
  6054. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  6055. </p>
  6056. <table>
  6057. <thead>
  6058. <tr>
  6059. <th>Value</th>
  6060. <th>Description</th>
  6061. </tr>
  6062. </thead>
  6063. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  6064. <td><p>RefreshPolicyCreatedOnce creates the Secret once and does not update it thereafter.</p>
  6065. </td>
  6066. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  6067. <td><p>RefreshPolicyOnChange only synchronizes when the ExternalSecret&rsquo;s metadata or spec changes.</p>
  6068. </td>
  6069. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  6070. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the provider at regular intervals.</p>
  6071. </td>
  6072. </tr></tbody>
  6073. </table>
  6074. <h3 id="external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite
  6075. </h3>
  6076. <p>
  6077. (<em>Appears on:</em>
  6078. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  6079. </p>
  6080. <p>
  6081. <p>ExternalSecretRewrite defines how to rewrite secret data values before they are written to the Secret.</p>
  6082. </p>
  6083. <table>
  6084. <thead>
  6085. <tr>
  6086. <th>Field</th>
  6087. <th>Description</th>
  6088. </tr>
  6089. </thead>
  6090. <tbody>
  6091. <tr>
  6092. <td>
  6093. <code>merge</code></br>
  6094. <em>
  6095. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">
  6096. ExternalSecretRewriteMerge
  6097. </a>
  6098. </em>
  6099. </td>
  6100. <td>
  6101. <em>(Optional)</em>
  6102. <p>Used to merge key/values in one single Secret
  6103. The resulting key will contain all values from the specified secrets</p>
  6104. </td>
  6105. </tr>
  6106. <tr>
  6107. <td>
  6108. <code>regexp</code></br>
  6109. <em>
  6110. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  6111. ExternalSecretRewriteRegexp
  6112. </a>
  6113. </em>
  6114. </td>
  6115. <td>
  6116. <em>(Optional)</em>
  6117. <p>Used to rewrite with regular expressions.
  6118. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  6119. </td>
  6120. </tr>
  6121. <tr>
  6122. <td>
  6123. <code>transform</code></br>
  6124. <em>
  6125. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  6126. ExternalSecretRewriteTransform
  6127. </a>
  6128. </em>
  6129. </td>
  6130. <td>
  6131. <em>(Optional)</em>
  6132. <p>Used to apply string transformation on the secrets.
  6133. The resulting key will be the output of the template applied by the operation.</p>
  6134. </td>
  6135. </tr>
  6136. </tbody>
  6137. </table>
  6138. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge
  6139. </h3>
  6140. <p>
  6141. (<em>Appears on:</em>
  6142. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  6143. </p>
  6144. <p>
  6145. <p>ExternalSecretRewriteMerge defines configuration for merging secret values.</p>
  6146. </p>
  6147. <table>
  6148. <thead>
  6149. <tr>
  6150. <th>Field</th>
  6151. <th>Description</th>
  6152. </tr>
  6153. </thead>
  6154. <tbody>
  6155. <tr>
  6156. <td>
  6157. <code>into</code></br>
  6158. <em>
  6159. string
  6160. </em>
  6161. </td>
  6162. <td>
  6163. <em>(Optional)</em>
  6164. <p>Used to define the target key of the merge operation.
  6165. Required if strategy is JSON. Ignored otherwise.</p>
  6166. </td>
  6167. </tr>
  6168. <tr>
  6169. <td>
  6170. <code>priority</code></br>
  6171. <em>
  6172. []string
  6173. </em>
  6174. </td>
  6175. <td>
  6176. <em>(Optional)</em>
  6177. <p>Used to define key priority in conflict resolution.</p>
  6178. </td>
  6179. </tr>
  6180. <tr>
  6181. <td>
  6182. <code>priorityPolicy</code></br>
  6183. <em>
  6184. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">
  6185. ExternalSecretRewriteMergePriorityPolicy
  6186. </a>
  6187. </em>
  6188. </td>
  6189. <td>
  6190. <em>(Optional)</em>
  6191. <p>Used to define the policy when a key in the priority list does not exist in the input.</p>
  6192. </td>
  6193. </tr>
  6194. <tr>
  6195. <td>
  6196. <code>conflictPolicy</code></br>
  6197. <em>
  6198. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">
  6199. ExternalSecretRewriteMergeConflictPolicy
  6200. </a>
  6201. </em>
  6202. </td>
  6203. <td>
  6204. <em>(Optional)</em>
  6205. <p>Used to define the policy to use in conflict resolution.</p>
  6206. </td>
  6207. </tr>
  6208. <tr>
  6209. <td>
  6210. <code>strategy</code></br>
  6211. <em>
  6212. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">
  6213. ExternalSecretRewriteMergeStrategy
  6214. </a>
  6215. </em>
  6216. </td>
  6217. <td>
  6218. <em>(Optional)</em>
  6219. <p>Used to define the strategy to use in the merge operation.</p>
  6220. </td>
  6221. </tr>
  6222. </tbody>
  6223. </table>
  6224. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">ExternalSecretRewriteMergeConflictPolicy
  6225. (<code>string</code> alias)</p></h3>
  6226. <p>
  6227. (<em>Appears on:</em>
  6228. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6229. </p>
  6230. <p>
  6231. <p>ExternalSecretRewriteMergeConflictPolicy defines the policy for resolving conflicts when merging secrets.</p>
  6232. </p>
  6233. <table>
  6234. <thead>
  6235. <tr>
  6236. <th>Value</th>
  6237. <th>Description</th>
  6238. </tr>
  6239. </thead>
  6240. <tbody><tr><td><p>&#34;Error&#34;</p></td>
  6241. <td><p>ExternalSecretRewriteMergeConflictPolicyError returns an error when conflicts occur during merge.</p>
  6242. </td>
  6243. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  6244. <td><p>ExternalSecretRewriteMergeConflictPolicyIgnore ignores conflicts when merging secret values.</p>
  6245. </td>
  6246. </tr></tbody>
  6247. </table>
  6248. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">ExternalSecretRewriteMergePriorityPolicy
  6249. (<code>string</code> alias)</p></h3>
  6250. <p>
  6251. (<em>Appears on:</em>
  6252. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6253. </p>
  6254. <p>
  6255. <p>ExternalSecretRewriteMergePriorityPolicy defines the policy for handling missing keys in the priority
  6256. list during merge operations.</p>
  6257. </p>
  6258. <table>
  6259. <thead>
  6260. <tr>
  6261. <th>Value</th>
  6262. <th>Description</th>
  6263. </tr>
  6264. </thead>
  6265. <tbody><tr><td><p>&#34;IgnoreNotFound&#34;</p></td>
  6266. <td></td>
  6267. </tr><tr><td><p>&#34;Strict&#34;</p></td>
  6268. <td></td>
  6269. </tr></tbody>
  6270. </table>
  6271. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">ExternalSecretRewriteMergeStrategy
  6272. (<code>string</code> alias)</p></h3>
  6273. <p>
  6274. (<em>Appears on:</em>
  6275. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6276. </p>
  6277. <p>
  6278. <p>ExternalSecretRewriteMergeStrategy defines the strategy for merging secrets.</p>
  6279. </p>
  6280. <table>
  6281. <thead>
  6282. <tr>
  6283. <th>Value</th>
  6284. <th>Description</th>
  6285. </tr>
  6286. </thead>
  6287. <tbody><tr><td><p>&#34;Extract&#34;</p></td>
  6288. <td><p>ExternalSecretRewriteMergeStrategyExtract merges secrets by extracting values.</p>
  6289. </td>
  6290. </tr><tr><td><p>&#34;JSON&#34;</p></td>
  6291. <td><p>ExternalSecretRewriteMergeStrategyJSON merges secrets using JSON merge strategy.</p>
  6292. </td>
  6293. </tr></tbody>
  6294. </table>
  6295. <h3 id="external-secrets.io/v1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  6296. </h3>
  6297. <p>
  6298. (<em>Appears on:</em>
  6299. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  6300. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  6301. </p>
  6302. <p>
  6303. <p>ExternalSecretRewriteRegexp defines configuration for rewriting secrets using regular expressions.</p>
  6304. </p>
  6305. <table>
  6306. <thead>
  6307. <tr>
  6308. <th>Field</th>
  6309. <th>Description</th>
  6310. </tr>
  6311. </thead>
  6312. <tbody>
  6313. <tr>
  6314. <td>
  6315. <code>source</code></br>
  6316. <em>
  6317. string
  6318. </em>
  6319. </td>
  6320. <td>
  6321. <p>Used to define the regular expression of a re.Compiler.</p>
  6322. </td>
  6323. </tr>
  6324. <tr>
  6325. <td>
  6326. <code>target</code></br>
  6327. <em>
  6328. string
  6329. </em>
  6330. </td>
  6331. <td>
  6332. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  6333. </td>
  6334. </tr>
  6335. </tbody>
  6336. </table>
  6337. <h3 id="external-secrets.io/v1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  6338. </h3>
  6339. <p>
  6340. (<em>Appears on:</em>
  6341. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  6342. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  6343. </p>
  6344. <p>
  6345. <p>ExternalSecretRewriteTransform defines configuration for transforming secrets using templates.</p>
  6346. </p>
  6347. <table>
  6348. <thead>
  6349. <tr>
  6350. <th>Field</th>
  6351. <th>Description</th>
  6352. </tr>
  6353. </thead>
  6354. <tbody>
  6355. <tr>
  6356. <td>
  6357. <code>template</code></br>
  6358. <em>
  6359. string
  6360. </em>
  6361. </td>
  6362. <td>
  6363. <p>Used to define the template to apply on the secret name.
  6364. <code>.value</code> will specify the secret name in the template.</p>
  6365. </td>
  6366. </tr>
  6367. </tbody>
  6368. </table>
  6369. <h3 id="external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec
  6370. </h3>
  6371. <p>
  6372. (<em>Appears on:</em>
  6373. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  6374. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6375. </p>
  6376. <p>
  6377. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  6378. </p>
  6379. <table>
  6380. <thead>
  6381. <tr>
  6382. <th>Field</th>
  6383. <th>Description</th>
  6384. </tr>
  6385. </thead>
  6386. <tbody>
  6387. <tr>
  6388. <td>
  6389. <code>secretStoreRef</code></br>
  6390. <em>
  6391. <a href="#external-secrets.io/v1.SecretStoreRef">
  6392. SecretStoreRef
  6393. </a>
  6394. </em>
  6395. </td>
  6396. <td>
  6397. <em>(Optional)</em>
  6398. </td>
  6399. </tr>
  6400. <tr>
  6401. <td>
  6402. <code>target</code></br>
  6403. <em>
  6404. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  6405. ExternalSecretTarget
  6406. </a>
  6407. </em>
  6408. </td>
  6409. <td>
  6410. <em>(Optional)</em>
  6411. </td>
  6412. </tr>
  6413. <tr>
  6414. <td>
  6415. <code>refreshPolicy</code></br>
  6416. <em>
  6417. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  6418. ExternalSecretRefreshPolicy
  6419. </a>
  6420. </em>
  6421. </td>
  6422. <td>
  6423. <em>(Optional)</em>
  6424. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  6425. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  6426. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  6427. No periodic updates occur if refreshInterval is 0.
  6428. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  6429. </td>
  6430. </tr>
  6431. <tr>
  6432. <td>
  6433. <code>refreshInterval</code></br>
  6434. <em>
  6435. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6436. Kubernetes meta/v1.Duration
  6437. </a>
  6438. </em>
  6439. </td>
  6440. <td>
  6441. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  6442. specified as Golang Duration strings.
  6443. 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;
  6444. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  6445. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  6446. </td>
  6447. </tr>
  6448. <tr>
  6449. <td>
  6450. <code>syncWindows</code></br>
  6451. <em>
  6452. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">
  6453. ExternalSecretSyncWindows
  6454. </a>
  6455. </em>
  6456. </td>
  6457. <td>
  6458. <em>(Optional)</em>
  6459. <p>SyncWindows optionally restricts when periodic refreshes may occur.
  6460. Evaluated in UTC, only for Periodic refresh policy (or when refreshPolicy is unset).</p>
  6461. </td>
  6462. </tr>
  6463. <tr>
  6464. <td>
  6465. <code>data</code></br>
  6466. <em>
  6467. <a href="#external-secrets.io/v1.ExternalSecretData">
  6468. []ExternalSecretData
  6469. </a>
  6470. </em>
  6471. </td>
  6472. <td>
  6473. <em>(Optional)</em>
  6474. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  6475. </td>
  6476. </tr>
  6477. <tr>
  6478. <td>
  6479. <code>dataFrom</code></br>
  6480. <em>
  6481. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  6482. []ExternalSecretDataFromRemoteRef
  6483. </a>
  6484. </em>
  6485. </td>
  6486. <td>
  6487. <em>(Optional)</em>
  6488. <p>DataFrom is used to fetch all properties from a specific Provider data
  6489. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  6490. </td>
  6491. </tr>
  6492. </tbody>
  6493. </table>
  6494. <h3 id="external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus
  6495. </h3>
  6496. <p>
  6497. (<em>Appears on:</em>
  6498. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6499. </p>
  6500. <p>
  6501. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  6502. </p>
  6503. <table>
  6504. <thead>
  6505. <tr>
  6506. <th>Field</th>
  6507. <th>Description</th>
  6508. </tr>
  6509. </thead>
  6510. <tbody>
  6511. <tr>
  6512. <td>
  6513. <code>refreshTime</code></br>
  6514. <em>
  6515. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6516. Kubernetes meta/v1.Time
  6517. </a>
  6518. </em>
  6519. </td>
  6520. <td>
  6521. <p>refreshTime is the time and date the external secret was fetched and
  6522. the target secret updated</p>
  6523. </td>
  6524. </tr>
  6525. <tr>
  6526. <td>
  6527. <code>syncedResourceVersion</code></br>
  6528. <em>
  6529. string
  6530. </em>
  6531. </td>
  6532. <td>
  6533. <p>SyncedResourceVersion keeps track of the last synced version</p>
  6534. </td>
  6535. </tr>
  6536. <tr>
  6537. <td>
  6538. <code>conditions</code></br>
  6539. <em>
  6540. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">
  6541. []ExternalSecretStatusCondition
  6542. </a>
  6543. </em>
  6544. </td>
  6545. <td>
  6546. <em>(Optional)</em>
  6547. </td>
  6548. </tr>
  6549. <tr>
  6550. <td>
  6551. <code>binding</code></br>
  6552. <em>
  6553. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  6554. Kubernetes core/v1.LocalObjectReference
  6555. </a>
  6556. </em>
  6557. </td>
  6558. <td>
  6559. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  6560. </td>
  6561. </tr>
  6562. </tbody>
  6563. </table>
  6564. <h3 id="external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  6565. </h3>
  6566. <p>
  6567. (<em>Appears on:</em>
  6568. <a href="#external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus</a>)
  6569. </p>
  6570. <p>
  6571. <p>ExternalSecretStatusCondition defines a status condition of an ExternalSecret resource.</p>
  6572. </p>
  6573. <table>
  6574. <thead>
  6575. <tr>
  6576. <th>Field</th>
  6577. <th>Description</th>
  6578. </tr>
  6579. </thead>
  6580. <tbody>
  6581. <tr>
  6582. <td>
  6583. <code>type</code></br>
  6584. <em>
  6585. <a href="#external-secrets.io/v1.ExternalSecretConditionType">
  6586. ExternalSecretConditionType
  6587. </a>
  6588. </em>
  6589. </td>
  6590. <td>
  6591. </td>
  6592. </tr>
  6593. <tr>
  6594. <td>
  6595. <code>status</code></br>
  6596. <em>
  6597. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  6598. Kubernetes core/v1.ConditionStatus
  6599. </a>
  6600. </em>
  6601. </td>
  6602. <td>
  6603. </td>
  6604. </tr>
  6605. <tr>
  6606. <td>
  6607. <code>reason</code></br>
  6608. <em>
  6609. string
  6610. </em>
  6611. </td>
  6612. <td>
  6613. <em>(Optional)</em>
  6614. </td>
  6615. </tr>
  6616. <tr>
  6617. <td>
  6618. <code>message</code></br>
  6619. <em>
  6620. string
  6621. </em>
  6622. </td>
  6623. <td>
  6624. <em>(Optional)</em>
  6625. </td>
  6626. </tr>
  6627. <tr>
  6628. <td>
  6629. <code>lastTransitionTime</code></br>
  6630. <em>
  6631. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6632. Kubernetes meta/v1.Time
  6633. </a>
  6634. </em>
  6635. </td>
  6636. <td>
  6637. <em>(Optional)</em>
  6638. </td>
  6639. </tr>
  6640. </tbody>
  6641. </table>
  6642. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindowEntry">ExternalSecretSyncWindowEntry
  6643. </h3>
  6644. <p>
  6645. (<em>Appears on:</em>
  6646. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows</a>)
  6647. </p>
  6648. <p>
  6649. <p>ExternalSecretSyncWindowEntry defines a single cron-schedule + duration pair
  6650. within a SyncWindows block.</p>
  6651. </p>
  6652. <table>
  6653. <thead>
  6654. <tr>
  6655. <th>Field</th>
  6656. <th>Description</th>
  6657. </tr>
  6658. </thead>
  6659. <tbody>
  6660. <tr>
  6661. <td>
  6662. <code>schedule</code></br>
  6663. <em>
  6664. string
  6665. </em>
  6666. </td>
  6667. <td>
  6668. <p>Schedule is a standard 5-field cron expression evaluated in UTC, or a
  6669. named shorthand such as @daily or @every 1h. It marks the start time of
  6670. each window occurrence.
  6671. Example: &ldquo;0 22 * * 1-5&rdquo; opens a window every weekday at 22:00 UTC.</p>
  6672. </td>
  6673. </tr>
  6674. <tr>
  6675. <td>
  6676. <code>duration</code></br>
  6677. <em>
  6678. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6679. Kubernetes meta/v1.Duration
  6680. </a>
  6681. </em>
  6682. </td>
  6683. <td>
  6684. <p>Duration specifies how long the window stays open after each Schedule
  6685. firing. Example: &ldquo;8h&rdquo;.</p>
  6686. </td>
  6687. </tr>
  6688. </tbody>
  6689. </table>
  6690. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindowKind">ExternalSecretSyncWindowKind
  6691. (<code>string</code> alias)</p></h3>
  6692. <p>
  6693. (<em>Appears on:</em>
  6694. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows</a>)
  6695. </p>
  6696. <p>
  6697. <p>ExternalSecretSyncWindowKind defines whether a SyncWindow permits or
  6698. blocks periodic refreshes.</p>
  6699. </p>
  6700. <table>
  6701. <thead>
  6702. <tr>
  6703. <th>Value</th>
  6704. <th>Description</th>
  6705. </tr>
  6706. </thead>
  6707. <tbody><tr><td><p>&#34;allow&#34;</p></td>
  6708. <td><p>SyncWindowAllow allows periodic refreshes only while at least one window
  6709. in the list is active. Refreshes are blocked at all other times.</p>
  6710. </td>
  6711. </tr><tr><td><p>&#34;deny&#34;</p></td>
  6712. <td><p>SyncWindowDeny blocks periodic refreshes while any window in the list is
  6713. active. Refreshes proceed normally at all other times.</p>
  6714. </td>
  6715. </tr></tbody>
  6716. </table>
  6717. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows
  6718. </h3>
  6719. <p>
  6720. (<em>Appears on:</em>
  6721. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6722. </p>
  6723. <p>
  6724. <p>ExternalSecretSyncWindows optionally restricts when periodic syncs may occur.
  6725. All windows in the list share the same Kind.</p>
  6726. </p>
  6727. <table>
  6728. <thead>
  6729. <tr>
  6730. <th>Field</th>
  6731. <th>Description</th>
  6732. </tr>
  6733. </thead>
  6734. <tbody>
  6735. <tr>
  6736. <td>
  6737. <code>kind</code></br>
  6738. <em>
  6739. <a href="#external-secrets.io/v1.ExternalSecretSyncWindowKind">
  6740. ExternalSecretSyncWindowKind
  6741. </a>
  6742. </em>
  6743. </td>
  6744. <td>
  6745. <p>Kind applies to every window in the list.
  6746. &ldquo;allow&rdquo; &ndash; syncs are permitted only while at least one window is active;
  6747. all other times are blocked.
  6748. &ldquo;deny&rdquo; &ndash; syncs are blocked while any window is active;
  6749. all other times are permitted.</p>
  6750. </td>
  6751. </tr>
  6752. <tr>
  6753. <td>
  6754. <code>windows</code></br>
  6755. <em>
  6756. <a href="#external-secrets.io/v1.ExternalSecretSyncWindowEntry">
  6757. []ExternalSecretSyncWindowEntry
  6758. </a>
  6759. </em>
  6760. </td>
  6761. <td>
  6762. <p>Windows is the list of schedule+duration pairs.</p>
  6763. </td>
  6764. </tr>
  6765. </tbody>
  6766. </table>
  6767. <h3 id="external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget
  6768. </h3>
  6769. <p>
  6770. (<em>Appears on:</em>
  6771. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6772. </p>
  6773. <p>
  6774. <p>ExternalSecretTarget defines the Kubernetes Secret to be created,
  6775. there can be only one target per ExternalSecret.</p>
  6776. </p>
  6777. <table>
  6778. <thead>
  6779. <tr>
  6780. <th>Field</th>
  6781. <th>Description</th>
  6782. </tr>
  6783. </thead>
  6784. <tbody>
  6785. <tr>
  6786. <td>
  6787. <code>name</code></br>
  6788. <em>
  6789. string
  6790. </em>
  6791. </td>
  6792. <td>
  6793. <em>(Optional)</em>
  6794. <p>The name of the Secret resource to be managed.
  6795. Defaults to the .metadata.name of the ExternalSecret resource</p>
  6796. </td>
  6797. </tr>
  6798. <tr>
  6799. <td>
  6800. <code>creationPolicy</code></br>
  6801. <em>
  6802. <a href="#external-secrets.io/v1.ExternalSecretCreationPolicy">
  6803. ExternalSecretCreationPolicy
  6804. </a>
  6805. </em>
  6806. </td>
  6807. <td>
  6808. <em>(Optional)</em>
  6809. <p>CreationPolicy defines rules on how to create the resulting Secret.
  6810. Defaults to &ldquo;Owner&rdquo;</p>
  6811. </td>
  6812. </tr>
  6813. <tr>
  6814. <td>
  6815. <code>deletionPolicy</code></br>
  6816. <em>
  6817. <a href="#external-secrets.io/v1.ExternalSecretDeletionPolicy">
  6818. ExternalSecretDeletionPolicy
  6819. </a>
  6820. </em>
  6821. </td>
  6822. <td>
  6823. <em>(Optional)</em>
  6824. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  6825. Defaults to &ldquo;Retain&rdquo;</p>
  6826. </td>
  6827. </tr>
  6828. <tr>
  6829. <td>
  6830. <code>template</code></br>
  6831. <em>
  6832. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  6833. ExternalSecretTemplate
  6834. </a>
  6835. </em>
  6836. </td>
  6837. <td>
  6838. <em>(Optional)</em>
  6839. <p>Template defines a blueprint for the created Secret resource.</p>
  6840. </td>
  6841. </tr>
  6842. <tr>
  6843. <td>
  6844. <code>manifest</code></br>
  6845. <em>
  6846. <a href="#external-secrets.io/v1.ManifestReference">
  6847. ManifestReference
  6848. </a>
  6849. </em>
  6850. </td>
  6851. <td>
  6852. <em>(Optional)</em>
  6853. <p>Manifest defines a custom Kubernetes resource to create instead of a Secret.
  6854. When specified, ExternalSecret will create the resource type defined here
  6855. (e.g., ConfigMap, Custom Resource) instead of a Secret.
  6856. Warning: Using Generic target. Make sure access policies and encryption are properly configured.</p>
  6857. </td>
  6858. </tr>
  6859. <tr>
  6860. <td>
  6861. <code>immutable</code></br>
  6862. <em>
  6863. bool
  6864. </em>
  6865. </td>
  6866. <td>
  6867. <em>(Optional)</em>
  6868. <p>Immutable defines if the final secret will be immutable</p>
  6869. </td>
  6870. </tr>
  6871. </tbody>
  6872. </table>
  6873. <h3 id="external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate
  6874. </h3>
  6875. <p>
  6876. (<em>Appears on:</em>
  6877. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>,
  6878. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  6879. </p>
  6880. <p>
  6881. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  6882. 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>
  6883. </p>
  6884. <table>
  6885. <thead>
  6886. <tr>
  6887. <th>Field</th>
  6888. <th>Description</th>
  6889. </tr>
  6890. </thead>
  6891. <tbody>
  6892. <tr>
  6893. <td>
  6894. <code>type</code></br>
  6895. <em>
  6896. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  6897. Kubernetes core/v1.SecretType
  6898. </a>
  6899. </em>
  6900. </td>
  6901. <td>
  6902. <em>(Optional)</em>
  6903. </td>
  6904. </tr>
  6905. <tr>
  6906. <td>
  6907. <code>engineVersion</code></br>
  6908. <em>
  6909. <a href="#external-secrets.io/v1.TemplateEngineVersion">
  6910. TemplateEngineVersion
  6911. </a>
  6912. </em>
  6913. </td>
  6914. <td>
  6915. <p>EngineVersion specifies the template engine version
  6916. that should be used to compile/execute the
  6917. template specified in .data and .templateFrom[].</p>
  6918. </td>
  6919. </tr>
  6920. <tr>
  6921. <td>
  6922. <code>metadata</code></br>
  6923. <em>
  6924. <a href="#external-secrets.io/v1.ExternalSecretTemplateMetadata">
  6925. ExternalSecretTemplateMetadata
  6926. </a>
  6927. </em>
  6928. </td>
  6929. <td>
  6930. <em>(Optional)</em>
  6931. </td>
  6932. </tr>
  6933. <tr>
  6934. <td>
  6935. <code>mergePolicy</code></br>
  6936. <em>
  6937. <a href="#external-secrets.io/v1.TemplateMergePolicy">
  6938. TemplateMergePolicy
  6939. </a>
  6940. </em>
  6941. </td>
  6942. <td>
  6943. </td>
  6944. </tr>
  6945. <tr>
  6946. <td>
  6947. <code>data</code></br>
  6948. <em>
  6949. map[string]string
  6950. </em>
  6951. </td>
  6952. <td>
  6953. <em>(Optional)</em>
  6954. </td>
  6955. </tr>
  6956. <tr>
  6957. <td>
  6958. <code>templateFrom</code></br>
  6959. <em>
  6960. <a href="#external-secrets.io/v1.TemplateFrom">
  6961. []TemplateFrom
  6962. </a>
  6963. </em>
  6964. </td>
  6965. <td>
  6966. <em>(Optional)</em>
  6967. </td>
  6968. </tr>
  6969. </tbody>
  6970. </table>
  6971. <h3 id="external-secrets.io/v1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  6972. </h3>
  6973. <p>
  6974. (<em>Appears on:</em>
  6975. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  6976. </p>
  6977. <p>
  6978. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</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>annotations</code></br>
  6991. <em>
  6992. map[string]string
  6993. </em>
  6994. </td>
  6995. <td>
  6996. <em>(Optional)</em>
  6997. </td>
  6998. </tr>
  6999. <tr>
  7000. <td>
  7001. <code>labels</code></br>
  7002. <em>
  7003. map[string]string
  7004. </em>
  7005. </td>
  7006. <td>
  7007. <em>(Optional)</em>
  7008. </td>
  7009. </tr>
  7010. <tr>
  7011. <td>
  7012. <code>finalizers</code></br>
  7013. <em>
  7014. []string
  7015. </em>
  7016. </td>
  7017. <td>
  7018. <em>(Optional)</em>
  7019. </td>
  7020. </tr>
  7021. </tbody>
  7022. </table>
  7023. <h3 id="external-secrets.io/v1.ExternalSecretValidator">ExternalSecretValidator
  7024. </h3>
  7025. <p>
  7026. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  7027. </p>
  7028. <h3 id="external-secrets.io/v1.FakeProvider">FakeProvider
  7029. </h3>
  7030. <p>
  7031. (<em>Appears on:</em>
  7032. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7033. </p>
  7034. <p>
  7035. <p>FakeProvider configures a fake provider that returns static values.</p>
  7036. </p>
  7037. <table>
  7038. <thead>
  7039. <tr>
  7040. <th>Field</th>
  7041. <th>Description</th>
  7042. </tr>
  7043. </thead>
  7044. <tbody>
  7045. <tr>
  7046. <td>
  7047. <code>data</code></br>
  7048. <em>
  7049. <a href="#external-secrets.io/v1.FakeProviderData">
  7050. []FakeProviderData
  7051. </a>
  7052. </em>
  7053. </td>
  7054. <td>
  7055. </td>
  7056. </tr>
  7057. <tr>
  7058. <td>
  7059. <code>validationResult</code></br>
  7060. <em>
  7061. <a href="#external-secrets.io/v1.ValidationResult">
  7062. ValidationResult
  7063. </a>
  7064. </em>
  7065. </td>
  7066. <td>
  7067. </td>
  7068. </tr>
  7069. </tbody>
  7070. </table>
  7071. <h3 id="external-secrets.io/v1.FakeProviderData">FakeProviderData
  7072. </h3>
  7073. <p>
  7074. (<em>Appears on:</em>
  7075. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  7076. </p>
  7077. <p>
  7078. <p>FakeProviderData defines a key-value pair with optional version for the fake provider.</p>
  7079. </p>
  7080. <table>
  7081. <thead>
  7082. <tr>
  7083. <th>Field</th>
  7084. <th>Description</th>
  7085. </tr>
  7086. </thead>
  7087. <tbody>
  7088. <tr>
  7089. <td>
  7090. <code>key</code></br>
  7091. <em>
  7092. string
  7093. </em>
  7094. </td>
  7095. <td>
  7096. </td>
  7097. </tr>
  7098. <tr>
  7099. <td>
  7100. <code>value</code></br>
  7101. <em>
  7102. string
  7103. </em>
  7104. </td>
  7105. <td>
  7106. </td>
  7107. </tr>
  7108. <tr>
  7109. <td>
  7110. <code>version</code></br>
  7111. <em>
  7112. string
  7113. </em>
  7114. </td>
  7115. <td>
  7116. </td>
  7117. </tr>
  7118. </tbody>
  7119. </table>
  7120. <h3 id="external-secrets.io/v1.FetchingPolicy">FetchingPolicy
  7121. </h3>
  7122. <p>
  7123. (<em>Appears on:</em>
  7124. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  7125. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  7126. </p>
  7127. <p>
  7128. <p>FetchingPolicy configures how the provider interprets the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret.</p>
  7129. </p>
  7130. <table>
  7131. <thead>
  7132. <tr>
  7133. <th>Field</th>
  7134. <th>Description</th>
  7135. </tr>
  7136. </thead>
  7137. <tbody>
  7138. <tr>
  7139. <td>
  7140. <code>byID</code></br>
  7141. <em>
  7142. <a href="#external-secrets.io/v1.ByID">
  7143. ByID
  7144. </a>
  7145. </em>
  7146. </td>
  7147. <td>
  7148. </td>
  7149. </tr>
  7150. <tr>
  7151. <td>
  7152. <code>byName</code></br>
  7153. <em>
  7154. <a href="#external-secrets.io/v1.ByName">
  7155. ByName
  7156. </a>
  7157. </em>
  7158. </td>
  7159. <td>
  7160. </td>
  7161. </tr>
  7162. </tbody>
  7163. </table>
  7164. <h3 id="external-secrets.io/v1.FindName">FindName
  7165. </h3>
  7166. <p>
  7167. (<em>Appears on:</em>
  7168. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  7169. </p>
  7170. <p>
  7171. <p>FindName defines criteria for finding secrets by name patterns.</p>
  7172. </p>
  7173. <table>
  7174. <thead>
  7175. <tr>
  7176. <th>Field</th>
  7177. <th>Description</th>
  7178. </tr>
  7179. </thead>
  7180. <tbody>
  7181. <tr>
  7182. <td>
  7183. <code>regexp</code></br>
  7184. <em>
  7185. string
  7186. </em>
  7187. </td>
  7188. <td>
  7189. <em>(Optional)</em>
  7190. <p>Finds secrets base</p>
  7191. </td>
  7192. </tr>
  7193. </tbody>
  7194. </table>
  7195. <h3 id="external-secrets.io/v1.FortanixProvider">FortanixProvider
  7196. </h3>
  7197. <p>
  7198. (<em>Appears on:</em>
  7199. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7200. </p>
  7201. <p>
  7202. <p>FortanixProvider provides access to Fortanix SDKMS API using the provided credentials.</p>
  7203. </p>
  7204. <table>
  7205. <thead>
  7206. <tr>
  7207. <th>Field</th>
  7208. <th>Description</th>
  7209. </tr>
  7210. </thead>
  7211. <tbody>
  7212. <tr>
  7213. <td>
  7214. <code>apiUrl</code></br>
  7215. <em>
  7216. string
  7217. </em>
  7218. </td>
  7219. <td>
  7220. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  7221. </td>
  7222. </tr>
  7223. <tr>
  7224. <td>
  7225. <code>apiKey</code></br>
  7226. <em>
  7227. <a href="#external-secrets.io/v1.FortanixProviderSecretRef">
  7228. FortanixProviderSecretRef
  7229. </a>
  7230. </em>
  7231. </td>
  7232. <td>
  7233. <p>APIKey is the API token to access SDKMS Applications.</p>
  7234. </td>
  7235. </tr>
  7236. </tbody>
  7237. </table>
  7238. <h3 id="external-secrets.io/v1.FortanixProviderSecretRef">FortanixProviderSecretRef
  7239. </h3>
  7240. <p>
  7241. (<em>Appears on:</em>
  7242. <a href="#external-secrets.io/v1.FortanixProvider">FortanixProvider</a>)
  7243. </p>
  7244. <p>
  7245. <p>FortanixProviderSecretRef is a secret reference containing the SDKMS API Key.</p>
  7246. </p>
  7247. <table>
  7248. <thead>
  7249. <tr>
  7250. <th>Field</th>
  7251. <th>Description</th>
  7252. </tr>
  7253. </thead>
  7254. <tbody>
  7255. <tr>
  7256. <td>
  7257. <code>secretRef</code></br>
  7258. <em>
  7259. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7260. External Secrets meta/v1.SecretKeySelector
  7261. </a>
  7262. </em>
  7263. </td>
  7264. <td>
  7265. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  7266. </td>
  7267. </tr>
  7268. </tbody>
  7269. </table>
  7270. <h3 id="external-secrets.io/v1.GCPSMAuth">GCPSMAuth
  7271. </h3>
  7272. <p>
  7273. (<em>Appears on:</em>
  7274. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  7275. </p>
  7276. <p>
  7277. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform Secret Manager.</p>
  7278. </p>
  7279. <table>
  7280. <thead>
  7281. <tr>
  7282. <th>Field</th>
  7283. <th>Description</th>
  7284. </tr>
  7285. </thead>
  7286. <tbody>
  7287. <tr>
  7288. <td>
  7289. <code>secretRef</code></br>
  7290. <em>
  7291. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  7292. GCPSMAuthSecretRef
  7293. </a>
  7294. </em>
  7295. </td>
  7296. <td>
  7297. <em>(Optional)</em>
  7298. </td>
  7299. </tr>
  7300. <tr>
  7301. <td>
  7302. <code>workloadIdentity</code></br>
  7303. <em>
  7304. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  7305. GCPWorkloadIdentity
  7306. </a>
  7307. </em>
  7308. </td>
  7309. <td>
  7310. <em>(Optional)</em>
  7311. </td>
  7312. </tr>
  7313. <tr>
  7314. <td>
  7315. <code>workloadIdentityFederation</code></br>
  7316. <em>
  7317. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  7318. GCPWorkloadIdentityFederation
  7319. </a>
  7320. </em>
  7321. </td>
  7322. <td>
  7323. <em>(Optional)</em>
  7324. </td>
  7325. </tr>
  7326. </tbody>
  7327. </table>
  7328. <h3 id="external-secrets.io/v1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  7329. </h3>
  7330. <p>
  7331. (<em>Appears on:</em>
  7332. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7333. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  7334. </p>
  7335. <p>
  7336. <p>GCPSMAuthSecretRef contains the secret references for GCP Secret Manager authentication.</p>
  7337. </p>
  7338. <table>
  7339. <thead>
  7340. <tr>
  7341. <th>Field</th>
  7342. <th>Description</th>
  7343. </tr>
  7344. </thead>
  7345. <tbody>
  7346. <tr>
  7347. <td>
  7348. <code>secretAccessKeySecretRef</code></br>
  7349. <em>
  7350. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7351. External Secrets meta/v1.SecretKeySelector
  7352. </a>
  7353. </em>
  7354. </td>
  7355. <td>
  7356. <em>(Optional)</em>
  7357. <p>The SecretAccessKey is used for authentication</p>
  7358. </td>
  7359. </tr>
  7360. </tbody>
  7361. </table>
  7362. <h3 id="external-secrets.io/v1.GCPSMProvider">GCPSMProvider
  7363. </h3>
  7364. <p>
  7365. (<em>Appears on:</em>
  7366. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7367. </p>
  7368. <p>
  7369. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  7370. </p>
  7371. <table>
  7372. <thead>
  7373. <tr>
  7374. <th>Field</th>
  7375. <th>Description</th>
  7376. </tr>
  7377. </thead>
  7378. <tbody>
  7379. <tr>
  7380. <td>
  7381. <code>auth</code></br>
  7382. <em>
  7383. <a href="#external-secrets.io/v1.GCPSMAuth">
  7384. GCPSMAuth
  7385. </a>
  7386. </em>
  7387. </td>
  7388. <td>
  7389. <em>(Optional)</em>
  7390. <p>Auth defines the information necessary to authenticate against GCP</p>
  7391. </td>
  7392. </tr>
  7393. <tr>
  7394. <td>
  7395. <code>projectID</code></br>
  7396. <em>
  7397. string
  7398. </em>
  7399. </td>
  7400. <td>
  7401. <p>ProjectID project where secret is located</p>
  7402. </td>
  7403. </tr>
  7404. <tr>
  7405. <td>
  7406. <code>location</code></br>
  7407. <em>
  7408. string
  7409. </em>
  7410. </td>
  7411. <td>
  7412. <p>Location optionally defines a location for a secret</p>
  7413. </td>
  7414. </tr>
  7415. <tr>
  7416. <td>
  7417. <code>secretVersionSelectionPolicy</code></br>
  7418. <em>
  7419. <a href="#external-secrets.io/v1.SecretVersionSelectionPolicy">
  7420. SecretVersionSelectionPolicy
  7421. </a>
  7422. </em>
  7423. </td>
  7424. <td>
  7425. <em>(Optional)</em>
  7426. <p>SecretVersionSelectionPolicy specifies how the provider selects a secret version
  7427. when &ldquo;latest&rdquo; is disabled or destroyed.
  7428. Possible values are:
  7429. - LatestOrFail: the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.
  7430. - LatestOrFetch: the provider falls back to fetching the latest version if the version is DESTROYED or DISABLED</p>
  7431. </td>
  7432. </tr>
  7433. </tbody>
  7434. </table>
  7435. <h3 id="external-secrets.io/v1.GCPWorkloadIdentity">GCPWorkloadIdentity
  7436. </h3>
  7437. <p>
  7438. (<em>Appears on:</em>
  7439. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7440. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  7441. </p>
  7442. <p>
  7443. <p>GCPWorkloadIdentity defines configuration for workload identity authentication to GCP.</p>
  7444. </p>
  7445. <table>
  7446. <thead>
  7447. <tr>
  7448. <th>Field</th>
  7449. <th>Description</th>
  7450. </tr>
  7451. </thead>
  7452. <tbody>
  7453. <tr>
  7454. <td>
  7455. <code>serviceAccountRef</code></br>
  7456. <em>
  7457. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7458. External Secrets meta/v1.ServiceAccountSelector
  7459. </a>
  7460. </em>
  7461. </td>
  7462. <td>
  7463. </td>
  7464. </tr>
  7465. <tr>
  7466. <td>
  7467. <code>clusterLocation</code></br>
  7468. <em>
  7469. string
  7470. </em>
  7471. </td>
  7472. <td>
  7473. <em>(Optional)</em>
  7474. <p>ClusterLocation is the location of the cluster
  7475. If not specified, it fetches information from the metadata server</p>
  7476. </td>
  7477. </tr>
  7478. <tr>
  7479. <td>
  7480. <code>clusterName</code></br>
  7481. <em>
  7482. string
  7483. </em>
  7484. </td>
  7485. <td>
  7486. <em>(Optional)</em>
  7487. <p>ClusterName is the name of the cluster
  7488. If not specified, it fetches information from the metadata server</p>
  7489. </td>
  7490. </tr>
  7491. <tr>
  7492. <td>
  7493. <code>clusterProjectID</code></br>
  7494. <em>
  7495. string
  7496. </em>
  7497. </td>
  7498. <td>
  7499. <em>(Optional)</em>
  7500. <p>ClusterProjectID is the project ID of the cluster
  7501. If not specified, it fetches information from the metadata server</p>
  7502. </td>
  7503. </tr>
  7504. </tbody>
  7505. </table>
  7506. <h3 id="external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation
  7507. </h3>
  7508. <p>
  7509. (<em>Appears on:</em>
  7510. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7511. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  7512. </p>
  7513. <p>
  7514. <p>GCPWorkloadIdentityFederation holds the configurations required for generating federated access tokens.</p>
  7515. </p>
  7516. <table>
  7517. <thead>
  7518. <tr>
  7519. <th>Field</th>
  7520. <th>Description</th>
  7521. </tr>
  7522. </thead>
  7523. <tbody>
  7524. <tr>
  7525. <td>
  7526. <code>credConfig</code></br>
  7527. <em>
  7528. <a href="#external-secrets.io/v1.ConfigMapReference">
  7529. ConfigMapReference
  7530. </a>
  7531. </em>
  7532. </td>
  7533. <td>
  7534. <p>credConfig holds the configmap reference containing the GCP external account credential configuration in JSON format and the key name containing the json data.
  7535. For using Kubernetes cluster as the identity provider, use serviceAccountRef instead. Operators mounted serviceaccount token cannot be used as the token source, instead
  7536. serviceAccountRef must be used by providing operators service account details.</p>
  7537. </td>
  7538. </tr>
  7539. <tr>
  7540. <td>
  7541. <code>serviceAccountRef</code></br>
  7542. <em>
  7543. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7544. External Secrets meta/v1.ServiceAccountSelector
  7545. </a>
  7546. </em>
  7547. </td>
  7548. <td>
  7549. <p>serviceAccountRef is the reference to the kubernetes ServiceAccount to be used for obtaining the tokens,
  7550. when Kubernetes is configured as provider in workload identity pool.</p>
  7551. </td>
  7552. </tr>
  7553. <tr>
  7554. <td>
  7555. <code>awsSecurityCredentials</code></br>
  7556. <em>
  7557. <a href="#external-secrets.io/v1.AwsCredentialsConfig">
  7558. AwsCredentialsConfig
  7559. </a>
  7560. </em>
  7561. </td>
  7562. <td>
  7563. <p>awsSecurityCredentials is for configuring AWS region and credentials to use for obtaining the access token,
  7564. when using the AWS metadata server is not an option.</p>
  7565. </td>
  7566. </tr>
  7567. <tr>
  7568. <td>
  7569. <code>audience</code></br>
  7570. <em>
  7571. string
  7572. </em>
  7573. </td>
  7574. <td>
  7575. <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.
  7576. If specified, Audience found in the external account credential config will be overridden with the configured value.
  7577. audience must be provided when serviceAccountRef or awsSecurityCredentials is configured.</p>
  7578. </td>
  7579. </tr>
  7580. <tr>
  7581. <td>
  7582. <code>externalTokenEndpoint</code></br>
  7583. <em>
  7584. string
  7585. </em>
  7586. </td>
  7587. <td>
  7588. <p>externalTokenEndpoint is the endpoint explicitly set up to provide tokens, which will be matched against the
  7589. credential_source.url in the provided credConfig. This field is merely to double-check the external token source
  7590. URL is having the expected value.</p>
  7591. </td>
  7592. </tr>
  7593. <tr>
  7594. <td>
  7595. <code>gcpServiceAccountEmail</code></br>
  7596. <em>
  7597. string
  7598. </em>
  7599. </td>
  7600. <td>
  7601. <p>GCPServiceAccountEmail is the email of the Google Cloud service account to impersonate
  7602. after Workload Identity Federation. Use this to grant access through the service account&rsquo;s
  7603. IAM bindings (for example roles/secretmanager.secretAccessor). When set, it overrides
  7604. service_account_impersonation_url in the external account JSON from credConfig;
  7605. when serviceAccountRef is set, it also overrides the &ldquo;iam.gke.io/gcp-service-account&rdquo; annotation
  7606. on that ServiceAccount.</p>
  7607. </td>
  7608. </tr>
  7609. </tbody>
  7610. </table>
  7611. <h3 id="external-secrets.io/v1.GcpIDTokenAuthCredentials">GcpIDTokenAuthCredentials
  7612. </h3>
  7613. <p>
  7614. (<em>Appears on:</em>
  7615. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7616. </p>
  7617. <p>
  7618. <p>GcpIDTokenAuthCredentials represents the credentials for GCP ID token authentication.</p>
  7619. </p>
  7620. <table>
  7621. <thead>
  7622. <tr>
  7623. <th>Field</th>
  7624. <th>Description</th>
  7625. </tr>
  7626. </thead>
  7627. <tbody>
  7628. <tr>
  7629. <td>
  7630. <code>identityId</code></br>
  7631. <em>
  7632. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7633. External Secrets meta/v1.SecretKeySelector
  7634. </a>
  7635. </em>
  7636. </td>
  7637. <td>
  7638. </td>
  7639. </tr>
  7640. </tbody>
  7641. </table>
  7642. <h3 id="external-secrets.io/v1.GcpIamAuthCredentials">GcpIamAuthCredentials
  7643. </h3>
  7644. <p>
  7645. (<em>Appears on:</em>
  7646. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7647. </p>
  7648. <p>
  7649. <p>GcpIamAuthCredentials represents the credentials for GCP IAM authentication.</p>
  7650. </p>
  7651. <table>
  7652. <thead>
  7653. <tr>
  7654. <th>Field</th>
  7655. <th>Description</th>
  7656. </tr>
  7657. </thead>
  7658. <tbody>
  7659. <tr>
  7660. <td>
  7661. <code>identityId</code></br>
  7662. <em>
  7663. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7664. External Secrets meta/v1.SecretKeySelector
  7665. </a>
  7666. </em>
  7667. </td>
  7668. <td>
  7669. </td>
  7670. </tr>
  7671. <tr>
  7672. <td>
  7673. <code>serviceAccountKeyFilePath</code></br>
  7674. <em>
  7675. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7676. External Secrets meta/v1.SecretKeySelector
  7677. </a>
  7678. </em>
  7679. </td>
  7680. <td>
  7681. </td>
  7682. </tr>
  7683. </tbody>
  7684. </table>
  7685. <h3 id="external-secrets.io/v1.GeneratorRef">GeneratorRef
  7686. </h3>
  7687. <p>
  7688. (<em>Appears on:</em>
  7689. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  7690. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>,
  7691. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  7692. </p>
  7693. <p>
  7694. <p>GeneratorRef points to a generator custom resource.</p>
  7695. </p>
  7696. <table>
  7697. <thead>
  7698. <tr>
  7699. <th>Field</th>
  7700. <th>Description</th>
  7701. </tr>
  7702. </thead>
  7703. <tbody>
  7704. <tr>
  7705. <td>
  7706. <code>apiVersion</code></br>
  7707. <em>
  7708. string
  7709. </em>
  7710. </td>
  7711. <td>
  7712. <p>Specify the apiVersion of the generator resource</p>
  7713. </td>
  7714. </tr>
  7715. <tr>
  7716. <td>
  7717. <code>kind</code></br>
  7718. <em>
  7719. string
  7720. </em>
  7721. </td>
  7722. <td>
  7723. <p>Specify the Kind of the generator resource</p>
  7724. </td>
  7725. </tr>
  7726. <tr>
  7727. <td>
  7728. <code>name</code></br>
  7729. <em>
  7730. string
  7731. </em>
  7732. </td>
  7733. <td>
  7734. <p>Specify the name of the generator resource</p>
  7735. </td>
  7736. </tr>
  7737. </tbody>
  7738. </table>
  7739. <h3 id="external-secrets.io/v1.GenericClusterStoreValidator">GenericClusterStoreValidator
  7740. </h3>
  7741. <p>
  7742. <p>GenericClusterStoreValidator implements webhook validation for ClusterSecretStore resources.</p>
  7743. </p>
  7744. <h3 id="external-secrets.io/v1.GenericStore">GenericStore
  7745. </h3>
  7746. <p>
  7747. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  7748. or a namespaced SecretStore.</p>
  7749. </p>
  7750. <h3 id="external-secrets.io/v1.GenericStoreValidator">GenericStoreValidator
  7751. </h3>
  7752. <p>
  7753. <p>GenericStoreValidator implements webhook validation for SecretStore resources.</p>
  7754. </p>
  7755. <h3 id="external-secrets.io/v1.GithubAppAuth">GithubAppAuth
  7756. </h3>
  7757. <p>
  7758. (<em>Appears on:</em>
  7759. <a href="#external-secrets.io/v1.GithubProvider">GithubProvider</a>)
  7760. </p>
  7761. <p>
  7762. <p>GithubAppAuth defines authentication configuration using a GitHub App for accessing GitHub API.</p>
  7763. </p>
  7764. <table>
  7765. <thead>
  7766. <tr>
  7767. <th>Field</th>
  7768. <th>Description</th>
  7769. </tr>
  7770. </thead>
  7771. <tbody>
  7772. <tr>
  7773. <td>
  7774. <code>privateKey</code></br>
  7775. <em>
  7776. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7777. External Secrets meta/v1.SecretKeySelector
  7778. </a>
  7779. </em>
  7780. </td>
  7781. <td>
  7782. </td>
  7783. </tr>
  7784. </tbody>
  7785. </table>
  7786. <h3 id="external-secrets.io/v1.GithubProvider">GithubProvider
  7787. </h3>
  7788. <p>
  7789. (<em>Appears on:</em>
  7790. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7791. </p>
  7792. <p>
  7793. <p>GithubProvider provides access and authentication to a GitHub instance .</p>
  7794. </p>
  7795. <table>
  7796. <thead>
  7797. <tr>
  7798. <th>Field</th>
  7799. <th>Description</th>
  7800. </tr>
  7801. </thead>
  7802. <tbody>
  7803. <tr>
  7804. <td>
  7805. <code>url</code></br>
  7806. <em>
  7807. string
  7808. </em>
  7809. </td>
  7810. <td>
  7811. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  7812. </td>
  7813. </tr>
  7814. <tr>
  7815. <td>
  7816. <code>uploadURL</code></br>
  7817. <em>
  7818. string
  7819. </em>
  7820. </td>
  7821. <td>
  7822. <em>(Optional)</em>
  7823. <p>Upload URL for enterprise instances. Default to URL.</p>
  7824. </td>
  7825. </tr>
  7826. <tr>
  7827. <td>
  7828. <code>auth</code></br>
  7829. <em>
  7830. <a href="#external-secrets.io/v1.GithubAppAuth">
  7831. GithubAppAuth
  7832. </a>
  7833. </em>
  7834. </td>
  7835. <td>
  7836. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  7837. </td>
  7838. </tr>
  7839. <tr>
  7840. <td>
  7841. <code>appID</code></br>
  7842. <em>
  7843. int64
  7844. </em>
  7845. </td>
  7846. <td>
  7847. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  7848. </td>
  7849. </tr>
  7850. <tr>
  7851. <td>
  7852. <code>installationID</code></br>
  7853. <em>
  7854. int64
  7855. </em>
  7856. </td>
  7857. <td>
  7858. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  7859. </td>
  7860. </tr>
  7861. <tr>
  7862. <td>
  7863. <code>organization</code></br>
  7864. <em>
  7865. string
  7866. </em>
  7867. </td>
  7868. <td>
  7869. <p>organization will be used to fetch secrets from the Github organization</p>
  7870. </td>
  7871. </tr>
  7872. <tr>
  7873. <td>
  7874. <code>repository</code></br>
  7875. <em>
  7876. string
  7877. </em>
  7878. </td>
  7879. <td>
  7880. <em>(Optional)</em>
  7881. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  7882. </td>
  7883. </tr>
  7884. <tr>
  7885. <td>
  7886. <code>environment</code></br>
  7887. <em>
  7888. string
  7889. </em>
  7890. </td>
  7891. <td>
  7892. <em>(Optional)</em>
  7893. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  7894. </td>
  7895. </tr>
  7896. <tr>
  7897. <td>
  7898. <code>orgSecretVisibility</code></br>
  7899. <em>
  7900. string
  7901. </em>
  7902. </td>
  7903. <td>
  7904. <em>(Optional)</em>
  7905. <p>orgSecretVisibility controls the visibility of organization secrets pushed via PushSecret.
  7906. Valid values are &ldquo;all&rdquo; or &ldquo;private&rdquo;.
  7907. When unset, new secrets are created with visibility &ldquo;all&rdquo; and existing secrets preserve
  7908. whatever visibility they already have in GitHub.</p>
  7909. </td>
  7910. </tr>
  7911. </tbody>
  7912. </table>
  7913. <h3 id="external-secrets.io/v1.GitlabAuth">GitlabAuth
  7914. </h3>
  7915. <p>
  7916. (<em>Appears on:</em>
  7917. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>)
  7918. </p>
  7919. <p>
  7920. <p>GitlabAuth defines the authentication method for accessing GitLab API.</p>
  7921. </p>
  7922. <table>
  7923. <thead>
  7924. <tr>
  7925. <th>Field</th>
  7926. <th>Description</th>
  7927. </tr>
  7928. </thead>
  7929. <tbody>
  7930. <tr>
  7931. <td>
  7932. <code>SecretRef</code></br>
  7933. <em>
  7934. <a href="#external-secrets.io/v1.GitlabSecretRef">
  7935. GitlabSecretRef
  7936. </a>
  7937. </em>
  7938. </td>
  7939. <td>
  7940. </td>
  7941. </tr>
  7942. </tbody>
  7943. </table>
  7944. <h3 id="external-secrets.io/v1.GitlabProvider">GitlabProvider
  7945. </h3>
  7946. <p>
  7947. (<em>Appears on:</em>
  7948. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7949. </p>
  7950. <p>
  7951. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  7952. </p>
  7953. <table>
  7954. <thead>
  7955. <tr>
  7956. <th>Field</th>
  7957. <th>Description</th>
  7958. </tr>
  7959. </thead>
  7960. <tbody>
  7961. <tr>
  7962. <td>
  7963. <code>url</code></br>
  7964. <em>
  7965. string
  7966. </em>
  7967. </td>
  7968. <td>
  7969. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  7970. </td>
  7971. </tr>
  7972. <tr>
  7973. <td>
  7974. <code>auth</code></br>
  7975. <em>
  7976. <a href="#external-secrets.io/v1.GitlabAuth">
  7977. GitlabAuth
  7978. </a>
  7979. </em>
  7980. </td>
  7981. <td>
  7982. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  7983. </td>
  7984. </tr>
  7985. <tr>
  7986. <td>
  7987. <code>projectID</code></br>
  7988. <em>
  7989. string
  7990. </em>
  7991. </td>
  7992. <td>
  7993. <p>ProjectID specifies a project where secrets are located.</p>
  7994. </td>
  7995. </tr>
  7996. <tr>
  7997. <td>
  7998. <code>inheritFromGroups</code></br>
  7999. <em>
  8000. bool
  8001. </em>
  8002. </td>
  8003. <td>
  8004. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  8005. </td>
  8006. </tr>
  8007. <tr>
  8008. <td>
  8009. <code>groupIDs</code></br>
  8010. <em>
  8011. []string
  8012. </em>
  8013. </td>
  8014. <td>
  8015. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  8016. </td>
  8017. </tr>
  8018. <tr>
  8019. <td>
  8020. <code>environment</code></br>
  8021. <em>
  8022. string
  8023. </em>
  8024. </td>
  8025. <td>
  8026. <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>
  8027. </td>
  8028. </tr>
  8029. <tr>
  8030. <td>
  8031. <code>caBundle</code></br>
  8032. <em>
  8033. []byte
  8034. </em>
  8035. </td>
  8036. <td>
  8037. <em>(Optional)</em>
  8038. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  8039. can be performed.</p>
  8040. </td>
  8041. </tr>
  8042. <tr>
  8043. <td>
  8044. <code>caProvider</code></br>
  8045. <em>
  8046. <a href="#external-secrets.io/v1.CAProvider">
  8047. CAProvider
  8048. </a>
  8049. </em>
  8050. </td>
  8051. <td>
  8052. <em>(Optional)</em>
  8053. <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>
  8054. </td>
  8055. </tr>
  8056. </tbody>
  8057. </table>
  8058. <h3 id="external-secrets.io/v1.GitlabSecretRef">GitlabSecretRef
  8059. </h3>
  8060. <p>
  8061. (<em>Appears on:</em>
  8062. <a href="#external-secrets.io/v1.GitlabAuth">GitlabAuth</a>)
  8063. </p>
  8064. <p>
  8065. <p>GitlabSecretRef contains the secret reference for GitLab authentication credentials.</p>
  8066. </p>
  8067. <table>
  8068. <thead>
  8069. <tr>
  8070. <th>Field</th>
  8071. <th>Description</th>
  8072. </tr>
  8073. </thead>
  8074. <tbody>
  8075. <tr>
  8076. <td>
  8077. <code>accessToken</code></br>
  8078. <em>
  8079. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8080. External Secrets meta/v1.SecretKeySelector
  8081. </a>
  8082. </em>
  8083. </td>
  8084. <td>
  8085. <p>AccessToken is used for authentication.</p>
  8086. </td>
  8087. </tr>
  8088. </tbody>
  8089. </table>
  8090. <h3 id="external-secrets.io/v1.IBMAuth">IBMAuth
  8091. </h3>
  8092. <p>
  8093. (<em>Appears on:</em>
  8094. <a href="#external-secrets.io/v1.IBMProvider">IBMProvider</a>)
  8095. </p>
  8096. <p>
  8097. <p>IBMAuth defines authentication options for connecting to IBM Cloud Secrets Manager.</p>
  8098. </p>
  8099. <table>
  8100. <thead>
  8101. <tr>
  8102. <th>Field</th>
  8103. <th>Description</th>
  8104. </tr>
  8105. </thead>
  8106. <tbody>
  8107. <tr>
  8108. <td>
  8109. <code>secretRef</code></br>
  8110. <em>
  8111. <a href="#external-secrets.io/v1.IBMAuthSecretRef">
  8112. IBMAuthSecretRef
  8113. </a>
  8114. </em>
  8115. </td>
  8116. <td>
  8117. </td>
  8118. </tr>
  8119. <tr>
  8120. <td>
  8121. <code>containerAuth</code></br>
  8122. <em>
  8123. <a href="#external-secrets.io/v1.IBMAuthContainerAuth">
  8124. IBMAuthContainerAuth
  8125. </a>
  8126. </em>
  8127. </td>
  8128. <td>
  8129. </td>
  8130. </tr>
  8131. </tbody>
  8132. </table>
  8133. <h3 id="external-secrets.io/v1.IBMAuthContainerAuth">IBMAuthContainerAuth
  8134. </h3>
  8135. <p>
  8136. (<em>Appears on:</em>
  8137. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  8138. </p>
  8139. <p>
  8140. <p>IBMAuthContainerAuth defines container-based authentication with IAM Trusted Profile.</p>
  8141. </p>
  8142. <table>
  8143. <thead>
  8144. <tr>
  8145. <th>Field</th>
  8146. <th>Description</th>
  8147. </tr>
  8148. </thead>
  8149. <tbody>
  8150. <tr>
  8151. <td>
  8152. <code>profile</code></br>
  8153. <em>
  8154. string
  8155. </em>
  8156. </td>
  8157. <td>
  8158. <p>the IBM Trusted Profile</p>
  8159. </td>
  8160. </tr>
  8161. <tr>
  8162. <td>
  8163. <code>tokenLocation</code></br>
  8164. <em>
  8165. string
  8166. </em>
  8167. </td>
  8168. <td>
  8169. <p>Location the token is mounted on the pod</p>
  8170. </td>
  8171. </tr>
  8172. <tr>
  8173. <td>
  8174. <code>iamEndpoint</code></br>
  8175. <em>
  8176. string
  8177. </em>
  8178. </td>
  8179. <td>
  8180. </td>
  8181. </tr>
  8182. </tbody>
  8183. </table>
  8184. <h3 id="external-secrets.io/v1.IBMAuthSecretRef">IBMAuthSecretRef
  8185. </h3>
  8186. <p>
  8187. (<em>Appears on:</em>
  8188. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  8189. </p>
  8190. <p>
  8191. <p>IBMAuthSecretRef contains the secret reference for IBM Cloud API key authentication.</p>
  8192. </p>
  8193. <table>
  8194. <thead>
  8195. <tr>
  8196. <th>Field</th>
  8197. <th>Description</th>
  8198. </tr>
  8199. </thead>
  8200. <tbody>
  8201. <tr>
  8202. <td>
  8203. <code>secretApiKeySecretRef</code></br>
  8204. <em>
  8205. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8206. External Secrets meta/v1.SecretKeySelector
  8207. </a>
  8208. </em>
  8209. </td>
  8210. <td>
  8211. <p>The SecretAccessKey is used for authentication</p>
  8212. </td>
  8213. </tr>
  8214. <tr>
  8215. <td>
  8216. <code>iamEndpoint</code></br>
  8217. <em>
  8218. string
  8219. </em>
  8220. </td>
  8221. <td>
  8222. <p>The IAM endpoint used to obain a token</p>
  8223. </td>
  8224. </tr>
  8225. </tbody>
  8226. </table>
  8227. <h3 id="external-secrets.io/v1.IBMProvider">IBMProvider
  8228. </h3>
  8229. <p>
  8230. (<em>Appears on:</em>
  8231. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8232. </p>
  8233. <p>
  8234. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager
  8235. backend.</p>
  8236. </p>
  8237. <table>
  8238. <thead>
  8239. <tr>
  8240. <th>Field</th>
  8241. <th>Description</th>
  8242. </tr>
  8243. </thead>
  8244. <tbody>
  8245. <tr>
  8246. <td>
  8247. <code>auth</code></br>
  8248. <em>
  8249. <a href="#external-secrets.io/v1.IBMAuth">
  8250. IBMAuth
  8251. </a>
  8252. </em>
  8253. </td>
  8254. <td>
  8255. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  8256. </td>
  8257. </tr>
  8258. <tr>
  8259. <td>
  8260. <code>serviceUrl</code></br>
  8261. <em>
  8262. string
  8263. </em>
  8264. </td>
  8265. <td>
  8266. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  8267. </td>
  8268. </tr>
  8269. </tbody>
  8270. </table>
  8271. <h3 id="external-secrets.io/v1.InfisicalAuth">InfisicalAuth
  8272. </h3>
  8273. <p>
  8274. (<em>Appears on:</em>
  8275. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8276. </p>
  8277. <p>
  8278. <p>InfisicalAuth specifies the authentication configuration for Infisical.</p>
  8279. </p>
  8280. <table>
  8281. <thead>
  8282. <tr>
  8283. <th>Field</th>
  8284. <th>Description</th>
  8285. </tr>
  8286. </thead>
  8287. <tbody>
  8288. <tr>
  8289. <td>
  8290. <code>universalAuthCredentials</code></br>
  8291. <em>
  8292. <a href="#external-secrets.io/v1.UniversalAuthCredentials">
  8293. UniversalAuthCredentials
  8294. </a>
  8295. </em>
  8296. </td>
  8297. <td>
  8298. <em>(Optional)</em>
  8299. </td>
  8300. </tr>
  8301. <tr>
  8302. <td>
  8303. <code>azureAuthCredentials</code></br>
  8304. <em>
  8305. <a href="#external-secrets.io/v1.AzureAuthCredentials">
  8306. AzureAuthCredentials
  8307. </a>
  8308. </em>
  8309. </td>
  8310. <td>
  8311. <em>(Optional)</em>
  8312. </td>
  8313. </tr>
  8314. <tr>
  8315. <td>
  8316. <code>gcpIdTokenAuthCredentials</code></br>
  8317. <em>
  8318. <a href="#external-secrets.io/v1.GcpIDTokenAuthCredentials">
  8319. GcpIDTokenAuthCredentials
  8320. </a>
  8321. </em>
  8322. </td>
  8323. <td>
  8324. <em>(Optional)</em>
  8325. </td>
  8326. </tr>
  8327. <tr>
  8328. <td>
  8329. <code>gcpIamAuthCredentials</code></br>
  8330. <em>
  8331. <a href="#external-secrets.io/v1.GcpIamAuthCredentials">
  8332. GcpIamAuthCredentials
  8333. </a>
  8334. </em>
  8335. </td>
  8336. <td>
  8337. <em>(Optional)</em>
  8338. </td>
  8339. </tr>
  8340. <tr>
  8341. <td>
  8342. <code>jwtAuthCredentials</code></br>
  8343. <em>
  8344. <a href="#external-secrets.io/v1.JwtAuthCredentials">
  8345. JwtAuthCredentials
  8346. </a>
  8347. </em>
  8348. </td>
  8349. <td>
  8350. <em>(Optional)</em>
  8351. </td>
  8352. </tr>
  8353. <tr>
  8354. <td>
  8355. <code>ldapAuthCredentials</code></br>
  8356. <em>
  8357. <a href="#external-secrets.io/v1.LdapAuthCredentials">
  8358. LdapAuthCredentials
  8359. </a>
  8360. </em>
  8361. </td>
  8362. <td>
  8363. <em>(Optional)</em>
  8364. </td>
  8365. </tr>
  8366. <tr>
  8367. <td>
  8368. <code>ociAuthCredentials</code></br>
  8369. <em>
  8370. <a href="#external-secrets.io/v1.OciAuthCredentials">
  8371. OciAuthCredentials
  8372. </a>
  8373. </em>
  8374. </td>
  8375. <td>
  8376. <em>(Optional)</em>
  8377. </td>
  8378. </tr>
  8379. <tr>
  8380. <td>
  8381. <code>kubernetesAuthCredentials</code></br>
  8382. <em>
  8383. <a href="#external-secrets.io/v1.KubernetesAuthCredentials">
  8384. KubernetesAuthCredentials
  8385. </a>
  8386. </em>
  8387. </td>
  8388. <td>
  8389. <em>(Optional)</em>
  8390. </td>
  8391. </tr>
  8392. <tr>
  8393. <td>
  8394. <code>awsAuthCredentials</code></br>
  8395. <em>
  8396. <a href="#external-secrets.io/v1.AwsAuthCredentials">
  8397. AwsAuthCredentials
  8398. </a>
  8399. </em>
  8400. </td>
  8401. <td>
  8402. <em>(Optional)</em>
  8403. </td>
  8404. </tr>
  8405. <tr>
  8406. <td>
  8407. <code>tokenAuthCredentials</code></br>
  8408. <em>
  8409. <a href="#external-secrets.io/v1.TokenAuthCredentials">
  8410. TokenAuthCredentials
  8411. </a>
  8412. </em>
  8413. </td>
  8414. <td>
  8415. <em>(Optional)</em>
  8416. </td>
  8417. </tr>
  8418. </tbody>
  8419. </table>
  8420. <h3 id="external-secrets.io/v1.InfisicalProvider">InfisicalProvider
  8421. </h3>
  8422. <p>
  8423. (<em>Appears on:</em>
  8424. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8425. </p>
  8426. <p>
  8427. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  8428. </p>
  8429. <table>
  8430. <thead>
  8431. <tr>
  8432. <th>Field</th>
  8433. <th>Description</th>
  8434. </tr>
  8435. </thead>
  8436. <tbody>
  8437. <tr>
  8438. <td>
  8439. <code>auth</code></br>
  8440. <em>
  8441. <a href="#external-secrets.io/v1.InfisicalAuth">
  8442. InfisicalAuth
  8443. </a>
  8444. </em>
  8445. </td>
  8446. <td>
  8447. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  8448. </td>
  8449. </tr>
  8450. <tr>
  8451. <td>
  8452. <code>secretsScope</code></br>
  8453. <em>
  8454. <a href="#external-secrets.io/v1.MachineIdentityScopeInWorkspace">
  8455. MachineIdentityScopeInWorkspace
  8456. </a>
  8457. </em>
  8458. </td>
  8459. <td>
  8460. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  8461. </td>
  8462. </tr>
  8463. <tr>
  8464. <td>
  8465. <code>hostAPI</code></br>
  8466. <em>
  8467. string
  8468. </em>
  8469. </td>
  8470. <td>
  8471. <em>(Optional)</em>
  8472. <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>
  8473. </td>
  8474. </tr>
  8475. <tr>
  8476. <td>
  8477. <code>caBundle</code></br>
  8478. <em>
  8479. []byte
  8480. </em>
  8481. </td>
  8482. <td>
  8483. <em>(Optional)</em>
  8484. <p>CABundle is a PEM-encoded CA certificate bundle used to validate
  8485. the Infisical server&rsquo;s TLS certificate. Mutually exclusive with CAProvider.</p>
  8486. </td>
  8487. </tr>
  8488. <tr>
  8489. <td>
  8490. <code>caProvider</code></br>
  8491. <em>
  8492. <a href="#external-secrets.io/v1.CAProvider">
  8493. CAProvider
  8494. </a>
  8495. </em>
  8496. </td>
  8497. <td>
  8498. <em>(Optional)</em>
  8499. <p>CAProvider is a reference to a Secret or ConfigMap that contains a CA certificate.
  8500. The certificate is used to validate the Infisical server&rsquo;s TLS certificate.
  8501. Mutually exclusive with CABundle.</p>
  8502. </td>
  8503. </tr>
  8504. </tbody>
  8505. </table>
  8506. <h3 id="external-secrets.io/v1.IntegrationInfo">IntegrationInfo
  8507. </h3>
  8508. <p>
  8509. (<em>Appears on:</em>
  8510. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  8511. </p>
  8512. <p>
  8513. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.</p>
  8514. </p>
  8515. <table>
  8516. <thead>
  8517. <tr>
  8518. <th>Field</th>
  8519. <th>Description</th>
  8520. </tr>
  8521. </thead>
  8522. <tbody>
  8523. <tr>
  8524. <td>
  8525. <code>name</code></br>
  8526. <em>
  8527. string
  8528. </em>
  8529. </td>
  8530. <td>
  8531. <p>Name defaults to &ldquo;1Password SDK&rdquo;.</p>
  8532. </td>
  8533. </tr>
  8534. <tr>
  8535. <td>
  8536. <code>version</code></br>
  8537. <em>
  8538. string
  8539. </em>
  8540. </td>
  8541. <td>
  8542. <p>Version defaults to &ldquo;v1.0.0&rdquo;.</p>
  8543. </td>
  8544. </tr>
  8545. </tbody>
  8546. </table>
  8547. <h3 id="external-secrets.io/v1.JwtAuthCredentials">JwtAuthCredentials
  8548. </h3>
  8549. <p>
  8550. (<em>Appears on:</em>
  8551. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8552. </p>
  8553. <p>
  8554. <p>JwtAuthCredentials represents the credentials for JWT authentication.</p>
  8555. </p>
  8556. <table>
  8557. <thead>
  8558. <tr>
  8559. <th>Field</th>
  8560. <th>Description</th>
  8561. </tr>
  8562. </thead>
  8563. <tbody>
  8564. <tr>
  8565. <td>
  8566. <code>identityId</code></br>
  8567. <em>
  8568. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8569. External Secrets meta/v1.SecretKeySelector
  8570. </a>
  8571. </em>
  8572. </td>
  8573. <td>
  8574. </td>
  8575. </tr>
  8576. <tr>
  8577. <td>
  8578. <code>jwt</code></br>
  8579. <em>
  8580. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8581. External Secrets meta/v1.SecretKeySelector
  8582. </a>
  8583. </em>
  8584. </td>
  8585. <td>
  8586. </td>
  8587. </tr>
  8588. </tbody>
  8589. </table>
  8590. <h3 id="external-secrets.io/v1.KeeperSecurityProvider">KeeperSecurityProvider
  8591. </h3>
  8592. <p>
  8593. (<em>Appears on:</em>
  8594. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8595. </p>
  8596. <p>
  8597. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  8598. </p>
  8599. <table>
  8600. <thead>
  8601. <tr>
  8602. <th>Field</th>
  8603. <th>Description</th>
  8604. </tr>
  8605. </thead>
  8606. <tbody>
  8607. <tr>
  8608. <td>
  8609. <code>authRef</code></br>
  8610. <em>
  8611. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8612. External Secrets meta/v1.SecretKeySelector
  8613. </a>
  8614. </em>
  8615. </td>
  8616. <td>
  8617. </td>
  8618. </tr>
  8619. <tr>
  8620. <td>
  8621. <code>folderID</code></br>
  8622. <em>
  8623. string
  8624. </em>
  8625. </td>
  8626. <td>
  8627. </td>
  8628. </tr>
  8629. <tr>
  8630. <td>
  8631. <code>getByTitleFallback</code></br>
  8632. <em>
  8633. bool
  8634. </em>
  8635. </td>
  8636. <td>
  8637. </td>
  8638. </tr>
  8639. </tbody>
  8640. </table>
  8641. <h3 id="external-secrets.io/v1.KubernetesAuth">KubernetesAuth
  8642. </h3>
  8643. <p>
  8644. (<em>Appears on:</em>
  8645. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8646. </p>
  8647. <p>
  8648. <p>KubernetesAuth defines authentication options for connecting to a Kubernetes cluster.</p>
  8649. </p>
  8650. <table>
  8651. <thead>
  8652. <tr>
  8653. <th>Field</th>
  8654. <th>Description</th>
  8655. </tr>
  8656. </thead>
  8657. <tbody>
  8658. <tr>
  8659. <td>
  8660. <code>cert</code></br>
  8661. <em>
  8662. <a href="#external-secrets.io/v1.CertAuth">
  8663. CertAuth
  8664. </a>
  8665. </em>
  8666. </td>
  8667. <td>
  8668. <em>(Optional)</em>
  8669. <p>has both clientCert and clientKey as secretKeySelector</p>
  8670. </td>
  8671. </tr>
  8672. <tr>
  8673. <td>
  8674. <code>token</code></br>
  8675. <em>
  8676. <a href="#external-secrets.io/v1.TokenAuth">
  8677. TokenAuth
  8678. </a>
  8679. </em>
  8680. </td>
  8681. <td>
  8682. <em>(Optional)</em>
  8683. <p>use static token to authenticate with</p>
  8684. </td>
  8685. </tr>
  8686. <tr>
  8687. <td>
  8688. <code>serviceAccount</code></br>
  8689. <em>
  8690. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  8691. External Secrets meta/v1.ServiceAccountSelector
  8692. </a>
  8693. </em>
  8694. </td>
  8695. <td>
  8696. <em>(Optional)</em>
  8697. <p>points to a service account that should be used for authentication</p>
  8698. </td>
  8699. </tr>
  8700. </tbody>
  8701. </table>
  8702. <h3 id="external-secrets.io/v1.KubernetesAuthCredentials">KubernetesAuthCredentials
  8703. </h3>
  8704. <p>
  8705. (<em>Appears on:</em>
  8706. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8707. </p>
  8708. <p>
  8709. <p>KubernetesAuthCredentials represents the credentials for Kubernetes authentication.</p>
  8710. </p>
  8711. <table>
  8712. <thead>
  8713. <tr>
  8714. <th>Field</th>
  8715. <th>Description</th>
  8716. </tr>
  8717. </thead>
  8718. <tbody>
  8719. <tr>
  8720. <td>
  8721. <code>identityId</code></br>
  8722. <em>
  8723. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8724. External Secrets meta/v1.SecretKeySelector
  8725. </a>
  8726. </em>
  8727. </td>
  8728. <td>
  8729. </td>
  8730. </tr>
  8731. <tr>
  8732. <td>
  8733. <code>serviceAccountTokenPath</code></br>
  8734. <em>
  8735. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8736. External Secrets meta/v1.SecretKeySelector
  8737. </a>
  8738. </em>
  8739. </td>
  8740. <td>
  8741. <em>(Optional)</em>
  8742. </td>
  8743. </tr>
  8744. </tbody>
  8745. </table>
  8746. <h3 id="external-secrets.io/v1.KubernetesProvider">KubernetesProvider
  8747. </h3>
  8748. <p>
  8749. (<em>Appears on:</em>
  8750. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8751. </p>
  8752. <p>
  8753. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  8754. </p>
  8755. <table>
  8756. <thead>
  8757. <tr>
  8758. <th>Field</th>
  8759. <th>Description</th>
  8760. </tr>
  8761. </thead>
  8762. <tbody>
  8763. <tr>
  8764. <td>
  8765. <code>server</code></br>
  8766. <em>
  8767. <a href="#external-secrets.io/v1.KubernetesServer">
  8768. KubernetesServer
  8769. </a>
  8770. </em>
  8771. </td>
  8772. <td>
  8773. <em>(Optional)</em>
  8774. <p>configures the Kubernetes server Address.</p>
  8775. </td>
  8776. </tr>
  8777. <tr>
  8778. <td>
  8779. <code>auth</code></br>
  8780. <em>
  8781. <a href="#external-secrets.io/v1.KubernetesAuth">
  8782. KubernetesAuth
  8783. </a>
  8784. </em>
  8785. </td>
  8786. <td>
  8787. <em>(Optional)</em>
  8788. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  8789. </td>
  8790. </tr>
  8791. <tr>
  8792. <td>
  8793. <code>authRef</code></br>
  8794. <em>
  8795. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8796. External Secrets meta/v1.SecretKeySelector
  8797. </a>
  8798. </em>
  8799. </td>
  8800. <td>
  8801. <em>(Optional)</em>
  8802. <p>A reference to a secret that contains the auth information.</p>
  8803. </td>
  8804. </tr>
  8805. <tr>
  8806. <td>
  8807. <code>remoteNamespace</code></br>
  8808. <em>
  8809. string
  8810. </em>
  8811. </td>
  8812. <td>
  8813. <em>(Optional)</em>
  8814. <p>Remote namespace to fetch the secrets from</p>
  8815. </td>
  8816. </tr>
  8817. </tbody>
  8818. </table>
  8819. <h3 id="external-secrets.io/v1.KubernetesServer">KubernetesServer
  8820. </h3>
  8821. <p>
  8822. (<em>Appears on:</em>
  8823. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8824. </p>
  8825. <p>
  8826. <p>KubernetesServer defines configuration for connecting to a Kubernetes API server.</p>
  8827. </p>
  8828. <table>
  8829. <thead>
  8830. <tr>
  8831. <th>Field</th>
  8832. <th>Description</th>
  8833. </tr>
  8834. </thead>
  8835. <tbody>
  8836. <tr>
  8837. <td>
  8838. <code>url</code></br>
  8839. <em>
  8840. string
  8841. </em>
  8842. </td>
  8843. <td>
  8844. <em>(Optional)</em>
  8845. <p>configures the Kubernetes server Address.</p>
  8846. </td>
  8847. </tr>
  8848. <tr>
  8849. <td>
  8850. <code>caBundle</code></br>
  8851. <em>
  8852. []byte
  8853. </em>
  8854. </td>
  8855. <td>
  8856. <em>(Optional)</em>
  8857. <p>CABundle is a base64-encoded CA certificate</p>
  8858. </td>
  8859. </tr>
  8860. <tr>
  8861. <td>
  8862. <code>caProvider</code></br>
  8863. <em>
  8864. <a href="#external-secrets.io/v1.CAProvider">
  8865. CAProvider
  8866. </a>
  8867. </em>
  8868. </td>
  8869. <td>
  8870. <em>(Optional)</em>
  8871. <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>
  8872. </td>
  8873. </tr>
  8874. </tbody>
  8875. </table>
  8876. <h3 id="external-secrets.io/v1.LdapAuthCredentials">LdapAuthCredentials
  8877. </h3>
  8878. <p>
  8879. (<em>Appears on:</em>
  8880. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8881. </p>
  8882. <p>
  8883. <p>LdapAuthCredentials represents the credentials for LDAP authentication.</p>
  8884. </p>
  8885. <table>
  8886. <thead>
  8887. <tr>
  8888. <th>Field</th>
  8889. <th>Description</th>
  8890. </tr>
  8891. </thead>
  8892. <tbody>
  8893. <tr>
  8894. <td>
  8895. <code>identityId</code></br>
  8896. <em>
  8897. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8898. External Secrets meta/v1.SecretKeySelector
  8899. </a>
  8900. </em>
  8901. </td>
  8902. <td>
  8903. </td>
  8904. </tr>
  8905. <tr>
  8906. <td>
  8907. <code>ldapPassword</code></br>
  8908. <em>
  8909. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8910. External Secrets meta/v1.SecretKeySelector
  8911. </a>
  8912. </em>
  8913. </td>
  8914. <td>
  8915. </td>
  8916. </tr>
  8917. <tr>
  8918. <td>
  8919. <code>ldapUsername</code></br>
  8920. <em>
  8921. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8922. External Secrets meta/v1.SecretKeySelector
  8923. </a>
  8924. </em>
  8925. </td>
  8926. <td>
  8927. </td>
  8928. </tr>
  8929. </tbody>
  8930. </table>
  8931. <h3 id="external-secrets.io/v1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  8932. </h3>
  8933. <p>
  8934. (<em>Appears on:</em>
  8935. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8936. </p>
  8937. <p>
  8938. <p>MachineIdentityScopeInWorkspace defines the scope for machine identity within a workspace.</p>
  8939. </p>
  8940. <table>
  8941. <thead>
  8942. <tr>
  8943. <th>Field</th>
  8944. <th>Description</th>
  8945. </tr>
  8946. </thead>
  8947. <tbody>
  8948. <tr>
  8949. <td>
  8950. <code>secretsPath</code></br>
  8951. <em>
  8952. string
  8953. </em>
  8954. </td>
  8955. <td>
  8956. <em>(Optional)</em>
  8957. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  8958. </td>
  8959. </tr>
  8960. <tr>
  8961. <td>
  8962. <code>recursive</code></br>
  8963. <em>
  8964. bool
  8965. </em>
  8966. </td>
  8967. <td>
  8968. <em>(Optional)</em>
  8969. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  8970. </td>
  8971. </tr>
  8972. <tr>
  8973. <td>
  8974. <code>environmentSlug</code></br>
  8975. <em>
  8976. string
  8977. </em>
  8978. </td>
  8979. <td>
  8980. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  8981. </td>
  8982. </tr>
  8983. <tr>
  8984. <td>
  8985. <code>projectSlug</code></br>
  8986. <em>
  8987. string
  8988. </em>
  8989. </td>
  8990. <td>
  8991. <p>ProjectSlug is the required slug identifier for the project.</p>
  8992. </td>
  8993. </tr>
  8994. <tr>
  8995. <td>
  8996. <code>organizationSlug</code></br>
  8997. <em>
  8998. string
  8999. </em>
  9000. </td>
  9001. <td>
  9002. <p>OrganizationSlug is the optional slug that identifies the organization that will be used
  9003. during authentication. Useful for sub-organization setups</p>
  9004. </td>
  9005. </tr>
  9006. <tr>
  9007. <td>
  9008. <code>expandSecretReferences</code></br>
  9009. <em>
  9010. bool
  9011. </em>
  9012. </td>
  9013. <td>
  9014. <em>(Optional)</em>
  9015. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  9016. </td>
  9017. </tr>
  9018. </tbody>
  9019. </table>
  9020. <h3 id="external-secrets.io/v1.MaintenanceStatus">MaintenanceStatus
  9021. (<code>string</code> alias)</p></h3>
  9022. <p>
  9023. <p>MaintenanceStatus defines a type for different maintenance states of a provider schema.</p>
  9024. </p>
  9025. <table>
  9026. <thead>
  9027. <tr>
  9028. <th>Value</th>
  9029. <th>Description</th>
  9030. </tr>
  9031. </thead>
  9032. <tbody><tr><td><p>&#34;Deprecated&#34;</p></td>
  9033. <td></td>
  9034. </tr><tr><td><p>&#34;Maintained&#34;</p></td>
  9035. <td></td>
  9036. </tr><tr><td><p>&#34;NotMaintained&#34;</p></td>
  9037. <td></td>
  9038. </tr></tbody>
  9039. </table>
  9040. <h3 id="external-secrets.io/v1.ManifestReference">ManifestReference
  9041. </h3>
  9042. <p>
  9043. (<em>Appears on:</em>
  9044. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  9045. </p>
  9046. <p>
  9047. <p>ManifestReference defines a custom Kubernetes resource type to be created
  9048. instead of a Secret. This allows ExternalSecret to create ConfigMaps,
  9049. Custom Resources, or any other Kubernetes resource type.</p>
  9050. </p>
  9051. <table>
  9052. <thead>
  9053. <tr>
  9054. <th>Field</th>
  9055. <th>Description</th>
  9056. </tr>
  9057. </thead>
  9058. <tbody>
  9059. <tr>
  9060. <td>
  9061. <code>apiVersion</code></br>
  9062. <em>
  9063. string
  9064. </em>
  9065. </td>
  9066. <td>
  9067. <p>APIVersion of the target resource (e.g., &ldquo;v1&rdquo; for ConfigMap, &ldquo;argoproj.io/v1alpha1&rdquo; for ArgoCD Application)</p>
  9068. </td>
  9069. </tr>
  9070. <tr>
  9071. <td>
  9072. <code>kind</code></br>
  9073. <em>
  9074. string
  9075. </em>
  9076. </td>
  9077. <td>
  9078. <p>Kind of the target resource (e.g., &ldquo;ConfigMap&rdquo;, &ldquo;Application&rdquo;)</p>
  9079. </td>
  9080. </tr>
  9081. </tbody>
  9082. </table>
  9083. <h3 id="external-secrets.io/v1.NTLMProtocol">NTLMProtocol
  9084. </h3>
  9085. <p>
  9086. (<em>Appears on:</em>
  9087. <a href="#external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol</a>)
  9088. </p>
  9089. <p>
  9090. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  9091. </p>
  9092. <table>
  9093. <thead>
  9094. <tr>
  9095. <th>Field</th>
  9096. <th>Description</th>
  9097. </tr>
  9098. </thead>
  9099. <tbody>
  9100. <tr>
  9101. <td>
  9102. <code>usernameSecret</code></br>
  9103. <em>
  9104. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9105. External Secrets meta/v1.SecretKeySelector
  9106. </a>
  9107. </em>
  9108. </td>
  9109. <td>
  9110. </td>
  9111. </tr>
  9112. <tr>
  9113. <td>
  9114. <code>passwordSecret</code></br>
  9115. <em>
  9116. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9117. External Secrets meta/v1.SecretKeySelector
  9118. </a>
  9119. </em>
  9120. </td>
  9121. <td>
  9122. </td>
  9123. </tr>
  9124. </tbody>
  9125. </table>
  9126. <h3 id="external-secrets.io/v1.NebiusAuth">NebiusAuth
  9127. </h3>
  9128. <p>
  9129. (<em>Appears on:</em>
  9130. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  9131. </p>
  9132. <p>
  9133. <p>NebiusAuth defines the authentication method for the Nebius provider.</p>
  9134. </p>
  9135. <table>
  9136. <thead>
  9137. <tr>
  9138. <th>Field</th>
  9139. <th>Description</th>
  9140. </tr>
  9141. </thead>
  9142. <tbody>
  9143. <tr>
  9144. <td>
  9145. <code>serviceAccountCredsSecretRef</code></br>
  9146. <em>
  9147. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9148. External Secrets meta/v1.SecretKeySelector
  9149. </a>
  9150. </em>
  9151. </td>
  9152. <td>
  9153. <em>(Optional)</em>
  9154. <p>ServiceAccountCreds references a Kubernetes Secret key that contains a JSON
  9155. document with service account credentials used to get an IAM token.</p>
  9156. <p>Expected JSON structure:
  9157. {
  9158. &ldquo;subject-credentials&rdquo;: {
  9159. &ldquo;alg&rdquo;: &ldquo;RS256&rdquo;,
  9160. &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;,
  9161. &ldquo;kid&rdquo;: &ldquo;<public-key-id>&rdquo;,
  9162. &ldquo;iss&rdquo;: &ldquo;<issuer-service-account-id>&rdquo;,
  9163. &ldquo;sub&rdquo;: &ldquo;<subject-service-account-id>&rdquo;
  9164. }
  9165. }</p>
  9166. </td>
  9167. </tr>
  9168. <tr>
  9169. <td>
  9170. <code>tokenSecretRef</code></br>
  9171. <em>
  9172. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9173. External Secrets meta/v1.SecretKeySelector
  9174. </a>
  9175. </em>
  9176. </td>
  9177. <td>
  9178. <em>(Optional)</em>
  9179. <p>Token authenticates with Nebius Mysterybox by presenting a token.</p>
  9180. </td>
  9181. </tr>
  9182. </tbody>
  9183. </table>
  9184. <h3 id="external-secrets.io/v1.NebiusCAProvider">NebiusCAProvider
  9185. </h3>
  9186. <p>
  9187. (<em>Appears on:</em>
  9188. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  9189. </p>
  9190. <p>
  9191. <p>NebiusCAProvider The provider for the CA bundle to use to validate Nebius server certificate.</p>
  9192. </p>
  9193. <table>
  9194. <thead>
  9195. <tr>
  9196. <th>Field</th>
  9197. <th>Description</th>
  9198. </tr>
  9199. </thead>
  9200. <tbody>
  9201. <tr>
  9202. <td>
  9203. <code>certSecretRef</code></br>
  9204. <em>
  9205. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9206. External Secrets meta/v1.SecretKeySelector
  9207. </a>
  9208. </em>
  9209. </td>
  9210. <td>
  9211. <em>(Optional)</em>
  9212. </td>
  9213. </tr>
  9214. </tbody>
  9215. </table>
  9216. <h3 id="external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider
  9217. </h3>
  9218. <p>
  9219. (<em>Appears on:</em>
  9220. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9221. </p>
  9222. <p>
  9223. <p>NebiusMysteryboxProvider Configures a store to sync secrets using the Nebius Mysterybox provider.</p>
  9224. </p>
  9225. <table>
  9226. <thead>
  9227. <tr>
  9228. <th>Field</th>
  9229. <th>Description</th>
  9230. </tr>
  9231. </thead>
  9232. <tbody>
  9233. <tr>
  9234. <td>
  9235. <code>apiDomain</code></br>
  9236. <em>
  9237. string
  9238. </em>
  9239. </td>
  9240. <td>
  9241. <p>NebiusMysterybox API endpoint</p>
  9242. </td>
  9243. </tr>
  9244. <tr>
  9245. <td>
  9246. <code>auth</code></br>
  9247. <em>
  9248. <a href="#external-secrets.io/v1.NebiusAuth">
  9249. NebiusAuth
  9250. </a>
  9251. </em>
  9252. </td>
  9253. <td>
  9254. <p>Auth defines parameters to authenticate in MysteryBox</p>
  9255. </td>
  9256. </tr>
  9257. <tr>
  9258. <td>
  9259. <code>caProvider</code></br>
  9260. <em>
  9261. <a href="#external-secrets.io/v1.NebiusCAProvider">
  9262. NebiusCAProvider
  9263. </a>
  9264. </em>
  9265. </td>
  9266. <td>
  9267. <em>(Optional)</em>
  9268. <p>The provider for the CA bundle to use to validate NebiusMysterybox server certificate.</p>
  9269. </td>
  9270. </tr>
  9271. </tbody>
  9272. </table>
  9273. <h3 id="external-secrets.io/v1.NgrokAuth">NgrokAuth
  9274. </h3>
  9275. <p>
  9276. (<em>Appears on:</em>
  9277. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  9278. </p>
  9279. <p>
  9280. <p>NgrokAuth configures the authentication method for the ngrok provider.</p>
  9281. </p>
  9282. <table>
  9283. <thead>
  9284. <tr>
  9285. <th>Field</th>
  9286. <th>Description</th>
  9287. </tr>
  9288. </thead>
  9289. <tbody>
  9290. <tr>
  9291. <td>
  9292. <code>apiKey</code></br>
  9293. <em>
  9294. <a href="#external-secrets.io/v1.NgrokProviderSecretRef">
  9295. NgrokProviderSecretRef
  9296. </a>
  9297. </em>
  9298. </td>
  9299. <td>
  9300. <em>(Optional)</em>
  9301. <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>
  9302. </td>
  9303. </tr>
  9304. </tbody>
  9305. </table>
  9306. <h3 id="external-secrets.io/v1.NgrokProvider">NgrokProvider
  9307. </h3>
  9308. <p>
  9309. (<em>Appears on:</em>
  9310. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9311. </p>
  9312. <p>
  9313. <p>NgrokProvider configures a store to sync secrets with a ngrok vault to use in traffic policies.
  9314. See: <a href="https://ngrok.com/blog-post/secrets-for-traffic-policy">https://ngrok.com/blog-post/secrets-for-traffic-policy</a></p>
  9315. </p>
  9316. <table>
  9317. <thead>
  9318. <tr>
  9319. <th>Field</th>
  9320. <th>Description</th>
  9321. </tr>
  9322. </thead>
  9323. <tbody>
  9324. <tr>
  9325. <td>
  9326. <code>apiUrl</code></br>
  9327. <em>
  9328. string
  9329. </em>
  9330. </td>
  9331. <td>
  9332. <p>APIURL is the URL of the ngrok API.</p>
  9333. </td>
  9334. </tr>
  9335. <tr>
  9336. <td>
  9337. <code>auth</code></br>
  9338. <em>
  9339. <a href="#external-secrets.io/v1.NgrokAuth">
  9340. NgrokAuth
  9341. </a>
  9342. </em>
  9343. </td>
  9344. <td>
  9345. <p>Auth configures how the ngrok provider authenticates with the ngrok API.</p>
  9346. </td>
  9347. </tr>
  9348. <tr>
  9349. <td>
  9350. <code>vault</code></br>
  9351. <em>
  9352. <a href="#external-secrets.io/v1.NgrokVault">
  9353. NgrokVault
  9354. </a>
  9355. </em>
  9356. </td>
  9357. <td>
  9358. <p>Vault configures the ngrok vault to sync secrets with.</p>
  9359. </td>
  9360. </tr>
  9361. </tbody>
  9362. </table>
  9363. <h3 id="external-secrets.io/v1.NgrokProviderSecretRef">NgrokProviderSecretRef
  9364. </h3>
  9365. <p>
  9366. (<em>Appears on:</em>
  9367. <a href="#external-secrets.io/v1.NgrokAuth">NgrokAuth</a>)
  9368. </p>
  9369. <p>
  9370. <p>NgrokProviderSecretRef contains the secret reference for the ngrok provider.</p>
  9371. </p>
  9372. <table>
  9373. <thead>
  9374. <tr>
  9375. <th>Field</th>
  9376. <th>Description</th>
  9377. </tr>
  9378. </thead>
  9379. <tbody>
  9380. <tr>
  9381. <td>
  9382. <code>secretRef</code></br>
  9383. <em>
  9384. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9385. External Secrets meta/v1.SecretKeySelector
  9386. </a>
  9387. </em>
  9388. </td>
  9389. <td>
  9390. <em>(Optional)</em>
  9391. <p>SecretRef is a reference to a secret containing the ngrok API key.</p>
  9392. </td>
  9393. </tr>
  9394. </tbody>
  9395. </table>
  9396. <h3 id="external-secrets.io/v1.NgrokVault">NgrokVault
  9397. </h3>
  9398. <p>
  9399. (<em>Appears on:</em>
  9400. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  9401. </p>
  9402. <p>
  9403. <p>NgrokVault configures the ngrok vault to sync secrets with.</p>
  9404. </p>
  9405. <table>
  9406. <thead>
  9407. <tr>
  9408. <th>Field</th>
  9409. <th>Description</th>
  9410. </tr>
  9411. </thead>
  9412. <tbody>
  9413. <tr>
  9414. <td>
  9415. <code>name</code></br>
  9416. <em>
  9417. string
  9418. </em>
  9419. </td>
  9420. <td>
  9421. <p>Name is the name of the ngrok vault to sync secrets with.</p>
  9422. </td>
  9423. </tr>
  9424. </tbody>
  9425. </table>
  9426. <h3 id="external-secrets.io/v1.NoSecretError">NoSecretError
  9427. </h3>
  9428. <p>
  9429. <p>NoSecretError shall be returned when a GetSecret can not find the
  9430. desired secret. This is used for deletionPolicy.</p>
  9431. </p>
  9432. <h3 id="external-secrets.io/v1.NotModifiedError">NotModifiedError
  9433. </h3>
  9434. <p>
  9435. <p>NotModifiedError to signal that the webhook received no changes,
  9436. and it should just return without doing anything.</p>
  9437. </p>
  9438. <h3 id="external-secrets.io/v1.OciAuthCredentials">OciAuthCredentials
  9439. </h3>
  9440. <p>
  9441. (<em>Appears on:</em>
  9442. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  9443. </p>
  9444. <p>
  9445. <p>OciAuthCredentials represents the credentials for OCI authentication.</p>
  9446. </p>
  9447. <table>
  9448. <thead>
  9449. <tr>
  9450. <th>Field</th>
  9451. <th>Description</th>
  9452. </tr>
  9453. </thead>
  9454. <tbody>
  9455. <tr>
  9456. <td>
  9457. <code>identityId</code></br>
  9458. <em>
  9459. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9460. External Secrets meta/v1.SecretKeySelector
  9461. </a>
  9462. </em>
  9463. </td>
  9464. <td>
  9465. </td>
  9466. </tr>
  9467. <tr>
  9468. <td>
  9469. <code>privateKey</code></br>
  9470. <em>
  9471. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9472. External Secrets meta/v1.SecretKeySelector
  9473. </a>
  9474. </em>
  9475. </td>
  9476. <td>
  9477. </td>
  9478. </tr>
  9479. <tr>
  9480. <td>
  9481. <code>privateKeyPassphrase</code></br>
  9482. <em>
  9483. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9484. External Secrets meta/v1.SecretKeySelector
  9485. </a>
  9486. </em>
  9487. </td>
  9488. <td>
  9489. <em>(Optional)</em>
  9490. </td>
  9491. </tr>
  9492. <tr>
  9493. <td>
  9494. <code>fingerprint</code></br>
  9495. <em>
  9496. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9497. External Secrets meta/v1.SecretKeySelector
  9498. </a>
  9499. </em>
  9500. </td>
  9501. <td>
  9502. </td>
  9503. </tr>
  9504. <tr>
  9505. <td>
  9506. <code>userId</code></br>
  9507. <em>
  9508. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9509. External Secrets meta/v1.SecretKeySelector
  9510. </a>
  9511. </em>
  9512. </td>
  9513. <td>
  9514. </td>
  9515. </tr>
  9516. <tr>
  9517. <td>
  9518. <code>tenancyId</code></br>
  9519. <em>
  9520. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9521. External Secrets meta/v1.SecretKeySelector
  9522. </a>
  9523. </em>
  9524. </td>
  9525. <td>
  9526. </td>
  9527. </tr>
  9528. <tr>
  9529. <td>
  9530. <code>region</code></br>
  9531. <em>
  9532. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9533. External Secrets meta/v1.SecretKeySelector
  9534. </a>
  9535. </em>
  9536. </td>
  9537. <td>
  9538. </td>
  9539. </tr>
  9540. </tbody>
  9541. </table>
  9542. <h3 id="external-secrets.io/v1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  9543. </h3>
  9544. <p>
  9545. (<em>Appears on:</em>
  9546. <a href="#external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider</a>)
  9547. </p>
  9548. <p>
  9549. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  9550. </p>
  9551. <table>
  9552. <thead>
  9553. <tr>
  9554. <th>Field</th>
  9555. <th>Description</th>
  9556. </tr>
  9557. </thead>
  9558. <tbody>
  9559. <tr>
  9560. <td>
  9561. <code>apiKeyRef</code></br>
  9562. <em>
  9563. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9564. External Secrets meta/v1.SecretKeySelector
  9565. </a>
  9566. </em>
  9567. </td>
  9568. <td>
  9569. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  9570. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  9571. </td>
  9572. </tr>
  9573. <tr>
  9574. <td>
  9575. <code>passcodeRef</code></br>
  9576. <em>
  9577. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9578. External Secrets meta/v1.SecretKeySelector
  9579. </a>
  9580. </em>
  9581. </td>
  9582. <td>
  9583. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  9584. </td>
  9585. </tr>
  9586. </tbody>
  9587. </table>
  9588. <h3 id="external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider
  9589. </h3>
  9590. <p>
  9591. (<em>Appears on:</em>
  9592. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9593. </p>
  9594. <p>
  9595. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  9596. Project and Config are required if not using a Service Token.</p>
  9597. </p>
  9598. <table>
  9599. <thead>
  9600. <tr>
  9601. <th>Field</th>
  9602. <th>Description</th>
  9603. </tr>
  9604. </thead>
  9605. <tbody>
  9606. <tr>
  9607. <td>
  9608. <code>auth</code></br>
  9609. <em>
  9610. <a href="#external-secrets.io/v1.OnboardbaseAuthSecretRef">
  9611. OnboardbaseAuthSecretRef
  9612. </a>
  9613. </em>
  9614. </td>
  9615. <td>
  9616. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  9617. </td>
  9618. </tr>
  9619. <tr>
  9620. <td>
  9621. <code>apiHost</code></br>
  9622. <em>
  9623. string
  9624. </em>
  9625. </td>
  9626. <td>
  9627. <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>
  9628. </td>
  9629. </tr>
  9630. <tr>
  9631. <td>
  9632. <code>project</code></br>
  9633. <em>
  9634. string
  9635. </em>
  9636. </td>
  9637. <td>
  9638. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  9639. </td>
  9640. </tr>
  9641. <tr>
  9642. <td>
  9643. <code>environment</code></br>
  9644. <em>
  9645. string
  9646. </em>
  9647. </td>
  9648. <td>
  9649. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  9650. </td>
  9651. </tr>
  9652. </tbody>
  9653. </table>
  9654. <h3 id="external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth
  9655. </h3>
  9656. <p>
  9657. (<em>Appears on:</em>
  9658. <a href="#external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider</a>)
  9659. </p>
  9660. <p>
  9661. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  9662. </p>
  9663. <table>
  9664. <thead>
  9665. <tr>
  9666. <th>Field</th>
  9667. <th>Description</th>
  9668. </tr>
  9669. </thead>
  9670. <tbody>
  9671. <tr>
  9672. <td>
  9673. <code>secretRef</code></br>
  9674. <em>
  9675. <a href="#external-secrets.io/v1.OnePasswordAuthSecretRef">
  9676. OnePasswordAuthSecretRef
  9677. </a>
  9678. </em>
  9679. </td>
  9680. <td>
  9681. </td>
  9682. </tr>
  9683. </tbody>
  9684. </table>
  9685. <h3 id="external-secrets.io/v1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  9686. </h3>
  9687. <p>
  9688. (<em>Appears on:</em>
  9689. <a href="#external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth</a>)
  9690. </p>
  9691. <p>
  9692. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  9693. </p>
  9694. <table>
  9695. <thead>
  9696. <tr>
  9697. <th>Field</th>
  9698. <th>Description</th>
  9699. </tr>
  9700. </thead>
  9701. <tbody>
  9702. <tr>
  9703. <td>
  9704. <code>connectTokenSecretRef</code></br>
  9705. <em>
  9706. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9707. External Secrets meta/v1.SecretKeySelector
  9708. </a>
  9709. </em>
  9710. </td>
  9711. <td>
  9712. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  9713. </td>
  9714. </tr>
  9715. </tbody>
  9716. </table>
  9717. <h3 id="external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider
  9718. </h3>
  9719. <p>
  9720. (<em>Appears on:</em>
  9721. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9722. </p>
  9723. <p>
  9724. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  9725. </p>
  9726. <table>
  9727. <thead>
  9728. <tr>
  9729. <th>Field</th>
  9730. <th>Description</th>
  9731. </tr>
  9732. </thead>
  9733. <tbody>
  9734. <tr>
  9735. <td>
  9736. <code>auth</code></br>
  9737. <em>
  9738. <a href="#external-secrets.io/v1.OnePasswordAuth">
  9739. OnePasswordAuth
  9740. </a>
  9741. </em>
  9742. </td>
  9743. <td>
  9744. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  9745. </td>
  9746. </tr>
  9747. <tr>
  9748. <td>
  9749. <code>connectHost</code></br>
  9750. <em>
  9751. string
  9752. </em>
  9753. </td>
  9754. <td>
  9755. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  9756. </td>
  9757. </tr>
  9758. <tr>
  9759. <td>
  9760. <code>vaults</code></br>
  9761. <em>
  9762. map[string]int
  9763. </em>
  9764. </td>
  9765. <td>
  9766. <p>Vaults defines which OnePassword vaults to search in which order</p>
  9767. </td>
  9768. </tr>
  9769. </tbody>
  9770. </table>
  9771. <h3 id="external-secrets.io/v1.OnePasswordSDKAuth">OnePasswordSDKAuth
  9772. </h3>
  9773. <p>
  9774. (<em>Appears on:</em>
  9775. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  9776. </p>
  9777. <p>
  9778. <p>OnePasswordSDKAuth contains a secretRef for the service account token.</p>
  9779. </p>
  9780. <table>
  9781. <thead>
  9782. <tr>
  9783. <th>Field</th>
  9784. <th>Description</th>
  9785. </tr>
  9786. </thead>
  9787. <tbody>
  9788. <tr>
  9789. <td>
  9790. <code>serviceAccountSecretRef</code></br>
  9791. <em>
  9792. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9793. External Secrets meta/v1.SecretKeySelector
  9794. </a>
  9795. </em>
  9796. </td>
  9797. <td>
  9798. <p>ServiceAccountSecretRef points to the secret containing the token to access 1Password vault.</p>
  9799. </td>
  9800. </tr>
  9801. </tbody>
  9802. </table>
  9803. <h3 id="external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider
  9804. </h3>
  9805. <p>
  9806. (<em>Appears on:</em>
  9807. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9808. </p>
  9809. <p>
  9810. <p>OnePasswordSDKProvider configures a store to sync secrets using the 1Password sdk.</p>
  9811. </p>
  9812. <table>
  9813. <thead>
  9814. <tr>
  9815. <th>Field</th>
  9816. <th>Description</th>
  9817. </tr>
  9818. </thead>
  9819. <tbody>
  9820. <tr>
  9821. <td>
  9822. <code>vault</code></br>
  9823. <em>
  9824. string
  9825. </em>
  9826. </td>
  9827. <td>
  9828. <p>Vault defines the vault&rsquo;s name or uuid to access. Do NOT add op:// prefix. This will be done automatically.</p>
  9829. </td>
  9830. </tr>
  9831. <tr>
  9832. <td>
  9833. <code>integrationInfo</code></br>
  9834. <em>
  9835. <a href="#external-secrets.io/v1.IntegrationInfo">
  9836. IntegrationInfo
  9837. </a>
  9838. </em>
  9839. </td>
  9840. <td>
  9841. <em>(Optional)</em>
  9842. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.
  9843. If you don&rsquo;t know which name and version to use, use <code>DefaultIntegrationName</code> and <code>DefaultIntegrationVersion</code>, respectively.</p>
  9844. </td>
  9845. </tr>
  9846. <tr>
  9847. <td>
  9848. <code>auth</code></br>
  9849. <em>
  9850. <a href="#external-secrets.io/v1.OnePasswordSDKAuth">
  9851. OnePasswordSDKAuth
  9852. </a>
  9853. </em>
  9854. </td>
  9855. <td>
  9856. <p>Auth defines the information necessary to authenticate against OnePassword API.</p>
  9857. </td>
  9858. </tr>
  9859. <tr>
  9860. <td>
  9861. <code>cache</code></br>
  9862. <em>
  9863. <a href="#external-secrets.io/v1.CacheConfig">
  9864. CacheConfig
  9865. </a>
  9866. </em>
  9867. </td>
  9868. <td>
  9869. <em>(Optional)</em>
  9870. <p>Cache configures client-side caching for read operations (GetSecret, GetSecretMap).
  9871. When enabled, secrets are cached with the specified TTL.
  9872. Write operations (PushSecret, DeleteSecret) automatically invalidate relevant cache entries.
  9873. If omitted, caching is disabled (default).
  9874. cache: {} is a valid option to set.</p>
  9875. </td>
  9876. </tr>
  9877. </tbody>
  9878. </table>
  9879. <h3 id="external-secrets.io/v1.OpenBaoAppRole">OpenBaoAppRole
  9880. </h3>
  9881. <p>
  9882. (<em>Appears on:</em>
  9883. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  9884. </p>
  9885. <p>
  9886. <p>OpenBaoAppRole authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/approle/">App Role auth
  9887. mechanism</a>, with the role and secret stored in a Kubernetes Secret resource.
  9888. The role ID has to be specified either inline via <code>roleId</code> or by referencing
  9889. a secret via <code>roleRef</code>.</p>
  9890. </p>
  9891. <table>
  9892. <thead>
  9893. <tr>
  9894. <th>Field</th>
  9895. <th>Description</th>
  9896. </tr>
  9897. </thead>
  9898. <tbody>
  9899. <tr>
  9900. <td>
  9901. <code>path</code></br>
  9902. <em>
  9903. string
  9904. </em>
  9905. </td>
  9906. <td>
  9907. <p>Path where the App Role authentication backend is mounted
  9908. in OpenBao, e.g: &ldquo;approle&rdquo;</p>
  9909. </td>
  9910. </tr>
  9911. <tr>
  9912. <td>
  9913. <code>roleId</code></br>
  9914. <em>
  9915. string
  9916. </em>
  9917. </td>
  9918. <td>
  9919. <em>(Optional)</em>
  9920. <p>RoleID configured in the App Role authentication backend when setting
  9921. up the authentication backend in OpenBao.</p>
  9922. </td>
  9923. </tr>
  9924. <tr>
  9925. <td>
  9926. <code>roleRef</code></br>
  9927. <em>
  9928. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9929. External Secrets meta/v1.SecretKeySelector
  9930. </a>
  9931. </em>
  9932. </td>
  9933. <td>
  9934. <em>(Optional)</em>
  9935. <p>Reference to a key in a Secret that contains the App Role ID used
  9936. to authenticate with OpenBao.
  9937. The <code>key</code> field must be specified and denotes which entry within the Secret
  9938. resource is used as the app role id.</p>
  9939. </td>
  9940. </tr>
  9941. <tr>
  9942. <td>
  9943. <code>secretRef</code></br>
  9944. <em>
  9945. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9946. External Secrets meta/v1.SecretKeySelector
  9947. </a>
  9948. </em>
  9949. </td>
  9950. <td>
  9951. <p>Reference to a key in a Secret that contains the App Role secret used
  9952. to authenticate with OpenBao.
  9953. The <code>key</code> field must be specified and denotes which entry within the Secret
  9954. resource is used as the app role secret.</p>
  9955. </td>
  9956. </tr>
  9957. </tbody>
  9958. </table>
  9959. <h3 id="external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth
  9960. </h3>
  9961. <p>
  9962. (<em>Appears on:</em>
  9963. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>)
  9964. </p>
  9965. <p>
  9966. <p>OpenBaoAuth is the configuration used to authenticate with an OpenBao server.
  9967. Currently the following authentication methods are supported: <a href="https://openbao.org/docs/auth/approle/">AppRole</a>,
  9968. <a href="https://openbao.org/docs/auth/token/">Token</a> and <a href="https://openbao.org/docs/auth/userpass/">UserPass</a></p>
  9969. <p>Additional authentication methods are planned for future releases.</p>
  9970. </p>
  9971. <table>
  9972. <thead>
  9973. <tr>
  9974. <th>Field</th>
  9975. <th>Description</th>
  9976. </tr>
  9977. </thead>
  9978. <tbody>
  9979. <tr>
  9980. <td>
  9981. <code>appRole</code></br>
  9982. <em>
  9983. <a href="#external-secrets.io/v1.OpenBaoAppRole">
  9984. OpenBaoAppRole
  9985. </a>
  9986. </em>
  9987. </td>
  9988. <td>
  9989. <em>(Optional)</em>
  9990. <p>AppRole authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/approle/">App Role auth mechanism</a>,
  9991. with the role and secret stored in a Kubernetes Secret resource.</p>
  9992. </td>
  9993. </tr>
  9994. <tr>
  9995. <td>
  9996. <code>namespace</code></br>
  9997. <em>
  9998. string
  9999. </em>
  10000. </td>
  10001. <td>
  10002. <em>(Optional)</em>
  10003. <p>Name of the <a href="https://openbao.org/docs/concepts/namespaces/">OpenBao Namespace</a> to authenticate to. This can be different
  10004. than the namespace your secret is in. Namespaces is a set of features
  10005. within OpenBao that allows OpenBao environments to support secure
  10006. multi-tenancy. e.g: &ldquo;ns1&rdquo;. This will default to OpenBao.Namespace field
  10007. if set, or empty otherwise</p>
  10008. </td>
  10009. </tr>
  10010. <tr>
  10011. <td>
  10012. <code>tokenSecretRef</code></br>
  10013. <em>
  10014. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10015. External Secrets meta/v1.SecretKeySelector
  10016. </a>
  10017. </em>
  10018. </td>
  10019. <td>
  10020. <em>(Optional)</em>
  10021. <p>TokenSecretRef authenticates with OpenBao by presenting a token.</p>
  10022. </td>
  10023. </tr>
  10024. <tr>
  10025. <td>
  10026. <code>userPass</code></br>
  10027. <em>
  10028. <a href="#external-secrets.io/v1.OpenBaoUserPassAuth">
  10029. OpenBaoUserPassAuth
  10030. </a>
  10031. </em>
  10032. </td>
  10033. <td>
  10034. <em>(Optional)</em>
  10035. <p>UserPass authenticates with OpenBao by passing a username/password pair</p>
  10036. </td>
  10037. </tr>
  10038. </tbody>
  10039. </table>
  10040. <h3 id="external-secrets.io/v1.OpenBaoKVStoreVersion">OpenBaoKVStoreVersion
  10041. (<code>string</code> alias)</p></h3>
  10042. <p>
  10043. (<em>Appears on:</em>
  10044. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>)
  10045. </p>
  10046. <p>
  10047. <p>OpenBaoKVStoreVersion represents the version of the OpenBao KV secret engine.</p>
  10048. </p>
  10049. <table>
  10050. <thead>
  10051. <tr>
  10052. <th>Value</th>
  10053. <th>Description</th>
  10054. </tr>
  10055. </thead>
  10056. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  10057. <td></td>
  10058. </tr><tr><td><p>&#34;v2&#34;</p></td>
  10059. <td></td>
  10060. </tr></tbody>
  10061. </table>
  10062. <h3 id="external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider
  10063. </h3>
  10064. <p>
  10065. (<em>Appears on:</em>
  10066. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10067. </p>
  10068. <p>
  10069. <p>OpenBaoProvider configures a store to sync secrets using an OpenBao KV backend.</p>
  10070. </p>
  10071. <table>
  10072. <thead>
  10073. <tr>
  10074. <th>Field</th>
  10075. <th>Description</th>
  10076. </tr>
  10077. </thead>
  10078. <tbody>
  10079. <tr>
  10080. <td>
  10081. <code>auth</code></br>
  10082. <em>
  10083. <a href="#external-secrets.io/v1.OpenBaoAuth">
  10084. OpenBaoAuth
  10085. </a>
  10086. </em>
  10087. </td>
  10088. <td>
  10089. <em>(Optional)</em>
  10090. <p>Auth configures how secret-manager authenticates with the OpenBao server.</p>
  10091. </td>
  10092. </tr>
  10093. <tr>
  10094. <td>
  10095. <code>caBundle</code></br>
  10096. <em>
  10097. []byte
  10098. </em>
  10099. </td>
  10100. <td>
  10101. <em>(Optional)</em>
  10102. <p>PEM encoded CA bundle used to validate the OpenBao server certificate. If
  10103. this and <code>caProvider</code> are not set the system root certificates are used
  10104. to validate the TLS connection.</p>
  10105. </td>
  10106. </tr>
  10107. <tr>
  10108. <td>
  10109. <code>caProvider</code></br>
  10110. <em>
  10111. <a href="#external-secrets.io/v1.CAProvider">
  10112. CAProvider
  10113. </a>
  10114. </em>
  10115. </td>
  10116. <td>
  10117. <em>(Optional)</em>
  10118. <p>The provider for the CA bundle to use to validate OpenBao server
  10119. certificate. If this and <code>caBundle</code> are not set the system root
  10120. certificates are used to validate the TLS connection.</p>
  10121. </td>
  10122. </tr>
  10123. <tr>
  10124. <td>
  10125. <code>namespace</code></br>
  10126. <em>
  10127. string
  10128. </em>
  10129. </td>
  10130. <td>
  10131. <em>(Optional)</em>
  10132. <p>Name of the <a href="https://openbao.org/docs/concepts/namespaces/">OpenBao Namespace</a>. Namespaces is a set of features within
  10133. OpenBao that allows OpenBao environments to support secure multi-tenancy.
  10134. e.g: &ldquo;ns1&rdquo;.</p>
  10135. </td>
  10136. </tr>
  10137. <tr>
  10138. <td>
  10139. <code>server</code></br>
  10140. <em>
  10141. string
  10142. </em>
  10143. </td>
  10144. <td>
  10145. <p>Server is the connection address for the OpenBao server, e.g: <code>https://openbao.example.com:8200</code>.</p>
  10146. </td>
  10147. </tr>
  10148. <tr>
  10149. <td>
  10150. <code>path</code></br>
  10151. <em>
  10152. string
  10153. </em>
  10154. </td>
  10155. <td>
  10156. <em>(Optional)</em>
  10157. <p>Path is the mount path of the OpenBao KV backend endpoint, e.g:
  10158. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  10159. for fetching secrets from OpenBao is optional and will be appended
  10160. if not present in specified path.</p>
  10161. </td>
  10162. </tr>
  10163. <tr>
  10164. <td>
  10165. <code>version</code></br>
  10166. <em>
  10167. <a href="#external-secrets.io/v1.OpenBaoKVStoreVersion">
  10168. OpenBaoKVStoreVersion
  10169. </a>
  10170. </em>
  10171. </td>
  10172. <td>
  10173. <p>Version is the OpenBao KV secret engine version. This can be either &ldquo;v1&rdquo; or
  10174. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  10175. </td>
  10176. </tr>
  10177. </tbody>
  10178. </table>
  10179. <h3 id="external-secrets.io/v1.OpenBaoUserPassAuth">OpenBaoUserPassAuth
  10180. </h3>
  10181. <p>
  10182. (<em>Appears on:</em>
  10183. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  10184. </p>
  10185. <p>
  10186. <p>OpenBaoUserPassAuth authenticates with OpenBao using <a href="https://openbao.org/docs/auth/userpass/">UserPass authentication
  10187. method</a>, with the username and password stored in a Kubernetes Secret
  10188. resource.</p>
  10189. </p>
  10190. <table>
  10191. <thead>
  10192. <tr>
  10193. <th>Field</th>
  10194. <th>Description</th>
  10195. </tr>
  10196. </thead>
  10197. <tbody>
  10198. <tr>
  10199. <td>
  10200. <code>path</code></br>
  10201. <em>
  10202. string
  10203. </em>
  10204. </td>
  10205. <td>
  10206. <p>Path where the UserPassword authentication backend is mounted
  10207. in OpenBao, e.g: &ldquo;userpass&rdquo;</p>
  10208. </td>
  10209. </tr>
  10210. <tr>
  10211. <td>
  10212. <code>username</code></br>
  10213. <em>
  10214. string
  10215. </em>
  10216. </td>
  10217. <td>
  10218. <p>Username is a username used to authenticate using the <a href="https://openbao.org/docs/auth/userpass/">UserPass
  10219. authentication method</a></p>
  10220. </td>
  10221. </tr>
  10222. <tr>
  10223. <td>
  10224. <code>secretRef</code></br>
  10225. <em>
  10226. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10227. External Secrets meta/v1.SecretKeySelector
  10228. </a>
  10229. </em>
  10230. </td>
  10231. <td>
  10232. <p>SecretRef to a key in a Secret resource containing password for the user
  10233. used to authenticate with OpenBao using the <a href="https://openbao.org/docs/auth/userpass/">UserPass authentication
  10234. method</a></p>
  10235. </td>
  10236. </tr>
  10237. </tbody>
  10238. </table>
  10239. <h3 id="external-secrets.io/v1.OracleAuth">OracleAuth
  10240. </h3>
  10241. <p>
  10242. (<em>Appears on:</em>
  10243. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  10244. </p>
  10245. <p>
  10246. <p>OracleAuth defines the authentication method for the Oracle Vault provider.</p>
  10247. </p>
  10248. <table>
  10249. <thead>
  10250. <tr>
  10251. <th>Field</th>
  10252. <th>Description</th>
  10253. </tr>
  10254. </thead>
  10255. <tbody>
  10256. <tr>
  10257. <td>
  10258. <code>tenancy</code></br>
  10259. <em>
  10260. string
  10261. </em>
  10262. </td>
  10263. <td>
  10264. <p>Tenancy is the tenancy OCID where user is located.</p>
  10265. </td>
  10266. </tr>
  10267. <tr>
  10268. <td>
  10269. <code>user</code></br>
  10270. <em>
  10271. string
  10272. </em>
  10273. </td>
  10274. <td>
  10275. <p>User is an access OCID specific to the account.</p>
  10276. </td>
  10277. </tr>
  10278. <tr>
  10279. <td>
  10280. <code>secretRef</code></br>
  10281. <em>
  10282. <a href="#external-secrets.io/v1.OracleSecretRef">
  10283. OracleSecretRef
  10284. </a>
  10285. </em>
  10286. </td>
  10287. <td>
  10288. <p>SecretRef to pass through sensitive information.</p>
  10289. </td>
  10290. </tr>
  10291. </tbody>
  10292. </table>
  10293. <h3 id="external-secrets.io/v1.OraclePrincipalType">OraclePrincipalType
  10294. (<code>string</code> alias)</p></h3>
  10295. <p>
  10296. (<em>Appears on:</em>
  10297. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  10298. </p>
  10299. <p>
  10300. <p>OraclePrincipalType defines the type of principal used for authentication with Oracle Vault.</p>
  10301. </p>
  10302. <table>
  10303. <thead>
  10304. <tr>
  10305. <th>Value</th>
  10306. <th>Description</th>
  10307. </tr>
  10308. </thead>
  10309. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  10310. <td><p>InstancePrincipal represents a instance principal.</p>
  10311. </td>
  10312. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  10313. <td><p>UserPrincipal represents a user principal.</p>
  10314. </td>
  10315. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  10316. <td><p>WorkloadPrincipal represents a workload principal.</p>
  10317. </td>
  10318. </tr></tbody>
  10319. </table>
  10320. <h3 id="external-secrets.io/v1.OracleProvider">OracleProvider
  10321. </h3>
  10322. <p>
  10323. (<em>Appears on:</em>
  10324. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10325. </p>
  10326. <p>
  10327. <p>OracleProvider configures a store to sync secrets using an Oracle Vault
  10328. backend.</p>
  10329. </p>
  10330. <table>
  10331. <thead>
  10332. <tr>
  10333. <th>Field</th>
  10334. <th>Description</th>
  10335. </tr>
  10336. </thead>
  10337. <tbody>
  10338. <tr>
  10339. <td>
  10340. <code>region</code></br>
  10341. <em>
  10342. string
  10343. </em>
  10344. </td>
  10345. <td>
  10346. <p>Region is the region where vault is located.</p>
  10347. </td>
  10348. </tr>
  10349. <tr>
  10350. <td>
  10351. <code>vault</code></br>
  10352. <em>
  10353. string
  10354. </em>
  10355. </td>
  10356. <td>
  10357. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  10358. </td>
  10359. </tr>
  10360. <tr>
  10361. <td>
  10362. <code>compartment</code></br>
  10363. <em>
  10364. string
  10365. </em>
  10366. </td>
  10367. <td>
  10368. <em>(Optional)</em>
  10369. <p>Compartment is the vault compartment OCID.
  10370. Required for PushSecret</p>
  10371. </td>
  10372. </tr>
  10373. <tr>
  10374. <td>
  10375. <code>encryptionKey</code></br>
  10376. <em>
  10377. string
  10378. </em>
  10379. </td>
  10380. <td>
  10381. <em>(Optional)</em>
  10382. <p>EncryptionKey is the OCID of the encryption key within the vault.
  10383. Required for PushSecret</p>
  10384. </td>
  10385. </tr>
  10386. <tr>
  10387. <td>
  10388. <code>principalType</code></br>
  10389. <em>
  10390. <a href="#external-secrets.io/v1.OraclePrincipalType">
  10391. OraclePrincipalType
  10392. </a>
  10393. </em>
  10394. </td>
  10395. <td>
  10396. <em>(Optional)</em>
  10397. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  10398. determine the principal type. This optional field must be specified if using
  10399. workload identity.</p>
  10400. </td>
  10401. </tr>
  10402. <tr>
  10403. <td>
  10404. <code>auth</code></br>
  10405. <em>
  10406. <a href="#external-secrets.io/v1.OracleAuth">
  10407. OracleAuth
  10408. </a>
  10409. </em>
  10410. </td>
  10411. <td>
  10412. <em>(Optional)</em>
  10413. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  10414. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  10415. </td>
  10416. </tr>
  10417. <tr>
  10418. <td>
  10419. <code>serviceAccountRef</code></br>
  10420. <em>
  10421. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  10422. External Secrets meta/v1.ServiceAccountSelector
  10423. </a>
  10424. </em>
  10425. </td>
  10426. <td>
  10427. <em>(Optional)</em>
  10428. <p>ServiceAccountRef specified the service account
  10429. that should be used when authenticating with WorkloadIdentity.</p>
  10430. </td>
  10431. </tr>
  10432. </tbody>
  10433. </table>
  10434. <h3 id="external-secrets.io/v1.OracleSecretRef">OracleSecretRef
  10435. </h3>
  10436. <p>
  10437. (<em>Appears on:</em>
  10438. <a href="#external-secrets.io/v1.OracleAuth">OracleAuth</a>)
  10439. </p>
  10440. <p>
  10441. <p>OracleSecretRef contains the secret reference for Oracle Vault authentication credentials.</p>
  10442. </p>
  10443. <table>
  10444. <thead>
  10445. <tr>
  10446. <th>Field</th>
  10447. <th>Description</th>
  10448. </tr>
  10449. </thead>
  10450. <tbody>
  10451. <tr>
  10452. <td>
  10453. <code>privatekey</code></br>
  10454. <em>
  10455. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10456. External Secrets meta/v1.SecretKeySelector
  10457. </a>
  10458. </em>
  10459. </td>
  10460. <td>
  10461. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  10462. </td>
  10463. </tr>
  10464. <tr>
  10465. <td>
  10466. <code>fingerprint</code></br>
  10467. <em>
  10468. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10469. External Secrets meta/v1.SecretKeySelector
  10470. </a>
  10471. </em>
  10472. </td>
  10473. <td>
  10474. <p>Fingerprint is the fingerprint of the API private key.</p>
  10475. </td>
  10476. </tr>
  10477. </tbody>
  10478. </table>
  10479. <h3 id="external-secrets.io/v1.OvhAuth">OvhAuth
  10480. </h3>
  10481. <p>
  10482. (<em>Appears on:</em>
  10483. <a href="#external-secrets.io/v1.OvhProvider">OvhProvider</a>)
  10484. </p>
  10485. <p>
  10486. <p>OvhAuth tells the controller how to authenticate to OVHcloud&rsquo;s Secret Manager, either using mTLS or a token.</p>
  10487. </p>
  10488. <table>
  10489. <thead>
  10490. <tr>
  10491. <th>Field</th>
  10492. <th>Description</th>
  10493. </tr>
  10494. </thead>
  10495. <tbody>
  10496. <tr>
  10497. <td>
  10498. <code>mtls</code></br>
  10499. <em>
  10500. <a href="#external-secrets.io/v1.OvhClientMTLS">
  10501. OvhClientMTLS
  10502. </a>
  10503. </em>
  10504. </td>
  10505. <td>
  10506. <em>(Optional)</em>
  10507. </td>
  10508. </tr>
  10509. <tr>
  10510. <td>
  10511. <code>token</code></br>
  10512. <em>
  10513. <a href="#external-secrets.io/v1.OvhClientToken">
  10514. OvhClientToken
  10515. </a>
  10516. </em>
  10517. </td>
  10518. <td>
  10519. <em>(Optional)</em>
  10520. </td>
  10521. </tr>
  10522. </tbody>
  10523. </table>
  10524. <h3 id="external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS
  10525. </h3>
  10526. <p>
  10527. (<em>Appears on:</em>
  10528. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  10529. </p>
  10530. <p>
  10531. <p>OvhClientMTLS defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using mTLS.</p>
  10532. </p>
  10533. <table>
  10534. <thead>
  10535. <tr>
  10536. <th>Field</th>
  10537. <th>Description</th>
  10538. </tr>
  10539. </thead>
  10540. <tbody>
  10541. <tr>
  10542. <td>
  10543. <code>certSecretRef</code></br>
  10544. <em>
  10545. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10546. External Secrets meta/v1.SecretKeySelector
  10547. </a>
  10548. </em>
  10549. </td>
  10550. <td>
  10551. </td>
  10552. </tr>
  10553. <tr>
  10554. <td>
  10555. <code>keySecretRef</code></br>
  10556. <em>
  10557. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10558. External Secrets meta/v1.SecretKeySelector
  10559. </a>
  10560. </em>
  10561. </td>
  10562. <td>
  10563. </td>
  10564. </tr>
  10565. <tr>
  10566. <td>
  10567. <code>caBundle</code></br>
  10568. <em>
  10569. []byte
  10570. </em>
  10571. </td>
  10572. <td>
  10573. <em>(Optional)</em>
  10574. </td>
  10575. </tr>
  10576. <tr>
  10577. <td>
  10578. <code>caProvider</code></br>
  10579. <em>
  10580. <a href="#external-secrets.io/v1.CAProvider">
  10581. CAProvider
  10582. </a>
  10583. </em>
  10584. </td>
  10585. <td>
  10586. <em>(Optional)</em>
  10587. </td>
  10588. </tr>
  10589. </tbody>
  10590. </table>
  10591. <h3 id="external-secrets.io/v1.OvhClientToken">OvhClientToken
  10592. </h3>
  10593. <p>
  10594. (<em>Appears on:</em>
  10595. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  10596. </p>
  10597. <p>
  10598. <p>OvhClientToken defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using a token.</p>
  10599. </p>
  10600. <table>
  10601. <thead>
  10602. <tr>
  10603. <th>Field</th>
  10604. <th>Description</th>
  10605. </tr>
  10606. </thead>
  10607. <tbody>
  10608. <tr>
  10609. <td>
  10610. <code>tokenSecretRef</code></br>
  10611. <em>
  10612. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10613. External Secrets meta/v1.SecretKeySelector
  10614. </a>
  10615. </em>
  10616. </td>
  10617. <td>
  10618. </td>
  10619. </tr>
  10620. </tbody>
  10621. </table>
  10622. <h3 id="external-secrets.io/v1.OvhProvider">OvhProvider
  10623. </h3>
  10624. <p>
  10625. (<em>Appears on:</em>
  10626. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10627. </p>
  10628. <p>
  10629. <p>OvhProvider holds the configuration to synchronize secrets with OVHcloud&rsquo;s Secret Manager.</p>
  10630. </p>
  10631. <table>
  10632. <thead>
  10633. <tr>
  10634. <th>Field</th>
  10635. <th>Description</th>
  10636. </tr>
  10637. </thead>
  10638. <tbody>
  10639. <tr>
  10640. <td>
  10641. <code>server</code></br>
  10642. <em>
  10643. string
  10644. </em>
  10645. </td>
  10646. <td>
  10647. <p>specifies the OKMS server endpoint.</p>
  10648. </td>
  10649. </tr>
  10650. <tr>
  10651. <td>
  10652. <code>okmsid</code></br>
  10653. <em>
  10654. string
  10655. </em>
  10656. </td>
  10657. <td>
  10658. <p>specifies the OKMS ID.</p>
  10659. </td>
  10660. </tr>
  10661. <tr>
  10662. <td>
  10663. <code>casRequired</code></br>
  10664. <em>
  10665. bool
  10666. </em>
  10667. </td>
  10668. <td>
  10669. <em>(Optional)</em>
  10670. <p>Enables or disables check-and-set (CAS) (default: false).</p>
  10671. </td>
  10672. </tr>
  10673. <tr>
  10674. <td>
  10675. <code>okmsTimeout</code></br>
  10676. <em>
  10677. uint32
  10678. </em>
  10679. </td>
  10680. <td>
  10681. <em>(Optional)</em>
  10682. <p>Setup a timeout in seconds when requests to the KMS are made (default: 30).</p>
  10683. </td>
  10684. </tr>
  10685. <tr>
  10686. <td>
  10687. <code>auth</code></br>
  10688. <em>
  10689. <a href="#external-secrets.io/v1.OvhAuth">
  10690. OvhAuth
  10691. </a>
  10692. </em>
  10693. </td>
  10694. <td>
  10695. <p>Authentication method (mtls or token).</p>
  10696. </td>
  10697. </tr>
  10698. </tbody>
  10699. </table>
  10700. <h3 id="external-secrets.io/v1.PassboltAuth">PassboltAuth
  10701. </h3>
  10702. <p>
  10703. (<em>Appears on:</em>
  10704. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>)
  10705. </p>
  10706. <p>
  10707. <p>PassboltAuth contains a secretRef for the passbolt credentials.</p>
  10708. </p>
  10709. <table>
  10710. <thead>
  10711. <tr>
  10712. <th>Field</th>
  10713. <th>Description</th>
  10714. </tr>
  10715. </thead>
  10716. <tbody>
  10717. <tr>
  10718. <td>
  10719. <code>passwordSecretRef</code></br>
  10720. <em>
  10721. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10722. External Secrets meta/v1.SecretKeySelector
  10723. </a>
  10724. </em>
  10725. </td>
  10726. <td>
  10727. </td>
  10728. </tr>
  10729. <tr>
  10730. <td>
  10731. <code>privateKeySecretRef</code></br>
  10732. <em>
  10733. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10734. External Secrets meta/v1.SecretKeySelector
  10735. </a>
  10736. </em>
  10737. </td>
  10738. <td>
  10739. </td>
  10740. </tr>
  10741. </tbody>
  10742. </table>
  10743. <h3 id="external-secrets.io/v1.PassboltProvider">PassboltProvider
  10744. </h3>
  10745. <p>
  10746. (<em>Appears on:</em>
  10747. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10748. </p>
  10749. <p>
  10750. <p>PassboltProvider provides access to Passbolt secrets manager.
  10751. See: <a href="https://www.passbolt.com">https://www.passbolt.com</a>.</p>
  10752. </p>
  10753. <table>
  10754. <thead>
  10755. <tr>
  10756. <th>Field</th>
  10757. <th>Description</th>
  10758. </tr>
  10759. </thead>
  10760. <tbody>
  10761. <tr>
  10762. <td>
  10763. <code>auth</code></br>
  10764. <em>
  10765. <a href="#external-secrets.io/v1.PassboltAuth">
  10766. PassboltAuth
  10767. </a>
  10768. </em>
  10769. </td>
  10770. <td>
  10771. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  10772. </td>
  10773. </tr>
  10774. <tr>
  10775. <td>
  10776. <code>host</code></br>
  10777. <em>
  10778. string
  10779. </em>
  10780. </td>
  10781. <td>
  10782. <p>Host defines the Passbolt Server to connect to</p>
  10783. </td>
  10784. </tr>
  10785. <tr>
  10786. <td>
  10787. <code>caBundle</code></br>
  10788. <em>
  10789. []byte
  10790. </em>
  10791. </td>
  10792. <td>
  10793. <em>(Optional)</em>
  10794. <p>PEM encoded CA bundle used to validate Passbolt server certificate. Only used
  10795. if the Host URL is using HTTPS protocol. If not set the system root certificates
  10796. are used to validate the TLS connection.</p>
  10797. </td>
  10798. </tr>
  10799. <tr>
  10800. <td>
  10801. <code>caProvider</code></br>
  10802. <em>
  10803. <a href="#external-secrets.io/v1.CAProvider">
  10804. CAProvider
  10805. </a>
  10806. </em>
  10807. </td>
  10808. <td>
  10809. <em>(Optional)</em>
  10810. <p>The provider for the CA bundle to use to validate Passbolt server certificate.</p>
  10811. </td>
  10812. </tr>
  10813. </tbody>
  10814. </table>
  10815. <h3 id="external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth
  10816. </h3>
  10817. <p>
  10818. (<em>Appears on:</em>
  10819. <a href="#external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider</a>)
  10820. </p>
  10821. <p>
  10822. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</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>secretRef</code></br>
  10835. <em>
  10836. <a href="#external-secrets.io/v1.PasswordDepotSecretRef">
  10837. PasswordDepotSecretRef
  10838. </a>
  10839. </em>
  10840. </td>
  10841. <td>
  10842. </td>
  10843. </tr>
  10844. </tbody>
  10845. </table>
  10846. <h3 id="external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider
  10847. </h3>
  10848. <p>
  10849. (<em>Appears on:</em>
  10850. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10851. </p>
  10852. <p>
  10853. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  10854. </p>
  10855. <table>
  10856. <thead>
  10857. <tr>
  10858. <th>Field</th>
  10859. <th>Description</th>
  10860. </tr>
  10861. </thead>
  10862. <tbody>
  10863. <tr>
  10864. <td>
  10865. <code>host</code></br>
  10866. <em>
  10867. string
  10868. </em>
  10869. </td>
  10870. <td>
  10871. <p>URL configures the Password Depot instance URL.</p>
  10872. </td>
  10873. </tr>
  10874. <tr>
  10875. <td>
  10876. <code>database</code></br>
  10877. <em>
  10878. string
  10879. </em>
  10880. </td>
  10881. <td>
  10882. <p>Database to use as source</p>
  10883. </td>
  10884. </tr>
  10885. <tr>
  10886. <td>
  10887. <code>auth</code></br>
  10888. <em>
  10889. <a href="#external-secrets.io/v1.PasswordDepotAuth">
  10890. PasswordDepotAuth
  10891. </a>
  10892. </em>
  10893. </td>
  10894. <td>
  10895. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  10896. </td>
  10897. </tr>
  10898. </tbody>
  10899. </table>
  10900. <h3 id="external-secrets.io/v1.PasswordDepotSecretRef">PasswordDepotSecretRef
  10901. </h3>
  10902. <p>
  10903. (<em>Appears on:</em>
  10904. <a href="#external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth</a>)
  10905. </p>
  10906. <p>
  10907. <p>PasswordDepotSecretRef contains the secret reference for Password Depot authentication.</p>
  10908. </p>
  10909. <table>
  10910. <thead>
  10911. <tr>
  10912. <th>Field</th>
  10913. <th>Description</th>
  10914. </tr>
  10915. </thead>
  10916. <tbody>
  10917. <tr>
  10918. <td>
  10919. <code>credentials</code></br>
  10920. <em>
  10921. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10922. External Secrets meta/v1.SecretKeySelector
  10923. </a>
  10924. </em>
  10925. </td>
  10926. <td>
  10927. <em>(Optional)</em>
  10928. <p>Username / Password is used for authentication.</p>
  10929. </td>
  10930. </tr>
  10931. </tbody>
  10932. </table>
  10933. <h3 id="external-secrets.io/v1.PreviderAuth">PreviderAuth
  10934. </h3>
  10935. <p>
  10936. (<em>Appears on:</em>
  10937. <a href="#external-secrets.io/v1.PreviderProvider">PreviderProvider</a>)
  10938. </p>
  10939. <p>
  10940. <p>PreviderAuth contains a secretRef for credentials.</p>
  10941. </p>
  10942. <table>
  10943. <thead>
  10944. <tr>
  10945. <th>Field</th>
  10946. <th>Description</th>
  10947. </tr>
  10948. </thead>
  10949. <tbody>
  10950. <tr>
  10951. <td>
  10952. <code>secretRef</code></br>
  10953. <em>
  10954. <a href="#external-secrets.io/v1.PreviderAuthSecretRef">
  10955. PreviderAuthSecretRef
  10956. </a>
  10957. </em>
  10958. </td>
  10959. <td>
  10960. <em>(Optional)</em>
  10961. </td>
  10962. </tr>
  10963. </tbody>
  10964. </table>
  10965. <h3 id="external-secrets.io/v1.PreviderAuthSecretRef">PreviderAuthSecretRef
  10966. </h3>
  10967. <p>
  10968. (<em>Appears on:</em>
  10969. <a href="#external-secrets.io/v1.PreviderAuth">PreviderAuth</a>)
  10970. </p>
  10971. <p>
  10972. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  10973. </p>
  10974. <table>
  10975. <thead>
  10976. <tr>
  10977. <th>Field</th>
  10978. <th>Description</th>
  10979. </tr>
  10980. </thead>
  10981. <tbody>
  10982. <tr>
  10983. <td>
  10984. <code>accessToken</code></br>
  10985. <em>
  10986. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10987. External Secrets meta/v1.SecretKeySelector
  10988. </a>
  10989. </em>
  10990. </td>
  10991. <td>
  10992. <p>The AccessToken is used for authentication</p>
  10993. </td>
  10994. </tr>
  10995. </tbody>
  10996. </table>
  10997. <h3 id="external-secrets.io/v1.PreviderProvider">PreviderProvider
  10998. </h3>
  10999. <p>
  11000. (<em>Appears on:</em>
  11001. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11002. </p>
  11003. <p>
  11004. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  11005. </p>
  11006. <table>
  11007. <thead>
  11008. <tr>
  11009. <th>Field</th>
  11010. <th>Description</th>
  11011. </tr>
  11012. </thead>
  11013. <tbody>
  11014. <tr>
  11015. <td>
  11016. <code>auth</code></br>
  11017. <em>
  11018. <a href="#external-secrets.io/v1.PreviderAuth">
  11019. PreviderAuth
  11020. </a>
  11021. </em>
  11022. </td>
  11023. <td>
  11024. </td>
  11025. </tr>
  11026. <tr>
  11027. <td>
  11028. <code>baseUri</code></br>
  11029. <em>
  11030. string
  11031. </em>
  11032. </td>
  11033. <td>
  11034. <em>(Optional)</em>
  11035. </td>
  11036. </tr>
  11037. </tbody>
  11038. </table>
  11039. <h3 id="external-secrets.io/v1.Provider">Provider
  11040. </h3>
  11041. <p>
  11042. <p>Provider is a common interface for interacting with secret backends.</p>
  11043. </p>
  11044. <h3 id="external-secrets.io/v1.PulumiAuth">PulumiAuth
  11045. </h3>
  11046. <p>
  11047. (<em>Appears on:</em>
  11048. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  11049. </p>
  11050. <p>
  11051. <p>PulumiAuth configures authentication with the Pulumi API.
  11052. Exactly one of accessToken or oidcConfig must be specified.</p>
  11053. </p>
  11054. <table>
  11055. <thead>
  11056. <tr>
  11057. <th>Field</th>
  11058. <th>Description</th>
  11059. </tr>
  11060. </thead>
  11061. <tbody>
  11062. <tr>
  11063. <td>
  11064. <code>accessToken</code></br>
  11065. <em>
  11066. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  11067. PulumiProviderSecretRef
  11068. </a>
  11069. </em>
  11070. </td>
  11071. <td>
  11072. <em>(Optional)</em>
  11073. <p>AccessToken authenticates using a Pulumi access token stored in a Kubernetes Secret.</p>
  11074. </td>
  11075. </tr>
  11076. <tr>
  11077. <td>
  11078. <code>oidcConfig</code></br>
  11079. <em>
  11080. <a href="#external-secrets.io/v1.PulumiOIDCAuth">
  11081. PulumiOIDCAuth
  11082. </a>
  11083. </em>
  11084. </td>
  11085. <td>
  11086. <em>(Optional)</em>
  11087. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  11088. </td>
  11089. </tr>
  11090. </tbody>
  11091. </table>
  11092. <h3 id="external-secrets.io/v1.PulumiOIDCAuth">PulumiOIDCAuth
  11093. </h3>
  11094. <p>
  11095. (<em>Appears on:</em>
  11096. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>)
  11097. </p>
  11098. <p>
  11099. <p>PulumiOIDCAuth configures OIDC authentication with Pulumi using Kubernetes ServiceAccount tokens.</p>
  11100. </p>
  11101. <table>
  11102. <thead>
  11103. <tr>
  11104. <th>Field</th>
  11105. <th>Description</th>
  11106. </tr>
  11107. </thead>
  11108. <tbody>
  11109. <tr>
  11110. <td>
  11111. <code>organization</code></br>
  11112. <em>
  11113. string
  11114. </em>
  11115. </td>
  11116. <td>
  11117. <p>Organization is the name of the Pulumi organization configured for OIDC authentication.</p>
  11118. </td>
  11119. </tr>
  11120. <tr>
  11121. <td>
  11122. <code>serviceAccountRef</code></br>
  11123. <em>
  11124. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  11125. External Secrets meta/v1.ServiceAccountSelector
  11126. </a>
  11127. </em>
  11128. </td>
  11129. <td>
  11130. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  11131. </td>
  11132. </tr>
  11133. <tr>
  11134. <td>
  11135. <code>expirationSeconds</code></br>
  11136. <em>
  11137. int64
  11138. </em>
  11139. </td>
  11140. <td>
  11141. <em>(Optional)</em>
  11142. <p>ExpirationSeconds sets the token validity duration for service account and OIDC token.
  11143. Defaults to 10 minutes.</p>
  11144. </td>
  11145. </tr>
  11146. </tbody>
  11147. </table>
  11148. <h3 id="external-secrets.io/v1.PulumiProvider">PulumiProvider
  11149. </h3>
  11150. <p>
  11151. (<em>Appears on:</em>
  11152. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11153. </p>
  11154. <p>
  11155. <p>PulumiProvider defines configuration for accessing secrets from Pulumi ESC.</p>
  11156. </p>
  11157. <table>
  11158. <thead>
  11159. <tr>
  11160. <th>Field</th>
  11161. <th>Description</th>
  11162. </tr>
  11163. </thead>
  11164. <tbody>
  11165. <tr>
  11166. <td>
  11167. <code>apiUrl</code></br>
  11168. <em>
  11169. string
  11170. </em>
  11171. </td>
  11172. <td>
  11173. <p>APIURL is the URL of the Pulumi API.</p>
  11174. </td>
  11175. </tr>
  11176. <tr>
  11177. <td>
  11178. <code>auth</code></br>
  11179. <em>
  11180. <a href="#external-secrets.io/v1.PulumiAuth">
  11181. PulumiAuth
  11182. </a>
  11183. </em>
  11184. </td>
  11185. <td>
  11186. <em>(Optional)</em>
  11187. <p>Auth configures how the Operator authenticates with the Pulumi API.
  11188. Either auth or the deprecated accessToken field must be specified.</p>
  11189. </td>
  11190. </tr>
  11191. <tr>
  11192. <td>
  11193. <code>organization</code></br>
  11194. <em>
  11195. string
  11196. </em>
  11197. </td>
  11198. <td>
  11199. <p>Organization are a space to collaborate on shared projects and stacks.
  11200. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  11201. </td>
  11202. </tr>
  11203. <tr>
  11204. <td>
  11205. <code>project</code></br>
  11206. <em>
  11207. string
  11208. </em>
  11209. </td>
  11210. <td>
  11211. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  11212. </td>
  11213. </tr>
  11214. <tr>
  11215. <td>
  11216. <code>environment</code></br>
  11217. <em>
  11218. string
  11219. </em>
  11220. </td>
  11221. <td>
  11222. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  11223. dynamically retrieved values from supported providers including all major clouds,
  11224. and other Pulumi ESC environments.
  11225. 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>
  11226. </td>
  11227. </tr>
  11228. <tr>
  11229. <td>
  11230. <code>accessToken</code></br>
  11231. <em>
  11232. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  11233. PulumiProviderSecretRef
  11234. </a>
  11235. </em>
  11236. </td>
  11237. <td>
  11238. <em>(Optional)</em>
  11239. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  11240. <p>Deprecated: Use auth.accessToken instead.</p>
  11241. </td>
  11242. </tr>
  11243. </tbody>
  11244. </table>
  11245. <h3 id="external-secrets.io/v1.PulumiProviderSecretRef">PulumiProviderSecretRef
  11246. </h3>
  11247. <p>
  11248. (<em>Appears on:</em>
  11249. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>,
  11250. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  11251. </p>
  11252. <p>
  11253. <p>PulumiProviderSecretRef contains the secret reference for Pulumi authentication.</p>
  11254. </p>
  11255. <table>
  11256. <thead>
  11257. <tr>
  11258. <th>Field</th>
  11259. <th>Description</th>
  11260. </tr>
  11261. </thead>
  11262. <tbody>
  11263. <tr>
  11264. <td>
  11265. <code>secretRef</code></br>
  11266. <em>
  11267. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11268. External Secrets meta/v1.SecretKeySelector
  11269. </a>
  11270. </em>
  11271. </td>
  11272. <td>
  11273. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  11274. </td>
  11275. </tr>
  11276. </tbody>
  11277. </table>
  11278. <h3 id="external-secrets.io/v1.PushSecretData">PushSecretData
  11279. </h3>
  11280. <p>
  11281. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1.</p>
  11282. </p>
  11283. <h3 id="external-secrets.io/v1.PushSecretRemoteRef">PushSecretRemoteRef
  11284. </h3>
  11285. <p>
  11286. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1.</p>
  11287. </p>
  11288. <h3 id="external-secrets.io/v1.ScalewayProvider">ScalewayProvider
  11289. </h3>
  11290. <p>
  11291. (<em>Appears on:</em>
  11292. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11293. </p>
  11294. <p>
  11295. <p>ScalewayProvider defines the configuration for the Scaleway Secret Manager provider.</p>
  11296. </p>
  11297. <table>
  11298. <thead>
  11299. <tr>
  11300. <th>Field</th>
  11301. <th>Description</th>
  11302. </tr>
  11303. </thead>
  11304. <tbody>
  11305. <tr>
  11306. <td>
  11307. <code>apiUrl</code></br>
  11308. <em>
  11309. string
  11310. </em>
  11311. </td>
  11312. <td>
  11313. <em>(Optional)</em>
  11314. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  11315. </td>
  11316. </tr>
  11317. <tr>
  11318. <td>
  11319. <code>region</code></br>
  11320. <em>
  11321. string
  11322. </em>
  11323. </td>
  11324. <td>
  11325. <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>
  11326. </td>
  11327. </tr>
  11328. <tr>
  11329. <td>
  11330. <code>projectId</code></br>
  11331. <em>
  11332. string
  11333. </em>
  11334. </td>
  11335. <td>
  11336. <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>
  11337. </td>
  11338. </tr>
  11339. <tr>
  11340. <td>
  11341. <code>accessKey</code></br>
  11342. <em>
  11343. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  11344. ScalewayProviderSecretRef
  11345. </a>
  11346. </em>
  11347. </td>
  11348. <td>
  11349. <p>AccessKey is the non-secret part of the api key.</p>
  11350. </td>
  11351. </tr>
  11352. <tr>
  11353. <td>
  11354. <code>secretKey</code></br>
  11355. <em>
  11356. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  11357. ScalewayProviderSecretRef
  11358. </a>
  11359. </em>
  11360. </td>
  11361. <td>
  11362. <p>SecretKey is the non-secret part of the api key.</p>
  11363. </td>
  11364. </tr>
  11365. </tbody>
  11366. </table>
  11367. <h3 id="external-secrets.io/v1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  11368. </h3>
  11369. <p>
  11370. (<em>Appears on:</em>
  11371. <a href="#external-secrets.io/v1.ScalewayProvider">ScalewayProvider</a>)
  11372. </p>
  11373. <p>
  11374. <p>ScalewayProviderSecretRef defines the configuration for Scaleway secret references.</p>
  11375. </p>
  11376. <table>
  11377. <thead>
  11378. <tr>
  11379. <th>Field</th>
  11380. <th>Description</th>
  11381. </tr>
  11382. </thead>
  11383. <tbody>
  11384. <tr>
  11385. <td>
  11386. <code>value</code></br>
  11387. <em>
  11388. string
  11389. </em>
  11390. </td>
  11391. <td>
  11392. <em>(Optional)</em>
  11393. <p>Value can be specified directly to set a value without using a secret.</p>
  11394. </td>
  11395. </tr>
  11396. <tr>
  11397. <td>
  11398. <code>secretRef</code></br>
  11399. <em>
  11400. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11401. External Secrets meta/v1.SecretKeySelector
  11402. </a>
  11403. </em>
  11404. </td>
  11405. <td>
  11406. <em>(Optional)</em>
  11407. <p>SecretRef references a key in a secret that will be used as value.</p>
  11408. </td>
  11409. </tr>
  11410. </tbody>
  11411. </table>
  11412. <h3 id="external-secrets.io/v1.SecretReference">SecretReference
  11413. </h3>
  11414. <p>
  11415. (<em>Appears on:</em>
  11416. <a href="#external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig</a>)
  11417. </p>
  11418. <p>
  11419. <p>SecretReference holds the details of a secret.</p>
  11420. </p>
  11421. <table>
  11422. <thead>
  11423. <tr>
  11424. <th>Field</th>
  11425. <th>Description</th>
  11426. </tr>
  11427. </thead>
  11428. <tbody>
  11429. <tr>
  11430. <td>
  11431. <code>name</code></br>
  11432. <em>
  11433. string
  11434. </em>
  11435. </td>
  11436. <td>
  11437. <p>name of the secret.</p>
  11438. </td>
  11439. </tr>
  11440. <tr>
  11441. <td>
  11442. <code>namespace</code></br>
  11443. <em>
  11444. string
  11445. </em>
  11446. </td>
  11447. <td>
  11448. <p>namespace in which the secret exists. If empty, secret will looked up in local namespace.</p>
  11449. </td>
  11450. </tr>
  11451. </tbody>
  11452. </table>
  11453. <h3 id="external-secrets.io/v1.SecretServerProvider">SecretServerProvider
  11454. </h3>
  11455. <p>
  11456. (<em>Appears on:</em>
  11457. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11458. </p>
  11459. <p>
  11460. <p>SecretServerProvider provides access to authenticate to a secrets provider server.
  11461. 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>
  11462. </p>
  11463. <table>
  11464. <thead>
  11465. <tr>
  11466. <th>Field</th>
  11467. <th>Description</th>
  11468. </tr>
  11469. </thead>
  11470. <tbody>
  11471. <tr>
  11472. <td>
  11473. <code>username</code></br>
  11474. <em>
  11475. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11476. SecretServerProviderRef
  11477. </a>
  11478. </em>
  11479. </td>
  11480. <td>
  11481. <p>Username is the secret server account username.</p>
  11482. </td>
  11483. </tr>
  11484. <tr>
  11485. <td>
  11486. <code>password</code></br>
  11487. <em>
  11488. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11489. SecretServerProviderRef
  11490. </a>
  11491. </em>
  11492. </td>
  11493. <td>
  11494. <p>Password is the secret server account password.</p>
  11495. </td>
  11496. </tr>
  11497. <tr>
  11498. <td>
  11499. <code>domain</code></br>
  11500. <em>
  11501. string
  11502. </em>
  11503. </td>
  11504. <td>
  11505. <em>(Optional)</em>
  11506. <p>Domain is the secret server domain.</p>
  11507. </td>
  11508. </tr>
  11509. <tr>
  11510. <td>
  11511. <code>serverURL</code></br>
  11512. <em>
  11513. string
  11514. </em>
  11515. </td>
  11516. <td>
  11517. <p>ServerURL
  11518. URL to your secret server installation</p>
  11519. </td>
  11520. </tr>
  11521. <tr>
  11522. <td>
  11523. <code>caBundle</code></br>
  11524. <em>
  11525. []byte
  11526. </em>
  11527. </td>
  11528. <td>
  11529. <em>(Optional)</em>
  11530. <p>PEM/base64 encoded CA bundle used to validate Secret ServerURL. Only used
  11531. if the ServerURL URL is using HTTPS protocol. If not set the system root certificates
  11532. are used to validate the TLS connection.</p>
  11533. </td>
  11534. </tr>
  11535. <tr>
  11536. <td>
  11537. <code>caProvider</code></br>
  11538. <em>
  11539. <a href="#external-secrets.io/v1.CAProvider">
  11540. CAProvider
  11541. </a>
  11542. </em>
  11543. </td>
  11544. <td>
  11545. <em>(Optional)</em>
  11546. <p>The provider for the CA bundle to use to validate Secret ServerURL certificate.</p>
  11547. </td>
  11548. </tr>
  11549. </tbody>
  11550. </table>
  11551. <h3 id="external-secrets.io/v1.SecretServerProviderRef">SecretServerProviderRef
  11552. </h3>
  11553. <p>
  11554. (<em>Appears on:</em>
  11555. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>)
  11556. </p>
  11557. <p>
  11558. <p>SecretServerProviderRef references a value that can be specified directly or via a secret
  11559. for a SecretServerProvider.</p>
  11560. </p>
  11561. <table>
  11562. <thead>
  11563. <tr>
  11564. <th>Field</th>
  11565. <th>Description</th>
  11566. </tr>
  11567. </thead>
  11568. <tbody>
  11569. <tr>
  11570. <td>
  11571. <code>value</code></br>
  11572. <em>
  11573. string
  11574. </em>
  11575. </td>
  11576. <td>
  11577. <em>(Optional)</em>
  11578. <p>Value can be specified directly to set a value without using a secret.</p>
  11579. </td>
  11580. </tr>
  11581. <tr>
  11582. <td>
  11583. <code>secretRef</code></br>
  11584. <em>
  11585. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11586. External Secrets meta/v1.SecretKeySelector
  11587. </a>
  11588. </em>
  11589. </td>
  11590. <td>
  11591. <em>(Optional)</em>
  11592. <p>SecretRef references a key in a secret that will be used as value.</p>
  11593. </td>
  11594. </tr>
  11595. </tbody>
  11596. </table>
  11597. <h3 id="external-secrets.io/v1.SecretStore">SecretStore
  11598. </h3>
  11599. <p>
  11600. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  11601. </p>
  11602. <table>
  11603. <thead>
  11604. <tr>
  11605. <th>Field</th>
  11606. <th>Description</th>
  11607. </tr>
  11608. </thead>
  11609. <tbody>
  11610. <tr>
  11611. <td>
  11612. <code>metadata</code></br>
  11613. <em>
  11614. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  11615. Kubernetes meta/v1.ObjectMeta
  11616. </a>
  11617. </em>
  11618. </td>
  11619. <td>
  11620. Refer to the Kubernetes API documentation for the fields of the
  11621. <code>metadata</code> field.
  11622. </td>
  11623. </tr>
  11624. <tr>
  11625. <td>
  11626. <code>spec</code></br>
  11627. <em>
  11628. <a href="#external-secrets.io/v1.SecretStoreSpec">
  11629. SecretStoreSpec
  11630. </a>
  11631. </em>
  11632. </td>
  11633. <td>
  11634. <br/>
  11635. <br/>
  11636. <table>
  11637. <tr>
  11638. <td>
  11639. <code>controller</code></br>
  11640. <em>
  11641. string
  11642. </em>
  11643. </td>
  11644. <td>
  11645. <em>(Optional)</em>
  11646. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  11647. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  11648. </td>
  11649. </tr>
  11650. <tr>
  11651. <td>
  11652. <code>provider</code></br>
  11653. <em>
  11654. <a href="#external-secrets.io/v1.SecretStoreProvider">
  11655. SecretStoreProvider
  11656. </a>
  11657. </em>
  11658. </td>
  11659. <td>
  11660. <p>Used to configure the provider. Only one provider may be set</p>
  11661. </td>
  11662. </tr>
  11663. <tr>
  11664. <td>
  11665. <code>retrySettings</code></br>
  11666. <em>
  11667. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  11668. SecretStoreRetrySettings
  11669. </a>
  11670. </em>
  11671. </td>
  11672. <td>
  11673. <em>(Optional)</em>
  11674. <p>Used to configure HTTP retries on failures.</p>
  11675. </td>
  11676. </tr>
  11677. <tr>
  11678. <td>
  11679. <code>refreshInterval</code></br>
  11680. <em>
  11681. int
  11682. </em>
  11683. </td>
  11684. <td>
  11685. <em>(Optional)</em>
  11686. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  11687. </td>
  11688. </tr>
  11689. <tr>
  11690. <td>
  11691. <code>conditions</code></br>
  11692. <em>
  11693. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  11694. []ClusterSecretStoreCondition
  11695. </a>
  11696. </em>
  11697. </td>
  11698. <td>
  11699. <em>(Optional)</em>
  11700. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  11701. </td>
  11702. </tr>
  11703. </table>
  11704. </td>
  11705. </tr>
  11706. <tr>
  11707. <td>
  11708. <code>status</code></br>
  11709. <em>
  11710. <a href="#external-secrets.io/v1.SecretStoreStatus">
  11711. SecretStoreStatus
  11712. </a>
  11713. </em>
  11714. </td>
  11715. <td>
  11716. </td>
  11717. </tr>
  11718. </tbody>
  11719. </table>
  11720. <h3 id="external-secrets.io/v1.SecretStoreCapabilities">SecretStoreCapabilities
  11721. (<code>string</code> alias)</p></h3>
  11722. <p>
  11723. (<em>Appears on:</em>
  11724. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  11725. </p>
  11726. <p>
  11727. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  11728. </p>
  11729. <table>
  11730. <thead>
  11731. <tr>
  11732. <th>Value</th>
  11733. <th>Description</th>
  11734. </tr>
  11735. </thead>
  11736. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  11737. <td><p>SecretStoreReadOnly indicates that the store can only read secrets.</p>
  11738. </td>
  11739. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  11740. <td><p>SecretStoreReadWrite indicates that the store can both read and write secrets.</p>
  11741. </td>
  11742. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  11743. <td><p>SecretStoreWriteOnly indicates that the store can only write secrets.</p>
  11744. </td>
  11745. </tr></tbody>
  11746. </table>
  11747. <h3 id="external-secrets.io/v1.SecretStoreConditionType">SecretStoreConditionType
  11748. (<code>string</code> alias)</p></h3>
  11749. <p>
  11750. (<em>Appears on:</em>
  11751. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  11752. </p>
  11753. <p>
  11754. <p>SecretStoreConditionType represents the condition of the SecretStore.</p>
  11755. </p>
  11756. <table>
  11757. <thead>
  11758. <tr>
  11759. <th>Value</th>
  11760. <th>Description</th>
  11761. </tr>
  11762. </thead>
  11763. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  11764. <td><p>SecretStoreReady indicates that the store is ready and able to serve requests.</p>
  11765. </td>
  11766. </tr></tbody>
  11767. </table>
  11768. <h3 id="external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider
  11769. </h3>
  11770. <p>
  11771. (<em>Appears on:</em>
  11772. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  11773. </p>
  11774. <p>
  11775. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  11776. </p>
  11777. <table>
  11778. <thead>
  11779. <tr>
  11780. <th>Field</th>
  11781. <th>Description</th>
  11782. </tr>
  11783. </thead>
  11784. <tbody>
  11785. <tr>
  11786. <td>
  11787. <code>aws</code></br>
  11788. <em>
  11789. <a href="#external-secrets.io/v1.AWSProvider">
  11790. AWSProvider
  11791. </a>
  11792. </em>
  11793. </td>
  11794. <td>
  11795. <em>(Optional)</em>
  11796. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  11797. </td>
  11798. </tr>
  11799. <tr>
  11800. <td>
  11801. <code>azurekv</code></br>
  11802. <em>
  11803. <a href="#external-secrets.io/v1.AzureKVProvider">
  11804. AzureKVProvider
  11805. </a>
  11806. </em>
  11807. </td>
  11808. <td>
  11809. <em>(Optional)</em>
  11810. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  11811. </td>
  11812. </tr>
  11813. <tr>
  11814. <td>
  11815. <code>akeyless</code></br>
  11816. <em>
  11817. <a href="#external-secrets.io/v1.AkeylessProvider">
  11818. AkeylessProvider
  11819. </a>
  11820. </em>
  11821. </td>
  11822. <td>
  11823. <em>(Optional)</em>
  11824. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  11825. </td>
  11826. </tr>
  11827. <tr>
  11828. <td>
  11829. <code>bitwardensecretsmanager</code></br>
  11830. <em>
  11831. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">
  11832. BitwardenSecretsManagerProvider
  11833. </a>
  11834. </em>
  11835. </td>
  11836. <td>
  11837. <em>(Optional)</em>
  11838. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  11839. </td>
  11840. </tr>
  11841. <tr>
  11842. <td>
  11843. <code>vault</code></br>
  11844. <em>
  11845. <a href="#external-secrets.io/v1.VaultProvider">
  11846. VaultProvider
  11847. </a>
  11848. </em>
  11849. </td>
  11850. <td>
  11851. <em>(Optional)</em>
  11852. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  11853. </td>
  11854. </tr>
  11855. <tr>
  11856. <td>
  11857. <code>ovh</code></br>
  11858. <em>
  11859. <a href="#external-secrets.io/v1.OvhProvider">
  11860. OvhProvider
  11861. </a>
  11862. </em>
  11863. </td>
  11864. <td>
  11865. <em>(Optional)</em>
  11866. <p>OVHcloud configures this store to sync secrets using the OVHcloud provider.</p>
  11867. </td>
  11868. </tr>
  11869. <tr>
  11870. <td>
  11871. <code>gcpsm</code></br>
  11872. <em>
  11873. <a href="#external-secrets.io/v1.GCPSMProvider">
  11874. GCPSMProvider
  11875. </a>
  11876. </em>
  11877. </td>
  11878. <td>
  11879. <em>(Optional)</em>
  11880. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  11881. </td>
  11882. </tr>
  11883. <tr>
  11884. <td>
  11885. <code>oracle</code></br>
  11886. <em>
  11887. <a href="#external-secrets.io/v1.OracleProvider">
  11888. OracleProvider
  11889. </a>
  11890. </em>
  11891. </td>
  11892. <td>
  11893. <em>(Optional)</em>
  11894. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  11895. </td>
  11896. </tr>
  11897. <tr>
  11898. <td>
  11899. <code>ibm</code></br>
  11900. <em>
  11901. <a href="#external-secrets.io/v1.IBMProvider">
  11902. IBMProvider
  11903. </a>
  11904. </em>
  11905. </td>
  11906. <td>
  11907. <em>(Optional)</em>
  11908. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  11909. </td>
  11910. </tr>
  11911. <tr>
  11912. <td>
  11913. <code>yandexcertificatemanager</code></br>
  11914. <em>
  11915. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">
  11916. YandexCertificateManagerProvider
  11917. </a>
  11918. </em>
  11919. </td>
  11920. <td>
  11921. <em>(Optional)</em>
  11922. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  11923. </td>
  11924. </tr>
  11925. <tr>
  11926. <td>
  11927. <code>yandexlockbox</code></br>
  11928. <em>
  11929. <a href="#external-secrets.io/v1.YandexLockboxProvider">
  11930. YandexLockboxProvider
  11931. </a>
  11932. </em>
  11933. </td>
  11934. <td>
  11935. <em>(Optional)</em>
  11936. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  11937. </td>
  11938. </tr>
  11939. <tr>
  11940. <td>
  11941. <code>github</code></br>
  11942. <em>
  11943. <a href="#external-secrets.io/v1.GithubProvider">
  11944. GithubProvider
  11945. </a>
  11946. </em>
  11947. </td>
  11948. <td>
  11949. <em>(Optional)</em>
  11950. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.
  11951. Note: This provider only supports write operations (PushSecret) and cannot fetch secrets from GitHub</p>
  11952. </td>
  11953. </tr>
  11954. <tr>
  11955. <td>
  11956. <code>gitlab</code></br>
  11957. <em>
  11958. <a href="#external-secrets.io/v1.GitlabProvider">
  11959. GitlabProvider
  11960. </a>
  11961. </em>
  11962. </td>
  11963. <td>
  11964. <em>(Optional)</em>
  11965. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  11966. </td>
  11967. </tr>
  11968. <tr>
  11969. <td>
  11970. <code>onepassword</code></br>
  11971. <em>
  11972. <a href="#external-secrets.io/v1.OnePasswordProvider">
  11973. OnePasswordProvider
  11974. </a>
  11975. </em>
  11976. </td>
  11977. <td>
  11978. <em>(Optional)</em>
  11979. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  11980. </td>
  11981. </tr>
  11982. <tr>
  11983. <td>
  11984. <code>onepasswordSDK</code></br>
  11985. <em>
  11986. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">
  11987. OnePasswordSDKProvider
  11988. </a>
  11989. </em>
  11990. </td>
  11991. <td>
  11992. <em>(Optional)</em>
  11993. <p>OnePasswordSDK configures this store to use 1Password&rsquo;s new Go SDK to sync secrets.</p>
  11994. </td>
  11995. </tr>
  11996. <tr>
  11997. <td>
  11998. <code>webhook</code></br>
  11999. <em>
  12000. <a href="#external-secrets.io/v1.WebhookProvider">
  12001. WebhookProvider
  12002. </a>
  12003. </em>
  12004. </td>
  12005. <td>
  12006. <em>(Optional)</em>
  12007. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  12008. </td>
  12009. </tr>
  12010. <tr>
  12011. <td>
  12012. <code>kubernetes</code></br>
  12013. <em>
  12014. <a href="#external-secrets.io/v1.KubernetesProvider">
  12015. KubernetesProvider
  12016. </a>
  12017. </em>
  12018. </td>
  12019. <td>
  12020. <em>(Optional)</em>
  12021. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  12022. </td>
  12023. </tr>
  12024. <tr>
  12025. <td>
  12026. <code>fake</code></br>
  12027. <em>
  12028. <a href="#external-secrets.io/v1.FakeProvider">
  12029. FakeProvider
  12030. </a>
  12031. </em>
  12032. </td>
  12033. <td>
  12034. <em>(Optional)</em>
  12035. <p>Fake configures a store with static key/value pairs</p>
  12036. </td>
  12037. </tr>
  12038. <tr>
  12039. <td>
  12040. <code>senhasegura</code></br>
  12041. <em>
  12042. <a href="#external-secrets.io/v1.SenhaseguraProvider">
  12043. SenhaseguraProvider
  12044. </a>
  12045. </em>
  12046. </td>
  12047. <td>
  12048. <em>(Optional)</em>
  12049. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  12050. </td>
  12051. </tr>
  12052. <tr>
  12053. <td>
  12054. <code>scaleway</code></br>
  12055. <em>
  12056. <a href="#external-secrets.io/v1.ScalewayProvider">
  12057. ScalewayProvider
  12058. </a>
  12059. </em>
  12060. </td>
  12061. <td>
  12062. <em>(Optional)</em>
  12063. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  12064. </td>
  12065. </tr>
  12066. <tr>
  12067. <td>
  12068. <code>doppler</code></br>
  12069. <em>
  12070. <a href="#external-secrets.io/v1.DopplerProvider">
  12071. DopplerProvider
  12072. </a>
  12073. </em>
  12074. </td>
  12075. <td>
  12076. <em>(Optional)</em>
  12077. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  12078. </td>
  12079. </tr>
  12080. <tr>
  12081. <td>
  12082. <code>previder</code></br>
  12083. <em>
  12084. <a href="#external-secrets.io/v1.PreviderProvider">
  12085. PreviderProvider
  12086. </a>
  12087. </em>
  12088. </td>
  12089. <td>
  12090. <em>(Optional)</em>
  12091. <p>Previder configures this store to sync secrets using the Previder provider</p>
  12092. </td>
  12093. </tr>
  12094. <tr>
  12095. <td>
  12096. <code>onboardbase</code></br>
  12097. <em>
  12098. <a href="#external-secrets.io/v1.OnboardbaseProvider">
  12099. OnboardbaseProvider
  12100. </a>
  12101. </em>
  12102. </td>
  12103. <td>
  12104. <em>(Optional)</em>
  12105. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  12106. </td>
  12107. </tr>
  12108. <tr>
  12109. <td>
  12110. <code>keepersecurity</code></br>
  12111. <em>
  12112. <a href="#external-secrets.io/v1.KeeperSecurityProvider">
  12113. KeeperSecurityProvider
  12114. </a>
  12115. </em>
  12116. </td>
  12117. <td>
  12118. <em>(Optional)</em>
  12119. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  12120. </td>
  12121. </tr>
  12122. <tr>
  12123. <td>
  12124. <code>conjur</code></br>
  12125. <em>
  12126. <a href="#external-secrets.io/v1.ConjurProvider">
  12127. ConjurProvider
  12128. </a>
  12129. </em>
  12130. </td>
  12131. <td>
  12132. <em>(Optional)</em>
  12133. <p>Conjur configures this store to sync secrets using conjur provider</p>
  12134. </td>
  12135. </tr>
  12136. <tr>
  12137. <td>
  12138. <code>delinea</code></br>
  12139. <em>
  12140. <a href="#external-secrets.io/v1.DelineaProvider">
  12141. DelineaProvider
  12142. </a>
  12143. </em>
  12144. </td>
  12145. <td>
  12146. <em>(Optional)</em>
  12147. <p>Delinea DevOps Secrets Vault
  12148. <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>
  12149. </td>
  12150. </tr>
  12151. <tr>
  12152. <td>
  12153. <code>secretserver</code></br>
  12154. <em>
  12155. <a href="#external-secrets.io/v1.SecretServerProvider">
  12156. SecretServerProvider
  12157. </a>
  12158. </em>
  12159. </td>
  12160. <td>
  12161. <em>(Optional)</em>
  12162. <p>SecretServer configures this store to sync secrets using SecretServer provider
  12163. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  12164. </td>
  12165. </tr>
  12166. <tr>
  12167. <td>
  12168. <code>chef</code></br>
  12169. <em>
  12170. <a href="#external-secrets.io/v1.ChefProvider">
  12171. ChefProvider
  12172. </a>
  12173. </em>
  12174. </td>
  12175. <td>
  12176. <em>(Optional)</em>
  12177. <p>Chef configures this store to sync secrets with chef server</p>
  12178. </td>
  12179. </tr>
  12180. <tr>
  12181. <td>
  12182. <code>pulumi</code></br>
  12183. <em>
  12184. <a href="#external-secrets.io/v1.PulumiProvider">
  12185. PulumiProvider
  12186. </a>
  12187. </em>
  12188. </td>
  12189. <td>
  12190. <em>(Optional)</em>
  12191. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  12192. </td>
  12193. </tr>
  12194. <tr>
  12195. <td>
  12196. <code>fortanix</code></br>
  12197. <em>
  12198. <a href="#external-secrets.io/v1.FortanixProvider">
  12199. FortanixProvider
  12200. </a>
  12201. </em>
  12202. </td>
  12203. <td>
  12204. <em>(Optional)</em>
  12205. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  12206. </td>
  12207. </tr>
  12208. <tr>
  12209. <td>
  12210. <code>passworddepot</code></br>
  12211. <em>
  12212. <a href="#external-secrets.io/v1.PasswordDepotProvider">
  12213. PasswordDepotProvider
  12214. </a>
  12215. </em>
  12216. </td>
  12217. <td>
  12218. <em>(Optional)</em>
  12219. </td>
  12220. </tr>
  12221. <tr>
  12222. <td>
  12223. <code>passbolt</code></br>
  12224. <em>
  12225. <a href="#external-secrets.io/v1.PassboltProvider">
  12226. PassboltProvider
  12227. </a>
  12228. </em>
  12229. </td>
  12230. <td>
  12231. <em>(Optional)</em>
  12232. </td>
  12233. </tr>
  12234. <tr>
  12235. <td>
  12236. <code>dvls</code></br>
  12237. <em>
  12238. <a href="#external-secrets.io/v1.DVLSProvider">
  12239. DVLSProvider
  12240. </a>
  12241. </em>
  12242. </td>
  12243. <td>
  12244. <em>(Optional)</em>
  12245. <p>DVLS configures this store to sync secrets using Devolutions Server provider</p>
  12246. </td>
  12247. </tr>
  12248. <tr>
  12249. <td>
  12250. <code>infisical</code></br>
  12251. <em>
  12252. <a href="#external-secrets.io/v1.InfisicalProvider">
  12253. InfisicalProvider
  12254. </a>
  12255. </em>
  12256. </td>
  12257. <td>
  12258. <em>(Optional)</em>
  12259. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  12260. </td>
  12261. </tr>
  12262. <tr>
  12263. <td>
  12264. <code>beyondtrust</code></br>
  12265. <em>
  12266. <a href="#external-secrets.io/v1.BeyondtrustProvider">
  12267. BeyondtrustProvider
  12268. </a>
  12269. </em>
  12270. </td>
  12271. <td>
  12272. <em>(Optional)</em>
  12273. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  12274. </td>
  12275. </tr>
  12276. <tr>
  12277. <td>
  12278. <code>beyondtrustworkloadcredentials</code></br>
  12279. <em>
  12280. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  12281. BeyondtrustWorkloadCredentialsProvider
  12282. </a>
  12283. </em>
  12284. </td>
  12285. <td>
  12286. <em>(Optional)</em>
  12287. <p>BeyondtrustWorkloadCredentials configures this store to sync secrets using the BeyondTrust Workload Credentials provider.</p>
  12288. </td>
  12289. </tr>
  12290. <tr>
  12291. <td>
  12292. <code>cloudrusm</code></br>
  12293. <em>
  12294. <a href="#external-secrets.io/v1.CloudruSMProvider">
  12295. CloudruSMProvider
  12296. </a>
  12297. </em>
  12298. </td>
  12299. <td>
  12300. <em>(Optional)</em>
  12301. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  12302. </td>
  12303. </tr>
  12304. <tr>
  12305. <td>
  12306. <code>volcengine</code></br>
  12307. <em>
  12308. <a href="#external-secrets.io/v1.VolcengineProvider">
  12309. VolcengineProvider
  12310. </a>
  12311. </em>
  12312. </td>
  12313. <td>
  12314. <em>(Optional)</em>
  12315. <p>Volcengine configures this store to sync secrets using the Volcengine provider</p>
  12316. </td>
  12317. </tr>
  12318. <tr>
  12319. <td>
  12320. <code>ngrok</code></br>
  12321. <em>
  12322. <a href="#external-secrets.io/v1.NgrokProvider">
  12323. NgrokProvider
  12324. </a>
  12325. </em>
  12326. </td>
  12327. <td>
  12328. <em>(Optional)</em>
  12329. <p>Ngrok configures this store to sync secrets using the ngrok provider.</p>
  12330. </td>
  12331. </tr>
  12332. <tr>
  12333. <td>
  12334. <code>barbican</code></br>
  12335. <em>
  12336. <a href="#external-secrets.io/v1.BarbicanProvider">
  12337. BarbicanProvider
  12338. </a>
  12339. </em>
  12340. </td>
  12341. <td>
  12342. <em>(Optional)</em>
  12343. <p>Barbican configures this store to sync secrets using the OpenStack Barbican provider</p>
  12344. </td>
  12345. </tr>
  12346. <tr>
  12347. <td>
  12348. <code>nebiusmysterybox</code></br>
  12349. <em>
  12350. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">
  12351. NebiusMysteryboxProvider
  12352. </a>
  12353. </em>
  12354. </td>
  12355. <td>
  12356. <em>(Optional)</em>
  12357. <p>NebiusMysterybox configures this store to sync secrets using NebiusMysterybox provider</p>
  12358. </td>
  12359. </tr>
  12360. <tr>
  12361. <td>
  12362. <code>openBao</code></br>
  12363. <em>
  12364. <a href="#external-secrets.io/v1.OpenBaoProvider">
  12365. OpenBaoProvider
  12366. </a>
  12367. </em>
  12368. </td>
  12369. <td>
  12370. <em>(Optional)</em>
  12371. <p>OpenBao configures this store to sync secrets using the OpenBao provider.</p>
  12372. </td>
  12373. </tr>
  12374. </tbody>
  12375. </table>
  12376. <h3 id="external-secrets.io/v1.SecretStoreRef">SecretStoreRef
  12377. </h3>
  12378. <p>
  12379. (<em>Appears on:</em>
  12380. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>,
  12381. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  12382. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>)
  12383. </p>
  12384. <p>
  12385. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  12386. </p>
  12387. <table>
  12388. <thead>
  12389. <tr>
  12390. <th>Field</th>
  12391. <th>Description</th>
  12392. </tr>
  12393. </thead>
  12394. <tbody>
  12395. <tr>
  12396. <td>
  12397. <code>name</code></br>
  12398. <em>
  12399. string
  12400. </em>
  12401. </td>
  12402. <td>
  12403. <p>Name of the SecretStore resource</p>
  12404. </td>
  12405. </tr>
  12406. <tr>
  12407. <td>
  12408. <code>kind</code></br>
  12409. <em>
  12410. string
  12411. </em>
  12412. </td>
  12413. <td>
  12414. <em>(Optional)</em>
  12415. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  12416. Defaults to <code>SecretStore</code></p>
  12417. </td>
  12418. </tr>
  12419. </tbody>
  12420. </table>
  12421. <h3 id="external-secrets.io/v1.SecretStoreRetrySettings">SecretStoreRetrySettings
  12422. </h3>
  12423. <p>
  12424. (<em>Appears on:</em>
  12425. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>,
  12426. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec</a>,
  12427. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  12428. </p>
  12429. <p>
  12430. <p>SecretStoreRetrySettings defines the retry settings for accessing external secrets manager stores.</p>
  12431. </p>
  12432. <table>
  12433. <thead>
  12434. <tr>
  12435. <th>Field</th>
  12436. <th>Description</th>
  12437. </tr>
  12438. </thead>
  12439. <tbody>
  12440. <tr>
  12441. <td>
  12442. <code>maxRetries</code></br>
  12443. <em>
  12444. int32
  12445. </em>
  12446. </td>
  12447. <td>
  12448. </td>
  12449. </tr>
  12450. <tr>
  12451. <td>
  12452. <code>retryInterval</code></br>
  12453. <em>
  12454. string
  12455. </em>
  12456. </td>
  12457. <td>
  12458. </td>
  12459. </tr>
  12460. </tbody>
  12461. </table>
  12462. <h3 id="external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec
  12463. </h3>
  12464. <p>
  12465. (<em>Appears on:</em>
  12466. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  12467. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  12468. </p>
  12469. <p>
  12470. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  12471. </p>
  12472. <table>
  12473. <thead>
  12474. <tr>
  12475. <th>Field</th>
  12476. <th>Description</th>
  12477. </tr>
  12478. </thead>
  12479. <tbody>
  12480. <tr>
  12481. <td>
  12482. <code>controller</code></br>
  12483. <em>
  12484. string
  12485. </em>
  12486. </td>
  12487. <td>
  12488. <em>(Optional)</em>
  12489. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  12490. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  12491. </td>
  12492. </tr>
  12493. <tr>
  12494. <td>
  12495. <code>provider</code></br>
  12496. <em>
  12497. <a href="#external-secrets.io/v1.SecretStoreProvider">
  12498. SecretStoreProvider
  12499. </a>
  12500. </em>
  12501. </td>
  12502. <td>
  12503. <p>Used to configure the provider. Only one provider may be set</p>
  12504. </td>
  12505. </tr>
  12506. <tr>
  12507. <td>
  12508. <code>retrySettings</code></br>
  12509. <em>
  12510. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  12511. SecretStoreRetrySettings
  12512. </a>
  12513. </em>
  12514. </td>
  12515. <td>
  12516. <em>(Optional)</em>
  12517. <p>Used to configure HTTP retries on failures.</p>
  12518. </td>
  12519. </tr>
  12520. <tr>
  12521. <td>
  12522. <code>refreshInterval</code></br>
  12523. <em>
  12524. int
  12525. </em>
  12526. </td>
  12527. <td>
  12528. <em>(Optional)</em>
  12529. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  12530. </td>
  12531. </tr>
  12532. <tr>
  12533. <td>
  12534. <code>conditions</code></br>
  12535. <em>
  12536. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  12537. []ClusterSecretStoreCondition
  12538. </a>
  12539. </em>
  12540. </td>
  12541. <td>
  12542. <em>(Optional)</em>
  12543. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  12544. </td>
  12545. </tr>
  12546. </tbody>
  12547. </table>
  12548. <h3 id="external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus
  12549. </h3>
  12550. <p>
  12551. (<em>Appears on:</em>
  12552. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  12553. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  12554. </p>
  12555. <p>
  12556. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  12557. </p>
  12558. <table>
  12559. <thead>
  12560. <tr>
  12561. <th>Field</th>
  12562. <th>Description</th>
  12563. </tr>
  12564. </thead>
  12565. <tbody>
  12566. <tr>
  12567. <td>
  12568. <code>conditions</code></br>
  12569. <em>
  12570. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">
  12571. []SecretStoreStatusCondition
  12572. </a>
  12573. </em>
  12574. </td>
  12575. <td>
  12576. <em>(Optional)</em>
  12577. </td>
  12578. </tr>
  12579. <tr>
  12580. <td>
  12581. <code>capabilities</code></br>
  12582. <em>
  12583. <a href="#external-secrets.io/v1.SecretStoreCapabilities">
  12584. SecretStoreCapabilities
  12585. </a>
  12586. </em>
  12587. </td>
  12588. <td>
  12589. <em>(Optional)</em>
  12590. </td>
  12591. </tr>
  12592. </tbody>
  12593. </table>
  12594. <h3 id="external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition
  12595. </h3>
  12596. <p>
  12597. (<em>Appears on:</em>
  12598. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  12599. </p>
  12600. <p>
  12601. <p>SecretStoreStatusCondition contains condition information for a SecretStore.</p>
  12602. </p>
  12603. <table>
  12604. <thead>
  12605. <tr>
  12606. <th>Field</th>
  12607. <th>Description</th>
  12608. </tr>
  12609. </thead>
  12610. <tbody>
  12611. <tr>
  12612. <td>
  12613. <code>type</code></br>
  12614. <em>
  12615. <a href="#external-secrets.io/v1.SecretStoreConditionType">
  12616. SecretStoreConditionType
  12617. </a>
  12618. </em>
  12619. </td>
  12620. <td>
  12621. </td>
  12622. </tr>
  12623. <tr>
  12624. <td>
  12625. <code>status</code></br>
  12626. <em>
  12627. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  12628. Kubernetes core/v1.ConditionStatus
  12629. </a>
  12630. </em>
  12631. </td>
  12632. <td>
  12633. </td>
  12634. </tr>
  12635. <tr>
  12636. <td>
  12637. <code>reason</code></br>
  12638. <em>
  12639. string
  12640. </em>
  12641. </td>
  12642. <td>
  12643. <em>(Optional)</em>
  12644. </td>
  12645. </tr>
  12646. <tr>
  12647. <td>
  12648. <code>message</code></br>
  12649. <em>
  12650. string
  12651. </em>
  12652. </td>
  12653. <td>
  12654. <em>(Optional)</em>
  12655. </td>
  12656. </tr>
  12657. <tr>
  12658. <td>
  12659. <code>lastTransitionTime</code></br>
  12660. <em>
  12661. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  12662. Kubernetes meta/v1.Time
  12663. </a>
  12664. </em>
  12665. </td>
  12666. <td>
  12667. <em>(Optional)</em>
  12668. </td>
  12669. </tr>
  12670. </tbody>
  12671. </table>
  12672. <h3 id="external-secrets.io/v1.SecretVersionSelectionPolicy">SecretVersionSelectionPolicy
  12673. (<code>string</code> alias)</p></h3>
  12674. <p>
  12675. (<em>Appears on:</em>
  12676. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  12677. </p>
  12678. <p>
  12679. <p>SecretVersionSelectionPolicy defines the policy for selecting secret versions in GCP Secret Manager.</p>
  12680. </p>
  12681. <table>
  12682. <thead>
  12683. <tr>
  12684. <th>Value</th>
  12685. <th>Description</th>
  12686. </tr>
  12687. </thead>
  12688. <tbody><tr><td><p>&#34;LatestOrFail&#34;</p></td>
  12689. <td><p>SecretVersionSelectionPolicyLatestOrFail means the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.</p>
  12690. </td>
  12691. </tr><tr><td><p>&#34;LatestOrFetch&#34;</p></td>
  12692. <td><p>SecretVersionSelectionPolicyLatestOrFetch behaves like SecretVersionSelectionPolicyLatestOrFail but falls back to fetching the latest version if the version is DESTROYED or DISABLED.</p>
  12693. </td>
  12694. </tr></tbody>
  12695. </table>
  12696. <h3 id="external-secrets.io/v1.SecretsClient">SecretsClient
  12697. </h3>
  12698. <p>
  12699. <p>SecretsClient provides access to secrets.</p>
  12700. </p>
  12701. <h3 id="external-secrets.io/v1.SecretsManager">SecretsManager
  12702. </h3>
  12703. <p>
  12704. (<em>Appears on:</em>
  12705. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  12706. </p>
  12707. <p>
  12708. <p>SecretsManager defines how the provider behaves when interacting with AWS
  12709. SecretsManager. Some of these settings are only applicable to controlling how
  12710. secrets are deleted, and hence only apply to PushSecret (and only when
  12711. deletionPolicy is set to Delete).</p>
  12712. </p>
  12713. <table>
  12714. <thead>
  12715. <tr>
  12716. <th>Field</th>
  12717. <th>Description</th>
  12718. </tr>
  12719. </thead>
  12720. <tbody>
  12721. <tr>
  12722. <td>
  12723. <code>forceDeleteWithoutRecovery</code></br>
  12724. <em>
  12725. bool
  12726. </em>
  12727. </td>
  12728. <td>
  12729. <em>(Optional)</em>
  12730. <p>Specifies whether to delete the secret without any recovery window. You
  12731. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  12732. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  12733. recovery window.
  12734. 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>
  12735. </td>
  12736. </tr>
  12737. <tr>
  12738. <td>
  12739. <code>recoveryWindowInDays</code></br>
  12740. <em>
  12741. int64
  12742. </em>
  12743. </td>
  12744. <td>
  12745. <em>(Optional)</em>
  12746. <p>The number of days from 7 to 30 that Secrets Manager waits before
  12747. permanently deleting the secret. You can&rsquo;t use both this parameter and
  12748. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  12749. then by default Secrets Manager uses a 30-day recovery window.
  12750. 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>
  12751. </td>
  12752. </tr>
  12753. </tbody>
  12754. </table>
  12755. <h3 id="external-secrets.io/v1.SenhaseguraAuth">SenhaseguraAuth
  12756. </h3>
  12757. <p>
  12758. (<em>Appears on:</em>
  12759. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  12760. </p>
  12761. <p>
  12762. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  12763. </p>
  12764. <table>
  12765. <thead>
  12766. <tr>
  12767. <th>Field</th>
  12768. <th>Description</th>
  12769. </tr>
  12770. </thead>
  12771. <tbody>
  12772. <tr>
  12773. <td>
  12774. <code>clientId</code></br>
  12775. <em>
  12776. string
  12777. </em>
  12778. </td>
  12779. <td>
  12780. </td>
  12781. </tr>
  12782. <tr>
  12783. <td>
  12784. <code>clientSecretSecretRef</code></br>
  12785. <em>
  12786. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12787. External Secrets meta/v1.SecretKeySelector
  12788. </a>
  12789. </em>
  12790. </td>
  12791. <td>
  12792. </td>
  12793. </tr>
  12794. </tbody>
  12795. </table>
  12796. <h3 id="external-secrets.io/v1.SenhaseguraModuleType">SenhaseguraModuleType
  12797. (<code>string</code> alias)</p></h3>
  12798. <p>
  12799. (<em>Appears on:</em>
  12800. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  12801. </p>
  12802. <p>
  12803. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  12804. </p>
  12805. <table>
  12806. <thead>
  12807. <tr>
  12808. <th>Value</th>
  12809. <th>Description</th>
  12810. </tr>
  12811. </thead>
  12812. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  12813. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  12814. see: https://senhasegura.com/devops
  12815. </code></pre>
  12816. </td>
  12817. </tr></tbody>
  12818. </table>
  12819. <h3 id="external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider
  12820. </h3>
  12821. <p>
  12822. (<em>Appears on:</em>
  12823. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  12824. </p>
  12825. <p>
  12826. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  12827. </p>
  12828. <table>
  12829. <thead>
  12830. <tr>
  12831. <th>Field</th>
  12832. <th>Description</th>
  12833. </tr>
  12834. </thead>
  12835. <tbody>
  12836. <tr>
  12837. <td>
  12838. <code>url</code></br>
  12839. <em>
  12840. string
  12841. </em>
  12842. </td>
  12843. <td>
  12844. <p>URL of senhasegura</p>
  12845. </td>
  12846. </tr>
  12847. <tr>
  12848. <td>
  12849. <code>module</code></br>
  12850. <em>
  12851. <a href="#external-secrets.io/v1.SenhaseguraModuleType">
  12852. SenhaseguraModuleType
  12853. </a>
  12854. </em>
  12855. </td>
  12856. <td>
  12857. <p>Module defines which senhasegura module should be used to get secrets</p>
  12858. </td>
  12859. </tr>
  12860. <tr>
  12861. <td>
  12862. <code>auth</code></br>
  12863. <em>
  12864. <a href="#external-secrets.io/v1.SenhaseguraAuth">
  12865. SenhaseguraAuth
  12866. </a>
  12867. </em>
  12868. </td>
  12869. <td>
  12870. <p>Auth defines parameters to authenticate in senhasegura</p>
  12871. </td>
  12872. </tr>
  12873. <tr>
  12874. <td>
  12875. <code>ignoreSslCertificate</code></br>
  12876. <em>
  12877. bool
  12878. </em>
  12879. </td>
  12880. <td>
  12881. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  12882. </td>
  12883. </tr>
  12884. </tbody>
  12885. </table>
  12886. <h3 id="external-secrets.io/v1.SessionTagsPolicy">SessionTagsPolicy
  12887. (<code>string</code> alias)</p></h3>
  12888. <p>
  12889. (<em>Appears on:</em>
  12890. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  12891. </p>
  12892. <p>
  12893. <p>SessionTagsPolicy defines how STS session tags are handled.</p>
  12894. </p>
  12895. <table>
  12896. <thead>
  12897. <tr>
  12898. <th>Value</th>
  12899. <th>Description</th>
  12900. </tr>
  12901. </thead>
  12902. <tbody><tr><td><p>&#34;Custom&#34;</p></td>
  12903. <td><p>SessionTagsPolicyCustom adds the tags defined in CustomSessionTags in addition to
  12904. the esoNamespace, esoStoreName, and esoStoreKind tags.</p>
  12905. </td>
  12906. </tr><tr><td><p>&#34;None&#34;</p></td>
  12907. <td><p>SessionTagsPolicyNone is the default behavior - no session tags are added.</p>
  12908. </td>
  12909. </tr><tr><td><p>&#34;Simple&#34;</p></td>
  12910. <td><p>SessionTagsPolicySimple automatically adds esoNamespace, esoStoreName, and esoStoreKind
  12911. session tags.</p>
  12912. </td>
  12913. </tr></tbody>
  12914. </table>
  12915. <h3 id="external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  12916. </h3>
  12917. <p>
  12918. (<em>Appears on:</em>
  12919. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  12920. </p>
  12921. <p>
  12922. <p>StoreGeneratorSourceRef allows you to override the source
  12923. from which the secret will be pulled from.
  12924. You can define at maximum one property.</p>
  12925. </p>
  12926. <table>
  12927. <thead>
  12928. <tr>
  12929. <th>Field</th>
  12930. <th>Description</th>
  12931. </tr>
  12932. </thead>
  12933. <tbody>
  12934. <tr>
  12935. <td>
  12936. <code>storeRef</code></br>
  12937. <em>
  12938. <a href="#external-secrets.io/v1.SecretStoreRef">
  12939. SecretStoreRef
  12940. </a>
  12941. </em>
  12942. </td>
  12943. <td>
  12944. <em>(Optional)</em>
  12945. </td>
  12946. </tr>
  12947. <tr>
  12948. <td>
  12949. <code>generatorRef</code></br>
  12950. <em>
  12951. <a href="#external-secrets.io/v1.GeneratorRef">
  12952. GeneratorRef
  12953. </a>
  12954. </em>
  12955. </td>
  12956. <td>
  12957. <em>(Optional)</em>
  12958. <p>GeneratorRef points to a generator custom resource.</p>
  12959. </td>
  12960. </tr>
  12961. </tbody>
  12962. </table>
  12963. <h3 id="external-secrets.io/v1.StoreSourceRef">StoreSourceRef
  12964. </h3>
  12965. <p>
  12966. (<em>Appears on:</em>
  12967. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>)
  12968. </p>
  12969. <p>
  12970. <p>StoreSourceRef allows you to override the SecretStore source
  12971. from which the secret will be pulled from.
  12972. You can define at maximum one property.</p>
  12973. </p>
  12974. <table>
  12975. <thead>
  12976. <tr>
  12977. <th>Field</th>
  12978. <th>Description</th>
  12979. </tr>
  12980. </thead>
  12981. <tbody>
  12982. <tr>
  12983. <td>
  12984. <code>storeRef</code></br>
  12985. <em>
  12986. <a href="#external-secrets.io/v1.SecretStoreRef">
  12987. SecretStoreRef
  12988. </a>
  12989. </em>
  12990. </td>
  12991. <td>
  12992. <em>(Optional)</em>
  12993. </td>
  12994. </tr>
  12995. <tr>
  12996. <td>
  12997. <code>generatorRef</code></br>
  12998. <em>
  12999. <a href="#external-secrets.io/v1.GeneratorRef">
  13000. GeneratorRef
  13001. </a>
  13002. </em>
  13003. </td>
  13004. <td>
  13005. <p>GeneratorRef points to a generator custom resource.</p>
  13006. <p>Deprecated: The generatorRef is not implemented in .data[].
  13007. this will be removed with v1.</p>
  13008. </td>
  13009. </tr>
  13010. </tbody>
  13011. </table>
  13012. <h3 id="external-secrets.io/v1.Tag">Tag
  13013. </h3>
  13014. <p>
  13015. <p>Tag is a key-value pair that can be attached to an AWS resource.
  13016. 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>
  13017. </p>
  13018. <table>
  13019. <thead>
  13020. <tr>
  13021. <th>Field</th>
  13022. <th>Description</th>
  13023. </tr>
  13024. </thead>
  13025. <tbody>
  13026. <tr>
  13027. <td>
  13028. <code>key</code></br>
  13029. <em>
  13030. string
  13031. </em>
  13032. </td>
  13033. <td>
  13034. </td>
  13035. </tr>
  13036. <tr>
  13037. <td>
  13038. <code>value</code></br>
  13039. <em>
  13040. string
  13041. </em>
  13042. </td>
  13043. <td>
  13044. </td>
  13045. </tr>
  13046. </tbody>
  13047. </table>
  13048. <h3 id="external-secrets.io/v1.TemplateEngineVersion">TemplateEngineVersion
  13049. (<code>string</code> alias)</p></h3>
  13050. <p>
  13051. (<em>Appears on:</em>
  13052. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  13053. </p>
  13054. <p>
  13055. <p>TemplateEngineVersion specifies the template engine version that should be used to
  13056. compile/execute the template.</p>
  13057. </p>
  13058. <table>
  13059. <thead>
  13060. <tr>
  13061. <th>Value</th>
  13062. <th>Description</th>
  13063. </tr>
  13064. </thead>
  13065. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  13066. <td><p>TemplateEngineV2 is the currently supported template engine version.</p>
  13067. </td>
  13068. </tr></tbody>
  13069. </table>
  13070. <h3 id="external-secrets.io/v1.TemplateFrom">TemplateFrom
  13071. </h3>
  13072. <p>
  13073. (<em>Appears on:</em>
  13074. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  13075. </p>
  13076. <p>
  13077. <p>TemplateFrom specifies a source for templates.
  13078. Each item in the list can either reference a ConfigMap or a Secret resource.</p>
  13079. </p>
  13080. <table>
  13081. <thead>
  13082. <tr>
  13083. <th>Field</th>
  13084. <th>Description</th>
  13085. </tr>
  13086. </thead>
  13087. <tbody>
  13088. <tr>
  13089. <td>
  13090. <code>configMap</code></br>
  13091. <em>
  13092. <a href="#external-secrets.io/v1.TemplateRef">
  13093. TemplateRef
  13094. </a>
  13095. </em>
  13096. </td>
  13097. <td>
  13098. </td>
  13099. </tr>
  13100. <tr>
  13101. <td>
  13102. <code>secret</code></br>
  13103. <em>
  13104. <a href="#external-secrets.io/v1.TemplateRef">
  13105. TemplateRef
  13106. </a>
  13107. </em>
  13108. </td>
  13109. <td>
  13110. </td>
  13111. </tr>
  13112. <tr>
  13113. <td>
  13114. <code>target</code></br>
  13115. <em>
  13116. string
  13117. </em>
  13118. </td>
  13119. <td>
  13120. <em>(Optional)</em>
  13121. <p>Target specifies where to place the template result.
  13122. For Secret resources, common values are: &ldquo;Data&rdquo;, &ldquo;Annotations&rdquo;, &ldquo;Labels&rdquo;.
  13123. For custom resources (when spec.target.manifest is set), this supports
  13124. nested paths like &ldquo;spec.database.config&rdquo; or &ldquo;data&rdquo;.</p>
  13125. </td>
  13126. </tr>
  13127. <tr>
  13128. <td>
  13129. <code>literal</code></br>
  13130. <em>
  13131. string
  13132. </em>
  13133. </td>
  13134. <td>
  13135. <em>(Optional)</em>
  13136. </td>
  13137. </tr>
  13138. <tr>
  13139. <td>
  13140. <code>valuesDecodingStrategy</code></br>
  13141. <em>
  13142. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  13143. ExternalSecretDecodingStrategy
  13144. </a>
  13145. </em>
  13146. </td>
  13147. <td>
  13148. <em>(Optional)</em>
  13149. <p>Used to define a decoding Strategy for the rendered template values.</p>
  13150. </td>
  13151. </tr>
  13152. </tbody>
  13153. </table>
  13154. <h3 id="external-secrets.io/v1.TemplateMergePolicy">TemplateMergePolicy
  13155. (<code>string</code> alias)</p></h3>
  13156. <p>
  13157. (<em>Appears on:</em>
  13158. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  13159. </p>
  13160. <p>
  13161. <p>TemplateMergePolicy defines how the rendered template should be merged with the existing Secret data.</p>
  13162. </p>
  13163. <table>
  13164. <thead>
  13165. <tr>
  13166. <th>Value</th>
  13167. <th>Description</th>
  13168. </tr>
  13169. </thead>
  13170. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  13171. <td></td>
  13172. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  13173. <td></td>
  13174. </tr></tbody>
  13175. </table>
  13176. <h3 id="external-secrets.io/v1.TemplateRef">TemplateRef
  13177. </h3>
  13178. <p>
  13179. (<em>Appears on:</em>
  13180. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  13181. </p>
  13182. <p>
  13183. <p>TemplateRef specifies a reference to either a ConfigMap or a Secret resource.</p>
  13184. </p>
  13185. <table>
  13186. <thead>
  13187. <tr>
  13188. <th>Field</th>
  13189. <th>Description</th>
  13190. </tr>
  13191. </thead>
  13192. <tbody>
  13193. <tr>
  13194. <td>
  13195. <code>name</code></br>
  13196. <em>
  13197. string
  13198. </em>
  13199. </td>
  13200. <td>
  13201. <p>The name of the ConfigMap/Secret resource</p>
  13202. </td>
  13203. </tr>
  13204. <tr>
  13205. <td>
  13206. <code>items</code></br>
  13207. <em>
  13208. <a href="#external-secrets.io/v1.TemplateRefItem">
  13209. []TemplateRefItem
  13210. </a>
  13211. </em>
  13212. </td>
  13213. <td>
  13214. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  13215. </td>
  13216. </tr>
  13217. </tbody>
  13218. </table>
  13219. <h3 id="external-secrets.io/v1.TemplateRefItem">TemplateRefItem
  13220. </h3>
  13221. <p>
  13222. (<em>Appears on:</em>
  13223. <a href="#external-secrets.io/v1.TemplateRef">TemplateRef</a>)
  13224. </p>
  13225. <p>
  13226. <p>TemplateRefItem specifies a key in the ConfigMap/Secret to use as a template for Secret data.</p>
  13227. </p>
  13228. <table>
  13229. <thead>
  13230. <tr>
  13231. <th>Field</th>
  13232. <th>Description</th>
  13233. </tr>
  13234. </thead>
  13235. <tbody>
  13236. <tr>
  13237. <td>
  13238. <code>key</code></br>
  13239. <em>
  13240. string
  13241. </em>
  13242. </td>
  13243. <td>
  13244. <p>A key in the ConfigMap/Secret</p>
  13245. </td>
  13246. </tr>
  13247. <tr>
  13248. <td>
  13249. <code>templateAs</code></br>
  13250. <em>
  13251. <a href="#external-secrets.io/v1.TemplateScope">
  13252. TemplateScope
  13253. </a>
  13254. </em>
  13255. </td>
  13256. <td>
  13257. </td>
  13258. </tr>
  13259. </tbody>
  13260. </table>
  13261. <h3 id="external-secrets.io/v1.TemplateScope">TemplateScope
  13262. (<code>string</code> alias)</p></h3>
  13263. <p>
  13264. (<em>Appears on:</em>
  13265. <a href="#external-secrets.io/v1.TemplateRefItem">TemplateRefItem</a>)
  13266. </p>
  13267. <p>
  13268. <p>TemplateScope specifies how the template keys should be interpreted.</p>
  13269. </p>
  13270. <table>
  13271. <thead>
  13272. <tr>
  13273. <th>Value</th>
  13274. <th>Description</th>
  13275. </tr>
  13276. </thead>
  13277. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  13278. <td></td>
  13279. </tr><tr><td><p>&#34;Values&#34;</p></td>
  13280. <td></td>
  13281. </tr></tbody>
  13282. </table>
  13283. <h3 id="external-secrets.io/v1.TokenAuth">TokenAuth
  13284. </h3>
  13285. <p>
  13286. (<em>Appears on:</em>
  13287. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  13288. </p>
  13289. <p>
  13290. <p>TokenAuth defines token-based authentication configuration for Kubernetes.</p>
  13291. </p>
  13292. <table>
  13293. <thead>
  13294. <tr>
  13295. <th>Field</th>
  13296. <th>Description</th>
  13297. </tr>
  13298. </thead>
  13299. <tbody>
  13300. <tr>
  13301. <td>
  13302. <code>bearerToken</code></br>
  13303. <em>
  13304. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13305. External Secrets meta/v1.SecretKeySelector
  13306. </a>
  13307. </em>
  13308. </td>
  13309. <td>
  13310. </td>
  13311. </tr>
  13312. </tbody>
  13313. </table>
  13314. <h3 id="external-secrets.io/v1.TokenAuthCredentials">TokenAuthCredentials
  13315. </h3>
  13316. <p>
  13317. (<em>Appears on:</em>
  13318. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  13319. </p>
  13320. <p>
  13321. <p>TokenAuthCredentials represents the credentials for access token-based authentication.</p>
  13322. </p>
  13323. <table>
  13324. <thead>
  13325. <tr>
  13326. <th>Field</th>
  13327. <th>Description</th>
  13328. </tr>
  13329. </thead>
  13330. <tbody>
  13331. <tr>
  13332. <td>
  13333. <code>accessToken</code></br>
  13334. <em>
  13335. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13336. External Secrets meta/v1.SecretKeySelector
  13337. </a>
  13338. </em>
  13339. </td>
  13340. <td>
  13341. </td>
  13342. </tr>
  13343. </tbody>
  13344. </table>
  13345. <h3 id="external-secrets.io/v1.UniversalAuthCredentials">UniversalAuthCredentials
  13346. </h3>
  13347. <p>
  13348. (<em>Appears on:</em>
  13349. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  13350. </p>
  13351. <p>
  13352. <p>UniversalAuthCredentials represents the client credentials for universal authentication.</p>
  13353. </p>
  13354. <table>
  13355. <thead>
  13356. <tr>
  13357. <th>Field</th>
  13358. <th>Description</th>
  13359. </tr>
  13360. </thead>
  13361. <tbody>
  13362. <tr>
  13363. <td>
  13364. <code>clientId</code></br>
  13365. <em>
  13366. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13367. External Secrets meta/v1.SecretKeySelector
  13368. </a>
  13369. </em>
  13370. </td>
  13371. <td>
  13372. </td>
  13373. </tr>
  13374. <tr>
  13375. <td>
  13376. <code>clientSecret</code></br>
  13377. <em>
  13378. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13379. External Secrets meta/v1.SecretKeySelector
  13380. </a>
  13381. </em>
  13382. </td>
  13383. <td>
  13384. </td>
  13385. </tr>
  13386. </tbody>
  13387. </table>
  13388. <h3 id="external-secrets.io/v1.ValidationResult">ValidationResult
  13389. (<code>byte</code> alias)</p></h3>
  13390. <p>
  13391. (<em>Appears on:</em>
  13392. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  13393. </p>
  13394. <p>
  13395. <p>ValidationResult is defined type for the number of validation results.</p>
  13396. </p>
  13397. <table>
  13398. <thead>
  13399. <tr>
  13400. <th>Value</th>
  13401. <th>Description</th>
  13402. </tr>
  13403. </thead>
  13404. <tbody><tr><td><p>2</p></td>
  13405. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  13406. </td>
  13407. </tr><tr><td><p>0</p></td>
  13408. <td><p>ValidationResultReady indicates that the client is configured correctly
  13409. and can be used.</p>
  13410. </td>
  13411. </tr><tr><td><p>1</p></td>
  13412. <td><p>ValidationResultUnknown indicates that the client can be used
  13413. but information is missing, and it can not be validated.</p>
  13414. </td>
  13415. </tr></tbody>
  13416. </table>
  13417. <h3 id="external-secrets.io/v1.VaultAppRole">VaultAppRole
  13418. </h3>
  13419. <p>
  13420. (<em>Appears on:</em>
  13421. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13422. </p>
  13423. <p>
  13424. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  13425. with the role and secret stored in a Kubernetes Secret resource.</p>
  13426. </p>
  13427. <table>
  13428. <thead>
  13429. <tr>
  13430. <th>Field</th>
  13431. <th>Description</th>
  13432. </tr>
  13433. </thead>
  13434. <tbody>
  13435. <tr>
  13436. <td>
  13437. <code>path</code></br>
  13438. <em>
  13439. string
  13440. </em>
  13441. </td>
  13442. <td>
  13443. <p>Path where the App Role authentication backend is mounted
  13444. in Vault, e.g: &ldquo;approle&rdquo;</p>
  13445. </td>
  13446. </tr>
  13447. <tr>
  13448. <td>
  13449. <code>roleId</code></br>
  13450. <em>
  13451. string
  13452. </em>
  13453. </td>
  13454. <td>
  13455. <em>(Optional)</em>
  13456. <p>RoleID configured in the App Role authentication backend when setting
  13457. up the authentication backend in Vault.</p>
  13458. </td>
  13459. </tr>
  13460. <tr>
  13461. <td>
  13462. <code>roleRef</code></br>
  13463. <em>
  13464. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13465. External Secrets meta/v1.SecretKeySelector
  13466. </a>
  13467. </em>
  13468. </td>
  13469. <td>
  13470. <em>(Optional)</em>
  13471. <p>Reference to a key in a Secret that contains the App Role ID used
  13472. to authenticate with Vault.
  13473. The <code>key</code> field must be specified and denotes which entry within the Secret
  13474. resource is used as the app role id.</p>
  13475. </td>
  13476. </tr>
  13477. <tr>
  13478. <td>
  13479. <code>secretRef</code></br>
  13480. <em>
  13481. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13482. External Secrets meta/v1.SecretKeySelector
  13483. </a>
  13484. </em>
  13485. </td>
  13486. <td>
  13487. <p>Reference to a key in a Secret that contains the App Role secret used
  13488. to authenticate with Vault.
  13489. The <code>key</code> field must be specified and denotes which entry within the Secret
  13490. resource is used as the app role secret.</p>
  13491. </td>
  13492. </tr>
  13493. </tbody>
  13494. </table>
  13495. <h3 id="external-secrets.io/v1.VaultAuth">VaultAuth
  13496. </h3>
  13497. <p>
  13498. (<em>Appears on:</em>
  13499. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13500. </p>
  13501. <p>
  13502. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  13503. 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>
  13504. can be specified. A namespace to authenticate against can optionally be specified.</p>
  13505. </p>
  13506. <table>
  13507. <thead>
  13508. <tr>
  13509. <th>Field</th>
  13510. <th>Description</th>
  13511. </tr>
  13512. </thead>
  13513. <tbody>
  13514. <tr>
  13515. <td>
  13516. <code>namespace</code></br>
  13517. <em>
  13518. string
  13519. </em>
  13520. </td>
  13521. <td>
  13522. <em>(Optional)</em>
  13523. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  13524. Namespaces is a set of features within Vault Enterprise that allows
  13525. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  13526. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  13527. This will default to Vault.Namespace field if set, or empty otherwise</p>
  13528. </td>
  13529. </tr>
  13530. <tr>
  13531. <td>
  13532. <code>tokenSecretRef</code></br>
  13533. <em>
  13534. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13535. External Secrets meta/v1.SecretKeySelector
  13536. </a>
  13537. </em>
  13538. </td>
  13539. <td>
  13540. <em>(Optional)</em>
  13541. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  13542. </td>
  13543. </tr>
  13544. <tr>
  13545. <td>
  13546. <code>appRole</code></br>
  13547. <em>
  13548. <a href="#external-secrets.io/v1.VaultAppRole">
  13549. VaultAppRole
  13550. </a>
  13551. </em>
  13552. </td>
  13553. <td>
  13554. <em>(Optional)</em>
  13555. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  13556. with the role and secret stored in a Kubernetes Secret resource.</p>
  13557. </td>
  13558. </tr>
  13559. <tr>
  13560. <td>
  13561. <code>kubernetes</code></br>
  13562. <em>
  13563. <a href="#external-secrets.io/v1.VaultKubernetesAuth">
  13564. VaultKubernetesAuth
  13565. </a>
  13566. </em>
  13567. </td>
  13568. <td>
  13569. <em>(Optional)</em>
  13570. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  13571. token stored in the named Secret resource to the Vault server.</p>
  13572. </td>
  13573. </tr>
  13574. <tr>
  13575. <td>
  13576. <code>ldap</code></br>
  13577. <em>
  13578. <a href="#external-secrets.io/v1.VaultLdapAuth">
  13579. VaultLdapAuth
  13580. </a>
  13581. </em>
  13582. </td>
  13583. <td>
  13584. <em>(Optional)</em>
  13585. <p>Ldap authenticates with Vault by passing username/password pair using
  13586. the LDAP authentication method</p>
  13587. </td>
  13588. </tr>
  13589. <tr>
  13590. <td>
  13591. <code>jwt</code></br>
  13592. <em>
  13593. <a href="#external-secrets.io/v1.VaultJwtAuth">
  13594. VaultJwtAuth
  13595. </a>
  13596. </em>
  13597. </td>
  13598. <td>
  13599. <em>(Optional)</em>
  13600. <p>Jwt authenticates with Vault by passing role and JWT token using the
  13601. JWT/OIDC authentication method</p>
  13602. </td>
  13603. </tr>
  13604. <tr>
  13605. <td>
  13606. <code>cert</code></br>
  13607. <em>
  13608. <a href="#external-secrets.io/v1.VaultCertAuth">
  13609. VaultCertAuth
  13610. </a>
  13611. </em>
  13612. </td>
  13613. <td>
  13614. <em>(Optional)</em>
  13615. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  13616. Cert authentication method</p>
  13617. </td>
  13618. </tr>
  13619. <tr>
  13620. <td>
  13621. <code>iam</code></br>
  13622. <em>
  13623. <a href="#external-secrets.io/v1.VaultIamAuth">
  13624. VaultIamAuth
  13625. </a>
  13626. </em>
  13627. </td>
  13628. <td>
  13629. <em>(Optional)</em>
  13630. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  13631. AWS IAM authentication method</p>
  13632. </td>
  13633. </tr>
  13634. <tr>
  13635. <td>
  13636. <code>userPass</code></br>
  13637. <em>
  13638. <a href="#external-secrets.io/v1.VaultUserPassAuth">
  13639. VaultUserPassAuth
  13640. </a>
  13641. </em>
  13642. </td>
  13643. <td>
  13644. <em>(Optional)</em>
  13645. <p>UserPass authenticates with Vault by passing username/password pair</p>
  13646. </td>
  13647. </tr>
  13648. <tr>
  13649. <td>
  13650. <code>gcp</code></br>
  13651. <em>
  13652. <a href="#external-secrets.io/v1.VaultGCPAuth">
  13653. VaultGCPAuth
  13654. </a>
  13655. </em>
  13656. </td>
  13657. <td>
  13658. <em>(Optional)</em>
  13659. <p>Gcp authenticates with Vault using Google Cloud Platform authentication method
  13660. GCP authentication method</p>
  13661. </td>
  13662. </tr>
  13663. </tbody>
  13664. </table>
  13665. <h3 id="external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth
  13666. </h3>
  13667. <p>
  13668. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  13669. Only one of secretRef or jwt can be specified.
  13670. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  13671. </p>
  13672. <table>
  13673. <thead>
  13674. <tr>
  13675. <th>Field</th>
  13676. <th>Description</th>
  13677. </tr>
  13678. </thead>
  13679. <tbody>
  13680. <tr>
  13681. <td>
  13682. <code>secretRef</code></br>
  13683. <em>
  13684. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  13685. VaultAwsAuthSecretRef
  13686. </a>
  13687. </em>
  13688. </td>
  13689. <td>
  13690. <em>(Optional)</em>
  13691. </td>
  13692. </tr>
  13693. <tr>
  13694. <td>
  13695. <code>jwt</code></br>
  13696. <em>
  13697. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  13698. VaultAwsJWTAuth
  13699. </a>
  13700. </em>
  13701. </td>
  13702. <td>
  13703. <em>(Optional)</em>
  13704. </td>
  13705. </tr>
  13706. </tbody>
  13707. </table>
  13708. <h3 id="external-secrets.io/v1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  13709. </h3>
  13710. <p>
  13711. (<em>Appears on:</em>
  13712. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  13713. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  13714. </p>
  13715. <p>
  13716. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  13717. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  13718. </p>
  13719. <table>
  13720. <thead>
  13721. <tr>
  13722. <th>Field</th>
  13723. <th>Description</th>
  13724. </tr>
  13725. </thead>
  13726. <tbody>
  13727. <tr>
  13728. <td>
  13729. <code>accessKeyIDSecretRef</code></br>
  13730. <em>
  13731. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13732. External Secrets meta/v1.SecretKeySelector
  13733. </a>
  13734. </em>
  13735. </td>
  13736. <td>
  13737. <em>(Optional)</em>
  13738. <p>The AccessKeyID is used for authentication</p>
  13739. </td>
  13740. </tr>
  13741. <tr>
  13742. <td>
  13743. <code>secretAccessKeySecretRef</code></br>
  13744. <em>
  13745. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13746. External Secrets meta/v1.SecretKeySelector
  13747. </a>
  13748. </em>
  13749. </td>
  13750. <td>
  13751. <em>(Optional)</em>
  13752. <p>The SecretAccessKey is used for authentication</p>
  13753. </td>
  13754. </tr>
  13755. <tr>
  13756. <td>
  13757. <code>sessionTokenSecretRef</code></br>
  13758. <em>
  13759. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13760. External Secrets meta/v1.SecretKeySelector
  13761. </a>
  13762. </em>
  13763. </td>
  13764. <td>
  13765. <em>(Optional)</em>
  13766. <p>The SessionToken used for authentication
  13767. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  13768. 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>
  13769. </td>
  13770. </tr>
  13771. </tbody>
  13772. </table>
  13773. <h3 id="external-secrets.io/v1.VaultAwsJWTAuth">VaultAwsJWTAuth
  13774. </h3>
  13775. <p>
  13776. (<em>Appears on:</em>
  13777. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  13778. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  13779. </p>
  13780. <p>
  13781. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  13782. </p>
  13783. <table>
  13784. <thead>
  13785. <tr>
  13786. <th>Field</th>
  13787. <th>Description</th>
  13788. </tr>
  13789. </thead>
  13790. <tbody>
  13791. <tr>
  13792. <td>
  13793. <code>serviceAccountRef</code></br>
  13794. <em>
  13795. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  13796. External Secrets meta/v1.ServiceAccountSelector
  13797. </a>
  13798. </em>
  13799. </td>
  13800. <td>
  13801. <em>(Optional)</em>
  13802. </td>
  13803. </tr>
  13804. </tbody>
  13805. </table>
  13806. <h3 id="external-secrets.io/v1.VaultCertAuth">VaultCertAuth
  13807. </h3>
  13808. <p>
  13809. (<em>Appears on:</em>
  13810. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13811. </p>
  13812. <p>
  13813. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  13814. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  13815. </p>
  13816. <table>
  13817. <thead>
  13818. <tr>
  13819. <th>Field</th>
  13820. <th>Description</th>
  13821. </tr>
  13822. </thead>
  13823. <tbody>
  13824. <tr>
  13825. <td>
  13826. <code>path</code></br>
  13827. <em>
  13828. string
  13829. </em>
  13830. </td>
  13831. <td>
  13832. <em>(Optional)</em>
  13833. <p>Path where the Certificate authentication backend is mounted
  13834. in Vault, e.g: &ldquo;cert&rdquo;</p>
  13835. </td>
  13836. </tr>
  13837. <tr>
  13838. <td>
  13839. <code>vaultRole</code></br>
  13840. <em>
  13841. string
  13842. </em>
  13843. </td>
  13844. <td>
  13845. <em>(Optional)</em>
  13846. <p>VaultRole specifies the Vault role to use for TLS certificate authentication.</p>
  13847. </td>
  13848. </tr>
  13849. <tr>
  13850. <td>
  13851. <code>clientCert</code></br>
  13852. <em>
  13853. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13854. External Secrets meta/v1.SecretKeySelector
  13855. </a>
  13856. </em>
  13857. </td>
  13858. <td>
  13859. <em>(Optional)</em>
  13860. <p>ClientCert is a certificate to authenticate using the Cert Vault
  13861. authentication method</p>
  13862. </td>
  13863. </tr>
  13864. <tr>
  13865. <td>
  13866. <code>secretRef</code></br>
  13867. <em>
  13868. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13869. External Secrets meta/v1.SecretKeySelector
  13870. </a>
  13871. </em>
  13872. </td>
  13873. <td>
  13874. <em>(Optional)</em>
  13875. <p>SecretRef to a key in a Secret resource containing client private key to
  13876. authenticate with Vault using the Cert authentication method</p>
  13877. </td>
  13878. </tr>
  13879. </tbody>
  13880. </table>
  13881. <h3 id="external-secrets.io/v1.VaultCheckAndSet">VaultCheckAndSet
  13882. </h3>
  13883. <p>
  13884. (<em>Appears on:</em>
  13885. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13886. </p>
  13887. <p>
  13888. <p>VaultCheckAndSet defines the Check-And-Set (CAS) settings for Vault KV v2 PushSecret operations.</p>
  13889. </p>
  13890. <table>
  13891. <thead>
  13892. <tr>
  13893. <th>Field</th>
  13894. <th>Description</th>
  13895. </tr>
  13896. </thead>
  13897. <tbody>
  13898. <tr>
  13899. <td>
  13900. <code>required</code></br>
  13901. <em>
  13902. bool
  13903. </em>
  13904. </td>
  13905. <td>
  13906. <em>(Optional)</em>
  13907. <p>Required when true, all write operations must include a check-and-set parameter.
  13908. This helps prevent unintentional overwrites of secrets.</p>
  13909. </td>
  13910. </tr>
  13911. </tbody>
  13912. </table>
  13913. <h3 id="external-secrets.io/v1.VaultClientTLS">VaultClientTLS
  13914. </h3>
  13915. <p>
  13916. (<em>Appears on:</em>
  13917. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13918. </p>
  13919. <p>
  13920. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  13921. when the Vault server requires mutual authentication.</p>
  13922. </p>
  13923. <table>
  13924. <thead>
  13925. <tr>
  13926. <th>Field</th>
  13927. <th>Description</th>
  13928. </tr>
  13929. </thead>
  13930. <tbody>
  13931. <tr>
  13932. <td>
  13933. <code>certSecretRef</code></br>
  13934. <em>
  13935. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13936. External Secrets meta/v1.SecretKeySelector
  13937. </a>
  13938. </em>
  13939. </td>
  13940. <td>
  13941. <em>(Optional)</em>
  13942. <p>CertSecretRef is a certificate added to the transport layer
  13943. when communicating with the Vault server.
  13944. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  13945. </td>
  13946. </tr>
  13947. <tr>
  13948. <td>
  13949. <code>keySecretRef</code></br>
  13950. <em>
  13951. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13952. External Secrets meta/v1.SecretKeySelector
  13953. </a>
  13954. </em>
  13955. </td>
  13956. <td>
  13957. <em>(Optional)</em>
  13958. <p>KeySecretRef to a key in a Secret resource containing client private key
  13959. added to the transport layer when communicating with the Vault server.
  13960. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  13961. </td>
  13962. </tr>
  13963. </tbody>
  13964. </table>
  13965. <h3 id="external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth
  13966. </h3>
  13967. <p>
  13968. (<em>Appears on:</em>
  13969. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13970. </p>
  13971. <p>
  13972. <p>VaultGCPAuth authenticates with Vault using Google Cloud Platform authentication method.
  13973. Refer: <a href="https://developer.hashicorp.com/vault/docs/auth/gcp">https://developer.hashicorp.com/vault/docs/auth/gcp</a></p>
  13974. <p>When ServiceAccountRef, SecretRef and WorkloadIdentity are not specified, the provider will use the controller pod&rsquo;s
  13975. identity to authenticate with GCP. This supports both GKE Workload Identity and service account keys.</p>
  13976. </p>
  13977. <table>
  13978. <thead>
  13979. <tr>
  13980. <th>Field</th>
  13981. <th>Description</th>
  13982. </tr>
  13983. </thead>
  13984. <tbody>
  13985. <tr>
  13986. <td>
  13987. <code>path</code></br>
  13988. <em>
  13989. string
  13990. </em>
  13991. </td>
  13992. <td>
  13993. <em>(Optional)</em>
  13994. <p>Path where the GCP auth method is enabled in Vault, e.g: &ldquo;gcp&rdquo;</p>
  13995. </td>
  13996. </tr>
  13997. <tr>
  13998. <td>
  13999. <code>role</code></br>
  14000. <em>
  14001. string
  14002. </em>
  14003. </td>
  14004. <td>
  14005. <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>
  14006. </td>
  14007. </tr>
  14008. <tr>
  14009. <td>
  14010. <code>projectID</code></br>
  14011. <em>
  14012. string
  14013. </em>
  14014. </td>
  14015. <td>
  14016. <em>(Optional)</em>
  14017. <p>Project ID of the Google Cloud Platform project</p>
  14018. </td>
  14019. </tr>
  14020. <tr>
  14021. <td>
  14022. <code>location</code></br>
  14023. <em>
  14024. string
  14025. </em>
  14026. </td>
  14027. <td>
  14028. <em>(Optional)</em>
  14029. <p>Location optionally defines a location/region for the secret</p>
  14030. </td>
  14031. </tr>
  14032. <tr>
  14033. <td>
  14034. <code>secretRef</code></br>
  14035. <em>
  14036. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  14037. GCPSMAuthSecretRef
  14038. </a>
  14039. </em>
  14040. </td>
  14041. <td>
  14042. <em>(Optional)</em>
  14043. <p>Specify credentials in a Secret object</p>
  14044. </td>
  14045. </tr>
  14046. <tr>
  14047. <td>
  14048. <code>workloadIdentity</code></br>
  14049. <em>
  14050. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  14051. GCPWorkloadIdentity
  14052. </a>
  14053. </em>
  14054. </td>
  14055. <td>
  14056. <em>(Optional)</em>
  14057. <p>Specify a service account with Workload Identity</p>
  14058. </td>
  14059. </tr>
  14060. <tr>
  14061. <td>
  14062. <code>serviceAccountRef</code></br>
  14063. <em>
  14064. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14065. External Secrets meta/v1.ServiceAccountSelector
  14066. </a>
  14067. </em>
  14068. </td>
  14069. <td>
  14070. <em>(Optional)</em>
  14071. <p>ServiceAccountRef to a service account for impersonation</p>
  14072. </td>
  14073. </tr>
  14074. </tbody>
  14075. </table>
  14076. <h3 id="external-secrets.io/v1.VaultIamAuth">VaultIamAuth
  14077. </h3>
  14078. <p>
  14079. (<em>Appears on:</em>
  14080. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14081. </p>
  14082. <p>
  14083. <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>
  14084. <p>When JWTAuth and SecretRef are not specified, the provider will use the controller pod&rsquo;s
  14085. identity to authenticate with AWS. This supports both IRSA and EKS Pod Identity.</p>
  14086. </p>
  14087. <table>
  14088. <thead>
  14089. <tr>
  14090. <th>Field</th>
  14091. <th>Description</th>
  14092. </tr>
  14093. </thead>
  14094. <tbody>
  14095. <tr>
  14096. <td>
  14097. <code>path</code></br>
  14098. <em>
  14099. string
  14100. </em>
  14101. </td>
  14102. <td>
  14103. <em>(Optional)</em>
  14104. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  14105. </td>
  14106. </tr>
  14107. <tr>
  14108. <td>
  14109. <code>region</code></br>
  14110. <em>
  14111. string
  14112. </em>
  14113. </td>
  14114. <td>
  14115. <em>(Optional)</em>
  14116. <p>AWS region</p>
  14117. </td>
  14118. </tr>
  14119. <tr>
  14120. <td>
  14121. <code>role</code></br>
  14122. <em>
  14123. string
  14124. </em>
  14125. </td>
  14126. <td>
  14127. <em>(Optional)</em>
  14128. <p>This is the AWS role to be assumed before talking to vault</p>
  14129. </td>
  14130. </tr>
  14131. <tr>
  14132. <td>
  14133. <code>vaultRole</code></br>
  14134. <em>
  14135. string
  14136. </em>
  14137. </td>
  14138. <td>
  14139. <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>
  14140. </td>
  14141. </tr>
  14142. <tr>
  14143. <td>
  14144. <code>externalID</code></br>
  14145. <em>
  14146. string
  14147. </em>
  14148. </td>
  14149. <td>
  14150. <p>AWS External ID set on assumed IAM roles</p>
  14151. </td>
  14152. </tr>
  14153. <tr>
  14154. <td>
  14155. <code>vaultAwsIamServerID</code></br>
  14156. <em>
  14157. string
  14158. </em>
  14159. </td>
  14160. <td>
  14161. <em>(Optional)</em>
  14162. <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>
  14163. </td>
  14164. </tr>
  14165. <tr>
  14166. <td>
  14167. <code>secretRef</code></br>
  14168. <em>
  14169. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  14170. VaultAwsAuthSecretRef
  14171. </a>
  14172. </em>
  14173. </td>
  14174. <td>
  14175. <em>(Optional)</em>
  14176. <p>Specify credentials in a Secret object</p>
  14177. </td>
  14178. </tr>
  14179. <tr>
  14180. <td>
  14181. <code>jwt</code></br>
  14182. <em>
  14183. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  14184. VaultAwsJWTAuth
  14185. </a>
  14186. </em>
  14187. </td>
  14188. <td>
  14189. <em>(Optional)</em>
  14190. <p>Specify a service account with IRSA enabled</p>
  14191. </td>
  14192. </tr>
  14193. </tbody>
  14194. </table>
  14195. <h3 id="external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth
  14196. </h3>
  14197. <p>
  14198. (<em>Appears on:</em>
  14199. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14200. </p>
  14201. <p>
  14202. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  14203. method, with the role name and a token stored in a Kubernetes Secret resource or
  14204. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  14205. </p>
  14206. <table>
  14207. <thead>
  14208. <tr>
  14209. <th>Field</th>
  14210. <th>Description</th>
  14211. </tr>
  14212. </thead>
  14213. <tbody>
  14214. <tr>
  14215. <td>
  14216. <code>path</code></br>
  14217. <em>
  14218. string
  14219. </em>
  14220. </td>
  14221. <td>
  14222. <p>Path where the JWT authentication backend is mounted
  14223. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  14224. </td>
  14225. </tr>
  14226. <tr>
  14227. <td>
  14228. <code>role</code></br>
  14229. <em>
  14230. string
  14231. </em>
  14232. </td>
  14233. <td>
  14234. <em>(Optional)</em>
  14235. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  14236. authentication method</p>
  14237. </td>
  14238. </tr>
  14239. <tr>
  14240. <td>
  14241. <code>secretRef</code></br>
  14242. <em>
  14243. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14244. External Secrets meta/v1.SecretKeySelector
  14245. </a>
  14246. </em>
  14247. </td>
  14248. <td>
  14249. <em>(Optional)</em>
  14250. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  14251. authenticate with Vault using the JWT/OIDC authentication method.</p>
  14252. </td>
  14253. </tr>
  14254. <tr>
  14255. <td>
  14256. <code>kubernetesServiceAccountToken</code></br>
  14257. <em>
  14258. <a href="#external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">
  14259. VaultKubernetesServiceAccountTokenAuth
  14260. </a>
  14261. </em>
  14262. </td>
  14263. <td>
  14264. <em>(Optional)</em>
  14265. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  14266. a token for with the <code>TokenRequest</code> API.</p>
  14267. </td>
  14268. </tr>
  14269. </tbody>
  14270. </table>
  14271. <h3 id="external-secrets.io/v1.VaultKVStoreVersion">VaultKVStoreVersion
  14272. (<code>string</code> alias)</p></h3>
  14273. <p>
  14274. (<em>Appears on:</em>
  14275. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  14276. </p>
  14277. <p>
  14278. <p>VaultKVStoreVersion represents the version of the Vault KV secret engine.</p>
  14279. </p>
  14280. <table>
  14281. <thead>
  14282. <tr>
  14283. <th>Value</th>
  14284. <th>Description</th>
  14285. </tr>
  14286. </thead>
  14287. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  14288. <td></td>
  14289. </tr><tr><td><p>&#34;v2&#34;</p></td>
  14290. <td></td>
  14291. </tr></tbody>
  14292. </table>
  14293. <h3 id="external-secrets.io/v1.VaultKubernetesAuth">VaultKubernetesAuth
  14294. </h3>
  14295. <p>
  14296. (<em>Appears on:</em>
  14297. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14298. </p>
  14299. <p>
  14300. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in
  14301. a Secret.</p>
  14302. </p>
  14303. <table>
  14304. <thead>
  14305. <tr>
  14306. <th>Field</th>
  14307. <th>Description</th>
  14308. </tr>
  14309. </thead>
  14310. <tbody>
  14311. <tr>
  14312. <td>
  14313. <code>mountPath</code></br>
  14314. <em>
  14315. string
  14316. </em>
  14317. </td>
  14318. <td>
  14319. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  14320. &ldquo;kubernetes&rdquo;</p>
  14321. </td>
  14322. </tr>
  14323. <tr>
  14324. <td>
  14325. <code>serviceAccountRef</code></br>
  14326. <em>
  14327. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14328. External Secrets meta/v1.ServiceAccountSelector
  14329. </a>
  14330. </em>
  14331. </td>
  14332. <td>
  14333. <em>(Optional)</em>
  14334. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  14335. If the service account is specified, the service account secret token JWT will be used
  14336. for authenticating with Vault. If the service account selector is not supplied,
  14337. the secretRef will be used instead.</p>
  14338. </td>
  14339. </tr>
  14340. <tr>
  14341. <td>
  14342. <code>secretRef</code></br>
  14343. <em>
  14344. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14345. External Secrets meta/v1.SecretKeySelector
  14346. </a>
  14347. </em>
  14348. </td>
  14349. <td>
  14350. <em>(Optional)</em>
  14351. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  14352. for authenticating with Vault. If a name is specified without a key,
  14353. <code>token</code> is the default. If one is not specified, the one bound to
  14354. the controller will be used.</p>
  14355. </td>
  14356. </tr>
  14357. <tr>
  14358. <td>
  14359. <code>role</code></br>
  14360. <em>
  14361. string
  14362. </em>
  14363. </td>
  14364. <td>
  14365. <p>A required field containing the Vault Role to assume. A Role binds a
  14366. Kubernetes ServiceAccount with a set of Vault policies.</p>
  14367. </td>
  14368. </tr>
  14369. </tbody>
  14370. </table>
  14371. <h3 id="external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  14372. </h3>
  14373. <p>
  14374. (<em>Appears on:</em>
  14375. <a href="#external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth</a>)
  14376. </p>
  14377. <p>
  14378. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  14379. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  14380. </p>
  14381. <table>
  14382. <thead>
  14383. <tr>
  14384. <th>Field</th>
  14385. <th>Description</th>
  14386. </tr>
  14387. </thead>
  14388. <tbody>
  14389. <tr>
  14390. <td>
  14391. <code>serviceAccountRef</code></br>
  14392. <em>
  14393. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14394. External Secrets meta/v1.ServiceAccountSelector
  14395. </a>
  14396. </em>
  14397. </td>
  14398. <td>
  14399. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  14400. </td>
  14401. </tr>
  14402. <tr>
  14403. <td>
  14404. <code>audiences</code></br>
  14405. <em>
  14406. []string
  14407. </em>
  14408. </td>
  14409. <td>
  14410. <em>(Optional)</em>
  14411. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  14412. account token for the service account referenced by <code>serviceAccountRef</code>.
  14413. Defaults to a single audience <code>vault</code> it not specified.</p>
  14414. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  14415. </td>
  14416. </tr>
  14417. <tr>
  14418. <td>
  14419. <code>expirationSeconds</code></br>
  14420. <em>
  14421. int64
  14422. </em>
  14423. </td>
  14424. <td>
  14425. <em>(Optional)</em>
  14426. <p>Optional expiration time in seconds that will be used to request a temporary
  14427. Kubernetes service account token for the service account referenced by
  14428. <code>serviceAccountRef</code>.</p>
  14429. <p>Deprecated: this will be removed in the future.
  14430. Defaults to 10 minutes.</p>
  14431. </td>
  14432. </tr>
  14433. </tbody>
  14434. </table>
  14435. <h3 id="external-secrets.io/v1.VaultLdapAuth">VaultLdapAuth
  14436. </h3>
  14437. <p>
  14438. (<em>Appears on:</em>
  14439. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14440. </p>
  14441. <p>
  14442. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  14443. with the username and password stored in a Kubernetes Secret resource.</p>
  14444. </p>
  14445. <table>
  14446. <thead>
  14447. <tr>
  14448. <th>Field</th>
  14449. <th>Description</th>
  14450. </tr>
  14451. </thead>
  14452. <tbody>
  14453. <tr>
  14454. <td>
  14455. <code>path</code></br>
  14456. <em>
  14457. string
  14458. </em>
  14459. </td>
  14460. <td>
  14461. <p>Path where the LDAP authentication backend is mounted
  14462. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  14463. </td>
  14464. </tr>
  14465. <tr>
  14466. <td>
  14467. <code>username</code></br>
  14468. <em>
  14469. string
  14470. </em>
  14471. </td>
  14472. <td>
  14473. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  14474. authentication method</p>
  14475. </td>
  14476. </tr>
  14477. <tr>
  14478. <td>
  14479. <code>secretRef</code></br>
  14480. <em>
  14481. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14482. External Secrets meta/v1.SecretKeySelector
  14483. </a>
  14484. </em>
  14485. </td>
  14486. <td>
  14487. <em>(Optional)</em>
  14488. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  14489. user used to authenticate with Vault using the LDAP authentication
  14490. method</p>
  14491. </td>
  14492. </tr>
  14493. </tbody>
  14494. </table>
  14495. <h3 id="external-secrets.io/v1.VaultProvider">VaultProvider
  14496. </h3>
  14497. <p>
  14498. (<em>Appears on:</em>
  14499. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  14500. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  14501. </p>
  14502. <p>
  14503. <p>VaultProvider configures a store to sync secrets using a Hashicorp Vault KV backend.</p>
  14504. </p>
  14505. <table>
  14506. <thead>
  14507. <tr>
  14508. <th>Field</th>
  14509. <th>Description</th>
  14510. </tr>
  14511. </thead>
  14512. <tbody>
  14513. <tr>
  14514. <td>
  14515. <code>auth</code></br>
  14516. <em>
  14517. <a href="#external-secrets.io/v1.VaultAuth">
  14518. VaultAuth
  14519. </a>
  14520. </em>
  14521. </td>
  14522. <td>
  14523. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  14524. </td>
  14525. </tr>
  14526. <tr>
  14527. <td>
  14528. <code>server</code></br>
  14529. <em>
  14530. string
  14531. </em>
  14532. </td>
  14533. <td>
  14534. <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>
  14535. </td>
  14536. </tr>
  14537. <tr>
  14538. <td>
  14539. <code>path</code></br>
  14540. <em>
  14541. string
  14542. </em>
  14543. </td>
  14544. <td>
  14545. <em>(Optional)</em>
  14546. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  14547. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  14548. for fetching secrets from Vault is optional and will be appended
  14549. if not present in specified path.</p>
  14550. </td>
  14551. </tr>
  14552. <tr>
  14553. <td>
  14554. <code>version</code></br>
  14555. <em>
  14556. <a href="#external-secrets.io/v1.VaultKVStoreVersion">
  14557. VaultKVStoreVersion
  14558. </a>
  14559. </em>
  14560. </td>
  14561. <td>
  14562. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  14563. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  14564. </td>
  14565. </tr>
  14566. <tr>
  14567. <td>
  14568. <code>namespace</code></br>
  14569. <em>
  14570. string
  14571. </em>
  14572. </td>
  14573. <td>
  14574. <em>(Optional)</em>
  14575. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  14576. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  14577. 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>
  14578. </td>
  14579. </tr>
  14580. <tr>
  14581. <td>
  14582. <code>caBundle</code></br>
  14583. <em>
  14584. []byte
  14585. </em>
  14586. </td>
  14587. <td>
  14588. <em>(Optional)</em>
  14589. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  14590. if the Server URL is using HTTPS protocol. This parameter is ignored for
  14591. plain HTTP protocol connection. If not set the system root certificates
  14592. are used to validate the TLS connection.</p>
  14593. </td>
  14594. </tr>
  14595. <tr>
  14596. <td>
  14597. <code>tls</code></br>
  14598. <em>
  14599. <a href="#external-secrets.io/v1.VaultClientTLS">
  14600. VaultClientTLS
  14601. </a>
  14602. </em>
  14603. </td>
  14604. <td>
  14605. <em>(Optional)</em>
  14606. <p>The configuration used for client side related TLS communication, when the Vault server
  14607. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  14608. This parameter is ignored for plain HTTP protocol connection.
  14609. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  14610. which is available under the <code>auth.cert</code> section.</p>
  14611. </td>
  14612. </tr>
  14613. <tr>
  14614. <td>
  14615. <code>caProvider</code></br>
  14616. <em>
  14617. <a href="#external-secrets.io/v1.CAProvider">
  14618. CAProvider
  14619. </a>
  14620. </em>
  14621. </td>
  14622. <td>
  14623. <em>(Optional)</em>
  14624. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  14625. </td>
  14626. </tr>
  14627. <tr>
  14628. <td>
  14629. <code>readYourWrites</code></br>
  14630. <em>
  14631. bool
  14632. </em>
  14633. </td>
  14634. <td>
  14635. <em>(Optional)</em>
  14636. <p>ReadYourWrites ensures isolated read-after-write semantics by
  14637. providing discovered cluster replication states in each request.
  14638. More information about eventual consistency in Vault can be found here
  14639. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  14640. </td>
  14641. </tr>
  14642. <tr>
  14643. <td>
  14644. <code>forwardInconsistent</code></br>
  14645. <em>
  14646. bool
  14647. </em>
  14648. </td>
  14649. <td>
  14650. <em>(Optional)</em>
  14651. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  14652. leader instead of simply retrying within a loop. This can increase performance if
  14653. the option is enabled serverside.
  14654. <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>
  14655. </td>
  14656. </tr>
  14657. <tr>
  14658. <td>
  14659. <code>headers</code></br>
  14660. <em>
  14661. map[string]string
  14662. </em>
  14663. </td>
  14664. <td>
  14665. <em>(Optional)</em>
  14666. <p>Headers to be added in Vault request</p>
  14667. </td>
  14668. </tr>
  14669. <tr>
  14670. <td>
  14671. <code>checkAndSet</code></br>
  14672. <em>
  14673. <a href="#external-secrets.io/v1.VaultCheckAndSet">
  14674. VaultCheckAndSet
  14675. </a>
  14676. </em>
  14677. </td>
  14678. <td>
  14679. <em>(Optional)</em>
  14680. <p>CheckAndSet defines the Check-And-Set (CAS) settings for PushSecret operations.
  14681. Only applies to Vault KV v2 stores. When enabled, write operations must include
  14682. the current version of the secret to prevent unintentional overwrites.</p>
  14683. </td>
  14684. </tr>
  14685. </tbody>
  14686. </table>
  14687. <h3 id="external-secrets.io/v1.VaultUserPassAuth">VaultUserPassAuth
  14688. </h3>
  14689. <p>
  14690. (<em>Appears on:</em>
  14691. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14692. </p>
  14693. <p>
  14694. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  14695. with the username and password stored in a Kubernetes Secret resource.</p>
  14696. </p>
  14697. <table>
  14698. <thead>
  14699. <tr>
  14700. <th>Field</th>
  14701. <th>Description</th>
  14702. </tr>
  14703. </thead>
  14704. <tbody>
  14705. <tr>
  14706. <td>
  14707. <code>path</code></br>
  14708. <em>
  14709. string
  14710. </em>
  14711. </td>
  14712. <td>
  14713. <p>Path where the UserPassword authentication backend is mounted
  14714. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  14715. </td>
  14716. </tr>
  14717. <tr>
  14718. <td>
  14719. <code>username</code></br>
  14720. <em>
  14721. string
  14722. </em>
  14723. </td>
  14724. <td>
  14725. <p>Username is a username used to authenticate using the UserPass Vault
  14726. authentication method</p>
  14727. </td>
  14728. </tr>
  14729. <tr>
  14730. <td>
  14731. <code>secretRef</code></br>
  14732. <em>
  14733. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14734. External Secrets meta/v1.SecretKeySelector
  14735. </a>
  14736. </em>
  14737. </td>
  14738. <td>
  14739. <em>(Optional)</em>
  14740. <p>SecretRef to a key in a Secret resource containing password for the
  14741. user used to authenticate with Vault using the UserPass authentication
  14742. method</p>
  14743. </td>
  14744. </tr>
  14745. </tbody>
  14746. </table>
  14747. <h3 id="external-secrets.io/v1.VolcengineAuth">VolcengineAuth
  14748. </h3>
  14749. <p>
  14750. (<em>Appears on:</em>
  14751. <a href="#external-secrets.io/v1.VolcengineProvider">VolcengineProvider</a>)
  14752. </p>
  14753. <p>
  14754. <p>VolcengineAuth defines the authentication method for the Volcengine provider.
  14755. Only one of the fields should be set.</p>
  14756. </p>
  14757. <table>
  14758. <thead>
  14759. <tr>
  14760. <th>Field</th>
  14761. <th>Description</th>
  14762. </tr>
  14763. </thead>
  14764. <tbody>
  14765. <tr>
  14766. <td>
  14767. <code>secretRef</code></br>
  14768. <em>
  14769. <a href="#external-secrets.io/v1.VolcengineAuthSecretRef">
  14770. VolcengineAuthSecretRef
  14771. </a>
  14772. </em>
  14773. </td>
  14774. <td>
  14775. <em>(Optional)</em>
  14776. <p>SecretRef defines the static credentials to use for authentication.
  14777. If not set, IRSA is used.</p>
  14778. </td>
  14779. </tr>
  14780. </tbody>
  14781. </table>
  14782. <h3 id="external-secrets.io/v1.VolcengineAuthSecretRef">VolcengineAuthSecretRef
  14783. </h3>
  14784. <p>
  14785. (<em>Appears on:</em>
  14786. <a href="#external-secrets.io/v1.VolcengineAuth">VolcengineAuth</a>)
  14787. </p>
  14788. <p>
  14789. <p>VolcengineAuthSecretRef defines the secret reference for static credentials.</p>
  14790. </p>
  14791. <table>
  14792. <thead>
  14793. <tr>
  14794. <th>Field</th>
  14795. <th>Description</th>
  14796. </tr>
  14797. </thead>
  14798. <tbody>
  14799. <tr>
  14800. <td>
  14801. <code>accessKeyID</code></br>
  14802. <em>
  14803. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14804. External Secrets meta/v1.SecretKeySelector
  14805. </a>
  14806. </em>
  14807. </td>
  14808. <td>
  14809. <p>AccessKeyID is the reference to the secret containing the Access Key ID.</p>
  14810. </td>
  14811. </tr>
  14812. <tr>
  14813. <td>
  14814. <code>secretAccessKey</code></br>
  14815. <em>
  14816. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14817. External Secrets meta/v1.SecretKeySelector
  14818. </a>
  14819. </em>
  14820. </td>
  14821. <td>
  14822. <p>SecretAccessKey is the reference to the secret containing the Secret Access Key.</p>
  14823. </td>
  14824. </tr>
  14825. <tr>
  14826. <td>
  14827. <code>token</code></br>
  14828. <em>
  14829. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14830. External Secrets meta/v1.SecretKeySelector
  14831. </a>
  14832. </em>
  14833. </td>
  14834. <td>
  14835. <em>(Optional)</em>
  14836. <p>Token is the reference to the secret containing the STS(Security Token Service) Token.</p>
  14837. </td>
  14838. </tr>
  14839. </tbody>
  14840. </table>
  14841. <h3 id="external-secrets.io/v1.VolcengineProvider">VolcengineProvider
  14842. </h3>
  14843. <p>
  14844. (<em>Appears on:</em>
  14845. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  14846. </p>
  14847. <p>
  14848. <p>VolcengineProvider defines the configuration for the Volcengine provider.</p>
  14849. </p>
  14850. <table>
  14851. <thead>
  14852. <tr>
  14853. <th>Field</th>
  14854. <th>Description</th>
  14855. </tr>
  14856. </thead>
  14857. <tbody>
  14858. <tr>
  14859. <td>
  14860. <code>region</code></br>
  14861. <em>
  14862. string
  14863. </em>
  14864. </td>
  14865. <td>
  14866. <p>Region specifies the Volcengine region to connect to.</p>
  14867. </td>
  14868. </tr>
  14869. <tr>
  14870. <td>
  14871. <code>auth</code></br>
  14872. <em>
  14873. <a href="#external-secrets.io/v1.VolcengineAuth">
  14874. VolcengineAuth
  14875. </a>
  14876. </em>
  14877. </td>
  14878. <td>
  14879. <em>(Optional)</em>
  14880. <p>Auth defines the authentication method to use.
  14881. If not specified, the provider will try to use IRSA (IAM Role for Service Account).</p>
  14882. </td>
  14883. </tr>
  14884. </tbody>
  14885. </table>
  14886. <h3 id="external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider
  14887. </h3>
  14888. <p>
  14889. (<em>Appears on:</em>
  14890. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  14891. </p>
  14892. <p>
  14893. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  14894. </p>
  14895. <table>
  14896. <thead>
  14897. <tr>
  14898. <th>Field</th>
  14899. <th>Description</th>
  14900. </tr>
  14901. </thead>
  14902. <tbody>
  14903. <tr>
  14904. <td>
  14905. <code>type</code></br>
  14906. <em>
  14907. <a href="#external-secrets.io/v1.WebhookCAProviderType">
  14908. WebhookCAProviderType
  14909. </a>
  14910. </em>
  14911. </td>
  14912. <td>
  14913. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  14914. </td>
  14915. </tr>
  14916. <tr>
  14917. <td>
  14918. <code>name</code></br>
  14919. <em>
  14920. string
  14921. </em>
  14922. </td>
  14923. <td>
  14924. <p>The name of the object located at the provider type.</p>
  14925. </td>
  14926. </tr>
  14927. <tr>
  14928. <td>
  14929. <code>key</code></br>
  14930. <em>
  14931. string
  14932. </em>
  14933. </td>
  14934. <td>
  14935. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  14936. </td>
  14937. </tr>
  14938. <tr>
  14939. <td>
  14940. <code>namespace</code></br>
  14941. <em>
  14942. string
  14943. </em>
  14944. </td>
  14945. <td>
  14946. <em>(Optional)</em>
  14947. <p>The namespace the Provider type is in.</p>
  14948. </td>
  14949. </tr>
  14950. </tbody>
  14951. </table>
  14952. <h3 id="external-secrets.io/v1.WebhookCAProviderType">WebhookCAProviderType
  14953. (<code>string</code> alias)</p></h3>
  14954. <p>
  14955. (<em>Appears on:</em>
  14956. <a href="#external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider</a>)
  14957. </p>
  14958. <p>
  14959. <p>WebhookCAProviderType defines the type of provider for certificate authority in webhook connections.</p>
  14960. </p>
  14961. <table>
  14962. <thead>
  14963. <tr>
  14964. <th>Value</th>
  14965. <th>Description</th>
  14966. </tr>
  14967. </thead>
  14968. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  14969. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  14970. </td>
  14971. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  14972. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  14973. </td>
  14974. </tr></tbody>
  14975. </table>
  14976. <h3 id="external-secrets.io/v1.WebhookProvider">WebhookProvider
  14977. </h3>
  14978. <p>
  14979. (<em>Appears on:</em>
  14980. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  14981. </p>
  14982. <p>
  14983. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  14984. </p>
  14985. <table>
  14986. <thead>
  14987. <tr>
  14988. <th>Field</th>
  14989. <th>Description</th>
  14990. </tr>
  14991. </thead>
  14992. <tbody>
  14993. <tr>
  14994. <td>
  14995. <code>method</code></br>
  14996. <em>
  14997. string
  14998. </em>
  14999. </td>
  15000. <td>
  15001. <p>Webhook Method</p>
  15002. </td>
  15003. </tr>
  15004. <tr>
  15005. <td>
  15006. <code>url</code></br>
  15007. <em>
  15008. string
  15009. </em>
  15010. </td>
  15011. <td>
  15012. <p>Webhook url to call</p>
  15013. </td>
  15014. </tr>
  15015. <tr>
  15016. <td>
  15017. <code>headers</code></br>
  15018. <em>
  15019. map[string]string
  15020. </em>
  15021. </td>
  15022. <td>
  15023. <em>(Optional)</em>
  15024. <p>Headers</p>
  15025. </td>
  15026. </tr>
  15027. <tr>
  15028. <td>
  15029. <code>auth</code></br>
  15030. <em>
  15031. <a href="#external-secrets.io/v1.AuthorizationProtocol">
  15032. AuthorizationProtocol
  15033. </a>
  15034. </em>
  15035. </td>
  15036. <td>
  15037. <em>(Optional)</em>
  15038. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  15039. </td>
  15040. </tr>
  15041. <tr>
  15042. <td>
  15043. <code>body</code></br>
  15044. <em>
  15045. string
  15046. </em>
  15047. </td>
  15048. <td>
  15049. <em>(Optional)</em>
  15050. <p>Body</p>
  15051. </td>
  15052. </tr>
  15053. <tr>
  15054. <td>
  15055. <code>timeout</code></br>
  15056. <em>
  15057. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15058. Kubernetes meta/v1.Duration
  15059. </a>
  15060. </em>
  15061. </td>
  15062. <td>
  15063. <em>(Optional)</em>
  15064. <p>Timeout</p>
  15065. </td>
  15066. </tr>
  15067. <tr>
  15068. <td>
  15069. <code>result</code></br>
  15070. <em>
  15071. <a href="#external-secrets.io/v1.WebhookResult">
  15072. WebhookResult
  15073. </a>
  15074. </em>
  15075. </td>
  15076. <td>
  15077. <em>(Optional)</em>
  15078. <p>Result formatting</p>
  15079. </td>
  15080. </tr>
  15081. <tr>
  15082. <td>
  15083. <code>secrets</code></br>
  15084. <em>
  15085. <a href="#external-secrets.io/v1.WebhookSecret">
  15086. []WebhookSecret
  15087. </a>
  15088. </em>
  15089. </td>
  15090. <td>
  15091. <em>(Optional)</em>
  15092. <p>Secrets to fill in templates
  15093. These secrets will be passed to the templating function as key value pairs under the given name</p>
  15094. </td>
  15095. </tr>
  15096. <tr>
  15097. <td>
  15098. <code>caBundle</code></br>
  15099. <em>
  15100. []byte
  15101. </em>
  15102. </td>
  15103. <td>
  15104. <em>(Optional)</em>
  15105. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  15106. if the Server URL is using HTTPS protocol. This parameter is ignored for
  15107. plain HTTP protocol connection. If not set the system root certificates
  15108. are used to validate the TLS connection.</p>
  15109. </td>
  15110. </tr>
  15111. <tr>
  15112. <td>
  15113. <code>caProvider</code></br>
  15114. <em>
  15115. <a href="#external-secrets.io/v1.WebhookCAProvider">
  15116. WebhookCAProvider
  15117. </a>
  15118. </em>
  15119. </td>
  15120. <td>
  15121. <em>(Optional)</em>
  15122. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  15123. </td>
  15124. </tr>
  15125. </tbody>
  15126. </table>
  15127. <h3 id="external-secrets.io/v1.WebhookResult">WebhookResult
  15128. </h3>
  15129. <p>
  15130. (<em>Appears on:</em>
  15131. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  15132. </p>
  15133. <p>
  15134. <p>WebhookResult defines how to process and extract secrets from the webhook response.</p>
  15135. </p>
  15136. <table>
  15137. <thead>
  15138. <tr>
  15139. <th>Field</th>
  15140. <th>Description</th>
  15141. </tr>
  15142. </thead>
  15143. <tbody>
  15144. <tr>
  15145. <td>
  15146. <code>jsonPath</code></br>
  15147. <em>
  15148. string
  15149. </em>
  15150. </td>
  15151. <td>
  15152. <em>(Optional)</em>
  15153. <p>Json path of return value</p>
  15154. </td>
  15155. </tr>
  15156. </tbody>
  15157. </table>
  15158. <h3 id="external-secrets.io/v1.WebhookSecret">WebhookSecret
  15159. </h3>
  15160. <p>
  15161. (<em>Appears on:</em>
  15162. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  15163. </p>
  15164. <p>
  15165. <p>WebhookSecret defines a secret that will be passed to the webhook request.</p>
  15166. </p>
  15167. <table>
  15168. <thead>
  15169. <tr>
  15170. <th>Field</th>
  15171. <th>Description</th>
  15172. </tr>
  15173. </thead>
  15174. <tbody>
  15175. <tr>
  15176. <td>
  15177. <code>name</code></br>
  15178. <em>
  15179. string
  15180. </em>
  15181. </td>
  15182. <td>
  15183. <p>Name of this secret in templates</p>
  15184. </td>
  15185. </tr>
  15186. <tr>
  15187. <td>
  15188. <code>secretRef</code></br>
  15189. <em>
  15190. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15191. External Secrets meta/v1.SecretKeySelector
  15192. </a>
  15193. </em>
  15194. </td>
  15195. <td>
  15196. <p>Secret ref to fill in credentials</p>
  15197. </td>
  15198. </tr>
  15199. </tbody>
  15200. </table>
  15201. <h3 id="external-secrets.io/v1.YandexAuth">YandexAuth
  15202. </h3>
  15203. <p>
  15204. (<em>Appears on:</em>
  15205. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  15206. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  15207. </p>
  15208. <p>
  15209. <p>YandexAuth defines the authentication method for the Yandex provider.</p>
  15210. </p>
  15211. <table>
  15212. <thead>
  15213. <tr>
  15214. <th>Field</th>
  15215. <th>Description</th>
  15216. </tr>
  15217. </thead>
  15218. <tbody>
  15219. <tr>
  15220. <td>
  15221. <code>authorizedKeySecretRef</code></br>
  15222. <em>
  15223. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15224. External Secrets meta/v1.SecretKeySelector
  15225. </a>
  15226. </em>
  15227. </td>
  15228. <td>
  15229. <em>(Optional)</em>
  15230. <p>The authorized key used for authentication</p>
  15231. </td>
  15232. </tr>
  15233. </tbody>
  15234. </table>
  15235. <h3 id="external-secrets.io/v1.YandexCAProvider">YandexCAProvider
  15236. </h3>
  15237. <p>
  15238. (<em>Appears on:</em>
  15239. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  15240. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  15241. </p>
  15242. <p>
  15243. <p>YandexCAProvider defines the configuration for Yandex custom certificate authority.</p>
  15244. </p>
  15245. <table>
  15246. <thead>
  15247. <tr>
  15248. <th>Field</th>
  15249. <th>Description</th>
  15250. </tr>
  15251. </thead>
  15252. <tbody>
  15253. <tr>
  15254. <td>
  15255. <code>certSecretRef</code></br>
  15256. <em>
  15257. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15258. External Secrets meta/v1.SecretKeySelector
  15259. </a>
  15260. </em>
  15261. </td>
  15262. <td>
  15263. </td>
  15264. </tr>
  15265. </tbody>
  15266. </table>
  15267. <h3 id="external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  15268. </h3>
  15269. <p>
  15270. (<em>Appears on:</em>
  15271. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15272. </p>
  15273. <p>
  15274. <p>YandexCertificateManagerProvider Configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  15275. </p>
  15276. <table>
  15277. <thead>
  15278. <tr>
  15279. <th>Field</th>
  15280. <th>Description</th>
  15281. </tr>
  15282. </thead>
  15283. <tbody>
  15284. <tr>
  15285. <td>
  15286. <code>apiEndpoint</code></br>
  15287. <em>
  15288. string
  15289. </em>
  15290. </td>
  15291. <td>
  15292. <em>(Optional)</em>
  15293. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  15294. </td>
  15295. </tr>
  15296. <tr>
  15297. <td>
  15298. <code>auth</code></br>
  15299. <em>
  15300. <a href="#external-secrets.io/v1.YandexAuth">
  15301. YandexAuth
  15302. </a>
  15303. </em>
  15304. </td>
  15305. <td>
  15306. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  15307. </td>
  15308. </tr>
  15309. <tr>
  15310. <td>
  15311. <code>caProvider</code></br>
  15312. <em>
  15313. <a href="#external-secrets.io/v1.YandexCAProvider">
  15314. YandexCAProvider
  15315. </a>
  15316. </em>
  15317. </td>
  15318. <td>
  15319. <em>(Optional)</em>
  15320. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  15321. </td>
  15322. </tr>
  15323. <tr>
  15324. <td>
  15325. <code>fetching</code></br>
  15326. <em>
  15327. <a href="#external-secrets.io/v1.FetchingPolicy">
  15328. FetchingPolicy
  15329. </a>
  15330. </em>
  15331. </td>
  15332. <td>
  15333. <em>(Optional)</em>
  15334. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as certificate ID or certificate name</p>
  15335. </td>
  15336. </tr>
  15337. </tbody>
  15338. </table>
  15339. <h3 id="external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider
  15340. </h3>
  15341. <p>
  15342. (<em>Appears on:</em>
  15343. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15344. </p>
  15345. <p>
  15346. <p>YandexLockboxProvider Configures a store to sync secrets using the Yandex Lockbox provider.</p>
  15347. </p>
  15348. <table>
  15349. <thead>
  15350. <tr>
  15351. <th>Field</th>
  15352. <th>Description</th>
  15353. </tr>
  15354. </thead>
  15355. <tbody>
  15356. <tr>
  15357. <td>
  15358. <code>apiEndpoint</code></br>
  15359. <em>
  15360. string
  15361. </em>
  15362. </td>
  15363. <td>
  15364. <em>(Optional)</em>
  15365. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  15366. </td>
  15367. </tr>
  15368. <tr>
  15369. <td>
  15370. <code>auth</code></br>
  15371. <em>
  15372. <a href="#external-secrets.io/v1.YandexAuth">
  15373. YandexAuth
  15374. </a>
  15375. </em>
  15376. </td>
  15377. <td>
  15378. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  15379. </td>
  15380. </tr>
  15381. <tr>
  15382. <td>
  15383. <code>caProvider</code></br>
  15384. <em>
  15385. <a href="#external-secrets.io/v1.YandexCAProvider">
  15386. YandexCAProvider
  15387. </a>
  15388. </em>
  15389. </td>
  15390. <td>
  15391. <em>(Optional)</em>
  15392. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  15393. </td>
  15394. </tr>
  15395. <tr>
  15396. <td>
  15397. <code>fetching</code></br>
  15398. <em>
  15399. <a href="#external-secrets.io/v1.FetchingPolicy">
  15400. FetchingPolicy
  15401. </a>
  15402. </em>
  15403. </td>
  15404. <td>
  15405. <em>(Optional)</em>
  15406. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID or secret name</p>
  15407. </td>
  15408. </tr>
  15409. </tbody>
  15410. </table>
  15411. <hr/>
  15412. <h2 id="external-secrets.io/v1alpha1">external-secrets.io/v1alpha1</h2>
  15413. <p>
  15414. <p>Package v1alpha1 contains resources for external-secrets</p>
  15415. </p>
  15416. <p>Resource Types:</p>
  15417. <ul></ul>
  15418. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret
  15419. </h3>
  15420. <p>
  15421. <p>ClusterPushSecret is the Schema for the ClusterPushSecrets API that enables cluster-wide management of pushing Kubernetes secrets to external providers.</p>
  15422. </p>
  15423. <table>
  15424. <thead>
  15425. <tr>
  15426. <th>Field</th>
  15427. <th>Description</th>
  15428. </tr>
  15429. </thead>
  15430. <tbody>
  15431. <tr>
  15432. <td>
  15433. <code>metadata</code></br>
  15434. <em>
  15435. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  15436. Kubernetes meta/v1.ObjectMeta
  15437. </a>
  15438. </em>
  15439. </td>
  15440. <td>
  15441. Refer to the Kubernetes API documentation for the fields of the
  15442. <code>metadata</code> field.
  15443. </td>
  15444. </tr>
  15445. <tr>
  15446. <td>
  15447. <code>spec</code></br>
  15448. <em>
  15449. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">
  15450. ClusterPushSecretSpec
  15451. </a>
  15452. </em>
  15453. </td>
  15454. <td>
  15455. <br/>
  15456. <br/>
  15457. <table>
  15458. <tr>
  15459. <td>
  15460. <code>pushSecretSpec</code></br>
  15461. <em>
  15462. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15463. PushSecretSpec
  15464. </a>
  15465. </em>
  15466. </td>
  15467. <td>
  15468. <p>PushSecretSpec defines what to do with the secrets.</p>
  15469. </td>
  15470. </tr>
  15471. <tr>
  15472. <td>
  15473. <code>refreshTime</code></br>
  15474. <em>
  15475. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15476. Kubernetes meta/v1.Duration
  15477. </a>
  15478. </em>
  15479. </td>
  15480. <td>
  15481. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  15482. </td>
  15483. </tr>
  15484. <tr>
  15485. <td>
  15486. <code>pushSecretName</code></br>
  15487. <em>
  15488. string
  15489. </em>
  15490. </td>
  15491. <td>
  15492. <em>(Optional)</em>
  15493. <p>The name of the push secrets to be created.
  15494. Defaults to the name of the ClusterPushSecret</p>
  15495. </td>
  15496. </tr>
  15497. <tr>
  15498. <td>
  15499. <code>pushSecretMetadata</code></br>
  15500. <em>
  15501. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  15502. PushSecretMetadata
  15503. </a>
  15504. </em>
  15505. </td>
  15506. <td>
  15507. <em>(Optional)</em>
  15508. <p>The metadata of the external secrets to be created</p>
  15509. </td>
  15510. </tr>
  15511. <tr>
  15512. <td>
  15513. <code>namespaceSelectors</code></br>
  15514. <em>
  15515. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  15516. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  15517. </a>
  15518. </em>
  15519. </td>
  15520. <td>
  15521. <em>(Optional)</em>
  15522. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  15523. </td>
  15524. </tr>
  15525. </table>
  15526. </td>
  15527. </tr>
  15528. <tr>
  15529. <td>
  15530. <code>status</code></br>
  15531. <em>
  15532. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">
  15533. ClusterPushSecretStatus
  15534. </a>
  15535. </em>
  15536. </td>
  15537. <td>
  15538. </td>
  15539. </tr>
  15540. </tbody>
  15541. </table>
  15542. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretCondition">ClusterPushSecretCondition
  15543. </h3>
  15544. <p>
  15545. <p>ClusterPushSecretCondition used to refine PushSecrets to specific namespaces and names.</p>
  15546. </p>
  15547. <table>
  15548. <thead>
  15549. <tr>
  15550. <th>Field</th>
  15551. <th>Description</th>
  15552. </tr>
  15553. </thead>
  15554. <tbody>
  15555. <tr>
  15556. <td>
  15557. <code>namespaceSelector</code></br>
  15558. <em>
  15559. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  15560. Kubernetes meta/v1.LabelSelector
  15561. </a>
  15562. </em>
  15563. </td>
  15564. <td>
  15565. <em>(Optional)</em>
  15566. <p>Choose namespace using a labelSelector</p>
  15567. </td>
  15568. </tr>
  15569. <tr>
  15570. <td>
  15571. <code>namespaces</code></br>
  15572. <em>
  15573. []string
  15574. </em>
  15575. </td>
  15576. <td>
  15577. <em>(Optional)</em>
  15578. <p>Choose namespaces by name</p>
  15579. </td>
  15580. </tr>
  15581. </tbody>
  15582. </table>
  15583. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">ClusterPushSecretNamespaceFailure
  15584. </h3>
  15585. <p>
  15586. (<em>Appears on:</em>
  15587. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>)
  15588. </p>
  15589. <p>
  15590. <p>ClusterPushSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  15591. </p>
  15592. <table>
  15593. <thead>
  15594. <tr>
  15595. <th>Field</th>
  15596. <th>Description</th>
  15597. </tr>
  15598. </thead>
  15599. <tbody>
  15600. <tr>
  15601. <td>
  15602. <code>namespace</code></br>
  15603. <em>
  15604. string
  15605. </em>
  15606. </td>
  15607. <td>
  15608. <p>Namespace is the namespace that failed when trying to apply an PushSecret</p>
  15609. </td>
  15610. </tr>
  15611. <tr>
  15612. <td>
  15613. <code>reason</code></br>
  15614. <em>
  15615. string
  15616. </em>
  15617. </td>
  15618. <td>
  15619. <em>(Optional)</em>
  15620. <p>Reason is why the PushSecret failed to apply to the namespace</p>
  15621. </td>
  15622. </tr>
  15623. </tbody>
  15624. </table>
  15625. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec
  15626. </h3>
  15627. <p>
  15628. (<em>Appears on:</em>
  15629. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  15630. </p>
  15631. <p>
  15632. <p>ClusterPushSecretSpec defines the configuration for a ClusterPushSecret resource.</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>pushSecretSpec</code></br>
  15645. <em>
  15646. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15647. PushSecretSpec
  15648. </a>
  15649. </em>
  15650. </td>
  15651. <td>
  15652. <p>PushSecretSpec defines what to do with the secrets.</p>
  15653. </td>
  15654. </tr>
  15655. <tr>
  15656. <td>
  15657. <code>refreshTime</code></br>
  15658. <em>
  15659. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15660. Kubernetes meta/v1.Duration
  15661. </a>
  15662. </em>
  15663. </td>
  15664. <td>
  15665. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  15666. </td>
  15667. </tr>
  15668. <tr>
  15669. <td>
  15670. <code>pushSecretName</code></br>
  15671. <em>
  15672. string
  15673. </em>
  15674. </td>
  15675. <td>
  15676. <em>(Optional)</em>
  15677. <p>The name of the push secrets to be created.
  15678. Defaults to the name of the ClusterPushSecret</p>
  15679. </td>
  15680. </tr>
  15681. <tr>
  15682. <td>
  15683. <code>pushSecretMetadata</code></br>
  15684. <em>
  15685. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  15686. PushSecretMetadata
  15687. </a>
  15688. </em>
  15689. </td>
  15690. <td>
  15691. <em>(Optional)</em>
  15692. <p>The metadata of the external secrets to be created</p>
  15693. </td>
  15694. </tr>
  15695. <tr>
  15696. <td>
  15697. <code>namespaceSelectors</code></br>
  15698. <em>
  15699. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  15700. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  15701. </a>
  15702. </em>
  15703. </td>
  15704. <td>
  15705. <em>(Optional)</em>
  15706. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  15707. </td>
  15708. </tr>
  15709. </tbody>
  15710. </table>
  15711. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus
  15712. </h3>
  15713. <p>
  15714. (<em>Appears on:</em>
  15715. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  15716. </p>
  15717. <p>
  15718. <p>ClusterPushSecretStatus contains the status information for the ClusterPushSecret resource.</p>
  15719. </p>
  15720. <table>
  15721. <thead>
  15722. <tr>
  15723. <th>Field</th>
  15724. <th>Description</th>
  15725. </tr>
  15726. </thead>
  15727. <tbody>
  15728. <tr>
  15729. <td>
  15730. <code>failedNamespaces</code></br>
  15731. <em>
  15732. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">
  15733. []ClusterPushSecretNamespaceFailure
  15734. </a>
  15735. </em>
  15736. </td>
  15737. <td>
  15738. <em>(Optional)</em>
  15739. <p>Failed namespaces are the namespaces that failed to apply an PushSecret</p>
  15740. </td>
  15741. </tr>
  15742. <tr>
  15743. <td>
  15744. <code>provisionedNamespaces</code></br>
  15745. <em>
  15746. []string
  15747. </em>
  15748. </td>
  15749. <td>
  15750. <em>(Optional)</em>
  15751. <p>ProvisionedNamespaces are the namespaces where the ClusterPushSecret has secrets</p>
  15752. </td>
  15753. </tr>
  15754. <tr>
  15755. <td>
  15756. <code>pushSecretName</code></br>
  15757. <em>
  15758. string
  15759. </em>
  15760. </td>
  15761. <td>
  15762. </td>
  15763. </tr>
  15764. <tr>
  15765. <td>
  15766. <code>conditions</code></br>
  15767. <em>
  15768. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  15769. []PushSecretStatusCondition
  15770. </a>
  15771. </em>
  15772. </td>
  15773. <td>
  15774. <em>(Optional)</em>
  15775. </td>
  15776. </tr>
  15777. </tbody>
  15778. </table>
  15779. <h3 id="external-secrets.io/v1alpha1.PushSecret">PushSecret
  15780. </h3>
  15781. <p>
  15782. <p>PushSecret is the Schema for the PushSecrets API that enables pushing Kubernetes secrets to external secret providers.</p>
  15783. </p>
  15784. <table>
  15785. <thead>
  15786. <tr>
  15787. <th>Field</th>
  15788. <th>Description</th>
  15789. </tr>
  15790. </thead>
  15791. <tbody>
  15792. <tr>
  15793. <td>
  15794. <code>metadata</code></br>
  15795. <em>
  15796. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  15797. Kubernetes meta/v1.ObjectMeta
  15798. </a>
  15799. </em>
  15800. </td>
  15801. <td>
  15802. Refer to the Kubernetes API documentation for the fields of the
  15803. <code>metadata</code> field.
  15804. </td>
  15805. </tr>
  15806. <tr>
  15807. <td>
  15808. <code>spec</code></br>
  15809. <em>
  15810. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15811. PushSecretSpec
  15812. </a>
  15813. </em>
  15814. </td>
  15815. <td>
  15816. <br/>
  15817. <br/>
  15818. <table>
  15819. <tr>
  15820. <td>
  15821. <code>refreshInterval</code></br>
  15822. <em>
  15823. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15824. Kubernetes meta/v1.Duration
  15825. </a>
  15826. </em>
  15827. </td>
  15828. <td>
  15829. <p>The Interval to which External Secrets will try to push a secret definition</p>
  15830. </td>
  15831. </tr>
  15832. <tr>
  15833. <td>
  15834. <code>secretStoreRefs</code></br>
  15835. <em>
  15836. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  15837. []PushSecretStoreRef
  15838. </a>
  15839. </em>
  15840. </td>
  15841. <td>
  15842. </td>
  15843. </tr>
  15844. <tr>
  15845. <td>
  15846. <code>updatePolicy</code></br>
  15847. <em>
  15848. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  15849. PushSecretUpdatePolicy
  15850. </a>
  15851. </em>
  15852. </td>
  15853. <td>
  15854. <em>(Optional)</em>
  15855. <p>UpdatePolicy to handle Secrets in the provider.</p>
  15856. </td>
  15857. </tr>
  15858. <tr>
  15859. <td>
  15860. <code>deletionPolicy</code></br>
  15861. <em>
  15862. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  15863. PushSecretDeletionPolicy
  15864. </a>
  15865. </em>
  15866. </td>
  15867. <td>
  15868. <em>(Optional)</em>
  15869. <p>Deletion Policy to handle Secrets in the provider.</p>
  15870. </td>
  15871. </tr>
  15872. <tr>
  15873. <td>
  15874. <code>selector</code></br>
  15875. <em>
  15876. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  15877. PushSecretSelector
  15878. </a>
  15879. </em>
  15880. </td>
  15881. <td>
  15882. <p>The Secret Selector (k8s source) for the Push Secret</p>
  15883. </td>
  15884. </tr>
  15885. <tr>
  15886. <td>
  15887. <code>data</code></br>
  15888. <em>
  15889. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  15890. []PushSecretData
  15891. </a>
  15892. </em>
  15893. </td>
  15894. <td>
  15895. <em>(Optional)</em>
  15896. <p>Secret Data that should be pushed to providers</p>
  15897. </td>
  15898. </tr>
  15899. <tr>
  15900. <td>
  15901. <code>dataTo</code></br>
  15902. <em>
  15903. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  15904. []PushSecretDataTo
  15905. </a>
  15906. </em>
  15907. </td>
  15908. <td>
  15909. <em>(Optional)</em>
  15910. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  15911. </td>
  15912. </tr>
  15913. <tr>
  15914. <td>
  15915. <code>template</code></br>
  15916. <em>
  15917. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  15918. ExternalSecretTemplate
  15919. </a>
  15920. </em>
  15921. </td>
  15922. <td>
  15923. <em>(Optional)</em>
  15924. <p>Template defines a blueprint for the created Secret resource.</p>
  15925. </td>
  15926. </tr>
  15927. </table>
  15928. </td>
  15929. </tr>
  15930. <tr>
  15931. <td>
  15932. <code>status</code></br>
  15933. <em>
  15934. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">
  15935. PushSecretStatus
  15936. </a>
  15937. </em>
  15938. </td>
  15939. <td>
  15940. </td>
  15941. </tr>
  15942. </tbody>
  15943. </table>
  15944. <h3 id="external-secrets.io/v1alpha1.PushSecretConditionType">PushSecretConditionType
  15945. (<code>string</code> alias)</p></h3>
  15946. <p>
  15947. (<em>Appears on:</em>
  15948. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition</a>)
  15949. </p>
  15950. <p>
  15951. <p>PushSecretConditionType indicates the condition of the PushSecret.</p>
  15952. </p>
  15953. <table>
  15954. <thead>
  15955. <tr>
  15956. <th>Value</th>
  15957. <th>Description</th>
  15958. </tr>
  15959. </thead>
  15960. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  15961. <td><p>PushSecretReady indicates the PushSecret resource is ready.</p>
  15962. </td>
  15963. </tr></tbody>
  15964. </table>
  15965. <h3 id="external-secrets.io/v1alpha1.PushSecretConversionStrategy">PushSecretConversionStrategy
  15966. (<code>string</code> alias)</p></h3>
  15967. <p>
  15968. (<em>Appears on:</em>
  15969. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>,
  15970. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  15971. </p>
  15972. <p>
  15973. <p>PushSecretConversionStrategy defines how secret values are converted when pushed to providers.</p>
  15974. </p>
  15975. <table>
  15976. <thead>
  15977. <tr>
  15978. <th>Value</th>
  15979. <th>Description</th>
  15980. </tr>
  15981. </thead>
  15982. <tbody><tr><td><p>&#34;None&#34;</p></td>
  15983. <td><p>PushSecretConversionNone indicates no conversion will be performed on the secret value.</p>
  15984. </td>
  15985. </tr><tr><td><p>&#34;ReverseUnicode&#34;</p></td>
  15986. <td><p>PushSecretConversionReverseUnicode indicates that unicode escape sequences will be reversed.</p>
  15987. </td>
  15988. </tr></tbody>
  15989. </table>
  15990. <h3 id="external-secrets.io/v1alpha1.PushSecretData">PushSecretData
  15991. </h3>
  15992. <p>
  15993. (<em>Appears on:</em>
  15994. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15995. </p>
  15996. <p>
  15997. <p>PushSecretData defines data to be pushed to the provider and associated metadata.</p>
  15998. </p>
  15999. <table>
  16000. <thead>
  16001. <tr>
  16002. <th>Field</th>
  16003. <th>Description</th>
  16004. </tr>
  16005. </thead>
  16006. <tbody>
  16007. <tr>
  16008. <td>
  16009. <code>match</code></br>
  16010. <em>
  16011. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">
  16012. PushSecretMatch
  16013. </a>
  16014. </em>
  16015. </td>
  16016. <td>
  16017. <p>Match a given Secret Key to be pushed to the provider.</p>
  16018. </td>
  16019. </tr>
  16020. <tr>
  16021. <td>
  16022. <code>metadata</code></br>
  16023. <em>
  16024. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  16025. </em>
  16026. </td>
  16027. <td>
  16028. <em>(Optional)</em>
  16029. <p>Metadata is metadata attached to the secret.
  16030. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  16031. </td>
  16032. </tr>
  16033. <tr>
  16034. <td>
  16035. <code>conversionStrategy</code></br>
  16036. <em>
  16037. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  16038. PushSecretConversionStrategy
  16039. </a>
  16040. </em>
  16041. </td>
  16042. <td>
  16043. <em>(Optional)</em>
  16044. <p>Used to define a conversion Strategy for the secret keys</p>
  16045. </td>
  16046. </tr>
  16047. </tbody>
  16048. </table>
  16049. <h3 id="external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo
  16050. </h3>
  16051. <p>
  16052. (<em>Appears on:</em>
  16053. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16054. </p>
  16055. <p>
  16056. <p>PushSecretDataTo defines how to bulk-push secrets to providers without explicit per-key mappings.</p>
  16057. </p>
  16058. <table>
  16059. <thead>
  16060. <tr>
  16061. <th>Field</th>
  16062. <th>Description</th>
  16063. </tr>
  16064. </thead>
  16065. <tbody>
  16066. <tr>
  16067. <td>
  16068. <code>storeRef</code></br>
  16069. <em>
  16070. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  16071. PushSecretStoreRef
  16072. </a>
  16073. </em>
  16074. </td>
  16075. <td>
  16076. <p>StoreRef specifies which SecretStore to push to. Required.</p>
  16077. </td>
  16078. </tr>
  16079. <tr>
  16080. <td>
  16081. <code>remoteKey</code></br>
  16082. <em>
  16083. string
  16084. </em>
  16085. </td>
  16086. <td>
  16087. <em>(Optional)</em>
  16088. <p>RemoteKey is the name of the single provider secret that will receive ALL
  16089. matched keys bundled as a JSON object (e.g. {&ldquo;DB_HOST&rdquo;:&ldquo;&hellip;&rdquo;,&ldquo;DB_USER&rdquo;:&ldquo;&hellip;&rdquo;}).
  16090. When set, per-key expansion is skipped and a single push is performed.
  16091. The provider&rsquo;s store prefix (if any) is still prepended to this value.
  16092. When not set, each matched key is pushed as its own individual provider secret.</p>
  16093. </td>
  16094. </tr>
  16095. <tr>
  16096. <td>
  16097. <code>match</code></br>
  16098. <em>
  16099. <a href="#external-secrets.io/v1alpha1.PushSecretDataToMatch">
  16100. PushSecretDataToMatch
  16101. </a>
  16102. </em>
  16103. </td>
  16104. <td>
  16105. <em>(Optional)</em>
  16106. <p>Match pattern for selecting keys from the source Secret.
  16107. If not specified, all keys are selected.</p>
  16108. </td>
  16109. </tr>
  16110. <tr>
  16111. <td>
  16112. <code>rewrite</code></br>
  16113. <em>
  16114. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">
  16115. []PushSecretRewrite
  16116. </a>
  16117. </em>
  16118. </td>
  16119. <td>
  16120. <em>(Optional)</em>
  16121. <p>Rewrite operations to transform keys before pushing to the provider.
  16122. Operations are applied sequentially.</p>
  16123. </td>
  16124. </tr>
  16125. <tr>
  16126. <td>
  16127. <code>metadata</code></br>
  16128. <em>
  16129. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  16130. </em>
  16131. </td>
  16132. <td>
  16133. <em>(Optional)</em>
  16134. <p>Metadata is metadata attached to the secret.
  16135. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  16136. </td>
  16137. </tr>
  16138. <tr>
  16139. <td>
  16140. <code>conversionStrategy</code></br>
  16141. <em>
  16142. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  16143. PushSecretConversionStrategy
  16144. </a>
  16145. </em>
  16146. </td>
  16147. <td>
  16148. <em>(Optional)</em>
  16149. <p>Used to define a conversion Strategy for the secret keys</p>
  16150. </td>
  16151. </tr>
  16152. </tbody>
  16153. </table>
  16154. <h3 id="external-secrets.io/v1alpha1.PushSecretDataToMatch">PushSecretDataToMatch
  16155. </h3>
  16156. <p>
  16157. (<em>Appears on:</em>
  16158. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16159. </p>
  16160. <p>
  16161. <p>PushSecretDataToMatch defines pattern matching for key selection.</p>
  16162. </p>
  16163. <table>
  16164. <thead>
  16165. <tr>
  16166. <th>Field</th>
  16167. <th>Description</th>
  16168. </tr>
  16169. </thead>
  16170. <tbody>
  16171. <tr>
  16172. <td>
  16173. <code>regexp</code></br>
  16174. <em>
  16175. string
  16176. </em>
  16177. </td>
  16178. <td>
  16179. <em>(Optional)</em>
  16180. <p>Regexp matches keys by regular expression.
  16181. If not specified, all keys are matched.</p>
  16182. </td>
  16183. </tr>
  16184. </tbody>
  16185. </table>
  16186. <h3 id="external-secrets.io/v1alpha1.PushSecretDeletionPolicy">PushSecretDeletionPolicy
  16187. (<code>string</code> alias)</p></h3>
  16188. <p>
  16189. (<em>Appears on:</em>
  16190. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16191. </p>
  16192. <p>
  16193. <p>PushSecretDeletionPolicy defines how push secrets are deleted in the provider.</p>
  16194. </p>
  16195. <table>
  16196. <thead>
  16197. <tr>
  16198. <th>Value</th>
  16199. <th>Description</th>
  16200. </tr>
  16201. </thead>
  16202. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  16203. <td><p>PushSecretDeletionPolicyDelete deletes secrets from the provider when the PushSecret is deleted.</p>
  16204. </td>
  16205. </tr><tr><td><p>&#34;None&#34;</p></td>
  16206. <td><p>PushSecretDeletionPolicyNone keeps secrets in the provider when the PushSecret is deleted.</p>
  16207. </td>
  16208. </tr></tbody>
  16209. </table>
  16210. <h3 id="external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch
  16211. </h3>
  16212. <p>
  16213. (<em>Appears on:</em>
  16214. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>)
  16215. </p>
  16216. <p>
  16217. <p>PushSecretMatch defines how a source Secret key maps to a destination in the provider.</p>
  16218. </p>
  16219. <table>
  16220. <thead>
  16221. <tr>
  16222. <th>Field</th>
  16223. <th>Description</th>
  16224. </tr>
  16225. </thead>
  16226. <tbody>
  16227. <tr>
  16228. <td>
  16229. <code>secretKey</code></br>
  16230. <em>
  16231. string
  16232. </em>
  16233. </td>
  16234. <td>
  16235. <em>(Optional)</em>
  16236. <p>Secret Key to be pushed</p>
  16237. </td>
  16238. </tr>
  16239. <tr>
  16240. <td>
  16241. <code>remoteRef</code></br>
  16242. <em>
  16243. <a href="#external-secrets.io/v1alpha1.PushSecretRemoteRef">
  16244. PushSecretRemoteRef
  16245. </a>
  16246. </em>
  16247. </td>
  16248. <td>
  16249. <p>Remote Refs to push to providers.</p>
  16250. </td>
  16251. </tr>
  16252. </tbody>
  16253. </table>
  16254. <h3 id="external-secrets.io/v1alpha1.PushSecretMetadata">PushSecretMetadata
  16255. </h3>
  16256. <p>
  16257. (<em>Appears on:</em>
  16258. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>)
  16259. </p>
  16260. <p>
  16261. <p>PushSecretMetadata defines metadata fields for the PushSecret generated by the ClusterPushSecret.</p>
  16262. </p>
  16263. <table>
  16264. <thead>
  16265. <tr>
  16266. <th>Field</th>
  16267. <th>Description</th>
  16268. </tr>
  16269. </thead>
  16270. <tbody>
  16271. <tr>
  16272. <td>
  16273. <code>annotations</code></br>
  16274. <em>
  16275. map[string]string
  16276. </em>
  16277. </td>
  16278. <td>
  16279. <em>(Optional)</em>
  16280. </td>
  16281. </tr>
  16282. <tr>
  16283. <td>
  16284. <code>labels</code></br>
  16285. <em>
  16286. map[string]string
  16287. </em>
  16288. </td>
  16289. <td>
  16290. <em>(Optional)</em>
  16291. </td>
  16292. </tr>
  16293. </tbody>
  16294. </table>
  16295. <h3 id="external-secrets.io/v1alpha1.PushSecretRemoteRef">PushSecretRemoteRef
  16296. </h3>
  16297. <p>
  16298. (<em>Appears on:</em>
  16299. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch</a>)
  16300. </p>
  16301. <p>
  16302. <p>PushSecretRemoteRef defines the location of the secret in the provider.</p>
  16303. </p>
  16304. <table>
  16305. <thead>
  16306. <tr>
  16307. <th>Field</th>
  16308. <th>Description</th>
  16309. </tr>
  16310. </thead>
  16311. <tbody>
  16312. <tr>
  16313. <td>
  16314. <code>remoteKey</code></br>
  16315. <em>
  16316. string
  16317. </em>
  16318. </td>
  16319. <td>
  16320. <p>Name of the resulting provider secret.</p>
  16321. </td>
  16322. </tr>
  16323. <tr>
  16324. <td>
  16325. <code>property</code></br>
  16326. <em>
  16327. string
  16328. </em>
  16329. </td>
  16330. <td>
  16331. <em>(Optional)</em>
  16332. <p>Name of the property in the resulting secret</p>
  16333. </td>
  16334. </tr>
  16335. </tbody>
  16336. </table>
  16337. <h3 id="external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite
  16338. </h3>
  16339. <p>
  16340. (<em>Appears on:</em>
  16341. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16342. </p>
  16343. <p>
  16344. <p>PushSecretRewrite defines how to transform secret keys before pushing.</p>
  16345. </p>
  16346. <table>
  16347. <thead>
  16348. <tr>
  16349. <th>Field</th>
  16350. <th>Description</th>
  16351. </tr>
  16352. </thead>
  16353. <tbody>
  16354. <tr>
  16355. <td>
  16356. <code>regexp</code></br>
  16357. <em>
  16358. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  16359. ExternalSecretRewriteRegexp
  16360. </a>
  16361. </em>
  16362. </td>
  16363. <td>
  16364. <em>(Optional)</em>
  16365. <p>Used to rewrite with regular expressions.</p>
  16366. </td>
  16367. </tr>
  16368. <tr>
  16369. <td>
  16370. <code>transform</code></br>
  16371. <em>
  16372. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  16373. ExternalSecretRewriteTransform
  16374. </a>
  16375. </em>
  16376. </td>
  16377. <td>
  16378. <em>(Optional)</em>
  16379. <p>Used to apply string transformation on the secrets.</p>
  16380. </td>
  16381. </tr>
  16382. </tbody>
  16383. </table>
  16384. <h3 id="external-secrets.io/v1alpha1.PushSecretSecret">PushSecretSecret
  16385. </h3>
  16386. <p>
  16387. (<em>Appears on:</em>
  16388. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  16389. </p>
  16390. <p>
  16391. <p>PushSecretSecret defines a Secret that will be used as a source for pushing to providers.</p>
  16392. </p>
  16393. <table>
  16394. <thead>
  16395. <tr>
  16396. <th>Field</th>
  16397. <th>Description</th>
  16398. </tr>
  16399. </thead>
  16400. <tbody>
  16401. <tr>
  16402. <td>
  16403. <code>name</code></br>
  16404. <em>
  16405. string
  16406. </em>
  16407. </td>
  16408. <td>
  16409. <em>(Optional)</em>
  16410. <p>Name of the Secret.
  16411. The Secret must exist in the same namespace as the PushSecret manifest.</p>
  16412. </td>
  16413. </tr>
  16414. <tr>
  16415. <td>
  16416. <code>selector</code></br>
  16417. <em>
  16418. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  16419. Kubernetes meta/v1.LabelSelector
  16420. </a>
  16421. </em>
  16422. </td>
  16423. <td>
  16424. <em>(Optional)</em>
  16425. <p>Selector chooses secrets using a labelSelector.</p>
  16426. </td>
  16427. </tr>
  16428. </tbody>
  16429. </table>
  16430. <h3 id="external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector
  16431. </h3>
  16432. <p>
  16433. (<em>Appears on:</em>
  16434. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16435. </p>
  16436. <p>
  16437. <p>PushSecretSelector defines criteria for selecting the source Secret for pushing to providers.</p>
  16438. </p>
  16439. <table>
  16440. <thead>
  16441. <tr>
  16442. <th>Field</th>
  16443. <th>Description</th>
  16444. </tr>
  16445. </thead>
  16446. <tbody>
  16447. <tr>
  16448. <td>
  16449. <code>secret</code></br>
  16450. <em>
  16451. <a href="#external-secrets.io/v1alpha1.PushSecretSecret">
  16452. PushSecretSecret
  16453. </a>
  16454. </em>
  16455. </td>
  16456. <td>
  16457. <em>(Optional)</em>
  16458. <p>Select a Secret to Push.</p>
  16459. </td>
  16460. </tr>
  16461. <tr>
  16462. <td>
  16463. <code>generatorRef</code></br>
  16464. <em>
  16465. <a href="#external-secrets.io/v1.GeneratorRef">
  16466. GeneratorRef
  16467. </a>
  16468. </em>
  16469. </td>
  16470. <td>
  16471. <em>(Optional)</em>
  16472. <p>Point to a generator to create a Secret.</p>
  16473. </td>
  16474. </tr>
  16475. </tbody>
  16476. </table>
  16477. <h3 id="external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec
  16478. </h3>
  16479. <p>
  16480. (<em>Appears on:</em>
  16481. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>,
  16482. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  16483. </p>
  16484. <p>
  16485. <p>PushSecretSpec configures the behavior of the PushSecret.</p>
  16486. </p>
  16487. <table>
  16488. <thead>
  16489. <tr>
  16490. <th>Field</th>
  16491. <th>Description</th>
  16492. </tr>
  16493. </thead>
  16494. <tbody>
  16495. <tr>
  16496. <td>
  16497. <code>refreshInterval</code></br>
  16498. <em>
  16499. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  16500. Kubernetes meta/v1.Duration
  16501. </a>
  16502. </em>
  16503. </td>
  16504. <td>
  16505. <p>The Interval to which External Secrets will try to push a secret definition</p>
  16506. </td>
  16507. </tr>
  16508. <tr>
  16509. <td>
  16510. <code>secretStoreRefs</code></br>
  16511. <em>
  16512. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  16513. []PushSecretStoreRef
  16514. </a>
  16515. </em>
  16516. </td>
  16517. <td>
  16518. </td>
  16519. </tr>
  16520. <tr>
  16521. <td>
  16522. <code>updatePolicy</code></br>
  16523. <em>
  16524. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  16525. PushSecretUpdatePolicy
  16526. </a>
  16527. </em>
  16528. </td>
  16529. <td>
  16530. <em>(Optional)</em>
  16531. <p>UpdatePolicy to handle Secrets in the provider.</p>
  16532. </td>
  16533. </tr>
  16534. <tr>
  16535. <td>
  16536. <code>deletionPolicy</code></br>
  16537. <em>
  16538. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  16539. PushSecretDeletionPolicy
  16540. </a>
  16541. </em>
  16542. </td>
  16543. <td>
  16544. <em>(Optional)</em>
  16545. <p>Deletion Policy to handle Secrets in the provider.</p>
  16546. </td>
  16547. </tr>
  16548. <tr>
  16549. <td>
  16550. <code>selector</code></br>
  16551. <em>
  16552. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  16553. PushSecretSelector
  16554. </a>
  16555. </em>
  16556. </td>
  16557. <td>
  16558. <p>The Secret Selector (k8s source) for the Push Secret</p>
  16559. </td>
  16560. </tr>
  16561. <tr>
  16562. <td>
  16563. <code>data</code></br>
  16564. <em>
  16565. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  16566. []PushSecretData
  16567. </a>
  16568. </em>
  16569. </td>
  16570. <td>
  16571. <em>(Optional)</em>
  16572. <p>Secret Data that should be pushed to providers</p>
  16573. </td>
  16574. </tr>
  16575. <tr>
  16576. <td>
  16577. <code>dataTo</code></br>
  16578. <em>
  16579. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  16580. []PushSecretDataTo
  16581. </a>
  16582. </em>
  16583. </td>
  16584. <td>
  16585. <em>(Optional)</em>
  16586. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  16587. </td>
  16588. </tr>
  16589. <tr>
  16590. <td>
  16591. <code>template</code></br>
  16592. <em>
  16593. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  16594. ExternalSecretTemplate
  16595. </a>
  16596. </em>
  16597. </td>
  16598. <td>
  16599. <em>(Optional)</em>
  16600. <p>Template defines a blueprint for the created Secret resource.</p>
  16601. </td>
  16602. </tr>
  16603. </tbody>
  16604. </table>
  16605. <h3 id="external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus
  16606. </h3>
  16607. <p>
  16608. (<em>Appears on:</em>
  16609. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  16610. </p>
  16611. <p>
  16612. <p>PushSecretStatus indicates the history of the status of PushSecret.</p>
  16613. </p>
  16614. <table>
  16615. <thead>
  16616. <tr>
  16617. <th>Field</th>
  16618. <th>Description</th>
  16619. </tr>
  16620. </thead>
  16621. <tbody>
  16622. <tr>
  16623. <td>
  16624. <code>refreshTime</code></br>
  16625. <em>
  16626. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  16627. Kubernetes meta/v1.Time
  16628. </a>
  16629. </em>
  16630. </td>
  16631. <td>
  16632. <p>refreshTime is the time and date the external secret was fetched and
  16633. the target secret updated</p>
  16634. </td>
  16635. </tr>
  16636. <tr>
  16637. <td>
  16638. <code>syncedResourceVersion</code></br>
  16639. <em>
  16640. string
  16641. </em>
  16642. </td>
  16643. <td>
  16644. <p>SyncedResourceVersion keeps track of the last synced version.</p>
  16645. </td>
  16646. </tr>
  16647. <tr>
  16648. <td>
  16649. <code>syncedPushSecrets</code></br>
  16650. <em>
  16651. <a href="#external-secrets.io/v1alpha1.SyncedPushSecretsMap">
  16652. SyncedPushSecretsMap
  16653. </a>
  16654. </em>
  16655. </td>
  16656. <td>
  16657. <em>(Optional)</em>
  16658. <p>Synced PushSecrets, including secrets that already exist in provider.
  16659. Matches secret stores to PushSecretData that was stored to that secret store.</p>
  16660. </td>
  16661. </tr>
  16662. <tr>
  16663. <td>
  16664. <code>conditions</code></br>
  16665. <em>
  16666. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  16667. []PushSecretStatusCondition
  16668. </a>
  16669. </em>
  16670. </td>
  16671. <td>
  16672. <em>(Optional)</em>
  16673. </td>
  16674. </tr>
  16675. </tbody>
  16676. </table>
  16677. <h3 id="external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition
  16678. </h3>
  16679. <p>
  16680. (<em>Appears on:</em>
  16681. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>,
  16682. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  16683. </p>
  16684. <p>
  16685. <p>PushSecretStatusCondition indicates the status of the PushSecret.</p>
  16686. </p>
  16687. <table>
  16688. <thead>
  16689. <tr>
  16690. <th>Field</th>
  16691. <th>Description</th>
  16692. </tr>
  16693. </thead>
  16694. <tbody>
  16695. <tr>
  16696. <td>
  16697. <code>type</code></br>
  16698. <em>
  16699. <a href="#external-secrets.io/v1alpha1.PushSecretConditionType">
  16700. PushSecretConditionType
  16701. </a>
  16702. </em>
  16703. </td>
  16704. <td>
  16705. </td>
  16706. </tr>
  16707. <tr>
  16708. <td>
  16709. <code>status</code></br>
  16710. <em>
  16711. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  16712. Kubernetes core/v1.ConditionStatus
  16713. </a>
  16714. </em>
  16715. </td>
  16716. <td>
  16717. </td>
  16718. </tr>
  16719. <tr>
  16720. <td>
  16721. <code>reason</code></br>
  16722. <em>
  16723. string
  16724. </em>
  16725. </td>
  16726. <td>
  16727. <em>(Optional)</em>
  16728. </td>
  16729. </tr>
  16730. <tr>
  16731. <td>
  16732. <code>message</code></br>
  16733. <em>
  16734. string
  16735. </em>
  16736. </td>
  16737. <td>
  16738. <em>(Optional)</em>
  16739. </td>
  16740. </tr>
  16741. <tr>
  16742. <td>
  16743. <code>lastTransitionTime</code></br>
  16744. <em>
  16745. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  16746. Kubernetes meta/v1.Time
  16747. </a>
  16748. </em>
  16749. </td>
  16750. <td>
  16751. <em>(Optional)</em>
  16752. </td>
  16753. </tr>
  16754. </tbody>
  16755. </table>
  16756. <h3 id="external-secrets.io/v1alpha1.PushSecretStoreRef">PushSecretStoreRef
  16757. </h3>
  16758. <p>
  16759. (<em>Appears on:</em>
  16760. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>,
  16761. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16762. </p>
  16763. <p>
  16764. <p>PushSecretStoreRef contains a reference on how to sync to a SecretStore.</p>
  16765. </p>
  16766. <table>
  16767. <thead>
  16768. <tr>
  16769. <th>Field</th>
  16770. <th>Description</th>
  16771. </tr>
  16772. </thead>
  16773. <tbody>
  16774. <tr>
  16775. <td>
  16776. <code>name</code></br>
  16777. <em>
  16778. string
  16779. </em>
  16780. </td>
  16781. <td>
  16782. <em>(Optional)</em>
  16783. <p>Optionally, sync to the SecretStore of the given name</p>
  16784. </td>
  16785. </tr>
  16786. <tr>
  16787. <td>
  16788. <code>labelSelector</code></br>
  16789. <em>
  16790. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  16791. Kubernetes meta/v1.LabelSelector
  16792. </a>
  16793. </em>
  16794. </td>
  16795. <td>
  16796. <em>(Optional)</em>
  16797. <p>Optionally, sync to secret stores with label selector</p>
  16798. </td>
  16799. </tr>
  16800. <tr>
  16801. <td>
  16802. <code>kind</code></br>
  16803. <em>
  16804. string
  16805. </em>
  16806. </td>
  16807. <td>
  16808. <em>(Optional)</em>
  16809. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)</p>
  16810. </td>
  16811. </tr>
  16812. </tbody>
  16813. </table>
  16814. <h3 id="external-secrets.io/v1alpha1.PushSecretUpdatePolicy">PushSecretUpdatePolicy
  16815. (<code>string</code> alias)</p></h3>
  16816. <p>
  16817. (<em>Appears on:</em>
  16818. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16819. </p>
  16820. <p>
  16821. <p>PushSecretUpdatePolicy defines how push secrets are updated in the provider.</p>
  16822. </p>
  16823. <table>
  16824. <thead>
  16825. <tr>
  16826. <th>Value</th>
  16827. <th>Description</th>
  16828. </tr>
  16829. </thead>
  16830. <tbody><tr><td><p>&#34;IfNotExists&#34;</p></td>
  16831. <td><p>PushSecretUpdatePolicyIfNotExists only creates secrets that don&rsquo;t exist in the provider.</p>
  16832. </td>
  16833. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  16834. <td><p>PushSecretUpdatePolicyReplace replaces existing secrets in the provider.</p>
  16835. </td>
  16836. </tr></tbody>
  16837. </table>
  16838. <h3 id="external-secrets.io/v1alpha1.SyncedPushSecretsMap">SyncedPushSecretsMap
  16839. (<code>map[string]map[string]github.com/external-secrets/external-secrets/apis/externalsecrets/v1alpha1.PushSecretData</code> alias)</p></h3>
  16840. <p>
  16841. (<em>Appears on:</em>
  16842. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  16843. </p>
  16844. <p>
  16845. <p>SyncedPushSecretsMap is a map that tracks which PushSecretData was stored to which secret store.
  16846. The outer map&rsquo;s key is the secret store name, and the inner map&rsquo;s key is the remote key name.</p>
  16847. </p>
  16848. <hr/>
  16849. <h2 id="external-secrets.io/v1beta1">external-secrets.io/v1beta1</h2>
  16850. <p>
  16851. <p>Package v1beta1 contains resources for external-secrets</p>
  16852. </p>
  16853. <p>Resource Types:</p>
  16854. <ul></ul>
  16855. <h3 id="external-secrets.io/v1beta1.AWSAuth">AWSAuth
  16856. </h3>
  16857. <p>
  16858. (<em>Appears on:</em>
  16859. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  16860. </p>
  16861. <p>
  16862. <p>AWSAuth tells the controller how to do authentication with aws.
  16863. Only one of secretRef or jwt can be specified.
  16864. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  16865. </p>
  16866. <table>
  16867. <thead>
  16868. <tr>
  16869. <th>Field</th>
  16870. <th>Description</th>
  16871. </tr>
  16872. </thead>
  16873. <tbody>
  16874. <tr>
  16875. <td>
  16876. <code>secretRef</code></br>
  16877. <em>
  16878. <a href="#external-secrets.io/v1beta1.AWSAuthSecretRef">
  16879. AWSAuthSecretRef
  16880. </a>
  16881. </em>
  16882. </td>
  16883. <td>
  16884. <em>(Optional)</em>
  16885. </td>
  16886. </tr>
  16887. <tr>
  16888. <td>
  16889. <code>jwt</code></br>
  16890. <em>
  16891. <a href="#external-secrets.io/v1beta1.AWSJWTAuth">
  16892. AWSJWTAuth
  16893. </a>
  16894. </em>
  16895. </td>
  16896. <td>
  16897. <em>(Optional)</em>
  16898. </td>
  16899. </tr>
  16900. </tbody>
  16901. </table>
  16902. <h3 id="external-secrets.io/v1beta1.AWSAuthSecretRef">AWSAuthSecretRef
  16903. </h3>
  16904. <p>
  16905. (<em>Appears on:</em>
  16906. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  16907. </p>
  16908. <p>
  16909. <p>AWSAuthSecretRef holds secret references for AWS credentials
  16910. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  16911. </p>
  16912. <table>
  16913. <thead>
  16914. <tr>
  16915. <th>Field</th>
  16916. <th>Description</th>
  16917. </tr>
  16918. </thead>
  16919. <tbody>
  16920. <tr>
  16921. <td>
  16922. <code>accessKeyIDSecretRef</code></br>
  16923. <em>
  16924. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16925. External Secrets meta/v1.SecretKeySelector
  16926. </a>
  16927. </em>
  16928. </td>
  16929. <td>
  16930. <p>The AccessKeyID is used for authentication</p>
  16931. </td>
  16932. </tr>
  16933. <tr>
  16934. <td>
  16935. <code>secretAccessKeySecretRef</code></br>
  16936. <em>
  16937. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16938. External Secrets meta/v1.SecretKeySelector
  16939. </a>
  16940. </em>
  16941. </td>
  16942. <td>
  16943. <p>The SecretAccessKey is used for authentication</p>
  16944. </td>
  16945. </tr>
  16946. <tr>
  16947. <td>
  16948. <code>sessionTokenSecretRef</code></br>
  16949. <em>
  16950. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16951. External Secrets meta/v1.SecretKeySelector
  16952. </a>
  16953. </em>
  16954. </td>
  16955. <td>
  16956. <p>The SessionToken used for authentication
  16957. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  16958. 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>
  16959. </td>
  16960. </tr>
  16961. </tbody>
  16962. </table>
  16963. <h3 id="external-secrets.io/v1beta1.AWSJWTAuth">AWSJWTAuth
  16964. </h3>
  16965. <p>
  16966. (<em>Appears on:</em>
  16967. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  16968. </p>
  16969. <p>
  16970. <p>AWSJWTAuth authenticates against AWS using service account tokens from the Kubernetes cluster.</p>
  16971. </p>
  16972. <table>
  16973. <thead>
  16974. <tr>
  16975. <th>Field</th>
  16976. <th>Description</th>
  16977. </tr>
  16978. </thead>
  16979. <tbody>
  16980. <tr>
  16981. <td>
  16982. <code>serviceAccountRef</code></br>
  16983. <em>
  16984. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  16985. External Secrets meta/v1.ServiceAccountSelector
  16986. </a>
  16987. </em>
  16988. </td>
  16989. <td>
  16990. </td>
  16991. </tr>
  16992. </tbody>
  16993. </table>
  16994. <h3 id="external-secrets.io/v1beta1.AWSProvider">AWSProvider
  16995. </h3>
  16996. <p>
  16997. (<em>Appears on:</em>
  16998. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16999. </p>
  17000. <p>
  17001. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  17002. </p>
  17003. <table>
  17004. <thead>
  17005. <tr>
  17006. <th>Field</th>
  17007. <th>Description</th>
  17008. </tr>
  17009. </thead>
  17010. <tbody>
  17011. <tr>
  17012. <td>
  17013. <code>service</code></br>
  17014. <em>
  17015. <a href="#external-secrets.io/v1beta1.AWSServiceType">
  17016. AWSServiceType
  17017. </a>
  17018. </em>
  17019. </td>
  17020. <td>
  17021. <p>Service defines which service should be used to fetch the secrets</p>
  17022. </td>
  17023. </tr>
  17024. <tr>
  17025. <td>
  17026. <code>auth</code></br>
  17027. <em>
  17028. <a href="#external-secrets.io/v1beta1.AWSAuth">
  17029. AWSAuth
  17030. </a>
  17031. </em>
  17032. </td>
  17033. <td>
  17034. <em>(Optional)</em>
  17035. <p>Auth defines the information necessary to authenticate against AWS
  17036. if not set aws sdk will infer credentials from your environment
  17037. 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>
  17038. </td>
  17039. </tr>
  17040. <tr>
  17041. <td>
  17042. <code>role</code></br>
  17043. <em>
  17044. string
  17045. </em>
  17046. </td>
  17047. <td>
  17048. <em>(Optional)</em>
  17049. <p>Role is a Role ARN which the provider will assume</p>
  17050. </td>
  17051. </tr>
  17052. <tr>
  17053. <td>
  17054. <code>region</code></br>
  17055. <em>
  17056. string
  17057. </em>
  17058. </td>
  17059. <td>
  17060. <p>AWS Region to be used for the provider</p>
  17061. </td>
  17062. </tr>
  17063. <tr>
  17064. <td>
  17065. <code>additionalRoles</code></br>
  17066. <em>
  17067. []string
  17068. </em>
  17069. </td>
  17070. <td>
  17071. <em>(Optional)</em>
  17072. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  17073. </td>
  17074. </tr>
  17075. <tr>
  17076. <td>
  17077. <code>externalID</code></br>
  17078. <em>
  17079. string
  17080. </em>
  17081. </td>
  17082. <td>
  17083. <p>AWS External ID set on assumed IAM roles</p>
  17084. </td>
  17085. </tr>
  17086. <tr>
  17087. <td>
  17088. <code>sessionTags</code></br>
  17089. <em>
  17090. <a href="#external-secrets.io/v1beta1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag">
  17091. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag
  17092. </a>
  17093. </em>
  17094. </td>
  17095. <td>
  17096. <em>(Optional)</em>
  17097. <p>AWS STS assume role session tags</p>
  17098. </td>
  17099. </tr>
  17100. <tr>
  17101. <td>
  17102. <code>secretsManager</code></br>
  17103. <em>
  17104. <a href="#external-secrets.io/v1beta1.SecretsManager">
  17105. SecretsManager
  17106. </a>
  17107. </em>
  17108. </td>
  17109. <td>
  17110. <em>(Optional)</em>
  17111. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  17112. </td>
  17113. </tr>
  17114. <tr>
  17115. <td>
  17116. <code>transitiveTagKeys</code></br>
  17117. <em>
  17118. []*string
  17119. </em>
  17120. </td>
  17121. <td>
  17122. <em>(Optional)</em>
  17123. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  17124. </td>
  17125. </tr>
  17126. <tr>
  17127. <td>
  17128. <code>prefix</code></br>
  17129. <em>
  17130. string
  17131. </em>
  17132. </td>
  17133. <td>
  17134. <em>(Optional)</em>
  17135. <p>Prefix adds a prefix to all retrieved values.</p>
  17136. </td>
  17137. </tr>
  17138. </tbody>
  17139. </table>
  17140. <h3 id="external-secrets.io/v1beta1.AWSServiceType">AWSServiceType
  17141. (<code>string</code> alias)</p></h3>
  17142. <p>
  17143. (<em>Appears on:</em>
  17144. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  17145. </p>
  17146. <p>
  17147. <p>AWSServiceType is an enum that defines the service/API that is used to fetch the secrets.</p>
  17148. </p>
  17149. <table>
  17150. <thead>
  17151. <tr>
  17152. <th>Value</th>
  17153. <th>Description</th>
  17154. </tr>
  17155. </thead>
  17156. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  17157. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  17158. 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>
  17159. </td>
  17160. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  17161. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  17162. 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>
  17163. </td>
  17164. </tr></tbody>
  17165. </table>
  17166. <h3 id="external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth
  17167. </h3>
  17168. <p>
  17169. (<em>Appears on:</em>
  17170. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>)
  17171. </p>
  17172. <p>
  17173. <p>AkeylessAuth defines methods of authentication with Akeyless Vault.</p>
  17174. </p>
  17175. <table>
  17176. <thead>
  17177. <tr>
  17178. <th>Field</th>
  17179. <th>Description</th>
  17180. </tr>
  17181. </thead>
  17182. <tbody>
  17183. <tr>
  17184. <td>
  17185. <code>secretRef</code></br>
  17186. <em>
  17187. <a href="#external-secrets.io/v1beta1.AkeylessAuthSecretRef">
  17188. AkeylessAuthSecretRef
  17189. </a>
  17190. </em>
  17191. </td>
  17192. <td>
  17193. <em>(Optional)</em>
  17194. <p>Reference to a Secret that contains the details
  17195. to authenticate with Akeyless.</p>
  17196. </td>
  17197. </tr>
  17198. <tr>
  17199. <td>
  17200. <code>kubernetesAuth</code></br>
  17201. <em>
  17202. <a href="#external-secrets.io/v1beta1.AkeylessKubernetesAuth">
  17203. AkeylessKubernetesAuth
  17204. </a>
  17205. </em>
  17206. </td>
  17207. <td>
  17208. <em>(Optional)</em>
  17209. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  17210. token stored in the named Secret resource.</p>
  17211. </td>
  17212. </tr>
  17213. </tbody>
  17214. </table>
  17215. <h3 id="external-secrets.io/v1beta1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  17216. </h3>
  17217. <p>
  17218. (<em>Appears on:</em>
  17219. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  17220. </p>
  17221. <p>
  17222. <p>AkeylessAuthSecretRef defines how to authenticate using a secret reference.
  17223. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  17224. </p>
  17225. <table>
  17226. <thead>
  17227. <tr>
  17228. <th>Field</th>
  17229. <th>Description</th>
  17230. </tr>
  17231. </thead>
  17232. <tbody>
  17233. <tr>
  17234. <td>
  17235. <code>accessID</code></br>
  17236. <em>
  17237. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17238. External Secrets meta/v1.SecretKeySelector
  17239. </a>
  17240. </em>
  17241. </td>
  17242. <td>
  17243. <p>The SecretAccessID is used for authentication</p>
  17244. </td>
  17245. </tr>
  17246. <tr>
  17247. <td>
  17248. <code>accessType</code></br>
  17249. <em>
  17250. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17251. External Secrets meta/v1.SecretKeySelector
  17252. </a>
  17253. </em>
  17254. </td>
  17255. <td>
  17256. </td>
  17257. </tr>
  17258. <tr>
  17259. <td>
  17260. <code>accessTypeParam</code></br>
  17261. <em>
  17262. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17263. External Secrets meta/v1.SecretKeySelector
  17264. </a>
  17265. </em>
  17266. </td>
  17267. <td>
  17268. </td>
  17269. </tr>
  17270. </tbody>
  17271. </table>
  17272. <h3 id="external-secrets.io/v1beta1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  17273. </h3>
  17274. <p>
  17275. (<em>Appears on:</em>
  17276. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  17277. </p>
  17278. <p>
  17279. <p>AkeylessKubernetesAuth authenticates with Akeyless using a Kubernetes ServiceAccount token.</p>
  17280. </p>
  17281. <table>
  17282. <thead>
  17283. <tr>
  17284. <th>Field</th>
  17285. <th>Description</th>
  17286. </tr>
  17287. </thead>
  17288. <tbody>
  17289. <tr>
  17290. <td>
  17291. <code>accessID</code></br>
  17292. <em>
  17293. string
  17294. </em>
  17295. </td>
  17296. <td>
  17297. <p>the Akeyless Kubernetes auth-method access-id</p>
  17298. </td>
  17299. </tr>
  17300. <tr>
  17301. <td>
  17302. <code>k8sConfName</code></br>
  17303. <em>
  17304. string
  17305. </em>
  17306. </td>
  17307. <td>
  17308. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  17309. </td>
  17310. </tr>
  17311. <tr>
  17312. <td>
  17313. <code>serviceAccountRef</code></br>
  17314. <em>
  17315. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17316. External Secrets meta/v1.ServiceAccountSelector
  17317. </a>
  17318. </em>
  17319. </td>
  17320. <td>
  17321. <em>(Optional)</em>
  17322. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  17323. If the service account is specified, the service account secret token JWT will be used
  17324. for authenticating with Akeyless. If the service account selector is not supplied,
  17325. the secretRef will be used instead.</p>
  17326. </td>
  17327. </tr>
  17328. <tr>
  17329. <td>
  17330. <code>secretRef</code></br>
  17331. <em>
  17332. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17333. External Secrets meta/v1.SecretKeySelector
  17334. </a>
  17335. </em>
  17336. </td>
  17337. <td>
  17338. <em>(Optional)</em>
  17339. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  17340. for authenticating with Akeyless. If a name is specified without a key,
  17341. <code>token</code> is the default. If one is not specified, the one bound to
  17342. the controller will be used.</p>
  17343. </td>
  17344. </tr>
  17345. </tbody>
  17346. </table>
  17347. <h3 id="external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider
  17348. </h3>
  17349. <p>
  17350. (<em>Appears on:</em>
  17351. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17352. </p>
  17353. <p>
  17354. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  17355. </p>
  17356. <table>
  17357. <thead>
  17358. <tr>
  17359. <th>Field</th>
  17360. <th>Description</th>
  17361. </tr>
  17362. </thead>
  17363. <tbody>
  17364. <tr>
  17365. <td>
  17366. <code>akeylessGWApiURL</code></br>
  17367. <em>
  17368. string
  17369. </em>
  17370. </td>
  17371. <td>
  17372. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  17373. </td>
  17374. </tr>
  17375. <tr>
  17376. <td>
  17377. <code>authSecretRef</code></br>
  17378. <em>
  17379. <a href="#external-secrets.io/v1beta1.AkeylessAuth">
  17380. AkeylessAuth
  17381. </a>
  17382. </em>
  17383. </td>
  17384. <td>
  17385. <p>Auth configures how the operator authenticates with Akeyless.</p>
  17386. </td>
  17387. </tr>
  17388. <tr>
  17389. <td>
  17390. <code>caBundle</code></br>
  17391. <em>
  17392. []byte
  17393. </em>
  17394. </td>
  17395. <td>
  17396. <em>(Optional)</em>
  17397. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  17398. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  17399. are used to validate the TLS connection.</p>
  17400. </td>
  17401. </tr>
  17402. <tr>
  17403. <td>
  17404. <code>caProvider</code></br>
  17405. <em>
  17406. <a href="#external-secrets.io/v1beta1.CAProvider">
  17407. CAProvider
  17408. </a>
  17409. </em>
  17410. </td>
  17411. <td>
  17412. <em>(Optional)</em>
  17413. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  17414. </td>
  17415. </tr>
  17416. </tbody>
  17417. </table>
  17418. <h3 id="external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth
  17419. </h3>
  17420. <p>
  17421. (<em>Appears on:</em>
  17422. <a href="#external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider</a>)
  17423. </p>
  17424. <p>
  17425. <p>AlibabaAuth contains a secretRef for credentials.</p>
  17426. </p>
  17427. <table>
  17428. <thead>
  17429. <tr>
  17430. <th>Field</th>
  17431. <th>Description</th>
  17432. </tr>
  17433. </thead>
  17434. <tbody>
  17435. <tr>
  17436. <td>
  17437. <code>secretRef</code></br>
  17438. <em>
  17439. <a href="#external-secrets.io/v1beta1.AlibabaAuthSecretRef">
  17440. AlibabaAuthSecretRef
  17441. </a>
  17442. </em>
  17443. </td>
  17444. <td>
  17445. <em>(Optional)</em>
  17446. </td>
  17447. </tr>
  17448. <tr>
  17449. <td>
  17450. <code>rrsa</code></br>
  17451. <em>
  17452. <a href="#external-secrets.io/v1beta1.AlibabaRRSAAuth">
  17453. AlibabaRRSAAuth
  17454. </a>
  17455. </em>
  17456. </td>
  17457. <td>
  17458. <em>(Optional)</em>
  17459. </td>
  17460. </tr>
  17461. </tbody>
  17462. </table>
  17463. <h3 id="external-secrets.io/v1beta1.AlibabaAuthSecretRef">AlibabaAuthSecretRef
  17464. </h3>
  17465. <p>
  17466. (<em>Appears on:</em>
  17467. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  17468. </p>
  17469. <p>
  17470. <p>AlibabaAuthSecretRef holds secret references for Alibaba credentials.</p>
  17471. </p>
  17472. <table>
  17473. <thead>
  17474. <tr>
  17475. <th>Field</th>
  17476. <th>Description</th>
  17477. </tr>
  17478. </thead>
  17479. <tbody>
  17480. <tr>
  17481. <td>
  17482. <code>accessKeyIDSecretRef</code></br>
  17483. <em>
  17484. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17485. External Secrets meta/v1.SecretKeySelector
  17486. </a>
  17487. </em>
  17488. </td>
  17489. <td>
  17490. <p>The AccessKeyID is used for authentication</p>
  17491. </td>
  17492. </tr>
  17493. <tr>
  17494. <td>
  17495. <code>accessKeySecretSecretRef</code></br>
  17496. <em>
  17497. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17498. External Secrets meta/v1.SecretKeySelector
  17499. </a>
  17500. </em>
  17501. </td>
  17502. <td>
  17503. <p>The AccessKeySecret is used for authentication</p>
  17504. </td>
  17505. </tr>
  17506. </tbody>
  17507. </table>
  17508. <h3 id="external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider
  17509. </h3>
  17510. <p>
  17511. (<em>Appears on:</em>
  17512. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17513. </p>
  17514. <p>
  17515. <p>AlibabaProvider configures a store to sync secrets using the Alibaba Secret Manager provider.</p>
  17516. </p>
  17517. <table>
  17518. <thead>
  17519. <tr>
  17520. <th>Field</th>
  17521. <th>Description</th>
  17522. </tr>
  17523. </thead>
  17524. <tbody>
  17525. <tr>
  17526. <td>
  17527. <code>auth</code></br>
  17528. <em>
  17529. <a href="#external-secrets.io/v1beta1.AlibabaAuth">
  17530. AlibabaAuth
  17531. </a>
  17532. </em>
  17533. </td>
  17534. <td>
  17535. </td>
  17536. </tr>
  17537. <tr>
  17538. <td>
  17539. <code>regionID</code></br>
  17540. <em>
  17541. string
  17542. </em>
  17543. </td>
  17544. <td>
  17545. <p>Alibaba Region to be used for the provider</p>
  17546. </td>
  17547. </tr>
  17548. </tbody>
  17549. </table>
  17550. <h3 id="external-secrets.io/v1beta1.AlibabaRRSAAuth">AlibabaRRSAAuth
  17551. </h3>
  17552. <p>
  17553. (<em>Appears on:</em>
  17554. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  17555. </p>
  17556. <p>
  17557. <p>AlibabaRRSAAuth authenticates against Alibaba using RRSA (Resource-oriented RAM-based Service Authentication).</p>
  17558. </p>
  17559. <table>
  17560. <thead>
  17561. <tr>
  17562. <th>Field</th>
  17563. <th>Description</th>
  17564. </tr>
  17565. </thead>
  17566. <tbody>
  17567. <tr>
  17568. <td>
  17569. <code>oidcProviderArn</code></br>
  17570. <em>
  17571. string
  17572. </em>
  17573. </td>
  17574. <td>
  17575. </td>
  17576. </tr>
  17577. <tr>
  17578. <td>
  17579. <code>oidcTokenFilePath</code></br>
  17580. <em>
  17581. string
  17582. </em>
  17583. </td>
  17584. <td>
  17585. </td>
  17586. </tr>
  17587. <tr>
  17588. <td>
  17589. <code>roleArn</code></br>
  17590. <em>
  17591. string
  17592. </em>
  17593. </td>
  17594. <td>
  17595. </td>
  17596. </tr>
  17597. <tr>
  17598. <td>
  17599. <code>sessionName</code></br>
  17600. <em>
  17601. string
  17602. </em>
  17603. </td>
  17604. <td>
  17605. </td>
  17606. </tr>
  17607. </tbody>
  17608. </table>
  17609. <h3 id="external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol
  17610. </h3>
  17611. <p>
  17612. (<em>Appears on:</em>
  17613. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  17614. </p>
  17615. <p>
  17616. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  17617. </p>
  17618. <table>
  17619. <thead>
  17620. <tr>
  17621. <th>Field</th>
  17622. <th>Description</th>
  17623. </tr>
  17624. </thead>
  17625. <tbody>
  17626. <tr>
  17627. <td>
  17628. <code>ntlm</code></br>
  17629. <em>
  17630. <a href="#external-secrets.io/v1beta1.NTLMProtocol">
  17631. NTLMProtocol
  17632. </a>
  17633. </em>
  17634. </td>
  17635. <td>
  17636. <em>(Optional)</em>
  17637. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  17638. </td>
  17639. </tr>
  17640. </tbody>
  17641. </table>
  17642. <h3 id="external-secrets.io/v1beta1.AzureAuthType">AzureAuthType
  17643. (<code>string</code> alias)</p></h3>
  17644. <p>
  17645. (<em>Appears on:</em>
  17646. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17647. </p>
  17648. <p>
  17649. <p>AzureAuthType describes how to authenticate to the Azure Keyvault.
  17650. Only one of the following auth types may be specified.
  17651. If none of the following auth type is specified, the default one
  17652. is ServicePrincipal.</p>
  17653. </p>
  17654. <table>
  17655. <thead>
  17656. <tr>
  17657. <th>Value</th>
  17658. <th>Description</th>
  17659. </tr>
  17660. </thead>
  17661. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  17662. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  17663. </td>
  17664. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  17665. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  17666. </td>
  17667. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  17668. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  17669. </td>
  17670. </tr></tbody>
  17671. </table>
  17672. <h3 id="external-secrets.io/v1beta1.AzureEnvironmentType">AzureEnvironmentType
  17673. (<code>string</code> alias)</p></h3>
  17674. <p>
  17675. (<em>Appears on:</em>
  17676. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17677. </p>
  17678. <p>
  17679. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  17680. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  17681. 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>
  17682. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  17683. </p>
  17684. <table>
  17685. <thead>
  17686. <tr>
  17687. <th>Value</th>
  17688. <th>Description</th>
  17689. </tr>
  17690. </thead>
  17691. <tbody><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  17692. <td><p>AzureEnvironmentChinaCloud represents the Azure China cloud environment.</p>
  17693. </td>
  17694. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  17695. <td><p>AzureEnvironmentGermanCloud represents the Azure German cloud environment.</p>
  17696. </td>
  17697. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  17698. <td><p>AzureEnvironmentPublicCloud represents the Azure public cloud environment.</p>
  17699. </td>
  17700. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  17701. <td><p>AzureEnvironmentUSGovernmentCloud represents the Azure US government cloud environment.</p>
  17702. </td>
  17703. </tr></tbody>
  17704. </table>
  17705. <h3 id="external-secrets.io/v1beta1.AzureKVAuth">AzureKVAuth
  17706. </h3>
  17707. <p>
  17708. (<em>Appears on:</em>
  17709. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17710. </p>
  17711. <p>
  17712. <p>AzureKVAuth defines configuration for authentication with Azure Key Vault.</p>
  17713. </p>
  17714. <table>
  17715. <thead>
  17716. <tr>
  17717. <th>Field</th>
  17718. <th>Description</th>
  17719. </tr>
  17720. </thead>
  17721. <tbody>
  17722. <tr>
  17723. <td>
  17724. <code>clientId</code></br>
  17725. <em>
  17726. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17727. External Secrets meta/v1.SecretKeySelector
  17728. </a>
  17729. </em>
  17730. </td>
  17731. <td>
  17732. <em>(Optional)</em>
  17733. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  17734. </td>
  17735. </tr>
  17736. <tr>
  17737. <td>
  17738. <code>tenantId</code></br>
  17739. <em>
  17740. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17741. External Secrets meta/v1.SecretKeySelector
  17742. </a>
  17743. </em>
  17744. </td>
  17745. <td>
  17746. <em>(Optional)</em>
  17747. <p>The Azure tenantId of the managed identity used for authentication.</p>
  17748. </td>
  17749. </tr>
  17750. <tr>
  17751. <td>
  17752. <code>clientSecret</code></br>
  17753. <em>
  17754. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17755. External Secrets meta/v1.SecretKeySelector
  17756. </a>
  17757. </em>
  17758. </td>
  17759. <td>
  17760. <em>(Optional)</em>
  17761. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  17762. </td>
  17763. </tr>
  17764. <tr>
  17765. <td>
  17766. <code>clientCertificate</code></br>
  17767. <em>
  17768. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17769. External Secrets meta/v1.SecretKeySelector
  17770. </a>
  17771. </em>
  17772. </td>
  17773. <td>
  17774. <em>(Optional)</em>
  17775. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  17776. </td>
  17777. </tr>
  17778. </tbody>
  17779. </table>
  17780. <h3 id="external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider
  17781. </h3>
  17782. <p>
  17783. (<em>Appears on:</em>
  17784. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17785. </p>
  17786. <p>
  17787. <p>AzureKVProvider configures a store to sync secrets using Azure Key Vault.</p>
  17788. </p>
  17789. <table>
  17790. <thead>
  17791. <tr>
  17792. <th>Field</th>
  17793. <th>Description</th>
  17794. </tr>
  17795. </thead>
  17796. <tbody>
  17797. <tr>
  17798. <td>
  17799. <code>authType</code></br>
  17800. <em>
  17801. <a href="#external-secrets.io/v1beta1.AzureAuthType">
  17802. AzureAuthType
  17803. </a>
  17804. </em>
  17805. </td>
  17806. <td>
  17807. <em>(Optional)</em>
  17808. <p>Auth type defines how to authenticate to the keyvault service.
  17809. Valid values are:
  17810. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  17811. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)</p>
  17812. </td>
  17813. </tr>
  17814. <tr>
  17815. <td>
  17816. <code>vaultUrl</code></br>
  17817. <em>
  17818. string
  17819. </em>
  17820. </td>
  17821. <td>
  17822. <p>Vault Url from which the secrets to be fetched from.</p>
  17823. </td>
  17824. </tr>
  17825. <tr>
  17826. <td>
  17827. <code>tenantId</code></br>
  17828. <em>
  17829. string
  17830. </em>
  17831. </td>
  17832. <td>
  17833. <em>(Optional)</em>
  17834. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  17835. </td>
  17836. </tr>
  17837. <tr>
  17838. <td>
  17839. <code>environmentType</code></br>
  17840. <em>
  17841. <a href="#external-secrets.io/v1beta1.AzureEnvironmentType">
  17842. AzureEnvironmentType
  17843. </a>
  17844. </em>
  17845. </td>
  17846. <td>
  17847. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  17848. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  17849. 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>
  17850. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  17851. </td>
  17852. </tr>
  17853. <tr>
  17854. <td>
  17855. <code>authSecretRef</code></br>
  17856. <em>
  17857. <a href="#external-secrets.io/v1beta1.AzureKVAuth">
  17858. AzureKVAuth
  17859. </a>
  17860. </em>
  17861. </td>
  17862. <td>
  17863. <em>(Optional)</em>
  17864. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  17865. </td>
  17866. </tr>
  17867. <tr>
  17868. <td>
  17869. <code>serviceAccountRef</code></br>
  17870. <em>
  17871. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17872. External Secrets meta/v1.ServiceAccountSelector
  17873. </a>
  17874. </em>
  17875. </td>
  17876. <td>
  17877. <em>(Optional)</em>
  17878. <p>ServiceAccountRef specified the service account
  17879. that should be used when authenticating with WorkloadIdentity.</p>
  17880. </td>
  17881. </tr>
  17882. <tr>
  17883. <td>
  17884. <code>identityId</code></br>
  17885. <em>
  17886. string
  17887. </em>
  17888. </td>
  17889. <td>
  17890. <em>(Optional)</em>
  17891. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  17892. </td>
  17893. </tr>
  17894. </tbody>
  17895. </table>
  17896. <h3 id="external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  17897. </h3>
  17898. <p>
  17899. (<em>Appears on:</em>
  17900. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth</a>)
  17901. </p>
  17902. <p>
  17903. <p>BeyondTrustProviderSecretRef defines a reference to a secret containing credentials for the BeyondTrust provider.</p>
  17904. </p>
  17905. <table>
  17906. <thead>
  17907. <tr>
  17908. <th>Field</th>
  17909. <th>Description</th>
  17910. </tr>
  17911. </thead>
  17912. <tbody>
  17913. <tr>
  17914. <td>
  17915. <code>value</code></br>
  17916. <em>
  17917. string
  17918. </em>
  17919. </td>
  17920. <td>
  17921. <em>(Optional)</em>
  17922. <p>Value can be specified directly to set a value without using a secret.</p>
  17923. </td>
  17924. </tr>
  17925. <tr>
  17926. <td>
  17927. <code>secretRef</code></br>
  17928. <em>
  17929. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17930. External Secrets meta/v1.SecretKeySelector
  17931. </a>
  17932. </em>
  17933. </td>
  17934. <td>
  17935. <em>(Optional)</em>
  17936. <p>SecretRef references a key in a secret that will be used as value.</p>
  17937. </td>
  17938. </tr>
  17939. </tbody>
  17940. </table>
  17941. <h3 id="external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth
  17942. </h3>
  17943. <p>
  17944. (<em>Appears on:</em>
  17945. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  17946. </p>
  17947. <p>
  17948. <p>BeyondtrustAuth configures authentication for BeyondTrust Password Safe.</p>
  17949. </p>
  17950. <table>
  17951. <thead>
  17952. <tr>
  17953. <th>Field</th>
  17954. <th>Description</th>
  17955. </tr>
  17956. </thead>
  17957. <tbody>
  17958. <tr>
  17959. <td>
  17960. <code>apiKey</code></br>
  17961. <em>
  17962. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17963. BeyondTrustProviderSecretRef
  17964. </a>
  17965. </em>
  17966. </td>
  17967. <td>
  17968. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  17969. </td>
  17970. </tr>
  17971. <tr>
  17972. <td>
  17973. <code>clientId</code></br>
  17974. <em>
  17975. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17976. BeyondTrustProviderSecretRef
  17977. </a>
  17978. </em>
  17979. </td>
  17980. <td>
  17981. <p>ClientID is the API OAuth Client ID.</p>
  17982. </td>
  17983. </tr>
  17984. <tr>
  17985. <td>
  17986. <code>clientSecret</code></br>
  17987. <em>
  17988. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17989. BeyondTrustProviderSecretRef
  17990. </a>
  17991. </em>
  17992. </td>
  17993. <td>
  17994. <p>ClientSecret is the API OAuth Client Secret.</p>
  17995. </td>
  17996. </tr>
  17997. <tr>
  17998. <td>
  17999. <code>certificate</code></br>
  18000. <em>
  18001. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  18002. BeyondTrustProviderSecretRef
  18003. </a>
  18004. </em>
  18005. </td>
  18006. <td>
  18007. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  18008. </td>
  18009. </tr>
  18010. <tr>
  18011. <td>
  18012. <code>certificateKey</code></br>
  18013. <em>
  18014. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  18015. BeyondTrustProviderSecretRef
  18016. </a>
  18017. </em>
  18018. </td>
  18019. <td>
  18020. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  18021. </td>
  18022. </tr>
  18023. </tbody>
  18024. </table>
  18025. <h3 id="external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider
  18026. </h3>
  18027. <p>
  18028. (<em>Appears on:</em>
  18029. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18030. </p>
  18031. <p>
  18032. <p>BeyondtrustProvider defines configuration for the BeyondTrust Password Safe provider.</p>
  18033. </p>
  18034. <table>
  18035. <thead>
  18036. <tr>
  18037. <th>Field</th>
  18038. <th>Description</th>
  18039. </tr>
  18040. </thead>
  18041. <tbody>
  18042. <tr>
  18043. <td>
  18044. <code>auth</code></br>
  18045. <em>
  18046. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">
  18047. BeyondtrustAuth
  18048. </a>
  18049. </em>
  18050. </td>
  18051. <td>
  18052. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  18053. </td>
  18054. </tr>
  18055. <tr>
  18056. <td>
  18057. <code>server</code></br>
  18058. <em>
  18059. <a href="#external-secrets.io/v1beta1.BeyondtrustServer">
  18060. BeyondtrustServer
  18061. </a>
  18062. </em>
  18063. </td>
  18064. <td>
  18065. <p>Auth configures how API server works.</p>
  18066. </td>
  18067. </tr>
  18068. </tbody>
  18069. </table>
  18070. <h3 id="external-secrets.io/v1beta1.BeyondtrustServer">BeyondtrustServer
  18071. </h3>
  18072. <p>
  18073. (<em>Appears on:</em>
  18074. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  18075. </p>
  18076. <p>
  18077. <p>BeyondtrustServer defines configuration for connecting to BeyondTrust Password Safe server.</p>
  18078. </p>
  18079. <table>
  18080. <thead>
  18081. <tr>
  18082. <th>Field</th>
  18083. <th>Description</th>
  18084. </tr>
  18085. </thead>
  18086. <tbody>
  18087. <tr>
  18088. <td>
  18089. <code>apiUrl</code></br>
  18090. <em>
  18091. string
  18092. </em>
  18093. </td>
  18094. <td>
  18095. </td>
  18096. </tr>
  18097. <tr>
  18098. <td>
  18099. <code>apiVersion</code></br>
  18100. <em>
  18101. string
  18102. </em>
  18103. </td>
  18104. <td>
  18105. </td>
  18106. </tr>
  18107. <tr>
  18108. <td>
  18109. <code>retrievalType</code></br>
  18110. <em>
  18111. string
  18112. </em>
  18113. </td>
  18114. <td>
  18115. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  18116. </td>
  18117. </tr>
  18118. <tr>
  18119. <td>
  18120. <code>separator</code></br>
  18121. <em>
  18122. string
  18123. </em>
  18124. </td>
  18125. <td>
  18126. <p>A character that separates the folder names.</p>
  18127. </td>
  18128. </tr>
  18129. <tr>
  18130. <td>
  18131. <code>decrypt</code></br>
  18132. <em>
  18133. bool
  18134. </em>
  18135. </td>
  18136. <td>
  18137. <em>(Optional)</em>
  18138. <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>
  18139. </td>
  18140. </tr>
  18141. <tr>
  18142. <td>
  18143. <code>verifyCA</code></br>
  18144. <em>
  18145. bool
  18146. </em>
  18147. </td>
  18148. <td>
  18149. </td>
  18150. </tr>
  18151. <tr>
  18152. <td>
  18153. <code>clientTimeOutSeconds</code></br>
  18154. <em>
  18155. int
  18156. </em>
  18157. </td>
  18158. <td>
  18159. <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>
  18160. </td>
  18161. </tr>
  18162. </tbody>
  18163. </table>
  18164. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  18165. </h3>
  18166. <p>
  18167. (<em>Appears on:</em>
  18168. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  18169. </p>
  18170. <p>
  18171. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  18172. </p>
  18173. <table>
  18174. <thead>
  18175. <tr>
  18176. <th>Field</th>
  18177. <th>Description</th>
  18178. </tr>
  18179. </thead>
  18180. <tbody>
  18181. <tr>
  18182. <td>
  18183. <code>secretRef</code></br>
  18184. <em>
  18185. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">
  18186. BitwardenSecretsManagerSecretRef
  18187. </a>
  18188. </em>
  18189. </td>
  18190. <td>
  18191. </td>
  18192. </tr>
  18193. </tbody>
  18194. </table>
  18195. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  18196. </h3>
  18197. <p>
  18198. (<em>Appears on:</em>
  18199. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18200. </p>
  18201. <p>
  18202. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  18203. </p>
  18204. <table>
  18205. <thead>
  18206. <tr>
  18207. <th>Field</th>
  18208. <th>Description</th>
  18209. </tr>
  18210. </thead>
  18211. <tbody>
  18212. <tr>
  18213. <td>
  18214. <code>apiURL</code></br>
  18215. <em>
  18216. string
  18217. </em>
  18218. </td>
  18219. <td>
  18220. </td>
  18221. </tr>
  18222. <tr>
  18223. <td>
  18224. <code>identityURL</code></br>
  18225. <em>
  18226. string
  18227. </em>
  18228. </td>
  18229. <td>
  18230. </td>
  18231. </tr>
  18232. <tr>
  18233. <td>
  18234. <code>bitwardenServerSDKURL</code></br>
  18235. <em>
  18236. string
  18237. </em>
  18238. </td>
  18239. <td>
  18240. </td>
  18241. </tr>
  18242. <tr>
  18243. <td>
  18244. <code>caBundle</code></br>
  18245. <em>
  18246. string
  18247. </em>
  18248. </td>
  18249. <td>
  18250. <em>(Optional)</em>
  18251. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  18252. can be performed.</p>
  18253. </td>
  18254. </tr>
  18255. <tr>
  18256. <td>
  18257. <code>caProvider</code></br>
  18258. <em>
  18259. <a href="#external-secrets.io/v1beta1.CAProvider">
  18260. CAProvider
  18261. </a>
  18262. </em>
  18263. </td>
  18264. <td>
  18265. <em>(Optional)</em>
  18266. <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>
  18267. </td>
  18268. </tr>
  18269. <tr>
  18270. <td>
  18271. <code>organizationID</code></br>
  18272. <em>
  18273. string
  18274. </em>
  18275. </td>
  18276. <td>
  18277. <p>OrganizationID determines which organization this secret store manages.</p>
  18278. </td>
  18279. </tr>
  18280. <tr>
  18281. <td>
  18282. <code>projectID</code></br>
  18283. <em>
  18284. string
  18285. </em>
  18286. </td>
  18287. <td>
  18288. <p>ProjectID determines which project this secret store manages.</p>
  18289. </td>
  18290. </tr>
  18291. <tr>
  18292. <td>
  18293. <code>auth</code></br>
  18294. <em>
  18295. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">
  18296. BitwardenSecretsManagerAuth
  18297. </a>
  18298. </em>
  18299. </td>
  18300. <td>
  18301. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  18302. Make sure that the token being used has permissions on the given secret.</p>
  18303. </td>
  18304. </tr>
  18305. </tbody>
  18306. </table>
  18307. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  18308. </h3>
  18309. <p>
  18310. (<em>Appears on:</em>
  18311. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  18312. </p>
  18313. <p>
  18314. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  18315. </p>
  18316. <table>
  18317. <thead>
  18318. <tr>
  18319. <th>Field</th>
  18320. <th>Description</th>
  18321. </tr>
  18322. </thead>
  18323. <tbody>
  18324. <tr>
  18325. <td>
  18326. <code>credentials</code></br>
  18327. <em>
  18328. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18329. External Secrets meta/v1.SecretKeySelector
  18330. </a>
  18331. </em>
  18332. </td>
  18333. <td>
  18334. <p>AccessToken used for the bitwarden instance.</p>
  18335. </td>
  18336. </tr>
  18337. </tbody>
  18338. </table>
  18339. <h3 id="external-secrets.io/v1beta1.CAProvider">CAProvider
  18340. </h3>
  18341. <p>
  18342. (<em>Appears on:</em>
  18343. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>,
  18344. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  18345. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>,
  18346. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>,
  18347. <a href="#external-secrets.io/v1beta1.KubernetesServer">KubernetesServer</a>,
  18348. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  18349. </p>
  18350. <p>
  18351. <p>CAProvider provides custom certificate authority (CA) certificates
  18352. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  18353. that contains a PEM-encoded certificate.</p>
  18354. </p>
  18355. <table>
  18356. <thead>
  18357. <tr>
  18358. <th>Field</th>
  18359. <th>Description</th>
  18360. </tr>
  18361. </thead>
  18362. <tbody>
  18363. <tr>
  18364. <td>
  18365. <code>type</code></br>
  18366. <em>
  18367. <a href="#external-secrets.io/v1beta1.CAProviderType">
  18368. CAProviderType
  18369. </a>
  18370. </em>
  18371. </td>
  18372. <td>
  18373. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  18374. </td>
  18375. </tr>
  18376. <tr>
  18377. <td>
  18378. <code>name</code></br>
  18379. <em>
  18380. string
  18381. </em>
  18382. </td>
  18383. <td>
  18384. <p>The name of the object located at the provider type.</p>
  18385. </td>
  18386. </tr>
  18387. <tr>
  18388. <td>
  18389. <code>key</code></br>
  18390. <em>
  18391. string
  18392. </em>
  18393. </td>
  18394. <td>
  18395. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  18396. </td>
  18397. </tr>
  18398. <tr>
  18399. <td>
  18400. <code>namespace</code></br>
  18401. <em>
  18402. string
  18403. </em>
  18404. </td>
  18405. <td>
  18406. <em>(Optional)</em>
  18407. <p>The namespace the Provider type is in.
  18408. Can only be defined when used in a ClusterSecretStore.</p>
  18409. </td>
  18410. </tr>
  18411. </tbody>
  18412. </table>
  18413. <h3 id="external-secrets.io/v1beta1.CAProviderType">CAProviderType
  18414. (<code>string</code> alias)</p></h3>
  18415. <p>
  18416. (<em>Appears on:</em>
  18417. <a href="#external-secrets.io/v1beta1.CAProvider">CAProvider</a>)
  18418. </p>
  18419. <p>
  18420. <p>CAProviderType defines the type of provider to use for CA certificates.</p>
  18421. </p>
  18422. <table>
  18423. <thead>
  18424. <tr>
  18425. <th>Value</th>
  18426. <th>Description</th>
  18427. </tr>
  18428. </thead>
  18429. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  18430. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  18431. </td>
  18432. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  18433. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  18434. </td>
  18435. </tr></tbody>
  18436. </table>
  18437. <h3 id="external-secrets.io/v1beta1.CSMAuth">CSMAuth
  18438. </h3>
  18439. <p>
  18440. (<em>Appears on:</em>
  18441. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider</a>)
  18442. </p>
  18443. <p>
  18444. <p>CSMAuth contains a secretRef for credentials.</p>
  18445. </p>
  18446. <table>
  18447. <thead>
  18448. <tr>
  18449. <th>Field</th>
  18450. <th>Description</th>
  18451. </tr>
  18452. </thead>
  18453. <tbody>
  18454. <tr>
  18455. <td>
  18456. <code>secretRef</code></br>
  18457. <em>
  18458. <a href="#external-secrets.io/v1beta1.CSMAuthSecretRef">
  18459. CSMAuthSecretRef
  18460. </a>
  18461. </em>
  18462. </td>
  18463. <td>
  18464. <em>(Optional)</em>
  18465. </td>
  18466. </tr>
  18467. </tbody>
  18468. </table>
  18469. <h3 id="external-secrets.io/v1beta1.CSMAuthSecretRef">CSMAuthSecretRef
  18470. </h3>
  18471. <p>
  18472. (<em>Appears on:</em>
  18473. <a href="#external-secrets.io/v1beta1.CSMAuth">CSMAuth</a>)
  18474. </p>
  18475. <p>
  18476. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  18477. </p>
  18478. <table>
  18479. <thead>
  18480. <tr>
  18481. <th>Field</th>
  18482. <th>Description</th>
  18483. </tr>
  18484. </thead>
  18485. <tbody>
  18486. <tr>
  18487. <td>
  18488. <code>accessKeyIDSecretRef</code></br>
  18489. <em>
  18490. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18491. External Secrets meta/v1.SecretKeySelector
  18492. </a>
  18493. </em>
  18494. </td>
  18495. <td>
  18496. <p>The AccessKeyID is used for authentication</p>
  18497. </td>
  18498. </tr>
  18499. <tr>
  18500. <td>
  18501. <code>accessKeySecretSecretRef</code></br>
  18502. <em>
  18503. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18504. External Secrets meta/v1.SecretKeySelector
  18505. </a>
  18506. </em>
  18507. </td>
  18508. <td>
  18509. <p>The AccessKeySecret is used for authentication</p>
  18510. </td>
  18511. </tr>
  18512. </tbody>
  18513. </table>
  18514. <h3 id="external-secrets.io/v1beta1.CertAuth">CertAuth
  18515. </h3>
  18516. <p>
  18517. (<em>Appears on:</em>
  18518. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  18519. </p>
  18520. <p>
  18521. <p>CertAuth defines certificate-based authentication for the Kubernetes provider.</p>
  18522. </p>
  18523. <table>
  18524. <thead>
  18525. <tr>
  18526. <th>Field</th>
  18527. <th>Description</th>
  18528. </tr>
  18529. </thead>
  18530. <tbody>
  18531. <tr>
  18532. <td>
  18533. <code>clientCert</code></br>
  18534. <em>
  18535. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18536. External Secrets meta/v1.SecretKeySelector
  18537. </a>
  18538. </em>
  18539. </td>
  18540. <td>
  18541. </td>
  18542. </tr>
  18543. <tr>
  18544. <td>
  18545. <code>clientKey</code></br>
  18546. <em>
  18547. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18548. External Secrets meta/v1.SecretKeySelector
  18549. </a>
  18550. </em>
  18551. </td>
  18552. <td>
  18553. </td>
  18554. </tr>
  18555. </tbody>
  18556. </table>
  18557. <h3 id="external-secrets.io/v1beta1.ChefAuth">ChefAuth
  18558. </h3>
  18559. <p>
  18560. (<em>Appears on:</em>
  18561. <a href="#external-secrets.io/v1beta1.ChefProvider">ChefProvider</a>)
  18562. </p>
  18563. <p>
  18564. <p>ChefAuth contains a secretRef for credentials.</p>
  18565. </p>
  18566. <table>
  18567. <thead>
  18568. <tr>
  18569. <th>Field</th>
  18570. <th>Description</th>
  18571. </tr>
  18572. </thead>
  18573. <tbody>
  18574. <tr>
  18575. <td>
  18576. <code>secretRef</code></br>
  18577. <em>
  18578. <a href="#external-secrets.io/v1beta1.ChefAuthSecretRef">
  18579. ChefAuthSecretRef
  18580. </a>
  18581. </em>
  18582. </td>
  18583. <td>
  18584. </td>
  18585. </tr>
  18586. </tbody>
  18587. </table>
  18588. <h3 id="external-secrets.io/v1beta1.ChefAuthSecretRef">ChefAuthSecretRef
  18589. </h3>
  18590. <p>
  18591. (<em>Appears on:</em>
  18592. <a href="#external-secrets.io/v1beta1.ChefAuth">ChefAuth</a>)
  18593. </p>
  18594. <p>
  18595. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  18596. </p>
  18597. <table>
  18598. <thead>
  18599. <tr>
  18600. <th>Field</th>
  18601. <th>Description</th>
  18602. </tr>
  18603. </thead>
  18604. <tbody>
  18605. <tr>
  18606. <td>
  18607. <code>privateKeySecretRef</code></br>
  18608. <em>
  18609. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18610. External Secrets meta/v1.SecretKeySelector
  18611. </a>
  18612. </em>
  18613. </td>
  18614. <td>
  18615. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  18616. </td>
  18617. </tr>
  18618. </tbody>
  18619. </table>
  18620. <h3 id="external-secrets.io/v1beta1.ChefProvider">ChefProvider
  18621. </h3>
  18622. <p>
  18623. (<em>Appears on:</em>
  18624. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18625. </p>
  18626. <p>
  18627. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  18628. </p>
  18629. <table>
  18630. <thead>
  18631. <tr>
  18632. <th>Field</th>
  18633. <th>Description</th>
  18634. </tr>
  18635. </thead>
  18636. <tbody>
  18637. <tr>
  18638. <td>
  18639. <code>auth</code></br>
  18640. <em>
  18641. <a href="#external-secrets.io/v1beta1.ChefAuth">
  18642. ChefAuth
  18643. </a>
  18644. </em>
  18645. </td>
  18646. <td>
  18647. <p>Auth defines the information necessary to authenticate against chef Server</p>
  18648. </td>
  18649. </tr>
  18650. <tr>
  18651. <td>
  18652. <code>username</code></br>
  18653. <em>
  18654. string
  18655. </em>
  18656. </td>
  18657. <td>
  18658. <p>UserName should be the user ID on the chef server</p>
  18659. </td>
  18660. </tr>
  18661. <tr>
  18662. <td>
  18663. <code>serverUrl</code></br>
  18664. <em>
  18665. string
  18666. </em>
  18667. </td>
  18668. <td>
  18669. <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>
  18670. </td>
  18671. </tr>
  18672. </tbody>
  18673. </table>
  18674. <h3 id="external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider
  18675. </h3>
  18676. <p>
  18677. (<em>Appears on:</em>
  18678. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18679. </p>
  18680. <p>
  18681. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  18682. </p>
  18683. <table>
  18684. <thead>
  18685. <tr>
  18686. <th>Field</th>
  18687. <th>Description</th>
  18688. </tr>
  18689. </thead>
  18690. <tbody>
  18691. <tr>
  18692. <td>
  18693. <code>auth</code></br>
  18694. <em>
  18695. <a href="#external-secrets.io/v1beta1.CSMAuth">
  18696. CSMAuth
  18697. </a>
  18698. </em>
  18699. </td>
  18700. <td>
  18701. </td>
  18702. </tr>
  18703. <tr>
  18704. <td>
  18705. <code>projectID</code></br>
  18706. <em>
  18707. string
  18708. </em>
  18709. </td>
  18710. <td>
  18711. <p>ProjectID is the project, which the secrets are stored in.</p>
  18712. </td>
  18713. </tr>
  18714. </tbody>
  18715. </table>
  18716. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret
  18717. </h3>
  18718. <p>
  18719. <p>ClusterExternalSecret is the schema for the clusterexternalsecrets API.</p>
  18720. </p>
  18721. <table>
  18722. <thead>
  18723. <tr>
  18724. <th>Field</th>
  18725. <th>Description</th>
  18726. </tr>
  18727. </thead>
  18728. <tbody>
  18729. <tr>
  18730. <td>
  18731. <code>metadata</code></br>
  18732. <em>
  18733. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  18734. Kubernetes meta/v1.ObjectMeta
  18735. </a>
  18736. </em>
  18737. </td>
  18738. <td>
  18739. Refer to the Kubernetes API documentation for the fields of the
  18740. <code>metadata</code> field.
  18741. </td>
  18742. </tr>
  18743. <tr>
  18744. <td>
  18745. <code>spec</code></br>
  18746. <em>
  18747. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">
  18748. ClusterExternalSecretSpec
  18749. </a>
  18750. </em>
  18751. </td>
  18752. <td>
  18753. <br/>
  18754. <br/>
  18755. <table>
  18756. <tr>
  18757. <td>
  18758. <code>externalSecretSpec</code></br>
  18759. <em>
  18760. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  18761. ExternalSecretSpec
  18762. </a>
  18763. </em>
  18764. </td>
  18765. <td>
  18766. <p>The spec for the ExternalSecrets to be created</p>
  18767. </td>
  18768. </tr>
  18769. <tr>
  18770. <td>
  18771. <code>externalSecretName</code></br>
  18772. <em>
  18773. string
  18774. </em>
  18775. </td>
  18776. <td>
  18777. <em>(Optional)</em>
  18778. <p>The name of the external secrets to be created.
  18779. Defaults to the name of the ClusterExternalSecret</p>
  18780. </td>
  18781. </tr>
  18782. <tr>
  18783. <td>
  18784. <code>externalSecretMetadata</code></br>
  18785. <em>
  18786. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  18787. ExternalSecretMetadata
  18788. </a>
  18789. </em>
  18790. </td>
  18791. <td>
  18792. <em>(Optional)</em>
  18793. <p>The metadata of the external secrets to be created</p>
  18794. </td>
  18795. </tr>
  18796. <tr>
  18797. <td>
  18798. <code>namespaceSelector</code></br>
  18799. <em>
  18800. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  18801. Kubernetes meta/v1.LabelSelector
  18802. </a>
  18803. </em>
  18804. </td>
  18805. <td>
  18806. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  18807. </td>
  18808. </tr>
  18809. <tr>
  18810. <td>
  18811. <code>namespaceSelectors</code></br>
  18812. <em>
  18813. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  18814. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  18815. </a>
  18816. </em>
  18817. </td>
  18818. <td>
  18819. <em>(Optional)</em>
  18820. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  18821. </td>
  18822. </tr>
  18823. <tr>
  18824. <td>
  18825. <code>namespaces</code></br>
  18826. <em>
  18827. []string
  18828. </em>
  18829. </td>
  18830. <td>
  18831. <em>(Optional)</em>
  18832. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  18833. <p>Deprecated: Use NamespaceSelectors instead.</p>
  18834. </td>
  18835. </tr>
  18836. <tr>
  18837. <td>
  18838. <code>refreshTime</code></br>
  18839. <em>
  18840. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  18841. Kubernetes meta/v1.Duration
  18842. </a>
  18843. </em>
  18844. </td>
  18845. <td>
  18846. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  18847. </td>
  18848. </tr>
  18849. </table>
  18850. </td>
  18851. </tr>
  18852. <tr>
  18853. <td>
  18854. <code>status</code></br>
  18855. <em>
  18856. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">
  18857. ClusterExternalSecretStatus
  18858. </a>
  18859. </em>
  18860. </td>
  18861. <td>
  18862. </td>
  18863. </tr>
  18864. </tbody>
  18865. </table>
  18866. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  18867. (<code>string</code> alias)</p></h3>
  18868. <p>
  18869. (<em>Appears on:</em>
  18870. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  18871. </p>
  18872. <p>
  18873. <p>ClusterExternalSecretConditionType indicates the condition of the ClusterExternalSecret.</p>
  18874. </p>
  18875. <table>
  18876. <thead>
  18877. <tr>
  18878. <th>Value</th>
  18879. <th>Description</th>
  18880. </tr>
  18881. </thead>
  18882. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  18883. <td><p>ClusterExternalSecretReady indicates the ClusterExternalSecret resource is ready.</p>
  18884. </td>
  18885. </tr></tbody>
  18886. </table>
  18887. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  18888. </h3>
  18889. <p>
  18890. (<em>Appears on:</em>
  18891. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  18892. </p>
  18893. <p>
  18894. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  18895. </p>
  18896. <table>
  18897. <thead>
  18898. <tr>
  18899. <th>Field</th>
  18900. <th>Description</th>
  18901. </tr>
  18902. </thead>
  18903. <tbody>
  18904. <tr>
  18905. <td>
  18906. <code>namespace</code></br>
  18907. <em>
  18908. string
  18909. </em>
  18910. </td>
  18911. <td>
  18912. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  18913. </td>
  18914. </tr>
  18915. <tr>
  18916. <td>
  18917. <code>reason</code></br>
  18918. <em>
  18919. string
  18920. </em>
  18921. </td>
  18922. <td>
  18923. <em>(Optional)</em>
  18924. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  18925. </td>
  18926. </tr>
  18927. </tbody>
  18928. </table>
  18929. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  18930. </h3>
  18931. <p>
  18932. (<em>Appears on:</em>
  18933. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  18934. </p>
  18935. <p>
  18936. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  18937. </p>
  18938. <table>
  18939. <thead>
  18940. <tr>
  18941. <th>Field</th>
  18942. <th>Description</th>
  18943. </tr>
  18944. </thead>
  18945. <tbody>
  18946. <tr>
  18947. <td>
  18948. <code>externalSecretSpec</code></br>
  18949. <em>
  18950. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  18951. ExternalSecretSpec
  18952. </a>
  18953. </em>
  18954. </td>
  18955. <td>
  18956. <p>The spec for the ExternalSecrets to be created</p>
  18957. </td>
  18958. </tr>
  18959. <tr>
  18960. <td>
  18961. <code>externalSecretName</code></br>
  18962. <em>
  18963. string
  18964. </em>
  18965. </td>
  18966. <td>
  18967. <em>(Optional)</em>
  18968. <p>The name of the external secrets to be created.
  18969. Defaults to the name of the ClusterExternalSecret</p>
  18970. </td>
  18971. </tr>
  18972. <tr>
  18973. <td>
  18974. <code>externalSecretMetadata</code></br>
  18975. <em>
  18976. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  18977. ExternalSecretMetadata
  18978. </a>
  18979. </em>
  18980. </td>
  18981. <td>
  18982. <em>(Optional)</em>
  18983. <p>The metadata of the external secrets to be created</p>
  18984. </td>
  18985. </tr>
  18986. <tr>
  18987. <td>
  18988. <code>namespaceSelector</code></br>
  18989. <em>
  18990. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  18991. Kubernetes meta/v1.LabelSelector
  18992. </a>
  18993. </em>
  18994. </td>
  18995. <td>
  18996. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  18997. </td>
  18998. </tr>
  18999. <tr>
  19000. <td>
  19001. <code>namespaceSelectors</code></br>
  19002. <em>
  19003. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  19004. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  19005. </a>
  19006. </em>
  19007. </td>
  19008. <td>
  19009. <em>(Optional)</em>
  19010. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  19011. </td>
  19012. </tr>
  19013. <tr>
  19014. <td>
  19015. <code>namespaces</code></br>
  19016. <em>
  19017. []string
  19018. </em>
  19019. </td>
  19020. <td>
  19021. <em>(Optional)</em>
  19022. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  19023. <p>Deprecated: Use NamespaceSelectors instead.</p>
  19024. </td>
  19025. </tr>
  19026. <tr>
  19027. <td>
  19028. <code>refreshTime</code></br>
  19029. <em>
  19030. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  19031. Kubernetes meta/v1.Duration
  19032. </a>
  19033. </em>
  19034. </td>
  19035. <td>
  19036. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  19037. </td>
  19038. </tr>
  19039. </tbody>
  19040. </table>
  19041. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  19042. </h3>
  19043. <p>
  19044. (<em>Appears on:</em>
  19045. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  19046. </p>
  19047. <p>
  19048. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  19049. </p>
  19050. <table>
  19051. <thead>
  19052. <tr>
  19053. <th>Field</th>
  19054. <th>Description</th>
  19055. </tr>
  19056. </thead>
  19057. <tbody>
  19058. <tr>
  19059. <td>
  19060. <code>externalSecretName</code></br>
  19061. <em>
  19062. string
  19063. </em>
  19064. </td>
  19065. <td>
  19066. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  19067. </td>
  19068. </tr>
  19069. <tr>
  19070. <td>
  19071. <code>failedNamespaces</code></br>
  19072. <em>
  19073. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">
  19074. []ClusterExternalSecretNamespaceFailure
  19075. </a>
  19076. </em>
  19077. </td>
  19078. <td>
  19079. <em>(Optional)</em>
  19080. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  19081. </td>
  19082. </tr>
  19083. <tr>
  19084. <td>
  19085. <code>provisionedNamespaces</code></br>
  19086. <em>
  19087. []string
  19088. </em>
  19089. </td>
  19090. <td>
  19091. <em>(Optional)</em>
  19092. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  19093. </td>
  19094. </tr>
  19095. <tr>
  19096. <td>
  19097. <code>conditions</code></br>
  19098. <em>
  19099. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">
  19100. []ClusterExternalSecretStatusCondition
  19101. </a>
  19102. </em>
  19103. </td>
  19104. <td>
  19105. <em>(Optional)</em>
  19106. </td>
  19107. </tr>
  19108. </tbody>
  19109. </table>
  19110. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  19111. </h3>
  19112. <p>
  19113. (<em>Appears on:</em>
  19114. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  19115. </p>
  19116. <p>
  19117. <p>ClusterExternalSecretStatusCondition indicates the status of the ClusterExternalSecret.</p>
  19118. </p>
  19119. <table>
  19120. <thead>
  19121. <tr>
  19122. <th>Field</th>
  19123. <th>Description</th>
  19124. </tr>
  19125. </thead>
  19126. <tbody>
  19127. <tr>
  19128. <td>
  19129. <code>type</code></br>
  19130. <em>
  19131. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretConditionType">
  19132. ClusterExternalSecretConditionType
  19133. </a>
  19134. </em>
  19135. </td>
  19136. <td>
  19137. </td>
  19138. </tr>
  19139. <tr>
  19140. <td>
  19141. <code>status</code></br>
  19142. <em>
  19143. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  19144. Kubernetes core/v1.ConditionStatus
  19145. </a>
  19146. </em>
  19147. </td>
  19148. <td>
  19149. </td>
  19150. </tr>
  19151. <tr>
  19152. <td>
  19153. <code>message</code></br>
  19154. <em>
  19155. string
  19156. </em>
  19157. </td>
  19158. <td>
  19159. <em>(Optional)</em>
  19160. </td>
  19161. </tr>
  19162. </tbody>
  19163. </table>
  19164. <h3 id="external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore
  19165. </h3>
  19166. <p>
  19167. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  19168. </p>
  19169. <table>
  19170. <thead>
  19171. <tr>
  19172. <th>Field</th>
  19173. <th>Description</th>
  19174. </tr>
  19175. </thead>
  19176. <tbody>
  19177. <tr>
  19178. <td>
  19179. <code>metadata</code></br>
  19180. <em>
  19181. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  19182. Kubernetes meta/v1.ObjectMeta
  19183. </a>
  19184. </em>
  19185. </td>
  19186. <td>
  19187. Refer to the Kubernetes API documentation for the fields of the
  19188. <code>metadata</code> field.
  19189. </td>
  19190. </tr>
  19191. <tr>
  19192. <td>
  19193. <code>spec</code></br>
  19194. <em>
  19195. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  19196. SecretStoreSpec
  19197. </a>
  19198. </em>
  19199. </td>
  19200. <td>
  19201. <br/>
  19202. <br/>
  19203. <table>
  19204. <tr>
  19205. <td>
  19206. <code>controller</code></br>
  19207. <em>
  19208. string
  19209. </em>
  19210. </td>
  19211. <td>
  19212. <em>(Optional)</em>
  19213. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  19214. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  19215. </td>
  19216. </tr>
  19217. <tr>
  19218. <td>
  19219. <code>provider</code></br>
  19220. <em>
  19221. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  19222. SecretStoreProvider
  19223. </a>
  19224. </em>
  19225. </td>
  19226. <td>
  19227. <p>Used to configure the provider. Only one provider may be set</p>
  19228. </td>
  19229. </tr>
  19230. <tr>
  19231. <td>
  19232. <code>retrySettings</code></br>
  19233. <em>
  19234. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  19235. SecretStoreRetrySettings
  19236. </a>
  19237. </em>
  19238. </td>
  19239. <td>
  19240. <em>(Optional)</em>
  19241. <p>Used to configure HTTP retries on failures.</p>
  19242. </td>
  19243. </tr>
  19244. <tr>
  19245. <td>
  19246. <code>refreshInterval</code></br>
  19247. <em>
  19248. int
  19249. </em>
  19250. </td>
  19251. <td>
  19252. <em>(Optional)</em>
  19253. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  19254. </td>
  19255. </tr>
  19256. <tr>
  19257. <td>
  19258. <code>conditions</code></br>
  19259. <em>
  19260. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  19261. []ClusterSecretStoreCondition
  19262. </a>
  19263. </em>
  19264. </td>
  19265. <td>
  19266. <em>(Optional)</em>
  19267. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  19268. </td>
  19269. </tr>
  19270. </table>
  19271. </td>
  19272. </tr>
  19273. <tr>
  19274. <td>
  19275. <code>status</code></br>
  19276. <em>
  19277. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  19278. SecretStoreStatus
  19279. </a>
  19280. </em>
  19281. </td>
  19282. <td>
  19283. </td>
  19284. </tr>
  19285. </tbody>
  19286. </table>
  19287. <h3 id="external-secrets.io/v1beta1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  19288. </h3>
  19289. <p>
  19290. (<em>Appears on:</em>
  19291. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  19292. </p>
  19293. <p>
  19294. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  19295. for a ClusterSecretStore instance.</p>
  19296. </p>
  19297. <table>
  19298. <thead>
  19299. <tr>
  19300. <th>Field</th>
  19301. <th>Description</th>
  19302. </tr>
  19303. </thead>
  19304. <tbody>
  19305. <tr>
  19306. <td>
  19307. <code>namespaceSelector</code></br>
  19308. <em>
  19309. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  19310. Kubernetes meta/v1.LabelSelector
  19311. </a>
  19312. </em>
  19313. </td>
  19314. <td>
  19315. <em>(Optional)</em>
  19316. <p>Choose namespace using a labelSelector</p>
  19317. </td>
  19318. </tr>
  19319. <tr>
  19320. <td>
  19321. <code>namespaces</code></br>
  19322. <em>
  19323. []string
  19324. </em>
  19325. </td>
  19326. <td>
  19327. <em>(Optional)</em>
  19328. <p>Choose namespaces by name</p>
  19329. </td>
  19330. </tr>
  19331. <tr>
  19332. <td>
  19333. <code>namespaceRegexes</code></br>
  19334. <em>
  19335. []string
  19336. </em>
  19337. </td>
  19338. <td>
  19339. <em>(Optional)</em>
  19340. <p>Choose namespaces by using regex matching</p>
  19341. </td>
  19342. </tr>
  19343. </tbody>
  19344. </table>
  19345. <h3 id="external-secrets.io/v1beta1.ConjurAPIKey">ConjurAPIKey
  19346. </h3>
  19347. <p>
  19348. (<em>Appears on:</em>
  19349. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  19350. </p>
  19351. <p>
  19352. <p>ConjurAPIKey defines authentication using a Conjur API key.</p>
  19353. </p>
  19354. <table>
  19355. <thead>
  19356. <tr>
  19357. <th>Field</th>
  19358. <th>Description</th>
  19359. </tr>
  19360. </thead>
  19361. <tbody>
  19362. <tr>
  19363. <td>
  19364. <code>account</code></br>
  19365. <em>
  19366. string
  19367. </em>
  19368. </td>
  19369. <td>
  19370. <p>Account is the Conjur organization account name.</p>
  19371. </td>
  19372. </tr>
  19373. <tr>
  19374. <td>
  19375. <code>userRef</code></br>
  19376. <em>
  19377. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19378. External Secrets meta/v1.SecretKeySelector
  19379. </a>
  19380. </em>
  19381. </td>
  19382. <td>
  19383. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  19384. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  19385. </td>
  19386. </tr>
  19387. <tr>
  19388. <td>
  19389. <code>apiKeyRef</code></br>
  19390. <em>
  19391. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19392. External Secrets meta/v1.SecretKeySelector
  19393. </a>
  19394. </em>
  19395. </td>
  19396. <td>
  19397. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  19398. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  19399. </td>
  19400. </tr>
  19401. </tbody>
  19402. </table>
  19403. <h3 id="external-secrets.io/v1beta1.ConjurAuth">ConjurAuth
  19404. </h3>
  19405. <p>
  19406. (<em>Appears on:</em>
  19407. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>)
  19408. </p>
  19409. <p>
  19410. <p>ConjurAuth defines the methods of authentication with Conjur.</p>
  19411. </p>
  19412. <table>
  19413. <thead>
  19414. <tr>
  19415. <th>Field</th>
  19416. <th>Description</th>
  19417. </tr>
  19418. </thead>
  19419. <tbody>
  19420. <tr>
  19421. <td>
  19422. <code>apikey</code></br>
  19423. <em>
  19424. <a href="#external-secrets.io/v1beta1.ConjurAPIKey">
  19425. ConjurAPIKey
  19426. </a>
  19427. </em>
  19428. </td>
  19429. <td>
  19430. <em>(Optional)</em>
  19431. <p>Authenticates with Conjur using an API key.</p>
  19432. </td>
  19433. </tr>
  19434. <tr>
  19435. <td>
  19436. <code>jwt</code></br>
  19437. <em>
  19438. <a href="#external-secrets.io/v1beta1.ConjurJWT">
  19439. ConjurJWT
  19440. </a>
  19441. </em>
  19442. </td>
  19443. <td>
  19444. <em>(Optional)</em>
  19445. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  19446. </td>
  19447. </tr>
  19448. </tbody>
  19449. </table>
  19450. <h3 id="external-secrets.io/v1beta1.ConjurJWT">ConjurJWT
  19451. </h3>
  19452. <p>
  19453. (<em>Appears on:</em>
  19454. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  19455. </p>
  19456. <p>
  19457. <p>ConjurJWT defines authentication using a JWT service account token.</p>
  19458. </p>
  19459. <table>
  19460. <thead>
  19461. <tr>
  19462. <th>Field</th>
  19463. <th>Description</th>
  19464. </tr>
  19465. </thead>
  19466. <tbody>
  19467. <tr>
  19468. <td>
  19469. <code>account</code></br>
  19470. <em>
  19471. string
  19472. </em>
  19473. </td>
  19474. <td>
  19475. <p>Account is the Conjur organization account name.</p>
  19476. </td>
  19477. </tr>
  19478. <tr>
  19479. <td>
  19480. <code>serviceID</code></br>
  19481. <em>
  19482. string
  19483. </em>
  19484. </td>
  19485. <td>
  19486. <p>The conjur authn jwt webservice id</p>
  19487. </td>
  19488. </tr>
  19489. <tr>
  19490. <td>
  19491. <code>hostId</code></br>
  19492. <em>
  19493. string
  19494. </em>
  19495. </td>
  19496. <td>
  19497. <em>(Optional)</em>
  19498. <p>Optional HostID for JWT authentication. This may be used depending
  19499. on how the Conjur JWT authenticator policy is configured.</p>
  19500. </td>
  19501. </tr>
  19502. <tr>
  19503. <td>
  19504. <code>secretRef</code></br>
  19505. <em>
  19506. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19507. External Secrets meta/v1.SecretKeySelector
  19508. </a>
  19509. </em>
  19510. </td>
  19511. <td>
  19512. <em>(Optional)</em>
  19513. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  19514. authenticate with Conjur using the JWT authentication method.</p>
  19515. </td>
  19516. </tr>
  19517. <tr>
  19518. <td>
  19519. <code>serviceAccountRef</code></br>
  19520. <em>
  19521. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  19522. External Secrets meta/v1.ServiceAccountSelector
  19523. </a>
  19524. </em>
  19525. </td>
  19526. <td>
  19527. <em>(Optional)</em>
  19528. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  19529. a token for with the <code>TokenRequest</code> API.</p>
  19530. </td>
  19531. </tr>
  19532. </tbody>
  19533. </table>
  19534. <h3 id="external-secrets.io/v1beta1.ConjurProvider">ConjurProvider
  19535. </h3>
  19536. <p>
  19537. (<em>Appears on:</em>
  19538. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19539. </p>
  19540. <p>
  19541. <p>ConjurProvider defines configuration for the CyberArk Conjur provider.</p>
  19542. </p>
  19543. <table>
  19544. <thead>
  19545. <tr>
  19546. <th>Field</th>
  19547. <th>Description</th>
  19548. </tr>
  19549. </thead>
  19550. <tbody>
  19551. <tr>
  19552. <td>
  19553. <code>url</code></br>
  19554. <em>
  19555. string
  19556. </em>
  19557. </td>
  19558. <td>
  19559. <p>URL is the endpoint of the Conjur instance.</p>
  19560. </td>
  19561. </tr>
  19562. <tr>
  19563. <td>
  19564. <code>caBundle</code></br>
  19565. <em>
  19566. string
  19567. </em>
  19568. </td>
  19569. <td>
  19570. <em>(Optional)</em>
  19571. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  19572. </td>
  19573. </tr>
  19574. <tr>
  19575. <td>
  19576. <code>caProvider</code></br>
  19577. <em>
  19578. <a href="#external-secrets.io/v1beta1.CAProvider">
  19579. CAProvider
  19580. </a>
  19581. </em>
  19582. </td>
  19583. <td>
  19584. <em>(Optional)</em>
  19585. <p>Used to provide custom certificate authority (CA) certificates
  19586. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  19587. that contains a PEM-encoded certificate.</p>
  19588. </td>
  19589. </tr>
  19590. <tr>
  19591. <td>
  19592. <code>auth</code></br>
  19593. <em>
  19594. <a href="#external-secrets.io/v1beta1.ConjurAuth">
  19595. ConjurAuth
  19596. </a>
  19597. </em>
  19598. </td>
  19599. <td>
  19600. <p>Defines authentication settings for connecting to Conjur.</p>
  19601. </td>
  19602. </tr>
  19603. </tbody>
  19604. </table>
  19605. <h3 id="external-secrets.io/v1beta1.DelineaProvider">DelineaProvider
  19606. </h3>
  19607. <p>
  19608. (<em>Appears on:</em>
  19609. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19610. </p>
  19611. <p>
  19612. <p>DelineaProvider defines configuration for the Delinea DevOps Secrets Vault provider.
  19613. 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>
  19614. </p>
  19615. <table>
  19616. <thead>
  19617. <tr>
  19618. <th>Field</th>
  19619. <th>Description</th>
  19620. </tr>
  19621. </thead>
  19622. <tbody>
  19623. <tr>
  19624. <td>
  19625. <code>clientId</code></br>
  19626. <em>
  19627. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  19628. DelineaProviderSecretRef
  19629. </a>
  19630. </em>
  19631. </td>
  19632. <td>
  19633. <p>ClientID is the non-secret part of the credential.</p>
  19634. </td>
  19635. </tr>
  19636. <tr>
  19637. <td>
  19638. <code>clientSecret</code></br>
  19639. <em>
  19640. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  19641. DelineaProviderSecretRef
  19642. </a>
  19643. </em>
  19644. </td>
  19645. <td>
  19646. <p>ClientSecret is the secret part of the credential.</p>
  19647. </td>
  19648. </tr>
  19649. <tr>
  19650. <td>
  19651. <code>tenant</code></br>
  19652. <em>
  19653. string
  19654. </em>
  19655. </td>
  19656. <td>
  19657. <p>Tenant is the chosen hostname / site name.</p>
  19658. </td>
  19659. </tr>
  19660. <tr>
  19661. <td>
  19662. <code>urlTemplate</code></br>
  19663. <em>
  19664. string
  19665. </em>
  19666. </td>
  19667. <td>
  19668. <em>(Optional)</em>
  19669. <p>URLTemplate
  19670. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  19671. </td>
  19672. </tr>
  19673. <tr>
  19674. <td>
  19675. <code>tld</code></br>
  19676. <em>
  19677. string
  19678. </em>
  19679. </td>
  19680. <td>
  19681. <em>(Optional)</em>
  19682. <p>TLD is based on the server location that was chosen during provisioning.
  19683. If unset, defaults to &ldquo;com&rdquo;.</p>
  19684. </td>
  19685. </tr>
  19686. </tbody>
  19687. </table>
  19688. <h3 id="external-secrets.io/v1beta1.DelineaProviderSecretRef">DelineaProviderSecretRef
  19689. </h3>
  19690. <p>
  19691. (<em>Appears on:</em>
  19692. <a href="#external-secrets.io/v1beta1.DelineaProvider">DelineaProvider</a>)
  19693. </p>
  19694. <p>
  19695. <p>DelineaProviderSecretRef defines a reference to a secret containing credentials for the Delinea provider.</p>
  19696. </p>
  19697. <table>
  19698. <thead>
  19699. <tr>
  19700. <th>Field</th>
  19701. <th>Description</th>
  19702. </tr>
  19703. </thead>
  19704. <tbody>
  19705. <tr>
  19706. <td>
  19707. <code>value</code></br>
  19708. <em>
  19709. string
  19710. </em>
  19711. </td>
  19712. <td>
  19713. <em>(Optional)</em>
  19714. <p>Value can be specified directly to set a value without using a secret.</p>
  19715. </td>
  19716. </tr>
  19717. <tr>
  19718. <td>
  19719. <code>secretRef</code></br>
  19720. <em>
  19721. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19722. External Secrets meta/v1.SecretKeySelector
  19723. </a>
  19724. </em>
  19725. </td>
  19726. <td>
  19727. <em>(Optional)</em>
  19728. <p>SecretRef references a key in a secret that will be used as value.</p>
  19729. </td>
  19730. </tr>
  19731. </tbody>
  19732. </table>
  19733. <h3 id="external-secrets.io/v1beta1.Device42Auth">Device42Auth
  19734. </h3>
  19735. <p>
  19736. (<em>Appears on:</em>
  19737. <a href="#external-secrets.io/v1beta1.Device42Provider">Device42Provider</a>)
  19738. </p>
  19739. <p>
  19740. <p>Device42Auth defines the authentication method for the Device42 provider.</p>
  19741. </p>
  19742. <table>
  19743. <thead>
  19744. <tr>
  19745. <th>Field</th>
  19746. <th>Description</th>
  19747. </tr>
  19748. </thead>
  19749. <tbody>
  19750. <tr>
  19751. <td>
  19752. <code>secretRef</code></br>
  19753. <em>
  19754. <a href="#external-secrets.io/v1beta1.Device42SecretRef">
  19755. Device42SecretRef
  19756. </a>
  19757. </em>
  19758. </td>
  19759. <td>
  19760. </td>
  19761. </tr>
  19762. </tbody>
  19763. </table>
  19764. <h3 id="external-secrets.io/v1beta1.Device42Provider">Device42Provider
  19765. </h3>
  19766. <p>
  19767. (<em>Appears on:</em>
  19768. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19769. </p>
  19770. <p>
  19771. <p>Device42Provider configures a store to sync secrets with a Device42 instance.</p>
  19772. </p>
  19773. <table>
  19774. <thead>
  19775. <tr>
  19776. <th>Field</th>
  19777. <th>Description</th>
  19778. </tr>
  19779. </thead>
  19780. <tbody>
  19781. <tr>
  19782. <td>
  19783. <code>host</code></br>
  19784. <em>
  19785. string
  19786. </em>
  19787. </td>
  19788. <td>
  19789. <p>URL configures the Device42 instance URL.</p>
  19790. </td>
  19791. </tr>
  19792. <tr>
  19793. <td>
  19794. <code>auth</code></br>
  19795. <em>
  19796. <a href="#external-secrets.io/v1beta1.Device42Auth">
  19797. Device42Auth
  19798. </a>
  19799. </em>
  19800. </td>
  19801. <td>
  19802. <p>Auth configures how secret-manager authenticates with a Device42 instance.</p>
  19803. </td>
  19804. </tr>
  19805. </tbody>
  19806. </table>
  19807. <h3 id="external-secrets.io/v1beta1.Device42SecretRef">Device42SecretRef
  19808. </h3>
  19809. <p>
  19810. (<em>Appears on:</em>
  19811. <a href="#external-secrets.io/v1beta1.Device42Auth">Device42Auth</a>)
  19812. </p>
  19813. <p>
  19814. <p>Device42SecretRef defines a reference to a secret containing credentials for the Device42 provider.</p>
  19815. </p>
  19816. <table>
  19817. <thead>
  19818. <tr>
  19819. <th>Field</th>
  19820. <th>Description</th>
  19821. </tr>
  19822. </thead>
  19823. <tbody>
  19824. <tr>
  19825. <td>
  19826. <code>credentials</code></br>
  19827. <em>
  19828. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19829. External Secrets meta/v1.SecretKeySelector
  19830. </a>
  19831. </em>
  19832. </td>
  19833. <td>
  19834. <em>(Optional)</em>
  19835. <p>Username / Password is used for authentication.</p>
  19836. </td>
  19837. </tr>
  19838. </tbody>
  19839. </table>
  19840. <h3 id="external-secrets.io/v1beta1.DopplerAuth">DopplerAuth
  19841. </h3>
  19842. <p>
  19843. (<em>Appears on:</em>
  19844. <a href="#external-secrets.io/v1beta1.DopplerProvider">DopplerProvider</a>)
  19845. </p>
  19846. <p>
  19847. <p>DopplerAuth defines the authentication method for the Doppler provider.</p>
  19848. </p>
  19849. <table>
  19850. <thead>
  19851. <tr>
  19852. <th>Field</th>
  19853. <th>Description</th>
  19854. </tr>
  19855. </thead>
  19856. <tbody>
  19857. <tr>
  19858. <td>
  19859. <code>secretRef</code></br>
  19860. <em>
  19861. <a href="#external-secrets.io/v1beta1.DopplerAuthSecretRef">
  19862. DopplerAuthSecretRef
  19863. </a>
  19864. </em>
  19865. </td>
  19866. <td>
  19867. </td>
  19868. </tr>
  19869. </tbody>
  19870. </table>
  19871. <h3 id="external-secrets.io/v1beta1.DopplerAuthSecretRef">DopplerAuthSecretRef
  19872. </h3>
  19873. <p>
  19874. (<em>Appears on:</em>
  19875. <a href="#external-secrets.io/v1beta1.DopplerAuth">DopplerAuth</a>)
  19876. </p>
  19877. <p>
  19878. <p>DopplerAuthSecretRef defines a reference to a secret containing credentials for the Doppler provider.</p>
  19879. </p>
  19880. <table>
  19881. <thead>
  19882. <tr>
  19883. <th>Field</th>
  19884. <th>Description</th>
  19885. </tr>
  19886. </thead>
  19887. <tbody>
  19888. <tr>
  19889. <td>
  19890. <code>dopplerToken</code></br>
  19891. <em>
  19892. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19893. External Secrets meta/v1.SecretKeySelector
  19894. </a>
  19895. </em>
  19896. </td>
  19897. <td>
  19898. <p>The DopplerToken is used for authentication.
  19899. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  19900. The Key attribute defaults to dopplerToken if not specified.</p>
  19901. </td>
  19902. </tr>
  19903. </tbody>
  19904. </table>
  19905. <h3 id="external-secrets.io/v1beta1.DopplerProvider">DopplerProvider
  19906. </h3>
  19907. <p>
  19908. (<em>Appears on:</em>
  19909. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19910. </p>
  19911. <p>
  19912. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  19913. Project and Config are required if not using a Service Token.</p>
  19914. </p>
  19915. <table>
  19916. <thead>
  19917. <tr>
  19918. <th>Field</th>
  19919. <th>Description</th>
  19920. </tr>
  19921. </thead>
  19922. <tbody>
  19923. <tr>
  19924. <td>
  19925. <code>auth</code></br>
  19926. <em>
  19927. <a href="#external-secrets.io/v1beta1.DopplerAuth">
  19928. DopplerAuth
  19929. </a>
  19930. </em>
  19931. </td>
  19932. <td>
  19933. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  19934. </td>
  19935. </tr>
  19936. <tr>
  19937. <td>
  19938. <code>project</code></br>
  19939. <em>
  19940. string
  19941. </em>
  19942. </td>
  19943. <td>
  19944. <em>(Optional)</em>
  19945. <p>Doppler project (required if not using a Service Token)</p>
  19946. </td>
  19947. </tr>
  19948. <tr>
  19949. <td>
  19950. <code>config</code></br>
  19951. <em>
  19952. string
  19953. </em>
  19954. </td>
  19955. <td>
  19956. <em>(Optional)</em>
  19957. <p>Doppler config (required if not using a Service Token)</p>
  19958. </td>
  19959. </tr>
  19960. <tr>
  19961. <td>
  19962. <code>nameTransformer</code></br>
  19963. <em>
  19964. string
  19965. </em>
  19966. </td>
  19967. <td>
  19968. <em>(Optional)</em>
  19969. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  19970. </td>
  19971. </tr>
  19972. <tr>
  19973. <td>
  19974. <code>format</code></br>
  19975. <em>
  19976. string
  19977. </em>
  19978. </td>
  19979. <td>
  19980. <em>(Optional)</em>
  19981. <p>Format enables the downloading of secrets as a file (string)</p>
  19982. </td>
  19983. </tr>
  19984. </tbody>
  19985. </table>
  19986. <h3 id="external-secrets.io/v1beta1.ExternalSecret">ExternalSecret
  19987. </h3>
  19988. <p>
  19989. <p>ExternalSecret is the schema for the external-secrets API.</p>
  19990. </p>
  19991. <table>
  19992. <thead>
  19993. <tr>
  19994. <th>Field</th>
  19995. <th>Description</th>
  19996. </tr>
  19997. </thead>
  19998. <tbody>
  19999. <tr>
  20000. <td>
  20001. <code>metadata</code></br>
  20002. <em>
  20003. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  20004. Kubernetes meta/v1.ObjectMeta
  20005. </a>
  20006. </em>
  20007. </td>
  20008. <td>
  20009. Refer to the Kubernetes API documentation for the fields of the
  20010. <code>metadata</code> field.
  20011. </td>
  20012. </tr>
  20013. <tr>
  20014. <td>
  20015. <code>spec</code></br>
  20016. <em>
  20017. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  20018. ExternalSecretSpec
  20019. </a>
  20020. </em>
  20021. </td>
  20022. <td>
  20023. <br/>
  20024. <br/>
  20025. <table>
  20026. <tr>
  20027. <td>
  20028. <code>secretStoreRef</code></br>
  20029. <em>
  20030. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  20031. SecretStoreRef
  20032. </a>
  20033. </em>
  20034. </td>
  20035. <td>
  20036. <em>(Optional)</em>
  20037. </td>
  20038. </tr>
  20039. <tr>
  20040. <td>
  20041. <code>target</code></br>
  20042. <em>
  20043. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  20044. ExternalSecretTarget
  20045. </a>
  20046. </em>
  20047. </td>
  20048. <td>
  20049. <em>(Optional)</em>
  20050. </td>
  20051. </tr>
  20052. <tr>
  20053. <td>
  20054. <code>refreshPolicy</code></br>
  20055. <em>
  20056. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  20057. ExternalSecretRefreshPolicy
  20058. </a>
  20059. </em>
  20060. </td>
  20061. <td>
  20062. <em>(Optional)</em>
  20063. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  20064. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  20065. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  20066. No periodic updates occur if refreshInterval is 0.
  20067. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  20068. </td>
  20069. </tr>
  20070. <tr>
  20071. <td>
  20072. <code>refreshInterval</code></br>
  20073. <em>
  20074. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  20075. Kubernetes meta/v1.Duration
  20076. </a>
  20077. </em>
  20078. </td>
  20079. <td>
  20080. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  20081. specified as Golang Duration strings.
  20082. 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;
  20083. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  20084. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  20085. </td>
  20086. </tr>
  20087. <tr>
  20088. <td>
  20089. <code>data</code></br>
  20090. <em>
  20091. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  20092. []ExternalSecretData
  20093. </a>
  20094. </em>
  20095. </td>
  20096. <td>
  20097. <em>(Optional)</em>
  20098. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  20099. </td>
  20100. </tr>
  20101. <tr>
  20102. <td>
  20103. <code>dataFrom</code></br>
  20104. <em>
  20105. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  20106. []ExternalSecretDataFromRemoteRef
  20107. </a>
  20108. </em>
  20109. </td>
  20110. <td>
  20111. <em>(Optional)</em>
  20112. <p>DataFrom is used to fetch all properties from a specific Provider data
  20113. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  20114. </td>
  20115. </tr>
  20116. </table>
  20117. </td>
  20118. </tr>
  20119. <tr>
  20120. <td>
  20121. <code>status</code></br>
  20122. <em>
  20123. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">
  20124. ExternalSecretStatus
  20125. </a>
  20126. </em>
  20127. </td>
  20128. <td>
  20129. </td>
  20130. </tr>
  20131. </tbody>
  20132. </table>
  20133. <h3 id="external-secrets.io/v1beta1.ExternalSecretConditionType">ExternalSecretConditionType
  20134. (<code>string</code> alias)</p></h3>
  20135. <p>
  20136. (<em>Appears on:</em>
  20137. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  20138. </p>
  20139. <p>
  20140. <p>ExternalSecretConditionType defines the condition type for an ExternalSecret.</p>
  20141. </p>
  20142. <table>
  20143. <thead>
  20144. <tr>
  20145. <th>Value</th>
  20146. <th>Description</th>
  20147. </tr>
  20148. </thead>
  20149. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  20150. <td><p>ExternalSecretDeleted indicates the ExternalSecret has been deleted.</p>
  20151. </td>
  20152. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  20153. <td><p>ExternalSecretReady indicates the ExternalSecret has been successfully reconciled.</p>
  20154. </td>
  20155. </tr></tbody>
  20156. </table>
  20157. <h3 id="external-secrets.io/v1beta1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  20158. (<code>string</code> alias)</p></h3>
  20159. <p>
  20160. (<em>Appears on:</em>
  20161. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  20162. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  20163. </p>
  20164. <p>
  20165. <p>ExternalSecretConversionStrategy defines how secret values are converted.</p>
  20166. </p>
  20167. <table>
  20168. <thead>
  20169. <tr>
  20170. <th>Value</th>
  20171. <th>Description</th>
  20172. </tr>
  20173. </thead>
  20174. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  20175. <td><p>ExternalSecretConversionDefault indicates the default conversion strategy.</p>
  20176. </td>
  20177. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  20178. <td><p>ExternalSecretConversionUnicode indicates that unicode conversion will be performed.</p>
  20179. </td>
  20180. </tr></tbody>
  20181. </table>
  20182. <h3 id="external-secrets.io/v1beta1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  20183. (<code>string</code> alias)</p></h3>
  20184. <p>
  20185. (<em>Appears on:</em>
  20186. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  20187. </p>
  20188. <p>
  20189. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  20190. </p>
  20191. <table>
  20192. <thead>
  20193. <tr>
  20194. <th>Value</th>
  20195. <th>Description</th>
  20196. </tr>
  20197. </thead>
  20198. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  20199. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  20200. </td>
  20201. </tr><tr><td><p>&#34;None&#34;</p></td>
  20202. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  20203. </td>
  20204. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  20205. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  20206. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  20207. </td>
  20208. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  20209. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  20210. </td>
  20211. </tr></tbody>
  20212. </table>
  20213. <h3 id="external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData
  20214. </h3>
  20215. <p>
  20216. (<em>Appears on:</em>
  20217. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20218. </p>
  20219. <p>
  20220. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  20221. </p>
  20222. <table>
  20223. <thead>
  20224. <tr>
  20225. <th>Field</th>
  20226. <th>Description</th>
  20227. </tr>
  20228. </thead>
  20229. <tbody>
  20230. <tr>
  20231. <td>
  20232. <code>secretKey</code></br>
  20233. <em>
  20234. string
  20235. </em>
  20236. </td>
  20237. <td>
  20238. <p>The key in the Kubernetes Secret to store the value.</p>
  20239. </td>
  20240. </tr>
  20241. <tr>
  20242. <td>
  20243. <code>remoteRef</code></br>
  20244. <em>
  20245. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  20246. ExternalSecretDataRemoteRef
  20247. </a>
  20248. </em>
  20249. </td>
  20250. <td>
  20251. <p>RemoteRef points to the remote secret and defines
  20252. which secret (version/property/..) to fetch.</p>
  20253. </td>
  20254. </tr>
  20255. <tr>
  20256. <td>
  20257. <code>sourceRef</code></br>
  20258. <em>
  20259. <a href="#external-secrets.io/v1beta1.StoreSourceRef">
  20260. StoreSourceRef
  20261. </a>
  20262. </em>
  20263. </td>
  20264. <td>
  20265. <p>SourceRef allows you to override the source
  20266. from which the value will be pulled.</p>
  20267. </td>
  20268. </tr>
  20269. </tbody>
  20270. </table>
  20271. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  20272. </h3>
  20273. <p>
  20274. (<em>Appears on:</em>
  20275. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20276. </p>
  20277. <p>
  20278. <p>ExternalSecretDataFromRemoteRef defines a reference to multiple secrets in the provider to be fetched using options.</p>
  20279. </p>
  20280. <table>
  20281. <thead>
  20282. <tr>
  20283. <th>Field</th>
  20284. <th>Description</th>
  20285. </tr>
  20286. </thead>
  20287. <tbody>
  20288. <tr>
  20289. <td>
  20290. <code>extract</code></br>
  20291. <em>
  20292. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  20293. ExternalSecretDataRemoteRef
  20294. </a>
  20295. </em>
  20296. </td>
  20297. <td>
  20298. <em>(Optional)</em>
  20299. <p>Used to extract multiple key/value pairs from one secret
  20300. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  20301. </td>
  20302. </tr>
  20303. <tr>
  20304. <td>
  20305. <code>find</code></br>
  20306. <em>
  20307. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">
  20308. ExternalSecretFind
  20309. </a>
  20310. </em>
  20311. </td>
  20312. <td>
  20313. <em>(Optional)</em>
  20314. <p>Used to find secrets based on tags or regular expressions
  20315. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  20316. </td>
  20317. </tr>
  20318. <tr>
  20319. <td>
  20320. <code>rewrite</code></br>
  20321. <em>
  20322. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">
  20323. []ExternalSecretRewrite
  20324. </a>
  20325. </em>
  20326. </td>
  20327. <td>
  20328. <em>(Optional)</em>
  20329. <p>Used to rewrite secret Keys after getting them from the secret Provider
  20330. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  20331. </td>
  20332. </tr>
  20333. <tr>
  20334. <td>
  20335. <code>sourceRef</code></br>
  20336. <em>
  20337. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">
  20338. StoreGeneratorSourceRef
  20339. </a>
  20340. </em>
  20341. </td>
  20342. <td>
  20343. <p>SourceRef points to a store or generator
  20344. which contains secret values ready to use.
  20345. Use this in combination with Extract or Find pull values out of
  20346. a specific SecretStore.
  20347. When sourceRef points to a generator Extract or Find is not supported.
  20348. The generator returns a static map of values</p>
  20349. </td>
  20350. </tr>
  20351. </tbody>
  20352. </table>
  20353. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  20354. </h3>
  20355. <p>
  20356. (<em>Appears on:</em>
  20357. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>,
  20358. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20359. </p>
  20360. <p>
  20361. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  20362. </p>
  20363. <table>
  20364. <thead>
  20365. <tr>
  20366. <th>Field</th>
  20367. <th>Description</th>
  20368. </tr>
  20369. </thead>
  20370. <tbody>
  20371. <tr>
  20372. <td>
  20373. <code>key</code></br>
  20374. <em>
  20375. string
  20376. </em>
  20377. </td>
  20378. <td>
  20379. <p>Key is the key used in the Provider, mandatory</p>
  20380. </td>
  20381. </tr>
  20382. <tr>
  20383. <td>
  20384. <code>metadataPolicy</code></br>
  20385. <em>
  20386. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">
  20387. ExternalSecretMetadataPolicy
  20388. </a>
  20389. </em>
  20390. </td>
  20391. <td>
  20392. <em>(Optional)</em>
  20393. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  20394. </td>
  20395. </tr>
  20396. <tr>
  20397. <td>
  20398. <code>property</code></br>
  20399. <em>
  20400. string
  20401. </em>
  20402. </td>
  20403. <td>
  20404. <em>(Optional)</em>
  20405. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  20406. </td>
  20407. </tr>
  20408. <tr>
  20409. <td>
  20410. <code>version</code></br>
  20411. <em>
  20412. string
  20413. </em>
  20414. </td>
  20415. <td>
  20416. <em>(Optional)</em>
  20417. <p>Used to select a specific version of the Provider value, if supported</p>
  20418. </td>
  20419. </tr>
  20420. <tr>
  20421. <td>
  20422. <code>conversionStrategy</code></br>
  20423. <em>
  20424. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  20425. ExternalSecretConversionStrategy
  20426. </a>
  20427. </em>
  20428. </td>
  20429. <td>
  20430. <em>(Optional)</em>
  20431. <p>Used to define a conversion Strategy</p>
  20432. </td>
  20433. </tr>
  20434. <tr>
  20435. <td>
  20436. <code>decodingStrategy</code></br>
  20437. <em>
  20438. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  20439. ExternalSecretDecodingStrategy
  20440. </a>
  20441. </em>
  20442. </td>
  20443. <td>
  20444. <em>(Optional)</em>
  20445. <p>Used to define a decoding Strategy</p>
  20446. </td>
  20447. </tr>
  20448. </tbody>
  20449. </table>
  20450. <h3 id="external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  20451. (<code>string</code> alias)</p></h3>
  20452. <p>
  20453. (<em>Appears on:</em>
  20454. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  20455. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  20456. </p>
  20457. <p>
  20458. <p>ExternalSecretDecodingStrategy defines how secret values are decoded.</p>
  20459. </p>
  20460. <table>
  20461. <thead>
  20462. <tr>
  20463. <th>Value</th>
  20464. <th>Description</th>
  20465. </tr>
  20466. </thead>
  20467. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  20468. <td><p>ExternalSecretDecodeAuto indicates that the decoding strategy will be automatically determined.</p>
  20469. </td>
  20470. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  20471. <td><p>ExternalSecretDecodeBase64 indicates that base64 decoding will be used.</p>
  20472. </td>
  20473. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  20474. <td><p>ExternalSecretDecodeBase64URL indicates that base64url decoding will be used.</p>
  20475. </td>
  20476. </tr><tr><td><p>&#34;None&#34;</p></td>
  20477. <td><p>ExternalSecretDecodeNone indicates that no decoding will be performed.</p>
  20478. </td>
  20479. </tr></tbody>
  20480. </table>
  20481. <h3 id="external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  20482. (<code>string</code> alias)</p></h3>
  20483. <p>
  20484. (<em>Appears on:</em>
  20485. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  20486. </p>
  20487. <p>
  20488. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  20489. </p>
  20490. <table>
  20491. <thead>
  20492. <tr>
  20493. <th>Value</th>
  20494. <th>Description</th>
  20495. </tr>
  20496. </thead>
  20497. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  20498. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  20499. If a secret gets deleted on the provider side and is not accessible
  20500. anymore this is not considered an error and the ExternalSecret
  20501. does not go into SecretSyncedError status.</p>
  20502. </td>
  20503. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  20504. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  20505. If a secret gets deleted on the provider side and is not accessible
  20506. anymore this is not considered an error and the ExternalSecret
  20507. does not go into SecretSyncedError status.</p>
  20508. </td>
  20509. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  20510. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  20511. If a provider secret does not exist the ExternalSecret gets into the
  20512. SecretSyncedError status.</p>
  20513. </td>
  20514. </tr></tbody>
  20515. </table>
  20516. <h3 id="external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind
  20517. </h3>
  20518. <p>
  20519. (<em>Appears on:</em>
  20520. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20521. </p>
  20522. <p>
  20523. <p>ExternalSecretFind defines criteria for finding secrets in the provider.</p>
  20524. </p>
  20525. <table>
  20526. <thead>
  20527. <tr>
  20528. <th>Field</th>
  20529. <th>Description</th>
  20530. </tr>
  20531. </thead>
  20532. <tbody>
  20533. <tr>
  20534. <td>
  20535. <code>path</code></br>
  20536. <em>
  20537. string
  20538. </em>
  20539. </td>
  20540. <td>
  20541. <em>(Optional)</em>
  20542. <p>A root path to start the find operations.</p>
  20543. </td>
  20544. </tr>
  20545. <tr>
  20546. <td>
  20547. <code>name</code></br>
  20548. <em>
  20549. <a href="#external-secrets.io/v1beta1.FindName">
  20550. FindName
  20551. </a>
  20552. </em>
  20553. </td>
  20554. <td>
  20555. <em>(Optional)</em>
  20556. <p>Finds secrets based on the name.</p>
  20557. </td>
  20558. </tr>
  20559. <tr>
  20560. <td>
  20561. <code>tags</code></br>
  20562. <em>
  20563. map[string]string
  20564. </em>
  20565. </td>
  20566. <td>
  20567. <em>(Optional)</em>
  20568. <p>Find secrets based on tags.</p>
  20569. </td>
  20570. </tr>
  20571. <tr>
  20572. <td>
  20573. <code>conversionStrategy</code></br>
  20574. <em>
  20575. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  20576. ExternalSecretConversionStrategy
  20577. </a>
  20578. </em>
  20579. </td>
  20580. <td>
  20581. <em>(Optional)</em>
  20582. <p>Used to define a conversion Strategy</p>
  20583. </td>
  20584. </tr>
  20585. <tr>
  20586. <td>
  20587. <code>decodingStrategy</code></br>
  20588. <em>
  20589. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  20590. ExternalSecretDecodingStrategy
  20591. </a>
  20592. </em>
  20593. </td>
  20594. <td>
  20595. <em>(Optional)</em>
  20596. <p>Used to define a decoding Strategy</p>
  20597. </td>
  20598. </tr>
  20599. </tbody>
  20600. </table>
  20601. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadata">ExternalSecretMetadata
  20602. </h3>
  20603. <p>
  20604. (<em>Appears on:</em>
  20605. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  20606. </p>
  20607. <p>
  20608. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  20609. </p>
  20610. <table>
  20611. <thead>
  20612. <tr>
  20613. <th>Field</th>
  20614. <th>Description</th>
  20615. </tr>
  20616. </thead>
  20617. <tbody>
  20618. <tr>
  20619. <td>
  20620. <code>annotations</code></br>
  20621. <em>
  20622. map[string]string
  20623. </em>
  20624. </td>
  20625. <td>
  20626. <em>(Optional)</em>
  20627. </td>
  20628. </tr>
  20629. <tr>
  20630. <td>
  20631. <code>labels</code></br>
  20632. <em>
  20633. map[string]string
  20634. </em>
  20635. </td>
  20636. <td>
  20637. <em>(Optional)</em>
  20638. </td>
  20639. </tr>
  20640. </tbody>
  20641. </table>
  20642. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  20643. (<code>string</code> alias)</p></h3>
  20644. <p>
  20645. (<em>Appears on:</em>
  20646. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  20647. </p>
  20648. <p>
  20649. <p>ExternalSecretMetadataPolicy defines the policy for fetching tags/labels from provider secrets.</p>
  20650. </p>
  20651. <table>
  20652. <thead>
  20653. <tr>
  20654. <th>Value</th>
  20655. <th>Description</th>
  20656. </tr>
  20657. </thead>
  20658. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  20659. <td><p>ExternalSecretMetadataPolicyFetch indicates that metadata will be fetched from the provider.</p>
  20660. </td>
  20661. </tr><tr><td><p>&#34;None&#34;</p></td>
  20662. <td><p>ExternalSecretMetadataPolicyNone indicates that no metadata will be fetched.</p>
  20663. </td>
  20664. </tr></tbody>
  20665. </table>
  20666. <h3 id="external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  20667. (<code>string</code> alias)</p></h3>
  20668. <p>
  20669. (<em>Appears on:</em>
  20670. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20671. </p>
  20672. <p>
  20673. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  20674. </p>
  20675. <table>
  20676. <thead>
  20677. <tr>
  20678. <th>Value</th>
  20679. <th>Description</th>
  20680. </tr>
  20681. </thead>
  20682. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  20683. <td><p>RefreshPolicyCreatedOnce creates the Secret only if it does not exist and does not update it thereafter.</p>
  20684. </td>
  20685. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  20686. <td><p>RefreshPolicyOnChange only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes.</p>
  20687. </td>
  20688. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  20689. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the external source at regular intervals.</p>
  20690. </td>
  20691. </tr></tbody>
  20692. </table>
  20693. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite
  20694. </h3>
  20695. <p>
  20696. (<em>Appears on:</em>
  20697. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20698. </p>
  20699. <p>
  20700. <p>ExternalSecretRewrite defines rules on how to rewrite secret keys.</p>
  20701. </p>
  20702. <table>
  20703. <thead>
  20704. <tr>
  20705. <th>Field</th>
  20706. <th>Description</th>
  20707. </tr>
  20708. </thead>
  20709. <tbody>
  20710. <tr>
  20711. <td>
  20712. <code>regexp</code></br>
  20713. <em>
  20714. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">
  20715. ExternalSecretRewriteRegexp
  20716. </a>
  20717. </em>
  20718. </td>
  20719. <td>
  20720. <em>(Optional)</em>
  20721. <p>Used to rewrite with regular expressions.
  20722. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  20723. </td>
  20724. </tr>
  20725. <tr>
  20726. <td>
  20727. <code>transform</code></br>
  20728. <em>
  20729. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteTransform">
  20730. ExternalSecretRewriteTransform
  20731. </a>
  20732. </em>
  20733. </td>
  20734. <td>
  20735. <em>(Optional)</em>
  20736. <p>Used to apply string transformation on the secrets.
  20737. The resulting key will be the output of the template applied by the operation.</p>
  20738. </td>
  20739. </tr>
  20740. </tbody>
  20741. </table>
  20742. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  20743. </h3>
  20744. <p>
  20745. (<em>Appears on:</em>
  20746. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  20747. </p>
  20748. <p>
  20749. <p>ExternalSecretRewriteRegexp defines how to use regular expressions for rewriting secret keys.</p>
  20750. </p>
  20751. <table>
  20752. <thead>
  20753. <tr>
  20754. <th>Field</th>
  20755. <th>Description</th>
  20756. </tr>
  20757. </thead>
  20758. <tbody>
  20759. <tr>
  20760. <td>
  20761. <code>source</code></br>
  20762. <em>
  20763. string
  20764. </em>
  20765. </td>
  20766. <td>
  20767. <p>Used to define the regular expression of a re.Compiler.</p>
  20768. </td>
  20769. </tr>
  20770. <tr>
  20771. <td>
  20772. <code>target</code></br>
  20773. <em>
  20774. string
  20775. </em>
  20776. </td>
  20777. <td>
  20778. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  20779. </td>
  20780. </tr>
  20781. </tbody>
  20782. </table>
  20783. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  20784. </h3>
  20785. <p>
  20786. (<em>Appears on:</em>
  20787. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  20788. </p>
  20789. <p>
  20790. <p>ExternalSecretRewriteTransform defines how to use string templates for transforming secret keys.</p>
  20791. </p>
  20792. <table>
  20793. <thead>
  20794. <tr>
  20795. <th>Field</th>
  20796. <th>Description</th>
  20797. </tr>
  20798. </thead>
  20799. <tbody>
  20800. <tr>
  20801. <td>
  20802. <code>template</code></br>
  20803. <em>
  20804. string
  20805. </em>
  20806. </td>
  20807. <td>
  20808. <p>Used to define the template to apply on the secret name.
  20809. <code>.value</code> will specify the secret name in the template.</p>
  20810. </td>
  20811. </tr>
  20812. </tbody>
  20813. </table>
  20814. <h3 id="external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec
  20815. </h3>
  20816. <p>
  20817. (<em>Appears on:</em>
  20818. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  20819. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  20820. </p>
  20821. <p>
  20822. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  20823. </p>
  20824. <table>
  20825. <thead>
  20826. <tr>
  20827. <th>Field</th>
  20828. <th>Description</th>
  20829. </tr>
  20830. </thead>
  20831. <tbody>
  20832. <tr>
  20833. <td>
  20834. <code>secretStoreRef</code></br>
  20835. <em>
  20836. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  20837. SecretStoreRef
  20838. </a>
  20839. </em>
  20840. </td>
  20841. <td>
  20842. <em>(Optional)</em>
  20843. </td>
  20844. </tr>
  20845. <tr>
  20846. <td>
  20847. <code>target</code></br>
  20848. <em>
  20849. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  20850. ExternalSecretTarget
  20851. </a>
  20852. </em>
  20853. </td>
  20854. <td>
  20855. <em>(Optional)</em>
  20856. </td>
  20857. </tr>
  20858. <tr>
  20859. <td>
  20860. <code>refreshPolicy</code></br>
  20861. <em>
  20862. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  20863. ExternalSecretRefreshPolicy
  20864. </a>
  20865. </em>
  20866. </td>
  20867. <td>
  20868. <em>(Optional)</em>
  20869. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  20870. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  20871. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  20872. No periodic updates occur if refreshInterval is 0.
  20873. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  20874. </td>
  20875. </tr>
  20876. <tr>
  20877. <td>
  20878. <code>refreshInterval</code></br>
  20879. <em>
  20880. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  20881. Kubernetes meta/v1.Duration
  20882. </a>
  20883. </em>
  20884. </td>
  20885. <td>
  20886. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  20887. specified as Golang Duration strings.
  20888. 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;
  20889. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  20890. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  20891. </td>
  20892. </tr>
  20893. <tr>
  20894. <td>
  20895. <code>data</code></br>
  20896. <em>
  20897. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  20898. []ExternalSecretData
  20899. </a>
  20900. </em>
  20901. </td>
  20902. <td>
  20903. <em>(Optional)</em>
  20904. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  20905. </td>
  20906. </tr>
  20907. <tr>
  20908. <td>
  20909. <code>dataFrom</code></br>
  20910. <em>
  20911. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  20912. []ExternalSecretDataFromRemoteRef
  20913. </a>
  20914. </em>
  20915. </td>
  20916. <td>
  20917. <em>(Optional)</em>
  20918. <p>DataFrom is used to fetch all properties from a specific Provider data
  20919. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  20920. </td>
  20921. </tr>
  20922. </tbody>
  20923. </table>
  20924. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus
  20925. </h3>
  20926. <p>
  20927. (<em>Appears on:</em>
  20928. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  20929. </p>
  20930. <p>
  20931. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  20932. </p>
  20933. <table>
  20934. <thead>
  20935. <tr>
  20936. <th>Field</th>
  20937. <th>Description</th>
  20938. </tr>
  20939. </thead>
  20940. <tbody>
  20941. <tr>
  20942. <td>
  20943. <code>refreshTime</code></br>
  20944. <em>
  20945. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  20946. Kubernetes meta/v1.Time
  20947. </a>
  20948. </em>
  20949. </td>
  20950. <td>
  20951. <p>refreshTime is the time and date the external secret was fetched and
  20952. the target secret updated</p>
  20953. </td>
  20954. </tr>
  20955. <tr>
  20956. <td>
  20957. <code>syncedResourceVersion</code></br>
  20958. <em>
  20959. string
  20960. </em>
  20961. </td>
  20962. <td>
  20963. <p>SyncedResourceVersion keeps track of the last synced version</p>
  20964. </td>
  20965. </tr>
  20966. <tr>
  20967. <td>
  20968. <code>conditions</code></br>
  20969. <em>
  20970. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">
  20971. []ExternalSecretStatusCondition
  20972. </a>
  20973. </em>
  20974. </td>
  20975. <td>
  20976. <em>(Optional)</em>
  20977. </td>
  20978. </tr>
  20979. <tr>
  20980. <td>
  20981. <code>binding</code></br>
  20982. <em>
  20983. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  20984. Kubernetes core/v1.LocalObjectReference
  20985. </a>
  20986. </em>
  20987. </td>
  20988. <td>
  20989. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  20990. </td>
  20991. </tr>
  20992. </tbody>
  20993. </table>
  20994. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  20995. </h3>
  20996. <p>
  20997. (<em>Appears on:</em>
  20998. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus</a>)
  20999. </p>
  21000. <p>
  21001. <p>ExternalSecretStatusCondition contains condition information for an ExternalSecret.</p>
  21002. </p>
  21003. <table>
  21004. <thead>
  21005. <tr>
  21006. <th>Field</th>
  21007. <th>Description</th>
  21008. </tr>
  21009. </thead>
  21010. <tbody>
  21011. <tr>
  21012. <td>
  21013. <code>type</code></br>
  21014. <em>
  21015. <a href="#external-secrets.io/v1beta1.ExternalSecretConditionType">
  21016. ExternalSecretConditionType
  21017. </a>
  21018. </em>
  21019. </td>
  21020. <td>
  21021. </td>
  21022. </tr>
  21023. <tr>
  21024. <td>
  21025. <code>status</code></br>
  21026. <em>
  21027. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  21028. Kubernetes core/v1.ConditionStatus
  21029. </a>
  21030. </em>
  21031. </td>
  21032. <td>
  21033. </td>
  21034. </tr>
  21035. <tr>
  21036. <td>
  21037. <code>reason</code></br>
  21038. <em>
  21039. string
  21040. </em>
  21041. </td>
  21042. <td>
  21043. <em>(Optional)</em>
  21044. </td>
  21045. </tr>
  21046. <tr>
  21047. <td>
  21048. <code>message</code></br>
  21049. <em>
  21050. string
  21051. </em>
  21052. </td>
  21053. <td>
  21054. <em>(Optional)</em>
  21055. </td>
  21056. </tr>
  21057. <tr>
  21058. <td>
  21059. <code>lastTransitionTime</code></br>
  21060. <em>
  21061. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  21062. Kubernetes meta/v1.Time
  21063. </a>
  21064. </em>
  21065. </td>
  21066. <td>
  21067. <em>(Optional)</em>
  21068. </td>
  21069. </tr>
  21070. </tbody>
  21071. </table>
  21072. <h3 id="external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget
  21073. </h3>
  21074. <p>
  21075. (<em>Appears on:</em>
  21076. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  21077. </p>
  21078. <p>
  21079. <p>ExternalSecretTarget defines the Kubernetes Secret to be created
  21080. There can be only one target per ExternalSecret.</p>
  21081. </p>
  21082. <table>
  21083. <thead>
  21084. <tr>
  21085. <th>Field</th>
  21086. <th>Description</th>
  21087. </tr>
  21088. </thead>
  21089. <tbody>
  21090. <tr>
  21091. <td>
  21092. <code>name</code></br>
  21093. <em>
  21094. string
  21095. </em>
  21096. </td>
  21097. <td>
  21098. <em>(Optional)</em>
  21099. <p>The name of the Secret resource to be managed.
  21100. Defaults to the .metadata.name of the ExternalSecret resource</p>
  21101. </td>
  21102. </tr>
  21103. <tr>
  21104. <td>
  21105. <code>creationPolicy</code></br>
  21106. <em>
  21107. <a href="#external-secrets.io/v1beta1.ExternalSecretCreationPolicy">
  21108. ExternalSecretCreationPolicy
  21109. </a>
  21110. </em>
  21111. </td>
  21112. <td>
  21113. <em>(Optional)</em>
  21114. <p>CreationPolicy defines rules on how to create the resulting Secret.
  21115. Defaults to &ldquo;Owner&rdquo;</p>
  21116. </td>
  21117. </tr>
  21118. <tr>
  21119. <td>
  21120. <code>deletionPolicy</code></br>
  21121. <em>
  21122. <a href="#external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">
  21123. ExternalSecretDeletionPolicy
  21124. </a>
  21125. </em>
  21126. </td>
  21127. <td>
  21128. <em>(Optional)</em>
  21129. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  21130. Defaults to &ldquo;Retain&rdquo;</p>
  21131. </td>
  21132. </tr>
  21133. <tr>
  21134. <td>
  21135. <code>template</code></br>
  21136. <em>
  21137. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">
  21138. ExternalSecretTemplate
  21139. </a>
  21140. </em>
  21141. </td>
  21142. <td>
  21143. <em>(Optional)</em>
  21144. <p>Template defines a blueprint for the created Secret resource.</p>
  21145. </td>
  21146. </tr>
  21147. <tr>
  21148. <td>
  21149. <code>immutable</code></br>
  21150. <em>
  21151. bool
  21152. </em>
  21153. </td>
  21154. <td>
  21155. <em>(Optional)</em>
  21156. <p>Immutable defines if the final secret will be immutable</p>
  21157. </td>
  21158. </tr>
  21159. </tbody>
  21160. </table>
  21161. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate
  21162. </h3>
  21163. <p>
  21164. (<em>Appears on:</em>
  21165. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  21166. </p>
  21167. <p>
  21168. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  21169. 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>
  21170. </p>
  21171. <table>
  21172. <thead>
  21173. <tr>
  21174. <th>Field</th>
  21175. <th>Description</th>
  21176. </tr>
  21177. </thead>
  21178. <tbody>
  21179. <tr>
  21180. <td>
  21181. <code>type</code></br>
  21182. <em>
  21183. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  21184. Kubernetes core/v1.SecretType
  21185. </a>
  21186. </em>
  21187. </td>
  21188. <td>
  21189. <em>(Optional)</em>
  21190. </td>
  21191. </tr>
  21192. <tr>
  21193. <td>
  21194. <code>engineVersion</code></br>
  21195. <em>
  21196. <a href="#external-secrets.io/v1beta1.TemplateEngineVersion">
  21197. TemplateEngineVersion
  21198. </a>
  21199. </em>
  21200. </td>
  21201. <td>
  21202. <p>EngineVersion specifies the template engine version
  21203. that should be used to compile/execute the
  21204. template specified in .data and .templateFrom[].</p>
  21205. </td>
  21206. </tr>
  21207. <tr>
  21208. <td>
  21209. <code>metadata</code></br>
  21210. <em>
  21211. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">
  21212. ExternalSecretTemplateMetadata
  21213. </a>
  21214. </em>
  21215. </td>
  21216. <td>
  21217. <em>(Optional)</em>
  21218. </td>
  21219. </tr>
  21220. <tr>
  21221. <td>
  21222. <code>mergePolicy</code></br>
  21223. <em>
  21224. <a href="#external-secrets.io/v1beta1.TemplateMergePolicy">
  21225. TemplateMergePolicy
  21226. </a>
  21227. </em>
  21228. </td>
  21229. <td>
  21230. </td>
  21231. </tr>
  21232. <tr>
  21233. <td>
  21234. <code>data</code></br>
  21235. <em>
  21236. map[string]string
  21237. </em>
  21238. </td>
  21239. <td>
  21240. <em>(Optional)</em>
  21241. </td>
  21242. </tr>
  21243. <tr>
  21244. <td>
  21245. <code>templateFrom</code></br>
  21246. <em>
  21247. <a href="#external-secrets.io/v1beta1.TemplateFrom">
  21248. []TemplateFrom
  21249. </a>
  21250. </em>
  21251. </td>
  21252. <td>
  21253. <em>(Optional)</em>
  21254. </td>
  21255. </tr>
  21256. </tbody>
  21257. </table>
  21258. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  21259. </h3>
  21260. <p>
  21261. (<em>Appears on:</em>
  21262. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  21263. </p>
  21264. <p>
  21265. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  21266. </p>
  21267. <table>
  21268. <thead>
  21269. <tr>
  21270. <th>Field</th>
  21271. <th>Description</th>
  21272. </tr>
  21273. </thead>
  21274. <tbody>
  21275. <tr>
  21276. <td>
  21277. <code>annotations</code></br>
  21278. <em>
  21279. map[string]string
  21280. </em>
  21281. </td>
  21282. <td>
  21283. <em>(Optional)</em>
  21284. </td>
  21285. </tr>
  21286. <tr>
  21287. <td>
  21288. <code>labels</code></br>
  21289. <em>
  21290. map[string]string
  21291. </em>
  21292. </td>
  21293. <td>
  21294. <em>(Optional)</em>
  21295. </td>
  21296. </tr>
  21297. </tbody>
  21298. </table>
  21299. <h3 id="external-secrets.io/v1beta1.ExternalSecretValidator">ExternalSecretValidator
  21300. </h3>
  21301. <p>
  21302. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  21303. </p>
  21304. <h3 id="external-secrets.io/v1beta1.FakeProvider">FakeProvider
  21305. </h3>
  21306. <p>
  21307. (<em>Appears on:</em>
  21308. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21309. </p>
  21310. <p>
  21311. <p>FakeProvider configures a fake provider that returns static values.</p>
  21312. </p>
  21313. <table>
  21314. <thead>
  21315. <tr>
  21316. <th>Field</th>
  21317. <th>Description</th>
  21318. </tr>
  21319. </thead>
  21320. <tbody>
  21321. <tr>
  21322. <td>
  21323. <code>data</code></br>
  21324. <em>
  21325. <a href="#external-secrets.io/v1beta1.FakeProviderData">
  21326. []FakeProviderData
  21327. </a>
  21328. </em>
  21329. </td>
  21330. <td>
  21331. </td>
  21332. </tr>
  21333. </tbody>
  21334. </table>
  21335. <h3 id="external-secrets.io/v1beta1.FakeProviderData">FakeProviderData
  21336. </h3>
  21337. <p>
  21338. (<em>Appears on:</em>
  21339. <a href="#external-secrets.io/v1beta1.FakeProvider">FakeProvider</a>)
  21340. </p>
  21341. <p>
  21342. <p>FakeProviderData defines a key-value pair for the fake provider used in testing.</p>
  21343. </p>
  21344. <table>
  21345. <thead>
  21346. <tr>
  21347. <th>Field</th>
  21348. <th>Description</th>
  21349. </tr>
  21350. </thead>
  21351. <tbody>
  21352. <tr>
  21353. <td>
  21354. <code>key</code></br>
  21355. <em>
  21356. string
  21357. </em>
  21358. </td>
  21359. <td>
  21360. </td>
  21361. </tr>
  21362. <tr>
  21363. <td>
  21364. <code>value</code></br>
  21365. <em>
  21366. string
  21367. </em>
  21368. </td>
  21369. <td>
  21370. </td>
  21371. </tr>
  21372. <tr>
  21373. <td>
  21374. <code>version</code></br>
  21375. <em>
  21376. string
  21377. </em>
  21378. </td>
  21379. <td>
  21380. </td>
  21381. </tr>
  21382. </tbody>
  21383. </table>
  21384. <h3 id="external-secrets.io/v1beta1.FindName">FindName
  21385. </h3>
  21386. <p>
  21387. (<em>Appears on:</em>
  21388. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  21389. </p>
  21390. <p>
  21391. <p>FindName defines name matching criteria for finding secrets.</p>
  21392. </p>
  21393. <table>
  21394. <thead>
  21395. <tr>
  21396. <th>Field</th>
  21397. <th>Description</th>
  21398. </tr>
  21399. </thead>
  21400. <tbody>
  21401. <tr>
  21402. <td>
  21403. <code>regexp</code></br>
  21404. <em>
  21405. string
  21406. </em>
  21407. </td>
  21408. <td>
  21409. <em>(Optional)</em>
  21410. <p>Finds secrets base</p>
  21411. </td>
  21412. </tr>
  21413. </tbody>
  21414. </table>
  21415. <h3 id="external-secrets.io/v1beta1.FortanixProvider">FortanixProvider
  21416. </h3>
  21417. <p>
  21418. (<em>Appears on:</em>
  21419. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21420. </p>
  21421. <p>
  21422. <p>FortanixProvider configures a store to sync secrets using the Fortanix SDKMS provider.</p>
  21423. </p>
  21424. <table>
  21425. <thead>
  21426. <tr>
  21427. <th>Field</th>
  21428. <th>Description</th>
  21429. </tr>
  21430. </thead>
  21431. <tbody>
  21432. <tr>
  21433. <td>
  21434. <code>apiUrl</code></br>
  21435. <em>
  21436. string
  21437. </em>
  21438. </td>
  21439. <td>
  21440. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  21441. </td>
  21442. </tr>
  21443. <tr>
  21444. <td>
  21445. <code>apiKey</code></br>
  21446. <em>
  21447. <a href="#external-secrets.io/v1beta1.FortanixProviderSecretRef">
  21448. FortanixProviderSecretRef
  21449. </a>
  21450. </em>
  21451. </td>
  21452. <td>
  21453. <p>APIKey is the API token to access SDKMS Applications.</p>
  21454. </td>
  21455. </tr>
  21456. </tbody>
  21457. </table>
  21458. <h3 id="external-secrets.io/v1beta1.FortanixProviderSecretRef">FortanixProviderSecretRef
  21459. </h3>
  21460. <p>
  21461. (<em>Appears on:</em>
  21462. <a href="#external-secrets.io/v1beta1.FortanixProvider">FortanixProvider</a>)
  21463. </p>
  21464. <p>
  21465. <p>FortanixProviderSecretRef defines a reference to a secret containing credentials for the Fortanix provider.</p>
  21466. </p>
  21467. <table>
  21468. <thead>
  21469. <tr>
  21470. <th>Field</th>
  21471. <th>Description</th>
  21472. </tr>
  21473. </thead>
  21474. <tbody>
  21475. <tr>
  21476. <td>
  21477. <code>secretRef</code></br>
  21478. <em>
  21479. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21480. External Secrets meta/v1.SecretKeySelector
  21481. </a>
  21482. </em>
  21483. </td>
  21484. <td>
  21485. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  21486. </td>
  21487. </tr>
  21488. </tbody>
  21489. </table>
  21490. <h3 id="external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth
  21491. </h3>
  21492. <p>
  21493. (<em>Appears on:</em>
  21494. <a href="#external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider</a>)
  21495. </p>
  21496. <p>
  21497. <p>GCPSMAuth defines the authentication methods for the GCP Secret Manager provider.</p>
  21498. </p>
  21499. <table>
  21500. <thead>
  21501. <tr>
  21502. <th>Field</th>
  21503. <th>Description</th>
  21504. </tr>
  21505. </thead>
  21506. <tbody>
  21507. <tr>
  21508. <td>
  21509. <code>secretRef</code></br>
  21510. <em>
  21511. <a href="#external-secrets.io/v1beta1.GCPSMAuthSecretRef">
  21512. GCPSMAuthSecretRef
  21513. </a>
  21514. </em>
  21515. </td>
  21516. <td>
  21517. <em>(Optional)</em>
  21518. </td>
  21519. </tr>
  21520. <tr>
  21521. <td>
  21522. <code>workloadIdentity</code></br>
  21523. <em>
  21524. <a href="#external-secrets.io/v1beta1.GCPWorkloadIdentity">
  21525. GCPWorkloadIdentity
  21526. </a>
  21527. </em>
  21528. </td>
  21529. <td>
  21530. <em>(Optional)</em>
  21531. </td>
  21532. </tr>
  21533. </tbody>
  21534. </table>
  21535. <h3 id="external-secrets.io/v1beta1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  21536. </h3>
  21537. <p>
  21538. (<em>Appears on:</em>
  21539. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  21540. </p>
  21541. <p>
  21542. <p>GCPSMAuthSecretRef defines a reference to a secret containing credentials for the GCP Secret Manager provider.</p>
  21543. </p>
  21544. <table>
  21545. <thead>
  21546. <tr>
  21547. <th>Field</th>
  21548. <th>Description</th>
  21549. </tr>
  21550. </thead>
  21551. <tbody>
  21552. <tr>
  21553. <td>
  21554. <code>secretAccessKeySecretRef</code></br>
  21555. <em>
  21556. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21557. External Secrets meta/v1.SecretKeySelector
  21558. </a>
  21559. </em>
  21560. </td>
  21561. <td>
  21562. <em>(Optional)</em>
  21563. <p>The SecretAccessKey is used for authentication</p>
  21564. </td>
  21565. </tr>
  21566. </tbody>
  21567. </table>
  21568. <h3 id="external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider
  21569. </h3>
  21570. <p>
  21571. (<em>Appears on:</em>
  21572. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21573. </p>
  21574. <p>
  21575. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  21576. </p>
  21577. <table>
  21578. <thead>
  21579. <tr>
  21580. <th>Field</th>
  21581. <th>Description</th>
  21582. </tr>
  21583. </thead>
  21584. <tbody>
  21585. <tr>
  21586. <td>
  21587. <code>auth</code></br>
  21588. <em>
  21589. <a href="#external-secrets.io/v1beta1.GCPSMAuth">
  21590. GCPSMAuth
  21591. </a>
  21592. </em>
  21593. </td>
  21594. <td>
  21595. <em>(Optional)</em>
  21596. <p>Auth defines the information necessary to authenticate against GCP</p>
  21597. </td>
  21598. </tr>
  21599. <tr>
  21600. <td>
  21601. <code>projectID</code></br>
  21602. <em>
  21603. string
  21604. </em>
  21605. </td>
  21606. <td>
  21607. <p>ProjectID project where secret is located</p>
  21608. </td>
  21609. </tr>
  21610. <tr>
  21611. <td>
  21612. <code>location</code></br>
  21613. <em>
  21614. string
  21615. </em>
  21616. </td>
  21617. <td>
  21618. <p>Location optionally defines a location for a secret</p>
  21619. </td>
  21620. </tr>
  21621. </tbody>
  21622. </table>
  21623. <h3 id="external-secrets.io/v1beta1.GCPWorkloadIdentity">GCPWorkloadIdentity
  21624. </h3>
  21625. <p>
  21626. (<em>Appears on:</em>
  21627. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  21628. </p>
  21629. <p>
  21630. <p>GCPWorkloadIdentity defines configuration for using GCP Workload Identity authentication.</p>
  21631. </p>
  21632. <table>
  21633. <thead>
  21634. <tr>
  21635. <th>Field</th>
  21636. <th>Description</th>
  21637. </tr>
  21638. </thead>
  21639. <tbody>
  21640. <tr>
  21641. <td>
  21642. <code>serviceAccountRef</code></br>
  21643. <em>
  21644. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  21645. External Secrets meta/v1.ServiceAccountSelector
  21646. </a>
  21647. </em>
  21648. </td>
  21649. <td>
  21650. </td>
  21651. </tr>
  21652. <tr>
  21653. <td>
  21654. <code>clusterLocation</code></br>
  21655. <em>
  21656. string
  21657. </em>
  21658. </td>
  21659. <td>
  21660. <em>(Optional)</em>
  21661. <p>ClusterLocation is the location of the cluster
  21662. If not specified, it fetches information from the metadata server</p>
  21663. </td>
  21664. </tr>
  21665. <tr>
  21666. <td>
  21667. <code>clusterName</code></br>
  21668. <em>
  21669. string
  21670. </em>
  21671. </td>
  21672. <td>
  21673. <em>(Optional)</em>
  21674. <p>ClusterName is the name of the cluster
  21675. If not specified, it fetches information from the metadata server</p>
  21676. </td>
  21677. </tr>
  21678. <tr>
  21679. <td>
  21680. <code>clusterProjectID</code></br>
  21681. <em>
  21682. string
  21683. </em>
  21684. </td>
  21685. <td>
  21686. <em>(Optional)</em>
  21687. <p>ClusterProjectID is the project ID of the cluster
  21688. If not specified, it fetches information from the metadata server</p>
  21689. </td>
  21690. </tr>
  21691. </tbody>
  21692. </table>
  21693. <h3 id="external-secrets.io/v1beta1.GeneratorRef">GeneratorRef
  21694. </h3>
  21695. <p>
  21696. (<em>Appears on:</em>
  21697. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  21698. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  21699. </p>
  21700. <p>
  21701. <p>GeneratorRef points to a generator custom resource.</p>
  21702. </p>
  21703. <table>
  21704. <thead>
  21705. <tr>
  21706. <th>Field</th>
  21707. <th>Description</th>
  21708. </tr>
  21709. </thead>
  21710. <tbody>
  21711. <tr>
  21712. <td>
  21713. <code>apiVersion</code></br>
  21714. <em>
  21715. string
  21716. </em>
  21717. </td>
  21718. <td>
  21719. <p>Specify the apiVersion of the generator resource</p>
  21720. </td>
  21721. </tr>
  21722. <tr>
  21723. <td>
  21724. <code>kind</code></br>
  21725. <em>
  21726. string
  21727. </em>
  21728. </td>
  21729. <td>
  21730. <p>Specify the Kind of the generator resource</p>
  21731. </td>
  21732. </tr>
  21733. <tr>
  21734. <td>
  21735. <code>name</code></br>
  21736. <em>
  21737. string
  21738. </em>
  21739. </td>
  21740. <td>
  21741. <p>Specify the name of the generator resource</p>
  21742. </td>
  21743. </tr>
  21744. </tbody>
  21745. </table>
  21746. <h3 id="external-secrets.io/v1beta1.GenericClusterStoreValidator">GenericClusterStoreValidator
  21747. </h3>
  21748. <p>
  21749. <p>GenericClusterStoreValidator provides validation for ClusterSecretStore resources.</p>
  21750. </p>
  21751. <h3 id="external-secrets.io/v1beta1.GenericStore">GenericStore
  21752. </h3>
  21753. <p>
  21754. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  21755. or a namespaced SecretStore.</p>
  21756. </p>
  21757. <h3 id="external-secrets.io/v1beta1.GenericStoreValidator">GenericStoreValidator
  21758. </h3>
  21759. <p>
  21760. <p>GenericStoreValidator provides validation for SecretStore resources.</p>
  21761. </p>
  21762. <h3 id="external-secrets.io/v1beta1.GithubAppAuth">GithubAppAuth
  21763. </h3>
  21764. <p>
  21765. (<em>Appears on:</em>
  21766. <a href="#external-secrets.io/v1beta1.GithubProvider">GithubProvider</a>)
  21767. </p>
  21768. <p>
  21769. <p>GithubAppAuth defines the GitHub App authentication mechanism for the GitHub provider.</p>
  21770. </p>
  21771. <table>
  21772. <thead>
  21773. <tr>
  21774. <th>Field</th>
  21775. <th>Description</th>
  21776. </tr>
  21777. </thead>
  21778. <tbody>
  21779. <tr>
  21780. <td>
  21781. <code>privateKey</code></br>
  21782. <em>
  21783. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21784. External Secrets meta/v1.SecretKeySelector
  21785. </a>
  21786. </em>
  21787. </td>
  21788. <td>
  21789. </td>
  21790. </tr>
  21791. </tbody>
  21792. </table>
  21793. <h3 id="external-secrets.io/v1beta1.GithubProvider">GithubProvider
  21794. </h3>
  21795. <p>
  21796. (<em>Appears on:</em>
  21797. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21798. </p>
  21799. <p>
  21800. <p>GithubProvider configures a store to push secrets to Github Actions.</p>
  21801. </p>
  21802. <table>
  21803. <thead>
  21804. <tr>
  21805. <th>Field</th>
  21806. <th>Description</th>
  21807. </tr>
  21808. </thead>
  21809. <tbody>
  21810. <tr>
  21811. <td>
  21812. <code>url</code></br>
  21813. <em>
  21814. string
  21815. </em>
  21816. </td>
  21817. <td>
  21818. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  21819. </td>
  21820. </tr>
  21821. <tr>
  21822. <td>
  21823. <code>uploadURL</code></br>
  21824. <em>
  21825. string
  21826. </em>
  21827. </td>
  21828. <td>
  21829. <em>(Optional)</em>
  21830. <p>Upload URL for enterprise instances. Default to URL.</p>
  21831. </td>
  21832. </tr>
  21833. <tr>
  21834. <td>
  21835. <code>auth</code></br>
  21836. <em>
  21837. <a href="#external-secrets.io/v1beta1.GithubAppAuth">
  21838. GithubAppAuth
  21839. </a>
  21840. </em>
  21841. </td>
  21842. <td>
  21843. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  21844. </td>
  21845. </tr>
  21846. <tr>
  21847. <td>
  21848. <code>appID</code></br>
  21849. <em>
  21850. int64
  21851. </em>
  21852. </td>
  21853. <td>
  21854. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  21855. </td>
  21856. </tr>
  21857. <tr>
  21858. <td>
  21859. <code>installationID</code></br>
  21860. <em>
  21861. int64
  21862. </em>
  21863. </td>
  21864. <td>
  21865. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  21866. </td>
  21867. </tr>
  21868. <tr>
  21869. <td>
  21870. <code>organization</code></br>
  21871. <em>
  21872. string
  21873. </em>
  21874. </td>
  21875. <td>
  21876. <p>organization will be used to fetch secrets from the Github organization</p>
  21877. </td>
  21878. </tr>
  21879. <tr>
  21880. <td>
  21881. <code>repository</code></br>
  21882. <em>
  21883. string
  21884. </em>
  21885. </td>
  21886. <td>
  21887. <em>(Optional)</em>
  21888. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  21889. </td>
  21890. </tr>
  21891. <tr>
  21892. <td>
  21893. <code>environment</code></br>
  21894. <em>
  21895. string
  21896. </em>
  21897. </td>
  21898. <td>
  21899. <em>(Optional)</em>
  21900. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  21901. </td>
  21902. </tr>
  21903. </tbody>
  21904. </table>
  21905. <h3 id="external-secrets.io/v1beta1.GitlabAuth">GitlabAuth
  21906. </h3>
  21907. <p>
  21908. (<em>Appears on:</em>
  21909. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>)
  21910. </p>
  21911. <p>
  21912. <p>GitlabAuth defines the authentication method for the GitLab provider.</p>
  21913. </p>
  21914. <table>
  21915. <thead>
  21916. <tr>
  21917. <th>Field</th>
  21918. <th>Description</th>
  21919. </tr>
  21920. </thead>
  21921. <tbody>
  21922. <tr>
  21923. <td>
  21924. <code>SecretRef</code></br>
  21925. <em>
  21926. <a href="#external-secrets.io/v1beta1.GitlabSecretRef">
  21927. GitlabSecretRef
  21928. </a>
  21929. </em>
  21930. </td>
  21931. <td>
  21932. </td>
  21933. </tr>
  21934. </tbody>
  21935. </table>
  21936. <h3 id="external-secrets.io/v1beta1.GitlabProvider">GitlabProvider
  21937. </h3>
  21938. <p>
  21939. (<em>Appears on:</em>
  21940. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21941. </p>
  21942. <p>
  21943. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  21944. </p>
  21945. <table>
  21946. <thead>
  21947. <tr>
  21948. <th>Field</th>
  21949. <th>Description</th>
  21950. </tr>
  21951. </thead>
  21952. <tbody>
  21953. <tr>
  21954. <td>
  21955. <code>url</code></br>
  21956. <em>
  21957. string
  21958. </em>
  21959. </td>
  21960. <td>
  21961. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  21962. </td>
  21963. </tr>
  21964. <tr>
  21965. <td>
  21966. <code>auth</code></br>
  21967. <em>
  21968. <a href="#external-secrets.io/v1beta1.GitlabAuth">
  21969. GitlabAuth
  21970. </a>
  21971. </em>
  21972. </td>
  21973. <td>
  21974. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  21975. </td>
  21976. </tr>
  21977. <tr>
  21978. <td>
  21979. <code>projectID</code></br>
  21980. <em>
  21981. string
  21982. </em>
  21983. </td>
  21984. <td>
  21985. <p>ProjectID specifies a project where secrets are located.</p>
  21986. </td>
  21987. </tr>
  21988. <tr>
  21989. <td>
  21990. <code>inheritFromGroups</code></br>
  21991. <em>
  21992. bool
  21993. </em>
  21994. </td>
  21995. <td>
  21996. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  21997. </td>
  21998. </tr>
  21999. <tr>
  22000. <td>
  22001. <code>groupIDs</code></br>
  22002. <em>
  22003. []string
  22004. </em>
  22005. </td>
  22006. <td>
  22007. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  22008. </td>
  22009. </tr>
  22010. <tr>
  22011. <td>
  22012. <code>environment</code></br>
  22013. <em>
  22014. string
  22015. </em>
  22016. </td>
  22017. <td>
  22018. <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>
  22019. </td>
  22020. </tr>
  22021. <tr>
  22022. <td>
  22023. <code>caBundle</code></br>
  22024. <em>
  22025. []byte
  22026. </em>
  22027. </td>
  22028. <td>
  22029. <em>(Optional)</em>
  22030. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  22031. can be performed.</p>
  22032. </td>
  22033. </tr>
  22034. <tr>
  22035. <td>
  22036. <code>caProvider</code></br>
  22037. <em>
  22038. <a href="#external-secrets.io/v1beta1.CAProvider">
  22039. CAProvider
  22040. </a>
  22041. </em>
  22042. </td>
  22043. <td>
  22044. <em>(Optional)</em>
  22045. <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>
  22046. </td>
  22047. </tr>
  22048. </tbody>
  22049. </table>
  22050. <h3 id="external-secrets.io/v1beta1.GitlabSecretRef">GitlabSecretRef
  22051. </h3>
  22052. <p>
  22053. (<em>Appears on:</em>
  22054. <a href="#external-secrets.io/v1beta1.GitlabAuth">GitlabAuth</a>)
  22055. </p>
  22056. <p>
  22057. <p>GitlabSecretRef defines a reference to a secret containing credentials for the GitLab provider.</p>
  22058. </p>
  22059. <table>
  22060. <thead>
  22061. <tr>
  22062. <th>Field</th>
  22063. <th>Description</th>
  22064. </tr>
  22065. </thead>
  22066. <tbody>
  22067. <tr>
  22068. <td>
  22069. <code>accessToken</code></br>
  22070. <em>
  22071. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22072. External Secrets meta/v1.SecretKeySelector
  22073. </a>
  22074. </em>
  22075. </td>
  22076. <td>
  22077. <p>AccessToken is used for authentication.</p>
  22078. </td>
  22079. </tr>
  22080. </tbody>
  22081. </table>
  22082. <h3 id="external-secrets.io/v1beta1.IBMAuth">IBMAuth
  22083. </h3>
  22084. <p>
  22085. (<em>Appears on:</em>
  22086. <a href="#external-secrets.io/v1beta1.IBMProvider">IBMProvider</a>)
  22087. </p>
  22088. <p>
  22089. <p>IBMAuth defines the authentication methods for the IBM Cloud Secrets Manager provider.</p>
  22090. </p>
  22091. <table>
  22092. <thead>
  22093. <tr>
  22094. <th>Field</th>
  22095. <th>Description</th>
  22096. </tr>
  22097. </thead>
  22098. <tbody>
  22099. <tr>
  22100. <td>
  22101. <code>secretRef</code></br>
  22102. <em>
  22103. <a href="#external-secrets.io/v1beta1.IBMAuthSecretRef">
  22104. IBMAuthSecretRef
  22105. </a>
  22106. </em>
  22107. </td>
  22108. <td>
  22109. </td>
  22110. </tr>
  22111. <tr>
  22112. <td>
  22113. <code>containerAuth</code></br>
  22114. <em>
  22115. <a href="#external-secrets.io/v1beta1.IBMAuthContainerAuth">
  22116. IBMAuthContainerAuth
  22117. </a>
  22118. </em>
  22119. </td>
  22120. <td>
  22121. </td>
  22122. </tr>
  22123. </tbody>
  22124. </table>
  22125. <h3 id="external-secrets.io/v1beta1.IBMAuthContainerAuth">IBMAuthContainerAuth
  22126. </h3>
  22127. <p>
  22128. (<em>Appears on:</em>
  22129. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  22130. </p>
  22131. <p>
  22132. <p>IBMAuthContainerAuth defines authentication using IBM Container-based auth with IAM Trusted Profile.</p>
  22133. </p>
  22134. <table>
  22135. <thead>
  22136. <tr>
  22137. <th>Field</th>
  22138. <th>Description</th>
  22139. </tr>
  22140. </thead>
  22141. <tbody>
  22142. <tr>
  22143. <td>
  22144. <code>profile</code></br>
  22145. <em>
  22146. string
  22147. </em>
  22148. </td>
  22149. <td>
  22150. <p>the IBM Trusted Profile</p>
  22151. </td>
  22152. </tr>
  22153. <tr>
  22154. <td>
  22155. <code>tokenLocation</code></br>
  22156. <em>
  22157. string
  22158. </em>
  22159. </td>
  22160. <td>
  22161. <p>Location the token is mounted on the pod</p>
  22162. </td>
  22163. </tr>
  22164. <tr>
  22165. <td>
  22166. <code>iamEndpoint</code></br>
  22167. <em>
  22168. string
  22169. </em>
  22170. </td>
  22171. <td>
  22172. </td>
  22173. </tr>
  22174. </tbody>
  22175. </table>
  22176. <h3 id="external-secrets.io/v1beta1.IBMAuthSecretRef">IBMAuthSecretRef
  22177. </h3>
  22178. <p>
  22179. (<em>Appears on:</em>
  22180. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  22181. </p>
  22182. <p>
  22183. <p>IBMAuthSecretRef defines a reference to a secret containing credentials for the IBM provider.</p>
  22184. </p>
  22185. <table>
  22186. <thead>
  22187. <tr>
  22188. <th>Field</th>
  22189. <th>Description</th>
  22190. </tr>
  22191. </thead>
  22192. <tbody>
  22193. <tr>
  22194. <td>
  22195. <code>secretApiKeySecretRef</code></br>
  22196. <em>
  22197. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22198. External Secrets meta/v1.SecretKeySelector
  22199. </a>
  22200. </em>
  22201. </td>
  22202. <td>
  22203. <p>The SecretAccessKey is used for authentication</p>
  22204. </td>
  22205. </tr>
  22206. </tbody>
  22207. </table>
  22208. <h3 id="external-secrets.io/v1beta1.IBMProvider">IBMProvider
  22209. </h3>
  22210. <p>
  22211. (<em>Appears on:</em>
  22212. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22213. </p>
  22214. <p>
  22215. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager backend.</p>
  22216. </p>
  22217. <table>
  22218. <thead>
  22219. <tr>
  22220. <th>Field</th>
  22221. <th>Description</th>
  22222. </tr>
  22223. </thead>
  22224. <tbody>
  22225. <tr>
  22226. <td>
  22227. <code>auth</code></br>
  22228. <em>
  22229. <a href="#external-secrets.io/v1beta1.IBMAuth">
  22230. IBMAuth
  22231. </a>
  22232. </em>
  22233. </td>
  22234. <td>
  22235. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  22236. </td>
  22237. </tr>
  22238. <tr>
  22239. <td>
  22240. <code>serviceUrl</code></br>
  22241. <em>
  22242. string
  22243. </em>
  22244. </td>
  22245. <td>
  22246. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  22247. </td>
  22248. </tr>
  22249. </tbody>
  22250. </table>
  22251. <h3 id="external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth
  22252. </h3>
  22253. <p>
  22254. (<em>Appears on:</em>
  22255. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  22256. </p>
  22257. <p>
  22258. <p>InfisicalAuth defines the authentication methods for the Infisical provider.</p>
  22259. </p>
  22260. <table>
  22261. <thead>
  22262. <tr>
  22263. <th>Field</th>
  22264. <th>Description</th>
  22265. </tr>
  22266. </thead>
  22267. <tbody>
  22268. <tr>
  22269. <td>
  22270. <code>universalAuthCredentials</code></br>
  22271. <em>
  22272. <a href="#external-secrets.io/v1beta1.UniversalAuthCredentials">
  22273. UniversalAuthCredentials
  22274. </a>
  22275. </em>
  22276. </td>
  22277. <td>
  22278. <em>(Optional)</em>
  22279. </td>
  22280. </tr>
  22281. </tbody>
  22282. </table>
  22283. <h3 id="external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider
  22284. </h3>
  22285. <p>
  22286. (<em>Appears on:</em>
  22287. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22288. </p>
  22289. <p>
  22290. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  22291. </p>
  22292. <table>
  22293. <thead>
  22294. <tr>
  22295. <th>Field</th>
  22296. <th>Description</th>
  22297. </tr>
  22298. </thead>
  22299. <tbody>
  22300. <tr>
  22301. <td>
  22302. <code>auth</code></br>
  22303. <em>
  22304. <a href="#external-secrets.io/v1beta1.InfisicalAuth">
  22305. InfisicalAuth
  22306. </a>
  22307. </em>
  22308. </td>
  22309. <td>
  22310. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  22311. </td>
  22312. </tr>
  22313. <tr>
  22314. <td>
  22315. <code>secretsScope</code></br>
  22316. <em>
  22317. <a href="#external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">
  22318. MachineIdentityScopeInWorkspace
  22319. </a>
  22320. </em>
  22321. </td>
  22322. <td>
  22323. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  22324. </td>
  22325. </tr>
  22326. <tr>
  22327. <td>
  22328. <code>hostAPI</code></br>
  22329. <em>
  22330. string
  22331. </em>
  22332. </td>
  22333. <td>
  22334. <em>(Optional)</em>
  22335. <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>
  22336. </td>
  22337. </tr>
  22338. </tbody>
  22339. </table>
  22340. <h3 id="external-secrets.io/v1beta1.KeeperSecurityProvider">KeeperSecurityProvider
  22341. </h3>
  22342. <p>
  22343. (<em>Appears on:</em>
  22344. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22345. </p>
  22346. <p>
  22347. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  22348. </p>
  22349. <table>
  22350. <thead>
  22351. <tr>
  22352. <th>Field</th>
  22353. <th>Description</th>
  22354. </tr>
  22355. </thead>
  22356. <tbody>
  22357. <tr>
  22358. <td>
  22359. <code>authRef</code></br>
  22360. <em>
  22361. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22362. External Secrets meta/v1.SecretKeySelector
  22363. </a>
  22364. </em>
  22365. </td>
  22366. <td>
  22367. </td>
  22368. </tr>
  22369. <tr>
  22370. <td>
  22371. <code>folderID</code></br>
  22372. <em>
  22373. string
  22374. </em>
  22375. </td>
  22376. <td>
  22377. </td>
  22378. </tr>
  22379. </tbody>
  22380. </table>
  22381. <h3 id="external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth
  22382. </h3>
  22383. <p>
  22384. (<em>Appears on:</em>
  22385. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  22386. </p>
  22387. <p>
  22388. <p>KubernetesAuth defines authentication methods for the Kubernetes provider.</p>
  22389. </p>
  22390. <table>
  22391. <thead>
  22392. <tr>
  22393. <th>Field</th>
  22394. <th>Description</th>
  22395. </tr>
  22396. </thead>
  22397. <tbody>
  22398. <tr>
  22399. <td>
  22400. <code>cert</code></br>
  22401. <em>
  22402. <a href="#external-secrets.io/v1beta1.CertAuth">
  22403. CertAuth
  22404. </a>
  22405. </em>
  22406. </td>
  22407. <td>
  22408. <em>(Optional)</em>
  22409. <p>has both clientCert and clientKey as secretKeySelector</p>
  22410. </td>
  22411. </tr>
  22412. <tr>
  22413. <td>
  22414. <code>token</code></br>
  22415. <em>
  22416. <a href="#external-secrets.io/v1beta1.TokenAuth">
  22417. TokenAuth
  22418. </a>
  22419. </em>
  22420. </td>
  22421. <td>
  22422. <em>(Optional)</em>
  22423. <p>use static token to authenticate with</p>
  22424. </td>
  22425. </tr>
  22426. <tr>
  22427. <td>
  22428. <code>serviceAccount</code></br>
  22429. <em>
  22430. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  22431. External Secrets meta/v1.ServiceAccountSelector
  22432. </a>
  22433. </em>
  22434. </td>
  22435. <td>
  22436. <em>(Optional)</em>
  22437. <p>points to a service account that should be used for authentication</p>
  22438. </td>
  22439. </tr>
  22440. </tbody>
  22441. </table>
  22442. <h3 id="external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider
  22443. </h3>
  22444. <p>
  22445. (<em>Appears on:</em>
  22446. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22447. </p>
  22448. <p>
  22449. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  22450. </p>
  22451. <table>
  22452. <thead>
  22453. <tr>
  22454. <th>Field</th>
  22455. <th>Description</th>
  22456. </tr>
  22457. </thead>
  22458. <tbody>
  22459. <tr>
  22460. <td>
  22461. <code>server</code></br>
  22462. <em>
  22463. <a href="#external-secrets.io/v1beta1.KubernetesServer">
  22464. KubernetesServer
  22465. </a>
  22466. </em>
  22467. </td>
  22468. <td>
  22469. <em>(Optional)</em>
  22470. <p>configures the Kubernetes server Address.</p>
  22471. </td>
  22472. </tr>
  22473. <tr>
  22474. <td>
  22475. <code>auth</code></br>
  22476. <em>
  22477. <a href="#external-secrets.io/v1beta1.KubernetesAuth">
  22478. KubernetesAuth
  22479. </a>
  22480. </em>
  22481. </td>
  22482. <td>
  22483. <em>(Optional)</em>
  22484. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  22485. </td>
  22486. </tr>
  22487. <tr>
  22488. <td>
  22489. <code>authRef</code></br>
  22490. <em>
  22491. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22492. External Secrets meta/v1.SecretKeySelector
  22493. </a>
  22494. </em>
  22495. </td>
  22496. <td>
  22497. <em>(Optional)</em>
  22498. <p>A reference to a secret that contains the auth information.</p>
  22499. </td>
  22500. </tr>
  22501. <tr>
  22502. <td>
  22503. <code>remoteNamespace</code></br>
  22504. <em>
  22505. string
  22506. </em>
  22507. </td>
  22508. <td>
  22509. <em>(Optional)</em>
  22510. <p>Remote namespace to fetch the secrets from</p>
  22511. </td>
  22512. </tr>
  22513. </tbody>
  22514. </table>
  22515. <h3 id="external-secrets.io/v1beta1.KubernetesServer">KubernetesServer
  22516. </h3>
  22517. <p>
  22518. (<em>Appears on:</em>
  22519. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  22520. </p>
  22521. <p>
  22522. <p>KubernetesServer defines the Kubernetes server connection configuration.</p>
  22523. </p>
  22524. <table>
  22525. <thead>
  22526. <tr>
  22527. <th>Field</th>
  22528. <th>Description</th>
  22529. </tr>
  22530. </thead>
  22531. <tbody>
  22532. <tr>
  22533. <td>
  22534. <code>url</code></br>
  22535. <em>
  22536. string
  22537. </em>
  22538. </td>
  22539. <td>
  22540. <em>(Optional)</em>
  22541. <p>configures the Kubernetes server Address.</p>
  22542. </td>
  22543. </tr>
  22544. <tr>
  22545. <td>
  22546. <code>caBundle</code></br>
  22547. <em>
  22548. []byte
  22549. </em>
  22550. </td>
  22551. <td>
  22552. <em>(Optional)</em>
  22553. <p>CABundle is a base64-encoded CA certificate</p>
  22554. </td>
  22555. </tr>
  22556. <tr>
  22557. <td>
  22558. <code>caProvider</code></br>
  22559. <em>
  22560. <a href="#external-secrets.io/v1beta1.CAProvider">
  22561. CAProvider
  22562. </a>
  22563. </em>
  22564. </td>
  22565. <td>
  22566. <em>(Optional)</em>
  22567. <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>
  22568. </td>
  22569. </tr>
  22570. </tbody>
  22571. </table>
  22572. <h3 id="external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  22573. </h3>
  22574. <p>
  22575. (<em>Appears on:</em>
  22576. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  22577. </p>
  22578. <p>
  22579. <p>MachineIdentityScopeInWorkspace defines the scope of a machine identity in an Infisical workspace.</p>
  22580. </p>
  22581. <table>
  22582. <thead>
  22583. <tr>
  22584. <th>Field</th>
  22585. <th>Description</th>
  22586. </tr>
  22587. </thead>
  22588. <tbody>
  22589. <tr>
  22590. <td>
  22591. <code>secretsPath</code></br>
  22592. <em>
  22593. string
  22594. </em>
  22595. </td>
  22596. <td>
  22597. <em>(Optional)</em>
  22598. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  22599. </td>
  22600. </tr>
  22601. <tr>
  22602. <td>
  22603. <code>recursive</code></br>
  22604. <em>
  22605. bool
  22606. </em>
  22607. </td>
  22608. <td>
  22609. <em>(Optional)</em>
  22610. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  22611. </td>
  22612. </tr>
  22613. <tr>
  22614. <td>
  22615. <code>environmentSlug</code></br>
  22616. <em>
  22617. string
  22618. </em>
  22619. </td>
  22620. <td>
  22621. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  22622. </td>
  22623. </tr>
  22624. <tr>
  22625. <td>
  22626. <code>projectSlug</code></br>
  22627. <em>
  22628. string
  22629. </em>
  22630. </td>
  22631. <td>
  22632. <p>ProjectSlug is the required slug identifier for the project.</p>
  22633. </td>
  22634. </tr>
  22635. <tr>
  22636. <td>
  22637. <code>expandSecretReferences</code></br>
  22638. <em>
  22639. bool
  22640. </em>
  22641. </td>
  22642. <td>
  22643. <em>(Optional)</em>
  22644. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  22645. </td>
  22646. </tr>
  22647. </tbody>
  22648. </table>
  22649. <h3 id="external-secrets.io/v1beta1.NTLMProtocol">NTLMProtocol
  22650. </h3>
  22651. <p>
  22652. (<em>Appears on:</em>
  22653. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol</a>)
  22654. </p>
  22655. <p>
  22656. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  22657. </p>
  22658. <table>
  22659. <thead>
  22660. <tr>
  22661. <th>Field</th>
  22662. <th>Description</th>
  22663. </tr>
  22664. </thead>
  22665. <tbody>
  22666. <tr>
  22667. <td>
  22668. <code>usernameSecret</code></br>
  22669. <em>
  22670. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22671. External Secrets meta/v1.SecretKeySelector
  22672. </a>
  22673. </em>
  22674. </td>
  22675. <td>
  22676. </td>
  22677. </tr>
  22678. <tr>
  22679. <td>
  22680. <code>passwordSecret</code></br>
  22681. <em>
  22682. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22683. External Secrets meta/v1.SecretKeySelector
  22684. </a>
  22685. </em>
  22686. </td>
  22687. <td>
  22688. </td>
  22689. </tr>
  22690. </tbody>
  22691. </table>
  22692. <h3 id="external-secrets.io/v1beta1.NoSecretError">NoSecretError
  22693. </h3>
  22694. <p>
  22695. <p>NoSecretError shall be returned when a GetSecret can not find the
  22696. desired secret. This is used for deletionPolicy.</p>
  22697. </p>
  22698. <h3 id="external-secrets.io/v1beta1.NotModifiedError">NotModifiedError
  22699. </h3>
  22700. <p>
  22701. <p>NotModifiedError to signal that the webhook received no changes,
  22702. and it should just return without doing anything.</p>
  22703. </p>
  22704. <h3 id="external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  22705. </h3>
  22706. <p>
  22707. (<em>Appears on:</em>
  22708. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider</a>)
  22709. </p>
  22710. <p>
  22711. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  22712. </p>
  22713. <table>
  22714. <thead>
  22715. <tr>
  22716. <th>Field</th>
  22717. <th>Description</th>
  22718. </tr>
  22719. </thead>
  22720. <tbody>
  22721. <tr>
  22722. <td>
  22723. <code>apiKeyRef</code></br>
  22724. <em>
  22725. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22726. External Secrets meta/v1.SecretKeySelector
  22727. </a>
  22728. </em>
  22729. </td>
  22730. <td>
  22731. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  22732. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  22733. </td>
  22734. </tr>
  22735. <tr>
  22736. <td>
  22737. <code>passcodeRef</code></br>
  22738. <em>
  22739. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22740. External Secrets meta/v1.SecretKeySelector
  22741. </a>
  22742. </em>
  22743. </td>
  22744. <td>
  22745. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  22746. </td>
  22747. </tr>
  22748. </tbody>
  22749. </table>
  22750. <h3 id="external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider
  22751. </h3>
  22752. <p>
  22753. (<em>Appears on:</em>
  22754. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22755. </p>
  22756. <p>
  22757. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  22758. Project and Config are required if not using a Service Token.</p>
  22759. </p>
  22760. <table>
  22761. <thead>
  22762. <tr>
  22763. <th>Field</th>
  22764. <th>Description</th>
  22765. </tr>
  22766. </thead>
  22767. <tbody>
  22768. <tr>
  22769. <td>
  22770. <code>auth</code></br>
  22771. <em>
  22772. <a href="#external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">
  22773. OnboardbaseAuthSecretRef
  22774. </a>
  22775. </em>
  22776. </td>
  22777. <td>
  22778. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  22779. </td>
  22780. </tr>
  22781. <tr>
  22782. <td>
  22783. <code>apiHost</code></br>
  22784. <em>
  22785. string
  22786. </em>
  22787. </td>
  22788. <td>
  22789. <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>
  22790. </td>
  22791. </tr>
  22792. <tr>
  22793. <td>
  22794. <code>project</code></br>
  22795. <em>
  22796. string
  22797. </em>
  22798. </td>
  22799. <td>
  22800. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  22801. </td>
  22802. </tr>
  22803. <tr>
  22804. <td>
  22805. <code>environment</code></br>
  22806. <em>
  22807. string
  22808. </em>
  22809. </td>
  22810. <td>
  22811. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  22812. </td>
  22813. </tr>
  22814. </tbody>
  22815. </table>
  22816. <h3 id="external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth
  22817. </h3>
  22818. <p>
  22819. (<em>Appears on:</em>
  22820. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider</a>)
  22821. </p>
  22822. <p>
  22823. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  22824. </p>
  22825. <table>
  22826. <thead>
  22827. <tr>
  22828. <th>Field</th>
  22829. <th>Description</th>
  22830. </tr>
  22831. </thead>
  22832. <tbody>
  22833. <tr>
  22834. <td>
  22835. <code>secretRef</code></br>
  22836. <em>
  22837. <a href="#external-secrets.io/v1beta1.OnePasswordAuthSecretRef">
  22838. OnePasswordAuthSecretRef
  22839. </a>
  22840. </em>
  22841. </td>
  22842. <td>
  22843. </td>
  22844. </tr>
  22845. </tbody>
  22846. </table>
  22847. <h3 id="external-secrets.io/v1beta1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  22848. </h3>
  22849. <p>
  22850. (<em>Appears on:</em>
  22851. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth</a>)
  22852. </p>
  22853. <p>
  22854. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  22855. </p>
  22856. <table>
  22857. <thead>
  22858. <tr>
  22859. <th>Field</th>
  22860. <th>Description</th>
  22861. </tr>
  22862. </thead>
  22863. <tbody>
  22864. <tr>
  22865. <td>
  22866. <code>connectTokenSecretRef</code></br>
  22867. <em>
  22868. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22869. External Secrets meta/v1.SecretKeySelector
  22870. </a>
  22871. </em>
  22872. </td>
  22873. <td>
  22874. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  22875. </td>
  22876. </tr>
  22877. </tbody>
  22878. </table>
  22879. <h3 id="external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider
  22880. </h3>
  22881. <p>
  22882. (<em>Appears on:</em>
  22883. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22884. </p>
  22885. <p>
  22886. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  22887. </p>
  22888. <table>
  22889. <thead>
  22890. <tr>
  22891. <th>Field</th>
  22892. <th>Description</th>
  22893. </tr>
  22894. </thead>
  22895. <tbody>
  22896. <tr>
  22897. <td>
  22898. <code>auth</code></br>
  22899. <em>
  22900. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">
  22901. OnePasswordAuth
  22902. </a>
  22903. </em>
  22904. </td>
  22905. <td>
  22906. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  22907. </td>
  22908. </tr>
  22909. <tr>
  22910. <td>
  22911. <code>connectHost</code></br>
  22912. <em>
  22913. string
  22914. </em>
  22915. </td>
  22916. <td>
  22917. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  22918. </td>
  22919. </tr>
  22920. <tr>
  22921. <td>
  22922. <code>vaults</code></br>
  22923. <em>
  22924. map[string]int
  22925. </em>
  22926. </td>
  22927. <td>
  22928. <p>Vaults defines which OnePassword vaults to search in which order</p>
  22929. </td>
  22930. </tr>
  22931. </tbody>
  22932. </table>
  22933. <h3 id="external-secrets.io/v1beta1.OracleAuth">OracleAuth
  22934. </h3>
  22935. <p>
  22936. (<em>Appears on:</em>
  22937. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  22938. </p>
  22939. <p>
  22940. <p>OracleAuth defines authentication configuration for the Oracle Vault provider.</p>
  22941. </p>
  22942. <table>
  22943. <thead>
  22944. <tr>
  22945. <th>Field</th>
  22946. <th>Description</th>
  22947. </tr>
  22948. </thead>
  22949. <tbody>
  22950. <tr>
  22951. <td>
  22952. <code>tenancy</code></br>
  22953. <em>
  22954. string
  22955. </em>
  22956. </td>
  22957. <td>
  22958. <p>Tenancy is the tenancy OCID where user is located.</p>
  22959. </td>
  22960. </tr>
  22961. <tr>
  22962. <td>
  22963. <code>user</code></br>
  22964. <em>
  22965. string
  22966. </em>
  22967. </td>
  22968. <td>
  22969. <p>User is an access OCID specific to the account.</p>
  22970. </td>
  22971. </tr>
  22972. <tr>
  22973. <td>
  22974. <code>secretRef</code></br>
  22975. <em>
  22976. <a href="#external-secrets.io/v1beta1.OracleSecretRef">
  22977. OracleSecretRef
  22978. </a>
  22979. </em>
  22980. </td>
  22981. <td>
  22982. <p>SecretRef to pass through sensitive information.</p>
  22983. </td>
  22984. </tr>
  22985. </tbody>
  22986. </table>
  22987. <h3 id="external-secrets.io/v1beta1.OraclePrincipalType">OraclePrincipalType
  22988. (<code>string</code> alias)</p></h3>
  22989. <p>
  22990. (<em>Appears on:</em>
  22991. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  22992. </p>
  22993. <p>
  22994. <p>OraclePrincipalType defines the type of principal used for authentication to Oracle Vault.</p>
  22995. </p>
  22996. <table>
  22997. <thead>
  22998. <tr>
  22999. <th>Value</th>
  23000. <th>Description</th>
  23001. </tr>
  23002. </thead>
  23003. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  23004. <td><p>InstancePrincipal represents a instance principal.</p>
  23005. </td>
  23006. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  23007. <td><p>UserPrincipal represents a user principal.</p>
  23008. </td>
  23009. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  23010. <td><p>WorkloadPrincipal represents a workload principal.</p>
  23011. </td>
  23012. </tr></tbody>
  23013. </table>
  23014. <h3 id="external-secrets.io/v1beta1.OracleProvider">OracleProvider
  23015. </h3>
  23016. <p>
  23017. (<em>Appears on:</em>
  23018. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23019. </p>
  23020. <p>
  23021. <p>OracleProvider configures a store to sync secrets using an Oracle Vault backend.</p>
  23022. </p>
  23023. <table>
  23024. <thead>
  23025. <tr>
  23026. <th>Field</th>
  23027. <th>Description</th>
  23028. </tr>
  23029. </thead>
  23030. <tbody>
  23031. <tr>
  23032. <td>
  23033. <code>region</code></br>
  23034. <em>
  23035. string
  23036. </em>
  23037. </td>
  23038. <td>
  23039. <p>Region is the region where vault is located.</p>
  23040. </td>
  23041. </tr>
  23042. <tr>
  23043. <td>
  23044. <code>vault</code></br>
  23045. <em>
  23046. string
  23047. </em>
  23048. </td>
  23049. <td>
  23050. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  23051. </td>
  23052. </tr>
  23053. <tr>
  23054. <td>
  23055. <code>compartment</code></br>
  23056. <em>
  23057. string
  23058. </em>
  23059. </td>
  23060. <td>
  23061. <em>(Optional)</em>
  23062. <p>Compartment is the vault compartment OCID.
  23063. Required for PushSecret</p>
  23064. </td>
  23065. </tr>
  23066. <tr>
  23067. <td>
  23068. <code>encryptionKey</code></br>
  23069. <em>
  23070. string
  23071. </em>
  23072. </td>
  23073. <td>
  23074. <em>(Optional)</em>
  23075. <p>EncryptionKey is the OCID of the encryption key within the vault.
  23076. Required for PushSecret</p>
  23077. </td>
  23078. </tr>
  23079. <tr>
  23080. <td>
  23081. <code>principalType</code></br>
  23082. <em>
  23083. <a href="#external-secrets.io/v1beta1.OraclePrincipalType">
  23084. OraclePrincipalType
  23085. </a>
  23086. </em>
  23087. </td>
  23088. <td>
  23089. <em>(Optional)</em>
  23090. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  23091. determine the principal type. This optional field must be specified if using
  23092. workload identity.</p>
  23093. </td>
  23094. </tr>
  23095. <tr>
  23096. <td>
  23097. <code>auth</code></br>
  23098. <em>
  23099. <a href="#external-secrets.io/v1beta1.OracleAuth">
  23100. OracleAuth
  23101. </a>
  23102. </em>
  23103. </td>
  23104. <td>
  23105. <em>(Optional)</em>
  23106. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  23107. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  23108. </td>
  23109. </tr>
  23110. <tr>
  23111. <td>
  23112. <code>serviceAccountRef</code></br>
  23113. <em>
  23114. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  23115. External Secrets meta/v1.ServiceAccountSelector
  23116. </a>
  23117. </em>
  23118. </td>
  23119. <td>
  23120. <em>(Optional)</em>
  23121. <p>ServiceAccountRef specified the service account
  23122. that should be used when authenticating with WorkloadIdentity.</p>
  23123. </td>
  23124. </tr>
  23125. </tbody>
  23126. </table>
  23127. <h3 id="external-secrets.io/v1beta1.OracleSecretRef">OracleSecretRef
  23128. </h3>
  23129. <p>
  23130. (<em>Appears on:</em>
  23131. <a href="#external-secrets.io/v1beta1.OracleAuth">OracleAuth</a>)
  23132. </p>
  23133. <p>
  23134. <p>OracleSecretRef defines references to secrets containing Oracle credentials.</p>
  23135. </p>
  23136. <table>
  23137. <thead>
  23138. <tr>
  23139. <th>Field</th>
  23140. <th>Description</th>
  23141. </tr>
  23142. </thead>
  23143. <tbody>
  23144. <tr>
  23145. <td>
  23146. <code>privatekey</code></br>
  23147. <em>
  23148. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23149. External Secrets meta/v1.SecretKeySelector
  23150. </a>
  23151. </em>
  23152. </td>
  23153. <td>
  23154. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  23155. </td>
  23156. </tr>
  23157. <tr>
  23158. <td>
  23159. <code>fingerprint</code></br>
  23160. <em>
  23161. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23162. External Secrets meta/v1.SecretKeySelector
  23163. </a>
  23164. </em>
  23165. </td>
  23166. <td>
  23167. <p>Fingerprint is the fingerprint of the API private key.</p>
  23168. </td>
  23169. </tr>
  23170. </tbody>
  23171. </table>
  23172. <h3 id="external-secrets.io/v1beta1.PassboltAuth">PassboltAuth
  23173. </h3>
  23174. <p>
  23175. (<em>Appears on:</em>
  23176. <a href="#external-secrets.io/v1beta1.PassboltProvider">PassboltProvider</a>)
  23177. </p>
  23178. <p>
  23179. <p>PassboltAuth contains credentials and configuration for authenticating with the Passbolt server.</p>
  23180. </p>
  23181. <table>
  23182. <thead>
  23183. <tr>
  23184. <th>Field</th>
  23185. <th>Description</th>
  23186. </tr>
  23187. </thead>
  23188. <tbody>
  23189. <tr>
  23190. <td>
  23191. <code>passwordSecretRef</code></br>
  23192. <em>
  23193. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23194. External Secrets meta/v1.SecretKeySelector
  23195. </a>
  23196. </em>
  23197. </td>
  23198. <td>
  23199. <p>PasswordSecretRef is a reference to the secret containing the Passbolt password</p>
  23200. </td>
  23201. </tr>
  23202. <tr>
  23203. <td>
  23204. <code>privateKeySecretRef</code></br>
  23205. <em>
  23206. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23207. External Secrets meta/v1.SecretKeySelector
  23208. </a>
  23209. </em>
  23210. </td>
  23211. <td>
  23212. <p>PrivateKeySecretRef is a reference to the secret containing the Passbolt private key</p>
  23213. </td>
  23214. </tr>
  23215. </tbody>
  23216. </table>
  23217. <h3 id="external-secrets.io/v1beta1.PassboltProvider">PassboltProvider
  23218. </h3>
  23219. <p>
  23220. (<em>Appears on:</em>
  23221. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23222. </p>
  23223. <p>
  23224. <p>PassboltProvider defines configuration for the Passbolt provider.</p>
  23225. </p>
  23226. <table>
  23227. <thead>
  23228. <tr>
  23229. <th>Field</th>
  23230. <th>Description</th>
  23231. </tr>
  23232. </thead>
  23233. <tbody>
  23234. <tr>
  23235. <td>
  23236. <code>auth</code></br>
  23237. <em>
  23238. <a href="#external-secrets.io/v1beta1.PassboltAuth">
  23239. PassboltAuth
  23240. </a>
  23241. </em>
  23242. </td>
  23243. <td>
  23244. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  23245. </td>
  23246. </tr>
  23247. <tr>
  23248. <td>
  23249. <code>host</code></br>
  23250. <em>
  23251. string
  23252. </em>
  23253. </td>
  23254. <td>
  23255. <p>Host defines the Passbolt Server to connect to</p>
  23256. </td>
  23257. </tr>
  23258. </tbody>
  23259. </table>
  23260. <h3 id="external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth
  23261. </h3>
  23262. <p>
  23263. (<em>Appears on:</em>
  23264. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider</a>)
  23265. </p>
  23266. <p>
  23267. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</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>secretRef</code></br>
  23280. <em>
  23281. <a href="#external-secrets.io/v1beta1.PasswordDepotSecretRef">
  23282. PasswordDepotSecretRef
  23283. </a>
  23284. </em>
  23285. </td>
  23286. <td>
  23287. </td>
  23288. </tr>
  23289. </tbody>
  23290. </table>
  23291. <h3 id="external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider
  23292. </h3>
  23293. <p>
  23294. (<em>Appears on:</em>
  23295. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23296. </p>
  23297. <p>
  23298. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  23299. </p>
  23300. <table>
  23301. <thead>
  23302. <tr>
  23303. <th>Field</th>
  23304. <th>Description</th>
  23305. </tr>
  23306. </thead>
  23307. <tbody>
  23308. <tr>
  23309. <td>
  23310. <code>host</code></br>
  23311. <em>
  23312. string
  23313. </em>
  23314. </td>
  23315. <td>
  23316. <p>URL configures the Password Depot instance URL.</p>
  23317. </td>
  23318. </tr>
  23319. <tr>
  23320. <td>
  23321. <code>database</code></br>
  23322. <em>
  23323. string
  23324. </em>
  23325. </td>
  23326. <td>
  23327. <p>Database to use as source</p>
  23328. </td>
  23329. </tr>
  23330. <tr>
  23331. <td>
  23332. <code>auth</code></br>
  23333. <em>
  23334. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">
  23335. PasswordDepotAuth
  23336. </a>
  23337. </em>
  23338. </td>
  23339. <td>
  23340. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  23341. </td>
  23342. </tr>
  23343. </tbody>
  23344. </table>
  23345. <h3 id="external-secrets.io/v1beta1.PasswordDepotSecretRef">PasswordDepotSecretRef
  23346. </h3>
  23347. <p>
  23348. (<em>Appears on:</em>
  23349. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth</a>)
  23350. </p>
  23351. <p>
  23352. <p>PasswordDepotSecretRef defines a reference to a secret containing credentials for the Password Depot provider.</p>
  23353. </p>
  23354. <table>
  23355. <thead>
  23356. <tr>
  23357. <th>Field</th>
  23358. <th>Description</th>
  23359. </tr>
  23360. </thead>
  23361. <tbody>
  23362. <tr>
  23363. <td>
  23364. <code>credentials</code></br>
  23365. <em>
  23366. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23367. External Secrets meta/v1.SecretKeySelector
  23368. </a>
  23369. </em>
  23370. </td>
  23371. <td>
  23372. <em>(Optional)</em>
  23373. <p>Username / Password is used for authentication.</p>
  23374. </td>
  23375. </tr>
  23376. </tbody>
  23377. </table>
  23378. <h3 id="external-secrets.io/v1beta1.PreviderAuth">PreviderAuth
  23379. </h3>
  23380. <p>
  23381. (<em>Appears on:</em>
  23382. <a href="#external-secrets.io/v1beta1.PreviderProvider">PreviderProvider</a>)
  23383. </p>
  23384. <p>
  23385. <p>PreviderAuth contains a secretRef for credentials.</p>
  23386. </p>
  23387. <table>
  23388. <thead>
  23389. <tr>
  23390. <th>Field</th>
  23391. <th>Description</th>
  23392. </tr>
  23393. </thead>
  23394. <tbody>
  23395. <tr>
  23396. <td>
  23397. <code>secretRef</code></br>
  23398. <em>
  23399. <a href="#external-secrets.io/v1beta1.PreviderAuthSecretRef">
  23400. PreviderAuthSecretRef
  23401. </a>
  23402. </em>
  23403. </td>
  23404. <td>
  23405. <em>(Optional)</em>
  23406. </td>
  23407. </tr>
  23408. </tbody>
  23409. </table>
  23410. <h3 id="external-secrets.io/v1beta1.PreviderAuthSecretRef">PreviderAuthSecretRef
  23411. </h3>
  23412. <p>
  23413. (<em>Appears on:</em>
  23414. <a href="#external-secrets.io/v1beta1.PreviderAuth">PreviderAuth</a>)
  23415. </p>
  23416. <p>
  23417. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  23418. </p>
  23419. <table>
  23420. <thead>
  23421. <tr>
  23422. <th>Field</th>
  23423. <th>Description</th>
  23424. </tr>
  23425. </thead>
  23426. <tbody>
  23427. <tr>
  23428. <td>
  23429. <code>accessToken</code></br>
  23430. <em>
  23431. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23432. External Secrets meta/v1.SecretKeySelector
  23433. </a>
  23434. </em>
  23435. </td>
  23436. <td>
  23437. <p>The AccessToken is used for authentication</p>
  23438. </td>
  23439. </tr>
  23440. </tbody>
  23441. </table>
  23442. <h3 id="external-secrets.io/v1beta1.PreviderProvider">PreviderProvider
  23443. </h3>
  23444. <p>
  23445. (<em>Appears on:</em>
  23446. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23447. </p>
  23448. <p>
  23449. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  23450. </p>
  23451. <table>
  23452. <thead>
  23453. <tr>
  23454. <th>Field</th>
  23455. <th>Description</th>
  23456. </tr>
  23457. </thead>
  23458. <tbody>
  23459. <tr>
  23460. <td>
  23461. <code>auth</code></br>
  23462. <em>
  23463. <a href="#external-secrets.io/v1beta1.PreviderAuth">
  23464. PreviderAuth
  23465. </a>
  23466. </em>
  23467. </td>
  23468. <td>
  23469. </td>
  23470. </tr>
  23471. <tr>
  23472. <td>
  23473. <code>baseUri</code></br>
  23474. <em>
  23475. string
  23476. </em>
  23477. </td>
  23478. <td>
  23479. <em>(Optional)</em>
  23480. </td>
  23481. </tr>
  23482. </tbody>
  23483. </table>
  23484. <h3 id="external-secrets.io/v1beta1.Provider">Provider
  23485. </h3>
  23486. <p>
  23487. <p>Provider is a common interface for interacting with secret backends.</p>
  23488. </p>
  23489. <h3 id="external-secrets.io/v1beta1.PulumiProvider">PulumiProvider
  23490. </h3>
  23491. <p>
  23492. (<em>Appears on:</em>
  23493. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23494. </p>
  23495. <p>
  23496. <p>PulumiProvider defines configuration for the Pulumi provider.</p>
  23497. </p>
  23498. <table>
  23499. <thead>
  23500. <tr>
  23501. <th>Field</th>
  23502. <th>Description</th>
  23503. </tr>
  23504. </thead>
  23505. <tbody>
  23506. <tr>
  23507. <td>
  23508. <code>apiUrl</code></br>
  23509. <em>
  23510. string
  23511. </em>
  23512. </td>
  23513. <td>
  23514. <p>APIURL is the URL of the Pulumi API.</p>
  23515. </td>
  23516. </tr>
  23517. <tr>
  23518. <td>
  23519. <code>accessToken</code></br>
  23520. <em>
  23521. <a href="#external-secrets.io/v1beta1.PulumiProviderSecretRef">
  23522. PulumiProviderSecretRef
  23523. </a>
  23524. </em>
  23525. </td>
  23526. <td>
  23527. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  23528. </td>
  23529. </tr>
  23530. <tr>
  23531. <td>
  23532. <code>organization</code></br>
  23533. <em>
  23534. string
  23535. </em>
  23536. </td>
  23537. <td>
  23538. <p>Organization are a space to collaborate on shared projects and stacks.
  23539. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  23540. </td>
  23541. </tr>
  23542. <tr>
  23543. <td>
  23544. <code>project</code></br>
  23545. <em>
  23546. string
  23547. </em>
  23548. </td>
  23549. <td>
  23550. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  23551. </td>
  23552. </tr>
  23553. <tr>
  23554. <td>
  23555. <code>environment</code></br>
  23556. <em>
  23557. string
  23558. </em>
  23559. </td>
  23560. <td>
  23561. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  23562. dynamically retrieved values from supported providers including all major clouds,
  23563. and other Pulumi ESC environments.
  23564. 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>
  23565. </td>
  23566. </tr>
  23567. </tbody>
  23568. </table>
  23569. <h3 id="external-secrets.io/v1beta1.PulumiProviderSecretRef">PulumiProviderSecretRef
  23570. </h3>
  23571. <p>
  23572. (<em>Appears on:</em>
  23573. <a href="#external-secrets.io/v1beta1.PulumiProvider">PulumiProvider</a>)
  23574. </p>
  23575. <p>
  23576. <p>PulumiProviderSecretRef defines a reference to a secret containing credentials for the Pulumi provider.</p>
  23577. </p>
  23578. <table>
  23579. <thead>
  23580. <tr>
  23581. <th>Field</th>
  23582. <th>Description</th>
  23583. </tr>
  23584. </thead>
  23585. <tbody>
  23586. <tr>
  23587. <td>
  23588. <code>secretRef</code></br>
  23589. <em>
  23590. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23591. External Secrets meta/v1.SecretKeySelector
  23592. </a>
  23593. </em>
  23594. </td>
  23595. <td>
  23596. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  23597. </td>
  23598. </tr>
  23599. </tbody>
  23600. </table>
  23601. <h3 id="external-secrets.io/v1beta1.PushSecretData">PushSecretData
  23602. </h3>
  23603. <p>
  23604. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1beta1.</p>
  23605. </p>
  23606. <h3 id="external-secrets.io/v1beta1.PushSecretRemoteRef">PushSecretRemoteRef
  23607. </h3>
  23608. <p>
  23609. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1beta1.</p>
  23610. </p>
  23611. <h3 id="external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider
  23612. </h3>
  23613. <p>
  23614. (<em>Appears on:</em>
  23615. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23616. </p>
  23617. <p>
  23618. <p>ScalewayProvider defines configuration for the Scaleway provider.</p>
  23619. </p>
  23620. <table>
  23621. <thead>
  23622. <tr>
  23623. <th>Field</th>
  23624. <th>Description</th>
  23625. </tr>
  23626. </thead>
  23627. <tbody>
  23628. <tr>
  23629. <td>
  23630. <code>apiUrl</code></br>
  23631. <em>
  23632. string
  23633. </em>
  23634. </td>
  23635. <td>
  23636. <em>(Optional)</em>
  23637. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  23638. </td>
  23639. </tr>
  23640. <tr>
  23641. <td>
  23642. <code>region</code></br>
  23643. <em>
  23644. string
  23645. </em>
  23646. </td>
  23647. <td>
  23648. <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>
  23649. </td>
  23650. </tr>
  23651. <tr>
  23652. <td>
  23653. <code>projectId</code></br>
  23654. <em>
  23655. string
  23656. </em>
  23657. </td>
  23658. <td>
  23659. <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>
  23660. </td>
  23661. </tr>
  23662. <tr>
  23663. <td>
  23664. <code>accessKey</code></br>
  23665. <em>
  23666. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  23667. ScalewayProviderSecretRef
  23668. </a>
  23669. </em>
  23670. </td>
  23671. <td>
  23672. <p>AccessKey is the non-secret part of the api key.</p>
  23673. </td>
  23674. </tr>
  23675. <tr>
  23676. <td>
  23677. <code>secretKey</code></br>
  23678. <em>
  23679. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  23680. ScalewayProviderSecretRef
  23681. </a>
  23682. </em>
  23683. </td>
  23684. <td>
  23685. <p>SecretKey is the non-secret part of the api key.</p>
  23686. </td>
  23687. </tr>
  23688. </tbody>
  23689. </table>
  23690. <h3 id="external-secrets.io/v1beta1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  23691. </h3>
  23692. <p>
  23693. (<em>Appears on:</em>
  23694. <a href="#external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider</a>)
  23695. </p>
  23696. <p>
  23697. <p>ScalewayProviderSecretRef defines a reference to a secret containing credentials for the Scaleway provider.</p>
  23698. </p>
  23699. <table>
  23700. <thead>
  23701. <tr>
  23702. <th>Field</th>
  23703. <th>Description</th>
  23704. </tr>
  23705. </thead>
  23706. <tbody>
  23707. <tr>
  23708. <td>
  23709. <code>value</code></br>
  23710. <em>
  23711. string
  23712. </em>
  23713. </td>
  23714. <td>
  23715. <em>(Optional)</em>
  23716. <p>Value can be specified directly to set a value without using a secret.</p>
  23717. </td>
  23718. </tr>
  23719. <tr>
  23720. <td>
  23721. <code>secretRef</code></br>
  23722. <em>
  23723. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23724. External Secrets meta/v1.SecretKeySelector
  23725. </a>
  23726. </em>
  23727. </td>
  23728. <td>
  23729. <em>(Optional)</em>
  23730. <p>SecretRef references a key in a secret that will be used as value.</p>
  23731. </td>
  23732. </tr>
  23733. </tbody>
  23734. </table>
  23735. <h3 id="external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider
  23736. </h3>
  23737. <p>
  23738. (<em>Appears on:</em>
  23739. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23740. </p>
  23741. <p>
  23742. <p>SecretServerProvider defines configuration for the Delinea Secret Server provider.
  23743. 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>
  23744. </p>
  23745. <table>
  23746. <thead>
  23747. <tr>
  23748. <th>Field</th>
  23749. <th>Description</th>
  23750. </tr>
  23751. </thead>
  23752. <tbody>
  23753. <tr>
  23754. <td>
  23755. <code>username</code></br>
  23756. <em>
  23757. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  23758. SecretServerProviderRef
  23759. </a>
  23760. </em>
  23761. </td>
  23762. <td>
  23763. <p>Username is the secret server account username.</p>
  23764. </td>
  23765. </tr>
  23766. <tr>
  23767. <td>
  23768. <code>password</code></br>
  23769. <em>
  23770. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  23771. SecretServerProviderRef
  23772. </a>
  23773. </em>
  23774. </td>
  23775. <td>
  23776. <p>Password is the secret server account password.</p>
  23777. </td>
  23778. </tr>
  23779. <tr>
  23780. <td>
  23781. <code>serverURL</code></br>
  23782. <em>
  23783. string
  23784. </em>
  23785. </td>
  23786. <td>
  23787. <p>ServerURL
  23788. URL to your secret server installation</p>
  23789. </td>
  23790. </tr>
  23791. </tbody>
  23792. </table>
  23793. <h3 id="external-secrets.io/v1beta1.SecretServerProviderRef">SecretServerProviderRef
  23794. </h3>
  23795. <p>
  23796. (<em>Appears on:</em>
  23797. <a href="#external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider</a>)
  23798. </p>
  23799. <p>
  23800. <p>SecretServerProviderRef defines a reference to a secret containing credentials for the Secret Server provider.</p>
  23801. </p>
  23802. <table>
  23803. <thead>
  23804. <tr>
  23805. <th>Field</th>
  23806. <th>Description</th>
  23807. </tr>
  23808. </thead>
  23809. <tbody>
  23810. <tr>
  23811. <td>
  23812. <code>value</code></br>
  23813. <em>
  23814. string
  23815. </em>
  23816. </td>
  23817. <td>
  23818. <em>(Optional)</em>
  23819. <p>Value can be specified directly to set a value without using a secret.</p>
  23820. </td>
  23821. </tr>
  23822. <tr>
  23823. <td>
  23824. <code>secretRef</code></br>
  23825. <em>
  23826. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23827. External Secrets meta/v1.SecretKeySelector
  23828. </a>
  23829. </em>
  23830. </td>
  23831. <td>
  23832. <em>(Optional)</em>
  23833. <p>SecretRef references a key in a secret that will be used as value.</p>
  23834. </td>
  23835. </tr>
  23836. </tbody>
  23837. </table>
  23838. <h3 id="external-secrets.io/v1beta1.SecretStore">SecretStore
  23839. </h3>
  23840. <p>
  23841. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  23842. </p>
  23843. <table>
  23844. <thead>
  23845. <tr>
  23846. <th>Field</th>
  23847. <th>Description</th>
  23848. </tr>
  23849. </thead>
  23850. <tbody>
  23851. <tr>
  23852. <td>
  23853. <code>metadata</code></br>
  23854. <em>
  23855. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  23856. Kubernetes meta/v1.ObjectMeta
  23857. </a>
  23858. </em>
  23859. </td>
  23860. <td>
  23861. Refer to the Kubernetes API documentation for the fields of the
  23862. <code>metadata</code> field.
  23863. </td>
  23864. </tr>
  23865. <tr>
  23866. <td>
  23867. <code>spec</code></br>
  23868. <em>
  23869. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  23870. SecretStoreSpec
  23871. </a>
  23872. </em>
  23873. </td>
  23874. <td>
  23875. <br/>
  23876. <br/>
  23877. <table>
  23878. <tr>
  23879. <td>
  23880. <code>controller</code></br>
  23881. <em>
  23882. string
  23883. </em>
  23884. </td>
  23885. <td>
  23886. <em>(Optional)</em>
  23887. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  23888. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  23889. </td>
  23890. </tr>
  23891. <tr>
  23892. <td>
  23893. <code>provider</code></br>
  23894. <em>
  23895. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  23896. SecretStoreProvider
  23897. </a>
  23898. </em>
  23899. </td>
  23900. <td>
  23901. <p>Used to configure the provider. Only one provider may be set</p>
  23902. </td>
  23903. </tr>
  23904. <tr>
  23905. <td>
  23906. <code>retrySettings</code></br>
  23907. <em>
  23908. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  23909. SecretStoreRetrySettings
  23910. </a>
  23911. </em>
  23912. </td>
  23913. <td>
  23914. <em>(Optional)</em>
  23915. <p>Used to configure HTTP retries on failures.</p>
  23916. </td>
  23917. </tr>
  23918. <tr>
  23919. <td>
  23920. <code>refreshInterval</code></br>
  23921. <em>
  23922. int
  23923. </em>
  23924. </td>
  23925. <td>
  23926. <em>(Optional)</em>
  23927. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  23928. </td>
  23929. </tr>
  23930. <tr>
  23931. <td>
  23932. <code>conditions</code></br>
  23933. <em>
  23934. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  23935. []ClusterSecretStoreCondition
  23936. </a>
  23937. </em>
  23938. </td>
  23939. <td>
  23940. <em>(Optional)</em>
  23941. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  23942. </td>
  23943. </tr>
  23944. </table>
  23945. </td>
  23946. </tr>
  23947. <tr>
  23948. <td>
  23949. <code>status</code></br>
  23950. <em>
  23951. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  23952. SecretStoreStatus
  23953. </a>
  23954. </em>
  23955. </td>
  23956. <td>
  23957. </td>
  23958. </tr>
  23959. </tbody>
  23960. </table>
  23961. <h3 id="external-secrets.io/v1beta1.SecretStoreCapabilities">SecretStoreCapabilities
  23962. (<code>string</code> alias)</p></h3>
  23963. <p>
  23964. (<em>Appears on:</em>
  23965. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  23966. </p>
  23967. <p>
  23968. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  23969. </p>
  23970. <table>
  23971. <thead>
  23972. <tr>
  23973. <th>Value</th>
  23974. <th>Description</th>
  23975. </tr>
  23976. </thead>
  23977. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  23978. <td><p>SecretStoreReadOnly indicates that the SecretStore only supports reading secrets.</p>
  23979. </td>
  23980. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  23981. <td><p>SecretStoreReadWrite indicates that the SecretStore supports both reading and writing secrets.</p>
  23982. </td>
  23983. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  23984. <td><p>SecretStoreWriteOnly indicates that the SecretStore only supports writing secrets.</p>
  23985. </td>
  23986. </tr></tbody>
  23987. </table>
  23988. <h3 id="external-secrets.io/v1beta1.SecretStoreConditionType">SecretStoreConditionType
  23989. (<code>string</code> alias)</p></h3>
  23990. <p>
  23991. (<em>Appears on:</em>
  23992. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  23993. </p>
  23994. <p>
  23995. <p>SecretStoreConditionType represents the condition type of the SecretStore.</p>
  23996. </p>
  23997. <table>
  23998. <thead>
  23999. <tr>
  24000. <th>Value</th>
  24001. <th>Description</th>
  24002. </tr>
  24003. </thead>
  24004. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  24005. <td><p>SecretStoreReady indicates that the SecretStore has been successfully configured.</p>
  24006. </td>
  24007. </tr></tbody>
  24008. </table>
  24009. <h3 id="external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider
  24010. </h3>
  24011. <p>
  24012. (<em>Appears on:</em>
  24013. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  24014. </p>
  24015. <p>
  24016. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  24017. </p>
  24018. <table>
  24019. <thead>
  24020. <tr>
  24021. <th>Field</th>
  24022. <th>Description</th>
  24023. </tr>
  24024. </thead>
  24025. <tbody>
  24026. <tr>
  24027. <td>
  24028. <code>aws</code></br>
  24029. <em>
  24030. <a href="#external-secrets.io/v1beta1.AWSProvider">
  24031. AWSProvider
  24032. </a>
  24033. </em>
  24034. </td>
  24035. <td>
  24036. <em>(Optional)</em>
  24037. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  24038. </td>
  24039. </tr>
  24040. <tr>
  24041. <td>
  24042. <code>azurekv</code></br>
  24043. <em>
  24044. <a href="#external-secrets.io/v1beta1.AzureKVProvider">
  24045. AzureKVProvider
  24046. </a>
  24047. </em>
  24048. </td>
  24049. <td>
  24050. <em>(Optional)</em>
  24051. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  24052. </td>
  24053. </tr>
  24054. <tr>
  24055. <td>
  24056. <code>akeyless</code></br>
  24057. <em>
  24058. <a href="#external-secrets.io/v1beta1.AkeylessProvider">
  24059. AkeylessProvider
  24060. </a>
  24061. </em>
  24062. </td>
  24063. <td>
  24064. <em>(Optional)</em>
  24065. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  24066. </td>
  24067. </tr>
  24068. <tr>
  24069. <td>
  24070. <code>bitwardensecretsmanager</code></br>
  24071. <em>
  24072. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">
  24073. BitwardenSecretsManagerProvider
  24074. </a>
  24075. </em>
  24076. </td>
  24077. <td>
  24078. <em>(Optional)</em>
  24079. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  24080. </td>
  24081. </tr>
  24082. <tr>
  24083. <td>
  24084. <code>vault</code></br>
  24085. <em>
  24086. <a href="#external-secrets.io/v1beta1.VaultProvider">
  24087. VaultProvider
  24088. </a>
  24089. </em>
  24090. </td>
  24091. <td>
  24092. <em>(Optional)</em>
  24093. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  24094. </td>
  24095. </tr>
  24096. <tr>
  24097. <td>
  24098. <code>gcpsm</code></br>
  24099. <em>
  24100. <a href="#external-secrets.io/v1beta1.GCPSMProvider">
  24101. GCPSMProvider
  24102. </a>
  24103. </em>
  24104. </td>
  24105. <td>
  24106. <em>(Optional)</em>
  24107. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  24108. </td>
  24109. </tr>
  24110. <tr>
  24111. <td>
  24112. <code>oracle</code></br>
  24113. <em>
  24114. <a href="#external-secrets.io/v1beta1.OracleProvider">
  24115. OracleProvider
  24116. </a>
  24117. </em>
  24118. </td>
  24119. <td>
  24120. <em>(Optional)</em>
  24121. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  24122. </td>
  24123. </tr>
  24124. <tr>
  24125. <td>
  24126. <code>ibm</code></br>
  24127. <em>
  24128. <a href="#external-secrets.io/v1beta1.IBMProvider">
  24129. IBMProvider
  24130. </a>
  24131. </em>
  24132. </td>
  24133. <td>
  24134. <em>(Optional)</em>
  24135. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  24136. </td>
  24137. </tr>
  24138. <tr>
  24139. <td>
  24140. <code>yandexcertificatemanager</code></br>
  24141. <em>
  24142. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">
  24143. YandexCertificateManagerProvider
  24144. </a>
  24145. </em>
  24146. </td>
  24147. <td>
  24148. <em>(Optional)</em>
  24149. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  24150. </td>
  24151. </tr>
  24152. <tr>
  24153. <td>
  24154. <code>yandexlockbox</code></br>
  24155. <em>
  24156. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">
  24157. YandexLockboxProvider
  24158. </a>
  24159. </em>
  24160. </td>
  24161. <td>
  24162. <em>(Optional)</em>
  24163. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  24164. </td>
  24165. </tr>
  24166. <tr>
  24167. <td>
  24168. <code>github</code></br>
  24169. <em>
  24170. <a href="#external-secrets.io/v1beta1.GithubProvider">
  24171. GithubProvider
  24172. </a>
  24173. </em>
  24174. </td>
  24175. <td>
  24176. <em>(Optional)</em>
  24177. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.</p>
  24178. </td>
  24179. </tr>
  24180. <tr>
  24181. <td>
  24182. <code>gitlab</code></br>
  24183. <em>
  24184. <a href="#external-secrets.io/v1beta1.GitlabProvider">
  24185. GitlabProvider
  24186. </a>
  24187. </em>
  24188. </td>
  24189. <td>
  24190. <em>(Optional)</em>
  24191. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  24192. </td>
  24193. </tr>
  24194. <tr>
  24195. <td>
  24196. <code>alibaba</code></br>
  24197. <em>
  24198. <a href="#external-secrets.io/v1beta1.AlibabaProvider">
  24199. AlibabaProvider
  24200. </a>
  24201. </em>
  24202. </td>
  24203. <td>
  24204. <em>(Optional)</em>
  24205. <p>Alibaba configures this store to sync secrets using Alibaba Cloud provider</p>
  24206. </td>
  24207. </tr>
  24208. <tr>
  24209. <td>
  24210. <code>onepassword</code></br>
  24211. <em>
  24212. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">
  24213. OnePasswordProvider
  24214. </a>
  24215. </em>
  24216. </td>
  24217. <td>
  24218. <em>(Optional)</em>
  24219. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  24220. </td>
  24221. </tr>
  24222. <tr>
  24223. <td>
  24224. <code>webhook</code></br>
  24225. <em>
  24226. <a href="#external-secrets.io/v1beta1.WebhookProvider">
  24227. WebhookProvider
  24228. </a>
  24229. </em>
  24230. </td>
  24231. <td>
  24232. <em>(Optional)</em>
  24233. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  24234. </td>
  24235. </tr>
  24236. <tr>
  24237. <td>
  24238. <code>kubernetes</code></br>
  24239. <em>
  24240. <a href="#external-secrets.io/v1beta1.KubernetesProvider">
  24241. KubernetesProvider
  24242. </a>
  24243. </em>
  24244. </td>
  24245. <td>
  24246. <em>(Optional)</em>
  24247. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  24248. </td>
  24249. </tr>
  24250. <tr>
  24251. <td>
  24252. <code>fake</code></br>
  24253. <em>
  24254. <a href="#external-secrets.io/v1beta1.FakeProvider">
  24255. FakeProvider
  24256. </a>
  24257. </em>
  24258. </td>
  24259. <td>
  24260. <em>(Optional)</em>
  24261. <p>Fake configures a store with static key/value pairs</p>
  24262. </td>
  24263. </tr>
  24264. <tr>
  24265. <td>
  24266. <code>senhasegura</code></br>
  24267. <em>
  24268. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">
  24269. SenhaseguraProvider
  24270. </a>
  24271. </em>
  24272. </td>
  24273. <td>
  24274. <em>(Optional)</em>
  24275. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  24276. </td>
  24277. </tr>
  24278. <tr>
  24279. <td>
  24280. <code>scaleway</code></br>
  24281. <em>
  24282. <a href="#external-secrets.io/v1beta1.ScalewayProvider">
  24283. ScalewayProvider
  24284. </a>
  24285. </em>
  24286. </td>
  24287. <td>
  24288. <em>(Optional)</em>
  24289. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  24290. </td>
  24291. </tr>
  24292. <tr>
  24293. <td>
  24294. <code>doppler</code></br>
  24295. <em>
  24296. <a href="#external-secrets.io/v1beta1.DopplerProvider">
  24297. DopplerProvider
  24298. </a>
  24299. </em>
  24300. </td>
  24301. <td>
  24302. <em>(Optional)</em>
  24303. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  24304. </td>
  24305. </tr>
  24306. <tr>
  24307. <td>
  24308. <code>previder</code></br>
  24309. <em>
  24310. <a href="#external-secrets.io/v1beta1.PreviderProvider">
  24311. PreviderProvider
  24312. </a>
  24313. </em>
  24314. </td>
  24315. <td>
  24316. <em>(Optional)</em>
  24317. <p>Previder configures this store to sync secrets using the Previder provider</p>
  24318. </td>
  24319. </tr>
  24320. <tr>
  24321. <td>
  24322. <code>onboardbase</code></br>
  24323. <em>
  24324. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">
  24325. OnboardbaseProvider
  24326. </a>
  24327. </em>
  24328. </td>
  24329. <td>
  24330. <em>(Optional)</em>
  24331. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  24332. </td>
  24333. </tr>
  24334. <tr>
  24335. <td>
  24336. <code>keepersecurity</code></br>
  24337. <em>
  24338. <a href="#external-secrets.io/v1beta1.KeeperSecurityProvider">
  24339. KeeperSecurityProvider
  24340. </a>
  24341. </em>
  24342. </td>
  24343. <td>
  24344. <em>(Optional)</em>
  24345. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  24346. </td>
  24347. </tr>
  24348. <tr>
  24349. <td>
  24350. <code>conjur</code></br>
  24351. <em>
  24352. <a href="#external-secrets.io/v1beta1.ConjurProvider">
  24353. ConjurProvider
  24354. </a>
  24355. </em>
  24356. </td>
  24357. <td>
  24358. <em>(Optional)</em>
  24359. <p>Conjur configures this store to sync secrets using conjur provider</p>
  24360. </td>
  24361. </tr>
  24362. <tr>
  24363. <td>
  24364. <code>delinea</code></br>
  24365. <em>
  24366. <a href="#external-secrets.io/v1beta1.DelineaProvider">
  24367. DelineaProvider
  24368. </a>
  24369. </em>
  24370. </td>
  24371. <td>
  24372. <em>(Optional)</em>
  24373. <p>Delinea DevOps Secrets Vault
  24374. <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>
  24375. </td>
  24376. </tr>
  24377. <tr>
  24378. <td>
  24379. <code>secretserver</code></br>
  24380. <em>
  24381. <a href="#external-secrets.io/v1beta1.SecretServerProvider">
  24382. SecretServerProvider
  24383. </a>
  24384. </em>
  24385. </td>
  24386. <td>
  24387. <em>(Optional)</em>
  24388. <p>SecretServer configures this store to sync secrets using SecretServer provider
  24389. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  24390. </td>
  24391. </tr>
  24392. <tr>
  24393. <td>
  24394. <code>chef</code></br>
  24395. <em>
  24396. <a href="#external-secrets.io/v1beta1.ChefProvider">
  24397. ChefProvider
  24398. </a>
  24399. </em>
  24400. </td>
  24401. <td>
  24402. <em>(Optional)</em>
  24403. <p>Chef configures this store to sync secrets with chef server</p>
  24404. </td>
  24405. </tr>
  24406. <tr>
  24407. <td>
  24408. <code>pulumi</code></br>
  24409. <em>
  24410. <a href="#external-secrets.io/v1beta1.PulumiProvider">
  24411. PulumiProvider
  24412. </a>
  24413. </em>
  24414. </td>
  24415. <td>
  24416. <em>(Optional)</em>
  24417. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  24418. </td>
  24419. </tr>
  24420. <tr>
  24421. <td>
  24422. <code>fortanix</code></br>
  24423. <em>
  24424. <a href="#external-secrets.io/v1beta1.FortanixProvider">
  24425. FortanixProvider
  24426. </a>
  24427. </em>
  24428. </td>
  24429. <td>
  24430. <em>(Optional)</em>
  24431. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  24432. </td>
  24433. </tr>
  24434. <tr>
  24435. <td>
  24436. <code>passworddepot</code></br>
  24437. <em>
  24438. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">
  24439. PasswordDepotProvider
  24440. </a>
  24441. </em>
  24442. </td>
  24443. <td>
  24444. <em>(Optional)</em>
  24445. </td>
  24446. </tr>
  24447. <tr>
  24448. <td>
  24449. <code>passbolt</code></br>
  24450. <em>
  24451. <a href="#external-secrets.io/v1beta1.PassboltProvider">
  24452. PassboltProvider
  24453. </a>
  24454. </em>
  24455. </td>
  24456. <td>
  24457. <em>(Optional)</em>
  24458. </td>
  24459. </tr>
  24460. <tr>
  24461. <td>
  24462. <code>device42</code></br>
  24463. <em>
  24464. <a href="#external-secrets.io/v1beta1.Device42Provider">
  24465. Device42Provider
  24466. </a>
  24467. </em>
  24468. </td>
  24469. <td>
  24470. <em>(Optional)</em>
  24471. <p>Device42 configures this store to sync secrets using the Device42 provider</p>
  24472. </td>
  24473. </tr>
  24474. <tr>
  24475. <td>
  24476. <code>infisical</code></br>
  24477. <em>
  24478. <a href="#external-secrets.io/v1beta1.InfisicalProvider">
  24479. InfisicalProvider
  24480. </a>
  24481. </em>
  24482. </td>
  24483. <td>
  24484. <em>(Optional)</em>
  24485. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  24486. </td>
  24487. </tr>
  24488. <tr>
  24489. <td>
  24490. <code>beyondtrust</code></br>
  24491. <em>
  24492. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">
  24493. BeyondtrustProvider
  24494. </a>
  24495. </em>
  24496. </td>
  24497. <td>
  24498. <em>(Optional)</em>
  24499. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  24500. </td>
  24501. </tr>
  24502. <tr>
  24503. <td>
  24504. <code>cloudrusm</code></br>
  24505. <em>
  24506. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">
  24507. CloudruSMProvider
  24508. </a>
  24509. </em>
  24510. </td>
  24511. <td>
  24512. <em>(Optional)</em>
  24513. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  24514. </td>
  24515. </tr>
  24516. </tbody>
  24517. </table>
  24518. <h3 id="external-secrets.io/v1beta1.SecretStoreRef">SecretStoreRef
  24519. </h3>
  24520. <p>
  24521. (<em>Appears on:</em>
  24522. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>,
  24523. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  24524. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  24525. </p>
  24526. <p>
  24527. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  24528. </p>
  24529. <table>
  24530. <thead>
  24531. <tr>
  24532. <th>Field</th>
  24533. <th>Description</th>
  24534. </tr>
  24535. </thead>
  24536. <tbody>
  24537. <tr>
  24538. <td>
  24539. <code>name</code></br>
  24540. <em>
  24541. string
  24542. </em>
  24543. </td>
  24544. <td>
  24545. <p>Name of the SecretStore resource</p>
  24546. </td>
  24547. </tr>
  24548. <tr>
  24549. <td>
  24550. <code>kind</code></br>
  24551. <em>
  24552. string
  24553. </em>
  24554. </td>
  24555. <td>
  24556. <em>(Optional)</em>
  24557. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  24558. Defaults to <code>SecretStore</code></p>
  24559. </td>
  24560. </tr>
  24561. </tbody>
  24562. </table>
  24563. <h3 id="external-secrets.io/v1beta1.SecretStoreRetrySettings">SecretStoreRetrySettings
  24564. </h3>
  24565. <p>
  24566. (<em>Appears on:</em>
  24567. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  24568. </p>
  24569. <p>
  24570. <p>SecretStoreRetrySettings defines configuration for retrying failed requests to the provider.</p>
  24571. </p>
  24572. <table>
  24573. <thead>
  24574. <tr>
  24575. <th>Field</th>
  24576. <th>Description</th>
  24577. </tr>
  24578. </thead>
  24579. <tbody>
  24580. <tr>
  24581. <td>
  24582. <code>maxRetries</code></br>
  24583. <em>
  24584. int32
  24585. </em>
  24586. </td>
  24587. <td>
  24588. <p>MaxRetries is the maximum number of retry attempts.</p>
  24589. </td>
  24590. </tr>
  24591. <tr>
  24592. <td>
  24593. <code>retryInterval</code></br>
  24594. <em>
  24595. string
  24596. </em>
  24597. </td>
  24598. <td>
  24599. <p>RetryInterval is the interval between retry attempts.</p>
  24600. </td>
  24601. </tr>
  24602. </tbody>
  24603. </table>
  24604. <h3 id="external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec
  24605. </h3>
  24606. <p>
  24607. (<em>Appears on:</em>
  24608. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  24609. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  24610. </p>
  24611. <p>
  24612. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  24613. </p>
  24614. <table>
  24615. <thead>
  24616. <tr>
  24617. <th>Field</th>
  24618. <th>Description</th>
  24619. </tr>
  24620. </thead>
  24621. <tbody>
  24622. <tr>
  24623. <td>
  24624. <code>controller</code></br>
  24625. <em>
  24626. string
  24627. </em>
  24628. </td>
  24629. <td>
  24630. <em>(Optional)</em>
  24631. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  24632. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  24633. </td>
  24634. </tr>
  24635. <tr>
  24636. <td>
  24637. <code>provider</code></br>
  24638. <em>
  24639. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  24640. SecretStoreProvider
  24641. </a>
  24642. </em>
  24643. </td>
  24644. <td>
  24645. <p>Used to configure the provider. Only one provider may be set</p>
  24646. </td>
  24647. </tr>
  24648. <tr>
  24649. <td>
  24650. <code>retrySettings</code></br>
  24651. <em>
  24652. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  24653. SecretStoreRetrySettings
  24654. </a>
  24655. </em>
  24656. </td>
  24657. <td>
  24658. <em>(Optional)</em>
  24659. <p>Used to configure HTTP retries on failures.</p>
  24660. </td>
  24661. </tr>
  24662. <tr>
  24663. <td>
  24664. <code>refreshInterval</code></br>
  24665. <em>
  24666. int
  24667. </em>
  24668. </td>
  24669. <td>
  24670. <em>(Optional)</em>
  24671. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  24672. </td>
  24673. </tr>
  24674. <tr>
  24675. <td>
  24676. <code>conditions</code></br>
  24677. <em>
  24678. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  24679. []ClusterSecretStoreCondition
  24680. </a>
  24681. </em>
  24682. </td>
  24683. <td>
  24684. <em>(Optional)</em>
  24685. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  24686. </td>
  24687. </tr>
  24688. </tbody>
  24689. </table>
  24690. <h3 id="external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus
  24691. </h3>
  24692. <p>
  24693. (<em>Appears on:</em>
  24694. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  24695. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  24696. </p>
  24697. <p>
  24698. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  24699. </p>
  24700. <table>
  24701. <thead>
  24702. <tr>
  24703. <th>Field</th>
  24704. <th>Description</th>
  24705. </tr>
  24706. </thead>
  24707. <tbody>
  24708. <tr>
  24709. <td>
  24710. <code>conditions</code></br>
  24711. <em>
  24712. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">
  24713. []SecretStoreStatusCondition
  24714. </a>
  24715. </em>
  24716. </td>
  24717. <td>
  24718. <em>(Optional)</em>
  24719. </td>
  24720. </tr>
  24721. <tr>
  24722. <td>
  24723. <code>capabilities</code></br>
  24724. <em>
  24725. <a href="#external-secrets.io/v1beta1.SecretStoreCapabilities">
  24726. SecretStoreCapabilities
  24727. </a>
  24728. </em>
  24729. </td>
  24730. <td>
  24731. <em>(Optional)</em>
  24732. </td>
  24733. </tr>
  24734. </tbody>
  24735. </table>
  24736. <h3 id="external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition
  24737. </h3>
  24738. <p>
  24739. (<em>Appears on:</em>
  24740. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  24741. </p>
  24742. <p>
  24743. <p>SecretStoreStatusCondition defines the observed condition of the SecretStore.</p>
  24744. </p>
  24745. <table>
  24746. <thead>
  24747. <tr>
  24748. <th>Field</th>
  24749. <th>Description</th>
  24750. </tr>
  24751. </thead>
  24752. <tbody>
  24753. <tr>
  24754. <td>
  24755. <code>type</code></br>
  24756. <em>
  24757. <a href="#external-secrets.io/v1beta1.SecretStoreConditionType">
  24758. SecretStoreConditionType
  24759. </a>
  24760. </em>
  24761. </td>
  24762. <td>
  24763. </td>
  24764. </tr>
  24765. <tr>
  24766. <td>
  24767. <code>status</code></br>
  24768. <em>
  24769. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  24770. Kubernetes core/v1.ConditionStatus
  24771. </a>
  24772. </em>
  24773. </td>
  24774. <td>
  24775. </td>
  24776. </tr>
  24777. <tr>
  24778. <td>
  24779. <code>reason</code></br>
  24780. <em>
  24781. string
  24782. </em>
  24783. </td>
  24784. <td>
  24785. <em>(Optional)</em>
  24786. </td>
  24787. </tr>
  24788. <tr>
  24789. <td>
  24790. <code>message</code></br>
  24791. <em>
  24792. string
  24793. </em>
  24794. </td>
  24795. <td>
  24796. <em>(Optional)</em>
  24797. </td>
  24798. </tr>
  24799. <tr>
  24800. <td>
  24801. <code>lastTransitionTime</code></br>
  24802. <em>
  24803. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  24804. Kubernetes meta/v1.Time
  24805. </a>
  24806. </em>
  24807. </td>
  24808. <td>
  24809. <em>(Optional)</em>
  24810. </td>
  24811. </tr>
  24812. </tbody>
  24813. </table>
  24814. <h3 id="external-secrets.io/v1beta1.SecretsClient">SecretsClient
  24815. </h3>
  24816. <p>
  24817. <p>SecretsClient provides access to secrets.</p>
  24818. </p>
  24819. <h3 id="external-secrets.io/v1beta1.SecretsManager">SecretsManager
  24820. </h3>
  24821. <p>
  24822. (<em>Appears on:</em>
  24823. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  24824. </p>
  24825. <p>
  24826. <p>SecretsManager defines how the provider behaves when interacting with AWS
  24827. SecretsManager. Some of these settings are only applicable to controlling how
  24828. secrets are deleted, and hence only apply to PushSecret (and only when
  24829. deletionPolicy is set to Delete).</p>
  24830. </p>
  24831. <table>
  24832. <thead>
  24833. <tr>
  24834. <th>Field</th>
  24835. <th>Description</th>
  24836. </tr>
  24837. </thead>
  24838. <tbody>
  24839. <tr>
  24840. <td>
  24841. <code>forceDeleteWithoutRecovery</code></br>
  24842. <em>
  24843. bool
  24844. </em>
  24845. </td>
  24846. <td>
  24847. <em>(Optional)</em>
  24848. <p>Specifies whether to delete the secret without any recovery window. You
  24849. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  24850. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  24851. recovery window.
  24852. 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>
  24853. </td>
  24854. </tr>
  24855. <tr>
  24856. <td>
  24857. <code>recoveryWindowInDays</code></br>
  24858. <em>
  24859. int64
  24860. </em>
  24861. </td>
  24862. <td>
  24863. <em>(Optional)</em>
  24864. <p>The number of days from 7 to 30 that Secrets Manager waits before
  24865. permanently deleting the secret. You can&rsquo;t use both this parameter and
  24866. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  24867. then by default Secrets Manager uses a 30 day recovery window.
  24868. 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>
  24869. </td>
  24870. </tr>
  24871. </tbody>
  24872. </table>
  24873. <h3 id="external-secrets.io/v1beta1.SenhaseguraAuth">SenhaseguraAuth
  24874. </h3>
  24875. <p>
  24876. (<em>Appears on:</em>
  24877. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  24878. </p>
  24879. <p>
  24880. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  24881. </p>
  24882. <table>
  24883. <thead>
  24884. <tr>
  24885. <th>Field</th>
  24886. <th>Description</th>
  24887. </tr>
  24888. </thead>
  24889. <tbody>
  24890. <tr>
  24891. <td>
  24892. <code>clientId</code></br>
  24893. <em>
  24894. string
  24895. </em>
  24896. </td>
  24897. <td>
  24898. </td>
  24899. </tr>
  24900. <tr>
  24901. <td>
  24902. <code>clientSecretSecretRef</code></br>
  24903. <em>
  24904. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24905. External Secrets meta/v1.SecretKeySelector
  24906. </a>
  24907. </em>
  24908. </td>
  24909. <td>
  24910. </td>
  24911. </tr>
  24912. </tbody>
  24913. </table>
  24914. <h3 id="external-secrets.io/v1beta1.SenhaseguraModuleType">SenhaseguraModuleType
  24915. (<code>string</code> alias)</p></h3>
  24916. <p>
  24917. (<em>Appears on:</em>
  24918. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  24919. </p>
  24920. <p>
  24921. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  24922. </p>
  24923. <table>
  24924. <thead>
  24925. <tr>
  24926. <th>Value</th>
  24927. <th>Description</th>
  24928. </tr>
  24929. </thead>
  24930. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  24931. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  24932. see: https://senhasegura.com/devops
  24933. </code></pre>
  24934. </td>
  24935. </tr></tbody>
  24936. </table>
  24937. <h3 id="external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider
  24938. </h3>
  24939. <p>
  24940. (<em>Appears on:</em>
  24941. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24942. </p>
  24943. <p>
  24944. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  24945. </p>
  24946. <table>
  24947. <thead>
  24948. <tr>
  24949. <th>Field</th>
  24950. <th>Description</th>
  24951. </tr>
  24952. </thead>
  24953. <tbody>
  24954. <tr>
  24955. <td>
  24956. <code>url</code></br>
  24957. <em>
  24958. string
  24959. </em>
  24960. </td>
  24961. <td>
  24962. <p>URL of senhasegura</p>
  24963. </td>
  24964. </tr>
  24965. <tr>
  24966. <td>
  24967. <code>module</code></br>
  24968. <em>
  24969. <a href="#external-secrets.io/v1beta1.SenhaseguraModuleType">
  24970. SenhaseguraModuleType
  24971. </a>
  24972. </em>
  24973. </td>
  24974. <td>
  24975. <p>Module defines which senhasegura module should be used to get secrets</p>
  24976. </td>
  24977. </tr>
  24978. <tr>
  24979. <td>
  24980. <code>auth</code></br>
  24981. <em>
  24982. <a href="#external-secrets.io/v1beta1.SenhaseguraAuth">
  24983. SenhaseguraAuth
  24984. </a>
  24985. </em>
  24986. </td>
  24987. <td>
  24988. <p>Auth defines parameters to authenticate in senhasegura</p>
  24989. </td>
  24990. </tr>
  24991. <tr>
  24992. <td>
  24993. <code>ignoreSslCertificate</code></br>
  24994. <em>
  24995. bool
  24996. </em>
  24997. </td>
  24998. <td>
  24999. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  25000. </td>
  25001. </tr>
  25002. </tbody>
  25003. </table>
  25004. <h3 id="external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  25005. </h3>
  25006. <p>
  25007. (<em>Appears on:</em>
  25008. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  25009. </p>
  25010. <p>
  25011. <p>StoreGeneratorSourceRef allows you to override the source
  25012. from which the secret will be pulled from.
  25013. You can define at maximum one property.</p>
  25014. </p>
  25015. <table>
  25016. <thead>
  25017. <tr>
  25018. <th>Field</th>
  25019. <th>Description</th>
  25020. </tr>
  25021. </thead>
  25022. <tbody>
  25023. <tr>
  25024. <td>
  25025. <code>storeRef</code></br>
  25026. <em>
  25027. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  25028. SecretStoreRef
  25029. </a>
  25030. </em>
  25031. </td>
  25032. <td>
  25033. <em>(Optional)</em>
  25034. </td>
  25035. </tr>
  25036. <tr>
  25037. <td>
  25038. <code>generatorRef</code></br>
  25039. <em>
  25040. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  25041. GeneratorRef
  25042. </a>
  25043. </em>
  25044. </td>
  25045. <td>
  25046. <em>(Optional)</em>
  25047. <p>GeneratorRef points to a generator custom resource.</p>
  25048. </td>
  25049. </tr>
  25050. </tbody>
  25051. </table>
  25052. <h3 id="external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef
  25053. </h3>
  25054. <p>
  25055. (<em>Appears on:</em>
  25056. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>)
  25057. </p>
  25058. <p>
  25059. <p>StoreSourceRef allows you to override the SecretStore source
  25060. from which the secret will be pulled from.
  25061. You can define at maximum one property.</p>
  25062. </p>
  25063. <table>
  25064. <thead>
  25065. <tr>
  25066. <th>Field</th>
  25067. <th>Description</th>
  25068. </tr>
  25069. </thead>
  25070. <tbody>
  25071. <tr>
  25072. <td>
  25073. <code>storeRef</code></br>
  25074. <em>
  25075. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  25076. SecretStoreRef
  25077. </a>
  25078. </em>
  25079. </td>
  25080. <td>
  25081. <em>(Optional)</em>
  25082. </td>
  25083. </tr>
  25084. <tr>
  25085. <td>
  25086. <code>generatorRef</code></br>
  25087. <em>
  25088. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  25089. GeneratorRef
  25090. </a>
  25091. </em>
  25092. </td>
  25093. <td>
  25094. <p>GeneratorRef points to a generator custom resource.</p>
  25095. <p>Deprecated: The generatorRef is not implemented in .data[].
  25096. this will be removed with v1.</p>
  25097. </td>
  25098. </tr>
  25099. </tbody>
  25100. </table>
  25101. <h3 id="external-secrets.io/v1beta1.Tag">Tag
  25102. </h3>
  25103. <p>
  25104. <p>Tag defines a tag key and value for AWS resources.</p>
  25105. </p>
  25106. <table>
  25107. <thead>
  25108. <tr>
  25109. <th>Field</th>
  25110. <th>Description</th>
  25111. </tr>
  25112. </thead>
  25113. <tbody>
  25114. <tr>
  25115. <td>
  25116. <code>key</code></br>
  25117. <em>
  25118. string
  25119. </em>
  25120. </td>
  25121. <td>
  25122. </td>
  25123. </tr>
  25124. <tr>
  25125. <td>
  25126. <code>value</code></br>
  25127. <em>
  25128. string
  25129. </em>
  25130. </td>
  25131. <td>
  25132. </td>
  25133. </tr>
  25134. </tbody>
  25135. </table>
  25136. <h3 id="external-secrets.io/v1beta1.TemplateEngineVersion">TemplateEngineVersion
  25137. (<code>string</code> alias)</p></h3>
  25138. <p>
  25139. (<em>Appears on:</em>
  25140. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25141. </p>
  25142. <p>
  25143. <p>TemplateEngineVersion defines the version of the template engine to use.</p>
  25144. </p>
  25145. <table>
  25146. <thead>
  25147. <tr>
  25148. <th>Value</th>
  25149. <th>Description</th>
  25150. </tr>
  25151. </thead>
  25152. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  25153. <td><p>TemplateEngineV2 specifies the v2 template engine version.</p>
  25154. </td>
  25155. </tr></tbody>
  25156. </table>
  25157. <h3 id="external-secrets.io/v1beta1.TemplateFrom">TemplateFrom
  25158. </h3>
  25159. <p>
  25160. (<em>Appears on:</em>
  25161. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25162. </p>
  25163. <p>
  25164. <p>TemplateFrom defines a source for template data.</p>
  25165. </p>
  25166. <table>
  25167. <thead>
  25168. <tr>
  25169. <th>Field</th>
  25170. <th>Description</th>
  25171. </tr>
  25172. </thead>
  25173. <tbody>
  25174. <tr>
  25175. <td>
  25176. <code>configMap</code></br>
  25177. <em>
  25178. <a href="#external-secrets.io/v1beta1.TemplateRef">
  25179. TemplateRef
  25180. </a>
  25181. </em>
  25182. </td>
  25183. <td>
  25184. </td>
  25185. </tr>
  25186. <tr>
  25187. <td>
  25188. <code>secret</code></br>
  25189. <em>
  25190. <a href="#external-secrets.io/v1beta1.TemplateRef">
  25191. TemplateRef
  25192. </a>
  25193. </em>
  25194. </td>
  25195. <td>
  25196. </td>
  25197. </tr>
  25198. <tr>
  25199. <td>
  25200. <code>target</code></br>
  25201. <em>
  25202. <a href="#external-secrets.io/v1beta1.TemplateTarget">
  25203. TemplateTarget
  25204. </a>
  25205. </em>
  25206. </td>
  25207. <td>
  25208. <em>(Optional)</em>
  25209. </td>
  25210. </tr>
  25211. <tr>
  25212. <td>
  25213. <code>literal</code></br>
  25214. <em>
  25215. string
  25216. </em>
  25217. </td>
  25218. <td>
  25219. <em>(Optional)</em>
  25220. </td>
  25221. </tr>
  25222. </tbody>
  25223. </table>
  25224. <h3 id="external-secrets.io/v1beta1.TemplateMergePolicy">TemplateMergePolicy
  25225. (<code>string</code> alias)</p></h3>
  25226. <p>
  25227. (<em>Appears on:</em>
  25228. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25229. </p>
  25230. <p>
  25231. <p>TemplateMergePolicy defines how template values should be merged when generating a secret.</p>
  25232. </p>
  25233. <table>
  25234. <thead>
  25235. <tr>
  25236. <th>Value</th>
  25237. <th>Description</th>
  25238. </tr>
  25239. </thead>
  25240. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  25241. <td><p>MergePolicyMerge merges the template content with existing values.</p>
  25242. </td>
  25243. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  25244. <td><p>MergePolicyReplace replaces the entire template content during merge operations.</p>
  25245. </td>
  25246. </tr></tbody>
  25247. </table>
  25248. <h3 id="external-secrets.io/v1beta1.TemplateRef">TemplateRef
  25249. </h3>
  25250. <p>
  25251. (<em>Appears on:</em>
  25252. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  25253. </p>
  25254. <p>
  25255. <p>TemplateRef defines a reference to a template source in a ConfigMap or Secret.</p>
  25256. </p>
  25257. <table>
  25258. <thead>
  25259. <tr>
  25260. <th>Field</th>
  25261. <th>Description</th>
  25262. </tr>
  25263. </thead>
  25264. <tbody>
  25265. <tr>
  25266. <td>
  25267. <code>name</code></br>
  25268. <em>
  25269. string
  25270. </em>
  25271. </td>
  25272. <td>
  25273. <p>The name of the ConfigMap/Secret resource</p>
  25274. </td>
  25275. </tr>
  25276. <tr>
  25277. <td>
  25278. <code>items</code></br>
  25279. <em>
  25280. <a href="#external-secrets.io/v1beta1.TemplateRefItem">
  25281. []TemplateRefItem
  25282. </a>
  25283. </em>
  25284. </td>
  25285. <td>
  25286. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  25287. </td>
  25288. </tr>
  25289. </tbody>
  25290. </table>
  25291. <h3 id="external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem
  25292. </h3>
  25293. <p>
  25294. (<em>Appears on:</em>
  25295. <a href="#external-secrets.io/v1beta1.TemplateRef">TemplateRef</a>)
  25296. </p>
  25297. <p>
  25298. <p>TemplateRefItem defines which key in the referenced ConfigMap or Secret to use as a template.</p>
  25299. </p>
  25300. <table>
  25301. <thead>
  25302. <tr>
  25303. <th>Field</th>
  25304. <th>Description</th>
  25305. </tr>
  25306. </thead>
  25307. <tbody>
  25308. <tr>
  25309. <td>
  25310. <code>key</code></br>
  25311. <em>
  25312. string
  25313. </em>
  25314. </td>
  25315. <td>
  25316. <p>A key in the ConfigMap/Secret</p>
  25317. </td>
  25318. </tr>
  25319. <tr>
  25320. <td>
  25321. <code>templateAs</code></br>
  25322. <em>
  25323. <a href="#external-secrets.io/v1beta1.TemplateScope">
  25324. TemplateScope
  25325. </a>
  25326. </em>
  25327. </td>
  25328. <td>
  25329. </td>
  25330. </tr>
  25331. </tbody>
  25332. </table>
  25333. <h3 id="external-secrets.io/v1beta1.TemplateScope">TemplateScope
  25334. (<code>string</code> alias)</p></h3>
  25335. <p>
  25336. (<em>Appears on:</em>
  25337. <a href="#external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem</a>)
  25338. </p>
  25339. <p>
  25340. <p>TemplateScope defines the scope of the template when processing template data.</p>
  25341. </p>
  25342. <table>
  25343. <thead>
  25344. <tr>
  25345. <th>Value</th>
  25346. <th>Description</th>
  25347. </tr>
  25348. </thead>
  25349. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  25350. <td><p>TemplateScopeKeysAndValues processes both keys and values of the data.</p>
  25351. </td>
  25352. </tr><tr><td><p>&#34;Values&#34;</p></td>
  25353. <td><p>TemplateScopeValues processes only the values of the data.</p>
  25354. </td>
  25355. </tr></tbody>
  25356. </table>
  25357. <h3 id="external-secrets.io/v1beta1.TemplateTarget">TemplateTarget
  25358. (<code>string</code> alias)</p></h3>
  25359. <p>
  25360. (<em>Appears on:</em>
  25361. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  25362. </p>
  25363. <p>
  25364. <p>TemplateTarget defines the target field where the template result will be stored.</p>
  25365. </p>
  25366. <table>
  25367. <thead>
  25368. <tr>
  25369. <th>Value</th>
  25370. <th>Description</th>
  25371. </tr>
  25372. </thead>
  25373. <tbody><tr><td><p>&#34;Annotations&#34;</p></td>
  25374. <td><p>TemplateTargetAnnotations stores template results in the annotations field of the secret.</p>
  25375. </td>
  25376. </tr><tr><td><p>&#34;Data&#34;</p></td>
  25377. <td><p>TemplateTargetData stores template results in the data field of the secret.</p>
  25378. </td>
  25379. </tr><tr><td><p>&#34;Labels&#34;</p></td>
  25380. <td><p>TemplateTargetLabels stores template results in the labels field of the secret.</p>
  25381. </td>
  25382. </tr></tbody>
  25383. </table>
  25384. <h3 id="external-secrets.io/v1beta1.TokenAuth">TokenAuth
  25385. </h3>
  25386. <p>
  25387. (<em>Appears on:</em>
  25388. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  25389. </p>
  25390. <p>
  25391. <p>TokenAuth defines token-based authentication for the Kubernetes provider.</p>
  25392. </p>
  25393. <table>
  25394. <thead>
  25395. <tr>
  25396. <th>Field</th>
  25397. <th>Description</th>
  25398. </tr>
  25399. </thead>
  25400. <tbody>
  25401. <tr>
  25402. <td>
  25403. <code>bearerToken</code></br>
  25404. <em>
  25405. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25406. External Secrets meta/v1.SecretKeySelector
  25407. </a>
  25408. </em>
  25409. </td>
  25410. <td>
  25411. </td>
  25412. </tr>
  25413. </tbody>
  25414. </table>
  25415. <h3 id="external-secrets.io/v1beta1.UniversalAuthCredentials">UniversalAuthCredentials
  25416. </h3>
  25417. <p>
  25418. (<em>Appears on:</em>
  25419. <a href="#external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth</a>)
  25420. </p>
  25421. <p>
  25422. <p>UniversalAuthCredentials defines the credentials for Infisical Universal Auth.</p>
  25423. </p>
  25424. <table>
  25425. <thead>
  25426. <tr>
  25427. <th>Field</th>
  25428. <th>Description</th>
  25429. </tr>
  25430. </thead>
  25431. <tbody>
  25432. <tr>
  25433. <td>
  25434. <code>clientId</code></br>
  25435. <em>
  25436. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25437. External Secrets meta/v1.SecretKeySelector
  25438. </a>
  25439. </em>
  25440. </td>
  25441. <td>
  25442. </td>
  25443. </tr>
  25444. <tr>
  25445. <td>
  25446. <code>clientSecret</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. </td>
  25455. </tr>
  25456. </tbody>
  25457. </table>
  25458. <h3 id="external-secrets.io/v1beta1.ValidationResult">ValidationResult
  25459. (<code>byte</code> alias)</p></h3>
  25460. <p>
  25461. <p>ValidationResult represents the result of validating a provider client configuration.</p>
  25462. </p>
  25463. <table>
  25464. <thead>
  25465. <tr>
  25466. <th>Value</th>
  25467. <th>Description</th>
  25468. </tr>
  25469. </thead>
  25470. <tbody><tr><td><p>2</p></td>
  25471. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  25472. </td>
  25473. </tr><tr><td><p>0</p></td>
  25474. <td><p>ValidationResultReady indicates that the client is configured correctly and can be used.</p>
  25475. </td>
  25476. </tr><tr><td><p>1</p></td>
  25477. <td><p>ValidationResultUnknown indicates that the client can be used but information is missing and it can not be validated.</p>
  25478. </td>
  25479. </tr></tbody>
  25480. </table>
  25481. <h3 id="external-secrets.io/v1beta1.VaultAppRole">VaultAppRole
  25482. </h3>
  25483. <p>
  25484. (<em>Appears on:</em>
  25485. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25486. </p>
  25487. <p>
  25488. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  25489. with the role and secret stored in a Kubernetes Secret resource.</p>
  25490. </p>
  25491. <table>
  25492. <thead>
  25493. <tr>
  25494. <th>Field</th>
  25495. <th>Description</th>
  25496. </tr>
  25497. </thead>
  25498. <tbody>
  25499. <tr>
  25500. <td>
  25501. <code>path</code></br>
  25502. <em>
  25503. string
  25504. </em>
  25505. </td>
  25506. <td>
  25507. <p>Path where the App Role authentication backend is mounted
  25508. in Vault, e.g: &ldquo;approle&rdquo;</p>
  25509. </td>
  25510. </tr>
  25511. <tr>
  25512. <td>
  25513. <code>roleId</code></br>
  25514. <em>
  25515. string
  25516. </em>
  25517. </td>
  25518. <td>
  25519. <em>(Optional)</em>
  25520. <p>RoleID configured in the App Role authentication backend when setting
  25521. up the authentication backend in Vault.</p>
  25522. </td>
  25523. </tr>
  25524. <tr>
  25525. <td>
  25526. <code>roleRef</code></br>
  25527. <em>
  25528. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25529. External Secrets meta/v1.SecretKeySelector
  25530. </a>
  25531. </em>
  25532. </td>
  25533. <td>
  25534. <em>(Optional)</em>
  25535. <p>Reference to a key in a Secret that contains the App Role ID used
  25536. to authenticate with Vault.
  25537. The <code>key</code> field must be specified and denotes which entry within the Secret
  25538. resource is used as the app role id.</p>
  25539. </td>
  25540. </tr>
  25541. <tr>
  25542. <td>
  25543. <code>secretRef</code></br>
  25544. <em>
  25545. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25546. External Secrets meta/v1.SecretKeySelector
  25547. </a>
  25548. </em>
  25549. </td>
  25550. <td>
  25551. <p>Reference to a key in a Secret that contains the App Role secret used
  25552. to authenticate with Vault.
  25553. The <code>key</code> field must be specified and denotes which entry within the Secret
  25554. resource is used as the app role secret.</p>
  25555. </td>
  25556. </tr>
  25557. </tbody>
  25558. </table>
  25559. <h3 id="external-secrets.io/v1beta1.VaultAuth">VaultAuth
  25560. </h3>
  25561. <p>
  25562. (<em>Appears on:</em>
  25563. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  25564. </p>
  25565. <p>
  25566. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  25567. 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>
  25568. can be specified. A namespace to authenticate against can optionally be specified.</p>
  25569. </p>
  25570. <table>
  25571. <thead>
  25572. <tr>
  25573. <th>Field</th>
  25574. <th>Description</th>
  25575. </tr>
  25576. </thead>
  25577. <tbody>
  25578. <tr>
  25579. <td>
  25580. <code>namespace</code></br>
  25581. <em>
  25582. string
  25583. </em>
  25584. </td>
  25585. <td>
  25586. <em>(Optional)</em>
  25587. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  25588. Namespaces is a set of features within Vault Enterprise that allows
  25589. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  25590. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  25591. This will default to Vault.Namespace field if set, or empty otherwise</p>
  25592. </td>
  25593. </tr>
  25594. <tr>
  25595. <td>
  25596. <code>tokenSecretRef</code></br>
  25597. <em>
  25598. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25599. External Secrets meta/v1.SecretKeySelector
  25600. </a>
  25601. </em>
  25602. </td>
  25603. <td>
  25604. <em>(Optional)</em>
  25605. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  25606. </td>
  25607. </tr>
  25608. <tr>
  25609. <td>
  25610. <code>appRole</code></br>
  25611. <em>
  25612. <a href="#external-secrets.io/v1beta1.VaultAppRole">
  25613. VaultAppRole
  25614. </a>
  25615. </em>
  25616. </td>
  25617. <td>
  25618. <em>(Optional)</em>
  25619. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  25620. with the role and secret stored in a Kubernetes Secret resource.</p>
  25621. </td>
  25622. </tr>
  25623. <tr>
  25624. <td>
  25625. <code>kubernetes</code></br>
  25626. <em>
  25627. <a href="#external-secrets.io/v1beta1.VaultKubernetesAuth">
  25628. VaultKubernetesAuth
  25629. </a>
  25630. </em>
  25631. </td>
  25632. <td>
  25633. <em>(Optional)</em>
  25634. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  25635. token stored in the named Secret resource to the Vault server.</p>
  25636. </td>
  25637. </tr>
  25638. <tr>
  25639. <td>
  25640. <code>ldap</code></br>
  25641. <em>
  25642. <a href="#external-secrets.io/v1beta1.VaultLdapAuth">
  25643. VaultLdapAuth
  25644. </a>
  25645. </em>
  25646. </td>
  25647. <td>
  25648. <em>(Optional)</em>
  25649. <p>Ldap authenticates with Vault by passing username/password pair using
  25650. the LDAP authentication method</p>
  25651. </td>
  25652. </tr>
  25653. <tr>
  25654. <td>
  25655. <code>jwt</code></br>
  25656. <em>
  25657. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">
  25658. VaultJwtAuth
  25659. </a>
  25660. </em>
  25661. </td>
  25662. <td>
  25663. <em>(Optional)</em>
  25664. <p>Jwt authenticates with Vault by passing role and JWT token using the
  25665. JWT/OIDC authentication method</p>
  25666. </td>
  25667. </tr>
  25668. <tr>
  25669. <td>
  25670. <code>cert</code></br>
  25671. <em>
  25672. <a href="#external-secrets.io/v1beta1.VaultCertAuth">
  25673. VaultCertAuth
  25674. </a>
  25675. </em>
  25676. </td>
  25677. <td>
  25678. <em>(Optional)</em>
  25679. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  25680. Cert authentication method</p>
  25681. </td>
  25682. </tr>
  25683. <tr>
  25684. <td>
  25685. <code>iam</code></br>
  25686. <em>
  25687. <a href="#external-secrets.io/v1beta1.VaultIamAuth">
  25688. VaultIamAuth
  25689. </a>
  25690. </em>
  25691. </td>
  25692. <td>
  25693. <em>(Optional)</em>
  25694. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  25695. AWS IAM authentication method</p>
  25696. </td>
  25697. </tr>
  25698. <tr>
  25699. <td>
  25700. <code>userPass</code></br>
  25701. <em>
  25702. <a href="#external-secrets.io/v1beta1.VaultUserPassAuth">
  25703. VaultUserPassAuth
  25704. </a>
  25705. </em>
  25706. </td>
  25707. <td>
  25708. <em>(Optional)</em>
  25709. <p>UserPass authenticates with Vault by passing username/password pair</p>
  25710. </td>
  25711. </tr>
  25712. </tbody>
  25713. </table>
  25714. <h3 id="external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth
  25715. </h3>
  25716. <p>
  25717. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  25718. Only one of secretRef or jwt can be specified.
  25719. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  25720. </p>
  25721. <table>
  25722. <thead>
  25723. <tr>
  25724. <th>Field</th>
  25725. <th>Description</th>
  25726. </tr>
  25727. </thead>
  25728. <tbody>
  25729. <tr>
  25730. <td>
  25731. <code>secretRef</code></br>
  25732. <em>
  25733. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  25734. VaultAwsAuthSecretRef
  25735. </a>
  25736. </em>
  25737. </td>
  25738. <td>
  25739. <em>(Optional)</em>
  25740. </td>
  25741. </tr>
  25742. <tr>
  25743. <td>
  25744. <code>jwt</code></br>
  25745. <em>
  25746. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  25747. VaultAwsJWTAuth
  25748. </a>
  25749. </em>
  25750. </td>
  25751. <td>
  25752. <em>(Optional)</em>
  25753. </td>
  25754. </tr>
  25755. </tbody>
  25756. </table>
  25757. <h3 id="external-secrets.io/v1beta1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  25758. </h3>
  25759. <p>
  25760. (<em>Appears on:</em>
  25761. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  25762. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  25763. </p>
  25764. <p>
  25765. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  25766. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  25767. </p>
  25768. <table>
  25769. <thead>
  25770. <tr>
  25771. <th>Field</th>
  25772. <th>Description</th>
  25773. </tr>
  25774. </thead>
  25775. <tbody>
  25776. <tr>
  25777. <td>
  25778. <code>accessKeyIDSecretRef</code></br>
  25779. <em>
  25780. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25781. External Secrets meta/v1.SecretKeySelector
  25782. </a>
  25783. </em>
  25784. </td>
  25785. <td>
  25786. <em>(Optional)</em>
  25787. <p>The AccessKeyID is used for authentication</p>
  25788. </td>
  25789. </tr>
  25790. <tr>
  25791. <td>
  25792. <code>secretAccessKeySecretRef</code></br>
  25793. <em>
  25794. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25795. External Secrets meta/v1.SecretKeySelector
  25796. </a>
  25797. </em>
  25798. </td>
  25799. <td>
  25800. <em>(Optional)</em>
  25801. <p>The SecretAccessKey is used for authentication</p>
  25802. </td>
  25803. </tr>
  25804. <tr>
  25805. <td>
  25806. <code>sessionTokenSecretRef</code></br>
  25807. <em>
  25808. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25809. External Secrets meta/v1.SecretKeySelector
  25810. </a>
  25811. </em>
  25812. </td>
  25813. <td>
  25814. <em>(Optional)</em>
  25815. <p>The SessionToken used for authentication
  25816. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  25817. 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>
  25818. </td>
  25819. </tr>
  25820. </tbody>
  25821. </table>
  25822. <h3 id="external-secrets.io/v1beta1.VaultAwsJWTAuth">VaultAwsJWTAuth
  25823. </h3>
  25824. <p>
  25825. (<em>Appears on:</em>
  25826. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  25827. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  25828. </p>
  25829. <p>
  25830. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  25831. </p>
  25832. <table>
  25833. <thead>
  25834. <tr>
  25835. <th>Field</th>
  25836. <th>Description</th>
  25837. </tr>
  25838. </thead>
  25839. <tbody>
  25840. <tr>
  25841. <td>
  25842. <code>serviceAccountRef</code></br>
  25843. <em>
  25844. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  25845. External Secrets meta/v1.ServiceAccountSelector
  25846. </a>
  25847. </em>
  25848. </td>
  25849. <td>
  25850. <em>(Optional)</em>
  25851. </td>
  25852. </tr>
  25853. </tbody>
  25854. </table>
  25855. <h3 id="external-secrets.io/v1beta1.VaultCertAuth">VaultCertAuth
  25856. </h3>
  25857. <p>
  25858. (<em>Appears on:</em>
  25859. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25860. </p>
  25861. <p>
  25862. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  25863. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  25864. </p>
  25865. <table>
  25866. <thead>
  25867. <tr>
  25868. <th>Field</th>
  25869. <th>Description</th>
  25870. </tr>
  25871. </thead>
  25872. <tbody>
  25873. <tr>
  25874. <td>
  25875. <code>clientCert</code></br>
  25876. <em>
  25877. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25878. External Secrets meta/v1.SecretKeySelector
  25879. </a>
  25880. </em>
  25881. </td>
  25882. <td>
  25883. <em>(Optional)</em>
  25884. <p>ClientCert is a certificate to authenticate using the Cert Vault
  25885. authentication method</p>
  25886. </td>
  25887. </tr>
  25888. <tr>
  25889. <td>
  25890. <code>secretRef</code></br>
  25891. <em>
  25892. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25893. External Secrets meta/v1.SecretKeySelector
  25894. </a>
  25895. </em>
  25896. </td>
  25897. <td>
  25898. <em>(Optional)</em>
  25899. <p>SecretRef to a key in a Secret resource containing client private key to
  25900. authenticate with Vault using the Cert authentication method</p>
  25901. </td>
  25902. </tr>
  25903. </tbody>
  25904. </table>
  25905. <h3 id="external-secrets.io/v1beta1.VaultClientTLS">VaultClientTLS
  25906. </h3>
  25907. <p>
  25908. (<em>Appears on:</em>
  25909. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  25910. </p>
  25911. <p>
  25912. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  25913. when the Vault server requires mutual authentication.</p>
  25914. </p>
  25915. <table>
  25916. <thead>
  25917. <tr>
  25918. <th>Field</th>
  25919. <th>Description</th>
  25920. </tr>
  25921. </thead>
  25922. <tbody>
  25923. <tr>
  25924. <td>
  25925. <code>certSecretRef</code></br>
  25926. <em>
  25927. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25928. External Secrets meta/v1.SecretKeySelector
  25929. </a>
  25930. </em>
  25931. </td>
  25932. <td>
  25933. <em>(Optional)</em>
  25934. <p>CertSecretRef is a certificate added to the transport layer
  25935. when communicating with the Vault server.
  25936. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  25937. </td>
  25938. </tr>
  25939. <tr>
  25940. <td>
  25941. <code>keySecretRef</code></br>
  25942. <em>
  25943. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25944. External Secrets meta/v1.SecretKeySelector
  25945. </a>
  25946. </em>
  25947. </td>
  25948. <td>
  25949. <em>(Optional)</em>
  25950. <p>KeySecretRef to a key in a Secret resource containing client private key
  25951. added to the transport layer when communicating with the Vault server.
  25952. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  25953. </td>
  25954. </tr>
  25955. </tbody>
  25956. </table>
  25957. <h3 id="external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth
  25958. </h3>
  25959. <p>
  25960. (<em>Appears on:</em>
  25961. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25962. </p>
  25963. <p>
  25964. <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>
  25965. </p>
  25966. <table>
  25967. <thead>
  25968. <tr>
  25969. <th>Field</th>
  25970. <th>Description</th>
  25971. </tr>
  25972. </thead>
  25973. <tbody>
  25974. <tr>
  25975. <td>
  25976. <code>path</code></br>
  25977. <em>
  25978. string
  25979. </em>
  25980. </td>
  25981. <td>
  25982. <em>(Optional)</em>
  25983. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  25984. </td>
  25985. </tr>
  25986. <tr>
  25987. <td>
  25988. <code>region</code></br>
  25989. <em>
  25990. string
  25991. </em>
  25992. </td>
  25993. <td>
  25994. <em>(Optional)</em>
  25995. <p>AWS region</p>
  25996. </td>
  25997. </tr>
  25998. <tr>
  25999. <td>
  26000. <code>role</code></br>
  26001. <em>
  26002. string
  26003. </em>
  26004. </td>
  26005. <td>
  26006. <em>(Optional)</em>
  26007. <p>This is the AWS role to be assumed before talking to vault</p>
  26008. </td>
  26009. </tr>
  26010. <tr>
  26011. <td>
  26012. <code>vaultRole</code></br>
  26013. <em>
  26014. string
  26015. </em>
  26016. </td>
  26017. <td>
  26018. <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>
  26019. </td>
  26020. </tr>
  26021. <tr>
  26022. <td>
  26023. <code>externalID</code></br>
  26024. <em>
  26025. string
  26026. </em>
  26027. </td>
  26028. <td>
  26029. <p>AWS External ID set on assumed IAM roles</p>
  26030. </td>
  26031. </tr>
  26032. <tr>
  26033. <td>
  26034. <code>vaultAwsIamServerID</code></br>
  26035. <em>
  26036. string
  26037. </em>
  26038. </td>
  26039. <td>
  26040. <em>(Optional)</em>
  26041. <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>
  26042. </td>
  26043. </tr>
  26044. <tr>
  26045. <td>
  26046. <code>secretRef</code></br>
  26047. <em>
  26048. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  26049. VaultAwsAuthSecretRef
  26050. </a>
  26051. </em>
  26052. </td>
  26053. <td>
  26054. <em>(Optional)</em>
  26055. <p>Specify credentials in a Secret object</p>
  26056. </td>
  26057. </tr>
  26058. <tr>
  26059. <td>
  26060. <code>jwt</code></br>
  26061. <em>
  26062. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  26063. VaultAwsJWTAuth
  26064. </a>
  26065. </em>
  26066. </td>
  26067. <td>
  26068. <em>(Optional)</em>
  26069. <p>Specify a service account with IRSA enabled</p>
  26070. </td>
  26071. </tr>
  26072. </tbody>
  26073. </table>
  26074. <h3 id="external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth
  26075. </h3>
  26076. <p>
  26077. (<em>Appears on:</em>
  26078. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26079. </p>
  26080. <p>
  26081. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  26082. method, with the role name and a token stored in a Kubernetes Secret resource or
  26083. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  26084. </p>
  26085. <table>
  26086. <thead>
  26087. <tr>
  26088. <th>Field</th>
  26089. <th>Description</th>
  26090. </tr>
  26091. </thead>
  26092. <tbody>
  26093. <tr>
  26094. <td>
  26095. <code>path</code></br>
  26096. <em>
  26097. string
  26098. </em>
  26099. </td>
  26100. <td>
  26101. <p>Path where the JWT authentication backend is mounted
  26102. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  26103. </td>
  26104. </tr>
  26105. <tr>
  26106. <td>
  26107. <code>role</code></br>
  26108. <em>
  26109. string
  26110. </em>
  26111. </td>
  26112. <td>
  26113. <em>(Optional)</em>
  26114. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  26115. authentication method</p>
  26116. </td>
  26117. </tr>
  26118. <tr>
  26119. <td>
  26120. <code>secretRef</code></br>
  26121. <em>
  26122. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26123. External Secrets meta/v1.SecretKeySelector
  26124. </a>
  26125. </em>
  26126. </td>
  26127. <td>
  26128. <em>(Optional)</em>
  26129. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  26130. authenticate with Vault using the JWT/OIDC authentication method.</p>
  26131. </td>
  26132. </tr>
  26133. <tr>
  26134. <td>
  26135. <code>kubernetesServiceAccountToken</code></br>
  26136. <em>
  26137. <a href="#external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">
  26138. VaultKubernetesServiceAccountTokenAuth
  26139. </a>
  26140. </em>
  26141. </td>
  26142. <td>
  26143. <em>(Optional)</em>
  26144. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  26145. a token for with the <code>TokenRequest</code> API.</p>
  26146. </td>
  26147. </tr>
  26148. </tbody>
  26149. </table>
  26150. <h3 id="external-secrets.io/v1beta1.VaultKVStoreVersion">VaultKVStoreVersion
  26151. (<code>string</code> alias)</p></h3>
  26152. <p>
  26153. (<em>Appears on:</em>
  26154. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  26155. </p>
  26156. <p>
  26157. <p>VaultKVStoreVersion defines the version of the KV store in Vault.</p>
  26158. </p>
  26159. <table>
  26160. <thead>
  26161. <tr>
  26162. <th>Value</th>
  26163. <th>Description</th>
  26164. </tr>
  26165. </thead>
  26166. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  26167. <td><p>VaultKVStoreV1 represents version 1 of the Vault KV store.</p>
  26168. </td>
  26169. </tr><tr><td><p>&#34;v2&#34;</p></td>
  26170. <td><p>VaultKVStoreV2 represents version 2 of the Vault KV store.</p>
  26171. </td>
  26172. </tr></tbody>
  26173. </table>
  26174. <h3 id="external-secrets.io/v1beta1.VaultKubernetesAuth">VaultKubernetesAuth
  26175. </h3>
  26176. <p>
  26177. (<em>Appears on:</em>
  26178. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26179. </p>
  26180. <p>
  26181. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in a Secret.</p>
  26182. </p>
  26183. <table>
  26184. <thead>
  26185. <tr>
  26186. <th>Field</th>
  26187. <th>Description</th>
  26188. </tr>
  26189. </thead>
  26190. <tbody>
  26191. <tr>
  26192. <td>
  26193. <code>mountPath</code></br>
  26194. <em>
  26195. string
  26196. </em>
  26197. </td>
  26198. <td>
  26199. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  26200. &ldquo;kubernetes&rdquo;</p>
  26201. </td>
  26202. </tr>
  26203. <tr>
  26204. <td>
  26205. <code>serviceAccountRef</code></br>
  26206. <em>
  26207. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26208. External Secrets meta/v1.ServiceAccountSelector
  26209. </a>
  26210. </em>
  26211. </td>
  26212. <td>
  26213. <em>(Optional)</em>
  26214. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  26215. If the service account is specified, the service account secret token JWT will be used
  26216. for authenticating with Vault. If the service account selector is not supplied,
  26217. the secretRef will be used instead.</p>
  26218. </td>
  26219. </tr>
  26220. <tr>
  26221. <td>
  26222. <code>secretRef</code></br>
  26223. <em>
  26224. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26225. External Secrets meta/v1.SecretKeySelector
  26226. </a>
  26227. </em>
  26228. </td>
  26229. <td>
  26230. <em>(Optional)</em>
  26231. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  26232. for authenticating with Vault. If a name is specified without a key,
  26233. <code>token</code> is the default. If one is not specified, the one bound to
  26234. the controller will be used.</p>
  26235. </td>
  26236. </tr>
  26237. <tr>
  26238. <td>
  26239. <code>role</code></br>
  26240. <em>
  26241. string
  26242. </em>
  26243. </td>
  26244. <td>
  26245. <p>A required field containing the Vault Role to assume. A Role binds a
  26246. Kubernetes ServiceAccount with a set of Vault policies.</p>
  26247. </td>
  26248. </tr>
  26249. </tbody>
  26250. </table>
  26251. <h3 id="external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  26252. </h3>
  26253. <p>
  26254. (<em>Appears on:</em>
  26255. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth</a>)
  26256. </p>
  26257. <p>
  26258. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  26259. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  26260. </p>
  26261. <table>
  26262. <thead>
  26263. <tr>
  26264. <th>Field</th>
  26265. <th>Description</th>
  26266. </tr>
  26267. </thead>
  26268. <tbody>
  26269. <tr>
  26270. <td>
  26271. <code>serviceAccountRef</code></br>
  26272. <em>
  26273. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26274. External Secrets meta/v1.ServiceAccountSelector
  26275. </a>
  26276. </em>
  26277. </td>
  26278. <td>
  26279. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  26280. </td>
  26281. </tr>
  26282. <tr>
  26283. <td>
  26284. <code>audiences</code></br>
  26285. <em>
  26286. []string
  26287. </em>
  26288. </td>
  26289. <td>
  26290. <em>(Optional)</em>
  26291. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  26292. account token for the service account referenced by <code>serviceAccountRef</code>.
  26293. Defaults to a single audience <code>vault</code> it not specified.</p>
  26294. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  26295. </td>
  26296. </tr>
  26297. <tr>
  26298. <td>
  26299. <code>expirationSeconds</code></br>
  26300. <em>
  26301. int64
  26302. </em>
  26303. </td>
  26304. <td>
  26305. <em>(Optional)</em>
  26306. <p>Optional expiration time in seconds that will be used to request a temporary
  26307. Kubernetes service account token for the service account referenced by
  26308. <code>serviceAccountRef</code>.</p>
  26309. <p>Deprecated: this will be removed in the future.
  26310. Defaults to 10 minutes.</p>
  26311. </td>
  26312. </tr>
  26313. </tbody>
  26314. </table>
  26315. <h3 id="external-secrets.io/v1beta1.VaultLdapAuth">VaultLdapAuth
  26316. </h3>
  26317. <p>
  26318. (<em>Appears on:</em>
  26319. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26320. </p>
  26321. <p>
  26322. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  26323. with the username and password stored in a Kubernetes Secret resource.</p>
  26324. </p>
  26325. <table>
  26326. <thead>
  26327. <tr>
  26328. <th>Field</th>
  26329. <th>Description</th>
  26330. </tr>
  26331. </thead>
  26332. <tbody>
  26333. <tr>
  26334. <td>
  26335. <code>path</code></br>
  26336. <em>
  26337. string
  26338. </em>
  26339. </td>
  26340. <td>
  26341. <p>Path where the LDAP authentication backend is mounted
  26342. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  26343. </td>
  26344. </tr>
  26345. <tr>
  26346. <td>
  26347. <code>username</code></br>
  26348. <em>
  26349. string
  26350. </em>
  26351. </td>
  26352. <td>
  26353. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  26354. authentication method</p>
  26355. </td>
  26356. </tr>
  26357. <tr>
  26358. <td>
  26359. <code>secretRef</code></br>
  26360. <em>
  26361. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26362. External Secrets meta/v1.SecretKeySelector
  26363. </a>
  26364. </em>
  26365. </td>
  26366. <td>
  26367. <em>(Optional)</em>
  26368. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  26369. user used to authenticate with Vault using the LDAP authentication
  26370. method</p>
  26371. </td>
  26372. </tr>
  26373. </tbody>
  26374. </table>
  26375. <h3 id="external-secrets.io/v1beta1.VaultProvider">VaultProvider
  26376. </h3>
  26377. <p>
  26378. (<em>Appears on:</em>
  26379. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26380. </p>
  26381. <p>
  26382. <p>VaultProvider configures a store to sync secrets using a HashiCorp Vault KV backend.</p>
  26383. </p>
  26384. <table>
  26385. <thead>
  26386. <tr>
  26387. <th>Field</th>
  26388. <th>Description</th>
  26389. </tr>
  26390. </thead>
  26391. <tbody>
  26392. <tr>
  26393. <td>
  26394. <code>auth</code></br>
  26395. <em>
  26396. <a href="#external-secrets.io/v1beta1.VaultAuth">
  26397. VaultAuth
  26398. </a>
  26399. </em>
  26400. </td>
  26401. <td>
  26402. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  26403. </td>
  26404. </tr>
  26405. <tr>
  26406. <td>
  26407. <code>server</code></br>
  26408. <em>
  26409. string
  26410. </em>
  26411. </td>
  26412. <td>
  26413. <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>
  26414. </td>
  26415. </tr>
  26416. <tr>
  26417. <td>
  26418. <code>path</code></br>
  26419. <em>
  26420. string
  26421. </em>
  26422. </td>
  26423. <td>
  26424. <em>(Optional)</em>
  26425. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  26426. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  26427. for fetching secrets from Vault is optional and will be appended
  26428. if not present in specified path.</p>
  26429. </td>
  26430. </tr>
  26431. <tr>
  26432. <td>
  26433. <code>version</code></br>
  26434. <em>
  26435. <a href="#external-secrets.io/v1beta1.VaultKVStoreVersion">
  26436. VaultKVStoreVersion
  26437. </a>
  26438. </em>
  26439. </td>
  26440. <td>
  26441. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  26442. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  26443. </td>
  26444. </tr>
  26445. <tr>
  26446. <td>
  26447. <code>namespace</code></br>
  26448. <em>
  26449. string
  26450. </em>
  26451. </td>
  26452. <td>
  26453. <em>(Optional)</em>
  26454. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  26455. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  26456. 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>
  26457. </td>
  26458. </tr>
  26459. <tr>
  26460. <td>
  26461. <code>caBundle</code></br>
  26462. <em>
  26463. []byte
  26464. </em>
  26465. </td>
  26466. <td>
  26467. <em>(Optional)</em>
  26468. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  26469. if the Server URL is using HTTPS protocol. This parameter is ignored for
  26470. plain HTTP protocol connection. If not set the system root certificates
  26471. are used to validate the TLS connection.</p>
  26472. </td>
  26473. </tr>
  26474. <tr>
  26475. <td>
  26476. <code>tls</code></br>
  26477. <em>
  26478. <a href="#external-secrets.io/v1beta1.VaultClientTLS">
  26479. VaultClientTLS
  26480. </a>
  26481. </em>
  26482. </td>
  26483. <td>
  26484. <em>(Optional)</em>
  26485. <p>The configuration used for client side related TLS communication, when the Vault server
  26486. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  26487. This parameter is ignored for plain HTTP protocol connection.
  26488. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  26489. which is available under the <code>auth.cert</code> section.</p>
  26490. </td>
  26491. </tr>
  26492. <tr>
  26493. <td>
  26494. <code>caProvider</code></br>
  26495. <em>
  26496. <a href="#external-secrets.io/v1beta1.CAProvider">
  26497. CAProvider
  26498. </a>
  26499. </em>
  26500. </td>
  26501. <td>
  26502. <em>(Optional)</em>
  26503. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  26504. </td>
  26505. </tr>
  26506. <tr>
  26507. <td>
  26508. <code>readYourWrites</code></br>
  26509. <em>
  26510. bool
  26511. </em>
  26512. </td>
  26513. <td>
  26514. <em>(Optional)</em>
  26515. <p>ReadYourWrites ensures isolated read-after-write semantics by
  26516. providing discovered cluster replication states in each request.
  26517. More information about eventual consistency in Vault can be found here
  26518. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  26519. </td>
  26520. </tr>
  26521. <tr>
  26522. <td>
  26523. <code>forwardInconsistent</code></br>
  26524. <em>
  26525. bool
  26526. </em>
  26527. </td>
  26528. <td>
  26529. <em>(Optional)</em>
  26530. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  26531. leader instead of simply retrying within a loop. This can increase performance if
  26532. the option is enabled serverside.
  26533. <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>
  26534. </td>
  26535. </tr>
  26536. <tr>
  26537. <td>
  26538. <code>headers</code></br>
  26539. <em>
  26540. map[string]string
  26541. </em>
  26542. </td>
  26543. <td>
  26544. <em>(Optional)</em>
  26545. <p>Headers to be added in Vault request</p>
  26546. </td>
  26547. </tr>
  26548. </tbody>
  26549. </table>
  26550. <h3 id="external-secrets.io/v1beta1.VaultUserPassAuth">VaultUserPassAuth
  26551. </h3>
  26552. <p>
  26553. (<em>Appears on:</em>
  26554. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26555. </p>
  26556. <p>
  26557. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  26558. with the username and password stored in a Kubernetes Secret resource.</p>
  26559. </p>
  26560. <table>
  26561. <thead>
  26562. <tr>
  26563. <th>Field</th>
  26564. <th>Description</th>
  26565. </tr>
  26566. </thead>
  26567. <tbody>
  26568. <tr>
  26569. <td>
  26570. <code>path</code></br>
  26571. <em>
  26572. string
  26573. </em>
  26574. </td>
  26575. <td>
  26576. <p>Path where the UserPassword authentication backend is mounted
  26577. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  26578. </td>
  26579. </tr>
  26580. <tr>
  26581. <td>
  26582. <code>username</code></br>
  26583. <em>
  26584. string
  26585. </em>
  26586. </td>
  26587. <td>
  26588. <p>Username is a username used to authenticate using the UserPass Vault
  26589. authentication method</p>
  26590. </td>
  26591. </tr>
  26592. <tr>
  26593. <td>
  26594. <code>secretRef</code></br>
  26595. <em>
  26596. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26597. External Secrets meta/v1.SecretKeySelector
  26598. </a>
  26599. </em>
  26600. </td>
  26601. <td>
  26602. <em>(Optional)</em>
  26603. <p>SecretRef to a key in a Secret resource containing password for the
  26604. user used to authenticate with Vault using the UserPass authentication
  26605. method</p>
  26606. </td>
  26607. </tr>
  26608. </tbody>
  26609. </table>
  26610. <h3 id="external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider
  26611. </h3>
  26612. <p>
  26613. (<em>Appears on:</em>
  26614. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26615. </p>
  26616. <p>
  26617. <p>WebhookCAProvider defines a location to fetch the certificate for the webhook provider.</p>
  26618. </p>
  26619. <table>
  26620. <thead>
  26621. <tr>
  26622. <th>Field</th>
  26623. <th>Description</th>
  26624. </tr>
  26625. </thead>
  26626. <tbody>
  26627. <tr>
  26628. <td>
  26629. <code>type</code></br>
  26630. <em>
  26631. <a href="#external-secrets.io/v1beta1.WebhookCAProviderType">
  26632. WebhookCAProviderType
  26633. </a>
  26634. </em>
  26635. </td>
  26636. <td>
  26637. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  26638. </td>
  26639. </tr>
  26640. <tr>
  26641. <td>
  26642. <code>name</code></br>
  26643. <em>
  26644. string
  26645. </em>
  26646. </td>
  26647. <td>
  26648. <p>The name of the object located at the provider type.</p>
  26649. </td>
  26650. </tr>
  26651. <tr>
  26652. <td>
  26653. <code>key</code></br>
  26654. <em>
  26655. string
  26656. </em>
  26657. </td>
  26658. <td>
  26659. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  26660. </td>
  26661. </tr>
  26662. <tr>
  26663. <td>
  26664. <code>namespace</code></br>
  26665. <em>
  26666. string
  26667. </em>
  26668. </td>
  26669. <td>
  26670. <em>(Optional)</em>
  26671. <p>The namespace the Provider type is in.</p>
  26672. </td>
  26673. </tr>
  26674. </tbody>
  26675. </table>
  26676. <h3 id="external-secrets.io/v1beta1.WebhookCAProviderType">WebhookCAProviderType
  26677. (<code>string</code> alias)</p></h3>
  26678. <p>
  26679. (<em>Appears on:</em>
  26680. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider</a>)
  26681. </p>
  26682. <p>
  26683. <p>WebhookCAProviderType defines the type of provider to use for CA certificates with Webhook providers.</p>
  26684. </p>
  26685. <table>
  26686. <thead>
  26687. <tr>
  26688. <th>Value</th>
  26689. <th>Description</th>
  26690. </tr>
  26691. </thead>
  26692. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  26693. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  26694. </td>
  26695. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  26696. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  26697. </td>
  26698. </tr></tbody>
  26699. </table>
  26700. <h3 id="external-secrets.io/v1beta1.WebhookProvider">WebhookProvider
  26701. </h3>
  26702. <p>
  26703. (<em>Appears on:</em>
  26704. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26705. </p>
  26706. <p>
  26707. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</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>method</code></br>
  26720. <em>
  26721. string
  26722. </em>
  26723. </td>
  26724. <td>
  26725. <p>Webhook Method</p>
  26726. </td>
  26727. </tr>
  26728. <tr>
  26729. <td>
  26730. <code>url</code></br>
  26731. <em>
  26732. string
  26733. </em>
  26734. </td>
  26735. <td>
  26736. <p>Webhook url to call</p>
  26737. </td>
  26738. </tr>
  26739. <tr>
  26740. <td>
  26741. <code>headers</code></br>
  26742. <em>
  26743. map[string]string
  26744. </em>
  26745. </td>
  26746. <td>
  26747. <em>(Optional)</em>
  26748. <p>Headers</p>
  26749. </td>
  26750. </tr>
  26751. <tr>
  26752. <td>
  26753. <code>auth</code></br>
  26754. <em>
  26755. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">
  26756. AuthorizationProtocol
  26757. </a>
  26758. </em>
  26759. </td>
  26760. <td>
  26761. <em>(Optional)</em>
  26762. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  26763. </td>
  26764. </tr>
  26765. <tr>
  26766. <td>
  26767. <code>body</code></br>
  26768. <em>
  26769. string
  26770. </em>
  26771. </td>
  26772. <td>
  26773. <em>(Optional)</em>
  26774. <p>Body</p>
  26775. </td>
  26776. </tr>
  26777. <tr>
  26778. <td>
  26779. <code>timeout</code></br>
  26780. <em>
  26781. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  26782. Kubernetes meta/v1.Duration
  26783. </a>
  26784. </em>
  26785. </td>
  26786. <td>
  26787. <em>(Optional)</em>
  26788. <p>Timeout</p>
  26789. </td>
  26790. </tr>
  26791. <tr>
  26792. <td>
  26793. <code>result</code></br>
  26794. <em>
  26795. <a href="#external-secrets.io/v1beta1.WebhookResult">
  26796. WebhookResult
  26797. </a>
  26798. </em>
  26799. </td>
  26800. <td>
  26801. <p>Result formatting</p>
  26802. </td>
  26803. </tr>
  26804. <tr>
  26805. <td>
  26806. <code>secrets</code></br>
  26807. <em>
  26808. <a href="#external-secrets.io/v1beta1.WebhookSecret">
  26809. []WebhookSecret
  26810. </a>
  26811. </em>
  26812. </td>
  26813. <td>
  26814. <em>(Optional)</em>
  26815. <p>Secrets to fill in templates
  26816. These secrets will be passed to the templating function as key value pairs under the given name</p>
  26817. </td>
  26818. </tr>
  26819. <tr>
  26820. <td>
  26821. <code>caBundle</code></br>
  26822. <em>
  26823. []byte
  26824. </em>
  26825. </td>
  26826. <td>
  26827. <em>(Optional)</em>
  26828. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  26829. if the Server URL is using HTTPS protocol. This parameter is ignored for
  26830. plain HTTP protocol connection. If not set the system root certificates
  26831. are used to validate the TLS connection.</p>
  26832. </td>
  26833. </tr>
  26834. <tr>
  26835. <td>
  26836. <code>caProvider</code></br>
  26837. <em>
  26838. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">
  26839. WebhookCAProvider
  26840. </a>
  26841. </em>
  26842. </td>
  26843. <td>
  26844. <em>(Optional)</em>
  26845. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  26846. </td>
  26847. </tr>
  26848. </tbody>
  26849. </table>
  26850. <h3 id="external-secrets.io/v1beta1.WebhookResult">WebhookResult
  26851. </h3>
  26852. <p>
  26853. (<em>Appears on:</em>
  26854. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26855. </p>
  26856. <p>
  26857. <p>WebhookResult defines how to extract and format the result from the webhook response.</p>
  26858. </p>
  26859. <table>
  26860. <thead>
  26861. <tr>
  26862. <th>Field</th>
  26863. <th>Description</th>
  26864. </tr>
  26865. </thead>
  26866. <tbody>
  26867. <tr>
  26868. <td>
  26869. <code>jsonPath</code></br>
  26870. <em>
  26871. string
  26872. </em>
  26873. </td>
  26874. <td>
  26875. <em>(Optional)</em>
  26876. <p>Json path of return value</p>
  26877. </td>
  26878. </tr>
  26879. </tbody>
  26880. </table>
  26881. <h3 id="external-secrets.io/v1beta1.WebhookSecret">WebhookSecret
  26882. </h3>
  26883. <p>
  26884. (<em>Appears on:</em>
  26885. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26886. </p>
  26887. <p>
  26888. <p>WebhookSecret defines a secret to be used in webhook templates.</p>
  26889. </p>
  26890. <table>
  26891. <thead>
  26892. <tr>
  26893. <th>Field</th>
  26894. <th>Description</th>
  26895. </tr>
  26896. </thead>
  26897. <tbody>
  26898. <tr>
  26899. <td>
  26900. <code>name</code></br>
  26901. <em>
  26902. string
  26903. </em>
  26904. </td>
  26905. <td>
  26906. <p>Name of this secret in templates</p>
  26907. </td>
  26908. </tr>
  26909. <tr>
  26910. <td>
  26911. <code>secretRef</code></br>
  26912. <em>
  26913. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26914. External Secrets meta/v1.SecretKeySelector
  26915. </a>
  26916. </em>
  26917. </td>
  26918. <td>
  26919. <p>Secret ref to fill in credentials</p>
  26920. </td>
  26921. </tr>
  26922. </tbody>
  26923. </table>
  26924. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerAuth">YandexCertificateManagerAuth
  26925. </h3>
  26926. <p>
  26927. (<em>Appears on:</em>
  26928. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  26929. </p>
  26930. <p>
  26931. <p>YandexCertificateManagerAuth defines authentication configuration for the Yandex Certificate Manager provider.</p>
  26932. </p>
  26933. <table>
  26934. <thead>
  26935. <tr>
  26936. <th>Field</th>
  26937. <th>Description</th>
  26938. </tr>
  26939. </thead>
  26940. <tbody>
  26941. <tr>
  26942. <td>
  26943. <code>authorizedKeySecretRef</code></br>
  26944. <em>
  26945. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26946. External Secrets meta/v1.SecretKeySelector
  26947. </a>
  26948. </em>
  26949. </td>
  26950. <td>
  26951. <em>(Optional)</em>
  26952. <p>The authorized key used for authentication</p>
  26953. </td>
  26954. </tr>
  26955. </tbody>
  26956. </table>
  26957. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">YandexCertificateManagerCAProvider
  26958. </h3>
  26959. <p>
  26960. (<em>Appears on:</em>
  26961. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  26962. </p>
  26963. <p>
  26964. <p>YandexCertificateManagerCAProvider defines CA certificate configuration for Yandex Certificate Manager.</p>
  26965. </p>
  26966. <table>
  26967. <thead>
  26968. <tr>
  26969. <th>Field</th>
  26970. <th>Description</th>
  26971. </tr>
  26972. </thead>
  26973. <tbody>
  26974. <tr>
  26975. <td>
  26976. <code>certSecretRef</code></br>
  26977. <em>
  26978. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26979. External Secrets meta/v1.SecretKeySelector
  26980. </a>
  26981. </em>
  26982. </td>
  26983. <td>
  26984. </td>
  26985. </tr>
  26986. </tbody>
  26987. </table>
  26988. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  26989. </h3>
  26990. <p>
  26991. (<em>Appears on:</em>
  26992. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26993. </p>
  26994. <p>
  26995. <p>YandexCertificateManagerProvider configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  26996. </p>
  26997. <table>
  26998. <thead>
  26999. <tr>
  27000. <th>Field</th>
  27001. <th>Description</th>
  27002. </tr>
  27003. </thead>
  27004. <tbody>
  27005. <tr>
  27006. <td>
  27007. <code>apiEndpoint</code></br>
  27008. <em>
  27009. string
  27010. </em>
  27011. </td>
  27012. <td>
  27013. <em>(Optional)</em>
  27014. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  27015. </td>
  27016. </tr>
  27017. <tr>
  27018. <td>
  27019. <code>auth</code></br>
  27020. <em>
  27021. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerAuth">
  27022. YandexCertificateManagerAuth
  27023. </a>
  27024. </em>
  27025. </td>
  27026. <td>
  27027. <p>Auth defines the information necessary to authenticate against Yandex Certificate Manager</p>
  27028. </td>
  27029. </tr>
  27030. <tr>
  27031. <td>
  27032. <code>caProvider</code></br>
  27033. <em>
  27034. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">
  27035. YandexCertificateManagerCAProvider
  27036. </a>
  27037. </em>
  27038. </td>
  27039. <td>
  27040. <em>(Optional)</em>
  27041. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  27042. </td>
  27043. </tr>
  27044. </tbody>
  27045. </table>
  27046. <h3 id="external-secrets.io/v1beta1.YandexLockboxAuth">YandexLockboxAuth
  27047. </h3>
  27048. <p>
  27049. (<em>Appears on:</em>
  27050. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  27051. </p>
  27052. <p>
  27053. <p>YandexLockboxAuth defines authentication configuration for the Yandex Lockbox provider.</p>
  27054. </p>
  27055. <table>
  27056. <thead>
  27057. <tr>
  27058. <th>Field</th>
  27059. <th>Description</th>
  27060. </tr>
  27061. </thead>
  27062. <tbody>
  27063. <tr>
  27064. <td>
  27065. <code>authorizedKeySecretRef</code></br>
  27066. <em>
  27067. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27068. External Secrets meta/v1.SecretKeySelector
  27069. </a>
  27070. </em>
  27071. </td>
  27072. <td>
  27073. <em>(Optional)</em>
  27074. <p>The authorized key used for authentication</p>
  27075. </td>
  27076. </tr>
  27077. </tbody>
  27078. </table>
  27079. <h3 id="external-secrets.io/v1beta1.YandexLockboxCAProvider">YandexLockboxCAProvider
  27080. </h3>
  27081. <p>
  27082. (<em>Appears on:</em>
  27083. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  27084. </p>
  27085. <p>
  27086. <p>YandexLockboxCAProvider defines CA certificate configuration for Yandex Lockbox.</p>
  27087. </p>
  27088. <table>
  27089. <thead>
  27090. <tr>
  27091. <th>Field</th>
  27092. <th>Description</th>
  27093. </tr>
  27094. </thead>
  27095. <tbody>
  27096. <tr>
  27097. <td>
  27098. <code>certSecretRef</code></br>
  27099. <em>
  27100. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27101. External Secrets meta/v1.SecretKeySelector
  27102. </a>
  27103. </em>
  27104. </td>
  27105. <td>
  27106. </td>
  27107. </tr>
  27108. </tbody>
  27109. </table>
  27110. <h3 id="external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider
  27111. </h3>
  27112. <p>
  27113. (<em>Appears on:</em>
  27114. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  27115. </p>
  27116. <p>
  27117. <p>YandexLockboxProvider configures a store to sync secrets using the Yandex Lockbox provider.</p>
  27118. </p>
  27119. <table>
  27120. <thead>
  27121. <tr>
  27122. <th>Field</th>
  27123. <th>Description</th>
  27124. </tr>
  27125. </thead>
  27126. <tbody>
  27127. <tr>
  27128. <td>
  27129. <code>apiEndpoint</code></br>
  27130. <em>
  27131. string
  27132. </em>
  27133. </td>
  27134. <td>
  27135. <em>(Optional)</em>
  27136. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  27137. </td>
  27138. </tr>
  27139. <tr>
  27140. <td>
  27141. <code>auth</code></br>
  27142. <em>
  27143. <a href="#external-secrets.io/v1beta1.YandexLockboxAuth">
  27144. YandexLockboxAuth
  27145. </a>
  27146. </em>
  27147. </td>
  27148. <td>
  27149. <p>Auth defines the information necessary to authenticate against Yandex Lockbox</p>
  27150. </td>
  27151. </tr>
  27152. <tr>
  27153. <td>
  27154. <code>caProvider</code></br>
  27155. <em>
  27156. <a href="#external-secrets.io/v1beta1.YandexLockboxCAProvider">
  27157. YandexLockboxCAProvider
  27158. </a>
  27159. </em>
  27160. </td>
  27161. <td>
  27162. <em>(Optional)</em>
  27163. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  27164. </td>
  27165. </tr>
  27166. </tbody>
  27167. </table>
  27168. <hr/>
  27169. <h2 id="generators.external-secrets.io/v1alpha1">generators.external-secrets.io/v1alpha1</h2>
  27170. <p>
  27171. <p>Package v1alpha1 contains resources for generators</p>
  27172. </p>
  27173. <p>Resource Types:</p>
  27174. <ul></ul>
  27175. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken
  27176. </h3>
  27177. <p>
  27178. <p>ACRAccessToken returns an Azure Container Registry token
  27179. that can be used for pushing/pulling images.
  27180. Note: by default it will return an ACR Refresh Token with full access
  27181. (depending on the identity).
  27182. This can be scoped down to the repository level using .spec.scope.
  27183. In case scope is defined it will return an ACR Access Token.</p>
  27184. <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>
  27185. </p>
  27186. <table>
  27187. <thead>
  27188. <tr>
  27189. <th>Field</th>
  27190. <th>Description</th>
  27191. </tr>
  27192. </thead>
  27193. <tbody>
  27194. <tr>
  27195. <td>
  27196. <code>metadata</code></br>
  27197. <em>
  27198. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27199. Kubernetes meta/v1.ObjectMeta
  27200. </a>
  27201. </em>
  27202. </td>
  27203. <td>
  27204. Refer to the Kubernetes API documentation for the fields of the
  27205. <code>metadata</code> field.
  27206. </td>
  27207. </tr>
  27208. <tr>
  27209. <td>
  27210. <code>spec</code></br>
  27211. <em>
  27212. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  27213. ACRAccessTokenSpec
  27214. </a>
  27215. </em>
  27216. </td>
  27217. <td>
  27218. <br/>
  27219. <br/>
  27220. <table>
  27221. <tr>
  27222. <td>
  27223. <code>auth</code></br>
  27224. <em>
  27225. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  27226. ACRAuth
  27227. </a>
  27228. </em>
  27229. </td>
  27230. <td>
  27231. </td>
  27232. </tr>
  27233. <tr>
  27234. <td>
  27235. <code>tenantId</code></br>
  27236. <em>
  27237. string
  27238. </em>
  27239. </td>
  27240. <td>
  27241. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  27242. </td>
  27243. </tr>
  27244. <tr>
  27245. <td>
  27246. <code>registry</code></br>
  27247. <em>
  27248. string
  27249. </em>
  27250. </td>
  27251. <td>
  27252. <p>the domain name of the ACR registry
  27253. e.g. foobarexample.azurecr.io</p>
  27254. </td>
  27255. </tr>
  27256. <tr>
  27257. <td>
  27258. <code>scope</code></br>
  27259. <em>
  27260. string
  27261. </em>
  27262. </td>
  27263. <td>
  27264. <em>(Optional)</em>
  27265. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  27266. if not provided it will return a refresh token that has full scope.
  27267. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  27268. <p>examples:
  27269. repository:my-repository:pull,push
  27270. repository:my-repository:pull</p>
  27271. <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>
  27272. </td>
  27273. </tr>
  27274. <tr>
  27275. <td>
  27276. <code>environmentType</code></br>
  27277. <em>
  27278. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  27279. AzureEnvironmentType
  27280. </a>
  27281. </em>
  27282. </td>
  27283. <td>
  27284. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  27285. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  27286. 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>
  27287. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  27288. </td>
  27289. </tr>
  27290. </table>
  27291. </td>
  27292. </tr>
  27293. </tbody>
  27294. </table>
  27295. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec
  27296. </h3>
  27297. <p>
  27298. (<em>Appears on:</em>
  27299. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken</a>,
  27300. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27301. </p>
  27302. <p>
  27303. <p>ACRAccessTokenSpec defines how to generate the access token
  27304. e.g. how to authenticate and which registry to use.
  27305. 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>
  27306. </p>
  27307. <table>
  27308. <thead>
  27309. <tr>
  27310. <th>Field</th>
  27311. <th>Description</th>
  27312. </tr>
  27313. </thead>
  27314. <tbody>
  27315. <tr>
  27316. <td>
  27317. <code>auth</code></br>
  27318. <em>
  27319. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  27320. ACRAuth
  27321. </a>
  27322. </em>
  27323. </td>
  27324. <td>
  27325. </td>
  27326. </tr>
  27327. <tr>
  27328. <td>
  27329. <code>tenantId</code></br>
  27330. <em>
  27331. string
  27332. </em>
  27333. </td>
  27334. <td>
  27335. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  27336. </td>
  27337. </tr>
  27338. <tr>
  27339. <td>
  27340. <code>registry</code></br>
  27341. <em>
  27342. string
  27343. </em>
  27344. </td>
  27345. <td>
  27346. <p>the domain name of the ACR registry
  27347. e.g. foobarexample.azurecr.io</p>
  27348. </td>
  27349. </tr>
  27350. <tr>
  27351. <td>
  27352. <code>scope</code></br>
  27353. <em>
  27354. string
  27355. </em>
  27356. </td>
  27357. <td>
  27358. <em>(Optional)</em>
  27359. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  27360. if not provided it will return a refresh token that has full scope.
  27361. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  27362. <p>examples:
  27363. repository:my-repository:pull,push
  27364. repository:my-repository:pull</p>
  27365. <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>
  27366. </td>
  27367. </tr>
  27368. <tr>
  27369. <td>
  27370. <code>environmentType</code></br>
  27371. <em>
  27372. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  27373. AzureEnvironmentType
  27374. </a>
  27375. </em>
  27376. </td>
  27377. <td>
  27378. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  27379. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  27380. 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>
  27381. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  27382. </td>
  27383. </tr>
  27384. </tbody>
  27385. </table>
  27386. <h3 id="generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth
  27387. </h3>
  27388. <p>
  27389. (<em>Appears on:</em>
  27390. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  27391. </p>
  27392. <p>
  27393. <p>ACRAuth defines the authentication methods for Azure Container Registry.</p>
  27394. </p>
  27395. <table>
  27396. <thead>
  27397. <tr>
  27398. <th>Field</th>
  27399. <th>Description</th>
  27400. </tr>
  27401. </thead>
  27402. <tbody>
  27403. <tr>
  27404. <td>
  27405. <code>servicePrincipal</code></br>
  27406. <em>
  27407. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">
  27408. AzureACRServicePrincipalAuth
  27409. </a>
  27410. </em>
  27411. </td>
  27412. <td>
  27413. <em>(Optional)</em>
  27414. <p>ServicePrincipal uses Azure Service Principal credentials to authenticate with Azure.</p>
  27415. </td>
  27416. </tr>
  27417. <tr>
  27418. <td>
  27419. <code>managedIdentity</code></br>
  27420. <em>
  27421. <a href="#generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">
  27422. AzureACRManagedIdentityAuth
  27423. </a>
  27424. </em>
  27425. </td>
  27426. <td>
  27427. <em>(Optional)</em>
  27428. <p>ManagedIdentity uses Azure Managed Identity to authenticate with Azure.</p>
  27429. </td>
  27430. </tr>
  27431. <tr>
  27432. <td>
  27433. <code>workloadIdentity</code></br>
  27434. <em>
  27435. <a href="#generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">
  27436. AzureACRWorkloadIdentityAuth
  27437. </a>
  27438. </em>
  27439. </td>
  27440. <td>
  27441. <em>(Optional)</em>
  27442. <p>WorkloadIdentity uses Azure Workload Identity to authenticate with Azure.</p>
  27443. </td>
  27444. </tr>
  27445. </tbody>
  27446. </table>
  27447. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth
  27448. </h3>
  27449. <p>
  27450. (<em>Appears on:</em>
  27451. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec</a>,
  27452. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  27453. </p>
  27454. <p>
  27455. <p>AWSAuth tells the controller how to do authentication with aws.
  27456. Only one of secretRef or jwt can be specified.
  27457. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  27458. </p>
  27459. <table>
  27460. <thead>
  27461. <tr>
  27462. <th>Field</th>
  27463. <th>Description</th>
  27464. </tr>
  27465. </thead>
  27466. <tbody>
  27467. <tr>
  27468. <td>
  27469. <code>secretRef</code></br>
  27470. <em>
  27471. <a href="#generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">
  27472. AWSAuthSecretRef
  27473. </a>
  27474. </em>
  27475. </td>
  27476. <td>
  27477. <em>(Optional)</em>
  27478. </td>
  27479. </tr>
  27480. <tr>
  27481. <td>
  27482. <code>jwt</code></br>
  27483. <em>
  27484. <a href="#generators.external-secrets.io/v1alpha1.AWSJWTAuth">
  27485. AWSJWTAuth
  27486. </a>
  27487. </em>
  27488. </td>
  27489. <td>
  27490. <em>(Optional)</em>
  27491. </td>
  27492. </tr>
  27493. </tbody>
  27494. </table>
  27495. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">AWSAuthSecretRef
  27496. </h3>
  27497. <p>
  27498. (<em>Appears on:</em>
  27499. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  27500. </p>
  27501. <p>
  27502. <p>AWSAuthSecretRef holds secret references for AWS credentials
  27503. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  27504. </p>
  27505. <table>
  27506. <thead>
  27507. <tr>
  27508. <th>Field</th>
  27509. <th>Description</th>
  27510. </tr>
  27511. </thead>
  27512. <tbody>
  27513. <tr>
  27514. <td>
  27515. <code>accessKeyIDSecretRef</code></br>
  27516. <em>
  27517. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27518. External Secrets meta/v1.SecretKeySelector
  27519. </a>
  27520. </em>
  27521. </td>
  27522. <td>
  27523. <p>The AccessKeyID is used for authentication</p>
  27524. </td>
  27525. </tr>
  27526. <tr>
  27527. <td>
  27528. <code>secretAccessKeySecretRef</code></br>
  27529. <em>
  27530. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27531. External Secrets meta/v1.SecretKeySelector
  27532. </a>
  27533. </em>
  27534. </td>
  27535. <td>
  27536. <p>The SecretAccessKey is used for authentication</p>
  27537. </td>
  27538. </tr>
  27539. <tr>
  27540. <td>
  27541. <code>sessionTokenSecretRef</code></br>
  27542. <em>
  27543. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27544. External Secrets meta/v1.SecretKeySelector
  27545. </a>
  27546. </em>
  27547. </td>
  27548. <td>
  27549. <p>The SessionToken used for authentication
  27550. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  27551. 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>
  27552. </td>
  27553. </tr>
  27554. </tbody>
  27555. </table>
  27556. <h3 id="generators.external-secrets.io/v1alpha1.AWSJWTAuth">AWSJWTAuth
  27557. </h3>
  27558. <p>
  27559. (<em>Appears on:</em>
  27560. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  27561. </p>
  27562. <p>
  27563. <p>AWSJWTAuth provides configuration to authenticate against AWS using service account tokens.</p>
  27564. </p>
  27565. <table>
  27566. <thead>
  27567. <tr>
  27568. <th>Field</th>
  27569. <th>Description</th>
  27570. </tr>
  27571. </thead>
  27572. <tbody>
  27573. <tr>
  27574. <td>
  27575. <code>serviceAccountRef</code></br>
  27576. <em>
  27577. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27578. External Secrets meta/v1.ServiceAccountSelector
  27579. </a>
  27580. </em>
  27581. </td>
  27582. <td>
  27583. </td>
  27584. </tr>
  27585. </tbody>
  27586. </table>
  27587. <h3 id="generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol
  27588. </h3>
  27589. <p>
  27590. (<em>Appears on:</em>
  27591. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  27592. </p>
  27593. <p>
  27594. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  27595. </p>
  27596. <table>
  27597. <thead>
  27598. <tr>
  27599. <th>Field</th>
  27600. <th>Description</th>
  27601. </tr>
  27602. </thead>
  27603. <tbody>
  27604. <tr>
  27605. <td>
  27606. <code>ntlm</code></br>
  27607. <em>
  27608. <a href="#generators.external-secrets.io/v1alpha1.NTLMProtocol">
  27609. NTLMProtocol
  27610. </a>
  27611. </em>
  27612. </td>
  27613. <td>
  27614. <em>(Optional)</em>
  27615. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  27616. </td>
  27617. </tr>
  27618. </tbody>
  27619. </table>
  27620. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">AzureACRManagedIdentityAuth
  27621. </h3>
  27622. <p>
  27623. (<em>Appears on:</em>
  27624. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27625. </p>
  27626. <p>
  27627. <p>AzureACRManagedIdentityAuth defines the configuration for using Azure Managed Identity authentication.</p>
  27628. </p>
  27629. <table>
  27630. <thead>
  27631. <tr>
  27632. <th>Field</th>
  27633. <th>Description</th>
  27634. </tr>
  27635. </thead>
  27636. <tbody>
  27637. <tr>
  27638. <td>
  27639. <code>identityId</code></br>
  27640. <em>
  27641. string
  27642. </em>
  27643. </td>
  27644. <td>
  27645. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  27646. </td>
  27647. </tr>
  27648. </tbody>
  27649. </table>
  27650. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth
  27651. </h3>
  27652. <p>
  27653. (<em>Appears on:</em>
  27654. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27655. </p>
  27656. <p>
  27657. <p>AzureACRServicePrincipalAuth defines the configuration for using Azure Service Principal authentication.</p>
  27658. </p>
  27659. <table>
  27660. <thead>
  27661. <tr>
  27662. <th>Field</th>
  27663. <th>Description</th>
  27664. </tr>
  27665. </thead>
  27666. <tbody>
  27667. <tr>
  27668. <td>
  27669. <code>secretRef</code></br>
  27670. <em>
  27671. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">
  27672. AzureACRServicePrincipalAuthSecretRef
  27673. </a>
  27674. </em>
  27675. </td>
  27676. <td>
  27677. </td>
  27678. </tr>
  27679. </tbody>
  27680. </table>
  27681. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">AzureACRServicePrincipalAuthSecretRef
  27682. </h3>
  27683. <p>
  27684. (<em>Appears on:</em>
  27685. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth</a>)
  27686. </p>
  27687. <p>
  27688. <p>AzureACRServicePrincipalAuthSecretRef defines the secret references for Azure Service Principal authentication.
  27689. It uses static credentials stored in a Kind=Secret.</p>
  27690. </p>
  27691. <table>
  27692. <thead>
  27693. <tr>
  27694. <th>Field</th>
  27695. <th>Description</th>
  27696. </tr>
  27697. </thead>
  27698. <tbody>
  27699. <tr>
  27700. <td>
  27701. <code>clientId</code></br>
  27702. <em>
  27703. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27704. External Secrets meta/v1.SecretKeySelector
  27705. </a>
  27706. </em>
  27707. </td>
  27708. <td>
  27709. <p>The Azure clientId of the service principle used for authentication.</p>
  27710. </td>
  27711. </tr>
  27712. <tr>
  27713. <td>
  27714. <code>clientSecret</code></br>
  27715. <em>
  27716. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27717. External Secrets meta/v1.SecretKeySelector
  27718. </a>
  27719. </em>
  27720. </td>
  27721. <td>
  27722. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  27723. </td>
  27724. </tr>
  27725. </tbody>
  27726. </table>
  27727. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">AzureACRWorkloadIdentityAuth
  27728. </h3>
  27729. <p>
  27730. (<em>Appears on:</em>
  27731. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27732. </p>
  27733. <p>
  27734. <p>AzureACRWorkloadIdentityAuth defines the configuration for using Azure Workload Identity authentication.</p>
  27735. </p>
  27736. <table>
  27737. <thead>
  27738. <tr>
  27739. <th>Field</th>
  27740. <th>Description</th>
  27741. </tr>
  27742. </thead>
  27743. <tbody>
  27744. <tr>
  27745. <td>
  27746. <code>serviceAccountRef</code></br>
  27747. <em>
  27748. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27749. External Secrets meta/v1.ServiceAccountSelector
  27750. </a>
  27751. </em>
  27752. </td>
  27753. <td>
  27754. <em>(Optional)</em>
  27755. <p>ServiceAccountRef specified the service account
  27756. that should be used when authenticating with WorkloadIdentity.</p>
  27757. </td>
  27758. </tr>
  27759. </tbody>
  27760. </table>
  27761. <h3 id="generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecret">BeyondtrustWorkloadCredentialsDynamicSecret
  27762. </h3>
  27763. <p>
  27764. <p>BeyondtrustWorkloadCredentialsDynamicSecret represents a generator that requests dynamic credentials from BeyondTrust Workload Credentials.
  27765. This generator calls the BeyondTrust Workload Credentials API to generate fresh, temporary credentials
  27766. (such as AWS STS credentials) each time an ExternalSecret is refreshed.
  27767. Dynamic secret definitions must be created in BeyondTrust Workload Credentials before they can be referenced.
  27768. 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>
  27769. </p>
  27770. <table>
  27771. <thead>
  27772. <tr>
  27773. <th>Field</th>
  27774. <th>Description</th>
  27775. </tr>
  27776. </thead>
  27777. <tbody>
  27778. <tr>
  27779. <td>
  27780. <code>metadata</code></br>
  27781. <em>
  27782. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27783. Kubernetes meta/v1.ObjectMeta
  27784. </a>
  27785. </em>
  27786. </td>
  27787. <td>
  27788. Refer to the Kubernetes API documentation for the fields of the
  27789. <code>metadata</code> field.
  27790. </td>
  27791. </tr>
  27792. <tr>
  27793. <td>
  27794. <code>spec</code></br>
  27795. <em>
  27796. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">
  27797. BeyondtrustWorkloadCredentialsDynamicSecretSpec
  27798. </a>
  27799. </em>
  27800. </td>
  27801. <td>
  27802. <br/>
  27803. <br/>
  27804. <table>
  27805. <tr>
  27806. <td>
  27807. <code>controller</code></br>
  27808. <em>
  27809. string
  27810. </em>
  27811. </td>
  27812. <td>
  27813. <em>(Optional)</em>
  27814. <p>Controller selects the controller that should handle this generator.
  27815. Leave empty to use the default controller.</p>
  27816. </td>
  27817. </tr>
  27818. <tr>
  27819. <td>
  27820. <code>provider</code></br>
  27821. <em>
  27822. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  27823. BeyondtrustWorkloadCredentialsProvider
  27824. </a>
  27825. </em>
  27826. </td>
  27827. <td>
  27828. <p>Provider contains the BeyondtrustWorkloadCredentials provider configuration including authentication,
  27829. server connection details, and the folder path to the dynamic secret definition.
  27830. The folderPath should point to a dynamic secret definition that has been created in
  27831. BeyondTrust Workload Credentials (e.g., &ldquo;production/aws-temp&rdquo;).
  27832. 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>
  27833. </td>
  27834. </tr>
  27835. <tr>
  27836. <td>
  27837. <code>retrySettings</code></br>
  27838. <em>
  27839. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  27840. SecretStoreRetrySettings
  27841. </a>
  27842. </em>
  27843. </td>
  27844. <td>
  27845. <em>(Optional)</em>
  27846. <p>RetrySettings configures exponential backoff for failed API requests.
  27847. If not specified, uses the default retry settings.</p>
  27848. </td>
  27849. </tr>
  27850. </table>
  27851. </td>
  27852. </tr>
  27853. </tbody>
  27854. </table>
  27855. <h3 id="generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec
  27856. </h3>
  27857. <p>
  27858. (<em>Appears on:</em>
  27859. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecret">BeyondtrustWorkloadCredentialsDynamicSecret</a>,
  27860. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27861. </p>
  27862. <p>
  27863. <p>BeyondtrustWorkloadCredentialsDynamicSecretSpec defines the desired spec for BeyondtrustWorkloadCredentials dynamic generator.
  27864. This generator enables obtaining temporary, short-lived credentials from BeyondTrust Workload Credentials.
  27865. 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>
  27866. </p>
  27867. <table>
  27868. <thead>
  27869. <tr>
  27870. <th>Field</th>
  27871. <th>Description</th>
  27872. </tr>
  27873. </thead>
  27874. <tbody>
  27875. <tr>
  27876. <td>
  27877. <code>controller</code></br>
  27878. <em>
  27879. string
  27880. </em>
  27881. </td>
  27882. <td>
  27883. <em>(Optional)</em>
  27884. <p>Controller selects the controller that should handle this generator.
  27885. Leave empty to use the default controller.</p>
  27886. </td>
  27887. </tr>
  27888. <tr>
  27889. <td>
  27890. <code>provider</code></br>
  27891. <em>
  27892. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  27893. BeyondtrustWorkloadCredentialsProvider
  27894. </a>
  27895. </em>
  27896. </td>
  27897. <td>
  27898. <p>Provider contains the BeyondtrustWorkloadCredentials provider configuration including authentication,
  27899. server connection details, and the folder path to the dynamic secret definition.
  27900. The folderPath should point to a dynamic secret definition that has been created in
  27901. BeyondTrust Workload Credentials (e.g., &ldquo;production/aws-temp&rdquo;).
  27902. 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>
  27903. </td>
  27904. </tr>
  27905. <tr>
  27906. <td>
  27907. <code>retrySettings</code></br>
  27908. <em>
  27909. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  27910. SecretStoreRetrySettings
  27911. </a>
  27912. </em>
  27913. </td>
  27914. <td>
  27915. <em>(Optional)</em>
  27916. <p>RetrySettings configures exponential backoff for failed API requests.
  27917. If not specified, uses the default retry settings.</p>
  27918. </td>
  27919. </tr>
  27920. </tbody>
  27921. </table>
  27922. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken
  27923. </h3>
  27924. <p>
  27925. <p>CloudsmithAccessToken generates Cloudsmith access token using OIDC authentication</p>
  27926. </p>
  27927. <table>
  27928. <thead>
  27929. <tr>
  27930. <th>Field</th>
  27931. <th>Description</th>
  27932. </tr>
  27933. </thead>
  27934. <tbody>
  27935. <tr>
  27936. <td>
  27937. <code>metadata</code></br>
  27938. <em>
  27939. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27940. Kubernetes meta/v1.ObjectMeta
  27941. </a>
  27942. </em>
  27943. </td>
  27944. <td>
  27945. Refer to the Kubernetes API documentation for the fields of the
  27946. <code>metadata</code> field.
  27947. </td>
  27948. </tr>
  27949. <tr>
  27950. <td>
  27951. <code>spec</code></br>
  27952. <em>
  27953. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  27954. CloudsmithAccessTokenSpec
  27955. </a>
  27956. </em>
  27957. </td>
  27958. <td>
  27959. <br/>
  27960. <br/>
  27961. <table>
  27962. <tr>
  27963. <td>
  27964. <code>apiUrl</code></br>
  27965. <em>
  27966. string
  27967. </em>
  27968. </td>
  27969. <td>
  27970. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  27971. </td>
  27972. </tr>
  27973. <tr>
  27974. <td>
  27975. <code>orgSlug</code></br>
  27976. <em>
  27977. string
  27978. </em>
  27979. </td>
  27980. <td>
  27981. <p>OrgSlug is the organization slug in Cloudsmith</p>
  27982. </td>
  27983. </tr>
  27984. <tr>
  27985. <td>
  27986. <code>serviceSlug</code></br>
  27987. <em>
  27988. string
  27989. </em>
  27990. </td>
  27991. <td>
  27992. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  27993. </td>
  27994. </tr>
  27995. <tr>
  27996. <td>
  27997. <code>serviceAccountRef</code></br>
  27998. <em>
  27999. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28000. External Secrets meta/v1.ServiceAccountSelector
  28001. </a>
  28002. </em>
  28003. </td>
  28004. <td>
  28005. <p>Name of the service account you are federating with</p>
  28006. </td>
  28007. </tr>
  28008. </table>
  28009. </td>
  28010. </tr>
  28011. </tbody>
  28012. </table>
  28013. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">CloudsmithAccessTokenSpec
  28014. </h3>
  28015. <p>
  28016. (<em>Appears on:</em>
  28017. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken</a>,
  28018. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28019. </p>
  28020. <p>
  28021. <p>CloudsmithAccessTokenSpec defines the configuration for generating a Cloudsmith access token using OIDC authentication.</p>
  28022. </p>
  28023. <table>
  28024. <thead>
  28025. <tr>
  28026. <th>Field</th>
  28027. <th>Description</th>
  28028. </tr>
  28029. </thead>
  28030. <tbody>
  28031. <tr>
  28032. <td>
  28033. <code>apiUrl</code></br>
  28034. <em>
  28035. string
  28036. </em>
  28037. </td>
  28038. <td>
  28039. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  28040. </td>
  28041. </tr>
  28042. <tr>
  28043. <td>
  28044. <code>orgSlug</code></br>
  28045. <em>
  28046. string
  28047. </em>
  28048. </td>
  28049. <td>
  28050. <p>OrgSlug is the organization slug in Cloudsmith</p>
  28051. </td>
  28052. </tr>
  28053. <tr>
  28054. <td>
  28055. <code>serviceSlug</code></br>
  28056. <em>
  28057. string
  28058. </em>
  28059. </td>
  28060. <td>
  28061. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  28062. </td>
  28063. </tr>
  28064. <tr>
  28065. <td>
  28066. <code>serviceAccountRef</code></br>
  28067. <em>
  28068. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28069. External Secrets meta/v1.ServiceAccountSelector
  28070. </a>
  28071. </em>
  28072. </td>
  28073. <td>
  28074. <p>Name of the service account you are federating with</p>
  28075. </td>
  28076. </tr>
  28077. </tbody>
  28078. </table>
  28079. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator
  28080. </h3>
  28081. <p>
  28082. <p>ClusterGenerator represents a cluster-wide generator which can be referenced as part of <code>generatorRef</code> fields.</p>
  28083. </p>
  28084. <table>
  28085. <thead>
  28086. <tr>
  28087. <th>Field</th>
  28088. <th>Description</th>
  28089. </tr>
  28090. </thead>
  28091. <tbody>
  28092. <tr>
  28093. <td>
  28094. <code>metadata</code></br>
  28095. <em>
  28096. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28097. Kubernetes meta/v1.ObjectMeta
  28098. </a>
  28099. </em>
  28100. </td>
  28101. <td>
  28102. Refer to the Kubernetes API documentation for the fields of the
  28103. <code>metadata</code> field.
  28104. </td>
  28105. </tr>
  28106. <tr>
  28107. <td>
  28108. <code>spec</code></br>
  28109. <em>
  28110. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">
  28111. ClusterGeneratorSpec
  28112. </a>
  28113. </em>
  28114. </td>
  28115. <td>
  28116. <br/>
  28117. <br/>
  28118. <table>
  28119. <tr>
  28120. <td>
  28121. <code>kind</code></br>
  28122. <em>
  28123. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  28124. GeneratorKind
  28125. </a>
  28126. </em>
  28127. </td>
  28128. <td>
  28129. <p>Kind the kind of this generator.</p>
  28130. </td>
  28131. </tr>
  28132. <tr>
  28133. <td>
  28134. <code>generator</code></br>
  28135. <em>
  28136. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  28137. GeneratorSpec
  28138. </a>
  28139. </em>
  28140. </td>
  28141. <td>
  28142. <p>Generator the spec for this generator, must match the kind.</p>
  28143. </td>
  28144. </tr>
  28145. </table>
  28146. </td>
  28147. </tr>
  28148. </tbody>
  28149. </table>
  28150. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec
  28151. </h3>
  28152. <p>
  28153. (<em>Appears on:</em>
  28154. <a href="#generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator</a>)
  28155. </p>
  28156. <p>
  28157. <p>ClusterGeneratorSpec defines the desired state of a ClusterGenerator.</p>
  28158. </p>
  28159. <table>
  28160. <thead>
  28161. <tr>
  28162. <th>Field</th>
  28163. <th>Description</th>
  28164. </tr>
  28165. </thead>
  28166. <tbody>
  28167. <tr>
  28168. <td>
  28169. <code>kind</code></br>
  28170. <em>
  28171. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  28172. GeneratorKind
  28173. </a>
  28174. </em>
  28175. </td>
  28176. <td>
  28177. <p>Kind the kind of this generator.</p>
  28178. </td>
  28179. </tr>
  28180. <tr>
  28181. <td>
  28182. <code>generator</code></br>
  28183. <em>
  28184. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  28185. GeneratorSpec
  28186. </a>
  28187. </em>
  28188. </td>
  28189. <td>
  28190. <p>Generator the spec for this generator, must match the kind.</p>
  28191. </td>
  28192. </tr>
  28193. </tbody>
  28194. </table>
  28195. <h3 id="generators.external-secrets.io/v1alpha1.ControllerClassResource">ControllerClassResource
  28196. </h3>
  28197. <p>
  28198. <p>ControllerClassResource defines a resource that can be assigned to a specific controller class.</p>
  28199. </p>
  28200. <table>
  28201. <thead>
  28202. <tr>
  28203. <th>Field</th>
  28204. <th>Description</th>
  28205. </tr>
  28206. </thead>
  28207. <tbody>
  28208. <tr>
  28209. <td>
  28210. <code>spec</code></br>
  28211. <em>
  28212. struct{ControllerClass string &#34;json:\&#34;controller\&#34;&#34;}
  28213. </em>
  28214. </td>
  28215. <td>
  28216. <br/>
  28217. <br/>
  28218. <table>
  28219. <tr>
  28220. <td>
  28221. <code>controller</code></br>
  28222. <em>
  28223. string
  28224. </em>
  28225. </td>
  28226. <td>
  28227. </td>
  28228. </tr>
  28229. </table>
  28230. </td>
  28231. </tr>
  28232. </tbody>
  28233. </table>
  28234. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken
  28235. </h3>
  28236. <p>
  28237. <p>ECRAuthorizationToken uses the GetAuthorizationToken API to retrieve an authorization token.
  28238. The authorization token is valid for 12 hours.
  28239. The authorizationToken returned is a base64 encoded string that can be decoded
  28240. and used in a docker login command to authenticate to a registry.
  28241. 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>
  28242. </p>
  28243. <table>
  28244. <thead>
  28245. <tr>
  28246. <th>Field</th>
  28247. <th>Description</th>
  28248. </tr>
  28249. </thead>
  28250. <tbody>
  28251. <tr>
  28252. <td>
  28253. <code>metadata</code></br>
  28254. <em>
  28255. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28256. Kubernetes meta/v1.ObjectMeta
  28257. </a>
  28258. </em>
  28259. </td>
  28260. <td>
  28261. Refer to the Kubernetes API documentation for the fields of the
  28262. <code>metadata</code> field.
  28263. </td>
  28264. </tr>
  28265. <tr>
  28266. <td>
  28267. <code>spec</code></br>
  28268. <em>
  28269. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  28270. ECRAuthorizationTokenSpec
  28271. </a>
  28272. </em>
  28273. </td>
  28274. <td>
  28275. <br/>
  28276. <br/>
  28277. <table>
  28278. <tr>
  28279. <td>
  28280. <code>region</code></br>
  28281. <em>
  28282. string
  28283. </em>
  28284. </td>
  28285. <td>
  28286. <p>Region specifies the region to operate in.</p>
  28287. </td>
  28288. </tr>
  28289. <tr>
  28290. <td>
  28291. <code>auth</code></br>
  28292. <em>
  28293. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28294. AWSAuth
  28295. </a>
  28296. </em>
  28297. </td>
  28298. <td>
  28299. <em>(Optional)</em>
  28300. <p>Auth defines how to authenticate with AWS</p>
  28301. </td>
  28302. </tr>
  28303. <tr>
  28304. <td>
  28305. <code>role</code></br>
  28306. <em>
  28307. string
  28308. </em>
  28309. </td>
  28310. <td>
  28311. <em>(Optional)</em>
  28312. <p>You can assume a role before making calls to the
  28313. desired AWS service.</p>
  28314. </td>
  28315. </tr>
  28316. <tr>
  28317. <td>
  28318. <code>scope</code></br>
  28319. <em>
  28320. string
  28321. </em>
  28322. </td>
  28323. <td>
  28324. <em>(Optional)</em>
  28325. <p>Scope specifies the ECR service scope.
  28326. Valid options are private and public.</p>
  28327. </td>
  28328. </tr>
  28329. </table>
  28330. </td>
  28331. </tr>
  28332. </tbody>
  28333. </table>
  28334. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec
  28335. </h3>
  28336. <p>
  28337. (<em>Appears on:</em>
  28338. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken</a>,
  28339. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28340. </p>
  28341. <p>
  28342. <p>ECRAuthorizationTokenSpec defines the desired state to generate an AWS ECR authorization token.</p>
  28343. </p>
  28344. <table>
  28345. <thead>
  28346. <tr>
  28347. <th>Field</th>
  28348. <th>Description</th>
  28349. </tr>
  28350. </thead>
  28351. <tbody>
  28352. <tr>
  28353. <td>
  28354. <code>region</code></br>
  28355. <em>
  28356. string
  28357. </em>
  28358. </td>
  28359. <td>
  28360. <p>Region specifies the region to operate in.</p>
  28361. </td>
  28362. </tr>
  28363. <tr>
  28364. <td>
  28365. <code>auth</code></br>
  28366. <em>
  28367. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28368. AWSAuth
  28369. </a>
  28370. </em>
  28371. </td>
  28372. <td>
  28373. <em>(Optional)</em>
  28374. <p>Auth defines how to authenticate with AWS</p>
  28375. </td>
  28376. </tr>
  28377. <tr>
  28378. <td>
  28379. <code>role</code></br>
  28380. <em>
  28381. string
  28382. </em>
  28383. </td>
  28384. <td>
  28385. <em>(Optional)</em>
  28386. <p>You can assume a role before making calls to the
  28387. desired AWS service.</p>
  28388. </td>
  28389. </tr>
  28390. <tr>
  28391. <td>
  28392. <code>scope</code></br>
  28393. <em>
  28394. string
  28395. </em>
  28396. </td>
  28397. <td>
  28398. <em>(Optional)</em>
  28399. <p>Scope specifies the ECR service scope.
  28400. Valid options are private and public.</p>
  28401. </td>
  28402. </tr>
  28403. </tbody>
  28404. </table>
  28405. <h3 id="generators.external-secrets.io/v1alpha1.Fake">Fake
  28406. </h3>
  28407. <p>
  28408. <p>Fake generator is used for testing. It lets you define
  28409. a static set of credentials that is always returned.</p>
  28410. </p>
  28411. <table>
  28412. <thead>
  28413. <tr>
  28414. <th>Field</th>
  28415. <th>Description</th>
  28416. </tr>
  28417. </thead>
  28418. <tbody>
  28419. <tr>
  28420. <td>
  28421. <code>metadata</code></br>
  28422. <em>
  28423. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28424. Kubernetes meta/v1.ObjectMeta
  28425. </a>
  28426. </em>
  28427. </td>
  28428. <td>
  28429. Refer to the Kubernetes API documentation for the fields of the
  28430. <code>metadata</code> field.
  28431. </td>
  28432. </tr>
  28433. <tr>
  28434. <td>
  28435. <code>spec</code></br>
  28436. <em>
  28437. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  28438. FakeSpec
  28439. </a>
  28440. </em>
  28441. </td>
  28442. <td>
  28443. <br/>
  28444. <br/>
  28445. <table>
  28446. <tr>
  28447. <td>
  28448. <code>controller</code></br>
  28449. <em>
  28450. string
  28451. </em>
  28452. </td>
  28453. <td>
  28454. <em>(Optional)</em>
  28455. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  28456. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  28457. </td>
  28458. </tr>
  28459. <tr>
  28460. <td>
  28461. <code>data</code></br>
  28462. <em>
  28463. map[string]string
  28464. </em>
  28465. </td>
  28466. <td>
  28467. <p>Data defines the static data returned
  28468. by this generator.</p>
  28469. </td>
  28470. </tr>
  28471. </table>
  28472. </td>
  28473. </tr>
  28474. </tbody>
  28475. </table>
  28476. <h3 id="generators.external-secrets.io/v1alpha1.FakeSpec">FakeSpec
  28477. </h3>
  28478. <p>
  28479. (<em>Appears on:</em>
  28480. <a href="#generators.external-secrets.io/v1alpha1.Fake">Fake</a>,
  28481. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28482. </p>
  28483. <p>
  28484. <p>FakeSpec contains the static data.</p>
  28485. </p>
  28486. <table>
  28487. <thead>
  28488. <tr>
  28489. <th>Field</th>
  28490. <th>Description</th>
  28491. </tr>
  28492. </thead>
  28493. <tbody>
  28494. <tr>
  28495. <td>
  28496. <code>controller</code></br>
  28497. <em>
  28498. string
  28499. </em>
  28500. </td>
  28501. <td>
  28502. <em>(Optional)</em>
  28503. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  28504. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  28505. </td>
  28506. </tr>
  28507. <tr>
  28508. <td>
  28509. <code>data</code></br>
  28510. <em>
  28511. map[string]string
  28512. </em>
  28513. </td>
  28514. <td>
  28515. <p>Data defines the static data returned
  28516. by this generator.</p>
  28517. </td>
  28518. </tr>
  28519. </tbody>
  28520. </table>
  28521. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth
  28522. </h3>
  28523. <p>
  28524. (<em>Appears on:</em>
  28525. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec</a>)
  28526. </p>
  28527. <p>
  28528. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform.</p>
  28529. </p>
  28530. <table>
  28531. <thead>
  28532. <tr>
  28533. <th>Field</th>
  28534. <th>Description</th>
  28535. </tr>
  28536. </thead>
  28537. <tbody>
  28538. <tr>
  28539. <td>
  28540. <code>secretRef</code></br>
  28541. <em>
  28542. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">
  28543. GCPSMAuthSecretRef
  28544. </a>
  28545. </em>
  28546. </td>
  28547. <td>
  28548. <em>(Optional)</em>
  28549. </td>
  28550. </tr>
  28551. <tr>
  28552. <td>
  28553. <code>workloadIdentity</code></br>
  28554. <em>
  28555. <a href="#generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">
  28556. GCPWorkloadIdentity
  28557. </a>
  28558. </em>
  28559. </td>
  28560. <td>
  28561. <em>(Optional)</em>
  28562. </td>
  28563. </tr>
  28564. <tr>
  28565. <td>
  28566. <code>workloadIdentityFederation</code></br>
  28567. <em>
  28568. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  28569. GCPWorkloadIdentityFederation
  28570. </a>
  28571. </em>
  28572. </td>
  28573. <td>
  28574. <em>(Optional)</em>
  28575. </td>
  28576. </tr>
  28577. </tbody>
  28578. </table>
  28579. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  28580. </h3>
  28581. <p>
  28582. (<em>Appears on:</em>
  28583. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  28584. </p>
  28585. <p>
  28586. <p>GCPSMAuthSecretRef defines the reference to a secret containing Google Cloud Platform credentials.</p>
  28587. </p>
  28588. <table>
  28589. <thead>
  28590. <tr>
  28591. <th>Field</th>
  28592. <th>Description</th>
  28593. </tr>
  28594. </thead>
  28595. <tbody>
  28596. <tr>
  28597. <td>
  28598. <code>secretAccessKeySecretRef</code></br>
  28599. <em>
  28600. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28601. External Secrets meta/v1.SecretKeySelector
  28602. </a>
  28603. </em>
  28604. </td>
  28605. <td>
  28606. <em>(Optional)</em>
  28607. <p>The SecretAccessKey is used for authentication</p>
  28608. </td>
  28609. </tr>
  28610. </tbody>
  28611. </table>
  28612. <h3 id="generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">GCPWorkloadIdentity
  28613. </h3>
  28614. <p>
  28615. (<em>Appears on:</em>
  28616. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  28617. </p>
  28618. <p>
  28619. <p>GCPWorkloadIdentity defines the configuration for using GCP Workload Identity authentication.</p>
  28620. </p>
  28621. <table>
  28622. <thead>
  28623. <tr>
  28624. <th>Field</th>
  28625. <th>Description</th>
  28626. </tr>
  28627. </thead>
  28628. <tbody>
  28629. <tr>
  28630. <td>
  28631. <code>serviceAccountRef</code></br>
  28632. <em>
  28633. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28634. External Secrets meta/v1.ServiceAccountSelector
  28635. </a>
  28636. </em>
  28637. </td>
  28638. <td>
  28639. </td>
  28640. </tr>
  28641. <tr>
  28642. <td>
  28643. <code>clusterLocation</code></br>
  28644. <em>
  28645. string
  28646. </em>
  28647. </td>
  28648. <td>
  28649. </td>
  28650. </tr>
  28651. <tr>
  28652. <td>
  28653. <code>clusterName</code></br>
  28654. <em>
  28655. string
  28656. </em>
  28657. </td>
  28658. <td>
  28659. </td>
  28660. </tr>
  28661. <tr>
  28662. <td>
  28663. <code>clusterProjectID</code></br>
  28664. <em>
  28665. string
  28666. </em>
  28667. </td>
  28668. <td>
  28669. </td>
  28670. </tr>
  28671. </tbody>
  28672. </table>
  28673. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken
  28674. </h3>
  28675. <p>
  28676. <p>GCRAccessToken generates an GCP access token
  28677. that can be used to authenticate with GCR.</p>
  28678. </p>
  28679. <table>
  28680. <thead>
  28681. <tr>
  28682. <th>Field</th>
  28683. <th>Description</th>
  28684. </tr>
  28685. </thead>
  28686. <tbody>
  28687. <tr>
  28688. <td>
  28689. <code>metadata</code></br>
  28690. <em>
  28691. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28692. Kubernetes meta/v1.ObjectMeta
  28693. </a>
  28694. </em>
  28695. </td>
  28696. <td>
  28697. Refer to the Kubernetes API documentation for the fields of the
  28698. <code>metadata</code> field.
  28699. </td>
  28700. </tr>
  28701. <tr>
  28702. <td>
  28703. <code>spec</code></br>
  28704. <em>
  28705. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  28706. GCRAccessTokenSpec
  28707. </a>
  28708. </em>
  28709. </td>
  28710. <td>
  28711. <br/>
  28712. <br/>
  28713. <table>
  28714. <tr>
  28715. <td>
  28716. <code>auth</code></br>
  28717. <em>
  28718. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  28719. GCPSMAuth
  28720. </a>
  28721. </em>
  28722. </td>
  28723. <td>
  28724. <p>Auth defines the means for authenticating with GCP</p>
  28725. </td>
  28726. </tr>
  28727. <tr>
  28728. <td>
  28729. <code>projectID</code></br>
  28730. <em>
  28731. string
  28732. </em>
  28733. </td>
  28734. <td>
  28735. <p>ProjectID defines which project to use to authenticate with</p>
  28736. </td>
  28737. </tr>
  28738. </table>
  28739. </td>
  28740. </tr>
  28741. </tbody>
  28742. </table>
  28743. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec
  28744. </h3>
  28745. <p>
  28746. (<em>Appears on:</em>
  28747. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken</a>,
  28748. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28749. </p>
  28750. <p>
  28751. <p>GCRAccessTokenSpec defines the desired state to generate a Google Container Registry access token.</p>
  28752. </p>
  28753. <table>
  28754. <thead>
  28755. <tr>
  28756. <th>Field</th>
  28757. <th>Description</th>
  28758. </tr>
  28759. </thead>
  28760. <tbody>
  28761. <tr>
  28762. <td>
  28763. <code>auth</code></br>
  28764. <em>
  28765. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  28766. GCPSMAuth
  28767. </a>
  28768. </em>
  28769. </td>
  28770. <td>
  28771. <p>Auth defines the means for authenticating with GCP</p>
  28772. </td>
  28773. </tr>
  28774. <tr>
  28775. <td>
  28776. <code>projectID</code></br>
  28777. <em>
  28778. string
  28779. </em>
  28780. </td>
  28781. <td>
  28782. <p>ProjectID defines which project to use to authenticate with</p>
  28783. </td>
  28784. </tr>
  28785. </tbody>
  28786. </table>
  28787. <h3 id="generators.external-secrets.io/v1alpha1.Generator">Generator
  28788. </h3>
  28789. <p>
  28790. <p>Generator is the common interface for all generators that is actually used to generate whatever is needed.</p>
  28791. </p>
  28792. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorKind">GeneratorKind
  28793. (<code>string</code> alias)</p></h3>
  28794. <p>
  28795. (<em>Appears on:</em>
  28796. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  28797. </p>
  28798. <p>
  28799. <p>GeneratorKind represents a kind of generator.</p>
  28800. </p>
  28801. <table>
  28802. <thead>
  28803. <tr>
  28804. <th>Value</th>
  28805. <th>Description</th>
  28806. </tr>
  28807. </thead>
  28808. <tbody><tr><td><p>&#34;ACRAccessToken&#34;</p></td>
  28809. <td><p>GeneratorKindACRAccessToken represents an Azure Container Registry access token generator.</p>
  28810. </td>
  28811. </tr><tr><td><p>&#34;BeyondtrustWorkloadCredentialsDynamicSecret&#34;</p></td>
  28812. <td><p>GeneratorKindBeyondtrustWorkloadCredentialsDynamicSecret represents a BeyondTrust Workload Credentials dynamic secret generator.</p>
  28813. </td>
  28814. </tr><tr><td><p>&#34;CloudsmithAccessToken&#34;</p></td>
  28815. <td><p>GeneratorKindCloudsmithAccessToken represents a Cloudsmith access token generator.</p>
  28816. </td>
  28817. </tr><tr><td><p>&#34;ECRAuthorizationToken&#34;</p></td>
  28818. <td><p>GeneratorKindECRAuthorizationToken represents an AWS ECR authorization token generator.</p>
  28819. </td>
  28820. </tr><tr><td><p>&#34;Fake&#34;</p></td>
  28821. <td><p>GeneratorKindFake represents a fake generator for testing purposes.</p>
  28822. </td>
  28823. </tr><tr><td><p>&#34;GCRAccessToken&#34;</p></td>
  28824. <td><p>GeneratorKindGCRAccessToken represents a Google Container Registry access token generator.</p>
  28825. </td>
  28826. </tr><tr><td><p>&#34;GithubAccessToken&#34;</p></td>
  28827. <td><p>GeneratorKindGithubAccessToken represents a GitHub access token generator.</p>
  28828. </td>
  28829. </tr><tr><td><p>&#34;GitlabDeployToken&#34;</p></td>
  28830. <td><p>GeneratorKindGitlabDeployToken represents a GitLab deploy token generator.</p>
  28831. </td>
  28832. </tr><tr><td><p>&#34;Grafana&#34;</p></td>
  28833. <td><p>GeneratorKindGrafana represents a Grafana token generator.</p>
  28834. </td>
  28835. </tr><tr><td><p>&#34;MFA&#34;</p></td>
  28836. <td><p>GeneratorKindMFA represents a Multi-Factor Authentication generator.</p>
  28837. </td>
  28838. </tr><tr><td><p>&#34;Password&#34;</p></td>
  28839. <td><p>GeneratorKindPassword represents a password generator.</p>
  28840. </td>
  28841. </tr><tr><td><p>&#34;QuayAccessToken&#34;</p></td>
  28842. <td><p>GeneratorKindQuayAccessToken represents a Quay access token generator.</p>
  28843. </td>
  28844. </tr><tr><td><p>&#34;SSHKey&#34;</p></td>
  28845. <td><p>GeneratorKindSSHKey represents an SSH key generator.</p>
  28846. </td>
  28847. </tr><tr><td><p>&#34;STSSessionToken&#34;</p></td>
  28848. <td><p>GeneratorKindSTSSessionToken represents an AWS STS session token generator.</p>
  28849. </td>
  28850. </tr><tr><td><p>&#34;UUID&#34;</p></td>
  28851. <td><p>GeneratorKindUUID represents a UUID generator.</p>
  28852. </td>
  28853. </tr><tr><td><p>&#34;VaultDynamicSecret&#34;</p></td>
  28854. <td><p>GeneratorKindVaultDynamicSecret represents a HashiCorp Vault dynamic secret generator.</p>
  28855. </td>
  28856. </tr><tr><td><p>&#34;Webhook&#34;</p></td>
  28857. <td><p>GeneratorKindWebhook represents a webhook-based generator.</p>
  28858. </td>
  28859. </tr></tbody>
  28860. </table>
  28861. <h3 id="&lt;UNKNOWN_API_GROUP&gt;.GeneratorProviderState">GeneratorProviderState
  28862. </h3>
  28863. <p>
  28864. <p>GeneratorProviderState represents the state of a generator provider that can be stored and retrieved.</p>
  28865. </p>
  28866. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec
  28867. </h3>
  28868. <p>
  28869. (<em>Appears on:</em>
  28870. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  28871. </p>
  28872. <p>
  28873. <p>GeneratorSpec defines the configuration for various supported generator types.</p>
  28874. </p>
  28875. <table>
  28876. <thead>
  28877. <tr>
  28878. <th>Field</th>
  28879. <th>Description</th>
  28880. </tr>
  28881. </thead>
  28882. <tbody>
  28883. <tr>
  28884. <td>
  28885. <code>acrAccessTokenSpec</code></br>
  28886. <em>
  28887. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  28888. ACRAccessTokenSpec
  28889. </a>
  28890. </em>
  28891. </td>
  28892. <td>
  28893. </td>
  28894. </tr>
  28895. <tr>
  28896. <td>
  28897. <code>beyondtrustWorkloadCredentialsDynamicSecretSpec</code></br>
  28898. <em>
  28899. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">
  28900. BeyondtrustWorkloadCredentialsDynamicSecretSpec
  28901. </a>
  28902. </em>
  28903. </td>
  28904. <td>
  28905. </td>
  28906. </tr>
  28907. <tr>
  28908. <td>
  28909. <code>cloudsmithAccessTokenSpec</code></br>
  28910. <em>
  28911. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  28912. CloudsmithAccessTokenSpec
  28913. </a>
  28914. </em>
  28915. </td>
  28916. <td>
  28917. </td>
  28918. </tr>
  28919. <tr>
  28920. <td>
  28921. <code>ecrAuthorizationTokenSpec</code></br>
  28922. <em>
  28923. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  28924. ECRAuthorizationTokenSpec
  28925. </a>
  28926. </em>
  28927. </td>
  28928. <td>
  28929. </td>
  28930. </tr>
  28931. <tr>
  28932. <td>
  28933. <code>fakeSpec</code></br>
  28934. <em>
  28935. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  28936. FakeSpec
  28937. </a>
  28938. </em>
  28939. </td>
  28940. <td>
  28941. </td>
  28942. </tr>
  28943. <tr>
  28944. <td>
  28945. <code>gcrAccessTokenSpec</code></br>
  28946. <em>
  28947. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  28948. GCRAccessTokenSpec
  28949. </a>
  28950. </em>
  28951. </td>
  28952. <td>
  28953. </td>
  28954. </tr>
  28955. <tr>
  28956. <td>
  28957. <code>githubAccessTokenSpec</code></br>
  28958. <em>
  28959. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  28960. GithubAccessTokenSpec
  28961. </a>
  28962. </em>
  28963. </td>
  28964. <td>
  28965. </td>
  28966. </tr>
  28967. <tr>
  28968. <td>
  28969. <code>gitlabDeployTokenSpec</code></br>
  28970. <em>
  28971. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">
  28972. GitlabDeployTokenSpec
  28973. </a>
  28974. </em>
  28975. </td>
  28976. <td>
  28977. </td>
  28978. </tr>
  28979. <tr>
  28980. <td>
  28981. <code>quayAccessTokenSpec</code></br>
  28982. <em>
  28983. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  28984. QuayAccessTokenSpec
  28985. </a>
  28986. </em>
  28987. </td>
  28988. <td>
  28989. </td>
  28990. </tr>
  28991. <tr>
  28992. <td>
  28993. <code>passwordSpec</code></br>
  28994. <em>
  28995. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  28996. PasswordSpec
  28997. </a>
  28998. </em>
  28999. </td>
  29000. <td>
  29001. </td>
  29002. </tr>
  29003. <tr>
  29004. <td>
  29005. <code>sshKeySpec</code></br>
  29006. <em>
  29007. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  29008. SSHKeySpec
  29009. </a>
  29010. </em>
  29011. </td>
  29012. <td>
  29013. </td>
  29014. </tr>
  29015. <tr>
  29016. <td>
  29017. <code>stsSessionTokenSpec</code></br>
  29018. <em>
  29019. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  29020. STSSessionTokenSpec
  29021. </a>
  29022. </em>
  29023. </td>
  29024. <td>
  29025. </td>
  29026. </tr>
  29027. <tr>
  29028. <td>
  29029. <code>uuidSpec</code></br>
  29030. <em>
  29031. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  29032. UUIDSpec
  29033. </a>
  29034. </em>
  29035. </td>
  29036. <td>
  29037. </td>
  29038. </tr>
  29039. <tr>
  29040. <td>
  29041. <code>vaultDynamicSecretSpec</code></br>
  29042. <em>
  29043. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  29044. VaultDynamicSecretSpec
  29045. </a>
  29046. </em>
  29047. </td>
  29048. <td>
  29049. </td>
  29050. </tr>
  29051. <tr>
  29052. <td>
  29053. <code>webhookSpec</code></br>
  29054. <em>
  29055. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  29056. WebhookSpec
  29057. </a>
  29058. </em>
  29059. </td>
  29060. <td>
  29061. </td>
  29062. </tr>
  29063. <tr>
  29064. <td>
  29065. <code>grafanaSpec</code></br>
  29066. <em>
  29067. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  29068. GrafanaSpec
  29069. </a>
  29070. </em>
  29071. </td>
  29072. <td>
  29073. </td>
  29074. </tr>
  29075. <tr>
  29076. <td>
  29077. <code>mfaSpec</code></br>
  29078. <em>
  29079. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  29080. MFASpec
  29081. </a>
  29082. </em>
  29083. </td>
  29084. <td>
  29085. </td>
  29086. </tr>
  29087. </tbody>
  29088. </table>
  29089. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState
  29090. </h3>
  29091. <p>
  29092. <p>GeneratorState represents the state created and managed by a generator resource.</p>
  29093. </p>
  29094. <table>
  29095. <thead>
  29096. <tr>
  29097. <th>Field</th>
  29098. <th>Description</th>
  29099. </tr>
  29100. </thead>
  29101. <tbody>
  29102. <tr>
  29103. <td>
  29104. <code>metadata</code></br>
  29105. <em>
  29106. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29107. Kubernetes meta/v1.ObjectMeta
  29108. </a>
  29109. </em>
  29110. </td>
  29111. <td>
  29112. Refer to the Kubernetes API documentation for the fields of the
  29113. <code>metadata</code> field.
  29114. </td>
  29115. </tr>
  29116. <tr>
  29117. <td>
  29118. <code>spec</code></br>
  29119. <em>
  29120. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateSpec">
  29121. GeneratorStateSpec
  29122. </a>
  29123. </em>
  29124. </td>
  29125. <td>
  29126. <br/>
  29127. <br/>
  29128. <table>
  29129. <tr>
  29130. <td>
  29131. <code>garbageCollectionDeadline</code></br>
  29132. <em>
  29133. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29134. Kubernetes meta/v1.Time
  29135. </a>
  29136. </em>
  29137. </td>
  29138. <td>
  29139. <p>GarbageCollectionDeadline is the time after which the generator state
  29140. will be deleted.
  29141. It is set by the controller which creates the generator state and
  29142. can be set configured by the user.
  29143. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  29144. </td>
  29145. </tr>
  29146. <tr>
  29147. <td>
  29148. <code>resource</code></br>
  29149. <em>
  29150. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29151. </em>
  29152. </td>
  29153. <td>
  29154. <p>Resource is the generator manifest that produced the state.
  29155. It is a snapshot of the generator manifest at the time the state was produced.
  29156. This manifest will be used to delete the resource. Any configuration that is referenced
  29157. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  29158. be blocked by a finalizer.</p>
  29159. </td>
  29160. </tr>
  29161. <tr>
  29162. <td>
  29163. <code>state</code></br>
  29164. <em>
  29165. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29166. </em>
  29167. </td>
  29168. <td>
  29169. <p>State is the state that was produced by the generator implementation.</p>
  29170. </td>
  29171. </tr>
  29172. </table>
  29173. </td>
  29174. </tr>
  29175. <tr>
  29176. <td>
  29177. <code>status</code></br>
  29178. <em>
  29179. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">
  29180. GeneratorStateStatus
  29181. </a>
  29182. </em>
  29183. </td>
  29184. <td>
  29185. </td>
  29186. </tr>
  29187. </tbody>
  29188. </table>
  29189. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">GeneratorStateConditionType
  29190. (<code>string</code> alias)</p></h3>
  29191. <p>
  29192. (<em>Appears on:</em>
  29193. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition</a>)
  29194. </p>
  29195. <p>
  29196. <p>GeneratorStateConditionType represents the type of condition for a generator state.</p>
  29197. </p>
  29198. <table>
  29199. <thead>
  29200. <tr>
  29201. <th>Value</th>
  29202. <th>Description</th>
  29203. </tr>
  29204. </thead>
  29205. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  29206. <td><p>GeneratorStateReady indicates the generator state is ready and available.</p>
  29207. </td>
  29208. </tr></tbody>
  29209. </table>
  29210. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateSpec">GeneratorStateSpec
  29211. </h3>
  29212. <p>
  29213. (<em>Appears on:</em>
  29214. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  29215. </p>
  29216. <p>
  29217. <p>GeneratorStateSpec defines the desired state of a generator state resource.</p>
  29218. </p>
  29219. <table>
  29220. <thead>
  29221. <tr>
  29222. <th>Field</th>
  29223. <th>Description</th>
  29224. </tr>
  29225. </thead>
  29226. <tbody>
  29227. <tr>
  29228. <td>
  29229. <code>garbageCollectionDeadline</code></br>
  29230. <em>
  29231. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29232. Kubernetes meta/v1.Time
  29233. </a>
  29234. </em>
  29235. </td>
  29236. <td>
  29237. <p>GarbageCollectionDeadline is the time after which the generator state
  29238. will be deleted.
  29239. It is set by the controller which creates the generator state and
  29240. can be set configured by the user.
  29241. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  29242. </td>
  29243. </tr>
  29244. <tr>
  29245. <td>
  29246. <code>resource</code></br>
  29247. <em>
  29248. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29249. </em>
  29250. </td>
  29251. <td>
  29252. <p>Resource is the generator manifest that produced the state.
  29253. It is a snapshot of the generator manifest at the time the state was produced.
  29254. This manifest will be used to delete the resource. Any configuration that is referenced
  29255. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  29256. be blocked by a finalizer.</p>
  29257. </td>
  29258. </tr>
  29259. <tr>
  29260. <td>
  29261. <code>state</code></br>
  29262. <em>
  29263. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29264. </em>
  29265. </td>
  29266. <td>
  29267. <p>State is the state that was produced by the generator implementation.</p>
  29268. </td>
  29269. </tr>
  29270. </tbody>
  29271. </table>
  29272. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus
  29273. </h3>
  29274. <p>
  29275. (<em>Appears on:</em>
  29276. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  29277. </p>
  29278. <p>
  29279. <p>GeneratorStateStatus defines the observed state of a generator state resource.</p>
  29280. </p>
  29281. <table>
  29282. <thead>
  29283. <tr>
  29284. <th>Field</th>
  29285. <th>Description</th>
  29286. </tr>
  29287. </thead>
  29288. <tbody>
  29289. <tr>
  29290. <td>
  29291. <code>conditions</code></br>
  29292. <em>
  29293. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">
  29294. []GeneratorStateStatusCondition
  29295. </a>
  29296. </em>
  29297. </td>
  29298. <td>
  29299. </td>
  29300. </tr>
  29301. </tbody>
  29302. </table>
  29303. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition
  29304. </h3>
  29305. <p>
  29306. (<em>Appears on:</em>
  29307. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus</a>)
  29308. </p>
  29309. <p>
  29310. <p>GeneratorStateStatusCondition represents the observed condition of a generator state.</p>
  29311. </p>
  29312. <table>
  29313. <thead>
  29314. <tr>
  29315. <th>Field</th>
  29316. <th>Description</th>
  29317. </tr>
  29318. </thead>
  29319. <tbody>
  29320. <tr>
  29321. <td>
  29322. <code>type</code></br>
  29323. <em>
  29324. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">
  29325. GeneratorStateConditionType
  29326. </a>
  29327. </em>
  29328. </td>
  29329. <td>
  29330. </td>
  29331. </tr>
  29332. <tr>
  29333. <td>
  29334. <code>status</code></br>
  29335. <em>
  29336. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  29337. Kubernetes core/v1.ConditionStatus
  29338. </a>
  29339. </em>
  29340. </td>
  29341. <td>
  29342. </td>
  29343. </tr>
  29344. <tr>
  29345. <td>
  29346. <code>reason</code></br>
  29347. <em>
  29348. string
  29349. </em>
  29350. </td>
  29351. <td>
  29352. <em>(Optional)</em>
  29353. </td>
  29354. </tr>
  29355. <tr>
  29356. <td>
  29357. <code>message</code></br>
  29358. <em>
  29359. string
  29360. </em>
  29361. </td>
  29362. <td>
  29363. <em>(Optional)</em>
  29364. </td>
  29365. </tr>
  29366. <tr>
  29367. <td>
  29368. <code>lastTransitionTime</code></br>
  29369. <em>
  29370. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29371. Kubernetes meta/v1.Time
  29372. </a>
  29373. </em>
  29374. </td>
  29375. <td>
  29376. <em>(Optional)</em>
  29377. </td>
  29378. </tr>
  29379. </tbody>
  29380. </table>
  29381. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken
  29382. </h3>
  29383. <p>
  29384. <p>GithubAccessToken generates ghs_ accessToken</p>
  29385. </p>
  29386. <table>
  29387. <thead>
  29388. <tr>
  29389. <th>Field</th>
  29390. <th>Description</th>
  29391. </tr>
  29392. </thead>
  29393. <tbody>
  29394. <tr>
  29395. <td>
  29396. <code>metadata</code></br>
  29397. <em>
  29398. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29399. Kubernetes meta/v1.ObjectMeta
  29400. </a>
  29401. </em>
  29402. </td>
  29403. <td>
  29404. Refer to the Kubernetes API documentation for the fields of the
  29405. <code>metadata</code> field.
  29406. </td>
  29407. </tr>
  29408. <tr>
  29409. <td>
  29410. <code>spec</code></br>
  29411. <em>
  29412. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  29413. GithubAccessTokenSpec
  29414. </a>
  29415. </em>
  29416. </td>
  29417. <td>
  29418. <br/>
  29419. <br/>
  29420. <table>
  29421. <tr>
  29422. <td>
  29423. <code>url</code></br>
  29424. <em>
  29425. string
  29426. </em>
  29427. </td>
  29428. <td>
  29429. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  29430. </td>
  29431. </tr>
  29432. <tr>
  29433. <td>
  29434. <code>appID</code></br>
  29435. <em>
  29436. string
  29437. </em>
  29438. </td>
  29439. <td>
  29440. </td>
  29441. </tr>
  29442. <tr>
  29443. <td>
  29444. <code>installID</code></br>
  29445. <em>
  29446. string
  29447. </em>
  29448. </td>
  29449. <td>
  29450. </td>
  29451. </tr>
  29452. <tr>
  29453. <td>
  29454. <code>repositories</code></br>
  29455. <em>
  29456. []string
  29457. </em>
  29458. </td>
  29459. <td>
  29460. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  29461. is installed to.</p>
  29462. </td>
  29463. </tr>
  29464. <tr>
  29465. <td>
  29466. <code>permissions</code></br>
  29467. <em>
  29468. map[string]string
  29469. </em>
  29470. </td>
  29471. <td>
  29472. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  29473. </td>
  29474. </tr>
  29475. <tr>
  29476. <td>
  29477. <code>auth</code></br>
  29478. <em>
  29479. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  29480. GithubAuth
  29481. </a>
  29482. </em>
  29483. </td>
  29484. <td>
  29485. <p>Auth configures how ESO authenticates with a Github instance.</p>
  29486. </td>
  29487. </tr>
  29488. </table>
  29489. </td>
  29490. </tr>
  29491. </tbody>
  29492. </table>
  29493. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec
  29494. </h3>
  29495. <p>
  29496. (<em>Appears on:</em>
  29497. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29498. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken</a>)
  29499. </p>
  29500. <p>
  29501. <p>GithubAccessTokenSpec defines the desired state to generate a GitHub access token.</p>
  29502. </p>
  29503. <table>
  29504. <thead>
  29505. <tr>
  29506. <th>Field</th>
  29507. <th>Description</th>
  29508. </tr>
  29509. </thead>
  29510. <tbody>
  29511. <tr>
  29512. <td>
  29513. <code>url</code></br>
  29514. <em>
  29515. string
  29516. </em>
  29517. </td>
  29518. <td>
  29519. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  29520. </td>
  29521. </tr>
  29522. <tr>
  29523. <td>
  29524. <code>appID</code></br>
  29525. <em>
  29526. string
  29527. </em>
  29528. </td>
  29529. <td>
  29530. </td>
  29531. </tr>
  29532. <tr>
  29533. <td>
  29534. <code>installID</code></br>
  29535. <em>
  29536. string
  29537. </em>
  29538. </td>
  29539. <td>
  29540. </td>
  29541. </tr>
  29542. <tr>
  29543. <td>
  29544. <code>repositories</code></br>
  29545. <em>
  29546. []string
  29547. </em>
  29548. </td>
  29549. <td>
  29550. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  29551. is installed to.</p>
  29552. </td>
  29553. </tr>
  29554. <tr>
  29555. <td>
  29556. <code>permissions</code></br>
  29557. <em>
  29558. map[string]string
  29559. </em>
  29560. </td>
  29561. <td>
  29562. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  29563. </td>
  29564. </tr>
  29565. <tr>
  29566. <td>
  29567. <code>auth</code></br>
  29568. <em>
  29569. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  29570. GithubAuth
  29571. </a>
  29572. </em>
  29573. </td>
  29574. <td>
  29575. <p>Auth configures how ESO authenticates with a Github instance.</p>
  29576. </td>
  29577. </tr>
  29578. </tbody>
  29579. </table>
  29580. <h3 id="generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth
  29581. </h3>
  29582. <p>
  29583. (<em>Appears on:</em>
  29584. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec</a>)
  29585. </p>
  29586. <p>
  29587. <p>GithubAuth defines the authentication configuration for GitHub access.</p>
  29588. </p>
  29589. <table>
  29590. <thead>
  29591. <tr>
  29592. <th>Field</th>
  29593. <th>Description</th>
  29594. </tr>
  29595. </thead>
  29596. <tbody>
  29597. <tr>
  29598. <td>
  29599. <code>privateKey</code></br>
  29600. <em>
  29601. <a href="#generators.external-secrets.io/v1alpha1.GithubSecretRef">
  29602. GithubSecretRef
  29603. </a>
  29604. </em>
  29605. </td>
  29606. <td>
  29607. </td>
  29608. </tr>
  29609. </tbody>
  29610. </table>
  29611. <h3 id="generators.external-secrets.io/v1alpha1.GithubSecretRef">GithubSecretRef
  29612. </h3>
  29613. <p>
  29614. (<em>Appears on:</em>
  29615. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth</a>)
  29616. </p>
  29617. <p>
  29618. <p>GithubSecretRef references a secret containing GitHub credentials.</p>
  29619. </p>
  29620. <table>
  29621. <thead>
  29622. <tr>
  29623. <th>Field</th>
  29624. <th>Description</th>
  29625. </tr>
  29626. </thead>
  29627. <tbody>
  29628. <tr>
  29629. <td>
  29630. <code>secretRef</code></br>
  29631. <em>
  29632. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29633. External Secrets meta/v1.SecretKeySelector
  29634. </a>
  29635. </em>
  29636. </td>
  29637. <td>
  29638. </td>
  29639. </tr>
  29640. </tbody>
  29641. </table>
  29642. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployToken">GitlabDeployToken
  29643. </h3>
  29644. <p>
  29645. <p>GitlabDeployToken generates a GitLab deploy token.</p>
  29646. </p>
  29647. <table>
  29648. <thead>
  29649. <tr>
  29650. <th>Field</th>
  29651. <th>Description</th>
  29652. </tr>
  29653. </thead>
  29654. <tbody>
  29655. <tr>
  29656. <td>
  29657. <code>metadata</code></br>
  29658. <em>
  29659. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29660. Kubernetes meta/v1.ObjectMeta
  29661. </a>
  29662. </em>
  29663. </td>
  29664. <td>
  29665. Refer to the Kubernetes API documentation for the fields of the
  29666. <code>metadata</code> field.
  29667. </td>
  29668. </tr>
  29669. <tr>
  29670. <td>
  29671. <code>spec</code></br>
  29672. <em>
  29673. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">
  29674. GitlabDeployTokenSpec
  29675. </a>
  29676. </em>
  29677. </td>
  29678. <td>
  29679. <br/>
  29680. <br/>
  29681. <table>
  29682. <tr>
  29683. <td>
  29684. <code>url</code></br>
  29685. <em>
  29686. string
  29687. </em>
  29688. </td>
  29689. <td>
  29690. <em>(Optional)</em>
  29691. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com">https://gitlab.com</a>.</p>
  29692. </td>
  29693. </tr>
  29694. <tr>
  29695. <td>
  29696. <code>projectID</code></br>
  29697. <em>
  29698. string
  29699. </em>
  29700. </td>
  29701. <td>
  29702. <em>(Optional)</em>
  29703. <p>ProjectID is the numeric ID or unescaped path (e.g. group/project) of the
  29704. project to create the deploy token in. The generator URL-escapes paths before
  29705. calling the GitLab API, so do not pre-encode. Mutually exclusive with groupID.</p>
  29706. </td>
  29707. </tr>
  29708. <tr>
  29709. <td>
  29710. <code>groupID</code></br>
  29711. <em>
  29712. string
  29713. </em>
  29714. </td>
  29715. <td>
  29716. <em>(Optional)</em>
  29717. <p>GroupID is the numeric ID or unescaped path (e.g. parent/group) of the group to
  29718. create the deploy token in. The generator URL-escapes paths before calling the
  29719. GitLab API, so do not pre-encode. Mutually exclusive with projectID.</p>
  29720. </td>
  29721. </tr>
  29722. <tr>
  29723. <td>
  29724. <code>name</code></br>
  29725. <em>
  29726. string
  29727. </em>
  29728. </td>
  29729. <td>
  29730. <p>Name of the deploy token.</p>
  29731. </td>
  29732. </tr>
  29733. <tr>
  29734. <td>
  29735. <code>scopes</code></br>
  29736. <em>
  29737. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">
  29738. []GitlabDeployTokenScope
  29739. </a>
  29740. </em>
  29741. </td>
  29742. <td>
  29743. <p>Scopes granted to the deploy token. At least one scope is required.</p>
  29744. </td>
  29745. </tr>
  29746. <tr>
  29747. <td>
  29748. <code>expiresAt</code></br>
  29749. <em>
  29750. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29751. Kubernetes meta/v1.Time
  29752. </a>
  29753. </em>
  29754. </td>
  29755. <td>
  29756. <em>(Optional)</em>
  29757. <p>ExpiresAt is an optional expiry for the deploy token. If omitted the token does
  29758. not expire on the GitLab side and is revoked only when the generator state is
  29759. cleaned up (on regeneration or when the consuming ExternalSecret is deleted).</p>
  29760. </td>
  29761. </tr>
  29762. <tr>
  29763. <td>
  29764. <code>username</code></br>
  29765. <em>
  29766. string
  29767. </em>
  29768. </td>
  29769. <td>
  29770. <em>(Optional)</em>
  29771. <p>Username is an optional username for the deploy token. GitLab defaults it to
  29772. gitlab+deploy-token-{n} when omitted.</p>
  29773. </td>
  29774. </tr>
  29775. <tr>
  29776. <td>
  29777. <code>auth</code></br>
  29778. <em>
  29779. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">
  29780. GitlabDeployTokenAuth
  29781. </a>
  29782. </em>
  29783. </td>
  29784. <td>
  29785. <p>Auth configures how ESO authenticates with the GitLab API.</p>
  29786. </td>
  29787. </tr>
  29788. </table>
  29789. </td>
  29790. </tr>
  29791. </tbody>
  29792. </table>
  29793. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">GitlabDeployTokenAuth
  29794. </h3>
  29795. <p>
  29796. (<em>Appears on:</em>
  29797. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec</a>)
  29798. </p>
  29799. <p>
  29800. <p>GitlabDeployTokenAuth defines the authentication configuration for the GitLab API.</p>
  29801. </p>
  29802. <table>
  29803. <thead>
  29804. <tr>
  29805. <th>Field</th>
  29806. <th>Description</th>
  29807. </tr>
  29808. </thead>
  29809. <tbody>
  29810. <tr>
  29811. <td>
  29812. <code>token</code></br>
  29813. <em>
  29814. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSecretRef">
  29815. GitlabDeployTokenSecretRef
  29816. </a>
  29817. </em>
  29818. </td>
  29819. <td>
  29820. <p>Token references a secret containing a GitLab access token (personal, group, or
  29821. project) with the api scope and at least the Maintainer role on the target.</p>
  29822. </td>
  29823. </tr>
  29824. </tbody>
  29825. </table>
  29826. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">GitlabDeployTokenScope
  29827. (<code>string</code> alias)</p></h3>
  29828. <p>
  29829. (<em>Appears on:</em>
  29830. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec</a>)
  29831. </p>
  29832. <p>
  29833. <p>GitlabDeployTokenScope is a scope that can be granted to a GitLab deploy token.</p>
  29834. </p>
  29835. <table>
  29836. <thead>
  29837. <tr>
  29838. <th>Value</th>
  29839. <th>Description</th>
  29840. </tr>
  29841. </thead>
  29842. <tbody><tr><td><p>&#34;read_package_registry&#34;</p></td>
  29843. <td><p>GitlabDeployTokenScopeReadPackageRegistry allows read access to the package registry.</p>
  29844. </td>
  29845. </tr><tr><td><p>&#34;read_registry&#34;</p></td>
  29846. <td><p>GitlabDeployTokenScopeReadRegistry allows read access to the container registry.</p>
  29847. </td>
  29848. </tr><tr><td><p>&#34;read_repository&#34;</p></td>
  29849. <td><p>GitlabDeployTokenScopeReadRepository allows read access to the repository.</p>
  29850. </td>
  29851. </tr><tr><td><p>&#34;read_virtual_registry&#34;</p></td>
  29852. <td><p>GitlabDeployTokenScopeReadVirtualRegistry allows read access to the virtual registry (projects only).</p>
  29853. </td>
  29854. </tr><tr><td><p>&#34;write_package_registry&#34;</p></td>
  29855. <td><p>GitlabDeployTokenScopeWritePackageRegistry allows write access to the package registry.</p>
  29856. </td>
  29857. </tr><tr><td><p>&#34;write_registry&#34;</p></td>
  29858. <td><p>GitlabDeployTokenScopeWriteRegistry allows write access to the container registry.</p>
  29859. </td>
  29860. </tr><tr><td><p>&#34;write_virtual_registry&#34;</p></td>
  29861. <td><p>GitlabDeployTokenScopeWriteVirtualRegistry allows write access to the virtual registry (projects only).</p>
  29862. </td>
  29863. </tr></tbody>
  29864. </table>
  29865. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenSecretRef">GitlabDeployTokenSecretRef
  29866. </h3>
  29867. <p>
  29868. (<em>Appears on:</em>
  29869. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">GitlabDeployTokenAuth</a>)
  29870. </p>
  29871. <p>
  29872. <p>GitlabDeployTokenSecretRef references a secret containing a GitLab access token.</p>
  29873. </p>
  29874. <table>
  29875. <thead>
  29876. <tr>
  29877. <th>Field</th>
  29878. <th>Description</th>
  29879. </tr>
  29880. </thead>
  29881. <tbody>
  29882. <tr>
  29883. <td>
  29884. <code>secretRef</code></br>
  29885. <em>
  29886. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29887. External Secrets meta/v1.SecretKeySelector
  29888. </a>
  29889. </em>
  29890. </td>
  29891. <td>
  29892. </td>
  29893. </tr>
  29894. </tbody>
  29895. </table>
  29896. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec
  29897. </h3>
  29898. <p>
  29899. (<em>Appears on:</em>
  29900. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29901. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployToken">GitlabDeployToken</a>)
  29902. </p>
  29903. <p>
  29904. <p>GitlabDeployTokenSpec defines the desired state to generate a GitLab deploy token.</p>
  29905. </p>
  29906. <table>
  29907. <thead>
  29908. <tr>
  29909. <th>Field</th>
  29910. <th>Description</th>
  29911. </tr>
  29912. </thead>
  29913. <tbody>
  29914. <tr>
  29915. <td>
  29916. <code>url</code></br>
  29917. <em>
  29918. string
  29919. </em>
  29920. </td>
  29921. <td>
  29922. <em>(Optional)</em>
  29923. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com">https://gitlab.com</a>.</p>
  29924. </td>
  29925. </tr>
  29926. <tr>
  29927. <td>
  29928. <code>projectID</code></br>
  29929. <em>
  29930. string
  29931. </em>
  29932. </td>
  29933. <td>
  29934. <em>(Optional)</em>
  29935. <p>ProjectID is the numeric ID or unescaped path (e.g. group/project) of the
  29936. project to create the deploy token in. The generator URL-escapes paths before
  29937. calling the GitLab API, so do not pre-encode. Mutually exclusive with groupID.</p>
  29938. </td>
  29939. </tr>
  29940. <tr>
  29941. <td>
  29942. <code>groupID</code></br>
  29943. <em>
  29944. string
  29945. </em>
  29946. </td>
  29947. <td>
  29948. <em>(Optional)</em>
  29949. <p>GroupID is the numeric ID or unescaped path (e.g. parent/group) of the group to
  29950. create the deploy token in. The generator URL-escapes paths before calling the
  29951. GitLab API, so do not pre-encode. Mutually exclusive with projectID.</p>
  29952. </td>
  29953. </tr>
  29954. <tr>
  29955. <td>
  29956. <code>name</code></br>
  29957. <em>
  29958. string
  29959. </em>
  29960. </td>
  29961. <td>
  29962. <p>Name of the deploy token.</p>
  29963. </td>
  29964. </tr>
  29965. <tr>
  29966. <td>
  29967. <code>scopes</code></br>
  29968. <em>
  29969. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">
  29970. []GitlabDeployTokenScope
  29971. </a>
  29972. </em>
  29973. </td>
  29974. <td>
  29975. <p>Scopes granted to the deploy token. At least one scope is required.</p>
  29976. </td>
  29977. </tr>
  29978. <tr>
  29979. <td>
  29980. <code>expiresAt</code></br>
  29981. <em>
  29982. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29983. Kubernetes meta/v1.Time
  29984. </a>
  29985. </em>
  29986. </td>
  29987. <td>
  29988. <em>(Optional)</em>
  29989. <p>ExpiresAt is an optional expiry for the deploy token. If omitted the token does
  29990. not expire on the GitLab side and is revoked only when the generator state is
  29991. cleaned up (on regeneration or when the consuming ExternalSecret is deleted).</p>
  29992. </td>
  29993. </tr>
  29994. <tr>
  29995. <td>
  29996. <code>username</code></br>
  29997. <em>
  29998. string
  29999. </em>
  30000. </td>
  30001. <td>
  30002. <em>(Optional)</em>
  30003. <p>Username is an optional username for the deploy token. GitLab defaults it to
  30004. gitlab+deploy-token-{n} when omitted.</p>
  30005. </td>
  30006. </tr>
  30007. <tr>
  30008. <td>
  30009. <code>auth</code></br>
  30010. <em>
  30011. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">
  30012. GitlabDeployTokenAuth
  30013. </a>
  30014. </em>
  30015. </td>
  30016. <td>
  30017. <p>Auth configures how ESO authenticates with the GitLab API.</p>
  30018. </td>
  30019. </tr>
  30020. </tbody>
  30021. </table>
  30022. <h3 id="generators.external-secrets.io/v1alpha1.Grafana">Grafana
  30023. </h3>
  30024. <p>
  30025. <p>Grafana represents a generator for Grafana service account tokens.</p>
  30026. </p>
  30027. <table>
  30028. <thead>
  30029. <tr>
  30030. <th>Field</th>
  30031. <th>Description</th>
  30032. </tr>
  30033. </thead>
  30034. <tbody>
  30035. <tr>
  30036. <td>
  30037. <code>metadata</code></br>
  30038. <em>
  30039. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30040. Kubernetes meta/v1.ObjectMeta
  30041. </a>
  30042. </em>
  30043. </td>
  30044. <td>
  30045. Refer to the Kubernetes API documentation for the fields of the
  30046. <code>metadata</code> field.
  30047. </td>
  30048. </tr>
  30049. <tr>
  30050. <td>
  30051. <code>spec</code></br>
  30052. <em>
  30053. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  30054. GrafanaSpec
  30055. </a>
  30056. </em>
  30057. </td>
  30058. <td>
  30059. <br/>
  30060. <br/>
  30061. <table>
  30062. <tr>
  30063. <td>
  30064. <code>url</code></br>
  30065. <em>
  30066. string
  30067. </em>
  30068. </td>
  30069. <td>
  30070. <p>URL is the URL of the Grafana instance.</p>
  30071. </td>
  30072. </tr>
  30073. <tr>
  30074. <td>
  30075. <code>auth</code></br>
  30076. <em>
  30077. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  30078. GrafanaAuth
  30079. </a>
  30080. </em>
  30081. </td>
  30082. <td>
  30083. <p>Auth is the authentication configuration to authenticate
  30084. against the Grafana instance.</p>
  30085. </td>
  30086. </tr>
  30087. <tr>
  30088. <td>
  30089. <code>serviceAccount</code></br>
  30090. <em>
  30091. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  30092. GrafanaServiceAccount
  30093. </a>
  30094. </em>
  30095. </td>
  30096. <td>
  30097. <p>ServiceAccount is the configuration for the service account that
  30098. is supposed to be generated by the generator.</p>
  30099. </td>
  30100. </tr>
  30101. </table>
  30102. </td>
  30103. </tr>
  30104. </tbody>
  30105. </table>
  30106. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth
  30107. </h3>
  30108. <p>
  30109. (<em>Appears on:</em>
  30110. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  30111. </p>
  30112. <p>
  30113. <p>GrafanaAuth defines the authentication methods for connecting to a Grafana instance.</p>
  30114. </p>
  30115. <table>
  30116. <thead>
  30117. <tr>
  30118. <th>Field</th>
  30119. <th>Description</th>
  30120. </tr>
  30121. </thead>
  30122. <tbody>
  30123. <tr>
  30124. <td>
  30125. <code>token</code></br>
  30126. <em>
  30127. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  30128. SecretKeySelector
  30129. </a>
  30130. </em>
  30131. </td>
  30132. <td>
  30133. <em>(Optional)</em>
  30134. <p>A service account token used to authenticate against the Grafana instance.
  30135. Note: you need a token which has elevated permissions to create service accounts.
  30136. See here for the documentation on basic roles offered by Grafana:
  30137. <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>
  30138. </td>
  30139. </tr>
  30140. <tr>
  30141. <td>
  30142. <code>basic</code></br>
  30143. <em>
  30144. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">
  30145. GrafanaBasicAuth
  30146. </a>
  30147. </em>
  30148. </td>
  30149. <td>
  30150. <em>(Optional)</em>
  30151. <p>Basic auth credentials used to authenticate against the Grafana instance.
  30152. Note: you need a token which has elevated permissions to create service accounts.
  30153. See here for the documentation on basic roles offered by Grafana:
  30154. <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>
  30155. </td>
  30156. </tr>
  30157. </tbody>
  30158. </table>
  30159. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth
  30160. </h3>
  30161. <p>
  30162. (<em>Appears on:</em>
  30163. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>)
  30164. </p>
  30165. <p>
  30166. <p>GrafanaBasicAuth defines the credentials for basic authentication with Grafana.</p>
  30167. </p>
  30168. <table>
  30169. <thead>
  30170. <tr>
  30171. <th>Field</th>
  30172. <th>Description</th>
  30173. </tr>
  30174. </thead>
  30175. <tbody>
  30176. <tr>
  30177. <td>
  30178. <code>username</code></br>
  30179. <em>
  30180. string
  30181. </em>
  30182. </td>
  30183. <td>
  30184. <p>A basic auth username used to authenticate against the Grafana instance.</p>
  30185. </td>
  30186. </tr>
  30187. <tr>
  30188. <td>
  30189. <code>password</code></br>
  30190. <em>
  30191. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  30192. SecretKeySelector
  30193. </a>
  30194. </em>
  30195. </td>
  30196. <td>
  30197. <p>A basic auth password used to authenticate against the Grafana instance.</p>
  30198. </td>
  30199. </tr>
  30200. </tbody>
  30201. </table>
  30202. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">GrafanaServiceAccount
  30203. </h3>
  30204. <p>
  30205. (<em>Appears on:</em>
  30206. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  30207. </p>
  30208. <p>
  30209. <p>GrafanaServiceAccount defines the configuration for a Grafana service account to be created.</p>
  30210. </p>
  30211. <table>
  30212. <thead>
  30213. <tr>
  30214. <th>Field</th>
  30215. <th>Description</th>
  30216. </tr>
  30217. </thead>
  30218. <tbody>
  30219. <tr>
  30220. <td>
  30221. <code>name</code></br>
  30222. <em>
  30223. string
  30224. </em>
  30225. </td>
  30226. <td>
  30227. <p>Name is the name of the service account that will be created by ESO.</p>
  30228. </td>
  30229. </tr>
  30230. <tr>
  30231. <td>
  30232. <code>role</code></br>
  30233. <em>
  30234. string
  30235. </em>
  30236. </td>
  30237. <td>
  30238. <p>Role is the role of the service account.
  30239. See here for the documentation on basic roles offered by Grafana:
  30240. <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>
  30241. </td>
  30242. </tr>
  30243. <tr>
  30244. <td>
  30245. <code>secondsToLive</code></br>
  30246. <em>
  30247. int64
  30248. </em>
  30249. </td>
  30250. <td>
  30251. <em>(Optional)</em>
  30252. <p>SecondsToLive is the number of seconds before the generated service account token will expire.
  30253. Some Grafana deployments (e.g. AWS Managed Grafana) require this value to be set.</p>
  30254. </td>
  30255. </tr>
  30256. </tbody>
  30257. </table>
  30258. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState
  30259. </h3>
  30260. <p>
  30261. <p>GrafanaServiceAccountTokenState is the state type produced by the Grafana generator.
  30262. It contains the service account ID, login and token ID which is enough to
  30263. identify the service account.</p>
  30264. </p>
  30265. <table>
  30266. <thead>
  30267. <tr>
  30268. <th>Field</th>
  30269. <th>Description</th>
  30270. </tr>
  30271. </thead>
  30272. <tbody>
  30273. <tr>
  30274. <td>
  30275. <code>serviceAccount</code></br>
  30276. <em>
  30277. <a href="#generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">
  30278. GrafanaStateServiceAccount
  30279. </a>
  30280. </em>
  30281. </td>
  30282. <td>
  30283. </td>
  30284. </tr>
  30285. </tbody>
  30286. </table>
  30287. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec
  30288. </h3>
  30289. <p>
  30290. (<em>Appears on:</em>
  30291. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30292. <a href="#generators.external-secrets.io/v1alpha1.Grafana">Grafana</a>)
  30293. </p>
  30294. <p>
  30295. <p>GrafanaSpec controls the behavior of the grafana generator.</p>
  30296. </p>
  30297. <table>
  30298. <thead>
  30299. <tr>
  30300. <th>Field</th>
  30301. <th>Description</th>
  30302. </tr>
  30303. </thead>
  30304. <tbody>
  30305. <tr>
  30306. <td>
  30307. <code>url</code></br>
  30308. <em>
  30309. string
  30310. </em>
  30311. </td>
  30312. <td>
  30313. <p>URL is the URL of the Grafana instance.</p>
  30314. </td>
  30315. </tr>
  30316. <tr>
  30317. <td>
  30318. <code>auth</code></br>
  30319. <em>
  30320. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  30321. GrafanaAuth
  30322. </a>
  30323. </em>
  30324. </td>
  30325. <td>
  30326. <p>Auth is the authentication configuration to authenticate
  30327. against the Grafana instance.</p>
  30328. </td>
  30329. </tr>
  30330. <tr>
  30331. <td>
  30332. <code>serviceAccount</code></br>
  30333. <em>
  30334. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  30335. GrafanaServiceAccount
  30336. </a>
  30337. </em>
  30338. </td>
  30339. <td>
  30340. <p>ServiceAccount is the configuration for the service account that
  30341. is supposed to be generated by the generator.</p>
  30342. </td>
  30343. </tr>
  30344. </tbody>
  30345. </table>
  30346. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">GrafanaStateServiceAccount
  30347. </h3>
  30348. <p>
  30349. (<em>Appears on:</em>
  30350. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState</a>)
  30351. </p>
  30352. <p>
  30353. <p>GrafanaStateServiceAccount contains the service account ID, login and token ID.</p>
  30354. </p>
  30355. <table>
  30356. <thead>
  30357. <tr>
  30358. <th>Field</th>
  30359. <th>Description</th>
  30360. </tr>
  30361. </thead>
  30362. <tbody>
  30363. <tr>
  30364. <td>
  30365. <code>id</code></br>
  30366. <em>
  30367. int64
  30368. </em>
  30369. </td>
  30370. <td>
  30371. </td>
  30372. </tr>
  30373. <tr>
  30374. <td>
  30375. <code>login</code></br>
  30376. <em>
  30377. string
  30378. </em>
  30379. </td>
  30380. <td>
  30381. </td>
  30382. </tr>
  30383. <tr>
  30384. <td>
  30385. <code>tokenID</code></br>
  30386. <em>
  30387. int64
  30388. </em>
  30389. </td>
  30390. <td>
  30391. </td>
  30392. </tr>
  30393. </tbody>
  30394. </table>
  30395. <h3 id="generators.external-secrets.io/v1alpha1.MFA">MFA
  30396. </h3>
  30397. <p>
  30398. <p>MFA generates a new TOTP token that is compliant with RFC 6238.</p>
  30399. </p>
  30400. <table>
  30401. <thead>
  30402. <tr>
  30403. <th>Field</th>
  30404. <th>Description</th>
  30405. </tr>
  30406. </thead>
  30407. <tbody>
  30408. <tr>
  30409. <td>
  30410. <code>metadata</code></br>
  30411. <em>
  30412. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30413. Kubernetes meta/v1.ObjectMeta
  30414. </a>
  30415. </em>
  30416. </td>
  30417. <td>
  30418. Refer to the Kubernetes API documentation for the fields of the
  30419. <code>metadata</code> field.
  30420. </td>
  30421. </tr>
  30422. <tr>
  30423. <td>
  30424. <code>spec</code></br>
  30425. <em>
  30426. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  30427. MFASpec
  30428. </a>
  30429. </em>
  30430. </td>
  30431. <td>
  30432. <br/>
  30433. <br/>
  30434. <table>
  30435. <tr>
  30436. <td>
  30437. <code>secret</code></br>
  30438. <em>
  30439. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30440. External Secrets meta/v1.SecretKeySelector
  30441. </a>
  30442. </em>
  30443. </td>
  30444. <td>
  30445. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  30446. </td>
  30447. </tr>
  30448. <tr>
  30449. <td>
  30450. <code>length</code></br>
  30451. <em>
  30452. int
  30453. </em>
  30454. </td>
  30455. <td>
  30456. <p>Length defines the token length. Defaults to 6 characters.</p>
  30457. </td>
  30458. </tr>
  30459. <tr>
  30460. <td>
  30461. <code>timePeriod</code></br>
  30462. <em>
  30463. int
  30464. </em>
  30465. </td>
  30466. <td>
  30467. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  30468. </td>
  30469. </tr>
  30470. <tr>
  30471. <td>
  30472. <code>algorithm</code></br>
  30473. <em>
  30474. string
  30475. </em>
  30476. </td>
  30477. <td>
  30478. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  30479. </td>
  30480. </tr>
  30481. <tr>
  30482. <td>
  30483. <code>when</code></br>
  30484. <em>
  30485. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  30486. Kubernetes meta/v1.Time
  30487. </a>
  30488. </em>
  30489. </td>
  30490. <td>
  30491. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  30492. </td>
  30493. </tr>
  30494. </table>
  30495. </td>
  30496. </tr>
  30497. </tbody>
  30498. </table>
  30499. <h3 id="generators.external-secrets.io/v1alpha1.MFASpec">MFASpec
  30500. </h3>
  30501. <p>
  30502. (<em>Appears on:</em>
  30503. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30504. <a href="#generators.external-secrets.io/v1alpha1.MFA">MFA</a>)
  30505. </p>
  30506. <p>
  30507. <p>MFASpec controls the behavior of the mfa generator.</p>
  30508. </p>
  30509. <table>
  30510. <thead>
  30511. <tr>
  30512. <th>Field</th>
  30513. <th>Description</th>
  30514. </tr>
  30515. </thead>
  30516. <tbody>
  30517. <tr>
  30518. <td>
  30519. <code>secret</code></br>
  30520. <em>
  30521. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30522. External Secrets meta/v1.SecretKeySelector
  30523. </a>
  30524. </em>
  30525. </td>
  30526. <td>
  30527. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  30528. </td>
  30529. </tr>
  30530. <tr>
  30531. <td>
  30532. <code>length</code></br>
  30533. <em>
  30534. int
  30535. </em>
  30536. </td>
  30537. <td>
  30538. <p>Length defines the token length. Defaults to 6 characters.</p>
  30539. </td>
  30540. </tr>
  30541. <tr>
  30542. <td>
  30543. <code>timePeriod</code></br>
  30544. <em>
  30545. int
  30546. </em>
  30547. </td>
  30548. <td>
  30549. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  30550. </td>
  30551. </tr>
  30552. <tr>
  30553. <td>
  30554. <code>algorithm</code></br>
  30555. <em>
  30556. string
  30557. </em>
  30558. </td>
  30559. <td>
  30560. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  30561. </td>
  30562. </tr>
  30563. <tr>
  30564. <td>
  30565. <code>when</code></br>
  30566. <em>
  30567. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  30568. Kubernetes meta/v1.Time
  30569. </a>
  30570. </em>
  30571. </td>
  30572. <td>
  30573. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  30574. </td>
  30575. </tr>
  30576. </tbody>
  30577. </table>
  30578. <h3 id="generators.external-secrets.io/v1alpha1.NTLMProtocol">NTLMProtocol
  30579. </h3>
  30580. <p>
  30581. (<em>Appears on:</em>
  30582. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol</a>)
  30583. </p>
  30584. <p>
  30585. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  30586. </p>
  30587. <table>
  30588. <thead>
  30589. <tr>
  30590. <th>Field</th>
  30591. <th>Description</th>
  30592. </tr>
  30593. </thead>
  30594. <tbody>
  30595. <tr>
  30596. <td>
  30597. <code>usernameSecret</code></br>
  30598. <em>
  30599. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30600. External Secrets meta/v1.SecretKeySelector
  30601. </a>
  30602. </em>
  30603. </td>
  30604. <td>
  30605. </td>
  30606. </tr>
  30607. <tr>
  30608. <td>
  30609. <code>passwordSecret</code></br>
  30610. <em>
  30611. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30612. External Secrets meta/v1.SecretKeySelector
  30613. </a>
  30614. </em>
  30615. </td>
  30616. <td>
  30617. </td>
  30618. </tr>
  30619. </tbody>
  30620. </table>
  30621. <h3 id="generators.external-secrets.io/v1alpha1.Password">Password
  30622. </h3>
  30623. <p>
  30624. <p>Password generates a random password based on the
  30625. configuration parameters in spec.
  30626. You can specify the length, characterset and other attributes.</p>
  30627. </p>
  30628. <table>
  30629. <thead>
  30630. <tr>
  30631. <th>Field</th>
  30632. <th>Description</th>
  30633. </tr>
  30634. </thead>
  30635. <tbody>
  30636. <tr>
  30637. <td>
  30638. <code>metadata</code></br>
  30639. <em>
  30640. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30641. Kubernetes meta/v1.ObjectMeta
  30642. </a>
  30643. </em>
  30644. </td>
  30645. <td>
  30646. Refer to the Kubernetes API documentation for the fields of the
  30647. <code>metadata</code> field.
  30648. </td>
  30649. </tr>
  30650. <tr>
  30651. <td>
  30652. <code>spec</code></br>
  30653. <em>
  30654. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  30655. PasswordSpec
  30656. </a>
  30657. </em>
  30658. </td>
  30659. <td>
  30660. <br/>
  30661. <br/>
  30662. <table>
  30663. <tr>
  30664. <td>
  30665. <code>length</code></br>
  30666. <em>
  30667. int
  30668. </em>
  30669. </td>
  30670. <td>
  30671. <p>Length of the password to be generated.
  30672. Defaults to 24</p>
  30673. </td>
  30674. </tr>
  30675. <tr>
  30676. <td>
  30677. <code>digits</code></br>
  30678. <em>
  30679. int
  30680. </em>
  30681. </td>
  30682. <td>
  30683. <p>Digits specifies the number of digits in the generated
  30684. password. If omitted it defaults to 25% of the length of the password</p>
  30685. </td>
  30686. </tr>
  30687. <tr>
  30688. <td>
  30689. <code>symbols</code></br>
  30690. <em>
  30691. int
  30692. </em>
  30693. </td>
  30694. <td>
  30695. <p>Symbols specifies the number of symbol characters in the generated
  30696. password. If omitted it defaults to 25% of the length of the password</p>
  30697. </td>
  30698. </tr>
  30699. <tr>
  30700. <td>
  30701. <code>symbolCharacters</code></br>
  30702. <em>
  30703. string
  30704. </em>
  30705. </td>
  30706. <td>
  30707. <p>SymbolCharacters specifies the special characters that should be used
  30708. in the generated password.</p>
  30709. </td>
  30710. </tr>
  30711. <tr>
  30712. <td>
  30713. <code>noUpper</code></br>
  30714. <em>
  30715. bool
  30716. </em>
  30717. </td>
  30718. <td>
  30719. <p>Set NoUpper to disable uppercase characters</p>
  30720. </td>
  30721. </tr>
  30722. <tr>
  30723. <td>
  30724. <code>allowRepeat</code></br>
  30725. <em>
  30726. bool
  30727. </em>
  30728. </td>
  30729. <td>
  30730. <p>set AllowRepeat to true to allow repeating characters.</p>
  30731. </td>
  30732. </tr>
  30733. <tr>
  30734. <td>
  30735. <code>secretKeys</code></br>
  30736. <em>
  30737. []string
  30738. </em>
  30739. </td>
  30740. <td>
  30741. <em>(Optional)</em>
  30742. <p>SecretKeys defines the keys that will be populated with generated passwords.
  30743. Defaults to &ldquo;password&rdquo; when not set.</p>
  30744. </td>
  30745. </tr>
  30746. <tr>
  30747. <td>
  30748. <code>encoding</code></br>
  30749. <em>
  30750. string
  30751. </em>
  30752. </td>
  30753. <td>
  30754. <p>Encoding specifies the encoding of the generated password.
  30755. Valid values are:
  30756. - &ldquo;raw&rdquo; (default): no encoding
  30757. - &ldquo;base64&rdquo;: standard base64 encoding
  30758. - &ldquo;base64url&rdquo;: base64url encoding
  30759. - &ldquo;base32&rdquo;: base32 encoding
  30760. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  30761. </td>
  30762. </tr>
  30763. </table>
  30764. </td>
  30765. </tr>
  30766. </tbody>
  30767. </table>
  30768. <h3 id="generators.external-secrets.io/v1alpha1.PasswordSpec">PasswordSpec
  30769. </h3>
  30770. <p>
  30771. (<em>Appears on:</em>
  30772. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30773. <a href="#generators.external-secrets.io/v1alpha1.Password">Password</a>)
  30774. </p>
  30775. <p>
  30776. <p>PasswordSpec controls the behavior of the password generator.</p>
  30777. </p>
  30778. <table>
  30779. <thead>
  30780. <tr>
  30781. <th>Field</th>
  30782. <th>Description</th>
  30783. </tr>
  30784. </thead>
  30785. <tbody>
  30786. <tr>
  30787. <td>
  30788. <code>length</code></br>
  30789. <em>
  30790. int
  30791. </em>
  30792. </td>
  30793. <td>
  30794. <p>Length of the password to be generated.
  30795. Defaults to 24</p>
  30796. </td>
  30797. </tr>
  30798. <tr>
  30799. <td>
  30800. <code>digits</code></br>
  30801. <em>
  30802. int
  30803. </em>
  30804. </td>
  30805. <td>
  30806. <p>Digits specifies the number of digits in the generated
  30807. password. If omitted it defaults to 25% of the length of the password</p>
  30808. </td>
  30809. </tr>
  30810. <tr>
  30811. <td>
  30812. <code>symbols</code></br>
  30813. <em>
  30814. int
  30815. </em>
  30816. </td>
  30817. <td>
  30818. <p>Symbols specifies the number of symbol characters in the generated
  30819. password. If omitted it defaults to 25% of the length of the password</p>
  30820. </td>
  30821. </tr>
  30822. <tr>
  30823. <td>
  30824. <code>symbolCharacters</code></br>
  30825. <em>
  30826. string
  30827. </em>
  30828. </td>
  30829. <td>
  30830. <p>SymbolCharacters specifies the special characters that should be used
  30831. in the generated password.</p>
  30832. </td>
  30833. </tr>
  30834. <tr>
  30835. <td>
  30836. <code>noUpper</code></br>
  30837. <em>
  30838. bool
  30839. </em>
  30840. </td>
  30841. <td>
  30842. <p>Set NoUpper to disable uppercase characters</p>
  30843. </td>
  30844. </tr>
  30845. <tr>
  30846. <td>
  30847. <code>allowRepeat</code></br>
  30848. <em>
  30849. bool
  30850. </em>
  30851. </td>
  30852. <td>
  30853. <p>set AllowRepeat to true to allow repeating characters.</p>
  30854. </td>
  30855. </tr>
  30856. <tr>
  30857. <td>
  30858. <code>secretKeys</code></br>
  30859. <em>
  30860. []string
  30861. </em>
  30862. </td>
  30863. <td>
  30864. <em>(Optional)</em>
  30865. <p>SecretKeys defines the keys that will be populated with generated passwords.
  30866. Defaults to &ldquo;password&rdquo; when not set.</p>
  30867. </td>
  30868. </tr>
  30869. <tr>
  30870. <td>
  30871. <code>encoding</code></br>
  30872. <em>
  30873. string
  30874. </em>
  30875. </td>
  30876. <td>
  30877. <p>Encoding specifies the encoding of the generated password.
  30878. Valid values are:
  30879. - &ldquo;raw&rdquo; (default): no encoding
  30880. - &ldquo;base64&rdquo;: standard base64 encoding
  30881. - &ldquo;base64url&rdquo;: base64url encoding
  30882. - &ldquo;base32&rdquo;: base32 encoding
  30883. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  30884. </td>
  30885. </tr>
  30886. </tbody>
  30887. </table>
  30888. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken
  30889. </h3>
  30890. <p>
  30891. <p>QuayAccessToken generates Quay oauth token for pulling/pushing images</p>
  30892. </p>
  30893. <table>
  30894. <thead>
  30895. <tr>
  30896. <th>Field</th>
  30897. <th>Description</th>
  30898. </tr>
  30899. </thead>
  30900. <tbody>
  30901. <tr>
  30902. <td>
  30903. <code>metadata</code></br>
  30904. <em>
  30905. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30906. Kubernetes meta/v1.ObjectMeta
  30907. </a>
  30908. </em>
  30909. </td>
  30910. <td>
  30911. Refer to the Kubernetes API documentation for the fields of the
  30912. <code>metadata</code> field.
  30913. </td>
  30914. </tr>
  30915. <tr>
  30916. <td>
  30917. <code>spec</code></br>
  30918. <em>
  30919. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  30920. QuayAccessTokenSpec
  30921. </a>
  30922. </em>
  30923. </td>
  30924. <td>
  30925. <br/>
  30926. <br/>
  30927. <table>
  30928. <tr>
  30929. <td>
  30930. <code>url</code></br>
  30931. <em>
  30932. string
  30933. </em>
  30934. </td>
  30935. <td>
  30936. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  30937. </td>
  30938. </tr>
  30939. <tr>
  30940. <td>
  30941. <code>robotAccount</code></br>
  30942. <em>
  30943. string
  30944. </em>
  30945. </td>
  30946. <td>
  30947. <p>Name of the robot account you are federating with</p>
  30948. </td>
  30949. </tr>
  30950. <tr>
  30951. <td>
  30952. <code>serviceAccountRef</code></br>
  30953. <em>
  30954. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  30955. External Secrets meta/v1.ServiceAccountSelector
  30956. </a>
  30957. </em>
  30958. </td>
  30959. <td>
  30960. <p>Name of the service account you are federating with</p>
  30961. </td>
  30962. </tr>
  30963. </table>
  30964. </td>
  30965. </tr>
  30966. </tbody>
  30967. </table>
  30968. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">QuayAccessTokenSpec
  30969. </h3>
  30970. <p>
  30971. (<em>Appears on:</em>
  30972. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30973. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken</a>)
  30974. </p>
  30975. <p>
  30976. <p>QuayAccessTokenSpec defines the desired state to generate a Quay access token.</p>
  30977. </p>
  30978. <table>
  30979. <thead>
  30980. <tr>
  30981. <th>Field</th>
  30982. <th>Description</th>
  30983. </tr>
  30984. </thead>
  30985. <tbody>
  30986. <tr>
  30987. <td>
  30988. <code>url</code></br>
  30989. <em>
  30990. string
  30991. </em>
  30992. </td>
  30993. <td>
  30994. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  30995. </td>
  30996. </tr>
  30997. <tr>
  30998. <td>
  30999. <code>robotAccount</code></br>
  31000. <em>
  31001. string
  31002. </em>
  31003. </td>
  31004. <td>
  31005. <p>Name of the robot account you are federating with</p>
  31006. </td>
  31007. </tr>
  31008. <tr>
  31009. <td>
  31010. <code>serviceAccountRef</code></br>
  31011. <em>
  31012. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  31013. External Secrets meta/v1.ServiceAccountSelector
  31014. </a>
  31015. </em>
  31016. </td>
  31017. <td>
  31018. <p>Name of the service account you are federating with</p>
  31019. </td>
  31020. </tr>
  31021. </tbody>
  31022. </table>
  31023. <h3 id="generators.external-secrets.io/v1alpha1.RequestParameters">RequestParameters
  31024. </h3>
  31025. <p>
  31026. (<em>Appears on:</em>
  31027. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  31028. </p>
  31029. <p>
  31030. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  31031. </p>
  31032. <table>
  31033. <thead>
  31034. <tr>
  31035. <th>Field</th>
  31036. <th>Description</th>
  31037. </tr>
  31038. </thead>
  31039. <tbody>
  31040. <tr>
  31041. <td>
  31042. <code>sessionDuration</code></br>
  31043. <em>
  31044. int32
  31045. </em>
  31046. </td>
  31047. <td>
  31048. <em>(Optional)</em>
  31049. </td>
  31050. </tr>
  31051. <tr>
  31052. <td>
  31053. <code>serialNumber</code></br>
  31054. <em>
  31055. string
  31056. </em>
  31057. </td>
  31058. <td>
  31059. <em>(Optional)</em>
  31060. <p>SerialNumber is the identification number of the MFA device that is associated with the IAM user who is making
  31061. the GetSessionToken call.
  31062. Possible values: hardware device (such as GAHT12345678) or an Amazon Resource Name (ARN) for a virtual device
  31063. (such as arn:aws:iam::123456789012:mfa/user)</p>
  31064. </td>
  31065. </tr>
  31066. <tr>
  31067. <td>
  31068. <code>tokenCode</code></br>
  31069. <em>
  31070. string
  31071. </em>
  31072. </td>
  31073. <td>
  31074. <em>(Optional)</em>
  31075. <p>TokenCode is the value provided by the MFA device, if MFA is required.</p>
  31076. </td>
  31077. </tr>
  31078. </tbody>
  31079. </table>
  31080. <h3 id="generators.external-secrets.io/v1alpha1.SSHKey">SSHKey
  31081. </h3>
  31082. <p>
  31083. <p>SSHKey generates SSH key pairs.</p>
  31084. </p>
  31085. <table>
  31086. <thead>
  31087. <tr>
  31088. <th>Field</th>
  31089. <th>Description</th>
  31090. </tr>
  31091. </thead>
  31092. <tbody>
  31093. <tr>
  31094. <td>
  31095. <code>metadata</code></br>
  31096. <em>
  31097. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31098. Kubernetes meta/v1.ObjectMeta
  31099. </a>
  31100. </em>
  31101. </td>
  31102. <td>
  31103. Refer to the Kubernetes API documentation for the fields of the
  31104. <code>metadata</code> field.
  31105. </td>
  31106. </tr>
  31107. <tr>
  31108. <td>
  31109. <code>spec</code></br>
  31110. <em>
  31111. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  31112. SSHKeySpec
  31113. </a>
  31114. </em>
  31115. </td>
  31116. <td>
  31117. <br/>
  31118. <br/>
  31119. <table>
  31120. <tr>
  31121. <td>
  31122. <code>keyType</code></br>
  31123. <em>
  31124. string
  31125. </em>
  31126. </td>
  31127. <td>
  31128. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  31129. </td>
  31130. </tr>
  31131. <tr>
  31132. <td>
  31133. <code>keySize</code></br>
  31134. <em>
  31135. int
  31136. </em>
  31137. </td>
  31138. <td>
  31139. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  31140. For RSA keys: 2048, 3072, 4096
  31141. For ECDSA keys: 256, 384, 521
  31142. Ignored for ed25519 keys</p>
  31143. </td>
  31144. </tr>
  31145. <tr>
  31146. <td>
  31147. <code>comment</code></br>
  31148. <em>
  31149. string
  31150. </em>
  31151. </td>
  31152. <td>
  31153. <p>Comment specifies an optional comment for the SSH key</p>
  31154. </td>
  31155. </tr>
  31156. </table>
  31157. </td>
  31158. </tr>
  31159. </tbody>
  31160. </table>
  31161. <h3 id="generators.external-secrets.io/v1alpha1.SSHKeySpec">SSHKeySpec
  31162. </h3>
  31163. <p>
  31164. (<em>Appears on:</em>
  31165. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31166. <a href="#generators.external-secrets.io/v1alpha1.SSHKey">SSHKey</a>)
  31167. </p>
  31168. <p>
  31169. <p>SSHKeySpec controls the behavior of the ssh key generator.</p>
  31170. </p>
  31171. <table>
  31172. <thead>
  31173. <tr>
  31174. <th>Field</th>
  31175. <th>Description</th>
  31176. </tr>
  31177. </thead>
  31178. <tbody>
  31179. <tr>
  31180. <td>
  31181. <code>keyType</code></br>
  31182. <em>
  31183. string
  31184. </em>
  31185. </td>
  31186. <td>
  31187. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  31188. </td>
  31189. </tr>
  31190. <tr>
  31191. <td>
  31192. <code>keySize</code></br>
  31193. <em>
  31194. int
  31195. </em>
  31196. </td>
  31197. <td>
  31198. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  31199. For RSA keys: 2048, 3072, 4096
  31200. For ECDSA keys: 256, 384, 521
  31201. Ignored for ed25519 keys</p>
  31202. </td>
  31203. </tr>
  31204. <tr>
  31205. <td>
  31206. <code>comment</code></br>
  31207. <em>
  31208. string
  31209. </em>
  31210. </td>
  31211. <td>
  31212. <p>Comment specifies an optional comment for the SSH key</p>
  31213. </td>
  31214. </tr>
  31215. </tbody>
  31216. </table>
  31217. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken
  31218. </h3>
  31219. <p>
  31220. <p>STSSessionToken uses the GetSessionToken API to retrieve an authorization token.
  31221. The authorization token is valid for 12 hours.
  31222. The authorizationToken returned is a base64 encoded string that can be decoded.
  31223. 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>
  31224. </p>
  31225. <table>
  31226. <thead>
  31227. <tr>
  31228. <th>Field</th>
  31229. <th>Description</th>
  31230. </tr>
  31231. </thead>
  31232. <tbody>
  31233. <tr>
  31234. <td>
  31235. <code>metadata</code></br>
  31236. <em>
  31237. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31238. Kubernetes meta/v1.ObjectMeta
  31239. </a>
  31240. </em>
  31241. </td>
  31242. <td>
  31243. Refer to the Kubernetes API documentation for the fields of the
  31244. <code>metadata</code> field.
  31245. </td>
  31246. </tr>
  31247. <tr>
  31248. <td>
  31249. <code>spec</code></br>
  31250. <em>
  31251. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  31252. STSSessionTokenSpec
  31253. </a>
  31254. </em>
  31255. </td>
  31256. <td>
  31257. <br/>
  31258. <br/>
  31259. <table>
  31260. <tr>
  31261. <td>
  31262. <code>region</code></br>
  31263. <em>
  31264. string
  31265. </em>
  31266. </td>
  31267. <td>
  31268. <p>Region specifies the region to operate in.</p>
  31269. </td>
  31270. </tr>
  31271. <tr>
  31272. <td>
  31273. <code>auth</code></br>
  31274. <em>
  31275. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  31276. AWSAuth
  31277. </a>
  31278. </em>
  31279. </td>
  31280. <td>
  31281. <em>(Optional)</em>
  31282. <p>Auth defines how to authenticate with AWS</p>
  31283. </td>
  31284. </tr>
  31285. <tr>
  31286. <td>
  31287. <code>role</code></br>
  31288. <em>
  31289. string
  31290. </em>
  31291. </td>
  31292. <td>
  31293. <em>(Optional)</em>
  31294. <p>You can assume a role before making calls to the
  31295. desired AWS service.</p>
  31296. </td>
  31297. </tr>
  31298. <tr>
  31299. <td>
  31300. <code>requestParameters</code></br>
  31301. <em>
  31302. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  31303. RequestParameters
  31304. </a>
  31305. </em>
  31306. </td>
  31307. <td>
  31308. <em>(Optional)</em>
  31309. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  31310. </td>
  31311. </tr>
  31312. </table>
  31313. </td>
  31314. </tr>
  31315. </tbody>
  31316. </table>
  31317. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec
  31318. </h3>
  31319. <p>
  31320. (<em>Appears on:</em>
  31321. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31322. <a href="#generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken</a>)
  31323. </p>
  31324. <p>
  31325. <p>STSSessionTokenSpec defines the desired state to generate an AWS STS session token.</p>
  31326. </p>
  31327. <table>
  31328. <thead>
  31329. <tr>
  31330. <th>Field</th>
  31331. <th>Description</th>
  31332. </tr>
  31333. </thead>
  31334. <tbody>
  31335. <tr>
  31336. <td>
  31337. <code>region</code></br>
  31338. <em>
  31339. string
  31340. </em>
  31341. </td>
  31342. <td>
  31343. <p>Region specifies the region to operate in.</p>
  31344. </td>
  31345. </tr>
  31346. <tr>
  31347. <td>
  31348. <code>auth</code></br>
  31349. <em>
  31350. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  31351. AWSAuth
  31352. </a>
  31353. </em>
  31354. </td>
  31355. <td>
  31356. <em>(Optional)</em>
  31357. <p>Auth defines how to authenticate with AWS</p>
  31358. </td>
  31359. </tr>
  31360. <tr>
  31361. <td>
  31362. <code>role</code></br>
  31363. <em>
  31364. string
  31365. </em>
  31366. </td>
  31367. <td>
  31368. <em>(Optional)</em>
  31369. <p>You can assume a role before making calls to the
  31370. desired AWS service.</p>
  31371. </td>
  31372. </tr>
  31373. <tr>
  31374. <td>
  31375. <code>requestParameters</code></br>
  31376. <em>
  31377. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  31378. RequestParameters
  31379. </a>
  31380. </em>
  31381. </td>
  31382. <td>
  31383. <em>(Optional)</em>
  31384. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  31385. </td>
  31386. </tr>
  31387. </tbody>
  31388. </table>
  31389. <h3 id="generators.external-secrets.io/v1alpha1.SecretKeySelector">SecretKeySelector
  31390. </h3>
  31391. <p>
  31392. (<em>Appears on:</em>
  31393. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>,
  31394. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth</a>,
  31395. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret</a>)
  31396. </p>
  31397. <p>
  31398. <p>SecretKeySelector defines a reference to a specific key within a Kubernetes Secret.</p>
  31399. </p>
  31400. <table>
  31401. <thead>
  31402. <tr>
  31403. <th>Field</th>
  31404. <th>Description</th>
  31405. </tr>
  31406. </thead>
  31407. <tbody>
  31408. <tr>
  31409. <td>
  31410. <code>name</code></br>
  31411. <em>
  31412. string
  31413. </em>
  31414. </td>
  31415. <td>
  31416. <p>The name of the Secret resource being referred to.</p>
  31417. </td>
  31418. </tr>
  31419. <tr>
  31420. <td>
  31421. <code>key</code></br>
  31422. <em>
  31423. string
  31424. </em>
  31425. </td>
  31426. <td>
  31427. <p>The key where the token is found.</p>
  31428. </td>
  31429. </tr>
  31430. </tbody>
  31431. </table>
  31432. <h3 id="generators.external-secrets.io/v1alpha1.StatefulResource">StatefulResource
  31433. </h3>
  31434. <p>
  31435. <p>StatefulResource represents a Kubernetes resource that has state which can be tracked.</p>
  31436. </p>
  31437. <h3 id="generators.external-secrets.io/v1alpha1.UUID">UUID
  31438. </h3>
  31439. <p>
  31440. <p>UUID generates a version 1 UUID (e56657e3-764f-11ef-a397-65231a88c216).</p>
  31441. </p>
  31442. <table>
  31443. <thead>
  31444. <tr>
  31445. <th>Field</th>
  31446. <th>Description</th>
  31447. </tr>
  31448. </thead>
  31449. <tbody>
  31450. <tr>
  31451. <td>
  31452. <code>metadata</code></br>
  31453. <em>
  31454. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31455. Kubernetes meta/v1.ObjectMeta
  31456. </a>
  31457. </em>
  31458. </td>
  31459. <td>
  31460. Refer to the Kubernetes API documentation for the fields of the
  31461. <code>metadata</code> field.
  31462. </td>
  31463. </tr>
  31464. <tr>
  31465. <td>
  31466. <code>spec</code></br>
  31467. <em>
  31468. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  31469. UUIDSpec
  31470. </a>
  31471. </em>
  31472. </td>
  31473. <td>
  31474. <br/>
  31475. <br/>
  31476. <table>
  31477. </table>
  31478. </td>
  31479. </tr>
  31480. </tbody>
  31481. </table>
  31482. <h3 id="generators.external-secrets.io/v1alpha1.UUIDSpec">UUIDSpec
  31483. </h3>
  31484. <p>
  31485. (<em>Appears on:</em>
  31486. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31487. <a href="#generators.external-secrets.io/v1alpha1.UUID">UUID</a>)
  31488. </p>
  31489. <p>
  31490. <p>UUIDSpec controls the behavior of the uuid generator.</p>
  31491. </p>
  31492. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret
  31493. </h3>
  31494. <p>
  31495. <p>VaultDynamicSecret represents a generator that can create dynamic secrets from HashiCorp Vault.</p>
  31496. </p>
  31497. <table>
  31498. <thead>
  31499. <tr>
  31500. <th>Field</th>
  31501. <th>Description</th>
  31502. </tr>
  31503. </thead>
  31504. <tbody>
  31505. <tr>
  31506. <td>
  31507. <code>metadata</code></br>
  31508. <em>
  31509. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31510. Kubernetes meta/v1.ObjectMeta
  31511. </a>
  31512. </em>
  31513. </td>
  31514. <td>
  31515. Refer to the Kubernetes API documentation for the fields of the
  31516. <code>metadata</code> field.
  31517. </td>
  31518. </tr>
  31519. <tr>
  31520. <td>
  31521. <code>spec</code></br>
  31522. <em>
  31523. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  31524. VaultDynamicSecretSpec
  31525. </a>
  31526. </em>
  31527. </td>
  31528. <td>
  31529. <br/>
  31530. <br/>
  31531. <table>
  31532. <tr>
  31533. <td>
  31534. <code>controller</code></br>
  31535. <em>
  31536. string
  31537. </em>
  31538. </td>
  31539. <td>
  31540. <em>(Optional)</em>
  31541. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  31542. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  31543. </td>
  31544. </tr>
  31545. <tr>
  31546. <td>
  31547. <code>method</code></br>
  31548. <em>
  31549. string
  31550. </em>
  31551. </td>
  31552. <td>
  31553. <p>Vault API method to use (GET/POST/other)</p>
  31554. </td>
  31555. </tr>
  31556. <tr>
  31557. <td>
  31558. <code>parameters</code></br>
  31559. <em>
  31560. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  31561. </em>
  31562. </td>
  31563. <td>
  31564. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  31565. </td>
  31566. </tr>
  31567. <tr>
  31568. <td>
  31569. <code>getParameters</code></br>
  31570. <em>
  31571. map[string][]string
  31572. </em>
  31573. </td>
  31574. <td>
  31575. <em>(Optional)</em>
  31576. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  31577. Each key may map to multiple values, matching HTTP query-string semantics.
  31578. Ignored for non-GET methods; use Parameters for write bodies.</p>
  31579. </td>
  31580. </tr>
  31581. <tr>
  31582. <td>
  31583. <code>resultType</code></br>
  31584. <em>
  31585. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  31586. VaultDynamicSecretResultType
  31587. </a>
  31588. </em>
  31589. </td>
  31590. <td>
  31591. <p>Result type defines which data is returned from the generator.
  31592. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  31593. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  31594. the &ldquo;auth&rdquo; section contains the generated token.
  31595. Please refer to the vault docs regarding the result data structure.
  31596. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  31597. </td>
  31598. </tr>
  31599. <tr>
  31600. <td>
  31601. <code>retrySettings</code></br>
  31602. <em>
  31603. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  31604. SecretStoreRetrySettings
  31605. </a>
  31606. </em>
  31607. </td>
  31608. <td>
  31609. <em>(Optional)</em>
  31610. <p>Used to configure http retries if failed</p>
  31611. </td>
  31612. </tr>
  31613. <tr>
  31614. <td>
  31615. <code>provider</code></br>
  31616. <em>
  31617. <a href="#external-secrets.io/v1.VaultProvider">
  31618. VaultProvider
  31619. </a>
  31620. </em>
  31621. </td>
  31622. <td>
  31623. <p>Vault provider common spec</p>
  31624. </td>
  31625. </tr>
  31626. <tr>
  31627. <td>
  31628. <code>path</code></br>
  31629. <em>
  31630. string
  31631. </em>
  31632. </td>
  31633. <td>
  31634. <p>Vault path to obtain the dynamic secret from</p>
  31635. </td>
  31636. </tr>
  31637. <tr>
  31638. <td>
  31639. <code>allowEmptyResponse</code></br>
  31640. <em>
  31641. bool
  31642. </em>
  31643. </td>
  31644. <td>
  31645. <em>(Optional)</em>
  31646. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  31647. </td>
  31648. </tr>
  31649. </table>
  31650. </td>
  31651. </tr>
  31652. </tbody>
  31653. </table>
  31654. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">VaultDynamicSecretResultType
  31655. (<code>string</code> alias)</p></h3>
  31656. <p>
  31657. (<em>Appears on:</em>
  31658. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  31659. </p>
  31660. <p>
  31661. <p>VaultDynamicSecretResultType defines which part of the Vault API response should be returned.</p>
  31662. </p>
  31663. <table>
  31664. <thead>
  31665. <tr>
  31666. <th>Value</th>
  31667. <th>Description</th>
  31668. </tr>
  31669. </thead>
  31670. <tbody><tr><td><p>&#34;Auth&#34;</p></td>
  31671. <td><p>VaultDynamicSecretResultTypeAuth specifies to return the &ldquo;auth&rdquo; section of the Vault API response.</p>
  31672. </td>
  31673. </tr><tr><td><p>&#34;Data&#34;</p></td>
  31674. <td><p>VaultDynamicSecretResultTypeData specifies to return the &ldquo;data&rdquo; section of the Vault API response.</p>
  31675. </td>
  31676. </tr><tr><td><p>&#34;Raw&#34;</p></td>
  31677. <td><p>VaultDynamicSecretResultTypeRaw specifies to return the raw response from the Vault API.</p>
  31678. </td>
  31679. </tr></tbody>
  31680. </table>
  31681. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec
  31682. </h3>
  31683. <p>
  31684. (<em>Appears on:</em>
  31685. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31686. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret</a>)
  31687. </p>
  31688. <p>
  31689. <p>VaultDynamicSecretSpec defines the desired spec of VaultDynamicSecret.</p>
  31690. </p>
  31691. <table>
  31692. <thead>
  31693. <tr>
  31694. <th>Field</th>
  31695. <th>Description</th>
  31696. </tr>
  31697. </thead>
  31698. <tbody>
  31699. <tr>
  31700. <td>
  31701. <code>controller</code></br>
  31702. <em>
  31703. string
  31704. </em>
  31705. </td>
  31706. <td>
  31707. <em>(Optional)</em>
  31708. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  31709. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  31710. </td>
  31711. </tr>
  31712. <tr>
  31713. <td>
  31714. <code>method</code></br>
  31715. <em>
  31716. string
  31717. </em>
  31718. </td>
  31719. <td>
  31720. <p>Vault API method to use (GET/POST/other)</p>
  31721. </td>
  31722. </tr>
  31723. <tr>
  31724. <td>
  31725. <code>parameters</code></br>
  31726. <em>
  31727. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  31728. </em>
  31729. </td>
  31730. <td>
  31731. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  31732. </td>
  31733. </tr>
  31734. <tr>
  31735. <td>
  31736. <code>getParameters</code></br>
  31737. <em>
  31738. map[string][]string
  31739. </em>
  31740. </td>
  31741. <td>
  31742. <em>(Optional)</em>
  31743. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  31744. Each key may map to multiple values, matching HTTP query-string semantics.
  31745. Ignored for non-GET methods; use Parameters for write bodies.</p>
  31746. </td>
  31747. </tr>
  31748. <tr>
  31749. <td>
  31750. <code>resultType</code></br>
  31751. <em>
  31752. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  31753. VaultDynamicSecretResultType
  31754. </a>
  31755. </em>
  31756. </td>
  31757. <td>
  31758. <p>Result type defines which data is returned from the generator.
  31759. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  31760. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  31761. the &ldquo;auth&rdquo; section contains the generated token.
  31762. Please refer to the vault docs regarding the result data structure.
  31763. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  31764. </td>
  31765. </tr>
  31766. <tr>
  31767. <td>
  31768. <code>retrySettings</code></br>
  31769. <em>
  31770. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  31771. SecretStoreRetrySettings
  31772. </a>
  31773. </em>
  31774. </td>
  31775. <td>
  31776. <em>(Optional)</em>
  31777. <p>Used to configure http retries if failed</p>
  31778. </td>
  31779. </tr>
  31780. <tr>
  31781. <td>
  31782. <code>provider</code></br>
  31783. <em>
  31784. <a href="#external-secrets.io/v1.VaultProvider">
  31785. VaultProvider
  31786. </a>
  31787. </em>
  31788. </td>
  31789. <td>
  31790. <p>Vault provider common spec</p>
  31791. </td>
  31792. </tr>
  31793. <tr>
  31794. <td>
  31795. <code>path</code></br>
  31796. <em>
  31797. string
  31798. </em>
  31799. </td>
  31800. <td>
  31801. <p>Vault path to obtain the dynamic secret from</p>
  31802. </td>
  31803. </tr>
  31804. <tr>
  31805. <td>
  31806. <code>allowEmptyResponse</code></br>
  31807. <em>
  31808. bool
  31809. </em>
  31810. </td>
  31811. <td>
  31812. <em>(Optional)</em>
  31813. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  31814. </td>
  31815. </tr>
  31816. </tbody>
  31817. </table>
  31818. <h3 id="generators.external-secrets.io/v1alpha1.Webhook">Webhook
  31819. </h3>
  31820. <p>
  31821. <p>Webhook connects to a third party API server to handle the secrets generation
  31822. configuration parameters in spec.
  31823. You can specify the server, the token, and additional body parameters.
  31824. See documentation for the full API specification for requests and responses.</p>
  31825. </p>
  31826. <table>
  31827. <thead>
  31828. <tr>
  31829. <th>Field</th>
  31830. <th>Description</th>
  31831. </tr>
  31832. </thead>
  31833. <tbody>
  31834. <tr>
  31835. <td>
  31836. <code>metadata</code></br>
  31837. <em>
  31838. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31839. Kubernetes meta/v1.ObjectMeta
  31840. </a>
  31841. </em>
  31842. </td>
  31843. <td>
  31844. Refer to the Kubernetes API documentation for the fields of the
  31845. <code>metadata</code> field.
  31846. </td>
  31847. </tr>
  31848. <tr>
  31849. <td>
  31850. <code>spec</code></br>
  31851. <em>
  31852. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  31853. WebhookSpec
  31854. </a>
  31855. </em>
  31856. </td>
  31857. <td>
  31858. <br/>
  31859. <br/>
  31860. <table>
  31861. <tr>
  31862. <td>
  31863. <code>method</code></br>
  31864. <em>
  31865. string
  31866. </em>
  31867. </td>
  31868. <td>
  31869. <p>Webhook Method</p>
  31870. </td>
  31871. </tr>
  31872. <tr>
  31873. <td>
  31874. <code>url</code></br>
  31875. <em>
  31876. string
  31877. </em>
  31878. </td>
  31879. <td>
  31880. <p>Webhook url to call</p>
  31881. </td>
  31882. </tr>
  31883. <tr>
  31884. <td>
  31885. <code>headers</code></br>
  31886. <em>
  31887. map[string]string
  31888. </em>
  31889. </td>
  31890. <td>
  31891. <em>(Optional)</em>
  31892. <p>Headers</p>
  31893. </td>
  31894. </tr>
  31895. <tr>
  31896. <td>
  31897. <code>auth</code></br>
  31898. <em>
  31899. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  31900. AuthorizationProtocol
  31901. </a>
  31902. </em>
  31903. </td>
  31904. <td>
  31905. <em>(Optional)</em>
  31906. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  31907. </td>
  31908. </tr>
  31909. <tr>
  31910. <td>
  31911. <code>body</code></br>
  31912. <em>
  31913. string
  31914. </em>
  31915. </td>
  31916. <td>
  31917. <em>(Optional)</em>
  31918. <p>Body</p>
  31919. </td>
  31920. </tr>
  31921. <tr>
  31922. <td>
  31923. <code>timeout</code></br>
  31924. <em>
  31925. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  31926. Kubernetes meta/v1.Duration
  31927. </a>
  31928. </em>
  31929. </td>
  31930. <td>
  31931. <em>(Optional)</em>
  31932. <p>Timeout</p>
  31933. </td>
  31934. </tr>
  31935. <tr>
  31936. <td>
  31937. <code>result</code></br>
  31938. <em>
  31939. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  31940. WebhookResult
  31941. </a>
  31942. </em>
  31943. </td>
  31944. <td>
  31945. <p>Result formatting</p>
  31946. </td>
  31947. </tr>
  31948. <tr>
  31949. <td>
  31950. <code>secrets</code></br>
  31951. <em>
  31952. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  31953. []WebhookSecret
  31954. </a>
  31955. </em>
  31956. </td>
  31957. <td>
  31958. <em>(Optional)</em>
  31959. <p>Secrets to fill in templates
  31960. These secrets will be passed to the templating function as key value pairs under the given name</p>
  31961. </td>
  31962. </tr>
  31963. <tr>
  31964. <td>
  31965. <code>caBundle</code></br>
  31966. <em>
  31967. []byte
  31968. </em>
  31969. </td>
  31970. <td>
  31971. <em>(Optional)</em>
  31972. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  31973. if the Server URL is using HTTPS protocol. This parameter is ignored for
  31974. plain HTTP protocol connection. If not set the system root certificates
  31975. are used to validate the TLS connection.</p>
  31976. </td>
  31977. </tr>
  31978. <tr>
  31979. <td>
  31980. <code>caProvider</code></br>
  31981. <em>
  31982. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  31983. WebhookCAProvider
  31984. </a>
  31985. </em>
  31986. </td>
  31987. <td>
  31988. <em>(Optional)</em>
  31989. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  31990. </td>
  31991. </tr>
  31992. </table>
  31993. </td>
  31994. </tr>
  31995. </tbody>
  31996. </table>
  31997. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider
  31998. </h3>
  31999. <p>
  32000. (<em>Appears on:</em>
  32001. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  32002. </p>
  32003. <p>
  32004. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  32005. </p>
  32006. <table>
  32007. <thead>
  32008. <tr>
  32009. <th>Field</th>
  32010. <th>Description</th>
  32011. </tr>
  32012. </thead>
  32013. <tbody>
  32014. <tr>
  32015. <td>
  32016. <code>type</code></br>
  32017. <em>
  32018. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProviderType">
  32019. WebhookCAProviderType
  32020. </a>
  32021. </em>
  32022. </td>
  32023. <td>
  32024. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  32025. </td>
  32026. </tr>
  32027. <tr>
  32028. <td>
  32029. <code>name</code></br>
  32030. <em>
  32031. string
  32032. </em>
  32033. </td>
  32034. <td>
  32035. <p>The name of the object located at the provider type.</p>
  32036. </td>
  32037. </tr>
  32038. <tr>
  32039. <td>
  32040. <code>key</code></br>
  32041. <em>
  32042. string
  32043. </em>
  32044. </td>
  32045. <td>
  32046. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  32047. </td>
  32048. </tr>
  32049. <tr>
  32050. <td>
  32051. <code>namespace</code></br>
  32052. <em>
  32053. string
  32054. </em>
  32055. </td>
  32056. <td>
  32057. <em>(Optional)</em>
  32058. <p>The namespace the Provider type is in.</p>
  32059. </td>
  32060. </tr>
  32061. </tbody>
  32062. </table>
  32063. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProviderType">WebhookCAProviderType
  32064. (<code>string</code> alias)</p></h3>
  32065. <p>
  32066. (<em>Appears on:</em>
  32067. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider</a>)
  32068. </p>
  32069. <p>
  32070. <p>WebhookCAProviderType defines the type of provider for webhook CA certificates.</p>
  32071. </p>
  32072. <table>
  32073. <thead>
  32074. <tr>
  32075. <th>Value</th>
  32076. <th>Description</th>
  32077. </tr>
  32078. </thead>
  32079. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  32080. <td><p>WebhookCAProviderTypeConfigMap indicates the CA provider is a ConfigMap resource.</p>
  32081. </td>
  32082. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  32083. <td><p>WebhookCAProviderTypeSecret indicates the CA provider is a Secret resource.</p>
  32084. </td>
  32085. </tr></tbody>
  32086. </table>
  32087. <h3 id="generators.external-secrets.io/v1alpha1.WebhookResult">WebhookResult
  32088. </h3>
  32089. <p>
  32090. (<em>Appears on:</em>
  32091. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  32092. </p>
  32093. <p>
  32094. <p>WebhookResult defines how to format and extract results from the webhook response.</p>
  32095. </p>
  32096. <table>
  32097. <thead>
  32098. <tr>
  32099. <th>Field</th>
  32100. <th>Description</th>
  32101. </tr>
  32102. </thead>
  32103. <tbody>
  32104. <tr>
  32105. <td>
  32106. <code>jsonPath</code></br>
  32107. <em>
  32108. string
  32109. </em>
  32110. </td>
  32111. <td>
  32112. <em>(Optional)</em>
  32113. <p>Json path of return value</p>
  32114. </td>
  32115. </tr>
  32116. </tbody>
  32117. </table>
  32118. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret
  32119. </h3>
  32120. <p>
  32121. (<em>Appears on:</em>
  32122. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  32123. </p>
  32124. <p>
  32125. <p>WebhookSecret defines a secret reference that will be used in webhook templates.</p>
  32126. </p>
  32127. <table>
  32128. <thead>
  32129. <tr>
  32130. <th>Field</th>
  32131. <th>Description</th>
  32132. </tr>
  32133. </thead>
  32134. <tbody>
  32135. <tr>
  32136. <td>
  32137. <code>name</code></br>
  32138. <em>
  32139. string
  32140. </em>
  32141. </td>
  32142. <td>
  32143. <p>Name of this secret in templates</p>
  32144. </td>
  32145. </tr>
  32146. <tr>
  32147. <td>
  32148. <code>secretRef</code></br>
  32149. <em>
  32150. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  32151. SecretKeySelector
  32152. </a>
  32153. </em>
  32154. </td>
  32155. <td>
  32156. <p>Secret ref to fill in credentials</p>
  32157. </td>
  32158. </tr>
  32159. </tbody>
  32160. </table>
  32161. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec
  32162. </h3>
  32163. <p>
  32164. (<em>Appears on:</em>
  32165. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  32166. <a href="#generators.external-secrets.io/v1alpha1.Webhook">Webhook</a>)
  32167. </p>
  32168. <p>
  32169. <p>WebhookSpec controls the behavior of the external generator. Any body parameters should be passed to the server through the parameters field.</p>
  32170. </p>
  32171. <table>
  32172. <thead>
  32173. <tr>
  32174. <th>Field</th>
  32175. <th>Description</th>
  32176. </tr>
  32177. </thead>
  32178. <tbody>
  32179. <tr>
  32180. <td>
  32181. <code>method</code></br>
  32182. <em>
  32183. string
  32184. </em>
  32185. </td>
  32186. <td>
  32187. <p>Webhook Method</p>
  32188. </td>
  32189. </tr>
  32190. <tr>
  32191. <td>
  32192. <code>url</code></br>
  32193. <em>
  32194. string
  32195. </em>
  32196. </td>
  32197. <td>
  32198. <p>Webhook url to call</p>
  32199. </td>
  32200. </tr>
  32201. <tr>
  32202. <td>
  32203. <code>headers</code></br>
  32204. <em>
  32205. map[string]string
  32206. </em>
  32207. </td>
  32208. <td>
  32209. <em>(Optional)</em>
  32210. <p>Headers</p>
  32211. </td>
  32212. </tr>
  32213. <tr>
  32214. <td>
  32215. <code>auth</code></br>
  32216. <em>
  32217. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  32218. AuthorizationProtocol
  32219. </a>
  32220. </em>
  32221. </td>
  32222. <td>
  32223. <em>(Optional)</em>
  32224. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  32225. </td>
  32226. </tr>
  32227. <tr>
  32228. <td>
  32229. <code>body</code></br>
  32230. <em>
  32231. string
  32232. </em>
  32233. </td>
  32234. <td>
  32235. <em>(Optional)</em>
  32236. <p>Body</p>
  32237. </td>
  32238. </tr>
  32239. <tr>
  32240. <td>
  32241. <code>timeout</code></br>
  32242. <em>
  32243. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  32244. Kubernetes meta/v1.Duration
  32245. </a>
  32246. </em>
  32247. </td>
  32248. <td>
  32249. <em>(Optional)</em>
  32250. <p>Timeout</p>
  32251. </td>
  32252. </tr>
  32253. <tr>
  32254. <td>
  32255. <code>result</code></br>
  32256. <em>
  32257. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  32258. WebhookResult
  32259. </a>
  32260. </em>
  32261. </td>
  32262. <td>
  32263. <p>Result formatting</p>
  32264. </td>
  32265. </tr>
  32266. <tr>
  32267. <td>
  32268. <code>secrets</code></br>
  32269. <em>
  32270. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  32271. []WebhookSecret
  32272. </a>
  32273. </em>
  32274. </td>
  32275. <td>
  32276. <em>(Optional)</em>
  32277. <p>Secrets to fill in templates
  32278. These secrets will be passed to the templating function as key value pairs under the given name</p>
  32279. </td>
  32280. </tr>
  32281. <tr>
  32282. <td>
  32283. <code>caBundle</code></br>
  32284. <em>
  32285. []byte
  32286. </em>
  32287. </td>
  32288. <td>
  32289. <em>(Optional)</em>
  32290. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  32291. if the Server URL is using HTTPS protocol. This parameter is ignored for
  32292. plain HTTP protocol connection. If not set the system root certificates
  32293. are used to validate the TLS connection.</p>
  32294. </td>
  32295. </tr>
  32296. <tr>
  32297. <td>
  32298. <code>caProvider</code></br>
  32299. <em>
  32300. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  32301. WebhookCAProvider
  32302. </a>
  32303. </em>
  32304. </td>
  32305. <td>
  32306. <em>(Optional)</em>
  32307. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  32308. </td>
  32309. </tr>
  32310. </tbody>
  32311. </table>
  32312. <hr/>
  32313. <p><em>
  32314. Generated with <code>gen-crd-api-reference-docs</code>.
  32315. </em></p>
  32316. </article>
  32317. </div>
  32318. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  32319. </div>
  32320. </main>
  32321. <img referrerpolicy="no-referrer-when-downgrade"
  32322. src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""
  32323. hidden />
  32324. <footer class="md-footer">
  32325. <div class="md-footer-meta md-typeset">
  32326. <div class="md-footer-meta__inner md-grid">
  32327. <div class="md-copyright">
  32328. <div class="md-copyright__highlight">
  32329. &copy; 2025 The external-secrets Authors.<br/>
  32330. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  32331. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  32332. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  32333. </div>
  32334. Made with
  32335. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  32336. Material for MkDocs
  32337. </a>
  32338. </div>
  32339. </div>
  32340. </div>
  32341. </footer>
  32342. </div>
  32343. <div class="md-dialog" data-md-component="dialog">
  32344. <div class="md-dialog__inner md-typeset"></div>
  32345. </div>
  32346. <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>
  32347. <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
  32348. </body>
  32349. </html>