index.html 691 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511185121851318514185151851618517185181851918520185211852218523185241852518526185271852818529185301853118532185331853418535185361853718538185391854018541185421854318544185451854618547185481854918550185511855218553185541855518556185571855818559185601856118562185631856418565185661856718568185691857018571185721857318574185751857618577185781857918580185811858218583185841858518586185871858818589185901859118592185931859418595185961859718598185991860018601186021860318604186051860618607186081860918610186111861218613186141861518616186171861818619186201862118622186231862418625186261862718628186291863018631186321863318634186351863618637186381863918640186411864218643186441864518646186471864818649186501865118652186531865418655186561865718658186591866018661186621866318664186651866618667186681866918670186711867218673186741867518676186771867818679186801868118682186831868418685186861868718688186891869018691186921869318694186951869618697186981869918700187011870218703187041870518706187071870818709187101871118712187131871418715187161871718718187191872018721187221872318724187251872618727187281872918730187311873218733187341873518736187371873818739187401874118742187431874418745187461874718748187491875018751187521875318754187551875618757187581875918760187611876218763187641876518766187671876818769187701877118772187731877418775187761877718778187791878018781187821878318784187851878618787187881878918790187911879218793187941879518796187971879818799188001880118802188031880418805188061880718808188091881018811188121881318814188151881618817188181881918820188211882218823188241882518826188271882818829188301883118832188331883418835188361883718838188391884018841188421884318844188451884618847188481884918850188511885218853188541885518856188571885818859188601886118862188631886418865188661886718868188691887018871188721887318874188751887618877188781887918880188811888218883188841888518886188871888818889188901889118892188931889418895188961889718898188991890018901189021890318904189051890618907189081890918910189111891218913189141891518916189171891818919189201892118922189231892418925189261892718928189291893018931189321893318934189351893618937189381893918940189411894218943189441894518946189471894818949189501895118952189531895418955189561895718958189591896018961189621896318964189651896618967189681896918970189711897218973189741897518976189771897818979189801898118982189831898418985189861898718988189891899018991189921899318994189951899618997189981899919000190011900219003190041900519006190071900819009190101901119012190131901419015190161901719018190191902019021190221902319024190251902619027190281902919030190311903219033190341903519036190371903819039190401904119042190431904419045190461904719048190491905019051190521905319054190551905619057190581905919060190611906219063190641906519066190671906819069190701907119072190731907419075190761907719078190791908019081190821908319084190851908619087190881908919090190911909219093190941909519096190971909819099191001910119102191031910419105191061910719108191091911019111191121911319114191151911619117191181911919120191211912219123191241912519126191271912819129191301913119132191331913419135191361913719138191391914019141191421914319144191451914619147191481914919150191511915219153191541915519156191571915819159191601916119162191631916419165191661916719168191691917019171191721917319174191751917619177191781917919180191811918219183191841918519186191871918819189191901919119192191931919419195191961919719198191991920019201192021920319204192051920619207192081920919210192111921219213192141921519216192171921819219192201922119222192231922419225192261922719228192291923019231192321923319234192351923619237192381923919240192411924219243192441924519246192471924819249192501925119252192531925419255192561925719258192591926019261192621926319264192651926619267192681926919270192711927219273192741927519276192771927819279192801928119282192831928419285192861928719288192891929019291192921929319294192951929619297192981929919300193011930219303193041930519306193071930819309193101931119312193131931419315193161931719318193191932019321193221932319324193251932619327193281932919330193311933219333193341933519336193371933819339193401934119342193431934419345193461934719348193491935019351193521935319354193551935619357193581935919360193611936219363193641936519366193671936819369193701937119372193731937419375193761937719378193791938019381193821938319384193851938619387193881938919390193911939219393193941939519396193971939819399194001940119402194031940419405194061940719408194091941019411194121941319414194151941619417194181941919420194211942219423194241942519426194271942819429194301943119432194331943419435194361943719438194391944019441194421944319444194451944619447194481944919450194511945219453194541945519456194571945819459194601946119462194631946419465194661946719468194691947019471194721947319474194751947619477194781947919480194811948219483194841948519486194871948819489194901949119492194931949419495194961949719498194991950019501195021950319504195051950619507195081950919510195111951219513195141951519516195171951819519195201952119522195231952419525195261952719528195291953019531195321953319534195351953619537195381953919540195411954219543195441954519546195471954819549195501955119552195531955419555195561955719558195591956019561195621956319564195651956619567195681956919570195711957219573195741957519576195771957819579195801958119582195831958419585195861958719588195891959019591195921959319594195951959619597195981959919600196011960219603196041960519606196071960819609196101961119612196131961419615196161961719618196191962019621196221962319624196251962619627196281962919630196311963219633196341963519636196371963819639196401964119642196431964419645196461964719648196491965019651196521965319654196551965619657196581965919660196611966219663196641966519666196671966819669196701967119672196731967419675196761967719678196791968019681196821968319684196851968619687196881968919690196911969219693196941969519696196971969819699197001970119702197031970419705197061970719708197091971019711197121971319714197151971619717197181971919720197211972219723197241972519726197271972819729197301973119732197331973419735197361973719738197391974019741197421974319744197451974619747197481974919750197511975219753197541975519756197571975819759197601976119762197631976419765197661976719768197691977019771197721977319774197751977619777197781977919780197811978219783197841978519786197871978819789197901979119792197931979419795197961979719798197991980019801198021980319804198051980619807198081980919810198111981219813198141981519816198171981819819198201982119822198231982419825198261982719828198291983019831198321983319834198351983619837198381983919840198411984219843198441984519846198471984819849198501985119852198531985419855198561985719858198591986019861198621986319864198651986619867198681986919870198711987219873198741987519876198771987819879198801988119882198831988419885198861988719888198891989019891198921989319894198951989619897198981989919900199011990219903199041990519906199071990819909199101991119912199131991419915199161991719918199191992019921199221992319924199251992619927199281992919930199311993219933199341993519936199371993819939199401994119942199431994419945199461994719948199491995019951199521995319954199551995619957199581995919960199611996219963199641996519966199671996819969199701997119972199731997419975199761997719978199791998019981199821998319984199851998619987199881998919990199911999219993199941999519996199971999819999200002000120002200032000420005200062000720008200092001020011200122001320014200152001620017200182001920020200212002220023200242002520026200272002820029200302003120032200332003420035200362003720038200392004020041200422004320044200452004620047200482004920050200512005220053200542005520056200572005820059200602006120062200632006420065200662006720068200692007020071200722007320074200752007620077200782007920080200812008220083200842008520086200872008820089200902009120092200932009420095200962009720098200992010020101201022010320104201052010620107201082010920110201112011220113201142011520116201172011820119201202012120122201232012420125201262012720128201292013020131201322013320134201352013620137201382013920140201412014220143201442014520146201472014820149201502015120152201532015420155201562015720158201592016020161201622016320164201652016620167201682016920170201712017220173201742017520176201772017820179201802018120182201832018420185201862018720188201892019020191201922019320194201952019620197201982019920200202012020220203202042020520206202072020820209202102021120212202132021420215202162021720218202192022020221202222022320224202252022620227202282022920230202312023220233202342023520236202372023820239202402024120242202432024420245202462024720248202492025020251202522025320254202552025620257202582025920260202612026220263202642026520266202672026820269202702027120272202732027420275202762027720278202792028020281202822028320284202852028620287202882028920290202912029220293202942029520296202972029820299203002030120302203032030420305203062030720308203092031020311203122031320314203152031620317203182031920320203212032220323203242032520326203272032820329203302033120332203332033420335203362033720338203392034020341203422034320344203452034620347203482034920350203512035220353203542035520356203572035820359203602036120362203632036420365203662036720368203692037020371203722037320374203752037620377203782037920380203812038220383203842038520386203872038820389203902039120392203932039420395203962039720398203992040020401204022040320404204052040620407204082040920410204112041220413204142041520416204172041820419204202042120422204232042420425204262042720428204292043020431204322043320434204352043620437204382043920440204412044220443204442044520446204472044820449204502045120452204532045420455204562045720458204592046020461204622046320464204652046620467204682046920470204712047220473204742047520476204772047820479204802048120482204832048420485204862048720488204892049020491204922049320494204952049620497204982049920500205012050220503205042050520506205072050820509205102051120512205132051420515205162051720518205192052020521205222052320524205252052620527205282052920530205312053220533205342053520536205372053820539205402054120542205432054420545205462054720548205492055020551205522055320554205552055620557205582055920560205612056220563205642056520566205672056820569205702057120572205732057420575205762057720578205792058020581205822058320584205852058620587205882058920590205912059220593205942059520596205972059820599206002060120602206032060420605206062060720608206092061020611206122061320614206152061620617206182061920620206212062220623206242062520626206272062820629206302063120632206332063420635206362063720638206392064020641206422064320644206452064620647206482064920650206512065220653206542065520656206572065820659206602066120662206632066420665206662066720668206692067020671206722067320674206752067620677206782067920680206812068220683206842068520686206872068820689206902069120692206932069420695206962069720698206992070020701207022070320704207052070620707207082070920710207112071220713207142071520716207172071820719207202072120722207232072420725207262072720728207292073020731207322073320734207352073620737207382073920740207412074220743207442074520746207472074820749207502075120752207532075420755207562075720758207592076020761207622076320764207652076620767207682076920770207712077220773207742077520776207772077820779207802078120782207832078420785207862078720788207892079020791207922079320794207952079620797207982079920800208012080220803208042080520806208072080820809208102081120812208132081420815208162081720818208192082020821208222082320824208252082620827208282082920830208312083220833208342083520836208372083820839208402084120842208432084420845208462084720848208492085020851208522085320854208552085620857208582085920860208612086220863208642086520866208672086820869208702087120872208732087420875208762087720878208792088020881208822088320884208852088620887208882088920890208912089220893208942089520896208972089820899209002090120902209032090420905209062090720908209092091020911209122091320914209152091620917209182091920920209212092220923209242092520926209272092820929209302093120932209332093420935209362093720938209392094020941209422094320944209452094620947209482094920950209512095220953209542095520956209572095820959209602096120962209632096420965209662096720968209692097020971209722097320974209752097620977209782097920980209812098220983209842098520986209872098820989209902099120992209932099420995209962099720998209992100021001210022100321004210052100621007210082100921010210112101221013210142101521016210172101821019210202102121022210232102421025210262102721028210292103021031210322103321034210352103621037210382103921040210412104221043210442104521046210472104821049210502105121052210532105421055210562105721058210592106021061210622106321064210652106621067210682106921070210712107221073210742107521076210772107821079210802108121082210832108421085210862108721088210892109021091210922109321094210952109621097210982109921100211012110221103211042110521106211072110821109211102111121112211132111421115211162111721118211192112021121211222112321124211252112621127211282112921130211312113221133211342113521136211372113821139211402114121142211432114421145211462114721148211492115021151211522115321154211552115621157211582115921160211612116221163211642116521166211672116821169211702117121172211732117421175211762117721178211792118021181211822118321184211852118621187211882118921190211912119221193211942119521196211972119821199212002120121202212032120421205212062120721208212092121021211212122121321214212152121621217212182121921220212212122221223212242122521226212272122821229212302123121232212332123421235212362123721238212392124021241212422124321244212452124621247212482124921250212512125221253212542125521256212572125821259212602126121262212632126421265212662126721268212692127021271212722127321274212752127621277212782127921280212812128221283212842128521286212872128821289212902129121292212932129421295212962129721298212992130021301213022130321304213052130621307213082130921310213112131221313213142131521316213172131821319213202132121322213232132421325213262132721328213292133021331213322133321334213352133621337213382133921340213412134221343213442134521346213472134821349213502135121352213532135421355213562135721358213592136021361213622136321364213652136621367213682136921370213712137221373213742137521376213772137821379213802138121382213832138421385213862138721388213892139021391213922139321394213952139621397213982139921400214012140221403214042140521406214072140821409214102141121412214132141421415214162141721418214192142021421214222142321424214252142621427214282142921430214312143221433214342143521436214372143821439214402144121442214432144421445214462144721448214492145021451214522145321454214552145621457214582145921460214612146221463214642146521466214672146821469214702147121472214732147421475214762147721478214792148021481214822148321484214852148621487214882148921490214912149221493214942149521496214972149821499215002150121502215032150421505215062150721508215092151021511215122151321514215152151621517215182151921520215212152221523215242152521526215272152821529215302153121532215332153421535215362153721538215392154021541215422154321544215452154621547215482154921550215512155221553215542155521556215572155821559215602156121562215632156421565215662156721568215692157021571215722157321574215752157621577215782157921580215812158221583215842158521586215872158821589215902159121592215932159421595215962159721598215992160021601216022160321604216052160621607216082160921610216112161221613216142161521616216172161821619216202162121622216232162421625216262162721628216292163021631216322163321634216352163621637216382163921640216412164221643216442164521646216472164821649216502165121652216532165421655216562165721658216592166021661216622166321664216652166621667216682166921670216712167221673216742167521676216772167821679216802168121682216832168421685216862168721688216892169021691216922169321694216952169621697216982169921700217012170221703217042170521706217072170821709217102171121712217132171421715217162171721718217192172021721217222172321724217252172621727217282172921730217312173221733217342173521736217372173821739217402174121742217432174421745217462174721748217492175021751217522175321754217552175621757217582175921760217612176221763217642176521766217672176821769217702177121772217732177421775217762177721778217792178021781217822178321784217852178621787217882178921790217912179221793217942179521796217972179821799218002180121802218032180421805218062180721808218092181021811218122181321814218152181621817218182181921820218212182221823218242182521826218272182821829218302183121832218332183421835218362183721838218392184021841218422184321844218452184621847218482184921850218512185221853218542185521856218572185821859218602186121862218632186421865218662186721868218692187021871218722187321874218752187621877218782187921880218812188221883218842188521886218872188821889218902189121892218932189421895218962189721898218992190021901219022190321904219052190621907219082190921910219112191221913219142191521916219172191821919219202192121922219232192421925219262192721928219292193021931219322193321934219352193621937219382193921940219412194221943219442194521946219472194821949219502195121952219532195421955219562195721958219592196021961219622196321964219652196621967219682196921970219712197221973219742197521976219772197821979219802198121982219832198421985219862198721988219892199021991219922199321994219952199621997219982199922000220012200222003220042200522006220072200822009220102201122012220132201422015220162201722018220192202022021220222202322024220252202622027220282202922030220312203222033220342203522036220372203822039220402204122042220432204422045220462204722048220492205022051220522205322054220552205622057220582205922060220612206222063220642206522066220672206822069220702207122072220732207422075220762207722078220792208022081220822208322084220852208622087220882208922090220912209222093220942209522096220972209822099221002210122102221032210422105221062210722108221092211022111221122211322114221152211622117221182211922120221212212222123221242212522126221272212822129221302213122132221332213422135221362213722138221392214022141221422214322144221452214622147221482214922150221512215222153221542215522156221572215822159221602216122162221632216422165221662216722168221692217022171221722217322174221752217622177221782217922180221812218222183221842218522186221872218822189221902219122192221932219422195221962219722198221992220022201222022220322204222052220622207222082220922210222112221222213222142221522216222172221822219222202222122222222232222422225222262222722228222292223022231222322223322234222352223622237222382223922240222412224222243222442224522246222472224822249222502225122252222532225422255222562225722258222592226022261222622226322264222652226622267222682226922270222712227222273222742227522276222772227822279222802228122282222832228422285222862228722288222892229022291222922229322294222952229622297222982229922300223012230222303223042230522306223072230822309223102231122312223132231422315223162231722318223192232022321223222232322324223252232622327223282232922330223312233222333223342233522336223372233822339223402234122342223432234422345223462234722348223492235022351223522235322354223552235622357223582235922360223612236222363223642236522366223672236822369223702237122372223732237422375223762237722378223792238022381223822238322384223852238622387223882238922390223912239222393223942239522396223972239822399224002240122402224032240422405224062240722408224092241022411224122241322414224152241622417224182241922420224212242222423224242242522426224272242822429224302243122432224332243422435224362243722438224392244022441224422244322444224452244622447224482244922450224512245222453224542245522456224572245822459224602246122462224632246422465224662246722468224692247022471224722247322474224752247622477224782247922480224812248222483224842248522486224872248822489224902249122492224932249422495224962249722498224992250022501225022250322504225052250622507225082250922510225112251222513225142251522516225172251822519225202252122522225232252422525225262252722528225292253022531225322253322534225352253622537225382253922540225412254222543225442254522546225472254822549225502255122552225532255422555225562255722558225592256022561225622256322564225652256622567225682256922570225712257222573225742257522576225772257822579225802258122582225832258422585225862258722588225892259022591225922259322594225952259622597225982259922600226012260222603226042260522606226072260822609226102261122612226132261422615226162261722618226192262022621226222262322624226252262622627226282262922630226312263222633226342263522636226372263822639226402264122642226432264422645226462264722648226492265022651226522265322654226552265622657226582265922660226612266222663226642266522666226672266822669226702267122672226732267422675226762267722678226792268022681226822268322684226852268622687226882268922690226912269222693226942269522696226972269822699227002270122702227032270422705227062270722708227092271022711227122271322714227152271622717227182271922720227212272222723227242272522726227272272822729227302273122732227332273422735227362273722738227392274022741227422274322744227452274622747227482274922750227512275222753227542275522756227572275822759227602276122762227632276422765227662276722768227692277022771227722277322774227752277622777227782277922780227812278222783227842278522786227872278822789227902279122792227932279422795227962279722798227992280022801228022280322804228052280622807228082280922810228112281222813228142281522816228172281822819228202282122822228232282422825228262282722828228292283022831228322283322834228352283622837228382283922840228412284222843228442284522846228472284822849228502285122852228532285422855228562285722858228592286022861228622286322864228652286622867228682286922870228712287222873228742287522876228772287822879228802288122882228832288422885228862288722888228892289022891228922289322894228952289622897228982289922900229012290222903229042290522906229072290822909229102291122912229132291422915229162291722918229192292022921229222292322924229252292622927229282292922930229312293222933229342293522936229372293822939229402294122942229432294422945229462294722948229492295022951229522295322954229552295622957229582295922960229612296222963229642296522966229672296822969229702297122972229732297422975229762297722978229792298022981229822298322984229852298622987229882298922990229912299222993229942299522996229972299822999230002300123002230032300423005230062300723008230092301023011230122301323014230152301623017230182301923020230212302223023230242302523026230272302823029230302303123032230332303423035230362303723038230392304023041230422304323044230452304623047230482304923050230512305223053230542305523056230572305823059230602306123062230632306423065230662306723068230692307023071230722307323074230752307623077230782307923080230812308223083230842308523086230872308823089230902309123092230932309423095230962309723098230992310023101231022310323104231052310623107231082310923110231112311223113231142311523116231172311823119231202312123122231232312423125231262312723128231292313023131231322313323134231352313623137231382313923140231412314223143231442314523146231472314823149231502315123152231532315423155231562315723158231592316023161231622316323164231652316623167231682316923170231712317223173231742317523176231772317823179231802318123182231832318423185231862318723188231892319023191231922319323194231952319623197231982319923200232012320223203232042320523206232072320823209232102321123212232132321423215232162321723218232192322023221232222322323224232252322623227232282322923230232312323223233232342323523236232372323823239232402324123242232432324423245232462324723248232492325023251232522325323254232552325623257232582325923260232612326223263232642326523266232672326823269232702327123272232732327423275232762327723278232792328023281232822328323284232852328623287232882328923290232912329223293232942329523296232972329823299233002330123302233032330423305233062330723308233092331023311233122331323314233152331623317233182331923320233212332223323233242332523326233272332823329233302333123332233332333423335233362333723338233392334023341233422334323344233452334623347233482334923350233512335223353233542335523356233572335823359233602336123362233632336423365233662336723368233692337023371233722337323374233752337623377233782337923380233812338223383233842338523386233872338823389233902339123392233932339423395233962339723398233992340023401234022340323404234052340623407234082340923410234112341223413234142341523416234172341823419234202342123422234232342423425234262342723428234292343023431234322343323434234352343623437234382343923440234412344223443234442344523446234472344823449234502345123452234532345423455234562345723458234592346023461234622346323464234652346623467234682346923470234712347223473234742347523476234772347823479234802348123482234832348423485234862348723488234892349023491234922349323494234952349623497234982349923500235012350223503235042350523506235072350823509235102351123512235132351423515235162351723518235192352023521235222352323524235252352623527235282352923530235312353223533235342353523536235372353823539235402354123542235432354423545235462354723548235492355023551235522355323554235552355623557235582355923560235612356223563235642356523566235672356823569235702357123572235732357423575235762357723578235792358023581235822358323584235852358623587235882358923590235912359223593235942359523596235972359823599236002360123602236032360423605236062360723608236092361023611236122361323614236152361623617236182361923620236212362223623236242362523626236272362823629236302363123632236332363423635236362363723638236392364023641236422364323644236452364623647236482364923650236512365223653236542365523656236572365823659236602366123662236632366423665236662366723668236692367023671236722367323674236752367623677236782367923680236812368223683236842368523686236872368823689236902369123692236932369423695236962369723698236992370023701237022370323704237052370623707237082370923710237112371223713237142371523716237172371823719237202372123722237232372423725237262372723728237292373023731237322373323734237352373623737237382373923740237412374223743237442374523746237472374823749237502375123752237532375423755237562375723758237592376023761237622376323764237652376623767237682376923770237712377223773237742377523776237772377823779237802378123782237832378423785237862378723788237892379023791237922379323794237952379623797237982379923800238012380223803238042380523806238072380823809238102381123812238132381423815238162381723818238192382023821238222382323824238252382623827238282382923830238312383223833238342383523836238372383823839238402384123842238432384423845238462384723848238492385023851238522385323854238552385623857238582385923860238612386223863238642386523866238672386823869238702387123872238732387423875238762387723878238792388023881238822388323884238852388623887238882388923890238912389223893238942389523896238972389823899239002390123902239032390423905239062390723908239092391023911239122391323914239152391623917239182391923920239212392223923239242392523926239272392823929239302393123932239332393423935239362393723938239392394023941239422394323944239452394623947239482394923950239512395223953239542395523956239572395823959239602396123962239632396423965239662396723968239692397023971239722397323974239752397623977239782397923980239812398223983239842398523986239872398823989239902399123992239932399423995239962399723998239992400024001240022400324004240052400624007240082400924010240112401224013240142401524016240172401824019240202402124022240232402424025240262402724028240292403024031240322403324034240352403624037240382403924040240412404224043240442404524046240472404824049240502405124052240532405424055240562405724058240592406024061240622406324064240652406624067240682406924070240712407224073240742407524076240772407824079240802408124082240832408424085240862408724088240892409024091240922409324094240952409624097240982409924100241012410224103241042410524106241072410824109241102411124112241132411424115241162411724118241192412024121241222412324124241252412624127241282412924130241312413224133241342413524136241372413824139241402414124142241432414424145241462414724148241492415024151241522415324154241552415624157241582415924160241612416224163241642416524166241672416824169241702417124172241732417424175241762417724178241792418024181241822418324184241852418624187241882418924190241912419224193241942419524196241972419824199242002420124202242032420424205242062420724208242092421024211242122421324214242152421624217242182421924220242212422224223242242422524226242272422824229242302423124232242332423424235242362423724238242392424024241242422424324244242452424624247242482424924250242512425224253242542425524256242572425824259242602426124262242632426424265242662426724268242692427024271242722427324274242752427624277242782427924280242812428224283242842428524286242872428824289242902429124292242932429424295242962429724298242992430024301243022430324304243052430624307243082430924310243112431224313243142431524316243172431824319243202432124322243232432424325243262432724328243292433024331243322433324334243352433624337243382433924340243412434224343243442434524346243472434824349243502435124352243532435424355243562435724358243592436024361243622436324364243652436624367243682436924370243712437224373243742437524376243772437824379243802438124382243832438424385243862438724388243892439024391243922439324394243952439624397243982439924400244012440224403244042440524406244072440824409244102441124412244132441424415244162441724418244192442024421244222442324424244252442624427244282442924430244312443224433244342443524436244372443824439244402444124442244432444424445244462444724448244492445024451244522445324454244552445624457244582445924460244612446224463244642446524466244672446824469244702447124472244732447424475244762447724478244792448024481244822448324484244852448624487244882448924490244912449224493244942449524496244972449824499245002450124502245032450424505245062450724508245092451024511245122451324514245152451624517245182451924520245212452224523245242452524526245272452824529245302453124532245332453424535245362453724538245392454024541245422454324544245452454624547245482454924550245512455224553245542455524556245572455824559245602456124562245632456424565245662456724568245692457024571245722457324574245752457624577245782457924580245812458224583245842458524586245872458824589245902459124592245932459424595245962459724598245992460024601246022460324604246052460624607246082460924610246112461224613246142461524616246172461824619246202462124622246232462424625246262462724628246292463024631246322463324634246352463624637246382463924640246412464224643246442464524646246472464824649246502465124652246532465424655246562465724658246592466024661246622466324664246652466624667246682466924670246712467224673246742467524676246772467824679246802468124682246832468424685246862468724688246892469024691246922469324694246952469624697246982469924700247012470224703247042470524706247072470824709247102471124712247132471424715247162471724718247192472024721247222472324724247252472624727247282472924730247312473224733247342473524736247372473824739247402474124742247432474424745247462474724748247492475024751247522475324754247552475624757247582475924760247612476224763247642476524766247672476824769247702477124772247732477424775247762477724778247792478024781247822478324784247852478624787247882478924790247912479224793247942479524796247972479824799248002480124802248032480424805248062480724808248092481024811248122481324814248152481624817248182481924820248212482224823248242482524826248272482824829248302483124832248332483424835248362483724838248392484024841248422484324844248452484624847248482484924850248512485224853248542485524856248572485824859248602486124862248632486424865248662486724868248692487024871248722487324874248752487624877248782487924880248812488224883248842488524886248872488824889248902489124892248932489424895248962489724898248992490024901249022490324904249052490624907249082490924910249112491224913249142491524916249172491824919249202492124922249232492424925249262492724928249292493024931249322493324934249352493624937249382493924940249412494224943249442494524946249472494824949249502495124952249532495424955249562495724958249592496024961249622496324964249652496624967249682496924970249712497224973249742497524976249772497824979249802498124982249832498424985249862498724988249892499024991249922499324994249952499624997249982499925000250012500225003250042500525006250072500825009250102501125012250132501425015250162501725018250192502025021250222502325024250252502625027250282502925030250312503225033250342503525036250372503825039250402504125042250432504425045250462504725048250492505025051250522505325054250552505625057250582505925060250612506225063250642506525066250672506825069250702507125072250732507425075250762507725078250792508025081250822508325084250852508625087250882508925090250912509225093250942509525096250972509825099251002510125102251032510425105251062510725108251092511025111251122511325114251152511625117251182511925120251212512225123251242512525126251272512825129251302513125132251332513425135251362513725138251392514025141251422514325144251452514625147251482514925150251512515225153251542515525156251572515825159251602516125162251632516425165251662516725168251692517025171251722517325174251752517625177251782517925180251812518225183251842518525186251872518825189251902519125192251932519425195251962519725198251992520025201252022520325204252052520625207252082520925210252112521225213252142521525216252172521825219252202522125222252232522425225252262522725228252292523025231252322523325234252352523625237252382523925240252412524225243252442524525246252472524825249252502525125252252532525425255252562525725258252592526025261252622526325264252652526625267252682526925270252712527225273252742527525276252772527825279252802528125282252832528425285252862528725288252892529025291252922529325294252952529625297252982529925300253012530225303253042530525306253072530825309253102531125312253132531425315253162531725318253192532025321253222532325324253252532625327253282532925330253312533225333253342533525336253372533825339253402534125342253432534425345253462534725348253492535025351253522535325354253552535625357253582535925360253612536225363253642536525366253672536825369253702537125372253732537425375253762537725378253792538025381253822538325384253852538625387253882538925390253912539225393253942539525396253972539825399254002540125402254032540425405254062540725408254092541025411254122541325414254152541625417254182541925420254212542225423254242542525426254272542825429254302543125432254332543425435254362543725438254392544025441254422544325444254452544625447254482544925450254512545225453254542545525456254572545825459254602546125462254632546425465254662546725468254692547025471254722547325474254752547625477254782547925480254812548225483254842548525486254872548825489254902549125492254932549425495254962549725498254992550025501255022550325504255052550625507255082550925510255112551225513255142551525516255172551825519255202552125522255232552425525255262552725528255292553025531255322553325534255352553625537255382553925540255412554225543255442554525546255472554825549255502555125552255532555425555255562555725558255592556025561255622556325564255652556625567255682556925570255712557225573255742557525576255772557825579255802558125582255832558425585255862558725588255892559025591255922559325594255952559625597255982559925600256012560225603256042560525606256072560825609256102561125612256132561425615256162561725618256192562025621256222562325624256252562625627256282562925630256312563225633256342563525636256372563825639256402564125642256432564425645256462564725648256492565025651256522565325654256552565625657256582565925660256612566225663256642566525666256672566825669256702567125672256732567425675256762567725678256792568025681256822568325684256852568625687256882568925690256912569225693256942569525696256972569825699257002570125702257032570425705257062570725708257092571025711257122571325714257152571625717257182571925720257212572225723257242572525726257272572825729257302573125732257332573425735257362573725738257392574025741257422574325744257452574625747257482574925750257512575225753257542575525756257572575825759257602576125762257632576425765257662576725768257692577025771257722577325774257752577625777257782577925780257812578225783257842578525786257872578825789257902579125792257932579425795257962579725798257992580025801258022580325804258052580625807258082580925810258112581225813258142581525816258172581825819258202582125822258232582425825258262582725828258292583025831258322583325834258352583625837258382583925840258412584225843258442584525846258472584825849258502585125852258532585425855258562585725858258592586025861258622586325864258652586625867258682586925870258712587225873258742587525876258772587825879258802588125882258832588425885258862588725888258892589025891258922589325894258952589625897258982589925900259012590225903259042590525906259072590825909259102591125912259132591425915259162591725918259192592025921259222592325924259252592625927259282592925930259312593225933259342593525936259372593825939259402594125942259432594425945259462594725948259492595025951259522595325954259552595625957259582595925960259612596225963259642596525966259672596825969259702597125972259732597425975259762597725978259792598025981259822598325984259852598625987259882598925990259912599225993259942599525996259972599825999260002600126002260032600426005260062600726008260092601026011260122601326014260152601626017260182601926020260212602226023260242602526026260272602826029260302603126032260332603426035260362603726038260392604026041260422604326044260452604626047260482604926050260512605226053260542605526056260572605826059260602606126062260632606426065260662606726068260692607026071260722607326074260752607626077260782607926080260812608226083260842608526086260872608826089260902609126092260932609426095260962609726098260992610026101261022610326104261052610626107261082610926110261112611226113261142611526116261172611826119261202612126122261232612426125261262612726128261292613026131261322613326134261352613626137261382613926140261412614226143261442614526146261472614826149261502615126152261532615426155261562615726158261592616026161261622616326164261652616626167261682616926170261712617226173261742617526176261772617826179261802618126182261832618426185261862618726188261892619026191261922619326194261952619626197261982619926200262012620226203262042620526206262072620826209262102621126212262132621426215262162621726218262192622026221262222622326224262252622626227262282622926230262312623226233262342623526236262372623826239262402624126242262432624426245262462624726248262492625026251262522625326254262552625626257262582625926260262612626226263262642626526266262672626826269262702627126272262732627426275262762627726278262792628026281262822628326284262852628626287262882628926290262912629226293262942629526296262972629826299263002630126302263032630426305263062630726308263092631026311263122631326314263152631626317263182631926320263212632226323263242632526326263272632826329263302633126332263332633426335263362633726338263392634026341263422634326344263452634626347263482634926350263512635226353263542635526356263572635826359263602636126362263632636426365263662636726368263692637026371263722637326374263752637626377263782637926380263812638226383263842638526386263872638826389263902639126392263932639426395263962639726398263992640026401264022640326404264052640626407264082640926410264112641226413264142641526416264172641826419264202642126422264232642426425264262642726428264292643026431264322643326434264352643626437264382643926440264412644226443264442644526446264472644826449264502645126452264532645426455264562645726458264592646026461264622646326464264652646626467264682646926470264712647226473264742647526476264772647826479264802648126482264832648426485264862648726488264892649026491264922649326494264952649626497264982649926500265012650226503265042650526506265072650826509265102651126512265132651426515265162651726518265192652026521265222652326524265252652626527265282652926530265312653226533265342653526536265372653826539265402654126542265432654426545265462654726548265492655026551265522655326554265552655626557265582655926560265612656226563265642656526566265672656826569265702657126572265732657426575265762657726578265792658026581265822658326584265852658626587265882658926590265912659226593265942659526596265972659826599266002660126602266032660426605266062660726608266092661026611266122661326614266152661626617266182661926620266212662226623266242662526626266272662826629266302663126632266332663426635266362663726638266392664026641266422664326644266452664626647266482664926650266512665226653266542665526656266572665826659266602666126662266632666426665266662666726668266692667026671266722667326674266752667626677266782667926680266812668226683266842668526686266872668826689266902669126692266932669426695266962669726698266992670026701267022670326704267052670626707267082670926710267112671226713267142671526716267172671826719267202672126722267232672426725267262672726728267292673026731267322673326734267352673626737267382673926740267412674226743267442674526746267472674826749267502675126752267532675426755267562675726758267592676026761267622676326764267652676626767267682676926770267712677226773267742677526776267772677826779267802678126782267832678426785267862678726788267892679026791267922679326794267952679626797267982679926800268012680226803268042680526806268072680826809268102681126812268132681426815268162681726818268192682026821268222682326824268252682626827268282682926830268312683226833268342683526836268372683826839268402684126842268432684426845268462684726848268492685026851268522685326854268552685626857268582685926860268612686226863268642686526866268672686826869268702687126872268732687426875268762687726878268792688026881268822688326884268852688626887268882688926890268912689226893268942689526896268972689826899269002690126902269032690426905269062690726908269092691026911269122691326914269152691626917269182691926920269212692226923269242692526926269272692826929269302693126932269332693426935269362693726938269392694026941269422694326944269452694626947269482694926950269512695226953269542695526956269572695826959269602696126962269632696426965269662696726968269692697026971269722697326974269752697626977269782697926980269812698226983269842698526986269872698826989269902699126992269932699426995269962699726998269992700027001270022700327004270052700627007270082700927010270112701227013270142701527016270172701827019270202702127022270232702427025270262702727028270292703027031270322703327034270352703627037270382703927040270412704227043270442704527046270472704827049270502705127052270532705427055270562705727058270592706027061270622706327064270652706627067270682706927070270712707227073270742707527076270772707827079270802708127082270832708427085270862708727088270892709027091270922709327094270952709627097270982709927100271012710227103271042710527106271072710827109271102711127112271132711427115271162711727118271192712027121271222712327124271252712627127271282712927130271312713227133271342713527136271372713827139271402714127142271432714427145271462714727148271492715027151271522715327154271552715627157271582715927160271612716227163271642716527166271672716827169271702717127172271732717427175271762717727178271792718027181271822718327184271852718627187271882718927190271912719227193271942719527196271972719827199272002720127202272032720427205272062720727208272092721027211272122721327214272152721627217272182721927220272212722227223272242722527226272272722827229272302723127232272332723427235272362723727238272392724027241272422724327244272452724627247272482724927250272512725227253272542725527256272572725827259272602726127262272632726427265272662726727268272692727027271272722727327274272752727627277272782727927280272812728227283272842728527286272872728827289272902729127292272932729427295272962729727298272992730027301273022730327304273052730627307273082730927310273112731227313273142731527316273172731827319273202732127322273232732427325273262732727328273292733027331273322733327334273352733627337273382733927340273412734227343273442734527346273472734827349273502735127352273532735427355273562735727358273592736027361273622736327364273652736627367273682736927370273712737227373273742737527376273772737827379273802738127382273832738427385273862738727388273892739027391273922739327394273952739627397273982739927400274012740227403274042740527406274072740827409274102741127412274132741427415274162741727418274192742027421274222742327424274252742627427274282742927430274312743227433274342743527436274372743827439274402744127442274432744427445274462744727448274492745027451274522745327454274552745627457274582745927460274612746227463274642746527466274672746827469274702747127472274732747427475274762747727478274792748027481274822748327484274852748627487274882748927490274912749227493274942749527496274972749827499275002750127502275032750427505275062750727508275092751027511275122751327514275152751627517275182751927520275212752227523275242752527526275272752827529275302753127532275332753427535275362753727538275392754027541275422754327544275452754627547275482754927550275512755227553275542755527556275572755827559275602756127562275632756427565275662756727568275692757027571275722757327574275752757627577275782757927580275812758227583275842758527586275872758827589275902759127592275932759427595275962759727598275992760027601276022760327604276052760627607276082760927610276112761227613276142761527616276172761827619276202762127622276232762427625276262762727628276292763027631276322763327634276352763627637276382763927640276412764227643276442764527646276472764827649276502765127652276532765427655276562765727658276592766027661276622766327664276652766627667276682766927670276712767227673276742767527676276772767827679276802768127682276832768427685276862768727688276892769027691276922769327694276952769627697276982769927700277012770227703277042770527706277072770827709277102771127712277132771427715277162771727718277192772027721277222772327724277252772627727277282772927730277312773227733277342773527736277372773827739277402774127742277432774427745277462774727748277492775027751277522775327754277552775627757277582775927760277612776227763277642776527766277672776827769277702777127772277732777427775277762777727778277792778027781277822778327784277852778627787277882778927790277912779227793277942779527796277972779827799278002780127802278032780427805278062780727808278092781027811278122781327814278152781627817278182781927820278212782227823278242782527826278272782827829278302783127832278332783427835278362783727838278392784027841278422784327844278452784627847278482784927850278512785227853278542785527856278572785827859278602786127862278632786427865278662786727868278692787027871278722787327874278752787627877278782787927880278812788227883278842788527886278872788827889278902789127892278932789427895278962789727898278992790027901279022790327904279052790627907279082790927910279112791227913279142791527916279172791827919279202792127922279232792427925279262792727928279292793027931279322793327934279352793627937279382793927940279412794227943279442794527946279472794827949279502795127952279532795427955279562795727958279592796027961279622796327964279652796627967279682796927970279712797227973279742797527976279772797827979279802798127982279832798427985279862798727988279892799027991279922799327994279952799627997279982799928000280012800228003280042800528006280072800828009280102801128012280132801428015280162801728018280192802028021280222802328024280252802628027280282802928030280312803228033280342803528036280372803828039280402804128042280432804428045280462804728048280492805028051280522805328054280552805628057280582805928060280612806228063280642806528066280672806828069280702807128072280732807428075280762807728078280792808028081280822808328084280852808628087280882808928090280912809228093280942809528096280972809828099281002810128102281032810428105281062810728108281092811028111281122811328114281152811628117281182811928120281212812228123281242812528126281272812828129281302813128132281332813428135281362813728138281392814028141281422814328144281452814628147281482814928150281512815228153281542815528156281572815828159281602816128162281632816428165281662816728168281692817028171281722817328174281752817628177281782817928180281812818228183281842818528186281872818828189281902819128192281932819428195281962819728198281992820028201282022820328204282052820628207282082820928210282112821228213282142821528216282172821828219282202822128222282232822428225282262822728228282292823028231282322823328234282352823628237282382823928240282412824228243282442824528246282472824828249282502825128252282532825428255282562825728258282592826028261282622826328264282652826628267282682826928270282712827228273282742827528276282772827828279282802828128282282832828428285282862828728288282892829028291282922829328294282952829628297282982829928300283012830228303283042830528306283072830828309283102831128312283132831428315283162831728318283192832028321283222832328324283252832628327283282832928330283312833228333283342833528336283372833828339283402834128342283432834428345283462834728348283492835028351283522835328354283552835628357283582835928360283612836228363283642836528366283672836828369283702837128372283732837428375283762837728378283792838028381283822838328384283852838628387283882838928390283912839228393283942839528396283972839828399284002840128402284032840428405284062840728408284092841028411284122841328414284152841628417284182841928420284212842228423284242842528426284272842828429284302843128432284332843428435284362843728438284392844028441284422844328444284452844628447284482844928450284512845228453284542845528456284572845828459284602846128462284632846428465284662846728468284692847028471284722847328474284752847628477284782847928480284812848228483284842848528486284872848828489284902849128492284932849428495284962849728498284992850028501285022850328504285052850628507285082850928510285112851228513285142851528516285172851828519285202852128522285232852428525285262852728528285292853028531285322853328534285352853628537285382853928540285412854228543285442854528546285472854828549285502855128552285532855428555285562855728558285592856028561285622856328564285652856628567285682856928570285712857228573285742857528576285772857828579285802858128582285832858428585285862858728588285892859028591285922859328594285952859628597285982859928600286012860228603286042860528606286072860828609286102861128612286132861428615286162861728618286192862028621286222862328624286252862628627286282862928630286312863228633286342863528636286372863828639286402864128642286432864428645286462864728648286492865028651286522865328654286552865628657286582865928660286612866228663286642866528666286672866828669286702867128672286732867428675286762867728678286792868028681286822868328684286852868628687286882868928690286912869228693286942869528696286972869828699287002870128702287032870428705287062870728708287092871028711287122871328714287152871628717287182871928720287212872228723287242872528726287272872828729287302873128732287332873428735287362873728738287392874028741287422874328744287452874628747287482874928750287512875228753287542875528756287572875828759287602876128762287632876428765287662876728768287692877028771287722877328774287752877628777287782877928780287812878228783287842878528786287872878828789287902879128792287932879428795287962879728798287992880028801288022880328804288052880628807288082880928810288112881228813288142881528816288172881828819288202882128822288232882428825288262882728828288292883028831288322883328834288352883628837288382883928840288412884228843288442884528846288472884828849288502885128852288532885428855288562885728858288592886028861288622886328864288652886628867288682886928870288712887228873288742887528876288772887828879288802888128882288832888428885288862888728888288892889028891288922889328894288952889628897288982889928900289012890228903289042890528906289072890828909289102891128912289132891428915289162891728918289192892028921289222892328924289252892628927289282892928930289312893228933289342893528936289372893828939289402894128942289432894428945289462894728948289492895028951289522895328954289552895628957289582895928960289612896228963289642896528966289672896828969289702897128972289732897428975289762897728978289792898028981289822898328984289852898628987289882898928990289912899228993289942899528996289972899828999290002900129002290032900429005290062900729008290092901029011290122901329014290152901629017290182901929020290212902229023290242902529026290272902829029290302903129032290332903429035290362903729038290392904029041290422904329044290452904629047290482904929050290512905229053290542905529056290572905829059290602906129062290632906429065290662906729068290692907029071290722907329074290752907629077290782907929080290812908229083290842908529086290872908829089290902909129092290932909429095290962909729098290992910029101291022910329104291052910629107291082910929110291112911229113291142911529116291172911829119291202912129122291232912429125291262912729128291292913029131291322913329134291352913629137291382913929140291412914229143291442914529146291472914829149291502915129152291532915429155291562915729158291592916029161291622916329164291652916629167291682916929170291712917229173291742917529176291772917829179291802918129182291832918429185291862918729188291892919029191291922919329194291952919629197291982919929200292012920229203292042920529206292072920829209292102921129212292132921429215292162921729218292192922029221292222922329224292252922629227292282922929230292312923229233292342923529236292372923829239292402924129242292432924429245292462924729248292492925029251292522925329254292552925629257292582925929260292612926229263292642926529266292672926829269292702927129272292732927429275292762927729278292792928029281292822928329284292852928629287292882928929290292912929229293292942929529296292972929829299293002930129302293032930429305293062930729308293092931029311293122931329314293152931629317293182931929320293212932229323293242932529326293272932829329293302933129332293332933429335293362933729338293392934029341293422934329344293452934629347293482934929350293512935229353293542935529356293572935829359293602936129362293632936429365293662936729368293692937029371293722937329374293752937629377293782937929380293812938229383293842938529386293872938829389293902939129392293932939429395293962939729398293992940029401294022940329404294052940629407294082940929410294112941229413294142941529416294172941829419294202942129422294232942429425294262942729428294292943029431294322943329434294352943629437294382943929440294412944229443294442944529446294472944829449294502945129452294532945429455294562945729458294592946029461294622946329464294652946629467294682946929470294712947229473294742947529476294772947829479294802948129482294832948429485294862948729488294892949029491294922949329494294952949629497294982949929500295012950229503295042950529506295072950829509295102951129512295132951429515295162951729518295192952029521295222952329524295252952629527295282952929530295312953229533295342953529536295372953829539295402954129542295432954429545295462954729548295492955029551295522955329554295552955629557295582955929560295612956229563295642956529566295672956829569295702957129572295732957429575295762957729578295792958029581295822958329584295852958629587295882958929590295912959229593295942959529596295972959829599296002960129602296032960429605296062960729608296092961029611296122961329614296152961629617296182961929620296212962229623296242962529626296272962829629296302963129632296332963429635296362963729638296392964029641296422964329644296452964629647296482964929650296512965229653296542965529656296572965829659296602966129662296632966429665296662966729668296692967029671296722967329674296752967629677296782967929680296812968229683296842968529686296872968829689296902969129692296932969429695296962969729698296992970029701297022970329704297052970629707297082970929710297112971229713297142971529716297172971829719297202972129722297232972429725297262972729728297292973029731297322973329734297352973629737297382973929740297412974229743297442974529746297472974829749297502975129752297532975429755297562975729758297592976029761297622976329764297652976629767297682976929770297712977229773297742977529776297772977829779297802978129782297832978429785297862978729788297892979029791297922979329794297952979629797297982979929800298012980229803298042980529806298072980829809298102981129812298132981429815298162981729818298192982029821298222982329824298252982629827298282982929830298312983229833298342983529836298372983829839298402984129842298432984429845298462984729848298492985029851298522985329854298552985629857298582985929860298612986229863298642986529866298672986829869298702987129872298732987429875298762987729878298792988029881298822988329884298852988629887298882988929890298912989229893298942989529896298972989829899299002990129902299032990429905299062990729908299092991029911299122991329914299152991629917299182991929920299212992229923299242992529926299272992829929299302993129932299332993429935299362993729938299392994029941299422994329944299452994629947299482994929950299512995229953299542995529956299572995829959299602996129962299632996429965299662996729968299692997029971299722997329974299752997629977299782997929980299812998229983299842998529986299872998829989299902999129992299932999429995299962999729998299993000030001300023000330004300053000630007300083000930010300113001230013300143001530016300173001830019300203002130022300233002430025300263002730028300293003030031300323003330034300353003630037300383003930040300413004230043300443004530046300473004830049300503005130052300533005430055300563005730058300593006030061300623006330064300653006630067300683006930070300713007230073300743007530076300773007830079300803008130082300833008430085300863008730088300893009030091300923009330094300953009630097300983009930100301013010230103301043010530106301073010830109301103011130112301133011430115301163011730118301193012030121301223012330124301253012630127301283012930130301313013230133301343013530136301373013830139301403014130142301433014430145301463014730148301493015030151301523015330154301553015630157301583015930160301613016230163301643016530166301673016830169301703017130172301733017430175301763017730178301793018030181301823018330184301853018630187301883018930190301913019230193301943019530196301973019830199302003020130202302033020430205302063020730208302093021030211302123021330214302153021630217302183021930220302213022230223302243022530226302273022830229302303023130232302333023430235302363023730238302393024030241302423024330244302453024630247302483024930250302513025230253302543025530256302573025830259302603026130262302633026430265302663026730268302693027030271302723027330274302753027630277302783027930280302813028230283302843028530286302873028830289302903029130292302933029430295302963029730298302993030030301303023030330304303053030630307303083030930310303113031230313303143031530316303173031830319303203032130322303233032430325303263032730328303293033030331303323033330334303353033630337303383033930340303413034230343303443034530346303473034830349303503035130352303533035430355303563035730358303593036030361303623036330364303653036630367303683036930370303713037230373303743037530376303773037830379303803038130382303833038430385303863038730388303893039030391303923039330394303953039630397303983039930400304013040230403304043040530406304073040830409304103041130412304133041430415304163041730418304193042030421304223042330424304253042630427304283042930430304313043230433304343043530436304373043830439304403044130442304433044430445304463044730448304493045030451304523045330454304553045630457304583045930460304613046230463304643046530466304673046830469304703047130472304733047430475304763047730478304793048030481304823048330484304853048630487304883048930490304913049230493304943049530496304973049830499305003050130502305033050430505305063050730508305093051030511305123051330514305153051630517305183051930520305213052230523305243052530526305273052830529305303053130532305333053430535305363053730538305393054030541305423054330544305453054630547305483054930550305513055230553305543055530556305573055830559305603056130562305633056430565305663056730568305693057030571305723057330574305753057630577305783057930580305813058230583305843058530586305873058830589305903059130592305933059430595305963059730598305993060030601306023060330604306053060630607306083060930610306113061230613306143061530616306173061830619306203062130622306233062430625306263062730628306293063030631306323063330634306353063630637306383063930640306413064230643306443064530646306473064830649306503065130652306533065430655306563065730658306593066030661306623066330664306653066630667306683066930670306713067230673306743067530676306773067830679306803068130682306833068430685306863068730688306893069030691306923069330694306953069630697306983069930700307013070230703307043070530706307073070830709307103071130712307133071430715307163071730718307193072030721307223072330724307253072630727307283072930730307313073230733307343073530736307373073830739307403074130742307433074430745307463074730748307493075030751307523075330754307553075630757307583075930760307613076230763307643076530766307673076830769307703077130772307733077430775307763077730778307793078030781307823078330784307853078630787307883078930790307913079230793307943079530796307973079830799308003080130802308033080430805308063080730808308093081030811308123081330814308153081630817308183081930820308213082230823308243082530826308273082830829308303083130832308333083430835308363083730838308393084030841308423084330844308453084630847308483084930850308513085230853308543085530856308573085830859308603086130862308633086430865308663086730868308693087030871308723087330874308753087630877308783087930880308813088230883308843088530886308873088830889308903089130892308933089430895308963089730898308993090030901309023090330904309053090630907309083090930910309113091230913309143091530916309173091830919309203092130922309233092430925309263092730928309293093030931309323093330934309353093630937309383093930940309413094230943309443094530946309473094830949309503095130952309533095430955309563095730958309593096030961309623096330964309653096630967309683096930970309713097230973309743097530976309773097830979309803098130982309833098430985309863098730988309893099030991309923099330994309953099630997309983099931000310013100231003310043100531006310073100831009310103101131012310133101431015310163101731018310193102031021310223102331024310253102631027310283102931030310313103231033310343103531036310373103831039310403104131042310433104431045310463104731048310493105031051310523105331054310553105631057310583105931060310613106231063310643106531066310673106831069310703107131072310733107431075310763107731078310793108031081310823108331084310853108631087310883108931090310913109231093310943109531096310973109831099311003110131102311033110431105311063110731108311093111031111311123111331114311153111631117311183111931120311213112231123311243112531126311273112831129311303113131132311333113431135311363113731138311393114031141311423114331144311453114631147311483114931150311513115231153311543115531156311573115831159311603116131162311633116431165311663116731168311693117031171311723117331174311753117631177311783117931180311813118231183311843118531186311873118831189311903119131192311933119431195311963119731198311993120031201312023120331204312053120631207312083120931210312113121231213312143121531216312173121831219312203122131222312233122431225312263122731228312293123031231312323123331234312353123631237312383123931240312413124231243312443124531246312473124831249312503125131252312533125431255312563125731258312593126031261312623126331264312653126631267312683126931270312713127231273312743127531276312773127831279312803128131282312833128431285312863128731288312893129031291312923129331294312953129631297312983129931300313013130231303313043130531306313073130831309313103131131312313133131431315313163131731318313193132031321313223132331324313253132631327313283132931330313313133231333313343133531336313373133831339313403134131342313433134431345313463134731348313493135031351313523135331354313553135631357313583135931360313613136231363313643136531366313673136831369313703137131372313733137431375313763137731378313793138031381313823138331384313853138631387313883138931390313913139231393313943139531396313973139831399314003140131402314033140431405314063140731408314093141031411314123141331414314153141631417314183141931420314213142231423314243142531426314273142831429314303143131432314333143431435314363143731438314393144031441314423144331444314453144631447314483144931450314513145231453314543145531456314573145831459314603146131462314633146431465314663146731468314693147031471314723147331474314753147631477314783147931480314813148231483314843148531486314873148831489314903149131492314933149431495314963149731498314993150031501315023150331504315053150631507315083150931510315113151231513315143151531516315173151831519315203152131522315233152431525315263152731528315293153031531315323153331534315353153631537315383153931540315413154231543315443154531546315473154831549315503155131552315533155431555315563155731558315593156031561315623156331564315653156631567315683156931570315713157231573315743157531576315773157831579315803158131582315833158431585315863158731588315893159031591315923159331594315953159631597315983159931600316013160231603316043160531606316073160831609316103161131612316133161431615316163161731618316193162031621316223162331624316253162631627316283162931630316313163231633316343163531636316373163831639316403164131642316433164431645316463164731648316493165031651316523165331654316553165631657316583165931660316613166231663316643166531666316673166831669316703167131672316733167431675316763167731678316793168031681316823168331684316853168631687316883168931690316913169231693316943169531696316973169831699317003170131702317033170431705317063170731708317093171031711317123171331714317153171631717317183171931720317213172231723317243172531726317273172831729317303173131732317333173431735317363173731738317393174031741317423174331744317453174631747317483174931750317513175231753317543175531756317573175831759317603176131762317633176431765317663176731768317693177031771317723177331774317753177631777317783177931780317813178231783317843178531786317873178831789317903179131792317933179431795317963179731798317993180031801318023180331804318053180631807318083180931810318113181231813318143181531816318173181831819318203182131822318233182431825318263182731828318293183031831318323183331834318353183631837318383183931840318413184231843318443184531846318473184831849318503185131852318533185431855318563185731858318593186031861318623186331864318653186631867318683186931870318713187231873318743187531876318773187831879318803188131882318833188431885318863188731888318893189031891318923189331894318953189631897318983189931900319013190231903319043190531906319073190831909319103191131912319133191431915319163191731918319193192031921319223192331924319253192631927319283192931930319313193231933319343193531936319373193831939319403194131942319433194431945319463194731948319493195031951319523195331954319553195631957319583195931960319613196231963319643196531966319673196831969319703197131972319733197431975319763197731978319793198031981319823198331984319853198631987319883198931990319913199231993319943199531996319973199831999320003200132002320033200432005320063200732008320093201032011320123201332014320153201632017320183201932020320213202232023320243202532026320273202832029320303203132032320333203432035320363203732038320393204032041320423204332044320453204632047320483204932050320513205232053320543205532056320573205832059320603206132062320633206432065320663206732068320693207032071320723207332074320753207632077320783207932080320813208232083320843208532086320873208832089320903209132092320933209432095320963209732098320993210032101321023210332104321053210632107321083210932110321113211232113321143211532116321173211832119321203212132122321233212432125321263212732128321293213032131321323213332134321353213632137321383213932140321413214232143321443214532146321473214832149321503215132152321533215432155321563215732158321593216032161321623216332164321653216632167321683216932170321713217232173321743217532176321773217832179321803218132182321833218432185321863218732188321893219032191321923219332194321953219632197321983219932200322013220232203322043220532206322073220832209322103221132212322133221432215322163221732218322193222032221322223222332224322253222632227322283222932230322313223232233322343223532236322373223832239322403224132242322433224432245322463224732248322493225032251322523225332254322553225632257322583225932260322613226232263322643226532266322673226832269322703227132272322733227432275322763227732278322793228032281322823228332284322853228632287322883228932290322913229232293322943229532296322973229832299323003230132302323033230432305323063230732308323093231032311323123231332314323153231632317323183231932320323213232232323323243232532326323273232832329323303233132332323333233432335323363233732338323393234032341323423234332344323453234632347323483234932350323513235232353323543235532356323573235832359323603236132362323633236432365323663236732368323693237032371323723237332374323753237632377323783237932380323813238232383323843238532386323873238832389323903239132392323933239432395323963239732398323993240032401324023240332404324053240632407324083240932410324113241232413324143241532416324173241832419324203242132422324233242432425324263242732428324293243032431324323243332434324353243632437324383243932440324413244232443324443244532446324473244832449324503245132452324533245432455324563245732458324593246032461324623246332464324653246632467324683246932470324713247232473324743247532476324773247832479324803248132482324833248432485324863248732488324893249032491324923249332494324953249632497324983249932500325013250232503325043250532506325073250832509325103251132512325133251432515325163251732518325193252032521325223252332524325253252632527325283252932530325313253232533325343253532536325373253832539325403254132542325433254432545325463254732548325493255032551325523255332554325553255632557325583255932560325613256232563325643256532566325673256832569325703257132572325733257432575325763257732578325793258032581325823258332584325853258632587325883258932590325913259232593325943259532596325973259832599326003260132602326033260432605326063260732608326093261032611326123261332614326153261632617326183261932620326213262232623326243262532626326273262832629326303263132632326333263432635326363263732638326393264032641326423264332644326453264632647326483264932650326513265232653326543265532656326573265832659326603266132662326633266432665326663266732668326693267032671326723267332674326753267632677326783267932680326813268232683326843268532686326873268832689326903269132692326933269432695326963269732698326993270032701327023270332704327053270632707327083270932710327113271232713327143271532716327173271832719327203272132722327233272432725327263272732728327293273032731327323273332734327353273632737327383273932740327413274232743327443274532746327473274832749327503275132752327533275432755327563275732758327593276032761327623276332764327653276632767327683276932770327713277232773327743277532776327773277832779327803278132782327833278432785327863278732788327893279032791327923279332794327953279632797327983279932800328013280232803328043280532806328073280832809328103281132812328133281432815328163281732818328193282032821328223282332824328253282632827328283282932830328313283232833328343283532836328373283832839328403284132842328433284432845328463284732848328493285032851328523285332854328553285632857328583285932860328613286232863328643286532866328673286832869328703287132872328733287432875328763287732878328793288032881328823288332884328853288632887328883288932890328913289232893328943289532896328973289832899329003290132902329033290432905329063290732908329093291032911329123291332914329153291632917329183291932920329213292232923329243292532926329273292832929329303293132932329333293432935329363293732938329393294032941329423294332944329453294632947329483294932950329513295232953329543295532956329573295832959329603296132962329633296432965329663296732968329693297032971329723297332974329753297632977329783297932980329813298232983329843298532986329873298832989329903299132992329933299432995329963299732998329993300033001330023300333004330053300633007330083300933010330113301233013330143301533016330173301833019330203302133022330233302433025330263302733028330293303033031330323303333034330353303633037330383303933040330413304233043330443304533046330473304833049330503305133052330533305433055330563305733058330593306033061330623306333064330653306633067330683306933070330713307233073330743307533076330773307833079330803308133082330833308433085330863308733088330893309033091330923309333094330953309633097330983309933100331013310233103331043310533106331073310833109331103311133112331133311433115331163311733118331193312033121331223312333124331253312633127331283312933130331313313233133331343313533136331373313833139331403314133142331433314433145331463314733148331493315033151331523315333154331553315633157331583315933160331613316233163331643316533166331673316833169331703317133172331733317433175331763317733178331793318033181331823318333184331853318633187331883318933190331913319233193331943319533196331973319833199332003320133202332033320433205332063320733208332093321033211332123321333214332153321633217332183321933220332213322233223332243322533226332273322833229332303323133232332333323433235332363323733238332393324033241332423324333244332453324633247332483324933250332513325233253332543325533256332573325833259332603326133262332633326433265332663326733268332693327033271332723327333274332753327633277332783327933280332813328233283332843328533286332873328833289332903329133292332933329433295332963329733298332993330033301333023330333304333053330633307333083330933310333113331233313333143331533316333173331833319333203332133322333233332433325333263332733328333293333033331333323333333334333353333633337333383333933340333413334233343333443334533346333473334833349333503335133352333533335433355333563335733358333593336033361333623336333364333653336633367333683336933370333713337233373333743337533376333773337833379333803338133382333833338433385333863338733388333893339033391333923339333394333953339633397333983339933400334013340233403334043340533406334073340833409334103341133412334133341433415334163341733418334193342033421334223342333424334253342633427334283342933430334313343233433334343343533436334373343833439334403344133442334433344433445334463344733448334493345033451334523345333454334553345633457334583345933460334613346233463334643346533466334673346833469334703347133472334733347433475334763347733478334793348033481334823348333484334853348633487334883348933490334913349233493334943349533496334973349833499335003350133502335033350433505335063350733508335093351033511335123351333514335153351633517335183351933520335213352233523335243352533526335273352833529335303353133532335333353433535335363353733538335393354033541335423354333544335453354633547335483354933550335513355233553335543355533556335573355833559335603356133562335633356433565335663356733568335693357033571335723357333574335753357633577335783357933580335813358233583335843358533586335873358833589335903359133592335933359433595335963359733598335993360033601336023360333604336053360633607336083360933610336113361233613336143361533616336173361833619336203362133622336233362433625336263362733628336293363033631336323363333634336353363633637336383363933640336413364233643336443364533646336473364833649336503365133652336533365433655336563365733658336593366033661336623366333664336653366633667336683366933670336713367233673336743367533676336773367833679336803368133682336833368433685336863368733688336893369033691336923369333694336953369633697336983369933700337013370233703337043370533706337073370833709337103371133712337133371433715337163371733718337193372033721337223372333724337253372633727337283372933730337313373233733337343373533736337373373833739337403374133742337433374433745337463374733748337493375033751337523375333754337553375633757337583375933760337613376233763337643376533766337673376833769337703377133772337733377433775337763377733778337793378033781337823378333784337853378633787337883378933790337913379233793337943379533796337973379833799338003380133802338033380433805338063380733808338093381033811338123381333814338153381633817338183381933820338213382233823338243382533826338273382833829338303383133832338333383433835338363383733838338393384033841338423384333844338453384633847338483384933850338513385233853338543385533856338573385833859338603386133862338633386433865338663386733868338693387033871338723387333874338753387633877338783387933880338813388233883338843388533886338873388833889338903389133892338933389433895338963389733898338993390033901339023390333904339053390633907339083390933910339113391233913339143391533916339173391833919339203392133922339233392433925339263392733928339293393033931339323393333934339353393633937339383393933940339413394233943339443394533946339473394833949339503395133952339533395433955339563395733958339593396033961339623396333964339653396633967339683396933970339713397233973339743397533976339773397833979339803398133982339833398433985339863398733988339893399033991339923399333994339953399633997339983399934000340013400234003340043400534006340073400834009340103401134012340133401434015340163401734018340193402034021340223402334024340253402634027340283402934030340313403234033340343403534036340373403834039340403404134042340433404434045340463404734048340493405034051340523405334054340553405634057340583405934060340613406234063340643406534066340673406834069340703407134072340733407434075340763407734078340793408034081340823408334084340853408634087340883408934090340913409234093340943409534096340973409834099341003410134102341033410434105341063410734108341093411034111341123411334114341153411634117341183411934120341213412234123341243412534126341273412834129341303413134132341333413434135341363413734138341393414034141341423414334144341453414634147341483414934150341513415234153341543415534156341573415834159341603416134162341633416434165341663416734168341693417034171341723417334174341753417634177341783417934180341813418234183341843418534186341873418834189341903419134192341933419434195341963419734198341993420034201342023420334204342053420634207342083420934210342113421234213342143421534216342173421834219342203422134222342233422434225342263422734228342293423034231342323423334234342353423634237342383423934240342413424234243342443424534246342473424834249342503425134252342533425434255342563425734258342593426034261342623426334264342653426634267342683426934270342713427234273342743427534276342773427834279342803428134282342833428434285342863428734288342893429034291342923429334294342953429634297342983429934300343013430234303343043430534306343073430834309343103431134312343133431434315343163431734318343193432034321343223432334324343253432634327343283432934330343313433234333343343433534336343373433834339343403434134342343433434434345343463434734348343493435034351343523435334354343553435634357343583435934360343613436234363343643436534366343673436834369343703437134372343733437434375343763437734378343793438034381343823438334384343853438634387343883438934390343913439234393343943439534396343973439834399344003440134402344033440434405344063440734408344093441034411344123441334414344153441634417344183441934420344213442234423344243442534426344273442834429344303443134432344333443434435344363443734438344393444034441344423444334444344453444634447344483444934450344513445234453344543445534456344573445834459344603446134462344633446434465344663446734468344693447034471344723447334474344753447634477344783447934480344813448234483344843448534486344873448834489344903449134492344933449434495344963449734498344993450034501345023450334504345053450634507345083450934510345113451234513345143451534516345173451834519345203452134522345233452434525345263452734528345293453034531345323453334534345353453634537345383453934540345413454234543345443454534546345473454834549345503455134552345533455434555345563455734558345593456034561345623456334564345653456634567345683456934570345713457234573345743457534576345773457834579345803458134582345833458434585345863458734588345893459034591345923459334594345953459634597345983459934600346013460234603346043460534606346073460834609346103461134612346133461434615346163461734618346193462034621346223462334624346253462634627346283462934630346313463234633346343463534636346373463834639346403464134642346433464434645346463464734648346493465034651346523465334654346553465634657346583465934660346613466234663346643466534666346673466834669346703467134672346733467434675346763467734678346793468034681346823468334684346853468634687346883468934690346913469234693346943469534696346973469834699347003470134702347033470434705347063470734708347093471034711347123471334714347153471634717347183471934720347213472234723347243472534726347273472834729347303473134732347333473434735347363473734738347393474034741347423474334744347453474634747347483474934750347513475234753347543475534756347573475834759347603476134762347633476434765347663476734768347693477034771347723477334774347753477634777347783477934780347813478234783347843478534786347873478834789347903479134792347933479434795347963479734798347993480034801348023480334804348053480634807348083480934810348113481234813348143481534816348173481834819348203482134822348233482434825348263482734828348293483034831348323483334834348353483634837348383483934840348413484234843348443484534846348473484834849348503485134852348533485434855348563485734858348593486034861348623486334864348653486634867348683486934870348713487234873348743487534876348773487834879348803488134882348833488434885348863488734888348893489034891348923489334894348953489634897348983489934900349013490234903349043490534906349073490834909349103491134912349133491434915349163491734918349193492034921349223492334924349253492634927349283492934930349313493234933349343493534936349373493834939349403494134942349433494434945349463494734948349493495034951349523495334954349553495634957349583495934960349613496234963349643496534966349673496834969349703497134972349733497434975349763497734978349793498034981349823498334984349853498634987349883498934990349913499234993349943499534996349973499834999350003500135002350033500435005350063500735008350093501035011350123501335014350153501635017350183501935020350213502235023350243502535026350273502835029350303503135032350333503435035350363503735038350393504035041350423504335044350453504635047350483504935050350513505235053350543505535056350573505835059350603506135062350633506435065350663506735068350693507035071350723507335074350753507635077350783507935080350813508235083350843508535086350873508835089350903509135092350933509435095350963509735098350993510035101351023510335104351053510635107351083510935110351113511235113351143511535116351173511835119351203512135122351233512435125351263512735128351293513035131351323513335134351353513635137351383513935140351413514235143351443514535146351473514835149351503515135152351533515435155351563515735158351593516035161351623516335164351653516635167351683516935170351713517235173351743517535176351773517835179351803518135182351833518435185351863518735188351893519035191351923519335194351953519635197351983519935200352013520235203352043520535206352073520835209352103521135212352133521435215352163521735218352193522035221352223522335224352253522635227352283522935230352313523235233352343523535236352373523835239352403524135242352433524435245352463524735248352493525035251352523525335254352553525635257352583525935260352613526235263352643526535266352673526835269352703527135272352733527435275352763527735278352793528035281352823528335284352853528635287352883528935290352913529235293352943529535296352973529835299353003530135302353033530435305353063530735308353093531035311353123531335314353153531635317353183531935320353213532235323353243532535326353273532835329353303533135332353333533435335353363533735338353393534035341353423534335344353453534635347353483534935350353513535235353353543535535356353573535835359353603536135362353633536435365353663536735368353693537035371353723537335374353753537635377353783537935380353813538235383353843538535386353873538835389353903539135392353933539435395353963539735398353993540035401354023540335404354053540635407354083540935410354113541235413354143541535416354173541835419354203542135422354233542435425354263542735428354293543035431354323543335434354353543635437354383543935440354413544235443354443544535446354473544835449354503545135452354533545435455354563545735458354593546035461354623546335464354653546635467354683546935470354713547235473354743547535476354773547835479354803548135482354833548435485354863548735488354893549035491354923549335494354953549635497354983549935500355013550235503355043550535506355073550835509355103551135512355133551435515355163551735518355193552035521355223552335524355253552635527355283552935530355313553235533355343553535536355373553835539355403554135542355433554435545355463554735548355493555035551355523555335554355553555635557355583555935560355613556235563355643556535566355673556835569355703557135572355733557435575355763557735578355793558035581355823558335584355853558635587355883558935590355913559235593355943559535596355973559835599356003560135602356033560435605356063560735608356093561035611356123561335614356153561635617356183561935620356213562235623356243562535626356273562835629356303563135632356333563435635356363563735638356393564035641356423564335644356453564635647356483564935650356513565235653356543565535656356573565835659356603566135662356633566435665356663566735668356693567035671356723567335674356753567635677356783567935680356813568235683356843568535686356873568835689356903569135692356933569435695356963569735698356993570035701357023570335704357053570635707357083570935710357113571235713357143571535716357173571835719357203572135722357233572435725357263572735728357293573035731357323573335734357353573635737357383573935740357413574235743357443574535746357473574835749357503575135752357533575435755357563575735758357593576035761357623576335764357653576635767357683576935770357713577235773357743577535776357773577835779357803578135782357833578435785357863578735788357893579035791357923579335794357953579635797357983579935800358013580235803358043580535806358073580835809358103581135812358133581435815358163581735818358193582035821358223582335824358253582635827358283582935830358313583235833358343583535836358373583835839358403584135842358433584435845358463584735848358493585035851358523585335854358553585635857358583585935860358613586235863358643586535866358673586835869358703587135872358733587435875358763587735878358793588035881358823588335884358853588635887358883588935890358913589235893358943589535896358973589835899359003590135902359033590435905359063590735908359093591035911359123591335914359153591635917359183591935920359213592235923359243592535926359273592835929359303593135932359333593435935359363593735938359393594035941359423594335944359453594635947359483594935950359513595235953359543595535956359573595835959359603596135962359633596435965359663596735968359693597035971359723597335974359753597635977359783597935980359813598235983359843598535986359873598835989359903599135992359933599435995359963599735998359993600036001360023600336004360053600636007360083600936010360113601236013360143601536016360173601836019360203602136022360233602436025360263602736028360293603036031360323603336034360353603636037360383603936040360413604236043360443604536046360473604836049360503605136052360533605436055360563605736058360593606036061360623606336064360653606636067360683606936070360713607236073360743607536076360773607836079360803608136082360833608436085360863608736088360893609036091360923609336094360953609636097360983609936100361013610236103361043610536106361073610836109361103611136112361133611436115361163611736118361193612036121361223612336124361253612636127361283612936130361313613236133361343613536136361373613836139361403614136142361433614436145361463614736148361493615036151361523615336154361553615636157361583615936160361613616236163361643616536166361673616836169361703617136172361733617436175361763617736178361793618036181361823618336184361853618636187361883618936190361913619236193361943619536196361973619836199362003620136202362033620436205362063620736208362093621036211362123621336214362153621636217362183621936220362213622236223362243622536226362273622836229362303623136232362333623436235362363623736238362393624036241362423624336244362453624636247362483624936250362513625236253362543625536256362573625836259362603626136262362633626436265362663626736268362693627036271362723627336274362753627636277362783627936280362813628236283362843628536286362873628836289362903629136292362933629436295362963629736298362993630036301363023630336304363053630636307363083630936310363113631236313363143631536316363173631836319363203632136322363233632436325363263632736328363293633036331363323633336334363353633636337363383633936340363413634236343363443634536346363473634836349363503635136352363533635436355363563635736358363593636036361363623636336364363653636636367363683636936370363713637236373363743637536376363773637836379363803638136382363833638436385363863638736388363893639036391363923639336394363953639636397363983639936400364013640236403364043640536406364073640836409364103641136412364133641436415364163641736418364193642036421364223642336424364253642636427364283642936430364313643236433364343643536436364373643836439364403644136442364433644436445364463644736448364493645036451364523645336454364553645636457364583645936460364613646236463364643646536466364673646836469364703647136472364733647436475364763647736478364793648036481364823648336484364853648636487364883648936490364913649236493364943649536496364973649836499365003650136502365033650436505365063650736508365093651036511365123651336514365153651636517365183651936520365213652236523365243652536526365273652836529365303653136532365333653436535365363653736538365393654036541365423654336544365453654636547365483654936550365513655236553365543655536556365573655836559365603656136562365633656436565365663656736568365693657036571365723657336574365753657636577365783657936580365813658236583365843658536586365873658836589365903659136592365933659436595365963659736598365993660036601366023660336604366053660636607366083660936610366113661236613366143661536616366173661836619366203662136622366233662436625366263662736628366293663036631366323663336634366353663636637366383663936640366413664236643366443664536646366473664836649366503665136652366533665436655366563665736658366593666036661366623666336664366653666636667366683666936670366713667236673
  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.7">
  10. <title>API specification - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.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/crd/" class="md-nav__link">
  866. <span class="md-ellipsis">
  867. Kubernetes CRD
  868. </span>
  869. </a>
  870. </li>
  871. <li class="md-nav__item">
  872. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  873. <span class="md-ellipsis">
  874. IBM Secrets Manager
  875. </span>
  876. </a>
  877. </li>
  878. <li class="md-nav__item">
  879. <a href="../../provider/akeyless/" class="md-nav__link">
  880. <span class="md-ellipsis">
  881. Akeyless
  882. </span>
  883. </a>
  884. </li>
  885. <li class="md-nav__item">
  886. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  887. <span class="md-ellipsis">
  888. Yandex Certificate Manager
  889. </span>
  890. </a>
  891. </li>
  892. <li class="md-nav__item">
  893. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  894. <span class="md-ellipsis">
  895. Yandex Lockbox
  896. </span>
  897. </a>
  898. </li>
  899. <li class="md-nav__item">
  900. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  901. <span class="md-ellipsis">
  902. GitLab Variables
  903. </span>
  904. </a>
  905. </li>
  906. <li class="md-nav__item">
  907. <a href="../../provider/github/" class="md-nav__link">
  908. <span class="md-ellipsis">
  909. GitHub Actions and Dependabot Secrets
  910. </span>
  911. </a>
  912. </li>
  913. <li class="md-nav__item">
  914. <a href="../../provider/oracle-vault/" class="md-nav__link">
  915. <span class="md-ellipsis">
  916. Oracle Vault
  917. </span>
  918. </a>
  919. </li>
  920. <li class="md-nav__item">
  921. <a href="../../provider/ovhcloud/" class="md-nav__link">
  922. <span class="md-ellipsis">
  923. OVHcloud
  924. </span>
  925. </a>
  926. </li>
  927. <li class="md-nav__item">
  928. <a href="../../provider/1password-automation/" class="md-nav__link">
  929. <span class="md-ellipsis">
  930. 1Password Connect Server
  931. </span>
  932. </a>
  933. </li>
  934. <li class="md-nav__item">
  935. <a href="../../provider/1password-sdk/" class="md-nav__link">
  936. <span class="md-ellipsis">
  937. 1Password SDK
  938. </span>
  939. </a>
  940. </li>
  941. <li class="md-nav__item">
  942. <a href="../../provider/webhook/" class="md-nav__link">
  943. <span class="md-ellipsis">
  944. Webhook
  945. </span>
  946. </a>
  947. </li>
  948. <li class="md-nav__item">
  949. <a href="../../provider/fake/" class="md-nav__link">
  950. <span class="md-ellipsis">
  951. Fake
  952. </span>
  953. </a>
  954. </li>
  955. <li class="md-nav__item">
  956. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  957. <span class="md-ellipsis">
  958. senhasegura DevOps Secrets Management (DSM)
  959. </span>
  960. </a>
  961. </li>
  962. <li class="md-nav__item">
  963. <a href="../../provider/doppler/" class="md-nav__link">
  964. <span class="md-ellipsis">
  965. Doppler
  966. </span>
  967. </a>
  968. </li>
  969. <li class="md-nav__item">
  970. <a href="../../provider/keeper-security/" class="md-nav__link">
  971. <span class="md-ellipsis">
  972. Keeper Security
  973. </span>
  974. </a>
  975. </li>
  976. <li class="md-nav__item">
  977. <a href="../../provider/cloak/" class="md-nav__link">
  978. <span class="md-ellipsis">
  979. Cloak End 2 End Encrypted Secrets
  980. </span>
  981. </a>
  982. </li>
  983. <li class="md-nav__item">
  984. <a href="../../provider/scaleway/" class="md-nav__link">
  985. <span class="md-ellipsis">
  986. Scaleway
  987. </span>
  988. </a>
  989. </li>
  990. <li class="md-nav__item">
  991. <a href="../../provider/delinea/" class="md-nav__link">
  992. <span class="md-ellipsis">
  993. Delinea
  994. </span>
  995. </a>
  996. </li>
  997. <li class="md-nav__item">
  998. <a href="../../provider/secretserver/" class="md-nav__link">
  999. <span class="md-ellipsis">
  1000. Secret Server
  1001. </span>
  1002. </a>
  1003. </li>
  1004. <li class="md-nav__item">
  1005. <a href="../../provider/passbolt/" class="md-nav__link">
  1006. <span class="md-ellipsis">
  1007. Passbolt
  1008. </span>
  1009. </a>
  1010. </li>
  1011. <li class="md-nav__item">
  1012. <a href="../../provider/pulumi/" class="md-nav__link">
  1013. <span class="md-ellipsis">
  1014. Pulumi ESC
  1015. </span>
  1016. </a>
  1017. </li>
  1018. <li class="md-nav__item">
  1019. <a href="../../provider/onboardbase/" class="md-nav__link">
  1020. <span class="md-ellipsis">
  1021. Onboardbase
  1022. </span>
  1023. </a>
  1024. </li>
  1025. <li class="md-nav__item">
  1026. <a href="../../provider-passworddepot/" class="md-nav__link">
  1027. <span class="md-ellipsis">
  1028. Password Depot
  1029. </span>
  1030. </a>
  1031. </li>
  1032. <li class="md-nav__item">
  1033. <a href="../../provider/fortanix/" class="md-nav__link">
  1034. <span class="md-ellipsis">
  1035. Fortanix
  1036. </span>
  1037. </a>
  1038. </li>
  1039. <li class="md-nav__item">
  1040. <a href="../../provider/infisical/" class="md-nav__link">
  1041. <span class="md-ellipsis">
  1042. Infisical
  1043. </span>
  1044. </a>
  1045. </li>
  1046. <li class="md-nav__item">
  1047. <a href="../../provider/previder/" class="md-nav__link">
  1048. <span class="md-ellipsis">
  1049. Previder
  1050. </span>
  1051. </a>
  1052. </li>
  1053. <li class="md-nav__item">
  1054. <a href="../../provider/openbao/" class="md-nav__link">
  1055. <span class="md-ellipsis">
  1056. OpenBao
  1057. </span>
  1058. </a>
  1059. </li>
  1060. <li class="md-nav__item">
  1061. <a href="../../provider/volcengine/" class="md-nav__link">
  1062. <span class="md-ellipsis">
  1063. Volcengine
  1064. </span>
  1065. </a>
  1066. </li>
  1067. <li class="md-nav__item">
  1068. <a href="../../provider/ngrok/" class="md-nav__link">
  1069. <span class="md-ellipsis">
  1070. ngrok
  1071. </span>
  1072. </a>
  1073. </li>
  1074. <li class="md-nav__item">
  1075. <a href="../../provider/devolutions-server/" class="md-nav__link">
  1076. <span class="md-ellipsis">
  1077. Devolutions Server
  1078. </span>
  1079. </a>
  1080. </li>
  1081. <li class="md-nav__item">
  1082. <a href="../../provider/nebius-mysterybox/" class="md-nav__link">
  1083. <span class="md-ellipsis">
  1084. Nebius MysteryBox
  1085. </span>
  1086. </a>
  1087. </li>
  1088. </ul>
  1089. </nav>
  1090. </li>
  1091. <li class="md-nav__item md-nav__item--nested">
  1092. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  1093. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  1094. <span class="md-ellipsis">
  1095. Examples
  1096. </span>
  1097. <span class="md-nav__icon md-icon"></span>
  1098. </label>
  1099. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  1100. <label class="md-nav__title" for="__nav_5">
  1101. <span class="md-nav__icon md-icon"></span>
  1102. Examples
  1103. </label>
  1104. <ul class="md-nav__list" data-md-scrollfix>
  1105. <li class="md-nav__item">
  1106. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  1107. <span class="md-ellipsis">
  1108. FluxCD
  1109. </span>
  1110. </a>
  1111. </li>
  1112. <li class="md-nav__item">
  1113. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  1114. <span class="md-ellipsis">
  1115. Anchore Engine
  1116. </span>
  1117. </a>
  1118. </li>
  1119. <li class="md-nav__item">
  1120. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  1121. <span class="md-ellipsis">
  1122. Jenkins
  1123. </span>
  1124. </a>
  1125. </li>
  1126. <li class="md-nav__item">
  1127. <a href="../../examples/bitwarden/" class="md-nav__link">
  1128. <span class="md-ellipsis">
  1129. Bitwarden
  1130. </span>
  1131. </a>
  1132. </li>
  1133. </ul>
  1134. </nav>
  1135. </li>
  1136. <li class="md-nav__item md-nav__item--nested">
  1137. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  1138. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  1139. <span class="md-ellipsis">
  1140. Community
  1141. </span>
  1142. <span class="md-nav__icon md-icon"></span>
  1143. </label>
  1144. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  1145. <label class="md-nav__title" for="__nav_6">
  1146. <span class="md-nav__icon md-icon"></span>
  1147. Community
  1148. </label>
  1149. <ul class="md-nav__list" data-md-scrollfix>
  1150. <li class="md-nav__item md-nav__item--nested">
  1151. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  1152. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  1153. <span class="md-ellipsis">
  1154. Contributing
  1155. </span>
  1156. <span class="md-nav__icon md-icon"></span>
  1157. </label>
  1158. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  1159. <label class="md-nav__title" for="__nav_6_1">
  1160. <span class="md-nav__icon md-icon"></span>
  1161. Contributing
  1162. </label>
  1163. <ul class="md-nav__list" data-md-scrollfix>
  1164. <li class="md-nav__item">
  1165. <a href="../../contributing/devguide/" class="md-nav__link">
  1166. <span class="md-ellipsis">
  1167. Developer guide
  1168. </span>
  1169. </a>
  1170. </li>
  1171. <li class="md-nav__item">
  1172. <a href="../../contributing/process/" class="md-nav__link">
  1173. <span class="md-ellipsis">
  1174. Contributing Process
  1175. </span>
  1176. </a>
  1177. </li>
  1178. <li class="md-nav__item">
  1179. <a href="../../contributing/release/" class="md-nav__link">
  1180. <span class="md-ellipsis">
  1181. Release Process
  1182. </span>
  1183. </a>
  1184. </li>
  1185. <li class="md-nav__item">
  1186. <a href="../../contributing/coc/" class="md-nav__link">
  1187. <span class="md-ellipsis">
  1188. Code of Conduct
  1189. </span>
  1190. </a>
  1191. </li>
  1192. <li class="md-nav__item">
  1193. <a href="../../contributing/calendar/" class="md-nav__link">
  1194. <span class="md-ellipsis">
  1195. Community meetings calendar
  1196. </span>
  1197. </a>
  1198. </li>
  1199. <li class="md-nav__item">
  1200. <a href="../../contributing/roadmap/" class="md-nav__link">
  1201. <span class="md-ellipsis">
  1202. Roadmap
  1203. </span>
  1204. </a>
  1205. </li>
  1206. <li class="md-nav__item">
  1207. <a href="../../contributing/burnout-mitigation/" class="md-nav__link">
  1208. <span class="md-ellipsis">
  1209. Burnout Prevention
  1210. </span>
  1211. </a>
  1212. </li>
  1213. <li class="md-nav__item">
  1214. <a href="../../contributing/llm-policy/" class="md-nav__link">
  1215. <span class="md-ellipsis">
  1216. LLM Policy
  1217. </span>
  1218. </a>
  1219. </li>
  1220. </ul>
  1221. </nav>
  1222. </li>
  1223. <li class="md-nav__item md-nav__item--nested">
  1224. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1225. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1226. <span class="md-ellipsis">
  1227. External Resources
  1228. </span>
  1229. <span class="md-nav__icon md-icon"></span>
  1230. </label>
  1231. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1232. <label class="md-nav__title" for="__nav_6_2">
  1233. <span class="md-nav__icon md-icon"></span>
  1234. External Resources
  1235. </label>
  1236. <ul class="md-nav__list" data-md-scrollfix>
  1237. <li class="md-nav__item">
  1238. <a href="../../eso-talks/" class="md-nav__link">
  1239. <span class="md-ellipsis">
  1240. Talks
  1241. </span>
  1242. </a>
  1243. </li>
  1244. <li class="md-nav__item">
  1245. <a href="../../eso-demos/" class="md-nav__link">
  1246. <span class="md-ellipsis">
  1247. Demos
  1248. </span>
  1249. </a>
  1250. </li>
  1251. <li class="md-nav__item">
  1252. <a href="../../eso-blogs/" class="md-nav__link">
  1253. <span class="md-ellipsis">
  1254. Blogs
  1255. </span>
  1256. </a>
  1257. </li>
  1258. <li class="md-nav__item">
  1259. <a href="../../eso-tools/" class="md-nav__link">
  1260. <span class="md-ellipsis">
  1261. Tools
  1262. </span>
  1263. </a>
  1264. </li>
  1265. </ul>
  1266. </nav>
  1267. </li>
  1268. </ul>
  1269. </nav>
  1270. </li>
  1271. </ul>
  1272. </nav>
  1273. </div>
  1274. </div>
  1275. </div>
  1276. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1277. <div class="md-sidebar__scrollwrap">
  1278. <div class="md-sidebar__inner">
  1279. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1280. </nav>
  1281. </div>
  1282. </div>
  1283. </div>
  1284. <div class="md-content" data-md-component="content">
  1285. <article class="md-content__inner md-typeset">
  1286. <p>Packages:</p>
  1287. <ul>
  1288. <li>
  1289. <a href="#external-secrets.io%2fv1">external-secrets.io/v1</a>
  1290. </li>
  1291. <li>
  1292. <a href="#external-secrets.io%2fv1alpha1">external-secrets.io/v1alpha1</a>
  1293. </li>
  1294. <li>
  1295. <a href="#external-secrets.io%2fv1beta1">external-secrets.io/v1beta1</a>
  1296. </li>
  1297. <li>
  1298. <a href="#generators.external-secrets.io%2fv1alpha1">generators.external-secrets.io/v1alpha1</a>
  1299. </li>
  1300. </ul>
  1301. <h2 id="external-secrets.io/v1">external-secrets.io/v1</h2>
  1302. <p>
  1303. <p>Package v1 contains resources for external-secrets</p>
  1304. </p>
  1305. <p>Resource Types:</p>
  1306. <ul></ul>
  1307. <h3 id="external-secrets.io/v1.AWSAuth">AWSAuth
  1308. </h3>
  1309. <p>
  1310. (<em>Appears on:</em>
  1311. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1312. </p>
  1313. <p>
  1314. <p>AWSAuth tells the controller how to do authentication with aws.
  1315. Only one of secretRef or jwt can be specified.
  1316. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  1317. </p>
  1318. <table>
  1319. <thead>
  1320. <tr>
  1321. <th>Field</th>
  1322. <th>Description</th>
  1323. </tr>
  1324. </thead>
  1325. <tbody>
  1326. <tr>
  1327. <td>
  1328. <code>secretRef</code></br>
  1329. <em>
  1330. <a href="#external-secrets.io/v1.AWSAuthSecretRef">
  1331. AWSAuthSecretRef
  1332. </a>
  1333. </em>
  1334. </td>
  1335. <td>
  1336. <em>(Optional)</em>
  1337. </td>
  1338. </tr>
  1339. <tr>
  1340. <td>
  1341. <code>jwt</code></br>
  1342. <em>
  1343. <a href="#external-secrets.io/v1.AWSJWTAuth">
  1344. AWSJWTAuth
  1345. </a>
  1346. </em>
  1347. </td>
  1348. <td>
  1349. <em>(Optional)</em>
  1350. </td>
  1351. </tr>
  1352. </tbody>
  1353. </table>
  1354. <h3 id="external-secrets.io/v1.AWSAuthSecretRef">AWSAuthSecretRef
  1355. </h3>
  1356. <p>
  1357. (<em>Appears on:</em>
  1358. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1359. </p>
  1360. <p>
  1361. <p>AWSAuthSecretRef holds secret references for AWS credentials
  1362. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  1363. </p>
  1364. <table>
  1365. <thead>
  1366. <tr>
  1367. <th>Field</th>
  1368. <th>Description</th>
  1369. </tr>
  1370. </thead>
  1371. <tbody>
  1372. <tr>
  1373. <td>
  1374. <code>accessKeyIDSecretRef</code></br>
  1375. <em>
  1376. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1377. External Secrets meta/v1.SecretKeySelector
  1378. </a>
  1379. </em>
  1380. </td>
  1381. <td>
  1382. <p>The AccessKeyID is used for authentication</p>
  1383. </td>
  1384. </tr>
  1385. <tr>
  1386. <td>
  1387. <code>secretAccessKeySecretRef</code></br>
  1388. <em>
  1389. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1390. External Secrets meta/v1.SecretKeySelector
  1391. </a>
  1392. </em>
  1393. </td>
  1394. <td>
  1395. <p>The SecretAccessKey is used for authentication</p>
  1396. </td>
  1397. </tr>
  1398. <tr>
  1399. <td>
  1400. <code>sessionTokenSecretRef</code></br>
  1401. <em>
  1402. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1403. External Secrets meta/v1.SecretKeySelector
  1404. </a>
  1405. </em>
  1406. </td>
  1407. <td>
  1408. <p>The SessionToken used for authentication
  1409. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  1410. 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>
  1411. </td>
  1412. </tr>
  1413. </tbody>
  1414. </table>
  1415. <h3 id="external-secrets.io/v1.AWSJWTAuth">AWSJWTAuth
  1416. </h3>
  1417. <p>
  1418. (<em>Appears on:</em>
  1419. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1420. </p>
  1421. <p>
  1422. <p>AWSJWTAuth stores reference to Authenticate against AWS using service account tokens.</p>
  1423. </p>
  1424. <table>
  1425. <thead>
  1426. <tr>
  1427. <th>Field</th>
  1428. <th>Description</th>
  1429. </tr>
  1430. </thead>
  1431. <tbody>
  1432. <tr>
  1433. <td>
  1434. <code>serviceAccountRef</code></br>
  1435. <em>
  1436. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1437. External Secrets meta/v1.ServiceAccountSelector
  1438. </a>
  1439. </em>
  1440. </td>
  1441. <td>
  1442. </td>
  1443. </tr>
  1444. </tbody>
  1445. </table>
  1446. <h3 id="external-secrets.io/v1.AWSProvider">AWSProvider
  1447. </h3>
  1448. <p>
  1449. (<em>Appears on:</em>
  1450. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1451. </p>
  1452. <p>
  1453. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  1454. </p>
  1455. <table>
  1456. <thead>
  1457. <tr>
  1458. <th>Field</th>
  1459. <th>Description</th>
  1460. </tr>
  1461. </thead>
  1462. <tbody>
  1463. <tr>
  1464. <td>
  1465. <code>service</code></br>
  1466. <em>
  1467. <a href="#external-secrets.io/v1.AWSServiceType">
  1468. AWSServiceType
  1469. </a>
  1470. </em>
  1471. </td>
  1472. <td>
  1473. <p>Service defines which service should be used to fetch the secrets</p>
  1474. </td>
  1475. </tr>
  1476. <tr>
  1477. <td>
  1478. <code>auth</code></br>
  1479. <em>
  1480. <a href="#external-secrets.io/v1.AWSAuth">
  1481. AWSAuth
  1482. </a>
  1483. </em>
  1484. </td>
  1485. <td>
  1486. <em>(Optional)</em>
  1487. <p>Auth defines the information necessary to authenticate against AWS
  1488. if not set aws sdk will infer credentials from your environment
  1489. 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>
  1490. </td>
  1491. </tr>
  1492. <tr>
  1493. <td>
  1494. <code>role</code></br>
  1495. <em>
  1496. string
  1497. </em>
  1498. </td>
  1499. <td>
  1500. <em>(Optional)</em>
  1501. <p>Role is a Role ARN which the provider will assume</p>
  1502. </td>
  1503. </tr>
  1504. <tr>
  1505. <td>
  1506. <code>region</code></br>
  1507. <em>
  1508. string
  1509. </em>
  1510. </td>
  1511. <td>
  1512. <p>AWS Region to be used for the provider</p>
  1513. </td>
  1514. </tr>
  1515. <tr>
  1516. <td>
  1517. <code>additionalRoles</code></br>
  1518. <em>
  1519. []string
  1520. </em>
  1521. </td>
  1522. <td>
  1523. <em>(Optional)</em>
  1524. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  1525. </td>
  1526. </tr>
  1527. <tr>
  1528. <td>
  1529. <code>externalID</code></br>
  1530. <em>
  1531. string
  1532. </em>
  1533. </td>
  1534. <td>
  1535. <p>AWS External ID set on assumed IAM roles</p>
  1536. </td>
  1537. </tr>
  1538. <tr>
  1539. <td>
  1540. <code>sessionTags</code></br>
  1541. <em>
  1542. <a href="#external-secrets.io/v1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag">
  1543. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag
  1544. </a>
  1545. </em>
  1546. </td>
  1547. <td>
  1548. <em>(Optional)</em>
  1549. <p>AWS STS assume role session tags</p>
  1550. </td>
  1551. </tr>
  1552. <tr>
  1553. <td>
  1554. <code>secretsManager</code></br>
  1555. <em>
  1556. <a href="#external-secrets.io/v1.SecretsManager">
  1557. SecretsManager
  1558. </a>
  1559. </em>
  1560. </td>
  1561. <td>
  1562. <em>(Optional)</em>
  1563. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  1564. </td>
  1565. </tr>
  1566. <tr>
  1567. <td>
  1568. <code>transitiveTagKeys</code></br>
  1569. <em>
  1570. []string
  1571. </em>
  1572. </td>
  1573. <td>
  1574. <em>(Optional)</em>
  1575. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  1576. </td>
  1577. </tr>
  1578. <tr>
  1579. <td>
  1580. <code>sessionTagsPolicy</code></br>
  1581. <em>
  1582. <a href="#external-secrets.io/v1.SessionTagsPolicy">
  1583. SessionTagsPolicy
  1584. </a>
  1585. </em>
  1586. </td>
  1587. <td>
  1588. <em>(Optional)</em>
  1589. <p>SessionTagsPolicy controls whether and how STS session tags are added when assuming roles.
  1590. None (default): no tags are added.
  1591. Simple: automatically adds esoNamespace (from the ExternalSecret), esoStoreName, and esoStoreKind tags.
  1592. Custom: adds esoNamespace, esoStoreName, and esoStoreKind plus any tags defined in CustomSessionTags.
  1593. Note: the IAM role must have sts:TagSession permission when using Simple or Custom.</p>
  1594. </td>
  1595. </tr>
  1596. <tr>
  1597. <td>
  1598. <code>customSessionTags</code></br>
  1599. <em>
  1600. map[string]string
  1601. </em>
  1602. </td>
  1603. <td>
  1604. <em>(Optional)</em>
  1605. <p>CustomSessionTags defines additional STS session tags to include when SessionTagsPolicy is Custom.
  1606. These are merged with the automatically injected esoNamespace, esoStoreName, and esoStoreKind tags.</p>
  1607. </td>
  1608. </tr>
  1609. <tr>
  1610. <td>
  1611. <code>prefix</code></br>
  1612. <em>
  1613. string
  1614. </em>
  1615. </td>
  1616. <td>
  1617. <em>(Optional)</em>
  1618. <p>Prefix adds a prefix to all retrieved values.</p>
  1619. </td>
  1620. </tr>
  1621. </tbody>
  1622. </table>
  1623. <h3 id="external-secrets.io/v1.AWSServiceType">AWSServiceType
  1624. (<code>string</code> alias)</p></h3>
  1625. <p>
  1626. (<em>Appears on:</em>
  1627. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1628. </p>
  1629. <p>
  1630. <p>AWSServiceType is a enum that defines the service/API that is used to fetch the secrets.</p>
  1631. </p>
  1632. <table>
  1633. <thead>
  1634. <tr>
  1635. <th>Value</th>
  1636. <th>Description</th>
  1637. </tr>
  1638. </thead>
  1639. <tbody><tr><td><p>&#34;CertificateManager&#34;</p></td>
  1640. <td><p>AWSServiceCertificateManager is the AWS Certificate Manager service.
  1641. 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>
  1642. </td>
  1643. </tr><tr><td><p>&#34;ParameterStore&#34;</p></td>
  1644. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  1645. 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>
  1646. </td>
  1647. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  1648. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  1649. 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>
  1650. </td>
  1651. </tr></tbody>
  1652. </table>
  1653. <h3 id="external-secrets.io/v1.AkeylessAuth">AkeylessAuth
  1654. </h3>
  1655. <p>
  1656. (<em>Appears on:</em>
  1657. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>)
  1658. </p>
  1659. <p>
  1660. <p>AkeylessAuth configures how the operator authenticates with Akeyless.</p>
  1661. </p>
  1662. <table>
  1663. <thead>
  1664. <tr>
  1665. <th>Field</th>
  1666. <th>Description</th>
  1667. </tr>
  1668. </thead>
  1669. <tbody>
  1670. <tr>
  1671. <td>
  1672. <code>secretRef</code></br>
  1673. <em>
  1674. <a href="#external-secrets.io/v1.AkeylessAuthSecretRef">
  1675. AkeylessAuthSecretRef
  1676. </a>
  1677. </em>
  1678. </td>
  1679. <td>
  1680. <em>(Optional)</em>
  1681. <p>Reference to a Secret that contains the details
  1682. to authenticate with Akeyless.</p>
  1683. </td>
  1684. </tr>
  1685. <tr>
  1686. <td>
  1687. <code>kubernetesAuth</code></br>
  1688. <em>
  1689. <a href="#external-secrets.io/v1.AkeylessKubernetesAuth">
  1690. AkeylessKubernetesAuth
  1691. </a>
  1692. </em>
  1693. </td>
  1694. <td>
  1695. <em>(Optional)</em>
  1696. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  1697. token stored in the named Secret resource.</p>
  1698. </td>
  1699. </tr>
  1700. <tr>
  1701. <td>
  1702. <code>serviceAccountRef</code></br>
  1703. <em>
  1704. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1705. External Secrets meta/v1.ServiceAccountSelector
  1706. </a>
  1707. </em>
  1708. </td>
  1709. <td>
  1710. <em>(Optional)</em>
  1711. <p>ServiceAccountRef specifies a Kubernetes ServiceAccount used for azure_ad
  1712. authentication on AKS Workload Identity. The operator obtains a federated
  1713. identity token from this ServiceAccount via the TokenRequest API instead
  1714. of using the ESO controller pod identity. Ignored for other access types.</p>
  1715. </td>
  1716. </tr>
  1717. </tbody>
  1718. </table>
  1719. <h3 id="external-secrets.io/v1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  1720. </h3>
  1721. <p>
  1722. (<em>Appears on:</em>
  1723. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1724. </p>
  1725. <p>
  1726. <p>AkeylessAuthSecretRef references a Secret that contains the details
  1727. to authenticate with Akeyless.
  1728. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  1729. </p>
  1730. <table>
  1731. <thead>
  1732. <tr>
  1733. <th>Field</th>
  1734. <th>Description</th>
  1735. </tr>
  1736. </thead>
  1737. <tbody>
  1738. <tr>
  1739. <td>
  1740. <code>accessID</code></br>
  1741. <em>
  1742. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1743. External Secrets meta/v1.SecretKeySelector
  1744. </a>
  1745. </em>
  1746. </td>
  1747. <td>
  1748. <p>The SecretAccessID is used for authentication</p>
  1749. </td>
  1750. </tr>
  1751. <tr>
  1752. <td>
  1753. <code>accessType</code></br>
  1754. <em>
  1755. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1756. External Secrets meta/v1.SecretKeySelector
  1757. </a>
  1758. </em>
  1759. </td>
  1760. <td>
  1761. </td>
  1762. </tr>
  1763. <tr>
  1764. <td>
  1765. <code>accessTypeParam</code></br>
  1766. <em>
  1767. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1768. External Secrets meta/v1.SecretKeySelector
  1769. </a>
  1770. </em>
  1771. </td>
  1772. <td>
  1773. </td>
  1774. </tr>
  1775. </tbody>
  1776. </table>
  1777. <h3 id="external-secrets.io/v1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  1778. </h3>
  1779. <p>
  1780. (<em>Appears on:</em>
  1781. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1782. </p>
  1783. <p>
  1784. <p>AkeylessKubernetesAuth configures Kubernetes authentication with Akeyless.
  1785. It authenticates with Kubernetes ServiceAccount token stored.</p>
  1786. </p>
  1787. <table>
  1788. <thead>
  1789. <tr>
  1790. <th>Field</th>
  1791. <th>Description</th>
  1792. </tr>
  1793. </thead>
  1794. <tbody>
  1795. <tr>
  1796. <td>
  1797. <code>accessID</code></br>
  1798. <em>
  1799. string
  1800. </em>
  1801. </td>
  1802. <td>
  1803. <p>the Akeyless Kubernetes auth-method access-id</p>
  1804. </td>
  1805. </tr>
  1806. <tr>
  1807. <td>
  1808. <code>k8sConfName</code></br>
  1809. <em>
  1810. string
  1811. </em>
  1812. </td>
  1813. <td>
  1814. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  1815. </td>
  1816. </tr>
  1817. <tr>
  1818. <td>
  1819. <code>serviceAccountRef</code></br>
  1820. <em>
  1821. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1822. External Secrets meta/v1.ServiceAccountSelector
  1823. </a>
  1824. </em>
  1825. </td>
  1826. <td>
  1827. <em>(Optional)</em>
  1828. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  1829. If the service account is specified, the service account secret token JWT will be used
  1830. for authenticating with Akeyless. If the service account selector is not supplied,
  1831. the secretRef will be used instead.</p>
  1832. </td>
  1833. </tr>
  1834. <tr>
  1835. <td>
  1836. <code>secretRef</code></br>
  1837. <em>
  1838. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1839. External Secrets meta/v1.SecretKeySelector
  1840. </a>
  1841. </em>
  1842. </td>
  1843. <td>
  1844. <em>(Optional)</em>
  1845. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  1846. for authenticating with Akeyless. If a name is specified without a key,
  1847. <code>token</code> is the default. If one is not specified, the one bound to
  1848. the controller will be used.</p>
  1849. </td>
  1850. </tr>
  1851. </tbody>
  1852. </table>
  1853. <h3 id="external-secrets.io/v1.AkeylessProvider">AkeylessProvider
  1854. </h3>
  1855. <p>
  1856. (<em>Appears on:</em>
  1857. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1858. </p>
  1859. <p>
  1860. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  1861. </p>
  1862. <table>
  1863. <thead>
  1864. <tr>
  1865. <th>Field</th>
  1866. <th>Description</th>
  1867. </tr>
  1868. </thead>
  1869. <tbody>
  1870. <tr>
  1871. <td>
  1872. <code>akeylessGWApiURL</code></br>
  1873. <em>
  1874. string
  1875. </em>
  1876. </td>
  1877. <td>
  1878. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  1879. </td>
  1880. </tr>
  1881. <tr>
  1882. <td>
  1883. <code>ignoreCache</code></br>
  1884. <em>
  1885. bool
  1886. </em>
  1887. </td>
  1888. <td>
  1889. <em>(Optional)</em>
  1890. <p>IgnoreCache bypasses the Gateway cache for secret reads when true.
  1891. Only relevant when akeylessGWApiURL points to an Akeyless Gateway.</p>
  1892. </td>
  1893. </tr>
  1894. <tr>
  1895. <td>
  1896. <code>authSecretRef</code></br>
  1897. <em>
  1898. <a href="#external-secrets.io/v1.AkeylessAuth">
  1899. AkeylessAuth
  1900. </a>
  1901. </em>
  1902. </td>
  1903. <td>
  1904. <p>Auth configures how the operator authenticates with Akeyless.</p>
  1905. </td>
  1906. </tr>
  1907. <tr>
  1908. <td>
  1909. <code>caBundle</code></br>
  1910. <em>
  1911. []byte
  1912. </em>
  1913. </td>
  1914. <td>
  1915. <em>(Optional)</em>
  1916. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  1917. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  1918. are used to validate the TLS connection.</p>
  1919. </td>
  1920. </tr>
  1921. <tr>
  1922. <td>
  1923. <code>caProvider</code></br>
  1924. <em>
  1925. <a href="#external-secrets.io/v1.CAProvider">
  1926. CAProvider
  1927. </a>
  1928. </em>
  1929. </td>
  1930. <td>
  1931. <em>(Optional)</em>
  1932. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  1933. </td>
  1934. </tr>
  1935. </tbody>
  1936. </table>
  1937. <h3 id="external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol
  1938. </h3>
  1939. <p>
  1940. (<em>Appears on:</em>
  1941. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  1942. </p>
  1943. <p>
  1944. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  1945. </p>
  1946. <table>
  1947. <thead>
  1948. <tr>
  1949. <th>Field</th>
  1950. <th>Description</th>
  1951. </tr>
  1952. </thead>
  1953. <tbody>
  1954. <tr>
  1955. <td>
  1956. <code>ntlm</code></br>
  1957. <em>
  1958. <a href="#external-secrets.io/v1.NTLMProtocol">
  1959. NTLMProtocol
  1960. </a>
  1961. </em>
  1962. </td>
  1963. <td>
  1964. <em>(Optional)</em>
  1965. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  1966. </td>
  1967. </tr>
  1968. </tbody>
  1969. </table>
  1970. <h3 id="external-secrets.io/v1.AwsAuthCredentials">AwsAuthCredentials
  1971. </h3>
  1972. <p>
  1973. (<em>Appears on:</em>
  1974. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1975. </p>
  1976. <p>
  1977. <p>AwsAuthCredentials represents the credentials for AWS authentication.</p>
  1978. </p>
  1979. <table>
  1980. <thead>
  1981. <tr>
  1982. <th>Field</th>
  1983. <th>Description</th>
  1984. </tr>
  1985. </thead>
  1986. <tbody>
  1987. <tr>
  1988. <td>
  1989. <code>identityId</code></br>
  1990. <em>
  1991. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1992. External Secrets meta/v1.SecretKeySelector
  1993. </a>
  1994. </em>
  1995. </td>
  1996. <td>
  1997. </td>
  1998. </tr>
  1999. </tbody>
  2000. </table>
  2001. <h3 id="external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig
  2002. </h3>
  2003. <p>
  2004. (<em>Appears on:</em>
  2005. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  2006. </p>
  2007. <p>
  2008. <p>AwsCredentialsConfig holds the region and the Secret reference which contains the AWS credentials.</p>
  2009. </p>
  2010. <table>
  2011. <thead>
  2012. <tr>
  2013. <th>Field</th>
  2014. <th>Description</th>
  2015. </tr>
  2016. </thead>
  2017. <tbody>
  2018. <tr>
  2019. <td>
  2020. <code>region</code></br>
  2021. <em>
  2022. string
  2023. </em>
  2024. </td>
  2025. <td>
  2026. <p>region is for configuring the AWS region to be used.</p>
  2027. </td>
  2028. </tr>
  2029. <tr>
  2030. <td>
  2031. <code>awsCredentialsSecretRef</code></br>
  2032. <em>
  2033. <a href="#external-secrets.io/v1.SecretReference">
  2034. SecretReference
  2035. </a>
  2036. </em>
  2037. </td>
  2038. <td>
  2039. <p>awsCredentialsSecretRef is the reference to the secret which holds the AWS credentials.
  2040. Secret should be created with below names for keys
  2041. - aws_access_key_id: Access Key ID, which is the unique identifier for the AWS account or the IAM user.
  2042. - aws_secret_access_key: Secret Access Key, which is used to authenticate requests made to AWS services.
  2043. - aws_session_token: Session Token, is the short-lived token to authenticate requests made to AWS services.</p>
  2044. </td>
  2045. </tr>
  2046. </tbody>
  2047. </table>
  2048. <h3 id="external-secrets.io/v1.AzureAuthCredentials">AzureAuthCredentials
  2049. </h3>
  2050. <p>
  2051. (<em>Appears on:</em>
  2052. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  2053. </p>
  2054. <p>
  2055. <p>AzureAuthCredentials represents the credentials for Azure authentication.</p>
  2056. </p>
  2057. <table>
  2058. <thead>
  2059. <tr>
  2060. <th>Field</th>
  2061. <th>Description</th>
  2062. </tr>
  2063. </thead>
  2064. <tbody>
  2065. <tr>
  2066. <td>
  2067. <code>identityId</code></br>
  2068. <em>
  2069. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2070. External Secrets meta/v1.SecretKeySelector
  2071. </a>
  2072. </em>
  2073. </td>
  2074. <td>
  2075. </td>
  2076. </tr>
  2077. <tr>
  2078. <td>
  2079. <code>resource</code></br>
  2080. <em>
  2081. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2082. External Secrets meta/v1.SecretKeySelector
  2083. </a>
  2084. </em>
  2085. </td>
  2086. <td>
  2087. <em>(Optional)</em>
  2088. </td>
  2089. </tr>
  2090. </tbody>
  2091. </table>
  2092. <h3 id="external-secrets.io/v1.AzureAuthType">AzureAuthType
  2093. (<code>string</code> alias)</p></h3>
  2094. <p>
  2095. (<em>Appears on:</em>
  2096. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2097. </p>
  2098. <p>
  2099. <p>AzureAuthType describes how to authenticate to the Azure Keyvault
  2100. Only one of the following auth types may be specified.
  2101. If none of the following auth type is specified, the default one
  2102. is ServicePrincipal.</p>
  2103. </p>
  2104. <table>
  2105. <thead>
  2106. <tr>
  2107. <th>Value</th>
  2108. <th>Description</th>
  2109. </tr>
  2110. </thead>
  2111. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  2112. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  2113. </td>
  2114. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  2115. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  2116. </td>
  2117. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  2118. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  2119. </td>
  2120. </tr></tbody>
  2121. </table>
  2122. <h3 id="external-secrets.io/v1.AzureCustomCloudConfig">AzureCustomCloudConfig
  2123. </h3>
  2124. <p>
  2125. (<em>Appears on:</em>
  2126. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2127. </p>
  2128. <p>
  2129. <p>AzureCustomCloudConfig specifies custom cloud configuration for private Azure environments
  2130. IMPORTANT: Custom cloud configuration is ONLY supported when UseAzureSDK is true.
  2131. The legacy go-autorest SDK does not support custom cloud endpoints.</p>
  2132. </p>
  2133. <table>
  2134. <thead>
  2135. <tr>
  2136. <th>Field</th>
  2137. <th>Description</th>
  2138. </tr>
  2139. </thead>
  2140. <tbody>
  2141. <tr>
  2142. <td>
  2143. <code>activeDirectoryEndpoint</code></br>
  2144. <em>
  2145. string
  2146. </em>
  2147. </td>
  2148. <td>
  2149. <p>ActiveDirectoryEndpoint is the AAD endpoint for authentication
  2150. Required when using custom cloud configuration</p>
  2151. </td>
  2152. </tr>
  2153. <tr>
  2154. <td>
  2155. <code>keyVaultEndpoint</code></br>
  2156. <em>
  2157. string
  2158. </em>
  2159. </td>
  2160. <td>
  2161. <em>(Optional)</em>
  2162. <p>KeyVaultEndpoint is the Key Vault service endpoint</p>
  2163. </td>
  2164. </tr>
  2165. <tr>
  2166. <td>
  2167. <code>keyVaultDNSSuffix</code></br>
  2168. <em>
  2169. string
  2170. </em>
  2171. </td>
  2172. <td>
  2173. <em>(Optional)</em>
  2174. <p>KeyVaultDNSSuffix is the DNS suffix for Key Vault URLs</p>
  2175. </td>
  2176. </tr>
  2177. <tr>
  2178. <td>
  2179. <code>resourceManagerEndpoint</code></br>
  2180. <em>
  2181. string
  2182. </em>
  2183. </td>
  2184. <td>
  2185. <em>(Optional)</em>
  2186. <p>ResourceManagerEndpoint is the Azure Resource Manager endpoint</p>
  2187. </td>
  2188. </tr>
  2189. </tbody>
  2190. </table>
  2191. <h3 id="external-secrets.io/v1.AzureEnvironmentType">AzureEnvironmentType
  2192. (<code>string</code> alias)</p></h3>
  2193. <p>
  2194. (<em>Appears on:</em>
  2195. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>,
  2196. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  2197. </p>
  2198. <p>
  2199. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  2200. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  2201. 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>
  2202. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud</p>
  2203. </p>
  2204. <table>
  2205. <thead>
  2206. <tr>
  2207. <th>Value</th>
  2208. <th>Description</th>
  2209. </tr>
  2210. </thead>
  2211. <tbody><tr><td><p>&#34;AzureStackCloud&#34;</p></td>
  2212. <td></td>
  2213. </tr><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  2214. <td></td>
  2215. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  2216. <td></td>
  2217. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  2218. <td></td>
  2219. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  2220. <td></td>
  2221. </tr></tbody>
  2222. </table>
  2223. <h3 id="external-secrets.io/v1.AzureKVAuth">AzureKVAuth
  2224. </h3>
  2225. <p>
  2226. (<em>Appears on:</em>
  2227. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2228. </p>
  2229. <p>
  2230. <p>AzureKVAuth is the configuration used to authenticate with Azure.</p>
  2231. </p>
  2232. <table>
  2233. <thead>
  2234. <tr>
  2235. <th>Field</th>
  2236. <th>Description</th>
  2237. </tr>
  2238. </thead>
  2239. <tbody>
  2240. <tr>
  2241. <td>
  2242. <code>clientId</code></br>
  2243. <em>
  2244. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2245. External Secrets meta/v1.SecretKeySelector
  2246. </a>
  2247. </em>
  2248. </td>
  2249. <td>
  2250. <em>(Optional)</em>
  2251. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  2252. </td>
  2253. </tr>
  2254. <tr>
  2255. <td>
  2256. <code>tenantId</code></br>
  2257. <em>
  2258. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2259. External Secrets meta/v1.SecretKeySelector
  2260. </a>
  2261. </em>
  2262. </td>
  2263. <td>
  2264. <em>(Optional)</em>
  2265. <p>The Azure tenantId of the managed identity used for authentication.</p>
  2266. </td>
  2267. </tr>
  2268. <tr>
  2269. <td>
  2270. <code>clientSecret</code></br>
  2271. <em>
  2272. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2273. External Secrets meta/v1.SecretKeySelector
  2274. </a>
  2275. </em>
  2276. </td>
  2277. <td>
  2278. <em>(Optional)</em>
  2279. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  2280. </td>
  2281. </tr>
  2282. <tr>
  2283. <td>
  2284. <code>clientCertificate</code></br>
  2285. <em>
  2286. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2287. External Secrets meta/v1.SecretKeySelector
  2288. </a>
  2289. </em>
  2290. </td>
  2291. <td>
  2292. <em>(Optional)</em>
  2293. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  2294. </td>
  2295. </tr>
  2296. </tbody>
  2297. </table>
  2298. <h3 id="external-secrets.io/v1.AzureKVProvider">AzureKVProvider
  2299. </h3>
  2300. <p>
  2301. (<em>Appears on:</em>
  2302. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2303. </p>
  2304. <p>
  2305. <p>AzureKVProvider configures a store to sync secrets using Azure KV.</p>
  2306. </p>
  2307. <table>
  2308. <thead>
  2309. <tr>
  2310. <th>Field</th>
  2311. <th>Description</th>
  2312. </tr>
  2313. </thead>
  2314. <tbody>
  2315. <tr>
  2316. <td>
  2317. <code>authType</code></br>
  2318. <em>
  2319. <a href="#external-secrets.io/v1.AzureAuthType">
  2320. AzureAuthType
  2321. </a>
  2322. </em>
  2323. </td>
  2324. <td>
  2325. <em>(Optional)</em>
  2326. <p>Auth type defines how to authenticate to the keyvault service.
  2327. Valid values are:
  2328. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  2329. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)
  2330. - &ldquo;WorkloadIdentity&rdquo;: Using a Kubernetes ServiceAccount federated with Entra ID</p>
  2331. </td>
  2332. </tr>
  2333. <tr>
  2334. <td>
  2335. <code>vaultUrl</code></br>
  2336. <em>
  2337. string
  2338. </em>
  2339. </td>
  2340. <td>
  2341. <p>Vault Url from which the secrets to be fetched from.</p>
  2342. </td>
  2343. </tr>
  2344. <tr>
  2345. <td>
  2346. <code>tenantId</code></br>
  2347. <em>
  2348. string
  2349. </em>
  2350. </td>
  2351. <td>
  2352. <em>(Optional)</em>
  2353. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2354. </td>
  2355. </tr>
  2356. <tr>
  2357. <td>
  2358. <code>environmentType</code></br>
  2359. <em>
  2360. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  2361. AzureEnvironmentType
  2362. </a>
  2363. </em>
  2364. </td>
  2365. <td>
  2366. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  2367. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  2368. 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>
  2369. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud
  2370. Use AzureStackCloud when you need to configure custom Azure Stack Hub or Azure Stack Edge endpoints.</p>
  2371. </td>
  2372. </tr>
  2373. <tr>
  2374. <td>
  2375. <code>authSecretRef</code></br>
  2376. <em>
  2377. <a href="#external-secrets.io/v1.AzureKVAuth">
  2378. AzureKVAuth
  2379. </a>
  2380. </em>
  2381. </td>
  2382. <td>
  2383. <em>(Optional)</em>
  2384. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2385. </td>
  2386. </tr>
  2387. <tr>
  2388. <td>
  2389. <code>serviceAccountRef</code></br>
  2390. <em>
  2391. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  2392. External Secrets meta/v1.ServiceAccountSelector
  2393. </a>
  2394. </em>
  2395. </td>
  2396. <td>
  2397. <em>(Optional)</em>
  2398. <p>ServiceAccountRef specified the service account
  2399. that should be used when authenticating with WorkloadIdentity.</p>
  2400. </td>
  2401. </tr>
  2402. <tr>
  2403. <td>
  2404. <code>identityId</code></br>
  2405. <em>
  2406. string
  2407. </em>
  2408. </td>
  2409. <td>
  2410. <em>(Optional)</em>
  2411. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  2412. </td>
  2413. </tr>
  2414. <tr>
  2415. <td>
  2416. <code>useAzureSDK</code></br>
  2417. <em>
  2418. bool
  2419. </em>
  2420. </td>
  2421. <td>
  2422. <em>(Optional)</em>
  2423. <p>UseAzureSDK enables the use of the new Azure SDK for Go (azcore-based) instead of the legacy go-autorest SDK.
  2424. This is experimental and may have behavioral differences. Defaults to false (legacy SDK).</p>
  2425. </td>
  2426. </tr>
  2427. <tr>
  2428. <td>
  2429. <code>customCloudConfig</code></br>
  2430. <em>
  2431. <a href="#external-secrets.io/v1.AzureCustomCloudConfig">
  2432. AzureCustomCloudConfig
  2433. </a>
  2434. </em>
  2435. </td>
  2436. <td>
  2437. <em>(Optional)</em>
  2438. <p>CustomCloudConfig defines custom Azure endpoints for non-standard clouds.
  2439. Required when EnvironmentType is AzureStackCloud.
  2440. Optional for other environment types - useful for Azure China when using Workload Identity
  2441. with AKS, where the OIDC issuer (login.partner.microsoftonline.cn) differs from the
  2442. standard China Cloud endpoint (login.chinacloudapi.cn).
  2443. IMPORTANT: This feature REQUIRES UseAzureSDK to be set to true. Custom cloud
  2444. configuration is not supported with the legacy go-autorest SDK.</p>
  2445. </td>
  2446. </tr>
  2447. </tbody>
  2448. </table>
  2449. <h3 id="external-secrets.io/v1.BarbicanAuth">BarbicanAuth
  2450. </h3>
  2451. <p>
  2452. (<em>Appears on:</em>
  2453. <a href="#external-secrets.io/v1.BarbicanProvider">BarbicanProvider</a>)
  2454. </p>
  2455. <p>
  2456. <p>BarbicanAuth contains the authentication information for Barbican.</p>
  2457. </p>
  2458. <table>
  2459. <thead>
  2460. <tr>
  2461. <th>Field</th>
  2462. <th>Description</th>
  2463. </tr>
  2464. </thead>
  2465. <tbody>
  2466. <tr>
  2467. <td>
  2468. <code>username</code></br>
  2469. <em>
  2470. <a href="#external-secrets.io/v1.BarbicanProviderUsernameRef">
  2471. BarbicanProviderUsernameRef
  2472. </a>
  2473. </em>
  2474. </td>
  2475. <td>
  2476. </td>
  2477. </tr>
  2478. <tr>
  2479. <td>
  2480. <code>password</code></br>
  2481. <em>
  2482. <a href="#external-secrets.io/v1.BarbicanProviderPasswordRef">
  2483. BarbicanProviderPasswordRef
  2484. </a>
  2485. </em>
  2486. </td>
  2487. <td>
  2488. </td>
  2489. </tr>
  2490. </tbody>
  2491. </table>
  2492. <h3 id="external-secrets.io/v1.BarbicanProvider">BarbicanProvider
  2493. </h3>
  2494. <p>
  2495. (<em>Appears on:</em>
  2496. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2497. </p>
  2498. <p>
  2499. <p>BarbicanProvider setup a store to sync secrets with barbican.</p>
  2500. </p>
  2501. <table>
  2502. <thead>
  2503. <tr>
  2504. <th>Field</th>
  2505. <th>Description</th>
  2506. </tr>
  2507. </thead>
  2508. <tbody>
  2509. <tr>
  2510. <td>
  2511. <code>authURL</code></br>
  2512. <em>
  2513. string
  2514. </em>
  2515. </td>
  2516. <td>
  2517. </td>
  2518. </tr>
  2519. <tr>
  2520. <td>
  2521. <code>tenantName</code></br>
  2522. <em>
  2523. string
  2524. </em>
  2525. </td>
  2526. <td>
  2527. </td>
  2528. </tr>
  2529. <tr>
  2530. <td>
  2531. <code>domainName</code></br>
  2532. <em>
  2533. string
  2534. </em>
  2535. </td>
  2536. <td>
  2537. </td>
  2538. </tr>
  2539. <tr>
  2540. <td>
  2541. <code>region</code></br>
  2542. <em>
  2543. string
  2544. </em>
  2545. </td>
  2546. <td>
  2547. </td>
  2548. </tr>
  2549. <tr>
  2550. <td>
  2551. <code>auth</code></br>
  2552. <em>
  2553. <a href="#external-secrets.io/v1.BarbicanAuth">
  2554. BarbicanAuth
  2555. </a>
  2556. </em>
  2557. </td>
  2558. <td>
  2559. </td>
  2560. </tr>
  2561. </tbody>
  2562. </table>
  2563. <h3 id="external-secrets.io/v1.BarbicanProviderPasswordRef">BarbicanProviderPasswordRef
  2564. </h3>
  2565. <p>
  2566. (<em>Appears on:</em>
  2567. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2568. </p>
  2569. <p>
  2570. <p>BarbicanProviderPasswordRef defines a reference to a secret containing password for the Barbican provider.</p>
  2571. </p>
  2572. <table>
  2573. <thead>
  2574. <tr>
  2575. <th>Field</th>
  2576. <th>Description</th>
  2577. </tr>
  2578. </thead>
  2579. <tbody>
  2580. <tr>
  2581. <td>
  2582. <code>secretRef</code></br>
  2583. <em>
  2584. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2585. External Secrets meta/v1.SecretKeySelector
  2586. </a>
  2587. </em>
  2588. </td>
  2589. <td>
  2590. </td>
  2591. </tr>
  2592. </tbody>
  2593. </table>
  2594. <h3 id="external-secrets.io/v1.BarbicanProviderUsernameRef">BarbicanProviderUsernameRef
  2595. </h3>
  2596. <p>
  2597. (<em>Appears on:</em>
  2598. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2599. </p>
  2600. <p>
  2601. <p>BarbicanProviderUsernameRef defines a reference to a secret containing username for the Barbican provider.</p>
  2602. </p>
  2603. <table>
  2604. <thead>
  2605. <tr>
  2606. <th>Field</th>
  2607. <th>Description</th>
  2608. </tr>
  2609. </thead>
  2610. <tbody>
  2611. <tr>
  2612. <td>
  2613. <code>value</code></br>
  2614. <em>
  2615. string
  2616. </em>
  2617. </td>
  2618. <td>
  2619. </td>
  2620. </tr>
  2621. <tr>
  2622. <td>
  2623. <code>secretRef</code></br>
  2624. <em>
  2625. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2626. External Secrets meta/v1.SecretKeySelector
  2627. </a>
  2628. </em>
  2629. </td>
  2630. <td>
  2631. </td>
  2632. </tr>
  2633. </tbody>
  2634. </table>
  2635. <h3 id="external-secrets.io/v1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  2636. </h3>
  2637. <p>
  2638. (<em>Appears on:</em>
  2639. <a href="#external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth</a>)
  2640. </p>
  2641. <p>
  2642. <p>BeyondTrustProviderSecretRef references a value that can be specified directly or via a secret
  2643. for a BeyondTrustProvider.</p>
  2644. </p>
  2645. <table>
  2646. <thead>
  2647. <tr>
  2648. <th>Field</th>
  2649. <th>Description</th>
  2650. </tr>
  2651. </thead>
  2652. <tbody>
  2653. <tr>
  2654. <td>
  2655. <code>value</code></br>
  2656. <em>
  2657. string
  2658. </em>
  2659. </td>
  2660. <td>
  2661. <em>(Optional)</em>
  2662. <p>Value can be specified directly to set a value without using a secret.</p>
  2663. </td>
  2664. </tr>
  2665. <tr>
  2666. <td>
  2667. <code>secretRef</code></br>
  2668. <em>
  2669. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2670. External Secrets meta/v1.SecretKeySelector
  2671. </a>
  2672. </em>
  2673. </td>
  2674. <td>
  2675. <em>(Optional)</em>
  2676. <p>SecretRef references a key in a secret that will be used as value.</p>
  2677. </td>
  2678. </tr>
  2679. </tbody>
  2680. </table>
  2681. <h3 id="external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth
  2682. </h3>
  2683. <p>
  2684. (<em>Appears on:</em>
  2685. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2686. </p>
  2687. <p>
  2688. <p>BeyondtrustAuth provides different ways to authenticate to a BeyondtrustProvider server.</p>
  2689. </p>
  2690. <table>
  2691. <thead>
  2692. <tr>
  2693. <th>Field</th>
  2694. <th>Description</th>
  2695. </tr>
  2696. </thead>
  2697. <tbody>
  2698. <tr>
  2699. <td>
  2700. <code>apiKey</code></br>
  2701. <em>
  2702. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2703. BeyondTrustProviderSecretRef
  2704. </a>
  2705. </em>
  2706. </td>
  2707. <td>
  2708. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  2709. </td>
  2710. </tr>
  2711. <tr>
  2712. <td>
  2713. <code>clientId</code></br>
  2714. <em>
  2715. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2716. BeyondTrustProviderSecretRef
  2717. </a>
  2718. </em>
  2719. </td>
  2720. <td>
  2721. <p>ClientID is the API OAuth Client ID.</p>
  2722. </td>
  2723. </tr>
  2724. <tr>
  2725. <td>
  2726. <code>clientSecret</code></br>
  2727. <em>
  2728. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2729. BeyondTrustProviderSecretRef
  2730. </a>
  2731. </em>
  2732. </td>
  2733. <td>
  2734. <p>ClientSecret is the API OAuth Client Secret.</p>
  2735. </td>
  2736. </tr>
  2737. <tr>
  2738. <td>
  2739. <code>certificate</code></br>
  2740. <em>
  2741. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2742. BeyondTrustProviderSecretRef
  2743. </a>
  2744. </em>
  2745. </td>
  2746. <td>
  2747. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  2748. </td>
  2749. </tr>
  2750. <tr>
  2751. <td>
  2752. <code>certificateKey</code></br>
  2753. <em>
  2754. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2755. BeyondTrustProviderSecretRef
  2756. </a>
  2757. </em>
  2758. </td>
  2759. <td>
  2760. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  2761. </td>
  2762. </tr>
  2763. </tbody>
  2764. </table>
  2765. <h3 id="external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider
  2766. </h3>
  2767. <p>
  2768. (<em>Appears on:</em>
  2769. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2770. </p>
  2771. <p>
  2772. <p>BeyondtrustProvider provides access to a BeyondTrust secrets provider.</p>
  2773. </p>
  2774. <table>
  2775. <thead>
  2776. <tr>
  2777. <th>Field</th>
  2778. <th>Description</th>
  2779. </tr>
  2780. </thead>
  2781. <tbody>
  2782. <tr>
  2783. <td>
  2784. <code>auth</code></br>
  2785. <em>
  2786. <a href="#external-secrets.io/v1.BeyondtrustAuth">
  2787. BeyondtrustAuth
  2788. </a>
  2789. </em>
  2790. </td>
  2791. <td>
  2792. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  2793. </td>
  2794. </tr>
  2795. <tr>
  2796. <td>
  2797. <code>server</code></br>
  2798. <em>
  2799. <a href="#external-secrets.io/v1.BeyondtrustServer">
  2800. BeyondtrustServer
  2801. </a>
  2802. </em>
  2803. </td>
  2804. <td>
  2805. <p>Auth configures how API server works.</p>
  2806. </td>
  2807. </tr>
  2808. </tbody>
  2809. </table>
  2810. <h3 id="external-secrets.io/v1.BeyondtrustServer">BeyondtrustServer
  2811. </h3>
  2812. <p>
  2813. (<em>Appears on:</em>
  2814. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2815. </p>
  2816. <p>
  2817. <p>BeyondtrustServer configures a store to sync secrets using BeyondTrust Password Safe.</p>
  2818. </p>
  2819. <table>
  2820. <thead>
  2821. <tr>
  2822. <th>Field</th>
  2823. <th>Description</th>
  2824. </tr>
  2825. </thead>
  2826. <tbody>
  2827. <tr>
  2828. <td>
  2829. <code>apiUrl</code></br>
  2830. <em>
  2831. string
  2832. </em>
  2833. </td>
  2834. <td>
  2835. </td>
  2836. </tr>
  2837. <tr>
  2838. <td>
  2839. <code>apiVersion</code></br>
  2840. <em>
  2841. string
  2842. </em>
  2843. </td>
  2844. <td>
  2845. </td>
  2846. </tr>
  2847. <tr>
  2848. <td>
  2849. <code>retrievalType</code></br>
  2850. <em>
  2851. string
  2852. </em>
  2853. </td>
  2854. <td>
  2855. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  2856. </td>
  2857. </tr>
  2858. <tr>
  2859. <td>
  2860. <code>separator</code></br>
  2861. <em>
  2862. string
  2863. </em>
  2864. </td>
  2865. <td>
  2866. <p>A character that separates the folder names.</p>
  2867. </td>
  2868. </tr>
  2869. <tr>
  2870. <td>
  2871. <code>decrypt</code></br>
  2872. <em>
  2873. bool
  2874. </em>
  2875. </td>
  2876. <td>
  2877. <em>(Optional)</em>
  2878. <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>
  2879. </td>
  2880. </tr>
  2881. <tr>
  2882. <td>
  2883. <code>verifyCA</code></br>
  2884. <em>
  2885. bool
  2886. </em>
  2887. </td>
  2888. <td>
  2889. </td>
  2890. </tr>
  2891. <tr>
  2892. <td>
  2893. <code>clientTimeOutSeconds</code></br>
  2894. <em>
  2895. int
  2896. </em>
  2897. </td>
  2898. <td>
  2899. <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>
  2900. </td>
  2901. </tr>
  2902. </tbody>
  2903. </table>
  2904. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">BeyondtrustWorkloadCredentialsAuth
  2905. </h3>
  2906. <p>
  2907. (<em>Appears on:</em>
  2908. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>)
  2909. </p>
  2910. <p>
  2911. <p>BeyondtrustWorkloadCredentialsAuth defines the authentication method for the BeyondTrust Workload Credentials provider.
  2912. Currently supports API key authentication via Kubernetes secret reference.
  2913. 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>
  2914. </p>
  2915. <table>
  2916. <thead>
  2917. <tr>
  2918. <th>Field</th>
  2919. <th>Description</th>
  2920. </tr>
  2921. </thead>
  2922. <tbody>
  2923. <tr>
  2924. <td>
  2925. <code>apikey</code></br>
  2926. <em>
  2927. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuthSecretRef">
  2928. BeyondtrustWorkloadCredentialsAuthSecretRef
  2929. </a>
  2930. </em>
  2931. </td>
  2932. <td>
  2933. <p>APIKey configures API token authentication for BeyondTrust Workload Credentials.
  2934. The token is retrieved from a Kubernetes secret and used as a Bearer token for API requests.</p>
  2935. </td>
  2936. </tr>
  2937. </tbody>
  2938. </table>
  2939. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuthSecretRef">BeyondtrustWorkloadCredentialsAuthSecretRef
  2940. </h3>
  2941. <p>
  2942. (<em>Appears on:</em>
  2943. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">BeyondtrustWorkloadCredentialsAuth</a>)
  2944. </p>
  2945. <p>
  2946. <p>BeyondtrustWorkloadCredentialsAuthSecretRef defines a reference to a secret containing credentials for the BeyondTrust Workload Credentials provider.
  2947. The nested structure supports multiple authentication methods (currently only API token is supported).
  2948. 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>
  2949. </p>
  2950. <table>
  2951. <thead>
  2952. <tr>
  2953. <th>Field</th>
  2954. <th>Description</th>
  2955. </tr>
  2956. </thead>
  2957. <tbody>
  2958. <tr>
  2959. <td>
  2960. <code>token</code></br>
  2961. <em>
  2962. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2963. External Secrets meta/v1.SecretKeySelector
  2964. </a>
  2965. </em>
  2966. </td>
  2967. <td>
  2968. <p>Token references the Kubernetes secret containing the BeyondTrust Workload Credentials API token.
  2969. The secret should contain the API key used to authenticate with BeyondTrust Workload Credentials.
  2970. Create an API token in your BeyondTrust Workload Credentials console and store it in a Kubernetes secret.
  2971. 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>
  2972. </td>
  2973. </tr>
  2974. </tbody>
  2975. </table>
  2976. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider
  2977. </h3>
  2978. <p>
  2979. (<em>Appears on:</em>
  2980. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  2981. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec</a>)
  2982. </p>
  2983. <p>
  2984. <p>BeyondtrustWorkloadCredentialsProvider configures a store to sync secrets using the BeyondTrust Workload Credentials provider.
  2985. BeyondTrust Workload Credentials provides secure storage for static secrets and dynamic credential generation.
  2986. This provider supports reading secrets and generating dynamic credentials (e.g., temporary AWS credentials).
  2987. 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>
  2988. </p>
  2989. <table>
  2990. <thead>
  2991. <tr>
  2992. <th>Field</th>
  2993. <th>Description</th>
  2994. </tr>
  2995. </thead>
  2996. <tbody>
  2997. <tr>
  2998. <td>
  2999. <code>auth</code></br>
  3000. <em>
  3001. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">
  3002. BeyondtrustWorkloadCredentialsAuth
  3003. </a>
  3004. </em>
  3005. </td>
  3006. <td>
  3007. <p>Auth configures how the Operator authenticates with the BeyondTrust Workload Credentials API.
  3008. Currently supports API key authentication via Kubernetes secret reference.
  3009. 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>
  3010. </td>
  3011. </tr>
  3012. <tr>
  3013. <td>
  3014. <code>server</code></br>
  3015. <em>
  3016. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsServer">
  3017. BeyondtrustWorkloadCredentialsServer
  3018. </a>
  3019. </em>
  3020. </td>
  3021. <td>
  3022. <p>Server configures the BeyondTrust Workload Credentials server connection details.
  3023. Includes the API URL and Site ID for your BeyondTrust instance.
  3024. 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>
  3025. </td>
  3026. </tr>
  3027. <tr>
  3028. <td>
  3029. <code>folderPath</code></br>
  3030. <em>
  3031. string
  3032. </em>
  3033. </td>
  3034. <td>
  3035. <em>(Optional)</em>
  3036. <p>FolderPath specifies the default folder path for secret retrieval.
  3037. Secrets will be fetched from this folder unless overridden in the ExternalSecret spec.
  3038. Example: &ldquo;production/database&rdquo; or &ldquo;dev/api-keys&rdquo;
  3039. Leave empty to retrieve secrets from the root folder.
  3040. 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>
  3041. </td>
  3042. </tr>
  3043. <tr>
  3044. <td>
  3045. <code>caBundle</code></br>
  3046. <em>
  3047. []byte
  3048. </em>
  3049. </td>
  3050. <td>
  3051. <em>(Optional)</em>
  3052. <p>CABundle is a base64-encoded CA certificate used to validate the BeyondTrust Workload Credentials API TLS certificate.
  3053. Use this when your BeyondTrust instance uses a self-signed certificate or internal CA.
  3054. If not set, the system&rsquo;s trusted root certificates are used.</p>
  3055. </td>
  3056. </tr>
  3057. <tr>
  3058. <td>
  3059. <code>caProvider</code></br>
  3060. <em>
  3061. <a href="#external-secrets.io/v1.CAProvider">
  3062. CAProvider
  3063. </a>
  3064. </em>
  3065. </td>
  3066. <td>
  3067. <em>(Optional)</em>
  3068. <p>CAProvider points to a Secret or ConfigMap containing a PEM-encoded CA certificate.
  3069. This is used to validate the BeyondTrust Workload Credentials API TLS certificate.
  3070. Use this as an alternative to CABundle when you want to reference an existing Kubernetes resource.</p>
  3071. </td>
  3072. </tr>
  3073. </tbody>
  3074. </table>
  3075. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsServer">BeyondtrustWorkloadCredentialsServer
  3076. </h3>
  3077. <p>
  3078. (<em>Appears on:</em>
  3079. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>)
  3080. </p>
  3081. <p>
  3082. <p>BeyondtrustWorkloadCredentialsServer defines connection configuration for BeyondTrust Workload Credentials.
  3083. 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>
  3084. </p>
  3085. <table>
  3086. <thead>
  3087. <tr>
  3088. <th>Field</th>
  3089. <th>Description</th>
  3090. </tr>
  3091. </thead>
  3092. <tbody>
  3093. <tr>
  3094. <td>
  3095. <code>apiUrl</code></br>
  3096. <em>
  3097. string
  3098. </em>
  3099. </td>
  3100. <td>
  3101. <p>APIURL is the base URL of your BeyondTrust Workload Credentials API server.
  3102. This should be the full URL to your BeyondTrust instance.
  3103. Example: <a href="https://api.beyondtrust.io/siie">https://api.beyondtrust.io/siie</a>
  3104. 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>
  3105. </td>
  3106. </tr>
  3107. <tr>
  3108. <td>
  3109. <code>siteId</code></br>
  3110. <em>
  3111. string
  3112. </em>
  3113. </td>
  3114. <td>
  3115. <p>SiteID is your BeyondTrust Workload Credentials site identifier (UUID format).
  3116. This identifier is unique to your BeyondTrust Workload Credentials instance.
  3117. You can find your Site ID in the BeyondTrust Workload Credentials admin console.
  3118. Example: a1b2c3d4-e5f6-4890-abcd-ef1234567890
  3119. 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>
  3120. </td>
  3121. </tr>
  3122. </tbody>
  3123. </table>
  3124. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  3125. </h3>
  3126. <p>
  3127. (<em>Appears on:</em>
  3128. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  3129. </p>
  3130. <p>
  3131. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  3132. </p>
  3133. <table>
  3134. <thead>
  3135. <tr>
  3136. <th>Field</th>
  3137. <th>Description</th>
  3138. </tr>
  3139. </thead>
  3140. <tbody>
  3141. <tr>
  3142. <td>
  3143. <code>secretRef</code></br>
  3144. <em>
  3145. <a href="#external-secrets.io/v1.BitwardenSecretsManagerSecretRef">
  3146. BitwardenSecretsManagerSecretRef
  3147. </a>
  3148. </em>
  3149. </td>
  3150. <td>
  3151. </td>
  3152. </tr>
  3153. </tbody>
  3154. </table>
  3155. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  3156. </h3>
  3157. <p>
  3158. (<em>Appears on:</em>
  3159. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3160. </p>
  3161. <p>
  3162. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  3163. </p>
  3164. <table>
  3165. <thead>
  3166. <tr>
  3167. <th>Field</th>
  3168. <th>Description</th>
  3169. </tr>
  3170. </thead>
  3171. <tbody>
  3172. <tr>
  3173. <td>
  3174. <code>apiURL</code></br>
  3175. <em>
  3176. string
  3177. </em>
  3178. </td>
  3179. <td>
  3180. </td>
  3181. </tr>
  3182. <tr>
  3183. <td>
  3184. <code>identityURL</code></br>
  3185. <em>
  3186. string
  3187. </em>
  3188. </td>
  3189. <td>
  3190. </td>
  3191. </tr>
  3192. <tr>
  3193. <td>
  3194. <code>bitwardenServerSDKURL</code></br>
  3195. <em>
  3196. string
  3197. </em>
  3198. </td>
  3199. <td>
  3200. </td>
  3201. </tr>
  3202. <tr>
  3203. <td>
  3204. <code>caBundle</code></br>
  3205. <em>
  3206. string
  3207. </em>
  3208. </td>
  3209. <td>
  3210. <em>(Optional)</em>
  3211. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  3212. can be performed.</p>
  3213. </td>
  3214. </tr>
  3215. <tr>
  3216. <td>
  3217. <code>caProvider</code></br>
  3218. <em>
  3219. <a href="#external-secrets.io/v1.CAProvider">
  3220. CAProvider
  3221. </a>
  3222. </em>
  3223. </td>
  3224. <td>
  3225. <em>(Optional)</em>
  3226. <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>
  3227. </td>
  3228. </tr>
  3229. <tr>
  3230. <td>
  3231. <code>organizationID</code></br>
  3232. <em>
  3233. string
  3234. </em>
  3235. </td>
  3236. <td>
  3237. <p>OrganizationID determines which organization this secret store manages.</p>
  3238. </td>
  3239. </tr>
  3240. <tr>
  3241. <td>
  3242. <code>projectID</code></br>
  3243. <em>
  3244. string
  3245. </em>
  3246. </td>
  3247. <td>
  3248. <p>ProjectID determines which project this secret store manages.</p>
  3249. </td>
  3250. </tr>
  3251. <tr>
  3252. <td>
  3253. <code>auth</code></br>
  3254. <em>
  3255. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">
  3256. BitwardenSecretsManagerAuth
  3257. </a>
  3258. </em>
  3259. </td>
  3260. <td>
  3261. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  3262. Make sure that the token being used has permissions on the given secret.</p>
  3263. </td>
  3264. </tr>
  3265. </tbody>
  3266. </table>
  3267. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  3268. </h3>
  3269. <p>
  3270. (<em>Appears on:</em>
  3271. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  3272. </p>
  3273. <p>
  3274. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  3275. </p>
  3276. <table>
  3277. <thead>
  3278. <tr>
  3279. <th>Field</th>
  3280. <th>Description</th>
  3281. </tr>
  3282. </thead>
  3283. <tbody>
  3284. <tr>
  3285. <td>
  3286. <code>credentials</code></br>
  3287. <em>
  3288. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3289. External Secrets meta/v1.SecretKeySelector
  3290. </a>
  3291. </em>
  3292. </td>
  3293. <td>
  3294. <p>AccessToken used for the bitwarden instance.</p>
  3295. </td>
  3296. </tr>
  3297. </tbody>
  3298. </table>
  3299. <h3 id="external-secrets.io/v1.ByID">ByID
  3300. </h3>
  3301. <p>
  3302. (<em>Appears on:</em>
  3303. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  3304. </p>
  3305. <p>
  3306. <p>ByID configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID.</p>
  3307. </p>
  3308. <h3 id="external-secrets.io/v1.ByName">ByName
  3309. </h3>
  3310. <p>
  3311. (<em>Appears on:</em>
  3312. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  3313. </p>
  3314. <p>
  3315. <p>ByName configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret name.</p>
  3316. </p>
  3317. <table>
  3318. <thead>
  3319. <tr>
  3320. <th>Field</th>
  3321. <th>Description</th>
  3322. </tr>
  3323. </thead>
  3324. <tbody>
  3325. <tr>
  3326. <td>
  3327. <code>folderID</code></br>
  3328. <em>
  3329. string
  3330. </em>
  3331. </td>
  3332. <td>
  3333. <p>The folder to fetch secrets from</p>
  3334. </td>
  3335. </tr>
  3336. </tbody>
  3337. </table>
  3338. <h3 id="external-secrets.io/v1.CAProvider">CAProvider
  3339. </h3>
  3340. <p>
  3341. (<em>Appears on:</em>
  3342. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>,
  3343. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>,
  3344. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  3345. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>,
  3346. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>,
  3347. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>,
  3348. <a href="#external-secrets.io/v1.KubernetesServer">KubernetesServer</a>,
  3349. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>,
  3350. <a href="#external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS</a>,
  3351. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>,
  3352. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>,
  3353. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  3354. </p>
  3355. <p>
  3356. <p>CAProvider provides a custom certificate authority for accessing the provider&rsquo;s store.
  3357. The CAProvider points to a Secret or ConfigMap resource that contains a PEM-encoded certificate.</p>
  3358. </p>
  3359. <table>
  3360. <thead>
  3361. <tr>
  3362. <th>Field</th>
  3363. <th>Description</th>
  3364. </tr>
  3365. </thead>
  3366. <tbody>
  3367. <tr>
  3368. <td>
  3369. <code>type</code></br>
  3370. <em>
  3371. <a href="#external-secrets.io/v1.CAProviderType">
  3372. CAProviderType
  3373. </a>
  3374. </em>
  3375. </td>
  3376. <td>
  3377. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  3378. </td>
  3379. </tr>
  3380. <tr>
  3381. <td>
  3382. <code>name</code></br>
  3383. <em>
  3384. string
  3385. </em>
  3386. </td>
  3387. <td>
  3388. <p>The name of the object located at the provider type.</p>
  3389. </td>
  3390. </tr>
  3391. <tr>
  3392. <td>
  3393. <code>key</code></br>
  3394. <em>
  3395. string
  3396. </em>
  3397. </td>
  3398. <td>
  3399. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  3400. </td>
  3401. </tr>
  3402. <tr>
  3403. <td>
  3404. <code>namespace</code></br>
  3405. <em>
  3406. string
  3407. </em>
  3408. </td>
  3409. <td>
  3410. <em>(Optional)</em>
  3411. <p>The namespace the Provider type is in.
  3412. Can only be defined when used in a ClusterSecretStore.</p>
  3413. </td>
  3414. </tr>
  3415. </tbody>
  3416. </table>
  3417. <h3 id="external-secrets.io/v1.CAProviderType">CAProviderType
  3418. (<code>string</code> alias)</p></h3>
  3419. <p>
  3420. (<em>Appears on:</em>
  3421. <a href="#external-secrets.io/v1.CAProvider">CAProvider</a>)
  3422. </p>
  3423. <p>
  3424. <p>CAProviderType defines the type of provider for certificate authority.</p>
  3425. </p>
  3426. <table>
  3427. <thead>
  3428. <tr>
  3429. <th>Value</th>
  3430. <th>Description</th>
  3431. </tr>
  3432. </thead>
  3433. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  3434. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  3435. </td>
  3436. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  3437. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  3438. </td>
  3439. </tr></tbody>
  3440. </table>
  3441. <h3 id="external-secrets.io/v1.CRDProvider">CRDProvider
  3442. </h3>
  3443. <p>
  3444. (<em>Appears on:</em>
  3445. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3446. </p>
  3447. <p>
  3448. <p>CRDProvider configures a store to fetch data from arbitrary Kubernetes
  3449. resources, including both custom resources (CRDs) and core API resources
  3450. (e.g. ConfigMap, addressed by setting resource.group to &ldquo;&rdquo;). Kubernetes
  3451. Secrets are intentionally blocked; use the Kubernetes provider for those.</p>
  3452. <h1>Authentication modes</h1>
  3453. <p>In-cluster: set auth.serviceAccount and omit server. The server URL defaults
  3454. to the in-cluster API (kubernetes.default) and the controller mints a
  3455. short-lived token for the referenced ServiceAccount to read CRDs locally.</p>
  3456. <p>Remote cluster: set server plus auth (serviceAccount, token, or cert) or
  3457. authRef (a kubeconfig Secret), exactly like the Kubernetes provider.</p>
  3458. <h1>Remote reference keys</h1>
  3459. <ul>
  3460. <li>SecretStore: the key is the object name only; &lsquo;/&rsquo; is not allowed. The API
  3461. namespace is always the store namespace, never part of the key.</li>
  3462. <li>ClusterSecretStore: use &ldquo;namespace/objectName&rdquo; to read a namespaced CR;
  3463. a key without &lsquo;/&rsquo; addresses a cluster-scoped CR by object name. For
  3464. dataFrom Find with a namespaced kind, listing spans all namespaces and
  3465. result keys are &ldquo;namespace/objectName&rdquo;.</li>
  3466. </ul>
  3467. </p>
  3468. <table>
  3469. <thead>
  3470. <tr>
  3471. <th>Field</th>
  3472. <th>Description</th>
  3473. </tr>
  3474. </thead>
  3475. <tbody>
  3476. <tr>
  3477. <td>
  3478. <code>server</code></br>
  3479. <em>
  3480. <a href="#external-secrets.io/v1.KubernetesServer">
  3481. KubernetesServer
  3482. </a>
  3483. </em>
  3484. </td>
  3485. <td>
  3486. <em>(Optional)</em>
  3487. <p>Server configures the Kubernetes API address and TLS trust, same as the
  3488. Kubernetes provider. When omitted, the URL defaults to the in-cluster API.</p>
  3489. </td>
  3490. </tr>
  3491. <tr>
  3492. <td>
  3493. <code>auth</code></br>
  3494. <em>
  3495. <a href="#external-secrets.io/v1.KubernetesAuth">
  3496. KubernetesAuth
  3497. </a>
  3498. </em>
  3499. </td>
  3500. <td>
  3501. <em>(Optional)</em>
  3502. <p>Auth configures authentication to the Kubernetes API, same as the
  3503. Kubernetes provider. Required when Server.URL is set (unless using AuthRef).</p>
  3504. </td>
  3505. </tr>
  3506. <tr>
  3507. <td>
  3508. <code>authRef</code></br>
  3509. <em>
  3510. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3511. External Secrets meta/v1.SecretKeySelector
  3512. </a>
  3513. </em>
  3514. </td>
  3515. <td>
  3516. <em>(Optional)</em>
  3517. <p>AuthRef references a Secret containing a kubeconfig. Same semantics as the
  3518. Kubernetes provider.</p>
  3519. </td>
  3520. </tr>
  3521. <tr>
  3522. <td>
  3523. <code>resource</code></br>
  3524. <em>
  3525. <a href="#external-secrets.io/v1.CRDProviderResource">
  3526. CRDProviderResource
  3527. </a>
  3528. </em>
  3529. </td>
  3530. <td>
  3531. <p>Resource identifies the CRD by its API group, version and kind.</p>
  3532. </td>
  3533. </tr>
  3534. <tr>
  3535. <td>
  3536. <code>whitelist</code></br>
  3537. <em>
  3538. <a href="#external-secrets.io/v1.CRDProviderWhitelist">
  3539. CRDProviderWhitelist
  3540. </a>
  3541. </em>
  3542. </td>
  3543. <td>
  3544. <em>(Optional)</em>
  3545. <p>Whitelist optionally restricts which object names and requested properties
  3546. are allowed to be read.</p>
  3547. </td>
  3548. </tr>
  3549. </tbody>
  3550. </table>
  3551. <h3 id="external-secrets.io/v1.CRDProviderResource">CRDProviderResource
  3552. </h3>
  3553. <p>
  3554. (<em>Appears on:</em>
  3555. <a href="#external-secrets.io/v1.CRDProvider">CRDProvider</a>)
  3556. </p>
  3557. <p>
  3558. <p>CRDProviderResource identifies a Kubernetes resource (CRD or core) by its
  3559. full API coordinates: group, version and kind.</p>
  3560. </p>
  3561. <table>
  3562. <thead>
  3563. <tr>
  3564. <th>Field</th>
  3565. <th>Description</th>
  3566. </tr>
  3567. </thead>
  3568. <tbody>
  3569. <tr>
  3570. <td>
  3571. <code>group</code></br>
  3572. <em>
  3573. string
  3574. </em>
  3575. </td>
  3576. <td>
  3577. <p>Group is the API group of the resource. Use &ldquo;&rdquo; (empty string) for core
  3578. Kubernetes resources such as ConfigMap; use e.g. &ldquo;config.example.io&rdquo;
  3579. for a CRD. The field is required to be present in the manifest — write
  3580. <code>group: &quot;&quot;</code> explicitly for core resources so typos fail at admission
  3581. time rather than later at discovery.</p>
  3582. </td>
  3583. </tr>
  3584. <tr>
  3585. <td>
  3586. <code>version</code></br>
  3587. <em>
  3588. string
  3589. </em>
  3590. </td>
  3591. <td>
  3592. <p>Version is the API version of the resource (e.g. &ldquo;v1alpha1&rdquo;).</p>
  3593. </td>
  3594. </tr>
  3595. <tr>
  3596. <td>
  3597. <code>kind</code></br>
  3598. <em>
  3599. string
  3600. </em>
  3601. </td>
  3602. <td>
  3603. <p>Kind is the Kubernetes resource kind (e.g. &ldquo;MyCustomResource&rdquo;).</p>
  3604. </td>
  3605. </tr>
  3606. </tbody>
  3607. </table>
  3608. <h3 id="external-secrets.io/v1.CRDProviderWhitelist">CRDProviderWhitelist
  3609. </h3>
  3610. <p>
  3611. (<em>Appears on:</em>
  3612. <a href="#external-secrets.io/v1.CRDProvider">CRDProvider</a>)
  3613. </p>
  3614. <p>
  3615. <p>CRDProviderWhitelist configures allow-list rules for CRD reads.
  3616. If any rules are present, a request must satisfy ALL non-empty filters of at
  3617. least one rule; requests that match no rule are denied.</p>
  3618. </p>
  3619. <table>
  3620. <thead>
  3621. <tr>
  3622. <th>Field</th>
  3623. <th>Description</th>
  3624. </tr>
  3625. </thead>
  3626. <tbody>
  3627. <tr>
  3628. <td>
  3629. <code>rules</code></br>
  3630. <em>
  3631. <a href="#external-secrets.io/v1.CRDProviderWhitelistRule">
  3632. []CRDProviderWhitelistRule
  3633. </a>
  3634. </em>
  3635. </td>
  3636. <td>
  3637. <em>(Optional)</em>
  3638. <p>Rules is a list of allow rules. If rules are set, at least one rule must
  3639. match for a request to be allowed.</p>
  3640. </td>
  3641. </tr>
  3642. </tbody>
  3643. </table>
  3644. <h3 id="external-secrets.io/v1.CRDProviderWhitelistRule">CRDProviderWhitelistRule
  3645. </h3>
  3646. <p>
  3647. (<em>Appears on:</em>
  3648. <a href="#external-secrets.io/v1.CRDProviderWhitelist">CRDProviderWhitelist</a>)
  3649. </p>
  3650. <p>
  3651. <p>CRDProviderWhitelistRule defines a single allow rule for CRD reads.</p>
  3652. </p>
  3653. <table>
  3654. <thead>
  3655. <tr>
  3656. <th>Field</th>
  3657. <th>Description</th>
  3658. </tr>
  3659. </thead>
  3660. <tbody>
  3661. <tr>
  3662. <td>
  3663. <code>name</code></br>
  3664. <em>
  3665. string
  3666. </em>
  3667. </td>
  3668. <td>
  3669. <em>(Optional)</em>
  3670. <p>Name is an optional regular expression matched against the bare object name.
  3671. For both SecretStore and ClusterSecretStore this is always the object name
  3672. without any namespace prefix (e.g. &ldquo;my-db-spec&rdquo;, not &ldquo;prod/my-db-spec&rdquo;).</p>
  3673. </td>
  3674. </tr>
  3675. <tr>
  3676. <td>
  3677. <code>namespace</code></br>
  3678. <em>
  3679. string
  3680. </em>
  3681. </td>
  3682. <td>
  3683. <em>(Optional)</em>
  3684. <p>Namespace is an optional regular expression matched against the namespace of
  3685. the object. Applies only when a ClusterSecretStore is used; it is ignored
  3686. for SecretStore (where the namespace is fixed to the store namespace).</p>
  3687. </td>
  3688. </tr>
  3689. <tr>
  3690. <td>
  3691. <code>properties</code></br>
  3692. <em>
  3693. []string
  3694. </em>
  3695. </td>
  3696. <td>
  3697. <em>(Optional)</em>
  3698. <p>Properties is an optional list of regular expressions matched against
  3699. requested property keys (for example: &ldquo;spec.secretValue&rdquo;).</p>
  3700. </td>
  3701. </tr>
  3702. </tbody>
  3703. </table>
  3704. <h3 id="external-secrets.io/v1.CSMAuth">CSMAuth
  3705. </h3>
  3706. <p>
  3707. (<em>Appears on:</em>
  3708. <a href="#external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider</a>)
  3709. </p>
  3710. <p>
  3711. <p>CSMAuth contains a secretRef for credentials.</p>
  3712. </p>
  3713. <table>
  3714. <thead>
  3715. <tr>
  3716. <th>Field</th>
  3717. <th>Description</th>
  3718. </tr>
  3719. </thead>
  3720. <tbody>
  3721. <tr>
  3722. <td>
  3723. <code>secretRef</code></br>
  3724. <em>
  3725. <a href="#external-secrets.io/v1.CSMAuthSecretRef">
  3726. CSMAuthSecretRef
  3727. </a>
  3728. </em>
  3729. </td>
  3730. <td>
  3731. <em>(Optional)</em>
  3732. </td>
  3733. </tr>
  3734. </tbody>
  3735. </table>
  3736. <h3 id="external-secrets.io/v1.CSMAuthSecretRef">CSMAuthSecretRef
  3737. </h3>
  3738. <p>
  3739. (<em>Appears on:</em>
  3740. <a href="#external-secrets.io/v1.CSMAuth">CSMAuth</a>)
  3741. </p>
  3742. <p>
  3743. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  3744. </p>
  3745. <table>
  3746. <thead>
  3747. <tr>
  3748. <th>Field</th>
  3749. <th>Description</th>
  3750. </tr>
  3751. </thead>
  3752. <tbody>
  3753. <tr>
  3754. <td>
  3755. <code>accessKeyIDSecretRef</code></br>
  3756. <em>
  3757. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3758. External Secrets meta/v1.SecretKeySelector
  3759. </a>
  3760. </em>
  3761. </td>
  3762. <td>
  3763. <p>The AccessKeyID is used for authentication</p>
  3764. </td>
  3765. </tr>
  3766. <tr>
  3767. <td>
  3768. <code>accessKeySecretSecretRef</code></br>
  3769. <em>
  3770. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3771. External Secrets meta/v1.SecretKeySelector
  3772. </a>
  3773. </em>
  3774. </td>
  3775. <td>
  3776. <p>The AccessKeySecret is used for authentication</p>
  3777. </td>
  3778. </tr>
  3779. </tbody>
  3780. </table>
  3781. <h3 id="external-secrets.io/v1.CacheConfig">CacheConfig
  3782. </h3>
  3783. <p>
  3784. (<em>Appears on:</em>
  3785. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  3786. </p>
  3787. <p>
  3788. <p>CacheConfig configures client-side caching for read operations.</p>
  3789. </p>
  3790. <table>
  3791. <thead>
  3792. <tr>
  3793. <th>Field</th>
  3794. <th>Description</th>
  3795. </tr>
  3796. </thead>
  3797. <tbody>
  3798. <tr>
  3799. <td>
  3800. <code>ttl</code></br>
  3801. <em>
  3802. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3803. Kubernetes meta/v1.Duration
  3804. </a>
  3805. </em>
  3806. </td>
  3807. <td>
  3808. <em>(Optional)</em>
  3809. <p>TTL is the time-to-live for cached secrets.
  3810. Format: duration string (e.g., &ldquo;5m&rdquo;, &ldquo;1h&rdquo;, &ldquo;30s&rdquo;)</p>
  3811. </td>
  3812. </tr>
  3813. <tr>
  3814. <td>
  3815. <code>maxSize</code></br>
  3816. <em>
  3817. int
  3818. </em>
  3819. </td>
  3820. <td>
  3821. <em>(Optional)</em>
  3822. <p>MaxSize is the maximum number of secrets to cache.
  3823. When the cache is full, least-recently-used entries are evicted.</p>
  3824. </td>
  3825. </tr>
  3826. </tbody>
  3827. </table>
  3828. <h3 id="external-secrets.io/v1.CertAuth">CertAuth
  3829. </h3>
  3830. <p>
  3831. (<em>Appears on:</em>
  3832. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  3833. </p>
  3834. <p>
  3835. <p>CertAuth defines certificate-based authentication configuration for Kubernetes.</p>
  3836. </p>
  3837. <table>
  3838. <thead>
  3839. <tr>
  3840. <th>Field</th>
  3841. <th>Description</th>
  3842. </tr>
  3843. </thead>
  3844. <tbody>
  3845. <tr>
  3846. <td>
  3847. <code>clientCert</code></br>
  3848. <em>
  3849. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3850. External Secrets meta/v1.SecretKeySelector
  3851. </a>
  3852. </em>
  3853. </td>
  3854. <td>
  3855. </td>
  3856. </tr>
  3857. <tr>
  3858. <td>
  3859. <code>clientKey</code></br>
  3860. <em>
  3861. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3862. External Secrets meta/v1.SecretKeySelector
  3863. </a>
  3864. </em>
  3865. </td>
  3866. <td>
  3867. </td>
  3868. </tr>
  3869. </tbody>
  3870. </table>
  3871. <h3 id="external-secrets.io/v1.ChefAuth">ChefAuth
  3872. </h3>
  3873. <p>
  3874. (<em>Appears on:</em>
  3875. <a href="#external-secrets.io/v1.ChefProvider">ChefProvider</a>)
  3876. </p>
  3877. <p>
  3878. <p>ChefAuth contains a secretRef for credentials.</p>
  3879. </p>
  3880. <table>
  3881. <thead>
  3882. <tr>
  3883. <th>Field</th>
  3884. <th>Description</th>
  3885. </tr>
  3886. </thead>
  3887. <tbody>
  3888. <tr>
  3889. <td>
  3890. <code>secretRef</code></br>
  3891. <em>
  3892. <a href="#external-secrets.io/v1.ChefAuthSecretRef">
  3893. ChefAuthSecretRef
  3894. </a>
  3895. </em>
  3896. </td>
  3897. <td>
  3898. </td>
  3899. </tr>
  3900. </tbody>
  3901. </table>
  3902. <h3 id="external-secrets.io/v1.ChefAuthSecretRef">ChefAuthSecretRef
  3903. </h3>
  3904. <p>
  3905. (<em>Appears on:</em>
  3906. <a href="#external-secrets.io/v1.ChefAuth">ChefAuth</a>)
  3907. </p>
  3908. <p>
  3909. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  3910. </p>
  3911. <table>
  3912. <thead>
  3913. <tr>
  3914. <th>Field</th>
  3915. <th>Description</th>
  3916. </tr>
  3917. </thead>
  3918. <tbody>
  3919. <tr>
  3920. <td>
  3921. <code>privateKeySecretRef</code></br>
  3922. <em>
  3923. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3924. External Secrets meta/v1.SecretKeySelector
  3925. </a>
  3926. </em>
  3927. </td>
  3928. <td>
  3929. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  3930. </td>
  3931. </tr>
  3932. </tbody>
  3933. </table>
  3934. <h3 id="external-secrets.io/v1.ChefProvider">ChefProvider
  3935. </h3>
  3936. <p>
  3937. (<em>Appears on:</em>
  3938. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3939. </p>
  3940. <p>
  3941. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</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>auth</code></br>
  3954. <em>
  3955. <a href="#external-secrets.io/v1.ChefAuth">
  3956. ChefAuth
  3957. </a>
  3958. </em>
  3959. </td>
  3960. <td>
  3961. <p>Auth defines the information necessary to authenticate against chef Server</p>
  3962. </td>
  3963. </tr>
  3964. <tr>
  3965. <td>
  3966. <code>username</code></br>
  3967. <em>
  3968. string
  3969. </em>
  3970. </td>
  3971. <td>
  3972. <p>UserName should be the user ID on the chef server</p>
  3973. </td>
  3974. </tr>
  3975. <tr>
  3976. <td>
  3977. <code>serverUrl</code></br>
  3978. <em>
  3979. string
  3980. </em>
  3981. </td>
  3982. <td>
  3983. <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>
  3984. </td>
  3985. </tr>
  3986. </tbody>
  3987. </table>
  3988. <h3 id="external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider
  3989. </h3>
  3990. <p>
  3991. (<em>Appears on:</em>
  3992. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3993. </p>
  3994. <p>
  3995. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  3996. </p>
  3997. <table>
  3998. <thead>
  3999. <tr>
  4000. <th>Field</th>
  4001. <th>Description</th>
  4002. </tr>
  4003. </thead>
  4004. <tbody>
  4005. <tr>
  4006. <td>
  4007. <code>auth</code></br>
  4008. <em>
  4009. <a href="#external-secrets.io/v1.CSMAuth">
  4010. CSMAuth
  4011. </a>
  4012. </em>
  4013. </td>
  4014. <td>
  4015. </td>
  4016. </tr>
  4017. <tr>
  4018. <td>
  4019. <code>projectID</code></br>
  4020. <em>
  4021. string
  4022. </em>
  4023. </td>
  4024. <td>
  4025. <p>ProjectID is the project, which the secrets are stored in.</p>
  4026. </td>
  4027. </tr>
  4028. </tbody>
  4029. </table>
  4030. <h3 id="external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret
  4031. </h3>
  4032. <p>
  4033. <p>ClusterExternalSecret is the Schema for the clusterexternalsecrets API.</p>
  4034. </p>
  4035. <table>
  4036. <thead>
  4037. <tr>
  4038. <th>Field</th>
  4039. <th>Description</th>
  4040. </tr>
  4041. </thead>
  4042. <tbody>
  4043. <tr>
  4044. <td>
  4045. <code>metadata</code></br>
  4046. <em>
  4047. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  4048. Kubernetes meta/v1.ObjectMeta
  4049. </a>
  4050. </em>
  4051. </td>
  4052. <td>
  4053. Refer to the Kubernetes API documentation for the fields of the
  4054. <code>metadata</code> field.
  4055. </td>
  4056. </tr>
  4057. <tr>
  4058. <td>
  4059. <code>spec</code></br>
  4060. <em>
  4061. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">
  4062. ClusterExternalSecretSpec
  4063. </a>
  4064. </em>
  4065. </td>
  4066. <td>
  4067. <br/>
  4068. <br/>
  4069. <table>
  4070. <tr>
  4071. <td>
  4072. <code>externalSecretSpec</code></br>
  4073. <em>
  4074. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  4075. ExternalSecretSpec
  4076. </a>
  4077. </em>
  4078. </td>
  4079. <td>
  4080. <p>The spec for the ExternalSecrets to be created</p>
  4081. </td>
  4082. </tr>
  4083. <tr>
  4084. <td>
  4085. <code>externalSecretName</code></br>
  4086. <em>
  4087. string
  4088. </em>
  4089. </td>
  4090. <td>
  4091. <em>(Optional)</em>
  4092. <p>The name of the external secrets to be created.
  4093. Defaults to the name of the ClusterExternalSecret</p>
  4094. </td>
  4095. </tr>
  4096. <tr>
  4097. <td>
  4098. <code>externalSecretMetadata</code></br>
  4099. <em>
  4100. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  4101. ExternalSecretMetadata
  4102. </a>
  4103. </em>
  4104. </td>
  4105. <td>
  4106. <em>(Optional)</em>
  4107. <p>The metadata of the external secrets to be created</p>
  4108. </td>
  4109. </tr>
  4110. <tr>
  4111. <td>
  4112. <code>namespaceSelector</code></br>
  4113. <em>
  4114. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4115. Kubernetes meta/v1.LabelSelector
  4116. </a>
  4117. </em>
  4118. </td>
  4119. <td>
  4120. <em>(Optional)</em>
  4121. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  4122. <p>Deprecated: Use NamespaceSelectors instead.</p>
  4123. </td>
  4124. </tr>
  4125. <tr>
  4126. <td>
  4127. <code>namespaceSelectors</code></br>
  4128. <em>
  4129. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  4130. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  4131. </a>
  4132. </em>
  4133. </td>
  4134. <td>
  4135. <em>(Optional)</em>
  4136. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  4137. </td>
  4138. </tr>
  4139. <tr>
  4140. <td>
  4141. <code>namespaces</code></br>
  4142. <em>
  4143. []string
  4144. </em>
  4145. </td>
  4146. <td>
  4147. <em>(Optional)</em>
  4148. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  4149. <p>Deprecated: Use NamespaceSelectors instead.</p>
  4150. </td>
  4151. </tr>
  4152. <tr>
  4153. <td>
  4154. <code>refreshTime</code></br>
  4155. <em>
  4156. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  4157. Kubernetes meta/v1.Duration
  4158. </a>
  4159. </em>
  4160. </td>
  4161. <td>
  4162. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  4163. </td>
  4164. </tr>
  4165. </table>
  4166. </td>
  4167. </tr>
  4168. <tr>
  4169. <td>
  4170. <code>status</code></br>
  4171. <em>
  4172. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">
  4173. ClusterExternalSecretStatus
  4174. </a>
  4175. </em>
  4176. </td>
  4177. <td>
  4178. </td>
  4179. </tr>
  4180. </tbody>
  4181. </table>
  4182. <h3 id="external-secrets.io/v1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  4183. (<code>string</code> alias)</p></h3>
  4184. <p>
  4185. (<em>Appears on:</em>
  4186. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  4187. </p>
  4188. <p>
  4189. <p>ClusterExternalSecretConditionType defines a value type for ClusterExternalSecret conditions.</p>
  4190. </p>
  4191. <table>
  4192. <thead>
  4193. <tr>
  4194. <th>Value</th>
  4195. <th>Description</th>
  4196. </tr>
  4197. </thead>
  4198. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  4199. <td><p>ClusterExternalSecretReady is a ClusterExternalSecretConditionType set when the ClusterExternalSecret is ready.</p>
  4200. </td>
  4201. </tr></tbody>
  4202. </table>
  4203. <h3 id="external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  4204. </h3>
  4205. <p>
  4206. (<em>Appears on:</em>
  4207. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  4208. </p>
  4209. <p>
  4210. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  4211. </p>
  4212. <table>
  4213. <thead>
  4214. <tr>
  4215. <th>Field</th>
  4216. <th>Description</th>
  4217. </tr>
  4218. </thead>
  4219. <tbody>
  4220. <tr>
  4221. <td>
  4222. <code>namespace</code></br>
  4223. <em>
  4224. string
  4225. </em>
  4226. </td>
  4227. <td>
  4228. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  4229. </td>
  4230. </tr>
  4231. <tr>
  4232. <td>
  4233. <code>reason</code></br>
  4234. <em>
  4235. string
  4236. </em>
  4237. </td>
  4238. <td>
  4239. <em>(Optional)</em>
  4240. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  4241. </td>
  4242. </tr>
  4243. </tbody>
  4244. </table>
  4245. <h3 id="external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  4246. </h3>
  4247. <p>
  4248. (<em>Appears on:</em>
  4249. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  4250. </p>
  4251. <p>
  4252. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  4253. </p>
  4254. <table>
  4255. <thead>
  4256. <tr>
  4257. <th>Field</th>
  4258. <th>Description</th>
  4259. </tr>
  4260. </thead>
  4261. <tbody>
  4262. <tr>
  4263. <td>
  4264. <code>externalSecretSpec</code></br>
  4265. <em>
  4266. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  4267. ExternalSecretSpec
  4268. </a>
  4269. </em>
  4270. </td>
  4271. <td>
  4272. <p>The spec for the ExternalSecrets to be created</p>
  4273. </td>
  4274. </tr>
  4275. <tr>
  4276. <td>
  4277. <code>externalSecretName</code></br>
  4278. <em>
  4279. string
  4280. </em>
  4281. </td>
  4282. <td>
  4283. <em>(Optional)</em>
  4284. <p>The name of the external secrets to be created.
  4285. Defaults to the name of the ClusterExternalSecret</p>
  4286. </td>
  4287. </tr>
  4288. <tr>
  4289. <td>
  4290. <code>externalSecretMetadata</code></br>
  4291. <em>
  4292. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  4293. ExternalSecretMetadata
  4294. </a>
  4295. </em>
  4296. </td>
  4297. <td>
  4298. <em>(Optional)</em>
  4299. <p>The metadata of the external secrets to be created</p>
  4300. </td>
  4301. </tr>
  4302. <tr>
  4303. <td>
  4304. <code>namespaceSelector</code></br>
  4305. <em>
  4306. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4307. Kubernetes meta/v1.LabelSelector
  4308. </a>
  4309. </em>
  4310. </td>
  4311. <td>
  4312. <em>(Optional)</em>
  4313. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  4314. <p>Deprecated: Use NamespaceSelectors instead.</p>
  4315. </td>
  4316. </tr>
  4317. <tr>
  4318. <td>
  4319. <code>namespaceSelectors</code></br>
  4320. <em>
  4321. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  4322. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  4323. </a>
  4324. </em>
  4325. </td>
  4326. <td>
  4327. <em>(Optional)</em>
  4328. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  4329. </td>
  4330. </tr>
  4331. <tr>
  4332. <td>
  4333. <code>namespaces</code></br>
  4334. <em>
  4335. []string
  4336. </em>
  4337. </td>
  4338. <td>
  4339. <em>(Optional)</em>
  4340. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  4341. <p>Deprecated: Use NamespaceSelectors instead.</p>
  4342. </td>
  4343. </tr>
  4344. <tr>
  4345. <td>
  4346. <code>refreshTime</code></br>
  4347. <em>
  4348. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  4349. Kubernetes meta/v1.Duration
  4350. </a>
  4351. </em>
  4352. </td>
  4353. <td>
  4354. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  4355. </td>
  4356. </tr>
  4357. </tbody>
  4358. </table>
  4359. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  4360. </h3>
  4361. <p>
  4362. (<em>Appears on:</em>
  4363. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  4364. </p>
  4365. <p>
  4366. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  4367. </p>
  4368. <table>
  4369. <thead>
  4370. <tr>
  4371. <th>Field</th>
  4372. <th>Description</th>
  4373. </tr>
  4374. </thead>
  4375. <tbody>
  4376. <tr>
  4377. <td>
  4378. <code>externalSecretName</code></br>
  4379. <em>
  4380. string
  4381. </em>
  4382. </td>
  4383. <td>
  4384. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  4385. </td>
  4386. </tr>
  4387. <tr>
  4388. <td>
  4389. <code>failedNamespaces</code></br>
  4390. <em>
  4391. <a href="#external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">
  4392. []ClusterExternalSecretNamespaceFailure
  4393. </a>
  4394. </em>
  4395. </td>
  4396. <td>
  4397. <em>(Optional)</em>
  4398. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  4399. </td>
  4400. </tr>
  4401. <tr>
  4402. <td>
  4403. <code>provisionedNamespaces</code></br>
  4404. <em>
  4405. []string
  4406. </em>
  4407. </td>
  4408. <td>
  4409. <em>(Optional)</em>
  4410. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  4411. </td>
  4412. </tr>
  4413. <tr>
  4414. <td>
  4415. <code>conditions</code></br>
  4416. <em>
  4417. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">
  4418. []ClusterExternalSecretStatusCondition
  4419. </a>
  4420. </em>
  4421. </td>
  4422. <td>
  4423. <em>(Optional)</em>
  4424. </td>
  4425. </tr>
  4426. </tbody>
  4427. </table>
  4428. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  4429. </h3>
  4430. <p>
  4431. (<em>Appears on:</em>
  4432. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  4433. </p>
  4434. <p>
  4435. <p>ClusterExternalSecretStatusCondition defines the observed state of a ClusterExternalSecret resource.</p>
  4436. </p>
  4437. <table>
  4438. <thead>
  4439. <tr>
  4440. <th>Field</th>
  4441. <th>Description</th>
  4442. </tr>
  4443. </thead>
  4444. <tbody>
  4445. <tr>
  4446. <td>
  4447. <code>type</code></br>
  4448. <em>
  4449. <a href="#external-secrets.io/v1.ClusterExternalSecretConditionType">
  4450. ClusterExternalSecretConditionType
  4451. </a>
  4452. </em>
  4453. </td>
  4454. <td>
  4455. </td>
  4456. </tr>
  4457. <tr>
  4458. <td>
  4459. <code>status</code></br>
  4460. <em>
  4461. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  4462. Kubernetes core/v1.ConditionStatus
  4463. </a>
  4464. </em>
  4465. </td>
  4466. <td>
  4467. </td>
  4468. </tr>
  4469. <tr>
  4470. <td>
  4471. <code>message</code></br>
  4472. <em>
  4473. string
  4474. </em>
  4475. </td>
  4476. <td>
  4477. <em>(Optional)</em>
  4478. </td>
  4479. </tr>
  4480. </tbody>
  4481. </table>
  4482. <h3 id="external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore
  4483. </h3>
  4484. <p>
  4485. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  4486. </p>
  4487. <table>
  4488. <thead>
  4489. <tr>
  4490. <th>Field</th>
  4491. <th>Description</th>
  4492. </tr>
  4493. </thead>
  4494. <tbody>
  4495. <tr>
  4496. <td>
  4497. <code>metadata</code></br>
  4498. <em>
  4499. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  4500. Kubernetes meta/v1.ObjectMeta
  4501. </a>
  4502. </em>
  4503. </td>
  4504. <td>
  4505. Refer to the Kubernetes API documentation for the fields of the
  4506. <code>metadata</code> field.
  4507. </td>
  4508. </tr>
  4509. <tr>
  4510. <td>
  4511. <code>spec</code></br>
  4512. <em>
  4513. <a href="#external-secrets.io/v1.SecretStoreSpec">
  4514. SecretStoreSpec
  4515. </a>
  4516. </em>
  4517. </td>
  4518. <td>
  4519. <br/>
  4520. <br/>
  4521. <table>
  4522. <tr>
  4523. <td>
  4524. <code>controller</code></br>
  4525. <em>
  4526. string
  4527. </em>
  4528. </td>
  4529. <td>
  4530. <em>(Optional)</em>
  4531. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  4532. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  4533. </td>
  4534. </tr>
  4535. <tr>
  4536. <td>
  4537. <code>provider</code></br>
  4538. <em>
  4539. <a href="#external-secrets.io/v1.SecretStoreProvider">
  4540. SecretStoreProvider
  4541. </a>
  4542. </em>
  4543. </td>
  4544. <td>
  4545. <p>Used to configure the provider. Only one provider may be set</p>
  4546. </td>
  4547. </tr>
  4548. <tr>
  4549. <td>
  4550. <code>retrySettings</code></br>
  4551. <em>
  4552. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  4553. SecretStoreRetrySettings
  4554. </a>
  4555. </em>
  4556. </td>
  4557. <td>
  4558. <em>(Optional)</em>
  4559. <p>Used to configure HTTP retries on failures.</p>
  4560. </td>
  4561. </tr>
  4562. <tr>
  4563. <td>
  4564. <code>refreshInterval</code></br>
  4565. <em>
  4566. k8s.io/apimachinery/pkg/util/intstr.IntOrString
  4567. </em>
  4568. </td>
  4569. <td>
  4570. <em>(Optional)</em>
  4571. <p>Used to configure store refresh interval. Accepts either an integer number
  4572. of seconds (legacy) or a Go duration string such as &ldquo;1h&rdquo; or &ldquo;5m&rdquo;. Empty or
  4573. 0 will default to the controller config.</p>
  4574. </td>
  4575. </tr>
  4576. <tr>
  4577. <td>
  4578. <code>conditions</code></br>
  4579. <em>
  4580. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  4581. []ClusterSecretStoreCondition
  4582. </a>
  4583. </em>
  4584. </td>
  4585. <td>
  4586. <em>(Optional)</em>
  4587. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  4588. </td>
  4589. </tr>
  4590. </table>
  4591. </td>
  4592. </tr>
  4593. <tr>
  4594. <td>
  4595. <code>status</code></br>
  4596. <em>
  4597. <a href="#external-secrets.io/v1.SecretStoreStatus">
  4598. SecretStoreStatus
  4599. </a>
  4600. </em>
  4601. </td>
  4602. <td>
  4603. </td>
  4604. </tr>
  4605. </tbody>
  4606. </table>
  4607. <h3 id="external-secrets.io/v1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  4608. </h3>
  4609. <p>
  4610. (<em>Appears on:</em>
  4611. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  4612. </p>
  4613. <p>
  4614. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  4615. for a ClusterSecretStore instance.</p>
  4616. </p>
  4617. <table>
  4618. <thead>
  4619. <tr>
  4620. <th>Field</th>
  4621. <th>Description</th>
  4622. </tr>
  4623. </thead>
  4624. <tbody>
  4625. <tr>
  4626. <td>
  4627. <code>namespaceSelector</code></br>
  4628. <em>
  4629. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4630. Kubernetes meta/v1.LabelSelector
  4631. </a>
  4632. </em>
  4633. </td>
  4634. <td>
  4635. <em>(Optional)</em>
  4636. <p>Choose namespace using a labelSelector</p>
  4637. </td>
  4638. </tr>
  4639. <tr>
  4640. <td>
  4641. <code>namespaces</code></br>
  4642. <em>
  4643. []string
  4644. </em>
  4645. </td>
  4646. <td>
  4647. <em>(Optional)</em>
  4648. <p>Choose namespaces by name</p>
  4649. </td>
  4650. </tr>
  4651. <tr>
  4652. <td>
  4653. <code>namespaceRegexes</code></br>
  4654. <em>
  4655. []string
  4656. </em>
  4657. </td>
  4658. <td>
  4659. <em>(Optional)</em>
  4660. <p>Choose namespaces by using regex matching</p>
  4661. </td>
  4662. </tr>
  4663. </tbody>
  4664. </table>
  4665. <h3 id="external-secrets.io/v1.ConfigMapReference">ConfigMapReference
  4666. </h3>
  4667. <p>
  4668. (<em>Appears on:</em>
  4669. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  4670. </p>
  4671. <p>
  4672. <p>ConfigMapReference holds the details of a configmap.</p>
  4673. </p>
  4674. <table>
  4675. <thead>
  4676. <tr>
  4677. <th>Field</th>
  4678. <th>Description</th>
  4679. </tr>
  4680. </thead>
  4681. <tbody>
  4682. <tr>
  4683. <td>
  4684. <code>name</code></br>
  4685. <em>
  4686. string
  4687. </em>
  4688. </td>
  4689. <td>
  4690. <p>name of the configmap.</p>
  4691. </td>
  4692. </tr>
  4693. <tr>
  4694. <td>
  4695. <code>namespace</code></br>
  4696. <em>
  4697. string
  4698. </em>
  4699. </td>
  4700. <td>
  4701. <p>namespace in which the configmap exists. If empty, configmap will looked up in local namespace.</p>
  4702. </td>
  4703. </tr>
  4704. <tr>
  4705. <td>
  4706. <code>key</code></br>
  4707. <em>
  4708. string
  4709. </em>
  4710. </td>
  4711. <td>
  4712. <p>key name holding the external account credential config.</p>
  4713. </td>
  4714. </tr>
  4715. </tbody>
  4716. </table>
  4717. <h3 id="external-secrets.io/v1.ConjurAPIKey">ConjurAPIKey
  4718. </h3>
  4719. <p>
  4720. (<em>Appears on:</em>
  4721. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4722. </p>
  4723. <p>
  4724. <p>ConjurAPIKey contains references to a Secret resource that holds
  4725. the Conjur username and API key.</p>
  4726. </p>
  4727. <table>
  4728. <thead>
  4729. <tr>
  4730. <th>Field</th>
  4731. <th>Description</th>
  4732. </tr>
  4733. </thead>
  4734. <tbody>
  4735. <tr>
  4736. <td>
  4737. <code>account</code></br>
  4738. <em>
  4739. string
  4740. </em>
  4741. </td>
  4742. <td>
  4743. <p>Account is the Conjur organization account name.</p>
  4744. </td>
  4745. </tr>
  4746. <tr>
  4747. <td>
  4748. <code>userRef</code></br>
  4749. <em>
  4750. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4751. External Secrets meta/v1.SecretKeySelector
  4752. </a>
  4753. </em>
  4754. </td>
  4755. <td>
  4756. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  4757. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4758. </td>
  4759. </tr>
  4760. <tr>
  4761. <td>
  4762. <code>apiKeyRef</code></br>
  4763. <em>
  4764. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4765. External Secrets meta/v1.SecretKeySelector
  4766. </a>
  4767. </em>
  4768. </td>
  4769. <td>
  4770. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  4771. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4772. </td>
  4773. </tr>
  4774. </tbody>
  4775. </table>
  4776. <h3 id="external-secrets.io/v1.ConjurAuth">ConjurAuth
  4777. </h3>
  4778. <p>
  4779. (<em>Appears on:</em>
  4780. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>)
  4781. </p>
  4782. <p>
  4783. <p>ConjurAuth is the way to provide authentication credentials to the ConjurProvider.</p>
  4784. </p>
  4785. <table>
  4786. <thead>
  4787. <tr>
  4788. <th>Field</th>
  4789. <th>Description</th>
  4790. </tr>
  4791. </thead>
  4792. <tbody>
  4793. <tr>
  4794. <td>
  4795. <code>apikey</code></br>
  4796. <em>
  4797. <a href="#external-secrets.io/v1.ConjurAPIKey">
  4798. ConjurAPIKey
  4799. </a>
  4800. </em>
  4801. </td>
  4802. <td>
  4803. <em>(Optional)</em>
  4804. <p>Authenticates with Conjur using an API key.</p>
  4805. </td>
  4806. </tr>
  4807. <tr>
  4808. <td>
  4809. <code>jwt</code></br>
  4810. <em>
  4811. <a href="#external-secrets.io/v1.ConjurJWT">
  4812. ConjurJWT
  4813. </a>
  4814. </em>
  4815. </td>
  4816. <td>
  4817. <em>(Optional)</em>
  4818. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  4819. </td>
  4820. </tr>
  4821. <tr>
  4822. <td>
  4823. <code>cert</code></br>
  4824. <em>
  4825. <a href="#external-secrets.io/v1.ConjurCert">
  4826. ConjurCert
  4827. </a>
  4828. </em>
  4829. </td>
  4830. <td>
  4831. <em>(Optional)</em>
  4832. <p>Cert enables certificate-based authentication using a client certificate and key.</p>
  4833. </td>
  4834. </tr>
  4835. </tbody>
  4836. </table>
  4837. <h3 id="external-secrets.io/v1.ConjurCert">ConjurCert
  4838. </h3>
  4839. <p>
  4840. (<em>Appears on:</em>
  4841. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4842. </p>
  4843. <p>
  4844. <p>ConjurCert defines the Cert authentication configuration for Conjur provider.</p>
  4845. </p>
  4846. <table>
  4847. <thead>
  4848. <tr>
  4849. <th>Field</th>
  4850. <th>Description</th>
  4851. </tr>
  4852. </thead>
  4853. <tbody>
  4854. <tr>
  4855. <td>
  4856. <code>account</code></br>
  4857. <em>
  4858. string
  4859. </em>
  4860. </td>
  4861. <td>
  4862. <p>Account is the Conjur organization account name.</p>
  4863. </td>
  4864. </tr>
  4865. <tr>
  4866. <td>
  4867. <code>serviceID</code></br>
  4868. <em>
  4869. string
  4870. </em>
  4871. </td>
  4872. <td>
  4873. <p>The conjur authn cert webservice id</p>
  4874. </td>
  4875. </tr>
  4876. <tr>
  4877. <td>
  4878. <code>hostId</code></br>
  4879. <em>
  4880. string
  4881. </em>
  4882. </td>
  4883. <td>
  4884. <em>(Optional)</em>
  4885. <p>Optional HostID for cert authentication (can be omitted when using &lsquo;spiffe&rsquo; mode).</p>
  4886. </td>
  4887. </tr>
  4888. <tr>
  4889. <td>
  4890. <code>clientCertRef</code></br>
  4891. <em>
  4892. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4893. External Secrets meta/v1.SecretKeySelector
  4894. </a>
  4895. </em>
  4896. </td>
  4897. <td>
  4898. <p>ClientCertRef is a reference to a specific &lsquo;key&rsquo; containing the client certificate
  4899. within a Secret resource. The certificate must be PEM-encoded.</p>
  4900. </td>
  4901. </tr>
  4902. <tr>
  4903. <td>
  4904. <code>clientKeyRef</code></br>
  4905. <em>
  4906. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4907. External Secrets meta/v1.SecretKeySelector
  4908. </a>
  4909. </em>
  4910. </td>
  4911. <td>
  4912. <p>ClientKeyRef is a reference to a specific &lsquo;key&rsquo; containing the private RSA client key
  4913. within a Secret resource. The key must be PEM-encoded.</p>
  4914. </td>
  4915. </tr>
  4916. </tbody>
  4917. </table>
  4918. <h3 id="external-secrets.io/v1.ConjurJWT">ConjurJWT
  4919. </h3>
  4920. <p>
  4921. (<em>Appears on:</em>
  4922. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4923. </p>
  4924. <p>
  4925. <p>ConjurJWT defines the JWT authentication configuration for Conjur provider.</p>
  4926. </p>
  4927. <table>
  4928. <thead>
  4929. <tr>
  4930. <th>Field</th>
  4931. <th>Description</th>
  4932. </tr>
  4933. </thead>
  4934. <tbody>
  4935. <tr>
  4936. <td>
  4937. <code>account</code></br>
  4938. <em>
  4939. string
  4940. </em>
  4941. </td>
  4942. <td>
  4943. <p>Account is the Conjur organization account name.</p>
  4944. </td>
  4945. </tr>
  4946. <tr>
  4947. <td>
  4948. <code>serviceID</code></br>
  4949. <em>
  4950. string
  4951. </em>
  4952. </td>
  4953. <td>
  4954. <p>The conjur authn jwt webservice id</p>
  4955. </td>
  4956. </tr>
  4957. <tr>
  4958. <td>
  4959. <code>hostId</code></br>
  4960. <em>
  4961. string
  4962. </em>
  4963. </td>
  4964. <td>
  4965. <em>(Optional)</em>
  4966. <p>Optional HostID for JWT authentication. This may be used depending
  4967. on how the Conjur JWT authenticator policy is configured.</p>
  4968. </td>
  4969. </tr>
  4970. <tr>
  4971. <td>
  4972. <code>secretRef</code></br>
  4973. <em>
  4974. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4975. External Secrets meta/v1.SecretKeySelector
  4976. </a>
  4977. </em>
  4978. </td>
  4979. <td>
  4980. <em>(Optional)</em>
  4981. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  4982. authenticate with Conjur using the JWT authentication method.</p>
  4983. </td>
  4984. </tr>
  4985. <tr>
  4986. <td>
  4987. <code>serviceAccountRef</code></br>
  4988. <em>
  4989. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  4990. External Secrets meta/v1.ServiceAccountSelector
  4991. </a>
  4992. </em>
  4993. </td>
  4994. <td>
  4995. <em>(Optional)</em>
  4996. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  4997. a token for with the <code>TokenRequest</code> API.</p>
  4998. </td>
  4999. </tr>
  5000. </tbody>
  5001. </table>
  5002. <h3 id="external-secrets.io/v1.ConjurProvider">ConjurProvider
  5003. </h3>
  5004. <p>
  5005. (<em>Appears on:</em>
  5006. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  5007. </p>
  5008. <p>
  5009. <p>ConjurProvider provides access to a Conjur provider.</p>
  5010. </p>
  5011. <table>
  5012. <thead>
  5013. <tr>
  5014. <th>Field</th>
  5015. <th>Description</th>
  5016. </tr>
  5017. </thead>
  5018. <tbody>
  5019. <tr>
  5020. <td>
  5021. <code>url</code></br>
  5022. <em>
  5023. string
  5024. </em>
  5025. </td>
  5026. <td>
  5027. <p>URL is the endpoint of the Conjur instance.</p>
  5028. </td>
  5029. </tr>
  5030. <tr>
  5031. <td>
  5032. <code>caBundle</code></br>
  5033. <em>
  5034. string
  5035. </em>
  5036. </td>
  5037. <td>
  5038. <em>(Optional)</em>
  5039. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  5040. </td>
  5041. </tr>
  5042. <tr>
  5043. <td>
  5044. <code>caProvider</code></br>
  5045. <em>
  5046. <a href="#external-secrets.io/v1.CAProvider">
  5047. CAProvider
  5048. </a>
  5049. </em>
  5050. </td>
  5051. <td>
  5052. <em>(Optional)</em>
  5053. <p>Used to provide custom certificate authority (CA) certificates
  5054. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  5055. that contains a PEM-encoded certificate.</p>
  5056. </td>
  5057. </tr>
  5058. <tr>
  5059. <td>
  5060. <code>auth</code></br>
  5061. <em>
  5062. <a href="#external-secrets.io/v1.ConjurAuth">
  5063. ConjurAuth
  5064. </a>
  5065. </em>
  5066. </td>
  5067. <td>
  5068. <p>Defines authentication settings for connecting to Conjur.</p>
  5069. </td>
  5070. </tr>
  5071. </tbody>
  5072. </table>
  5073. <h3 id="external-secrets.io/v1.DVLSAuth">DVLSAuth
  5074. </h3>
  5075. <p>
  5076. (<em>Appears on:</em>
  5077. <a href="#external-secrets.io/v1.DVLSProvider">DVLSProvider</a>)
  5078. </p>
  5079. <p>
  5080. <p>DVLSAuth defines the authentication method for the DVLS provider.</p>
  5081. </p>
  5082. <table>
  5083. <thead>
  5084. <tr>
  5085. <th>Field</th>
  5086. <th>Description</th>
  5087. </tr>
  5088. </thead>
  5089. <tbody>
  5090. <tr>
  5091. <td>
  5092. <code>secretRef</code></br>
  5093. <em>
  5094. <a href="#external-secrets.io/v1.DVLSAuthSecretRef">
  5095. DVLSAuthSecretRef
  5096. </a>
  5097. </em>
  5098. </td>
  5099. <td>
  5100. <p>SecretRef contains the Application ID and Application Secret for authentication.</p>
  5101. </td>
  5102. </tr>
  5103. </tbody>
  5104. </table>
  5105. <h3 id="external-secrets.io/v1.DVLSAuthSecretRef">DVLSAuthSecretRef
  5106. </h3>
  5107. <p>
  5108. (<em>Appears on:</em>
  5109. <a href="#external-secrets.io/v1.DVLSAuth">DVLSAuth</a>)
  5110. </p>
  5111. <p>
  5112. <p>DVLSAuthSecretRef defines the secret references for DVLS authentication credentials.</p>
  5113. </p>
  5114. <table>
  5115. <thead>
  5116. <tr>
  5117. <th>Field</th>
  5118. <th>Description</th>
  5119. </tr>
  5120. </thead>
  5121. <tbody>
  5122. <tr>
  5123. <td>
  5124. <code>appId</code></br>
  5125. <em>
  5126. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  5127. External Secrets meta/v1.SecretKeySelector
  5128. </a>
  5129. </em>
  5130. </td>
  5131. <td>
  5132. <p>AppID is the reference to the secret containing the Application ID.</p>
  5133. </td>
  5134. </tr>
  5135. <tr>
  5136. <td>
  5137. <code>appSecret</code></br>
  5138. <em>
  5139. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  5140. External Secrets meta/v1.SecretKeySelector
  5141. </a>
  5142. </em>
  5143. </td>
  5144. <td>
  5145. <p>AppSecret is the reference to the secret containing the Application Secret.</p>
  5146. </td>
  5147. </tr>
  5148. </tbody>
  5149. </table>
  5150. <h3 id="external-secrets.io/v1.DVLSProvider">DVLSProvider
  5151. </h3>
  5152. <p>
  5153. (<em>Appears on:</em>
  5154. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  5155. </p>
  5156. <p>
  5157. <p>DVLSProvider configures a store to sync secrets using Devolutions Server.</p>
  5158. </p>
  5159. <table>
  5160. <thead>
  5161. <tr>
  5162. <th>Field</th>
  5163. <th>Description</th>
  5164. </tr>
  5165. </thead>
  5166. <tbody>
  5167. <tr>
  5168. <td>
  5169. <code>serverUrl</code></br>
  5170. <em>
  5171. string
  5172. </em>
  5173. </td>
  5174. <td>
  5175. <p>ServerURL is the DVLS instance URL (e.g., <a href="https://dvls.example.com">https://dvls.example.com</a>).</p>
  5176. </td>
  5177. </tr>
  5178. <tr>
  5179. <td>
  5180. <code>vault</code></br>
  5181. <em>
  5182. string
  5183. </em>
  5184. </td>
  5185. <td>
  5186. <em>(Optional)</em>
  5187. <p>Vault is the name or UUID of the vault to fetch secrets from.
  5188. When omitted, the vault must be specified in the secret key using the legacy format &ldquo;<vault-id>/<entry-id>&rdquo;.</p>
  5189. </td>
  5190. </tr>
  5191. <tr>
  5192. <td>
  5193. <code>insecure</code></br>
  5194. <em>
  5195. bool
  5196. </em>
  5197. </td>
  5198. <td>
  5199. <em>(Optional)</em>
  5200. <p>Insecure allows connecting to DVLS over plain HTTP.
  5201. This is NOT RECOMMENDED for production use.
  5202. Set to true only if you understand the security implications.</p>
  5203. </td>
  5204. </tr>
  5205. <tr>
  5206. <td>
  5207. <code>auth</code></br>
  5208. <em>
  5209. <a href="#external-secrets.io/v1.DVLSAuth">
  5210. DVLSAuth
  5211. </a>
  5212. </em>
  5213. </td>
  5214. <td>
  5215. <p>Auth defines the authentication method to use.</p>
  5216. </td>
  5217. </tr>
  5218. </tbody>
  5219. </table>
  5220. <h3 id="external-secrets.io/v1.DelineaProvider">DelineaProvider
  5221. </h3>
  5222. <p>
  5223. (<em>Appears on:</em>
  5224. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  5225. </p>
  5226. <p>
  5227. <p>DelineaProvider provides access to Delinea secrets vault Server.
  5228. 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>
  5229. </p>
  5230. <table>
  5231. <thead>
  5232. <tr>
  5233. <th>Field</th>
  5234. <th>Description</th>
  5235. </tr>
  5236. </thead>
  5237. <tbody>
  5238. <tr>
  5239. <td>
  5240. <code>clientId</code></br>
  5241. <em>
  5242. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  5243. DelineaProviderSecretRef
  5244. </a>
  5245. </em>
  5246. </td>
  5247. <td>
  5248. <p>ClientID is the non-secret part of the credential.</p>
  5249. </td>
  5250. </tr>
  5251. <tr>
  5252. <td>
  5253. <code>clientSecret</code></br>
  5254. <em>
  5255. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  5256. DelineaProviderSecretRef
  5257. </a>
  5258. </em>
  5259. </td>
  5260. <td>
  5261. <p>ClientSecret is the secret part of the credential.</p>
  5262. </td>
  5263. </tr>
  5264. <tr>
  5265. <td>
  5266. <code>tenant</code></br>
  5267. <em>
  5268. string
  5269. </em>
  5270. </td>
  5271. <td>
  5272. <p>Tenant is the chosen hostname / site name.</p>
  5273. </td>
  5274. </tr>
  5275. <tr>
  5276. <td>
  5277. <code>urlTemplate</code></br>
  5278. <em>
  5279. string
  5280. </em>
  5281. </td>
  5282. <td>
  5283. <em>(Optional)</em>
  5284. <p>URLTemplate
  5285. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  5286. </td>
  5287. </tr>
  5288. <tr>
  5289. <td>
  5290. <code>tld</code></br>
  5291. <em>
  5292. string
  5293. </em>
  5294. </td>
  5295. <td>
  5296. <em>(Optional)</em>
  5297. <p>TLD is based on the server location that was chosen during provisioning.
  5298. If unset, defaults to &ldquo;com&rdquo;.</p>
  5299. </td>
  5300. </tr>
  5301. </tbody>
  5302. </table>
  5303. <h3 id="external-secrets.io/v1.DelineaProviderSecretRef">DelineaProviderSecretRef
  5304. </h3>
  5305. <p>
  5306. (<em>Appears on:</em>
  5307. <a href="#external-secrets.io/v1.DelineaProvider">DelineaProvider</a>)
  5308. </p>
  5309. <p>
  5310. <p>DelineaProviderSecretRef is a secret reference containing either a direct value or a reference to a secret key.</p>
  5311. </p>
  5312. <table>
  5313. <thead>
  5314. <tr>
  5315. <th>Field</th>
  5316. <th>Description</th>
  5317. </tr>
  5318. </thead>
  5319. <tbody>
  5320. <tr>
  5321. <td>
  5322. <code>value</code></br>
  5323. <em>
  5324. string
  5325. </em>
  5326. </td>
  5327. <td>
  5328. <em>(Optional)</em>
  5329. <p>Value can be specified directly to set a value without using a secret.</p>
  5330. </td>
  5331. </tr>
  5332. <tr>
  5333. <td>
  5334. <code>secretRef</code></br>
  5335. <em>
  5336. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  5337. External Secrets meta/v1.SecretKeySelector
  5338. </a>
  5339. </em>
  5340. </td>
  5341. <td>
  5342. <em>(Optional)</em>
  5343. <p>SecretRef references a key in a secret that will be used as value.</p>
  5344. </td>
  5345. </tr>
  5346. </tbody>
  5347. </table>
  5348. <h3 id="external-secrets.io/v1.DopplerAuth">DopplerAuth
  5349. </h3>
  5350. <p>
  5351. (<em>Appears on:</em>
  5352. <a href="#external-secrets.io/v1.DopplerProvider">DopplerProvider</a>)
  5353. </p>
  5354. <p>
  5355. <p>DopplerAuth configures authentication with the Doppler API.
  5356. Exactly one of secretRef or oidcConfig must be specified.</p>
  5357. </p>
  5358. <table>
  5359. <thead>
  5360. <tr>
  5361. <th>Field</th>
  5362. <th>Description</th>
  5363. </tr>
  5364. </thead>
  5365. <tbody>
  5366. <tr>
  5367. <td>
  5368. <code>secretRef</code></br>
  5369. <em>
  5370. <a href="#external-secrets.io/v1.DopplerAuthSecretRef">
  5371. DopplerAuthSecretRef
  5372. </a>
  5373. </em>
  5374. </td>
  5375. <td>
  5376. <em>(Optional)</em>
  5377. <p>SecretRef authenticates using a Doppler service token stored in a Kubernetes Secret.</p>
  5378. </td>
  5379. </tr>
  5380. <tr>
  5381. <td>
  5382. <code>oidcConfig</code></br>
  5383. <em>
  5384. <a href="#external-secrets.io/v1.DopplerOIDCAuth">
  5385. DopplerOIDCAuth
  5386. </a>
  5387. </em>
  5388. </td>
  5389. <td>
  5390. <em>(Optional)</em>
  5391. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  5392. </td>
  5393. </tr>
  5394. </tbody>
  5395. </table>
  5396. <h3 id="external-secrets.io/v1.DopplerAuthSecretRef">DopplerAuthSecretRef
  5397. </h3>
  5398. <p>
  5399. (<em>Appears on:</em>
  5400. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  5401. </p>
  5402. <p>
  5403. <p>DopplerAuthSecretRef contains the secret reference for accessing the Doppler API.</p>
  5404. </p>
  5405. <table>
  5406. <thead>
  5407. <tr>
  5408. <th>Field</th>
  5409. <th>Description</th>
  5410. </tr>
  5411. </thead>
  5412. <tbody>
  5413. <tr>
  5414. <td>
  5415. <code>dopplerToken</code></br>
  5416. <em>
  5417. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  5418. External Secrets meta/v1.SecretKeySelector
  5419. </a>
  5420. </em>
  5421. </td>
  5422. <td>
  5423. <p>The DopplerToken is used for authentication.
  5424. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  5425. The Key attribute defaults to dopplerToken if not specified.</p>
  5426. </td>
  5427. </tr>
  5428. </tbody>
  5429. </table>
  5430. <h3 id="external-secrets.io/v1.DopplerOIDCAuth">DopplerOIDCAuth
  5431. </h3>
  5432. <p>
  5433. (<em>Appears on:</em>
  5434. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  5435. </p>
  5436. <p>
  5437. <p>DopplerOIDCAuth configures OIDC authentication with Doppler using Kubernetes ServiceAccount tokens.</p>
  5438. </p>
  5439. <table>
  5440. <thead>
  5441. <tr>
  5442. <th>Field</th>
  5443. <th>Description</th>
  5444. </tr>
  5445. </thead>
  5446. <tbody>
  5447. <tr>
  5448. <td>
  5449. <code>identity</code></br>
  5450. <em>
  5451. string
  5452. </em>
  5453. </td>
  5454. <td>
  5455. <p>Identity is the Doppler Service Account Identity ID configured for OIDC authentication.</p>
  5456. </td>
  5457. </tr>
  5458. <tr>
  5459. <td>
  5460. <code>serviceAccountRef</code></br>
  5461. <em>
  5462. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  5463. External Secrets meta/v1.ServiceAccountSelector
  5464. </a>
  5465. </em>
  5466. </td>
  5467. <td>
  5468. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  5469. </td>
  5470. </tr>
  5471. <tr>
  5472. <td>
  5473. <code>expirationSeconds</code></br>
  5474. <em>
  5475. int64
  5476. </em>
  5477. </td>
  5478. <td>
  5479. <em>(Optional)</em>
  5480. <p>ExpirationSeconds sets the ServiceAccount token validity duration.
  5481. Defaults to 10 minutes.</p>
  5482. </td>
  5483. </tr>
  5484. </tbody>
  5485. </table>
  5486. <h3 id="external-secrets.io/v1.DopplerProvider">DopplerProvider
  5487. </h3>
  5488. <p>
  5489. (<em>Appears on:</em>
  5490. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  5491. </p>
  5492. <p>
  5493. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  5494. Project and Config are required if not using a Service Token.</p>
  5495. </p>
  5496. <table>
  5497. <thead>
  5498. <tr>
  5499. <th>Field</th>
  5500. <th>Description</th>
  5501. </tr>
  5502. </thead>
  5503. <tbody>
  5504. <tr>
  5505. <td>
  5506. <code>auth</code></br>
  5507. <em>
  5508. <a href="#external-secrets.io/v1.DopplerAuth">
  5509. DopplerAuth
  5510. </a>
  5511. </em>
  5512. </td>
  5513. <td>
  5514. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  5515. </td>
  5516. </tr>
  5517. <tr>
  5518. <td>
  5519. <code>project</code></br>
  5520. <em>
  5521. string
  5522. </em>
  5523. </td>
  5524. <td>
  5525. <em>(Optional)</em>
  5526. <p>Doppler project (required if not using a Service Token)</p>
  5527. </td>
  5528. </tr>
  5529. <tr>
  5530. <td>
  5531. <code>config</code></br>
  5532. <em>
  5533. string
  5534. </em>
  5535. </td>
  5536. <td>
  5537. <em>(Optional)</em>
  5538. <p>Doppler config (required if not using a Service Token)</p>
  5539. </td>
  5540. </tr>
  5541. <tr>
  5542. <td>
  5543. <code>nameTransformer</code></br>
  5544. <em>
  5545. string
  5546. </em>
  5547. </td>
  5548. <td>
  5549. <em>(Optional)</em>
  5550. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  5551. </td>
  5552. </tr>
  5553. <tr>
  5554. <td>
  5555. <code>format</code></br>
  5556. <em>
  5557. string
  5558. </em>
  5559. </td>
  5560. <td>
  5561. <em>(Optional)</em>
  5562. <p>Format enables the downloading of secrets as a file (string)</p>
  5563. </td>
  5564. </tr>
  5565. </tbody>
  5566. </table>
  5567. <h3 id="external-secrets.io/v1.ExternalSecret">ExternalSecret
  5568. </h3>
  5569. <p>
  5570. <p>ExternalSecret is the Schema for the external-secrets API.
  5571. It defines how to fetch data from external APIs and make it available as Kubernetes Secrets.</p>
  5572. </p>
  5573. <table>
  5574. <thead>
  5575. <tr>
  5576. <th>Field</th>
  5577. <th>Description</th>
  5578. </tr>
  5579. </thead>
  5580. <tbody>
  5581. <tr>
  5582. <td>
  5583. <code>metadata</code></br>
  5584. <em>
  5585. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  5586. Kubernetes meta/v1.ObjectMeta
  5587. </a>
  5588. </em>
  5589. </td>
  5590. <td>
  5591. Refer to the Kubernetes API documentation for the fields of the
  5592. <code>metadata</code> field.
  5593. </td>
  5594. </tr>
  5595. <tr>
  5596. <td>
  5597. <code>spec</code></br>
  5598. <em>
  5599. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  5600. ExternalSecretSpec
  5601. </a>
  5602. </em>
  5603. </td>
  5604. <td>
  5605. <br/>
  5606. <br/>
  5607. <table>
  5608. <tr>
  5609. <td>
  5610. <code>secretStoreRef</code></br>
  5611. <em>
  5612. <a href="#external-secrets.io/v1.SecretStoreRef">
  5613. SecretStoreRef
  5614. </a>
  5615. </em>
  5616. </td>
  5617. <td>
  5618. <em>(Optional)</em>
  5619. </td>
  5620. </tr>
  5621. <tr>
  5622. <td>
  5623. <code>target</code></br>
  5624. <em>
  5625. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  5626. ExternalSecretTarget
  5627. </a>
  5628. </em>
  5629. </td>
  5630. <td>
  5631. <em>(Optional)</em>
  5632. </td>
  5633. </tr>
  5634. <tr>
  5635. <td>
  5636. <code>refreshPolicy</code></br>
  5637. <em>
  5638. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  5639. ExternalSecretRefreshPolicy
  5640. </a>
  5641. </em>
  5642. </td>
  5643. <td>
  5644. <em>(Optional)</em>
  5645. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  5646. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  5647. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  5648. No periodic updates occur if refreshInterval is 0.
  5649. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  5650. </td>
  5651. </tr>
  5652. <tr>
  5653. <td>
  5654. <code>refreshInterval</code></br>
  5655. <em>
  5656. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  5657. Kubernetes meta/v1.Duration
  5658. </a>
  5659. </em>
  5660. </td>
  5661. <td>
  5662. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  5663. specified as Golang Duration strings.
  5664. 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;
  5665. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  5666. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  5667. </td>
  5668. </tr>
  5669. <tr>
  5670. <td>
  5671. <code>syncWindows</code></br>
  5672. <em>
  5673. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">
  5674. ExternalSecretSyncWindows
  5675. </a>
  5676. </em>
  5677. </td>
  5678. <td>
  5679. <em>(Optional)</em>
  5680. <p>SyncWindows optionally restricts when periodic refreshes may occur.
  5681. Evaluated in UTC, only for Periodic refresh policy (or when refreshPolicy is unset).</p>
  5682. </td>
  5683. </tr>
  5684. <tr>
  5685. <td>
  5686. <code>data</code></br>
  5687. <em>
  5688. <a href="#external-secrets.io/v1.ExternalSecretData">
  5689. []ExternalSecretData
  5690. </a>
  5691. </em>
  5692. </td>
  5693. <td>
  5694. <em>(Optional)</em>
  5695. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  5696. </td>
  5697. </tr>
  5698. <tr>
  5699. <td>
  5700. <code>dataFrom</code></br>
  5701. <em>
  5702. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  5703. []ExternalSecretDataFromRemoteRef
  5704. </a>
  5705. </em>
  5706. </td>
  5707. <td>
  5708. <em>(Optional)</em>
  5709. <p>DataFrom is used to fetch all properties from a specific Provider data
  5710. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  5711. </td>
  5712. </tr>
  5713. </table>
  5714. </td>
  5715. </tr>
  5716. <tr>
  5717. <td>
  5718. <code>status</code></br>
  5719. <em>
  5720. <a href="#external-secrets.io/v1.ExternalSecretStatus">
  5721. ExternalSecretStatus
  5722. </a>
  5723. </em>
  5724. </td>
  5725. <td>
  5726. </td>
  5727. </tr>
  5728. </tbody>
  5729. </table>
  5730. <h3 id="external-secrets.io/v1.ExternalSecretConditionType">ExternalSecretConditionType
  5731. (<code>string</code> alias)</p></h3>
  5732. <p>
  5733. (<em>Appears on:</em>
  5734. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  5735. </p>
  5736. <p>
  5737. <p>ExternalSecretConditionType defines a value type for ExternalSecret conditions.</p>
  5738. </p>
  5739. <table>
  5740. <thead>
  5741. <tr>
  5742. <th>Value</th>
  5743. <th>Description</th>
  5744. </tr>
  5745. </thead>
  5746. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  5747. <td><p>ExternalSecretDeleted indicates that the external secret has been deleted.</p>
  5748. </td>
  5749. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  5750. <td><p>ExternalSecretReady indicates that the external secret is ready and synced.</p>
  5751. </td>
  5752. </tr></tbody>
  5753. </table>
  5754. <h3 id="external-secrets.io/v1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  5755. (<code>string</code> alias)</p></h3>
  5756. <p>
  5757. (<em>Appears on:</em>
  5758. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5759. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5760. </p>
  5761. <p>
  5762. <p>ExternalSecretConversionStrategy defines strategies for converting secret values.</p>
  5763. </p>
  5764. <table>
  5765. <thead>
  5766. <tr>
  5767. <th>Value</th>
  5768. <th>Description</th>
  5769. </tr>
  5770. </thead>
  5771. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  5772. <td><p>ExternalSecretConversionDefault specifies the default conversion strategy.</p>
  5773. </td>
  5774. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  5775. <td><p>ExternalSecretConversionUnicode specifies that values should be treated as Unicode.</p>
  5776. </td>
  5777. </tr></tbody>
  5778. </table>
  5779. <h3 id="external-secrets.io/v1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  5780. (<code>string</code> alias)</p></h3>
  5781. <p>
  5782. (<em>Appears on:</em>
  5783. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5784. </p>
  5785. <p>
  5786. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  5787. </p>
  5788. <table>
  5789. <thead>
  5790. <tr>
  5791. <th>Value</th>
  5792. <th>Description</th>
  5793. </tr>
  5794. </thead>
  5795. <tbody><tr><td><p>&#34;CreateOrMerge&#34;</p></td>
  5796. <td><p>CreatePolicyCreateOrMerge creates the Secret if it is missing and merges
  5797. data fields into it if it exists, without an ownerReference. A deleted
  5798. target is recreated while the ExternalSecret exists, and the Secret is
  5799. retained when the ExternalSecret is deleted.</p>
  5800. </td>
  5801. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  5802. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  5803. </td>
  5804. </tr><tr><td><p>&#34;None&#34;</p></td>
  5805. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  5806. </td>
  5807. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  5808. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  5809. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  5810. </td>
  5811. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  5812. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  5813. </td>
  5814. </tr></tbody>
  5815. </table>
  5816. <h3 id="external-secrets.io/v1.ExternalSecretData">ExternalSecretData
  5817. </h3>
  5818. <p>
  5819. (<em>Appears on:</em>
  5820. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5821. </p>
  5822. <p>
  5823. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  5824. </p>
  5825. <table>
  5826. <thead>
  5827. <tr>
  5828. <th>Field</th>
  5829. <th>Description</th>
  5830. </tr>
  5831. </thead>
  5832. <tbody>
  5833. <tr>
  5834. <td>
  5835. <code>secretKey</code></br>
  5836. <em>
  5837. string
  5838. </em>
  5839. </td>
  5840. <td>
  5841. <p>The key in the Kubernetes Secret to store the value.</p>
  5842. </td>
  5843. </tr>
  5844. <tr>
  5845. <td>
  5846. <code>remoteRef</code></br>
  5847. <em>
  5848. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5849. ExternalSecretDataRemoteRef
  5850. </a>
  5851. </em>
  5852. </td>
  5853. <td>
  5854. <p>RemoteRef points to the remote secret and defines
  5855. which secret (version/property/..) to fetch.</p>
  5856. </td>
  5857. </tr>
  5858. <tr>
  5859. <td>
  5860. <code>sourceRef</code></br>
  5861. <em>
  5862. <a href="#external-secrets.io/v1.StoreSourceRef">
  5863. StoreSourceRef
  5864. </a>
  5865. </em>
  5866. </td>
  5867. <td>
  5868. <p>SourceRef allows you to override the source
  5869. from which the value will be pulled.</p>
  5870. </td>
  5871. </tr>
  5872. </tbody>
  5873. </table>
  5874. <h3 id="external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  5875. </h3>
  5876. <p>
  5877. (<em>Appears on:</em>
  5878. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5879. </p>
  5880. <p>
  5881. <p>ExternalSecretDataFromRemoteRef defines the connection between the Kubernetes Secret keys and the Provider data
  5882. when using DataFrom to fetch multiple values from a Provider.</p>
  5883. </p>
  5884. <table>
  5885. <thead>
  5886. <tr>
  5887. <th>Field</th>
  5888. <th>Description</th>
  5889. </tr>
  5890. </thead>
  5891. <tbody>
  5892. <tr>
  5893. <td>
  5894. <code>extract</code></br>
  5895. <em>
  5896. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5897. ExternalSecretDataRemoteRef
  5898. </a>
  5899. </em>
  5900. </td>
  5901. <td>
  5902. <em>(Optional)</em>
  5903. <p>Used to extract multiple key/value pairs from one secret
  5904. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5905. </td>
  5906. </tr>
  5907. <tr>
  5908. <td>
  5909. <code>find</code></br>
  5910. <em>
  5911. <a href="#external-secrets.io/v1.ExternalSecretFind">
  5912. ExternalSecretFind
  5913. </a>
  5914. </em>
  5915. </td>
  5916. <td>
  5917. <em>(Optional)</em>
  5918. <p>Used to find secrets based on tags or regular expressions
  5919. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5920. </td>
  5921. </tr>
  5922. <tr>
  5923. <td>
  5924. <code>rewrite</code></br>
  5925. <em>
  5926. <a href="#external-secrets.io/v1.ExternalSecretRewrite">
  5927. []ExternalSecretRewrite
  5928. </a>
  5929. </em>
  5930. </td>
  5931. <td>
  5932. <em>(Optional)</em>
  5933. <p>Used to rewrite secret Keys after getting them from the secret Provider
  5934. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  5935. </td>
  5936. </tr>
  5937. <tr>
  5938. <td>
  5939. <code>sourceRef</code></br>
  5940. <em>
  5941. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">
  5942. StoreGeneratorSourceRef
  5943. </a>
  5944. </em>
  5945. </td>
  5946. <td>
  5947. <p>SourceRef points to a store or generator
  5948. which contains secret values ready to use.
  5949. Use this in combination with Extract or Find pull values out of
  5950. a specific SecretStore.
  5951. When sourceRef points to a generator Extract or Find is not supported.
  5952. The generator returns a static map of values</p>
  5953. </td>
  5954. </tr>
  5955. </tbody>
  5956. </table>
  5957. <h3 id="external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  5958. </h3>
  5959. <p>
  5960. (<em>Appears on:</em>
  5961. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>,
  5962. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5963. </p>
  5964. <p>
  5965. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  5966. </p>
  5967. <table>
  5968. <thead>
  5969. <tr>
  5970. <th>Field</th>
  5971. <th>Description</th>
  5972. </tr>
  5973. </thead>
  5974. <tbody>
  5975. <tr>
  5976. <td>
  5977. <code>key</code></br>
  5978. <em>
  5979. string
  5980. </em>
  5981. </td>
  5982. <td>
  5983. <p>Key is the key used in the Provider, mandatory</p>
  5984. </td>
  5985. </tr>
  5986. <tr>
  5987. <td>
  5988. <code>metadataPolicy</code></br>
  5989. <em>
  5990. <a href="#external-secrets.io/v1.ExternalSecretMetadataPolicy">
  5991. ExternalSecretMetadataPolicy
  5992. </a>
  5993. </em>
  5994. </td>
  5995. <td>
  5996. <em>(Optional)</em>
  5997. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  5998. </td>
  5999. </tr>
  6000. <tr>
  6001. <td>
  6002. <code>property</code></br>
  6003. <em>
  6004. string
  6005. </em>
  6006. </td>
  6007. <td>
  6008. <em>(Optional)</em>
  6009. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  6010. </td>
  6011. </tr>
  6012. <tr>
  6013. <td>
  6014. <code>version</code></br>
  6015. <em>
  6016. string
  6017. </em>
  6018. </td>
  6019. <td>
  6020. <em>(Optional)</em>
  6021. <p>Used to select a specific version of the Provider value, if supported</p>
  6022. </td>
  6023. </tr>
  6024. <tr>
  6025. <td>
  6026. <code>conversionStrategy</code></br>
  6027. <em>
  6028. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  6029. ExternalSecretConversionStrategy
  6030. </a>
  6031. </em>
  6032. </td>
  6033. <td>
  6034. <em>(Optional)</em>
  6035. <p>Used to define a conversion Strategy. Defaults to Default when omitted.</p>
  6036. </td>
  6037. </tr>
  6038. <tr>
  6039. <td>
  6040. <code>decodingStrategy</code></br>
  6041. <em>
  6042. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  6043. ExternalSecretDecodingStrategy
  6044. </a>
  6045. </em>
  6046. </td>
  6047. <td>
  6048. <em>(Optional)</em>
  6049. <p>Used to define a decoding Strategy. Defaults to None when omitted.</p>
  6050. </td>
  6051. </tr>
  6052. <tr>
  6053. <td>
  6054. <code>nullBytePolicy</code></br>
  6055. <em>
  6056. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  6057. ExternalSecretNullBytePolicy
  6058. </a>
  6059. </em>
  6060. </td>
  6061. <td>
  6062. <em>(Optional)</em>
  6063. <p>Controls how ESO handles fetched secret data containing NUL bytes for this source.</p>
  6064. </td>
  6065. </tr>
  6066. </tbody>
  6067. </table>
  6068. <h3 id="external-secrets.io/v1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  6069. (<code>string</code> alias)</p></h3>
  6070. <p>
  6071. (<em>Appears on:</em>
  6072. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  6073. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>,
  6074. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  6075. </p>
  6076. <p>
  6077. <p>ExternalSecretDecodingStrategy defines strategies for decoding secret values.</p>
  6078. </p>
  6079. <table>
  6080. <thead>
  6081. <tr>
  6082. <th>Value</th>
  6083. <th>Description</th>
  6084. </tr>
  6085. </thead>
  6086. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  6087. <td><p>ExternalSecretDecodeAuto specifies automatic detection of the decoding method.</p>
  6088. </td>
  6089. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  6090. <td><p>ExternalSecretDecodeBase64 specifies that values should be decoded using Base64.</p>
  6091. </td>
  6092. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  6093. <td><p>ExternalSecretDecodeBase64URL specifies that values should be decoded using Base64URL.</p>
  6094. </td>
  6095. </tr><tr><td><p>&#34;None&#34;</p></td>
  6096. <td><p>ExternalSecretDecodeNone specifies that no decoding should be performed.</p>
  6097. </td>
  6098. </tr></tbody>
  6099. </table>
  6100. <h3 id="external-secrets.io/v1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  6101. (<code>string</code> alias)</p></h3>
  6102. <p>
  6103. (<em>Appears on:</em>
  6104. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  6105. </p>
  6106. <p>
  6107. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  6108. </p>
  6109. <table>
  6110. <thead>
  6111. <tr>
  6112. <th>Value</th>
  6113. <th>Description</th>
  6114. </tr>
  6115. </thead>
  6116. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  6117. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  6118. If a secret gets deleted on the provider side and is not accessible
  6119. anymore this is not considered an error and the ExternalSecret
  6120. does not go into SecretSyncedError status.</p>
  6121. </td>
  6122. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  6123. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  6124. If a secret gets deleted on the provider side and is not accessible
  6125. anymore this is not considered an error and the ExternalSecret
  6126. does not go into SecretSyncedError status.</p>
  6127. </td>
  6128. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  6129. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  6130. If a provider secret does not exist the ExternalSecret gets into the
  6131. SecretSyncedError status.</p>
  6132. </td>
  6133. </tr></tbody>
  6134. </table>
  6135. <h3 id="external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind
  6136. </h3>
  6137. <p>
  6138. (<em>Appears on:</em>
  6139. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  6140. </p>
  6141. <p>
  6142. <p>ExternalSecretFind defines configuration for finding secrets in the provider.</p>
  6143. </p>
  6144. <table>
  6145. <thead>
  6146. <tr>
  6147. <th>Field</th>
  6148. <th>Description</th>
  6149. </tr>
  6150. </thead>
  6151. <tbody>
  6152. <tr>
  6153. <td>
  6154. <code>path</code></br>
  6155. <em>
  6156. string
  6157. </em>
  6158. </td>
  6159. <td>
  6160. <em>(Optional)</em>
  6161. <p>A root path to start the find operations.</p>
  6162. </td>
  6163. </tr>
  6164. <tr>
  6165. <td>
  6166. <code>name</code></br>
  6167. <em>
  6168. <a href="#external-secrets.io/v1.FindName">
  6169. FindName
  6170. </a>
  6171. </em>
  6172. </td>
  6173. <td>
  6174. <em>(Optional)</em>
  6175. <p>Finds secrets based on the name.</p>
  6176. </td>
  6177. </tr>
  6178. <tr>
  6179. <td>
  6180. <code>tags</code></br>
  6181. <em>
  6182. map[string]string
  6183. </em>
  6184. </td>
  6185. <td>
  6186. <em>(Optional)</em>
  6187. <p>Find secrets based on tags.</p>
  6188. </td>
  6189. </tr>
  6190. <tr>
  6191. <td>
  6192. <code>conversionStrategy</code></br>
  6193. <em>
  6194. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  6195. ExternalSecretConversionStrategy
  6196. </a>
  6197. </em>
  6198. </td>
  6199. <td>
  6200. <em>(Optional)</em>
  6201. <p>Used to define a conversion Strategy. Defaults to Default when omitted.</p>
  6202. </td>
  6203. </tr>
  6204. <tr>
  6205. <td>
  6206. <code>decodingStrategy</code></br>
  6207. <em>
  6208. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  6209. ExternalSecretDecodingStrategy
  6210. </a>
  6211. </em>
  6212. </td>
  6213. <td>
  6214. <em>(Optional)</em>
  6215. <p>Used to define a decoding Strategy. Defaults to None when omitted.</p>
  6216. </td>
  6217. </tr>
  6218. <tr>
  6219. <td>
  6220. <code>nullBytePolicy</code></br>
  6221. <em>
  6222. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  6223. ExternalSecretNullBytePolicy
  6224. </a>
  6225. </em>
  6226. </td>
  6227. <td>
  6228. <em>(Optional)</em>
  6229. <p>Controls how ESO handles fetched secret data containing NUL bytes for this find source.</p>
  6230. </td>
  6231. </tr>
  6232. </tbody>
  6233. </table>
  6234. <h3 id="external-secrets.io/v1.ExternalSecretMetadata">ExternalSecretMetadata
  6235. </h3>
  6236. <p>
  6237. (<em>Appears on:</em>
  6238. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  6239. </p>
  6240. <p>
  6241. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  6242. </p>
  6243. <table>
  6244. <thead>
  6245. <tr>
  6246. <th>Field</th>
  6247. <th>Description</th>
  6248. </tr>
  6249. </thead>
  6250. <tbody>
  6251. <tr>
  6252. <td>
  6253. <code>annotations</code></br>
  6254. <em>
  6255. map[string]string
  6256. </em>
  6257. </td>
  6258. <td>
  6259. <em>(Optional)</em>
  6260. </td>
  6261. </tr>
  6262. <tr>
  6263. <td>
  6264. <code>labels</code></br>
  6265. <em>
  6266. map[string]string
  6267. </em>
  6268. </td>
  6269. <td>
  6270. <em>(Optional)</em>
  6271. </td>
  6272. </tr>
  6273. </tbody>
  6274. </table>
  6275. <h3 id="external-secrets.io/v1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  6276. (<code>string</code> alias)</p></h3>
  6277. <p>
  6278. (<em>Appears on:</em>
  6279. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  6280. </p>
  6281. <p>
  6282. <p>ExternalSecretMetadataPolicy defines policies for fetching metadata from provider secrets.</p>
  6283. </p>
  6284. <table>
  6285. <thead>
  6286. <tr>
  6287. <th>Value</th>
  6288. <th>Description</th>
  6289. </tr>
  6290. </thead>
  6291. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  6292. <td><p>ExternalSecretMetadataPolicyFetch specifies that metadata should be fetched from the provider.</p>
  6293. </td>
  6294. </tr><tr><td><p>&#34;None&#34;</p></td>
  6295. <td><p>ExternalSecretMetadataPolicyNone specifies that no metadata should be fetched from the provider.</p>
  6296. </td>
  6297. </tr></tbody>
  6298. </table>
  6299. <h3 id="external-secrets.io/v1.ExternalSecretNullBytePolicy">ExternalSecretNullBytePolicy
  6300. (<code>string</code> alias)</p></h3>
  6301. <p>
  6302. (<em>Appears on:</em>
  6303. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  6304. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  6305. </p>
  6306. <p>
  6307. <p>ExternalSecretNullBytePolicy defines how fetched secret data containing NUL bytes should be handled.</p>
  6308. </p>
  6309. <table>
  6310. <thead>
  6311. <tr>
  6312. <th>Value</th>
  6313. <th>Description</th>
  6314. </tr>
  6315. </thead>
  6316. <tbody><tr><td><p>&#34;Fail&#34;</p></td>
  6317. <td><p>ExternalSecretNullBytePolicyFail fails reconciliation if fetched secret data contains NUL bytes.</p>
  6318. </td>
  6319. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  6320. <td><p>ExternalSecretNullBytePolicyIgnore allows fetched secret data to contain NUL bytes.</p>
  6321. </td>
  6322. </tr></tbody>
  6323. </table>
  6324. <h3 id="external-secrets.io/v1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  6325. (<code>string</code> alias)</p></h3>
  6326. <p>
  6327. (<em>Appears on:</em>
  6328. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6329. </p>
  6330. <p>
  6331. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  6332. </p>
  6333. <table>
  6334. <thead>
  6335. <tr>
  6336. <th>Value</th>
  6337. <th>Description</th>
  6338. </tr>
  6339. </thead>
  6340. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  6341. <td><p>RefreshPolicyCreatedOnce creates the Secret once and does not update it thereafter.</p>
  6342. </td>
  6343. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  6344. <td><p>RefreshPolicyOnChange only synchronizes when the ExternalSecret&rsquo;s metadata or spec changes.</p>
  6345. </td>
  6346. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  6347. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the provider at regular intervals.</p>
  6348. </td>
  6349. </tr></tbody>
  6350. </table>
  6351. <h3 id="external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite
  6352. </h3>
  6353. <p>
  6354. (<em>Appears on:</em>
  6355. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  6356. </p>
  6357. <p>
  6358. <p>ExternalSecretRewrite defines how to rewrite secret data values before they are written to the Secret.</p>
  6359. </p>
  6360. <table>
  6361. <thead>
  6362. <tr>
  6363. <th>Field</th>
  6364. <th>Description</th>
  6365. </tr>
  6366. </thead>
  6367. <tbody>
  6368. <tr>
  6369. <td>
  6370. <code>merge</code></br>
  6371. <em>
  6372. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">
  6373. ExternalSecretRewriteMerge
  6374. </a>
  6375. </em>
  6376. </td>
  6377. <td>
  6378. <em>(Optional)</em>
  6379. <p>Used to merge key/values in one single Secret
  6380. The resulting key will contain all values from the specified secrets</p>
  6381. </td>
  6382. </tr>
  6383. <tr>
  6384. <td>
  6385. <code>regexp</code></br>
  6386. <em>
  6387. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  6388. ExternalSecretRewriteRegexp
  6389. </a>
  6390. </em>
  6391. </td>
  6392. <td>
  6393. <em>(Optional)</em>
  6394. <p>Used to rewrite with regular expressions.
  6395. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  6396. </td>
  6397. </tr>
  6398. <tr>
  6399. <td>
  6400. <code>transform</code></br>
  6401. <em>
  6402. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  6403. ExternalSecretRewriteTransform
  6404. </a>
  6405. </em>
  6406. </td>
  6407. <td>
  6408. <em>(Optional)</em>
  6409. <p>Used to apply string transformation on the secrets.
  6410. The resulting key will be the output of the template applied by the operation.</p>
  6411. </td>
  6412. </tr>
  6413. </tbody>
  6414. </table>
  6415. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge
  6416. </h3>
  6417. <p>
  6418. (<em>Appears on:</em>
  6419. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  6420. </p>
  6421. <p>
  6422. <p>ExternalSecretRewriteMerge defines configuration for merging secret values.</p>
  6423. </p>
  6424. <table>
  6425. <thead>
  6426. <tr>
  6427. <th>Field</th>
  6428. <th>Description</th>
  6429. </tr>
  6430. </thead>
  6431. <tbody>
  6432. <tr>
  6433. <td>
  6434. <code>into</code></br>
  6435. <em>
  6436. string
  6437. </em>
  6438. </td>
  6439. <td>
  6440. <em>(Optional)</em>
  6441. <p>Used to define the target key of the merge operation.
  6442. Required if strategy is JSON. Ignored otherwise.</p>
  6443. </td>
  6444. </tr>
  6445. <tr>
  6446. <td>
  6447. <code>priority</code></br>
  6448. <em>
  6449. []string
  6450. </em>
  6451. </td>
  6452. <td>
  6453. <em>(Optional)</em>
  6454. <p>Used to define key priority in conflict resolution.</p>
  6455. </td>
  6456. </tr>
  6457. <tr>
  6458. <td>
  6459. <code>priorityPolicy</code></br>
  6460. <em>
  6461. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">
  6462. ExternalSecretRewriteMergePriorityPolicy
  6463. </a>
  6464. </em>
  6465. </td>
  6466. <td>
  6467. <em>(Optional)</em>
  6468. <p>Used to define the policy when a key in the priority list does not exist in the input.</p>
  6469. </td>
  6470. </tr>
  6471. <tr>
  6472. <td>
  6473. <code>conflictPolicy</code></br>
  6474. <em>
  6475. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">
  6476. ExternalSecretRewriteMergeConflictPolicy
  6477. </a>
  6478. </em>
  6479. </td>
  6480. <td>
  6481. <em>(Optional)</em>
  6482. <p>Used to define the policy to use in conflict resolution.</p>
  6483. </td>
  6484. </tr>
  6485. <tr>
  6486. <td>
  6487. <code>strategy</code></br>
  6488. <em>
  6489. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">
  6490. ExternalSecretRewriteMergeStrategy
  6491. </a>
  6492. </em>
  6493. </td>
  6494. <td>
  6495. <em>(Optional)</em>
  6496. <p>Used to define the strategy to use in the merge operation.</p>
  6497. </td>
  6498. </tr>
  6499. </tbody>
  6500. </table>
  6501. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">ExternalSecretRewriteMergeConflictPolicy
  6502. (<code>string</code> alias)</p></h3>
  6503. <p>
  6504. (<em>Appears on:</em>
  6505. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6506. </p>
  6507. <p>
  6508. <p>ExternalSecretRewriteMergeConflictPolicy defines the policy for resolving conflicts when merging secrets.</p>
  6509. </p>
  6510. <table>
  6511. <thead>
  6512. <tr>
  6513. <th>Value</th>
  6514. <th>Description</th>
  6515. </tr>
  6516. </thead>
  6517. <tbody><tr><td><p>&#34;Error&#34;</p></td>
  6518. <td><p>ExternalSecretRewriteMergeConflictPolicyError returns an error when conflicts occur during merge.</p>
  6519. </td>
  6520. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  6521. <td><p>ExternalSecretRewriteMergeConflictPolicyIgnore ignores conflicts when merging secret values.</p>
  6522. </td>
  6523. </tr></tbody>
  6524. </table>
  6525. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">ExternalSecretRewriteMergePriorityPolicy
  6526. (<code>string</code> alias)</p></h3>
  6527. <p>
  6528. (<em>Appears on:</em>
  6529. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6530. </p>
  6531. <p>
  6532. <p>ExternalSecretRewriteMergePriorityPolicy defines the policy for handling missing keys in the priority
  6533. list during merge operations.</p>
  6534. </p>
  6535. <table>
  6536. <thead>
  6537. <tr>
  6538. <th>Value</th>
  6539. <th>Description</th>
  6540. </tr>
  6541. </thead>
  6542. <tbody><tr><td><p>&#34;IgnoreNotFound&#34;</p></td>
  6543. <td></td>
  6544. </tr><tr><td><p>&#34;Strict&#34;</p></td>
  6545. <td></td>
  6546. </tr></tbody>
  6547. </table>
  6548. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">ExternalSecretRewriteMergeStrategy
  6549. (<code>string</code> alias)</p></h3>
  6550. <p>
  6551. (<em>Appears on:</em>
  6552. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6553. </p>
  6554. <p>
  6555. <p>ExternalSecretRewriteMergeStrategy defines the strategy for merging secrets.</p>
  6556. </p>
  6557. <table>
  6558. <thead>
  6559. <tr>
  6560. <th>Value</th>
  6561. <th>Description</th>
  6562. </tr>
  6563. </thead>
  6564. <tbody><tr><td><p>&#34;Extract&#34;</p></td>
  6565. <td><p>ExternalSecretRewriteMergeStrategyExtract merges secrets by extracting values.</p>
  6566. </td>
  6567. </tr><tr><td><p>&#34;JSON&#34;</p></td>
  6568. <td><p>ExternalSecretRewriteMergeStrategyJSON merges secrets using JSON merge strategy.</p>
  6569. </td>
  6570. </tr></tbody>
  6571. </table>
  6572. <h3 id="external-secrets.io/v1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  6573. </h3>
  6574. <p>
  6575. (<em>Appears on:</em>
  6576. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  6577. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  6578. </p>
  6579. <p>
  6580. <p>ExternalSecretRewriteRegexp defines configuration for rewriting secrets using regular expressions.</p>
  6581. </p>
  6582. <table>
  6583. <thead>
  6584. <tr>
  6585. <th>Field</th>
  6586. <th>Description</th>
  6587. </tr>
  6588. </thead>
  6589. <tbody>
  6590. <tr>
  6591. <td>
  6592. <code>source</code></br>
  6593. <em>
  6594. string
  6595. </em>
  6596. </td>
  6597. <td>
  6598. <p>Used to define the regular expression of a re.Compiler.</p>
  6599. </td>
  6600. </tr>
  6601. <tr>
  6602. <td>
  6603. <code>target</code></br>
  6604. <em>
  6605. string
  6606. </em>
  6607. </td>
  6608. <td>
  6609. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  6610. </td>
  6611. </tr>
  6612. </tbody>
  6613. </table>
  6614. <h3 id="external-secrets.io/v1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  6615. </h3>
  6616. <p>
  6617. (<em>Appears on:</em>
  6618. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  6619. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  6620. </p>
  6621. <p>
  6622. <p>ExternalSecretRewriteTransform defines configuration for transforming secrets using templates.</p>
  6623. </p>
  6624. <table>
  6625. <thead>
  6626. <tr>
  6627. <th>Field</th>
  6628. <th>Description</th>
  6629. </tr>
  6630. </thead>
  6631. <tbody>
  6632. <tr>
  6633. <td>
  6634. <code>template</code></br>
  6635. <em>
  6636. string
  6637. </em>
  6638. </td>
  6639. <td>
  6640. <p>Used to define the template to apply on the secret name.
  6641. <code>.value</code> will specify the secret name in the template.</p>
  6642. </td>
  6643. </tr>
  6644. </tbody>
  6645. </table>
  6646. <h3 id="external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec
  6647. </h3>
  6648. <p>
  6649. (<em>Appears on:</em>
  6650. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  6651. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6652. </p>
  6653. <p>
  6654. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  6655. </p>
  6656. <table>
  6657. <thead>
  6658. <tr>
  6659. <th>Field</th>
  6660. <th>Description</th>
  6661. </tr>
  6662. </thead>
  6663. <tbody>
  6664. <tr>
  6665. <td>
  6666. <code>secretStoreRef</code></br>
  6667. <em>
  6668. <a href="#external-secrets.io/v1.SecretStoreRef">
  6669. SecretStoreRef
  6670. </a>
  6671. </em>
  6672. </td>
  6673. <td>
  6674. <em>(Optional)</em>
  6675. </td>
  6676. </tr>
  6677. <tr>
  6678. <td>
  6679. <code>target</code></br>
  6680. <em>
  6681. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  6682. ExternalSecretTarget
  6683. </a>
  6684. </em>
  6685. </td>
  6686. <td>
  6687. <em>(Optional)</em>
  6688. </td>
  6689. </tr>
  6690. <tr>
  6691. <td>
  6692. <code>refreshPolicy</code></br>
  6693. <em>
  6694. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  6695. ExternalSecretRefreshPolicy
  6696. </a>
  6697. </em>
  6698. </td>
  6699. <td>
  6700. <em>(Optional)</em>
  6701. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  6702. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  6703. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  6704. No periodic updates occur if refreshInterval is 0.
  6705. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  6706. </td>
  6707. </tr>
  6708. <tr>
  6709. <td>
  6710. <code>refreshInterval</code></br>
  6711. <em>
  6712. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6713. Kubernetes meta/v1.Duration
  6714. </a>
  6715. </em>
  6716. </td>
  6717. <td>
  6718. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  6719. specified as Golang Duration strings.
  6720. 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;
  6721. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  6722. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  6723. </td>
  6724. </tr>
  6725. <tr>
  6726. <td>
  6727. <code>syncWindows</code></br>
  6728. <em>
  6729. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">
  6730. ExternalSecretSyncWindows
  6731. </a>
  6732. </em>
  6733. </td>
  6734. <td>
  6735. <em>(Optional)</em>
  6736. <p>SyncWindows optionally restricts when periodic refreshes may occur.
  6737. Evaluated in UTC, only for Periodic refresh policy (or when refreshPolicy is unset).</p>
  6738. </td>
  6739. </tr>
  6740. <tr>
  6741. <td>
  6742. <code>data</code></br>
  6743. <em>
  6744. <a href="#external-secrets.io/v1.ExternalSecretData">
  6745. []ExternalSecretData
  6746. </a>
  6747. </em>
  6748. </td>
  6749. <td>
  6750. <em>(Optional)</em>
  6751. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  6752. </td>
  6753. </tr>
  6754. <tr>
  6755. <td>
  6756. <code>dataFrom</code></br>
  6757. <em>
  6758. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  6759. []ExternalSecretDataFromRemoteRef
  6760. </a>
  6761. </em>
  6762. </td>
  6763. <td>
  6764. <em>(Optional)</em>
  6765. <p>DataFrom is used to fetch all properties from a specific Provider data
  6766. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  6767. </td>
  6768. </tr>
  6769. </tbody>
  6770. </table>
  6771. <h3 id="external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus
  6772. </h3>
  6773. <p>
  6774. (<em>Appears on:</em>
  6775. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6776. </p>
  6777. <p>
  6778. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  6779. </p>
  6780. <table>
  6781. <thead>
  6782. <tr>
  6783. <th>Field</th>
  6784. <th>Description</th>
  6785. </tr>
  6786. </thead>
  6787. <tbody>
  6788. <tr>
  6789. <td>
  6790. <code>refreshTime</code></br>
  6791. <em>
  6792. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6793. Kubernetes meta/v1.Time
  6794. </a>
  6795. </em>
  6796. </td>
  6797. <td>
  6798. <p>refreshTime is the time and date the external secret was fetched and
  6799. the target secret updated</p>
  6800. </td>
  6801. </tr>
  6802. <tr>
  6803. <td>
  6804. <code>syncedResourceVersion</code></br>
  6805. <em>
  6806. string
  6807. </em>
  6808. </td>
  6809. <td>
  6810. <p>SyncedResourceVersion keeps track of the last synced version</p>
  6811. </td>
  6812. </tr>
  6813. <tr>
  6814. <td>
  6815. <code>conditions</code></br>
  6816. <em>
  6817. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">
  6818. []ExternalSecretStatusCondition
  6819. </a>
  6820. </em>
  6821. </td>
  6822. <td>
  6823. <em>(Optional)</em>
  6824. </td>
  6825. </tr>
  6826. <tr>
  6827. <td>
  6828. <code>binding</code></br>
  6829. <em>
  6830. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  6831. Kubernetes core/v1.LocalObjectReference
  6832. </a>
  6833. </em>
  6834. </td>
  6835. <td>
  6836. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  6837. </td>
  6838. </tr>
  6839. </tbody>
  6840. </table>
  6841. <h3 id="external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  6842. </h3>
  6843. <p>
  6844. (<em>Appears on:</em>
  6845. <a href="#external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus</a>)
  6846. </p>
  6847. <p>
  6848. <p>ExternalSecretStatusCondition defines a status condition of an ExternalSecret resource.</p>
  6849. </p>
  6850. <table>
  6851. <thead>
  6852. <tr>
  6853. <th>Field</th>
  6854. <th>Description</th>
  6855. </tr>
  6856. </thead>
  6857. <tbody>
  6858. <tr>
  6859. <td>
  6860. <code>type</code></br>
  6861. <em>
  6862. <a href="#external-secrets.io/v1.ExternalSecretConditionType">
  6863. ExternalSecretConditionType
  6864. </a>
  6865. </em>
  6866. </td>
  6867. <td>
  6868. </td>
  6869. </tr>
  6870. <tr>
  6871. <td>
  6872. <code>status</code></br>
  6873. <em>
  6874. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  6875. Kubernetes core/v1.ConditionStatus
  6876. </a>
  6877. </em>
  6878. </td>
  6879. <td>
  6880. </td>
  6881. </tr>
  6882. <tr>
  6883. <td>
  6884. <code>reason</code></br>
  6885. <em>
  6886. string
  6887. </em>
  6888. </td>
  6889. <td>
  6890. <em>(Optional)</em>
  6891. </td>
  6892. </tr>
  6893. <tr>
  6894. <td>
  6895. <code>message</code></br>
  6896. <em>
  6897. string
  6898. </em>
  6899. </td>
  6900. <td>
  6901. <em>(Optional)</em>
  6902. </td>
  6903. </tr>
  6904. <tr>
  6905. <td>
  6906. <code>lastTransitionTime</code></br>
  6907. <em>
  6908. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6909. Kubernetes meta/v1.Time
  6910. </a>
  6911. </em>
  6912. </td>
  6913. <td>
  6914. <em>(Optional)</em>
  6915. </td>
  6916. </tr>
  6917. </tbody>
  6918. </table>
  6919. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindowEntry">ExternalSecretSyncWindowEntry
  6920. </h3>
  6921. <p>
  6922. (<em>Appears on:</em>
  6923. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows</a>)
  6924. </p>
  6925. <p>
  6926. <p>ExternalSecretSyncWindowEntry defines a single cron-schedule + duration pair
  6927. within a SyncWindows block.</p>
  6928. </p>
  6929. <table>
  6930. <thead>
  6931. <tr>
  6932. <th>Field</th>
  6933. <th>Description</th>
  6934. </tr>
  6935. </thead>
  6936. <tbody>
  6937. <tr>
  6938. <td>
  6939. <code>schedule</code></br>
  6940. <em>
  6941. string
  6942. </em>
  6943. </td>
  6944. <td>
  6945. <p>Schedule is a standard 5-field cron expression evaluated in UTC, or a
  6946. named shorthand such as @daily or @every 1h. It marks the start time of
  6947. each window occurrence.
  6948. Example: &ldquo;0 22 * * 1-5&rdquo; opens a window every weekday at 22:00 UTC.</p>
  6949. </td>
  6950. </tr>
  6951. <tr>
  6952. <td>
  6953. <code>duration</code></br>
  6954. <em>
  6955. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6956. Kubernetes meta/v1.Duration
  6957. </a>
  6958. </em>
  6959. </td>
  6960. <td>
  6961. <p>Duration specifies how long the window stays open after each Schedule
  6962. firing. Example: &ldquo;8h&rdquo;.</p>
  6963. </td>
  6964. </tr>
  6965. </tbody>
  6966. </table>
  6967. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindowKind">ExternalSecretSyncWindowKind
  6968. (<code>string</code> alias)</p></h3>
  6969. <p>
  6970. (<em>Appears on:</em>
  6971. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows</a>)
  6972. </p>
  6973. <p>
  6974. <p>ExternalSecretSyncWindowKind defines whether a SyncWindow permits or
  6975. blocks periodic refreshes.</p>
  6976. </p>
  6977. <table>
  6978. <thead>
  6979. <tr>
  6980. <th>Value</th>
  6981. <th>Description</th>
  6982. </tr>
  6983. </thead>
  6984. <tbody><tr><td><p>&#34;allow&#34;</p></td>
  6985. <td><p>SyncWindowAllow allows periodic refreshes only while at least one window
  6986. in the list is active. Refreshes are blocked at all other times.</p>
  6987. </td>
  6988. </tr><tr><td><p>&#34;deny&#34;</p></td>
  6989. <td><p>SyncWindowDeny blocks periodic refreshes while any window in the list is
  6990. active. Refreshes proceed normally at all other times.</p>
  6991. </td>
  6992. </tr></tbody>
  6993. </table>
  6994. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows
  6995. </h3>
  6996. <p>
  6997. (<em>Appears on:</em>
  6998. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6999. </p>
  7000. <p>
  7001. <p>ExternalSecretSyncWindows optionally restricts when periodic syncs may occur.
  7002. All windows in the list share the same Kind.</p>
  7003. </p>
  7004. <table>
  7005. <thead>
  7006. <tr>
  7007. <th>Field</th>
  7008. <th>Description</th>
  7009. </tr>
  7010. </thead>
  7011. <tbody>
  7012. <tr>
  7013. <td>
  7014. <code>kind</code></br>
  7015. <em>
  7016. <a href="#external-secrets.io/v1.ExternalSecretSyncWindowKind">
  7017. ExternalSecretSyncWindowKind
  7018. </a>
  7019. </em>
  7020. </td>
  7021. <td>
  7022. <p>Kind applies to every window in the list.
  7023. &ldquo;allow&rdquo; &ndash; syncs are permitted only while at least one window is active;
  7024. all other times are blocked.
  7025. &ldquo;deny&rdquo; &ndash; syncs are blocked while any window is active;
  7026. all other times are permitted.</p>
  7027. </td>
  7028. </tr>
  7029. <tr>
  7030. <td>
  7031. <code>windows</code></br>
  7032. <em>
  7033. <a href="#external-secrets.io/v1.ExternalSecretSyncWindowEntry">
  7034. []ExternalSecretSyncWindowEntry
  7035. </a>
  7036. </em>
  7037. </td>
  7038. <td>
  7039. <p>Windows is the list of schedule+duration pairs.</p>
  7040. </td>
  7041. </tr>
  7042. </tbody>
  7043. </table>
  7044. <h3 id="external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget
  7045. </h3>
  7046. <p>
  7047. (<em>Appears on:</em>
  7048. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  7049. </p>
  7050. <p>
  7051. <p>ExternalSecretTarget defines the Kubernetes Secret to be created,
  7052. there can be only one target per ExternalSecret.</p>
  7053. </p>
  7054. <table>
  7055. <thead>
  7056. <tr>
  7057. <th>Field</th>
  7058. <th>Description</th>
  7059. </tr>
  7060. </thead>
  7061. <tbody>
  7062. <tr>
  7063. <td>
  7064. <code>name</code></br>
  7065. <em>
  7066. string
  7067. </em>
  7068. </td>
  7069. <td>
  7070. <em>(Optional)</em>
  7071. <p>The name of the Secret resource to be managed.
  7072. Defaults to the .metadata.name of the ExternalSecret resource</p>
  7073. </td>
  7074. </tr>
  7075. <tr>
  7076. <td>
  7077. <code>creationPolicy</code></br>
  7078. <em>
  7079. <a href="#external-secrets.io/v1.ExternalSecretCreationPolicy">
  7080. ExternalSecretCreationPolicy
  7081. </a>
  7082. </em>
  7083. </td>
  7084. <td>
  7085. <em>(Optional)</em>
  7086. <p>CreationPolicy defines rules on how to create the resulting Secret.
  7087. Defaults to &ldquo;Owner&rdquo;</p>
  7088. </td>
  7089. </tr>
  7090. <tr>
  7091. <td>
  7092. <code>deletionPolicy</code></br>
  7093. <em>
  7094. <a href="#external-secrets.io/v1.ExternalSecretDeletionPolicy">
  7095. ExternalSecretDeletionPolicy
  7096. </a>
  7097. </em>
  7098. </td>
  7099. <td>
  7100. <em>(Optional)</em>
  7101. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  7102. Defaults to &ldquo;Retain&rdquo;</p>
  7103. </td>
  7104. </tr>
  7105. <tr>
  7106. <td>
  7107. <code>template</code></br>
  7108. <em>
  7109. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  7110. ExternalSecretTemplate
  7111. </a>
  7112. </em>
  7113. </td>
  7114. <td>
  7115. <em>(Optional)</em>
  7116. <p>Template defines a blueprint for the created Secret resource.</p>
  7117. </td>
  7118. </tr>
  7119. <tr>
  7120. <td>
  7121. <code>manifest</code></br>
  7122. <em>
  7123. <a href="#external-secrets.io/v1.ManifestReference">
  7124. ManifestReference
  7125. </a>
  7126. </em>
  7127. </td>
  7128. <td>
  7129. <em>(Optional)</em>
  7130. <p>Manifest defines a custom Kubernetes resource to create instead of a Secret.
  7131. When specified, ExternalSecret will create the resource type defined here
  7132. (e.g., ConfigMap, Custom Resource) instead of a Secret.
  7133. Warning: Using Generic target. Make sure access policies and encryption are properly configured.</p>
  7134. </td>
  7135. </tr>
  7136. <tr>
  7137. <td>
  7138. <code>immutable</code></br>
  7139. <em>
  7140. bool
  7141. </em>
  7142. </td>
  7143. <td>
  7144. <em>(Optional)</em>
  7145. <p>Immutable defines if the final secret will be immutable</p>
  7146. </td>
  7147. </tr>
  7148. </tbody>
  7149. </table>
  7150. <h3 id="external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate
  7151. </h3>
  7152. <p>
  7153. (<em>Appears on:</em>
  7154. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>,
  7155. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  7156. </p>
  7157. <p>
  7158. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  7159. 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>
  7160. </p>
  7161. <table>
  7162. <thead>
  7163. <tr>
  7164. <th>Field</th>
  7165. <th>Description</th>
  7166. </tr>
  7167. </thead>
  7168. <tbody>
  7169. <tr>
  7170. <td>
  7171. <code>type</code></br>
  7172. <em>
  7173. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  7174. Kubernetes core/v1.SecretType
  7175. </a>
  7176. </em>
  7177. </td>
  7178. <td>
  7179. <em>(Optional)</em>
  7180. </td>
  7181. </tr>
  7182. <tr>
  7183. <td>
  7184. <code>engineVersion</code></br>
  7185. <em>
  7186. <a href="#external-secrets.io/v1.TemplateEngineVersion">
  7187. TemplateEngineVersion
  7188. </a>
  7189. </em>
  7190. </td>
  7191. <td>
  7192. <p>EngineVersion specifies the template engine version
  7193. that should be used to compile/execute the
  7194. template specified in .data and .templateFrom[].</p>
  7195. </td>
  7196. </tr>
  7197. <tr>
  7198. <td>
  7199. <code>metadata</code></br>
  7200. <em>
  7201. <a href="#external-secrets.io/v1.ExternalSecretTemplateMetadata">
  7202. ExternalSecretTemplateMetadata
  7203. </a>
  7204. </em>
  7205. </td>
  7206. <td>
  7207. <em>(Optional)</em>
  7208. </td>
  7209. </tr>
  7210. <tr>
  7211. <td>
  7212. <code>mergePolicy</code></br>
  7213. <em>
  7214. <a href="#external-secrets.io/v1.TemplateMergePolicy">
  7215. TemplateMergePolicy
  7216. </a>
  7217. </em>
  7218. </td>
  7219. <td>
  7220. </td>
  7221. </tr>
  7222. <tr>
  7223. <td>
  7224. <code>data</code></br>
  7225. <em>
  7226. map[string]string
  7227. </em>
  7228. </td>
  7229. <td>
  7230. <em>(Optional)</em>
  7231. </td>
  7232. </tr>
  7233. <tr>
  7234. <td>
  7235. <code>templateFrom</code></br>
  7236. <em>
  7237. <a href="#external-secrets.io/v1.TemplateFrom">
  7238. []TemplateFrom
  7239. </a>
  7240. </em>
  7241. </td>
  7242. <td>
  7243. <em>(Optional)</em>
  7244. </td>
  7245. </tr>
  7246. </tbody>
  7247. </table>
  7248. <h3 id="external-secrets.io/v1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  7249. </h3>
  7250. <p>
  7251. (<em>Appears on:</em>
  7252. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  7253. </p>
  7254. <p>
  7255. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  7256. </p>
  7257. <table>
  7258. <thead>
  7259. <tr>
  7260. <th>Field</th>
  7261. <th>Description</th>
  7262. </tr>
  7263. </thead>
  7264. <tbody>
  7265. <tr>
  7266. <td>
  7267. <code>annotations</code></br>
  7268. <em>
  7269. map[string]string
  7270. </em>
  7271. </td>
  7272. <td>
  7273. <em>(Optional)</em>
  7274. </td>
  7275. </tr>
  7276. <tr>
  7277. <td>
  7278. <code>labels</code></br>
  7279. <em>
  7280. map[string]string
  7281. </em>
  7282. </td>
  7283. <td>
  7284. <em>(Optional)</em>
  7285. </td>
  7286. </tr>
  7287. <tr>
  7288. <td>
  7289. <code>finalizers</code></br>
  7290. <em>
  7291. []string
  7292. </em>
  7293. </td>
  7294. <td>
  7295. <em>(Optional)</em>
  7296. </td>
  7297. </tr>
  7298. </tbody>
  7299. </table>
  7300. <h3 id="external-secrets.io/v1.ExternalSecretValidator">ExternalSecretValidator
  7301. </h3>
  7302. <p>
  7303. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  7304. </p>
  7305. <h3 id="external-secrets.io/v1.FakeProvider">FakeProvider
  7306. </h3>
  7307. <p>
  7308. (<em>Appears on:</em>
  7309. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7310. </p>
  7311. <p>
  7312. <p>FakeProvider configures a fake provider that returns static values.</p>
  7313. </p>
  7314. <table>
  7315. <thead>
  7316. <tr>
  7317. <th>Field</th>
  7318. <th>Description</th>
  7319. </tr>
  7320. </thead>
  7321. <tbody>
  7322. <tr>
  7323. <td>
  7324. <code>data</code></br>
  7325. <em>
  7326. <a href="#external-secrets.io/v1.FakeProviderData">
  7327. []FakeProviderData
  7328. </a>
  7329. </em>
  7330. </td>
  7331. <td>
  7332. </td>
  7333. </tr>
  7334. <tr>
  7335. <td>
  7336. <code>validationResult</code></br>
  7337. <em>
  7338. <a href="#external-secrets.io/v1.ValidationResult">
  7339. ValidationResult
  7340. </a>
  7341. </em>
  7342. </td>
  7343. <td>
  7344. </td>
  7345. </tr>
  7346. </tbody>
  7347. </table>
  7348. <h3 id="external-secrets.io/v1.FakeProviderData">FakeProviderData
  7349. </h3>
  7350. <p>
  7351. (<em>Appears on:</em>
  7352. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  7353. </p>
  7354. <p>
  7355. <p>FakeProviderData defines a key-value pair with optional version for the fake provider.</p>
  7356. </p>
  7357. <table>
  7358. <thead>
  7359. <tr>
  7360. <th>Field</th>
  7361. <th>Description</th>
  7362. </tr>
  7363. </thead>
  7364. <tbody>
  7365. <tr>
  7366. <td>
  7367. <code>key</code></br>
  7368. <em>
  7369. string
  7370. </em>
  7371. </td>
  7372. <td>
  7373. </td>
  7374. </tr>
  7375. <tr>
  7376. <td>
  7377. <code>value</code></br>
  7378. <em>
  7379. string
  7380. </em>
  7381. </td>
  7382. <td>
  7383. </td>
  7384. </tr>
  7385. <tr>
  7386. <td>
  7387. <code>version</code></br>
  7388. <em>
  7389. string
  7390. </em>
  7391. </td>
  7392. <td>
  7393. </td>
  7394. </tr>
  7395. </tbody>
  7396. </table>
  7397. <h3 id="external-secrets.io/v1.FetchingPolicy">FetchingPolicy
  7398. </h3>
  7399. <p>
  7400. (<em>Appears on:</em>
  7401. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  7402. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  7403. </p>
  7404. <p>
  7405. <p>FetchingPolicy configures how the provider interprets the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret.</p>
  7406. </p>
  7407. <table>
  7408. <thead>
  7409. <tr>
  7410. <th>Field</th>
  7411. <th>Description</th>
  7412. </tr>
  7413. </thead>
  7414. <tbody>
  7415. <tr>
  7416. <td>
  7417. <code>byID</code></br>
  7418. <em>
  7419. <a href="#external-secrets.io/v1.ByID">
  7420. ByID
  7421. </a>
  7422. </em>
  7423. </td>
  7424. <td>
  7425. </td>
  7426. </tr>
  7427. <tr>
  7428. <td>
  7429. <code>byName</code></br>
  7430. <em>
  7431. <a href="#external-secrets.io/v1.ByName">
  7432. ByName
  7433. </a>
  7434. </em>
  7435. </td>
  7436. <td>
  7437. </td>
  7438. </tr>
  7439. </tbody>
  7440. </table>
  7441. <h3 id="external-secrets.io/v1.FindName">FindName
  7442. </h3>
  7443. <p>
  7444. (<em>Appears on:</em>
  7445. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  7446. </p>
  7447. <p>
  7448. <p>FindName defines criteria for finding secrets by name patterns.</p>
  7449. </p>
  7450. <table>
  7451. <thead>
  7452. <tr>
  7453. <th>Field</th>
  7454. <th>Description</th>
  7455. </tr>
  7456. </thead>
  7457. <tbody>
  7458. <tr>
  7459. <td>
  7460. <code>regexp</code></br>
  7461. <em>
  7462. string
  7463. </em>
  7464. </td>
  7465. <td>
  7466. <em>(Optional)</em>
  7467. <p>Finds secrets base</p>
  7468. </td>
  7469. </tr>
  7470. </tbody>
  7471. </table>
  7472. <h3 id="external-secrets.io/v1.FortanixProvider">FortanixProvider
  7473. </h3>
  7474. <p>
  7475. (<em>Appears on:</em>
  7476. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7477. </p>
  7478. <p>
  7479. <p>FortanixProvider provides access to Fortanix SDKMS API using the provided credentials.</p>
  7480. </p>
  7481. <table>
  7482. <thead>
  7483. <tr>
  7484. <th>Field</th>
  7485. <th>Description</th>
  7486. </tr>
  7487. </thead>
  7488. <tbody>
  7489. <tr>
  7490. <td>
  7491. <code>apiUrl</code></br>
  7492. <em>
  7493. string
  7494. </em>
  7495. </td>
  7496. <td>
  7497. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  7498. </td>
  7499. </tr>
  7500. <tr>
  7501. <td>
  7502. <code>apiKey</code></br>
  7503. <em>
  7504. <a href="#external-secrets.io/v1.FortanixProviderSecretRef">
  7505. FortanixProviderSecretRef
  7506. </a>
  7507. </em>
  7508. </td>
  7509. <td>
  7510. <p>APIKey is the API token to access SDKMS Applications.</p>
  7511. </td>
  7512. </tr>
  7513. </tbody>
  7514. </table>
  7515. <h3 id="external-secrets.io/v1.FortanixProviderSecretRef">FortanixProviderSecretRef
  7516. </h3>
  7517. <p>
  7518. (<em>Appears on:</em>
  7519. <a href="#external-secrets.io/v1.FortanixProvider">FortanixProvider</a>)
  7520. </p>
  7521. <p>
  7522. <p>FortanixProviderSecretRef is a secret reference containing the SDKMS API Key.</p>
  7523. </p>
  7524. <table>
  7525. <thead>
  7526. <tr>
  7527. <th>Field</th>
  7528. <th>Description</th>
  7529. </tr>
  7530. </thead>
  7531. <tbody>
  7532. <tr>
  7533. <td>
  7534. <code>secretRef</code></br>
  7535. <em>
  7536. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7537. External Secrets meta/v1.SecretKeySelector
  7538. </a>
  7539. </em>
  7540. </td>
  7541. <td>
  7542. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  7543. </td>
  7544. </tr>
  7545. </tbody>
  7546. </table>
  7547. <h3 id="external-secrets.io/v1.GCPSMAuth">GCPSMAuth
  7548. </h3>
  7549. <p>
  7550. (<em>Appears on:</em>
  7551. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  7552. </p>
  7553. <p>
  7554. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform Secret Manager.</p>
  7555. </p>
  7556. <table>
  7557. <thead>
  7558. <tr>
  7559. <th>Field</th>
  7560. <th>Description</th>
  7561. </tr>
  7562. </thead>
  7563. <tbody>
  7564. <tr>
  7565. <td>
  7566. <code>secretRef</code></br>
  7567. <em>
  7568. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  7569. GCPSMAuthSecretRef
  7570. </a>
  7571. </em>
  7572. </td>
  7573. <td>
  7574. <em>(Optional)</em>
  7575. </td>
  7576. </tr>
  7577. <tr>
  7578. <td>
  7579. <code>workloadIdentity</code></br>
  7580. <em>
  7581. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  7582. GCPWorkloadIdentity
  7583. </a>
  7584. </em>
  7585. </td>
  7586. <td>
  7587. <em>(Optional)</em>
  7588. </td>
  7589. </tr>
  7590. <tr>
  7591. <td>
  7592. <code>workloadIdentityFederation</code></br>
  7593. <em>
  7594. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  7595. GCPWorkloadIdentityFederation
  7596. </a>
  7597. </em>
  7598. </td>
  7599. <td>
  7600. <em>(Optional)</em>
  7601. </td>
  7602. </tr>
  7603. </tbody>
  7604. </table>
  7605. <h3 id="external-secrets.io/v1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  7606. </h3>
  7607. <p>
  7608. (<em>Appears on:</em>
  7609. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7610. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  7611. </p>
  7612. <p>
  7613. <p>GCPSMAuthSecretRef contains the secret references for GCP Secret Manager authentication.</p>
  7614. </p>
  7615. <table>
  7616. <thead>
  7617. <tr>
  7618. <th>Field</th>
  7619. <th>Description</th>
  7620. </tr>
  7621. </thead>
  7622. <tbody>
  7623. <tr>
  7624. <td>
  7625. <code>secretAccessKeySecretRef</code></br>
  7626. <em>
  7627. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7628. External Secrets meta/v1.SecretKeySelector
  7629. </a>
  7630. </em>
  7631. </td>
  7632. <td>
  7633. <em>(Optional)</em>
  7634. <p>The SecretAccessKey is used for authentication</p>
  7635. </td>
  7636. </tr>
  7637. </tbody>
  7638. </table>
  7639. <h3 id="external-secrets.io/v1.GCPSMProvider">GCPSMProvider
  7640. </h3>
  7641. <p>
  7642. (<em>Appears on:</em>
  7643. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7644. </p>
  7645. <p>
  7646. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  7647. </p>
  7648. <table>
  7649. <thead>
  7650. <tr>
  7651. <th>Field</th>
  7652. <th>Description</th>
  7653. </tr>
  7654. </thead>
  7655. <tbody>
  7656. <tr>
  7657. <td>
  7658. <code>auth</code></br>
  7659. <em>
  7660. <a href="#external-secrets.io/v1.GCPSMAuth">
  7661. GCPSMAuth
  7662. </a>
  7663. </em>
  7664. </td>
  7665. <td>
  7666. <em>(Optional)</em>
  7667. <p>Auth defines the information necessary to authenticate against GCP</p>
  7668. </td>
  7669. </tr>
  7670. <tr>
  7671. <td>
  7672. <code>projectID</code></br>
  7673. <em>
  7674. string
  7675. </em>
  7676. </td>
  7677. <td>
  7678. <p>ProjectID project where secret is located</p>
  7679. </td>
  7680. </tr>
  7681. <tr>
  7682. <td>
  7683. <code>location</code></br>
  7684. <em>
  7685. string
  7686. </em>
  7687. </td>
  7688. <td>
  7689. <p>Location optionally defines a location for a secret</p>
  7690. </td>
  7691. </tr>
  7692. <tr>
  7693. <td>
  7694. <code>secretVersionSelectionPolicy</code></br>
  7695. <em>
  7696. <a href="#external-secrets.io/v1.SecretVersionSelectionPolicy">
  7697. SecretVersionSelectionPolicy
  7698. </a>
  7699. </em>
  7700. </td>
  7701. <td>
  7702. <em>(Optional)</em>
  7703. <p>SecretVersionSelectionPolicy specifies how the provider selects a secret version
  7704. when &ldquo;latest&rdquo; is disabled or destroyed.
  7705. Possible values are:
  7706. - LatestOrFail: the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.
  7707. - LatestOrFetch: the provider falls back to fetching the latest version if the version is DESTROYED or DISABLED</p>
  7708. </td>
  7709. </tr>
  7710. </tbody>
  7711. </table>
  7712. <h3 id="external-secrets.io/v1.GCPWorkloadIdentity">GCPWorkloadIdentity
  7713. </h3>
  7714. <p>
  7715. (<em>Appears on:</em>
  7716. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7717. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  7718. </p>
  7719. <p>
  7720. <p>GCPWorkloadIdentity defines configuration for workload identity authentication to GCP.</p>
  7721. </p>
  7722. <table>
  7723. <thead>
  7724. <tr>
  7725. <th>Field</th>
  7726. <th>Description</th>
  7727. </tr>
  7728. </thead>
  7729. <tbody>
  7730. <tr>
  7731. <td>
  7732. <code>serviceAccountRef</code></br>
  7733. <em>
  7734. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7735. External Secrets meta/v1.ServiceAccountSelector
  7736. </a>
  7737. </em>
  7738. </td>
  7739. <td>
  7740. </td>
  7741. </tr>
  7742. <tr>
  7743. <td>
  7744. <code>clusterLocation</code></br>
  7745. <em>
  7746. string
  7747. </em>
  7748. </td>
  7749. <td>
  7750. <em>(Optional)</em>
  7751. <p>ClusterLocation is the location of the cluster
  7752. If not specified, it fetches information from the metadata server</p>
  7753. </td>
  7754. </tr>
  7755. <tr>
  7756. <td>
  7757. <code>clusterName</code></br>
  7758. <em>
  7759. string
  7760. </em>
  7761. </td>
  7762. <td>
  7763. <em>(Optional)</em>
  7764. <p>ClusterName is the name of the cluster
  7765. If not specified, it fetches information from the metadata server</p>
  7766. </td>
  7767. </tr>
  7768. <tr>
  7769. <td>
  7770. <code>clusterProjectID</code></br>
  7771. <em>
  7772. string
  7773. </em>
  7774. </td>
  7775. <td>
  7776. <em>(Optional)</em>
  7777. <p>ClusterProjectID is the project ID of the cluster
  7778. If not specified, it fetches information from the metadata server</p>
  7779. </td>
  7780. </tr>
  7781. </tbody>
  7782. </table>
  7783. <h3 id="external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation
  7784. </h3>
  7785. <p>
  7786. (<em>Appears on:</em>
  7787. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7788. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  7789. </p>
  7790. <p>
  7791. <p>GCPWorkloadIdentityFederation holds the configurations required for generating federated access tokens.</p>
  7792. </p>
  7793. <table>
  7794. <thead>
  7795. <tr>
  7796. <th>Field</th>
  7797. <th>Description</th>
  7798. </tr>
  7799. </thead>
  7800. <tbody>
  7801. <tr>
  7802. <td>
  7803. <code>credConfig</code></br>
  7804. <em>
  7805. <a href="#external-secrets.io/v1.ConfigMapReference">
  7806. ConfigMapReference
  7807. </a>
  7808. </em>
  7809. </td>
  7810. <td>
  7811. <p>credConfig holds the configmap reference containing the GCP external account credential configuration in JSON format and the key name containing the json data.
  7812. For using Kubernetes cluster as the identity provider, use serviceAccountRef instead. Operators mounted serviceaccount token cannot be used as the token source, instead
  7813. serviceAccountRef must be used by providing operators service account details.</p>
  7814. </td>
  7815. </tr>
  7816. <tr>
  7817. <td>
  7818. <code>serviceAccountRef</code></br>
  7819. <em>
  7820. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7821. External Secrets meta/v1.ServiceAccountSelector
  7822. </a>
  7823. </em>
  7824. </td>
  7825. <td>
  7826. <p>serviceAccountRef is the reference to the kubernetes ServiceAccount to be used for obtaining the tokens,
  7827. when Kubernetes is configured as provider in workload identity pool.</p>
  7828. </td>
  7829. </tr>
  7830. <tr>
  7831. <td>
  7832. <code>awsSecurityCredentials</code></br>
  7833. <em>
  7834. <a href="#external-secrets.io/v1.AwsCredentialsConfig">
  7835. AwsCredentialsConfig
  7836. </a>
  7837. </em>
  7838. </td>
  7839. <td>
  7840. <p>awsSecurityCredentials is for configuring AWS region and credentials to use for obtaining the access token,
  7841. when using the AWS metadata server is not an option.</p>
  7842. </td>
  7843. </tr>
  7844. <tr>
  7845. <td>
  7846. <code>audience</code></br>
  7847. <em>
  7848. string
  7849. </em>
  7850. </td>
  7851. <td>
  7852. <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.
  7853. If specified, Audience found in the external account credential config will be overridden with the configured value.
  7854. audience must be provided when serviceAccountRef or awsSecurityCredentials is configured.</p>
  7855. </td>
  7856. </tr>
  7857. <tr>
  7858. <td>
  7859. <code>externalTokenEndpoint</code></br>
  7860. <em>
  7861. string
  7862. </em>
  7863. </td>
  7864. <td>
  7865. <p>externalTokenEndpoint is the endpoint explicitly set up to provide tokens, which will be matched against the
  7866. credential_source.url in the provided credConfig. This field is merely to double-check the external token source
  7867. URL is having the expected value.</p>
  7868. </td>
  7869. </tr>
  7870. <tr>
  7871. <td>
  7872. <code>gcpServiceAccountEmail</code></br>
  7873. <em>
  7874. string
  7875. </em>
  7876. </td>
  7877. <td>
  7878. <p>GCPServiceAccountEmail is the email of the Google Cloud service account to impersonate
  7879. after Workload Identity Federation. Use this to grant access through the service account&rsquo;s
  7880. IAM bindings (for example roles/secretmanager.secretAccessor). When set, it overrides
  7881. service_account_impersonation_url in the external account JSON from credConfig;
  7882. when serviceAccountRef is set, it also overrides the &ldquo;iam.gke.io/gcp-service-account&rdquo; annotation
  7883. on that ServiceAccount.</p>
  7884. </td>
  7885. </tr>
  7886. </tbody>
  7887. </table>
  7888. <h3 id="external-secrets.io/v1.GcpIDTokenAuthCredentials">GcpIDTokenAuthCredentials
  7889. </h3>
  7890. <p>
  7891. (<em>Appears on:</em>
  7892. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7893. </p>
  7894. <p>
  7895. <p>GcpIDTokenAuthCredentials represents the credentials for GCP ID token authentication.</p>
  7896. </p>
  7897. <table>
  7898. <thead>
  7899. <tr>
  7900. <th>Field</th>
  7901. <th>Description</th>
  7902. </tr>
  7903. </thead>
  7904. <tbody>
  7905. <tr>
  7906. <td>
  7907. <code>identityId</code></br>
  7908. <em>
  7909. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7910. External Secrets meta/v1.SecretKeySelector
  7911. </a>
  7912. </em>
  7913. </td>
  7914. <td>
  7915. </td>
  7916. </tr>
  7917. </tbody>
  7918. </table>
  7919. <h3 id="external-secrets.io/v1.GcpIamAuthCredentials">GcpIamAuthCredentials
  7920. </h3>
  7921. <p>
  7922. (<em>Appears on:</em>
  7923. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7924. </p>
  7925. <p>
  7926. <p>GcpIamAuthCredentials represents the credentials for GCP IAM authentication.</p>
  7927. </p>
  7928. <table>
  7929. <thead>
  7930. <tr>
  7931. <th>Field</th>
  7932. <th>Description</th>
  7933. </tr>
  7934. </thead>
  7935. <tbody>
  7936. <tr>
  7937. <td>
  7938. <code>identityId</code></br>
  7939. <em>
  7940. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7941. External Secrets meta/v1.SecretKeySelector
  7942. </a>
  7943. </em>
  7944. </td>
  7945. <td>
  7946. </td>
  7947. </tr>
  7948. <tr>
  7949. <td>
  7950. <code>serviceAccountKeyFilePath</code></br>
  7951. <em>
  7952. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7953. External Secrets meta/v1.SecretKeySelector
  7954. </a>
  7955. </em>
  7956. </td>
  7957. <td>
  7958. </td>
  7959. </tr>
  7960. </tbody>
  7961. </table>
  7962. <h3 id="external-secrets.io/v1.GeneratorRef">GeneratorRef
  7963. </h3>
  7964. <p>
  7965. (<em>Appears on:</em>
  7966. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  7967. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>,
  7968. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  7969. </p>
  7970. <p>
  7971. <p>GeneratorRef points to a generator custom resource.</p>
  7972. </p>
  7973. <table>
  7974. <thead>
  7975. <tr>
  7976. <th>Field</th>
  7977. <th>Description</th>
  7978. </tr>
  7979. </thead>
  7980. <tbody>
  7981. <tr>
  7982. <td>
  7983. <code>apiVersion</code></br>
  7984. <em>
  7985. string
  7986. </em>
  7987. </td>
  7988. <td>
  7989. <p>Specify the apiVersion of the generator resource</p>
  7990. </td>
  7991. </tr>
  7992. <tr>
  7993. <td>
  7994. <code>kind</code></br>
  7995. <em>
  7996. string
  7997. </em>
  7998. </td>
  7999. <td>
  8000. <p>Specify the Kind of the generator resource</p>
  8001. </td>
  8002. </tr>
  8003. <tr>
  8004. <td>
  8005. <code>name</code></br>
  8006. <em>
  8007. string
  8008. </em>
  8009. </td>
  8010. <td>
  8011. <p>Specify the name of the generator resource</p>
  8012. </td>
  8013. </tr>
  8014. </tbody>
  8015. </table>
  8016. <h3 id="external-secrets.io/v1.GenericClusterStoreValidator">GenericClusterStoreValidator
  8017. </h3>
  8018. <p>
  8019. <p>GenericClusterStoreValidator implements webhook validation for ClusterSecretStore resources.</p>
  8020. </p>
  8021. <h3 id="external-secrets.io/v1.GenericStore">GenericStore
  8022. </h3>
  8023. <p>
  8024. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  8025. or a namespaced SecretStore.</p>
  8026. </p>
  8027. <h3 id="external-secrets.io/v1.GenericStoreValidator">GenericStoreValidator
  8028. </h3>
  8029. <p>
  8030. <p>GenericStoreValidator implements webhook validation for SecretStore resources.</p>
  8031. </p>
  8032. <h3 id="external-secrets.io/v1.GithubAppAuth">GithubAppAuth
  8033. </h3>
  8034. <p>
  8035. (<em>Appears on:</em>
  8036. <a href="#external-secrets.io/v1.GithubProvider">GithubProvider</a>)
  8037. </p>
  8038. <p>
  8039. <p>GithubAppAuth defines authentication configuration using a GitHub App for accessing GitHub API.</p>
  8040. </p>
  8041. <table>
  8042. <thead>
  8043. <tr>
  8044. <th>Field</th>
  8045. <th>Description</th>
  8046. </tr>
  8047. </thead>
  8048. <tbody>
  8049. <tr>
  8050. <td>
  8051. <code>privateKey</code></br>
  8052. <em>
  8053. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8054. External Secrets meta/v1.SecretKeySelector
  8055. </a>
  8056. </em>
  8057. </td>
  8058. <td>
  8059. </td>
  8060. </tr>
  8061. </tbody>
  8062. </table>
  8063. <h3 id="external-secrets.io/v1.GithubProvider">GithubProvider
  8064. </h3>
  8065. <p>
  8066. (<em>Appears on:</em>
  8067. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8068. </p>
  8069. <p>
  8070. <p>GithubProvider provides access and authentication to a GitHub instance .</p>
  8071. </p>
  8072. <table>
  8073. <thead>
  8074. <tr>
  8075. <th>Field</th>
  8076. <th>Description</th>
  8077. </tr>
  8078. </thead>
  8079. <tbody>
  8080. <tr>
  8081. <td>
  8082. <code>url</code></br>
  8083. <em>
  8084. string
  8085. </em>
  8086. </td>
  8087. <td>
  8088. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  8089. </td>
  8090. </tr>
  8091. <tr>
  8092. <td>
  8093. <code>uploadURL</code></br>
  8094. <em>
  8095. string
  8096. </em>
  8097. </td>
  8098. <td>
  8099. <em>(Optional)</em>
  8100. <p>Upload URL for enterprise instances. Default to URL.</p>
  8101. </td>
  8102. </tr>
  8103. <tr>
  8104. <td>
  8105. <code>auth</code></br>
  8106. <em>
  8107. <a href="#external-secrets.io/v1.GithubAppAuth">
  8108. GithubAppAuth
  8109. </a>
  8110. </em>
  8111. </td>
  8112. <td>
  8113. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  8114. </td>
  8115. </tr>
  8116. <tr>
  8117. <td>
  8118. <code>secretType</code></br>
  8119. <em>
  8120. <a href="#external-secrets.io/v1.GithubSecretType">
  8121. GithubSecretType
  8122. </a>
  8123. </em>
  8124. </td>
  8125. <td>
  8126. <em>(Optional)</em>
  8127. <p>secretType specifies which GitHub secret service to use.
  8128. Defaults to Actions for backwards compatibility.</p>
  8129. </td>
  8130. </tr>
  8131. <tr>
  8132. <td>
  8133. <code>appID</code></br>
  8134. <em>
  8135. int64
  8136. </em>
  8137. </td>
  8138. <td>
  8139. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  8140. </td>
  8141. </tr>
  8142. <tr>
  8143. <td>
  8144. <code>installationID</code></br>
  8145. <em>
  8146. int64
  8147. </em>
  8148. </td>
  8149. <td>
  8150. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  8151. </td>
  8152. </tr>
  8153. <tr>
  8154. <td>
  8155. <code>organization</code></br>
  8156. <em>
  8157. string
  8158. </em>
  8159. </td>
  8160. <td>
  8161. <p>organization will be used to fetch secrets from the Github organization</p>
  8162. </td>
  8163. </tr>
  8164. <tr>
  8165. <td>
  8166. <code>repository</code></br>
  8167. <em>
  8168. string
  8169. </em>
  8170. </td>
  8171. <td>
  8172. <em>(Optional)</em>
  8173. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  8174. </td>
  8175. </tr>
  8176. <tr>
  8177. <td>
  8178. <code>environment</code></br>
  8179. <em>
  8180. string
  8181. </em>
  8182. </td>
  8183. <td>
  8184. <em>(Optional)</em>
  8185. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  8186. </td>
  8187. </tr>
  8188. <tr>
  8189. <td>
  8190. <code>orgSecretVisibility</code></br>
  8191. <em>
  8192. string
  8193. </em>
  8194. </td>
  8195. <td>
  8196. <em>(Optional)</em>
  8197. <p>orgSecretVisibility controls the visibility of organization secrets pushed via PushSecret.
  8198. Valid values are &ldquo;all&rdquo; or &ldquo;private&rdquo;.
  8199. When unset, new secrets are created with visibility &ldquo;all&rdquo; and existing secrets preserve
  8200. whatever visibility they already have in GitHub.</p>
  8201. </td>
  8202. </tr>
  8203. </tbody>
  8204. </table>
  8205. <h3 id="external-secrets.io/v1.GithubSecretType">GithubSecretType
  8206. (<code>string</code> alias)</p></h3>
  8207. <p>
  8208. (<em>Appears on:</em>
  8209. <a href="#external-secrets.io/v1.GithubProvider">GithubProvider</a>)
  8210. </p>
  8211. <p>
  8212. <p>GithubSecretType specifies the GitHub secret service to use.</p>
  8213. </p>
  8214. <table>
  8215. <thead>
  8216. <tr>
  8217. <th>Value</th>
  8218. <th>Description</th>
  8219. </tr>
  8220. </thead>
  8221. <tbody><tr><td><p>&#34;Actions&#34;</p></td>
  8222. <td><p>GithubSecretTypeActions selects GitHub Actions secrets.</p>
  8223. </td>
  8224. </tr><tr><td><p>&#34;Dependabot&#34;</p></td>
  8225. <td><p>GithubSecretTypeDependabot selects GitHub Dependabot secrets.</p>
  8226. </td>
  8227. </tr></tbody>
  8228. </table>
  8229. <h3 id="external-secrets.io/v1.GitlabAuth">GitlabAuth
  8230. </h3>
  8231. <p>
  8232. (<em>Appears on:</em>
  8233. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>)
  8234. </p>
  8235. <p>
  8236. <p>GitlabAuth defines the authentication method for accessing GitLab API.</p>
  8237. </p>
  8238. <table>
  8239. <thead>
  8240. <tr>
  8241. <th>Field</th>
  8242. <th>Description</th>
  8243. </tr>
  8244. </thead>
  8245. <tbody>
  8246. <tr>
  8247. <td>
  8248. <code>SecretRef</code></br>
  8249. <em>
  8250. <a href="#external-secrets.io/v1.GitlabSecretRef">
  8251. GitlabSecretRef
  8252. </a>
  8253. </em>
  8254. </td>
  8255. <td>
  8256. </td>
  8257. </tr>
  8258. </tbody>
  8259. </table>
  8260. <h3 id="external-secrets.io/v1.GitlabProvider">GitlabProvider
  8261. </h3>
  8262. <p>
  8263. (<em>Appears on:</em>
  8264. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8265. </p>
  8266. <p>
  8267. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  8268. </p>
  8269. <table>
  8270. <thead>
  8271. <tr>
  8272. <th>Field</th>
  8273. <th>Description</th>
  8274. </tr>
  8275. </thead>
  8276. <tbody>
  8277. <tr>
  8278. <td>
  8279. <code>url</code></br>
  8280. <em>
  8281. string
  8282. </em>
  8283. </td>
  8284. <td>
  8285. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  8286. </td>
  8287. </tr>
  8288. <tr>
  8289. <td>
  8290. <code>auth</code></br>
  8291. <em>
  8292. <a href="#external-secrets.io/v1.GitlabAuth">
  8293. GitlabAuth
  8294. </a>
  8295. </em>
  8296. </td>
  8297. <td>
  8298. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  8299. </td>
  8300. </tr>
  8301. <tr>
  8302. <td>
  8303. <code>projectID</code></br>
  8304. <em>
  8305. string
  8306. </em>
  8307. </td>
  8308. <td>
  8309. <p>ProjectID specifies a project where secrets are located.</p>
  8310. </td>
  8311. </tr>
  8312. <tr>
  8313. <td>
  8314. <code>inheritFromGroups</code></br>
  8315. <em>
  8316. bool
  8317. </em>
  8318. </td>
  8319. <td>
  8320. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  8321. </td>
  8322. </tr>
  8323. <tr>
  8324. <td>
  8325. <code>groupIDs</code></br>
  8326. <em>
  8327. []string
  8328. </em>
  8329. </td>
  8330. <td>
  8331. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  8332. </td>
  8333. </tr>
  8334. <tr>
  8335. <td>
  8336. <code>environment</code></br>
  8337. <em>
  8338. string
  8339. </em>
  8340. </td>
  8341. <td>
  8342. <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>
  8343. </td>
  8344. </tr>
  8345. <tr>
  8346. <td>
  8347. <code>caBundle</code></br>
  8348. <em>
  8349. []byte
  8350. </em>
  8351. </td>
  8352. <td>
  8353. <em>(Optional)</em>
  8354. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  8355. can be performed.</p>
  8356. </td>
  8357. </tr>
  8358. <tr>
  8359. <td>
  8360. <code>caProvider</code></br>
  8361. <em>
  8362. <a href="#external-secrets.io/v1.CAProvider">
  8363. CAProvider
  8364. </a>
  8365. </em>
  8366. </td>
  8367. <td>
  8368. <em>(Optional)</em>
  8369. <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>
  8370. </td>
  8371. </tr>
  8372. </tbody>
  8373. </table>
  8374. <h3 id="external-secrets.io/v1.GitlabSecretRef">GitlabSecretRef
  8375. </h3>
  8376. <p>
  8377. (<em>Appears on:</em>
  8378. <a href="#external-secrets.io/v1.GitlabAuth">GitlabAuth</a>)
  8379. </p>
  8380. <p>
  8381. <p>GitlabSecretRef contains the secret reference for GitLab authentication credentials.</p>
  8382. </p>
  8383. <table>
  8384. <thead>
  8385. <tr>
  8386. <th>Field</th>
  8387. <th>Description</th>
  8388. </tr>
  8389. </thead>
  8390. <tbody>
  8391. <tr>
  8392. <td>
  8393. <code>accessToken</code></br>
  8394. <em>
  8395. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8396. External Secrets meta/v1.SecretKeySelector
  8397. </a>
  8398. </em>
  8399. </td>
  8400. <td>
  8401. <p>AccessToken is used for authentication.</p>
  8402. </td>
  8403. </tr>
  8404. </tbody>
  8405. </table>
  8406. <h3 id="external-secrets.io/v1.IBMAuth">IBMAuth
  8407. </h3>
  8408. <p>
  8409. (<em>Appears on:</em>
  8410. <a href="#external-secrets.io/v1.IBMProvider">IBMProvider</a>)
  8411. </p>
  8412. <p>
  8413. <p>IBMAuth defines authentication options for connecting to IBM Cloud Secrets Manager.</p>
  8414. </p>
  8415. <table>
  8416. <thead>
  8417. <tr>
  8418. <th>Field</th>
  8419. <th>Description</th>
  8420. </tr>
  8421. </thead>
  8422. <tbody>
  8423. <tr>
  8424. <td>
  8425. <code>secretRef</code></br>
  8426. <em>
  8427. <a href="#external-secrets.io/v1.IBMAuthSecretRef">
  8428. IBMAuthSecretRef
  8429. </a>
  8430. </em>
  8431. </td>
  8432. <td>
  8433. </td>
  8434. </tr>
  8435. <tr>
  8436. <td>
  8437. <code>containerAuth</code></br>
  8438. <em>
  8439. <a href="#external-secrets.io/v1.IBMAuthContainerAuth">
  8440. IBMAuthContainerAuth
  8441. </a>
  8442. </em>
  8443. </td>
  8444. <td>
  8445. </td>
  8446. </tr>
  8447. </tbody>
  8448. </table>
  8449. <h3 id="external-secrets.io/v1.IBMAuthContainerAuth">IBMAuthContainerAuth
  8450. </h3>
  8451. <p>
  8452. (<em>Appears on:</em>
  8453. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  8454. </p>
  8455. <p>
  8456. <p>IBMAuthContainerAuth defines container-based authentication with IAM Trusted Profile.</p>
  8457. </p>
  8458. <table>
  8459. <thead>
  8460. <tr>
  8461. <th>Field</th>
  8462. <th>Description</th>
  8463. </tr>
  8464. </thead>
  8465. <tbody>
  8466. <tr>
  8467. <td>
  8468. <code>profile</code></br>
  8469. <em>
  8470. string
  8471. </em>
  8472. </td>
  8473. <td>
  8474. <p>the IBM Trusted Profile</p>
  8475. </td>
  8476. </tr>
  8477. <tr>
  8478. <td>
  8479. <code>tokenLocation</code></br>
  8480. <em>
  8481. string
  8482. </em>
  8483. </td>
  8484. <td>
  8485. <p>Location the token is mounted on the pod</p>
  8486. </td>
  8487. </tr>
  8488. <tr>
  8489. <td>
  8490. <code>iamEndpoint</code></br>
  8491. <em>
  8492. string
  8493. </em>
  8494. </td>
  8495. <td>
  8496. </td>
  8497. </tr>
  8498. </tbody>
  8499. </table>
  8500. <h3 id="external-secrets.io/v1.IBMAuthSecretRef">IBMAuthSecretRef
  8501. </h3>
  8502. <p>
  8503. (<em>Appears on:</em>
  8504. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  8505. </p>
  8506. <p>
  8507. <p>IBMAuthSecretRef contains the secret reference for IBM Cloud API key authentication.</p>
  8508. </p>
  8509. <table>
  8510. <thead>
  8511. <tr>
  8512. <th>Field</th>
  8513. <th>Description</th>
  8514. </tr>
  8515. </thead>
  8516. <tbody>
  8517. <tr>
  8518. <td>
  8519. <code>secretApiKeySecretRef</code></br>
  8520. <em>
  8521. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8522. External Secrets meta/v1.SecretKeySelector
  8523. </a>
  8524. </em>
  8525. </td>
  8526. <td>
  8527. <p>The SecretAccessKey is used for authentication</p>
  8528. </td>
  8529. </tr>
  8530. <tr>
  8531. <td>
  8532. <code>iamEndpoint</code></br>
  8533. <em>
  8534. string
  8535. </em>
  8536. </td>
  8537. <td>
  8538. <p>The IAM endpoint used to obain a token</p>
  8539. </td>
  8540. </tr>
  8541. </tbody>
  8542. </table>
  8543. <h3 id="external-secrets.io/v1.IBMProvider">IBMProvider
  8544. </h3>
  8545. <p>
  8546. (<em>Appears on:</em>
  8547. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8548. </p>
  8549. <p>
  8550. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager
  8551. backend.</p>
  8552. </p>
  8553. <table>
  8554. <thead>
  8555. <tr>
  8556. <th>Field</th>
  8557. <th>Description</th>
  8558. </tr>
  8559. </thead>
  8560. <tbody>
  8561. <tr>
  8562. <td>
  8563. <code>auth</code></br>
  8564. <em>
  8565. <a href="#external-secrets.io/v1.IBMAuth">
  8566. IBMAuth
  8567. </a>
  8568. </em>
  8569. </td>
  8570. <td>
  8571. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  8572. </td>
  8573. </tr>
  8574. <tr>
  8575. <td>
  8576. <code>serviceUrl</code></br>
  8577. <em>
  8578. string
  8579. </em>
  8580. </td>
  8581. <td>
  8582. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  8583. </td>
  8584. </tr>
  8585. </tbody>
  8586. </table>
  8587. <h3 id="external-secrets.io/v1.InfisicalAuth">InfisicalAuth
  8588. </h3>
  8589. <p>
  8590. (<em>Appears on:</em>
  8591. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8592. </p>
  8593. <p>
  8594. <p>InfisicalAuth specifies the authentication configuration for Infisical.</p>
  8595. </p>
  8596. <table>
  8597. <thead>
  8598. <tr>
  8599. <th>Field</th>
  8600. <th>Description</th>
  8601. </tr>
  8602. </thead>
  8603. <tbody>
  8604. <tr>
  8605. <td>
  8606. <code>universalAuthCredentials</code></br>
  8607. <em>
  8608. <a href="#external-secrets.io/v1.UniversalAuthCredentials">
  8609. UniversalAuthCredentials
  8610. </a>
  8611. </em>
  8612. </td>
  8613. <td>
  8614. <em>(Optional)</em>
  8615. </td>
  8616. </tr>
  8617. <tr>
  8618. <td>
  8619. <code>azureAuthCredentials</code></br>
  8620. <em>
  8621. <a href="#external-secrets.io/v1.AzureAuthCredentials">
  8622. AzureAuthCredentials
  8623. </a>
  8624. </em>
  8625. </td>
  8626. <td>
  8627. <em>(Optional)</em>
  8628. </td>
  8629. </tr>
  8630. <tr>
  8631. <td>
  8632. <code>gcpIdTokenAuthCredentials</code></br>
  8633. <em>
  8634. <a href="#external-secrets.io/v1.GcpIDTokenAuthCredentials">
  8635. GcpIDTokenAuthCredentials
  8636. </a>
  8637. </em>
  8638. </td>
  8639. <td>
  8640. <em>(Optional)</em>
  8641. </td>
  8642. </tr>
  8643. <tr>
  8644. <td>
  8645. <code>gcpIamAuthCredentials</code></br>
  8646. <em>
  8647. <a href="#external-secrets.io/v1.GcpIamAuthCredentials">
  8648. GcpIamAuthCredentials
  8649. </a>
  8650. </em>
  8651. </td>
  8652. <td>
  8653. <em>(Optional)</em>
  8654. </td>
  8655. </tr>
  8656. <tr>
  8657. <td>
  8658. <code>jwtAuthCredentials</code></br>
  8659. <em>
  8660. <a href="#external-secrets.io/v1.JwtAuthCredentials">
  8661. JwtAuthCredentials
  8662. </a>
  8663. </em>
  8664. </td>
  8665. <td>
  8666. <em>(Optional)</em>
  8667. </td>
  8668. </tr>
  8669. <tr>
  8670. <td>
  8671. <code>ldapAuthCredentials</code></br>
  8672. <em>
  8673. <a href="#external-secrets.io/v1.LdapAuthCredentials">
  8674. LdapAuthCredentials
  8675. </a>
  8676. </em>
  8677. </td>
  8678. <td>
  8679. <em>(Optional)</em>
  8680. </td>
  8681. </tr>
  8682. <tr>
  8683. <td>
  8684. <code>ociAuthCredentials</code></br>
  8685. <em>
  8686. <a href="#external-secrets.io/v1.OciAuthCredentials">
  8687. OciAuthCredentials
  8688. </a>
  8689. </em>
  8690. </td>
  8691. <td>
  8692. <em>(Optional)</em>
  8693. </td>
  8694. </tr>
  8695. <tr>
  8696. <td>
  8697. <code>kubernetesAuthCredentials</code></br>
  8698. <em>
  8699. <a href="#external-secrets.io/v1.KubernetesAuthCredentials">
  8700. KubernetesAuthCredentials
  8701. </a>
  8702. </em>
  8703. </td>
  8704. <td>
  8705. <em>(Optional)</em>
  8706. </td>
  8707. </tr>
  8708. <tr>
  8709. <td>
  8710. <code>awsAuthCredentials</code></br>
  8711. <em>
  8712. <a href="#external-secrets.io/v1.AwsAuthCredentials">
  8713. AwsAuthCredentials
  8714. </a>
  8715. </em>
  8716. </td>
  8717. <td>
  8718. <em>(Optional)</em>
  8719. </td>
  8720. </tr>
  8721. <tr>
  8722. <td>
  8723. <code>tokenAuthCredentials</code></br>
  8724. <em>
  8725. <a href="#external-secrets.io/v1.TokenAuthCredentials">
  8726. TokenAuthCredentials
  8727. </a>
  8728. </em>
  8729. </td>
  8730. <td>
  8731. <em>(Optional)</em>
  8732. </td>
  8733. </tr>
  8734. </tbody>
  8735. </table>
  8736. <h3 id="external-secrets.io/v1.InfisicalProvider">InfisicalProvider
  8737. </h3>
  8738. <p>
  8739. (<em>Appears on:</em>
  8740. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8741. </p>
  8742. <p>
  8743. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  8744. </p>
  8745. <table>
  8746. <thead>
  8747. <tr>
  8748. <th>Field</th>
  8749. <th>Description</th>
  8750. </tr>
  8751. </thead>
  8752. <tbody>
  8753. <tr>
  8754. <td>
  8755. <code>auth</code></br>
  8756. <em>
  8757. <a href="#external-secrets.io/v1.InfisicalAuth">
  8758. InfisicalAuth
  8759. </a>
  8760. </em>
  8761. </td>
  8762. <td>
  8763. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  8764. </td>
  8765. </tr>
  8766. <tr>
  8767. <td>
  8768. <code>secretsScope</code></br>
  8769. <em>
  8770. <a href="#external-secrets.io/v1.MachineIdentityScopeInWorkspace">
  8771. MachineIdentityScopeInWorkspace
  8772. </a>
  8773. </em>
  8774. </td>
  8775. <td>
  8776. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  8777. </td>
  8778. </tr>
  8779. <tr>
  8780. <td>
  8781. <code>hostAPI</code></br>
  8782. <em>
  8783. string
  8784. </em>
  8785. </td>
  8786. <td>
  8787. <em>(Optional)</em>
  8788. <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>
  8789. </td>
  8790. </tr>
  8791. <tr>
  8792. <td>
  8793. <code>caBundle</code></br>
  8794. <em>
  8795. []byte
  8796. </em>
  8797. </td>
  8798. <td>
  8799. <em>(Optional)</em>
  8800. <p>CABundle is a PEM-encoded CA certificate bundle used to validate
  8801. the Infisical server&rsquo;s TLS certificate. Mutually exclusive with CAProvider.</p>
  8802. </td>
  8803. </tr>
  8804. <tr>
  8805. <td>
  8806. <code>caProvider</code></br>
  8807. <em>
  8808. <a href="#external-secrets.io/v1.CAProvider">
  8809. CAProvider
  8810. </a>
  8811. </em>
  8812. </td>
  8813. <td>
  8814. <em>(Optional)</em>
  8815. <p>CAProvider is a reference to a Secret or ConfigMap that contains a CA certificate.
  8816. The certificate is used to validate the Infisical server&rsquo;s TLS certificate.
  8817. Mutually exclusive with CABundle.</p>
  8818. </td>
  8819. </tr>
  8820. </tbody>
  8821. </table>
  8822. <h3 id="external-secrets.io/v1.IntegrationInfo">IntegrationInfo
  8823. </h3>
  8824. <p>
  8825. (<em>Appears on:</em>
  8826. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  8827. </p>
  8828. <p>
  8829. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.</p>
  8830. </p>
  8831. <table>
  8832. <thead>
  8833. <tr>
  8834. <th>Field</th>
  8835. <th>Description</th>
  8836. </tr>
  8837. </thead>
  8838. <tbody>
  8839. <tr>
  8840. <td>
  8841. <code>name</code></br>
  8842. <em>
  8843. string
  8844. </em>
  8845. </td>
  8846. <td>
  8847. <p>Name defaults to &ldquo;1Password SDK&rdquo;.</p>
  8848. </td>
  8849. </tr>
  8850. <tr>
  8851. <td>
  8852. <code>version</code></br>
  8853. <em>
  8854. string
  8855. </em>
  8856. </td>
  8857. <td>
  8858. <p>Version defaults to &ldquo;v1.0.0&rdquo;.</p>
  8859. </td>
  8860. </tr>
  8861. </tbody>
  8862. </table>
  8863. <h3 id="external-secrets.io/v1.JwtAuthCredentials">JwtAuthCredentials
  8864. </h3>
  8865. <p>
  8866. (<em>Appears on:</em>
  8867. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8868. </p>
  8869. <p>
  8870. <p>JwtAuthCredentials represents the credentials for JWT authentication.</p>
  8871. </p>
  8872. <table>
  8873. <thead>
  8874. <tr>
  8875. <th>Field</th>
  8876. <th>Description</th>
  8877. </tr>
  8878. </thead>
  8879. <tbody>
  8880. <tr>
  8881. <td>
  8882. <code>identityId</code></br>
  8883. <em>
  8884. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8885. External Secrets meta/v1.SecretKeySelector
  8886. </a>
  8887. </em>
  8888. </td>
  8889. <td>
  8890. </td>
  8891. </tr>
  8892. <tr>
  8893. <td>
  8894. <code>jwt</code></br>
  8895. <em>
  8896. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8897. External Secrets meta/v1.SecretKeySelector
  8898. </a>
  8899. </em>
  8900. </td>
  8901. <td>
  8902. </td>
  8903. </tr>
  8904. </tbody>
  8905. </table>
  8906. <h3 id="external-secrets.io/v1.KeeperSecurityProvider">KeeperSecurityProvider
  8907. </h3>
  8908. <p>
  8909. (<em>Appears on:</em>
  8910. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8911. </p>
  8912. <p>
  8913. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  8914. </p>
  8915. <table>
  8916. <thead>
  8917. <tr>
  8918. <th>Field</th>
  8919. <th>Description</th>
  8920. </tr>
  8921. </thead>
  8922. <tbody>
  8923. <tr>
  8924. <td>
  8925. <code>authRef</code></br>
  8926. <em>
  8927. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8928. External Secrets meta/v1.SecretKeySelector
  8929. </a>
  8930. </em>
  8931. </td>
  8932. <td>
  8933. </td>
  8934. </tr>
  8935. <tr>
  8936. <td>
  8937. <code>folderID</code></br>
  8938. <em>
  8939. string
  8940. </em>
  8941. </td>
  8942. <td>
  8943. </td>
  8944. </tr>
  8945. <tr>
  8946. <td>
  8947. <code>getByTitleFallback</code></br>
  8948. <em>
  8949. bool
  8950. </em>
  8951. </td>
  8952. <td>
  8953. </td>
  8954. </tr>
  8955. </tbody>
  8956. </table>
  8957. <h3 id="external-secrets.io/v1.KubernetesAuth">KubernetesAuth
  8958. </h3>
  8959. <p>
  8960. (<em>Appears on:</em>
  8961. <a href="#external-secrets.io/v1.CRDProvider">CRDProvider</a>,
  8962. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8963. </p>
  8964. <p>
  8965. <p>KubernetesAuth defines authentication options for connecting to a Kubernetes cluster.</p>
  8966. </p>
  8967. <table>
  8968. <thead>
  8969. <tr>
  8970. <th>Field</th>
  8971. <th>Description</th>
  8972. </tr>
  8973. </thead>
  8974. <tbody>
  8975. <tr>
  8976. <td>
  8977. <code>cert</code></br>
  8978. <em>
  8979. <a href="#external-secrets.io/v1.CertAuth">
  8980. CertAuth
  8981. </a>
  8982. </em>
  8983. </td>
  8984. <td>
  8985. <em>(Optional)</em>
  8986. <p>has both clientCert and clientKey as secretKeySelector</p>
  8987. </td>
  8988. </tr>
  8989. <tr>
  8990. <td>
  8991. <code>token</code></br>
  8992. <em>
  8993. <a href="#external-secrets.io/v1.TokenAuth">
  8994. TokenAuth
  8995. </a>
  8996. </em>
  8997. </td>
  8998. <td>
  8999. <em>(Optional)</em>
  9000. <p>use static token to authenticate with</p>
  9001. </td>
  9002. </tr>
  9003. <tr>
  9004. <td>
  9005. <code>serviceAccount</code></br>
  9006. <em>
  9007. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  9008. External Secrets meta/v1.ServiceAccountSelector
  9009. </a>
  9010. </em>
  9011. </td>
  9012. <td>
  9013. <em>(Optional)</em>
  9014. <p>points to a service account that should be used for authentication</p>
  9015. </td>
  9016. </tr>
  9017. </tbody>
  9018. </table>
  9019. <h3 id="external-secrets.io/v1.KubernetesAuthCredentials">KubernetesAuthCredentials
  9020. </h3>
  9021. <p>
  9022. (<em>Appears on:</em>
  9023. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  9024. </p>
  9025. <p>
  9026. <p>KubernetesAuthCredentials represents the credentials for Kubernetes authentication.</p>
  9027. </p>
  9028. <table>
  9029. <thead>
  9030. <tr>
  9031. <th>Field</th>
  9032. <th>Description</th>
  9033. </tr>
  9034. </thead>
  9035. <tbody>
  9036. <tr>
  9037. <td>
  9038. <code>identityId</code></br>
  9039. <em>
  9040. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9041. External Secrets meta/v1.SecretKeySelector
  9042. </a>
  9043. </em>
  9044. </td>
  9045. <td>
  9046. </td>
  9047. </tr>
  9048. <tr>
  9049. <td>
  9050. <code>serviceAccountTokenPath</code></br>
  9051. <em>
  9052. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9053. External Secrets meta/v1.SecretKeySelector
  9054. </a>
  9055. </em>
  9056. </td>
  9057. <td>
  9058. <em>(Optional)</em>
  9059. </td>
  9060. </tr>
  9061. </tbody>
  9062. </table>
  9063. <h3 id="external-secrets.io/v1.KubernetesProvider">KubernetesProvider
  9064. </h3>
  9065. <p>
  9066. (<em>Appears on:</em>
  9067. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9068. </p>
  9069. <p>
  9070. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  9071. </p>
  9072. <table>
  9073. <thead>
  9074. <tr>
  9075. <th>Field</th>
  9076. <th>Description</th>
  9077. </tr>
  9078. </thead>
  9079. <tbody>
  9080. <tr>
  9081. <td>
  9082. <code>server</code></br>
  9083. <em>
  9084. <a href="#external-secrets.io/v1.KubernetesServer">
  9085. KubernetesServer
  9086. </a>
  9087. </em>
  9088. </td>
  9089. <td>
  9090. <em>(Optional)</em>
  9091. <p>configures the Kubernetes server Address.</p>
  9092. </td>
  9093. </tr>
  9094. <tr>
  9095. <td>
  9096. <code>auth</code></br>
  9097. <em>
  9098. <a href="#external-secrets.io/v1.KubernetesAuth">
  9099. KubernetesAuth
  9100. </a>
  9101. </em>
  9102. </td>
  9103. <td>
  9104. <em>(Optional)</em>
  9105. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  9106. </td>
  9107. </tr>
  9108. <tr>
  9109. <td>
  9110. <code>authRef</code></br>
  9111. <em>
  9112. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9113. External Secrets meta/v1.SecretKeySelector
  9114. </a>
  9115. </em>
  9116. </td>
  9117. <td>
  9118. <em>(Optional)</em>
  9119. <p>A reference to a secret that contains the auth information.</p>
  9120. </td>
  9121. </tr>
  9122. <tr>
  9123. <td>
  9124. <code>remoteNamespace</code></br>
  9125. <em>
  9126. string
  9127. </em>
  9128. </td>
  9129. <td>
  9130. <em>(Optional)</em>
  9131. <p>Remote namespace to fetch the secrets from</p>
  9132. </td>
  9133. </tr>
  9134. </tbody>
  9135. </table>
  9136. <h3 id="external-secrets.io/v1.KubernetesServer">KubernetesServer
  9137. </h3>
  9138. <p>
  9139. (<em>Appears on:</em>
  9140. <a href="#external-secrets.io/v1.CRDProvider">CRDProvider</a>,
  9141. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  9142. </p>
  9143. <p>
  9144. <p>KubernetesServer defines configuration for connecting to a Kubernetes API server.</p>
  9145. </p>
  9146. <table>
  9147. <thead>
  9148. <tr>
  9149. <th>Field</th>
  9150. <th>Description</th>
  9151. </tr>
  9152. </thead>
  9153. <tbody>
  9154. <tr>
  9155. <td>
  9156. <code>url</code></br>
  9157. <em>
  9158. string
  9159. </em>
  9160. </td>
  9161. <td>
  9162. <em>(Optional)</em>
  9163. <p>configures the Kubernetes server Address.</p>
  9164. </td>
  9165. </tr>
  9166. <tr>
  9167. <td>
  9168. <code>caBundle</code></br>
  9169. <em>
  9170. []byte
  9171. </em>
  9172. </td>
  9173. <td>
  9174. <em>(Optional)</em>
  9175. <p>CABundle is a base64-encoded CA certificate</p>
  9176. </td>
  9177. </tr>
  9178. <tr>
  9179. <td>
  9180. <code>caProvider</code></br>
  9181. <em>
  9182. <a href="#external-secrets.io/v1.CAProvider">
  9183. CAProvider
  9184. </a>
  9185. </em>
  9186. </td>
  9187. <td>
  9188. <em>(Optional)</em>
  9189. <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>
  9190. </td>
  9191. </tr>
  9192. </tbody>
  9193. </table>
  9194. <h3 id="external-secrets.io/v1.LdapAuthCredentials">LdapAuthCredentials
  9195. </h3>
  9196. <p>
  9197. (<em>Appears on:</em>
  9198. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  9199. </p>
  9200. <p>
  9201. <p>LdapAuthCredentials represents the credentials for LDAP authentication.</p>
  9202. </p>
  9203. <table>
  9204. <thead>
  9205. <tr>
  9206. <th>Field</th>
  9207. <th>Description</th>
  9208. </tr>
  9209. </thead>
  9210. <tbody>
  9211. <tr>
  9212. <td>
  9213. <code>identityId</code></br>
  9214. <em>
  9215. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9216. External Secrets meta/v1.SecretKeySelector
  9217. </a>
  9218. </em>
  9219. </td>
  9220. <td>
  9221. </td>
  9222. </tr>
  9223. <tr>
  9224. <td>
  9225. <code>ldapPassword</code></br>
  9226. <em>
  9227. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9228. External Secrets meta/v1.SecretKeySelector
  9229. </a>
  9230. </em>
  9231. </td>
  9232. <td>
  9233. </td>
  9234. </tr>
  9235. <tr>
  9236. <td>
  9237. <code>ldapUsername</code></br>
  9238. <em>
  9239. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9240. External Secrets meta/v1.SecretKeySelector
  9241. </a>
  9242. </em>
  9243. </td>
  9244. <td>
  9245. </td>
  9246. </tr>
  9247. </tbody>
  9248. </table>
  9249. <h3 id="external-secrets.io/v1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  9250. </h3>
  9251. <p>
  9252. (<em>Appears on:</em>
  9253. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  9254. </p>
  9255. <p>
  9256. <p>MachineIdentityScopeInWorkspace defines the scope for machine identity within a workspace.</p>
  9257. </p>
  9258. <table>
  9259. <thead>
  9260. <tr>
  9261. <th>Field</th>
  9262. <th>Description</th>
  9263. </tr>
  9264. </thead>
  9265. <tbody>
  9266. <tr>
  9267. <td>
  9268. <code>secretsPath</code></br>
  9269. <em>
  9270. string
  9271. </em>
  9272. </td>
  9273. <td>
  9274. <em>(Optional)</em>
  9275. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  9276. </td>
  9277. </tr>
  9278. <tr>
  9279. <td>
  9280. <code>recursive</code></br>
  9281. <em>
  9282. bool
  9283. </em>
  9284. </td>
  9285. <td>
  9286. <em>(Optional)</em>
  9287. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  9288. </td>
  9289. </tr>
  9290. <tr>
  9291. <td>
  9292. <code>environmentSlug</code></br>
  9293. <em>
  9294. string
  9295. </em>
  9296. </td>
  9297. <td>
  9298. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  9299. </td>
  9300. </tr>
  9301. <tr>
  9302. <td>
  9303. <code>projectSlug</code></br>
  9304. <em>
  9305. string
  9306. </em>
  9307. </td>
  9308. <td>
  9309. <p>ProjectSlug is the required slug identifier for the project.</p>
  9310. </td>
  9311. </tr>
  9312. <tr>
  9313. <td>
  9314. <code>organizationSlug</code></br>
  9315. <em>
  9316. string
  9317. </em>
  9318. </td>
  9319. <td>
  9320. <p>OrganizationSlug is the optional slug that identifies the organization that will be used
  9321. during authentication. Useful for sub-organization setups</p>
  9322. </td>
  9323. </tr>
  9324. <tr>
  9325. <td>
  9326. <code>expandSecretReferences</code></br>
  9327. <em>
  9328. bool
  9329. </em>
  9330. </td>
  9331. <td>
  9332. <em>(Optional)</em>
  9333. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  9334. </td>
  9335. </tr>
  9336. </tbody>
  9337. </table>
  9338. <h3 id="external-secrets.io/v1.MaintenanceStatus">MaintenanceStatus
  9339. (<code>string</code> alias)</p></h3>
  9340. <p>
  9341. <p>MaintenanceStatus defines a type for different maintenance states of a provider schema.</p>
  9342. </p>
  9343. <table>
  9344. <thead>
  9345. <tr>
  9346. <th>Value</th>
  9347. <th>Description</th>
  9348. </tr>
  9349. </thead>
  9350. <tbody><tr><td><p>&#34;Deprecated&#34;</p></td>
  9351. <td></td>
  9352. </tr><tr><td><p>&#34;Maintained&#34;</p></td>
  9353. <td></td>
  9354. </tr><tr><td><p>&#34;NotMaintained&#34;</p></td>
  9355. <td></td>
  9356. </tr></tbody>
  9357. </table>
  9358. <h3 id="external-secrets.io/v1.ManifestReference">ManifestReference
  9359. </h3>
  9360. <p>
  9361. (<em>Appears on:</em>
  9362. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  9363. </p>
  9364. <p>
  9365. <p>ManifestReference defines a custom Kubernetes resource type to be created
  9366. instead of a Secret. This allows ExternalSecret to create ConfigMaps,
  9367. Custom Resources, or any other Kubernetes resource type.</p>
  9368. </p>
  9369. <table>
  9370. <thead>
  9371. <tr>
  9372. <th>Field</th>
  9373. <th>Description</th>
  9374. </tr>
  9375. </thead>
  9376. <tbody>
  9377. <tr>
  9378. <td>
  9379. <code>apiVersion</code></br>
  9380. <em>
  9381. string
  9382. </em>
  9383. </td>
  9384. <td>
  9385. <p>APIVersion of the target resource (e.g., &ldquo;v1&rdquo; for ConfigMap, &ldquo;argoproj.io/v1alpha1&rdquo; for ArgoCD Application)</p>
  9386. </td>
  9387. </tr>
  9388. <tr>
  9389. <td>
  9390. <code>kind</code></br>
  9391. <em>
  9392. string
  9393. </em>
  9394. </td>
  9395. <td>
  9396. <p>Kind of the target resource (e.g., &ldquo;ConfigMap&rdquo;, &ldquo;Application&rdquo;)</p>
  9397. </td>
  9398. </tr>
  9399. </tbody>
  9400. </table>
  9401. <h3 id="external-secrets.io/v1.NTLMProtocol">NTLMProtocol
  9402. </h3>
  9403. <p>
  9404. (<em>Appears on:</em>
  9405. <a href="#external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol</a>)
  9406. </p>
  9407. <p>
  9408. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  9409. </p>
  9410. <table>
  9411. <thead>
  9412. <tr>
  9413. <th>Field</th>
  9414. <th>Description</th>
  9415. </tr>
  9416. </thead>
  9417. <tbody>
  9418. <tr>
  9419. <td>
  9420. <code>usernameSecret</code></br>
  9421. <em>
  9422. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9423. External Secrets meta/v1.SecretKeySelector
  9424. </a>
  9425. </em>
  9426. </td>
  9427. <td>
  9428. </td>
  9429. </tr>
  9430. <tr>
  9431. <td>
  9432. <code>passwordSecret</code></br>
  9433. <em>
  9434. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9435. External Secrets meta/v1.SecretKeySelector
  9436. </a>
  9437. </em>
  9438. </td>
  9439. <td>
  9440. </td>
  9441. </tr>
  9442. </tbody>
  9443. </table>
  9444. <h3 id="external-secrets.io/v1.NebiusAuth">NebiusAuth
  9445. </h3>
  9446. <p>
  9447. (<em>Appears on:</em>
  9448. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  9449. </p>
  9450. <p>
  9451. <p>NebiusAuth defines the authentication method for the Nebius provider.</p>
  9452. </p>
  9453. <table>
  9454. <thead>
  9455. <tr>
  9456. <th>Field</th>
  9457. <th>Description</th>
  9458. </tr>
  9459. </thead>
  9460. <tbody>
  9461. <tr>
  9462. <td>
  9463. <code>serviceAccountCredsSecretRef</code></br>
  9464. <em>
  9465. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9466. External Secrets meta/v1.SecretKeySelector
  9467. </a>
  9468. </em>
  9469. </td>
  9470. <td>
  9471. <em>(Optional)</em>
  9472. <p>ServiceAccountCreds references a Kubernetes Secret key that contains a JSON
  9473. document with service account credentials used to get an IAM token.</p>
  9474. <p>Expected JSON structure:
  9475. {
  9476. &ldquo;subject-credentials&rdquo;: {
  9477. &ldquo;alg&rdquo;: &ldquo;RS256&rdquo;,
  9478. &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;,
  9479. &ldquo;kid&rdquo;: &ldquo;<public-key-id>&rdquo;,
  9480. &ldquo;iss&rdquo;: &ldquo;<issuer-service-account-id>&rdquo;,
  9481. &ldquo;sub&rdquo;: &ldquo;<subject-service-account-id>&rdquo;
  9482. }
  9483. }</p>
  9484. </td>
  9485. </tr>
  9486. <tr>
  9487. <td>
  9488. <code>tokenSecretRef</code></br>
  9489. <em>
  9490. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9491. External Secrets meta/v1.SecretKeySelector
  9492. </a>
  9493. </em>
  9494. </td>
  9495. <td>
  9496. <em>(Optional)</em>
  9497. <p>Token authenticates with Nebius Mysterybox by presenting a token.</p>
  9498. </td>
  9499. </tr>
  9500. <tr>
  9501. <td>
  9502. <code>workloadIdentity</code></br>
  9503. <em>
  9504. <a href="#external-secrets.io/v1.NebiusWorkloadIdentity">
  9505. NebiusWorkloadIdentity
  9506. </a>
  9507. </em>
  9508. </td>
  9509. <td>
  9510. <em>(Optional)</em>
  9511. <p>WorkloadIdentity defines configuration for workload identity authentication to Nebius IAM.</p>
  9512. </td>
  9513. </tr>
  9514. </tbody>
  9515. </table>
  9516. <h3 id="external-secrets.io/v1.NebiusCAProvider">NebiusCAProvider
  9517. </h3>
  9518. <p>
  9519. (<em>Appears on:</em>
  9520. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  9521. </p>
  9522. <p>
  9523. <p>NebiusCAProvider The provider for the CA bundle to use to validate Nebius server certificate.</p>
  9524. </p>
  9525. <table>
  9526. <thead>
  9527. <tr>
  9528. <th>Field</th>
  9529. <th>Description</th>
  9530. </tr>
  9531. </thead>
  9532. <tbody>
  9533. <tr>
  9534. <td>
  9535. <code>certSecretRef</code></br>
  9536. <em>
  9537. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9538. External Secrets meta/v1.SecretKeySelector
  9539. </a>
  9540. </em>
  9541. </td>
  9542. <td>
  9543. <em>(Optional)</em>
  9544. </td>
  9545. </tr>
  9546. </tbody>
  9547. </table>
  9548. <h3 id="external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider
  9549. </h3>
  9550. <p>
  9551. (<em>Appears on:</em>
  9552. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9553. </p>
  9554. <p>
  9555. <p>NebiusMysteryboxProvider Configures a store to sync secrets using the Nebius Mysterybox provider.</p>
  9556. </p>
  9557. <table>
  9558. <thead>
  9559. <tr>
  9560. <th>Field</th>
  9561. <th>Description</th>
  9562. </tr>
  9563. </thead>
  9564. <tbody>
  9565. <tr>
  9566. <td>
  9567. <code>apiDomain</code></br>
  9568. <em>
  9569. string
  9570. </em>
  9571. </td>
  9572. <td>
  9573. <p>NebiusMysterybox API endpoint</p>
  9574. </td>
  9575. </tr>
  9576. <tr>
  9577. <td>
  9578. <code>auth</code></br>
  9579. <em>
  9580. <a href="#external-secrets.io/v1.NebiusAuth">
  9581. NebiusAuth
  9582. </a>
  9583. </em>
  9584. </td>
  9585. <td>
  9586. <p>Auth defines parameters to authenticate in MysteryBox</p>
  9587. </td>
  9588. </tr>
  9589. <tr>
  9590. <td>
  9591. <code>caProvider</code></br>
  9592. <em>
  9593. <a href="#external-secrets.io/v1.NebiusCAProvider">
  9594. NebiusCAProvider
  9595. </a>
  9596. </em>
  9597. </td>
  9598. <td>
  9599. <em>(Optional)</em>
  9600. <p>The provider for the CA bundle to use to validate NebiusMysterybox server certificate.</p>
  9601. </td>
  9602. </tr>
  9603. </tbody>
  9604. </table>
  9605. <h3 id="external-secrets.io/v1.NebiusWorkloadIdentity">NebiusWorkloadIdentity
  9606. </h3>
  9607. <p>
  9608. (<em>Appears on:</em>
  9609. <a href="#external-secrets.io/v1.NebiusAuth">NebiusAuth</a>)
  9610. </p>
  9611. <p>
  9612. <p>NebiusWorkloadIdentity defines configuration for workload identity authentication to Nebius IAM.</p>
  9613. </p>
  9614. <table>
  9615. <thead>
  9616. <tr>
  9617. <th>Field</th>
  9618. <th>Description</th>
  9619. </tr>
  9620. </thead>
  9621. <tbody>
  9622. <tr>
  9623. <td>
  9624. <code>serviceAccountRef</code></br>
  9625. <em>
  9626. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  9627. External Secrets meta/v1.ServiceAccountSelector
  9628. </a>
  9629. </em>
  9630. </td>
  9631. <td>
  9632. <p>ServiceAccountRef references a Kubernetes ServiceAccount used to request a
  9633. temporary JWT via the TokenRequest API. The JWT is then exchanged for a
  9634. Nebius IAM token using workload federation.</p>
  9635. </td>
  9636. </tr>
  9637. <tr>
  9638. <td>
  9639. <code>iamServiceAccountID</code></br>
  9640. <em>
  9641. string
  9642. </em>
  9643. </td>
  9644. <td>
  9645. <p>IAMServiceAccountID is the Nebius IAM service account identifier that the
  9646. federated Kubernetes service account should impersonate during token exchange.</p>
  9647. </td>
  9648. </tr>
  9649. </tbody>
  9650. </table>
  9651. <h3 id="external-secrets.io/v1.NgrokAuth">NgrokAuth
  9652. </h3>
  9653. <p>
  9654. (<em>Appears on:</em>
  9655. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  9656. </p>
  9657. <p>
  9658. <p>NgrokAuth configures the authentication method for the ngrok provider.</p>
  9659. </p>
  9660. <table>
  9661. <thead>
  9662. <tr>
  9663. <th>Field</th>
  9664. <th>Description</th>
  9665. </tr>
  9666. </thead>
  9667. <tbody>
  9668. <tr>
  9669. <td>
  9670. <code>apiKey</code></br>
  9671. <em>
  9672. <a href="#external-secrets.io/v1.NgrokProviderSecretRef">
  9673. NgrokProviderSecretRef
  9674. </a>
  9675. </em>
  9676. </td>
  9677. <td>
  9678. <em>(Optional)</em>
  9679. <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>
  9680. </td>
  9681. </tr>
  9682. </tbody>
  9683. </table>
  9684. <h3 id="external-secrets.io/v1.NgrokProvider">NgrokProvider
  9685. </h3>
  9686. <p>
  9687. (<em>Appears on:</em>
  9688. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9689. </p>
  9690. <p>
  9691. <p>NgrokProvider configures a store to sync secrets with a ngrok vault to use in traffic policies.
  9692. See: <a href="https://ngrok.com/blog-post/secrets-for-traffic-policy">https://ngrok.com/blog-post/secrets-for-traffic-policy</a></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>apiUrl</code></br>
  9705. <em>
  9706. string
  9707. </em>
  9708. </td>
  9709. <td>
  9710. <p>APIURL is the URL of the ngrok API.</p>
  9711. </td>
  9712. </tr>
  9713. <tr>
  9714. <td>
  9715. <code>auth</code></br>
  9716. <em>
  9717. <a href="#external-secrets.io/v1.NgrokAuth">
  9718. NgrokAuth
  9719. </a>
  9720. </em>
  9721. </td>
  9722. <td>
  9723. <p>Auth configures how the ngrok provider authenticates with the ngrok API.</p>
  9724. </td>
  9725. </tr>
  9726. <tr>
  9727. <td>
  9728. <code>vault</code></br>
  9729. <em>
  9730. <a href="#external-secrets.io/v1.NgrokVault">
  9731. NgrokVault
  9732. </a>
  9733. </em>
  9734. </td>
  9735. <td>
  9736. <p>Vault configures the ngrok vault to sync secrets with.</p>
  9737. </td>
  9738. </tr>
  9739. </tbody>
  9740. </table>
  9741. <h3 id="external-secrets.io/v1.NgrokProviderSecretRef">NgrokProviderSecretRef
  9742. </h3>
  9743. <p>
  9744. (<em>Appears on:</em>
  9745. <a href="#external-secrets.io/v1.NgrokAuth">NgrokAuth</a>)
  9746. </p>
  9747. <p>
  9748. <p>NgrokProviderSecretRef contains the secret reference for the ngrok provider.</p>
  9749. </p>
  9750. <table>
  9751. <thead>
  9752. <tr>
  9753. <th>Field</th>
  9754. <th>Description</th>
  9755. </tr>
  9756. </thead>
  9757. <tbody>
  9758. <tr>
  9759. <td>
  9760. <code>secretRef</code></br>
  9761. <em>
  9762. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9763. External Secrets meta/v1.SecretKeySelector
  9764. </a>
  9765. </em>
  9766. </td>
  9767. <td>
  9768. <em>(Optional)</em>
  9769. <p>SecretRef is a reference to a secret containing the ngrok API key.</p>
  9770. </td>
  9771. </tr>
  9772. </tbody>
  9773. </table>
  9774. <h3 id="external-secrets.io/v1.NgrokVault">NgrokVault
  9775. </h3>
  9776. <p>
  9777. (<em>Appears on:</em>
  9778. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  9779. </p>
  9780. <p>
  9781. <p>NgrokVault configures the ngrok vault to sync secrets with.</p>
  9782. </p>
  9783. <table>
  9784. <thead>
  9785. <tr>
  9786. <th>Field</th>
  9787. <th>Description</th>
  9788. </tr>
  9789. </thead>
  9790. <tbody>
  9791. <tr>
  9792. <td>
  9793. <code>name</code></br>
  9794. <em>
  9795. string
  9796. </em>
  9797. </td>
  9798. <td>
  9799. <p>Name is the name of the ngrok vault to sync secrets with.</p>
  9800. </td>
  9801. </tr>
  9802. </tbody>
  9803. </table>
  9804. <h3 id="external-secrets.io/v1.NoSecretError">NoSecretError
  9805. </h3>
  9806. <p>
  9807. <p>NoSecretError shall be returned when a GetSecret can not find the
  9808. desired secret. This is used for deletionPolicy.</p>
  9809. </p>
  9810. <h3 id="external-secrets.io/v1.NotModifiedError">NotModifiedError
  9811. </h3>
  9812. <p>
  9813. <p>NotModifiedError to signal that the webhook received no changes,
  9814. and it should just return without doing anything.</p>
  9815. </p>
  9816. <h3 id="external-secrets.io/v1.OciAuthCredentials">OciAuthCredentials
  9817. </h3>
  9818. <p>
  9819. (<em>Appears on:</em>
  9820. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  9821. </p>
  9822. <p>
  9823. <p>OciAuthCredentials represents the credentials for OCI authentication.</p>
  9824. </p>
  9825. <table>
  9826. <thead>
  9827. <tr>
  9828. <th>Field</th>
  9829. <th>Description</th>
  9830. </tr>
  9831. </thead>
  9832. <tbody>
  9833. <tr>
  9834. <td>
  9835. <code>identityId</code></br>
  9836. <em>
  9837. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9838. External Secrets meta/v1.SecretKeySelector
  9839. </a>
  9840. </em>
  9841. </td>
  9842. <td>
  9843. </td>
  9844. </tr>
  9845. <tr>
  9846. <td>
  9847. <code>privateKey</code></br>
  9848. <em>
  9849. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9850. External Secrets meta/v1.SecretKeySelector
  9851. </a>
  9852. </em>
  9853. </td>
  9854. <td>
  9855. </td>
  9856. </tr>
  9857. <tr>
  9858. <td>
  9859. <code>privateKeyPassphrase</code></br>
  9860. <em>
  9861. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9862. External Secrets meta/v1.SecretKeySelector
  9863. </a>
  9864. </em>
  9865. </td>
  9866. <td>
  9867. <em>(Optional)</em>
  9868. </td>
  9869. </tr>
  9870. <tr>
  9871. <td>
  9872. <code>fingerprint</code></br>
  9873. <em>
  9874. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9875. External Secrets meta/v1.SecretKeySelector
  9876. </a>
  9877. </em>
  9878. </td>
  9879. <td>
  9880. </td>
  9881. </tr>
  9882. <tr>
  9883. <td>
  9884. <code>userId</code></br>
  9885. <em>
  9886. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9887. External Secrets meta/v1.SecretKeySelector
  9888. </a>
  9889. </em>
  9890. </td>
  9891. <td>
  9892. </td>
  9893. </tr>
  9894. <tr>
  9895. <td>
  9896. <code>tenancyId</code></br>
  9897. <em>
  9898. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9899. External Secrets meta/v1.SecretKeySelector
  9900. </a>
  9901. </em>
  9902. </td>
  9903. <td>
  9904. </td>
  9905. </tr>
  9906. <tr>
  9907. <td>
  9908. <code>region</code></br>
  9909. <em>
  9910. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9911. External Secrets meta/v1.SecretKeySelector
  9912. </a>
  9913. </em>
  9914. </td>
  9915. <td>
  9916. </td>
  9917. </tr>
  9918. </tbody>
  9919. </table>
  9920. <h3 id="external-secrets.io/v1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  9921. </h3>
  9922. <p>
  9923. (<em>Appears on:</em>
  9924. <a href="#external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider</a>)
  9925. </p>
  9926. <p>
  9927. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  9928. </p>
  9929. <table>
  9930. <thead>
  9931. <tr>
  9932. <th>Field</th>
  9933. <th>Description</th>
  9934. </tr>
  9935. </thead>
  9936. <tbody>
  9937. <tr>
  9938. <td>
  9939. <code>apiKeyRef</code></br>
  9940. <em>
  9941. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9942. External Secrets meta/v1.SecretKeySelector
  9943. </a>
  9944. </em>
  9945. </td>
  9946. <td>
  9947. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  9948. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  9949. </td>
  9950. </tr>
  9951. <tr>
  9952. <td>
  9953. <code>passcodeRef</code></br>
  9954. <em>
  9955. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9956. External Secrets meta/v1.SecretKeySelector
  9957. </a>
  9958. </em>
  9959. </td>
  9960. <td>
  9961. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  9962. </td>
  9963. </tr>
  9964. </tbody>
  9965. </table>
  9966. <h3 id="external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider
  9967. </h3>
  9968. <p>
  9969. (<em>Appears on:</em>
  9970. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9971. </p>
  9972. <p>
  9973. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  9974. Project and Config are required if not using a Service Token.</p>
  9975. </p>
  9976. <table>
  9977. <thead>
  9978. <tr>
  9979. <th>Field</th>
  9980. <th>Description</th>
  9981. </tr>
  9982. </thead>
  9983. <tbody>
  9984. <tr>
  9985. <td>
  9986. <code>auth</code></br>
  9987. <em>
  9988. <a href="#external-secrets.io/v1.OnboardbaseAuthSecretRef">
  9989. OnboardbaseAuthSecretRef
  9990. </a>
  9991. </em>
  9992. </td>
  9993. <td>
  9994. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  9995. </td>
  9996. </tr>
  9997. <tr>
  9998. <td>
  9999. <code>apiHost</code></br>
  10000. <em>
  10001. string
  10002. </em>
  10003. </td>
  10004. <td>
  10005. <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>
  10006. </td>
  10007. </tr>
  10008. <tr>
  10009. <td>
  10010. <code>project</code></br>
  10011. <em>
  10012. string
  10013. </em>
  10014. </td>
  10015. <td>
  10016. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  10017. </td>
  10018. </tr>
  10019. <tr>
  10020. <td>
  10021. <code>environment</code></br>
  10022. <em>
  10023. string
  10024. </em>
  10025. </td>
  10026. <td>
  10027. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  10028. </td>
  10029. </tr>
  10030. </tbody>
  10031. </table>
  10032. <h3 id="external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth
  10033. </h3>
  10034. <p>
  10035. (<em>Appears on:</em>
  10036. <a href="#external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider</a>)
  10037. </p>
  10038. <p>
  10039. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  10040. </p>
  10041. <table>
  10042. <thead>
  10043. <tr>
  10044. <th>Field</th>
  10045. <th>Description</th>
  10046. </tr>
  10047. </thead>
  10048. <tbody>
  10049. <tr>
  10050. <td>
  10051. <code>secretRef</code></br>
  10052. <em>
  10053. <a href="#external-secrets.io/v1.OnePasswordAuthSecretRef">
  10054. OnePasswordAuthSecretRef
  10055. </a>
  10056. </em>
  10057. </td>
  10058. <td>
  10059. </td>
  10060. </tr>
  10061. </tbody>
  10062. </table>
  10063. <h3 id="external-secrets.io/v1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  10064. </h3>
  10065. <p>
  10066. (<em>Appears on:</em>
  10067. <a href="#external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth</a>)
  10068. </p>
  10069. <p>
  10070. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  10071. </p>
  10072. <table>
  10073. <thead>
  10074. <tr>
  10075. <th>Field</th>
  10076. <th>Description</th>
  10077. </tr>
  10078. </thead>
  10079. <tbody>
  10080. <tr>
  10081. <td>
  10082. <code>connectTokenSecretRef</code></br>
  10083. <em>
  10084. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10085. External Secrets meta/v1.SecretKeySelector
  10086. </a>
  10087. </em>
  10088. </td>
  10089. <td>
  10090. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  10091. </td>
  10092. </tr>
  10093. </tbody>
  10094. </table>
  10095. <h3 id="external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider
  10096. </h3>
  10097. <p>
  10098. (<em>Appears on:</em>
  10099. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10100. </p>
  10101. <p>
  10102. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  10103. </p>
  10104. <table>
  10105. <thead>
  10106. <tr>
  10107. <th>Field</th>
  10108. <th>Description</th>
  10109. </tr>
  10110. </thead>
  10111. <tbody>
  10112. <tr>
  10113. <td>
  10114. <code>auth</code></br>
  10115. <em>
  10116. <a href="#external-secrets.io/v1.OnePasswordAuth">
  10117. OnePasswordAuth
  10118. </a>
  10119. </em>
  10120. </td>
  10121. <td>
  10122. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  10123. </td>
  10124. </tr>
  10125. <tr>
  10126. <td>
  10127. <code>connectHost</code></br>
  10128. <em>
  10129. string
  10130. </em>
  10131. </td>
  10132. <td>
  10133. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  10134. </td>
  10135. </tr>
  10136. <tr>
  10137. <td>
  10138. <code>vaults</code></br>
  10139. <em>
  10140. map[string]int
  10141. </em>
  10142. </td>
  10143. <td>
  10144. <p>Vaults defines which OnePassword vaults to search in which order</p>
  10145. </td>
  10146. </tr>
  10147. </tbody>
  10148. </table>
  10149. <h3 id="external-secrets.io/v1.OnePasswordSDKAuth">OnePasswordSDKAuth
  10150. </h3>
  10151. <p>
  10152. (<em>Appears on:</em>
  10153. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  10154. </p>
  10155. <p>
  10156. <p>OnePasswordSDKAuth contains a secretRef for the service account token.</p>
  10157. </p>
  10158. <table>
  10159. <thead>
  10160. <tr>
  10161. <th>Field</th>
  10162. <th>Description</th>
  10163. </tr>
  10164. </thead>
  10165. <tbody>
  10166. <tr>
  10167. <td>
  10168. <code>serviceAccountSecretRef</code></br>
  10169. <em>
  10170. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10171. External Secrets meta/v1.SecretKeySelector
  10172. </a>
  10173. </em>
  10174. </td>
  10175. <td>
  10176. <p>ServiceAccountSecretRef points to the secret containing the token to access 1Password vault.</p>
  10177. </td>
  10178. </tr>
  10179. </tbody>
  10180. </table>
  10181. <h3 id="external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider
  10182. </h3>
  10183. <p>
  10184. (<em>Appears on:</em>
  10185. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10186. </p>
  10187. <p>
  10188. <p>OnePasswordSDKProvider configures a store to sync secrets using the 1Password sdk.
  10189. Exactly one of Vault or Environment must be set.</p>
  10190. </p>
  10191. <table>
  10192. <thead>
  10193. <tr>
  10194. <th>Field</th>
  10195. <th>Description</th>
  10196. </tr>
  10197. </thead>
  10198. <tbody>
  10199. <tr>
  10200. <td>
  10201. <code>vault</code></br>
  10202. <em>
  10203. string
  10204. </em>
  10205. </td>
  10206. <td>
  10207. <em>(Optional)</em>
  10208. <p>Vault defines the vault&rsquo;s name or uuid to access. Do NOT add op:// prefix. This will be done automatically.
  10209. Mutually exclusive with Environment.</p>
  10210. </td>
  10211. </tr>
  10212. <tr>
  10213. <td>
  10214. <code>environment</code></br>
  10215. <em>
  10216. string
  10217. </em>
  10218. </td>
  10219. <td>
  10220. <em>(Optional)</em>
  10221. <p>Environment defines the 1Password Environment ID to read variables from.
  10222. Environments are read-only: PushSecret, DeleteSecret, and SecretExists return an error when set.
  10223. Mutually exclusive with Vault.</p>
  10224. </td>
  10225. </tr>
  10226. <tr>
  10227. <td>
  10228. <code>integrationInfo</code></br>
  10229. <em>
  10230. <a href="#external-secrets.io/v1.IntegrationInfo">
  10231. IntegrationInfo
  10232. </a>
  10233. </em>
  10234. </td>
  10235. <td>
  10236. <em>(Optional)</em>
  10237. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.
  10238. If you don&rsquo;t know which name and version to use, use <code>DefaultIntegrationName</code> and <code>DefaultIntegrationVersion</code>, respectively.</p>
  10239. </td>
  10240. </tr>
  10241. <tr>
  10242. <td>
  10243. <code>auth</code></br>
  10244. <em>
  10245. <a href="#external-secrets.io/v1.OnePasswordSDKAuth">
  10246. OnePasswordSDKAuth
  10247. </a>
  10248. </em>
  10249. </td>
  10250. <td>
  10251. <p>Auth defines the information necessary to authenticate against OnePassword API.</p>
  10252. </td>
  10253. </tr>
  10254. <tr>
  10255. <td>
  10256. <code>cache</code></br>
  10257. <em>
  10258. <a href="#external-secrets.io/v1.CacheConfig">
  10259. CacheConfig
  10260. </a>
  10261. </em>
  10262. </td>
  10263. <td>
  10264. <em>(Optional)</em>
  10265. <p>Cache configures client-side caching for read operations (GetSecret, GetSecretMap).
  10266. When enabled, secrets are cached with the specified TTL.
  10267. Write operations (PushSecret, DeleteSecret) automatically invalidate relevant cache entries.
  10268. If omitted, caching is disabled (default).
  10269. cache: {} is a valid option to set.</p>
  10270. </td>
  10271. </tr>
  10272. </tbody>
  10273. </table>
  10274. <h3 id="external-secrets.io/v1.OpenBaoAppRole">OpenBaoAppRole
  10275. </h3>
  10276. <p>
  10277. (<em>Appears on:</em>
  10278. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  10279. </p>
  10280. <p>
  10281. <p>OpenBaoAppRole authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/approle/">App Role auth
  10282. mechanism</a>, with the role and secret stored in a Kubernetes Secret resource.
  10283. The role ID has to be specified either inline via <code>roleId</code> or by referencing
  10284. a secret via <code>roleRef</code>.</p>
  10285. </p>
  10286. <table>
  10287. <thead>
  10288. <tr>
  10289. <th>Field</th>
  10290. <th>Description</th>
  10291. </tr>
  10292. </thead>
  10293. <tbody>
  10294. <tr>
  10295. <td>
  10296. <code>path</code></br>
  10297. <em>
  10298. string
  10299. </em>
  10300. </td>
  10301. <td>
  10302. <p>Path where the App Role authentication backend is mounted
  10303. in OpenBao, e.g: &ldquo;approle&rdquo;</p>
  10304. </td>
  10305. </tr>
  10306. <tr>
  10307. <td>
  10308. <code>roleId</code></br>
  10309. <em>
  10310. string
  10311. </em>
  10312. </td>
  10313. <td>
  10314. <em>(Optional)</em>
  10315. <p>RoleID configured in the App Role authentication backend when setting
  10316. up the authentication backend in OpenBao.</p>
  10317. </td>
  10318. </tr>
  10319. <tr>
  10320. <td>
  10321. <code>roleRef</code></br>
  10322. <em>
  10323. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10324. External Secrets meta/v1.SecretKeySelector
  10325. </a>
  10326. </em>
  10327. </td>
  10328. <td>
  10329. <em>(Optional)</em>
  10330. <p>Reference to a key in a Secret that contains the App Role ID used
  10331. to authenticate with OpenBao.
  10332. The <code>key</code> field must be specified and denotes which entry within the Secret
  10333. resource is used as the app role id.</p>
  10334. </td>
  10335. </tr>
  10336. <tr>
  10337. <td>
  10338. <code>secretRef</code></br>
  10339. <em>
  10340. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10341. External Secrets meta/v1.SecretKeySelector
  10342. </a>
  10343. </em>
  10344. </td>
  10345. <td>
  10346. <p>Reference to a key in a Secret that contains the App Role secret used
  10347. to authenticate with OpenBao.
  10348. The <code>key</code> field must be specified and denotes which entry within the Secret
  10349. resource is used as the app role secret.</p>
  10350. </td>
  10351. </tr>
  10352. </tbody>
  10353. </table>
  10354. <h3 id="external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth
  10355. </h3>
  10356. <p>
  10357. (<em>Appears on:</em>
  10358. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>)
  10359. </p>
  10360. <p>
  10361. <p>OpenBaoAuth is the configuration used to authenticate with an OpenBao server.
  10362. Currently the following authentication methods are supported: <a href="https://openbao.org/docs/auth/approle/">AppRole</a>,
  10363. <a href="https://openbao.org/docs/auth/kubernetes/">Kubernetes</a>, <a href="https://openbao.org/docs/auth/token/">Token</a> and <a href="https://openbao.org/docs/auth/userpass/">UserPass</a></p>
  10364. <p>Additional authentication methods are planned for future releases.</p>
  10365. </p>
  10366. <table>
  10367. <thead>
  10368. <tr>
  10369. <th>Field</th>
  10370. <th>Description</th>
  10371. </tr>
  10372. </thead>
  10373. <tbody>
  10374. <tr>
  10375. <td>
  10376. <code>appRole</code></br>
  10377. <em>
  10378. <a href="#external-secrets.io/v1.OpenBaoAppRole">
  10379. OpenBaoAppRole
  10380. </a>
  10381. </em>
  10382. </td>
  10383. <td>
  10384. <em>(Optional)</em>
  10385. <p>AppRole authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/approle/">App Role auth mechanism</a>,
  10386. with the role and secret stored in a Kubernetes Secret resource.</p>
  10387. </td>
  10388. </tr>
  10389. <tr>
  10390. <td>
  10391. <code>kubernetes</code></br>
  10392. <em>
  10393. <a href="#external-secrets.io/v1.OpenBaoKubernetesAuth">
  10394. OpenBaoKubernetesAuth
  10395. </a>
  10396. </em>
  10397. </td>
  10398. <td>
  10399. <em>(Optional)</em>
  10400. <p>Kubernetes authenticates with OpenBao by passing a ServiceAccount
  10401. token to the <a href="https://openbao.org/docs/auth/kubernetes/">Kubernetes auth mechanism</a>.</p>
  10402. </td>
  10403. </tr>
  10404. <tr>
  10405. <td>
  10406. <code>namespace</code></br>
  10407. <em>
  10408. string
  10409. </em>
  10410. </td>
  10411. <td>
  10412. <em>(Optional)</em>
  10413. <p>Name of the <a href="https://openbao.org/docs/concepts/namespaces/">OpenBao Namespace</a> to authenticate to. This can be different
  10414. than the namespace your secret is in. Namespaces is a set of features
  10415. within OpenBao that allows OpenBao environments to support secure
  10416. multi-tenancy. e.g: &ldquo;ns1&rdquo;. This will default to OpenBao.Namespace field
  10417. if set, or empty otherwise</p>
  10418. </td>
  10419. </tr>
  10420. <tr>
  10421. <td>
  10422. <code>tokenSecretRef</code></br>
  10423. <em>
  10424. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10425. External Secrets meta/v1.SecretKeySelector
  10426. </a>
  10427. </em>
  10428. </td>
  10429. <td>
  10430. <em>(Optional)</em>
  10431. <p>TokenSecretRef authenticates with OpenBao by presenting a token.</p>
  10432. </td>
  10433. </tr>
  10434. <tr>
  10435. <td>
  10436. <code>userPass</code></br>
  10437. <em>
  10438. <a href="#external-secrets.io/v1.OpenBaoUserPassAuth">
  10439. OpenBaoUserPassAuth
  10440. </a>
  10441. </em>
  10442. </td>
  10443. <td>
  10444. <em>(Optional)</em>
  10445. <p>UserPass authenticates with OpenBao by passing a username/password pair</p>
  10446. </td>
  10447. </tr>
  10448. </tbody>
  10449. </table>
  10450. <h3 id="external-secrets.io/v1.OpenBaoKVStoreVersion">OpenBaoKVStoreVersion
  10451. (<code>string</code> alias)</p></h3>
  10452. <p>
  10453. (<em>Appears on:</em>
  10454. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>)
  10455. </p>
  10456. <p>
  10457. <p>OpenBaoKVStoreVersion represents the version of the OpenBao KV secret engine.</p>
  10458. </p>
  10459. <table>
  10460. <thead>
  10461. <tr>
  10462. <th>Value</th>
  10463. <th>Description</th>
  10464. </tr>
  10465. </thead>
  10466. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  10467. <td></td>
  10468. </tr><tr><td><p>&#34;v2&#34;</p></td>
  10469. <td></td>
  10470. </tr></tbody>
  10471. </table>
  10472. <h3 id="external-secrets.io/v1.OpenBaoKubernetesAuth">OpenBaoKubernetesAuth
  10473. </h3>
  10474. <p>
  10475. (<em>Appears on:</em>
  10476. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  10477. </p>
  10478. <p>
  10479. <p>OpenBaoKubernetesAuth authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/kubernetes/">Kubernetes
  10480. auth mechanism</a> with a ServiceAccount token. The ServiceAccount token can be
  10481. sourced from a ServiceAccount via <code>ServiceAccountRef</code> or from a secret
  10482. via <code>SecretRef</code>.
  10483. Using the controller pod&rsquo;s ServiceAccount token is not supported.</p>
  10484. </p>
  10485. <table>
  10486. <thead>
  10487. <tr>
  10488. <th>Field</th>
  10489. <th>Description</th>
  10490. </tr>
  10491. </thead>
  10492. <tbody>
  10493. <tr>
  10494. <td>
  10495. <code>path</code></br>
  10496. <em>
  10497. string
  10498. </em>
  10499. </td>
  10500. <td>
  10501. <p>Path where the Kubernetes authentication backend is mounted in OpenBao, e.g:
  10502. &ldquo;kubernetes&rdquo;</p>
  10503. </td>
  10504. </tr>
  10505. <tr>
  10506. <td>
  10507. <code>serviceAccountRef</code></br>
  10508. <em>
  10509. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  10510. External Secrets meta/v1.ServiceAccountSelector
  10511. </a>
  10512. </em>
  10513. </td>
  10514. <td>
  10515. <em>(Optional)</em>
  10516. <p>Optional service account field containing the name of a Kubernetes ServiceAccount.
  10517. If the service account is specified, a token will be requested from the Kubernetes
  10518. TokenRequest API for authenticating with OpenBao.
  10519. Any configured audiences will be passed to the TokenRequest as-is.</p>
  10520. </td>
  10521. </tr>
  10522. <tr>
  10523. <td>
  10524. <code>secretRef</code></br>
  10525. <em>
  10526. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10527. External Secrets meta/v1.SecretKeySelector
  10528. </a>
  10529. </em>
  10530. </td>
  10531. <td>
  10532. <em>(Optional)</em>
  10533. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  10534. for authenticating with OpenBao. If a name is specified without a key,
  10535. <code>token</code> is the default.</p>
  10536. </td>
  10537. </tr>
  10538. <tr>
  10539. <td>
  10540. <code>role</code></br>
  10541. <em>
  10542. string
  10543. </em>
  10544. </td>
  10545. <td>
  10546. <p>A required field containing the OpenBao Role to assume. A Role binds a
  10547. Kubernetes ServiceAccount with a set of OpenBao policies.</p>
  10548. </td>
  10549. </tr>
  10550. </tbody>
  10551. </table>
  10552. <h3 id="external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider
  10553. </h3>
  10554. <p>
  10555. (<em>Appears on:</em>
  10556. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10557. </p>
  10558. <p>
  10559. <p>OpenBaoProvider configures a store to sync secrets using an OpenBao KV backend.</p>
  10560. </p>
  10561. <table>
  10562. <thead>
  10563. <tr>
  10564. <th>Field</th>
  10565. <th>Description</th>
  10566. </tr>
  10567. </thead>
  10568. <tbody>
  10569. <tr>
  10570. <td>
  10571. <code>auth</code></br>
  10572. <em>
  10573. <a href="#external-secrets.io/v1.OpenBaoAuth">
  10574. OpenBaoAuth
  10575. </a>
  10576. </em>
  10577. </td>
  10578. <td>
  10579. <em>(Optional)</em>
  10580. <p>Auth configures how secret-manager authenticates with the OpenBao server.</p>
  10581. </td>
  10582. </tr>
  10583. <tr>
  10584. <td>
  10585. <code>caBundle</code></br>
  10586. <em>
  10587. []byte
  10588. </em>
  10589. </td>
  10590. <td>
  10591. <em>(Optional)</em>
  10592. <p>PEM encoded CA bundle used to validate the OpenBao server certificate. If
  10593. this and <code>caProvider</code> are not set the system root certificates are used
  10594. to validate the TLS connection.</p>
  10595. </td>
  10596. </tr>
  10597. <tr>
  10598. <td>
  10599. <code>caProvider</code></br>
  10600. <em>
  10601. <a href="#external-secrets.io/v1.CAProvider">
  10602. CAProvider
  10603. </a>
  10604. </em>
  10605. </td>
  10606. <td>
  10607. <em>(Optional)</em>
  10608. <p>The provider for the CA bundle to use to validate OpenBao server
  10609. certificate. If this and <code>caBundle</code> are not set the system root
  10610. certificates are used to validate the TLS connection.</p>
  10611. </td>
  10612. </tr>
  10613. <tr>
  10614. <td>
  10615. <code>namespace</code></br>
  10616. <em>
  10617. string
  10618. </em>
  10619. </td>
  10620. <td>
  10621. <em>(Optional)</em>
  10622. <p>Name of the <a href="https://openbao.org/docs/concepts/namespaces/">OpenBao Namespace</a>. Namespaces is a set of features within
  10623. OpenBao that allows OpenBao environments to support secure multi-tenancy.
  10624. e.g: &ldquo;ns1&rdquo;.</p>
  10625. </td>
  10626. </tr>
  10627. <tr>
  10628. <td>
  10629. <code>server</code></br>
  10630. <em>
  10631. string
  10632. </em>
  10633. </td>
  10634. <td>
  10635. <p>Server is the connection address for the OpenBao server, e.g: <code>https://openbao.example.com:8200</code>.</p>
  10636. </td>
  10637. </tr>
  10638. <tr>
  10639. <td>
  10640. <code>path</code></br>
  10641. <em>
  10642. string
  10643. </em>
  10644. </td>
  10645. <td>
  10646. <em>(Optional)</em>
  10647. <p>Path is the mount path of the OpenBao KV backend endpoint, e.g:
  10648. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  10649. for fetching secrets from OpenBao is optional and will be appended
  10650. if not present in specified path.</p>
  10651. </td>
  10652. </tr>
  10653. <tr>
  10654. <td>
  10655. <code>version</code></br>
  10656. <em>
  10657. <a href="#external-secrets.io/v1.OpenBaoKVStoreVersion">
  10658. OpenBaoKVStoreVersion
  10659. </a>
  10660. </em>
  10661. </td>
  10662. <td>
  10663. <p>Version is the OpenBao KV secret engine version. This can be either &ldquo;v1&rdquo; or
  10664. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  10665. </td>
  10666. </tr>
  10667. </tbody>
  10668. </table>
  10669. <h3 id="external-secrets.io/v1.OpenBaoUserPassAuth">OpenBaoUserPassAuth
  10670. </h3>
  10671. <p>
  10672. (<em>Appears on:</em>
  10673. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  10674. </p>
  10675. <p>
  10676. <p>OpenBaoUserPassAuth authenticates with OpenBao using <a href="https://openbao.org/docs/auth/userpass/">UserPass authentication
  10677. method</a>, with the username and password stored in a Kubernetes Secret
  10678. resource.</p>
  10679. </p>
  10680. <table>
  10681. <thead>
  10682. <tr>
  10683. <th>Field</th>
  10684. <th>Description</th>
  10685. </tr>
  10686. </thead>
  10687. <tbody>
  10688. <tr>
  10689. <td>
  10690. <code>path</code></br>
  10691. <em>
  10692. string
  10693. </em>
  10694. </td>
  10695. <td>
  10696. <p>Path where the UserPassword authentication backend is mounted
  10697. in OpenBao, e.g: &ldquo;userpass&rdquo;</p>
  10698. </td>
  10699. </tr>
  10700. <tr>
  10701. <td>
  10702. <code>username</code></br>
  10703. <em>
  10704. string
  10705. </em>
  10706. </td>
  10707. <td>
  10708. <p>Username is a username used to authenticate using the <a href="https://openbao.org/docs/auth/userpass/">UserPass
  10709. authentication method</a></p>
  10710. </td>
  10711. </tr>
  10712. <tr>
  10713. <td>
  10714. <code>secretRef</code></br>
  10715. <em>
  10716. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10717. External Secrets meta/v1.SecretKeySelector
  10718. </a>
  10719. </em>
  10720. </td>
  10721. <td>
  10722. <p>SecretRef to a key in a Secret resource containing password for the user
  10723. used to authenticate with OpenBao using the <a href="https://openbao.org/docs/auth/userpass/">UserPass authentication
  10724. method</a></p>
  10725. </td>
  10726. </tr>
  10727. </tbody>
  10728. </table>
  10729. <h3 id="external-secrets.io/v1.OracleAuth">OracleAuth
  10730. </h3>
  10731. <p>
  10732. (<em>Appears on:</em>
  10733. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  10734. </p>
  10735. <p>
  10736. <p>OracleAuth defines the authentication method for the Oracle Vault provider.</p>
  10737. </p>
  10738. <table>
  10739. <thead>
  10740. <tr>
  10741. <th>Field</th>
  10742. <th>Description</th>
  10743. </tr>
  10744. </thead>
  10745. <tbody>
  10746. <tr>
  10747. <td>
  10748. <code>tenancy</code></br>
  10749. <em>
  10750. string
  10751. </em>
  10752. </td>
  10753. <td>
  10754. <p>Tenancy is the tenancy OCID where user is located.</p>
  10755. </td>
  10756. </tr>
  10757. <tr>
  10758. <td>
  10759. <code>user</code></br>
  10760. <em>
  10761. string
  10762. </em>
  10763. </td>
  10764. <td>
  10765. <p>User is an access OCID specific to the account.</p>
  10766. </td>
  10767. </tr>
  10768. <tr>
  10769. <td>
  10770. <code>secretRef</code></br>
  10771. <em>
  10772. <a href="#external-secrets.io/v1.OracleSecretRef">
  10773. OracleSecretRef
  10774. </a>
  10775. </em>
  10776. </td>
  10777. <td>
  10778. <p>SecretRef to pass through sensitive information.</p>
  10779. </td>
  10780. </tr>
  10781. </tbody>
  10782. </table>
  10783. <h3 id="external-secrets.io/v1.OraclePrincipalType">OraclePrincipalType
  10784. (<code>string</code> alias)</p></h3>
  10785. <p>
  10786. (<em>Appears on:</em>
  10787. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  10788. </p>
  10789. <p>
  10790. <p>OraclePrincipalType defines the type of principal used for authentication with Oracle Vault.</p>
  10791. </p>
  10792. <table>
  10793. <thead>
  10794. <tr>
  10795. <th>Value</th>
  10796. <th>Description</th>
  10797. </tr>
  10798. </thead>
  10799. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  10800. <td><p>InstancePrincipal represents a instance principal.</p>
  10801. </td>
  10802. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  10803. <td><p>UserPrincipal represents a user principal.</p>
  10804. </td>
  10805. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  10806. <td><p>WorkloadPrincipal represents a workload principal.</p>
  10807. </td>
  10808. </tr></tbody>
  10809. </table>
  10810. <h3 id="external-secrets.io/v1.OracleProvider">OracleProvider
  10811. </h3>
  10812. <p>
  10813. (<em>Appears on:</em>
  10814. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10815. </p>
  10816. <p>
  10817. <p>OracleProvider configures a store to sync secrets using an Oracle Vault
  10818. backend.</p>
  10819. </p>
  10820. <table>
  10821. <thead>
  10822. <tr>
  10823. <th>Field</th>
  10824. <th>Description</th>
  10825. </tr>
  10826. </thead>
  10827. <tbody>
  10828. <tr>
  10829. <td>
  10830. <code>region</code></br>
  10831. <em>
  10832. string
  10833. </em>
  10834. </td>
  10835. <td>
  10836. <p>Region is the region where vault is located.</p>
  10837. </td>
  10838. </tr>
  10839. <tr>
  10840. <td>
  10841. <code>vault</code></br>
  10842. <em>
  10843. string
  10844. </em>
  10845. </td>
  10846. <td>
  10847. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  10848. </td>
  10849. </tr>
  10850. <tr>
  10851. <td>
  10852. <code>compartment</code></br>
  10853. <em>
  10854. string
  10855. </em>
  10856. </td>
  10857. <td>
  10858. <em>(Optional)</em>
  10859. <p>Compartment is the vault compartment OCID.
  10860. Required for PushSecret</p>
  10861. </td>
  10862. </tr>
  10863. <tr>
  10864. <td>
  10865. <code>encryptionKey</code></br>
  10866. <em>
  10867. string
  10868. </em>
  10869. </td>
  10870. <td>
  10871. <em>(Optional)</em>
  10872. <p>EncryptionKey is the OCID of the encryption key within the vault.
  10873. Required for PushSecret</p>
  10874. </td>
  10875. </tr>
  10876. <tr>
  10877. <td>
  10878. <code>principalType</code></br>
  10879. <em>
  10880. <a href="#external-secrets.io/v1.OraclePrincipalType">
  10881. OraclePrincipalType
  10882. </a>
  10883. </em>
  10884. </td>
  10885. <td>
  10886. <em>(Optional)</em>
  10887. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  10888. determine the principal type. This optional field must be specified if using
  10889. workload identity.</p>
  10890. </td>
  10891. </tr>
  10892. <tr>
  10893. <td>
  10894. <code>auth</code></br>
  10895. <em>
  10896. <a href="#external-secrets.io/v1.OracleAuth">
  10897. OracleAuth
  10898. </a>
  10899. </em>
  10900. </td>
  10901. <td>
  10902. <em>(Optional)</em>
  10903. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  10904. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  10905. </td>
  10906. </tr>
  10907. <tr>
  10908. <td>
  10909. <code>serviceAccountRef</code></br>
  10910. <em>
  10911. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  10912. External Secrets meta/v1.ServiceAccountSelector
  10913. </a>
  10914. </em>
  10915. </td>
  10916. <td>
  10917. <em>(Optional)</em>
  10918. <p>ServiceAccountRef specified the service account
  10919. that should be used when authenticating with WorkloadIdentity.</p>
  10920. </td>
  10921. </tr>
  10922. </tbody>
  10923. </table>
  10924. <h3 id="external-secrets.io/v1.OracleSecretRef">OracleSecretRef
  10925. </h3>
  10926. <p>
  10927. (<em>Appears on:</em>
  10928. <a href="#external-secrets.io/v1.OracleAuth">OracleAuth</a>)
  10929. </p>
  10930. <p>
  10931. <p>OracleSecretRef contains the secret reference for Oracle Vault authentication credentials.</p>
  10932. </p>
  10933. <table>
  10934. <thead>
  10935. <tr>
  10936. <th>Field</th>
  10937. <th>Description</th>
  10938. </tr>
  10939. </thead>
  10940. <tbody>
  10941. <tr>
  10942. <td>
  10943. <code>privatekey</code></br>
  10944. <em>
  10945. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10946. External Secrets meta/v1.SecretKeySelector
  10947. </a>
  10948. </em>
  10949. </td>
  10950. <td>
  10951. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  10952. </td>
  10953. </tr>
  10954. <tr>
  10955. <td>
  10956. <code>fingerprint</code></br>
  10957. <em>
  10958. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10959. External Secrets meta/v1.SecretKeySelector
  10960. </a>
  10961. </em>
  10962. </td>
  10963. <td>
  10964. <p>Fingerprint is the fingerprint of the API private key.</p>
  10965. </td>
  10966. </tr>
  10967. </tbody>
  10968. </table>
  10969. <h3 id="external-secrets.io/v1.OvhAuth">OvhAuth
  10970. </h3>
  10971. <p>
  10972. (<em>Appears on:</em>
  10973. <a href="#external-secrets.io/v1.OvhProvider">OvhProvider</a>)
  10974. </p>
  10975. <p>
  10976. <p>OvhAuth tells the controller how to authenticate to OVHcloud&rsquo;s Secret Manager, either using mTLS or a token.</p>
  10977. </p>
  10978. <table>
  10979. <thead>
  10980. <tr>
  10981. <th>Field</th>
  10982. <th>Description</th>
  10983. </tr>
  10984. </thead>
  10985. <tbody>
  10986. <tr>
  10987. <td>
  10988. <code>mtls</code></br>
  10989. <em>
  10990. <a href="#external-secrets.io/v1.OvhClientMTLS">
  10991. OvhClientMTLS
  10992. </a>
  10993. </em>
  10994. </td>
  10995. <td>
  10996. <em>(Optional)</em>
  10997. </td>
  10998. </tr>
  10999. <tr>
  11000. <td>
  11001. <code>token</code></br>
  11002. <em>
  11003. <a href="#external-secrets.io/v1.OvhClientToken">
  11004. OvhClientToken
  11005. </a>
  11006. </em>
  11007. </td>
  11008. <td>
  11009. <em>(Optional)</em>
  11010. </td>
  11011. </tr>
  11012. </tbody>
  11013. </table>
  11014. <h3 id="external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS
  11015. </h3>
  11016. <p>
  11017. (<em>Appears on:</em>
  11018. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  11019. </p>
  11020. <p>
  11021. <p>OvhClientMTLS defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using mTLS.</p>
  11022. </p>
  11023. <table>
  11024. <thead>
  11025. <tr>
  11026. <th>Field</th>
  11027. <th>Description</th>
  11028. </tr>
  11029. </thead>
  11030. <tbody>
  11031. <tr>
  11032. <td>
  11033. <code>certSecretRef</code></br>
  11034. <em>
  11035. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11036. External Secrets meta/v1.SecretKeySelector
  11037. </a>
  11038. </em>
  11039. </td>
  11040. <td>
  11041. </td>
  11042. </tr>
  11043. <tr>
  11044. <td>
  11045. <code>keySecretRef</code></br>
  11046. <em>
  11047. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11048. External Secrets meta/v1.SecretKeySelector
  11049. </a>
  11050. </em>
  11051. </td>
  11052. <td>
  11053. </td>
  11054. </tr>
  11055. <tr>
  11056. <td>
  11057. <code>caBundle</code></br>
  11058. <em>
  11059. []byte
  11060. </em>
  11061. </td>
  11062. <td>
  11063. <em>(Optional)</em>
  11064. </td>
  11065. </tr>
  11066. <tr>
  11067. <td>
  11068. <code>caProvider</code></br>
  11069. <em>
  11070. <a href="#external-secrets.io/v1.CAProvider">
  11071. CAProvider
  11072. </a>
  11073. </em>
  11074. </td>
  11075. <td>
  11076. <em>(Optional)</em>
  11077. </td>
  11078. </tr>
  11079. </tbody>
  11080. </table>
  11081. <h3 id="external-secrets.io/v1.OvhClientToken">OvhClientToken
  11082. </h3>
  11083. <p>
  11084. (<em>Appears on:</em>
  11085. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  11086. </p>
  11087. <p>
  11088. <p>OvhClientToken defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using a token.</p>
  11089. </p>
  11090. <table>
  11091. <thead>
  11092. <tr>
  11093. <th>Field</th>
  11094. <th>Description</th>
  11095. </tr>
  11096. </thead>
  11097. <tbody>
  11098. <tr>
  11099. <td>
  11100. <code>tokenSecretRef</code></br>
  11101. <em>
  11102. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11103. External Secrets meta/v1.SecretKeySelector
  11104. </a>
  11105. </em>
  11106. </td>
  11107. <td>
  11108. </td>
  11109. </tr>
  11110. </tbody>
  11111. </table>
  11112. <h3 id="external-secrets.io/v1.OvhProvider">OvhProvider
  11113. </h3>
  11114. <p>
  11115. (<em>Appears on:</em>
  11116. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11117. </p>
  11118. <p>
  11119. <p>OvhProvider holds the configuration to synchronize secrets with OVHcloud&rsquo;s Secret Manager.</p>
  11120. </p>
  11121. <table>
  11122. <thead>
  11123. <tr>
  11124. <th>Field</th>
  11125. <th>Description</th>
  11126. </tr>
  11127. </thead>
  11128. <tbody>
  11129. <tr>
  11130. <td>
  11131. <code>server</code></br>
  11132. <em>
  11133. string
  11134. </em>
  11135. </td>
  11136. <td>
  11137. <p>specifies the OKMS server endpoint.</p>
  11138. </td>
  11139. </tr>
  11140. <tr>
  11141. <td>
  11142. <code>okmsid</code></br>
  11143. <em>
  11144. string
  11145. </em>
  11146. </td>
  11147. <td>
  11148. <p>specifies the OKMS ID.</p>
  11149. </td>
  11150. </tr>
  11151. <tr>
  11152. <td>
  11153. <code>casRequired</code></br>
  11154. <em>
  11155. bool
  11156. </em>
  11157. </td>
  11158. <td>
  11159. <em>(Optional)</em>
  11160. <p>Enables or disables check-and-set (CAS) (default: false).</p>
  11161. </td>
  11162. </tr>
  11163. <tr>
  11164. <td>
  11165. <code>okmsTimeout</code></br>
  11166. <em>
  11167. uint32
  11168. </em>
  11169. </td>
  11170. <td>
  11171. <em>(Optional)</em>
  11172. <p>Setup a timeout in seconds when requests to the KMS are made (default: 30).</p>
  11173. </td>
  11174. </tr>
  11175. <tr>
  11176. <td>
  11177. <code>auth</code></br>
  11178. <em>
  11179. <a href="#external-secrets.io/v1.OvhAuth">
  11180. OvhAuth
  11181. </a>
  11182. </em>
  11183. </td>
  11184. <td>
  11185. <p>Authentication method (mtls or token).</p>
  11186. </td>
  11187. </tr>
  11188. </tbody>
  11189. </table>
  11190. <h3 id="external-secrets.io/v1.PassboltAuth">PassboltAuth
  11191. </h3>
  11192. <p>
  11193. (<em>Appears on:</em>
  11194. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>)
  11195. </p>
  11196. <p>
  11197. <p>PassboltAuth contains a secretRef for the passbolt credentials.</p>
  11198. </p>
  11199. <table>
  11200. <thead>
  11201. <tr>
  11202. <th>Field</th>
  11203. <th>Description</th>
  11204. </tr>
  11205. </thead>
  11206. <tbody>
  11207. <tr>
  11208. <td>
  11209. <code>passwordSecretRef</code></br>
  11210. <em>
  11211. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11212. External Secrets meta/v1.SecretKeySelector
  11213. </a>
  11214. </em>
  11215. </td>
  11216. <td>
  11217. </td>
  11218. </tr>
  11219. <tr>
  11220. <td>
  11221. <code>privateKeySecretRef</code></br>
  11222. <em>
  11223. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11224. External Secrets meta/v1.SecretKeySelector
  11225. </a>
  11226. </em>
  11227. </td>
  11228. <td>
  11229. </td>
  11230. </tr>
  11231. </tbody>
  11232. </table>
  11233. <h3 id="external-secrets.io/v1.PassboltProvider">PassboltProvider
  11234. </h3>
  11235. <p>
  11236. (<em>Appears on:</em>
  11237. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11238. </p>
  11239. <p>
  11240. <p>PassboltProvider provides access to Passbolt secrets manager.
  11241. See: <a href="https://www.passbolt.com">https://www.passbolt.com</a>.</p>
  11242. </p>
  11243. <table>
  11244. <thead>
  11245. <tr>
  11246. <th>Field</th>
  11247. <th>Description</th>
  11248. </tr>
  11249. </thead>
  11250. <tbody>
  11251. <tr>
  11252. <td>
  11253. <code>auth</code></br>
  11254. <em>
  11255. <a href="#external-secrets.io/v1.PassboltAuth">
  11256. PassboltAuth
  11257. </a>
  11258. </em>
  11259. </td>
  11260. <td>
  11261. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  11262. </td>
  11263. </tr>
  11264. <tr>
  11265. <td>
  11266. <code>host</code></br>
  11267. <em>
  11268. string
  11269. </em>
  11270. </td>
  11271. <td>
  11272. <p>Host defines the Passbolt Server to connect to</p>
  11273. </td>
  11274. </tr>
  11275. <tr>
  11276. <td>
  11277. <code>caBundle</code></br>
  11278. <em>
  11279. []byte
  11280. </em>
  11281. </td>
  11282. <td>
  11283. <em>(Optional)</em>
  11284. <p>PEM encoded CA bundle used to validate Passbolt server certificate. Only used
  11285. if the Host URL is using HTTPS protocol. If not set the system root certificates
  11286. are used to validate the TLS connection.</p>
  11287. </td>
  11288. </tr>
  11289. <tr>
  11290. <td>
  11291. <code>caProvider</code></br>
  11292. <em>
  11293. <a href="#external-secrets.io/v1.CAProvider">
  11294. CAProvider
  11295. </a>
  11296. </em>
  11297. </td>
  11298. <td>
  11299. <em>(Optional)</em>
  11300. <p>The provider for the CA bundle to use to validate Passbolt server certificate.</p>
  11301. </td>
  11302. </tr>
  11303. </tbody>
  11304. </table>
  11305. <h3 id="external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth
  11306. </h3>
  11307. <p>
  11308. (<em>Appears on:</em>
  11309. <a href="#external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider</a>)
  11310. </p>
  11311. <p>
  11312. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  11313. </p>
  11314. <table>
  11315. <thead>
  11316. <tr>
  11317. <th>Field</th>
  11318. <th>Description</th>
  11319. </tr>
  11320. </thead>
  11321. <tbody>
  11322. <tr>
  11323. <td>
  11324. <code>secretRef</code></br>
  11325. <em>
  11326. <a href="#external-secrets.io/v1.PasswordDepotSecretRef">
  11327. PasswordDepotSecretRef
  11328. </a>
  11329. </em>
  11330. </td>
  11331. <td>
  11332. </td>
  11333. </tr>
  11334. </tbody>
  11335. </table>
  11336. <h3 id="external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider
  11337. </h3>
  11338. <p>
  11339. (<em>Appears on:</em>
  11340. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11341. </p>
  11342. <p>
  11343. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  11344. </p>
  11345. <table>
  11346. <thead>
  11347. <tr>
  11348. <th>Field</th>
  11349. <th>Description</th>
  11350. </tr>
  11351. </thead>
  11352. <tbody>
  11353. <tr>
  11354. <td>
  11355. <code>host</code></br>
  11356. <em>
  11357. string
  11358. </em>
  11359. </td>
  11360. <td>
  11361. <p>URL configures the Password Depot instance URL.</p>
  11362. </td>
  11363. </tr>
  11364. <tr>
  11365. <td>
  11366. <code>database</code></br>
  11367. <em>
  11368. string
  11369. </em>
  11370. </td>
  11371. <td>
  11372. <p>Database to use as source</p>
  11373. </td>
  11374. </tr>
  11375. <tr>
  11376. <td>
  11377. <code>auth</code></br>
  11378. <em>
  11379. <a href="#external-secrets.io/v1.PasswordDepotAuth">
  11380. PasswordDepotAuth
  11381. </a>
  11382. </em>
  11383. </td>
  11384. <td>
  11385. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  11386. </td>
  11387. </tr>
  11388. </tbody>
  11389. </table>
  11390. <h3 id="external-secrets.io/v1.PasswordDepotSecretRef">PasswordDepotSecretRef
  11391. </h3>
  11392. <p>
  11393. (<em>Appears on:</em>
  11394. <a href="#external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth</a>)
  11395. </p>
  11396. <p>
  11397. <p>PasswordDepotSecretRef contains the secret reference for Password Depot authentication.</p>
  11398. </p>
  11399. <table>
  11400. <thead>
  11401. <tr>
  11402. <th>Field</th>
  11403. <th>Description</th>
  11404. </tr>
  11405. </thead>
  11406. <tbody>
  11407. <tr>
  11408. <td>
  11409. <code>credentials</code></br>
  11410. <em>
  11411. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11412. External Secrets meta/v1.SecretKeySelector
  11413. </a>
  11414. </em>
  11415. </td>
  11416. <td>
  11417. <em>(Optional)</em>
  11418. <p>Username / Password is used for authentication.</p>
  11419. </td>
  11420. </tr>
  11421. </tbody>
  11422. </table>
  11423. <h3 id="external-secrets.io/v1.PreviderAuth">PreviderAuth
  11424. </h3>
  11425. <p>
  11426. (<em>Appears on:</em>
  11427. <a href="#external-secrets.io/v1.PreviderProvider">PreviderProvider</a>)
  11428. </p>
  11429. <p>
  11430. <p>PreviderAuth contains a secretRef for credentials.</p>
  11431. </p>
  11432. <table>
  11433. <thead>
  11434. <tr>
  11435. <th>Field</th>
  11436. <th>Description</th>
  11437. </tr>
  11438. </thead>
  11439. <tbody>
  11440. <tr>
  11441. <td>
  11442. <code>secretRef</code></br>
  11443. <em>
  11444. <a href="#external-secrets.io/v1.PreviderAuthSecretRef">
  11445. PreviderAuthSecretRef
  11446. </a>
  11447. </em>
  11448. </td>
  11449. <td>
  11450. <em>(Optional)</em>
  11451. </td>
  11452. </tr>
  11453. </tbody>
  11454. </table>
  11455. <h3 id="external-secrets.io/v1.PreviderAuthSecretRef">PreviderAuthSecretRef
  11456. </h3>
  11457. <p>
  11458. (<em>Appears on:</em>
  11459. <a href="#external-secrets.io/v1.PreviderAuth">PreviderAuth</a>)
  11460. </p>
  11461. <p>
  11462. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  11463. </p>
  11464. <table>
  11465. <thead>
  11466. <tr>
  11467. <th>Field</th>
  11468. <th>Description</th>
  11469. </tr>
  11470. </thead>
  11471. <tbody>
  11472. <tr>
  11473. <td>
  11474. <code>accessToken</code></br>
  11475. <em>
  11476. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11477. External Secrets meta/v1.SecretKeySelector
  11478. </a>
  11479. </em>
  11480. </td>
  11481. <td>
  11482. <p>The AccessToken is used for authentication</p>
  11483. </td>
  11484. </tr>
  11485. </tbody>
  11486. </table>
  11487. <h3 id="external-secrets.io/v1.PreviderProvider">PreviderProvider
  11488. </h3>
  11489. <p>
  11490. (<em>Appears on:</em>
  11491. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11492. </p>
  11493. <p>
  11494. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  11495. </p>
  11496. <table>
  11497. <thead>
  11498. <tr>
  11499. <th>Field</th>
  11500. <th>Description</th>
  11501. </tr>
  11502. </thead>
  11503. <tbody>
  11504. <tr>
  11505. <td>
  11506. <code>auth</code></br>
  11507. <em>
  11508. <a href="#external-secrets.io/v1.PreviderAuth">
  11509. PreviderAuth
  11510. </a>
  11511. </em>
  11512. </td>
  11513. <td>
  11514. </td>
  11515. </tr>
  11516. <tr>
  11517. <td>
  11518. <code>baseUri</code></br>
  11519. <em>
  11520. string
  11521. </em>
  11522. </td>
  11523. <td>
  11524. <em>(Optional)</em>
  11525. </td>
  11526. </tr>
  11527. </tbody>
  11528. </table>
  11529. <h3 id="external-secrets.io/v1.Provider">Provider
  11530. </h3>
  11531. <p>
  11532. <p>Provider is a common interface for interacting with secret backends.</p>
  11533. </p>
  11534. <h3 id="external-secrets.io/v1.PulumiAuth">PulumiAuth
  11535. </h3>
  11536. <p>
  11537. (<em>Appears on:</em>
  11538. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  11539. </p>
  11540. <p>
  11541. <p>PulumiAuth configures authentication with the Pulumi API.
  11542. Exactly one of accessToken or oidcConfig must be specified.</p>
  11543. </p>
  11544. <table>
  11545. <thead>
  11546. <tr>
  11547. <th>Field</th>
  11548. <th>Description</th>
  11549. </tr>
  11550. </thead>
  11551. <tbody>
  11552. <tr>
  11553. <td>
  11554. <code>accessToken</code></br>
  11555. <em>
  11556. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  11557. PulumiProviderSecretRef
  11558. </a>
  11559. </em>
  11560. </td>
  11561. <td>
  11562. <em>(Optional)</em>
  11563. <p>AccessToken authenticates using a Pulumi access token stored in a Kubernetes Secret.</p>
  11564. </td>
  11565. </tr>
  11566. <tr>
  11567. <td>
  11568. <code>oidcConfig</code></br>
  11569. <em>
  11570. <a href="#external-secrets.io/v1.PulumiOIDCAuth">
  11571. PulumiOIDCAuth
  11572. </a>
  11573. </em>
  11574. </td>
  11575. <td>
  11576. <em>(Optional)</em>
  11577. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  11578. </td>
  11579. </tr>
  11580. </tbody>
  11581. </table>
  11582. <h3 id="external-secrets.io/v1.PulumiOIDCAuth">PulumiOIDCAuth
  11583. </h3>
  11584. <p>
  11585. (<em>Appears on:</em>
  11586. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>)
  11587. </p>
  11588. <p>
  11589. <p>PulumiOIDCAuth configures OIDC authentication with Pulumi using Kubernetes ServiceAccount tokens.</p>
  11590. </p>
  11591. <table>
  11592. <thead>
  11593. <tr>
  11594. <th>Field</th>
  11595. <th>Description</th>
  11596. </tr>
  11597. </thead>
  11598. <tbody>
  11599. <tr>
  11600. <td>
  11601. <code>organization</code></br>
  11602. <em>
  11603. string
  11604. </em>
  11605. </td>
  11606. <td>
  11607. <p>Organization is the name of the Pulumi organization configured for OIDC authentication.</p>
  11608. </td>
  11609. </tr>
  11610. <tr>
  11611. <td>
  11612. <code>serviceAccountRef</code></br>
  11613. <em>
  11614. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  11615. External Secrets meta/v1.ServiceAccountSelector
  11616. </a>
  11617. </em>
  11618. </td>
  11619. <td>
  11620. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  11621. </td>
  11622. </tr>
  11623. <tr>
  11624. <td>
  11625. <code>expirationSeconds</code></br>
  11626. <em>
  11627. int64
  11628. </em>
  11629. </td>
  11630. <td>
  11631. <em>(Optional)</em>
  11632. <p>ExpirationSeconds sets the token validity duration for service account and OIDC token.
  11633. Defaults to 10 minutes.</p>
  11634. </td>
  11635. </tr>
  11636. </tbody>
  11637. </table>
  11638. <h3 id="external-secrets.io/v1.PulumiProvider">PulumiProvider
  11639. </h3>
  11640. <p>
  11641. (<em>Appears on:</em>
  11642. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11643. </p>
  11644. <p>
  11645. <p>PulumiProvider defines configuration for accessing secrets from Pulumi ESC.</p>
  11646. </p>
  11647. <table>
  11648. <thead>
  11649. <tr>
  11650. <th>Field</th>
  11651. <th>Description</th>
  11652. </tr>
  11653. </thead>
  11654. <tbody>
  11655. <tr>
  11656. <td>
  11657. <code>apiUrl</code></br>
  11658. <em>
  11659. string
  11660. </em>
  11661. </td>
  11662. <td>
  11663. <p>APIURL is the URL of the Pulumi API.</p>
  11664. </td>
  11665. </tr>
  11666. <tr>
  11667. <td>
  11668. <code>auth</code></br>
  11669. <em>
  11670. <a href="#external-secrets.io/v1.PulumiAuth">
  11671. PulumiAuth
  11672. </a>
  11673. </em>
  11674. </td>
  11675. <td>
  11676. <em>(Optional)</em>
  11677. <p>Auth configures how the Operator authenticates with the Pulumi API.
  11678. Either auth or the deprecated accessToken field must be specified.</p>
  11679. </td>
  11680. </tr>
  11681. <tr>
  11682. <td>
  11683. <code>organization</code></br>
  11684. <em>
  11685. string
  11686. </em>
  11687. </td>
  11688. <td>
  11689. <p>Organization are a space to collaborate on shared projects and stacks.
  11690. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  11691. </td>
  11692. </tr>
  11693. <tr>
  11694. <td>
  11695. <code>project</code></br>
  11696. <em>
  11697. string
  11698. </em>
  11699. </td>
  11700. <td>
  11701. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  11702. </td>
  11703. </tr>
  11704. <tr>
  11705. <td>
  11706. <code>environment</code></br>
  11707. <em>
  11708. string
  11709. </em>
  11710. </td>
  11711. <td>
  11712. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  11713. dynamically retrieved values from supported providers including all major clouds,
  11714. and other Pulumi ESC environments.
  11715. 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>
  11716. </td>
  11717. </tr>
  11718. <tr>
  11719. <td>
  11720. <code>accessToken</code></br>
  11721. <em>
  11722. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  11723. PulumiProviderSecretRef
  11724. </a>
  11725. </em>
  11726. </td>
  11727. <td>
  11728. <em>(Optional)</em>
  11729. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  11730. <p>Deprecated: Use auth.accessToken instead.</p>
  11731. </td>
  11732. </tr>
  11733. </tbody>
  11734. </table>
  11735. <h3 id="external-secrets.io/v1.PulumiProviderSecretRef">PulumiProviderSecretRef
  11736. </h3>
  11737. <p>
  11738. (<em>Appears on:</em>
  11739. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>,
  11740. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  11741. </p>
  11742. <p>
  11743. <p>PulumiProviderSecretRef contains the secret reference for Pulumi authentication.</p>
  11744. </p>
  11745. <table>
  11746. <thead>
  11747. <tr>
  11748. <th>Field</th>
  11749. <th>Description</th>
  11750. </tr>
  11751. </thead>
  11752. <tbody>
  11753. <tr>
  11754. <td>
  11755. <code>secretRef</code></br>
  11756. <em>
  11757. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11758. External Secrets meta/v1.SecretKeySelector
  11759. </a>
  11760. </em>
  11761. </td>
  11762. <td>
  11763. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  11764. </td>
  11765. </tr>
  11766. </tbody>
  11767. </table>
  11768. <h3 id="external-secrets.io/v1.PushSecretData">PushSecretData
  11769. </h3>
  11770. <p>
  11771. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1.</p>
  11772. </p>
  11773. <h3 id="external-secrets.io/v1.PushSecretRemoteRef">PushSecretRemoteRef
  11774. </h3>
  11775. <p>
  11776. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1.</p>
  11777. </p>
  11778. <h3 id="external-secrets.io/v1.ScalewayProvider">ScalewayProvider
  11779. </h3>
  11780. <p>
  11781. (<em>Appears on:</em>
  11782. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11783. </p>
  11784. <p>
  11785. <p>ScalewayProvider defines the configuration for the Scaleway Secret Manager provider.</p>
  11786. </p>
  11787. <table>
  11788. <thead>
  11789. <tr>
  11790. <th>Field</th>
  11791. <th>Description</th>
  11792. </tr>
  11793. </thead>
  11794. <tbody>
  11795. <tr>
  11796. <td>
  11797. <code>apiUrl</code></br>
  11798. <em>
  11799. string
  11800. </em>
  11801. </td>
  11802. <td>
  11803. <em>(Optional)</em>
  11804. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  11805. </td>
  11806. </tr>
  11807. <tr>
  11808. <td>
  11809. <code>region</code></br>
  11810. <em>
  11811. string
  11812. </em>
  11813. </td>
  11814. <td>
  11815. <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>
  11816. </td>
  11817. </tr>
  11818. <tr>
  11819. <td>
  11820. <code>projectId</code></br>
  11821. <em>
  11822. string
  11823. </em>
  11824. </td>
  11825. <td>
  11826. <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>
  11827. </td>
  11828. </tr>
  11829. <tr>
  11830. <td>
  11831. <code>accessKey</code></br>
  11832. <em>
  11833. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  11834. ScalewayProviderSecretRef
  11835. </a>
  11836. </em>
  11837. </td>
  11838. <td>
  11839. <p>AccessKey is the non-secret part of the api key.</p>
  11840. </td>
  11841. </tr>
  11842. <tr>
  11843. <td>
  11844. <code>secretKey</code></br>
  11845. <em>
  11846. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  11847. ScalewayProviderSecretRef
  11848. </a>
  11849. </em>
  11850. </td>
  11851. <td>
  11852. <p>SecretKey is the non-secret part of the api key.</p>
  11853. </td>
  11854. </tr>
  11855. </tbody>
  11856. </table>
  11857. <h3 id="external-secrets.io/v1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  11858. </h3>
  11859. <p>
  11860. (<em>Appears on:</em>
  11861. <a href="#external-secrets.io/v1.ScalewayProvider">ScalewayProvider</a>)
  11862. </p>
  11863. <p>
  11864. <p>ScalewayProviderSecretRef defines the configuration for Scaleway secret references.</p>
  11865. </p>
  11866. <table>
  11867. <thead>
  11868. <tr>
  11869. <th>Field</th>
  11870. <th>Description</th>
  11871. </tr>
  11872. </thead>
  11873. <tbody>
  11874. <tr>
  11875. <td>
  11876. <code>value</code></br>
  11877. <em>
  11878. string
  11879. </em>
  11880. </td>
  11881. <td>
  11882. <em>(Optional)</em>
  11883. <p>Value can be specified directly to set a value without using a secret.</p>
  11884. </td>
  11885. </tr>
  11886. <tr>
  11887. <td>
  11888. <code>secretRef</code></br>
  11889. <em>
  11890. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11891. External Secrets meta/v1.SecretKeySelector
  11892. </a>
  11893. </em>
  11894. </td>
  11895. <td>
  11896. <em>(Optional)</em>
  11897. <p>SecretRef references a key in a secret that will be used as value.</p>
  11898. </td>
  11899. </tr>
  11900. </tbody>
  11901. </table>
  11902. <h3 id="external-secrets.io/v1.SecretReference">SecretReference
  11903. </h3>
  11904. <p>
  11905. (<em>Appears on:</em>
  11906. <a href="#external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig</a>)
  11907. </p>
  11908. <p>
  11909. <p>SecretReference holds the details of a secret.</p>
  11910. </p>
  11911. <table>
  11912. <thead>
  11913. <tr>
  11914. <th>Field</th>
  11915. <th>Description</th>
  11916. </tr>
  11917. </thead>
  11918. <tbody>
  11919. <tr>
  11920. <td>
  11921. <code>name</code></br>
  11922. <em>
  11923. string
  11924. </em>
  11925. </td>
  11926. <td>
  11927. <p>name of the secret.</p>
  11928. </td>
  11929. </tr>
  11930. <tr>
  11931. <td>
  11932. <code>namespace</code></br>
  11933. <em>
  11934. string
  11935. </em>
  11936. </td>
  11937. <td>
  11938. <p>namespace in which the secret exists. If empty, secret will looked up in local namespace.</p>
  11939. </td>
  11940. </tr>
  11941. </tbody>
  11942. </table>
  11943. <h3 id="external-secrets.io/v1.SecretServerProvider">SecretServerProvider
  11944. </h3>
  11945. <p>
  11946. (<em>Appears on:</em>
  11947. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11948. </p>
  11949. <p>
  11950. <p>SecretServerProvider provides access to authenticate to a secrets provider server.
  11951. 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>.
  11952. Authentication requires either Token, or both Username and Password. If Token is
  11953. set it takes precedence and Username/Password are ignored.</p>
  11954. </p>
  11955. <table>
  11956. <thead>
  11957. <tr>
  11958. <th>Field</th>
  11959. <th>Description</th>
  11960. </tr>
  11961. </thead>
  11962. <tbody>
  11963. <tr>
  11964. <td>
  11965. <code>username</code></br>
  11966. <em>
  11967. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11968. SecretServerProviderRef
  11969. </a>
  11970. </em>
  11971. </td>
  11972. <td>
  11973. <em>(Optional)</em>
  11974. <p>Username is the secret server account username.
  11975. Required unless Token is set.</p>
  11976. </td>
  11977. </tr>
  11978. <tr>
  11979. <td>
  11980. <code>password</code></br>
  11981. <em>
  11982. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11983. SecretServerProviderRef
  11984. </a>
  11985. </em>
  11986. </td>
  11987. <td>
  11988. <em>(Optional)</em>
  11989. <p>Password is the secret server account password.
  11990. Required unless Token is set.</p>
  11991. </td>
  11992. </tr>
  11993. <tr>
  11994. <td>
  11995. <code>token</code></br>
  11996. <em>
  11997. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11998. SecretServerProviderRef
  11999. </a>
  12000. </em>
  12001. </td>
  12002. <td>
  12003. <em>(Optional)</em>
  12004. <p>Token is an access token used to authenticate to the secret server,
  12005. as an alternative to Username and Password. When set, Username and
  12006. Password are not required and are ignored.</p>
  12007. </td>
  12008. </tr>
  12009. <tr>
  12010. <td>
  12011. <code>domain</code></br>
  12012. <em>
  12013. string
  12014. </em>
  12015. </td>
  12016. <td>
  12017. <em>(Optional)</em>
  12018. <p>Domain is the secret server domain.</p>
  12019. </td>
  12020. </tr>
  12021. <tr>
  12022. <td>
  12023. <code>serverURL</code></br>
  12024. <em>
  12025. string
  12026. </em>
  12027. </td>
  12028. <td>
  12029. <p>ServerURL
  12030. URL to your secret server installation</p>
  12031. </td>
  12032. </tr>
  12033. <tr>
  12034. <td>
  12035. <code>siteId</code></br>
  12036. <em>
  12037. int
  12038. </em>
  12039. </td>
  12040. <td>
  12041. <em>(Optional)</em>
  12042. <p>SiteID is the ID of the Secret Server site for new secrets.
  12043. PushSecret metadata can override this value for one secret.
  12044. The provider uses 1 if this field is not set.</p>
  12045. </td>
  12046. </tr>
  12047. <tr>
  12048. <td>
  12049. <code>disableSiteIDValidation</code></br>
  12050. <em>
  12051. bool
  12052. </em>
  12053. </td>
  12054. <td>
  12055. <em>(Optional)</em>
  12056. <p>DisableSiteIDValidation permits a missing site ID for new secrets.
  12057. The provider sends 0 if no site ID is set.</p>
  12058. </td>
  12059. </tr>
  12060. <tr>
  12061. <td>
  12062. <code>caBundle</code></br>
  12063. <em>
  12064. []byte
  12065. </em>
  12066. </td>
  12067. <td>
  12068. <em>(Optional)</em>
  12069. <p>PEM/base64 encoded CA bundle used to validate Secret ServerURL. Only used
  12070. if the ServerURL URL is using HTTPS protocol. If not set the system root certificates
  12071. are used to validate the TLS connection.</p>
  12072. </td>
  12073. </tr>
  12074. <tr>
  12075. <td>
  12076. <code>caProvider</code></br>
  12077. <em>
  12078. <a href="#external-secrets.io/v1.CAProvider">
  12079. CAProvider
  12080. </a>
  12081. </em>
  12082. </td>
  12083. <td>
  12084. <em>(Optional)</em>
  12085. <p>The provider for the CA bundle to use to validate Secret ServerURL certificate.</p>
  12086. </td>
  12087. </tr>
  12088. </tbody>
  12089. </table>
  12090. <h3 id="external-secrets.io/v1.SecretServerProviderRef">SecretServerProviderRef
  12091. </h3>
  12092. <p>
  12093. (<em>Appears on:</em>
  12094. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>)
  12095. </p>
  12096. <p>
  12097. <p>SecretServerProviderRef references a value that can be specified directly or via a secret
  12098. for a SecretServerProvider. Exactly one of Value or SecretRef must be set.</p>
  12099. </p>
  12100. <table>
  12101. <thead>
  12102. <tr>
  12103. <th>Field</th>
  12104. <th>Description</th>
  12105. </tr>
  12106. </thead>
  12107. <tbody>
  12108. <tr>
  12109. <td>
  12110. <code>value</code></br>
  12111. <em>
  12112. string
  12113. </em>
  12114. </td>
  12115. <td>
  12116. <em>(Optional)</em>
  12117. <p>Value can be specified directly to set a value without using a secret.</p>
  12118. </td>
  12119. </tr>
  12120. <tr>
  12121. <td>
  12122. <code>secretRef</code></br>
  12123. <em>
  12124. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12125. External Secrets meta/v1.SecretKeySelector
  12126. </a>
  12127. </em>
  12128. </td>
  12129. <td>
  12130. <em>(Optional)</em>
  12131. <p>SecretRef references a key in a secret that will be used as value.</p>
  12132. </td>
  12133. </tr>
  12134. </tbody>
  12135. </table>
  12136. <h3 id="external-secrets.io/v1.SecretStore">SecretStore
  12137. </h3>
  12138. <p>
  12139. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  12140. </p>
  12141. <table>
  12142. <thead>
  12143. <tr>
  12144. <th>Field</th>
  12145. <th>Description</th>
  12146. </tr>
  12147. </thead>
  12148. <tbody>
  12149. <tr>
  12150. <td>
  12151. <code>metadata</code></br>
  12152. <em>
  12153. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  12154. Kubernetes meta/v1.ObjectMeta
  12155. </a>
  12156. </em>
  12157. </td>
  12158. <td>
  12159. Refer to the Kubernetes API documentation for the fields of the
  12160. <code>metadata</code> field.
  12161. </td>
  12162. </tr>
  12163. <tr>
  12164. <td>
  12165. <code>spec</code></br>
  12166. <em>
  12167. <a href="#external-secrets.io/v1.SecretStoreSpec">
  12168. SecretStoreSpec
  12169. </a>
  12170. </em>
  12171. </td>
  12172. <td>
  12173. <br/>
  12174. <br/>
  12175. <table>
  12176. <tr>
  12177. <td>
  12178. <code>controller</code></br>
  12179. <em>
  12180. string
  12181. </em>
  12182. </td>
  12183. <td>
  12184. <em>(Optional)</em>
  12185. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  12186. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  12187. </td>
  12188. </tr>
  12189. <tr>
  12190. <td>
  12191. <code>provider</code></br>
  12192. <em>
  12193. <a href="#external-secrets.io/v1.SecretStoreProvider">
  12194. SecretStoreProvider
  12195. </a>
  12196. </em>
  12197. </td>
  12198. <td>
  12199. <p>Used to configure the provider. Only one provider may be set</p>
  12200. </td>
  12201. </tr>
  12202. <tr>
  12203. <td>
  12204. <code>retrySettings</code></br>
  12205. <em>
  12206. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  12207. SecretStoreRetrySettings
  12208. </a>
  12209. </em>
  12210. </td>
  12211. <td>
  12212. <em>(Optional)</em>
  12213. <p>Used to configure HTTP retries on failures.</p>
  12214. </td>
  12215. </tr>
  12216. <tr>
  12217. <td>
  12218. <code>refreshInterval</code></br>
  12219. <em>
  12220. k8s.io/apimachinery/pkg/util/intstr.IntOrString
  12221. </em>
  12222. </td>
  12223. <td>
  12224. <em>(Optional)</em>
  12225. <p>Used to configure store refresh interval. Accepts either an integer number
  12226. of seconds (legacy) or a Go duration string such as &ldquo;1h&rdquo; or &ldquo;5m&rdquo;. Empty or
  12227. 0 will default to the controller config.</p>
  12228. </td>
  12229. </tr>
  12230. <tr>
  12231. <td>
  12232. <code>conditions</code></br>
  12233. <em>
  12234. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  12235. []ClusterSecretStoreCondition
  12236. </a>
  12237. </em>
  12238. </td>
  12239. <td>
  12240. <em>(Optional)</em>
  12241. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  12242. </td>
  12243. </tr>
  12244. </table>
  12245. </td>
  12246. </tr>
  12247. <tr>
  12248. <td>
  12249. <code>status</code></br>
  12250. <em>
  12251. <a href="#external-secrets.io/v1.SecretStoreStatus">
  12252. SecretStoreStatus
  12253. </a>
  12254. </em>
  12255. </td>
  12256. <td>
  12257. </td>
  12258. </tr>
  12259. </tbody>
  12260. </table>
  12261. <h3 id="external-secrets.io/v1.SecretStoreCapabilities">SecretStoreCapabilities
  12262. (<code>string</code> alias)</p></h3>
  12263. <p>
  12264. (<em>Appears on:</em>
  12265. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  12266. </p>
  12267. <p>
  12268. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  12269. </p>
  12270. <table>
  12271. <thead>
  12272. <tr>
  12273. <th>Value</th>
  12274. <th>Description</th>
  12275. </tr>
  12276. </thead>
  12277. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  12278. <td><p>SecretStoreReadOnly indicates that the store can only read secrets.</p>
  12279. </td>
  12280. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  12281. <td><p>SecretStoreReadWrite indicates that the store can both read and write secrets.</p>
  12282. </td>
  12283. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  12284. <td><p>SecretStoreWriteOnly indicates that the store can only write secrets.</p>
  12285. </td>
  12286. </tr></tbody>
  12287. </table>
  12288. <h3 id="external-secrets.io/v1.SecretStoreConditionType">SecretStoreConditionType
  12289. (<code>string</code> alias)</p></h3>
  12290. <p>
  12291. (<em>Appears on:</em>
  12292. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  12293. </p>
  12294. <p>
  12295. <p>SecretStoreConditionType represents the condition of the SecretStore.</p>
  12296. </p>
  12297. <table>
  12298. <thead>
  12299. <tr>
  12300. <th>Value</th>
  12301. <th>Description</th>
  12302. </tr>
  12303. </thead>
  12304. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  12305. <td><p>SecretStoreReady indicates that the store is ready and able to serve requests.</p>
  12306. </td>
  12307. </tr></tbody>
  12308. </table>
  12309. <h3 id="external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider
  12310. </h3>
  12311. <p>
  12312. (<em>Appears on:</em>
  12313. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  12314. </p>
  12315. <p>
  12316. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  12317. </p>
  12318. <table>
  12319. <thead>
  12320. <tr>
  12321. <th>Field</th>
  12322. <th>Description</th>
  12323. </tr>
  12324. </thead>
  12325. <tbody>
  12326. <tr>
  12327. <td>
  12328. <code>aws</code></br>
  12329. <em>
  12330. <a href="#external-secrets.io/v1.AWSProvider">
  12331. AWSProvider
  12332. </a>
  12333. </em>
  12334. </td>
  12335. <td>
  12336. <em>(Optional)</em>
  12337. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  12338. </td>
  12339. </tr>
  12340. <tr>
  12341. <td>
  12342. <code>azurekv</code></br>
  12343. <em>
  12344. <a href="#external-secrets.io/v1.AzureKVProvider">
  12345. AzureKVProvider
  12346. </a>
  12347. </em>
  12348. </td>
  12349. <td>
  12350. <em>(Optional)</em>
  12351. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  12352. </td>
  12353. </tr>
  12354. <tr>
  12355. <td>
  12356. <code>akeyless</code></br>
  12357. <em>
  12358. <a href="#external-secrets.io/v1.AkeylessProvider">
  12359. AkeylessProvider
  12360. </a>
  12361. </em>
  12362. </td>
  12363. <td>
  12364. <em>(Optional)</em>
  12365. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  12366. </td>
  12367. </tr>
  12368. <tr>
  12369. <td>
  12370. <code>bitwardensecretsmanager</code></br>
  12371. <em>
  12372. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">
  12373. BitwardenSecretsManagerProvider
  12374. </a>
  12375. </em>
  12376. </td>
  12377. <td>
  12378. <em>(Optional)</em>
  12379. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  12380. </td>
  12381. </tr>
  12382. <tr>
  12383. <td>
  12384. <code>vault</code></br>
  12385. <em>
  12386. <a href="#external-secrets.io/v1.VaultProvider">
  12387. VaultProvider
  12388. </a>
  12389. </em>
  12390. </td>
  12391. <td>
  12392. <em>(Optional)</em>
  12393. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  12394. </td>
  12395. </tr>
  12396. <tr>
  12397. <td>
  12398. <code>ovh</code></br>
  12399. <em>
  12400. <a href="#external-secrets.io/v1.OvhProvider">
  12401. OvhProvider
  12402. </a>
  12403. </em>
  12404. </td>
  12405. <td>
  12406. <em>(Optional)</em>
  12407. <p>OVHcloud configures this store to sync secrets using the OVHcloud provider.</p>
  12408. </td>
  12409. </tr>
  12410. <tr>
  12411. <td>
  12412. <code>gcpsm</code></br>
  12413. <em>
  12414. <a href="#external-secrets.io/v1.GCPSMProvider">
  12415. GCPSMProvider
  12416. </a>
  12417. </em>
  12418. </td>
  12419. <td>
  12420. <em>(Optional)</em>
  12421. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  12422. </td>
  12423. </tr>
  12424. <tr>
  12425. <td>
  12426. <code>oracle</code></br>
  12427. <em>
  12428. <a href="#external-secrets.io/v1.OracleProvider">
  12429. OracleProvider
  12430. </a>
  12431. </em>
  12432. </td>
  12433. <td>
  12434. <em>(Optional)</em>
  12435. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  12436. </td>
  12437. </tr>
  12438. <tr>
  12439. <td>
  12440. <code>ibm</code></br>
  12441. <em>
  12442. <a href="#external-secrets.io/v1.IBMProvider">
  12443. IBMProvider
  12444. </a>
  12445. </em>
  12446. </td>
  12447. <td>
  12448. <em>(Optional)</em>
  12449. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  12450. </td>
  12451. </tr>
  12452. <tr>
  12453. <td>
  12454. <code>yandexcertificatemanager</code></br>
  12455. <em>
  12456. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">
  12457. YandexCertificateManagerProvider
  12458. </a>
  12459. </em>
  12460. </td>
  12461. <td>
  12462. <em>(Optional)</em>
  12463. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  12464. </td>
  12465. </tr>
  12466. <tr>
  12467. <td>
  12468. <code>yandexlockbox</code></br>
  12469. <em>
  12470. <a href="#external-secrets.io/v1.YandexLockboxProvider">
  12471. YandexLockboxProvider
  12472. </a>
  12473. </em>
  12474. </td>
  12475. <td>
  12476. <em>(Optional)</em>
  12477. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  12478. </td>
  12479. </tr>
  12480. <tr>
  12481. <td>
  12482. <code>github</code></br>
  12483. <em>
  12484. <a href="#external-secrets.io/v1.GithubProvider">
  12485. GithubProvider
  12486. </a>
  12487. </em>
  12488. </td>
  12489. <td>
  12490. <em>(Optional)</em>
  12491. <p>Github configures this store to push GitHub Actions or Dependabot secrets using the GitHub API provider.
  12492. Note: This provider only supports write operations (PushSecret) and cannot fetch secrets from GitHub</p>
  12493. </td>
  12494. </tr>
  12495. <tr>
  12496. <td>
  12497. <code>gitlab</code></br>
  12498. <em>
  12499. <a href="#external-secrets.io/v1.GitlabProvider">
  12500. GitlabProvider
  12501. </a>
  12502. </em>
  12503. </td>
  12504. <td>
  12505. <em>(Optional)</em>
  12506. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  12507. </td>
  12508. </tr>
  12509. <tr>
  12510. <td>
  12511. <code>onepassword</code></br>
  12512. <em>
  12513. <a href="#external-secrets.io/v1.OnePasswordProvider">
  12514. OnePasswordProvider
  12515. </a>
  12516. </em>
  12517. </td>
  12518. <td>
  12519. <em>(Optional)</em>
  12520. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  12521. </td>
  12522. </tr>
  12523. <tr>
  12524. <td>
  12525. <code>onepasswordSDK</code></br>
  12526. <em>
  12527. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">
  12528. OnePasswordSDKProvider
  12529. </a>
  12530. </em>
  12531. </td>
  12532. <td>
  12533. <em>(Optional)</em>
  12534. <p>OnePasswordSDK configures this store to use 1Password&rsquo;s new Go SDK to sync secrets.</p>
  12535. </td>
  12536. </tr>
  12537. <tr>
  12538. <td>
  12539. <code>webhook</code></br>
  12540. <em>
  12541. <a href="#external-secrets.io/v1.WebhookProvider">
  12542. WebhookProvider
  12543. </a>
  12544. </em>
  12545. </td>
  12546. <td>
  12547. <em>(Optional)</em>
  12548. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  12549. </td>
  12550. </tr>
  12551. <tr>
  12552. <td>
  12553. <code>kubernetes</code></br>
  12554. <em>
  12555. <a href="#external-secrets.io/v1.KubernetesProvider">
  12556. KubernetesProvider
  12557. </a>
  12558. </em>
  12559. </td>
  12560. <td>
  12561. <em>(Optional)</em>
  12562. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  12563. </td>
  12564. </tr>
  12565. <tr>
  12566. <td>
  12567. <code>crd</code></br>
  12568. <em>
  12569. <a href="#external-secrets.io/v1.CRDProvider">
  12570. CRDProvider
  12571. </a>
  12572. </em>
  12573. </td>
  12574. <td>
  12575. <em>(Optional)</em>
  12576. <p>CRD configures this store to sync secrets from arbitrary Kubernetes resources,
  12577. including both custom resources (CRDs) and core API resources. Resources are
  12578. selected by API group, version and kind, where group can be &ldquo;&rdquo; (empty string)
  12579. for core resources such as ConfigMap. Reading the core v1 Secret is
  12580. intentionally blocked — use the Kubernetes provider for that.</p>
  12581. </td>
  12582. </tr>
  12583. <tr>
  12584. <td>
  12585. <code>fake</code></br>
  12586. <em>
  12587. <a href="#external-secrets.io/v1.FakeProvider">
  12588. FakeProvider
  12589. </a>
  12590. </em>
  12591. </td>
  12592. <td>
  12593. <em>(Optional)</em>
  12594. <p>Fake configures a store with static key/value pairs</p>
  12595. </td>
  12596. </tr>
  12597. <tr>
  12598. <td>
  12599. <code>senhasegura</code></br>
  12600. <em>
  12601. <a href="#external-secrets.io/v1.SenhaseguraProvider">
  12602. SenhaseguraProvider
  12603. </a>
  12604. </em>
  12605. </td>
  12606. <td>
  12607. <em>(Optional)</em>
  12608. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  12609. </td>
  12610. </tr>
  12611. <tr>
  12612. <td>
  12613. <code>scaleway</code></br>
  12614. <em>
  12615. <a href="#external-secrets.io/v1.ScalewayProvider">
  12616. ScalewayProvider
  12617. </a>
  12618. </em>
  12619. </td>
  12620. <td>
  12621. <em>(Optional)</em>
  12622. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  12623. </td>
  12624. </tr>
  12625. <tr>
  12626. <td>
  12627. <code>doppler</code></br>
  12628. <em>
  12629. <a href="#external-secrets.io/v1.DopplerProvider">
  12630. DopplerProvider
  12631. </a>
  12632. </em>
  12633. </td>
  12634. <td>
  12635. <em>(Optional)</em>
  12636. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  12637. </td>
  12638. </tr>
  12639. <tr>
  12640. <td>
  12641. <code>previder</code></br>
  12642. <em>
  12643. <a href="#external-secrets.io/v1.PreviderProvider">
  12644. PreviderProvider
  12645. </a>
  12646. </em>
  12647. </td>
  12648. <td>
  12649. <em>(Optional)</em>
  12650. <p>Previder configures this store to sync secrets using the Previder provider</p>
  12651. </td>
  12652. </tr>
  12653. <tr>
  12654. <td>
  12655. <code>onboardbase</code></br>
  12656. <em>
  12657. <a href="#external-secrets.io/v1.OnboardbaseProvider">
  12658. OnboardbaseProvider
  12659. </a>
  12660. </em>
  12661. </td>
  12662. <td>
  12663. <em>(Optional)</em>
  12664. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  12665. </td>
  12666. </tr>
  12667. <tr>
  12668. <td>
  12669. <code>keepersecurity</code></br>
  12670. <em>
  12671. <a href="#external-secrets.io/v1.KeeperSecurityProvider">
  12672. KeeperSecurityProvider
  12673. </a>
  12674. </em>
  12675. </td>
  12676. <td>
  12677. <em>(Optional)</em>
  12678. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  12679. </td>
  12680. </tr>
  12681. <tr>
  12682. <td>
  12683. <code>conjur</code></br>
  12684. <em>
  12685. <a href="#external-secrets.io/v1.ConjurProvider">
  12686. ConjurProvider
  12687. </a>
  12688. </em>
  12689. </td>
  12690. <td>
  12691. <em>(Optional)</em>
  12692. <p>Conjur configures this store to sync secrets using conjur provider</p>
  12693. </td>
  12694. </tr>
  12695. <tr>
  12696. <td>
  12697. <code>delinea</code></br>
  12698. <em>
  12699. <a href="#external-secrets.io/v1.DelineaProvider">
  12700. DelineaProvider
  12701. </a>
  12702. </em>
  12703. </td>
  12704. <td>
  12705. <em>(Optional)</em>
  12706. <p>Delinea DevOps Secrets Vault
  12707. <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>
  12708. </td>
  12709. </tr>
  12710. <tr>
  12711. <td>
  12712. <code>secretserver</code></br>
  12713. <em>
  12714. <a href="#external-secrets.io/v1.SecretServerProvider">
  12715. SecretServerProvider
  12716. </a>
  12717. </em>
  12718. </td>
  12719. <td>
  12720. <em>(Optional)</em>
  12721. <p>SecretServer configures this store to sync secrets using SecretServer provider
  12722. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  12723. </td>
  12724. </tr>
  12725. <tr>
  12726. <td>
  12727. <code>chef</code></br>
  12728. <em>
  12729. <a href="#external-secrets.io/v1.ChefProvider">
  12730. ChefProvider
  12731. </a>
  12732. </em>
  12733. </td>
  12734. <td>
  12735. <em>(Optional)</em>
  12736. <p>Chef configures this store to sync secrets with chef server</p>
  12737. </td>
  12738. </tr>
  12739. <tr>
  12740. <td>
  12741. <code>pulumi</code></br>
  12742. <em>
  12743. <a href="#external-secrets.io/v1.PulumiProvider">
  12744. PulumiProvider
  12745. </a>
  12746. </em>
  12747. </td>
  12748. <td>
  12749. <em>(Optional)</em>
  12750. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  12751. </td>
  12752. </tr>
  12753. <tr>
  12754. <td>
  12755. <code>fortanix</code></br>
  12756. <em>
  12757. <a href="#external-secrets.io/v1.FortanixProvider">
  12758. FortanixProvider
  12759. </a>
  12760. </em>
  12761. </td>
  12762. <td>
  12763. <em>(Optional)</em>
  12764. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  12765. </td>
  12766. </tr>
  12767. <tr>
  12768. <td>
  12769. <code>passworddepot</code></br>
  12770. <em>
  12771. <a href="#external-secrets.io/v1.PasswordDepotProvider">
  12772. PasswordDepotProvider
  12773. </a>
  12774. </em>
  12775. </td>
  12776. <td>
  12777. <em>(Optional)</em>
  12778. </td>
  12779. </tr>
  12780. <tr>
  12781. <td>
  12782. <code>passbolt</code></br>
  12783. <em>
  12784. <a href="#external-secrets.io/v1.PassboltProvider">
  12785. PassboltProvider
  12786. </a>
  12787. </em>
  12788. </td>
  12789. <td>
  12790. <em>(Optional)</em>
  12791. </td>
  12792. </tr>
  12793. <tr>
  12794. <td>
  12795. <code>dvls</code></br>
  12796. <em>
  12797. <a href="#external-secrets.io/v1.DVLSProvider">
  12798. DVLSProvider
  12799. </a>
  12800. </em>
  12801. </td>
  12802. <td>
  12803. <em>(Optional)</em>
  12804. <p>DVLS configures this store to sync secrets using Devolutions Server provider</p>
  12805. </td>
  12806. </tr>
  12807. <tr>
  12808. <td>
  12809. <code>infisical</code></br>
  12810. <em>
  12811. <a href="#external-secrets.io/v1.InfisicalProvider">
  12812. InfisicalProvider
  12813. </a>
  12814. </em>
  12815. </td>
  12816. <td>
  12817. <em>(Optional)</em>
  12818. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  12819. </td>
  12820. </tr>
  12821. <tr>
  12822. <td>
  12823. <code>beyondtrust</code></br>
  12824. <em>
  12825. <a href="#external-secrets.io/v1.BeyondtrustProvider">
  12826. BeyondtrustProvider
  12827. </a>
  12828. </em>
  12829. </td>
  12830. <td>
  12831. <em>(Optional)</em>
  12832. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  12833. </td>
  12834. </tr>
  12835. <tr>
  12836. <td>
  12837. <code>beyondtrustworkloadcredentials</code></br>
  12838. <em>
  12839. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  12840. BeyondtrustWorkloadCredentialsProvider
  12841. </a>
  12842. </em>
  12843. </td>
  12844. <td>
  12845. <em>(Optional)</em>
  12846. <p>BeyondtrustWorkloadCredentials configures this store to sync secrets using the BeyondTrust Workload Credentials provider.</p>
  12847. </td>
  12848. </tr>
  12849. <tr>
  12850. <td>
  12851. <code>cloudrusm</code></br>
  12852. <em>
  12853. <a href="#external-secrets.io/v1.CloudruSMProvider">
  12854. CloudruSMProvider
  12855. </a>
  12856. </em>
  12857. </td>
  12858. <td>
  12859. <em>(Optional)</em>
  12860. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  12861. </td>
  12862. </tr>
  12863. <tr>
  12864. <td>
  12865. <code>volcengine</code></br>
  12866. <em>
  12867. <a href="#external-secrets.io/v1.VolcengineProvider">
  12868. VolcengineProvider
  12869. </a>
  12870. </em>
  12871. </td>
  12872. <td>
  12873. <em>(Optional)</em>
  12874. <p>Volcengine configures this store to sync secrets using the Volcengine provider</p>
  12875. </td>
  12876. </tr>
  12877. <tr>
  12878. <td>
  12879. <code>ngrok</code></br>
  12880. <em>
  12881. <a href="#external-secrets.io/v1.NgrokProvider">
  12882. NgrokProvider
  12883. </a>
  12884. </em>
  12885. </td>
  12886. <td>
  12887. <em>(Optional)</em>
  12888. <p>Ngrok configures this store to sync secrets using the ngrok provider.</p>
  12889. </td>
  12890. </tr>
  12891. <tr>
  12892. <td>
  12893. <code>barbican</code></br>
  12894. <em>
  12895. <a href="#external-secrets.io/v1.BarbicanProvider">
  12896. BarbicanProvider
  12897. </a>
  12898. </em>
  12899. </td>
  12900. <td>
  12901. <em>(Optional)</em>
  12902. <p>Barbican configures this store to sync secrets using the OpenStack Barbican provider</p>
  12903. </td>
  12904. </tr>
  12905. <tr>
  12906. <td>
  12907. <code>nebiusmysterybox</code></br>
  12908. <em>
  12909. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">
  12910. NebiusMysteryboxProvider
  12911. </a>
  12912. </em>
  12913. </td>
  12914. <td>
  12915. <em>(Optional)</em>
  12916. <p>NebiusMysterybox configures this store to sync secrets using NebiusMysterybox provider</p>
  12917. </td>
  12918. </tr>
  12919. <tr>
  12920. <td>
  12921. <code>openBao</code></br>
  12922. <em>
  12923. <a href="#external-secrets.io/v1.OpenBaoProvider">
  12924. OpenBaoProvider
  12925. </a>
  12926. </em>
  12927. </td>
  12928. <td>
  12929. <em>(Optional)</em>
  12930. <p>OpenBao configures this store to sync secrets using the OpenBao provider.</p>
  12931. </td>
  12932. </tr>
  12933. </tbody>
  12934. </table>
  12935. <h3 id="external-secrets.io/v1.SecretStoreRef">SecretStoreRef
  12936. </h3>
  12937. <p>
  12938. (<em>Appears on:</em>
  12939. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>,
  12940. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  12941. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>)
  12942. </p>
  12943. <p>
  12944. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  12945. </p>
  12946. <table>
  12947. <thead>
  12948. <tr>
  12949. <th>Field</th>
  12950. <th>Description</th>
  12951. </tr>
  12952. </thead>
  12953. <tbody>
  12954. <tr>
  12955. <td>
  12956. <code>name</code></br>
  12957. <em>
  12958. string
  12959. </em>
  12960. </td>
  12961. <td>
  12962. <p>Name of the SecretStore resource</p>
  12963. </td>
  12964. </tr>
  12965. <tr>
  12966. <td>
  12967. <code>kind</code></br>
  12968. <em>
  12969. string
  12970. </em>
  12971. </td>
  12972. <td>
  12973. <em>(Optional)</em>
  12974. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  12975. Defaults to <code>SecretStore</code></p>
  12976. </td>
  12977. </tr>
  12978. </tbody>
  12979. </table>
  12980. <h3 id="external-secrets.io/v1.SecretStoreRetrySettings">SecretStoreRetrySettings
  12981. </h3>
  12982. <p>
  12983. (<em>Appears on:</em>
  12984. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>,
  12985. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec</a>,
  12986. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  12987. </p>
  12988. <p>
  12989. <p>SecretStoreRetrySettings defines the retry settings for accessing external secrets manager stores.</p>
  12990. </p>
  12991. <table>
  12992. <thead>
  12993. <tr>
  12994. <th>Field</th>
  12995. <th>Description</th>
  12996. </tr>
  12997. </thead>
  12998. <tbody>
  12999. <tr>
  13000. <td>
  13001. <code>maxRetries</code></br>
  13002. <em>
  13003. int32
  13004. </em>
  13005. </td>
  13006. <td>
  13007. </td>
  13008. </tr>
  13009. <tr>
  13010. <td>
  13011. <code>retryInterval</code></br>
  13012. <em>
  13013. string
  13014. </em>
  13015. </td>
  13016. <td>
  13017. </td>
  13018. </tr>
  13019. </tbody>
  13020. </table>
  13021. <h3 id="external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec
  13022. </h3>
  13023. <p>
  13024. (<em>Appears on:</em>
  13025. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  13026. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  13027. </p>
  13028. <p>
  13029. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  13030. </p>
  13031. <table>
  13032. <thead>
  13033. <tr>
  13034. <th>Field</th>
  13035. <th>Description</th>
  13036. </tr>
  13037. </thead>
  13038. <tbody>
  13039. <tr>
  13040. <td>
  13041. <code>controller</code></br>
  13042. <em>
  13043. string
  13044. </em>
  13045. </td>
  13046. <td>
  13047. <em>(Optional)</em>
  13048. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  13049. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  13050. </td>
  13051. </tr>
  13052. <tr>
  13053. <td>
  13054. <code>provider</code></br>
  13055. <em>
  13056. <a href="#external-secrets.io/v1.SecretStoreProvider">
  13057. SecretStoreProvider
  13058. </a>
  13059. </em>
  13060. </td>
  13061. <td>
  13062. <p>Used to configure the provider. Only one provider may be set</p>
  13063. </td>
  13064. </tr>
  13065. <tr>
  13066. <td>
  13067. <code>retrySettings</code></br>
  13068. <em>
  13069. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  13070. SecretStoreRetrySettings
  13071. </a>
  13072. </em>
  13073. </td>
  13074. <td>
  13075. <em>(Optional)</em>
  13076. <p>Used to configure HTTP retries on failures.</p>
  13077. </td>
  13078. </tr>
  13079. <tr>
  13080. <td>
  13081. <code>refreshInterval</code></br>
  13082. <em>
  13083. k8s.io/apimachinery/pkg/util/intstr.IntOrString
  13084. </em>
  13085. </td>
  13086. <td>
  13087. <em>(Optional)</em>
  13088. <p>Used to configure store refresh interval. Accepts either an integer number
  13089. of seconds (legacy) or a Go duration string such as &ldquo;1h&rdquo; or &ldquo;5m&rdquo;. Empty or
  13090. 0 will default to the controller config.</p>
  13091. </td>
  13092. </tr>
  13093. <tr>
  13094. <td>
  13095. <code>conditions</code></br>
  13096. <em>
  13097. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  13098. []ClusterSecretStoreCondition
  13099. </a>
  13100. </em>
  13101. </td>
  13102. <td>
  13103. <em>(Optional)</em>
  13104. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  13105. </td>
  13106. </tr>
  13107. </tbody>
  13108. </table>
  13109. <h3 id="external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus
  13110. </h3>
  13111. <p>
  13112. (<em>Appears on:</em>
  13113. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  13114. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  13115. </p>
  13116. <p>
  13117. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  13118. </p>
  13119. <table>
  13120. <thead>
  13121. <tr>
  13122. <th>Field</th>
  13123. <th>Description</th>
  13124. </tr>
  13125. </thead>
  13126. <tbody>
  13127. <tr>
  13128. <td>
  13129. <code>conditions</code></br>
  13130. <em>
  13131. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">
  13132. []SecretStoreStatusCondition
  13133. </a>
  13134. </em>
  13135. </td>
  13136. <td>
  13137. <em>(Optional)</em>
  13138. </td>
  13139. </tr>
  13140. <tr>
  13141. <td>
  13142. <code>capabilities</code></br>
  13143. <em>
  13144. <a href="#external-secrets.io/v1.SecretStoreCapabilities">
  13145. SecretStoreCapabilities
  13146. </a>
  13147. </em>
  13148. </td>
  13149. <td>
  13150. <em>(Optional)</em>
  13151. </td>
  13152. </tr>
  13153. </tbody>
  13154. </table>
  13155. <h3 id="external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition
  13156. </h3>
  13157. <p>
  13158. (<em>Appears on:</em>
  13159. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  13160. </p>
  13161. <p>
  13162. <p>SecretStoreStatusCondition contains condition information for a SecretStore.</p>
  13163. </p>
  13164. <table>
  13165. <thead>
  13166. <tr>
  13167. <th>Field</th>
  13168. <th>Description</th>
  13169. </tr>
  13170. </thead>
  13171. <tbody>
  13172. <tr>
  13173. <td>
  13174. <code>type</code></br>
  13175. <em>
  13176. <a href="#external-secrets.io/v1.SecretStoreConditionType">
  13177. SecretStoreConditionType
  13178. </a>
  13179. </em>
  13180. </td>
  13181. <td>
  13182. </td>
  13183. </tr>
  13184. <tr>
  13185. <td>
  13186. <code>status</code></br>
  13187. <em>
  13188. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  13189. Kubernetes core/v1.ConditionStatus
  13190. </a>
  13191. </em>
  13192. </td>
  13193. <td>
  13194. </td>
  13195. </tr>
  13196. <tr>
  13197. <td>
  13198. <code>reason</code></br>
  13199. <em>
  13200. string
  13201. </em>
  13202. </td>
  13203. <td>
  13204. <em>(Optional)</em>
  13205. </td>
  13206. </tr>
  13207. <tr>
  13208. <td>
  13209. <code>message</code></br>
  13210. <em>
  13211. string
  13212. </em>
  13213. </td>
  13214. <td>
  13215. <em>(Optional)</em>
  13216. </td>
  13217. </tr>
  13218. <tr>
  13219. <td>
  13220. <code>lastTransitionTime</code></br>
  13221. <em>
  13222. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  13223. Kubernetes meta/v1.Time
  13224. </a>
  13225. </em>
  13226. </td>
  13227. <td>
  13228. <em>(Optional)</em>
  13229. </td>
  13230. </tr>
  13231. </tbody>
  13232. </table>
  13233. <h3 id="external-secrets.io/v1.SecretVersionSelectionPolicy">SecretVersionSelectionPolicy
  13234. (<code>string</code> alias)</p></h3>
  13235. <p>
  13236. (<em>Appears on:</em>
  13237. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  13238. </p>
  13239. <p>
  13240. <p>SecretVersionSelectionPolicy defines the policy for selecting secret versions in GCP Secret Manager.</p>
  13241. </p>
  13242. <table>
  13243. <thead>
  13244. <tr>
  13245. <th>Value</th>
  13246. <th>Description</th>
  13247. </tr>
  13248. </thead>
  13249. <tbody><tr><td><p>&#34;LatestOrFail&#34;</p></td>
  13250. <td><p>SecretVersionSelectionPolicyLatestOrFail means the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.</p>
  13251. </td>
  13252. </tr><tr><td><p>&#34;LatestOrFetch&#34;</p></td>
  13253. <td><p>SecretVersionSelectionPolicyLatestOrFetch behaves like SecretVersionSelectionPolicyLatestOrFail but falls back to fetching the latest version if the version is DESTROYED or DISABLED.</p>
  13254. </td>
  13255. </tr></tbody>
  13256. </table>
  13257. <h3 id="external-secrets.io/v1.SecretsClient">SecretsClient
  13258. </h3>
  13259. <p>
  13260. <p>SecretsClient provides access to secrets.</p>
  13261. </p>
  13262. <h3 id="external-secrets.io/v1.SecretsManager">SecretsManager
  13263. </h3>
  13264. <p>
  13265. (<em>Appears on:</em>
  13266. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  13267. </p>
  13268. <p>
  13269. <p>SecretsManager defines how the provider behaves when interacting with AWS
  13270. SecretsManager. Some of these settings are only applicable to controlling how
  13271. secrets are deleted, and hence only apply to PushSecret (and only when
  13272. deletionPolicy is set to Delete).</p>
  13273. </p>
  13274. <table>
  13275. <thead>
  13276. <tr>
  13277. <th>Field</th>
  13278. <th>Description</th>
  13279. </tr>
  13280. </thead>
  13281. <tbody>
  13282. <tr>
  13283. <td>
  13284. <code>forceDeleteWithoutRecovery</code></br>
  13285. <em>
  13286. bool
  13287. </em>
  13288. </td>
  13289. <td>
  13290. <em>(Optional)</em>
  13291. <p>Specifies whether to delete the secret without any recovery window. You
  13292. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  13293. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  13294. recovery window.
  13295. 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>
  13296. </td>
  13297. </tr>
  13298. <tr>
  13299. <td>
  13300. <code>recoveryWindowInDays</code></br>
  13301. <em>
  13302. int64
  13303. </em>
  13304. </td>
  13305. <td>
  13306. <em>(Optional)</em>
  13307. <p>The number of days from 7 to 30 that Secrets Manager waits before
  13308. permanently deleting the secret. You can&rsquo;t use both this parameter and
  13309. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  13310. then by default Secrets Manager uses a 30-day recovery window.
  13311. 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>
  13312. </td>
  13313. </tr>
  13314. </tbody>
  13315. </table>
  13316. <h3 id="external-secrets.io/v1.SenhaseguraAuth">SenhaseguraAuth
  13317. </h3>
  13318. <p>
  13319. (<em>Appears on:</em>
  13320. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  13321. </p>
  13322. <p>
  13323. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  13324. </p>
  13325. <table>
  13326. <thead>
  13327. <tr>
  13328. <th>Field</th>
  13329. <th>Description</th>
  13330. </tr>
  13331. </thead>
  13332. <tbody>
  13333. <tr>
  13334. <td>
  13335. <code>clientId</code></br>
  13336. <em>
  13337. string
  13338. </em>
  13339. </td>
  13340. <td>
  13341. </td>
  13342. </tr>
  13343. <tr>
  13344. <td>
  13345. <code>clientSecretSecretRef</code></br>
  13346. <em>
  13347. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13348. External Secrets meta/v1.SecretKeySelector
  13349. </a>
  13350. </em>
  13351. </td>
  13352. <td>
  13353. </td>
  13354. </tr>
  13355. </tbody>
  13356. </table>
  13357. <h3 id="external-secrets.io/v1.SenhaseguraModuleType">SenhaseguraModuleType
  13358. (<code>string</code> alias)</p></h3>
  13359. <p>
  13360. (<em>Appears on:</em>
  13361. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  13362. </p>
  13363. <p>
  13364. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  13365. </p>
  13366. <table>
  13367. <thead>
  13368. <tr>
  13369. <th>Value</th>
  13370. <th>Description</th>
  13371. </tr>
  13372. </thead>
  13373. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  13374. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  13375. see: https://senhasegura.com/devops
  13376. </code></pre>
  13377. </td>
  13378. </tr></tbody>
  13379. </table>
  13380. <h3 id="external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider
  13381. </h3>
  13382. <p>
  13383. (<em>Appears on:</em>
  13384. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  13385. </p>
  13386. <p>
  13387. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  13388. </p>
  13389. <table>
  13390. <thead>
  13391. <tr>
  13392. <th>Field</th>
  13393. <th>Description</th>
  13394. </tr>
  13395. </thead>
  13396. <tbody>
  13397. <tr>
  13398. <td>
  13399. <code>url</code></br>
  13400. <em>
  13401. string
  13402. </em>
  13403. </td>
  13404. <td>
  13405. <p>URL of senhasegura</p>
  13406. </td>
  13407. </tr>
  13408. <tr>
  13409. <td>
  13410. <code>module</code></br>
  13411. <em>
  13412. <a href="#external-secrets.io/v1.SenhaseguraModuleType">
  13413. SenhaseguraModuleType
  13414. </a>
  13415. </em>
  13416. </td>
  13417. <td>
  13418. <p>Module defines which senhasegura module should be used to get secrets</p>
  13419. </td>
  13420. </tr>
  13421. <tr>
  13422. <td>
  13423. <code>auth</code></br>
  13424. <em>
  13425. <a href="#external-secrets.io/v1.SenhaseguraAuth">
  13426. SenhaseguraAuth
  13427. </a>
  13428. </em>
  13429. </td>
  13430. <td>
  13431. <p>Auth defines parameters to authenticate in senhasegura</p>
  13432. </td>
  13433. </tr>
  13434. <tr>
  13435. <td>
  13436. <code>ignoreSslCertificate</code></br>
  13437. <em>
  13438. bool
  13439. </em>
  13440. </td>
  13441. <td>
  13442. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  13443. </td>
  13444. </tr>
  13445. </tbody>
  13446. </table>
  13447. <h3 id="external-secrets.io/v1.SessionTagsPolicy">SessionTagsPolicy
  13448. (<code>string</code> alias)</p></h3>
  13449. <p>
  13450. (<em>Appears on:</em>
  13451. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  13452. </p>
  13453. <p>
  13454. <p>SessionTagsPolicy defines how STS session tags are handled.</p>
  13455. </p>
  13456. <table>
  13457. <thead>
  13458. <tr>
  13459. <th>Value</th>
  13460. <th>Description</th>
  13461. </tr>
  13462. </thead>
  13463. <tbody><tr><td><p>&#34;Custom&#34;</p></td>
  13464. <td><p>SessionTagsPolicyCustom adds the tags defined in CustomSessionTags in addition to
  13465. the esoNamespace, esoStoreName, and esoStoreKind tags.</p>
  13466. </td>
  13467. </tr><tr><td><p>&#34;None&#34;</p></td>
  13468. <td><p>SessionTagsPolicyNone is the default behavior - no session tags are added.</p>
  13469. </td>
  13470. </tr><tr><td><p>&#34;Simple&#34;</p></td>
  13471. <td><p>SessionTagsPolicySimple automatically adds esoNamespace, esoStoreName, and esoStoreKind
  13472. session tags.</p>
  13473. </td>
  13474. </tr></tbody>
  13475. </table>
  13476. <h3 id="external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  13477. </h3>
  13478. <p>
  13479. (<em>Appears on:</em>
  13480. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  13481. </p>
  13482. <p>
  13483. <p>StoreGeneratorSourceRef allows you to override the source
  13484. from which the secret will be pulled from.
  13485. You can define at maximum one property.</p>
  13486. </p>
  13487. <table>
  13488. <thead>
  13489. <tr>
  13490. <th>Field</th>
  13491. <th>Description</th>
  13492. </tr>
  13493. </thead>
  13494. <tbody>
  13495. <tr>
  13496. <td>
  13497. <code>storeRef</code></br>
  13498. <em>
  13499. <a href="#external-secrets.io/v1.SecretStoreRef">
  13500. SecretStoreRef
  13501. </a>
  13502. </em>
  13503. </td>
  13504. <td>
  13505. <em>(Optional)</em>
  13506. </td>
  13507. </tr>
  13508. <tr>
  13509. <td>
  13510. <code>generatorRef</code></br>
  13511. <em>
  13512. <a href="#external-secrets.io/v1.GeneratorRef">
  13513. GeneratorRef
  13514. </a>
  13515. </em>
  13516. </td>
  13517. <td>
  13518. <em>(Optional)</em>
  13519. <p>GeneratorRef points to a generator custom resource.</p>
  13520. </td>
  13521. </tr>
  13522. </tbody>
  13523. </table>
  13524. <h3 id="external-secrets.io/v1.StoreSourceRef">StoreSourceRef
  13525. </h3>
  13526. <p>
  13527. (<em>Appears on:</em>
  13528. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>)
  13529. </p>
  13530. <p>
  13531. <p>StoreSourceRef allows you to override the SecretStore source
  13532. from which the secret will be pulled from.
  13533. You can define at maximum one property.</p>
  13534. </p>
  13535. <table>
  13536. <thead>
  13537. <tr>
  13538. <th>Field</th>
  13539. <th>Description</th>
  13540. </tr>
  13541. </thead>
  13542. <tbody>
  13543. <tr>
  13544. <td>
  13545. <code>storeRef</code></br>
  13546. <em>
  13547. <a href="#external-secrets.io/v1.SecretStoreRef">
  13548. SecretStoreRef
  13549. </a>
  13550. </em>
  13551. </td>
  13552. <td>
  13553. <em>(Optional)</em>
  13554. </td>
  13555. </tr>
  13556. <tr>
  13557. <td>
  13558. <code>generatorRef</code></br>
  13559. <em>
  13560. <a href="#external-secrets.io/v1.GeneratorRef">
  13561. GeneratorRef
  13562. </a>
  13563. </em>
  13564. </td>
  13565. <td>
  13566. <p>GeneratorRef points to a generator custom resource.</p>
  13567. <p>Deprecated: The generatorRef is not implemented in .data[].
  13568. this will be removed with v1.</p>
  13569. </td>
  13570. </tr>
  13571. </tbody>
  13572. </table>
  13573. <h3 id="external-secrets.io/v1.Tag">Tag
  13574. </h3>
  13575. <p>
  13576. <p>Tag is a key-value pair that can be attached to an AWS resource.
  13577. 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>
  13578. </p>
  13579. <table>
  13580. <thead>
  13581. <tr>
  13582. <th>Field</th>
  13583. <th>Description</th>
  13584. </tr>
  13585. </thead>
  13586. <tbody>
  13587. <tr>
  13588. <td>
  13589. <code>key</code></br>
  13590. <em>
  13591. string
  13592. </em>
  13593. </td>
  13594. <td>
  13595. </td>
  13596. </tr>
  13597. <tr>
  13598. <td>
  13599. <code>value</code></br>
  13600. <em>
  13601. string
  13602. </em>
  13603. </td>
  13604. <td>
  13605. </td>
  13606. </tr>
  13607. </tbody>
  13608. </table>
  13609. <h3 id="external-secrets.io/v1.TemplateEngineVersion">TemplateEngineVersion
  13610. (<code>string</code> alias)</p></h3>
  13611. <p>
  13612. (<em>Appears on:</em>
  13613. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  13614. </p>
  13615. <p>
  13616. <p>TemplateEngineVersion specifies the template engine version that should be used to
  13617. compile/execute the template.</p>
  13618. </p>
  13619. <table>
  13620. <thead>
  13621. <tr>
  13622. <th>Value</th>
  13623. <th>Description</th>
  13624. </tr>
  13625. </thead>
  13626. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  13627. <td><p>TemplateEngineV2 is the currently supported template engine version.</p>
  13628. </td>
  13629. </tr></tbody>
  13630. </table>
  13631. <h3 id="external-secrets.io/v1.TemplateFrom">TemplateFrom
  13632. </h3>
  13633. <p>
  13634. (<em>Appears on:</em>
  13635. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  13636. </p>
  13637. <p>
  13638. <p>TemplateFrom specifies a source for templates.
  13639. Each item in the list can either reference a ConfigMap or a Secret resource.</p>
  13640. </p>
  13641. <table>
  13642. <thead>
  13643. <tr>
  13644. <th>Field</th>
  13645. <th>Description</th>
  13646. </tr>
  13647. </thead>
  13648. <tbody>
  13649. <tr>
  13650. <td>
  13651. <code>configMap</code></br>
  13652. <em>
  13653. <a href="#external-secrets.io/v1.TemplateRef">
  13654. TemplateRef
  13655. </a>
  13656. </em>
  13657. </td>
  13658. <td>
  13659. </td>
  13660. </tr>
  13661. <tr>
  13662. <td>
  13663. <code>secret</code></br>
  13664. <em>
  13665. <a href="#external-secrets.io/v1.TemplateRef">
  13666. TemplateRef
  13667. </a>
  13668. </em>
  13669. </td>
  13670. <td>
  13671. </td>
  13672. </tr>
  13673. <tr>
  13674. <td>
  13675. <code>target</code></br>
  13676. <em>
  13677. string
  13678. </em>
  13679. </td>
  13680. <td>
  13681. <em>(Optional)</em>
  13682. <p>Target specifies where to place the template result.
  13683. For Secret resources the accepted values are empty, &ldquo;Data&rdquo;, &ldquo;Annotations&rdquo; and &ldquo;Labels&rdquo;;
  13684. any other value is rejected because it would allow writes to privileged Secret fields.
  13685. For custom resources (when spec.target.manifest is set), this supports
  13686. nested paths like &ldquo;spec.database.config&rdquo; or &ldquo;data&rdquo;.</p>
  13687. </td>
  13688. </tr>
  13689. <tr>
  13690. <td>
  13691. <code>literal</code></br>
  13692. <em>
  13693. string
  13694. </em>
  13695. </td>
  13696. <td>
  13697. <em>(Optional)</em>
  13698. </td>
  13699. </tr>
  13700. <tr>
  13701. <td>
  13702. <code>valuesDecodingStrategy</code></br>
  13703. <em>
  13704. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  13705. ExternalSecretDecodingStrategy
  13706. </a>
  13707. </em>
  13708. </td>
  13709. <td>
  13710. <em>(Optional)</em>
  13711. <p>Used to define a decoding Strategy for the rendered template values.
  13712. Defaults to None when omitted.</p>
  13713. </td>
  13714. </tr>
  13715. </tbody>
  13716. </table>
  13717. <h3 id="external-secrets.io/v1.TemplateMergePolicy">TemplateMergePolicy
  13718. (<code>string</code> alias)</p></h3>
  13719. <p>
  13720. (<em>Appears on:</em>
  13721. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  13722. </p>
  13723. <p>
  13724. <p>TemplateMergePolicy defines how the rendered template should be merged with the existing Secret data.</p>
  13725. </p>
  13726. <table>
  13727. <thead>
  13728. <tr>
  13729. <th>Value</th>
  13730. <th>Description</th>
  13731. </tr>
  13732. </thead>
  13733. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  13734. <td></td>
  13735. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  13736. <td></td>
  13737. </tr></tbody>
  13738. </table>
  13739. <h3 id="external-secrets.io/v1.TemplateRef">TemplateRef
  13740. </h3>
  13741. <p>
  13742. (<em>Appears on:</em>
  13743. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  13744. </p>
  13745. <p>
  13746. <p>TemplateRef specifies a reference to either a ConfigMap or a Secret resource.</p>
  13747. </p>
  13748. <table>
  13749. <thead>
  13750. <tr>
  13751. <th>Field</th>
  13752. <th>Description</th>
  13753. </tr>
  13754. </thead>
  13755. <tbody>
  13756. <tr>
  13757. <td>
  13758. <code>name</code></br>
  13759. <em>
  13760. string
  13761. </em>
  13762. </td>
  13763. <td>
  13764. <p>The name of the ConfigMap/Secret resource</p>
  13765. </td>
  13766. </tr>
  13767. <tr>
  13768. <td>
  13769. <code>items</code></br>
  13770. <em>
  13771. <a href="#external-secrets.io/v1.TemplateRefItem">
  13772. []TemplateRefItem
  13773. </a>
  13774. </em>
  13775. </td>
  13776. <td>
  13777. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  13778. </td>
  13779. </tr>
  13780. </tbody>
  13781. </table>
  13782. <h3 id="external-secrets.io/v1.TemplateRefItem">TemplateRefItem
  13783. </h3>
  13784. <p>
  13785. (<em>Appears on:</em>
  13786. <a href="#external-secrets.io/v1.TemplateRef">TemplateRef</a>)
  13787. </p>
  13788. <p>
  13789. <p>TemplateRefItem specifies a key in the ConfigMap/Secret to use as a template for Secret data.</p>
  13790. </p>
  13791. <table>
  13792. <thead>
  13793. <tr>
  13794. <th>Field</th>
  13795. <th>Description</th>
  13796. </tr>
  13797. </thead>
  13798. <tbody>
  13799. <tr>
  13800. <td>
  13801. <code>key</code></br>
  13802. <em>
  13803. string
  13804. </em>
  13805. </td>
  13806. <td>
  13807. <p>A key in the ConfigMap/Secret</p>
  13808. </td>
  13809. </tr>
  13810. <tr>
  13811. <td>
  13812. <code>templateAs</code></br>
  13813. <em>
  13814. <a href="#external-secrets.io/v1.TemplateScope">
  13815. TemplateScope
  13816. </a>
  13817. </em>
  13818. </td>
  13819. <td>
  13820. </td>
  13821. </tr>
  13822. </tbody>
  13823. </table>
  13824. <h3 id="external-secrets.io/v1.TemplateScope">TemplateScope
  13825. (<code>string</code> alias)</p></h3>
  13826. <p>
  13827. (<em>Appears on:</em>
  13828. <a href="#external-secrets.io/v1.TemplateRefItem">TemplateRefItem</a>)
  13829. </p>
  13830. <p>
  13831. <p>TemplateScope specifies how the template keys should be interpreted.</p>
  13832. </p>
  13833. <table>
  13834. <thead>
  13835. <tr>
  13836. <th>Value</th>
  13837. <th>Description</th>
  13838. </tr>
  13839. </thead>
  13840. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  13841. <td></td>
  13842. </tr><tr><td><p>&#34;Values&#34;</p></td>
  13843. <td></td>
  13844. </tr></tbody>
  13845. </table>
  13846. <h3 id="external-secrets.io/v1.TokenAuth">TokenAuth
  13847. </h3>
  13848. <p>
  13849. (<em>Appears on:</em>
  13850. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  13851. </p>
  13852. <p>
  13853. <p>TokenAuth defines token-based authentication configuration for Kubernetes.</p>
  13854. </p>
  13855. <table>
  13856. <thead>
  13857. <tr>
  13858. <th>Field</th>
  13859. <th>Description</th>
  13860. </tr>
  13861. </thead>
  13862. <tbody>
  13863. <tr>
  13864. <td>
  13865. <code>bearerToken</code></br>
  13866. <em>
  13867. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13868. External Secrets meta/v1.SecretKeySelector
  13869. </a>
  13870. </em>
  13871. </td>
  13872. <td>
  13873. </td>
  13874. </tr>
  13875. </tbody>
  13876. </table>
  13877. <h3 id="external-secrets.io/v1.TokenAuthCredentials">TokenAuthCredentials
  13878. </h3>
  13879. <p>
  13880. (<em>Appears on:</em>
  13881. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  13882. </p>
  13883. <p>
  13884. <p>TokenAuthCredentials represents the credentials for access token-based authentication.</p>
  13885. </p>
  13886. <table>
  13887. <thead>
  13888. <tr>
  13889. <th>Field</th>
  13890. <th>Description</th>
  13891. </tr>
  13892. </thead>
  13893. <tbody>
  13894. <tr>
  13895. <td>
  13896. <code>accessToken</code></br>
  13897. <em>
  13898. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13899. External Secrets meta/v1.SecretKeySelector
  13900. </a>
  13901. </em>
  13902. </td>
  13903. <td>
  13904. </td>
  13905. </tr>
  13906. </tbody>
  13907. </table>
  13908. <h3 id="external-secrets.io/v1.UniversalAuthCredentials">UniversalAuthCredentials
  13909. </h3>
  13910. <p>
  13911. (<em>Appears on:</em>
  13912. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  13913. </p>
  13914. <p>
  13915. <p>UniversalAuthCredentials represents the client credentials for universal authentication.</p>
  13916. </p>
  13917. <table>
  13918. <thead>
  13919. <tr>
  13920. <th>Field</th>
  13921. <th>Description</th>
  13922. </tr>
  13923. </thead>
  13924. <tbody>
  13925. <tr>
  13926. <td>
  13927. <code>clientId</code></br>
  13928. <em>
  13929. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13930. External Secrets meta/v1.SecretKeySelector
  13931. </a>
  13932. </em>
  13933. </td>
  13934. <td>
  13935. </td>
  13936. </tr>
  13937. <tr>
  13938. <td>
  13939. <code>clientSecret</code></br>
  13940. <em>
  13941. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13942. External Secrets meta/v1.SecretKeySelector
  13943. </a>
  13944. </em>
  13945. </td>
  13946. <td>
  13947. </td>
  13948. </tr>
  13949. </tbody>
  13950. </table>
  13951. <h3 id="external-secrets.io/v1.ValidationResult">ValidationResult
  13952. (<code>byte</code> alias)</p></h3>
  13953. <p>
  13954. (<em>Appears on:</em>
  13955. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  13956. </p>
  13957. <p>
  13958. <p>ValidationResult is defined type for the number of validation results.</p>
  13959. </p>
  13960. <table>
  13961. <thead>
  13962. <tr>
  13963. <th>Value</th>
  13964. <th>Description</th>
  13965. </tr>
  13966. </thead>
  13967. <tbody><tr><td><p>2</p></td>
  13968. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  13969. </td>
  13970. </tr><tr><td><p>0</p></td>
  13971. <td><p>ValidationResultReady indicates that the client is configured correctly
  13972. and can be used.</p>
  13973. </td>
  13974. </tr><tr><td><p>1</p></td>
  13975. <td><p>ValidationResultUnknown indicates that the client can be used
  13976. but information is missing, and it can not be validated.</p>
  13977. </td>
  13978. </tr></tbody>
  13979. </table>
  13980. <h3 id="external-secrets.io/v1.VaultAppRole">VaultAppRole
  13981. </h3>
  13982. <p>
  13983. (<em>Appears on:</em>
  13984. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13985. </p>
  13986. <p>
  13987. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  13988. with the role and secret stored in a Kubernetes Secret resource.</p>
  13989. </p>
  13990. <table>
  13991. <thead>
  13992. <tr>
  13993. <th>Field</th>
  13994. <th>Description</th>
  13995. </tr>
  13996. </thead>
  13997. <tbody>
  13998. <tr>
  13999. <td>
  14000. <code>path</code></br>
  14001. <em>
  14002. string
  14003. </em>
  14004. </td>
  14005. <td>
  14006. <p>Path where the App Role authentication backend is mounted
  14007. in Vault, e.g: &ldquo;approle&rdquo;</p>
  14008. </td>
  14009. </tr>
  14010. <tr>
  14011. <td>
  14012. <code>roleId</code></br>
  14013. <em>
  14014. string
  14015. </em>
  14016. </td>
  14017. <td>
  14018. <em>(Optional)</em>
  14019. <p>RoleID configured in the App Role authentication backend when setting
  14020. up the authentication backend in Vault.</p>
  14021. </td>
  14022. </tr>
  14023. <tr>
  14024. <td>
  14025. <code>roleRef</code></br>
  14026. <em>
  14027. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14028. External Secrets meta/v1.SecretKeySelector
  14029. </a>
  14030. </em>
  14031. </td>
  14032. <td>
  14033. <em>(Optional)</em>
  14034. <p>Reference to a key in a Secret that contains the App Role ID used
  14035. to authenticate with Vault.
  14036. The <code>key</code> field must be specified and denotes which entry within the Secret
  14037. resource is used as the app role id.</p>
  14038. </td>
  14039. </tr>
  14040. <tr>
  14041. <td>
  14042. <code>secretRef</code></br>
  14043. <em>
  14044. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14045. External Secrets meta/v1.SecretKeySelector
  14046. </a>
  14047. </em>
  14048. </td>
  14049. <td>
  14050. <p>Reference to a key in a Secret that contains the App Role secret used
  14051. to authenticate with Vault.
  14052. The <code>key</code> field must be specified and denotes which entry within the Secret
  14053. resource is used as the app role secret.</p>
  14054. </td>
  14055. </tr>
  14056. </tbody>
  14057. </table>
  14058. <h3 id="external-secrets.io/v1.VaultAuth">VaultAuth
  14059. </h3>
  14060. <p>
  14061. (<em>Appears on:</em>
  14062. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  14063. </p>
  14064. <p>
  14065. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  14066. 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>
  14067. can be specified. A namespace to authenticate against can optionally be specified.</p>
  14068. </p>
  14069. <table>
  14070. <thead>
  14071. <tr>
  14072. <th>Field</th>
  14073. <th>Description</th>
  14074. </tr>
  14075. </thead>
  14076. <tbody>
  14077. <tr>
  14078. <td>
  14079. <code>namespace</code></br>
  14080. <em>
  14081. string
  14082. </em>
  14083. </td>
  14084. <td>
  14085. <em>(Optional)</em>
  14086. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  14087. Namespaces is a set of features within Vault Enterprise that allows
  14088. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  14089. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  14090. This will default to Vault.Namespace field if set, or empty otherwise</p>
  14091. </td>
  14092. </tr>
  14093. <tr>
  14094. <td>
  14095. <code>tokenSecretRef</code></br>
  14096. <em>
  14097. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14098. External Secrets meta/v1.SecretKeySelector
  14099. </a>
  14100. </em>
  14101. </td>
  14102. <td>
  14103. <em>(Optional)</em>
  14104. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  14105. </td>
  14106. </tr>
  14107. <tr>
  14108. <td>
  14109. <code>appRole</code></br>
  14110. <em>
  14111. <a href="#external-secrets.io/v1.VaultAppRole">
  14112. VaultAppRole
  14113. </a>
  14114. </em>
  14115. </td>
  14116. <td>
  14117. <em>(Optional)</em>
  14118. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  14119. with the role and secret stored in a Kubernetes Secret resource.</p>
  14120. </td>
  14121. </tr>
  14122. <tr>
  14123. <td>
  14124. <code>kubernetes</code></br>
  14125. <em>
  14126. <a href="#external-secrets.io/v1.VaultKubernetesAuth">
  14127. VaultKubernetesAuth
  14128. </a>
  14129. </em>
  14130. </td>
  14131. <td>
  14132. <em>(Optional)</em>
  14133. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  14134. token stored in the named Secret resource to the Vault server.</p>
  14135. </td>
  14136. </tr>
  14137. <tr>
  14138. <td>
  14139. <code>ldap</code></br>
  14140. <em>
  14141. <a href="#external-secrets.io/v1.VaultLdapAuth">
  14142. VaultLdapAuth
  14143. </a>
  14144. </em>
  14145. </td>
  14146. <td>
  14147. <em>(Optional)</em>
  14148. <p>Ldap authenticates with Vault by passing username/password pair using
  14149. the LDAP authentication method</p>
  14150. </td>
  14151. </tr>
  14152. <tr>
  14153. <td>
  14154. <code>jwt</code></br>
  14155. <em>
  14156. <a href="#external-secrets.io/v1.VaultJwtAuth">
  14157. VaultJwtAuth
  14158. </a>
  14159. </em>
  14160. </td>
  14161. <td>
  14162. <em>(Optional)</em>
  14163. <p>Jwt authenticates with Vault by passing role and JWT token using the
  14164. JWT/OIDC authentication method</p>
  14165. </td>
  14166. </tr>
  14167. <tr>
  14168. <td>
  14169. <code>cert</code></br>
  14170. <em>
  14171. <a href="#external-secrets.io/v1.VaultCertAuth">
  14172. VaultCertAuth
  14173. </a>
  14174. </em>
  14175. </td>
  14176. <td>
  14177. <em>(Optional)</em>
  14178. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  14179. Cert authentication method</p>
  14180. </td>
  14181. </tr>
  14182. <tr>
  14183. <td>
  14184. <code>iam</code></br>
  14185. <em>
  14186. <a href="#external-secrets.io/v1.VaultIamAuth">
  14187. VaultIamAuth
  14188. </a>
  14189. </em>
  14190. </td>
  14191. <td>
  14192. <em>(Optional)</em>
  14193. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  14194. AWS IAM authentication method</p>
  14195. </td>
  14196. </tr>
  14197. <tr>
  14198. <td>
  14199. <code>userPass</code></br>
  14200. <em>
  14201. <a href="#external-secrets.io/v1.VaultUserPassAuth">
  14202. VaultUserPassAuth
  14203. </a>
  14204. </em>
  14205. </td>
  14206. <td>
  14207. <em>(Optional)</em>
  14208. <p>UserPass authenticates with Vault by passing username/password pair</p>
  14209. </td>
  14210. </tr>
  14211. <tr>
  14212. <td>
  14213. <code>gcp</code></br>
  14214. <em>
  14215. <a href="#external-secrets.io/v1.VaultGCPAuth">
  14216. VaultGCPAuth
  14217. </a>
  14218. </em>
  14219. </td>
  14220. <td>
  14221. <em>(Optional)</em>
  14222. <p>Gcp authenticates with Vault using Google Cloud Platform authentication method
  14223. GCP authentication method</p>
  14224. </td>
  14225. </tr>
  14226. </tbody>
  14227. </table>
  14228. <h3 id="external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth
  14229. </h3>
  14230. <p>
  14231. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  14232. Only one of secretRef or jwt can be specified.
  14233. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  14234. </p>
  14235. <table>
  14236. <thead>
  14237. <tr>
  14238. <th>Field</th>
  14239. <th>Description</th>
  14240. </tr>
  14241. </thead>
  14242. <tbody>
  14243. <tr>
  14244. <td>
  14245. <code>secretRef</code></br>
  14246. <em>
  14247. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  14248. VaultAwsAuthSecretRef
  14249. </a>
  14250. </em>
  14251. </td>
  14252. <td>
  14253. <em>(Optional)</em>
  14254. </td>
  14255. </tr>
  14256. <tr>
  14257. <td>
  14258. <code>jwt</code></br>
  14259. <em>
  14260. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  14261. VaultAwsJWTAuth
  14262. </a>
  14263. </em>
  14264. </td>
  14265. <td>
  14266. <em>(Optional)</em>
  14267. </td>
  14268. </tr>
  14269. </tbody>
  14270. </table>
  14271. <h3 id="external-secrets.io/v1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  14272. </h3>
  14273. <p>
  14274. (<em>Appears on:</em>
  14275. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  14276. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  14277. </p>
  14278. <p>
  14279. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  14280. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  14281. </p>
  14282. <table>
  14283. <thead>
  14284. <tr>
  14285. <th>Field</th>
  14286. <th>Description</th>
  14287. </tr>
  14288. </thead>
  14289. <tbody>
  14290. <tr>
  14291. <td>
  14292. <code>accessKeyIDSecretRef</code></br>
  14293. <em>
  14294. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14295. External Secrets meta/v1.SecretKeySelector
  14296. </a>
  14297. </em>
  14298. </td>
  14299. <td>
  14300. <em>(Optional)</em>
  14301. <p>The AccessKeyID is used for authentication</p>
  14302. </td>
  14303. </tr>
  14304. <tr>
  14305. <td>
  14306. <code>secretAccessKeySecretRef</code></br>
  14307. <em>
  14308. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14309. External Secrets meta/v1.SecretKeySelector
  14310. </a>
  14311. </em>
  14312. </td>
  14313. <td>
  14314. <em>(Optional)</em>
  14315. <p>The SecretAccessKey is used for authentication</p>
  14316. </td>
  14317. </tr>
  14318. <tr>
  14319. <td>
  14320. <code>sessionTokenSecretRef</code></br>
  14321. <em>
  14322. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14323. External Secrets meta/v1.SecretKeySelector
  14324. </a>
  14325. </em>
  14326. </td>
  14327. <td>
  14328. <em>(Optional)</em>
  14329. <p>The SessionToken used for authentication
  14330. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  14331. 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>
  14332. </td>
  14333. </tr>
  14334. </tbody>
  14335. </table>
  14336. <h3 id="external-secrets.io/v1.VaultAwsJWTAuth">VaultAwsJWTAuth
  14337. </h3>
  14338. <p>
  14339. (<em>Appears on:</em>
  14340. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  14341. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  14342. </p>
  14343. <p>
  14344. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  14345. </p>
  14346. <table>
  14347. <thead>
  14348. <tr>
  14349. <th>Field</th>
  14350. <th>Description</th>
  14351. </tr>
  14352. </thead>
  14353. <tbody>
  14354. <tr>
  14355. <td>
  14356. <code>serviceAccountRef</code></br>
  14357. <em>
  14358. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14359. External Secrets meta/v1.ServiceAccountSelector
  14360. </a>
  14361. </em>
  14362. </td>
  14363. <td>
  14364. <em>(Optional)</em>
  14365. </td>
  14366. </tr>
  14367. </tbody>
  14368. </table>
  14369. <h3 id="external-secrets.io/v1.VaultCertAuth">VaultCertAuth
  14370. </h3>
  14371. <p>
  14372. (<em>Appears on:</em>
  14373. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14374. </p>
  14375. <p>
  14376. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  14377. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  14378. </p>
  14379. <table>
  14380. <thead>
  14381. <tr>
  14382. <th>Field</th>
  14383. <th>Description</th>
  14384. </tr>
  14385. </thead>
  14386. <tbody>
  14387. <tr>
  14388. <td>
  14389. <code>path</code></br>
  14390. <em>
  14391. string
  14392. </em>
  14393. </td>
  14394. <td>
  14395. <em>(Optional)</em>
  14396. <p>Path where the Certificate authentication backend is mounted
  14397. in Vault, e.g: &ldquo;cert&rdquo;</p>
  14398. </td>
  14399. </tr>
  14400. <tr>
  14401. <td>
  14402. <code>vaultRole</code></br>
  14403. <em>
  14404. string
  14405. </em>
  14406. </td>
  14407. <td>
  14408. <em>(Optional)</em>
  14409. <p>VaultRole specifies the Vault role to use for TLS certificate authentication.</p>
  14410. </td>
  14411. </tr>
  14412. <tr>
  14413. <td>
  14414. <code>clientCert</code></br>
  14415. <em>
  14416. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14417. External Secrets meta/v1.SecretKeySelector
  14418. </a>
  14419. </em>
  14420. </td>
  14421. <td>
  14422. <em>(Optional)</em>
  14423. <p>ClientCert is a certificate to authenticate using the Cert Vault
  14424. authentication method</p>
  14425. </td>
  14426. </tr>
  14427. <tr>
  14428. <td>
  14429. <code>secretRef</code></br>
  14430. <em>
  14431. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14432. External Secrets meta/v1.SecretKeySelector
  14433. </a>
  14434. </em>
  14435. </td>
  14436. <td>
  14437. <em>(Optional)</em>
  14438. <p>SecretRef to a key in a Secret resource containing client private key to
  14439. authenticate with Vault using the Cert authentication method</p>
  14440. </td>
  14441. </tr>
  14442. </tbody>
  14443. </table>
  14444. <h3 id="external-secrets.io/v1.VaultCheckAndSet">VaultCheckAndSet
  14445. </h3>
  14446. <p>
  14447. (<em>Appears on:</em>
  14448. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  14449. </p>
  14450. <p>
  14451. <p>VaultCheckAndSet defines the Check-And-Set (CAS) settings for Vault KV v2 PushSecret operations.</p>
  14452. </p>
  14453. <table>
  14454. <thead>
  14455. <tr>
  14456. <th>Field</th>
  14457. <th>Description</th>
  14458. </tr>
  14459. </thead>
  14460. <tbody>
  14461. <tr>
  14462. <td>
  14463. <code>required</code></br>
  14464. <em>
  14465. bool
  14466. </em>
  14467. </td>
  14468. <td>
  14469. <em>(Optional)</em>
  14470. <p>Required when true, all write operations must include a check-and-set parameter.
  14471. This helps prevent unintentional overwrites of secrets.</p>
  14472. </td>
  14473. </tr>
  14474. </tbody>
  14475. </table>
  14476. <h3 id="external-secrets.io/v1.VaultClientTLS">VaultClientTLS
  14477. </h3>
  14478. <p>
  14479. (<em>Appears on:</em>
  14480. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  14481. </p>
  14482. <p>
  14483. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  14484. when the Vault server requires mutual authentication.</p>
  14485. </p>
  14486. <table>
  14487. <thead>
  14488. <tr>
  14489. <th>Field</th>
  14490. <th>Description</th>
  14491. </tr>
  14492. </thead>
  14493. <tbody>
  14494. <tr>
  14495. <td>
  14496. <code>certSecretRef</code></br>
  14497. <em>
  14498. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14499. External Secrets meta/v1.SecretKeySelector
  14500. </a>
  14501. </em>
  14502. </td>
  14503. <td>
  14504. <em>(Optional)</em>
  14505. <p>CertSecretRef is a certificate added to the transport layer
  14506. when communicating with the Vault server.
  14507. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  14508. </td>
  14509. </tr>
  14510. <tr>
  14511. <td>
  14512. <code>keySecretRef</code></br>
  14513. <em>
  14514. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14515. External Secrets meta/v1.SecretKeySelector
  14516. </a>
  14517. </em>
  14518. </td>
  14519. <td>
  14520. <em>(Optional)</em>
  14521. <p>KeySecretRef to a key in a Secret resource containing client private key
  14522. added to the transport layer when communicating with the Vault server.
  14523. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  14524. </td>
  14525. </tr>
  14526. </tbody>
  14527. </table>
  14528. <h3 id="external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth
  14529. </h3>
  14530. <p>
  14531. (<em>Appears on:</em>
  14532. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14533. </p>
  14534. <p>
  14535. <p>VaultGCPAuth authenticates with Vault using Google Cloud Platform authentication method.
  14536. Refer: <a href="https://developer.hashicorp.com/vault/docs/auth/gcp">https://developer.hashicorp.com/vault/docs/auth/gcp</a></p>
  14537. <p>When ServiceAccountRef, SecretRef and WorkloadIdentity are not specified, the provider will use the controller pod&rsquo;s
  14538. identity to authenticate with GCP. This supports both GKE Workload Identity and service account keys.</p>
  14539. </p>
  14540. <table>
  14541. <thead>
  14542. <tr>
  14543. <th>Field</th>
  14544. <th>Description</th>
  14545. </tr>
  14546. </thead>
  14547. <tbody>
  14548. <tr>
  14549. <td>
  14550. <code>path</code></br>
  14551. <em>
  14552. string
  14553. </em>
  14554. </td>
  14555. <td>
  14556. <em>(Optional)</em>
  14557. <p>Path where the GCP auth method is enabled in Vault, e.g: &ldquo;gcp&rdquo;</p>
  14558. </td>
  14559. </tr>
  14560. <tr>
  14561. <td>
  14562. <code>role</code></br>
  14563. <em>
  14564. string
  14565. </em>
  14566. </td>
  14567. <td>
  14568. <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>
  14569. </td>
  14570. </tr>
  14571. <tr>
  14572. <td>
  14573. <code>projectID</code></br>
  14574. <em>
  14575. string
  14576. </em>
  14577. </td>
  14578. <td>
  14579. <em>(Optional)</em>
  14580. <p>Project ID of the Google Cloud Platform project</p>
  14581. </td>
  14582. </tr>
  14583. <tr>
  14584. <td>
  14585. <code>location</code></br>
  14586. <em>
  14587. string
  14588. </em>
  14589. </td>
  14590. <td>
  14591. <em>(Optional)</em>
  14592. <p>Location optionally defines a location/region for the secret</p>
  14593. </td>
  14594. </tr>
  14595. <tr>
  14596. <td>
  14597. <code>secretRef</code></br>
  14598. <em>
  14599. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  14600. GCPSMAuthSecretRef
  14601. </a>
  14602. </em>
  14603. </td>
  14604. <td>
  14605. <em>(Optional)</em>
  14606. <p>Specify credentials in a Secret object</p>
  14607. </td>
  14608. </tr>
  14609. <tr>
  14610. <td>
  14611. <code>workloadIdentity</code></br>
  14612. <em>
  14613. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  14614. GCPWorkloadIdentity
  14615. </a>
  14616. </em>
  14617. </td>
  14618. <td>
  14619. <em>(Optional)</em>
  14620. <p>Specify a service account with Workload Identity</p>
  14621. </td>
  14622. </tr>
  14623. <tr>
  14624. <td>
  14625. <code>serviceAccountRef</code></br>
  14626. <em>
  14627. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14628. External Secrets meta/v1.ServiceAccountSelector
  14629. </a>
  14630. </em>
  14631. </td>
  14632. <td>
  14633. <em>(Optional)</em>
  14634. <p>ServiceAccountRef to a service account for impersonation</p>
  14635. </td>
  14636. </tr>
  14637. </tbody>
  14638. </table>
  14639. <h3 id="external-secrets.io/v1.VaultIamAuth">VaultIamAuth
  14640. </h3>
  14641. <p>
  14642. (<em>Appears on:</em>
  14643. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14644. </p>
  14645. <p>
  14646. <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>
  14647. <p>When JWTAuth and SecretRef are not specified, the provider will use the controller pod&rsquo;s
  14648. identity to authenticate with AWS. This supports both IRSA and EKS Pod Identity.</p>
  14649. </p>
  14650. <table>
  14651. <thead>
  14652. <tr>
  14653. <th>Field</th>
  14654. <th>Description</th>
  14655. </tr>
  14656. </thead>
  14657. <tbody>
  14658. <tr>
  14659. <td>
  14660. <code>path</code></br>
  14661. <em>
  14662. string
  14663. </em>
  14664. </td>
  14665. <td>
  14666. <em>(Optional)</em>
  14667. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  14668. </td>
  14669. </tr>
  14670. <tr>
  14671. <td>
  14672. <code>region</code></br>
  14673. <em>
  14674. string
  14675. </em>
  14676. </td>
  14677. <td>
  14678. <em>(Optional)</em>
  14679. <p>AWS region</p>
  14680. </td>
  14681. </tr>
  14682. <tr>
  14683. <td>
  14684. <code>role</code></br>
  14685. <em>
  14686. string
  14687. </em>
  14688. </td>
  14689. <td>
  14690. <em>(Optional)</em>
  14691. <p>This is the AWS role to be assumed before talking to vault</p>
  14692. </td>
  14693. </tr>
  14694. <tr>
  14695. <td>
  14696. <code>vaultRole</code></br>
  14697. <em>
  14698. string
  14699. </em>
  14700. </td>
  14701. <td>
  14702. <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>
  14703. </td>
  14704. </tr>
  14705. <tr>
  14706. <td>
  14707. <code>externalID</code></br>
  14708. <em>
  14709. string
  14710. </em>
  14711. </td>
  14712. <td>
  14713. <p>AWS External ID set on assumed IAM roles</p>
  14714. </td>
  14715. </tr>
  14716. <tr>
  14717. <td>
  14718. <code>vaultAwsIamServerID</code></br>
  14719. <em>
  14720. string
  14721. </em>
  14722. </td>
  14723. <td>
  14724. <em>(Optional)</em>
  14725. <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>
  14726. </td>
  14727. </tr>
  14728. <tr>
  14729. <td>
  14730. <code>secretRef</code></br>
  14731. <em>
  14732. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  14733. VaultAwsAuthSecretRef
  14734. </a>
  14735. </em>
  14736. </td>
  14737. <td>
  14738. <em>(Optional)</em>
  14739. <p>Specify credentials in a Secret object</p>
  14740. </td>
  14741. </tr>
  14742. <tr>
  14743. <td>
  14744. <code>jwt</code></br>
  14745. <em>
  14746. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  14747. VaultAwsJWTAuth
  14748. </a>
  14749. </em>
  14750. </td>
  14751. <td>
  14752. <em>(Optional)</em>
  14753. <p>Specify a service account with IRSA enabled</p>
  14754. </td>
  14755. </tr>
  14756. </tbody>
  14757. </table>
  14758. <h3 id="external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth
  14759. </h3>
  14760. <p>
  14761. (<em>Appears on:</em>
  14762. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14763. </p>
  14764. <p>
  14765. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  14766. method, with the role name and a token stored in a Kubernetes Secret resource or
  14767. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  14768. </p>
  14769. <table>
  14770. <thead>
  14771. <tr>
  14772. <th>Field</th>
  14773. <th>Description</th>
  14774. </tr>
  14775. </thead>
  14776. <tbody>
  14777. <tr>
  14778. <td>
  14779. <code>path</code></br>
  14780. <em>
  14781. string
  14782. </em>
  14783. </td>
  14784. <td>
  14785. <p>Path where the JWT authentication backend is mounted
  14786. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  14787. </td>
  14788. </tr>
  14789. <tr>
  14790. <td>
  14791. <code>role</code></br>
  14792. <em>
  14793. string
  14794. </em>
  14795. </td>
  14796. <td>
  14797. <em>(Optional)</em>
  14798. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  14799. authentication method</p>
  14800. </td>
  14801. </tr>
  14802. <tr>
  14803. <td>
  14804. <code>secretRef</code></br>
  14805. <em>
  14806. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14807. External Secrets meta/v1.SecretKeySelector
  14808. </a>
  14809. </em>
  14810. </td>
  14811. <td>
  14812. <em>(Optional)</em>
  14813. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  14814. authenticate with Vault using the JWT/OIDC authentication method.</p>
  14815. </td>
  14816. </tr>
  14817. <tr>
  14818. <td>
  14819. <code>kubernetesServiceAccountToken</code></br>
  14820. <em>
  14821. <a href="#external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">
  14822. VaultKubernetesServiceAccountTokenAuth
  14823. </a>
  14824. </em>
  14825. </td>
  14826. <td>
  14827. <em>(Optional)</em>
  14828. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  14829. a token for with the <code>TokenRequest</code> API.</p>
  14830. </td>
  14831. </tr>
  14832. </tbody>
  14833. </table>
  14834. <h3 id="external-secrets.io/v1.VaultKVStoreVersion">VaultKVStoreVersion
  14835. (<code>string</code> alias)</p></h3>
  14836. <p>
  14837. (<em>Appears on:</em>
  14838. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  14839. </p>
  14840. <p>
  14841. <p>VaultKVStoreVersion represents the version of the Vault KV secret engine.</p>
  14842. </p>
  14843. <table>
  14844. <thead>
  14845. <tr>
  14846. <th>Value</th>
  14847. <th>Description</th>
  14848. </tr>
  14849. </thead>
  14850. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  14851. <td></td>
  14852. </tr><tr><td><p>&#34;v2&#34;</p></td>
  14853. <td></td>
  14854. </tr></tbody>
  14855. </table>
  14856. <h3 id="external-secrets.io/v1.VaultKubernetesAuth">VaultKubernetesAuth
  14857. </h3>
  14858. <p>
  14859. (<em>Appears on:</em>
  14860. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14861. </p>
  14862. <p>
  14863. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in
  14864. a Secret.</p>
  14865. </p>
  14866. <table>
  14867. <thead>
  14868. <tr>
  14869. <th>Field</th>
  14870. <th>Description</th>
  14871. </tr>
  14872. </thead>
  14873. <tbody>
  14874. <tr>
  14875. <td>
  14876. <code>mountPath</code></br>
  14877. <em>
  14878. string
  14879. </em>
  14880. </td>
  14881. <td>
  14882. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  14883. &ldquo;kubernetes&rdquo;</p>
  14884. </td>
  14885. </tr>
  14886. <tr>
  14887. <td>
  14888. <code>serviceAccountRef</code></br>
  14889. <em>
  14890. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14891. External Secrets meta/v1.ServiceAccountSelector
  14892. </a>
  14893. </em>
  14894. </td>
  14895. <td>
  14896. <em>(Optional)</em>
  14897. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  14898. If the service account is specified, the service account secret token JWT will be used
  14899. for authenticating with Vault. If the service account selector is not supplied,
  14900. the secretRef will be used instead.</p>
  14901. </td>
  14902. </tr>
  14903. <tr>
  14904. <td>
  14905. <code>secretRef</code></br>
  14906. <em>
  14907. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14908. External Secrets meta/v1.SecretKeySelector
  14909. </a>
  14910. </em>
  14911. </td>
  14912. <td>
  14913. <em>(Optional)</em>
  14914. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  14915. for authenticating with Vault. If a name is specified without a key,
  14916. <code>token</code> is the default. If one is not specified, the one bound to
  14917. the controller will be used.</p>
  14918. </td>
  14919. </tr>
  14920. <tr>
  14921. <td>
  14922. <code>role</code></br>
  14923. <em>
  14924. string
  14925. </em>
  14926. </td>
  14927. <td>
  14928. <p>A required field containing the Vault Role to assume. A Role binds a
  14929. Kubernetes ServiceAccount with a set of Vault policies.</p>
  14930. </td>
  14931. </tr>
  14932. </tbody>
  14933. </table>
  14934. <h3 id="external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  14935. </h3>
  14936. <p>
  14937. (<em>Appears on:</em>
  14938. <a href="#external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth</a>)
  14939. </p>
  14940. <p>
  14941. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  14942. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  14943. </p>
  14944. <table>
  14945. <thead>
  14946. <tr>
  14947. <th>Field</th>
  14948. <th>Description</th>
  14949. </tr>
  14950. </thead>
  14951. <tbody>
  14952. <tr>
  14953. <td>
  14954. <code>serviceAccountRef</code></br>
  14955. <em>
  14956. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14957. External Secrets meta/v1.ServiceAccountSelector
  14958. </a>
  14959. </em>
  14960. </td>
  14961. <td>
  14962. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  14963. </td>
  14964. </tr>
  14965. <tr>
  14966. <td>
  14967. <code>audiences</code></br>
  14968. <em>
  14969. []string
  14970. </em>
  14971. </td>
  14972. <td>
  14973. <em>(Optional)</em>
  14974. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  14975. account token for the service account referenced by <code>serviceAccountRef</code>.
  14976. Defaults to a single audience <code>vault</code> it not specified.</p>
  14977. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  14978. </td>
  14979. </tr>
  14980. <tr>
  14981. <td>
  14982. <code>expirationSeconds</code></br>
  14983. <em>
  14984. int64
  14985. </em>
  14986. </td>
  14987. <td>
  14988. <em>(Optional)</em>
  14989. <p>Optional expiration time in seconds that will be used to request a temporary
  14990. Kubernetes service account token for the service account referenced by
  14991. <code>serviceAccountRef</code>.</p>
  14992. <p>Deprecated: this will be removed in the future.
  14993. Defaults to 10 minutes.</p>
  14994. </td>
  14995. </tr>
  14996. </tbody>
  14997. </table>
  14998. <h3 id="external-secrets.io/v1.VaultLdapAuth">VaultLdapAuth
  14999. </h3>
  15000. <p>
  15001. (<em>Appears on:</em>
  15002. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  15003. </p>
  15004. <p>
  15005. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  15006. with the username and password stored in a Kubernetes Secret resource.</p>
  15007. </p>
  15008. <table>
  15009. <thead>
  15010. <tr>
  15011. <th>Field</th>
  15012. <th>Description</th>
  15013. </tr>
  15014. </thead>
  15015. <tbody>
  15016. <tr>
  15017. <td>
  15018. <code>path</code></br>
  15019. <em>
  15020. string
  15021. </em>
  15022. </td>
  15023. <td>
  15024. <p>Path where the LDAP authentication backend is mounted
  15025. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  15026. </td>
  15027. </tr>
  15028. <tr>
  15029. <td>
  15030. <code>username</code></br>
  15031. <em>
  15032. string
  15033. </em>
  15034. </td>
  15035. <td>
  15036. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  15037. authentication method</p>
  15038. </td>
  15039. </tr>
  15040. <tr>
  15041. <td>
  15042. <code>secretRef</code></br>
  15043. <em>
  15044. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15045. External Secrets meta/v1.SecretKeySelector
  15046. </a>
  15047. </em>
  15048. </td>
  15049. <td>
  15050. <em>(Optional)</em>
  15051. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  15052. user used to authenticate with Vault using the LDAP authentication
  15053. method</p>
  15054. </td>
  15055. </tr>
  15056. </tbody>
  15057. </table>
  15058. <h3 id="external-secrets.io/v1.VaultProvider">VaultProvider
  15059. </h3>
  15060. <p>
  15061. (<em>Appears on:</em>
  15062. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  15063. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  15064. </p>
  15065. <p>
  15066. <p>VaultProvider configures a store to sync secrets using a Hashicorp Vault KV backend.</p>
  15067. </p>
  15068. <table>
  15069. <thead>
  15070. <tr>
  15071. <th>Field</th>
  15072. <th>Description</th>
  15073. </tr>
  15074. </thead>
  15075. <tbody>
  15076. <tr>
  15077. <td>
  15078. <code>auth</code></br>
  15079. <em>
  15080. <a href="#external-secrets.io/v1.VaultAuth">
  15081. VaultAuth
  15082. </a>
  15083. </em>
  15084. </td>
  15085. <td>
  15086. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  15087. </td>
  15088. </tr>
  15089. <tr>
  15090. <td>
  15091. <code>server</code></br>
  15092. <em>
  15093. string
  15094. </em>
  15095. </td>
  15096. <td>
  15097. <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>
  15098. </td>
  15099. </tr>
  15100. <tr>
  15101. <td>
  15102. <code>path</code></br>
  15103. <em>
  15104. string
  15105. </em>
  15106. </td>
  15107. <td>
  15108. <em>(Optional)</em>
  15109. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  15110. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  15111. for fetching secrets from Vault is optional and will be appended
  15112. if not present in specified path.</p>
  15113. </td>
  15114. </tr>
  15115. <tr>
  15116. <td>
  15117. <code>version</code></br>
  15118. <em>
  15119. <a href="#external-secrets.io/v1.VaultKVStoreVersion">
  15120. VaultKVStoreVersion
  15121. </a>
  15122. </em>
  15123. </td>
  15124. <td>
  15125. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  15126. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  15127. </td>
  15128. </tr>
  15129. <tr>
  15130. <td>
  15131. <code>namespace</code></br>
  15132. <em>
  15133. string
  15134. </em>
  15135. </td>
  15136. <td>
  15137. <em>(Optional)</em>
  15138. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  15139. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  15140. 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>
  15141. </td>
  15142. </tr>
  15143. <tr>
  15144. <td>
  15145. <code>caBundle</code></br>
  15146. <em>
  15147. []byte
  15148. </em>
  15149. </td>
  15150. <td>
  15151. <em>(Optional)</em>
  15152. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  15153. if the Server URL is using HTTPS protocol. This parameter is ignored for
  15154. plain HTTP protocol connection. If not set the system root certificates
  15155. are used to validate the TLS connection.</p>
  15156. </td>
  15157. </tr>
  15158. <tr>
  15159. <td>
  15160. <code>tls</code></br>
  15161. <em>
  15162. <a href="#external-secrets.io/v1.VaultClientTLS">
  15163. VaultClientTLS
  15164. </a>
  15165. </em>
  15166. </td>
  15167. <td>
  15168. <em>(Optional)</em>
  15169. <p>The configuration used for client side related TLS communication, when the Vault server
  15170. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  15171. This parameter is ignored for plain HTTP protocol connection.
  15172. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  15173. which is available under the <code>auth.cert</code> section.</p>
  15174. </td>
  15175. </tr>
  15176. <tr>
  15177. <td>
  15178. <code>caProvider</code></br>
  15179. <em>
  15180. <a href="#external-secrets.io/v1.CAProvider">
  15181. CAProvider
  15182. </a>
  15183. </em>
  15184. </td>
  15185. <td>
  15186. <em>(Optional)</em>
  15187. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  15188. </td>
  15189. </tr>
  15190. <tr>
  15191. <td>
  15192. <code>readYourWrites</code></br>
  15193. <em>
  15194. bool
  15195. </em>
  15196. </td>
  15197. <td>
  15198. <em>(Optional)</em>
  15199. <p>ReadYourWrites ensures isolated read-after-write semantics by
  15200. providing discovered cluster replication states in each request.
  15201. More information about eventual consistency in Vault can be found here
  15202. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  15203. </td>
  15204. </tr>
  15205. <tr>
  15206. <td>
  15207. <code>forwardInconsistent</code></br>
  15208. <em>
  15209. bool
  15210. </em>
  15211. </td>
  15212. <td>
  15213. <em>(Optional)</em>
  15214. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  15215. leader instead of simply retrying within a loop. This can increase performance if
  15216. the option is enabled serverside.
  15217. <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>
  15218. </td>
  15219. </tr>
  15220. <tr>
  15221. <td>
  15222. <code>headers</code></br>
  15223. <em>
  15224. map[string]string
  15225. </em>
  15226. </td>
  15227. <td>
  15228. <em>(Optional)</em>
  15229. <p>Headers to be added in Vault request</p>
  15230. </td>
  15231. </tr>
  15232. <tr>
  15233. <td>
  15234. <code>checkAndSet</code></br>
  15235. <em>
  15236. <a href="#external-secrets.io/v1.VaultCheckAndSet">
  15237. VaultCheckAndSet
  15238. </a>
  15239. </em>
  15240. </td>
  15241. <td>
  15242. <em>(Optional)</em>
  15243. <p>CheckAndSet defines the Check-And-Set (CAS) settings for PushSecret operations.
  15244. Only applies to Vault KV v2 stores. When enabled, write operations must include
  15245. the current version of the secret to prevent unintentional overwrites.</p>
  15246. </td>
  15247. </tr>
  15248. </tbody>
  15249. </table>
  15250. <h3 id="external-secrets.io/v1.VaultUserPassAuth">VaultUserPassAuth
  15251. </h3>
  15252. <p>
  15253. (<em>Appears on:</em>
  15254. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  15255. </p>
  15256. <p>
  15257. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  15258. with the username and password stored in a Kubernetes Secret resource.</p>
  15259. </p>
  15260. <table>
  15261. <thead>
  15262. <tr>
  15263. <th>Field</th>
  15264. <th>Description</th>
  15265. </tr>
  15266. </thead>
  15267. <tbody>
  15268. <tr>
  15269. <td>
  15270. <code>path</code></br>
  15271. <em>
  15272. string
  15273. </em>
  15274. </td>
  15275. <td>
  15276. <p>Path where the UserPassword authentication backend is mounted
  15277. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  15278. </td>
  15279. </tr>
  15280. <tr>
  15281. <td>
  15282. <code>username</code></br>
  15283. <em>
  15284. string
  15285. </em>
  15286. </td>
  15287. <td>
  15288. <p>Username is a username used to authenticate using the UserPass Vault
  15289. authentication method</p>
  15290. </td>
  15291. </tr>
  15292. <tr>
  15293. <td>
  15294. <code>secretRef</code></br>
  15295. <em>
  15296. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15297. External Secrets meta/v1.SecretKeySelector
  15298. </a>
  15299. </em>
  15300. </td>
  15301. <td>
  15302. <em>(Optional)</em>
  15303. <p>SecretRef to a key in a Secret resource containing password for the
  15304. user used to authenticate with Vault using the UserPass authentication
  15305. method</p>
  15306. </td>
  15307. </tr>
  15308. </tbody>
  15309. </table>
  15310. <h3 id="external-secrets.io/v1.VolcengineAuth">VolcengineAuth
  15311. </h3>
  15312. <p>
  15313. (<em>Appears on:</em>
  15314. <a href="#external-secrets.io/v1.VolcengineProvider">VolcengineProvider</a>)
  15315. </p>
  15316. <p>
  15317. <p>VolcengineAuth defines the authentication method for the Volcengine provider.
  15318. Only one of the fields should be set.</p>
  15319. </p>
  15320. <table>
  15321. <thead>
  15322. <tr>
  15323. <th>Field</th>
  15324. <th>Description</th>
  15325. </tr>
  15326. </thead>
  15327. <tbody>
  15328. <tr>
  15329. <td>
  15330. <code>secretRef</code></br>
  15331. <em>
  15332. <a href="#external-secrets.io/v1.VolcengineAuthSecretRef">
  15333. VolcengineAuthSecretRef
  15334. </a>
  15335. </em>
  15336. </td>
  15337. <td>
  15338. <em>(Optional)</em>
  15339. <p>SecretRef defines the static credentials to use for authentication.
  15340. If not set, IRSA is used.</p>
  15341. </td>
  15342. </tr>
  15343. </tbody>
  15344. </table>
  15345. <h3 id="external-secrets.io/v1.VolcengineAuthSecretRef">VolcengineAuthSecretRef
  15346. </h3>
  15347. <p>
  15348. (<em>Appears on:</em>
  15349. <a href="#external-secrets.io/v1.VolcengineAuth">VolcengineAuth</a>)
  15350. </p>
  15351. <p>
  15352. <p>VolcengineAuthSecretRef defines the secret reference for static credentials.</p>
  15353. </p>
  15354. <table>
  15355. <thead>
  15356. <tr>
  15357. <th>Field</th>
  15358. <th>Description</th>
  15359. </tr>
  15360. </thead>
  15361. <tbody>
  15362. <tr>
  15363. <td>
  15364. <code>accessKeyID</code></br>
  15365. <em>
  15366. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15367. External Secrets meta/v1.SecretKeySelector
  15368. </a>
  15369. </em>
  15370. </td>
  15371. <td>
  15372. <p>AccessKeyID is the reference to the secret containing the Access Key ID.</p>
  15373. </td>
  15374. </tr>
  15375. <tr>
  15376. <td>
  15377. <code>secretAccessKey</code></br>
  15378. <em>
  15379. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15380. External Secrets meta/v1.SecretKeySelector
  15381. </a>
  15382. </em>
  15383. </td>
  15384. <td>
  15385. <p>SecretAccessKey is the reference to the secret containing the Secret Access Key.</p>
  15386. </td>
  15387. </tr>
  15388. <tr>
  15389. <td>
  15390. <code>token</code></br>
  15391. <em>
  15392. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15393. External Secrets meta/v1.SecretKeySelector
  15394. </a>
  15395. </em>
  15396. </td>
  15397. <td>
  15398. <em>(Optional)</em>
  15399. <p>Token is the reference to the secret containing the STS(Security Token Service) Token.</p>
  15400. </td>
  15401. </tr>
  15402. </tbody>
  15403. </table>
  15404. <h3 id="external-secrets.io/v1.VolcengineProvider">VolcengineProvider
  15405. </h3>
  15406. <p>
  15407. (<em>Appears on:</em>
  15408. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15409. </p>
  15410. <p>
  15411. <p>VolcengineProvider defines the configuration for the Volcengine provider.</p>
  15412. </p>
  15413. <table>
  15414. <thead>
  15415. <tr>
  15416. <th>Field</th>
  15417. <th>Description</th>
  15418. </tr>
  15419. </thead>
  15420. <tbody>
  15421. <tr>
  15422. <td>
  15423. <code>region</code></br>
  15424. <em>
  15425. string
  15426. </em>
  15427. </td>
  15428. <td>
  15429. <p>Region specifies the Volcengine region to connect to.</p>
  15430. </td>
  15431. </tr>
  15432. <tr>
  15433. <td>
  15434. <code>auth</code></br>
  15435. <em>
  15436. <a href="#external-secrets.io/v1.VolcengineAuth">
  15437. VolcengineAuth
  15438. </a>
  15439. </em>
  15440. </td>
  15441. <td>
  15442. <em>(Optional)</em>
  15443. <p>Auth defines the authentication method to use.
  15444. If not specified, the provider will try to use IRSA (IAM Role for Service Account).</p>
  15445. </td>
  15446. </tr>
  15447. </tbody>
  15448. </table>
  15449. <h3 id="external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider
  15450. </h3>
  15451. <p>
  15452. (<em>Appears on:</em>
  15453. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  15454. </p>
  15455. <p>
  15456. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  15457. </p>
  15458. <table>
  15459. <thead>
  15460. <tr>
  15461. <th>Field</th>
  15462. <th>Description</th>
  15463. </tr>
  15464. </thead>
  15465. <tbody>
  15466. <tr>
  15467. <td>
  15468. <code>type</code></br>
  15469. <em>
  15470. <a href="#external-secrets.io/v1.WebhookCAProviderType">
  15471. WebhookCAProviderType
  15472. </a>
  15473. </em>
  15474. </td>
  15475. <td>
  15476. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  15477. </td>
  15478. </tr>
  15479. <tr>
  15480. <td>
  15481. <code>name</code></br>
  15482. <em>
  15483. string
  15484. </em>
  15485. </td>
  15486. <td>
  15487. <p>The name of the object located at the provider type.</p>
  15488. </td>
  15489. </tr>
  15490. <tr>
  15491. <td>
  15492. <code>key</code></br>
  15493. <em>
  15494. string
  15495. </em>
  15496. </td>
  15497. <td>
  15498. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  15499. </td>
  15500. </tr>
  15501. <tr>
  15502. <td>
  15503. <code>namespace</code></br>
  15504. <em>
  15505. string
  15506. </em>
  15507. </td>
  15508. <td>
  15509. <em>(Optional)</em>
  15510. <p>The namespace the Provider type is in.</p>
  15511. </td>
  15512. </tr>
  15513. </tbody>
  15514. </table>
  15515. <h3 id="external-secrets.io/v1.WebhookCAProviderType">WebhookCAProviderType
  15516. (<code>string</code> alias)</p></h3>
  15517. <p>
  15518. (<em>Appears on:</em>
  15519. <a href="#external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider</a>)
  15520. </p>
  15521. <p>
  15522. <p>WebhookCAProviderType defines the type of provider for certificate authority in webhook connections.</p>
  15523. </p>
  15524. <table>
  15525. <thead>
  15526. <tr>
  15527. <th>Value</th>
  15528. <th>Description</th>
  15529. </tr>
  15530. </thead>
  15531. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  15532. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  15533. </td>
  15534. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  15535. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  15536. </td>
  15537. </tr></tbody>
  15538. </table>
  15539. <h3 id="external-secrets.io/v1.WebhookProvider">WebhookProvider
  15540. </h3>
  15541. <p>
  15542. (<em>Appears on:</em>
  15543. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15544. </p>
  15545. <p>
  15546. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  15547. </p>
  15548. <table>
  15549. <thead>
  15550. <tr>
  15551. <th>Field</th>
  15552. <th>Description</th>
  15553. </tr>
  15554. </thead>
  15555. <tbody>
  15556. <tr>
  15557. <td>
  15558. <code>method</code></br>
  15559. <em>
  15560. string
  15561. </em>
  15562. </td>
  15563. <td>
  15564. <p>Webhook Method</p>
  15565. </td>
  15566. </tr>
  15567. <tr>
  15568. <td>
  15569. <code>url</code></br>
  15570. <em>
  15571. string
  15572. </em>
  15573. </td>
  15574. <td>
  15575. <p>Webhook url to call</p>
  15576. </td>
  15577. </tr>
  15578. <tr>
  15579. <td>
  15580. <code>headers</code></br>
  15581. <em>
  15582. map[string]string
  15583. </em>
  15584. </td>
  15585. <td>
  15586. <em>(Optional)</em>
  15587. <p>Headers</p>
  15588. </td>
  15589. </tr>
  15590. <tr>
  15591. <td>
  15592. <code>auth</code></br>
  15593. <em>
  15594. <a href="#external-secrets.io/v1.AuthorizationProtocol">
  15595. AuthorizationProtocol
  15596. </a>
  15597. </em>
  15598. </td>
  15599. <td>
  15600. <em>(Optional)</em>
  15601. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  15602. </td>
  15603. </tr>
  15604. <tr>
  15605. <td>
  15606. <code>body</code></br>
  15607. <em>
  15608. string
  15609. </em>
  15610. </td>
  15611. <td>
  15612. <em>(Optional)</em>
  15613. <p>Body</p>
  15614. </td>
  15615. </tr>
  15616. <tr>
  15617. <td>
  15618. <code>timeout</code></br>
  15619. <em>
  15620. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15621. Kubernetes meta/v1.Duration
  15622. </a>
  15623. </em>
  15624. </td>
  15625. <td>
  15626. <em>(Optional)</em>
  15627. <p>Timeout</p>
  15628. </td>
  15629. </tr>
  15630. <tr>
  15631. <td>
  15632. <code>result</code></br>
  15633. <em>
  15634. <a href="#external-secrets.io/v1.WebhookResult">
  15635. WebhookResult
  15636. </a>
  15637. </em>
  15638. </td>
  15639. <td>
  15640. <em>(Optional)</em>
  15641. <p>Result formatting</p>
  15642. </td>
  15643. </tr>
  15644. <tr>
  15645. <td>
  15646. <code>secrets</code></br>
  15647. <em>
  15648. <a href="#external-secrets.io/v1.WebhookSecret">
  15649. []WebhookSecret
  15650. </a>
  15651. </em>
  15652. </td>
  15653. <td>
  15654. <em>(Optional)</em>
  15655. <p>Secrets to fill in templates
  15656. These secrets will be passed to the templating function as key value pairs under the given name</p>
  15657. </td>
  15658. </tr>
  15659. <tr>
  15660. <td>
  15661. <code>caBundle</code></br>
  15662. <em>
  15663. []byte
  15664. </em>
  15665. </td>
  15666. <td>
  15667. <em>(Optional)</em>
  15668. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  15669. if the Server URL is using HTTPS protocol. This parameter is ignored for
  15670. plain HTTP protocol connection. If not set the system root certificates
  15671. are used to validate the TLS connection.</p>
  15672. </td>
  15673. </tr>
  15674. <tr>
  15675. <td>
  15676. <code>caProvider</code></br>
  15677. <em>
  15678. <a href="#external-secrets.io/v1.WebhookCAProvider">
  15679. WebhookCAProvider
  15680. </a>
  15681. </em>
  15682. </td>
  15683. <td>
  15684. <em>(Optional)</em>
  15685. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  15686. </td>
  15687. </tr>
  15688. </tbody>
  15689. </table>
  15690. <h3 id="external-secrets.io/v1.WebhookResult">WebhookResult
  15691. </h3>
  15692. <p>
  15693. (<em>Appears on:</em>
  15694. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  15695. </p>
  15696. <p>
  15697. <p>WebhookResult defines how to process and extract secrets from the webhook response.</p>
  15698. </p>
  15699. <table>
  15700. <thead>
  15701. <tr>
  15702. <th>Field</th>
  15703. <th>Description</th>
  15704. </tr>
  15705. </thead>
  15706. <tbody>
  15707. <tr>
  15708. <td>
  15709. <code>jsonPath</code></br>
  15710. <em>
  15711. string
  15712. </em>
  15713. </td>
  15714. <td>
  15715. <em>(Optional)</em>
  15716. <p>Json path of return value</p>
  15717. </td>
  15718. </tr>
  15719. </tbody>
  15720. </table>
  15721. <h3 id="external-secrets.io/v1.WebhookSecret">WebhookSecret
  15722. </h3>
  15723. <p>
  15724. (<em>Appears on:</em>
  15725. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  15726. </p>
  15727. <p>
  15728. <p>WebhookSecret defines a secret that will be passed to the webhook request.</p>
  15729. </p>
  15730. <table>
  15731. <thead>
  15732. <tr>
  15733. <th>Field</th>
  15734. <th>Description</th>
  15735. </tr>
  15736. </thead>
  15737. <tbody>
  15738. <tr>
  15739. <td>
  15740. <code>name</code></br>
  15741. <em>
  15742. string
  15743. </em>
  15744. </td>
  15745. <td>
  15746. <p>Name of this secret in templates</p>
  15747. </td>
  15748. </tr>
  15749. <tr>
  15750. <td>
  15751. <code>secretRef</code></br>
  15752. <em>
  15753. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15754. External Secrets meta/v1.SecretKeySelector
  15755. </a>
  15756. </em>
  15757. </td>
  15758. <td>
  15759. <p>Secret ref to fill in credentials</p>
  15760. </td>
  15761. </tr>
  15762. </tbody>
  15763. </table>
  15764. <h3 id="external-secrets.io/v1.YandexAuth">YandexAuth
  15765. </h3>
  15766. <p>
  15767. (<em>Appears on:</em>
  15768. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  15769. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  15770. </p>
  15771. <p>
  15772. <p>YandexAuth defines the authentication method for the Yandex provider.</p>
  15773. </p>
  15774. <table>
  15775. <thead>
  15776. <tr>
  15777. <th>Field</th>
  15778. <th>Description</th>
  15779. </tr>
  15780. </thead>
  15781. <tbody>
  15782. <tr>
  15783. <td>
  15784. <code>authorizedKeySecretRef</code></br>
  15785. <em>
  15786. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15787. External Secrets meta/v1.SecretKeySelector
  15788. </a>
  15789. </em>
  15790. </td>
  15791. <td>
  15792. <em>(Optional)</em>
  15793. <p>The authorized key used for authentication</p>
  15794. </td>
  15795. </tr>
  15796. </tbody>
  15797. </table>
  15798. <h3 id="external-secrets.io/v1.YandexCAProvider">YandexCAProvider
  15799. </h3>
  15800. <p>
  15801. (<em>Appears on:</em>
  15802. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  15803. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  15804. </p>
  15805. <p>
  15806. <p>YandexCAProvider defines the configuration for Yandex custom certificate authority.</p>
  15807. </p>
  15808. <table>
  15809. <thead>
  15810. <tr>
  15811. <th>Field</th>
  15812. <th>Description</th>
  15813. </tr>
  15814. </thead>
  15815. <tbody>
  15816. <tr>
  15817. <td>
  15818. <code>certSecretRef</code></br>
  15819. <em>
  15820. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15821. External Secrets meta/v1.SecretKeySelector
  15822. </a>
  15823. </em>
  15824. </td>
  15825. <td>
  15826. </td>
  15827. </tr>
  15828. </tbody>
  15829. </table>
  15830. <h3 id="external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  15831. </h3>
  15832. <p>
  15833. (<em>Appears on:</em>
  15834. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15835. </p>
  15836. <p>
  15837. <p>YandexCertificateManagerProvider Configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  15838. </p>
  15839. <table>
  15840. <thead>
  15841. <tr>
  15842. <th>Field</th>
  15843. <th>Description</th>
  15844. </tr>
  15845. </thead>
  15846. <tbody>
  15847. <tr>
  15848. <td>
  15849. <code>apiEndpoint</code></br>
  15850. <em>
  15851. string
  15852. </em>
  15853. </td>
  15854. <td>
  15855. <em>(Optional)</em>
  15856. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  15857. </td>
  15858. </tr>
  15859. <tr>
  15860. <td>
  15861. <code>auth</code></br>
  15862. <em>
  15863. <a href="#external-secrets.io/v1.YandexAuth">
  15864. YandexAuth
  15865. </a>
  15866. </em>
  15867. </td>
  15868. <td>
  15869. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  15870. </td>
  15871. </tr>
  15872. <tr>
  15873. <td>
  15874. <code>caProvider</code></br>
  15875. <em>
  15876. <a href="#external-secrets.io/v1.YandexCAProvider">
  15877. YandexCAProvider
  15878. </a>
  15879. </em>
  15880. </td>
  15881. <td>
  15882. <em>(Optional)</em>
  15883. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  15884. </td>
  15885. </tr>
  15886. <tr>
  15887. <td>
  15888. <code>fetching</code></br>
  15889. <em>
  15890. <a href="#external-secrets.io/v1.FetchingPolicy">
  15891. FetchingPolicy
  15892. </a>
  15893. </em>
  15894. </td>
  15895. <td>
  15896. <em>(Optional)</em>
  15897. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as certificate ID or certificate name</p>
  15898. </td>
  15899. </tr>
  15900. </tbody>
  15901. </table>
  15902. <h3 id="external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider
  15903. </h3>
  15904. <p>
  15905. (<em>Appears on:</em>
  15906. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15907. </p>
  15908. <p>
  15909. <p>YandexLockboxProvider Configures a store to sync secrets using the Yandex Lockbox provider.</p>
  15910. </p>
  15911. <table>
  15912. <thead>
  15913. <tr>
  15914. <th>Field</th>
  15915. <th>Description</th>
  15916. </tr>
  15917. </thead>
  15918. <tbody>
  15919. <tr>
  15920. <td>
  15921. <code>apiEndpoint</code></br>
  15922. <em>
  15923. string
  15924. </em>
  15925. </td>
  15926. <td>
  15927. <em>(Optional)</em>
  15928. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  15929. </td>
  15930. </tr>
  15931. <tr>
  15932. <td>
  15933. <code>auth</code></br>
  15934. <em>
  15935. <a href="#external-secrets.io/v1.YandexAuth">
  15936. YandexAuth
  15937. </a>
  15938. </em>
  15939. </td>
  15940. <td>
  15941. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  15942. </td>
  15943. </tr>
  15944. <tr>
  15945. <td>
  15946. <code>caProvider</code></br>
  15947. <em>
  15948. <a href="#external-secrets.io/v1.YandexCAProvider">
  15949. YandexCAProvider
  15950. </a>
  15951. </em>
  15952. </td>
  15953. <td>
  15954. <em>(Optional)</em>
  15955. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  15956. </td>
  15957. </tr>
  15958. <tr>
  15959. <td>
  15960. <code>fetching</code></br>
  15961. <em>
  15962. <a href="#external-secrets.io/v1.FetchingPolicy">
  15963. FetchingPolicy
  15964. </a>
  15965. </em>
  15966. </td>
  15967. <td>
  15968. <em>(Optional)</em>
  15969. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID or secret name</p>
  15970. </td>
  15971. </tr>
  15972. </tbody>
  15973. </table>
  15974. <hr/>
  15975. <h2 id="external-secrets.io/v1alpha1">external-secrets.io/v1alpha1</h2>
  15976. <p>
  15977. <p>Package v1alpha1 contains resources for external-secrets</p>
  15978. </p>
  15979. <p>Resource Types:</p>
  15980. <ul></ul>
  15981. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret
  15982. </h3>
  15983. <p>
  15984. <p>ClusterPushSecret is the Schema for the ClusterPushSecrets API that enables cluster-wide management of pushing Kubernetes secrets to external providers.</p>
  15985. </p>
  15986. <table>
  15987. <thead>
  15988. <tr>
  15989. <th>Field</th>
  15990. <th>Description</th>
  15991. </tr>
  15992. </thead>
  15993. <tbody>
  15994. <tr>
  15995. <td>
  15996. <code>metadata</code></br>
  15997. <em>
  15998. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  15999. Kubernetes meta/v1.ObjectMeta
  16000. </a>
  16001. </em>
  16002. </td>
  16003. <td>
  16004. Refer to the Kubernetes API documentation for the fields of the
  16005. <code>metadata</code> field.
  16006. </td>
  16007. </tr>
  16008. <tr>
  16009. <td>
  16010. <code>spec</code></br>
  16011. <em>
  16012. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">
  16013. ClusterPushSecretSpec
  16014. </a>
  16015. </em>
  16016. </td>
  16017. <td>
  16018. <br/>
  16019. <br/>
  16020. <table>
  16021. <tr>
  16022. <td>
  16023. <code>pushSecretSpec</code></br>
  16024. <em>
  16025. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  16026. PushSecretSpec
  16027. </a>
  16028. </em>
  16029. </td>
  16030. <td>
  16031. <p>PushSecretSpec defines what to do with the secrets.</p>
  16032. </td>
  16033. </tr>
  16034. <tr>
  16035. <td>
  16036. <code>refreshTime</code></br>
  16037. <em>
  16038. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  16039. Kubernetes meta/v1.Duration
  16040. </a>
  16041. </em>
  16042. </td>
  16043. <td>
  16044. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  16045. </td>
  16046. </tr>
  16047. <tr>
  16048. <td>
  16049. <code>pushSecretName</code></br>
  16050. <em>
  16051. string
  16052. </em>
  16053. </td>
  16054. <td>
  16055. <em>(Optional)</em>
  16056. <p>The name of the push secrets to be created.
  16057. Defaults to the name of the ClusterPushSecret</p>
  16058. </td>
  16059. </tr>
  16060. <tr>
  16061. <td>
  16062. <code>pushSecretMetadata</code></br>
  16063. <em>
  16064. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  16065. PushSecretMetadata
  16066. </a>
  16067. </em>
  16068. </td>
  16069. <td>
  16070. <em>(Optional)</em>
  16071. <p>The metadata of the external secrets to be created</p>
  16072. </td>
  16073. </tr>
  16074. <tr>
  16075. <td>
  16076. <code>namespaceSelectors</code></br>
  16077. <em>
  16078. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  16079. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  16080. </a>
  16081. </em>
  16082. </td>
  16083. <td>
  16084. <em>(Optional)</em>
  16085. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  16086. </td>
  16087. </tr>
  16088. </table>
  16089. </td>
  16090. </tr>
  16091. <tr>
  16092. <td>
  16093. <code>status</code></br>
  16094. <em>
  16095. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">
  16096. ClusterPushSecretStatus
  16097. </a>
  16098. </em>
  16099. </td>
  16100. <td>
  16101. </td>
  16102. </tr>
  16103. </tbody>
  16104. </table>
  16105. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretCondition">ClusterPushSecretCondition
  16106. </h3>
  16107. <p>
  16108. <p>ClusterPushSecretCondition used to refine PushSecrets to specific namespaces and names.</p>
  16109. </p>
  16110. <table>
  16111. <thead>
  16112. <tr>
  16113. <th>Field</th>
  16114. <th>Description</th>
  16115. </tr>
  16116. </thead>
  16117. <tbody>
  16118. <tr>
  16119. <td>
  16120. <code>namespaceSelector</code></br>
  16121. <em>
  16122. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  16123. Kubernetes meta/v1.LabelSelector
  16124. </a>
  16125. </em>
  16126. </td>
  16127. <td>
  16128. <em>(Optional)</em>
  16129. <p>Choose namespace using a labelSelector</p>
  16130. </td>
  16131. </tr>
  16132. <tr>
  16133. <td>
  16134. <code>namespaces</code></br>
  16135. <em>
  16136. []string
  16137. </em>
  16138. </td>
  16139. <td>
  16140. <em>(Optional)</em>
  16141. <p>Choose namespaces by name</p>
  16142. </td>
  16143. </tr>
  16144. </tbody>
  16145. </table>
  16146. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">ClusterPushSecretNamespaceFailure
  16147. </h3>
  16148. <p>
  16149. (<em>Appears on:</em>
  16150. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>)
  16151. </p>
  16152. <p>
  16153. <p>ClusterPushSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  16154. </p>
  16155. <table>
  16156. <thead>
  16157. <tr>
  16158. <th>Field</th>
  16159. <th>Description</th>
  16160. </tr>
  16161. </thead>
  16162. <tbody>
  16163. <tr>
  16164. <td>
  16165. <code>namespace</code></br>
  16166. <em>
  16167. string
  16168. </em>
  16169. </td>
  16170. <td>
  16171. <p>Namespace is the namespace that failed when trying to apply an PushSecret</p>
  16172. </td>
  16173. </tr>
  16174. <tr>
  16175. <td>
  16176. <code>reason</code></br>
  16177. <em>
  16178. string
  16179. </em>
  16180. </td>
  16181. <td>
  16182. <em>(Optional)</em>
  16183. <p>Reason is why the PushSecret failed to apply to the namespace</p>
  16184. </td>
  16185. </tr>
  16186. </tbody>
  16187. </table>
  16188. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec
  16189. </h3>
  16190. <p>
  16191. (<em>Appears on:</em>
  16192. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  16193. </p>
  16194. <p>
  16195. <p>ClusterPushSecretSpec defines the configuration for a ClusterPushSecret resource.</p>
  16196. </p>
  16197. <table>
  16198. <thead>
  16199. <tr>
  16200. <th>Field</th>
  16201. <th>Description</th>
  16202. </tr>
  16203. </thead>
  16204. <tbody>
  16205. <tr>
  16206. <td>
  16207. <code>pushSecretSpec</code></br>
  16208. <em>
  16209. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  16210. PushSecretSpec
  16211. </a>
  16212. </em>
  16213. </td>
  16214. <td>
  16215. <p>PushSecretSpec defines what to do with the secrets.</p>
  16216. </td>
  16217. </tr>
  16218. <tr>
  16219. <td>
  16220. <code>refreshTime</code></br>
  16221. <em>
  16222. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  16223. Kubernetes meta/v1.Duration
  16224. </a>
  16225. </em>
  16226. </td>
  16227. <td>
  16228. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  16229. </td>
  16230. </tr>
  16231. <tr>
  16232. <td>
  16233. <code>pushSecretName</code></br>
  16234. <em>
  16235. string
  16236. </em>
  16237. </td>
  16238. <td>
  16239. <em>(Optional)</em>
  16240. <p>The name of the push secrets to be created.
  16241. Defaults to the name of the ClusterPushSecret</p>
  16242. </td>
  16243. </tr>
  16244. <tr>
  16245. <td>
  16246. <code>pushSecretMetadata</code></br>
  16247. <em>
  16248. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  16249. PushSecretMetadata
  16250. </a>
  16251. </em>
  16252. </td>
  16253. <td>
  16254. <em>(Optional)</em>
  16255. <p>The metadata of the external secrets to be created</p>
  16256. </td>
  16257. </tr>
  16258. <tr>
  16259. <td>
  16260. <code>namespaceSelectors</code></br>
  16261. <em>
  16262. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  16263. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  16264. </a>
  16265. </em>
  16266. </td>
  16267. <td>
  16268. <em>(Optional)</em>
  16269. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  16270. </td>
  16271. </tr>
  16272. </tbody>
  16273. </table>
  16274. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus
  16275. </h3>
  16276. <p>
  16277. (<em>Appears on:</em>
  16278. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  16279. </p>
  16280. <p>
  16281. <p>ClusterPushSecretStatus contains the status information for the ClusterPushSecret resource.</p>
  16282. </p>
  16283. <table>
  16284. <thead>
  16285. <tr>
  16286. <th>Field</th>
  16287. <th>Description</th>
  16288. </tr>
  16289. </thead>
  16290. <tbody>
  16291. <tr>
  16292. <td>
  16293. <code>failedNamespaces</code></br>
  16294. <em>
  16295. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">
  16296. []ClusterPushSecretNamespaceFailure
  16297. </a>
  16298. </em>
  16299. </td>
  16300. <td>
  16301. <em>(Optional)</em>
  16302. <p>Failed namespaces are the namespaces that failed to apply an PushSecret</p>
  16303. </td>
  16304. </tr>
  16305. <tr>
  16306. <td>
  16307. <code>provisionedNamespaces</code></br>
  16308. <em>
  16309. []string
  16310. </em>
  16311. </td>
  16312. <td>
  16313. <em>(Optional)</em>
  16314. <p>ProvisionedNamespaces are the namespaces where the ClusterPushSecret has secrets</p>
  16315. </td>
  16316. </tr>
  16317. <tr>
  16318. <td>
  16319. <code>pushSecretName</code></br>
  16320. <em>
  16321. string
  16322. </em>
  16323. </td>
  16324. <td>
  16325. </td>
  16326. </tr>
  16327. <tr>
  16328. <td>
  16329. <code>conditions</code></br>
  16330. <em>
  16331. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  16332. []PushSecretStatusCondition
  16333. </a>
  16334. </em>
  16335. </td>
  16336. <td>
  16337. <em>(Optional)</em>
  16338. </td>
  16339. </tr>
  16340. </tbody>
  16341. </table>
  16342. <h3 id="external-secrets.io/v1alpha1.PushSecret">PushSecret
  16343. </h3>
  16344. <p>
  16345. <p>PushSecret is the Schema for the PushSecrets API that enables pushing Kubernetes secrets to external secret providers.</p>
  16346. </p>
  16347. <table>
  16348. <thead>
  16349. <tr>
  16350. <th>Field</th>
  16351. <th>Description</th>
  16352. </tr>
  16353. </thead>
  16354. <tbody>
  16355. <tr>
  16356. <td>
  16357. <code>metadata</code></br>
  16358. <em>
  16359. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  16360. Kubernetes meta/v1.ObjectMeta
  16361. </a>
  16362. </em>
  16363. </td>
  16364. <td>
  16365. Refer to the Kubernetes API documentation for the fields of the
  16366. <code>metadata</code> field.
  16367. </td>
  16368. </tr>
  16369. <tr>
  16370. <td>
  16371. <code>spec</code></br>
  16372. <em>
  16373. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  16374. PushSecretSpec
  16375. </a>
  16376. </em>
  16377. </td>
  16378. <td>
  16379. <br/>
  16380. <br/>
  16381. <table>
  16382. <tr>
  16383. <td>
  16384. <code>refreshInterval</code></br>
  16385. <em>
  16386. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  16387. Kubernetes meta/v1.Duration
  16388. </a>
  16389. </em>
  16390. </td>
  16391. <td>
  16392. <p>The Interval to which External Secrets will try to push a secret definition</p>
  16393. </td>
  16394. </tr>
  16395. <tr>
  16396. <td>
  16397. <code>secretStoreRefs</code></br>
  16398. <em>
  16399. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  16400. []PushSecretStoreRef
  16401. </a>
  16402. </em>
  16403. </td>
  16404. <td>
  16405. </td>
  16406. </tr>
  16407. <tr>
  16408. <td>
  16409. <code>updatePolicy</code></br>
  16410. <em>
  16411. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  16412. PushSecretUpdatePolicy
  16413. </a>
  16414. </em>
  16415. </td>
  16416. <td>
  16417. <em>(Optional)</em>
  16418. <p>UpdatePolicy to handle Secrets in the provider.</p>
  16419. </td>
  16420. </tr>
  16421. <tr>
  16422. <td>
  16423. <code>deletionPolicy</code></br>
  16424. <em>
  16425. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  16426. PushSecretDeletionPolicy
  16427. </a>
  16428. </em>
  16429. </td>
  16430. <td>
  16431. <em>(Optional)</em>
  16432. <p>Deletion Policy to handle Secrets in the provider.</p>
  16433. </td>
  16434. </tr>
  16435. <tr>
  16436. <td>
  16437. <code>selector</code></br>
  16438. <em>
  16439. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  16440. PushSecretSelector
  16441. </a>
  16442. </em>
  16443. </td>
  16444. <td>
  16445. <p>The Secret Selector (k8s source) for the Push Secret</p>
  16446. </td>
  16447. </tr>
  16448. <tr>
  16449. <td>
  16450. <code>data</code></br>
  16451. <em>
  16452. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  16453. []PushSecretData
  16454. </a>
  16455. </em>
  16456. </td>
  16457. <td>
  16458. <em>(Optional)</em>
  16459. <p>Secret Data that should be pushed to providers</p>
  16460. </td>
  16461. </tr>
  16462. <tr>
  16463. <td>
  16464. <code>dataTo</code></br>
  16465. <em>
  16466. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  16467. []PushSecretDataTo
  16468. </a>
  16469. </em>
  16470. </td>
  16471. <td>
  16472. <em>(Optional)</em>
  16473. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  16474. </td>
  16475. </tr>
  16476. <tr>
  16477. <td>
  16478. <code>template</code></br>
  16479. <em>
  16480. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  16481. ExternalSecretTemplate
  16482. </a>
  16483. </em>
  16484. </td>
  16485. <td>
  16486. <em>(Optional)</em>
  16487. <p>Template defines a blueprint for the created Secret resource.</p>
  16488. </td>
  16489. </tr>
  16490. </table>
  16491. </td>
  16492. </tr>
  16493. <tr>
  16494. <td>
  16495. <code>status</code></br>
  16496. <em>
  16497. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">
  16498. PushSecretStatus
  16499. </a>
  16500. </em>
  16501. </td>
  16502. <td>
  16503. </td>
  16504. </tr>
  16505. </tbody>
  16506. </table>
  16507. <h3 id="external-secrets.io/v1alpha1.PushSecretConditionType">PushSecretConditionType
  16508. (<code>string</code> alias)</p></h3>
  16509. <p>
  16510. (<em>Appears on:</em>
  16511. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition</a>)
  16512. </p>
  16513. <p>
  16514. <p>PushSecretConditionType indicates the condition of the PushSecret.</p>
  16515. </p>
  16516. <table>
  16517. <thead>
  16518. <tr>
  16519. <th>Value</th>
  16520. <th>Description</th>
  16521. </tr>
  16522. </thead>
  16523. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  16524. <td><p>PushSecretReady indicates the PushSecret resource is ready.</p>
  16525. </td>
  16526. </tr></tbody>
  16527. </table>
  16528. <h3 id="external-secrets.io/v1alpha1.PushSecretConversionStrategy">PushSecretConversionStrategy
  16529. (<code>string</code> alias)</p></h3>
  16530. <p>
  16531. (<em>Appears on:</em>
  16532. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>,
  16533. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16534. </p>
  16535. <p>
  16536. <p>PushSecretConversionStrategy defines how secret values are converted when pushed to providers.</p>
  16537. </p>
  16538. <table>
  16539. <thead>
  16540. <tr>
  16541. <th>Value</th>
  16542. <th>Description</th>
  16543. </tr>
  16544. </thead>
  16545. <tbody><tr><td><p>&#34;None&#34;</p></td>
  16546. <td><p>PushSecretConversionNone indicates no conversion will be performed on the secret value.</p>
  16547. </td>
  16548. </tr><tr><td><p>&#34;ReverseUnicode&#34;</p></td>
  16549. <td><p>PushSecretConversionReverseUnicode indicates that unicode escape sequences will be reversed.</p>
  16550. </td>
  16551. </tr></tbody>
  16552. </table>
  16553. <h3 id="external-secrets.io/v1alpha1.PushSecretData">PushSecretData
  16554. </h3>
  16555. <p>
  16556. (<em>Appears on:</em>
  16557. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16558. </p>
  16559. <p>
  16560. <p>PushSecretData defines data to be pushed to the provider and associated metadata.</p>
  16561. </p>
  16562. <table>
  16563. <thead>
  16564. <tr>
  16565. <th>Field</th>
  16566. <th>Description</th>
  16567. </tr>
  16568. </thead>
  16569. <tbody>
  16570. <tr>
  16571. <td>
  16572. <code>match</code></br>
  16573. <em>
  16574. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">
  16575. PushSecretMatch
  16576. </a>
  16577. </em>
  16578. </td>
  16579. <td>
  16580. <p>Match a given Secret Key to be pushed to the provider.</p>
  16581. </td>
  16582. </tr>
  16583. <tr>
  16584. <td>
  16585. <code>metadata</code></br>
  16586. <em>
  16587. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  16588. </em>
  16589. </td>
  16590. <td>
  16591. <em>(Optional)</em>
  16592. <p>Metadata is metadata attached to the secret.
  16593. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  16594. </td>
  16595. </tr>
  16596. <tr>
  16597. <td>
  16598. <code>conversionStrategy</code></br>
  16599. <em>
  16600. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  16601. PushSecretConversionStrategy
  16602. </a>
  16603. </em>
  16604. </td>
  16605. <td>
  16606. <em>(Optional)</em>
  16607. <p>Used to define a conversion Strategy for the secret keys</p>
  16608. </td>
  16609. </tr>
  16610. </tbody>
  16611. </table>
  16612. <h3 id="external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo
  16613. </h3>
  16614. <p>
  16615. (<em>Appears on:</em>
  16616. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16617. </p>
  16618. <p>
  16619. <p>PushSecretDataTo defines how to bulk-push secrets to providers without explicit per-key mappings.</p>
  16620. </p>
  16621. <table>
  16622. <thead>
  16623. <tr>
  16624. <th>Field</th>
  16625. <th>Description</th>
  16626. </tr>
  16627. </thead>
  16628. <tbody>
  16629. <tr>
  16630. <td>
  16631. <code>storeRef</code></br>
  16632. <em>
  16633. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  16634. PushSecretStoreRef
  16635. </a>
  16636. </em>
  16637. </td>
  16638. <td>
  16639. <p>StoreRef specifies which SecretStore to push to. Required.</p>
  16640. </td>
  16641. </tr>
  16642. <tr>
  16643. <td>
  16644. <code>remoteKey</code></br>
  16645. <em>
  16646. string
  16647. </em>
  16648. </td>
  16649. <td>
  16650. <em>(Optional)</em>
  16651. <p>RemoteKey is the name of the single provider secret that will receive ALL
  16652. matched keys bundled as a JSON object (e.g. {&ldquo;DB_HOST&rdquo;:&ldquo;&hellip;&rdquo;,&ldquo;DB_USER&rdquo;:&ldquo;&hellip;&rdquo;}).
  16653. When set, per-key expansion is skipped and a single push is performed.
  16654. The provider&rsquo;s store prefix (if any) is still prepended to this value.
  16655. When not set, each matched key is pushed as its own individual provider secret.</p>
  16656. </td>
  16657. </tr>
  16658. <tr>
  16659. <td>
  16660. <code>match</code></br>
  16661. <em>
  16662. <a href="#external-secrets.io/v1alpha1.PushSecretDataToMatch">
  16663. PushSecretDataToMatch
  16664. </a>
  16665. </em>
  16666. </td>
  16667. <td>
  16668. <em>(Optional)</em>
  16669. <p>Match pattern for selecting keys from the source Secret.
  16670. If not specified, all keys are selected.</p>
  16671. </td>
  16672. </tr>
  16673. <tr>
  16674. <td>
  16675. <code>rewrite</code></br>
  16676. <em>
  16677. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">
  16678. []PushSecretRewrite
  16679. </a>
  16680. </em>
  16681. </td>
  16682. <td>
  16683. <em>(Optional)</em>
  16684. <p>Rewrite operations to transform keys before pushing to the provider.
  16685. Operations are applied sequentially.</p>
  16686. </td>
  16687. </tr>
  16688. <tr>
  16689. <td>
  16690. <code>metadata</code></br>
  16691. <em>
  16692. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  16693. </em>
  16694. </td>
  16695. <td>
  16696. <em>(Optional)</em>
  16697. <p>Metadata is metadata attached to the secret.
  16698. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  16699. </td>
  16700. </tr>
  16701. <tr>
  16702. <td>
  16703. <code>conversionStrategy</code></br>
  16704. <em>
  16705. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  16706. PushSecretConversionStrategy
  16707. </a>
  16708. </em>
  16709. </td>
  16710. <td>
  16711. <em>(Optional)</em>
  16712. <p>Used to define a conversion Strategy for the secret keys</p>
  16713. </td>
  16714. </tr>
  16715. </tbody>
  16716. </table>
  16717. <h3 id="external-secrets.io/v1alpha1.PushSecretDataToMatch">PushSecretDataToMatch
  16718. </h3>
  16719. <p>
  16720. (<em>Appears on:</em>
  16721. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16722. </p>
  16723. <p>
  16724. <p>PushSecretDataToMatch defines pattern matching for key selection.</p>
  16725. </p>
  16726. <table>
  16727. <thead>
  16728. <tr>
  16729. <th>Field</th>
  16730. <th>Description</th>
  16731. </tr>
  16732. </thead>
  16733. <tbody>
  16734. <tr>
  16735. <td>
  16736. <code>regexp</code></br>
  16737. <em>
  16738. string
  16739. </em>
  16740. </td>
  16741. <td>
  16742. <em>(Optional)</em>
  16743. <p>Regexp matches keys by regular expression.
  16744. If not specified, all keys are matched.</p>
  16745. </td>
  16746. </tr>
  16747. </tbody>
  16748. </table>
  16749. <h3 id="external-secrets.io/v1alpha1.PushSecretDeletionPolicy">PushSecretDeletionPolicy
  16750. (<code>string</code> alias)</p></h3>
  16751. <p>
  16752. (<em>Appears on:</em>
  16753. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16754. </p>
  16755. <p>
  16756. <p>PushSecretDeletionPolicy defines how push secrets are deleted in the provider.</p>
  16757. </p>
  16758. <table>
  16759. <thead>
  16760. <tr>
  16761. <th>Value</th>
  16762. <th>Description</th>
  16763. </tr>
  16764. </thead>
  16765. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  16766. <td><p>PushSecretDeletionPolicyDelete deletes secrets from the provider when the PushSecret is deleted.</p>
  16767. </td>
  16768. </tr><tr><td><p>&#34;None&#34;</p></td>
  16769. <td><p>PushSecretDeletionPolicyNone keeps secrets in the provider when the PushSecret is deleted.</p>
  16770. </td>
  16771. </tr></tbody>
  16772. </table>
  16773. <h3 id="external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch
  16774. </h3>
  16775. <p>
  16776. (<em>Appears on:</em>
  16777. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>)
  16778. </p>
  16779. <p>
  16780. <p>PushSecretMatch defines how a source Secret key maps to a destination in the provider.</p>
  16781. </p>
  16782. <table>
  16783. <thead>
  16784. <tr>
  16785. <th>Field</th>
  16786. <th>Description</th>
  16787. </tr>
  16788. </thead>
  16789. <tbody>
  16790. <tr>
  16791. <td>
  16792. <code>secretKey</code></br>
  16793. <em>
  16794. string
  16795. </em>
  16796. </td>
  16797. <td>
  16798. <em>(Optional)</em>
  16799. <p>Secret Key to be pushed</p>
  16800. </td>
  16801. </tr>
  16802. <tr>
  16803. <td>
  16804. <code>remoteRef</code></br>
  16805. <em>
  16806. <a href="#external-secrets.io/v1alpha1.PushSecretRemoteRef">
  16807. PushSecretRemoteRef
  16808. </a>
  16809. </em>
  16810. </td>
  16811. <td>
  16812. <p>Remote Refs to push to providers.</p>
  16813. </td>
  16814. </tr>
  16815. </tbody>
  16816. </table>
  16817. <h3 id="external-secrets.io/v1alpha1.PushSecretMetadata">PushSecretMetadata
  16818. </h3>
  16819. <p>
  16820. (<em>Appears on:</em>
  16821. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>)
  16822. </p>
  16823. <p>
  16824. <p>PushSecretMetadata defines metadata fields for the PushSecret generated by the ClusterPushSecret.</p>
  16825. </p>
  16826. <table>
  16827. <thead>
  16828. <tr>
  16829. <th>Field</th>
  16830. <th>Description</th>
  16831. </tr>
  16832. </thead>
  16833. <tbody>
  16834. <tr>
  16835. <td>
  16836. <code>annotations</code></br>
  16837. <em>
  16838. map[string]string
  16839. </em>
  16840. </td>
  16841. <td>
  16842. <em>(Optional)</em>
  16843. </td>
  16844. </tr>
  16845. <tr>
  16846. <td>
  16847. <code>labels</code></br>
  16848. <em>
  16849. map[string]string
  16850. </em>
  16851. </td>
  16852. <td>
  16853. <em>(Optional)</em>
  16854. </td>
  16855. </tr>
  16856. </tbody>
  16857. </table>
  16858. <h3 id="external-secrets.io/v1alpha1.PushSecretRemoteRef">PushSecretRemoteRef
  16859. </h3>
  16860. <p>
  16861. (<em>Appears on:</em>
  16862. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch</a>)
  16863. </p>
  16864. <p>
  16865. <p>PushSecretRemoteRef defines the location of the secret in the provider.</p>
  16866. </p>
  16867. <table>
  16868. <thead>
  16869. <tr>
  16870. <th>Field</th>
  16871. <th>Description</th>
  16872. </tr>
  16873. </thead>
  16874. <tbody>
  16875. <tr>
  16876. <td>
  16877. <code>remoteKey</code></br>
  16878. <em>
  16879. string
  16880. </em>
  16881. </td>
  16882. <td>
  16883. <p>Name of the resulting provider secret.</p>
  16884. </td>
  16885. </tr>
  16886. <tr>
  16887. <td>
  16888. <code>property</code></br>
  16889. <em>
  16890. string
  16891. </em>
  16892. </td>
  16893. <td>
  16894. <em>(Optional)</em>
  16895. <p>Name of the property in the resulting secret</p>
  16896. </td>
  16897. </tr>
  16898. </tbody>
  16899. </table>
  16900. <h3 id="external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite
  16901. </h3>
  16902. <p>
  16903. (<em>Appears on:</em>
  16904. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16905. </p>
  16906. <p>
  16907. <p>PushSecretRewrite defines how to transform secret keys before pushing.</p>
  16908. </p>
  16909. <table>
  16910. <thead>
  16911. <tr>
  16912. <th>Field</th>
  16913. <th>Description</th>
  16914. </tr>
  16915. </thead>
  16916. <tbody>
  16917. <tr>
  16918. <td>
  16919. <code>regexp</code></br>
  16920. <em>
  16921. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  16922. ExternalSecretRewriteRegexp
  16923. </a>
  16924. </em>
  16925. </td>
  16926. <td>
  16927. <em>(Optional)</em>
  16928. <p>Used to rewrite with regular expressions.</p>
  16929. </td>
  16930. </tr>
  16931. <tr>
  16932. <td>
  16933. <code>transform</code></br>
  16934. <em>
  16935. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  16936. ExternalSecretRewriteTransform
  16937. </a>
  16938. </em>
  16939. </td>
  16940. <td>
  16941. <em>(Optional)</em>
  16942. <p>Used to apply string transformation on the secrets.</p>
  16943. </td>
  16944. </tr>
  16945. </tbody>
  16946. </table>
  16947. <h3 id="external-secrets.io/v1alpha1.PushSecretSecret">PushSecretSecret
  16948. </h3>
  16949. <p>
  16950. (<em>Appears on:</em>
  16951. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  16952. </p>
  16953. <p>
  16954. <p>PushSecretSecret defines a Secret that will be used as a source for pushing to providers.</p>
  16955. </p>
  16956. <table>
  16957. <thead>
  16958. <tr>
  16959. <th>Field</th>
  16960. <th>Description</th>
  16961. </tr>
  16962. </thead>
  16963. <tbody>
  16964. <tr>
  16965. <td>
  16966. <code>name</code></br>
  16967. <em>
  16968. string
  16969. </em>
  16970. </td>
  16971. <td>
  16972. <em>(Optional)</em>
  16973. <p>Name of the Secret.
  16974. The Secret must exist in the same namespace as the PushSecret manifest.</p>
  16975. </td>
  16976. </tr>
  16977. <tr>
  16978. <td>
  16979. <code>selector</code></br>
  16980. <em>
  16981. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  16982. Kubernetes meta/v1.LabelSelector
  16983. </a>
  16984. </em>
  16985. </td>
  16986. <td>
  16987. <em>(Optional)</em>
  16988. <p>Selector chooses secrets using a labelSelector.</p>
  16989. </td>
  16990. </tr>
  16991. </tbody>
  16992. </table>
  16993. <h3 id="external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector
  16994. </h3>
  16995. <p>
  16996. (<em>Appears on:</em>
  16997. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16998. </p>
  16999. <p>
  17000. <p>PushSecretSelector defines criteria for selecting the source Secret for pushing to providers.</p>
  17001. </p>
  17002. <table>
  17003. <thead>
  17004. <tr>
  17005. <th>Field</th>
  17006. <th>Description</th>
  17007. </tr>
  17008. </thead>
  17009. <tbody>
  17010. <tr>
  17011. <td>
  17012. <code>secret</code></br>
  17013. <em>
  17014. <a href="#external-secrets.io/v1alpha1.PushSecretSecret">
  17015. PushSecretSecret
  17016. </a>
  17017. </em>
  17018. </td>
  17019. <td>
  17020. <em>(Optional)</em>
  17021. <p>Select a Secret to Push.</p>
  17022. </td>
  17023. </tr>
  17024. <tr>
  17025. <td>
  17026. <code>generatorRef</code></br>
  17027. <em>
  17028. <a href="#external-secrets.io/v1.GeneratorRef">
  17029. GeneratorRef
  17030. </a>
  17031. </em>
  17032. </td>
  17033. <td>
  17034. <em>(Optional)</em>
  17035. <p>Point to a generator to create a Secret.</p>
  17036. </td>
  17037. </tr>
  17038. </tbody>
  17039. </table>
  17040. <h3 id="external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec
  17041. </h3>
  17042. <p>
  17043. (<em>Appears on:</em>
  17044. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>,
  17045. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  17046. </p>
  17047. <p>
  17048. <p>PushSecretSpec configures the behavior of the PushSecret.</p>
  17049. </p>
  17050. <table>
  17051. <thead>
  17052. <tr>
  17053. <th>Field</th>
  17054. <th>Description</th>
  17055. </tr>
  17056. </thead>
  17057. <tbody>
  17058. <tr>
  17059. <td>
  17060. <code>refreshInterval</code></br>
  17061. <em>
  17062. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  17063. Kubernetes meta/v1.Duration
  17064. </a>
  17065. </em>
  17066. </td>
  17067. <td>
  17068. <p>The Interval to which External Secrets will try to push a secret definition</p>
  17069. </td>
  17070. </tr>
  17071. <tr>
  17072. <td>
  17073. <code>secretStoreRefs</code></br>
  17074. <em>
  17075. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  17076. []PushSecretStoreRef
  17077. </a>
  17078. </em>
  17079. </td>
  17080. <td>
  17081. </td>
  17082. </tr>
  17083. <tr>
  17084. <td>
  17085. <code>updatePolicy</code></br>
  17086. <em>
  17087. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  17088. PushSecretUpdatePolicy
  17089. </a>
  17090. </em>
  17091. </td>
  17092. <td>
  17093. <em>(Optional)</em>
  17094. <p>UpdatePolicy to handle Secrets in the provider.</p>
  17095. </td>
  17096. </tr>
  17097. <tr>
  17098. <td>
  17099. <code>deletionPolicy</code></br>
  17100. <em>
  17101. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  17102. PushSecretDeletionPolicy
  17103. </a>
  17104. </em>
  17105. </td>
  17106. <td>
  17107. <em>(Optional)</em>
  17108. <p>Deletion Policy to handle Secrets in the provider.</p>
  17109. </td>
  17110. </tr>
  17111. <tr>
  17112. <td>
  17113. <code>selector</code></br>
  17114. <em>
  17115. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  17116. PushSecretSelector
  17117. </a>
  17118. </em>
  17119. </td>
  17120. <td>
  17121. <p>The Secret Selector (k8s source) for the Push Secret</p>
  17122. </td>
  17123. </tr>
  17124. <tr>
  17125. <td>
  17126. <code>data</code></br>
  17127. <em>
  17128. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  17129. []PushSecretData
  17130. </a>
  17131. </em>
  17132. </td>
  17133. <td>
  17134. <em>(Optional)</em>
  17135. <p>Secret Data that should be pushed to providers</p>
  17136. </td>
  17137. </tr>
  17138. <tr>
  17139. <td>
  17140. <code>dataTo</code></br>
  17141. <em>
  17142. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  17143. []PushSecretDataTo
  17144. </a>
  17145. </em>
  17146. </td>
  17147. <td>
  17148. <em>(Optional)</em>
  17149. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  17150. </td>
  17151. </tr>
  17152. <tr>
  17153. <td>
  17154. <code>template</code></br>
  17155. <em>
  17156. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  17157. ExternalSecretTemplate
  17158. </a>
  17159. </em>
  17160. </td>
  17161. <td>
  17162. <em>(Optional)</em>
  17163. <p>Template defines a blueprint for the created Secret resource.</p>
  17164. </td>
  17165. </tr>
  17166. </tbody>
  17167. </table>
  17168. <h3 id="external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus
  17169. </h3>
  17170. <p>
  17171. (<em>Appears on:</em>
  17172. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  17173. </p>
  17174. <p>
  17175. <p>PushSecretStatus indicates the history of the status of PushSecret.</p>
  17176. </p>
  17177. <table>
  17178. <thead>
  17179. <tr>
  17180. <th>Field</th>
  17181. <th>Description</th>
  17182. </tr>
  17183. </thead>
  17184. <tbody>
  17185. <tr>
  17186. <td>
  17187. <code>refreshTime</code></br>
  17188. <em>
  17189. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  17190. Kubernetes meta/v1.Time
  17191. </a>
  17192. </em>
  17193. </td>
  17194. <td>
  17195. <p>refreshTime is the time and date the external secret was fetched and
  17196. the target secret updated</p>
  17197. </td>
  17198. </tr>
  17199. <tr>
  17200. <td>
  17201. <code>syncedResourceVersion</code></br>
  17202. <em>
  17203. string
  17204. </em>
  17205. </td>
  17206. <td>
  17207. <p>SyncedResourceVersion keeps track of the last synced version.</p>
  17208. </td>
  17209. </tr>
  17210. <tr>
  17211. <td>
  17212. <code>syncedPushSecrets</code></br>
  17213. <em>
  17214. <a href="#external-secrets.io/v1alpha1.SyncedPushSecretsMap">
  17215. SyncedPushSecretsMap
  17216. </a>
  17217. </em>
  17218. </td>
  17219. <td>
  17220. <em>(Optional)</em>
  17221. <p>Synced PushSecrets, including secrets that already exist in provider.
  17222. Matches secret stores to PushSecretData that was stored to that secret store.</p>
  17223. </td>
  17224. </tr>
  17225. <tr>
  17226. <td>
  17227. <code>conditions</code></br>
  17228. <em>
  17229. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  17230. []PushSecretStatusCondition
  17231. </a>
  17232. </em>
  17233. </td>
  17234. <td>
  17235. <em>(Optional)</em>
  17236. </td>
  17237. </tr>
  17238. </tbody>
  17239. </table>
  17240. <h3 id="external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition
  17241. </h3>
  17242. <p>
  17243. (<em>Appears on:</em>
  17244. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>,
  17245. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  17246. </p>
  17247. <p>
  17248. <p>PushSecretStatusCondition indicates the status of the PushSecret.</p>
  17249. </p>
  17250. <table>
  17251. <thead>
  17252. <tr>
  17253. <th>Field</th>
  17254. <th>Description</th>
  17255. </tr>
  17256. </thead>
  17257. <tbody>
  17258. <tr>
  17259. <td>
  17260. <code>type</code></br>
  17261. <em>
  17262. <a href="#external-secrets.io/v1alpha1.PushSecretConditionType">
  17263. PushSecretConditionType
  17264. </a>
  17265. </em>
  17266. </td>
  17267. <td>
  17268. </td>
  17269. </tr>
  17270. <tr>
  17271. <td>
  17272. <code>status</code></br>
  17273. <em>
  17274. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  17275. Kubernetes core/v1.ConditionStatus
  17276. </a>
  17277. </em>
  17278. </td>
  17279. <td>
  17280. </td>
  17281. </tr>
  17282. <tr>
  17283. <td>
  17284. <code>reason</code></br>
  17285. <em>
  17286. string
  17287. </em>
  17288. </td>
  17289. <td>
  17290. <em>(Optional)</em>
  17291. </td>
  17292. </tr>
  17293. <tr>
  17294. <td>
  17295. <code>message</code></br>
  17296. <em>
  17297. string
  17298. </em>
  17299. </td>
  17300. <td>
  17301. <em>(Optional)</em>
  17302. </td>
  17303. </tr>
  17304. <tr>
  17305. <td>
  17306. <code>lastTransitionTime</code></br>
  17307. <em>
  17308. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  17309. Kubernetes meta/v1.Time
  17310. </a>
  17311. </em>
  17312. </td>
  17313. <td>
  17314. <em>(Optional)</em>
  17315. </td>
  17316. </tr>
  17317. </tbody>
  17318. </table>
  17319. <h3 id="external-secrets.io/v1alpha1.PushSecretStoreRef">PushSecretStoreRef
  17320. </h3>
  17321. <p>
  17322. (<em>Appears on:</em>
  17323. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>,
  17324. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  17325. </p>
  17326. <p>
  17327. <p>PushSecretStoreRef contains a reference on how to sync to a SecretStore.</p>
  17328. </p>
  17329. <table>
  17330. <thead>
  17331. <tr>
  17332. <th>Field</th>
  17333. <th>Description</th>
  17334. </tr>
  17335. </thead>
  17336. <tbody>
  17337. <tr>
  17338. <td>
  17339. <code>name</code></br>
  17340. <em>
  17341. string
  17342. </em>
  17343. </td>
  17344. <td>
  17345. <em>(Optional)</em>
  17346. <p>Optionally, sync to the SecretStore of the given name</p>
  17347. </td>
  17348. </tr>
  17349. <tr>
  17350. <td>
  17351. <code>labelSelector</code></br>
  17352. <em>
  17353. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  17354. Kubernetes meta/v1.LabelSelector
  17355. </a>
  17356. </em>
  17357. </td>
  17358. <td>
  17359. <em>(Optional)</em>
  17360. <p>Optionally, sync to secret stores with label selector</p>
  17361. </td>
  17362. </tr>
  17363. <tr>
  17364. <td>
  17365. <code>kind</code></br>
  17366. <em>
  17367. string
  17368. </em>
  17369. </td>
  17370. <td>
  17371. <em>(Optional)</em>
  17372. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)</p>
  17373. </td>
  17374. </tr>
  17375. </tbody>
  17376. </table>
  17377. <h3 id="external-secrets.io/v1alpha1.PushSecretUpdatePolicy">PushSecretUpdatePolicy
  17378. (<code>string</code> alias)</p></h3>
  17379. <p>
  17380. (<em>Appears on:</em>
  17381. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  17382. </p>
  17383. <p>
  17384. <p>PushSecretUpdatePolicy defines how push secrets are updated in the provider.</p>
  17385. </p>
  17386. <table>
  17387. <thead>
  17388. <tr>
  17389. <th>Value</th>
  17390. <th>Description</th>
  17391. </tr>
  17392. </thead>
  17393. <tbody><tr><td><p>&#34;IfNotExists&#34;</p></td>
  17394. <td><p>PushSecretUpdatePolicyIfNotExists only creates secrets that don&rsquo;t exist in the provider.</p>
  17395. </td>
  17396. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  17397. <td><p>PushSecretUpdatePolicyReplace replaces existing secrets in the provider.</p>
  17398. </td>
  17399. </tr></tbody>
  17400. </table>
  17401. <h3 id="external-secrets.io/v1alpha1.SyncedPushSecretsMap">SyncedPushSecretsMap
  17402. (<code>map[string]map[string]github.com/external-secrets/external-secrets/apis/externalsecrets/v1alpha1.PushSecretData</code> alias)</p></h3>
  17403. <p>
  17404. (<em>Appears on:</em>
  17405. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  17406. </p>
  17407. <p>
  17408. <p>SyncedPushSecretsMap is a map that tracks which PushSecretData was stored to which secret store.
  17409. The outer map&rsquo;s key is the secret store name, and the inner map&rsquo;s key is the remote key name.</p>
  17410. </p>
  17411. <hr/>
  17412. <h2 id="external-secrets.io/v1beta1">external-secrets.io/v1beta1</h2>
  17413. <p>
  17414. <p>Package v1beta1 contains resources for external-secrets</p>
  17415. </p>
  17416. <p>Resource Types:</p>
  17417. <ul></ul>
  17418. <h3 id="external-secrets.io/v1beta1.AWSAuth">AWSAuth
  17419. </h3>
  17420. <p>
  17421. (<em>Appears on:</em>
  17422. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  17423. </p>
  17424. <p>
  17425. <p>AWSAuth tells the controller how to do authentication with aws.
  17426. Only one of secretRef or jwt can be specified.
  17427. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  17428. </p>
  17429. <table>
  17430. <thead>
  17431. <tr>
  17432. <th>Field</th>
  17433. <th>Description</th>
  17434. </tr>
  17435. </thead>
  17436. <tbody>
  17437. <tr>
  17438. <td>
  17439. <code>secretRef</code></br>
  17440. <em>
  17441. <a href="#external-secrets.io/v1beta1.AWSAuthSecretRef">
  17442. AWSAuthSecretRef
  17443. </a>
  17444. </em>
  17445. </td>
  17446. <td>
  17447. <em>(Optional)</em>
  17448. </td>
  17449. </tr>
  17450. <tr>
  17451. <td>
  17452. <code>jwt</code></br>
  17453. <em>
  17454. <a href="#external-secrets.io/v1beta1.AWSJWTAuth">
  17455. AWSJWTAuth
  17456. </a>
  17457. </em>
  17458. </td>
  17459. <td>
  17460. <em>(Optional)</em>
  17461. </td>
  17462. </tr>
  17463. </tbody>
  17464. </table>
  17465. <h3 id="external-secrets.io/v1beta1.AWSAuthSecretRef">AWSAuthSecretRef
  17466. </h3>
  17467. <p>
  17468. (<em>Appears on:</em>
  17469. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  17470. </p>
  17471. <p>
  17472. <p>AWSAuthSecretRef holds secret references for AWS credentials
  17473. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  17474. </p>
  17475. <table>
  17476. <thead>
  17477. <tr>
  17478. <th>Field</th>
  17479. <th>Description</th>
  17480. </tr>
  17481. </thead>
  17482. <tbody>
  17483. <tr>
  17484. <td>
  17485. <code>accessKeyIDSecretRef</code></br>
  17486. <em>
  17487. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17488. External Secrets meta/v1.SecretKeySelector
  17489. </a>
  17490. </em>
  17491. </td>
  17492. <td>
  17493. <p>The AccessKeyID is used for authentication</p>
  17494. </td>
  17495. </tr>
  17496. <tr>
  17497. <td>
  17498. <code>secretAccessKeySecretRef</code></br>
  17499. <em>
  17500. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17501. External Secrets meta/v1.SecretKeySelector
  17502. </a>
  17503. </em>
  17504. </td>
  17505. <td>
  17506. <p>The SecretAccessKey is used for authentication</p>
  17507. </td>
  17508. </tr>
  17509. <tr>
  17510. <td>
  17511. <code>sessionTokenSecretRef</code></br>
  17512. <em>
  17513. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17514. External Secrets meta/v1.SecretKeySelector
  17515. </a>
  17516. </em>
  17517. </td>
  17518. <td>
  17519. <p>The SessionToken used for authentication
  17520. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  17521. 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>
  17522. </td>
  17523. </tr>
  17524. </tbody>
  17525. </table>
  17526. <h3 id="external-secrets.io/v1beta1.AWSJWTAuth">AWSJWTAuth
  17527. </h3>
  17528. <p>
  17529. (<em>Appears on:</em>
  17530. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  17531. </p>
  17532. <p>
  17533. <p>AWSJWTAuth authenticates against AWS using service account tokens from the Kubernetes cluster.</p>
  17534. </p>
  17535. <table>
  17536. <thead>
  17537. <tr>
  17538. <th>Field</th>
  17539. <th>Description</th>
  17540. </tr>
  17541. </thead>
  17542. <tbody>
  17543. <tr>
  17544. <td>
  17545. <code>serviceAccountRef</code></br>
  17546. <em>
  17547. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17548. External Secrets meta/v1.ServiceAccountSelector
  17549. </a>
  17550. </em>
  17551. </td>
  17552. <td>
  17553. </td>
  17554. </tr>
  17555. </tbody>
  17556. </table>
  17557. <h3 id="external-secrets.io/v1beta1.AWSProvider">AWSProvider
  17558. </h3>
  17559. <p>
  17560. (<em>Appears on:</em>
  17561. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17562. </p>
  17563. <p>
  17564. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  17565. </p>
  17566. <table>
  17567. <thead>
  17568. <tr>
  17569. <th>Field</th>
  17570. <th>Description</th>
  17571. </tr>
  17572. </thead>
  17573. <tbody>
  17574. <tr>
  17575. <td>
  17576. <code>service</code></br>
  17577. <em>
  17578. <a href="#external-secrets.io/v1beta1.AWSServiceType">
  17579. AWSServiceType
  17580. </a>
  17581. </em>
  17582. </td>
  17583. <td>
  17584. <p>Service defines which service should be used to fetch the secrets</p>
  17585. </td>
  17586. </tr>
  17587. <tr>
  17588. <td>
  17589. <code>auth</code></br>
  17590. <em>
  17591. <a href="#external-secrets.io/v1beta1.AWSAuth">
  17592. AWSAuth
  17593. </a>
  17594. </em>
  17595. </td>
  17596. <td>
  17597. <em>(Optional)</em>
  17598. <p>Auth defines the information necessary to authenticate against AWS
  17599. if not set aws sdk will infer credentials from your environment
  17600. 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>
  17601. </td>
  17602. </tr>
  17603. <tr>
  17604. <td>
  17605. <code>role</code></br>
  17606. <em>
  17607. string
  17608. </em>
  17609. </td>
  17610. <td>
  17611. <em>(Optional)</em>
  17612. <p>Role is a Role ARN which the provider will assume</p>
  17613. </td>
  17614. </tr>
  17615. <tr>
  17616. <td>
  17617. <code>region</code></br>
  17618. <em>
  17619. string
  17620. </em>
  17621. </td>
  17622. <td>
  17623. <p>AWS Region to be used for the provider</p>
  17624. </td>
  17625. </tr>
  17626. <tr>
  17627. <td>
  17628. <code>additionalRoles</code></br>
  17629. <em>
  17630. []string
  17631. </em>
  17632. </td>
  17633. <td>
  17634. <em>(Optional)</em>
  17635. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  17636. </td>
  17637. </tr>
  17638. <tr>
  17639. <td>
  17640. <code>externalID</code></br>
  17641. <em>
  17642. string
  17643. </em>
  17644. </td>
  17645. <td>
  17646. <p>AWS External ID set on assumed IAM roles</p>
  17647. </td>
  17648. </tr>
  17649. <tr>
  17650. <td>
  17651. <code>sessionTags</code></br>
  17652. <em>
  17653. <a href="#external-secrets.io/v1beta1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag">
  17654. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag
  17655. </a>
  17656. </em>
  17657. </td>
  17658. <td>
  17659. <em>(Optional)</em>
  17660. <p>AWS STS assume role session tags</p>
  17661. </td>
  17662. </tr>
  17663. <tr>
  17664. <td>
  17665. <code>secretsManager</code></br>
  17666. <em>
  17667. <a href="#external-secrets.io/v1beta1.SecretsManager">
  17668. SecretsManager
  17669. </a>
  17670. </em>
  17671. </td>
  17672. <td>
  17673. <em>(Optional)</em>
  17674. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  17675. </td>
  17676. </tr>
  17677. <tr>
  17678. <td>
  17679. <code>transitiveTagKeys</code></br>
  17680. <em>
  17681. []*string
  17682. </em>
  17683. </td>
  17684. <td>
  17685. <em>(Optional)</em>
  17686. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  17687. </td>
  17688. </tr>
  17689. <tr>
  17690. <td>
  17691. <code>prefix</code></br>
  17692. <em>
  17693. string
  17694. </em>
  17695. </td>
  17696. <td>
  17697. <em>(Optional)</em>
  17698. <p>Prefix adds a prefix to all retrieved values.</p>
  17699. </td>
  17700. </tr>
  17701. </tbody>
  17702. </table>
  17703. <h3 id="external-secrets.io/v1beta1.AWSServiceType">AWSServiceType
  17704. (<code>string</code> alias)</p></h3>
  17705. <p>
  17706. (<em>Appears on:</em>
  17707. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  17708. </p>
  17709. <p>
  17710. <p>AWSServiceType is an enum that defines the service/API that is used to fetch the secrets.</p>
  17711. </p>
  17712. <table>
  17713. <thead>
  17714. <tr>
  17715. <th>Value</th>
  17716. <th>Description</th>
  17717. </tr>
  17718. </thead>
  17719. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  17720. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  17721. 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>
  17722. </td>
  17723. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  17724. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  17725. 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>
  17726. </td>
  17727. </tr></tbody>
  17728. </table>
  17729. <h3 id="external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth
  17730. </h3>
  17731. <p>
  17732. (<em>Appears on:</em>
  17733. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>)
  17734. </p>
  17735. <p>
  17736. <p>AkeylessAuth defines methods of authentication with Akeyless Vault.</p>
  17737. </p>
  17738. <table>
  17739. <thead>
  17740. <tr>
  17741. <th>Field</th>
  17742. <th>Description</th>
  17743. </tr>
  17744. </thead>
  17745. <tbody>
  17746. <tr>
  17747. <td>
  17748. <code>secretRef</code></br>
  17749. <em>
  17750. <a href="#external-secrets.io/v1beta1.AkeylessAuthSecretRef">
  17751. AkeylessAuthSecretRef
  17752. </a>
  17753. </em>
  17754. </td>
  17755. <td>
  17756. <em>(Optional)</em>
  17757. <p>Reference to a Secret that contains the details
  17758. to authenticate with Akeyless.</p>
  17759. </td>
  17760. </tr>
  17761. <tr>
  17762. <td>
  17763. <code>kubernetesAuth</code></br>
  17764. <em>
  17765. <a href="#external-secrets.io/v1beta1.AkeylessKubernetesAuth">
  17766. AkeylessKubernetesAuth
  17767. </a>
  17768. </em>
  17769. </td>
  17770. <td>
  17771. <em>(Optional)</em>
  17772. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  17773. token stored in the named Secret resource.</p>
  17774. </td>
  17775. </tr>
  17776. </tbody>
  17777. </table>
  17778. <h3 id="external-secrets.io/v1beta1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  17779. </h3>
  17780. <p>
  17781. (<em>Appears on:</em>
  17782. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  17783. </p>
  17784. <p>
  17785. <p>AkeylessAuthSecretRef defines how to authenticate using a secret reference.
  17786. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  17787. </p>
  17788. <table>
  17789. <thead>
  17790. <tr>
  17791. <th>Field</th>
  17792. <th>Description</th>
  17793. </tr>
  17794. </thead>
  17795. <tbody>
  17796. <tr>
  17797. <td>
  17798. <code>accessID</code></br>
  17799. <em>
  17800. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17801. External Secrets meta/v1.SecretKeySelector
  17802. </a>
  17803. </em>
  17804. </td>
  17805. <td>
  17806. <p>The SecretAccessID is used for authentication</p>
  17807. </td>
  17808. </tr>
  17809. <tr>
  17810. <td>
  17811. <code>accessType</code></br>
  17812. <em>
  17813. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17814. External Secrets meta/v1.SecretKeySelector
  17815. </a>
  17816. </em>
  17817. </td>
  17818. <td>
  17819. </td>
  17820. </tr>
  17821. <tr>
  17822. <td>
  17823. <code>accessTypeParam</code></br>
  17824. <em>
  17825. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17826. External Secrets meta/v1.SecretKeySelector
  17827. </a>
  17828. </em>
  17829. </td>
  17830. <td>
  17831. </td>
  17832. </tr>
  17833. </tbody>
  17834. </table>
  17835. <h3 id="external-secrets.io/v1beta1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  17836. </h3>
  17837. <p>
  17838. (<em>Appears on:</em>
  17839. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  17840. </p>
  17841. <p>
  17842. <p>AkeylessKubernetesAuth authenticates with Akeyless using a Kubernetes ServiceAccount token.</p>
  17843. </p>
  17844. <table>
  17845. <thead>
  17846. <tr>
  17847. <th>Field</th>
  17848. <th>Description</th>
  17849. </tr>
  17850. </thead>
  17851. <tbody>
  17852. <tr>
  17853. <td>
  17854. <code>accessID</code></br>
  17855. <em>
  17856. string
  17857. </em>
  17858. </td>
  17859. <td>
  17860. <p>the Akeyless Kubernetes auth-method access-id</p>
  17861. </td>
  17862. </tr>
  17863. <tr>
  17864. <td>
  17865. <code>k8sConfName</code></br>
  17866. <em>
  17867. string
  17868. </em>
  17869. </td>
  17870. <td>
  17871. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  17872. </td>
  17873. </tr>
  17874. <tr>
  17875. <td>
  17876. <code>serviceAccountRef</code></br>
  17877. <em>
  17878. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17879. External Secrets meta/v1.ServiceAccountSelector
  17880. </a>
  17881. </em>
  17882. </td>
  17883. <td>
  17884. <em>(Optional)</em>
  17885. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  17886. If the service account is specified, the service account secret token JWT will be used
  17887. for authenticating with Akeyless. If the service account selector is not supplied,
  17888. the secretRef will be used instead.</p>
  17889. </td>
  17890. </tr>
  17891. <tr>
  17892. <td>
  17893. <code>secretRef</code></br>
  17894. <em>
  17895. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17896. External Secrets meta/v1.SecretKeySelector
  17897. </a>
  17898. </em>
  17899. </td>
  17900. <td>
  17901. <em>(Optional)</em>
  17902. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  17903. for authenticating with Akeyless. If a name is specified without a key,
  17904. <code>token</code> is the default. If one is not specified, the one bound to
  17905. the controller will be used.</p>
  17906. </td>
  17907. </tr>
  17908. </tbody>
  17909. </table>
  17910. <h3 id="external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider
  17911. </h3>
  17912. <p>
  17913. (<em>Appears on:</em>
  17914. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17915. </p>
  17916. <p>
  17917. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  17918. </p>
  17919. <table>
  17920. <thead>
  17921. <tr>
  17922. <th>Field</th>
  17923. <th>Description</th>
  17924. </tr>
  17925. </thead>
  17926. <tbody>
  17927. <tr>
  17928. <td>
  17929. <code>akeylessGWApiURL</code></br>
  17930. <em>
  17931. string
  17932. </em>
  17933. </td>
  17934. <td>
  17935. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  17936. </td>
  17937. </tr>
  17938. <tr>
  17939. <td>
  17940. <code>authSecretRef</code></br>
  17941. <em>
  17942. <a href="#external-secrets.io/v1beta1.AkeylessAuth">
  17943. AkeylessAuth
  17944. </a>
  17945. </em>
  17946. </td>
  17947. <td>
  17948. <p>Auth configures how the operator authenticates with Akeyless.</p>
  17949. </td>
  17950. </tr>
  17951. <tr>
  17952. <td>
  17953. <code>caBundle</code></br>
  17954. <em>
  17955. []byte
  17956. </em>
  17957. </td>
  17958. <td>
  17959. <em>(Optional)</em>
  17960. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  17961. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  17962. are used to validate the TLS connection.</p>
  17963. </td>
  17964. </tr>
  17965. <tr>
  17966. <td>
  17967. <code>caProvider</code></br>
  17968. <em>
  17969. <a href="#external-secrets.io/v1beta1.CAProvider">
  17970. CAProvider
  17971. </a>
  17972. </em>
  17973. </td>
  17974. <td>
  17975. <em>(Optional)</em>
  17976. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  17977. </td>
  17978. </tr>
  17979. </tbody>
  17980. </table>
  17981. <h3 id="external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth
  17982. </h3>
  17983. <p>
  17984. (<em>Appears on:</em>
  17985. <a href="#external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider</a>)
  17986. </p>
  17987. <p>
  17988. <p>AlibabaAuth contains a secretRef for credentials.</p>
  17989. </p>
  17990. <table>
  17991. <thead>
  17992. <tr>
  17993. <th>Field</th>
  17994. <th>Description</th>
  17995. </tr>
  17996. </thead>
  17997. <tbody>
  17998. <tr>
  17999. <td>
  18000. <code>secretRef</code></br>
  18001. <em>
  18002. <a href="#external-secrets.io/v1beta1.AlibabaAuthSecretRef">
  18003. AlibabaAuthSecretRef
  18004. </a>
  18005. </em>
  18006. </td>
  18007. <td>
  18008. <em>(Optional)</em>
  18009. </td>
  18010. </tr>
  18011. <tr>
  18012. <td>
  18013. <code>rrsa</code></br>
  18014. <em>
  18015. <a href="#external-secrets.io/v1beta1.AlibabaRRSAAuth">
  18016. AlibabaRRSAAuth
  18017. </a>
  18018. </em>
  18019. </td>
  18020. <td>
  18021. <em>(Optional)</em>
  18022. </td>
  18023. </tr>
  18024. </tbody>
  18025. </table>
  18026. <h3 id="external-secrets.io/v1beta1.AlibabaAuthSecretRef">AlibabaAuthSecretRef
  18027. </h3>
  18028. <p>
  18029. (<em>Appears on:</em>
  18030. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  18031. </p>
  18032. <p>
  18033. <p>AlibabaAuthSecretRef holds secret references for Alibaba credentials.</p>
  18034. </p>
  18035. <table>
  18036. <thead>
  18037. <tr>
  18038. <th>Field</th>
  18039. <th>Description</th>
  18040. </tr>
  18041. </thead>
  18042. <tbody>
  18043. <tr>
  18044. <td>
  18045. <code>accessKeyIDSecretRef</code></br>
  18046. <em>
  18047. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18048. External Secrets meta/v1.SecretKeySelector
  18049. </a>
  18050. </em>
  18051. </td>
  18052. <td>
  18053. <p>The AccessKeyID is used for authentication</p>
  18054. </td>
  18055. </tr>
  18056. <tr>
  18057. <td>
  18058. <code>accessKeySecretSecretRef</code></br>
  18059. <em>
  18060. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18061. External Secrets meta/v1.SecretKeySelector
  18062. </a>
  18063. </em>
  18064. </td>
  18065. <td>
  18066. <p>The AccessKeySecret is used for authentication</p>
  18067. </td>
  18068. </tr>
  18069. </tbody>
  18070. </table>
  18071. <h3 id="external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider
  18072. </h3>
  18073. <p>
  18074. (<em>Appears on:</em>
  18075. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18076. </p>
  18077. <p>
  18078. <p>AlibabaProvider configures a store to sync secrets using the Alibaba Secret Manager provider.</p>
  18079. </p>
  18080. <table>
  18081. <thead>
  18082. <tr>
  18083. <th>Field</th>
  18084. <th>Description</th>
  18085. </tr>
  18086. </thead>
  18087. <tbody>
  18088. <tr>
  18089. <td>
  18090. <code>auth</code></br>
  18091. <em>
  18092. <a href="#external-secrets.io/v1beta1.AlibabaAuth">
  18093. AlibabaAuth
  18094. </a>
  18095. </em>
  18096. </td>
  18097. <td>
  18098. </td>
  18099. </tr>
  18100. <tr>
  18101. <td>
  18102. <code>regionID</code></br>
  18103. <em>
  18104. string
  18105. </em>
  18106. </td>
  18107. <td>
  18108. <p>Alibaba Region to be used for the provider</p>
  18109. </td>
  18110. </tr>
  18111. </tbody>
  18112. </table>
  18113. <h3 id="external-secrets.io/v1beta1.AlibabaRRSAAuth">AlibabaRRSAAuth
  18114. </h3>
  18115. <p>
  18116. (<em>Appears on:</em>
  18117. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  18118. </p>
  18119. <p>
  18120. <p>AlibabaRRSAAuth authenticates against Alibaba using RRSA (Resource-oriented RAM-based Service Authentication).</p>
  18121. </p>
  18122. <table>
  18123. <thead>
  18124. <tr>
  18125. <th>Field</th>
  18126. <th>Description</th>
  18127. </tr>
  18128. </thead>
  18129. <tbody>
  18130. <tr>
  18131. <td>
  18132. <code>oidcProviderArn</code></br>
  18133. <em>
  18134. string
  18135. </em>
  18136. </td>
  18137. <td>
  18138. </td>
  18139. </tr>
  18140. <tr>
  18141. <td>
  18142. <code>oidcTokenFilePath</code></br>
  18143. <em>
  18144. string
  18145. </em>
  18146. </td>
  18147. <td>
  18148. </td>
  18149. </tr>
  18150. <tr>
  18151. <td>
  18152. <code>roleArn</code></br>
  18153. <em>
  18154. string
  18155. </em>
  18156. </td>
  18157. <td>
  18158. </td>
  18159. </tr>
  18160. <tr>
  18161. <td>
  18162. <code>sessionName</code></br>
  18163. <em>
  18164. string
  18165. </em>
  18166. </td>
  18167. <td>
  18168. </td>
  18169. </tr>
  18170. </tbody>
  18171. </table>
  18172. <h3 id="external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol
  18173. </h3>
  18174. <p>
  18175. (<em>Appears on:</em>
  18176. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  18177. </p>
  18178. <p>
  18179. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  18180. </p>
  18181. <table>
  18182. <thead>
  18183. <tr>
  18184. <th>Field</th>
  18185. <th>Description</th>
  18186. </tr>
  18187. </thead>
  18188. <tbody>
  18189. <tr>
  18190. <td>
  18191. <code>ntlm</code></br>
  18192. <em>
  18193. <a href="#external-secrets.io/v1beta1.NTLMProtocol">
  18194. NTLMProtocol
  18195. </a>
  18196. </em>
  18197. </td>
  18198. <td>
  18199. <em>(Optional)</em>
  18200. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  18201. </td>
  18202. </tr>
  18203. </tbody>
  18204. </table>
  18205. <h3 id="external-secrets.io/v1beta1.AzureAuthType">AzureAuthType
  18206. (<code>string</code> alias)</p></h3>
  18207. <p>
  18208. (<em>Appears on:</em>
  18209. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  18210. </p>
  18211. <p>
  18212. <p>AzureAuthType describes how to authenticate to the Azure Keyvault.
  18213. Only one of the following auth types may be specified.
  18214. If none of the following auth type is specified, the default one
  18215. is ServicePrincipal.</p>
  18216. </p>
  18217. <table>
  18218. <thead>
  18219. <tr>
  18220. <th>Value</th>
  18221. <th>Description</th>
  18222. </tr>
  18223. </thead>
  18224. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  18225. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  18226. </td>
  18227. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  18228. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  18229. </td>
  18230. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  18231. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  18232. </td>
  18233. </tr></tbody>
  18234. </table>
  18235. <h3 id="external-secrets.io/v1beta1.AzureEnvironmentType">AzureEnvironmentType
  18236. (<code>string</code> alias)</p></h3>
  18237. <p>
  18238. (<em>Appears on:</em>
  18239. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  18240. </p>
  18241. <p>
  18242. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  18243. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  18244. 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>
  18245. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  18246. </p>
  18247. <table>
  18248. <thead>
  18249. <tr>
  18250. <th>Value</th>
  18251. <th>Description</th>
  18252. </tr>
  18253. </thead>
  18254. <tbody><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  18255. <td><p>AzureEnvironmentChinaCloud represents the Azure China cloud environment.</p>
  18256. </td>
  18257. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  18258. <td><p>AzureEnvironmentGermanCloud represents the Azure German cloud environment.</p>
  18259. </td>
  18260. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  18261. <td><p>AzureEnvironmentPublicCloud represents the Azure public cloud environment.</p>
  18262. </td>
  18263. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  18264. <td><p>AzureEnvironmentUSGovernmentCloud represents the Azure US government cloud environment.</p>
  18265. </td>
  18266. </tr></tbody>
  18267. </table>
  18268. <h3 id="external-secrets.io/v1beta1.AzureKVAuth">AzureKVAuth
  18269. </h3>
  18270. <p>
  18271. (<em>Appears on:</em>
  18272. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  18273. </p>
  18274. <p>
  18275. <p>AzureKVAuth defines configuration for authentication with Azure Key Vault.</p>
  18276. </p>
  18277. <table>
  18278. <thead>
  18279. <tr>
  18280. <th>Field</th>
  18281. <th>Description</th>
  18282. </tr>
  18283. </thead>
  18284. <tbody>
  18285. <tr>
  18286. <td>
  18287. <code>clientId</code></br>
  18288. <em>
  18289. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18290. External Secrets meta/v1.SecretKeySelector
  18291. </a>
  18292. </em>
  18293. </td>
  18294. <td>
  18295. <em>(Optional)</em>
  18296. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  18297. </td>
  18298. </tr>
  18299. <tr>
  18300. <td>
  18301. <code>tenantId</code></br>
  18302. <em>
  18303. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18304. External Secrets meta/v1.SecretKeySelector
  18305. </a>
  18306. </em>
  18307. </td>
  18308. <td>
  18309. <em>(Optional)</em>
  18310. <p>The Azure tenantId of the managed identity used for authentication.</p>
  18311. </td>
  18312. </tr>
  18313. <tr>
  18314. <td>
  18315. <code>clientSecret</code></br>
  18316. <em>
  18317. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18318. External Secrets meta/v1.SecretKeySelector
  18319. </a>
  18320. </em>
  18321. </td>
  18322. <td>
  18323. <em>(Optional)</em>
  18324. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  18325. </td>
  18326. </tr>
  18327. <tr>
  18328. <td>
  18329. <code>clientCertificate</code></br>
  18330. <em>
  18331. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18332. External Secrets meta/v1.SecretKeySelector
  18333. </a>
  18334. </em>
  18335. </td>
  18336. <td>
  18337. <em>(Optional)</em>
  18338. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  18339. </td>
  18340. </tr>
  18341. </tbody>
  18342. </table>
  18343. <h3 id="external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider
  18344. </h3>
  18345. <p>
  18346. (<em>Appears on:</em>
  18347. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18348. </p>
  18349. <p>
  18350. <p>AzureKVProvider configures a store to sync secrets using Azure Key Vault.</p>
  18351. </p>
  18352. <table>
  18353. <thead>
  18354. <tr>
  18355. <th>Field</th>
  18356. <th>Description</th>
  18357. </tr>
  18358. </thead>
  18359. <tbody>
  18360. <tr>
  18361. <td>
  18362. <code>authType</code></br>
  18363. <em>
  18364. <a href="#external-secrets.io/v1beta1.AzureAuthType">
  18365. AzureAuthType
  18366. </a>
  18367. </em>
  18368. </td>
  18369. <td>
  18370. <em>(Optional)</em>
  18371. <p>Auth type defines how to authenticate to the keyvault service.
  18372. Valid values are:
  18373. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  18374. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)</p>
  18375. </td>
  18376. </tr>
  18377. <tr>
  18378. <td>
  18379. <code>vaultUrl</code></br>
  18380. <em>
  18381. string
  18382. </em>
  18383. </td>
  18384. <td>
  18385. <p>Vault Url from which the secrets to be fetched from.</p>
  18386. </td>
  18387. </tr>
  18388. <tr>
  18389. <td>
  18390. <code>tenantId</code></br>
  18391. <em>
  18392. string
  18393. </em>
  18394. </td>
  18395. <td>
  18396. <em>(Optional)</em>
  18397. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  18398. </td>
  18399. </tr>
  18400. <tr>
  18401. <td>
  18402. <code>environmentType</code></br>
  18403. <em>
  18404. <a href="#external-secrets.io/v1beta1.AzureEnvironmentType">
  18405. AzureEnvironmentType
  18406. </a>
  18407. </em>
  18408. </td>
  18409. <td>
  18410. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  18411. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  18412. 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>
  18413. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  18414. </td>
  18415. </tr>
  18416. <tr>
  18417. <td>
  18418. <code>authSecretRef</code></br>
  18419. <em>
  18420. <a href="#external-secrets.io/v1beta1.AzureKVAuth">
  18421. AzureKVAuth
  18422. </a>
  18423. </em>
  18424. </td>
  18425. <td>
  18426. <em>(Optional)</em>
  18427. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  18428. </td>
  18429. </tr>
  18430. <tr>
  18431. <td>
  18432. <code>serviceAccountRef</code></br>
  18433. <em>
  18434. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  18435. External Secrets meta/v1.ServiceAccountSelector
  18436. </a>
  18437. </em>
  18438. </td>
  18439. <td>
  18440. <em>(Optional)</em>
  18441. <p>ServiceAccountRef specified the service account
  18442. that should be used when authenticating with WorkloadIdentity.</p>
  18443. </td>
  18444. </tr>
  18445. <tr>
  18446. <td>
  18447. <code>identityId</code></br>
  18448. <em>
  18449. string
  18450. </em>
  18451. </td>
  18452. <td>
  18453. <em>(Optional)</em>
  18454. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  18455. </td>
  18456. </tr>
  18457. </tbody>
  18458. </table>
  18459. <h3 id="external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  18460. </h3>
  18461. <p>
  18462. (<em>Appears on:</em>
  18463. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth</a>)
  18464. </p>
  18465. <p>
  18466. <p>BeyondTrustProviderSecretRef defines a reference to a secret containing credentials for the BeyondTrust provider.</p>
  18467. </p>
  18468. <table>
  18469. <thead>
  18470. <tr>
  18471. <th>Field</th>
  18472. <th>Description</th>
  18473. </tr>
  18474. </thead>
  18475. <tbody>
  18476. <tr>
  18477. <td>
  18478. <code>value</code></br>
  18479. <em>
  18480. string
  18481. </em>
  18482. </td>
  18483. <td>
  18484. <em>(Optional)</em>
  18485. <p>Value can be specified directly to set a value without using a secret.</p>
  18486. </td>
  18487. </tr>
  18488. <tr>
  18489. <td>
  18490. <code>secretRef</code></br>
  18491. <em>
  18492. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18493. External Secrets meta/v1.SecretKeySelector
  18494. </a>
  18495. </em>
  18496. </td>
  18497. <td>
  18498. <em>(Optional)</em>
  18499. <p>SecretRef references a key in a secret that will be used as value.</p>
  18500. </td>
  18501. </tr>
  18502. </tbody>
  18503. </table>
  18504. <h3 id="external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth
  18505. </h3>
  18506. <p>
  18507. (<em>Appears on:</em>
  18508. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  18509. </p>
  18510. <p>
  18511. <p>BeyondtrustAuth configures authentication for BeyondTrust Password Safe.</p>
  18512. </p>
  18513. <table>
  18514. <thead>
  18515. <tr>
  18516. <th>Field</th>
  18517. <th>Description</th>
  18518. </tr>
  18519. </thead>
  18520. <tbody>
  18521. <tr>
  18522. <td>
  18523. <code>apiKey</code></br>
  18524. <em>
  18525. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  18526. BeyondTrustProviderSecretRef
  18527. </a>
  18528. </em>
  18529. </td>
  18530. <td>
  18531. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  18532. </td>
  18533. </tr>
  18534. <tr>
  18535. <td>
  18536. <code>clientId</code></br>
  18537. <em>
  18538. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  18539. BeyondTrustProviderSecretRef
  18540. </a>
  18541. </em>
  18542. </td>
  18543. <td>
  18544. <p>ClientID is the API OAuth Client ID.</p>
  18545. </td>
  18546. </tr>
  18547. <tr>
  18548. <td>
  18549. <code>clientSecret</code></br>
  18550. <em>
  18551. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  18552. BeyondTrustProviderSecretRef
  18553. </a>
  18554. </em>
  18555. </td>
  18556. <td>
  18557. <p>ClientSecret is the API OAuth Client Secret.</p>
  18558. </td>
  18559. </tr>
  18560. <tr>
  18561. <td>
  18562. <code>certificate</code></br>
  18563. <em>
  18564. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  18565. BeyondTrustProviderSecretRef
  18566. </a>
  18567. </em>
  18568. </td>
  18569. <td>
  18570. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  18571. </td>
  18572. </tr>
  18573. <tr>
  18574. <td>
  18575. <code>certificateKey</code></br>
  18576. <em>
  18577. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  18578. BeyondTrustProviderSecretRef
  18579. </a>
  18580. </em>
  18581. </td>
  18582. <td>
  18583. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  18584. </td>
  18585. </tr>
  18586. </tbody>
  18587. </table>
  18588. <h3 id="external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider
  18589. </h3>
  18590. <p>
  18591. (<em>Appears on:</em>
  18592. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18593. </p>
  18594. <p>
  18595. <p>BeyondtrustProvider defines configuration for the BeyondTrust Password Safe provider.</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>auth</code></br>
  18608. <em>
  18609. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">
  18610. BeyondtrustAuth
  18611. </a>
  18612. </em>
  18613. </td>
  18614. <td>
  18615. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  18616. </td>
  18617. </tr>
  18618. <tr>
  18619. <td>
  18620. <code>server</code></br>
  18621. <em>
  18622. <a href="#external-secrets.io/v1beta1.BeyondtrustServer">
  18623. BeyondtrustServer
  18624. </a>
  18625. </em>
  18626. </td>
  18627. <td>
  18628. <p>Auth configures how API server works.</p>
  18629. </td>
  18630. </tr>
  18631. </tbody>
  18632. </table>
  18633. <h3 id="external-secrets.io/v1beta1.BeyondtrustServer">BeyondtrustServer
  18634. </h3>
  18635. <p>
  18636. (<em>Appears on:</em>
  18637. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  18638. </p>
  18639. <p>
  18640. <p>BeyondtrustServer defines configuration for connecting to BeyondTrust Password Safe server.</p>
  18641. </p>
  18642. <table>
  18643. <thead>
  18644. <tr>
  18645. <th>Field</th>
  18646. <th>Description</th>
  18647. </tr>
  18648. </thead>
  18649. <tbody>
  18650. <tr>
  18651. <td>
  18652. <code>apiUrl</code></br>
  18653. <em>
  18654. string
  18655. </em>
  18656. </td>
  18657. <td>
  18658. </td>
  18659. </tr>
  18660. <tr>
  18661. <td>
  18662. <code>apiVersion</code></br>
  18663. <em>
  18664. string
  18665. </em>
  18666. </td>
  18667. <td>
  18668. </td>
  18669. </tr>
  18670. <tr>
  18671. <td>
  18672. <code>retrievalType</code></br>
  18673. <em>
  18674. string
  18675. </em>
  18676. </td>
  18677. <td>
  18678. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  18679. </td>
  18680. </tr>
  18681. <tr>
  18682. <td>
  18683. <code>separator</code></br>
  18684. <em>
  18685. string
  18686. </em>
  18687. </td>
  18688. <td>
  18689. <p>A character that separates the folder names.</p>
  18690. </td>
  18691. </tr>
  18692. <tr>
  18693. <td>
  18694. <code>decrypt</code></br>
  18695. <em>
  18696. bool
  18697. </em>
  18698. </td>
  18699. <td>
  18700. <em>(Optional)</em>
  18701. <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>
  18702. </td>
  18703. </tr>
  18704. <tr>
  18705. <td>
  18706. <code>verifyCA</code></br>
  18707. <em>
  18708. bool
  18709. </em>
  18710. </td>
  18711. <td>
  18712. </td>
  18713. </tr>
  18714. <tr>
  18715. <td>
  18716. <code>clientTimeOutSeconds</code></br>
  18717. <em>
  18718. int
  18719. </em>
  18720. </td>
  18721. <td>
  18722. <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>
  18723. </td>
  18724. </tr>
  18725. </tbody>
  18726. </table>
  18727. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  18728. </h3>
  18729. <p>
  18730. (<em>Appears on:</em>
  18731. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  18732. </p>
  18733. <p>
  18734. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  18735. </p>
  18736. <table>
  18737. <thead>
  18738. <tr>
  18739. <th>Field</th>
  18740. <th>Description</th>
  18741. </tr>
  18742. </thead>
  18743. <tbody>
  18744. <tr>
  18745. <td>
  18746. <code>secretRef</code></br>
  18747. <em>
  18748. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">
  18749. BitwardenSecretsManagerSecretRef
  18750. </a>
  18751. </em>
  18752. </td>
  18753. <td>
  18754. </td>
  18755. </tr>
  18756. </tbody>
  18757. </table>
  18758. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  18759. </h3>
  18760. <p>
  18761. (<em>Appears on:</em>
  18762. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18763. </p>
  18764. <p>
  18765. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  18766. </p>
  18767. <table>
  18768. <thead>
  18769. <tr>
  18770. <th>Field</th>
  18771. <th>Description</th>
  18772. </tr>
  18773. </thead>
  18774. <tbody>
  18775. <tr>
  18776. <td>
  18777. <code>apiURL</code></br>
  18778. <em>
  18779. string
  18780. </em>
  18781. </td>
  18782. <td>
  18783. </td>
  18784. </tr>
  18785. <tr>
  18786. <td>
  18787. <code>identityURL</code></br>
  18788. <em>
  18789. string
  18790. </em>
  18791. </td>
  18792. <td>
  18793. </td>
  18794. </tr>
  18795. <tr>
  18796. <td>
  18797. <code>bitwardenServerSDKURL</code></br>
  18798. <em>
  18799. string
  18800. </em>
  18801. </td>
  18802. <td>
  18803. </td>
  18804. </tr>
  18805. <tr>
  18806. <td>
  18807. <code>caBundle</code></br>
  18808. <em>
  18809. string
  18810. </em>
  18811. </td>
  18812. <td>
  18813. <em>(Optional)</em>
  18814. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  18815. can be performed.</p>
  18816. </td>
  18817. </tr>
  18818. <tr>
  18819. <td>
  18820. <code>caProvider</code></br>
  18821. <em>
  18822. <a href="#external-secrets.io/v1beta1.CAProvider">
  18823. CAProvider
  18824. </a>
  18825. </em>
  18826. </td>
  18827. <td>
  18828. <em>(Optional)</em>
  18829. <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>
  18830. </td>
  18831. </tr>
  18832. <tr>
  18833. <td>
  18834. <code>organizationID</code></br>
  18835. <em>
  18836. string
  18837. </em>
  18838. </td>
  18839. <td>
  18840. <p>OrganizationID determines which organization this secret store manages.</p>
  18841. </td>
  18842. </tr>
  18843. <tr>
  18844. <td>
  18845. <code>projectID</code></br>
  18846. <em>
  18847. string
  18848. </em>
  18849. </td>
  18850. <td>
  18851. <p>ProjectID determines which project this secret store manages.</p>
  18852. </td>
  18853. </tr>
  18854. <tr>
  18855. <td>
  18856. <code>auth</code></br>
  18857. <em>
  18858. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">
  18859. BitwardenSecretsManagerAuth
  18860. </a>
  18861. </em>
  18862. </td>
  18863. <td>
  18864. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  18865. Make sure that the token being used has permissions on the given secret.</p>
  18866. </td>
  18867. </tr>
  18868. </tbody>
  18869. </table>
  18870. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  18871. </h3>
  18872. <p>
  18873. (<em>Appears on:</em>
  18874. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  18875. </p>
  18876. <p>
  18877. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  18878. </p>
  18879. <table>
  18880. <thead>
  18881. <tr>
  18882. <th>Field</th>
  18883. <th>Description</th>
  18884. </tr>
  18885. </thead>
  18886. <tbody>
  18887. <tr>
  18888. <td>
  18889. <code>credentials</code></br>
  18890. <em>
  18891. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18892. External Secrets meta/v1.SecretKeySelector
  18893. </a>
  18894. </em>
  18895. </td>
  18896. <td>
  18897. <p>AccessToken used for the bitwarden instance.</p>
  18898. </td>
  18899. </tr>
  18900. </tbody>
  18901. </table>
  18902. <h3 id="external-secrets.io/v1beta1.CAProvider">CAProvider
  18903. </h3>
  18904. <p>
  18905. (<em>Appears on:</em>
  18906. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>,
  18907. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  18908. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>,
  18909. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>,
  18910. <a href="#external-secrets.io/v1beta1.KubernetesServer">KubernetesServer</a>,
  18911. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  18912. </p>
  18913. <p>
  18914. <p>CAProvider provides custom certificate authority (CA) certificates
  18915. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  18916. that contains a PEM-encoded certificate.</p>
  18917. </p>
  18918. <table>
  18919. <thead>
  18920. <tr>
  18921. <th>Field</th>
  18922. <th>Description</th>
  18923. </tr>
  18924. </thead>
  18925. <tbody>
  18926. <tr>
  18927. <td>
  18928. <code>type</code></br>
  18929. <em>
  18930. <a href="#external-secrets.io/v1beta1.CAProviderType">
  18931. CAProviderType
  18932. </a>
  18933. </em>
  18934. </td>
  18935. <td>
  18936. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  18937. </td>
  18938. </tr>
  18939. <tr>
  18940. <td>
  18941. <code>name</code></br>
  18942. <em>
  18943. string
  18944. </em>
  18945. </td>
  18946. <td>
  18947. <p>The name of the object located at the provider type.</p>
  18948. </td>
  18949. </tr>
  18950. <tr>
  18951. <td>
  18952. <code>key</code></br>
  18953. <em>
  18954. string
  18955. </em>
  18956. </td>
  18957. <td>
  18958. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  18959. </td>
  18960. </tr>
  18961. <tr>
  18962. <td>
  18963. <code>namespace</code></br>
  18964. <em>
  18965. string
  18966. </em>
  18967. </td>
  18968. <td>
  18969. <em>(Optional)</em>
  18970. <p>The namespace the Provider type is in.
  18971. Can only be defined when used in a ClusterSecretStore.</p>
  18972. </td>
  18973. </tr>
  18974. </tbody>
  18975. </table>
  18976. <h3 id="external-secrets.io/v1beta1.CAProviderType">CAProviderType
  18977. (<code>string</code> alias)</p></h3>
  18978. <p>
  18979. (<em>Appears on:</em>
  18980. <a href="#external-secrets.io/v1beta1.CAProvider">CAProvider</a>)
  18981. </p>
  18982. <p>
  18983. <p>CAProviderType defines the type of provider to use for CA certificates.</p>
  18984. </p>
  18985. <table>
  18986. <thead>
  18987. <tr>
  18988. <th>Value</th>
  18989. <th>Description</th>
  18990. </tr>
  18991. </thead>
  18992. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  18993. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  18994. </td>
  18995. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  18996. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  18997. </td>
  18998. </tr></tbody>
  18999. </table>
  19000. <h3 id="external-secrets.io/v1beta1.CSMAuth">CSMAuth
  19001. </h3>
  19002. <p>
  19003. (<em>Appears on:</em>
  19004. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider</a>)
  19005. </p>
  19006. <p>
  19007. <p>CSMAuth contains a secretRef for credentials.</p>
  19008. </p>
  19009. <table>
  19010. <thead>
  19011. <tr>
  19012. <th>Field</th>
  19013. <th>Description</th>
  19014. </tr>
  19015. </thead>
  19016. <tbody>
  19017. <tr>
  19018. <td>
  19019. <code>secretRef</code></br>
  19020. <em>
  19021. <a href="#external-secrets.io/v1beta1.CSMAuthSecretRef">
  19022. CSMAuthSecretRef
  19023. </a>
  19024. </em>
  19025. </td>
  19026. <td>
  19027. <em>(Optional)</em>
  19028. </td>
  19029. </tr>
  19030. </tbody>
  19031. </table>
  19032. <h3 id="external-secrets.io/v1beta1.CSMAuthSecretRef">CSMAuthSecretRef
  19033. </h3>
  19034. <p>
  19035. (<em>Appears on:</em>
  19036. <a href="#external-secrets.io/v1beta1.CSMAuth">CSMAuth</a>)
  19037. </p>
  19038. <p>
  19039. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  19040. </p>
  19041. <table>
  19042. <thead>
  19043. <tr>
  19044. <th>Field</th>
  19045. <th>Description</th>
  19046. </tr>
  19047. </thead>
  19048. <tbody>
  19049. <tr>
  19050. <td>
  19051. <code>accessKeyIDSecretRef</code></br>
  19052. <em>
  19053. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19054. External Secrets meta/v1.SecretKeySelector
  19055. </a>
  19056. </em>
  19057. </td>
  19058. <td>
  19059. <p>The AccessKeyID is used for authentication</p>
  19060. </td>
  19061. </tr>
  19062. <tr>
  19063. <td>
  19064. <code>accessKeySecretSecretRef</code></br>
  19065. <em>
  19066. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19067. External Secrets meta/v1.SecretKeySelector
  19068. </a>
  19069. </em>
  19070. </td>
  19071. <td>
  19072. <p>The AccessKeySecret is used for authentication</p>
  19073. </td>
  19074. </tr>
  19075. </tbody>
  19076. </table>
  19077. <h3 id="external-secrets.io/v1beta1.CertAuth">CertAuth
  19078. </h3>
  19079. <p>
  19080. (<em>Appears on:</em>
  19081. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  19082. </p>
  19083. <p>
  19084. <p>CertAuth defines certificate-based authentication for the Kubernetes provider.</p>
  19085. </p>
  19086. <table>
  19087. <thead>
  19088. <tr>
  19089. <th>Field</th>
  19090. <th>Description</th>
  19091. </tr>
  19092. </thead>
  19093. <tbody>
  19094. <tr>
  19095. <td>
  19096. <code>clientCert</code></br>
  19097. <em>
  19098. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19099. External Secrets meta/v1.SecretKeySelector
  19100. </a>
  19101. </em>
  19102. </td>
  19103. <td>
  19104. </td>
  19105. </tr>
  19106. <tr>
  19107. <td>
  19108. <code>clientKey</code></br>
  19109. <em>
  19110. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19111. External Secrets meta/v1.SecretKeySelector
  19112. </a>
  19113. </em>
  19114. </td>
  19115. <td>
  19116. </td>
  19117. </tr>
  19118. </tbody>
  19119. </table>
  19120. <h3 id="external-secrets.io/v1beta1.ChefAuth">ChefAuth
  19121. </h3>
  19122. <p>
  19123. (<em>Appears on:</em>
  19124. <a href="#external-secrets.io/v1beta1.ChefProvider">ChefProvider</a>)
  19125. </p>
  19126. <p>
  19127. <p>ChefAuth contains a secretRef for credentials.</p>
  19128. </p>
  19129. <table>
  19130. <thead>
  19131. <tr>
  19132. <th>Field</th>
  19133. <th>Description</th>
  19134. </tr>
  19135. </thead>
  19136. <tbody>
  19137. <tr>
  19138. <td>
  19139. <code>secretRef</code></br>
  19140. <em>
  19141. <a href="#external-secrets.io/v1beta1.ChefAuthSecretRef">
  19142. ChefAuthSecretRef
  19143. </a>
  19144. </em>
  19145. </td>
  19146. <td>
  19147. </td>
  19148. </tr>
  19149. </tbody>
  19150. </table>
  19151. <h3 id="external-secrets.io/v1beta1.ChefAuthSecretRef">ChefAuthSecretRef
  19152. </h3>
  19153. <p>
  19154. (<em>Appears on:</em>
  19155. <a href="#external-secrets.io/v1beta1.ChefAuth">ChefAuth</a>)
  19156. </p>
  19157. <p>
  19158. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  19159. </p>
  19160. <table>
  19161. <thead>
  19162. <tr>
  19163. <th>Field</th>
  19164. <th>Description</th>
  19165. </tr>
  19166. </thead>
  19167. <tbody>
  19168. <tr>
  19169. <td>
  19170. <code>privateKeySecretRef</code></br>
  19171. <em>
  19172. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19173. External Secrets meta/v1.SecretKeySelector
  19174. </a>
  19175. </em>
  19176. </td>
  19177. <td>
  19178. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  19179. </td>
  19180. </tr>
  19181. </tbody>
  19182. </table>
  19183. <h3 id="external-secrets.io/v1beta1.ChefProvider">ChefProvider
  19184. </h3>
  19185. <p>
  19186. (<em>Appears on:</em>
  19187. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19188. </p>
  19189. <p>
  19190. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  19191. </p>
  19192. <table>
  19193. <thead>
  19194. <tr>
  19195. <th>Field</th>
  19196. <th>Description</th>
  19197. </tr>
  19198. </thead>
  19199. <tbody>
  19200. <tr>
  19201. <td>
  19202. <code>auth</code></br>
  19203. <em>
  19204. <a href="#external-secrets.io/v1beta1.ChefAuth">
  19205. ChefAuth
  19206. </a>
  19207. </em>
  19208. </td>
  19209. <td>
  19210. <p>Auth defines the information necessary to authenticate against chef Server</p>
  19211. </td>
  19212. </tr>
  19213. <tr>
  19214. <td>
  19215. <code>username</code></br>
  19216. <em>
  19217. string
  19218. </em>
  19219. </td>
  19220. <td>
  19221. <p>UserName should be the user ID on the chef server</p>
  19222. </td>
  19223. </tr>
  19224. <tr>
  19225. <td>
  19226. <code>serverUrl</code></br>
  19227. <em>
  19228. string
  19229. </em>
  19230. </td>
  19231. <td>
  19232. <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>
  19233. </td>
  19234. </tr>
  19235. </tbody>
  19236. </table>
  19237. <h3 id="external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider
  19238. </h3>
  19239. <p>
  19240. (<em>Appears on:</em>
  19241. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19242. </p>
  19243. <p>
  19244. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  19245. </p>
  19246. <table>
  19247. <thead>
  19248. <tr>
  19249. <th>Field</th>
  19250. <th>Description</th>
  19251. </tr>
  19252. </thead>
  19253. <tbody>
  19254. <tr>
  19255. <td>
  19256. <code>auth</code></br>
  19257. <em>
  19258. <a href="#external-secrets.io/v1beta1.CSMAuth">
  19259. CSMAuth
  19260. </a>
  19261. </em>
  19262. </td>
  19263. <td>
  19264. </td>
  19265. </tr>
  19266. <tr>
  19267. <td>
  19268. <code>projectID</code></br>
  19269. <em>
  19270. string
  19271. </em>
  19272. </td>
  19273. <td>
  19274. <p>ProjectID is the project, which the secrets are stored in.</p>
  19275. </td>
  19276. </tr>
  19277. </tbody>
  19278. </table>
  19279. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret
  19280. </h3>
  19281. <p>
  19282. <p>ClusterExternalSecret is the schema for the clusterexternalsecrets API.</p>
  19283. </p>
  19284. <table>
  19285. <thead>
  19286. <tr>
  19287. <th>Field</th>
  19288. <th>Description</th>
  19289. </tr>
  19290. </thead>
  19291. <tbody>
  19292. <tr>
  19293. <td>
  19294. <code>metadata</code></br>
  19295. <em>
  19296. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  19297. Kubernetes meta/v1.ObjectMeta
  19298. </a>
  19299. </em>
  19300. </td>
  19301. <td>
  19302. Refer to the Kubernetes API documentation for the fields of the
  19303. <code>metadata</code> field.
  19304. </td>
  19305. </tr>
  19306. <tr>
  19307. <td>
  19308. <code>spec</code></br>
  19309. <em>
  19310. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">
  19311. ClusterExternalSecretSpec
  19312. </a>
  19313. </em>
  19314. </td>
  19315. <td>
  19316. <br/>
  19317. <br/>
  19318. <table>
  19319. <tr>
  19320. <td>
  19321. <code>externalSecretSpec</code></br>
  19322. <em>
  19323. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  19324. ExternalSecretSpec
  19325. </a>
  19326. </em>
  19327. </td>
  19328. <td>
  19329. <p>The spec for the ExternalSecrets to be created</p>
  19330. </td>
  19331. </tr>
  19332. <tr>
  19333. <td>
  19334. <code>externalSecretName</code></br>
  19335. <em>
  19336. string
  19337. </em>
  19338. </td>
  19339. <td>
  19340. <em>(Optional)</em>
  19341. <p>The name of the external secrets to be created.
  19342. Defaults to the name of the ClusterExternalSecret</p>
  19343. </td>
  19344. </tr>
  19345. <tr>
  19346. <td>
  19347. <code>externalSecretMetadata</code></br>
  19348. <em>
  19349. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  19350. ExternalSecretMetadata
  19351. </a>
  19352. </em>
  19353. </td>
  19354. <td>
  19355. <em>(Optional)</em>
  19356. <p>The metadata of the external secrets to be created</p>
  19357. </td>
  19358. </tr>
  19359. <tr>
  19360. <td>
  19361. <code>namespaceSelector</code></br>
  19362. <em>
  19363. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  19364. Kubernetes meta/v1.LabelSelector
  19365. </a>
  19366. </em>
  19367. </td>
  19368. <td>
  19369. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  19370. </td>
  19371. </tr>
  19372. <tr>
  19373. <td>
  19374. <code>namespaceSelectors</code></br>
  19375. <em>
  19376. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  19377. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  19378. </a>
  19379. </em>
  19380. </td>
  19381. <td>
  19382. <em>(Optional)</em>
  19383. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  19384. </td>
  19385. </tr>
  19386. <tr>
  19387. <td>
  19388. <code>namespaces</code></br>
  19389. <em>
  19390. []string
  19391. </em>
  19392. </td>
  19393. <td>
  19394. <em>(Optional)</em>
  19395. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  19396. <p>Deprecated: Use NamespaceSelectors instead.</p>
  19397. </td>
  19398. </tr>
  19399. <tr>
  19400. <td>
  19401. <code>refreshTime</code></br>
  19402. <em>
  19403. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  19404. Kubernetes meta/v1.Duration
  19405. </a>
  19406. </em>
  19407. </td>
  19408. <td>
  19409. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  19410. </td>
  19411. </tr>
  19412. </table>
  19413. </td>
  19414. </tr>
  19415. <tr>
  19416. <td>
  19417. <code>status</code></br>
  19418. <em>
  19419. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">
  19420. ClusterExternalSecretStatus
  19421. </a>
  19422. </em>
  19423. </td>
  19424. <td>
  19425. </td>
  19426. </tr>
  19427. </tbody>
  19428. </table>
  19429. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  19430. (<code>string</code> alias)</p></h3>
  19431. <p>
  19432. (<em>Appears on:</em>
  19433. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  19434. </p>
  19435. <p>
  19436. <p>ClusterExternalSecretConditionType indicates the condition of the ClusterExternalSecret.</p>
  19437. </p>
  19438. <table>
  19439. <thead>
  19440. <tr>
  19441. <th>Value</th>
  19442. <th>Description</th>
  19443. </tr>
  19444. </thead>
  19445. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  19446. <td><p>ClusterExternalSecretReady indicates the ClusterExternalSecret resource is ready.</p>
  19447. </td>
  19448. </tr></tbody>
  19449. </table>
  19450. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  19451. </h3>
  19452. <p>
  19453. (<em>Appears on:</em>
  19454. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  19455. </p>
  19456. <p>
  19457. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</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>namespace</code></br>
  19470. <em>
  19471. string
  19472. </em>
  19473. </td>
  19474. <td>
  19475. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  19476. </td>
  19477. </tr>
  19478. <tr>
  19479. <td>
  19480. <code>reason</code></br>
  19481. <em>
  19482. string
  19483. </em>
  19484. </td>
  19485. <td>
  19486. <em>(Optional)</em>
  19487. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  19488. </td>
  19489. </tr>
  19490. </tbody>
  19491. </table>
  19492. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  19493. </h3>
  19494. <p>
  19495. (<em>Appears on:</em>
  19496. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  19497. </p>
  19498. <p>
  19499. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  19500. </p>
  19501. <table>
  19502. <thead>
  19503. <tr>
  19504. <th>Field</th>
  19505. <th>Description</th>
  19506. </tr>
  19507. </thead>
  19508. <tbody>
  19509. <tr>
  19510. <td>
  19511. <code>externalSecretSpec</code></br>
  19512. <em>
  19513. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  19514. ExternalSecretSpec
  19515. </a>
  19516. </em>
  19517. </td>
  19518. <td>
  19519. <p>The spec for the ExternalSecrets to be created</p>
  19520. </td>
  19521. </tr>
  19522. <tr>
  19523. <td>
  19524. <code>externalSecretName</code></br>
  19525. <em>
  19526. string
  19527. </em>
  19528. </td>
  19529. <td>
  19530. <em>(Optional)</em>
  19531. <p>The name of the external secrets to be created.
  19532. Defaults to the name of the ClusterExternalSecret</p>
  19533. </td>
  19534. </tr>
  19535. <tr>
  19536. <td>
  19537. <code>externalSecretMetadata</code></br>
  19538. <em>
  19539. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  19540. ExternalSecretMetadata
  19541. </a>
  19542. </em>
  19543. </td>
  19544. <td>
  19545. <em>(Optional)</em>
  19546. <p>The metadata of the external secrets to be created</p>
  19547. </td>
  19548. </tr>
  19549. <tr>
  19550. <td>
  19551. <code>namespaceSelector</code></br>
  19552. <em>
  19553. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  19554. Kubernetes meta/v1.LabelSelector
  19555. </a>
  19556. </em>
  19557. </td>
  19558. <td>
  19559. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  19560. </td>
  19561. </tr>
  19562. <tr>
  19563. <td>
  19564. <code>namespaceSelectors</code></br>
  19565. <em>
  19566. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  19567. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  19568. </a>
  19569. </em>
  19570. </td>
  19571. <td>
  19572. <em>(Optional)</em>
  19573. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  19574. </td>
  19575. </tr>
  19576. <tr>
  19577. <td>
  19578. <code>namespaces</code></br>
  19579. <em>
  19580. []string
  19581. </em>
  19582. </td>
  19583. <td>
  19584. <em>(Optional)</em>
  19585. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  19586. <p>Deprecated: Use NamespaceSelectors instead.</p>
  19587. </td>
  19588. </tr>
  19589. <tr>
  19590. <td>
  19591. <code>refreshTime</code></br>
  19592. <em>
  19593. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  19594. Kubernetes meta/v1.Duration
  19595. </a>
  19596. </em>
  19597. </td>
  19598. <td>
  19599. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  19600. </td>
  19601. </tr>
  19602. </tbody>
  19603. </table>
  19604. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  19605. </h3>
  19606. <p>
  19607. (<em>Appears on:</em>
  19608. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  19609. </p>
  19610. <p>
  19611. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  19612. </p>
  19613. <table>
  19614. <thead>
  19615. <tr>
  19616. <th>Field</th>
  19617. <th>Description</th>
  19618. </tr>
  19619. </thead>
  19620. <tbody>
  19621. <tr>
  19622. <td>
  19623. <code>externalSecretName</code></br>
  19624. <em>
  19625. string
  19626. </em>
  19627. </td>
  19628. <td>
  19629. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  19630. </td>
  19631. </tr>
  19632. <tr>
  19633. <td>
  19634. <code>failedNamespaces</code></br>
  19635. <em>
  19636. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">
  19637. []ClusterExternalSecretNamespaceFailure
  19638. </a>
  19639. </em>
  19640. </td>
  19641. <td>
  19642. <em>(Optional)</em>
  19643. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  19644. </td>
  19645. </tr>
  19646. <tr>
  19647. <td>
  19648. <code>provisionedNamespaces</code></br>
  19649. <em>
  19650. []string
  19651. </em>
  19652. </td>
  19653. <td>
  19654. <em>(Optional)</em>
  19655. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  19656. </td>
  19657. </tr>
  19658. <tr>
  19659. <td>
  19660. <code>conditions</code></br>
  19661. <em>
  19662. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">
  19663. []ClusterExternalSecretStatusCondition
  19664. </a>
  19665. </em>
  19666. </td>
  19667. <td>
  19668. <em>(Optional)</em>
  19669. </td>
  19670. </tr>
  19671. </tbody>
  19672. </table>
  19673. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  19674. </h3>
  19675. <p>
  19676. (<em>Appears on:</em>
  19677. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  19678. </p>
  19679. <p>
  19680. <p>ClusterExternalSecretStatusCondition indicates the status of the ClusterExternalSecret.</p>
  19681. </p>
  19682. <table>
  19683. <thead>
  19684. <tr>
  19685. <th>Field</th>
  19686. <th>Description</th>
  19687. </tr>
  19688. </thead>
  19689. <tbody>
  19690. <tr>
  19691. <td>
  19692. <code>type</code></br>
  19693. <em>
  19694. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretConditionType">
  19695. ClusterExternalSecretConditionType
  19696. </a>
  19697. </em>
  19698. </td>
  19699. <td>
  19700. </td>
  19701. </tr>
  19702. <tr>
  19703. <td>
  19704. <code>status</code></br>
  19705. <em>
  19706. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  19707. Kubernetes core/v1.ConditionStatus
  19708. </a>
  19709. </em>
  19710. </td>
  19711. <td>
  19712. </td>
  19713. </tr>
  19714. <tr>
  19715. <td>
  19716. <code>message</code></br>
  19717. <em>
  19718. string
  19719. </em>
  19720. </td>
  19721. <td>
  19722. <em>(Optional)</em>
  19723. </td>
  19724. </tr>
  19725. </tbody>
  19726. </table>
  19727. <h3 id="external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore
  19728. </h3>
  19729. <p>
  19730. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  19731. </p>
  19732. <table>
  19733. <thead>
  19734. <tr>
  19735. <th>Field</th>
  19736. <th>Description</th>
  19737. </tr>
  19738. </thead>
  19739. <tbody>
  19740. <tr>
  19741. <td>
  19742. <code>metadata</code></br>
  19743. <em>
  19744. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  19745. Kubernetes meta/v1.ObjectMeta
  19746. </a>
  19747. </em>
  19748. </td>
  19749. <td>
  19750. Refer to the Kubernetes API documentation for the fields of the
  19751. <code>metadata</code> field.
  19752. </td>
  19753. </tr>
  19754. <tr>
  19755. <td>
  19756. <code>spec</code></br>
  19757. <em>
  19758. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  19759. SecretStoreSpec
  19760. </a>
  19761. </em>
  19762. </td>
  19763. <td>
  19764. <br/>
  19765. <br/>
  19766. <table>
  19767. <tr>
  19768. <td>
  19769. <code>controller</code></br>
  19770. <em>
  19771. string
  19772. </em>
  19773. </td>
  19774. <td>
  19775. <em>(Optional)</em>
  19776. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  19777. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  19778. </td>
  19779. </tr>
  19780. <tr>
  19781. <td>
  19782. <code>provider</code></br>
  19783. <em>
  19784. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  19785. SecretStoreProvider
  19786. </a>
  19787. </em>
  19788. </td>
  19789. <td>
  19790. <p>Used to configure the provider. Only one provider may be set</p>
  19791. </td>
  19792. </tr>
  19793. <tr>
  19794. <td>
  19795. <code>retrySettings</code></br>
  19796. <em>
  19797. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  19798. SecretStoreRetrySettings
  19799. </a>
  19800. </em>
  19801. </td>
  19802. <td>
  19803. <em>(Optional)</em>
  19804. <p>Used to configure HTTP retries on failures.</p>
  19805. </td>
  19806. </tr>
  19807. <tr>
  19808. <td>
  19809. <code>refreshInterval</code></br>
  19810. <em>
  19811. int
  19812. </em>
  19813. </td>
  19814. <td>
  19815. <em>(Optional)</em>
  19816. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  19817. </td>
  19818. </tr>
  19819. <tr>
  19820. <td>
  19821. <code>conditions</code></br>
  19822. <em>
  19823. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  19824. []ClusterSecretStoreCondition
  19825. </a>
  19826. </em>
  19827. </td>
  19828. <td>
  19829. <em>(Optional)</em>
  19830. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  19831. </td>
  19832. </tr>
  19833. </table>
  19834. </td>
  19835. </tr>
  19836. <tr>
  19837. <td>
  19838. <code>status</code></br>
  19839. <em>
  19840. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  19841. SecretStoreStatus
  19842. </a>
  19843. </em>
  19844. </td>
  19845. <td>
  19846. </td>
  19847. </tr>
  19848. </tbody>
  19849. </table>
  19850. <h3 id="external-secrets.io/v1beta1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  19851. </h3>
  19852. <p>
  19853. (<em>Appears on:</em>
  19854. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  19855. </p>
  19856. <p>
  19857. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  19858. for a ClusterSecretStore instance.</p>
  19859. </p>
  19860. <table>
  19861. <thead>
  19862. <tr>
  19863. <th>Field</th>
  19864. <th>Description</th>
  19865. </tr>
  19866. </thead>
  19867. <tbody>
  19868. <tr>
  19869. <td>
  19870. <code>namespaceSelector</code></br>
  19871. <em>
  19872. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  19873. Kubernetes meta/v1.LabelSelector
  19874. </a>
  19875. </em>
  19876. </td>
  19877. <td>
  19878. <em>(Optional)</em>
  19879. <p>Choose namespace using a labelSelector</p>
  19880. </td>
  19881. </tr>
  19882. <tr>
  19883. <td>
  19884. <code>namespaces</code></br>
  19885. <em>
  19886. []string
  19887. </em>
  19888. </td>
  19889. <td>
  19890. <em>(Optional)</em>
  19891. <p>Choose namespaces by name</p>
  19892. </td>
  19893. </tr>
  19894. <tr>
  19895. <td>
  19896. <code>namespaceRegexes</code></br>
  19897. <em>
  19898. []string
  19899. </em>
  19900. </td>
  19901. <td>
  19902. <em>(Optional)</em>
  19903. <p>Choose namespaces by using regex matching</p>
  19904. </td>
  19905. </tr>
  19906. </tbody>
  19907. </table>
  19908. <h3 id="external-secrets.io/v1beta1.ConjurAPIKey">ConjurAPIKey
  19909. </h3>
  19910. <p>
  19911. (<em>Appears on:</em>
  19912. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  19913. </p>
  19914. <p>
  19915. <p>ConjurAPIKey defines authentication using a Conjur API key.</p>
  19916. </p>
  19917. <table>
  19918. <thead>
  19919. <tr>
  19920. <th>Field</th>
  19921. <th>Description</th>
  19922. </tr>
  19923. </thead>
  19924. <tbody>
  19925. <tr>
  19926. <td>
  19927. <code>account</code></br>
  19928. <em>
  19929. string
  19930. </em>
  19931. </td>
  19932. <td>
  19933. <p>Account is the Conjur organization account name.</p>
  19934. </td>
  19935. </tr>
  19936. <tr>
  19937. <td>
  19938. <code>userRef</code></br>
  19939. <em>
  19940. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19941. External Secrets meta/v1.SecretKeySelector
  19942. </a>
  19943. </em>
  19944. </td>
  19945. <td>
  19946. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  19947. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  19948. </td>
  19949. </tr>
  19950. <tr>
  19951. <td>
  19952. <code>apiKeyRef</code></br>
  19953. <em>
  19954. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19955. External Secrets meta/v1.SecretKeySelector
  19956. </a>
  19957. </em>
  19958. </td>
  19959. <td>
  19960. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  19961. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  19962. </td>
  19963. </tr>
  19964. </tbody>
  19965. </table>
  19966. <h3 id="external-secrets.io/v1beta1.ConjurAuth">ConjurAuth
  19967. </h3>
  19968. <p>
  19969. (<em>Appears on:</em>
  19970. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>)
  19971. </p>
  19972. <p>
  19973. <p>ConjurAuth defines the methods of authentication with Conjur.</p>
  19974. </p>
  19975. <table>
  19976. <thead>
  19977. <tr>
  19978. <th>Field</th>
  19979. <th>Description</th>
  19980. </tr>
  19981. </thead>
  19982. <tbody>
  19983. <tr>
  19984. <td>
  19985. <code>apikey</code></br>
  19986. <em>
  19987. <a href="#external-secrets.io/v1beta1.ConjurAPIKey">
  19988. ConjurAPIKey
  19989. </a>
  19990. </em>
  19991. </td>
  19992. <td>
  19993. <em>(Optional)</em>
  19994. <p>Authenticates with Conjur using an API key.</p>
  19995. </td>
  19996. </tr>
  19997. <tr>
  19998. <td>
  19999. <code>jwt</code></br>
  20000. <em>
  20001. <a href="#external-secrets.io/v1beta1.ConjurJWT">
  20002. ConjurJWT
  20003. </a>
  20004. </em>
  20005. </td>
  20006. <td>
  20007. <em>(Optional)</em>
  20008. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  20009. </td>
  20010. </tr>
  20011. </tbody>
  20012. </table>
  20013. <h3 id="external-secrets.io/v1beta1.ConjurJWT">ConjurJWT
  20014. </h3>
  20015. <p>
  20016. (<em>Appears on:</em>
  20017. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  20018. </p>
  20019. <p>
  20020. <p>ConjurJWT defines authentication using a JWT service account token.</p>
  20021. </p>
  20022. <table>
  20023. <thead>
  20024. <tr>
  20025. <th>Field</th>
  20026. <th>Description</th>
  20027. </tr>
  20028. </thead>
  20029. <tbody>
  20030. <tr>
  20031. <td>
  20032. <code>account</code></br>
  20033. <em>
  20034. string
  20035. </em>
  20036. </td>
  20037. <td>
  20038. <p>Account is the Conjur organization account name.</p>
  20039. </td>
  20040. </tr>
  20041. <tr>
  20042. <td>
  20043. <code>serviceID</code></br>
  20044. <em>
  20045. string
  20046. </em>
  20047. </td>
  20048. <td>
  20049. <p>The conjur authn jwt webservice id</p>
  20050. </td>
  20051. </tr>
  20052. <tr>
  20053. <td>
  20054. <code>hostId</code></br>
  20055. <em>
  20056. string
  20057. </em>
  20058. </td>
  20059. <td>
  20060. <em>(Optional)</em>
  20061. <p>Optional HostID for JWT authentication. This may be used depending
  20062. on how the Conjur JWT authenticator policy is configured.</p>
  20063. </td>
  20064. </tr>
  20065. <tr>
  20066. <td>
  20067. <code>secretRef</code></br>
  20068. <em>
  20069. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20070. External Secrets meta/v1.SecretKeySelector
  20071. </a>
  20072. </em>
  20073. </td>
  20074. <td>
  20075. <em>(Optional)</em>
  20076. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  20077. authenticate with Conjur using the JWT authentication method.</p>
  20078. </td>
  20079. </tr>
  20080. <tr>
  20081. <td>
  20082. <code>serviceAccountRef</code></br>
  20083. <em>
  20084. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  20085. External Secrets meta/v1.ServiceAccountSelector
  20086. </a>
  20087. </em>
  20088. </td>
  20089. <td>
  20090. <em>(Optional)</em>
  20091. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  20092. a token for with the <code>TokenRequest</code> API.</p>
  20093. </td>
  20094. </tr>
  20095. </tbody>
  20096. </table>
  20097. <h3 id="external-secrets.io/v1beta1.ConjurProvider">ConjurProvider
  20098. </h3>
  20099. <p>
  20100. (<em>Appears on:</em>
  20101. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20102. </p>
  20103. <p>
  20104. <p>ConjurProvider defines configuration for the CyberArk Conjur provider.</p>
  20105. </p>
  20106. <table>
  20107. <thead>
  20108. <tr>
  20109. <th>Field</th>
  20110. <th>Description</th>
  20111. </tr>
  20112. </thead>
  20113. <tbody>
  20114. <tr>
  20115. <td>
  20116. <code>url</code></br>
  20117. <em>
  20118. string
  20119. </em>
  20120. </td>
  20121. <td>
  20122. <p>URL is the endpoint of the Conjur instance.</p>
  20123. </td>
  20124. </tr>
  20125. <tr>
  20126. <td>
  20127. <code>caBundle</code></br>
  20128. <em>
  20129. string
  20130. </em>
  20131. </td>
  20132. <td>
  20133. <em>(Optional)</em>
  20134. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  20135. </td>
  20136. </tr>
  20137. <tr>
  20138. <td>
  20139. <code>caProvider</code></br>
  20140. <em>
  20141. <a href="#external-secrets.io/v1beta1.CAProvider">
  20142. CAProvider
  20143. </a>
  20144. </em>
  20145. </td>
  20146. <td>
  20147. <em>(Optional)</em>
  20148. <p>Used to provide custom certificate authority (CA) certificates
  20149. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  20150. that contains a PEM-encoded certificate.</p>
  20151. </td>
  20152. </tr>
  20153. <tr>
  20154. <td>
  20155. <code>auth</code></br>
  20156. <em>
  20157. <a href="#external-secrets.io/v1beta1.ConjurAuth">
  20158. ConjurAuth
  20159. </a>
  20160. </em>
  20161. </td>
  20162. <td>
  20163. <p>Defines authentication settings for connecting to Conjur.</p>
  20164. </td>
  20165. </tr>
  20166. </tbody>
  20167. </table>
  20168. <h3 id="external-secrets.io/v1beta1.DelineaProvider">DelineaProvider
  20169. </h3>
  20170. <p>
  20171. (<em>Appears on:</em>
  20172. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20173. </p>
  20174. <p>
  20175. <p>DelineaProvider defines configuration for the Delinea DevOps Secrets Vault provider.
  20176. 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>
  20177. </p>
  20178. <table>
  20179. <thead>
  20180. <tr>
  20181. <th>Field</th>
  20182. <th>Description</th>
  20183. </tr>
  20184. </thead>
  20185. <tbody>
  20186. <tr>
  20187. <td>
  20188. <code>clientId</code></br>
  20189. <em>
  20190. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  20191. DelineaProviderSecretRef
  20192. </a>
  20193. </em>
  20194. </td>
  20195. <td>
  20196. <p>ClientID is the non-secret part of the credential.</p>
  20197. </td>
  20198. </tr>
  20199. <tr>
  20200. <td>
  20201. <code>clientSecret</code></br>
  20202. <em>
  20203. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  20204. DelineaProviderSecretRef
  20205. </a>
  20206. </em>
  20207. </td>
  20208. <td>
  20209. <p>ClientSecret is the secret part of the credential.</p>
  20210. </td>
  20211. </tr>
  20212. <tr>
  20213. <td>
  20214. <code>tenant</code></br>
  20215. <em>
  20216. string
  20217. </em>
  20218. </td>
  20219. <td>
  20220. <p>Tenant is the chosen hostname / site name.</p>
  20221. </td>
  20222. </tr>
  20223. <tr>
  20224. <td>
  20225. <code>urlTemplate</code></br>
  20226. <em>
  20227. string
  20228. </em>
  20229. </td>
  20230. <td>
  20231. <em>(Optional)</em>
  20232. <p>URLTemplate
  20233. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  20234. </td>
  20235. </tr>
  20236. <tr>
  20237. <td>
  20238. <code>tld</code></br>
  20239. <em>
  20240. string
  20241. </em>
  20242. </td>
  20243. <td>
  20244. <em>(Optional)</em>
  20245. <p>TLD is based on the server location that was chosen during provisioning.
  20246. If unset, defaults to &ldquo;com&rdquo;.</p>
  20247. </td>
  20248. </tr>
  20249. </tbody>
  20250. </table>
  20251. <h3 id="external-secrets.io/v1beta1.DelineaProviderSecretRef">DelineaProviderSecretRef
  20252. </h3>
  20253. <p>
  20254. (<em>Appears on:</em>
  20255. <a href="#external-secrets.io/v1beta1.DelineaProvider">DelineaProvider</a>)
  20256. </p>
  20257. <p>
  20258. <p>DelineaProviderSecretRef defines a reference to a secret containing credentials for the Delinea provider.</p>
  20259. </p>
  20260. <table>
  20261. <thead>
  20262. <tr>
  20263. <th>Field</th>
  20264. <th>Description</th>
  20265. </tr>
  20266. </thead>
  20267. <tbody>
  20268. <tr>
  20269. <td>
  20270. <code>value</code></br>
  20271. <em>
  20272. string
  20273. </em>
  20274. </td>
  20275. <td>
  20276. <em>(Optional)</em>
  20277. <p>Value can be specified directly to set a value without using a secret.</p>
  20278. </td>
  20279. </tr>
  20280. <tr>
  20281. <td>
  20282. <code>secretRef</code></br>
  20283. <em>
  20284. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20285. External Secrets meta/v1.SecretKeySelector
  20286. </a>
  20287. </em>
  20288. </td>
  20289. <td>
  20290. <em>(Optional)</em>
  20291. <p>SecretRef references a key in a secret that will be used as value.</p>
  20292. </td>
  20293. </tr>
  20294. </tbody>
  20295. </table>
  20296. <h3 id="external-secrets.io/v1beta1.Device42Auth">Device42Auth
  20297. </h3>
  20298. <p>
  20299. (<em>Appears on:</em>
  20300. <a href="#external-secrets.io/v1beta1.Device42Provider">Device42Provider</a>)
  20301. </p>
  20302. <p>
  20303. <p>Device42Auth defines the authentication method for the Device42 provider.</p>
  20304. </p>
  20305. <table>
  20306. <thead>
  20307. <tr>
  20308. <th>Field</th>
  20309. <th>Description</th>
  20310. </tr>
  20311. </thead>
  20312. <tbody>
  20313. <tr>
  20314. <td>
  20315. <code>secretRef</code></br>
  20316. <em>
  20317. <a href="#external-secrets.io/v1beta1.Device42SecretRef">
  20318. Device42SecretRef
  20319. </a>
  20320. </em>
  20321. </td>
  20322. <td>
  20323. </td>
  20324. </tr>
  20325. </tbody>
  20326. </table>
  20327. <h3 id="external-secrets.io/v1beta1.Device42Provider">Device42Provider
  20328. </h3>
  20329. <p>
  20330. (<em>Appears on:</em>
  20331. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20332. </p>
  20333. <p>
  20334. <p>Device42Provider configures a store to sync secrets with a Device42 instance.</p>
  20335. </p>
  20336. <table>
  20337. <thead>
  20338. <tr>
  20339. <th>Field</th>
  20340. <th>Description</th>
  20341. </tr>
  20342. </thead>
  20343. <tbody>
  20344. <tr>
  20345. <td>
  20346. <code>host</code></br>
  20347. <em>
  20348. string
  20349. </em>
  20350. </td>
  20351. <td>
  20352. <p>URL configures the Device42 instance URL.</p>
  20353. </td>
  20354. </tr>
  20355. <tr>
  20356. <td>
  20357. <code>auth</code></br>
  20358. <em>
  20359. <a href="#external-secrets.io/v1beta1.Device42Auth">
  20360. Device42Auth
  20361. </a>
  20362. </em>
  20363. </td>
  20364. <td>
  20365. <p>Auth configures how secret-manager authenticates with a Device42 instance.</p>
  20366. </td>
  20367. </tr>
  20368. </tbody>
  20369. </table>
  20370. <h3 id="external-secrets.io/v1beta1.Device42SecretRef">Device42SecretRef
  20371. </h3>
  20372. <p>
  20373. (<em>Appears on:</em>
  20374. <a href="#external-secrets.io/v1beta1.Device42Auth">Device42Auth</a>)
  20375. </p>
  20376. <p>
  20377. <p>Device42SecretRef defines a reference to a secret containing credentials for the Device42 provider.</p>
  20378. </p>
  20379. <table>
  20380. <thead>
  20381. <tr>
  20382. <th>Field</th>
  20383. <th>Description</th>
  20384. </tr>
  20385. </thead>
  20386. <tbody>
  20387. <tr>
  20388. <td>
  20389. <code>credentials</code></br>
  20390. <em>
  20391. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20392. External Secrets meta/v1.SecretKeySelector
  20393. </a>
  20394. </em>
  20395. </td>
  20396. <td>
  20397. <em>(Optional)</em>
  20398. <p>Username / Password is used for authentication.</p>
  20399. </td>
  20400. </tr>
  20401. </tbody>
  20402. </table>
  20403. <h3 id="external-secrets.io/v1beta1.DopplerAuth">DopplerAuth
  20404. </h3>
  20405. <p>
  20406. (<em>Appears on:</em>
  20407. <a href="#external-secrets.io/v1beta1.DopplerProvider">DopplerProvider</a>)
  20408. </p>
  20409. <p>
  20410. <p>DopplerAuth defines the authentication method for the Doppler provider.</p>
  20411. </p>
  20412. <table>
  20413. <thead>
  20414. <tr>
  20415. <th>Field</th>
  20416. <th>Description</th>
  20417. </tr>
  20418. </thead>
  20419. <tbody>
  20420. <tr>
  20421. <td>
  20422. <code>secretRef</code></br>
  20423. <em>
  20424. <a href="#external-secrets.io/v1beta1.DopplerAuthSecretRef">
  20425. DopplerAuthSecretRef
  20426. </a>
  20427. </em>
  20428. </td>
  20429. <td>
  20430. </td>
  20431. </tr>
  20432. </tbody>
  20433. </table>
  20434. <h3 id="external-secrets.io/v1beta1.DopplerAuthSecretRef">DopplerAuthSecretRef
  20435. </h3>
  20436. <p>
  20437. (<em>Appears on:</em>
  20438. <a href="#external-secrets.io/v1beta1.DopplerAuth">DopplerAuth</a>)
  20439. </p>
  20440. <p>
  20441. <p>DopplerAuthSecretRef defines a reference to a secret containing credentials for the Doppler provider.</p>
  20442. </p>
  20443. <table>
  20444. <thead>
  20445. <tr>
  20446. <th>Field</th>
  20447. <th>Description</th>
  20448. </tr>
  20449. </thead>
  20450. <tbody>
  20451. <tr>
  20452. <td>
  20453. <code>dopplerToken</code></br>
  20454. <em>
  20455. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20456. External Secrets meta/v1.SecretKeySelector
  20457. </a>
  20458. </em>
  20459. </td>
  20460. <td>
  20461. <p>The DopplerToken is used for authentication.
  20462. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  20463. The Key attribute defaults to dopplerToken if not specified.</p>
  20464. </td>
  20465. </tr>
  20466. </tbody>
  20467. </table>
  20468. <h3 id="external-secrets.io/v1beta1.DopplerProvider">DopplerProvider
  20469. </h3>
  20470. <p>
  20471. (<em>Appears on:</em>
  20472. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20473. </p>
  20474. <p>
  20475. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  20476. Project and Config are required if not using a Service Token.</p>
  20477. </p>
  20478. <table>
  20479. <thead>
  20480. <tr>
  20481. <th>Field</th>
  20482. <th>Description</th>
  20483. </tr>
  20484. </thead>
  20485. <tbody>
  20486. <tr>
  20487. <td>
  20488. <code>auth</code></br>
  20489. <em>
  20490. <a href="#external-secrets.io/v1beta1.DopplerAuth">
  20491. DopplerAuth
  20492. </a>
  20493. </em>
  20494. </td>
  20495. <td>
  20496. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  20497. </td>
  20498. </tr>
  20499. <tr>
  20500. <td>
  20501. <code>project</code></br>
  20502. <em>
  20503. string
  20504. </em>
  20505. </td>
  20506. <td>
  20507. <em>(Optional)</em>
  20508. <p>Doppler project (required if not using a Service Token)</p>
  20509. </td>
  20510. </tr>
  20511. <tr>
  20512. <td>
  20513. <code>config</code></br>
  20514. <em>
  20515. string
  20516. </em>
  20517. </td>
  20518. <td>
  20519. <em>(Optional)</em>
  20520. <p>Doppler config (required if not using a Service Token)</p>
  20521. </td>
  20522. </tr>
  20523. <tr>
  20524. <td>
  20525. <code>nameTransformer</code></br>
  20526. <em>
  20527. string
  20528. </em>
  20529. </td>
  20530. <td>
  20531. <em>(Optional)</em>
  20532. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  20533. </td>
  20534. </tr>
  20535. <tr>
  20536. <td>
  20537. <code>format</code></br>
  20538. <em>
  20539. string
  20540. </em>
  20541. </td>
  20542. <td>
  20543. <em>(Optional)</em>
  20544. <p>Format enables the downloading of secrets as a file (string)</p>
  20545. </td>
  20546. </tr>
  20547. </tbody>
  20548. </table>
  20549. <h3 id="external-secrets.io/v1beta1.ExternalSecret">ExternalSecret
  20550. </h3>
  20551. <p>
  20552. <p>ExternalSecret is the schema for the external-secrets API.</p>
  20553. </p>
  20554. <table>
  20555. <thead>
  20556. <tr>
  20557. <th>Field</th>
  20558. <th>Description</th>
  20559. </tr>
  20560. </thead>
  20561. <tbody>
  20562. <tr>
  20563. <td>
  20564. <code>metadata</code></br>
  20565. <em>
  20566. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  20567. Kubernetes meta/v1.ObjectMeta
  20568. </a>
  20569. </em>
  20570. </td>
  20571. <td>
  20572. Refer to the Kubernetes API documentation for the fields of the
  20573. <code>metadata</code> field.
  20574. </td>
  20575. </tr>
  20576. <tr>
  20577. <td>
  20578. <code>spec</code></br>
  20579. <em>
  20580. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  20581. ExternalSecretSpec
  20582. </a>
  20583. </em>
  20584. </td>
  20585. <td>
  20586. <br/>
  20587. <br/>
  20588. <table>
  20589. <tr>
  20590. <td>
  20591. <code>secretStoreRef</code></br>
  20592. <em>
  20593. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  20594. SecretStoreRef
  20595. </a>
  20596. </em>
  20597. </td>
  20598. <td>
  20599. <em>(Optional)</em>
  20600. </td>
  20601. </tr>
  20602. <tr>
  20603. <td>
  20604. <code>target</code></br>
  20605. <em>
  20606. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  20607. ExternalSecretTarget
  20608. </a>
  20609. </em>
  20610. </td>
  20611. <td>
  20612. <em>(Optional)</em>
  20613. </td>
  20614. </tr>
  20615. <tr>
  20616. <td>
  20617. <code>refreshPolicy</code></br>
  20618. <em>
  20619. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  20620. ExternalSecretRefreshPolicy
  20621. </a>
  20622. </em>
  20623. </td>
  20624. <td>
  20625. <em>(Optional)</em>
  20626. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  20627. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  20628. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  20629. No periodic updates occur if refreshInterval is 0.
  20630. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  20631. </td>
  20632. </tr>
  20633. <tr>
  20634. <td>
  20635. <code>refreshInterval</code></br>
  20636. <em>
  20637. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  20638. Kubernetes meta/v1.Duration
  20639. </a>
  20640. </em>
  20641. </td>
  20642. <td>
  20643. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  20644. specified as Golang Duration strings.
  20645. 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;
  20646. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  20647. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  20648. </td>
  20649. </tr>
  20650. <tr>
  20651. <td>
  20652. <code>data</code></br>
  20653. <em>
  20654. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  20655. []ExternalSecretData
  20656. </a>
  20657. </em>
  20658. </td>
  20659. <td>
  20660. <em>(Optional)</em>
  20661. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  20662. </td>
  20663. </tr>
  20664. <tr>
  20665. <td>
  20666. <code>dataFrom</code></br>
  20667. <em>
  20668. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  20669. []ExternalSecretDataFromRemoteRef
  20670. </a>
  20671. </em>
  20672. </td>
  20673. <td>
  20674. <em>(Optional)</em>
  20675. <p>DataFrom is used to fetch all properties from a specific Provider data
  20676. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  20677. </td>
  20678. </tr>
  20679. </table>
  20680. </td>
  20681. </tr>
  20682. <tr>
  20683. <td>
  20684. <code>status</code></br>
  20685. <em>
  20686. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">
  20687. ExternalSecretStatus
  20688. </a>
  20689. </em>
  20690. </td>
  20691. <td>
  20692. </td>
  20693. </tr>
  20694. </tbody>
  20695. </table>
  20696. <h3 id="external-secrets.io/v1beta1.ExternalSecretConditionType">ExternalSecretConditionType
  20697. (<code>string</code> alias)</p></h3>
  20698. <p>
  20699. (<em>Appears on:</em>
  20700. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  20701. </p>
  20702. <p>
  20703. <p>ExternalSecretConditionType defines the condition type for an ExternalSecret.</p>
  20704. </p>
  20705. <table>
  20706. <thead>
  20707. <tr>
  20708. <th>Value</th>
  20709. <th>Description</th>
  20710. </tr>
  20711. </thead>
  20712. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  20713. <td><p>ExternalSecretDeleted indicates the ExternalSecret has been deleted.</p>
  20714. </td>
  20715. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  20716. <td><p>ExternalSecretReady indicates the ExternalSecret has been successfully reconciled.</p>
  20717. </td>
  20718. </tr></tbody>
  20719. </table>
  20720. <h3 id="external-secrets.io/v1beta1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  20721. (<code>string</code> alias)</p></h3>
  20722. <p>
  20723. (<em>Appears on:</em>
  20724. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  20725. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  20726. </p>
  20727. <p>
  20728. <p>ExternalSecretConversionStrategy defines how secret values are converted.</p>
  20729. </p>
  20730. <table>
  20731. <thead>
  20732. <tr>
  20733. <th>Value</th>
  20734. <th>Description</th>
  20735. </tr>
  20736. </thead>
  20737. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  20738. <td><p>ExternalSecretConversionDefault indicates the default conversion strategy.</p>
  20739. </td>
  20740. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  20741. <td><p>ExternalSecretConversionUnicode indicates that unicode conversion will be performed.</p>
  20742. </td>
  20743. </tr></tbody>
  20744. </table>
  20745. <h3 id="external-secrets.io/v1beta1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  20746. (<code>string</code> alias)</p></h3>
  20747. <p>
  20748. (<em>Appears on:</em>
  20749. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  20750. </p>
  20751. <p>
  20752. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  20753. </p>
  20754. <table>
  20755. <thead>
  20756. <tr>
  20757. <th>Value</th>
  20758. <th>Description</th>
  20759. </tr>
  20760. </thead>
  20761. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  20762. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  20763. </td>
  20764. </tr><tr><td><p>&#34;None&#34;</p></td>
  20765. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  20766. </td>
  20767. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  20768. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  20769. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  20770. </td>
  20771. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  20772. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  20773. </td>
  20774. </tr></tbody>
  20775. </table>
  20776. <h3 id="external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData
  20777. </h3>
  20778. <p>
  20779. (<em>Appears on:</em>
  20780. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20781. </p>
  20782. <p>
  20783. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  20784. </p>
  20785. <table>
  20786. <thead>
  20787. <tr>
  20788. <th>Field</th>
  20789. <th>Description</th>
  20790. </tr>
  20791. </thead>
  20792. <tbody>
  20793. <tr>
  20794. <td>
  20795. <code>secretKey</code></br>
  20796. <em>
  20797. string
  20798. </em>
  20799. </td>
  20800. <td>
  20801. <p>The key in the Kubernetes Secret to store the value.</p>
  20802. </td>
  20803. </tr>
  20804. <tr>
  20805. <td>
  20806. <code>remoteRef</code></br>
  20807. <em>
  20808. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  20809. ExternalSecretDataRemoteRef
  20810. </a>
  20811. </em>
  20812. </td>
  20813. <td>
  20814. <p>RemoteRef points to the remote secret and defines
  20815. which secret (version/property/..) to fetch.</p>
  20816. </td>
  20817. </tr>
  20818. <tr>
  20819. <td>
  20820. <code>sourceRef</code></br>
  20821. <em>
  20822. <a href="#external-secrets.io/v1beta1.StoreSourceRef">
  20823. StoreSourceRef
  20824. </a>
  20825. </em>
  20826. </td>
  20827. <td>
  20828. <p>SourceRef allows you to override the source
  20829. from which the value will be pulled.</p>
  20830. </td>
  20831. </tr>
  20832. </tbody>
  20833. </table>
  20834. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  20835. </h3>
  20836. <p>
  20837. (<em>Appears on:</em>
  20838. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20839. </p>
  20840. <p>
  20841. <p>ExternalSecretDataFromRemoteRef defines a reference to multiple secrets in the provider to be fetched using options.</p>
  20842. </p>
  20843. <table>
  20844. <thead>
  20845. <tr>
  20846. <th>Field</th>
  20847. <th>Description</th>
  20848. </tr>
  20849. </thead>
  20850. <tbody>
  20851. <tr>
  20852. <td>
  20853. <code>extract</code></br>
  20854. <em>
  20855. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  20856. ExternalSecretDataRemoteRef
  20857. </a>
  20858. </em>
  20859. </td>
  20860. <td>
  20861. <em>(Optional)</em>
  20862. <p>Used to extract multiple key/value pairs from one secret
  20863. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  20864. </td>
  20865. </tr>
  20866. <tr>
  20867. <td>
  20868. <code>find</code></br>
  20869. <em>
  20870. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">
  20871. ExternalSecretFind
  20872. </a>
  20873. </em>
  20874. </td>
  20875. <td>
  20876. <em>(Optional)</em>
  20877. <p>Used to find secrets based on tags or regular expressions
  20878. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  20879. </td>
  20880. </tr>
  20881. <tr>
  20882. <td>
  20883. <code>rewrite</code></br>
  20884. <em>
  20885. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">
  20886. []ExternalSecretRewrite
  20887. </a>
  20888. </em>
  20889. </td>
  20890. <td>
  20891. <em>(Optional)</em>
  20892. <p>Used to rewrite secret Keys after getting them from the secret Provider
  20893. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  20894. </td>
  20895. </tr>
  20896. <tr>
  20897. <td>
  20898. <code>sourceRef</code></br>
  20899. <em>
  20900. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">
  20901. StoreGeneratorSourceRef
  20902. </a>
  20903. </em>
  20904. </td>
  20905. <td>
  20906. <p>SourceRef points to a store or generator
  20907. which contains secret values ready to use.
  20908. Use this in combination with Extract or Find pull values out of
  20909. a specific SecretStore.
  20910. When sourceRef points to a generator Extract or Find is not supported.
  20911. The generator returns a static map of values</p>
  20912. </td>
  20913. </tr>
  20914. </tbody>
  20915. </table>
  20916. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  20917. </h3>
  20918. <p>
  20919. (<em>Appears on:</em>
  20920. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>,
  20921. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20922. </p>
  20923. <p>
  20924. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  20925. </p>
  20926. <table>
  20927. <thead>
  20928. <tr>
  20929. <th>Field</th>
  20930. <th>Description</th>
  20931. </tr>
  20932. </thead>
  20933. <tbody>
  20934. <tr>
  20935. <td>
  20936. <code>key</code></br>
  20937. <em>
  20938. string
  20939. </em>
  20940. </td>
  20941. <td>
  20942. <p>Key is the key used in the Provider, mandatory</p>
  20943. </td>
  20944. </tr>
  20945. <tr>
  20946. <td>
  20947. <code>metadataPolicy</code></br>
  20948. <em>
  20949. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">
  20950. ExternalSecretMetadataPolicy
  20951. </a>
  20952. </em>
  20953. </td>
  20954. <td>
  20955. <em>(Optional)</em>
  20956. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  20957. </td>
  20958. </tr>
  20959. <tr>
  20960. <td>
  20961. <code>property</code></br>
  20962. <em>
  20963. string
  20964. </em>
  20965. </td>
  20966. <td>
  20967. <em>(Optional)</em>
  20968. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  20969. </td>
  20970. </tr>
  20971. <tr>
  20972. <td>
  20973. <code>version</code></br>
  20974. <em>
  20975. string
  20976. </em>
  20977. </td>
  20978. <td>
  20979. <em>(Optional)</em>
  20980. <p>Used to select a specific version of the Provider value, if supported</p>
  20981. </td>
  20982. </tr>
  20983. <tr>
  20984. <td>
  20985. <code>conversionStrategy</code></br>
  20986. <em>
  20987. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  20988. ExternalSecretConversionStrategy
  20989. </a>
  20990. </em>
  20991. </td>
  20992. <td>
  20993. <em>(Optional)</em>
  20994. <p>Used to define a conversion Strategy</p>
  20995. </td>
  20996. </tr>
  20997. <tr>
  20998. <td>
  20999. <code>decodingStrategy</code></br>
  21000. <em>
  21001. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  21002. ExternalSecretDecodingStrategy
  21003. </a>
  21004. </em>
  21005. </td>
  21006. <td>
  21007. <em>(Optional)</em>
  21008. <p>Used to define a decoding Strategy</p>
  21009. </td>
  21010. </tr>
  21011. </tbody>
  21012. </table>
  21013. <h3 id="external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  21014. (<code>string</code> alias)</p></h3>
  21015. <p>
  21016. (<em>Appears on:</em>
  21017. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  21018. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  21019. </p>
  21020. <p>
  21021. <p>ExternalSecretDecodingStrategy defines how secret values are decoded.</p>
  21022. </p>
  21023. <table>
  21024. <thead>
  21025. <tr>
  21026. <th>Value</th>
  21027. <th>Description</th>
  21028. </tr>
  21029. </thead>
  21030. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  21031. <td><p>ExternalSecretDecodeAuto indicates that the decoding strategy will be automatically determined.</p>
  21032. </td>
  21033. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  21034. <td><p>ExternalSecretDecodeBase64 indicates that base64 decoding will be used.</p>
  21035. </td>
  21036. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  21037. <td><p>ExternalSecretDecodeBase64URL indicates that base64url decoding will be used.</p>
  21038. </td>
  21039. </tr><tr><td><p>&#34;None&#34;</p></td>
  21040. <td><p>ExternalSecretDecodeNone indicates that no decoding will be performed.</p>
  21041. </td>
  21042. </tr></tbody>
  21043. </table>
  21044. <h3 id="external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  21045. (<code>string</code> alias)</p></h3>
  21046. <p>
  21047. (<em>Appears on:</em>
  21048. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  21049. </p>
  21050. <p>
  21051. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  21052. </p>
  21053. <table>
  21054. <thead>
  21055. <tr>
  21056. <th>Value</th>
  21057. <th>Description</th>
  21058. </tr>
  21059. </thead>
  21060. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  21061. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  21062. If a secret gets deleted on the provider side and is not accessible
  21063. anymore this is not considered an error and the ExternalSecret
  21064. does not go into SecretSyncedError status.</p>
  21065. </td>
  21066. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  21067. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  21068. If a secret gets deleted on the provider side and is not accessible
  21069. anymore this is not considered an error and the ExternalSecret
  21070. does not go into SecretSyncedError status.</p>
  21071. </td>
  21072. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  21073. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  21074. If a provider secret does not exist the ExternalSecret gets into the
  21075. SecretSyncedError status.</p>
  21076. </td>
  21077. </tr></tbody>
  21078. </table>
  21079. <h3 id="external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind
  21080. </h3>
  21081. <p>
  21082. (<em>Appears on:</em>
  21083. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  21084. </p>
  21085. <p>
  21086. <p>ExternalSecretFind defines criteria for finding secrets in the provider.</p>
  21087. </p>
  21088. <table>
  21089. <thead>
  21090. <tr>
  21091. <th>Field</th>
  21092. <th>Description</th>
  21093. </tr>
  21094. </thead>
  21095. <tbody>
  21096. <tr>
  21097. <td>
  21098. <code>path</code></br>
  21099. <em>
  21100. string
  21101. </em>
  21102. </td>
  21103. <td>
  21104. <em>(Optional)</em>
  21105. <p>A root path to start the find operations.</p>
  21106. </td>
  21107. </tr>
  21108. <tr>
  21109. <td>
  21110. <code>name</code></br>
  21111. <em>
  21112. <a href="#external-secrets.io/v1beta1.FindName">
  21113. FindName
  21114. </a>
  21115. </em>
  21116. </td>
  21117. <td>
  21118. <em>(Optional)</em>
  21119. <p>Finds secrets based on the name.</p>
  21120. </td>
  21121. </tr>
  21122. <tr>
  21123. <td>
  21124. <code>tags</code></br>
  21125. <em>
  21126. map[string]string
  21127. </em>
  21128. </td>
  21129. <td>
  21130. <em>(Optional)</em>
  21131. <p>Find secrets based on tags.</p>
  21132. </td>
  21133. </tr>
  21134. <tr>
  21135. <td>
  21136. <code>conversionStrategy</code></br>
  21137. <em>
  21138. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  21139. ExternalSecretConversionStrategy
  21140. </a>
  21141. </em>
  21142. </td>
  21143. <td>
  21144. <em>(Optional)</em>
  21145. <p>Used to define a conversion Strategy</p>
  21146. </td>
  21147. </tr>
  21148. <tr>
  21149. <td>
  21150. <code>decodingStrategy</code></br>
  21151. <em>
  21152. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  21153. ExternalSecretDecodingStrategy
  21154. </a>
  21155. </em>
  21156. </td>
  21157. <td>
  21158. <em>(Optional)</em>
  21159. <p>Used to define a decoding Strategy</p>
  21160. </td>
  21161. </tr>
  21162. </tbody>
  21163. </table>
  21164. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadata">ExternalSecretMetadata
  21165. </h3>
  21166. <p>
  21167. (<em>Appears on:</em>
  21168. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  21169. </p>
  21170. <p>
  21171. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  21172. </p>
  21173. <table>
  21174. <thead>
  21175. <tr>
  21176. <th>Field</th>
  21177. <th>Description</th>
  21178. </tr>
  21179. </thead>
  21180. <tbody>
  21181. <tr>
  21182. <td>
  21183. <code>annotations</code></br>
  21184. <em>
  21185. map[string]string
  21186. </em>
  21187. </td>
  21188. <td>
  21189. <em>(Optional)</em>
  21190. </td>
  21191. </tr>
  21192. <tr>
  21193. <td>
  21194. <code>labels</code></br>
  21195. <em>
  21196. map[string]string
  21197. </em>
  21198. </td>
  21199. <td>
  21200. <em>(Optional)</em>
  21201. </td>
  21202. </tr>
  21203. </tbody>
  21204. </table>
  21205. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  21206. (<code>string</code> alias)</p></h3>
  21207. <p>
  21208. (<em>Appears on:</em>
  21209. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  21210. </p>
  21211. <p>
  21212. <p>ExternalSecretMetadataPolicy defines the policy for fetching tags/labels from provider secrets.</p>
  21213. </p>
  21214. <table>
  21215. <thead>
  21216. <tr>
  21217. <th>Value</th>
  21218. <th>Description</th>
  21219. </tr>
  21220. </thead>
  21221. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  21222. <td><p>ExternalSecretMetadataPolicyFetch indicates that metadata will be fetched from the provider.</p>
  21223. </td>
  21224. </tr><tr><td><p>&#34;None&#34;</p></td>
  21225. <td><p>ExternalSecretMetadataPolicyNone indicates that no metadata will be fetched.</p>
  21226. </td>
  21227. </tr></tbody>
  21228. </table>
  21229. <h3 id="external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  21230. (<code>string</code> alias)</p></h3>
  21231. <p>
  21232. (<em>Appears on:</em>
  21233. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  21234. </p>
  21235. <p>
  21236. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  21237. </p>
  21238. <table>
  21239. <thead>
  21240. <tr>
  21241. <th>Value</th>
  21242. <th>Description</th>
  21243. </tr>
  21244. </thead>
  21245. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  21246. <td><p>RefreshPolicyCreatedOnce creates the Secret only if it does not exist and does not update it thereafter.</p>
  21247. </td>
  21248. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  21249. <td><p>RefreshPolicyOnChange only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes.</p>
  21250. </td>
  21251. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  21252. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the external source at regular intervals.</p>
  21253. </td>
  21254. </tr></tbody>
  21255. </table>
  21256. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite
  21257. </h3>
  21258. <p>
  21259. (<em>Appears on:</em>
  21260. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  21261. </p>
  21262. <p>
  21263. <p>ExternalSecretRewrite defines rules on how to rewrite secret keys.</p>
  21264. </p>
  21265. <table>
  21266. <thead>
  21267. <tr>
  21268. <th>Field</th>
  21269. <th>Description</th>
  21270. </tr>
  21271. </thead>
  21272. <tbody>
  21273. <tr>
  21274. <td>
  21275. <code>regexp</code></br>
  21276. <em>
  21277. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">
  21278. ExternalSecretRewriteRegexp
  21279. </a>
  21280. </em>
  21281. </td>
  21282. <td>
  21283. <em>(Optional)</em>
  21284. <p>Used to rewrite with regular expressions.
  21285. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  21286. </td>
  21287. </tr>
  21288. <tr>
  21289. <td>
  21290. <code>transform</code></br>
  21291. <em>
  21292. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteTransform">
  21293. ExternalSecretRewriteTransform
  21294. </a>
  21295. </em>
  21296. </td>
  21297. <td>
  21298. <em>(Optional)</em>
  21299. <p>Used to apply string transformation on the secrets.
  21300. The resulting key will be the output of the template applied by the operation.</p>
  21301. </td>
  21302. </tr>
  21303. </tbody>
  21304. </table>
  21305. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  21306. </h3>
  21307. <p>
  21308. (<em>Appears on:</em>
  21309. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  21310. </p>
  21311. <p>
  21312. <p>ExternalSecretRewriteRegexp defines how to use regular expressions for rewriting secret keys.</p>
  21313. </p>
  21314. <table>
  21315. <thead>
  21316. <tr>
  21317. <th>Field</th>
  21318. <th>Description</th>
  21319. </tr>
  21320. </thead>
  21321. <tbody>
  21322. <tr>
  21323. <td>
  21324. <code>source</code></br>
  21325. <em>
  21326. string
  21327. </em>
  21328. </td>
  21329. <td>
  21330. <p>Used to define the regular expression of a re.Compiler.</p>
  21331. </td>
  21332. </tr>
  21333. <tr>
  21334. <td>
  21335. <code>target</code></br>
  21336. <em>
  21337. string
  21338. </em>
  21339. </td>
  21340. <td>
  21341. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  21342. </td>
  21343. </tr>
  21344. </tbody>
  21345. </table>
  21346. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  21347. </h3>
  21348. <p>
  21349. (<em>Appears on:</em>
  21350. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  21351. </p>
  21352. <p>
  21353. <p>ExternalSecretRewriteTransform defines how to use string templates for transforming secret keys.</p>
  21354. </p>
  21355. <table>
  21356. <thead>
  21357. <tr>
  21358. <th>Field</th>
  21359. <th>Description</th>
  21360. </tr>
  21361. </thead>
  21362. <tbody>
  21363. <tr>
  21364. <td>
  21365. <code>template</code></br>
  21366. <em>
  21367. string
  21368. </em>
  21369. </td>
  21370. <td>
  21371. <p>Used to define the template to apply on the secret name.
  21372. <code>.value</code> will specify the secret name in the template.</p>
  21373. </td>
  21374. </tr>
  21375. </tbody>
  21376. </table>
  21377. <h3 id="external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec
  21378. </h3>
  21379. <p>
  21380. (<em>Appears on:</em>
  21381. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  21382. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  21383. </p>
  21384. <p>
  21385. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  21386. </p>
  21387. <table>
  21388. <thead>
  21389. <tr>
  21390. <th>Field</th>
  21391. <th>Description</th>
  21392. </tr>
  21393. </thead>
  21394. <tbody>
  21395. <tr>
  21396. <td>
  21397. <code>secretStoreRef</code></br>
  21398. <em>
  21399. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  21400. SecretStoreRef
  21401. </a>
  21402. </em>
  21403. </td>
  21404. <td>
  21405. <em>(Optional)</em>
  21406. </td>
  21407. </tr>
  21408. <tr>
  21409. <td>
  21410. <code>target</code></br>
  21411. <em>
  21412. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  21413. ExternalSecretTarget
  21414. </a>
  21415. </em>
  21416. </td>
  21417. <td>
  21418. <em>(Optional)</em>
  21419. </td>
  21420. </tr>
  21421. <tr>
  21422. <td>
  21423. <code>refreshPolicy</code></br>
  21424. <em>
  21425. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  21426. ExternalSecretRefreshPolicy
  21427. </a>
  21428. </em>
  21429. </td>
  21430. <td>
  21431. <em>(Optional)</em>
  21432. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  21433. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  21434. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  21435. No periodic updates occur if refreshInterval is 0.
  21436. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  21437. </td>
  21438. </tr>
  21439. <tr>
  21440. <td>
  21441. <code>refreshInterval</code></br>
  21442. <em>
  21443. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  21444. Kubernetes meta/v1.Duration
  21445. </a>
  21446. </em>
  21447. </td>
  21448. <td>
  21449. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  21450. specified as Golang Duration strings.
  21451. 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;
  21452. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  21453. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  21454. </td>
  21455. </tr>
  21456. <tr>
  21457. <td>
  21458. <code>data</code></br>
  21459. <em>
  21460. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  21461. []ExternalSecretData
  21462. </a>
  21463. </em>
  21464. </td>
  21465. <td>
  21466. <em>(Optional)</em>
  21467. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  21468. </td>
  21469. </tr>
  21470. <tr>
  21471. <td>
  21472. <code>dataFrom</code></br>
  21473. <em>
  21474. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  21475. []ExternalSecretDataFromRemoteRef
  21476. </a>
  21477. </em>
  21478. </td>
  21479. <td>
  21480. <em>(Optional)</em>
  21481. <p>DataFrom is used to fetch all properties from a specific Provider data
  21482. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  21483. </td>
  21484. </tr>
  21485. </tbody>
  21486. </table>
  21487. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus
  21488. </h3>
  21489. <p>
  21490. (<em>Appears on:</em>
  21491. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  21492. </p>
  21493. <p>
  21494. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  21495. </p>
  21496. <table>
  21497. <thead>
  21498. <tr>
  21499. <th>Field</th>
  21500. <th>Description</th>
  21501. </tr>
  21502. </thead>
  21503. <tbody>
  21504. <tr>
  21505. <td>
  21506. <code>refreshTime</code></br>
  21507. <em>
  21508. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  21509. Kubernetes meta/v1.Time
  21510. </a>
  21511. </em>
  21512. </td>
  21513. <td>
  21514. <p>refreshTime is the time and date the external secret was fetched and
  21515. the target secret updated</p>
  21516. </td>
  21517. </tr>
  21518. <tr>
  21519. <td>
  21520. <code>syncedResourceVersion</code></br>
  21521. <em>
  21522. string
  21523. </em>
  21524. </td>
  21525. <td>
  21526. <p>SyncedResourceVersion keeps track of the last synced version</p>
  21527. </td>
  21528. </tr>
  21529. <tr>
  21530. <td>
  21531. <code>conditions</code></br>
  21532. <em>
  21533. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">
  21534. []ExternalSecretStatusCondition
  21535. </a>
  21536. </em>
  21537. </td>
  21538. <td>
  21539. <em>(Optional)</em>
  21540. </td>
  21541. </tr>
  21542. <tr>
  21543. <td>
  21544. <code>binding</code></br>
  21545. <em>
  21546. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  21547. Kubernetes core/v1.LocalObjectReference
  21548. </a>
  21549. </em>
  21550. </td>
  21551. <td>
  21552. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  21553. </td>
  21554. </tr>
  21555. </tbody>
  21556. </table>
  21557. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  21558. </h3>
  21559. <p>
  21560. (<em>Appears on:</em>
  21561. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus</a>)
  21562. </p>
  21563. <p>
  21564. <p>ExternalSecretStatusCondition contains condition information for an ExternalSecret.</p>
  21565. </p>
  21566. <table>
  21567. <thead>
  21568. <tr>
  21569. <th>Field</th>
  21570. <th>Description</th>
  21571. </tr>
  21572. </thead>
  21573. <tbody>
  21574. <tr>
  21575. <td>
  21576. <code>type</code></br>
  21577. <em>
  21578. <a href="#external-secrets.io/v1beta1.ExternalSecretConditionType">
  21579. ExternalSecretConditionType
  21580. </a>
  21581. </em>
  21582. </td>
  21583. <td>
  21584. </td>
  21585. </tr>
  21586. <tr>
  21587. <td>
  21588. <code>status</code></br>
  21589. <em>
  21590. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  21591. Kubernetes core/v1.ConditionStatus
  21592. </a>
  21593. </em>
  21594. </td>
  21595. <td>
  21596. </td>
  21597. </tr>
  21598. <tr>
  21599. <td>
  21600. <code>reason</code></br>
  21601. <em>
  21602. string
  21603. </em>
  21604. </td>
  21605. <td>
  21606. <em>(Optional)</em>
  21607. </td>
  21608. </tr>
  21609. <tr>
  21610. <td>
  21611. <code>message</code></br>
  21612. <em>
  21613. string
  21614. </em>
  21615. </td>
  21616. <td>
  21617. <em>(Optional)</em>
  21618. </td>
  21619. </tr>
  21620. <tr>
  21621. <td>
  21622. <code>lastTransitionTime</code></br>
  21623. <em>
  21624. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  21625. Kubernetes meta/v1.Time
  21626. </a>
  21627. </em>
  21628. </td>
  21629. <td>
  21630. <em>(Optional)</em>
  21631. </td>
  21632. </tr>
  21633. </tbody>
  21634. </table>
  21635. <h3 id="external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget
  21636. </h3>
  21637. <p>
  21638. (<em>Appears on:</em>
  21639. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  21640. </p>
  21641. <p>
  21642. <p>ExternalSecretTarget defines the Kubernetes Secret to be created
  21643. There can be only one target per ExternalSecret.</p>
  21644. </p>
  21645. <table>
  21646. <thead>
  21647. <tr>
  21648. <th>Field</th>
  21649. <th>Description</th>
  21650. </tr>
  21651. </thead>
  21652. <tbody>
  21653. <tr>
  21654. <td>
  21655. <code>name</code></br>
  21656. <em>
  21657. string
  21658. </em>
  21659. </td>
  21660. <td>
  21661. <em>(Optional)</em>
  21662. <p>The name of the Secret resource to be managed.
  21663. Defaults to the .metadata.name of the ExternalSecret resource</p>
  21664. </td>
  21665. </tr>
  21666. <tr>
  21667. <td>
  21668. <code>creationPolicy</code></br>
  21669. <em>
  21670. <a href="#external-secrets.io/v1beta1.ExternalSecretCreationPolicy">
  21671. ExternalSecretCreationPolicy
  21672. </a>
  21673. </em>
  21674. </td>
  21675. <td>
  21676. <em>(Optional)</em>
  21677. <p>CreationPolicy defines rules on how to create the resulting Secret.
  21678. Defaults to &ldquo;Owner&rdquo;</p>
  21679. </td>
  21680. </tr>
  21681. <tr>
  21682. <td>
  21683. <code>deletionPolicy</code></br>
  21684. <em>
  21685. <a href="#external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">
  21686. ExternalSecretDeletionPolicy
  21687. </a>
  21688. </em>
  21689. </td>
  21690. <td>
  21691. <em>(Optional)</em>
  21692. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  21693. Defaults to &ldquo;Retain&rdquo;</p>
  21694. </td>
  21695. </tr>
  21696. <tr>
  21697. <td>
  21698. <code>template</code></br>
  21699. <em>
  21700. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">
  21701. ExternalSecretTemplate
  21702. </a>
  21703. </em>
  21704. </td>
  21705. <td>
  21706. <em>(Optional)</em>
  21707. <p>Template defines a blueprint for the created Secret resource.</p>
  21708. </td>
  21709. </tr>
  21710. <tr>
  21711. <td>
  21712. <code>immutable</code></br>
  21713. <em>
  21714. bool
  21715. </em>
  21716. </td>
  21717. <td>
  21718. <em>(Optional)</em>
  21719. <p>Immutable defines if the final secret will be immutable</p>
  21720. </td>
  21721. </tr>
  21722. </tbody>
  21723. </table>
  21724. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate
  21725. </h3>
  21726. <p>
  21727. (<em>Appears on:</em>
  21728. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  21729. </p>
  21730. <p>
  21731. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  21732. 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>
  21733. </p>
  21734. <table>
  21735. <thead>
  21736. <tr>
  21737. <th>Field</th>
  21738. <th>Description</th>
  21739. </tr>
  21740. </thead>
  21741. <tbody>
  21742. <tr>
  21743. <td>
  21744. <code>type</code></br>
  21745. <em>
  21746. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  21747. Kubernetes core/v1.SecretType
  21748. </a>
  21749. </em>
  21750. </td>
  21751. <td>
  21752. <em>(Optional)</em>
  21753. </td>
  21754. </tr>
  21755. <tr>
  21756. <td>
  21757. <code>engineVersion</code></br>
  21758. <em>
  21759. <a href="#external-secrets.io/v1beta1.TemplateEngineVersion">
  21760. TemplateEngineVersion
  21761. </a>
  21762. </em>
  21763. </td>
  21764. <td>
  21765. <p>EngineVersion specifies the template engine version
  21766. that should be used to compile/execute the
  21767. template specified in .data and .templateFrom[].</p>
  21768. </td>
  21769. </tr>
  21770. <tr>
  21771. <td>
  21772. <code>metadata</code></br>
  21773. <em>
  21774. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">
  21775. ExternalSecretTemplateMetadata
  21776. </a>
  21777. </em>
  21778. </td>
  21779. <td>
  21780. <em>(Optional)</em>
  21781. </td>
  21782. </tr>
  21783. <tr>
  21784. <td>
  21785. <code>mergePolicy</code></br>
  21786. <em>
  21787. <a href="#external-secrets.io/v1beta1.TemplateMergePolicy">
  21788. TemplateMergePolicy
  21789. </a>
  21790. </em>
  21791. </td>
  21792. <td>
  21793. </td>
  21794. </tr>
  21795. <tr>
  21796. <td>
  21797. <code>data</code></br>
  21798. <em>
  21799. map[string]string
  21800. </em>
  21801. </td>
  21802. <td>
  21803. <em>(Optional)</em>
  21804. </td>
  21805. </tr>
  21806. <tr>
  21807. <td>
  21808. <code>templateFrom</code></br>
  21809. <em>
  21810. <a href="#external-secrets.io/v1beta1.TemplateFrom">
  21811. []TemplateFrom
  21812. </a>
  21813. </em>
  21814. </td>
  21815. <td>
  21816. <em>(Optional)</em>
  21817. </td>
  21818. </tr>
  21819. </tbody>
  21820. </table>
  21821. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  21822. </h3>
  21823. <p>
  21824. (<em>Appears on:</em>
  21825. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  21826. </p>
  21827. <p>
  21828. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  21829. </p>
  21830. <table>
  21831. <thead>
  21832. <tr>
  21833. <th>Field</th>
  21834. <th>Description</th>
  21835. </tr>
  21836. </thead>
  21837. <tbody>
  21838. <tr>
  21839. <td>
  21840. <code>annotations</code></br>
  21841. <em>
  21842. map[string]string
  21843. </em>
  21844. </td>
  21845. <td>
  21846. <em>(Optional)</em>
  21847. </td>
  21848. </tr>
  21849. <tr>
  21850. <td>
  21851. <code>labels</code></br>
  21852. <em>
  21853. map[string]string
  21854. </em>
  21855. </td>
  21856. <td>
  21857. <em>(Optional)</em>
  21858. </td>
  21859. </tr>
  21860. </tbody>
  21861. </table>
  21862. <h3 id="external-secrets.io/v1beta1.ExternalSecretValidator">ExternalSecretValidator
  21863. </h3>
  21864. <p>
  21865. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  21866. </p>
  21867. <h3 id="external-secrets.io/v1beta1.FakeProvider">FakeProvider
  21868. </h3>
  21869. <p>
  21870. (<em>Appears on:</em>
  21871. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21872. </p>
  21873. <p>
  21874. <p>FakeProvider configures a fake provider that returns static values.</p>
  21875. </p>
  21876. <table>
  21877. <thead>
  21878. <tr>
  21879. <th>Field</th>
  21880. <th>Description</th>
  21881. </tr>
  21882. </thead>
  21883. <tbody>
  21884. <tr>
  21885. <td>
  21886. <code>data</code></br>
  21887. <em>
  21888. <a href="#external-secrets.io/v1beta1.FakeProviderData">
  21889. []FakeProviderData
  21890. </a>
  21891. </em>
  21892. </td>
  21893. <td>
  21894. </td>
  21895. </tr>
  21896. </tbody>
  21897. </table>
  21898. <h3 id="external-secrets.io/v1beta1.FakeProviderData">FakeProviderData
  21899. </h3>
  21900. <p>
  21901. (<em>Appears on:</em>
  21902. <a href="#external-secrets.io/v1beta1.FakeProvider">FakeProvider</a>)
  21903. </p>
  21904. <p>
  21905. <p>FakeProviderData defines a key-value pair for the fake provider used in testing.</p>
  21906. </p>
  21907. <table>
  21908. <thead>
  21909. <tr>
  21910. <th>Field</th>
  21911. <th>Description</th>
  21912. </tr>
  21913. </thead>
  21914. <tbody>
  21915. <tr>
  21916. <td>
  21917. <code>key</code></br>
  21918. <em>
  21919. string
  21920. </em>
  21921. </td>
  21922. <td>
  21923. </td>
  21924. </tr>
  21925. <tr>
  21926. <td>
  21927. <code>value</code></br>
  21928. <em>
  21929. string
  21930. </em>
  21931. </td>
  21932. <td>
  21933. </td>
  21934. </tr>
  21935. <tr>
  21936. <td>
  21937. <code>version</code></br>
  21938. <em>
  21939. string
  21940. </em>
  21941. </td>
  21942. <td>
  21943. </td>
  21944. </tr>
  21945. </tbody>
  21946. </table>
  21947. <h3 id="external-secrets.io/v1beta1.FindName">FindName
  21948. </h3>
  21949. <p>
  21950. (<em>Appears on:</em>
  21951. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  21952. </p>
  21953. <p>
  21954. <p>FindName defines name matching criteria for finding secrets.</p>
  21955. </p>
  21956. <table>
  21957. <thead>
  21958. <tr>
  21959. <th>Field</th>
  21960. <th>Description</th>
  21961. </tr>
  21962. </thead>
  21963. <tbody>
  21964. <tr>
  21965. <td>
  21966. <code>regexp</code></br>
  21967. <em>
  21968. string
  21969. </em>
  21970. </td>
  21971. <td>
  21972. <em>(Optional)</em>
  21973. <p>Finds secrets base</p>
  21974. </td>
  21975. </tr>
  21976. </tbody>
  21977. </table>
  21978. <h3 id="external-secrets.io/v1beta1.FortanixProvider">FortanixProvider
  21979. </h3>
  21980. <p>
  21981. (<em>Appears on:</em>
  21982. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21983. </p>
  21984. <p>
  21985. <p>FortanixProvider configures a store to sync secrets using the Fortanix SDKMS provider.</p>
  21986. </p>
  21987. <table>
  21988. <thead>
  21989. <tr>
  21990. <th>Field</th>
  21991. <th>Description</th>
  21992. </tr>
  21993. </thead>
  21994. <tbody>
  21995. <tr>
  21996. <td>
  21997. <code>apiUrl</code></br>
  21998. <em>
  21999. string
  22000. </em>
  22001. </td>
  22002. <td>
  22003. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  22004. </td>
  22005. </tr>
  22006. <tr>
  22007. <td>
  22008. <code>apiKey</code></br>
  22009. <em>
  22010. <a href="#external-secrets.io/v1beta1.FortanixProviderSecretRef">
  22011. FortanixProviderSecretRef
  22012. </a>
  22013. </em>
  22014. </td>
  22015. <td>
  22016. <p>APIKey is the API token to access SDKMS Applications.</p>
  22017. </td>
  22018. </tr>
  22019. </tbody>
  22020. </table>
  22021. <h3 id="external-secrets.io/v1beta1.FortanixProviderSecretRef">FortanixProviderSecretRef
  22022. </h3>
  22023. <p>
  22024. (<em>Appears on:</em>
  22025. <a href="#external-secrets.io/v1beta1.FortanixProvider">FortanixProvider</a>)
  22026. </p>
  22027. <p>
  22028. <p>FortanixProviderSecretRef defines a reference to a secret containing credentials for the Fortanix provider.</p>
  22029. </p>
  22030. <table>
  22031. <thead>
  22032. <tr>
  22033. <th>Field</th>
  22034. <th>Description</th>
  22035. </tr>
  22036. </thead>
  22037. <tbody>
  22038. <tr>
  22039. <td>
  22040. <code>secretRef</code></br>
  22041. <em>
  22042. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22043. External Secrets meta/v1.SecretKeySelector
  22044. </a>
  22045. </em>
  22046. </td>
  22047. <td>
  22048. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  22049. </td>
  22050. </tr>
  22051. </tbody>
  22052. </table>
  22053. <h3 id="external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth
  22054. </h3>
  22055. <p>
  22056. (<em>Appears on:</em>
  22057. <a href="#external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider</a>)
  22058. </p>
  22059. <p>
  22060. <p>GCPSMAuth defines the authentication methods for the GCP Secret Manager provider.</p>
  22061. </p>
  22062. <table>
  22063. <thead>
  22064. <tr>
  22065. <th>Field</th>
  22066. <th>Description</th>
  22067. </tr>
  22068. </thead>
  22069. <tbody>
  22070. <tr>
  22071. <td>
  22072. <code>secretRef</code></br>
  22073. <em>
  22074. <a href="#external-secrets.io/v1beta1.GCPSMAuthSecretRef">
  22075. GCPSMAuthSecretRef
  22076. </a>
  22077. </em>
  22078. </td>
  22079. <td>
  22080. <em>(Optional)</em>
  22081. </td>
  22082. </tr>
  22083. <tr>
  22084. <td>
  22085. <code>workloadIdentity</code></br>
  22086. <em>
  22087. <a href="#external-secrets.io/v1beta1.GCPWorkloadIdentity">
  22088. GCPWorkloadIdentity
  22089. </a>
  22090. </em>
  22091. </td>
  22092. <td>
  22093. <em>(Optional)</em>
  22094. </td>
  22095. </tr>
  22096. </tbody>
  22097. </table>
  22098. <h3 id="external-secrets.io/v1beta1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  22099. </h3>
  22100. <p>
  22101. (<em>Appears on:</em>
  22102. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  22103. </p>
  22104. <p>
  22105. <p>GCPSMAuthSecretRef defines a reference to a secret containing credentials for the GCP Secret Manager provider.</p>
  22106. </p>
  22107. <table>
  22108. <thead>
  22109. <tr>
  22110. <th>Field</th>
  22111. <th>Description</th>
  22112. </tr>
  22113. </thead>
  22114. <tbody>
  22115. <tr>
  22116. <td>
  22117. <code>secretAccessKeySecretRef</code></br>
  22118. <em>
  22119. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22120. External Secrets meta/v1.SecretKeySelector
  22121. </a>
  22122. </em>
  22123. </td>
  22124. <td>
  22125. <em>(Optional)</em>
  22126. <p>The SecretAccessKey is used for authentication</p>
  22127. </td>
  22128. </tr>
  22129. </tbody>
  22130. </table>
  22131. <h3 id="external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider
  22132. </h3>
  22133. <p>
  22134. (<em>Appears on:</em>
  22135. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22136. </p>
  22137. <p>
  22138. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  22139. </p>
  22140. <table>
  22141. <thead>
  22142. <tr>
  22143. <th>Field</th>
  22144. <th>Description</th>
  22145. </tr>
  22146. </thead>
  22147. <tbody>
  22148. <tr>
  22149. <td>
  22150. <code>auth</code></br>
  22151. <em>
  22152. <a href="#external-secrets.io/v1beta1.GCPSMAuth">
  22153. GCPSMAuth
  22154. </a>
  22155. </em>
  22156. </td>
  22157. <td>
  22158. <em>(Optional)</em>
  22159. <p>Auth defines the information necessary to authenticate against GCP</p>
  22160. </td>
  22161. </tr>
  22162. <tr>
  22163. <td>
  22164. <code>projectID</code></br>
  22165. <em>
  22166. string
  22167. </em>
  22168. </td>
  22169. <td>
  22170. <p>ProjectID project where secret is located</p>
  22171. </td>
  22172. </tr>
  22173. <tr>
  22174. <td>
  22175. <code>location</code></br>
  22176. <em>
  22177. string
  22178. </em>
  22179. </td>
  22180. <td>
  22181. <p>Location optionally defines a location for a secret</p>
  22182. </td>
  22183. </tr>
  22184. </tbody>
  22185. </table>
  22186. <h3 id="external-secrets.io/v1beta1.GCPWorkloadIdentity">GCPWorkloadIdentity
  22187. </h3>
  22188. <p>
  22189. (<em>Appears on:</em>
  22190. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  22191. </p>
  22192. <p>
  22193. <p>GCPWorkloadIdentity defines configuration for using GCP Workload Identity authentication.</p>
  22194. </p>
  22195. <table>
  22196. <thead>
  22197. <tr>
  22198. <th>Field</th>
  22199. <th>Description</th>
  22200. </tr>
  22201. </thead>
  22202. <tbody>
  22203. <tr>
  22204. <td>
  22205. <code>serviceAccountRef</code></br>
  22206. <em>
  22207. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  22208. External Secrets meta/v1.ServiceAccountSelector
  22209. </a>
  22210. </em>
  22211. </td>
  22212. <td>
  22213. </td>
  22214. </tr>
  22215. <tr>
  22216. <td>
  22217. <code>clusterLocation</code></br>
  22218. <em>
  22219. string
  22220. </em>
  22221. </td>
  22222. <td>
  22223. <em>(Optional)</em>
  22224. <p>ClusterLocation is the location of the cluster
  22225. If not specified, it fetches information from the metadata server</p>
  22226. </td>
  22227. </tr>
  22228. <tr>
  22229. <td>
  22230. <code>clusterName</code></br>
  22231. <em>
  22232. string
  22233. </em>
  22234. </td>
  22235. <td>
  22236. <em>(Optional)</em>
  22237. <p>ClusterName is the name of the cluster
  22238. If not specified, it fetches information from the metadata server</p>
  22239. </td>
  22240. </tr>
  22241. <tr>
  22242. <td>
  22243. <code>clusterProjectID</code></br>
  22244. <em>
  22245. string
  22246. </em>
  22247. </td>
  22248. <td>
  22249. <em>(Optional)</em>
  22250. <p>ClusterProjectID is the project ID of the cluster
  22251. If not specified, it fetches information from the metadata server</p>
  22252. </td>
  22253. </tr>
  22254. </tbody>
  22255. </table>
  22256. <h3 id="external-secrets.io/v1beta1.GeneratorRef">GeneratorRef
  22257. </h3>
  22258. <p>
  22259. (<em>Appears on:</em>
  22260. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  22261. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  22262. </p>
  22263. <p>
  22264. <p>GeneratorRef points to a generator custom resource.</p>
  22265. </p>
  22266. <table>
  22267. <thead>
  22268. <tr>
  22269. <th>Field</th>
  22270. <th>Description</th>
  22271. </tr>
  22272. </thead>
  22273. <tbody>
  22274. <tr>
  22275. <td>
  22276. <code>apiVersion</code></br>
  22277. <em>
  22278. string
  22279. </em>
  22280. </td>
  22281. <td>
  22282. <p>Specify the apiVersion of the generator resource</p>
  22283. </td>
  22284. </tr>
  22285. <tr>
  22286. <td>
  22287. <code>kind</code></br>
  22288. <em>
  22289. string
  22290. </em>
  22291. </td>
  22292. <td>
  22293. <p>Specify the Kind of the generator resource</p>
  22294. </td>
  22295. </tr>
  22296. <tr>
  22297. <td>
  22298. <code>name</code></br>
  22299. <em>
  22300. string
  22301. </em>
  22302. </td>
  22303. <td>
  22304. <p>Specify the name of the generator resource</p>
  22305. </td>
  22306. </tr>
  22307. </tbody>
  22308. </table>
  22309. <h3 id="external-secrets.io/v1beta1.GenericClusterStoreValidator">GenericClusterStoreValidator
  22310. </h3>
  22311. <p>
  22312. <p>GenericClusterStoreValidator provides validation for ClusterSecretStore resources.</p>
  22313. </p>
  22314. <h3 id="external-secrets.io/v1beta1.GenericStore">GenericStore
  22315. </h3>
  22316. <p>
  22317. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  22318. or a namespaced SecretStore.</p>
  22319. </p>
  22320. <h3 id="external-secrets.io/v1beta1.GenericStoreValidator">GenericStoreValidator
  22321. </h3>
  22322. <p>
  22323. <p>GenericStoreValidator provides validation for SecretStore resources.</p>
  22324. </p>
  22325. <h3 id="external-secrets.io/v1beta1.GithubAppAuth">GithubAppAuth
  22326. </h3>
  22327. <p>
  22328. (<em>Appears on:</em>
  22329. <a href="#external-secrets.io/v1beta1.GithubProvider">GithubProvider</a>)
  22330. </p>
  22331. <p>
  22332. <p>GithubAppAuth defines the GitHub App authentication mechanism for the GitHub provider.</p>
  22333. </p>
  22334. <table>
  22335. <thead>
  22336. <tr>
  22337. <th>Field</th>
  22338. <th>Description</th>
  22339. </tr>
  22340. </thead>
  22341. <tbody>
  22342. <tr>
  22343. <td>
  22344. <code>privateKey</code></br>
  22345. <em>
  22346. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22347. External Secrets meta/v1.SecretKeySelector
  22348. </a>
  22349. </em>
  22350. </td>
  22351. <td>
  22352. </td>
  22353. </tr>
  22354. </tbody>
  22355. </table>
  22356. <h3 id="external-secrets.io/v1beta1.GithubProvider">GithubProvider
  22357. </h3>
  22358. <p>
  22359. (<em>Appears on:</em>
  22360. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22361. </p>
  22362. <p>
  22363. <p>GithubProvider configures a store to push secrets to Github Actions.</p>
  22364. </p>
  22365. <table>
  22366. <thead>
  22367. <tr>
  22368. <th>Field</th>
  22369. <th>Description</th>
  22370. </tr>
  22371. </thead>
  22372. <tbody>
  22373. <tr>
  22374. <td>
  22375. <code>url</code></br>
  22376. <em>
  22377. string
  22378. </em>
  22379. </td>
  22380. <td>
  22381. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  22382. </td>
  22383. </tr>
  22384. <tr>
  22385. <td>
  22386. <code>uploadURL</code></br>
  22387. <em>
  22388. string
  22389. </em>
  22390. </td>
  22391. <td>
  22392. <em>(Optional)</em>
  22393. <p>Upload URL for enterprise instances. Default to URL.</p>
  22394. </td>
  22395. </tr>
  22396. <tr>
  22397. <td>
  22398. <code>auth</code></br>
  22399. <em>
  22400. <a href="#external-secrets.io/v1beta1.GithubAppAuth">
  22401. GithubAppAuth
  22402. </a>
  22403. </em>
  22404. </td>
  22405. <td>
  22406. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  22407. </td>
  22408. </tr>
  22409. <tr>
  22410. <td>
  22411. <code>appID</code></br>
  22412. <em>
  22413. int64
  22414. </em>
  22415. </td>
  22416. <td>
  22417. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  22418. </td>
  22419. </tr>
  22420. <tr>
  22421. <td>
  22422. <code>installationID</code></br>
  22423. <em>
  22424. int64
  22425. </em>
  22426. </td>
  22427. <td>
  22428. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  22429. </td>
  22430. </tr>
  22431. <tr>
  22432. <td>
  22433. <code>organization</code></br>
  22434. <em>
  22435. string
  22436. </em>
  22437. </td>
  22438. <td>
  22439. <p>organization will be used to fetch secrets from the Github organization</p>
  22440. </td>
  22441. </tr>
  22442. <tr>
  22443. <td>
  22444. <code>repository</code></br>
  22445. <em>
  22446. string
  22447. </em>
  22448. </td>
  22449. <td>
  22450. <em>(Optional)</em>
  22451. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  22452. </td>
  22453. </tr>
  22454. <tr>
  22455. <td>
  22456. <code>environment</code></br>
  22457. <em>
  22458. string
  22459. </em>
  22460. </td>
  22461. <td>
  22462. <em>(Optional)</em>
  22463. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  22464. </td>
  22465. </tr>
  22466. </tbody>
  22467. </table>
  22468. <h3 id="external-secrets.io/v1beta1.GitlabAuth">GitlabAuth
  22469. </h3>
  22470. <p>
  22471. (<em>Appears on:</em>
  22472. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>)
  22473. </p>
  22474. <p>
  22475. <p>GitlabAuth defines the authentication method for the GitLab provider.</p>
  22476. </p>
  22477. <table>
  22478. <thead>
  22479. <tr>
  22480. <th>Field</th>
  22481. <th>Description</th>
  22482. </tr>
  22483. </thead>
  22484. <tbody>
  22485. <tr>
  22486. <td>
  22487. <code>SecretRef</code></br>
  22488. <em>
  22489. <a href="#external-secrets.io/v1beta1.GitlabSecretRef">
  22490. GitlabSecretRef
  22491. </a>
  22492. </em>
  22493. </td>
  22494. <td>
  22495. </td>
  22496. </tr>
  22497. </tbody>
  22498. </table>
  22499. <h3 id="external-secrets.io/v1beta1.GitlabProvider">GitlabProvider
  22500. </h3>
  22501. <p>
  22502. (<em>Appears on:</em>
  22503. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22504. </p>
  22505. <p>
  22506. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  22507. </p>
  22508. <table>
  22509. <thead>
  22510. <tr>
  22511. <th>Field</th>
  22512. <th>Description</th>
  22513. </tr>
  22514. </thead>
  22515. <tbody>
  22516. <tr>
  22517. <td>
  22518. <code>url</code></br>
  22519. <em>
  22520. string
  22521. </em>
  22522. </td>
  22523. <td>
  22524. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  22525. </td>
  22526. </tr>
  22527. <tr>
  22528. <td>
  22529. <code>auth</code></br>
  22530. <em>
  22531. <a href="#external-secrets.io/v1beta1.GitlabAuth">
  22532. GitlabAuth
  22533. </a>
  22534. </em>
  22535. </td>
  22536. <td>
  22537. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  22538. </td>
  22539. </tr>
  22540. <tr>
  22541. <td>
  22542. <code>projectID</code></br>
  22543. <em>
  22544. string
  22545. </em>
  22546. </td>
  22547. <td>
  22548. <p>ProjectID specifies a project where secrets are located.</p>
  22549. </td>
  22550. </tr>
  22551. <tr>
  22552. <td>
  22553. <code>inheritFromGroups</code></br>
  22554. <em>
  22555. bool
  22556. </em>
  22557. </td>
  22558. <td>
  22559. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  22560. </td>
  22561. </tr>
  22562. <tr>
  22563. <td>
  22564. <code>groupIDs</code></br>
  22565. <em>
  22566. []string
  22567. </em>
  22568. </td>
  22569. <td>
  22570. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  22571. </td>
  22572. </tr>
  22573. <tr>
  22574. <td>
  22575. <code>environment</code></br>
  22576. <em>
  22577. string
  22578. </em>
  22579. </td>
  22580. <td>
  22581. <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>
  22582. </td>
  22583. </tr>
  22584. <tr>
  22585. <td>
  22586. <code>caBundle</code></br>
  22587. <em>
  22588. []byte
  22589. </em>
  22590. </td>
  22591. <td>
  22592. <em>(Optional)</em>
  22593. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  22594. can be performed.</p>
  22595. </td>
  22596. </tr>
  22597. <tr>
  22598. <td>
  22599. <code>caProvider</code></br>
  22600. <em>
  22601. <a href="#external-secrets.io/v1beta1.CAProvider">
  22602. CAProvider
  22603. </a>
  22604. </em>
  22605. </td>
  22606. <td>
  22607. <em>(Optional)</em>
  22608. <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>
  22609. </td>
  22610. </tr>
  22611. </tbody>
  22612. </table>
  22613. <h3 id="external-secrets.io/v1beta1.GitlabSecretRef">GitlabSecretRef
  22614. </h3>
  22615. <p>
  22616. (<em>Appears on:</em>
  22617. <a href="#external-secrets.io/v1beta1.GitlabAuth">GitlabAuth</a>)
  22618. </p>
  22619. <p>
  22620. <p>GitlabSecretRef defines a reference to a secret containing credentials for the GitLab provider.</p>
  22621. </p>
  22622. <table>
  22623. <thead>
  22624. <tr>
  22625. <th>Field</th>
  22626. <th>Description</th>
  22627. </tr>
  22628. </thead>
  22629. <tbody>
  22630. <tr>
  22631. <td>
  22632. <code>accessToken</code></br>
  22633. <em>
  22634. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22635. External Secrets meta/v1.SecretKeySelector
  22636. </a>
  22637. </em>
  22638. </td>
  22639. <td>
  22640. <p>AccessToken is used for authentication.</p>
  22641. </td>
  22642. </tr>
  22643. </tbody>
  22644. </table>
  22645. <h3 id="external-secrets.io/v1beta1.IBMAuth">IBMAuth
  22646. </h3>
  22647. <p>
  22648. (<em>Appears on:</em>
  22649. <a href="#external-secrets.io/v1beta1.IBMProvider">IBMProvider</a>)
  22650. </p>
  22651. <p>
  22652. <p>IBMAuth defines the authentication methods for the IBM Cloud Secrets Manager provider.</p>
  22653. </p>
  22654. <table>
  22655. <thead>
  22656. <tr>
  22657. <th>Field</th>
  22658. <th>Description</th>
  22659. </tr>
  22660. </thead>
  22661. <tbody>
  22662. <tr>
  22663. <td>
  22664. <code>secretRef</code></br>
  22665. <em>
  22666. <a href="#external-secrets.io/v1beta1.IBMAuthSecretRef">
  22667. IBMAuthSecretRef
  22668. </a>
  22669. </em>
  22670. </td>
  22671. <td>
  22672. </td>
  22673. </tr>
  22674. <tr>
  22675. <td>
  22676. <code>containerAuth</code></br>
  22677. <em>
  22678. <a href="#external-secrets.io/v1beta1.IBMAuthContainerAuth">
  22679. IBMAuthContainerAuth
  22680. </a>
  22681. </em>
  22682. </td>
  22683. <td>
  22684. </td>
  22685. </tr>
  22686. </tbody>
  22687. </table>
  22688. <h3 id="external-secrets.io/v1beta1.IBMAuthContainerAuth">IBMAuthContainerAuth
  22689. </h3>
  22690. <p>
  22691. (<em>Appears on:</em>
  22692. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  22693. </p>
  22694. <p>
  22695. <p>IBMAuthContainerAuth defines authentication using IBM Container-based auth with IAM Trusted Profile.</p>
  22696. </p>
  22697. <table>
  22698. <thead>
  22699. <tr>
  22700. <th>Field</th>
  22701. <th>Description</th>
  22702. </tr>
  22703. </thead>
  22704. <tbody>
  22705. <tr>
  22706. <td>
  22707. <code>profile</code></br>
  22708. <em>
  22709. string
  22710. </em>
  22711. </td>
  22712. <td>
  22713. <p>the IBM Trusted Profile</p>
  22714. </td>
  22715. </tr>
  22716. <tr>
  22717. <td>
  22718. <code>tokenLocation</code></br>
  22719. <em>
  22720. string
  22721. </em>
  22722. </td>
  22723. <td>
  22724. <p>Location the token is mounted on the pod</p>
  22725. </td>
  22726. </tr>
  22727. <tr>
  22728. <td>
  22729. <code>iamEndpoint</code></br>
  22730. <em>
  22731. string
  22732. </em>
  22733. </td>
  22734. <td>
  22735. </td>
  22736. </tr>
  22737. </tbody>
  22738. </table>
  22739. <h3 id="external-secrets.io/v1beta1.IBMAuthSecretRef">IBMAuthSecretRef
  22740. </h3>
  22741. <p>
  22742. (<em>Appears on:</em>
  22743. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  22744. </p>
  22745. <p>
  22746. <p>IBMAuthSecretRef defines a reference to a secret containing credentials for the IBM provider.</p>
  22747. </p>
  22748. <table>
  22749. <thead>
  22750. <tr>
  22751. <th>Field</th>
  22752. <th>Description</th>
  22753. </tr>
  22754. </thead>
  22755. <tbody>
  22756. <tr>
  22757. <td>
  22758. <code>secretApiKeySecretRef</code></br>
  22759. <em>
  22760. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22761. External Secrets meta/v1.SecretKeySelector
  22762. </a>
  22763. </em>
  22764. </td>
  22765. <td>
  22766. <p>The SecretAccessKey is used for authentication</p>
  22767. </td>
  22768. </tr>
  22769. </tbody>
  22770. </table>
  22771. <h3 id="external-secrets.io/v1beta1.IBMProvider">IBMProvider
  22772. </h3>
  22773. <p>
  22774. (<em>Appears on:</em>
  22775. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22776. </p>
  22777. <p>
  22778. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager backend.</p>
  22779. </p>
  22780. <table>
  22781. <thead>
  22782. <tr>
  22783. <th>Field</th>
  22784. <th>Description</th>
  22785. </tr>
  22786. </thead>
  22787. <tbody>
  22788. <tr>
  22789. <td>
  22790. <code>auth</code></br>
  22791. <em>
  22792. <a href="#external-secrets.io/v1beta1.IBMAuth">
  22793. IBMAuth
  22794. </a>
  22795. </em>
  22796. </td>
  22797. <td>
  22798. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  22799. </td>
  22800. </tr>
  22801. <tr>
  22802. <td>
  22803. <code>serviceUrl</code></br>
  22804. <em>
  22805. string
  22806. </em>
  22807. </td>
  22808. <td>
  22809. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  22810. </td>
  22811. </tr>
  22812. </tbody>
  22813. </table>
  22814. <h3 id="external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth
  22815. </h3>
  22816. <p>
  22817. (<em>Appears on:</em>
  22818. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  22819. </p>
  22820. <p>
  22821. <p>InfisicalAuth defines the authentication methods for the Infisical provider.</p>
  22822. </p>
  22823. <table>
  22824. <thead>
  22825. <tr>
  22826. <th>Field</th>
  22827. <th>Description</th>
  22828. </tr>
  22829. </thead>
  22830. <tbody>
  22831. <tr>
  22832. <td>
  22833. <code>universalAuthCredentials</code></br>
  22834. <em>
  22835. <a href="#external-secrets.io/v1beta1.UniversalAuthCredentials">
  22836. UniversalAuthCredentials
  22837. </a>
  22838. </em>
  22839. </td>
  22840. <td>
  22841. <em>(Optional)</em>
  22842. </td>
  22843. </tr>
  22844. </tbody>
  22845. </table>
  22846. <h3 id="external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider
  22847. </h3>
  22848. <p>
  22849. (<em>Appears on:</em>
  22850. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22851. </p>
  22852. <p>
  22853. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  22854. </p>
  22855. <table>
  22856. <thead>
  22857. <tr>
  22858. <th>Field</th>
  22859. <th>Description</th>
  22860. </tr>
  22861. </thead>
  22862. <tbody>
  22863. <tr>
  22864. <td>
  22865. <code>auth</code></br>
  22866. <em>
  22867. <a href="#external-secrets.io/v1beta1.InfisicalAuth">
  22868. InfisicalAuth
  22869. </a>
  22870. </em>
  22871. </td>
  22872. <td>
  22873. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  22874. </td>
  22875. </tr>
  22876. <tr>
  22877. <td>
  22878. <code>secretsScope</code></br>
  22879. <em>
  22880. <a href="#external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">
  22881. MachineIdentityScopeInWorkspace
  22882. </a>
  22883. </em>
  22884. </td>
  22885. <td>
  22886. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  22887. </td>
  22888. </tr>
  22889. <tr>
  22890. <td>
  22891. <code>hostAPI</code></br>
  22892. <em>
  22893. string
  22894. </em>
  22895. </td>
  22896. <td>
  22897. <em>(Optional)</em>
  22898. <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>
  22899. </td>
  22900. </tr>
  22901. </tbody>
  22902. </table>
  22903. <h3 id="external-secrets.io/v1beta1.KeeperSecurityProvider">KeeperSecurityProvider
  22904. </h3>
  22905. <p>
  22906. (<em>Appears on:</em>
  22907. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22908. </p>
  22909. <p>
  22910. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  22911. </p>
  22912. <table>
  22913. <thead>
  22914. <tr>
  22915. <th>Field</th>
  22916. <th>Description</th>
  22917. </tr>
  22918. </thead>
  22919. <tbody>
  22920. <tr>
  22921. <td>
  22922. <code>authRef</code></br>
  22923. <em>
  22924. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22925. External Secrets meta/v1.SecretKeySelector
  22926. </a>
  22927. </em>
  22928. </td>
  22929. <td>
  22930. </td>
  22931. </tr>
  22932. <tr>
  22933. <td>
  22934. <code>folderID</code></br>
  22935. <em>
  22936. string
  22937. </em>
  22938. </td>
  22939. <td>
  22940. </td>
  22941. </tr>
  22942. </tbody>
  22943. </table>
  22944. <h3 id="external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth
  22945. </h3>
  22946. <p>
  22947. (<em>Appears on:</em>
  22948. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  22949. </p>
  22950. <p>
  22951. <p>KubernetesAuth defines authentication methods for the Kubernetes provider.</p>
  22952. </p>
  22953. <table>
  22954. <thead>
  22955. <tr>
  22956. <th>Field</th>
  22957. <th>Description</th>
  22958. </tr>
  22959. </thead>
  22960. <tbody>
  22961. <tr>
  22962. <td>
  22963. <code>cert</code></br>
  22964. <em>
  22965. <a href="#external-secrets.io/v1beta1.CertAuth">
  22966. CertAuth
  22967. </a>
  22968. </em>
  22969. </td>
  22970. <td>
  22971. <em>(Optional)</em>
  22972. <p>has both clientCert and clientKey as secretKeySelector</p>
  22973. </td>
  22974. </tr>
  22975. <tr>
  22976. <td>
  22977. <code>token</code></br>
  22978. <em>
  22979. <a href="#external-secrets.io/v1beta1.TokenAuth">
  22980. TokenAuth
  22981. </a>
  22982. </em>
  22983. </td>
  22984. <td>
  22985. <em>(Optional)</em>
  22986. <p>use static token to authenticate with</p>
  22987. </td>
  22988. </tr>
  22989. <tr>
  22990. <td>
  22991. <code>serviceAccount</code></br>
  22992. <em>
  22993. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  22994. External Secrets meta/v1.ServiceAccountSelector
  22995. </a>
  22996. </em>
  22997. </td>
  22998. <td>
  22999. <em>(Optional)</em>
  23000. <p>points to a service account that should be used for authentication</p>
  23001. </td>
  23002. </tr>
  23003. </tbody>
  23004. </table>
  23005. <h3 id="external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider
  23006. </h3>
  23007. <p>
  23008. (<em>Appears on:</em>
  23009. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23010. </p>
  23011. <p>
  23012. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  23013. </p>
  23014. <table>
  23015. <thead>
  23016. <tr>
  23017. <th>Field</th>
  23018. <th>Description</th>
  23019. </tr>
  23020. </thead>
  23021. <tbody>
  23022. <tr>
  23023. <td>
  23024. <code>server</code></br>
  23025. <em>
  23026. <a href="#external-secrets.io/v1beta1.KubernetesServer">
  23027. KubernetesServer
  23028. </a>
  23029. </em>
  23030. </td>
  23031. <td>
  23032. <em>(Optional)</em>
  23033. <p>configures the Kubernetes server Address.</p>
  23034. </td>
  23035. </tr>
  23036. <tr>
  23037. <td>
  23038. <code>auth</code></br>
  23039. <em>
  23040. <a href="#external-secrets.io/v1beta1.KubernetesAuth">
  23041. KubernetesAuth
  23042. </a>
  23043. </em>
  23044. </td>
  23045. <td>
  23046. <em>(Optional)</em>
  23047. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  23048. </td>
  23049. </tr>
  23050. <tr>
  23051. <td>
  23052. <code>authRef</code></br>
  23053. <em>
  23054. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23055. External Secrets meta/v1.SecretKeySelector
  23056. </a>
  23057. </em>
  23058. </td>
  23059. <td>
  23060. <em>(Optional)</em>
  23061. <p>A reference to a secret that contains the auth information.</p>
  23062. </td>
  23063. </tr>
  23064. <tr>
  23065. <td>
  23066. <code>remoteNamespace</code></br>
  23067. <em>
  23068. string
  23069. </em>
  23070. </td>
  23071. <td>
  23072. <em>(Optional)</em>
  23073. <p>Remote namespace to fetch the secrets from</p>
  23074. </td>
  23075. </tr>
  23076. </tbody>
  23077. </table>
  23078. <h3 id="external-secrets.io/v1beta1.KubernetesServer">KubernetesServer
  23079. </h3>
  23080. <p>
  23081. (<em>Appears on:</em>
  23082. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  23083. </p>
  23084. <p>
  23085. <p>KubernetesServer defines the Kubernetes server connection configuration.</p>
  23086. </p>
  23087. <table>
  23088. <thead>
  23089. <tr>
  23090. <th>Field</th>
  23091. <th>Description</th>
  23092. </tr>
  23093. </thead>
  23094. <tbody>
  23095. <tr>
  23096. <td>
  23097. <code>url</code></br>
  23098. <em>
  23099. string
  23100. </em>
  23101. </td>
  23102. <td>
  23103. <em>(Optional)</em>
  23104. <p>configures the Kubernetes server Address.</p>
  23105. </td>
  23106. </tr>
  23107. <tr>
  23108. <td>
  23109. <code>caBundle</code></br>
  23110. <em>
  23111. []byte
  23112. </em>
  23113. </td>
  23114. <td>
  23115. <em>(Optional)</em>
  23116. <p>CABundle is a base64-encoded CA certificate</p>
  23117. </td>
  23118. </tr>
  23119. <tr>
  23120. <td>
  23121. <code>caProvider</code></br>
  23122. <em>
  23123. <a href="#external-secrets.io/v1beta1.CAProvider">
  23124. CAProvider
  23125. </a>
  23126. </em>
  23127. </td>
  23128. <td>
  23129. <em>(Optional)</em>
  23130. <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>
  23131. </td>
  23132. </tr>
  23133. </tbody>
  23134. </table>
  23135. <h3 id="external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  23136. </h3>
  23137. <p>
  23138. (<em>Appears on:</em>
  23139. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  23140. </p>
  23141. <p>
  23142. <p>MachineIdentityScopeInWorkspace defines the scope of a machine identity in an Infisical workspace.</p>
  23143. </p>
  23144. <table>
  23145. <thead>
  23146. <tr>
  23147. <th>Field</th>
  23148. <th>Description</th>
  23149. </tr>
  23150. </thead>
  23151. <tbody>
  23152. <tr>
  23153. <td>
  23154. <code>secretsPath</code></br>
  23155. <em>
  23156. string
  23157. </em>
  23158. </td>
  23159. <td>
  23160. <em>(Optional)</em>
  23161. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  23162. </td>
  23163. </tr>
  23164. <tr>
  23165. <td>
  23166. <code>recursive</code></br>
  23167. <em>
  23168. bool
  23169. </em>
  23170. </td>
  23171. <td>
  23172. <em>(Optional)</em>
  23173. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  23174. </td>
  23175. </tr>
  23176. <tr>
  23177. <td>
  23178. <code>environmentSlug</code></br>
  23179. <em>
  23180. string
  23181. </em>
  23182. </td>
  23183. <td>
  23184. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  23185. </td>
  23186. </tr>
  23187. <tr>
  23188. <td>
  23189. <code>projectSlug</code></br>
  23190. <em>
  23191. string
  23192. </em>
  23193. </td>
  23194. <td>
  23195. <p>ProjectSlug is the required slug identifier for the project.</p>
  23196. </td>
  23197. </tr>
  23198. <tr>
  23199. <td>
  23200. <code>expandSecretReferences</code></br>
  23201. <em>
  23202. bool
  23203. </em>
  23204. </td>
  23205. <td>
  23206. <em>(Optional)</em>
  23207. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  23208. </td>
  23209. </tr>
  23210. </tbody>
  23211. </table>
  23212. <h3 id="external-secrets.io/v1beta1.NTLMProtocol">NTLMProtocol
  23213. </h3>
  23214. <p>
  23215. (<em>Appears on:</em>
  23216. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol</a>)
  23217. </p>
  23218. <p>
  23219. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  23220. </p>
  23221. <table>
  23222. <thead>
  23223. <tr>
  23224. <th>Field</th>
  23225. <th>Description</th>
  23226. </tr>
  23227. </thead>
  23228. <tbody>
  23229. <tr>
  23230. <td>
  23231. <code>usernameSecret</code></br>
  23232. <em>
  23233. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23234. External Secrets meta/v1.SecretKeySelector
  23235. </a>
  23236. </em>
  23237. </td>
  23238. <td>
  23239. </td>
  23240. </tr>
  23241. <tr>
  23242. <td>
  23243. <code>passwordSecret</code></br>
  23244. <em>
  23245. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23246. External Secrets meta/v1.SecretKeySelector
  23247. </a>
  23248. </em>
  23249. </td>
  23250. <td>
  23251. </td>
  23252. </tr>
  23253. </tbody>
  23254. </table>
  23255. <h3 id="external-secrets.io/v1beta1.NoSecretError">NoSecretError
  23256. </h3>
  23257. <p>
  23258. <p>NoSecretError shall be returned when a GetSecret can not find the
  23259. desired secret. This is used for deletionPolicy.</p>
  23260. </p>
  23261. <h3 id="external-secrets.io/v1beta1.NotModifiedError">NotModifiedError
  23262. </h3>
  23263. <p>
  23264. <p>NotModifiedError to signal that the webhook received no changes,
  23265. and it should just return without doing anything.</p>
  23266. </p>
  23267. <h3 id="external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  23268. </h3>
  23269. <p>
  23270. (<em>Appears on:</em>
  23271. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider</a>)
  23272. </p>
  23273. <p>
  23274. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  23275. </p>
  23276. <table>
  23277. <thead>
  23278. <tr>
  23279. <th>Field</th>
  23280. <th>Description</th>
  23281. </tr>
  23282. </thead>
  23283. <tbody>
  23284. <tr>
  23285. <td>
  23286. <code>apiKeyRef</code></br>
  23287. <em>
  23288. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23289. External Secrets meta/v1.SecretKeySelector
  23290. </a>
  23291. </em>
  23292. </td>
  23293. <td>
  23294. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  23295. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  23296. </td>
  23297. </tr>
  23298. <tr>
  23299. <td>
  23300. <code>passcodeRef</code></br>
  23301. <em>
  23302. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23303. External Secrets meta/v1.SecretKeySelector
  23304. </a>
  23305. </em>
  23306. </td>
  23307. <td>
  23308. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  23309. </td>
  23310. </tr>
  23311. </tbody>
  23312. </table>
  23313. <h3 id="external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider
  23314. </h3>
  23315. <p>
  23316. (<em>Appears on:</em>
  23317. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23318. </p>
  23319. <p>
  23320. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  23321. Project and Config are required if not using a Service Token.</p>
  23322. </p>
  23323. <table>
  23324. <thead>
  23325. <tr>
  23326. <th>Field</th>
  23327. <th>Description</th>
  23328. </tr>
  23329. </thead>
  23330. <tbody>
  23331. <tr>
  23332. <td>
  23333. <code>auth</code></br>
  23334. <em>
  23335. <a href="#external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">
  23336. OnboardbaseAuthSecretRef
  23337. </a>
  23338. </em>
  23339. </td>
  23340. <td>
  23341. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  23342. </td>
  23343. </tr>
  23344. <tr>
  23345. <td>
  23346. <code>apiHost</code></br>
  23347. <em>
  23348. string
  23349. </em>
  23350. </td>
  23351. <td>
  23352. <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>
  23353. </td>
  23354. </tr>
  23355. <tr>
  23356. <td>
  23357. <code>project</code></br>
  23358. <em>
  23359. string
  23360. </em>
  23361. </td>
  23362. <td>
  23363. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  23364. </td>
  23365. </tr>
  23366. <tr>
  23367. <td>
  23368. <code>environment</code></br>
  23369. <em>
  23370. string
  23371. </em>
  23372. </td>
  23373. <td>
  23374. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  23375. </td>
  23376. </tr>
  23377. </tbody>
  23378. </table>
  23379. <h3 id="external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth
  23380. </h3>
  23381. <p>
  23382. (<em>Appears on:</em>
  23383. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider</a>)
  23384. </p>
  23385. <p>
  23386. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  23387. </p>
  23388. <table>
  23389. <thead>
  23390. <tr>
  23391. <th>Field</th>
  23392. <th>Description</th>
  23393. </tr>
  23394. </thead>
  23395. <tbody>
  23396. <tr>
  23397. <td>
  23398. <code>secretRef</code></br>
  23399. <em>
  23400. <a href="#external-secrets.io/v1beta1.OnePasswordAuthSecretRef">
  23401. OnePasswordAuthSecretRef
  23402. </a>
  23403. </em>
  23404. </td>
  23405. <td>
  23406. </td>
  23407. </tr>
  23408. </tbody>
  23409. </table>
  23410. <h3 id="external-secrets.io/v1beta1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  23411. </h3>
  23412. <p>
  23413. (<em>Appears on:</em>
  23414. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth</a>)
  23415. </p>
  23416. <p>
  23417. <p>OnePasswordAuthSecretRef holds secret references for 1Password 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>connectTokenSecretRef</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 ConnectToken is used for authentication to a 1Password Connect Server.</p>
  23438. </td>
  23439. </tr>
  23440. </tbody>
  23441. </table>
  23442. <h3 id="external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider
  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>OnePasswordProvider configures a store to sync secrets using the 1Password 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.OnePasswordAuth">
  23464. OnePasswordAuth
  23465. </a>
  23466. </em>
  23467. </td>
  23468. <td>
  23469. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  23470. </td>
  23471. </tr>
  23472. <tr>
  23473. <td>
  23474. <code>connectHost</code></br>
  23475. <em>
  23476. string
  23477. </em>
  23478. </td>
  23479. <td>
  23480. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  23481. </td>
  23482. </tr>
  23483. <tr>
  23484. <td>
  23485. <code>vaults</code></br>
  23486. <em>
  23487. map[string]int
  23488. </em>
  23489. </td>
  23490. <td>
  23491. <p>Vaults defines which OnePassword vaults to search in which order</p>
  23492. </td>
  23493. </tr>
  23494. </tbody>
  23495. </table>
  23496. <h3 id="external-secrets.io/v1beta1.OracleAuth">OracleAuth
  23497. </h3>
  23498. <p>
  23499. (<em>Appears on:</em>
  23500. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  23501. </p>
  23502. <p>
  23503. <p>OracleAuth defines authentication configuration for the Oracle Vault provider.</p>
  23504. </p>
  23505. <table>
  23506. <thead>
  23507. <tr>
  23508. <th>Field</th>
  23509. <th>Description</th>
  23510. </tr>
  23511. </thead>
  23512. <tbody>
  23513. <tr>
  23514. <td>
  23515. <code>tenancy</code></br>
  23516. <em>
  23517. string
  23518. </em>
  23519. </td>
  23520. <td>
  23521. <p>Tenancy is the tenancy OCID where user is located.</p>
  23522. </td>
  23523. </tr>
  23524. <tr>
  23525. <td>
  23526. <code>user</code></br>
  23527. <em>
  23528. string
  23529. </em>
  23530. </td>
  23531. <td>
  23532. <p>User is an access OCID specific to the account.</p>
  23533. </td>
  23534. </tr>
  23535. <tr>
  23536. <td>
  23537. <code>secretRef</code></br>
  23538. <em>
  23539. <a href="#external-secrets.io/v1beta1.OracleSecretRef">
  23540. OracleSecretRef
  23541. </a>
  23542. </em>
  23543. </td>
  23544. <td>
  23545. <p>SecretRef to pass through sensitive information.</p>
  23546. </td>
  23547. </tr>
  23548. </tbody>
  23549. </table>
  23550. <h3 id="external-secrets.io/v1beta1.OraclePrincipalType">OraclePrincipalType
  23551. (<code>string</code> alias)</p></h3>
  23552. <p>
  23553. (<em>Appears on:</em>
  23554. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  23555. </p>
  23556. <p>
  23557. <p>OraclePrincipalType defines the type of principal used for authentication to Oracle Vault.</p>
  23558. </p>
  23559. <table>
  23560. <thead>
  23561. <tr>
  23562. <th>Value</th>
  23563. <th>Description</th>
  23564. </tr>
  23565. </thead>
  23566. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  23567. <td><p>InstancePrincipal represents a instance principal.</p>
  23568. </td>
  23569. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  23570. <td><p>UserPrincipal represents a user principal.</p>
  23571. </td>
  23572. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  23573. <td><p>WorkloadPrincipal represents a workload principal.</p>
  23574. </td>
  23575. </tr></tbody>
  23576. </table>
  23577. <h3 id="external-secrets.io/v1beta1.OracleProvider">OracleProvider
  23578. </h3>
  23579. <p>
  23580. (<em>Appears on:</em>
  23581. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23582. </p>
  23583. <p>
  23584. <p>OracleProvider configures a store to sync secrets using an Oracle Vault backend.</p>
  23585. </p>
  23586. <table>
  23587. <thead>
  23588. <tr>
  23589. <th>Field</th>
  23590. <th>Description</th>
  23591. </tr>
  23592. </thead>
  23593. <tbody>
  23594. <tr>
  23595. <td>
  23596. <code>region</code></br>
  23597. <em>
  23598. string
  23599. </em>
  23600. </td>
  23601. <td>
  23602. <p>Region is the region where vault is located.</p>
  23603. </td>
  23604. </tr>
  23605. <tr>
  23606. <td>
  23607. <code>vault</code></br>
  23608. <em>
  23609. string
  23610. </em>
  23611. </td>
  23612. <td>
  23613. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  23614. </td>
  23615. </tr>
  23616. <tr>
  23617. <td>
  23618. <code>compartment</code></br>
  23619. <em>
  23620. string
  23621. </em>
  23622. </td>
  23623. <td>
  23624. <em>(Optional)</em>
  23625. <p>Compartment is the vault compartment OCID.
  23626. Required for PushSecret</p>
  23627. </td>
  23628. </tr>
  23629. <tr>
  23630. <td>
  23631. <code>encryptionKey</code></br>
  23632. <em>
  23633. string
  23634. </em>
  23635. </td>
  23636. <td>
  23637. <em>(Optional)</em>
  23638. <p>EncryptionKey is the OCID of the encryption key within the vault.
  23639. Required for PushSecret</p>
  23640. </td>
  23641. </tr>
  23642. <tr>
  23643. <td>
  23644. <code>principalType</code></br>
  23645. <em>
  23646. <a href="#external-secrets.io/v1beta1.OraclePrincipalType">
  23647. OraclePrincipalType
  23648. </a>
  23649. </em>
  23650. </td>
  23651. <td>
  23652. <em>(Optional)</em>
  23653. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  23654. determine the principal type. This optional field must be specified if using
  23655. workload identity.</p>
  23656. </td>
  23657. </tr>
  23658. <tr>
  23659. <td>
  23660. <code>auth</code></br>
  23661. <em>
  23662. <a href="#external-secrets.io/v1beta1.OracleAuth">
  23663. OracleAuth
  23664. </a>
  23665. </em>
  23666. </td>
  23667. <td>
  23668. <em>(Optional)</em>
  23669. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  23670. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  23671. </td>
  23672. </tr>
  23673. <tr>
  23674. <td>
  23675. <code>serviceAccountRef</code></br>
  23676. <em>
  23677. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  23678. External Secrets meta/v1.ServiceAccountSelector
  23679. </a>
  23680. </em>
  23681. </td>
  23682. <td>
  23683. <em>(Optional)</em>
  23684. <p>ServiceAccountRef specified the service account
  23685. that should be used when authenticating with WorkloadIdentity.</p>
  23686. </td>
  23687. </tr>
  23688. </tbody>
  23689. </table>
  23690. <h3 id="external-secrets.io/v1beta1.OracleSecretRef">OracleSecretRef
  23691. </h3>
  23692. <p>
  23693. (<em>Appears on:</em>
  23694. <a href="#external-secrets.io/v1beta1.OracleAuth">OracleAuth</a>)
  23695. </p>
  23696. <p>
  23697. <p>OracleSecretRef defines references to secrets containing Oracle credentials.</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>privatekey</code></br>
  23710. <em>
  23711. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23712. External Secrets meta/v1.SecretKeySelector
  23713. </a>
  23714. </em>
  23715. </td>
  23716. <td>
  23717. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  23718. </td>
  23719. </tr>
  23720. <tr>
  23721. <td>
  23722. <code>fingerprint</code></br>
  23723. <em>
  23724. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23725. External Secrets meta/v1.SecretKeySelector
  23726. </a>
  23727. </em>
  23728. </td>
  23729. <td>
  23730. <p>Fingerprint is the fingerprint of the API private key.</p>
  23731. </td>
  23732. </tr>
  23733. </tbody>
  23734. </table>
  23735. <h3 id="external-secrets.io/v1beta1.PassboltAuth">PassboltAuth
  23736. </h3>
  23737. <p>
  23738. (<em>Appears on:</em>
  23739. <a href="#external-secrets.io/v1beta1.PassboltProvider">PassboltProvider</a>)
  23740. </p>
  23741. <p>
  23742. <p>PassboltAuth contains credentials and configuration for authenticating with the Passbolt server.</p>
  23743. </p>
  23744. <table>
  23745. <thead>
  23746. <tr>
  23747. <th>Field</th>
  23748. <th>Description</th>
  23749. </tr>
  23750. </thead>
  23751. <tbody>
  23752. <tr>
  23753. <td>
  23754. <code>passwordSecretRef</code></br>
  23755. <em>
  23756. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23757. External Secrets meta/v1.SecretKeySelector
  23758. </a>
  23759. </em>
  23760. </td>
  23761. <td>
  23762. <p>PasswordSecretRef is a reference to the secret containing the Passbolt password</p>
  23763. </td>
  23764. </tr>
  23765. <tr>
  23766. <td>
  23767. <code>privateKeySecretRef</code></br>
  23768. <em>
  23769. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23770. External Secrets meta/v1.SecretKeySelector
  23771. </a>
  23772. </em>
  23773. </td>
  23774. <td>
  23775. <p>PrivateKeySecretRef is a reference to the secret containing the Passbolt private key</p>
  23776. </td>
  23777. </tr>
  23778. </tbody>
  23779. </table>
  23780. <h3 id="external-secrets.io/v1beta1.PassboltProvider">PassboltProvider
  23781. </h3>
  23782. <p>
  23783. (<em>Appears on:</em>
  23784. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23785. </p>
  23786. <p>
  23787. <p>PassboltProvider defines configuration for the Passbolt provider.</p>
  23788. </p>
  23789. <table>
  23790. <thead>
  23791. <tr>
  23792. <th>Field</th>
  23793. <th>Description</th>
  23794. </tr>
  23795. </thead>
  23796. <tbody>
  23797. <tr>
  23798. <td>
  23799. <code>auth</code></br>
  23800. <em>
  23801. <a href="#external-secrets.io/v1beta1.PassboltAuth">
  23802. PassboltAuth
  23803. </a>
  23804. </em>
  23805. </td>
  23806. <td>
  23807. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  23808. </td>
  23809. </tr>
  23810. <tr>
  23811. <td>
  23812. <code>host</code></br>
  23813. <em>
  23814. string
  23815. </em>
  23816. </td>
  23817. <td>
  23818. <p>Host defines the Passbolt Server to connect to</p>
  23819. </td>
  23820. </tr>
  23821. </tbody>
  23822. </table>
  23823. <h3 id="external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth
  23824. </h3>
  23825. <p>
  23826. (<em>Appears on:</em>
  23827. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider</a>)
  23828. </p>
  23829. <p>
  23830. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  23831. </p>
  23832. <table>
  23833. <thead>
  23834. <tr>
  23835. <th>Field</th>
  23836. <th>Description</th>
  23837. </tr>
  23838. </thead>
  23839. <tbody>
  23840. <tr>
  23841. <td>
  23842. <code>secretRef</code></br>
  23843. <em>
  23844. <a href="#external-secrets.io/v1beta1.PasswordDepotSecretRef">
  23845. PasswordDepotSecretRef
  23846. </a>
  23847. </em>
  23848. </td>
  23849. <td>
  23850. </td>
  23851. </tr>
  23852. </tbody>
  23853. </table>
  23854. <h3 id="external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider
  23855. </h3>
  23856. <p>
  23857. (<em>Appears on:</em>
  23858. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23859. </p>
  23860. <p>
  23861. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  23862. </p>
  23863. <table>
  23864. <thead>
  23865. <tr>
  23866. <th>Field</th>
  23867. <th>Description</th>
  23868. </tr>
  23869. </thead>
  23870. <tbody>
  23871. <tr>
  23872. <td>
  23873. <code>host</code></br>
  23874. <em>
  23875. string
  23876. </em>
  23877. </td>
  23878. <td>
  23879. <p>URL configures the Password Depot instance URL.</p>
  23880. </td>
  23881. </tr>
  23882. <tr>
  23883. <td>
  23884. <code>database</code></br>
  23885. <em>
  23886. string
  23887. </em>
  23888. </td>
  23889. <td>
  23890. <p>Database to use as source</p>
  23891. </td>
  23892. </tr>
  23893. <tr>
  23894. <td>
  23895. <code>auth</code></br>
  23896. <em>
  23897. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">
  23898. PasswordDepotAuth
  23899. </a>
  23900. </em>
  23901. </td>
  23902. <td>
  23903. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  23904. </td>
  23905. </tr>
  23906. </tbody>
  23907. </table>
  23908. <h3 id="external-secrets.io/v1beta1.PasswordDepotSecretRef">PasswordDepotSecretRef
  23909. </h3>
  23910. <p>
  23911. (<em>Appears on:</em>
  23912. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth</a>)
  23913. </p>
  23914. <p>
  23915. <p>PasswordDepotSecretRef defines a reference to a secret containing credentials for the Password Depot provider.</p>
  23916. </p>
  23917. <table>
  23918. <thead>
  23919. <tr>
  23920. <th>Field</th>
  23921. <th>Description</th>
  23922. </tr>
  23923. </thead>
  23924. <tbody>
  23925. <tr>
  23926. <td>
  23927. <code>credentials</code></br>
  23928. <em>
  23929. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23930. External Secrets meta/v1.SecretKeySelector
  23931. </a>
  23932. </em>
  23933. </td>
  23934. <td>
  23935. <em>(Optional)</em>
  23936. <p>Username / Password is used for authentication.</p>
  23937. </td>
  23938. </tr>
  23939. </tbody>
  23940. </table>
  23941. <h3 id="external-secrets.io/v1beta1.PreviderAuth">PreviderAuth
  23942. </h3>
  23943. <p>
  23944. (<em>Appears on:</em>
  23945. <a href="#external-secrets.io/v1beta1.PreviderProvider">PreviderProvider</a>)
  23946. </p>
  23947. <p>
  23948. <p>PreviderAuth contains a secretRef for credentials.</p>
  23949. </p>
  23950. <table>
  23951. <thead>
  23952. <tr>
  23953. <th>Field</th>
  23954. <th>Description</th>
  23955. </tr>
  23956. </thead>
  23957. <tbody>
  23958. <tr>
  23959. <td>
  23960. <code>secretRef</code></br>
  23961. <em>
  23962. <a href="#external-secrets.io/v1beta1.PreviderAuthSecretRef">
  23963. PreviderAuthSecretRef
  23964. </a>
  23965. </em>
  23966. </td>
  23967. <td>
  23968. <em>(Optional)</em>
  23969. </td>
  23970. </tr>
  23971. </tbody>
  23972. </table>
  23973. <h3 id="external-secrets.io/v1beta1.PreviderAuthSecretRef">PreviderAuthSecretRef
  23974. </h3>
  23975. <p>
  23976. (<em>Appears on:</em>
  23977. <a href="#external-secrets.io/v1beta1.PreviderAuth">PreviderAuth</a>)
  23978. </p>
  23979. <p>
  23980. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  23981. </p>
  23982. <table>
  23983. <thead>
  23984. <tr>
  23985. <th>Field</th>
  23986. <th>Description</th>
  23987. </tr>
  23988. </thead>
  23989. <tbody>
  23990. <tr>
  23991. <td>
  23992. <code>accessToken</code></br>
  23993. <em>
  23994. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23995. External Secrets meta/v1.SecretKeySelector
  23996. </a>
  23997. </em>
  23998. </td>
  23999. <td>
  24000. <p>The AccessToken is used for authentication</p>
  24001. </td>
  24002. </tr>
  24003. </tbody>
  24004. </table>
  24005. <h3 id="external-secrets.io/v1beta1.PreviderProvider">PreviderProvider
  24006. </h3>
  24007. <p>
  24008. (<em>Appears on:</em>
  24009. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24010. </p>
  24011. <p>
  24012. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  24013. </p>
  24014. <table>
  24015. <thead>
  24016. <tr>
  24017. <th>Field</th>
  24018. <th>Description</th>
  24019. </tr>
  24020. </thead>
  24021. <tbody>
  24022. <tr>
  24023. <td>
  24024. <code>auth</code></br>
  24025. <em>
  24026. <a href="#external-secrets.io/v1beta1.PreviderAuth">
  24027. PreviderAuth
  24028. </a>
  24029. </em>
  24030. </td>
  24031. <td>
  24032. </td>
  24033. </tr>
  24034. <tr>
  24035. <td>
  24036. <code>baseUri</code></br>
  24037. <em>
  24038. string
  24039. </em>
  24040. </td>
  24041. <td>
  24042. <em>(Optional)</em>
  24043. </td>
  24044. </tr>
  24045. </tbody>
  24046. </table>
  24047. <h3 id="external-secrets.io/v1beta1.Provider">Provider
  24048. </h3>
  24049. <p>
  24050. <p>Provider is a common interface for interacting with secret backends.</p>
  24051. </p>
  24052. <h3 id="external-secrets.io/v1beta1.PulumiProvider">PulumiProvider
  24053. </h3>
  24054. <p>
  24055. (<em>Appears on:</em>
  24056. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24057. </p>
  24058. <p>
  24059. <p>PulumiProvider defines configuration for the Pulumi provider.</p>
  24060. </p>
  24061. <table>
  24062. <thead>
  24063. <tr>
  24064. <th>Field</th>
  24065. <th>Description</th>
  24066. </tr>
  24067. </thead>
  24068. <tbody>
  24069. <tr>
  24070. <td>
  24071. <code>apiUrl</code></br>
  24072. <em>
  24073. string
  24074. </em>
  24075. </td>
  24076. <td>
  24077. <p>APIURL is the URL of the Pulumi API.</p>
  24078. </td>
  24079. </tr>
  24080. <tr>
  24081. <td>
  24082. <code>accessToken</code></br>
  24083. <em>
  24084. <a href="#external-secrets.io/v1beta1.PulumiProviderSecretRef">
  24085. PulumiProviderSecretRef
  24086. </a>
  24087. </em>
  24088. </td>
  24089. <td>
  24090. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  24091. </td>
  24092. </tr>
  24093. <tr>
  24094. <td>
  24095. <code>organization</code></br>
  24096. <em>
  24097. string
  24098. </em>
  24099. </td>
  24100. <td>
  24101. <p>Organization are a space to collaborate on shared projects and stacks.
  24102. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  24103. </td>
  24104. </tr>
  24105. <tr>
  24106. <td>
  24107. <code>project</code></br>
  24108. <em>
  24109. string
  24110. </em>
  24111. </td>
  24112. <td>
  24113. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  24114. </td>
  24115. </tr>
  24116. <tr>
  24117. <td>
  24118. <code>environment</code></br>
  24119. <em>
  24120. string
  24121. </em>
  24122. </td>
  24123. <td>
  24124. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  24125. dynamically retrieved values from supported providers including all major clouds,
  24126. and other Pulumi ESC environments.
  24127. 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>
  24128. </td>
  24129. </tr>
  24130. </tbody>
  24131. </table>
  24132. <h3 id="external-secrets.io/v1beta1.PulumiProviderSecretRef">PulumiProviderSecretRef
  24133. </h3>
  24134. <p>
  24135. (<em>Appears on:</em>
  24136. <a href="#external-secrets.io/v1beta1.PulumiProvider">PulumiProvider</a>)
  24137. </p>
  24138. <p>
  24139. <p>PulumiProviderSecretRef defines a reference to a secret containing credentials for the Pulumi provider.</p>
  24140. </p>
  24141. <table>
  24142. <thead>
  24143. <tr>
  24144. <th>Field</th>
  24145. <th>Description</th>
  24146. </tr>
  24147. </thead>
  24148. <tbody>
  24149. <tr>
  24150. <td>
  24151. <code>secretRef</code></br>
  24152. <em>
  24153. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24154. External Secrets meta/v1.SecretKeySelector
  24155. </a>
  24156. </em>
  24157. </td>
  24158. <td>
  24159. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  24160. </td>
  24161. </tr>
  24162. </tbody>
  24163. </table>
  24164. <h3 id="external-secrets.io/v1beta1.PushSecretData">PushSecretData
  24165. </h3>
  24166. <p>
  24167. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1beta1.</p>
  24168. </p>
  24169. <h3 id="external-secrets.io/v1beta1.PushSecretRemoteRef">PushSecretRemoteRef
  24170. </h3>
  24171. <p>
  24172. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1beta1.</p>
  24173. </p>
  24174. <h3 id="external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider
  24175. </h3>
  24176. <p>
  24177. (<em>Appears on:</em>
  24178. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24179. </p>
  24180. <p>
  24181. <p>ScalewayProvider defines configuration for the Scaleway provider.</p>
  24182. </p>
  24183. <table>
  24184. <thead>
  24185. <tr>
  24186. <th>Field</th>
  24187. <th>Description</th>
  24188. </tr>
  24189. </thead>
  24190. <tbody>
  24191. <tr>
  24192. <td>
  24193. <code>apiUrl</code></br>
  24194. <em>
  24195. string
  24196. </em>
  24197. </td>
  24198. <td>
  24199. <em>(Optional)</em>
  24200. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  24201. </td>
  24202. </tr>
  24203. <tr>
  24204. <td>
  24205. <code>region</code></br>
  24206. <em>
  24207. string
  24208. </em>
  24209. </td>
  24210. <td>
  24211. <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>
  24212. </td>
  24213. </tr>
  24214. <tr>
  24215. <td>
  24216. <code>projectId</code></br>
  24217. <em>
  24218. string
  24219. </em>
  24220. </td>
  24221. <td>
  24222. <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>
  24223. </td>
  24224. </tr>
  24225. <tr>
  24226. <td>
  24227. <code>accessKey</code></br>
  24228. <em>
  24229. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  24230. ScalewayProviderSecretRef
  24231. </a>
  24232. </em>
  24233. </td>
  24234. <td>
  24235. <p>AccessKey is the non-secret part of the api key.</p>
  24236. </td>
  24237. </tr>
  24238. <tr>
  24239. <td>
  24240. <code>secretKey</code></br>
  24241. <em>
  24242. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  24243. ScalewayProviderSecretRef
  24244. </a>
  24245. </em>
  24246. </td>
  24247. <td>
  24248. <p>SecretKey is the non-secret part of the api key.</p>
  24249. </td>
  24250. </tr>
  24251. </tbody>
  24252. </table>
  24253. <h3 id="external-secrets.io/v1beta1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  24254. </h3>
  24255. <p>
  24256. (<em>Appears on:</em>
  24257. <a href="#external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider</a>)
  24258. </p>
  24259. <p>
  24260. <p>ScalewayProviderSecretRef defines a reference to a secret containing credentials for the Scaleway provider.</p>
  24261. </p>
  24262. <table>
  24263. <thead>
  24264. <tr>
  24265. <th>Field</th>
  24266. <th>Description</th>
  24267. </tr>
  24268. </thead>
  24269. <tbody>
  24270. <tr>
  24271. <td>
  24272. <code>value</code></br>
  24273. <em>
  24274. string
  24275. </em>
  24276. </td>
  24277. <td>
  24278. <em>(Optional)</em>
  24279. <p>Value can be specified directly to set a value without using a secret.</p>
  24280. </td>
  24281. </tr>
  24282. <tr>
  24283. <td>
  24284. <code>secretRef</code></br>
  24285. <em>
  24286. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24287. External Secrets meta/v1.SecretKeySelector
  24288. </a>
  24289. </em>
  24290. </td>
  24291. <td>
  24292. <em>(Optional)</em>
  24293. <p>SecretRef references a key in a secret that will be used as value.</p>
  24294. </td>
  24295. </tr>
  24296. </tbody>
  24297. </table>
  24298. <h3 id="external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider
  24299. </h3>
  24300. <p>
  24301. (<em>Appears on:</em>
  24302. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24303. </p>
  24304. <p>
  24305. <p>SecretServerProvider defines configuration for the Delinea Secret Server provider.
  24306. 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>
  24307. </p>
  24308. <table>
  24309. <thead>
  24310. <tr>
  24311. <th>Field</th>
  24312. <th>Description</th>
  24313. </tr>
  24314. </thead>
  24315. <tbody>
  24316. <tr>
  24317. <td>
  24318. <code>username</code></br>
  24319. <em>
  24320. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  24321. SecretServerProviderRef
  24322. </a>
  24323. </em>
  24324. </td>
  24325. <td>
  24326. <p>Username is the secret server account username.</p>
  24327. </td>
  24328. </tr>
  24329. <tr>
  24330. <td>
  24331. <code>password</code></br>
  24332. <em>
  24333. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  24334. SecretServerProviderRef
  24335. </a>
  24336. </em>
  24337. </td>
  24338. <td>
  24339. <p>Password is the secret server account password.</p>
  24340. </td>
  24341. </tr>
  24342. <tr>
  24343. <td>
  24344. <code>serverURL</code></br>
  24345. <em>
  24346. string
  24347. </em>
  24348. </td>
  24349. <td>
  24350. <p>ServerURL
  24351. URL to your secret server installation</p>
  24352. </td>
  24353. </tr>
  24354. </tbody>
  24355. </table>
  24356. <h3 id="external-secrets.io/v1beta1.SecretServerProviderRef">SecretServerProviderRef
  24357. </h3>
  24358. <p>
  24359. (<em>Appears on:</em>
  24360. <a href="#external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider</a>)
  24361. </p>
  24362. <p>
  24363. <p>SecretServerProviderRef defines a reference to a secret containing credentials for the Secret Server provider.</p>
  24364. </p>
  24365. <table>
  24366. <thead>
  24367. <tr>
  24368. <th>Field</th>
  24369. <th>Description</th>
  24370. </tr>
  24371. </thead>
  24372. <tbody>
  24373. <tr>
  24374. <td>
  24375. <code>value</code></br>
  24376. <em>
  24377. string
  24378. </em>
  24379. </td>
  24380. <td>
  24381. <em>(Optional)</em>
  24382. <p>Value can be specified directly to set a value without using a secret.</p>
  24383. </td>
  24384. </tr>
  24385. <tr>
  24386. <td>
  24387. <code>secretRef</code></br>
  24388. <em>
  24389. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24390. External Secrets meta/v1.SecretKeySelector
  24391. </a>
  24392. </em>
  24393. </td>
  24394. <td>
  24395. <em>(Optional)</em>
  24396. <p>SecretRef references a key in a secret that will be used as value.</p>
  24397. </td>
  24398. </tr>
  24399. </tbody>
  24400. </table>
  24401. <h3 id="external-secrets.io/v1beta1.SecretStore">SecretStore
  24402. </h3>
  24403. <p>
  24404. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  24405. </p>
  24406. <table>
  24407. <thead>
  24408. <tr>
  24409. <th>Field</th>
  24410. <th>Description</th>
  24411. </tr>
  24412. </thead>
  24413. <tbody>
  24414. <tr>
  24415. <td>
  24416. <code>metadata</code></br>
  24417. <em>
  24418. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  24419. Kubernetes meta/v1.ObjectMeta
  24420. </a>
  24421. </em>
  24422. </td>
  24423. <td>
  24424. Refer to the Kubernetes API documentation for the fields of the
  24425. <code>metadata</code> field.
  24426. </td>
  24427. </tr>
  24428. <tr>
  24429. <td>
  24430. <code>spec</code></br>
  24431. <em>
  24432. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  24433. SecretStoreSpec
  24434. </a>
  24435. </em>
  24436. </td>
  24437. <td>
  24438. <br/>
  24439. <br/>
  24440. <table>
  24441. <tr>
  24442. <td>
  24443. <code>controller</code></br>
  24444. <em>
  24445. string
  24446. </em>
  24447. </td>
  24448. <td>
  24449. <em>(Optional)</em>
  24450. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  24451. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  24452. </td>
  24453. </tr>
  24454. <tr>
  24455. <td>
  24456. <code>provider</code></br>
  24457. <em>
  24458. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  24459. SecretStoreProvider
  24460. </a>
  24461. </em>
  24462. </td>
  24463. <td>
  24464. <p>Used to configure the provider. Only one provider may be set</p>
  24465. </td>
  24466. </tr>
  24467. <tr>
  24468. <td>
  24469. <code>retrySettings</code></br>
  24470. <em>
  24471. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  24472. SecretStoreRetrySettings
  24473. </a>
  24474. </em>
  24475. </td>
  24476. <td>
  24477. <em>(Optional)</em>
  24478. <p>Used to configure HTTP retries on failures.</p>
  24479. </td>
  24480. </tr>
  24481. <tr>
  24482. <td>
  24483. <code>refreshInterval</code></br>
  24484. <em>
  24485. int
  24486. </em>
  24487. </td>
  24488. <td>
  24489. <em>(Optional)</em>
  24490. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  24491. </td>
  24492. </tr>
  24493. <tr>
  24494. <td>
  24495. <code>conditions</code></br>
  24496. <em>
  24497. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  24498. []ClusterSecretStoreCondition
  24499. </a>
  24500. </em>
  24501. </td>
  24502. <td>
  24503. <em>(Optional)</em>
  24504. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  24505. </td>
  24506. </tr>
  24507. </table>
  24508. </td>
  24509. </tr>
  24510. <tr>
  24511. <td>
  24512. <code>status</code></br>
  24513. <em>
  24514. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  24515. SecretStoreStatus
  24516. </a>
  24517. </em>
  24518. </td>
  24519. <td>
  24520. </td>
  24521. </tr>
  24522. </tbody>
  24523. </table>
  24524. <h3 id="external-secrets.io/v1beta1.SecretStoreCapabilities">SecretStoreCapabilities
  24525. (<code>string</code> alias)</p></h3>
  24526. <p>
  24527. (<em>Appears on:</em>
  24528. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  24529. </p>
  24530. <p>
  24531. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  24532. </p>
  24533. <table>
  24534. <thead>
  24535. <tr>
  24536. <th>Value</th>
  24537. <th>Description</th>
  24538. </tr>
  24539. </thead>
  24540. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  24541. <td><p>SecretStoreReadOnly indicates that the SecretStore only supports reading secrets.</p>
  24542. </td>
  24543. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  24544. <td><p>SecretStoreReadWrite indicates that the SecretStore supports both reading and writing secrets.</p>
  24545. </td>
  24546. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  24547. <td><p>SecretStoreWriteOnly indicates that the SecretStore only supports writing secrets.</p>
  24548. </td>
  24549. </tr></tbody>
  24550. </table>
  24551. <h3 id="external-secrets.io/v1beta1.SecretStoreConditionType">SecretStoreConditionType
  24552. (<code>string</code> alias)</p></h3>
  24553. <p>
  24554. (<em>Appears on:</em>
  24555. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  24556. </p>
  24557. <p>
  24558. <p>SecretStoreConditionType represents the condition type of the SecretStore.</p>
  24559. </p>
  24560. <table>
  24561. <thead>
  24562. <tr>
  24563. <th>Value</th>
  24564. <th>Description</th>
  24565. </tr>
  24566. </thead>
  24567. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  24568. <td><p>SecretStoreReady indicates that the SecretStore has been successfully configured.</p>
  24569. </td>
  24570. </tr></tbody>
  24571. </table>
  24572. <h3 id="external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider
  24573. </h3>
  24574. <p>
  24575. (<em>Appears on:</em>
  24576. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  24577. </p>
  24578. <p>
  24579. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  24580. </p>
  24581. <table>
  24582. <thead>
  24583. <tr>
  24584. <th>Field</th>
  24585. <th>Description</th>
  24586. </tr>
  24587. </thead>
  24588. <tbody>
  24589. <tr>
  24590. <td>
  24591. <code>aws</code></br>
  24592. <em>
  24593. <a href="#external-secrets.io/v1beta1.AWSProvider">
  24594. AWSProvider
  24595. </a>
  24596. </em>
  24597. </td>
  24598. <td>
  24599. <em>(Optional)</em>
  24600. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  24601. </td>
  24602. </tr>
  24603. <tr>
  24604. <td>
  24605. <code>azurekv</code></br>
  24606. <em>
  24607. <a href="#external-secrets.io/v1beta1.AzureKVProvider">
  24608. AzureKVProvider
  24609. </a>
  24610. </em>
  24611. </td>
  24612. <td>
  24613. <em>(Optional)</em>
  24614. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  24615. </td>
  24616. </tr>
  24617. <tr>
  24618. <td>
  24619. <code>akeyless</code></br>
  24620. <em>
  24621. <a href="#external-secrets.io/v1beta1.AkeylessProvider">
  24622. AkeylessProvider
  24623. </a>
  24624. </em>
  24625. </td>
  24626. <td>
  24627. <em>(Optional)</em>
  24628. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  24629. </td>
  24630. </tr>
  24631. <tr>
  24632. <td>
  24633. <code>bitwardensecretsmanager</code></br>
  24634. <em>
  24635. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">
  24636. BitwardenSecretsManagerProvider
  24637. </a>
  24638. </em>
  24639. </td>
  24640. <td>
  24641. <em>(Optional)</em>
  24642. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  24643. </td>
  24644. </tr>
  24645. <tr>
  24646. <td>
  24647. <code>vault</code></br>
  24648. <em>
  24649. <a href="#external-secrets.io/v1beta1.VaultProvider">
  24650. VaultProvider
  24651. </a>
  24652. </em>
  24653. </td>
  24654. <td>
  24655. <em>(Optional)</em>
  24656. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  24657. </td>
  24658. </tr>
  24659. <tr>
  24660. <td>
  24661. <code>gcpsm</code></br>
  24662. <em>
  24663. <a href="#external-secrets.io/v1beta1.GCPSMProvider">
  24664. GCPSMProvider
  24665. </a>
  24666. </em>
  24667. </td>
  24668. <td>
  24669. <em>(Optional)</em>
  24670. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  24671. </td>
  24672. </tr>
  24673. <tr>
  24674. <td>
  24675. <code>oracle</code></br>
  24676. <em>
  24677. <a href="#external-secrets.io/v1beta1.OracleProvider">
  24678. OracleProvider
  24679. </a>
  24680. </em>
  24681. </td>
  24682. <td>
  24683. <em>(Optional)</em>
  24684. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  24685. </td>
  24686. </tr>
  24687. <tr>
  24688. <td>
  24689. <code>ibm</code></br>
  24690. <em>
  24691. <a href="#external-secrets.io/v1beta1.IBMProvider">
  24692. IBMProvider
  24693. </a>
  24694. </em>
  24695. </td>
  24696. <td>
  24697. <em>(Optional)</em>
  24698. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  24699. </td>
  24700. </tr>
  24701. <tr>
  24702. <td>
  24703. <code>yandexcertificatemanager</code></br>
  24704. <em>
  24705. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">
  24706. YandexCertificateManagerProvider
  24707. </a>
  24708. </em>
  24709. </td>
  24710. <td>
  24711. <em>(Optional)</em>
  24712. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  24713. </td>
  24714. </tr>
  24715. <tr>
  24716. <td>
  24717. <code>yandexlockbox</code></br>
  24718. <em>
  24719. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">
  24720. YandexLockboxProvider
  24721. </a>
  24722. </em>
  24723. </td>
  24724. <td>
  24725. <em>(Optional)</em>
  24726. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  24727. </td>
  24728. </tr>
  24729. <tr>
  24730. <td>
  24731. <code>github</code></br>
  24732. <em>
  24733. <a href="#external-secrets.io/v1beta1.GithubProvider">
  24734. GithubProvider
  24735. </a>
  24736. </em>
  24737. </td>
  24738. <td>
  24739. <em>(Optional)</em>
  24740. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.</p>
  24741. </td>
  24742. </tr>
  24743. <tr>
  24744. <td>
  24745. <code>gitlab</code></br>
  24746. <em>
  24747. <a href="#external-secrets.io/v1beta1.GitlabProvider">
  24748. GitlabProvider
  24749. </a>
  24750. </em>
  24751. </td>
  24752. <td>
  24753. <em>(Optional)</em>
  24754. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  24755. </td>
  24756. </tr>
  24757. <tr>
  24758. <td>
  24759. <code>alibaba</code></br>
  24760. <em>
  24761. <a href="#external-secrets.io/v1beta1.AlibabaProvider">
  24762. AlibabaProvider
  24763. </a>
  24764. </em>
  24765. </td>
  24766. <td>
  24767. <em>(Optional)</em>
  24768. <p>Alibaba configures this store to sync secrets using Alibaba Cloud provider</p>
  24769. </td>
  24770. </tr>
  24771. <tr>
  24772. <td>
  24773. <code>onepassword</code></br>
  24774. <em>
  24775. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">
  24776. OnePasswordProvider
  24777. </a>
  24778. </em>
  24779. </td>
  24780. <td>
  24781. <em>(Optional)</em>
  24782. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  24783. </td>
  24784. </tr>
  24785. <tr>
  24786. <td>
  24787. <code>webhook</code></br>
  24788. <em>
  24789. <a href="#external-secrets.io/v1beta1.WebhookProvider">
  24790. WebhookProvider
  24791. </a>
  24792. </em>
  24793. </td>
  24794. <td>
  24795. <em>(Optional)</em>
  24796. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  24797. </td>
  24798. </tr>
  24799. <tr>
  24800. <td>
  24801. <code>kubernetes</code></br>
  24802. <em>
  24803. <a href="#external-secrets.io/v1beta1.KubernetesProvider">
  24804. KubernetesProvider
  24805. </a>
  24806. </em>
  24807. </td>
  24808. <td>
  24809. <em>(Optional)</em>
  24810. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  24811. </td>
  24812. </tr>
  24813. <tr>
  24814. <td>
  24815. <code>fake</code></br>
  24816. <em>
  24817. <a href="#external-secrets.io/v1beta1.FakeProvider">
  24818. FakeProvider
  24819. </a>
  24820. </em>
  24821. </td>
  24822. <td>
  24823. <em>(Optional)</em>
  24824. <p>Fake configures a store with static key/value pairs</p>
  24825. </td>
  24826. </tr>
  24827. <tr>
  24828. <td>
  24829. <code>senhasegura</code></br>
  24830. <em>
  24831. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">
  24832. SenhaseguraProvider
  24833. </a>
  24834. </em>
  24835. </td>
  24836. <td>
  24837. <em>(Optional)</em>
  24838. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  24839. </td>
  24840. </tr>
  24841. <tr>
  24842. <td>
  24843. <code>scaleway</code></br>
  24844. <em>
  24845. <a href="#external-secrets.io/v1beta1.ScalewayProvider">
  24846. ScalewayProvider
  24847. </a>
  24848. </em>
  24849. </td>
  24850. <td>
  24851. <em>(Optional)</em>
  24852. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  24853. </td>
  24854. </tr>
  24855. <tr>
  24856. <td>
  24857. <code>doppler</code></br>
  24858. <em>
  24859. <a href="#external-secrets.io/v1beta1.DopplerProvider">
  24860. DopplerProvider
  24861. </a>
  24862. </em>
  24863. </td>
  24864. <td>
  24865. <em>(Optional)</em>
  24866. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  24867. </td>
  24868. </tr>
  24869. <tr>
  24870. <td>
  24871. <code>previder</code></br>
  24872. <em>
  24873. <a href="#external-secrets.io/v1beta1.PreviderProvider">
  24874. PreviderProvider
  24875. </a>
  24876. </em>
  24877. </td>
  24878. <td>
  24879. <em>(Optional)</em>
  24880. <p>Previder configures this store to sync secrets using the Previder provider</p>
  24881. </td>
  24882. </tr>
  24883. <tr>
  24884. <td>
  24885. <code>onboardbase</code></br>
  24886. <em>
  24887. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">
  24888. OnboardbaseProvider
  24889. </a>
  24890. </em>
  24891. </td>
  24892. <td>
  24893. <em>(Optional)</em>
  24894. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  24895. </td>
  24896. </tr>
  24897. <tr>
  24898. <td>
  24899. <code>keepersecurity</code></br>
  24900. <em>
  24901. <a href="#external-secrets.io/v1beta1.KeeperSecurityProvider">
  24902. KeeperSecurityProvider
  24903. </a>
  24904. </em>
  24905. </td>
  24906. <td>
  24907. <em>(Optional)</em>
  24908. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  24909. </td>
  24910. </tr>
  24911. <tr>
  24912. <td>
  24913. <code>conjur</code></br>
  24914. <em>
  24915. <a href="#external-secrets.io/v1beta1.ConjurProvider">
  24916. ConjurProvider
  24917. </a>
  24918. </em>
  24919. </td>
  24920. <td>
  24921. <em>(Optional)</em>
  24922. <p>Conjur configures this store to sync secrets using conjur provider</p>
  24923. </td>
  24924. </tr>
  24925. <tr>
  24926. <td>
  24927. <code>delinea</code></br>
  24928. <em>
  24929. <a href="#external-secrets.io/v1beta1.DelineaProvider">
  24930. DelineaProvider
  24931. </a>
  24932. </em>
  24933. </td>
  24934. <td>
  24935. <em>(Optional)</em>
  24936. <p>Delinea DevOps Secrets Vault
  24937. <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>
  24938. </td>
  24939. </tr>
  24940. <tr>
  24941. <td>
  24942. <code>secretserver</code></br>
  24943. <em>
  24944. <a href="#external-secrets.io/v1beta1.SecretServerProvider">
  24945. SecretServerProvider
  24946. </a>
  24947. </em>
  24948. </td>
  24949. <td>
  24950. <em>(Optional)</em>
  24951. <p>SecretServer configures this store to sync secrets using SecretServer provider
  24952. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  24953. </td>
  24954. </tr>
  24955. <tr>
  24956. <td>
  24957. <code>chef</code></br>
  24958. <em>
  24959. <a href="#external-secrets.io/v1beta1.ChefProvider">
  24960. ChefProvider
  24961. </a>
  24962. </em>
  24963. </td>
  24964. <td>
  24965. <em>(Optional)</em>
  24966. <p>Chef configures this store to sync secrets with chef server</p>
  24967. </td>
  24968. </tr>
  24969. <tr>
  24970. <td>
  24971. <code>pulumi</code></br>
  24972. <em>
  24973. <a href="#external-secrets.io/v1beta1.PulumiProvider">
  24974. PulumiProvider
  24975. </a>
  24976. </em>
  24977. </td>
  24978. <td>
  24979. <em>(Optional)</em>
  24980. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  24981. </td>
  24982. </tr>
  24983. <tr>
  24984. <td>
  24985. <code>fortanix</code></br>
  24986. <em>
  24987. <a href="#external-secrets.io/v1beta1.FortanixProvider">
  24988. FortanixProvider
  24989. </a>
  24990. </em>
  24991. </td>
  24992. <td>
  24993. <em>(Optional)</em>
  24994. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  24995. </td>
  24996. </tr>
  24997. <tr>
  24998. <td>
  24999. <code>passworddepot</code></br>
  25000. <em>
  25001. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">
  25002. PasswordDepotProvider
  25003. </a>
  25004. </em>
  25005. </td>
  25006. <td>
  25007. <em>(Optional)</em>
  25008. </td>
  25009. </tr>
  25010. <tr>
  25011. <td>
  25012. <code>passbolt</code></br>
  25013. <em>
  25014. <a href="#external-secrets.io/v1beta1.PassboltProvider">
  25015. PassboltProvider
  25016. </a>
  25017. </em>
  25018. </td>
  25019. <td>
  25020. <em>(Optional)</em>
  25021. </td>
  25022. </tr>
  25023. <tr>
  25024. <td>
  25025. <code>device42</code></br>
  25026. <em>
  25027. <a href="#external-secrets.io/v1beta1.Device42Provider">
  25028. Device42Provider
  25029. </a>
  25030. </em>
  25031. </td>
  25032. <td>
  25033. <em>(Optional)</em>
  25034. <p>Device42 configures this store to sync secrets using the Device42 provider</p>
  25035. </td>
  25036. </tr>
  25037. <tr>
  25038. <td>
  25039. <code>infisical</code></br>
  25040. <em>
  25041. <a href="#external-secrets.io/v1beta1.InfisicalProvider">
  25042. InfisicalProvider
  25043. </a>
  25044. </em>
  25045. </td>
  25046. <td>
  25047. <em>(Optional)</em>
  25048. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  25049. </td>
  25050. </tr>
  25051. <tr>
  25052. <td>
  25053. <code>beyondtrust</code></br>
  25054. <em>
  25055. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">
  25056. BeyondtrustProvider
  25057. </a>
  25058. </em>
  25059. </td>
  25060. <td>
  25061. <em>(Optional)</em>
  25062. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  25063. </td>
  25064. </tr>
  25065. <tr>
  25066. <td>
  25067. <code>cloudrusm</code></br>
  25068. <em>
  25069. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">
  25070. CloudruSMProvider
  25071. </a>
  25072. </em>
  25073. </td>
  25074. <td>
  25075. <em>(Optional)</em>
  25076. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  25077. </td>
  25078. </tr>
  25079. </tbody>
  25080. </table>
  25081. <h3 id="external-secrets.io/v1beta1.SecretStoreRef">SecretStoreRef
  25082. </h3>
  25083. <p>
  25084. (<em>Appears on:</em>
  25085. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>,
  25086. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  25087. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  25088. </p>
  25089. <p>
  25090. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  25091. </p>
  25092. <table>
  25093. <thead>
  25094. <tr>
  25095. <th>Field</th>
  25096. <th>Description</th>
  25097. </tr>
  25098. </thead>
  25099. <tbody>
  25100. <tr>
  25101. <td>
  25102. <code>name</code></br>
  25103. <em>
  25104. string
  25105. </em>
  25106. </td>
  25107. <td>
  25108. <p>Name of the SecretStore resource</p>
  25109. </td>
  25110. </tr>
  25111. <tr>
  25112. <td>
  25113. <code>kind</code></br>
  25114. <em>
  25115. string
  25116. </em>
  25117. </td>
  25118. <td>
  25119. <em>(Optional)</em>
  25120. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  25121. Defaults to <code>SecretStore</code></p>
  25122. </td>
  25123. </tr>
  25124. </tbody>
  25125. </table>
  25126. <h3 id="external-secrets.io/v1beta1.SecretStoreRetrySettings">SecretStoreRetrySettings
  25127. </h3>
  25128. <p>
  25129. (<em>Appears on:</em>
  25130. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  25131. </p>
  25132. <p>
  25133. <p>SecretStoreRetrySettings defines configuration for retrying failed requests to the provider.</p>
  25134. </p>
  25135. <table>
  25136. <thead>
  25137. <tr>
  25138. <th>Field</th>
  25139. <th>Description</th>
  25140. </tr>
  25141. </thead>
  25142. <tbody>
  25143. <tr>
  25144. <td>
  25145. <code>maxRetries</code></br>
  25146. <em>
  25147. int32
  25148. </em>
  25149. </td>
  25150. <td>
  25151. <p>MaxRetries is the maximum number of retry attempts.</p>
  25152. </td>
  25153. </tr>
  25154. <tr>
  25155. <td>
  25156. <code>retryInterval</code></br>
  25157. <em>
  25158. string
  25159. </em>
  25160. </td>
  25161. <td>
  25162. <p>RetryInterval is the interval between retry attempts.</p>
  25163. </td>
  25164. </tr>
  25165. </tbody>
  25166. </table>
  25167. <h3 id="external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec
  25168. </h3>
  25169. <p>
  25170. (<em>Appears on:</em>
  25171. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  25172. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  25173. </p>
  25174. <p>
  25175. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  25176. </p>
  25177. <table>
  25178. <thead>
  25179. <tr>
  25180. <th>Field</th>
  25181. <th>Description</th>
  25182. </tr>
  25183. </thead>
  25184. <tbody>
  25185. <tr>
  25186. <td>
  25187. <code>controller</code></br>
  25188. <em>
  25189. string
  25190. </em>
  25191. </td>
  25192. <td>
  25193. <em>(Optional)</em>
  25194. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  25195. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  25196. </td>
  25197. </tr>
  25198. <tr>
  25199. <td>
  25200. <code>provider</code></br>
  25201. <em>
  25202. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  25203. SecretStoreProvider
  25204. </a>
  25205. </em>
  25206. </td>
  25207. <td>
  25208. <p>Used to configure the provider. Only one provider may be set</p>
  25209. </td>
  25210. </tr>
  25211. <tr>
  25212. <td>
  25213. <code>retrySettings</code></br>
  25214. <em>
  25215. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  25216. SecretStoreRetrySettings
  25217. </a>
  25218. </em>
  25219. </td>
  25220. <td>
  25221. <em>(Optional)</em>
  25222. <p>Used to configure HTTP retries on failures.</p>
  25223. </td>
  25224. </tr>
  25225. <tr>
  25226. <td>
  25227. <code>refreshInterval</code></br>
  25228. <em>
  25229. int
  25230. </em>
  25231. </td>
  25232. <td>
  25233. <em>(Optional)</em>
  25234. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  25235. </td>
  25236. </tr>
  25237. <tr>
  25238. <td>
  25239. <code>conditions</code></br>
  25240. <em>
  25241. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  25242. []ClusterSecretStoreCondition
  25243. </a>
  25244. </em>
  25245. </td>
  25246. <td>
  25247. <em>(Optional)</em>
  25248. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  25249. </td>
  25250. </tr>
  25251. </tbody>
  25252. </table>
  25253. <h3 id="external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus
  25254. </h3>
  25255. <p>
  25256. (<em>Appears on:</em>
  25257. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  25258. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  25259. </p>
  25260. <p>
  25261. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  25262. </p>
  25263. <table>
  25264. <thead>
  25265. <tr>
  25266. <th>Field</th>
  25267. <th>Description</th>
  25268. </tr>
  25269. </thead>
  25270. <tbody>
  25271. <tr>
  25272. <td>
  25273. <code>conditions</code></br>
  25274. <em>
  25275. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">
  25276. []SecretStoreStatusCondition
  25277. </a>
  25278. </em>
  25279. </td>
  25280. <td>
  25281. <em>(Optional)</em>
  25282. </td>
  25283. </tr>
  25284. <tr>
  25285. <td>
  25286. <code>capabilities</code></br>
  25287. <em>
  25288. <a href="#external-secrets.io/v1beta1.SecretStoreCapabilities">
  25289. SecretStoreCapabilities
  25290. </a>
  25291. </em>
  25292. </td>
  25293. <td>
  25294. <em>(Optional)</em>
  25295. </td>
  25296. </tr>
  25297. </tbody>
  25298. </table>
  25299. <h3 id="external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition
  25300. </h3>
  25301. <p>
  25302. (<em>Appears on:</em>
  25303. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  25304. </p>
  25305. <p>
  25306. <p>SecretStoreStatusCondition defines the observed condition of the SecretStore.</p>
  25307. </p>
  25308. <table>
  25309. <thead>
  25310. <tr>
  25311. <th>Field</th>
  25312. <th>Description</th>
  25313. </tr>
  25314. </thead>
  25315. <tbody>
  25316. <tr>
  25317. <td>
  25318. <code>type</code></br>
  25319. <em>
  25320. <a href="#external-secrets.io/v1beta1.SecretStoreConditionType">
  25321. SecretStoreConditionType
  25322. </a>
  25323. </em>
  25324. </td>
  25325. <td>
  25326. </td>
  25327. </tr>
  25328. <tr>
  25329. <td>
  25330. <code>status</code></br>
  25331. <em>
  25332. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  25333. Kubernetes core/v1.ConditionStatus
  25334. </a>
  25335. </em>
  25336. </td>
  25337. <td>
  25338. </td>
  25339. </tr>
  25340. <tr>
  25341. <td>
  25342. <code>reason</code></br>
  25343. <em>
  25344. string
  25345. </em>
  25346. </td>
  25347. <td>
  25348. <em>(Optional)</em>
  25349. </td>
  25350. </tr>
  25351. <tr>
  25352. <td>
  25353. <code>message</code></br>
  25354. <em>
  25355. string
  25356. </em>
  25357. </td>
  25358. <td>
  25359. <em>(Optional)</em>
  25360. </td>
  25361. </tr>
  25362. <tr>
  25363. <td>
  25364. <code>lastTransitionTime</code></br>
  25365. <em>
  25366. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  25367. Kubernetes meta/v1.Time
  25368. </a>
  25369. </em>
  25370. </td>
  25371. <td>
  25372. <em>(Optional)</em>
  25373. </td>
  25374. </tr>
  25375. </tbody>
  25376. </table>
  25377. <h3 id="external-secrets.io/v1beta1.SecretsClient">SecretsClient
  25378. </h3>
  25379. <p>
  25380. <p>SecretsClient provides access to secrets.</p>
  25381. </p>
  25382. <h3 id="external-secrets.io/v1beta1.SecretsManager">SecretsManager
  25383. </h3>
  25384. <p>
  25385. (<em>Appears on:</em>
  25386. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  25387. </p>
  25388. <p>
  25389. <p>SecretsManager defines how the provider behaves when interacting with AWS
  25390. SecretsManager. Some of these settings are only applicable to controlling how
  25391. secrets are deleted, and hence only apply to PushSecret (and only when
  25392. deletionPolicy is set to Delete).</p>
  25393. </p>
  25394. <table>
  25395. <thead>
  25396. <tr>
  25397. <th>Field</th>
  25398. <th>Description</th>
  25399. </tr>
  25400. </thead>
  25401. <tbody>
  25402. <tr>
  25403. <td>
  25404. <code>forceDeleteWithoutRecovery</code></br>
  25405. <em>
  25406. bool
  25407. </em>
  25408. </td>
  25409. <td>
  25410. <em>(Optional)</em>
  25411. <p>Specifies whether to delete the secret without any recovery window. You
  25412. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  25413. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  25414. recovery window.
  25415. 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>
  25416. </td>
  25417. </tr>
  25418. <tr>
  25419. <td>
  25420. <code>recoveryWindowInDays</code></br>
  25421. <em>
  25422. int64
  25423. </em>
  25424. </td>
  25425. <td>
  25426. <em>(Optional)</em>
  25427. <p>The number of days from 7 to 30 that Secrets Manager waits before
  25428. permanently deleting the secret. You can&rsquo;t use both this parameter and
  25429. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  25430. then by default Secrets Manager uses a 30 day recovery window.
  25431. 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>
  25432. </td>
  25433. </tr>
  25434. </tbody>
  25435. </table>
  25436. <h3 id="external-secrets.io/v1beta1.SenhaseguraAuth">SenhaseguraAuth
  25437. </h3>
  25438. <p>
  25439. (<em>Appears on:</em>
  25440. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  25441. </p>
  25442. <p>
  25443. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  25444. </p>
  25445. <table>
  25446. <thead>
  25447. <tr>
  25448. <th>Field</th>
  25449. <th>Description</th>
  25450. </tr>
  25451. </thead>
  25452. <tbody>
  25453. <tr>
  25454. <td>
  25455. <code>clientId</code></br>
  25456. <em>
  25457. string
  25458. </em>
  25459. </td>
  25460. <td>
  25461. </td>
  25462. </tr>
  25463. <tr>
  25464. <td>
  25465. <code>clientSecretSecretRef</code></br>
  25466. <em>
  25467. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25468. External Secrets meta/v1.SecretKeySelector
  25469. </a>
  25470. </em>
  25471. </td>
  25472. <td>
  25473. </td>
  25474. </tr>
  25475. </tbody>
  25476. </table>
  25477. <h3 id="external-secrets.io/v1beta1.SenhaseguraModuleType">SenhaseguraModuleType
  25478. (<code>string</code> alias)</p></h3>
  25479. <p>
  25480. (<em>Appears on:</em>
  25481. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  25482. </p>
  25483. <p>
  25484. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  25485. </p>
  25486. <table>
  25487. <thead>
  25488. <tr>
  25489. <th>Value</th>
  25490. <th>Description</th>
  25491. </tr>
  25492. </thead>
  25493. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  25494. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  25495. see: https://senhasegura.com/devops
  25496. </code></pre>
  25497. </td>
  25498. </tr></tbody>
  25499. </table>
  25500. <h3 id="external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider
  25501. </h3>
  25502. <p>
  25503. (<em>Appears on:</em>
  25504. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  25505. </p>
  25506. <p>
  25507. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  25508. </p>
  25509. <table>
  25510. <thead>
  25511. <tr>
  25512. <th>Field</th>
  25513. <th>Description</th>
  25514. </tr>
  25515. </thead>
  25516. <tbody>
  25517. <tr>
  25518. <td>
  25519. <code>url</code></br>
  25520. <em>
  25521. string
  25522. </em>
  25523. </td>
  25524. <td>
  25525. <p>URL of senhasegura</p>
  25526. </td>
  25527. </tr>
  25528. <tr>
  25529. <td>
  25530. <code>module</code></br>
  25531. <em>
  25532. <a href="#external-secrets.io/v1beta1.SenhaseguraModuleType">
  25533. SenhaseguraModuleType
  25534. </a>
  25535. </em>
  25536. </td>
  25537. <td>
  25538. <p>Module defines which senhasegura module should be used to get secrets</p>
  25539. </td>
  25540. </tr>
  25541. <tr>
  25542. <td>
  25543. <code>auth</code></br>
  25544. <em>
  25545. <a href="#external-secrets.io/v1beta1.SenhaseguraAuth">
  25546. SenhaseguraAuth
  25547. </a>
  25548. </em>
  25549. </td>
  25550. <td>
  25551. <p>Auth defines parameters to authenticate in senhasegura</p>
  25552. </td>
  25553. </tr>
  25554. <tr>
  25555. <td>
  25556. <code>ignoreSslCertificate</code></br>
  25557. <em>
  25558. bool
  25559. </em>
  25560. </td>
  25561. <td>
  25562. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  25563. </td>
  25564. </tr>
  25565. </tbody>
  25566. </table>
  25567. <h3 id="external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  25568. </h3>
  25569. <p>
  25570. (<em>Appears on:</em>
  25571. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  25572. </p>
  25573. <p>
  25574. <p>StoreGeneratorSourceRef allows you to override the source
  25575. from which the secret will be pulled from.
  25576. You can define at maximum one property.</p>
  25577. </p>
  25578. <table>
  25579. <thead>
  25580. <tr>
  25581. <th>Field</th>
  25582. <th>Description</th>
  25583. </tr>
  25584. </thead>
  25585. <tbody>
  25586. <tr>
  25587. <td>
  25588. <code>storeRef</code></br>
  25589. <em>
  25590. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  25591. SecretStoreRef
  25592. </a>
  25593. </em>
  25594. </td>
  25595. <td>
  25596. <em>(Optional)</em>
  25597. </td>
  25598. </tr>
  25599. <tr>
  25600. <td>
  25601. <code>generatorRef</code></br>
  25602. <em>
  25603. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  25604. GeneratorRef
  25605. </a>
  25606. </em>
  25607. </td>
  25608. <td>
  25609. <em>(Optional)</em>
  25610. <p>GeneratorRef points to a generator custom resource.</p>
  25611. </td>
  25612. </tr>
  25613. </tbody>
  25614. </table>
  25615. <h3 id="external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef
  25616. </h3>
  25617. <p>
  25618. (<em>Appears on:</em>
  25619. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>)
  25620. </p>
  25621. <p>
  25622. <p>StoreSourceRef allows you to override the SecretStore source
  25623. from which the secret will be pulled from.
  25624. You can define at maximum one property.</p>
  25625. </p>
  25626. <table>
  25627. <thead>
  25628. <tr>
  25629. <th>Field</th>
  25630. <th>Description</th>
  25631. </tr>
  25632. </thead>
  25633. <tbody>
  25634. <tr>
  25635. <td>
  25636. <code>storeRef</code></br>
  25637. <em>
  25638. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  25639. SecretStoreRef
  25640. </a>
  25641. </em>
  25642. </td>
  25643. <td>
  25644. <em>(Optional)</em>
  25645. </td>
  25646. </tr>
  25647. <tr>
  25648. <td>
  25649. <code>generatorRef</code></br>
  25650. <em>
  25651. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  25652. GeneratorRef
  25653. </a>
  25654. </em>
  25655. </td>
  25656. <td>
  25657. <p>GeneratorRef points to a generator custom resource.</p>
  25658. <p>Deprecated: The generatorRef is not implemented in .data[].
  25659. this will be removed with v1.</p>
  25660. </td>
  25661. </tr>
  25662. </tbody>
  25663. </table>
  25664. <h3 id="external-secrets.io/v1beta1.Tag">Tag
  25665. </h3>
  25666. <p>
  25667. <p>Tag defines a tag key and value for AWS resources.</p>
  25668. </p>
  25669. <table>
  25670. <thead>
  25671. <tr>
  25672. <th>Field</th>
  25673. <th>Description</th>
  25674. </tr>
  25675. </thead>
  25676. <tbody>
  25677. <tr>
  25678. <td>
  25679. <code>key</code></br>
  25680. <em>
  25681. string
  25682. </em>
  25683. </td>
  25684. <td>
  25685. </td>
  25686. </tr>
  25687. <tr>
  25688. <td>
  25689. <code>value</code></br>
  25690. <em>
  25691. string
  25692. </em>
  25693. </td>
  25694. <td>
  25695. </td>
  25696. </tr>
  25697. </tbody>
  25698. </table>
  25699. <h3 id="external-secrets.io/v1beta1.TemplateEngineVersion">TemplateEngineVersion
  25700. (<code>string</code> alias)</p></h3>
  25701. <p>
  25702. (<em>Appears on:</em>
  25703. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25704. </p>
  25705. <p>
  25706. <p>TemplateEngineVersion defines the version of the template engine to use.</p>
  25707. </p>
  25708. <table>
  25709. <thead>
  25710. <tr>
  25711. <th>Value</th>
  25712. <th>Description</th>
  25713. </tr>
  25714. </thead>
  25715. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  25716. <td><p>TemplateEngineV2 specifies the v2 template engine version.</p>
  25717. </td>
  25718. </tr></tbody>
  25719. </table>
  25720. <h3 id="external-secrets.io/v1beta1.TemplateFrom">TemplateFrom
  25721. </h3>
  25722. <p>
  25723. (<em>Appears on:</em>
  25724. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25725. </p>
  25726. <p>
  25727. <p>TemplateFrom defines a source for template data.</p>
  25728. </p>
  25729. <table>
  25730. <thead>
  25731. <tr>
  25732. <th>Field</th>
  25733. <th>Description</th>
  25734. </tr>
  25735. </thead>
  25736. <tbody>
  25737. <tr>
  25738. <td>
  25739. <code>configMap</code></br>
  25740. <em>
  25741. <a href="#external-secrets.io/v1beta1.TemplateRef">
  25742. TemplateRef
  25743. </a>
  25744. </em>
  25745. </td>
  25746. <td>
  25747. </td>
  25748. </tr>
  25749. <tr>
  25750. <td>
  25751. <code>secret</code></br>
  25752. <em>
  25753. <a href="#external-secrets.io/v1beta1.TemplateRef">
  25754. TemplateRef
  25755. </a>
  25756. </em>
  25757. </td>
  25758. <td>
  25759. </td>
  25760. </tr>
  25761. <tr>
  25762. <td>
  25763. <code>target</code></br>
  25764. <em>
  25765. <a href="#external-secrets.io/v1beta1.TemplateTarget">
  25766. TemplateTarget
  25767. </a>
  25768. </em>
  25769. </td>
  25770. <td>
  25771. <em>(Optional)</em>
  25772. </td>
  25773. </tr>
  25774. <tr>
  25775. <td>
  25776. <code>literal</code></br>
  25777. <em>
  25778. string
  25779. </em>
  25780. </td>
  25781. <td>
  25782. <em>(Optional)</em>
  25783. </td>
  25784. </tr>
  25785. </tbody>
  25786. </table>
  25787. <h3 id="external-secrets.io/v1beta1.TemplateMergePolicy">TemplateMergePolicy
  25788. (<code>string</code> alias)</p></h3>
  25789. <p>
  25790. (<em>Appears on:</em>
  25791. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25792. </p>
  25793. <p>
  25794. <p>TemplateMergePolicy defines how template values should be merged when generating a secret.</p>
  25795. </p>
  25796. <table>
  25797. <thead>
  25798. <tr>
  25799. <th>Value</th>
  25800. <th>Description</th>
  25801. </tr>
  25802. </thead>
  25803. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  25804. <td><p>MergePolicyMerge merges the template content with existing values.</p>
  25805. </td>
  25806. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  25807. <td><p>MergePolicyReplace replaces the entire template content during merge operations.</p>
  25808. </td>
  25809. </tr></tbody>
  25810. </table>
  25811. <h3 id="external-secrets.io/v1beta1.TemplateRef">TemplateRef
  25812. </h3>
  25813. <p>
  25814. (<em>Appears on:</em>
  25815. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  25816. </p>
  25817. <p>
  25818. <p>TemplateRef defines a reference to a template source in a ConfigMap or Secret.</p>
  25819. </p>
  25820. <table>
  25821. <thead>
  25822. <tr>
  25823. <th>Field</th>
  25824. <th>Description</th>
  25825. </tr>
  25826. </thead>
  25827. <tbody>
  25828. <tr>
  25829. <td>
  25830. <code>name</code></br>
  25831. <em>
  25832. string
  25833. </em>
  25834. </td>
  25835. <td>
  25836. <p>The name of the ConfigMap/Secret resource</p>
  25837. </td>
  25838. </tr>
  25839. <tr>
  25840. <td>
  25841. <code>items</code></br>
  25842. <em>
  25843. <a href="#external-secrets.io/v1beta1.TemplateRefItem">
  25844. []TemplateRefItem
  25845. </a>
  25846. </em>
  25847. </td>
  25848. <td>
  25849. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  25850. </td>
  25851. </tr>
  25852. </tbody>
  25853. </table>
  25854. <h3 id="external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem
  25855. </h3>
  25856. <p>
  25857. (<em>Appears on:</em>
  25858. <a href="#external-secrets.io/v1beta1.TemplateRef">TemplateRef</a>)
  25859. </p>
  25860. <p>
  25861. <p>TemplateRefItem defines which key in the referenced ConfigMap or Secret to use as a template.</p>
  25862. </p>
  25863. <table>
  25864. <thead>
  25865. <tr>
  25866. <th>Field</th>
  25867. <th>Description</th>
  25868. </tr>
  25869. </thead>
  25870. <tbody>
  25871. <tr>
  25872. <td>
  25873. <code>key</code></br>
  25874. <em>
  25875. string
  25876. </em>
  25877. </td>
  25878. <td>
  25879. <p>A key in the ConfigMap/Secret</p>
  25880. </td>
  25881. </tr>
  25882. <tr>
  25883. <td>
  25884. <code>templateAs</code></br>
  25885. <em>
  25886. <a href="#external-secrets.io/v1beta1.TemplateScope">
  25887. TemplateScope
  25888. </a>
  25889. </em>
  25890. </td>
  25891. <td>
  25892. </td>
  25893. </tr>
  25894. </tbody>
  25895. </table>
  25896. <h3 id="external-secrets.io/v1beta1.TemplateScope">TemplateScope
  25897. (<code>string</code> alias)</p></h3>
  25898. <p>
  25899. (<em>Appears on:</em>
  25900. <a href="#external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem</a>)
  25901. </p>
  25902. <p>
  25903. <p>TemplateScope defines the scope of the template when processing template data.</p>
  25904. </p>
  25905. <table>
  25906. <thead>
  25907. <tr>
  25908. <th>Value</th>
  25909. <th>Description</th>
  25910. </tr>
  25911. </thead>
  25912. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  25913. <td><p>TemplateScopeKeysAndValues processes both keys and values of the data.</p>
  25914. </td>
  25915. </tr><tr><td><p>&#34;Values&#34;</p></td>
  25916. <td><p>TemplateScopeValues processes only the values of the data.</p>
  25917. </td>
  25918. </tr></tbody>
  25919. </table>
  25920. <h3 id="external-secrets.io/v1beta1.TemplateTarget">TemplateTarget
  25921. (<code>string</code> alias)</p></h3>
  25922. <p>
  25923. (<em>Appears on:</em>
  25924. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  25925. </p>
  25926. <p>
  25927. <p>TemplateTarget defines the target field where the template result will be stored.</p>
  25928. </p>
  25929. <table>
  25930. <thead>
  25931. <tr>
  25932. <th>Value</th>
  25933. <th>Description</th>
  25934. </tr>
  25935. </thead>
  25936. <tbody><tr><td><p>&#34;Annotations&#34;</p></td>
  25937. <td><p>TemplateTargetAnnotations stores template results in the annotations field of the secret.</p>
  25938. </td>
  25939. </tr><tr><td><p>&#34;Data&#34;</p></td>
  25940. <td><p>TemplateTargetData stores template results in the data field of the secret.</p>
  25941. </td>
  25942. </tr><tr><td><p>&#34;Labels&#34;</p></td>
  25943. <td><p>TemplateTargetLabels stores template results in the labels field of the secret.</p>
  25944. </td>
  25945. </tr></tbody>
  25946. </table>
  25947. <h3 id="external-secrets.io/v1beta1.TokenAuth">TokenAuth
  25948. </h3>
  25949. <p>
  25950. (<em>Appears on:</em>
  25951. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  25952. </p>
  25953. <p>
  25954. <p>TokenAuth defines token-based authentication for the Kubernetes provider.</p>
  25955. </p>
  25956. <table>
  25957. <thead>
  25958. <tr>
  25959. <th>Field</th>
  25960. <th>Description</th>
  25961. </tr>
  25962. </thead>
  25963. <tbody>
  25964. <tr>
  25965. <td>
  25966. <code>bearerToken</code></br>
  25967. <em>
  25968. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25969. External Secrets meta/v1.SecretKeySelector
  25970. </a>
  25971. </em>
  25972. </td>
  25973. <td>
  25974. </td>
  25975. </tr>
  25976. </tbody>
  25977. </table>
  25978. <h3 id="external-secrets.io/v1beta1.UniversalAuthCredentials">UniversalAuthCredentials
  25979. </h3>
  25980. <p>
  25981. (<em>Appears on:</em>
  25982. <a href="#external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth</a>)
  25983. </p>
  25984. <p>
  25985. <p>UniversalAuthCredentials defines the credentials for Infisical Universal Auth.</p>
  25986. </p>
  25987. <table>
  25988. <thead>
  25989. <tr>
  25990. <th>Field</th>
  25991. <th>Description</th>
  25992. </tr>
  25993. </thead>
  25994. <tbody>
  25995. <tr>
  25996. <td>
  25997. <code>clientId</code></br>
  25998. <em>
  25999. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26000. External Secrets meta/v1.SecretKeySelector
  26001. </a>
  26002. </em>
  26003. </td>
  26004. <td>
  26005. </td>
  26006. </tr>
  26007. <tr>
  26008. <td>
  26009. <code>clientSecret</code></br>
  26010. <em>
  26011. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26012. External Secrets meta/v1.SecretKeySelector
  26013. </a>
  26014. </em>
  26015. </td>
  26016. <td>
  26017. </td>
  26018. </tr>
  26019. </tbody>
  26020. </table>
  26021. <h3 id="external-secrets.io/v1beta1.ValidationResult">ValidationResult
  26022. (<code>byte</code> alias)</p></h3>
  26023. <p>
  26024. <p>ValidationResult represents the result of validating a provider client configuration.</p>
  26025. </p>
  26026. <table>
  26027. <thead>
  26028. <tr>
  26029. <th>Value</th>
  26030. <th>Description</th>
  26031. </tr>
  26032. </thead>
  26033. <tbody><tr><td><p>2</p></td>
  26034. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  26035. </td>
  26036. </tr><tr><td><p>0</p></td>
  26037. <td><p>ValidationResultReady indicates that the client is configured correctly and can be used.</p>
  26038. </td>
  26039. </tr><tr><td><p>1</p></td>
  26040. <td><p>ValidationResultUnknown indicates that the client can be used but information is missing and it can not be validated.</p>
  26041. </td>
  26042. </tr></tbody>
  26043. </table>
  26044. <h3 id="external-secrets.io/v1beta1.VaultAppRole">VaultAppRole
  26045. </h3>
  26046. <p>
  26047. (<em>Appears on:</em>
  26048. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26049. </p>
  26050. <p>
  26051. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  26052. with the role and secret stored in a Kubernetes Secret resource.</p>
  26053. </p>
  26054. <table>
  26055. <thead>
  26056. <tr>
  26057. <th>Field</th>
  26058. <th>Description</th>
  26059. </tr>
  26060. </thead>
  26061. <tbody>
  26062. <tr>
  26063. <td>
  26064. <code>path</code></br>
  26065. <em>
  26066. string
  26067. </em>
  26068. </td>
  26069. <td>
  26070. <p>Path where the App Role authentication backend is mounted
  26071. in Vault, e.g: &ldquo;approle&rdquo;</p>
  26072. </td>
  26073. </tr>
  26074. <tr>
  26075. <td>
  26076. <code>roleId</code></br>
  26077. <em>
  26078. string
  26079. </em>
  26080. </td>
  26081. <td>
  26082. <em>(Optional)</em>
  26083. <p>RoleID configured in the App Role authentication backend when setting
  26084. up the authentication backend in Vault.</p>
  26085. </td>
  26086. </tr>
  26087. <tr>
  26088. <td>
  26089. <code>roleRef</code></br>
  26090. <em>
  26091. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26092. External Secrets meta/v1.SecretKeySelector
  26093. </a>
  26094. </em>
  26095. </td>
  26096. <td>
  26097. <em>(Optional)</em>
  26098. <p>Reference to a key in a Secret that contains the App Role ID used
  26099. to authenticate with Vault.
  26100. The <code>key</code> field must be specified and denotes which entry within the Secret
  26101. resource is used as the app role id.</p>
  26102. </td>
  26103. </tr>
  26104. <tr>
  26105. <td>
  26106. <code>secretRef</code></br>
  26107. <em>
  26108. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26109. External Secrets meta/v1.SecretKeySelector
  26110. </a>
  26111. </em>
  26112. </td>
  26113. <td>
  26114. <p>Reference to a key in a Secret that contains the App Role secret used
  26115. to authenticate with Vault.
  26116. The <code>key</code> field must be specified and denotes which entry within the Secret
  26117. resource is used as the app role secret.</p>
  26118. </td>
  26119. </tr>
  26120. </tbody>
  26121. </table>
  26122. <h3 id="external-secrets.io/v1beta1.VaultAuth">VaultAuth
  26123. </h3>
  26124. <p>
  26125. (<em>Appears on:</em>
  26126. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  26127. </p>
  26128. <p>
  26129. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  26130. 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>
  26131. can be specified. A namespace to authenticate against can optionally be specified.</p>
  26132. </p>
  26133. <table>
  26134. <thead>
  26135. <tr>
  26136. <th>Field</th>
  26137. <th>Description</th>
  26138. </tr>
  26139. </thead>
  26140. <tbody>
  26141. <tr>
  26142. <td>
  26143. <code>namespace</code></br>
  26144. <em>
  26145. string
  26146. </em>
  26147. </td>
  26148. <td>
  26149. <em>(Optional)</em>
  26150. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  26151. Namespaces is a set of features within Vault Enterprise that allows
  26152. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  26153. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  26154. This will default to Vault.Namespace field if set, or empty otherwise</p>
  26155. </td>
  26156. </tr>
  26157. <tr>
  26158. <td>
  26159. <code>tokenSecretRef</code></br>
  26160. <em>
  26161. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26162. External Secrets meta/v1.SecretKeySelector
  26163. </a>
  26164. </em>
  26165. </td>
  26166. <td>
  26167. <em>(Optional)</em>
  26168. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  26169. </td>
  26170. </tr>
  26171. <tr>
  26172. <td>
  26173. <code>appRole</code></br>
  26174. <em>
  26175. <a href="#external-secrets.io/v1beta1.VaultAppRole">
  26176. VaultAppRole
  26177. </a>
  26178. </em>
  26179. </td>
  26180. <td>
  26181. <em>(Optional)</em>
  26182. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  26183. with the role and secret stored in a Kubernetes Secret resource.</p>
  26184. </td>
  26185. </tr>
  26186. <tr>
  26187. <td>
  26188. <code>kubernetes</code></br>
  26189. <em>
  26190. <a href="#external-secrets.io/v1beta1.VaultKubernetesAuth">
  26191. VaultKubernetesAuth
  26192. </a>
  26193. </em>
  26194. </td>
  26195. <td>
  26196. <em>(Optional)</em>
  26197. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  26198. token stored in the named Secret resource to the Vault server.</p>
  26199. </td>
  26200. </tr>
  26201. <tr>
  26202. <td>
  26203. <code>ldap</code></br>
  26204. <em>
  26205. <a href="#external-secrets.io/v1beta1.VaultLdapAuth">
  26206. VaultLdapAuth
  26207. </a>
  26208. </em>
  26209. </td>
  26210. <td>
  26211. <em>(Optional)</em>
  26212. <p>Ldap authenticates with Vault by passing username/password pair using
  26213. the LDAP authentication method</p>
  26214. </td>
  26215. </tr>
  26216. <tr>
  26217. <td>
  26218. <code>jwt</code></br>
  26219. <em>
  26220. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">
  26221. VaultJwtAuth
  26222. </a>
  26223. </em>
  26224. </td>
  26225. <td>
  26226. <em>(Optional)</em>
  26227. <p>Jwt authenticates with Vault by passing role and JWT token using the
  26228. JWT/OIDC authentication method</p>
  26229. </td>
  26230. </tr>
  26231. <tr>
  26232. <td>
  26233. <code>cert</code></br>
  26234. <em>
  26235. <a href="#external-secrets.io/v1beta1.VaultCertAuth">
  26236. VaultCertAuth
  26237. </a>
  26238. </em>
  26239. </td>
  26240. <td>
  26241. <em>(Optional)</em>
  26242. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  26243. Cert authentication method</p>
  26244. </td>
  26245. </tr>
  26246. <tr>
  26247. <td>
  26248. <code>iam</code></br>
  26249. <em>
  26250. <a href="#external-secrets.io/v1beta1.VaultIamAuth">
  26251. VaultIamAuth
  26252. </a>
  26253. </em>
  26254. </td>
  26255. <td>
  26256. <em>(Optional)</em>
  26257. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  26258. AWS IAM authentication method</p>
  26259. </td>
  26260. </tr>
  26261. <tr>
  26262. <td>
  26263. <code>userPass</code></br>
  26264. <em>
  26265. <a href="#external-secrets.io/v1beta1.VaultUserPassAuth">
  26266. VaultUserPassAuth
  26267. </a>
  26268. </em>
  26269. </td>
  26270. <td>
  26271. <em>(Optional)</em>
  26272. <p>UserPass authenticates with Vault by passing username/password pair</p>
  26273. </td>
  26274. </tr>
  26275. </tbody>
  26276. </table>
  26277. <h3 id="external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth
  26278. </h3>
  26279. <p>
  26280. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  26281. Only one of secretRef or jwt can be specified.
  26282. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  26283. </p>
  26284. <table>
  26285. <thead>
  26286. <tr>
  26287. <th>Field</th>
  26288. <th>Description</th>
  26289. </tr>
  26290. </thead>
  26291. <tbody>
  26292. <tr>
  26293. <td>
  26294. <code>secretRef</code></br>
  26295. <em>
  26296. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  26297. VaultAwsAuthSecretRef
  26298. </a>
  26299. </em>
  26300. </td>
  26301. <td>
  26302. <em>(Optional)</em>
  26303. </td>
  26304. </tr>
  26305. <tr>
  26306. <td>
  26307. <code>jwt</code></br>
  26308. <em>
  26309. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  26310. VaultAwsJWTAuth
  26311. </a>
  26312. </em>
  26313. </td>
  26314. <td>
  26315. <em>(Optional)</em>
  26316. </td>
  26317. </tr>
  26318. </tbody>
  26319. </table>
  26320. <h3 id="external-secrets.io/v1beta1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  26321. </h3>
  26322. <p>
  26323. (<em>Appears on:</em>
  26324. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  26325. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  26326. </p>
  26327. <p>
  26328. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  26329. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  26330. </p>
  26331. <table>
  26332. <thead>
  26333. <tr>
  26334. <th>Field</th>
  26335. <th>Description</th>
  26336. </tr>
  26337. </thead>
  26338. <tbody>
  26339. <tr>
  26340. <td>
  26341. <code>accessKeyIDSecretRef</code></br>
  26342. <em>
  26343. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26344. External Secrets meta/v1.SecretKeySelector
  26345. </a>
  26346. </em>
  26347. </td>
  26348. <td>
  26349. <em>(Optional)</em>
  26350. <p>The AccessKeyID is used for authentication</p>
  26351. </td>
  26352. </tr>
  26353. <tr>
  26354. <td>
  26355. <code>secretAccessKeySecretRef</code></br>
  26356. <em>
  26357. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26358. External Secrets meta/v1.SecretKeySelector
  26359. </a>
  26360. </em>
  26361. </td>
  26362. <td>
  26363. <em>(Optional)</em>
  26364. <p>The SecretAccessKey is used for authentication</p>
  26365. </td>
  26366. </tr>
  26367. <tr>
  26368. <td>
  26369. <code>sessionTokenSecretRef</code></br>
  26370. <em>
  26371. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26372. External Secrets meta/v1.SecretKeySelector
  26373. </a>
  26374. </em>
  26375. </td>
  26376. <td>
  26377. <em>(Optional)</em>
  26378. <p>The SessionToken used for authentication
  26379. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  26380. 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>
  26381. </td>
  26382. </tr>
  26383. </tbody>
  26384. </table>
  26385. <h3 id="external-secrets.io/v1beta1.VaultAwsJWTAuth">VaultAwsJWTAuth
  26386. </h3>
  26387. <p>
  26388. (<em>Appears on:</em>
  26389. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  26390. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  26391. </p>
  26392. <p>
  26393. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  26394. </p>
  26395. <table>
  26396. <thead>
  26397. <tr>
  26398. <th>Field</th>
  26399. <th>Description</th>
  26400. </tr>
  26401. </thead>
  26402. <tbody>
  26403. <tr>
  26404. <td>
  26405. <code>serviceAccountRef</code></br>
  26406. <em>
  26407. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26408. External Secrets meta/v1.ServiceAccountSelector
  26409. </a>
  26410. </em>
  26411. </td>
  26412. <td>
  26413. <em>(Optional)</em>
  26414. </td>
  26415. </tr>
  26416. </tbody>
  26417. </table>
  26418. <h3 id="external-secrets.io/v1beta1.VaultCertAuth">VaultCertAuth
  26419. </h3>
  26420. <p>
  26421. (<em>Appears on:</em>
  26422. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26423. </p>
  26424. <p>
  26425. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  26426. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  26427. </p>
  26428. <table>
  26429. <thead>
  26430. <tr>
  26431. <th>Field</th>
  26432. <th>Description</th>
  26433. </tr>
  26434. </thead>
  26435. <tbody>
  26436. <tr>
  26437. <td>
  26438. <code>clientCert</code></br>
  26439. <em>
  26440. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26441. External Secrets meta/v1.SecretKeySelector
  26442. </a>
  26443. </em>
  26444. </td>
  26445. <td>
  26446. <em>(Optional)</em>
  26447. <p>ClientCert is a certificate to authenticate using the Cert Vault
  26448. authentication method</p>
  26449. </td>
  26450. </tr>
  26451. <tr>
  26452. <td>
  26453. <code>secretRef</code></br>
  26454. <em>
  26455. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26456. External Secrets meta/v1.SecretKeySelector
  26457. </a>
  26458. </em>
  26459. </td>
  26460. <td>
  26461. <em>(Optional)</em>
  26462. <p>SecretRef to a key in a Secret resource containing client private key to
  26463. authenticate with Vault using the Cert authentication method</p>
  26464. </td>
  26465. </tr>
  26466. </tbody>
  26467. </table>
  26468. <h3 id="external-secrets.io/v1beta1.VaultClientTLS">VaultClientTLS
  26469. </h3>
  26470. <p>
  26471. (<em>Appears on:</em>
  26472. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  26473. </p>
  26474. <p>
  26475. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  26476. when the Vault server requires mutual authentication.</p>
  26477. </p>
  26478. <table>
  26479. <thead>
  26480. <tr>
  26481. <th>Field</th>
  26482. <th>Description</th>
  26483. </tr>
  26484. </thead>
  26485. <tbody>
  26486. <tr>
  26487. <td>
  26488. <code>certSecretRef</code></br>
  26489. <em>
  26490. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26491. External Secrets meta/v1.SecretKeySelector
  26492. </a>
  26493. </em>
  26494. </td>
  26495. <td>
  26496. <em>(Optional)</em>
  26497. <p>CertSecretRef is a certificate added to the transport layer
  26498. when communicating with the Vault server.
  26499. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  26500. </td>
  26501. </tr>
  26502. <tr>
  26503. <td>
  26504. <code>keySecretRef</code></br>
  26505. <em>
  26506. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26507. External Secrets meta/v1.SecretKeySelector
  26508. </a>
  26509. </em>
  26510. </td>
  26511. <td>
  26512. <em>(Optional)</em>
  26513. <p>KeySecretRef to a key in a Secret resource containing client private key
  26514. added to the transport layer when communicating with the Vault server.
  26515. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  26516. </td>
  26517. </tr>
  26518. </tbody>
  26519. </table>
  26520. <h3 id="external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth
  26521. </h3>
  26522. <p>
  26523. (<em>Appears on:</em>
  26524. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26525. </p>
  26526. <p>
  26527. <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>
  26528. </p>
  26529. <table>
  26530. <thead>
  26531. <tr>
  26532. <th>Field</th>
  26533. <th>Description</th>
  26534. </tr>
  26535. </thead>
  26536. <tbody>
  26537. <tr>
  26538. <td>
  26539. <code>path</code></br>
  26540. <em>
  26541. string
  26542. </em>
  26543. </td>
  26544. <td>
  26545. <em>(Optional)</em>
  26546. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  26547. </td>
  26548. </tr>
  26549. <tr>
  26550. <td>
  26551. <code>region</code></br>
  26552. <em>
  26553. string
  26554. </em>
  26555. </td>
  26556. <td>
  26557. <em>(Optional)</em>
  26558. <p>AWS region</p>
  26559. </td>
  26560. </tr>
  26561. <tr>
  26562. <td>
  26563. <code>role</code></br>
  26564. <em>
  26565. string
  26566. </em>
  26567. </td>
  26568. <td>
  26569. <em>(Optional)</em>
  26570. <p>This is the AWS role to be assumed before talking to vault</p>
  26571. </td>
  26572. </tr>
  26573. <tr>
  26574. <td>
  26575. <code>vaultRole</code></br>
  26576. <em>
  26577. string
  26578. </em>
  26579. </td>
  26580. <td>
  26581. <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>
  26582. </td>
  26583. </tr>
  26584. <tr>
  26585. <td>
  26586. <code>externalID</code></br>
  26587. <em>
  26588. string
  26589. </em>
  26590. </td>
  26591. <td>
  26592. <p>AWS External ID set on assumed IAM roles</p>
  26593. </td>
  26594. </tr>
  26595. <tr>
  26596. <td>
  26597. <code>vaultAwsIamServerID</code></br>
  26598. <em>
  26599. string
  26600. </em>
  26601. </td>
  26602. <td>
  26603. <em>(Optional)</em>
  26604. <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>
  26605. </td>
  26606. </tr>
  26607. <tr>
  26608. <td>
  26609. <code>secretRef</code></br>
  26610. <em>
  26611. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  26612. VaultAwsAuthSecretRef
  26613. </a>
  26614. </em>
  26615. </td>
  26616. <td>
  26617. <em>(Optional)</em>
  26618. <p>Specify credentials in a Secret object</p>
  26619. </td>
  26620. </tr>
  26621. <tr>
  26622. <td>
  26623. <code>jwt</code></br>
  26624. <em>
  26625. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  26626. VaultAwsJWTAuth
  26627. </a>
  26628. </em>
  26629. </td>
  26630. <td>
  26631. <em>(Optional)</em>
  26632. <p>Specify a service account with IRSA enabled</p>
  26633. </td>
  26634. </tr>
  26635. </tbody>
  26636. </table>
  26637. <h3 id="external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth
  26638. </h3>
  26639. <p>
  26640. (<em>Appears on:</em>
  26641. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26642. </p>
  26643. <p>
  26644. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  26645. method, with the role name and a token stored in a Kubernetes Secret resource or
  26646. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  26647. </p>
  26648. <table>
  26649. <thead>
  26650. <tr>
  26651. <th>Field</th>
  26652. <th>Description</th>
  26653. </tr>
  26654. </thead>
  26655. <tbody>
  26656. <tr>
  26657. <td>
  26658. <code>path</code></br>
  26659. <em>
  26660. string
  26661. </em>
  26662. </td>
  26663. <td>
  26664. <p>Path where the JWT authentication backend is mounted
  26665. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  26666. </td>
  26667. </tr>
  26668. <tr>
  26669. <td>
  26670. <code>role</code></br>
  26671. <em>
  26672. string
  26673. </em>
  26674. </td>
  26675. <td>
  26676. <em>(Optional)</em>
  26677. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  26678. authentication method</p>
  26679. </td>
  26680. </tr>
  26681. <tr>
  26682. <td>
  26683. <code>secretRef</code></br>
  26684. <em>
  26685. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26686. External Secrets meta/v1.SecretKeySelector
  26687. </a>
  26688. </em>
  26689. </td>
  26690. <td>
  26691. <em>(Optional)</em>
  26692. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  26693. authenticate with Vault using the JWT/OIDC authentication method.</p>
  26694. </td>
  26695. </tr>
  26696. <tr>
  26697. <td>
  26698. <code>kubernetesServiceAccountToken</code></br>
  26699. <em>
  26700. <a href="#external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">
  26701. VaultKubernetesServiceAccountTokenAuth
  26702. </a>
  26703. </em>
  26704. </td>
  26705. <td>
  26706. <em>(Optional)</em>
  26707. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  26708. a token for with the <code>TokenRequest</code> API.</p>
  26709. </td>
  26710. </tr>
  26711. </tbody>
  26712. </table>
  26713. <h3 id="external-secrets.io/v1beta1.VaultKVStoreVersion">VaultKVStoreVersion
  26714. (<code>string</code> alias)</p></h3>
  26715. <p>
  26716. (<em>Appears on:</em>
  26717. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  26718. </p>
  26719. <p>
  26720. <p>VaultKVStoreVersion defines the version of the KV store in Vault.</p>
  26721. </p>
  26722. <table>
  26723. <thead>
  26724. <tr>
  26725. <th>Value</th>
  26726. <th>Description</th>
  26727. </tr>
  26728. </thead>
  26729. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  26730. <td><p>VaultKVStoreV1 represents version 1 of the Vault KV store.</p>
  26731. </td>
  26732. </tr><tr><td><p>&#34;v2&#34;</p></td>
  26733. <td><p>VaultKVStoreV2 represents version 2 of the Vault KV store.</p>
  26734. </td>
  26735. </tr></tbody>
  26736. </table>
  26737. <h3 id="external-secrets.io/v1beta1.VaultKubernetesAuth">VaultKubernetesAuth
  26738. </h3>
  26739. <p>
  26740. (<em>Appears on:</em>
  26741. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26742. </p>
  26743. <p>
  26744. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in a Secret.</p>
  26745. </p>
  26746. <table>
  26747. <thead>
  26748. <tr>
  26749. <th>Field</th>
  26750. <th>Description</th>
  26751. </tr>
  26752. </thead>
  26753. <tbody>
  26754. <tr>
  26755. <td>
  26756. <code>mountPath</code></br>
  26757. <em>
  26758. string
  26759. </em>
  26760. </td>
  26761. <td>
  26762. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  26763. &ldquo;kubernetes&rdquo;</p>
  26764. </td>
  26765. </tr>
  26766. <tr>
  26767. <td>
  26768. <code>serviceAccountRef</code></br>
  26769. <em>
  26770. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26771. External Secrets meta/v1.ServiceAccountSelector
  26772. </a>
  26773. </em>
  26774. </td>
  26775. <td>
  26776. <em>(Optional)</em>
  26777. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  26778. If the service account is specified, the service account secret token JWT will be used
  26779. for authenticating with Vault. If the service account selector is not supplied,
  26780. the secretRef will be used instead.</p>
  26781. </td>
  26782. </tr>
  26783. <tr>
  26784. <td>
  26785. <code>secretRef</code></br>
  26786. <em>
  26787. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26788. External Secrets meta/v1.SecretKeySelector
  26789. </a>
  26790. </em>
  26791. </td>
  26792. <td>
  26793. <em>(Optional)</em>
  26794. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  26795. for authenticating with Vault. If a name is specified without a key,
  26796. <code>token</code> is the default. If one is not specified, the one bound to
  26797. the controller will be used.</p>
  26798. </td>
  26799. </tr>
  26800. <tr>
  26801. <td>
  26802. <code>role</code></br>
  26803. <em>
  26804. string
  26805. </em>
  26806. </td>
  26807. <td>
  26808. <p>A required field containing the Vault Role to assume. A Role binds a
  26809. Kubernetes ServiceAccount with a set of Vault policies.</p>
  26810. </td>
  26811. </tr>
  26812. </tbody>
  26813. </table>
  26814. <h3 id="external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  26815. </h3>
  26816. <p>
  26817. (<em>Appears on:</em>
  26818. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth</a>)
  26819. </p>
  26820. <p>
  26821. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  26822. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  26823. </p>
  26824. <table>
  26825. <thead>
  26826. <tr>
  26827. <th>Field</th>
  26828. <th>Description</th>
  26829. </tr>
  26830. </thead>
  26831. <tbody>
  26832. <tr>
  26833. <td>
  26834. <code>serviceAccountRef</code></br>
  26835. <em>
  26836. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26837. External Secrets meta/v1.ServiceAccountSelector
  26838. </a>
  26839. </em>
  26840. </td>
  26841. <td>
  26842. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  26843. </td>
  26844. </tr>
  26845. <tr>
  26846. <td>
  26847. <code>audiences</code></br>
  26848. <em>
  26849. []string
  26850. </em>
  26851. </td>
  26852. <td>
  26853. <em>(Optional)</em>
  26854. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  26855. account token for the service account referenced by <code>serviceAccountRef</code>.
  26856. Defaults to a single audience <code>vault</code> it not specified.</p>
  26857. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  26858. </td>
  26859. </tr>
  26860. <tr>
  26861. <td>
  26862. <code>expirationSeconds</code></br>
  26863. <em>
  26864. int64
  26865. </em>
  26866. </td>
  26867. <td>
  26868. <em>(Optional)</em>
  26869. <p>Optional expiration time in seconds that will be used to request a temporary
  26870. Kubernetes service account token for the service account referenced by
  26871. <code>serviceAccountRef</code>.</p>
  26872. <p>Deprecated: this will be removed in the future.
  26873. Defaults to 10 minutes.</p>
  26874. </td>
  26875. </tr>
  26876. </tbody>
  26877. </table>
  26878. <h3 id="external-secrets.io/v1beta1.VaultLdapAuth">VaultLdapAuth
  26879. </h3>
  26880. <p>
  26881. (<em>Appears on:</em>
  26882. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26883. </p>
  26884. <p>
  26885. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  26886. with the username and password stored in a Kubernetes Secret resource.</p>
  26887. </p>
  26888. <table>
  26889. <thead>
  26890. <tr>
  26891. <th>Field</th>
  26892. <th>Description</th>
  26893. </tr>
  26894. </thead>
  26895. <tbody>
  26896. <tr>
  26897. <td>
  26898. <code>path</code></br>
  26899. <em>
  26900. string
  26901. </em>
  26902. </td>
  26903. <td>
  26904. <p>Path where the LDAP authentication backend is mounted
  26905. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  26906. </td>
  26907. </tr>
  26908. <tr>
  26909. <td>
  26910. <code>username</code></br>
  26911. <em>
  26912. string
  26913. </em>
  26914. </td>
  26915. <td>
  26916. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  26917. authentication method</p>
  26918. </td>
  26919. </tr>
  26920. <tr>
  26921. <td>
  26922. <code>secretRef</code></br>
  26923. <em>
  26924. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26925. External Secrets meta/v1.SecretKeySelector
  26926. </a>
  26927. </em>
  26928. </td>
  26929. <td>
  26930. <em>(Optional)</em>
  26931. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  26932. user used to authenticate with Vault using the LDAP authentication
  26933. method</p>
  26934. </td>
  26935. </tr>
  26936. </tbody>
  26937. </table>
  26938. <h3 id="external-secrets.io/v1beta1.VaultProvider">VaultProvider
  26939. </h3>
  26940. <p>
  26941. (<em>Appears on:</em>
  26942. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26943. </p>
  26944. <p>
  26945. <p>VaultProvider configures a store to sync secrets using a HashiCorp Vault KV backend.</p>
  26946. </p>
  26947. <table>
  26948. <thead>
  26949. <tr>
  26950. <th>Field</th>
  26951. <th>Description</th>
  26952. </tr>
  26953. </thead>
  26954. <tbody>
  26955. <tr>
  26956. <td>
  26957. <code>auth</code></br>
  26958. <em>
  26959. <a href="#external-secrets.io/v1beta1.VaultAuth">
  26960. VaultAuth
  26961. </a>
  26962. </em>
  26963. </td>
  26964. <td>
  26965. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  26966. </td>
  26967. </tr>
  26968. <tr>
  26969. <td>
  26970. <code>server</code></br>
  26971. <em>
  26972. string
  26973. </em>
  26974. </td>
  26975. <td>
  26976. <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>
  26977. </td>
  26978. </tr>
  26979. <tr>
  26980. <td>
  26981. <code>path</code></br>
  26982. <em>
  26983. string
  26984. </em>
  26985. </td>
  26986. <td>
  26987. <em>(Optional)</em>
  26988. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  26989. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  26990. for fetching secrets from Vault is optional and will be appended
  26991. if not present in specified path.</p>
  26992. </td>
  26993. </tr>
  26994. <tr>
  26995. <td>
  26996. <code>version</code></br>
  26997. <em>
  26998. <a href="#external-secrets.io/v1beta1.VaultKVStoreVersion">
  26999. VaultKVStoreVersion
  27000. </a>
  27001. </em>
  27002. </td>
  27003. <td>
  27004. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  27005. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  27006. </td>
  27007. </tr>
  27008. <tr>
  27009. <td>
  27010. <code>namespace</code></br>
  27011. <em>
  27012. string
  27013. </em>
  27014. </td>
  27015. <td>
  27016. <em>(Optional)</em>
  27017. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  27018. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  27019. 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>
  27020. </td>
  27021. </tr>
  27022. <tr>
  27023. <td>
  27024. <code>caBundle</code></br>
  27025. <em>
  27026. []byte
  27027. </em>
  27028. </td>
  27029. <td>
  27030. <em>(Optional)</em>
  27031. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  27032. if the Server URL is using HTTPS protocol. This parameter is ignored for
  27033. plain HTTP protocol connection. If not set the system root certificates
  27034. are used to validate the TLS connection.</p>
  27035. </td>
  27036. </tr>
  27037. <tr>
  27038. <td>
  27039. <code>tls</code></br>
  27040. <em>
  27041. <a href="#external-secrets.io/v1beta1.VaultClientTLS">
  27042. VaultClientTLS
  27043. </a>
  27044. </em>
  27045. </td>
  27046. <td>
  27047. <em>(Optional)</em>
  27048. <p>The configuration used for client side related TLS communication, when the Vault server
  27049. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  27050. This parameter is ignored for plain HTTP protocol connection.
  27051. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  27052. which is available under the <code>auth.cert</code> section.</p>
  27053. </td>
  27054. </tr>
  27055. <tr>
  27056. <td>
  27057. <code>caProvider</code></br>
  27058. <em>
  27059. <a href="#external-secrets.io/v1beta1.CAProvider">
  27060. CAProvider
  27061. </a>
  27062. </em>
  27063. </td>
  27064. <td>
  27065. <em>(Optional)</em>
  27066. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  27067. </td>
  27068. </tr>
  27069. <tr>
  27070. <td>
  27071. <code>readYourWrites</code></br>
  27072. <em>
  27073. bool
  27074. </em>
  27075. </td>
  27076. <td>
  27077. <em>(Optional)</em>
  27078. <p>ReadYourWrites ensures isolated read-after-write semantics by
  27079. providing discovered cluster replication states in each request.
  27080. More information about eventual consistency in Vault can be found here
  27081. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  27082. </td>
  27083. </tr>
  27084. <tr>
  27085. <td>
  27086. <code>forwardInconsistent</code></br>
  27087. <em>
  27088. bool
  27089. </em>
  27090. </td>
  27091. <td>
  27092. <em>(Optional)</em>
  27093. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  27094. leader instead of simply retrying within a loop. This can increase performance if
  27095. the option is enabled serverside.
  27096. <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>
  27097. </td>
  27098. </tr>
  27099. <tr>
  27100. <td>
  27101. <code>headers</code></br>
  27102. <em>
  27103. map[string]string
  27104. </em>
  27105. </td>
  27106. <td>
  27107. <em>(Optional)</em>
  27108. <p>Headers to be added in Vault request</p>
  27109. </td>
  27110. </tr>
  27111. </tbody>
  27112. </table>
  27113. <h3 id="external-secrets.io/v1beta1.VaultUserPassAuth">VaultUserPassAuth
  27114. </h3>
  27115. <p>
  27116. (<em>Appears on:</em>
  27117. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  27118. </p>
  27119. <p>
  27120. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  27121. with the username and password stored in a Kubernetes Secret resource.</p>
  27122. </p>
  27123. <table>
  27124. <thead>
  27125. <tr>
  27126. <th>Field</th>
  27127. <th>Description</th>
  27128. </tr>
  27129. </thead>
  27130. <tbody>
  27131. <tr>
  27132. <td>
  27133. <code>path</code></br>
  27134. <em>
  27135. string
  27136. </em>
  27137. </td>
  27138. <td>
  27139. <p>Path where the UserPassword authentication backend is mounted
  27140. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  27141. </td>
  27142. </tr>
  27143. <tr>
  27144. <td>
  27145. <code>username</code></br>
  27146. <em>
  27147. string
  27148. </em>
  27149. </td>
  27150. <td>
  27151. <p>Username is a username used to authenticate using the UserPass Vault
  27152. authentication method</p>
  27153. </td>
  27154. </tr>
  27155. <tr>
  27156. <td>
  27157. <code>secretRef</code></br>
  27158. <em>
  27159. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27160. External Secrets meta/v1.SecretKeySelector
  27161. </a>
  27162. </em>
  27163. </td>
  27164. <td>
  27165. <em>(Optional)</em>
  27166. <p>SecretRef to a key in a Secret resource containing password for the
  27167. user used to authenticate with Vault using the UserPass authentication
  27168. method</p>
  27169. </td>
  27170. </tr>
  27171. </tbody>
  27172. </table>
  27173. <h3 id="external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider
  27174. </h3>
  27175. <p>
  27176. (<em>Appears on:</em>
  27177. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  27178. </p>
  27179. <p>
  27180. <p>WebhookCAProvider defines a location to fetch the certificate for the webhook provider.</p>
  27181. </p>
  27182. <table>
  27183. <thead>
  27184. <tr>
  27185. <th>Field</th>
  27186. <th>Description</th>
  27187. </tr>
  27188. </thead>
  27189. <tbody>
  27190. <tr>
  27191. <td>
  27192. <code>type</code></br>
  27193. <em>
  27194. <a href="#external-secrets.io/v1beta1.WebhookCAProviderType">
  27195. WebhookCAProviderType
  27196. </a>
  27197. </em>
  27198. </td>
  27199. <td>
  27200. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  27201. </td>
  27202. </tr>
  27203. <tr>
  27204. <td>
  27205. <code>name</code></br>
  27206. <em>
  27207. string
  27208. </em>
  27209. </td>
  27210. <td>
  27211. <p>The name of the object located at the provider type.</p>
  27212. </td>
  27213. </tr>
  27214. <tr>
  27215. <td>
  27216. <code>key</code></br>
  27217. <em>
  27218. string
  27219. </em>
  27220. </td>
  27221. <td>
  27222. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  27223. </td>
  27224. </tr>
  27225. <tr>
  27226. <td>
  27227. <code>namespace</code></br>
  27228. <em>
  27229. string
  27230. </em>
  27231. </td>
  27232. <td>
  27233. <em>(Optional)</em>
  27234. <p>The namespace the Provider type is in.</p>
  27235. </td>
  27236. </tr>
  27237. </tbody>
  27238. </table>
  27239. <h3 id="external-secrets.io/v1beta1.WebhookCAProviderType">WebhookCAProviderType
  27240. (<code>string</code> alias)</p></h3>
  27241. <p>
  27242. (<em>Appears on:</em>
  27243. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider</a>)
  27244. </p>
  27245. <p>
  27246. <p>WebhookCAProviderType defines the type of provider to use for CA certificates with Webhook providers.</p>
  27247. </p>
  27248. <table>
  27249. <thead>
  27250. <tr>
  27251. <th>Value</th>
  27252. <th>Description</th>
  27253. </tr>
  27254. </thead>
  27255. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  27256. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  27257. </td>
  27258. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  27259. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  27260. </td>
  27261. </tr></tbody>
  27262. </table>
  27263. <h3 id="external-secrets.io/v1beta1.WebhookProvider">WebhookProvider
  27264. </h3>
  27265. <p>
  27266. (<em>Appears on:</em>
  27267. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  27268. </p>
  27269. <p>
  27270. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  27271. </p>
  27272. <table>
  27273. <thead>
  27274. <tr>
  27275. <th>Field</th>
  27276. <th>Description</th>
  27277. </tr>
  27278. </thead>
  27279. <tbody>
  27280. <tr>
  27281. <td>
  27282. <code>method</code></br>
  27283. <em>
  27284. string
  27285. </em>
  27286. </td>
  27287. <td>
  27288. <p>Webhook Method</p>
  27289. </td>
  27290. </tr>
  27291. <tr>
  27292. <td>
  27293. <code>url</code></br>
  27294. <em>
  27295. string
  27296. </em>
  27297. </td>
  27298. <td>
  27299. <p>Webhook url to call</p>
  27300. </td>
  27301. </tr>
  27302. <tr>
  27303. <td>
  27304. <code>headers</code></br>
  27305. <em>
  27306. map[string]string
  27307. </em>
  27308. </td>
  27309. <td>
  27310. <em>(Optional)</em>
  27311. <p>Headers</p>
  27312. </td>
  27313. </tr>
  27314. <tr>
  27315. <td>
  27316. <code>auth</code></br>
  27317. <em>
  27318. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">
  27319. AuthorizationProtocol
  27320. </a>
  27321. </em>
  27322. </td>
  27323. <td>
  27324. <em>(Optional)</em>
  27325. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  27326. </td>
  27327. </tr>
  27328. <tr>
  27329. <td>
  27330. <code>body</code></br>
  27331. <em>
  27332. string
  27333. </em>
  27334. </td>
  27335. <td>
  27336. <em>(Optional)</em>
  27337. <p>Body</p>
  27338. </td>
  27339. </tr>
  27340. <tr>
  27341. <td>
  27342. <code>timeout</code></br>
  27343. <em>
  27344. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  27345. Kubernetes meta/v1.Duration
  27346. </a>
  27347. </em>
  27348. </td>
  27349. <td>
  27350. <em>(Optional)</em>
  27351. <p>Timeout</p>
  27352. </td>
  27353. </tr>
  27354. <tr>
  27355. <td>
  27356. <code>result</code></br>
  27357. <em>
  27358. <a href="#external-secrets.io/v1beta1.WebhookResult">
  27359. WebhookResult
  27360. </a>
  27361. </em>
  27362. </td>
  27363. <td>
  27364. <p>Result formatting</p>
  27365. </td>
  27366. </tr>
  27367. <tr>
  27368. <td>
  27369. <code>secrets</code></br>
  27370. <em>
  27371. <a href="#external-secrets.io/v1beta1.WebhookSecret">
  27372. []WebhookSecret
  27373. </a>
  27374. </em>
  27375. </td>
  27376. <td>
  27377. <em>(Optional)</em>
  27378. <p>Secrets to fill in templates
  27379. These secrets will be passed to the templating function as key value pairs under the given name</p>
  27380. </td>
  27381. </tr>
  27382. <tr>
  27383. <td>
  27384. <code>caBundle</code></br>
  27385. <em>
  27386. []byte
  27387. </em>
  27388. </td>
  27389. <td>
  27390. <em>(Optional)</em>
  27391. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  27392. if the Server URL is using HTTPS protocol. This parameter is ignored for
  27393. plain HTTP protocol connection. If not set the system root certificates
  27394. are used to validate the TLS connection.</p>
  27395. </td>
  27396. </tr>
  27397. <tr>
  27398. <td>
  27399. <code>caProvider</code></br>
  27400. <em>
  27401. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">
  27402. WebhookCAProvider
  27403. </a>
  27404. </em>
  27405. </td>
  27406. <td>
  27407. <em>(Optional)</em>
  27408. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  27409. </td>
  27410. </tr>
  27411. </tbody>
  27412. </table>
  27413. <h3 id="external-secrets.io/v1beta1.WebhookResult">WebhookResult
  27414. </h3>
  27415. <p>
  27416. (<em>Appears on:</em>
  27417. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  27418. </p>
  27419. <p>
  27420. <p>WebhookResult defines how to extract and format the result from the webhook response.</p>
  27421. </p>
  27422. <table>
  27423. <thead>
  27424. <tr>
  27425. <th>Field</th>
  27426. <th>Description</th>
  27427. </tr>
  27428. </thead>
  27429. <tbody>
  27430. <tr>
  27431. <td>
  27432. <code>jsonPath</code></br>
  27433. <em>
  27434. string
  27435. </em>
  27436. </td>
  27437. <td>
  27438. <em>(Optional)</em>
  27439. <p>Json path of return value</p>
  27440. </td>
  27441. </tr>
  27442. </tbody>
  27443. </table>
  27444. <h3 id="external-secrets.io/v1beta1.WebhookSecret">WebhookSecret
  27445. </h3>
  27446. <p>
  27447. (<em>Appears on:</em>
  27448. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  27449. </p>
  27450. <p>
  27451. <p>WebhookSecret defines a secret to be used in webhook templates.</p>
  27452. </p>
  27453. <table>
  27454. <thead>
  27455. <tr>
  27456. <th>Field</th>
  27457. <th>Description</th>
  27458. </tr>
  27459. </thead>
  27460. <tbody>
  27461. <tr>
  27462. <td>
  27463. <code>name</code></br>
  27464. <em>
  27465. string
  27466. </em>
  27467. </td>
  27468. <td>
  27469. <p>Name of this secret in templates</p>
  27470. </td>
  27471. </tr>
  27472. <tr>
  27473. <td>
  27474. <code>secretRef</code></br>
  27475. <em>
  27476. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27477. External Secrets meta/v1.SecretKeySelector
  27478. </a>
  27479. </em>
  27480. </td>
  27481. <td>
  27482. <p>Secret ref to fill in credentials</p>
  27483. </td>
  27484. </tr>
  27485. </tbody>
  27486. </table>
  27487. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerAuth">YandexCertificateManagerAuth
  27488. </h3>
  27489. <p>
  27490. (<em>Appears on:</em>
  27491. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  27492. </p>
  27493. <p>
  27494. <p>YandexCertificateManagerAuth defines authentication configuration for the Yandex Certificate Manager provider.</p>
  27495. </p>
  27496. <table>
  27497. <thead>
  27498. <tr>
  27499. <th>Field</th>
  27500. <th>Description</th>
  27501. </tr>
  27502. </thead>
  27503. <tbody>
  27504. <tr>
  27505. <td>
  27506. <code>authorizedKeySecretRef</code></br>
  27507. <em>
  27508. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27509. External Secrets meta/v1.SecretKeySelector
  27510. </a>
  27511. </em>
  27512. </td>
  27513. <td>
  27514. <em>(Optional)</em>
  27515. <p>The authorized key used for authentication</p>
  27516. </td>
  27517. </tr>
  27518. </tbody>
  27519. </table>
  27520. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">YandexCertificateManagerCAProvider
  27521. </h3>
  27522. <p>
  27523. (<em>Appears on:</em>
  27524. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  27525. </p>
  27526. <p>
  27527. <p>YandexCertificateManagerCAProvider defines CA certificate configuration for Yandex Certificate Manager.</p>
  27528. </p>
  27529. <table>
  27530. <thead>
  27531. <tr>
  27532. <th>Field</th>
  27533. <th>Description</th>
  27534. </tr>
  27535. </thead>
  27536. <tbody>
  27537. <tr>
  27538. <td>
  27539. <code>certSecretRef</code></br>
  27540. <em>
  27541. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27542. External Secrets meta/v1.SecretKeySelector
  27543. </a>
  27544. </em>
  27545. </td>
  27546. <td>
  27547. </td>
  27548. </tr>
  27549. </tbody>
  27550. </table>
  27551. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  27552. </h3>
  27553. <p>
  27554. (<em>Appears on:</em>
  27555. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  27556. </p>
  27557. <p>
  27558. <p>YandexCertificateManagerProvider configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  27559. </p>
  27560. <table>
  27561. <thead>
  27562. <tr>
  27563. <th>Field</th>
  27564. <th>Description</th>
  27565. </tr>
  27566. </thead>
  27567. <tbody>
  27568. <tr>
  27569. <td>
  27570. <code>apiEndpoint</code></br>
  27571. <em>
  27572. string
  27573. </em>
  27574. </td>
  27575. <td>
  27576. <em>(Optional)</em>
  27577. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  27578. </td>
  27579. </tr>
  27580. <tr>
  27581. <td>
  27582. <code>auth</code></br>
  27583. <em>
  27584. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerAuth">
  27585. YandexCertificateManagerAuth
  27586. </a>
  27587. </em>
  27588. </td>
  27589. <td>
  27590. <p>Auth defines the information necessary to authenticate against Yandex Certificate Manager</p>
  27591. </td>
  27592. </tr>
  27593. <tr>
  27594. <td>
  27595. <code>caProvider</code></br>
  27596. <em>
  27597. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">
  27598. YandexCertificateManagerCAProvider
  27599. </a>
  27600. </em>
  27601. </td>
  27602. <td>
  27603. <em>(Optional)</em>
  27604. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  27605. </td>
  27606. </tr>
  27607. </tbody>
  27608. </table>
  27609. <h3 id="external-secrets.io/v1beta1.YandexLockboxAuth">YandexLockboxAuth
  27610. </h3>
  27611. <p>
  27612. (<em>Appears on:</em>
  27613. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  27614. </p>
  27615. <p>
  27616. <p>YandexLockboxAuth defines authentication configuration for the Yandex Lockbox provider.</p>
  27617. </p>
  27618. <table>
  27619. <thead>
  27620. <tr>
  27621. <th>Field</th>
  27622. <th>Description</th>
  27623. </tr>
  27624. </thead>
  27625. <tbody>
  27626. <tr>
  27627. <td>
  27628. <code>authorizedKeySecretRef</code></br>
  27629. <em>
  27630. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27631. External Secrets meta/v1.SecretKeySelector
  27632. </a>
  27633. </em>
  27634. </td>
  27635. <td>
  27636. <em>(Optional)</em>
  27637. <p>The authorized key used for authentication</p>
  27638. </td>
  27639. </tr>
  27640. </tbody>
  27641. </table>
  27642. <h3 id="external-secrets.io/v1beta1.YandexLockboxCAProvider">YandexLockboxCAProvider
  27643. </h3>
  27644. <p>
  27645. (<em>Appears on:</em>
  27646. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  27647. </p>
  27648. <p>
  27649. <p>YandexLockboxCAProvider defines CA certificate configuration for Yandex Lockbox.</p>
  27650. </p>
  27651. <table>
  27652. <thead>
  27653. <tr>
  27654. <th>Field</th>
  27655. <th>Description</th>
  27656. </tr>
  27657. </thead>
  27658. <tbody>
  27659. <tr>
  27660. <td>
  27661. <code>certSecretRef</code></br>
  27662. <em>
  27663. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27664. External Secrets meta/v1.SecretKeySelector
  27665. </a>
  27666. </em>
  27667. </td>
  27668. <td>
  27669. </td>
  27670. </tr>
  27671. </tbody>
  27672. </table>
  27673. <h3 id="external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider
  27674. </h3>
  27675. <p>
  27676. (<em>Appears on:</em>
  27677. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  27678. </p>
  27679. <p>
  27680. <p>YandexLockboxProvider configures a store to sync secrets using the Yandex Lockbox provider.</p>
  27681. </p>
  27682. <table>
  27683. <thead>
  27684. <tr>
  27685. <th>Field</th>
  27686. <th>Description</th>
  27687. </tr>
  27688. </thead>
  27689. <tbody>
  27690. <tr>
  27691. <td>
  27692. <code>apiEndpoint</code></br>
  27693. <em>
  27694. string
  27695. </em>
  27696. </td>
  27697. <td>
  27698. <em>(Optional)</em>
  27699. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  27700. </td>
  27701. </tr>
  27702. <tr>
  27703. <td>
  27704. <code>auth</code></br>
  27705. <em>
  27706. <a href="#external-secrets.io/v1beta1.YandexLockboxAuth">
  27707. YandexLockboxAuth
  27708. </a>
  27709. </em>
  27710. </td>
  27711. <td>
  27712. <p>Auth defines the information necessary to authenticate against Yandex Lockbox</p>
  27713. </td>
  27714. </tr>
  27715. <tr>
  27716. <td>
  27717. <code>caProvider</code></br>
  27718. <em>
  27719. <a href="#external-secrets.io/v1beta1.YandexLockboxCAProvider">
  27720. YandexLockboxCAProvider
  27721. </a>
  27722. </em>
  27723. </td>
  27724. <td>
  27725. <em>(Optional)</em>
  27726. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  27727. </td>
  27728. </tr>
  27729. </tbody>
  27730. </table>
  27731. <hr/>
  27732. <h2 id="generators.external-secrets.io/v1alpha1">generators.external-secrets.io/v1alpha1</h2>
  27733. <p>
  27734. <p>Package v1alpha1 contains resources for generators</p>
  27735. </p>
  27736. <p>Resource Types:</p>
  27737. <ul></ul>
  27738. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken
  27739. </h3>
  27740. <p>
  27741. <p>ACRAccessToken returns an Azure Container Registry token
  27742. that can be used for pushing/pulling images.
  27743. Note: by default it will return an ACR Refresh Token with full access
  27744. (depending on the identity).
  27745. This can be scoped down to the repository level using .spec.scope.
  27746. In case scope is defined it will return an ACR Access Token.</p>
  27747. <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>
  27748. </p>
  27749. <table>
  27750. <thead>
  27751. <tr>
  27752. <th>Field</th>
  27753. <th>Description</th>
  27754. </tr>
  27755. </thead>
  27756. <tbody>
  27757. <tr>
  27758. <td>
  27759. <code>metadata</code></br>
  27760. <em>
  27761. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27762. Kubernetes meta/v1.ObjectMeta
  27763. </a>
  27764. </em>
  27765. </td>
  27766. <td>
  27767. Refer to the Kubernetes API documentation for the fields of the
  27768. <code>metadata</code> field.
  27769. </td>
  27770. </tr>
  27771. <tr>
  27772. <td>
  27773. <code>spec</code></br>
  27774. <em>
  27775. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  27776. ACRAccessTokenSpec
  27777. </a>
  27778. </em>
  27779. </td>
  27780. <td>
  27781. <br/>
  27782. <br/>
  27783. <table>
  27784. <tr>
  27785. <td>
  27786. <code>auth</code></br>
  27787. <em>
  27788. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  27789. ACRAuth
  27790. </a>
  27791. </em>
  27792. </td>
  27793. <td>
  27794. </td>
  27795. </tr>
  27796. <tr>
  27797. <td>
  27798. <code>tenantId</code></br>
  27799. <em>
  27800. string
  27801. </em>
  27802. </td>
  27803. <td>
  27804. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  27805. </td>
  27806. </tr>
  27807. <tr>
  27808. <td>
  27809. <code>registry</code></br>
  27810. <em>
  27811. string
  27812. </em>
  27813. </td>
  27814. <td>
  27815. <p>the domain name of the ACR registry
  27816. e.g. foobarexample.azurecr.io</p>
  27817. </td>
  27818. </tr>
  27819. <tr>
  27820. <td>
  27821. <code>scope</code></br>
  27822. <em>
  27823. string
  27824. </em>
  27825. </td>
  27826. <td>
  27827. <em>(Optional)</em>
  27828. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  27829. if not provided it will return a refresh token that has full scope.
  27830. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  27831. <p>examples:
  27832. repository:my-repository:pull,push
  27833. repository:my-repository:pull</p>
  27834. <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>
  27835. </td>
  27836. </tr>
  27837. <tr>
  27838. <td>
  27839. <code>environmentType</code></br>
  27840. <em>
  27841. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  27842. AzureEnvironmentType
  27843. </a>
  27844. </em>
  27845. </td>
  27846. <td>
  27847. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  27848. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  27849. 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>
  27850. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  27851. </td>
  27852. </tr>
  27853. </table>
  27854. </td>
  27855. </tr>
  27856. </tbody>
  27857. </table>
  27858. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec
  27859. </h3>
  27860. <p>
  27861. (<em>Appears on:</em>
  27862. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken</a>,
  27863. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27864. </p>
  27865. <p>
  27866. <p>ACRAccessTokenSpec defines how to generate the access token
  27867. e.g. how to authenticate and which registry to use.
  27868. 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>
  27869. </p>
  27870. <table>
  27871. <thead>
  27872. <tr>
  27873. <th>Field</th>
  27874. <th>Description</th>
  27875. </tr>
  27876. </thead>
  27877. <tbody>
  27878. <tr>
  27879. <td>
  27880. <code>auth</code></br>
  27881. <em>
  27882. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  27883. ACRAuth
  27884. </a>
  27885. </em>
  27886. </td>
  27887. <td>
  27888. </td>
  27889. </tr>
  27890. <tr>
  27891. <td>
  27892. <code>tenantId</code></br>
  27893. <em>
  27894. string
  27895. </em>
  27896. </td>
  27897. <td>
  27898. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  27899. </td>
  27900. </tr>
  27901. <tr>
  27902. <td>
  27903. <code>registry</code></br>
  27904. <em>
  27905. string
  27906. </em>
  27907. </td>
  27908. <td>
  27909. <p>the domain name of the ACR registry
  27910. e.g. foobarexample.azurecr.io</p>
  27911. </td>
  27912. </tr>
  27913. <tr>
  27914. <td>
  27915. <code>scope</code></br>
  27916. <em>
  27917. string
  27918. </em>
  27919. </td>
  27920. <td>
  27921. <em>(Optional)</em>
  27922. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  27923. if not provided it will return a refresh token that has full scope.
  27924. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  27925. <p>examples:
  27926. repository:my-repository:pull,push
  27927. repository:my-repository:pull</p>
  27928. <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>
  27929. </td>
  27930. </tr>
  27931. <tr>
  27932. <td>
  27933. <code>environmentType</code></br>
  27934. <em>
  27935. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  27936. AzureEnvironmentType
  27937. </a>
  27938. </em>
  27939. </td>
  27940. <td>
  27941. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  27942. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  27943. 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>
  27944. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  27945. </td>
  27946. </tr>
  27947. </tbody>
  27948. </table>
  27949. <h3 id="generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth
  27950. </h3>
  27951. <p>
  27952. (<em>Appears on:</em>
  27953. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  27954. </p>
  27955. <p>
  27956. <p>ACRAuth defines the authentication methods for Azure Container Registry.</p>
  27957. </p>
  27958. <table>
  27959. <thead>
  27960. <tr>
  27961. <th>Field</th>
  27962. <th>Description</th>
  27963. </tr>
  27964. </thead>
  27965. <tbody>
  27966. <tr>
  27967. <td>
  27968. <code>servicePrincipal</code></br>
  27969. <em>
  27970. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">
  27971. AzureACRServicePrincipalAuth
  27972. </a>
  27973. </em>
  27974. </td>
  27975. <td>
  27976. <em>(Optional)</em>
  27977. <p>ServicePrincipal uses Azure Service Principal credentials to authenticate with Azure.</p>
  27978. </td>
  27979. </tr>
  27980. <tr>
  27981. <td>
  27982. <code>managedIdentity</code></br>
  27983. <em>
  27984. <a href="#generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">
  27985. AzureACRManagedIdentityAuth
  27986. </a>
  27987. </em>
  27988. </td>
  27989. <td>
  27990. <em>(Optional)</em>
  27991. <p>ManagedIdentity uses Azure Managed Identity to authenticate with Azure.</p>
  27992. </td>
  27993. </tr>
  27994. <tr>
  27995. <td>
  27996. <code>workloadIdentity</code></br>
  27997. <em>
  27998. <a href="#generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">
  27999. AzureACRWorkloadIdentityAuth
  28000. </a>
  28001. </em>
  28002. </td>
  28003. <td>
  28004. <em>(Optional)</em>
  28005. <p>WorkloadIdentity uses Azure Workload Identity to authenticate with Azure.</p>
  28006. </td>
  28007. </tr>
  28008. </tbody>
  28009. </table>
  28010. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth
  28011. </h3>
  28012. <p>
  28013. (<em>Appears on:</em>
  28014. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec</a>,
  28015. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  28016. </p>
  28017. <p>
  28018. <p>AWSAuth tells the controller how to do authentication with aws.
  28019. Only one of secretRef or jwt can be specified.
  28020. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  28021. </p>
  28022. <table>
  28023. <thead>
  28024. <tr>
  28025. <th>Field</th>
  28026. <th>Description</th>
  28027. </tr>
  28028. </thead>
  28029. <tbody>
  28030. <tr>
  28031. <td>
  28032. <code>secretRef</code></br>
  28033. <em>
  28034. <a href="#generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">
  28035. AWSAuthSecretRef
  28036. </a>
  28037. </em>
  28038. </td>
  28039. <td>
  28040. <em>(Optional)</em>
  28041. </td>
  28042. </tr>
  28043. <tr>
  28044. <td>
  28045. <code>jwt</code></br>
  28046. <em>
  28047. <a href="#generators.external-secrets.io/v1alpha1.AWSJWTAuth">
  28048. AWSJWTAuth
  28049. </a>
  28050. </em>
  28051. </td>
  28052. <td>
  28053. <em>(Optional)</em>
  28054. </td>
  28055. </tr>
  28056. </tbody>
  28057. </table>
  28058. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">AWSAuthSecretRef
  28059. </h3>
  28060. <p>
  28061. (<em>Appears on:</em>
  28062. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  28063. </p>
  28064. <p>
  28065. <p>AWSAuthSecretRef holds secret references for AWS credentials
  28066. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  28067. </p>
  28068. <table>
  28069. <thead>
  28070. <tr>
  28071. <th>Field</th>
  28072. <th>Description</th>
  28073. </tr>
  28074. </thead>
  28075. <tbody>
  28076. <tr>
  28077. <td>
  28078. <code>accessKeyIDSecretRef</code></br>
  28079. <em>
  28080. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28081. External Secrets meta/v1.SecretKeySelector
  28082. </a>
  28083. </em>
  28084. </td>
  28085. <td>
  28086. <p>The AccessKeyID is used for authentication</p>
  28087. </td>
  28088. </tr>
  28089. <tr>
  28090. <td>
  28091. <code>secretAccessKeySecretRef</code></br>
  28092. <em>
  28093. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28094. External Secrets meta/v1.SecretKeySelector
  28095. </a>
  28096. </em>
  28097. </td>
  28098. <td>
  28099. <p>The SecretAccessKey is used for authentication</p>
  28100. </td>
  28101. </tr>
  28102. <tr>
  28103. <td>
  28104. <code>sessionTokenSecretRef</code></br>
  28105. <em>
  28106. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28107. External Secrets meta/v1.SecretKeySelector
  28108. </a>
  28109. </em>
  28110. </td>
  28111. <td>
  28112. <p>The SessionToken used for authentication
  28113. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  28114. 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>
  28115. </td>
  28116. </tr>
  28117. </tbody>
  28118. </table>
  28119. <h3 id="generators.external-secrets.io/v1alpha1.AWSJWTAuth">AWSJWTAuth
  28120. </h3>
  28121. <p>
  28122. (<em>Appears on:</em>
  28123. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  28124. </p>
  28125. <p>
  28126. <p>AWSJWTAuth provides configuration to authenticate against AWS using service account tokens.</p>
  28127. </p>
  28128. <table>
  28129. <thead>
  28130. <tr>
  28131. <th>Field</th>
  28132. <th>Description</th>
  28133. </tr>
  28134. </thead>
  28135. <tbody>
  28136. <tr>
  28137. <td>
  28138. <code>serviceAccountRef</code></br>
  28139. <em>
  28140. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28141. External Secrets meta/v1.ServiceAccountSelector
  28142. </a>
  28143. </em>
  28144. </td>
  28145. <td>
  28146. </td>
  28147. </tr>
  28148. </tbody>
  28149. </table>
  28150. <h3 id="generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol
  28151. </h3>
  28152. <p>
  28153. (<em>Appears on:</em>
  28154. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  28155. </p>
  28156. <p>
  28157. <p>AuthorizationProtocol contains the protocol-specific configuration</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>ntlm</code></br>
  28170. <em>
  28171. <a href="#generators.external-secrets.io/v1alpha1.NTLMProtocol">
  28172. NTLMProtocol
  28173. </a>
  28174. </em>
  28175. </td>
  28176. <td>
  28177. <em>(Optional)</em>
  28178. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  28179. </td>
  28180. </tr>
  28181. </tbody>
  28182. </table>
  28183. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">AzureACRManagedIdentityAuth
  28184. </h3>
  28185. <p>
  28186. (<em>Appears on:</em>
  28187. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  28188. </p>
  28189. <p>
  28190. <p>AzureACRManagedIdentityAuth defines the configuration for using Azure Managed Identity authentication.</p>
  28191. </p>
  28192. <table>
  28193. <thead>
  28194. <tr>
  28195. <th>Field</th>
  28196. <th>Description</th>
  28197. </tr>
  28198. </thead>
  28199. <tbody>
  28200. <tr>
  28201. <td>
  28202. <code>identityId</code></br>
  28203. <em>
  28204. string
  28205. </em>
  28206. </td>
  28207. <td>
  28208. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  28209. </td>
  28210. </tr>
  28211. </tbody>
  28212. </table>
  28213. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth
  28214. </h3>
  28215. <p>
  28216. (<em>Appears on:</em>
  28217. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  28218. </p>
  28219. <p>
  28220. <p>AzureACRServicePrincipalAuth defines the configuration for using Azure Service Principal authentication.</p>
  28221. </p>
  28222. <table>
  28223. <thead>
  28224. <tr>
  28225. <th>Field</th>
  28226. <th>Description</th>
  28227. </tr>
  28228. </thead>
  28229. <tbody>
  28230. <tr>
  28231. <td>
  28232. <code>secretRef</code></br>
  28233. <em>
  28234. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">
  28235. AzureACRServicePrincipalAuthSecretRef
  28236. </a>
  28237. </em>
  28238. </td>
  28239. <td>
  28240. </td>
  28241. </tr>
  28242. </tbody>
  28243. </table>
  28244. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">AzureACRServicePrincipalAuthSecretRef
  28245. </h3>
  28246. <p>
  28247. (<em>Appears on:</em>
  28248. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth</a>)
  28249. </p>
  28250. <p>
  28251. <p>AzureACRServicePrincipalAuthSecretRef defines the secret references for Azure Service Principal authentication.
  28252. It uses static credentials stored in a Kind=Secret.</p>
  28253. </p>
  28254. <table>
  28255. <thead>
  28256. <tr>
  28257. <th>Field</th>
  28258. <th>Description</th>
  28259. </tr>
  28260. </thead>
  28261. <tbody>
  28262. <tr>
  28263. <td>
  28264. <code>clientId</code></br>
  28265. <em>
  28266. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28267. External Secrets meta/v1.SecretKeySelector
  28268. </a>
  28269. </em>
  28270. </td>
  28271. <td>
  28272. <p>The Azure clientId of the service principle used for authentication.</p>
  28273. </td>
  28274. </tr>
  28275. <tr>
  28276. <td>
  28277. <code>clientSecret</code></br>
  28278. <em>
  28279. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28280. External Secrets meta/v1.SecretKeySelector
  28281. </a>
  28282. </em>
  28283. </td>
  28284. <td>
  28285. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  28286. </td>
  28287. </tr>
  28288. </tbody>
  28289. </table>
  28290. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">AzureACRWorkloadIdentityAuth
  28291. </h3>
  28292. <p>
  28293. (<em>Appears on:</em>
  28294. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  28295. </p>
  28296. <p>
  28297. <p>AzureACRWorkloadIdentityAuth defines the configuration for using Azure Workload Identity authentication.</p>
  28298. </p>
  28299. <table>
  28300. <thead>
  28301. <tr>
  28302. <th>Field</th>
  28303. <th>Description</th>
  28304. </tr>
  28305. </thead>
  28306. <tbody>
  28307. <tr>
  28308. <td>
  28309. <code>serviceAccountRef</code></br>
  28310. <em>
  28311. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28312. External Secrets meta/v1.ServiceAccountSelector
  28313. </a>
  28314. </em>
  28315. </td>
  28316. <td>
  28317. <em>(Optional)</em>
  28318. <p>ServiceAccountRef specified the service account
  28319. that should be used when authenticating with WorkloadIdentity.</p>
  28320. </td>
  28321. </tr>
  28322. </tbody>
  28323. </table>
  28324. <h3 id="generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecret">BeyondtrustWorkloadCredentialsDynamicSecret
  28325. </h3>
  28326. <p>
  28327. <p>BeyondtrustWorkloadCredentialsDynamicSecret represents a generator that requests dynamic credentials from BeyondTrust Workload Credentials.
  28328. This generator calls the BeyondTrust Workload Credentials API to generate fresh, temporary credentials
  28329. (such as AWS STS credentials) each time an ExternalSecret is refreshed.
  28330. Dynamic secret definitions must be created in BeyondTrust Workload Credentials before they can be referenced.
  28331. 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>
  28332. </p>
  28333. <table>
  28334. <thead>
  28335. <tr>
  28336. <th>Field</th>
  28337. <th>Description</th>
  28338. </tr>
  28339. </thead>
  28340. <tbody>
  28341. <tr>
  28342. <td>
  28343. <code>metadata</code></br>
  28344. <em>
  28345. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28346. Kubernetes meta/v1.ObjectMeta
  28347. </a>
  28348. </em>
  28349. </td>
  28350. <td>
  28351. Refer to the Kubernetes API documentation for the fields of the
  28352. <code>metadata</code> field.
  28353. </td>
  28354. </tr>
  28355. <tr>
  28356. <td>
  28357. <code>spec</code></br>
  28358. <em>
  28359. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">
  28360. BeyondtrustWorkloadCredentialsDynamicSecretSpec
  28361. </a>
  28362. </em>
  28363. </td>
  28364. <td>
  28365. <br/>
  28366. <br/>
  28367. <table>
  28368. <tr>
  28369. <td>
  28370. <code>controller</code></br>
  28371. <em>
  28372. string
  28373. </em>
  28374. </td>
  28375. <td>
  28376. <em>(Optional)</em>
  28377. <p>Controller selects the controller that should handle this generator.
  28378. Leave empty to use the default controller.</p>
  28379. </td>
  28380. </tr>
  28381. <tr>
  28382. <td>
  28383. <code>provider</code></br>
  28384. <em>
  28385. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  28386. BeyondtrustWorkloadCredentialsProvider
  28387. </a>
  28388. </em>
  28389. </td>
  28390. <td>
  28391. <p>Provider contains the BeyondtrustWorkloadCredentials provider configuration including authentication,
  28392. server connection details, and the folder path to the dynamic secret definition.
  28393. The folderPath should point to a dynamic secret definition that has been created in
  28394. BeyondTrust Workload Credentials (e.g., &ldquo;production/aws-temp&rdquo;).
  28395. 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>
  28396. </td>
  28397. </tr>
  28398. <tr>
  28399. <td>
  28400. <code>retrySettings</code></br>
  28401. <em>
  28402. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  28403. SecretStoreRetrySettings
  28404. </a>
  28405. </em>
  28406. </td>
  28407. <td>
  28408. <em>(Optional)</em>
  28409. <p>RetrySettings configures exponential backoff for failed API requests.
  28410. If not specified, uses the default retry settings.</p>
  28411. </td>
  28412. </tr>
  28413. </table>
  28414. </td>
  28415. </tr>
  28416. </tbody>
  28417. </table>
  28418. <h3 id="generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec
  28419. </h3>
  28420. <p>
  28421. (<em>Appears on:</em>
  28422. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecret">BeyondtrustWorkloadCredentialsDynamicSecret</a>,
  28423. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28424. </p>
  28425. <p>
  28426. <p>BeyondtrustWorkloadCredentialsDynamicSecretSpec defines the desired spec for BeyondtrustWorkloadCredentials dynamic generator.
  28427. This generator enables obtaining temporary, short-lived credentials from BeyondTrust Workload Credentials.
  28428. 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>
  28429. </p>
  28430. <table>
  28431. <thead>
  28432. <tr>
  28433. <th>Field</th>
  28434. <th>Description</th>
  28435. </tr>
  28436. </thead>
  28437. <tbody>
  28438. <tr>
  28439. <td>
  28440. <code>controller</code></br>
  28441. <em>
  28442. string
  28443. </em>
  28444. </td>
  28445. <td>
  28446. <em>(Optional)</em>
  28447. <p>Controller selects the controller that should handle this generator.
  28448. Leave empty to use the default controller.</p>
  28449. </td>
  28450. </tr>
  28451. <tr>
  28452. <td>
  28453. <code>provider</code></br>
  28454. <em>
  28455. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  28456. BeyondtrustWorkloadCredentialsProvider
  28457. </a>
  28458. </em>
  28459. </td>
  28460. <td>
  28461. <p>Provider contains the BeyondtrustWorkloadCredentials provider configuration including authentication,
  28462. server connection details, and the folder path to the dynamic secret definition.
  28463. The folderPath should point to a dynamic secret definition that has been created in
  28464. BeyondTrust Workload Credentials (e.g., &ldquo;production/aws-temp&rdquo;).
  28465. 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>
  28466. </td>
  28467. </tr>
  28468. <tr>
  28469. <td>
  28470. <code>retrySettings</code></br>
  28471. <em>
  28472. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  28473. SecretStoreRetrySettings
  28474. </a>
  28475. </em>
  28476. </td>
  28477. <td>
  28478. <em>(Optional)</em>
  28479. <p>RetrySettings configures exponential backoff for failed API requests.
  28480. If not specified, uses the default retry settings.</p>
  28481. </td>
  28482. </tr>
  28483. </tbody>
  28484. </table>
  28485. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken
  28486. </h3>
  28487. <p>
  28488. <p>CloudsmithAccessToken generates Cloudsmith access token using OIDC authentication</p>
  28489. </p>
  28490. <table>
  28491. <thead>
  28492. <tr>
  28493. <th>Field</th>
  28494. <th>Description</th>
  28495. </tr>
  28496. </thead>
  28497. <tbody>
  28498. <tr>
  28499. <td>
  28500. <code>metadata</code></br>
  28501. <em>
  28502. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28503. Kubernetes meta/v1.ObjectMeta
  28504. </a>
  28505. </em>
  28506. </td>
  28507. <td>
  28508. Refer to the Kubernetes API documentation for the fields of the
  28509. <code>metadata</code> field.
  28510. </td>
  28511. </tr>
  28512. <tr>
  28513. <td>
  28514. <code>spec</code></br>
  28515. <em>
  28516. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  28517. CloudsmithAccessTokenSpec
  28518. </a>
  28519. </em>
  28520. </td>
  28521. <td>
  28522. <br/>
  28523. <br/>
  28524. <table>
  28525. <tr>
  28526. <td>
  28527. <code>apiUrl</code></br>
  28528. <em>
  28529. string
  28530. </em>
  28531. </td>
  28532. <td>
  28533. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  28534. </td>
  28535. </tr>
  28536. <tr>
  28537. <td>
  28538. <code>orgSlug</code></br>
  28539. <em>
  28540. string
  28541. </em>
  28542. </td>
  28543. <td>
  28544. <p>OrgSlug is the organization slug in Cloudsmith</p>
  28545. </td>
  28546. </tr>
  28547. <tr>
  28548. <td>
  28549. <code>serviceSlug</code></br>
  28550. <em>
  28551. string
  28552. </em>
  28553. </td>
  28554. <td>
  28555. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  28556. </td>
  28557. </tr>
  28558. <tr>
  28559. <td>
  28560. <code>serviceAccountRef</code></br>
  28561. <em>
  28562. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28563. External Secrets meta/v1.ServiceAccountSelector
  28564. </a>
  28565. </em>
  28566. </td>
  28567. <td>
  28568. <p>Name of the service account you are federating with</p>
  28569. </td>
  28570. </tr>
  28571. </table>
  28572. </td>
  28573. </tr>
  28574. </tbody>
  28575. </table>
  28576. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">CloudsmithAccessTokenSpec
  28577. </h3>
  28578. <p>
  28579. (<em>Appears on:</em>
  28580. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken</a>,
  28581. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28582. </p>
  28583. <p>
  28584. <p>CloudsmithAccessTokenSpec defines the configuration for generating a Cloudsmith access token using OIDC authentication.</p>
  28585. </p>
  28586. <table>
  28587. <thead>
  28588. <tr>
  28589. <th>Field</th>
  28590. <th>Description</th>
  28591. </tr>
  28592. </thead>
  28593. <tbody>
  28594. <tr>
  28595. <td>
  28596. <code>apiUrl</code></br>
  28597. <em>
  28598. string
  28599. </em>
  28600. </td>
  28601. <td>
  28602. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  28603. </td>
  28604. </tr>
  28605. <tr>
  28606. <td>
  28607. <code>orgSlug</code></br>
  28608. <em>
  28609. string
  28610. </em>
  28611. </td>
  28612. <td>
  28613. <p>OrgSlug is the organization slug in Cloudsmith</p>
  28614. </td>
  28615. </tr>
  28616. <tr>
  28617. <td>
  28618. <code>serviceSlug</code></br>
  28619. <em>
  28620. string
  28621. </em>
  28622. </td>
  28623. <td>
  28624. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  28625. </td>
  28626. </tr>
  28627. <tr>
  28628. <td>
  28629. <code>serviceAccountRef</code></br>
  28630. <em>
  28631. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28632. External Secrets meta/v1.ServiceAccountSelector
  28633. </a>
  28634. </em>
  28635. </td>
  28636. <td>
  28637. <p>Name of the service account you are federating with</p>
  28638. </td>
  28639. </tr>
  28640. </tbody>
  28641. </table>
  28642. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator
  28643. </h3>
  28644. <p>
  28645. <p>ClusterGenerator represents a cluster-wide generator which can be referenced as part of <code>generatorRef</code> fields.</p>
  28646. </p>
  28647. <table>
  28648. <thead>
  28649. <tr>
  28650. <th>Field</th>
  28651. <th>Description</th>
  28652. </tr>
  28653. </thead>
  28654. <tbody>
  28655. <tr>
  28656. <td>
  28657. <code>metadata</code></br>
  28658. <em>
  28659. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28660. Kubernetes meta/v1.ObjectMeta
  28661. </a>
  28662. </em>
  28663. </td>
  28664. <td>
  28665. Refer to the Kubernetes API documentation for the fields of the
  28666. <code>metadata</code> field.
  28667. </td>
  28668. </tr>
  28669. <tr>
  28670. <td>
  28671. <code>spec</code></br>
  28672. <em>
  28673. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">
  28674. ClusterGeneratorSpec
  28675. </a>
  28676. </em>
  28677. </td>
  28678. <td>
  28679. <br/>
  28680. <br/>
  28681. <table>
  28682. <tr>
  28683. <td>
  28684. <code>kind</code></br>
  28685. <em>
  28686. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  28687. GeneratorKind
  28688. </a>
  28689. </em>
  28690. </td>
  28691. <td>
  28692. <p>Kind the kind of this generator.</p>
  28693. </td>
  28694. </tr>
  28695. <tr>
  28696. <td>
  28697. <code>generator</code></br>
  28698. <em>
  28699. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  28700. GeneratorSpec
  28701. </a>
  28702. </em>
  28703. </td>
  28704. <td>
  28705. <p>Generator the spec for this generator, must match the kind.</p>
  28706. </td>
  28707. </tr>
  28708. </table>
  28709. </td>
  28710. </tr>
  28711. </tbody>
  28712. </table>
  28713. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec
  28714. </h3>
  28715. <p>
  28716. (<em>Appears on:</em>
  28717. <a href="#generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator</a>)
  28718. </p>
  28719. <p>
  28720. <p>ClusterGeneratorSpec defines the desired state of a ClusterGenerator.</p>
  28721. </p>
  28722. <table>
  28723. <thead>
  28724. <tr>
  28725. <th>Field</th>
  28726. <th>Description</th>
  28727. </tr>
  28728. </thead>
  28729. <tbody>
  28730. <tr>
  28731. <td>
  28732. <code>kind</code></br>
  28733. <em>
  28734. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  28735. GeneratorKind
  28736. </a>
  28737. </em>
  28738. </td>
  28739. <td>
  28740. <p>Kind the kind of this generator.</p>
  28741. </td>
  28742. </tr>
  28743. <tr>
  28744. <td>
  28745. <code>generator</code></br>
  28746. <em>
  28747. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  28748. GeneratorSpec
  28749. </a>
  28750. </em>
  28751. </td>
  28752. <td>
  28753. <p>Generator the spec for this generator, must match the kind.</p>
  28754. </td>
  28755. </tr>
  28756. </tbody>
  28757. </table>
  28758. <h3 id="generators.external-secrets.io/v1alpha1.ControllerClassResource">ControllerClassResource
  28759. </h3>
  28760. <p>
  28761. <p>ControllerClassResource defines a resource that can be assigned to a specific controller class.</p>
  28762. </p>
  28763. <table>
  28764. <thead>
  28765. <tr>
  28766. <th>Field</th>
  28767. <th>Description</th>
  28768. </tr>
  28769. </thead>
  28770. <tbody>
  28771. <tr>
  28772. <td>
  28773. <code>spec</code></br>
  28774. <em>
  28775. struct{ControllerClass string &#34;json:\&#34;controller\&#34;&#34;}
  28776. </em>
  28777. </td>
  28778. <td>
  28779. <br/>
  28780. <br/>
  28781. <table>
  28782. <tr>
  28783. <td>
  28784. <code>controller</code></br>
  28785. <em>
  28786. string
  28787. </em>
  28788. </td>
  28789. <td>
  28790. </td>
  28791. </tr>
  28792. </table>
  28793. </td>
  28794. </tr>
  28795. </tbody>
  28796. </table>
  28797. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken
  28798. </h3>
  28799. <p>
  28800. <p>ECRAuthorizationToken uses the GetAuthorizationToken API to retrieve an authorization token.
  28801. The authorization token is valid for 12 hours.
  28802. The authorizationToken returned is a base64 encoded string that can be decoded
  28803. and used in a docker login command to authenticate to a registry.
  28804. 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>
  28805. </p>
  28806. <table>
  28807. <thead>
  28808. <tr>
  28809. <th>Field</th>
  28810. <th>Description</th>
  28811. </tr>
  28812. </thead>
  28813. <tbody>
  28814. <tr>
  28815. <td>
  28816. <code>metadata</code></br>
  28817. <em>
  28818. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28819. Kubernetes meta/v1.ObjectMeta
  28820. </a>
  28821. </em>
  28822. </td>
  28823. <td>
  28824. Refer to the Kubernetes API documentation for the fields of the
  28825. <code>metadata</code> field.
  28826. </td>
  28827. </tr>
  28828. <tr>
  28829. <td>
  28830. <code>spec</code></br>
  28831. <em>
  28832. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  28833. ECRAuthorizationTokenSpec
  28834. </a>
  28835. </em>
  28836. </td>
  28837. <td>
  28838. <br/>
  28839. <br/>
  28840. <table>
  28841. <tr>
  28842. <td>
  28843. <code>region</code></br>
  28844. <em>
  28845. string
  28846. </em>
  28847. </td>
  28848. <td>
  28849. <p>Region specifies the region to operate in.</p>
  28850. </td>
  28851. </tr>
  28852. <tr>
  28853. <td>
  28854. <code>auth</code></br>
  28855. <em>
  28856. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28857. AWSAuth
  28858. </a>
  28859. </em>
  28860. </td>
  28861. <td>
  28862. <em>(Optional)</em>
  28863. <p>Auth defines how to authenticate with AWS</p>
  28864. </td>
  28865. </tr>
  28866. <tr>
  28867. <td>
  28868. <code>role</code></br>
  28869. <em>
  28870. string
  28871. </em>
  28872. </td>
  28873. <td>
  28874. <em>(Optional)</em>
  28875. <p>You can assume a role before making calls to the
  28876. desired AWS service.</p>
  28877. </td>
  28878. </tr>
  28879. <tr>
  28880. <td>
  28881. <code>scope</code></br>
  28882. <em>
  28883. string
  28884. </em>
  28885. </td>
  28886. <td>
  28887. <em>(Optional)</em>
  28888. <p>Scope specifies the ECR service scope.
  28889. Valid options are private and public.</p>
  28890. </td>
  28891. </tr>
  28892. </table>
  28893. </td>
  28894. </tr>
  28895. </tbody>
  28896. </table>
  28897. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec
  28898. </h3>
  28899. <p>
  28900. (<em>Appears on:</em>
  28901. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken</a>,
  28902. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28903. </p>
  28904. <p>
  28905. <p>ECRAuthorizationTokenSpec defines the desired state to generate an AWS ECR authorization token.</p>
  28906. </p>
  28907. <table>
  28908. <thead>
  28909. <tr>
  28910. <th>Field</th>
  28911. <th>Description</th>
  28912. </tr>
  28913. </thead>
  28914. <tbody>
  28915. <tr>
  28916. <td>
  28917. <code>region</code></br>
  28918. <em>
  28919. string
  28920. </em>
  28921. </td>
  28922. <td>
  28923. <p>Region specifies the region to operate in.</p>
  28924. </td>
  28925. </tr>
  28926. <tr>
  28927. <td>
  28928. <code>auth</code></br>
  28929. <em>
  28930. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28931. AWSAuth
  28932. </a>
  28933. </em>
  28934. </td>
  28935. <td>
  28936. <em>(Optional)</em>
  28937. <p>Auth defines how to authenticate with AWS</p>
  28938. </td>
  28939. </tr>
  28940. <tr>
  28941. <td>
  28942. <code>role</code></br>
  28943. <em>
  28944. string
  28945. </em>
  28946. </td>
  28947. <td>
  28948. <em>(Optional)</em>
  28949. <p>You can assume a role before making calls to the
  28950. desired AWS service.</p>
  28951. </td>
  28952. </tr>
  28953. <tr>
  28954. <td>
  28955. <code>scope</code></br>
  28956. <em>
  28957. string
  28958. </em>
  28959. </td>
  28960. <td>
  28961. <em>(Optional)</em>
  28962. <p>Scope specifies the ECR service scope.
  28963. Valid options are private and public.</p>
  28964. </td>
  28965. </tr>
  28966. </tbody>
  28967. </table>
  28968. <h3 id="generators.external-secrets.io/v1alpha1.Fake">Fake
  28969. </h3>
  28970. <p>
  28971. <p>Fake generator is used for testing. It lets you define
  28972. a static set of credentials that is always returned.</p>
  28973. </p>
  28974. <table>
  28975. <thead>
  28976. <tr>
  28977. <th>Field</th>
  28978. <th>Description</th>
  28979. </tr>
  28980. </thead>
  28981. <tbody>
  28982. <tr>
  28983. <td>
  28984. <code>metadata</code></br>
  28985. <em>
  28986. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28987. Kubernetes meta/v1.ObjectMeta
  28988. </a>
  28989. </em>
  28990. </td>
  28991. <td>
  28992. Refer to the Kubernetes API documentation for the fields of the
  28993. <code>metadata</code> field.
  28994. </td>
  28995. </tr>
  28996. <tr>
  28997. <td>
  28998. <code>spec</code></br>
  28999. <em>
  29000. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  29001. FakeSpec
  29002. </a>
  29003. </em>
  29004. </td>
  29005. <td>
  29006. <br/>
  29007. <br/>
  29008. <table>
  29009. <tr>
  29010. <td>
  29011. <code>controller</code></br>
  29012. <em>
  29013. string
  29014. </em>
  29015. </td>
  29016. <td>
  29017. <em>(Optional)</em>
  29018. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  29019. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  29020. </td>
  29021. </tr>
  29022. <tr>
  29023. <td>
  29024. <code>data</code></br>
  29025. <em>
  29026. map[string]string
  29027. </em>
  29028. </td>
  29029. <td>
  29030. <p>Data defines the static data returned
  29031. by this generator.</p>
  29032. </td>
  29033. </tr>
  29034. </table>
  29035. </td>
  29036. </tr>
  29037. </tbody>
  29038. </table>
  29039. <h3 id="generators.external-secrets.io/v1alpha1.FakeSpec">FakeSpec
  29040. </h3>
  29041. <p>
  29042. (<em>Appears on:</em>
  29043. <a href="#generators.external-secrets.io/v1alpha1.Fake">Fake</a>,
  29044. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  29045. </p>
  29046. <p>
  29047. <p>FakeSpec contains the static data.</p>
  29048. </p>
  29049. <table>
  29050. <thead>
  29051. <tr>
  29052. <th>Field</th>
  29053. <th>Description</th>
  29054. </tr>
  29055. </thead>
  29056. <tbody>
  29057. <tr>
  29058. <td>
  29059. <code>controller</code></br>
  29060. <em>
  29061. string
  29062. </em>
  29063. </td>
  29064. <td>
  29065. <em>(Optional)</em>
  29066. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  29067. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  29068. </td>
  29069. </tr>
  29070. <tr>
  29071. <td>
  29072. <code>data</code></br>
  29073. <em>
  29074. map[string]string
  29075. </em>
  29076. </td>
  29077. <td>
  29078. <p>Data defines the static data returned
  29079. by this generator.</p>
  29080. </td>
  29081. </tr>
  29082. </tbody>
  29083. </table>
  29084. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth
  29085. </h3>
  29086. <p>
  29087. (<em>Appears on:</em>
  29088. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec</a>)
  29089. </p>
  29090. <p>
  29091. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform.</p>
  29092. </p>
  29093. <table>
  29094. <thead>
  29095. <tr>
  29096. <th>Field</th>
  29097. <th>Description</th>
  29098. </tr>
  29099. </thead>
  29100. <tbody>
  29101. <tr>
  29102. <td>
  29103. <code>secretRef</code></br>
  29104. <em>
  29105. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">
  29106. GCPSMAuthSecretRef
  29107. </a>
  29108. </em>
  29109. </td>
  29110. <td>
  29111. <em>(Optional)</em>
  29112. </td>
  29113. </tr>
  29114. <tr>
  29115. <td>
  29116. <code>workloadIdentity</code></br>
  29117. <em>
  29118. <a href="#generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">
  29119. GCPWorkloadIdentity
  29120. </a>
  29121. </em>
  29122. </td>
  29123. <td>
  29124. <em>(Optional)</em>
  29125. </td>
  29126. </tr>
  29127. <tr>
  29128. <td>
  29129. <code>workloadIdentityFederation</code></br>
  29130. <em>
  29131. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  29132. GCPWorkloadIdentityFederation
  29133. </a>
  29134. </em>
  29135. </td>
  29136. <td>
  29137. <em>(Optional)</em>
  29138. </td>
  29139. </tr>
  29140. </tbody>
  29141. </table>
  29142. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  29143. </h3>
  29144. <p>
  29145. (<em>Appears on:</em>
  29146. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  29147. </p>
  29148. <p>
  29149. <p>GCPSMAuthSecretRef defines the reference to a secret containing Google Cloud Platform credentials.</p>
  29150. </p>
  29151. <table>
  29152. <thead>
  29153. <tr>
  29154. <th>Field</th>
  29155. <th>Description</th>
  29156. </tr>
  29157. </thead>
  29158. <tbody>
  29159. <tr>
  29160. <td>
  29161. <code>secretAccessKeySecretRef</code></br>
  29162. <em>
  29163. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29164. External Secrets meta/v1.SecretKeySelector
  29165. </a>
  29166. </em>
  29167. </td>
  29168. <td>
  29169. <em>(Optional)</em>
  29170. <p>The SecretAccessKey is used for authentication</p>
  29171. </td>
  29172. </tr>
  29173. </tbody>
  29174. </table>
  29175. <h3 id="generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">GCPWorkloadIdentity
  29176. </h3>
  29177. <p>
  29178. (<em>Appears on:</em>
  29179. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  29180. </p>
  29181. <p>
  29182. <p>GCPWorkloadIdentity defines the configuration for using GCP Workload Identity authentication.</p>
  29183. </p>
  29184. <table>
  29185. <thead>
  29186. <tr>
  29187. <th>Field</th>
  29188. <th>Description</th>
  29189. </tr>
  29190. </thead>
  29191. <tbody>
  29192. <tr>
  29193. <td>
  29194. <code>serviceAccountRef</code></br>
  29195. <em>
  29196. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  29197. External Secrets meta/v1.ServiceAccountSelector
  29198. </a>
  29199. </em>
  29200. </td>
  29201. <td>
  29202. </td>
  29203. </tr>
  29204. <tr>
  29205. <td>
  29206. <code>clusterLocation</code></br>
  29207. <em>
  29208. string
  29209. </em>
  29210. </td>
  29211. <td>
  29212. </td>
  29213. </tr>
  29214. <tr>
  29215. <td>
  29216. <code>clusterName</code></br>
  29217. <em>
  29218. string
  29219. </em>
  29220. </td>
  29221. <td>
  29222. </td>
  29223. </tr>
  29224. <tr>
  29225. <td>
  29226. <code>clusterProjectID</code></br>
  29227. <em>
  29228. string
  29229. </em>
  29230. </td>
  29231. <td>
  29232. </td>
  29233. </tr>
  29234. </tbody>
  29235. </table>
  29236. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken
  29237. </h3>
  29238. <p>
  29239. <p>GCRAccessToken generates an GCP access token
  29240. that can be used to authenticate with GCR.</p>
  29241. </p>
  29242. <table>
  29243. <thead>
  29244. <tr>
  29245. <th>Field</th>
  29246. <th>Description</th>
  29247. </tr>
  29248. </thead>
  29249. <tbody>
  29250. <tr>
  29251. <td>
  29252. <code>metadata</code></br>
  29253. <em>
  29254. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29255. Kubernetes meta/v1.ObjectMeta
  29256. </a>
  29257. </em>
  29258. </td>
  29259. <td>
  29260. Refer to the Kubernetes API documentation for the fields of the
  29261. <code>metadata</code> field.
  29262. </td>
  29263. </tr>
  29264. <tr>
  29265. <td>
  29266. <code>spec</code></br>
  29267. <em>
  29268. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  29269. GCRAccessTokenSpec
  29270. </a>
  29271. </em>
  29272. </td>
  29273. <td>
  29274. <br/>
  29275. <br/>
  29276. <table>
  29277. <tr>
  29278. <td>
  29279. <code>auth</code></br>
  29280. <em>
  29281. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  29282. GCPSMAuth
  29283. </a>
  29284. </em>
  29285. </td>
  29286. <td>
  29287. <p>Auth defines the means for authenticating with GCP</p>
  29288. </td>
  29289. </tr>
  29290. <tr>
  29291. <td>
  29292. <code>projectID</code></br>
  29293. <em>
  29294. string
  29295. </em>
  29296. </td>
  29297. <td>
  29298. <p>ProjectID defines which project to use to authenticate with</p>
  29299. </td>
  29300. </tr>
  29301. </table>
  29302. </td>
  29303. </tr>
  29304. </tbody>
  29305. </table>
  29306. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec
  29307. </h3>
  29308. <p>
  29309. (<em>Appears on:</em>
  29310. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken</a>,
  29311. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  29312. </p>
  29313. <p>
  29314. <p>GCRAccessTokenSpec defines the desired state to generate a Google Container Registry access token.</p>
  29315. </p>
  29316. <table>
  29317. <thead>
  29318. <tr>
  29319. <th>Field</th>
  29320. <th>Description</th>
  29321. </tr>
  29322. </thead>
  29323. <tbody>
  29324. <tr>
  29325. <td>
  29326. <code>auth</code></br>
  29327. <em>
  29328. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  29329. GCPSMAuth
  29330. </a>
  29331. </em>
  29332. </td>
  29333. <td>
  29334. <p>Auth defines the means for authenticating with GCP</p>
  29335. </td>
  29336. </tr>
  29337. <tr>
  29338. <td>
  29339. <code>projectID</code></br>
  29340. <em>
  29341. string
  29342. </em>
  29343. </td>
  29344. <td>
  29345. <p>ProjectID defines which project to use to authenticate with</p>
  29346. </td>
  29347. </tr>
  29348. </tbody>
  29349. </table>
  29350. <h3 id="generators.external-secrets.io/v1alpha1.Generator">Generator
  29351. </h3>
  29352. <p>
  29353. <p>Generator is the common interface for all generators that is actually used to generate whatever is needed.</p>
  29354. </p>
  29355. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorKind">GeneratorKind
  29356. (<code>string</code> alias)</p></h3>
  29357. <p>
  29358. (<em>Appears on:</em>
  29359. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  29360. </p>
  29361. <p>
  29362. <p>GeneratorKind represents a kind of generator.</p>
  29363. </p>
  29364. <table>
  29365. <thead>
  29366. <tr>
  29367. <th>Value</th>
  29368. <th>Description</th>
  29369. </tr>
  29370. </thead>
  29371. <tbody><tr><td><p>&#34;ACRAccessToken&#34;</p></td>
  29372. <td><p>GeneratorKindACRAccessToken represents an Azure Container Registry access token generator.</p>
  29373. </td>
  29374. </tr><tr><td><p>&#34;BeyondtrustWorkloadCredentialsDynamicSecret&#34;</p></td>
  29375. <td><p>GeneratorKindBeyondtrustWorkloadCredentialsDynamicSecret represents a BeyondTrust Workload Credentials dynamic secret generator.</p>
  29376. </td>
  29377. </tr><tr><td><p>&#34;CloudsmithAccessToken&#34;</p></td>
  29378. <td><p>GeneratorKindCloudsmithAccessToken represents a Cloudsmith access token generator.</p>
  29379. </td>
  29380. </tr><tr><td><p>&#34;ECRAuthorizationToken&#34;</p></td>
  29381. <td><p>GeneratorKindECRAuthorizationToken represents an AWS ECR authorization token generator.</p>
  29382. </td>
  29383. </tr><tr><td><p>&#34;Fake&#34;</p></td>
  29384. <td><p>GeneratorKindFake represents a fake generator for testing purposes.</p>
  29385. </td>
  29386. </tr><tr><td><p>&#34;GCRAccessToken&#34;</p></td>
  29387. <td><p>GeneratorKindGCRAccessToken represents a Google Container Registry access token generator.</p>
  29388. </td>
  29389. </tr><tr><td><p>&#34;GithubAccessToken&#34;</p></td>
  29390. <td><p>GeneratorKindGithubAccessToken represents a GitHub access token generator.</p>
  29391. </td>
  29392. </tr><tr><td><p>&#34;GitlabDeployToken&#34;</p></td>
  29393. <td><p>GeneratorKindGitlabDeployToken represents a GitLab deploy token generator.</p>
  29394. </td>
  29395. </tr><tr><td><p>&#34;Grafana&#34;</p></td>
  29396. <td><p>GeneratorKindGrafana represents a Grafana token generator.</p>
  29397. </td>
  29398. </tr><tr><td><p>&#34;MFA&#34;</p></td>
  29399. <td><p>GeneratorKindMFA represents a Multi-Factor Authentication generator.</p>
  29400. </td>
  29401. </tr><tr><td><p>&#34;Password&#34;</p></td>
  29402. <td><p>GeneratorKindPassword represents a password generator.</p>
  29403. </td>
  29404. </tr><tr><td><p>&#34;QuayAccessToken&#34;</p></td>
  29405. <td><p>GeneratorKindQuayAccessToken represents a Quay access token generator.</p>
  29406. </td>
  29407. </tr><tr><td><p>&#34;SSHKey&#34;</p></td>
  29408. <td><p>GeneratorKindSSHKey represents an SSH key generator.</p>
  29409. </td>
  29410. </tr><tr><td><p>&#34;STSSessionToken&#34;</p></td>
  29411. <td><p>GeneratorKindSTSSessionToken represents an AWS STS session token generator.</p>
  29412. </td>
  29413. </tr><tr><td><p>&#34;UUID&#34;</p></td>
  29414. <td><p>GeneratorKindUUID represents a UUID generator.</p>
  29415. </td>
  29416. </tr><tr><td><p>&#34;VaultDynamicSecret&#34;</p></td>
  29417. <td><p>GeneratorKindVaultDynamicSecret represents a HashiCorp Vault dynamic secret generator.</p>
  29418. </td>
  29419. </tr><tr><td><p>&#34;Webhook&#34;</p></td>
  29420. <td><p>GeneratorKindWebhook represents a webhook-based generator.</p>
  29421. </td>
  29422. </tr></tbody>
  29423. </table>
  29424. <h3 id="&lt;UNKNOWN_API_GROUP&gt;.GeneratorProviderState">GeneratorProviderState
  29425. </h3>
  29426. <p>
  29427. <p>GeneratorProviderState represents the state of a generator provider that can be stored and retrieved.</p>
  29428. </p>
  29429. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec
  29430. </h3>
  29431. <p>
  29432. (<em>Appears on:</em>
  29433. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  29434. </p>
  29435. <p>
  29436. <p>GeneratorSpec defines the configuration for various supported generator types.</p>
  29437. </p>
  29438. <table>
  29439. <thead>
  29440. <tr>
  29441. <th>Field</th>
  29442. <th>Description</th>
  29443. </tr>
  29444. </thead>
  29445. <tbody>
  29446. <tr>
  29447. <td>
  29448. <code>acrAccessTokenSpec</code></br>
  29449. <em>
  29450. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  29451. ACRAccessTokenSpec
  29452. </a>
  29453. </em>
  29454. </td>
  29455. <td>
  29456. </td>
  29457. </tr>
  29458. <tr>
  29459. <td>
  29460. <code>beyondtrustWorkloadCredentialsDynamicSecretSpec</code></br>
  29461. <em>
  29462. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">
  29463. BeyondtrustWorkloadCredentialsDynamicSecretSpec
  29464. </a>
  29465. </em>
  29466. </td>
  29467. <td>
  29468. </td>
  29469. </tr>
  29470. <tr>
  29471. <td>
  29472. <code>cloudsmithAccessTokenSpec</code></br>
  29473. <em>
  29474. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  29475. CloudsmithAccessTokenSpec
  29476. </a>
  29477. </em>
  29478. </td>
  29479. <td>
  29480. </td>
  29481. </tr>
  29482. <tr>
  29483. <td>
  29484. <code>ecrAuthorizationTokenSpec</code></br>
  29485. <em>
  29486. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  29487. ECRAuthorizationTokenSpec
  29488. </a>
  29489. </em>
  29490. </td>
  29491. <td>
  29492. </td>
  29493. </tr>
  29494. <tr>
  29495. <td>
  29496. <code>fakeSpec</code></br>
  29497. <em>
  29498. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  29499. FakeSpec
  29500. </a>
  29501. </em>
  29502. </td>
  29503. <td>
  29504. </td>
  29505. </tr>
  29506. <tr>
  29507. <td>
  29508. <code>gcrAccessTokenSpec</code></br>
  29509. <em>
  29510. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  29511. GCRAccessTokenSpec
  29512. </a>
  29513. </em>
  29514. </td>
  29515. <td>
  29516. </td>
  29517. </tr>
  29518. <tr>
  29519. <td>
  29520. <code>githubAccessTokenSpec</code></br>
  29521. <em>
  29522. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  29523. GithubAccessTokenSpec
  29524. </a>
  29525. </em>
  29526. </td>
  29527. <td>
  29528. </td>
  29529. </tr>
  29530. <tr>
  29531. <td>
  29532. <code>gitlabDeployTokenSpec</code></br>
  29533. <em>
  29534. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">
  29535. GitlabDeployTokenSpec
  29536. </a>
  29537. </em>
  29538. </td>
  29539. <td>
  29540. </td>
  29541. </tr>
  29542. <tr>
  29543. <td>
  29544. <code>quayAccessTokenSpec</code></br>
  29545. <em>
  29546. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  29547. QuayAccessTokenSpec
  29548. </a>
  29549. </em>
  29550. </td>
  29551. <td>
  29552. </td>
  29553. </tr>
  29554. <tr>
  29555. <td>
  29556. <code>passwordSpec</code></br>
  29557. <em>
  29558. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  29559. PasswordSpec
  29560. </a>
  29561. </em>
  29562. </td>
  29563. <td>
  29564. </td>
  29565. </tr>
  29566. <tr>
  29567. <td>
  29568. <code>sshKeySpec</code></br>
  29569. <em>
  29570. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  29571. SSHKeySpec
  29572. </a>
  29573. </em>
  29574. </td>
  29575. <td>
  29576. </td>
  29577. </tr>
  29578. <tr>
  29579. <td>
  29580. <code>stsSessionTokenSpec</code></br>
  29581. <em>
  29582. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  29583. STSSessionTokenSpec
  29584. </a>
  29585. </em>
  29586. </td>
  29587. <td>
  29588. </td>
  29589. </tr>
  29590. <tr>
  29591. <td>
  29592. <code>uuidSpec</code></br>
  29593. <em>
  29594. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  29595. UUIDSpec
  29596. </a>
  29597. </em>
  29598. </td>
  29599. <td>
  29600. </td>
  29601. </tr>
  29602. <tr>
  29603. <td>
  29604. <code>vaultDynamicSecretSpec</code></br>
  29605. <em>
  29606. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  29607. VaultDynamicSecretSpec
  29608. </a>
  29609. </em>
  29610. </td>
  29611. <td>
  29612. </td>
  29613. </tr>
  29614. <tr>
  29615. <td>
  29616. <code>webhookSpec</code></br>
  29617. <em>
  29618. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  29619. WebhookSpec
  29620. </a>
  29621. </em>
  29622. </td>
  29623. <td>
  29624. </td>
  29625. </tr>
  29626. <tr>
  29627. <td>
  29628. <code>grafanaSpec</code></br>
  29629. <em>
  29630. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  29631. GrafanaSpec
  29632. </a>
  29633. </em>
  29634. </td>
  29635. <td>
  29636. </td>
  29637. </tr>
  29638. <tr>
  29639. <td>
  29640. <code>mfaSpec</code></br>
  29641. <em>
  29642. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  29643. MFASpec
  29644. </a>
  29645. </em>
  29646. </td>
  29647. <td>
  29648. </td>
  29649. </tr>
  29650. </tbody>
  29651. </table>
  29652. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState
  29653. </h3>
  29654. <p>
  29655. <p>GeneratorState represents the state created and managed by a generator resource.</p>
  29656. </p>
  29657. <table>
  29658. <thead>
  29659. <tr>
  29660. <th>Field</th>
  29661. <th>Description</th>
  29662. </tr>
  29663. </thead>
  29664. <tbody>
  29665. <tr>
  29666. <td>
  29667. <code>metadata</code></br>
  29668. <em>
  29669. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29670. Kubernetes meta/v1.ObjectMeta
  29671. </a>
  29672. </em>
  29673. </td>
  29674. <td>
  29675. Refer to the Kubernetes API documentation for the fields of the
  29676. <code>metadata</code> field.
  29677. </td>
  29678. </tr>
  29679. <tr>
  29680. <td>
  29681. <code>spec</code></br>
  29682. <em>
  29683. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateSpec">
  29684. GeneratorStateSpec
  29685. </a>
  29686. </em>
  29687. </td>
  29688. <td>
  29689. <br/>
  29690. <br/>
  29691. <table>
  29692. <tr>
  29693. <td>
  29694. <code>garbageCollectionDeadline</code></br>
  29695. <em>
  29696. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29697. Kubernetes meta/v1.Time
  29698. </a>
  29699. </em>
  29700. </td>
  29701. <td>
  29702. <p>GarbageCollectionDeadline is the time after which the generator state
  29703. will be deleted.
  29704. It is set by the controller which creates the generator state and
  29705. can be set configured by the user.
  29706. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  29707. </td>
  29708. </tr>
  29709. <tr>
  29710. <td>
  29711. <code>resource</code></br>
  29712. <em>
  29713. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29714. </em>
  29715. </td>
  29716. <td>
  29717. <p>Resource is the generator manifest that produced the state.
  29718. It is a snapshot of the generator manifest at the time the state was produced.
  29719. This manifest will be used to delete the resource. Any configuration that is referenced
  29720. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  29721. be blocked by a finalizer.</p>
  29722. </td>
  29723. </tr>
  29724. <tr>
  29725. <td>
  29726. <code>state</code></br>
  29727. <em>
  29728. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29729. </em>
  29730. </td>
  29731. <td>
  29732. <p>State is the state that was produced by the generator implementation.</p>
  29733. </td>
  29734. </tr>
  29735. </table>
  29736. </td>
  29737. </tr>
  29738. <tr>
  29739. <td>
  29740. <code>status</code></br>
  29741. <em>
  29742. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">
  29743. GeneratorStateStatus
  29744. </a>
  29745. </em>
  29746. </td>
  29747. <td>
  29748. </td>
  29749. </tr>
  29750. </tbody>
  29751. </table>
  29752. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">GeneratorStateConditionType
  29753. (<code>string</code> alias)</p></h3>
  29754. <p>
  29755. (<em>Appears on:</em>
  29756. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition</a>)
  29757. </p>
  29758. <p>
  29759. <p>GeneratorStateConditionType represents the type of condition for a generator state.</p>
  29760. </p>
  29761. <table>
  29762. <thead>
  29763. <tr>
  29764. <th>Value</th>
  29765. <th>Description</th>
  29766. </tr>
  29767. </thead>
  29768. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  29769. <td><p>GeneratorStateReady indicates the generator state is ready and available.</p>
  29770. </td>
  29771. </tr></tbody>
  29772. </table>
  29773. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateSpec">GeneratorStateSpec
  29774. </h3>
  29775. <p>
  29776. (<em>Appears on:</em>
  29777. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  29778. </p>
  29779. <p>
  29780. <p>GeneratorStateSpec defines the desired state of a generator state resource.</p>
  29781. </p>
  29782. <table>
  29783. <thead>
  29784. <tr>
  29785. <th>Field</th>
  29786. <th>Description</th>
  29787. </tr>
  29788. </thead>
  29789. <tbody>
  29790. <tr>
  29791. <td>
  29792. <code>garbageCollectionDeadline</code></br>
  29793. <em>
  29794. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29795. Kubernetes meta/v1.Time
  29796. </a>
  29797. </em>
  29798. </td>
  29799. <td>
  29800. <p>GarbageCollectionDeadline is the time after which the generator state
  29801. will be deleted.
  29802. It is set by the controller which creates the generator state and
  29803. can be set configured by the user.
  29804. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  29805. </td>
  29806. </tr>
  29807. <tr>
  29808. <td>
  29809. <code>resource</code></br>
  29810. <em>
  29811. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29812. </em>
  29813. </td>
  29814. <td>
  29815. <p>Resource is the generator manifest that produced the state.
  29816. It is a snapshot of the generator manifest at the time the state was produced.
  29817. This manifest will be used to delete the resource. Any configuration that is referenced
  29818. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  29819. be blocked by a finalizer.</p>
  29820. </td>
  29821. </tr>
  29822. <tr>
  29823. <td>
  29824. <code>state</code></br>
  29825. <em>
  29826. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29827. </em>
  29828. </td>
  29829. <td>
  29830. <p>State is the state that was produced by the generator implementation.</p>
  29831. </td>
  29832. </tr>
  29833. </tbody>
  29834. </table>
  29835. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus
  29836. </h3>
  29837. <p>
  29838. (<em>Appears on:</em>
  29839. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  29840. </p>
  29841. <p>
  29842. <p>GeneratorStateStatus defines the observed state of a generator state resource.</p>
  29843. </p>
  29844. <table>
  29845. <thead>
  29846. <tr>
  29847. <th>Field</th>
  29848. <th>Description</th>
  29849. </tr>
  29850. </thead>
  29851. <tbody>
  29852. <tr>
  29853. <td>
  29854. <code>conditions</code></br>
  29855. <em>
  29856. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">
  29857. []GeneratorStateStatusCondition
  29858. </a>
  29859. </em>
  29860. </td>
  29861. <td>
  29862. </td>
  29863. </tr>
  29864. </tbody>
  29865. </table>
  29866. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition
  29867. </h3>
  29868. <p>
  29869. (<em>Appears on:</em>
  29870. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus</a>)
  29871. </p>
  29872. <p>
  29873. <p>GeneratorStateStatusCondition represents the observed condition of a generator state.</p>
  29874. </p>
  29875. <table>
  29876. <thead>
  29877. <tr>
  29878. <th>Field</th>
  29879. <th>Description</th>
  29880. </tr>
  29881. </thead>
  29882. <tbody>
  29883. <tr>
  29884. <td>
  29885. <code>type</code></br>
  29886. <em>
  29887. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">
  29888. GeneratorStateConditionType
  29889. </a>
  29890. </em>
  29891. </td>
  29892. <td>
  29893. </td>
  29894. </tr>
  29895. <tr>
  29896. <td>
  29897. <code>status</code></br>
  29898. <em>
  29899. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  29900. Kubernetes core/v1.ConditionStatus
  29901. </a>
  29902. </em>
  29903. </td>
  29904. <td>
  29905. </td>
  29906. </tr>
  29907. <tr>
  29908. <td>
  29909. <code>reason</code></br>
  29910. <em>
  29911. string
  29912. </em>
  29913. </td>
  29914. <td>
  29915. <em>(Optional)</em>
  29916. </td>
  29917. </tr>
  29918. <tr>
  29919. <td>
  29920. <code>message</code></br>
  29921. <em>
  29922. string
  29923. </em>
  29924. </td>
  29925. <td>
  29926. <em>(Optional)</em>
  29927. </td>
  29928. </tr>
  29929. <tr>
  29930. <td>
  29931. <code>lastTransitionTime</code></br>
  29932. <em>
  29933. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29934. Kubernetes meta/v1.Time
  29935. </a>
  29936. </em>
  29937. </td>
  29938. <td>
  29939. <em>(Optional)</em>
  29940. </td>
  29941. </tr>
  29942. </tbody>
  29943. </table>
  29944. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken
  29945. </h3>
  29946. <p>
  29947. <p>GithubAccessToken generates ghs_ accessToken</p>
  29948. </p>
  29949. <table>
  29950. <thead>
  29951. <tr>
  29952. <th>Field</th>
  29953. <th>Description</th>
  29954. </tr>
  29955. </thead>
  29956. <tbody>
  29957. <tr>
  29958. <td>
  29959. <code>metadata</code></br>
  29960. <em>
  29961. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29962. Kubernetes meta/v1.ObjectMeta
  29963. </a>
  29964. </em>
  29965. </td>
  29966. <td>
  29967. Refer to the Kubernetes API documentation for the fields of the
  29968. <code>metadata</code> field.
  29969. </td>
  29970. </tr>
  29971. <tr>
  29972. <td>
  29973. <code>spec</code></br>
  29974. <em>
  29975. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  29976. GithubAccessTokenSpec
  29977. </a>
  29978. </em>
  29979. </td>
  29980. <td>
  29981. <br/>
  29982. <br/>
  29983. <table>
  29984. <tr>
  29985. <td>
  29986. <code>url</code></br>
  29987. <em>
  29988. string
  29989. </em>
  29990. </td>
  29991. <td>
  29992. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  29993. </td>
  29994. </tr>
  29995. <tr>
  29996. <td>
  29997. <code>appID</code></br>
  29998. <em>
  29999. string
  30000. </em>
  30001. </td>
  30002. <td>
  30003. </td>
  30004. </tr>
  30005. <tr>
  30006. <td>
  30007. <code>installID</code></br>
  30008. <em>
  30009. string
  30010. </em>
  30011. </td>
  30012. <td>
  30013. </td>
  30014. </tr>
  30015. <tr>
  30016. <td>
  30017. <code>repositories</code></br>
  30018. <em>
  30019. []string
  30020. </em>
  30021. </td>
  30022. <td>
  30023. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  30024. is installed to.</p>
  30025. </td>
  30026. </tr>
  30027. <tr>
  30028. <td>
  30029. <code>permissions</code></br>
  30030. <em>
  30031. map[string]string
  30032. </em>
  30033. </td>
  30034. <td>
  30035. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  30036. </td>
  30037. </tr>
  30038. <tr>
  30039. <td>
  30040. <code>auth</code></br>
  30041. <em>
  30042. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  30043. GithubAuth
  30044. </a>
  30045. </em>
  30046. </td>
  30047. <td>
  30048. <p>Auth configures how ESO authenticates with a Github instance.</p>
  30049. </td>
  30050. </tr>
  30051. </table>
  30052. </td>
  30053. </tr>
  30054. </tbody>
  30055. </table>
  30056. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec
  30057. </h3>
  30058. <p>
  30059. (<em>Appears on:</em>
  30060. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30061. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken</a>)
  30062. </p>
  30063. <p>
  30064. <p>GithubAccessTokenSpec defines the desired state to generate a GitHub access token.</p>
  30065. </p>
  30066. <table>
  30067. <thead>
  30068. <tr>
  30069. <th>Field</th>
  30070. <th>Description</th>
  30071. </tr>
  30072. </thead>
  30073. <tbody>
  30074. <tr>
  30075. <td>
  30076. <code>url</code></br>
  30077. <em>
  30078. string
  30079. </em>
  30080. </td>
  30081. <td>
  30082. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  30083. </td>
  30084. </tr>
  30085. <tr>
  30086. <td>
  30087. <code>appID</code></br>
  30088. <em>
  30089. string
  30090. </em>
  30091. </td>
  30092. <td>
  30093. </td>
  30094. </tr>
  30095. <tr>
  30096. <td>
  30097. <code>installID</code></br>
  30098. <em>
  30099. string
  30100. </em>
  30101. </td>
  30102. <td>
  30103. </td>
  30104. </tr>
  30105. <tr>
  30106. <td>
  30107. <code>repositories</code></br>
  30108. <em>
  30109. []string
  30110. </em>
  30111. </td>
  30112. <td>
  30113. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  30114. is installed to.</p>
  30115. </td>
  30116. </tr>
  30117. <tr>
  30118. <td>
  30119. <code>permissions</code></br>
  30120. <em>
  30121. map[string]string
  30122. </em>
  30123. </td>
  30124. <td>
  30125. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  30126. </td>
  30127. </tr>
  30128. <tr>
  30129. <td>
  30130. <code>auth</code></br>
  30131. <em>
  30132. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  30133. GithubAuth
  30134. </a>
  30135. </em>
  30136. </td>
  30137. <td>
  30138. <p>Auth configures how ESO authenticates with a Github instance.</p>
  30139. </td>
  30140. </tr>
  30141. </tbody>
  30142. </table>
  30143. <h3 id="generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth
  30144. </h3>
  30145. <p>
  30146. (<em>Appears on:</em>
  30147. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec</a>)
  30148. </p>
  30149. <p>
  30150. <p>GithubAuth defines the authentication configuration for GitHub access.</p>
  30151. </p>
  30152. <table>
  30153. <thead>
  30154. <tr>
  30155. <th>Field</th>
  30156. <th>Description</th>
  30157. </tr>
  30158. </thead>
  30159. <tbody>
  30160. <tr>
  30161. <td>
  30162. <code>privateKey</code></br>
  30163. <em>
  30164. <a href="#generators.external-secrets.io/v1alpha1.GithubSecretRef">
  30165. GithubSecretRef
  30166. </a>
  30167. </em>
  30168. </td>
  30169. <td>
  30170. </td>
  30171. </tr>
  30172. </tbody>
  30173. </table>
  30174. <h3 id="generators.external-secrets.io/v1alpha1.GithubSecretRef">GithubSecretRef
  30175. </h3>
  30176. <p>
  30177. (<em>Appears on:</em>
  30178. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth</a>)
  30179. </p>
  30180. <p>
  30181. <p>GithubSecretRef references a secret containing GitHub credentials.</p>
  30182. </p>
  30183. <table>
  30184. <thead>
  30185. <tr>
  30186. <th>Field</th>
  30187. <th>Description</th>
  30188. </tr>
  30189. </thead>
  30190. <tbody>
  30191. <tr>
  30192. <td>
  30193. <code>secretRef</code></br>
  30194. <em>
  30195. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30196. External Secrets meta/v1.SecretKeySelector
  30197. </a>
  30198. </em>
  30199. </td>
  30200. <td>
  30201. </td>
  30202. </tr>
  30203. </tbody>
  30204. </table>
  30205. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployToken">GitlabDeployToken
  30206. </h3>
  30207. <p>
  30208. <p>GitlabDeployToken generates a GitLab deploy token.</p>
  30209. </p>
  30210. <table>
  30211. <thead>
  30212. <tr>
  30213. <th>Field</th>
  30214. <th>Description</th>
  30215. </tr>
  30216. </thead>
  30217. <tbody>
  30218. <tr>
  30219. <td>
  30220. <code>metadata</code></br>
  30221. <em>
  30222. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30223. Kubernetes meta/v1.ObjectMeta
  30224. </a>
  30225. </em>
  30226. </td>
  30227. <td>
  30228. Refer to the Kubernetes API documentation for the fields of the
  30229. <code>metadata</code> field.
  30230. </td>
  30231. </tr>
  30232. <tr>
  30233. <td>
  30234. <code>spec</code></br>
  30235. <em>
  30236. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">
  30237. GitlabDeployTokenSpec
  30238. </a>
  30239. </em>
  30240. </td>
  30241. <td>
  30242. <br/>
  30243. <br/>
  30244. <table>
  30245. <tr>
  30246. <td>
  30247. <code>url</code></br>
  30248. <em>
  30249. string
  30250. </em>
  30251. </td>
  30252. <td>
  30253. <em>(Optional)</em>
  30254. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com">https://gitlab.com</a>.</p>
  30255. </td>
  30256. </tr>
  30257. <tr>
  30258. <td>
  30259. <code>projectID</code></br>
  30260. <em>
  30261. string
  30262. </em>
  30263. </td>
  30264. <td>
  30265. <em>(Optional)</em>
  30266. <p>ProjectID is the numeric ID or unescaped path (e.g. group/project) of the
  30267. project to create the deploy token in. The generator URL-escapes paths before
  30268. calling the GitLab API, so do not pre-encode. Mutually exclusive with groupID.</p>
  30269. </td>
  30270. </tr>
  30271. <tr>
  30272. <td>
  30273. <code>groupID</code></br>
  30274. <em>
  30275. string
  30276. </em>
  30277. </td>
  30278. <td>
  30279. <em>(Optional)</em>
  30280. <p>GroupID is the numeric ID or unescaped path (e.g. parent/group) of the group to
  30281. create the deploy token in. The generator URL-escapes paths before calling the
  30282. GitLab API, so do not pre-encode. Mutually exclusive with projectID.</p>
  30283. </td>
  30284. </tr>
  30285. <tr>
  30286. <td>
  30287. <code>name</code></br>
  30288. <em>
  30289. string
  30290. </em>
  30291. </td>
  30292. <td>
  30293. <p>Name of the deploy token.</p>
  30294. </td>
  30295. </tr>
  30296. <tr>
  30297. <td>
  30298. <code>scopes</code></br>
  30299. <em>
  30300. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">
  30301. []GitlabDeployTokenScope
  30302. </a>
  30303. </em>
  30304. </td>
  30305. <td>
  30306. <p>Scopes granted to the deploy token. At least one scope is required.</p>
  30307. </td>
  30308. </tr>
  30309. <tr>
  30310. <td>
  30311. <code>expiresAt</code></br>
  30312. <em>
  30313. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  30314. Kubernetes meta/v1.Time
  30315. </a>
  30316. </em>
  30317. </td>
  30318. <td>
  30319. <em>(Optional)</em>
  30320. <p>ExpiresAt is an optional expiry for the deploy token. If omitted the token does
  30321. not expire on the GitLab side and is revoked only when the generator state is
  30322. cleaned up (on regeneration or when the consuming ExternalSecret is deleted).</p>
  30323. </td>
  30324. </tr>
  30325. <tr>
  30326. <td>
  30327. <code>username</code></br>
  30328. <em>
  30329. string
  30330. </em>
  30331. </td>
  30332. <td>
  30333. <em>(Optional)</em>
  30334. <p>Username is an optional username for the deploy token. GitLab defaults it to
  30335. gitlab+deploy-token-{n} when omitted.</p>
  30336. </td>
  30337. </tr>
  30338. <tr>
  30339. <td>
  30340. <code>auth</code></br>
  30341. <em>
  30342. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">
  30343. GitlabDeployTokenAuth
  30344. </a>
  30345. </em>
  30346. </td>
  30347. <td>
  30348. <p>Auth configures how ESO authenticates with the GitLab API.</p>
  30349. </td>
  30350. </tr>
  30351. </table>
  30352. </td>
  30353. </tr>
  30354. </tbody>
  30355. </table>
  30356. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">GitlabDeployTokenAuth
  30357. </h3>
  30358. <p>
  30359. (<em>Appears on:</em>
  30360. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec</a>)
  30361. </p>
  30362. <p>
  30363. <p>GitlabDeployTokenAuth defines the authentication configuration for the GitLab API.</p>
  30364. </p>
  30365. <table>
  30366. <thead>
  30367. <tr>
  30368. <th>Field</th>
  30369. <th>Description</th>
  30370. </tr>
  30371. </thead>
  30372. <tbody>
  30373. <tr>
  30374. <td>
  30375. <code>token</code></br>
  30376. <em>
  30377. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSecretRef">
  30378. GitlabDeployTokenSecretRef
  30379. </a>
  30380. </em>
  30381. </td>
  30382. <td>
  30383. <p>Token references a secret containing a GitLab access token (personal, group, or
  30384. project) with the api scope and at least the Maintainer role on the target.</p>
  30385. </td>
  30386. </tr>
  30387. </tbody>
  30388. </table>
  30389. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">GitlabDeployTokenScope
  30390. (<code>string</code> alias)</p></h3>
  30391. <p>
  30392. (<em>Appears on:</em>
  30393. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec</a>)
  30394. </p>
  30395. <p>
  30396. <p>GitlabDeployTokenScope is a scope that can be granted to a GitLab deploy token.</p>
  30397. </p>
  30398. <table>
  30399. <thead>
  30400. <tr>
  30401. <th>Value</th>
  30402. <th>Description</th>
  30403. </tr>
  30404. </thead>
  30405. <tbody><tr><td><p>&#34;read_package_registry&#34;</p></td>
  30406. <td><p>GitlabDeployTokenScopeReadPackageRegistry allows read access to the package registry.</p>
  30407. </td>
  30408. </tr><tr><td><p>&#34;read_registry&#34;</p></td>
  30409. <td><p>GitlabDeployTokenScopeReadRegistry allows read access to the container registry.</p>
  30410. </td>
  30411. </tr><tr><td><p>&#34;read_repository&#34;</p></td>
  30412. <td><p>GitlabDeployTokenScopeReadRepository allows read access to the repository.</p>
  30413. </td>
  30414. </tr><tr><td><p>&#34;read_virtual_registry&#34;</p></td>
  30415. <td><p>GitlabDeployTokenScopeReadVirtualRegistry allows read access to the virtual registry (projects only).</p>
  30416. </td>
  30417. </tr><tr><td><p>&#34;write_package_registry&#34;</p></td>
  30418. <td><p>GitlabDeployTokenScopeWritePackageRegistry allows write access to the package registry.</p>
  30419. </td>
  30420. </tr><tr><td><p>&#34;write_registry&#34;</p></td>
  30421. <td><p>GitlabDeployTokenScopeWriteRegistry allows write access to the container registry.</p>
  30422. </td>
  30423. </tr><tr><td><p>&#34;write_virtual_registry&#34;</p></td>
  30424. <td><p>GitlabDeployTokenScopeWriteVirtualRegistry allows write access to the virtual registry (projects only).</p>
  30425. </td>
  30426. </tr></tbody>
  30427. </table>
  30428. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenSecretRef">GitlabDeployTokenSecretRef
  30429. </h3>
  30430. <p>
  30431. (<em>Appears on:</em>
  30432. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">GitlabDeployTokenAuth</a>)
  30433. </p>
  30434. <p>
  30435. <p>GitlabDeployTokenSecretRef references a secret containing a GitLab access token.</p>
  30436. </p>
  30437. <table>
  30438. <thead>
  30439. <tr>
  30440. <th>Field</th>
  30441. <th>Description</th>
  30442. </tr>
  30443. </thead>
  30444. <tbody>
  30445. <tr>
  30446. <td>
  30447. <code>secretRef</code></br>
  30448. <em>
  30449. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30450. External Secrets meta/v1.SecretKeySelector
  30451. </a>
  30452. </em>
  30453. </td>
  30454. <td>
  30455. </td>
  30456. </tr>
  30457. </tbody>
  30458. </table>
  30459. <h3 id="generators.external-secrets.io/v1alpha1.GitlabDeployTokenSpec">GitlabDeployTokenSpec
  30460. </h3>
  30461. <p>
  30462. (<em>Appears on:</em>
  30463. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30464. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployToken">GitlabDeployToken</a>)
  30465. </p>
  30466. <p>
  30467. <p>GitlabDeployTokenSpec defines the desired state to generate a GitLab deploy token.</p>
  30468. </p>
  30469. <table>
  30470. <thead>
  30471. <tr>
  30472. <th>Field</th>
  30473. <th>Description</th>
  30474. </tr>
  30475. </thead>
  30476. <tbody>
  30477. <tr>
  30478. <td>
  30479. <code>url</code></br>
  30480. <em>
  30481. string
  30482. </em>
  30483. </td>
  30484. <td>
  30485. <em>(Optional)</em>
  30486. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com">https://gitlab.com</a>.</p>
  30487. </td>
  30488. </tr>
  30489. <tr>
  30490. <td>
  30491. <code>projectID</code></br>
  30492. <em>
  30493. string
  30494. </em>
  30495. </td>
  30496. <td>
  30497. <em>(Optional)</em>
  30498. <p>ProjectID is the numeric ID or unescaped path (e.g. group/project) of the
  30499. project to create the deploy token in. The generator URL-escapes paths before
  30500. calling the GitLab API, so do not pre-encode. Mutually exclusive with groupID.</p>
  30501. </td>
  30502. </tr>
  30503. <tr>
  30504. <td>
  30505. <code>groupID</code></br>
  30506. <em>
  30507. string
  30508. </em>
  30509. </td>
  30510. <td>
  30511. <em>(Optional)</em>
  30512. <p>GroupID is the numeric ID or unescaped path (e.g. parent/group) of the group to
  30513. create the deploy token in. The generator URL-escapes paths before calling the
  30514. GitLab API, so do not pre-encode. Mutually exclusive with projectID.</p>
  30515. </td>
  30516. </tr>
  30517. <tr>
  30518. <td>
  30519. <code>name</code></br>
  30520. <em>
  30521. string
  30522. </em>
  30523. </td>
  30524. <td>
  30525. <p>Name of the deploy token.</p>
  30526. </td>
  30527. </tr>
  30528. <tr>
  30529. <td>
  30530. <code>scopes</code></br>
  30531. <em>
  30532. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenScope">
  30533. []GitlabDeployTokenScope
  30534. </a>
  30535. </em>
  30536. </td>
  30537. <td>
  30538. <p>Scopes granted to the deploy token. At least one scope is required.</p>
  30539. </td>
  30540. </tr>
  30541. <tr>
  30542. <td>
  30543. <code>expiresAt</code></br>
  30544. <em>
  30545. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  30546. Kubernetes meta/v1.Time
  30547. </a>
  30548. </em>
  30549. </td>
  30550. <td>
  30551. <em>(Optional)</em>
  30552. <p>ExpiresAt is an optional expiry for the deploy token. If omitted the token does
  30553. not expire on the GitLab side and is revoked only when the generator state is
  30554. cleaned up (on regeneration or when the consuming ExternalSecret is deleted).</p>
  30555. </td>
  30556. </tr>
  30557. <tr>
  30558. <td>
  30559. <code>username</code></br>
  30560. <em>
  30561. string
  30562. </em>
  30563. </td>
  30564. <td>
  30565. <em>(Optional)</em>
  30566. <p>Username is an optional username for the deploy token. GitLab defaults it to
  30567. gitlab+deploy-token-{n} when omitted.</p>
  30568. </td>
  30569. </tr>
  30570. <tr>
  30571. <td>
  30572. <code>auth</code></br>
  30573. <em>
  30574. <a href="#generators.external-secrets.io/v1alpha1.GitlabDeployTokenAuth">
  30575. GitlabDeployTokenAuth
  30576. </a>
  30577. </em>
  30578. </td>
  30579. <td>
  30580. <p>Auth configures how ESO authenticates with the GitLab API.</p>
  30581. </td>
  30582. </tr>
  30583. </tbody>
  30584. </table>
  30585. <h3 id="generators.external-secrets.io/v1alpha1.Grafana">Grafana
  30586. </h3>
  30587. <p>
  30588. <p>Grafana represents a generator for Grafana service account tokens.</p>
  30589. </p>
  30590. <table>
  30591. <thead>
  30592. <tr>
  30593. <th>Field</th>
  30594. <th>Description</th>
  30595. </tr>
  30596. </thead>
  30597. <tbody>
  30598. <tr>
  30599. <td>
  30600. <code>metadata</code></br>
  30601. <em>
  30602. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30603. Kubernetes meta/v1.ObjectMeta
  30604. </a>
  30605. </em>
  30606. </td>
  30607. <td>
  30608. Refer to the Kubernetes API documentation for the fields of the
  30609. <code>metadata</code> field.
  30610. </td>
  30611. </tr>
  30612. <tr>
  30613. <td>
  30614. <code>spec</code></br>
  30615. <em>
  30616. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  30617. GrafanaSpec
  30618. </a>
  30619. </em>
  30620. </td>
  30621. <td>
  30622. <br/>
  30623. <br/>
  30624. <table>
  30625. <tr>
  30626. <td>
  30627. <code>url</code></br>
  30628. <em>
  30629. string
  30630. </em>
  30631. </td>
  30632. <td>
  30633. <p>URL is the URL of the Grafana instance.</p>
  30634. </td>
  30635. </tr>
  30636. <tr>
  30637. <td>
  30638. <code>auth</code></br>
  30639. <em>
  30640. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  30641. GrafanaAuth
  30642. </a>
  30643. </em>
  30644. </td>
  30645. <td>
  30646. <p>Auth is the authentication configuration to authenticate
  30647. against the Grafana instance.</p>
  30648. </td>
  30649. </tr>
  30650. <tr>
  30651. <td>
  30652. <code>serviceAccount</code></br>
  30653. <em>
  30654. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  30655. GrafanaServiceAccount
  30656. </a>
  30657. </em>
  30658. </td>
  30659. <td>
  30660. <p>ServiceAccount is the configuration for the service account that
  30661. is supposed to be generated by the generator.</p>
  30662. </td>
  30663. </tr>
  30664. </table>
  30665. </td>
  30666. </tr>
  30667. </tbody>
  30668. </table>
  30669. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth
  30670. </h3>
  30671. <p>
  30672. (<em>Appears on:</em>
  30673. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  30674. </p>
  30675. <p>
  30676. <p>GrafanaAuth defines the authentication methods for connecting to a Grafana instance.</p>
  30677. </p>
  30678. <table>
  30679. <thead>
  30680. <tr>
  30681. <th>Field</th>
  30682. <th>Description</th>
  30683. </tr>
  30684. </thead>
  30685. <tbody>
  30686. <tr>
  30687. <td>
  30688. <code>token</code></br>
  30689. <em>
  30690. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  30691. SecretKeySelector
  30692. </a>
  30693. </em>
  30694. </td>
  30695. <td>
  30696. <em>(Optional)</em>
  30697. <p>A service account token used to authenticate against the Grafana instance.
  30698. Note: you need a token which has elevated permissions to create service accounts.
  30699. See here for the documentation on basic roles offered by Grafana:
  30700. <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>
  30701. </td>
  30702. </tr>
  30703. <tr>
  30704. <td>
  30705. <code>basic</code></br>
  30706. <em>
  30707. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">
  30708. GrafanaBasicAuth
  30709. </a>
  30710. </em>
  30711. </td>
  30712. <td>
  30713. <em>(Optional)</em>
  30714. <p>Basic auth credentials used to authenticate against the Grafana instance.
  30715. Note: you need a token which has elevated permissions to create service accounts.
  30716. See here for the documentation on basic roles offered by Grafana:
  30717. <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>
  30718. </td>
  30719. </tr>
  30720. </tbody>
  30721. </table>
  30722. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth
  30723. </h3>
  30724. <p>
  30725. (<em>Appears on:</em>
  30726. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>)
  30727. </p>
  30728. <p>
  30729. <p>GrafanaBasicAuth defines the credentials for basic authentication with Grafana.</p>
  30730. </p>
  30731. <table>
  30732. <thead>
  30733. <tr>
  30734. <th>Field</th>
  30735. <th>Description</th>
  30736. </tr>
  30737. </thead>
  30738. <tbody>
  30739. <tr>
  30740. <td>
  30741. <code>username</code></br>
  30742. <em>
  30743. string
  30744. </em>
  30745. </td>
  30746. <td>
  30747. <p>A basic auth username used to authenticate against the Grafana instance.</p>
  30748. </td>
  30749. </tr>
  30750. <tr>
  30751. <td>
  30752. <code>password</code></br>
  30753. <em>
  30754. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  30755. SecretKeySelector
  30756. </a>
  30757. </em>
  30758. </td>
  30759. <td>
  30760. <p>A basic auth password used to authenticate against the Grafana instance.</p>
  30761. </td>
  30762. </tr>
  30763. </tbody>
  30764. </table>
  30765. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">GrafanaServiceAccount
  30766. </h3>
  30767. <p>
  30768. (<em>Appears on:</em>
  30769. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  30770. </p>
  30771. <p>
  30772. <p>GrafanaServiceAccount defines the configuration for a Grafana service account to be created.</p>
  30773. </p>
  30774. <table>
  30775. <thead>
  30776. <tr>
  30777. <th>Field</th>
  30778. <th>Description</th>
  30779. </tr>
  30780. </thead>
  30781. <tbody>
  30782. <tr>
  30783. <td>
  30784. <code>name</code></br>
  30785. <em>
  30786. string
  30787. </em>
  30788. </td>
  30789. <td>
  30790. <p>Name is the name of the service account that will be created by ESO.</p>
  30791. </td>
  30792. </tr>
  30793. <tr>
  30794. <td>
  30795. <code>role</code></br>
  30796. <em>
  30797. string
  30798. </em>
  30799. </td>
  30800. <td>
  30801. <p>Role is the role of the service account.
  30802. See here for the documentation on basic roles offered by Grafana:
  30803. <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>
  30804. </td>
  30805. </tr>
  30806. <tr>
  30807. <td>
  30808. <code>secondsToLive</code></br>
  30809. <em>
  30810. int64
  30811. </em>
  30812. </td>
  30813. <td>
  30814. <em>(Optional)</em>
  30815. <p>SecondsToLive is the number of seconds before the generated service account token will expire.
  30816. Some Grafana deployments (e.g. AWS Managed Grafana) require this value to be set.</p>
  30817. </td>
  30818. </tr>
  30819. </tbody>
  30820. </table>
  30821. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState
  30822. </h3>
  30823. <p>
  30824. <p>GrafanaServiceAccountTokenState is the state type produced by the Grafana generator.
  30825. It contains the service account ID, login and token ID which is enough to
  30826. identify the service account.</p>
  30827. </p>
  30828. <table>
  30829. <thead>
  30830. <tr>
  30831. <th>Field</th>
  30832. <th>Description</th>
  30833. </tr>
  30834. </thead>
  30835. <tbody>
  30836. <tr>
  30837. <td>
  30838. <code>serviceAccount</code></br>
  30839. <em>
  30840. <a href="#generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">
  30841. GrafanaStateServiceAccount
  30842. </a>
  30843. </em>
  30844. </td>
  30845. <td>
  30846. </td>
  30847. </tr>
  30848. </tbody>
  30849. </table>
  30850. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec
  30851. </h3>
  30852. <p>
  30853. (<em>Appears on:</em>
  30854. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30855. <a href="#generators.external-secrets.io/v1alpha1.Grafana">Grafana</a>)
  30856. </p>
  30857. <p>
  30858. <p>GrafanaSpec controls the behavior of the grafana generator.</p>
  30859. </p>
  30860. <table>
  30861. <thead>
  30862. <tr>
  30863. <th>Field</th>
  30864. <th>Description</th>
  30865. </tr>
  30866. </thead>
  30867. <tbody>
  30868. <tr>
  30869. <td>
  30870. <code>url</code></br>
  30871. <em>
  30872. string
  30873. </em>
  30874. </td>
  30875. <td>
  30876. <p>URL is the URL of the Grafana instance.</p>
  30877. </td>
  30878. </tr>
  30879. <tr>
  30880. <td>
  30881. <code>auth</code></br>
  30882. <em>
  30883. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  30884. GrafanaAuth
  30885. </a>
  30886. </em>
  30887. </td>
  30888. <td>
  30889. <p>Auth is the authentication configuration to authenticate
  30890. against the Grafana instance.</p>
  30891. </td>
  30892. </tr>
  30893. <tr>
  30894. <td>
  30895. <code>serviceAccount</code></br>
  30896. <em>
  30897. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  30898. GrafanaServiceAccount
  30899. </a>
  30900. </em>
  30901. </td>
  30902. <td>
  30903. <p>ServiceAccount is the configuration for the service account that
  30904. is supposed to be generated by the generator.</p>
  30905. </td>
  30906. </tr>
  30907. </tbody>
  30908. </table>
  30909. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">GrafanaStateServiceAccount
  30910. </h3>
  30911. <p>
  30912. (<em>Appears on:</em>
  30913. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState</a>)
  30914. </p>
  30915. <p>
  30916. <p>GrafanaStateServiceAccount contains the service account ID, login and token ID.</p>
  30917. </p>
  30918. <table>
  30919. <thead>
  30920. <tr>
  30921. <th>Field</th>
  30922. <th>Description</th>
  30923. </tr>
  30924. </thead>
  30925. <tbody>
  30926. <tr>
  30927. <td>
  30928. <code>id</code></br>
  30929. <em>
  30930. int64
  30931. </em>
  30932. </td>
  30933. <td>
  30934. </td>
  30935. </tr>
  30936. <tr>
  30937. <td>
  30938. <code>login</code></br>
  30939. <em>
  30940. string
  30941. </em>
  30942. </td>
  30943. <td>
  30944. </td>
  30945. </tr>
  30946. <tr>
  30947. <td>
  30948. <code>tokenID</code></br>
  30949. <em>
  30950. int64
  30951. </em>
  30952. </td>
  30953. <td>
  30954. </td>
  30955. </tr>
  30956. </tbody>
  30957. </table>
  30958. <h3 id="generators.external-secrets.io/v1alpha1.MFA">MFA
  30959. </h3>
  30960. <p>
  30961. <p>MFA generates a new TOTP token that is compliant with RFC 6238.</p>
  30962. </p>
  30963. <table>
  30964. <thead>
  30965. <tr>
  30966. <th>Field</th>
  30967. <th>Description</th>
  30968. </tr>
  30969. </thead>
  30970. <tbody>
  30971. <tr>
  30972. <td>
  30973. <code>metadata</code></br>
  30974. <em>
  30975. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30976. Kubernetes meta/v1.ObjectMeta
  30977. </a>
  30978. </em>
  30979. </td>
  30980. <td>
  30981. Refer to the Kubernetes API documentation for the fields of the
  30982. <code>metadata</code> field.
  30983. </td>
  30984. </tr>
  30985. <tr>
  30986. <td>
  30987. <code>spec</code></br>
  30988. <em>
  30989. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  30990. MFASpec
  30991. </a>
  30992. </em>
  30993. </td>
  30994. <td>
  30995. <br/>
  30996. <br/>
  30997. <table>
  30998. <tr>
  30999. <td>
  31000. <code>secret</code></br>
  31001. <em>
  31002. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  31003. External Secrets meta/v1.SecretKeySelector
  31004. </a>
  31005. </em>
  31006. </td>
  31007. <td>
  31008. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  31009. </td>
  31010. </tr>
  31011. <tr>
  31012. <td>
  31013. <code>length</code></br>
  31014. <em>
  31015. int
  31016. </em>
  31017. </td>
  31018. <td>
  31019. <p>Length defines the token length. Defaults to 6 characters.</p>
  31020. </td>
  31021. </tr>
  31022. <tr>
  31023. <td>
  31024. <code>timePeriod</code></br>
  31025. <em>
  31026. int
  31027. </em>
  31028. </td>
  31029. <td>
  31030. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  31031. </td>
  31032. </tr>
  31033. <tr>
  31034. <td>
  31035. <code>algorithm</code></br>
  31036. <em>
  31037. string
  31038. </em>
  31039. </td>
  31040. <td>
  31041. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  31042. </td>
  31043. </tr>
  31044. <tr>
  31045. <td>
  31046. <code>when</code></br>
  31047. <em>
  31048. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  31049. Kubernetes meta/v1.Time
  31050. </a>
  31051. </em>
  31052. </td>
  31053. <td>
  31054. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  31055. </td>
  31056. </tr>
  31057. </table>
  31058. </td>
  31059. </tr>
  31060. </tbody>
  31061. </table>
  31062. <h3 id="generators.external-secrets.io/v1alpha1.MFASpec">MFASpec
  31063. </h3>
  31064. <p>
  31065. (<em>Appears on:</em>
  31066. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31067. <a href="#generators.external-secrets.io/v1alpha1.MFA">MFA</a>)
  31068. </p>
  31069. <p>
  31070. <p>MFASpec controls the behavior of the mfa generator.</p>
  31071. </p>
  31072. <table>
  31073. <thead>
  31074. <tr>
  31075. <th>Field</th>
  31076. <th>Description</th>
  31077. </tr>
  31078. </thead>
  31079. <tbody>
  31080. <tr>
  31081. <td>
  31082. <code>secret</code></br>
  31083. <em>
  31084. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  31085. External Secrets meta/v1.SecretKeySelector
  31086. </a>
  31087. </em>
  31088. </td>
  31089. <td>
  31090. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  31091. </td>
  31092. </tr>
  31093. <tr>
  31094. <td>
  31095. <code>length</code></br>
  31096. <em>
  31097. int
  31098. </em>
  31099. </td>
  31100. <td>
  31101. <p>Length defines the token length. Defaults to 6 characters.</p>
  31102. </td>
  31103. </tr>
  31104. <tr>
  31105. <td>
  31106. <code>timePeriod</code></br>
  31107. <em>
  31108. int
  31109. </em>
  31110. </td>
  31111. <td>
  31112. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  31113. </td>
  31114. </tr>
  31115. <tr>
  31116. <td>
  31117. <code>algorithm</code></br>
  31118. <em>
  31119. string
  31120. </em>
  31121. </td>
  31122. <td>
  31123. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  31124. </td>
  31125. </tr>
  31126. <tr>
  31127. <td>
  31128. <code>when</code></br>
  31129. <em>
  31130. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  31131. Kubernetes meta/v1.Time
  31132. </a>
  31133. </em>
  31134. </td>
  31135. <td>
  31136. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  31137. </td>
  31138. </tr>
  31139. </tbody>
  31140. </table>
  31141. <h3 id="generators.external-secrets.io/v1alpha1.NTLMProtocol">NTLMProtocol
  31142. </h3>
  31143. <p>
  31144. (<em>Appears on:</em>
  31145. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol</a>)
  31146. </p>
  31147. <p>
  31148. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  31149. </p>
  31150. <table>
  31151. <thead>
  31152. <tr>
  31153. <th>Field</th>
  31154. <th>Description</th>
  31155. </tr>
  31156. </thead>
  31157. <tbody>
  31158. <tr>
  31159. <td>
  31160. <code>usernameSecret</code></br>
  31161. <em>
  31162. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  31163. External Secrets meta/v1.SecretKeySelector
  31164. </a>
  31165. </em>
  31166. </td>
  31167. <td>
  31168. </td>
  31169. </tr>
  31170. <tr>
  31171. <td>
  31172. <code>passwordSecret</code></br>
  31173. <em>
  31174. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  31175. External Secrets meta/v1.SecretKeySelector
  31176. </a>
  31177. </em>
  31178. </td>
  31179. <td>
  31180. </td>
  31181. </tr>
  31182. </tbody>
  31183. </table>
  31184. <h3 id="generators.external-secrets.io/v1alpha1.Password">Password
  31185. </h3>
  31186. <p>
  31187. <p>Password generates a random password based on the
  31188. configuration parameters in spec.
  31189. You can specify the length, characterset and other attributes.</p>
  31190. </p>
  31191. <table>
  31192. <thead>
  31193. <tr>
  31194. <th>Field</th>
  31195. <th>Description</th>
  31196. </tr>
  31197. </thead>
  31198. <tbody>
  31199. <tr>
  31200. <td>
  31201. <code>metadata</code></br>
  31202. <em>
  31203. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31204. Kubernetes meta/v1.ObjectMeta
  31205. </a>
  31206. </em>
  31207. </td>
  31208. <td>
  31209. Refer to the Kubernetes API documentation for the fields of the
  31210. <code>metadata</code> field.
  31211. </td>
  31212. </tr>
  31213. <tr>
  31214. <td>
  31215. <code>spec</code></br>
  31216. <em>
  31217. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  31218. PasswordSpec
  31219. </a>
  31220. </em>
  31221. </td>
  31222. <td>
  31223. <br/>
  31224. <br/>
  31225. <table>
  31226. <tr>
  31227. <td>
  31228. <code>length</code></br>
  31229. <em>
  31230. int
  31231. </em>
  31232. </td>
  31233. <td>
  31234. <p>Length of the password to be generated.
  31235. Defaults to 24</p>
  31236. </td>
  31237. </tr>
  31238. <tr>
  31239. <td>
  31240. <code>digits</code></br>
  31241. <em>
  31242. int
  31243. </em>
  31244. </td>
  31245. <td>
  31246. <p>Digits specifies the number of digits in the generated
  31247. password. If omitted it defaults to 25% of the length of the password</p>
  31248. </td>
  31249. </tr>
  31250. <tr>
  31251. <td>
  31252. <code>symbols</code></br>
  31253. <em>
  31254. int
  31255. </em>
  31256. </td>
  31257. <td>
  31258. <p>Symbols specifies the number of symbol characters in the generated
  31259. password. If omitted it defaults to 25% of the length of the password</p>
  31260. </td>
  31261. </tr>
  31262. <tr>
  31263. <td>
  31264. <code>symbolCharacters</code></br>
  31265. <em>
  31266. string
  31267. </em>
  31268. </td>
  31269. <td>
  31270. <p>SymbolCharacters specifies the special characters that should be used
  31271. in the generated password.</p>
  31272. </td>
  31273. </tr>
  31274. <tr>
  31275. <td>
  31276. <code>noUpper</code></br>
  31277. <em>
  31278. bool
  31279. </em>
  31280. </td>
  31281. <td>
  31282. <p>Set NoUpper to disable uppercase characters</p>
  31283. </td>
  31284. </tr>
  31285. <tr>
  31286. <td>
  31287. <code>allowRepeat</code></br>
  31288. <em>
  31289. bool
  31290. </em>
  31291. </td>
  31292. <td>
  31293. <p>set AllowRepeat to true to allow repeating characters.</p>
  31294. </td>
  31295. </tr>
  31296. <tr>
  31297. <td>
  31298. <code>secretKeys</code></br>
  31299. <em>
  31300. []string
  31301. </em>
  31302. </td>
  31303. <td>
  31304. <em>(Optional)</em>
  31305. <p>SecretKeys defines the keys that will be populated with generated passwords.
  31306. Defaults to &ldquo;password&rdquo; when not set.</p>
  31307. </td>
  31308. </tr>
  31309. <tr>
  31310. <td>
  31311. <code>encoding</code></br>
  31312. <em>
  31313. string
  31314. </em>
  31315. </td>
  31316. <td>
  31317. <p>Encoding specifies the encoding of the generated password.
  31318. Valid values are:
  31319. - &ldquo;raw&rdquo; (default): no encoding
  31320. - &ldquo;base64&rdquo;: standard base64 encoding
  31321. - &ldquo;base64url&rdquo;: base64url encoding
  31322. - &ldquo;base32&rdquo;: base32 encoding
  31323. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  31324. </td>
  31325. </tr>
  31326. </table>
  31327. </td>
  31328. </tr>
  31329. </tbody>
  31330. </table>
  31331. <h3 id="generators.external-secrets.io/v1alpha1.PasswordSpec">PasswordSpec
  31332. </h3>
  31333. <p>
  31334. (<em>Appears on:</em>
  31335. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31336. <a href="#generators.external-secrets.io/v1alpha1.Password">Password</a>)
  31337. </p>
  31338. <p>
  31339. <p>PasswordSpec controls the behavior of the password generator.</p>
  31340. </p>
  31341. <table>
  31342. <thead>
  31343. <tr>
  31344. <th>Field</th>
  31345. <th>Description</th>
  31346. </tr>
  31347. </thead>
  31348. <tbody>
  31349. <tr>
  31350. <td>
  31351. <code>length</code></br>
  31352. <em>
  31353. int
  31354. </em>
  31355. </td>
  31356. <td>
  31357. <p>Length of the password to be generated.
  31358. Defaults to 24</p>
  31359. </td>
  31360. </tr>
  31361. <tr>
  31362. <td>
  31363. <code>digits</code></br>
  31364. <em>
  31365. int
  31366. </em>
  31367. </td>
  31368. <td>
  31369. <p>Digits specifies the number of digits in the generated
  31370. password. If omitted it defaults to 25% of the length of the password</p>
  31371. </td>
  31372. </tr>
  31373. <tr>
  31374. <td>
  31375. <code>symbols</code></br>
  31376. <em>
  31377. int
  31378. </em>
  31379. </td>
  31380. <td>
  31381. <p>Symbols specifies the number of symbol characters in the generated
  31382. password. If omitted it defaults to 25% of the length of the password</p>
  31383. </td>
  31384. </tr>
  31385. <tr>
  31386. <td>
  31387. <code>symbolCharacters</code></br>
  31388. <em>
  31389. string
  31390. </em>
  31391. </td>
  31392. <td>
  31393. <p>SymbolCharacters specifies the special characters that should be used
  31394. in the generated password.</p>
  31395. </td>
  31396. </tr>
  31397. <tr>
  31398. <td>
  31399. <code>noUpper</code></br>
  31400. <em>
  31401. bool
  31402. </em>
  31403. </td>
  31404. <td>
  31405. <p>Set NoUpper to disable uppercase characters</p>
  31406. </td>
  31407. </tr>
  31408. <tr>
  31409. <td>
  31410. <code>allowRepeat</code></br>
  31411. <em>
  31412. bool
  31413. </em>
  31414. </td>
  31415. <td>
  31416. <p>set AllowRepeat to true to allow repeating characters.</p>
  31417. </td>
  31418. </tr>
  31419. <tr>
  31420. <td>
  31421. <code>secretKeys</code></br>
  31422. <em>
  31423. []string
  31424. </em>
  31425. </td>
  31426. <td>
  31427. <em>(Optional)</em>
  31428. <p>SecretKeys defines the keys that will be populated with generated passwords.
  31429. Defaults to &ldquo;password&rdquo; when not set.</p>
  31430. </td>
  31431. </tr>
  31432. <tr>
  31433. <td>
  31434. <code>encoding</code></br>
  31435. <em>
  31436. string
  31437. </em>
  31438. </td>
  31439. <td>
  31440. <p>Encoding specifies the encoding of the generated password.
  31441. Valid values are:
  31442. - &ldquo;raw&rdquo; (default): no encoding
  31443. - &ldquo;base64&rdquo;: standard base64 encoding
  31444. - &ldquo;base64url&rdquo;: base64url encoding
  31445. - &ldquo;base32&rdquo;: base32 encoding
  31446. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  31447. </td>
  31448. </tr>
  31449. </tbody>
  31450. </table>
  31451. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken
  31452. </h3>
  31453. <p>
  31454. <p>QuayAccessToken generates Quay oauth token for pulling/pushing images</p>
  31455. </p>
  31456. <table>
  31457. <thead>
  31458. <tr>
  31459. <th>Field</th>
  31460. <th>Description</th>
  31461. </tr>
  31462. </thead>
  31463. <tbody>
  31464. <tr>
  31465. <td>
  31466. <code>metadata</code></br>
  31467. <em>
  31468. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31469. Kubernetes meta/v1.ObjectMeta
  31470. </a>
  31471. </em>
  31472. </td>
  31473. <td>
  31474. Refer to the Kubernetes API documentation for the fields of the
  31475. <code>metadata</code> field.
  31476. </td>
  31477. </tr>
  31478. <tr>
  31479. <td>
  31480. <code>spec</code></br>
  31481. <em>
  31482. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  31483. QuayAccessTokenSpec
  31484. </a>
  31485. </em>
  31486. </td>
  31487. <td>
  31488. <br/>
  31489. <br/>
  31490. <table>
  31491. <tr>
  31492. <td>
  31493. <code>url</code></br>
  31494. <em>
  31495. string
  31496. </em>
  31497. </td>
  31498. <td>
  31499. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  31500. </td>
  31501. </tr>
  31502. <tr>
  31503. <td>
  31504. <code>robotAccount</code></br>
  31505. <em>
  31506. string
  31507. </em>
  31508. </td>
  31509. <td>
  31510. <p>Name of the robot account you are federating with</p>
  31511. </td>
  31512. </tr>
  31513. <tr>
  31514. <td>
  31515. <code>serviceAccountRef</code></br>
  31516. <em>
  31517. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  31518. External Secrets meta/v1.ServiceAccountSelector
  31519. </a>
  31520. </em>
  31521. </td>
  31522. <td>
  31523. <p>Name of the service account you are federating with</p>
  31524. </td>
  31525. </tr>
  31526. </table>
  31527. </td>
  31528. </tr>
  31529. </tbody>
  31530. </table>
  31531. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">QuayAccessTokenSpec
  31532. </h3>
  31533. <p>
  31534. (<em>Appears on:</em>
  31535. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31536. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken</a>)
  31537. </p>
  31538. <p>
  31539. <p>QuayAccessTokenSpec defines the desired state to generate a Quay access token.</p>
  31540. </p>
  31541. <table>
  31542. <thead>
  31543. <tr>
  31544. <th>Field</th>
  31545. <th>Description</th>
  31546. </tr>
  31547. </thead>
  31548. <tbody>
  31549. <tr>
  31550. <td>
  31551. <code>url</code></br>
  31552. <em>
  31553. string
  31554. </em>
  31555. </td>
  31556. <td>
  31557. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  31558. </td>
  31559. </tr>
  31560. <tr>
  31561. <td>
  31562. <code>robotAccount</code></br>
  31563. <em>
  31564. string
  31565. </em>
  31566. </td>
  31567. <td>
  31568. <p>Name of the robot account you are federating with</p>
  31569. </td>
  31570. </tr>
  31571. <tr>
  31572. <td>
  31573. <code>serviceAccountRef</code></br>
  31574. <em>
  31575. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  31576. External Secrets meta/v1.ServiceAccountSelector
  31577. </a>
  31578. </em>
  31579. </td>
  31580. <td>
  31581. <p>Name of the service account you are federating with</p>
  31582. </td>
  31583. </tr>
  31584. </tbody>
  31585. </table>
  31586. <h3 id="generators.external-secrets.io/v1alpha1.RequestParameters">RequestParameters
  31587. </h3>
  31588. <p>
  31589. (<em>Appears on:</em>
  31590. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  31591. </p>
  31592. <p>
  31593. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  31594. </p>
  31595. <table>
  31596. <thead>
  31597. <tr>
  31598. <th>Field</th>
  31599. <th>Description</th>
  31600. </tr>
  31601. </thead>
  31602. <tbody>
  31603. <tr>
  31604. <td>
  31605. <code>sessionDuration</code></br>
  31606. <em>
  31607. int32
  31608. </em>
  31609. </td>
  31610. <td>
  31611. <em>(Optional)</em>
  31612. </td>
  31613. </tr>
  31614. <tr>
  31615. <td>
  31616. <code>serialNumber</code></br>
  31617. <em>
  31618. string
  31619. </em>
  31620. </td>
  31621. <td>
  31622. <em>(Optional)</em>
  31623. <p>SerialNumber is the identification number of the MFA device that is associated with the IAM user who is making
  31624. the GetSessionToken call.
  31625. Possible values: hardware device (such as GAHT12345678) or an Amazon Resource Name (ARN) for a virtual device
  31626. (such as arn:aws:iam::123456789012:mfa/user)</p>
  31627. </td>
  31628. </tr>
  31629. <tr>
  31630. <td>
  31631. <code>tokenCode</code></br>
  31632. <em>
  31633. string
  31634. </em>
  31635. </td>
  31636. <td>
  31637. <em>(Optional)</em>
  31638. <p>TokenCode is the value provided by the MFA device, if MFA is required.</p>
  31639. </td>
  31640. </tr>
  31641. </tbody>
  31642. </table>
  31643. <h3 id="generators.external-secrets.io/v1alpha1.SSHKey">SSHKey
  31644. </h3>
  31645. <p>
  31646. <p>SSHKey generates SSH key pairs.</p>
  31647. </p>
  31648. <table>
  31649. <thead>
  31650. <tr>
  31651. <th>Field</th>
  31652. <th>Description</th>
  31653. </tr>
  31654. </thead>
  31655. <tbody>
  31656. <tr>
  31657. <td>
  31658. <code>metadata</code></br>
  31659. <em>
  31660. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31661. Kubernetes meta/v1.ObjectMeta
  31662. </a>
  31663. </em>
  31664. </td>
  31665. <td>
  31666. Refer to the Kubernetes API documentation for the fields of the
  31667. <code>metadata</code> field.
  31668. </td>
  31669. </tr>
  31670. <tr>
  31671. <td>
  31672. <code>spec</code></br>
  31673. <em>
  31674. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  31675. SSHKeySpec
  31676. </a>
  31677. </em>
  31678. </td>
  31679. <td>
  31680. <br/>
  31681. <br/>
  31682. <table>
  31683. <tr>
  31684. <td>
  31685. <code>keyType</code></br>
  31686. <em>
  31687. string
  31688. </em>
  31689. </td>
  31690. <td>
  31691. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  31692. </td>
  31693. </tr>
  31694. <tr>
  31695. <td>
  31696. <code>keySize</code></br>
  31697. <em>
  31698. int
  31699. </em>
  31700. </td>
  31701. <td>
  31702. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  31703. For RSA keys: 2048, 3072, 4096
  31704. For ECDSA keys: 256, 384, 521
  31705. Ignored for ed25519 keys</p>
  31706. </td>
  31707. </tr>
  31708. <tr>
  31709. <td>
  31710. <code>comment</code></br>
  31711. <em>
  31712. string
  31713. </em>
  31714. </td>
  31715. <td>
  31716. <p>Comment specifies an optional comment for the SSH key</p>
  31717. </td>
  31718. </tr>
  31719. </table>
  31720. </td>
  31721. </tr>
  31722. </tbody>
  31723. </table>
  31724. <h3 id="generators.external-secrets.io/v1alpha1.SSHKeySpec">SSHKeySpec
  31725. </h3>
  31726. <p>
  31727. (<em>Appears on:</em>
  31728. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31729. <a href="#generators.external-secrets.io/v1alpha1.SSHKey">SSHKey</a>)
  31730. </p>
  31731. <p>
  31732. <p>SSHKeySpec controls the behavior of the ssh key generator.</p>
  31733. </p>
  31734. <table>
  31735. <thead>
  31736. <tr>
  31737. <th>Field</th>
  31738. <th>Description</th>
  31739. </tr>
  31740. </thead>
  31741. <tbody>
  31742. <tr>
  31743. <td>
  31744. <code>keyType</code></br>
  31745. <em>
  31746. string
  31747. </em>
  31748. </td>
  31749. <td>
  31750. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  31751. </td>
  31752. </tr>
  31753. <tr>
  31754. <td>
  31755. <code>keySize</code></br>
  31756. <em>
  31757. int
  31758. </em>
  31759. </td>
  31760. <td>
  31761. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  31762. For RSA keys: 2048, 3072, 4096
  31763. For ECDSA keys: 256, 384, 521
  31764. Ignored for ed25519 keys</p>
  31765. </td>
  31766. </tr>
  31767. <tr>
  31768. <td>
  31769. <code>comment</code></br>
  31770. <em>
  31771. string
  31772. </em>
  31773. </td>
  31774. <td>
  31775. <p>Comment specifies an optional comment for the SSH key</p>
  31776. </td>
  31777. </tr>
  31778. </tbody>
  31779. </table>
  31780. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken
  31781. </h3>
  31782. <p>
  31783. <p>STSSessionToken uses the GetSessionToken API to retrieve an authorization token.
  31784. The authorization token is valid for 12 hours.
  31785. The authorizationToken returned is a base64 encoded string that can be decoded.
  31786. 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>
  31787. </p>
  31788. <table>
  31789. <thead>
  31790. <tr>
  31791. <th>Field</th>
  31792. <th>Description</th>
  31793. </tr>
  31794. </thead>
  31795. <tbody>
  31796. <tr>
  31797. <td>
  31798. <code>metadata</code></br>
  31799. <em>
  31800. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31801. Kubernetes meta/v1.ObjectMeta
  31802. </a>
  31803. </em>
  31804. </td>
  31805. <td>
  31806. Refer to the Kubernetes API documentation for the fields of the
  31807. <code>metadata</code> field.
  31808. </td>
  31809. </tr>
  31810. <tr>
  31811. <td>
  31812. <code>spec</code></br>
  31813. <em>
  31814. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  31815. STSSessionTokenSpec
  31816. </a>
  31817. </em>
  31818. </td>
  31819. <td>
  31820. <br/>
  31821. <br/>
  31822. <table>
  31823. <tr>
  31824. <td>
  31825. <code>region</code></br>
  31826. <em>
  31827. string
  31828. </em>
  31829. </td>
  31830. <td>
  31831. <p>Region specifies the region to operate in.</p>
  31832. </td>
  31833. </tr>
  31834. <tr>
  31835. <td>
  31836. <code>auth</code></br>
  31837. <em>
  31838. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  31839. AWSAuth
  31840. </a>
  31841. </em>
  31842. </td>
  31843. <td>
  31844. <em>(Optional)</em>
  31845. <p>Auth defines how to authenticate with AWS</p>
  31846. </td>
  31847. </tr>
  31848. <tr>
  31849. <td>
  31850. <code>role</code></br>
  31851. <em>
  31852. string
  31853. </em>
  31854. </td>
  31855. <td>
  31856. <em>(Optional)</em>
  31857. <p>You can assume a role before making calls to the
  31858. desired AWS service.</p>
  31859. </td>
  31860. </tr>
  31861. <tr>
  31862. <td>
  31863. <code>requestParameters</code></br>
  31864. <em>
  31865. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  31866. RequestParameters
  31867. </a>
  31868. </em>
  31869. </td>
  31870. <td>
  31871. <em>(Optional)</em>
  31872. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  31873. </td>
  31874. </tr>
  31875. </table>
  31876. </td>
  31877. </tr>
  31878. </tbody>
  31879. </table>
  31880. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec
  31881. </h3>
  31882. <p>
  31883. (<em>Appears on:</em>
  31884. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31885. <a href="#generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken</a>)
  31886. </p>
  31887. <p>
  31888. <p>STSSessionTokenSpec defines the desired state to generate an AWS STS session token.</p>
  31889. </p>
  31890. <table>
  31891. <thead>
  31892. <tr>
  31893. <th>Field</th>
  31894. <th>Description</th>
  31895. </tr>
  31896. </thead>
  31897. <tbody>
  31898. <tr>
  31899. <td>
  31900. <code>region</code></br>
  31901. <em>
  31902. string
  31903. </em>
  31904. </td>
  31905. <td>
  31906. <p>Region specifies the region to operate in.</p>
  31907. </td>
  31908. </tr>
  31909. <tr>
  31910. <td>
  31911. <code>auth</code></br>
  31912. <em>
  31913. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  31914. AWSAuth
  31915. </a>
  31916. </em>
  31917. </td>
  31918. <td>
  31919. <em>(Optional)</em>
  31920. <p>Auth defines how to authenticate with AWS</p>
  31921. </td>
  31922. </tr>
  31923. <tr>
  31924. <td>
  31925. <code>role</code></br>
  31926. <em>
  31927. string
  31928. </em>
  31929. </td>
  31930. <td>
  31931. <em>(Optional)</em>
  31932. <p>You can assume a role before making calls to the
  31933. desired AWS service.</p>
  31934. </td>
  31935. </tr>
  31936. <tr>
  31937. <td>
  31938. <code>requestParameters</code></br>
  31939. <em>
  31940. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  31941. RequestParameters
  31942. </a>
  31943. </em>
  31944. </td>
  31945. <td>
  31946. <em>(Optional)</em>
  31947. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  31948. </td>
  31949. </tr>
  31950. </tbody>
  31951. </table>
  31952. <h3 id="generators.external-secrets.io/v1alpha1.SecretKeySelector">SecretKeySelector
  31953. </h3>
  31954. <p>
  31955. (<em>Appears on:</em>
  31956. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>,
  31957. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth</a>,
  31958. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret</a>)
  31959. </p>
  31960. <p>
  31961. <p>SecretKeySelector defines a reference to a specific key within a Kubernetes Secret.</p>
  31962. </p>
  31963. <table>
  31964. <thead>
  31965. <tr>
  31966. <th>Field</th>
  31967. <th>Description</th>
  31968. </tr>
  31969. </thead>
  31970. <tbody>
  31971. <tr>
  31972. <td>
  31973. <code>name</code></br>
  31974. <em>
  31975. string
  31976. </em>
  31977. </td>
  31978. <td>
  31979. <p>The name of the Secret resource being referred to.</p>
  31980. </td>
  31981. </tr>
  31982. <tr>
  31983. <td>
  31984. <code>key</code></br>
  31985. <em>
  31986. string
  31987. </em>
  31988. </td>
  31989. <td>
  31990. <p>The key where the token is found.</p>
  31991. </td>
  31992. </tr>
  31993. </tbody>
  31994. </table>
  31995. <h3 id="generators.external-secrets.io/v1alpha1.StatefulResource">StatefulResource
  31996. </h3>
  31997. <p>
  31998. <p>StatefulResource represents a Kubernetes resource that has state which can be tracked.</p>
  31999. </p>
  32000. <h3 id="generators.external-secrets.io/v1alpha1.UUID">UUID
  32001. </h3>
  32002. <p>
  32003. <p>UUID generates a version 1 UUID (e56657e3-764f-11ef-a397-65231a88c216).</p>
  32004. </p>
  32005. <table>
  32006. <thead>
  32007. <tr>
  32008. <th>Field</th>
  32009. <th>Description</th>
  32010. </tr>
  32011. </thead>
  32012. <tbody>
  32013. <tr>
  32014. <td>
  32015. <code>metadata</code></br>
  32016. <em>
  32017. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  32018. Kubernetes meta/v1.ObjectMeta
  32019. </a>
  32020. </em>
  32021. </td>
  32022. <td>
  32023. Refer to the Kubernetes API documentation for the fields of the
  32024. <code>metadata</code> field.
  32025. </td>
  32026. </tr>
  32027. <tr>
  32028. <td>
  32029. <code>spec</code></br>
  32030. <em>
  32031. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  32032. UUIDSpec
  32033. </a>
  32034. </em>
  32035. </td>
  32036. <td>
  32037. <br/>
  32038. <br/>
  32039. <table>
  32040. </table>
  32041. </td>
  32042. </tr>
  32043. </tbody>
  32044. </table>
  32045. <h3 id="generators.external-secrets.io/v1alpha1.UUIDSpec">UUIDSpec
  32046. </h3>
  32047. <p>
  32048. (<em>Appears on:</em>
  32049. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  32050. <a href="#generators.external-secrets.io/v1alpha1.UUID">UUID</a>)
  32051. </p>
  32052. <p>
  32053. <p>UUIDSpec controls the behavior of the uuid generator.</p>
  32054. </p>
  32055. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret
  32056. </h3>
  32057. <p>
  32058. <p>VaultDynamicSecret represents a generator that can create dynamic secrets from HashiCorp Vault.</p>
  32059. </p>
  32060. <table>
  32061. <thead>
  32062. <tr>
  32063. <th>Field</th>
  32064. <th>Description</th>
  32065. </tr>
  32066. </thead>
  32067. <tbody>
  32068. <tr>
  32069. <td>
  32070. <code>metadata</code></br>
  32071. <em>
  32072. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  32073. Kubernetes meta/v1.ObjectMeta
  32074. </a>
  32075. </em>
  32076. </td>
  32077. <td>
  32078. Refer to the Kubernetes API documentation for the fields of the
  32079. <code>metadata</code> field.
  32080. </td>
  32081. </tr>
  32082. <tr>
  32083. <td>
  32084. <code>spec</code></br>
  32085. <em>
  32086. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  32087. VaultDynamicSecretSpec
  32088. </a>
  32089. </em>
  32090. </td>
  32091. <td>
  32092. <br/>
  32093. <br/>
  32094. <table>
  32095. <tr>
  32096. <td>
  32097. <code>controller</code></br>
  32098. <em>
  32099. string
  32100. </em>
  32101. </td>
  32102. <td>
  32103. <em>(Optional)</em>
  32104. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  32105. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  32106. </td>
  32107. </tr>
  32108. <tr>
  32109. <td>
  32110. <code>method</code></br>
  32111. <em>
  32112. string
  32113. </em>
  32114. </td>
  32115. <td>
  32116. <p>Vault API method to use (GET/POST/other)</p>
  32117. </td>
  32118. </tr>
  32119. <tr>
  32120. <td>
  32121. <code>parameters</code></br>
  32122. <em>
  32123. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  32124. </em>
  32125. </td>
  32126. <td>
  32127. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  32128. </td>
  32129. </tr>
  32130. <tr>
  32131. <td>
  32132. <code>getParameters</code></br>
  32133. <em>
  32134. map[string][]string
  32135. </em>
  32136. </td>
  32137. <td>
  32138. <em>(Optional)</em>
  32139. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  32140. Each key may map to multiple values, matching HTTP query-string semantics.
  32141. Ignored for non-GET methods; use Parameters for write bodies.</p>
  32142. </td>
  32143. </tr>
  32144. <tr>
  32145. <td>
  32146. <code>resultType</code></br>
  32147. <em>
  32148. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  32149. VaultDynamicSecretResultType
  32150. </a>
  32151. </em>
  32152. </td>
  32153. <td>
  32154. <p>Result type defines which data is returned from the generator.
  32155. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  32156. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  32157. the &ldquo;auth&rdquo; section contains the generated token.
  32158. Please refer to the vault docs regarding the result data structure.
  32159. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  32160. </td>
  32161. </tr>
  32162. <tr>
  32163. <td>
  32164. <code>retrySettings</code></br>
  32165. <em>
  32166. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  32167. SecretStoreRetrySettings
  32168. </a>
  32169. </em>
  32170. </td>
  32171. <td>
  32172. <em>(Optional)</em>
  32173. <p>Used to configure http retries if failed</p>
  32174. </td>
  32175. </tr>
  32176. <tr>
  32177. <td>
  32178. <code>provider</code></br>
  32179. <em>
  32180. <a href="#external-secrets.io/v1.VaultProvider">
  32181. VaultProvider
  32182. </a>
  32183. </em>
  32184. </td>
  32185. <td>
  32186. <p>Vault provider common spec</p>
  32187. </td>
  32188. </tr>
  32189. <tr>
  32190. <td>
  32191. <code>path</code></br>
  32192. <em>
  32193. string
  32194. </em>
  32195. </td>
  32196. <td>
  32197. <p>Vault path to obtain the dynamic secret from</p>
  32198. </td>
  32199. </tr>
  32200. <tr>
  32201. <td>
  32202. <code>allowEmptyResponse</code></br>
  32203. <em>
  32204. bool
  32205. </em>
  32206. </td>
  32207. <td>
  32208. <em>(Optional)</em>
  32209. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  32210. </td>
  32211. </tr>
  32212. </table>
  32213. </td>
  32214. </tr>
  32215. </tbody>
  32216. </table>
  32217. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">VaultDynamicSecretResultType
  32218. (<code>string</code> alias)</p></h3>
  32219. <p>
  32220. (<em>Appears on:</em>
  32221. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  32222. </p>
  32223. <p>
  32224. <p>VaultDynamicSecretResultType defines which part of the Vault API response should be returned.</p>
  32225. </p>
  32226. <table>
  32227. <thead>
  32228. <tr>
  32229. <th>Value</th>
  32230. <th>Description</th>
  32231. </tr>
  32232. </thead>
  32233. <tbody><tr><td><p>&#34;Auth&#34;</p></td>
  32234. <td><p>VaultDynamicSecretResultTypeAuth specifies to return the &ldquo;auth&rdquo; section of the Vault API response.</p>
  32235. </td>
  32236. </tr><tr><td><p>&#34;Data&#34;</p></td>
  32237. <td><p>VaultDynamicSecretResultTypeData specifies to return the &ldquo;data&rdquo; section of the Vault API response.</p>
  32238. </td>
  32239. </tr><tr><td><p>&#34;Raw&#34;</p></td>
  32240. <td><p>VaultDynamicSecretResultTypeRaw specifies to return the raw response from the Vault API.</p>
  32241. </td>
  32242. </tr></tbody>
  32243. </table>
  32244. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec
  32245. </h3>
  32246. <p>
  32247. (<em>Appears on:</em>
  32248. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  32249. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret</a>)
  32250. </p>
  32251. <p>
  32252. <p>VaultDynamicSecretSpec defines the desired spec of VaultDynamicSecret.</p>
  32253. </p>
  32254. <table>
  32255. <thead>
  32256. <tr>
  32257. <th>Field</th>
  32258. <th>Description</th>
  32259. </tr>
  32260. </thead>
  32261. <tbody>
  32262. <tr>
  32263. <td>
  32264. <code>controller</code></br>
  32265. <em>
  32266. string
  32267. </em>
  32268. </td>
  32269. <td>
  32270. <em>(Optional)</em>
  32271. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  32272. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  32273. </td>
  32274. </tr>
  32275. <tr>
  32276. <td>
  32277. <code>method</code></br>
  32278. <em>
  32279. string
  32280. </em>
  32281. </td>
  32282. <td>
  32283. <p>Vault API method to use (GET/POST/other)</p>
  32284. </td>
  32285. </tr>
  32286. <tr>
  32287. <td>
  32288. <code>parameters</code></br>
  32289. <em>
  32290. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  32291. </em>
  32292. </td>
  32293. <td>
  32294. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  32295. </td>
  32296. </tr>
  32297. <tr>
  32298. <td>
  32299. <code>getParameters</code></br>
  32300. <em>
  32301. map[string][]string
  32302. </em>
  32303. </td>
  32304. <td>
  32305. <em>(Optional)</em>
  32306. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  32307. Each key may map to multiple values, matching HTTP query-string semantics.
  32308. Ignored for non-GET methods; use Parameters for write bodies.</p>
  32309. </td>
  32310. </tr>
  32311. <tr>
  32312. <td>
  32313. <code>resultType</code></br>
  32314. <em>
  32315. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  32316. VaultDynamicSecretResultType
  32317. </a>
  32318. </em>
  32319. </td>
  32320. <td>
  32321. <p>Result type defines which data is returned from the generator.
  32322. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  32323. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  32324. the &ldquo;auth&rdquo; section contains the generated token.
  32325. Please refer to the vault docs regarding the result data structure.
  32326. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  32327. </td>
  32328. </tr>
  32329. <tr>
  32330. <td>
  32331. <code>retrySettings</code></br>
  32332. <em>
  32333. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  32334. SecretStoreRetrySettings
  32335. </a>
  32336. </em>
  32337. </td>
  32338. <td>
  32339. <em>(Optional)</em>
  32340. <p>Used to configure http retries if failed</p>
  32341. </td>
  32342. </tr>
  32343. <tr>
  32344. <td>
  32345. <code>provider</code></br>
  32346. <em>
  32347. <a href="#external-secrets.io/v1.VaultProvider">
  32348. VaultProvider
  32349. </a>
  32350. </em>
  32351. </td>
  32352. <td>
  32353. <p>Vault provider common spec</p>
  32354. </td>
  32355. </tr>
  32356. <tr>
  32357. <td>
  32358. <code>path</code></br>
  32359. <em>
  32360. string
  32361. </em>
  32362. </td>
  32363. <td>
  32364. <p>Vault path to obtain the dynamic secret from</p>
  32365. </td>
  32366. </tr>
  32367. <tr>
  32368. <td>
  32369. <code>allowEmptyResponse</code></br>
  32370. <em>
  32371. bool
  32372. </em>
  32373. </td>
  32374. <td>
  32375. <em>(Optional)</em>
  32376. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  32377. </td>
  32378. </tr>
  32379. </tbody>
  32380. </table>
  32381. <h3 id="generators.external-secrets.io/v1alpha1.Webhook">Webhook
  32382. </h3>
  32383. <p>
  32384. <p>Webhook connects to a third party API server to handle the secrets generation
  32385. configuration parameters in spec.
  32386. You can specify the server, the token, and additional body parameters.
  32387. See documentation for the full API specification for requests and responses.</p>
  32388. </p>
  32389. <table>
  32390. <thead>
  32391. <tr>
  32392. <th>Field</th>
  32393. <th>Description</th>
  32394. </tr>
  32395. </thead>
  32396. <tbody>
  32397. <tr>
  32398. <td>
  32399. <code>metadata</code></br>
  32400. <em>
  32401. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  32402. Kubernetes meta/v1.ObjectMeta
  32403. </a>
  32404. </em>
  32405. </td>
  32406. <td>
  32407. Refer to the Kubernetes API documentation for the fields of the
  32408. <code>metadata</code> field.
  32409. </td>
  32410. </tr>
  32411. <tr>
  32412. <td>
  32413. <code>spec</code></br>
  32414. <em>
  32415. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  32416. WebhookSpec
  32417. </a>
  32418. </em>
  32419. </td>
  32420. <td>
  32421. <br/>
  32422. <br/>
  32423. <table>
  32424. <tr>
  32425. <td>
  32426. <code>method</code></br>
  32427. <em>
  32428. string
  32429. </em>
  32430. </td>
  32431. <td>
  32432. <p>Webhook Method</p>
  32433. </td>
  32434. </tr>
  32435. <tr>
  32436. <td>
  32437. <code>url</code></br>
  32438. <em>
  32439. string
  32440. </em>
  32441. </td>
  32442. <td>
  32443. <p>Webhook url to call</p>
  32444. </td>
  32445. </tr>
  32446. <tr>
  32447. <td>
  32448. <code>headers</code></br>
  32449. <em>
  32450. map[string]string
  32451. </em>
  32452. </td>
  32453. <td>
  32454. <em>(Optional)</em>
  32455. <p>Headers</p>
  32456. </td>
  32457. </tr>
  32458. <tr>
  32459. <td>
  32460. <code>auth</code></br>
  32461. <em>
  32462. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  32463. AuthorizationProtocol
  32464. </a>
  32465. </em>
  32466. </td>
  32467. <td>
  32468. <em>(Optional)</em>
  32469. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  32470. </td>
  32471. </tr>
  32472. <tr>
  32473. <td>
  32474. <code>body</code></br>
  32475. <em>
  32476. string
  32477. </em>
  32478. </td>
  32479. <td>
  32480. <em>(Optional)</em>
  32481. <p>Body</p>
  32482. </td>
  32483. </tr>
  32484. <tr>
  32485. <td>
  32486. <code>timeout</code></br>
  32487. <em>
  32488. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  32489. Kubernetes meta/v1.Duration
  32490. </a>
  32491. </em>
  32492. </td>
  32493. <td>
  32494. <em>(Optional)</em>
  32495. <p>Timeout</p>
  32496. </td>
  32497. </tr>
  32498. <tr>
  32499. <td>
  32500. <code>result</code></br>
  32501. <em>
  32502. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  32503. WebhookResult
  32504. </a>
  32505. </em>
  32506. </td>
  32507. <td>
  32508. <p>Result formatting</p>
  32509. </td>
  32510. </tr>
  32511. <tr>
  32512. <td>
  32513. <code>secrets</code></br>
  32514. <em>
  32515. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  32516. []WebhookSecret
  32517. </a>
  32518. </em>
  32519. </td>
  32520. <td>
  32521. <em>(Optional)</em>
  32522. <p>Secrets to fill in templates
  32523. These secrets will be passed to the templating function as key value pairs under the given name</p>
  32524. </td>
  32525. </tr>
  32526. <tr>
  32527. <td>
  32528. <code>caBundle</code></br>
  32529. <em>
  32530. []byte
  32531. </em>
  32532. </td>
  32533. <td>
  32534. <em>(Optional)</em>
  32535. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  32536. if the Server URL is using HTTPS protocol. This parameter is ignored for
  32537. plain HTTP protocol connection. If not set the system root certificates
  32538. are used to validate the TLS connection.</p>
  32539. </td>
  32540. </tr>
  32541. <tr>
  32542. <td>
  32543. <code>caProvider</code></br>
  32544. <em>
  32545. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  32546. WebhookCAProvider
  32547. </a>
  32548. </em>
  32549. </td>
  32550. <td>
  32551. <em>(Optional)</em>
  32552. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  32553. </td>
  32554. </tr>
  32555. </table>
  32556. </td>
  32557. </tr>
  32558. </tbody>
  32559. </table>
  32560. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider
  32561. </h3>
  32562. <p>
  32563. (<em>Appears on:</em>
  32564. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  32565. </p>
  32566. <p>
  32567. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  32568. </p>
  32569. <table>
  32570. <thead>
  32571. <tr>
  32572. <th>Field</th>
  32573. <th>Description</th>
  32574. </tr>
  32575. </thead>
  32576. <tbody>
  32577. <tr>
  32578. <td>
  32579. <code>type</code></br>
  32580. <em>
  32581. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProviderType">
  32582. WebhookCAProviderType
  32583. </a>
  32584. </em>
  32585. </td>
  32586. <td>
  32587. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  32588. </td>
  32589. </tr>
  32590. <tr>
  32591. <td>
  32592. <code>name</code></br>
  32593. <em>
  32594. string
  32595. </em>
  32596. </td>
  32597. <td>
  32598. <p>The name of the object located at the provider type.</p>
  32599. </td>
  32600. </tr>
  32601. <tr>
  32602. <td>
  32603. <code>key</code></br>
  32604. <em>
  32605. string
  32606. </em>
  32607. </td>
  32608. <td>
  32609. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  32610. </td>
  32611. </tr>
  32612. <tr>
  32613. <td>
  32614. <code>namespace</code></br>
  32615. <em>
  32616. string
  32617. </em>
  32618. </td>
  32619. <td>
  32620. <em>(Optional)</em>
  32621. <p>The namespace the Provider type is in.</p>
  32622. </td>
  32623. </tr>
  32624. </tbody>
  32625. </table>
  32626. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProviderType">WebhookCAProviderType
  32627. (<code>string</code> alias)</p></h3>
  32628. <p>
  32629. (<em>Appears on:</em>
  32630. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider</a>)
  32631. </p>
  32632. <p>
  32633. <p>WebhookCAProviderType defines the type of provider for webhook CA certificates.</p>
  32634. </p>
  32635. <table>
  32636. <thead>
  32637. <tr>
  32638. <th>Value</th>
  32639. <th>Description</th>
  32640. </tr>
  32641. </thead>
  32642. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  32643. <td><p>WebhookCAProviderTypeConfigMap indicates the CA provider is a ConfigMap resource.</p>
  32644. </td>
  32645. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  32646. <td><p>WebhookCAProviderTypeSecret indicates the CA provider is a Secret resource.</p>
  32647. </td>
  32648. </tr></tbody>
  32649. </table>
  32650. <h3 id="generators.external-secrets.io/v1alpha1.WebhookResult">WebhookResult
  32651. </h3>
  32652. <p>
  32653. (<em>Appears on:</em>
  32654. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  32655. </p>
  32656. <p>
  32657. <p>WebhookResult defines how to format and extract results from the webhook response.</p>
  32658. </p>
  32659. <table>
  32660. <thead>
  32661. <tr>
  32662. <th>Field</th>
  32663. <th>Description</th>
  32664. </tr>
  32665. </thead>
  32666. <tbody>
  32667. <tr>
  32668. <td>
  32669. <code>jsonPath</code></br>
  32670. <em>
  32671. string
  32672. </em>
  32673. </td>
  32674. <td>
  32675. <em>(Optional)</em>
  32676. <p>Json path of return value</p>
  32677. </td>
  32678. </tr>
  32679. </tbody>
  32680. </table>
  32681. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret
  32682. </h3>
  32683. <p>
  32684. (<em>Appears on:</em>
  32685. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  32686. </p>
  32687. <p>
  32688. <p>WebhookSecret defines a secret reference that will be used in webhook templates.</p>
  32689. </p>
  32690. <table>
  32691. <thead>
  32692. <tr>
  32693. <th>Field</th>
  32694. <th>Description</th>
  32695. </tr>
  32696. </thead>
  32697. <tbody>
  32698. <tr>
  32699. <td>
  32700. <code>name</code></br>
  32701. <em>
  32702. string
  32703. </em>
  32704. </td>
  32705. <td>
  32706. <p>Name of this secret in templates</p>
  32707. </td>
  32708. </tr>
  32709. <tr>
  32710. <td>
  32711. <code>secretRef</code></br>
  32712. <em>
  32713. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  32714. SecretKeySelector
  32715. </a>
  32716. </em>
  32717. </td>
  32718. <td>
  32719. <p>Secret ref to fill in credentials</p>
  32720. </td>
  32721. </tr>
  32722. </tbody>
  32723. </table>
  32724. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec
  32725. </h3>
  32726. <p>
  32727. (<em>Appears on:</em>
  32728. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  32729. <a href="#generators.external-secrets.io/v1alpha1.Webhook">Webhook</a>)
  32730. </p>
  32731. <p>
  32732. <p>WebhookSpec controls the behavior of the external generator. Any body parameters should be passed to the server through the parameters field.</p>
  32733. </p>
  32734. <table>
  32735. <thead>
  32736. <tr>
  32737. <th>Field</th>
  32738. <th>Description</th>
  32739. </tr>
  32740. </thead>
  32741. <tbody>
  32742. <tr>
  32743. <td>
  32744. <code>method</code></br>
  32745. <em>
  32746. string
  32747. </em>
  32748. </td>
  32749. <td>
  32750. <p>Webhook Method</p>
  32751. </td>
  32752. </tr>
  32753. <tr>
  32754. <td>
  32755. <code>url</code></br>
  32756. <em>
  32757. string
  32758. </em>
  32759. </td>
  32760. <td>
  32761. <p>Webhook url to call</p>
  32762. </td>
  32763. </tr>
  32764. <tr>
  32765. <td>
  32766. <code>headers</code></br>
  32767. <em>
  32768. map[string]string
  32769. </em>
  32770. </td>
  32771. <td>
  32772. <em>(Optional)</em>
  32773. <p>Headers</p>
  32774. </td>
  32775. </tr>
  32776. <tr>
  32777. <td>
  32778. <code>auth</code></br>
  32779. <em>
  32780. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  32781. AuthorizationProtocol
  32782. </a>
  32783. </em>
  32784. </td>
  32785. <td>
  32786. <em>(Optional)</em>
  32787. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  32788. </td>
  32789. </tr>
  32790. <tr>
  32791. <td>
  32792. <code>body</code></br>
  32793. <em>
  32794. string
  32795. </em>
  32796. </td>
  32797. <td>
  32798. <em>(Optional)</em>
  32799. <p>Body</p>
  32800. </td>
  32801. </tr>
  32802. <tr>
  32803. <td>
  32804. <code>timeout</code></br>
  32805. <em>
  32806. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  32807. Kubernetes meta/v1.Duration
  32808. </a>
  32809. </em>
  32810. </td>
  32811. <td>
  32812. <em>(Optional)</em>
  32813. <p>Timeout</p>
  32814. </td>
  32815. </tr>
  32816. <tr>
  32817. <td>
  32818. <code>result</code></br>
  32819. <em>
  32820. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  32821. WebhookResult
  32822. </a>
  32823. </em>
  32824. </td>
  32825. <td>
  32826. <p>Result formatting</p>
  32827. </td>
  32828. </tr>
  32829. <tr>
  32830. <td>
  32831. <code>secrets</code></br>
  32832. <em>
  32833. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  32834. []WebhookSecret
  32835. </a>
  32836. </em>
  32837. </td>
  32838. <td>
  32839. <em>(Optional)</em>
  32840. <p>Secrets to fill in templates
  32841. These secrets will be passed to the templating function as key value pairs under the given name</p>
  32842. </td>
  32843. </tr>
  32844. <tr>
  32845. <td>
  32846. <code>caBundle</code></br>
  32847. <em>
  32848. []byte
  32849. </em>
  32850. </td>
  32851. <td>
  32852. <em>(Optional)</em>
  32853. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  32854. if the Server URL is using HTTPS protocol. This parameter is ignored for
  32855. plain HTTP protocol connection. If not set the system root certificates
  32856. are used to validate the TLS connection.</p>
  32857. </td>
  32858. </tr>
  32859. <tr>
  32860. <td>
  32861. <code>caProvider</code></br>
  32862. <em>
  32863. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  32864. WebhookCAProvider
  32865. </a>
  32866. </em>
  32867. </td>
  32868. <td>
  32869. <em>(Optional)</em>
  32870. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  32871. </td>
  32872. </tr>
  32873. </tbody>
  32874. </table>
  32875. <hr/>
  32876. <p><em>
  32877. Generated with <code>gen-crd-api-reference-docs</code>.
  32878. </em></p>
  32879. </article>
  32880. </div>
  32881. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  32882. </div>
  32883. </main>
  32884. <img referrerpolicy="no-referrer-when-downgrade"
  32885. src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""
  32886. hidden />
  32887. <footer class="md-footer">
  32888. <div class="md-footer-meta md-typeset">
  32889. <div class="md-footer-meta__inner md-grid">
  32890. <div class="md-copyright">
  32891. <div class="md-copyright__highlight">
  32892. &copy; 2025 The external-secrets Authors.<br/>
  32893. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  32894. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  32895. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  32896. </div>
  32897. Made with
  32898. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  32899. Material for MkDocs
  32900. </a>
  32901. </div>
  32902. </div>
  32903. </div>
  32904. </footer>
  32905. </div>
  32906. <div class="md-dialog" data-md-component="dialog">
  32907. <div class="md-dialog__inner md-typeset"></div>
  32908. </div>
  32909. <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>
  32910. <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
  32911. </body>
  32912. </html>