index.html 664 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511185121851318514185151851618517185181851918520185211852218523185241852518526185271852818529185301853118532185331853418535185361853718538185391854018541185421854318544185451854618547185481854918550185511855218553185541855518556185571855818559185601856118562185631856418565185661856718568185691857018571185721857318574185751857618577185781857918580185811858218583185841858518586185871858818589185901859118592185931859418595185961859718598185991860018601186021860318604186051860618607186081860918610186111861218613186141861518616186171861818619186201862118622186231862418625186261862718628186291863018631186321863318634186351863618637186381863918640186411864218643186441864518646186471864818649186501865118652186531865418655186561865718658186591866018661186621866318664186651866618667186681866918670186711867218673186741867518676186771867818679186801868118682186831868418685186861868718688186891869018691186921869318694186951869618697186981869918700187011870218703187041870518706187071870818709187101871118712187131871418715187161871718718187191872018721187221872318724187251872618727187281872918730187311873218733187341873518736187371873818739187401874118742187431874418745187461874718748187491875018751187521875318754187551875618757187581875918760187611876218763187641876518766187671876818769187701877118772187731877418775187761877718778187791878018781187821878318784187851878618787187881878918790187911879218793187941879518796187971879818799188001880118802188031880418805188061880718808188091881018811188121881318814188151881618817188181881918820188211882218823188241882518826188271882818829188301883118832188331883418835188361883718838188391884018841188421884318844188451884618847188481884918850188511885218853188541885518856188571885818859188601886118862188631886418865188661886718868188691887018871188721887318874188751887618877188781887918880188811888218883188841888518886188871888818889188901889118892188931889418895188961889718898188991890018901189021890318904189051890618907189081890918910189111891218913189141891518916189171891818919189201892118922189231892418925189261892718928189291893018931189321893318934189351893618937189381893918940189411894218943189441894518946189471894818949189501895118952189531895418955189561895718958189591896018961189621896318964189651896618967189681896918970189711897218973189741897518976189771897818979189801898118982189831898418985189861898718988189891899018991189921899318994189951899618997189981899919000190011900219003190041900519006190071900819009190101901119012190131901419015190161901719018190191902019021190221902319024190251902619027190281902919030190311903219033190341903519036190371903819039190401904119042190431904419045190461904719048190491905019051190521905319054190551905619057190581905919060190611906219063190641906519066190671906819069190701907119072190731907419075190761907719078190791908019081190821908319084190851908619087190881908919090190911909219093190941909519096190971909819099191001910119102191031910419105191061910719108191091911019111191121911319114191151911619117191181911919120191211912219123191241912519126191271912819129191301913119132191331913419135191361913719138191391914019141191421914319144191451914619147191481914919150191511915219153191541915519156191571915819159191601916119162191631916419165191661916719168191691917019171191721917319174191751917619177191781917919180191811918219183191841918519186191871918819189191901919119192191931919419195191961919719198191991920019201192021920319204192051920619207192081920919210192111921219213192141921519216192171921819219192201922119222192231922419225192261922719228192291923019231192321923319234192351923619237192381923919240192411924219243192441924519246192471924819249192501925119252192531925419255192561925719258192591926019261192621926319264192651926619267192681926919270192711927219273192741927519276192771927819279192801928119282192831928419285192861928719288192891929019291192921929319294192951929619297192981929919300193011930219303193041930519306193071930819309193101931119312193131931419315193161931719318193191932019321193221932319324193251932619327193281932919330193311933219333193341933519336193371933819339193401934119342193431934419345193461934719348193491935019351193521935319354193551935619357193581935919360193611936219363193641936519366193671936819369193701937119372193731937419375193761937719378193791938019381193821938319384193851938619387193881938919390193911939219393193941939519396193971939819399194001940119402194031940419405194061940719408194091941019411194121941319414194151941619417194181941919420194211942219423194241942519426194271942819429194301943119432194331943419435194361943719438194391944019441194421944319444194451944619447194481944919450194511945219453194541945519456194571945819459194601946119462194631946419465194661946719468194691947019471194721947319474194751947619477194781947919480194811948219483194841948519486194871948819489194901949119492194931949419495194961949719498194991950019501195021950319504195051950619507195081950919510195111951219513195141951519516195171951819519195201952119522195231952419525195261952719528195291953019531195321953319534195351953619537195381953919540195411954219543195441954519546195471954819549195501955119552195531955419555195561955719558195591956019561195621956319564195651956619567195681956919570195711957219573195741957519576195771957819579195801958119582195831958419585195861958719588195891959019591195921959319594195951959619597195981959919600196011960219603196041960519606196071960819609196101961119612196131961419615196161961719618196191962019621196221962319624196251962619627196281962919630196311963219633196341963519636196371963819639196401964119642196431964419645196461964719648196491965019651196521965319654196551965619657196581965919660196611966219663196641966519666196671966819669196701967119672196731967419675196761967719678196791968019681196821968319684196851968619687196881968919690196911969219693196941969519696196971969819699197001970119702197031970419705197061970719708197091971019711197121971319714197151971619717197181971919720197211972219723197241972519726197271972819729197301973119732197331973419735197361973719738197391974019741197421974319744197451974619747197481974919750197511975219753197541975519756197571975819759197601976119762197631976419765197661976719768197691977019771197721977319774197751977619777197781977919780197811978219783197841978519786197871978819789197901979119792197931979419795197961979719798197991980019801198021980319804198051980619807198081980919810198111981219813198141981519816198171981819819198201982119822198231982419825198261982719828198291983019831198321983319834198351983619837198381983919840198411984219843198441984519846198471984819849198501985119852198531985419855198561985719858198591986019861198621986319864198651986619867198681986919870198711987219873198741987519876198771987819879198801988119882198831988419885198861988719888198891989019891198921989319894198951989619897198981989919900199011990219903199041990519906199071990819909199101991119912199131991419915199161991719918199191992019921199221992319924199251992619927199281992919930199311993219933199341993519936199371993819939199401994119942199431994419945199461994719948199491995019951199521995319954199551995619957199581995919960199611996219963199641996519966199671996819969199701997119972199731997419975199761997719978199791998019981199821998319984199851998619987199881998919990199911999219993199941999519996199971999819999200002000120002200032000420005200062000720008200092001020011200122001320014200152001620017200182001920020200212002220023200242002520026200272002820029200302003120032200332003420035200362003720038200392004020041200422004320044200452004620047200482004920050200512005220053200542005520056200572005820059200602006120062200632006420065200662006720068200692007020071200722007320074200752007620077200782007920080200812008220083200842008520086200872008820089200902009120092200932009420095200962009720098200992010020101201022010320104201052010620107201082010920110201112011220113201142011520116201172011820119201202012120122201232012420125201262012720128201292013020131201322013320134201352013620137201382013920140201412014220143201442014520146201472014820149201502015120152201532015420155201562015720158201592016020161201622016320164201652016620167201682016920170201712017220173201742017520176201772017820179201802018120182201832018420185201862018720188201892019020191201922019320194201952019620197201982019920200202012020220203202042020520206202072020820209202102021120212202132021420215202162021720218202192022020221202222022320224202252022620227202282022920230202312023220233202342023520236202372023820239202402024120242202432024420245202462024720248202492025020251202522025320254202552025620257202582025920260202612026220263202642026520266202672026820269202702027120272202732027420275202762027720278202792028020281202822028320284202852028620287202882028920290202912029220293202942029520296202972029820299203002030120302203032030420305203062030720308203092031020311203122031320314203152031620317203182031920320203212032220323203242032520326203272032820329203302033120332203332033420335203362033720338203392034020341203422034320344203452034620347203482034920350203512035220353203542035520356203572035820359203602036120362203632036420365203662036720368203692037020371203722037320374203752037620377203782037920380203812038220383203842038520386203872038820389203902039120392203932039420395203962039720398203992040020401204022040320404204052040620407204082040920410204112041220413204142041520416204172041820419204202042120422204232042420425204262042720428204292043020431204322043320434204352043620437204382043920440204412044220443204442044520446204472044820449204502045120452204532045420455204562045720458204592046020461204622046320464204652046620467204682046920470204712047220473204742047520476204772047820479204802048120482204832048420485204862048720488204892049020491204922049320494204952049620497204982049920500205012050220503205042050520506205072050820509205102051120512205132051420515205162051720518205192052020521205222052320524205252052620527205282052920530205312053220533205342053520536205372053820539205402054120542205432054420545205462054720548205492055020551205522055320554205552055620557205582055920560205612056220563205642056520566205672056820569205702057120572205732057420575205762057720578205792058020581205822058320584205852058620587205882058920590205912059220593205942059520596205972059820599206002060120602206032060420605206062060720608206092061020611206122061320614206152061620617206182061920620206212062220623206242062520626206272062820629206302063120632206332063420635206362063720638206392064020641206422064320644206452064620647206482064920650206512065220653206542065520656206572065820659206602066120662206632066420665206662066720668206692067020671206722067320674206752067620677206782067920680206812068220683206842068520686206872068820689206902069120692206932069420695206962069720698206992070020701207022070320704207052070620707207082070920710207112071220713207142071520716207172071820719207202072120722207232072420725207262072720728207292073020731207322073320734207352073620737207382073920740207412074220743207442074520746207472074820749207502075120752207532075420755207562075720758207592076020761207622076320764207652076620767207682076920770207712077220773207742077520776207772077820779207802078120782207832078420785207862078720788207892079020791207922079320794207952079620797207982079920800208012080220803208042080520806208072080820809208102081120812208132081420815208162081720818208192082020821208222082320824208252082620827208282082920830208312083220833208342083520836208372083820839208402084120842208432084420845208462084720848208492085020851208522085320854208552085620857208582085920860208612086220863208642086520866208672086820869208702087120872208732087420875208762087720878208792088020881208822088320884208852088620887208882088920890208912089220893208942089520896208972089820899209002090120902209032090420905209062090720908209092091020911209122091320914209152091620917209182091920920209212092220923209242092520926209272092820929209302093120932209332093420935209362093720938209392094020941209422094320944209452094620947209482094920950209512095220953209542095520956209572095820959209602096120962209632096420965209662096720968209692097020971209722097320974209752097620977209782097920980209812098220983209842098520986209872098820989209902099120992209932099420995209962099720998209992100021001210022100321004210052100621007210082100921010210112101221013210142101521016210172101821019210202102121022210232102421025210262102721028210292103021031210322103321034210352103621037210382103921040210412104221043210442104521046210472104821049210502105121052210532105421055210562105721058210592106021061210622106321064210652106621067210682106921070210712107221073210742107521076210772107821079210802108121082210832108421085210862108721088210892109021091210922109321094210952109621097210982109921100211012110221103211042110521106211072110821109211102111121112211132111421115211162111721118211192112021121211222112321124211252112621127211282112921130211312113221133211342113521136211372113821139211402114121142211432114421145211462114721148211492115021151211522115321154211552115621157211582115921160211612116221163211642116521166211672116821169211702117121172211732117421175211762117721178211792118021181211822118321184211852118621187211882118921190211912119221193211942119521196211972119821199212002120121202212032120421205212062120721208212092121021211212122121321214212152121621217212182121921220212212122221223212242122521226212272122821229212302123121232212332123421235212362123721238212392124021241212422124321244212452124621247212482124921250212512125221253212542125521256212572125821259212602126121262212632126421265212662126721268212692127021271212722127321274212752127621277212782127921280212812128221283212842128521286212872128821289212902129121292212932129421295212962129721298212992130021301213022130321304213052130621307213082130921310213112131221313213142131521316213172131821319213202132121322213232132421325213262132721328213292133021331213322133321334213352133621337213382133921340213412134221343213442134521346213472134821349213502135121352213532135421355213562135721358213592136021361213622136321364213652136621367213682136921370213712137221373213742137521376213772137821379213802138121382213832138421385213862138721388213892139021391213922139321394213952139621397213982139921400214012140221403214042140521406214072140821409214102141121412214132141421415214162141721418214192142021421214222142321424214252142621427214282142921430214312143221433214342143521436214372143821439214402144121442214432144421445214462144721448214492145021451214522145321454214552145621457214582145921460214612146221463214642146521466214672146821469214702147121472214732147421475214762147721478214792148021481214822148321484214852148621487214882148921490214912149221493214942149521496214972149821499215002150121502215032150421505215062150721508215092151021511215122151321514215152151621517215182151921520215212152221523215242152521526215272152821529215302153121532215332153421535215362153721538215392154021541215422154321544215452154621547215482154921550215512155221553215542155521556215572155821559215602156121562215632156421565215662156721568215692157021571215722157321574215752157621577215782157921580215812158221583215842158521586215872158821589215902159121592215932159421595215962159721598215992160021601216022160321604216052160621607216082160921610216112161221613216142161521616216172161821619216202162121622216232162421625216262162721628216292163021631216322163321634216352163621637216382163921640216412164221643216442164521646216472164821649216502165121652216532165421655216562165721658216592166021661216622166321664216652166621667216682166921670216712167221673216742167521676216772167821679216802168121682216832168421685216862168721688216892169021691216922169321694216952169621697216982169921700217012170221703217042170521706217072170821709217102171121712217132171421715217162171721718217192172021721217222172321724217252172621727217282172921730217312173221733217342173521736217372173821739217402174121742217432174421745217462174721748217492175021751217522175321754217552175621757217582175921760217612176221763217642176521766217672176821769217702177121772217732177421775217762177721778217792178021781217822178321784217852178621787217882178921790217912179221793217942179521796217972179821799218002180121802218032180421805218062180721808218092181021811218122181321814218152181621817218182181921820218212182221823218242182521826218272182821829218302183121832218332183421835218362183721838218392184021841218422184321844218452184621847218482184921850218512185221853218542185521856218572185821859218602186121862218632186421865218662186721868218692187021871218722187321874218752187621877218782187921880218812188221883218842188521886218872188821889218902189121892218932189421895218962189721898218992190021901219022190321904219052190621907219082190921910219112191221913219142191521916219172191821919219202192121922219232192421925219262192721928219292193021931219322193321934219352193621937219382193921940219412194221943219442194521946219472194821949219502195121952219532195421955219562195721958219592196021961219622196321964219652196621967219682196921970219712197221973219742197521976219772197821979219802198121982219832198421985219862198721988219892199021991219922199321994219952199621997219982199922000220012200222003220042200522006220072200822009220102201122012220132201422015220162201722018220192202022021220222202322024220252202622027220282202922030220312203222033220342203522036220372203822039220402204122042220432204422045220462204722048220492205022051220522205322054220552205622057220582205922060220612206222063220642206522066220672206822069220702207122072220732207422075220762207722078220792208022081220822208322084220852208622087220882208922090220912209222093220942209522096220972209822099221002210122102221032210422105221062210722108221092211022111221122211322114221152211622117221182211922120221212212222123221242212522126221272212822129221302213122132221332213422135221362213722138221392214022141221422214322144221452214622147221482214922150221512215222153221542215522156221572215822159221602216122162221632216422165221662216722168221692217022171221722217322174221752217622177221782217922180221812218222183221842218522186221872218822189221902219122192221932219422195221962219722198221992220022201222022220322204222052220622207222082220922210222112221222213222142221522216222172221822219222202222122222222232222422225222262222722228222292223022231222322223322234222352223622237222382223922240222412224222243222442224522246222472224822249222502225122252222532225422255222562225722258222592226022261222622226322264222652226622267222682226922270222712227222273222742227522276222772227822279222802228122282222832228422285222862228722288222892229022291222922229322294222952229622297222982229922300223012230222303223042230522306223072230822309223102231122312223132231422315223162231722318223192232022321223222232322324223252232622327223282232922330223312233222333223342233522336223372233822339223402234122342223432234422345223462234722348223492235022351223522235322354223552235622357223582235922360223612236222363223642236522366223672236822369223702237122372223732237422375223762237722378223792238022381223822238322384223852238622387223882238922390223912239222393223942239522396223972239822399224002240122402224032240422405224062240722408224092241022411224122241322414224152241622417224182241922420224212242222423224242242522426224272242822429224302243122432224332243422435224362243722438224392244022441224422244322444224452244622447224482244922450224512245222453224542245522456224572245822459224602246122462224632246422465224662246722468224692247022471224722247322474224752247622477224782247922480224812248222483224842248522486224872248822489224902249122492224932249422495224962249722498224992250022501225022250322504225052250622507225082250922510225112251222513225142251522516225172251822519225202252122522225232252422525225262252722528225292253022531225322253322534225352253622537225382253922540225412254222543225442254522546225472254822549225502255122552225532255422555225562255722558225592256022561225622256322564225652256622567225682256922570225712257222573225742257522576225772257822579225802258122582225832258422585225862258722588225892259022591225922259322594225952259622597225982259922600226012260222603226042260522606226072260822609226102261122612226132261422615226162261722618226192262022621226222262322624226252262622627226282262922630226312263222633226342263522636226372263822639226402264122642226432264422645226462264722648226492265022651226522265322654226552265622657226582265922660226612266222663226642266522666226672266822669226702267122672226732267422675226762267722678226792268022681226822268322684226852268622687226882268922690226912269222693226942269522696226972269822699227002270122702227032270422705227062270722708227092271022711227122271322714227152271622717227182271922720227212272222723227242272522726227272272822729227302273122732227332273422735227362273722738227392274022741227422274322744227452274622747227482274922750227512275222753227542275522756227572275822759227602276122762227632276422765227662276722768227692277022771227722277322774227752277622777227782277922780227812278222783227842278522786227872278822789227902279122792227932279422795227962279722798227992280022801228022280322804228052280622807228082280922810228112281222813228142281522816228172281822819228202282122822228232282422825228262282722828228292283022831228322283322834228352283622837228382283922840228412284222843228442284522846228472284822849228502285122852228532285422855228562285722858228592286022861228622286322864228652286622867228682286922870228712287222873228742287522876228772287822879228802288122882228832288422885228862288722888228892289022891228922289322894228952289622897228982289922900229012290222903229042290522906229072290822909229102291122912229132291422915229162291722918229192292022921229222292322924229252292622927229282292922930229312293222933229342293522936229372293822939229402294122942229432294422945229462294722948229492295022951229522295322954229552295622957229582295922960229612296222963229642296522966229672296822969229702297122972229732297422975229762297722978229792298022981229822298322984229852298622987229882298922990229912299222993229942299522996229972299822999230002300123002230032300423005230062300723008230092301023011230122301323014230152301623017230182301923020230212302223023230242302523026230272302823029230302303123032230332303423035230362303723038230392304023041230422304323044230452304623047230482304923050230512305223053230542305523056230572305823059230602306123062230632306423065230662306723068230692307023071230722307323074230752307623077230782307923080230812308223083230842308523086230872308823089230902309123092230932309423095230962309723098230992310023101231022310323104231052310623107231082310923110231112311223113231142311523116231172311823119231202312123122231232312423125231262312723128231292313023131231322313323134231352313623137231382313923140231412314223143231442314523146231472314823149231502315123152231532315423155231562315723158231592316023161231622316323164231652316623167231682316923170231712317223173231742317523176231772317823179231802318123182231832318423185231862318723188231892319023191231922319323194231952319623197231982319923200232012320223203232042320523206232072320823209232102321123212232132321423215232162321723218232192322023221232222322323224232252322623227232282322923230232312323223233232342323523236232372323823239232402324123242232432324423245232462324723248232492325023251232522325323254232552325623257232582325923260232612326223263232642326523266232672326823269232702327123272232732327423275232762327723278232792328023281232822328323284232852328623287232882328923290232912329223293232942329523296232972329823299233002330123302233032330423305233062330723308233092331023311233122331323314233152331623317233182331923320233212332223323233242332523326233272332823329233302333123332233332333423335233362333723338233392334023341233422334323344233452334623347233482334923350233512335223353233542335523356233572335823359233602336123362233632336423365233662336723368233692337023371233722337323374233752337623377233782337923380233812338223383233842338523386233872338823389233902339123392233932339423395233962339723398233992340023401234022340323404234052340623407234082340923410234112341223413234142341523416234172341823419234202342123422234232342423425234262342723428234292343023431234322343323434234352343623437234382343923440234412344223443234442344523446234472344823449234502345123452234532345423455234562345723458234592346023461234622346323464234652346623467234682346923470234712347223473234742347523476234772347823479234802348123482234832348423485234862348723488234892349023491234922349323494234952349623497234982349923500235012350223503235042350523506235072350823509235102351123512235132351423515235162351723518235192352023521235222352323524235252352623527235282352923530235312353223533235342353523536235372353823539235402354123542235432354423545235462354723548235492355023551235522355323554235552355623557235582355923560235612356223563235642356523566235672356823569235702357123572235732357423575235762357723578235792358023581235822358323584235852358623587235882358923590235912359223593235942359523596235972359823599236002360123602236032360423605236062360723608236092361023611236122361323614236152361623617236182361923620236212362223623236242362523626236272362823629236302363123632236332363423635236362363723638236392364023641236422364323644236452364623647236482364923650236512365223653236542365523656236572365823659236602366123662236632366423665236662366723668236692367023671236722367323674236752367623677236782367923680236812368223683236842368523686236872368823689236902369123692236932369423695236962369723698236992370023701237022370323704237052370623707237082370923710237112371223713237142371523716237172371823719237202372123722237232372423725237262372723728237292373023731237322373323734237352373623737237382373923740237412374223743237442374523746237472374823749237502375123752237532375423755237562375723758237592376023761237622376323764237652376623767237682376923770237712377223773237742377523776237772377823779237802378123782237832378423785237862378723788237892379023791237922379323794237952379623797237982379923800238012380223803238042380523806238072380823809238102381123812238132381423815238162381723818238192382023821238222382323824238252382623827238282382923830238312383223833238342383523836238372383823839238402384123842238432384423845238462384723848238492385023851238522385323854238552385623857238582385923860238612386223863238642386523866238672386823869238702387123872238732387423875238762387723878238792388023881238822388323884238852388623887238882388923890238912389223893238942389523896238972389823899239002390123902239032390423905239062390723908239092391023911239122391323914239152391623917239182391923920239212392223923239242392523926239272392823929239302393123932239332393423935239362393723938239392394023941239422394323944239452394623947239482394923950239512395223953239542395523956239572395823959239602396123962239632396423965239662396723968239692397023971239722397323974239752397623977239782397923980239812398223983239842398523986239872398823989239902399123992239932399423995239962399723998239992400024001240022400324004240052400624007240082400924010240112401224013240142401524016240172401824019240202402124022240232402424025240262402724028240292403024031240322403324034240352403624037240382403924040240412404224043240442404524046240472404824049240502405124052240532405424055240562405724058240592406024061240622406324064240652406624067240682406924070240712407224073240742407524076240772407824079240802408124082240832408424085240862408724088240892409024091240922409324094240952409624097240982409924100241012410224103241042410524106241072410824109241102411124112241132411424115241162411724118241192412024121241222412324124241252412624127241282412924130241312413224133241342413524136241372413824139241402414124142241432414424145241462414724148241492415024151241522415324154241552415624157241582415924160241612416224163241642416524166241672416824169241702417124172241732417424175241762417724178241792418024181241822418324184241852418624187241882418924190241912419224193241942419524196241972419824199242002420124202242032420424205242062420724208242092421024211242122421324214242152421624217242182421924220242212422224223242242422524226242272422824229242302423124232242332423424235242362423724238242392424024241242422424324244242452424624247242482424924250242512425224253242542425524256242572425824259242602426124262242632426424265242662426724268242692427024271242722427324274242752427624277242782427924280242812428224283242842428524286242872428824289242902429124292242932429424295242962429724298242992430024301243022430324304243052430624307243082430924310243112431224313243142431524316243172431824319243202432124322243232432424325243262432724328243292433024331243322433324334243352433624337243382433924340243412434224343243442434524346243472434824349243502435124352243532435424355243562435724358243592436024361243622436324364243652436624367243682436924370243712437224373243742437524376243772437824379243802438124382243832438424385243862438724388243892439024391243922439324394243952439624397243982439924400244012440224403244042440524406244072440824409244102441124412244132441424415244162441724418244192442024421244222442324424244252442624427244282442924430244312443224433244342443524436244372443824439244402444124442244432444424445244462444724448244492445024451244522445324454244552445624457244582445924460244612446224463244642446524466244672446824469244702447124472244732447424475244762447724478244792448024481244822448324484244852448624487244882448924490244912449224493244942449524496244972449824499245002450124502245032450424505245062450724508245092451024511245122451324514245152451624517245182451924520245212452224523245242452524526245272452824529245302453124532245332453424535245362453724538245392454024541245422454324544245452454624547245482454924550245512455224553245542455524556245572455824559245602456124562245632456424565245662456724568245692457024571245722457324574245752457624577245782457924580245812458224583245842458524586245872458824589245902459124592245932459424595245962459724598245992460024601246022460324604246052460624607246082460924610246112461224613246142461524616246172461824619246202462124622246232462424625246262462724628246292463024631246322463324634246352463624637246382463924640246412464224643246442464524646246472464824649246502465124652246532465424655246562465724658246592466024661246622466324664246652466624667246682466924670246712467224673246742467524676246772467824679246802468124682246832468424685246862468724688246892469024691246922469324694246952469624697246982469924700247012470224703247042470524706247072470824709247102471124712247132471424715247162471724718247192472024721247222472324724247252472624727247282472924730247312473224733247342473524736247372473824739247402474124742247432474424745247462474724748247492475024751247522475324754247552475624757247582475924760247612476224763247642476524766247672476824769247702477124772247732477424775247762477724778247792478024781247822478324784247852478624787247882478924790247912479224793247942479524796247972479824799248002480124802248032480424805248062480724808248092481024811248122481324814248152481624817248182481924820248212482224823248242482524826248272482824829248302483124832248332483424835248362483724838248392484024841248422484324844248452484624847248482484924850248512485224853248542485524856248572485824859248602486124862248632486424865248662486724868248692487024871248722487324874248752487624877248782487924880248812488224883248842488524886248872488824889248902489124892248932489424895248962489724898248992490024901249022490324904249052490624907249082490924910249112491224913249142491524916249172491824919249202492124922249232492424925249262492724928249292493024931249322493324934249352493624937249382493924940249412494224943249442494524946249472494824949249502495124952249532495424955249562495724958249592496024961249622496324964249652496624967249682496924970249712497224973249742497524976249772497824979249802498124982249832498424985249862498724988249892499024991249922499324994249952499624997249982499925000250012500225003250042500525006250072500825009250102501125012250132501425015250162501725018250192502025021250222502325024250252502625027250282502925030250312503225033250342503525036250372503825039250402504125042250432504425045250462504725048250492505025051250522505325054250552505625057250582505925060250612506225063250642506525066250672506825069250702507125072250732507425075250762507725078250792508025081250822508325084250852508625087250882508925090250912509225093250942509525096250972509825099251002510125102251032510425105251062510725108251092511025111251122511325114251152511625117251182511925120251212512225123251242512525126251272512825129251302513125132251332513425135251362513725138251392514025141251422514325144251452514625147251482514925150251512515225153251542515525156251572515825159251602516125162251632516425165251662516725168251692517025171251722517325174251752517625177251782517925180251812518225183251842518525186251872518825189251902519125192251932519425195251962519725198251992520025201252022520325204252052520625207252082520925210252112521225213252142521525216252172521825219252202522125222252232522425225252262522725228252292523025231252322523325234252352523625237252382523925240252412524225243252442524525246252472524825249252502525125252252532525425255252562525725258252592526025261252622526325264252652526625267252682526925270252712527225273252742527525276252772527825279252802528125282252832528425285252862528725288252892529025291252922529325294252952529625297252982529925300253012530225303253042530525306253072530825309253102531125312253132531425315253162531725318253192532025321253222532325324253252532625327253282532925330253312533225333253342533525336253372533825339253402534125342253432534425345253462534725348253492535025351253522535325354253552535625357253582535925360253612536225363253642536525366253672536825369253702537125372253732537425375253762537725378253792538025381253822538325384253852538625387253882538925390253912539225393253942539525396253972539825399254002540125402254032540425405254062540725408254092541025411254122541325414254152541625417254182541925420254212542225423254242542525426254272542825429254302543125432254332543425435254362543725438254392544025441254422544325444254452544625447254482544925450254512545225453254542545525456254572545825459254602546125462254632546425465254662546725468254692547025471254722547325474254752547625477254782547925480254812548225483254842548525486254872548825489254902549125492254932549425495254962549725498254992550025501255022550325504255052550625507255082550925510255112551225513255142551525516255172551825519255202552125522255232552425525255262552725528255292553025531255322553325534255352553625537255382553925540255412554225543255442554525546255472554825549255502555125552255532555425555255562555725558255592556025561255622556325564255652556625567255682556925570255712557225573255742557525576255772557825579255802558125582255832558425585255862558725588255892559025591255922559325594255952559625597255982559925600256012560225603256042560525606256072560825609256102561125612256132561425615256162561725618256192562025621256222562325624256252562625627256282562925630256312563225633256342563525636256372563825639256402564125642256432564425645256462564725648256492565025651256522565325654256552565625657256582565925660256612566225663256642566525666256672566825669256702567125672256732567425675256762567725678256792568025681256822568325684256852568625687256882568925690256912569225693256942569525696256972569825699257002570125702257032570425705257062570725708257092571025711257122571325714257152571625717257182571925720257212572225723257242572525726257272572825729257302573125732257332573425735257362573725738257392574025741257422574325744257452574625747257482574925750257512575225753257542575525756257572575825759257602576125762257632576425765257662576725768257692577025771257722577325774257752577625777257782577925780257812578225783257842578525786257872578825789257902579125792257932579425795257962579725798257992580025801258022580325804258052580625807258082580925810258112581225813258142581525816258172581825819258202582125822258232582425825258262582725828258292583025831258322583325834258352583625837258382583925840258412584225843258442584525846258472584825849258502585125852258532585425855258562585725858258592586025861258622586325864258652586625867258682586925870258712587225873258742587525876258772587825879258802588125882258832588425885258862588725888258892589025891258922589325894258952589625897258982589925900259012590225903259042590525906259072590825909259102591125912259132591425915259162591725918259192592025921259222592325924259252592625927259282592925930259312593225933259342593525936259372593825939259402594125942259432594425945259462594725948259492595025951259522595325954259552595625957259582595925960259612596225963259642596525966259672596825969259702597125972259732597425975259762597725978259792598025981259822598325984259852598625987259882598925990259912599225993259942599525996259972599825999260002600126002260032600426005260062600726008260092601026011260122601326014260152601626017260182601926020260212602226023260242602526026260272602826029260302603126032260332603426035260362603726038260392604026041260422604326044260452604626047260482604926050260512605226053260542605526056260572605826059260602606126062260632606426065260662606726068260692607026071260722607326074260752607626077260782607926080260812608226083260842608526086260872608826089260902609126092260932609426095260962609726098260992610026101261022610326104261052610626107261082610926110261112611226113261142611526116261172611826119261202612126122261232612426125261262612726128261292613026131261322613326134261352613626137261382613926140261412614226143261442614526146261472614826149261502615126152261532615426155261562615726158261592616026161261622616326164261652616626167261682616926170261712617226173261742617526176261772617826179261802618126182261832618426185261862618726188261892619026191261922619326194261952619626197261982619926200262012620226203262042620526206262072620826209262102621126212262132621426215262162621726218262192622026221262222622326224262252622626227262282622926230262312623226233262342623526236262372623826239262402624126242262432624426245262462624726248262492625026251262522625326254262552625626257262582625926260262612626226263262642626526266262672626826269262702627126272262732627426275262762627726278262792628026281262822628326284262852628626287262882628926290262912629226293262942629526296262972629826299263002630126302263032630426305263062630726308263092631026311263122631326314263152631626317263182631926320263212632226323263242632526326263272632826329263302633126332263332633426335263362633726338263392634026341263422634326344263452634626347263482634926350263512635226353263542635526356263572635826359263602636126362263632636426365263662636726368263692637026371263722637326374263752637626377263782637926380263812638226383263842638526386263872638826389263902639126392263932639426395263962639726398263992640026401264022640326404264052640626407264082640926410264112641226413264142641526416264172641826419264202642126422264232642426425264262642726428264292643026431264322643326434264352643626437264382643926440264412644226443264442644526446264472644826449264502645126452264532645426455264562645726458264592646026461264622646326464264652646626467264682646926470264712647226473264742647526476264772647826479264802648126482264832648426485264862648726488264892649026491264922649326494264952649626497264982649926500265012650226503265042650526506265072650826509265102651126512265132651426515265162651726518265192652026521265222652326524265252652626527265282652926530265312653226533265342653526536265372653826539265402654126542265432654426545265462654726548265492655026551265522655326554265552655626557265582655926560265612656226563265642656526566265672656826569265702657126572265732657426575265762657726578265792658026581265822658326584265852658626587265882658926590265912659226593265942659526596265972659826599266002660126602266032660426605266062660726608266092661026611266122661326614266152661626617266182661926620266212662226623266242662526626266272662826629266302663126632266332663426635266362663726638266392664026641266422664326644266452664626647266482664926650266512665226653266542665526656266572665826659266602666126662266632666426665266662666726668266692667026671266722667326674266752667626677266782667926680266812668226683266842668526686266872668826689266902669126692266932669426695266962669726698266992670026701267022670326704267052670626707267082670926710267112671226713267142671526716267172671826719267202672126722267232672426725267262672726728267292673026731267322673326734267352673626737267382673926740267412674226743267442674526746267472674826749267502675126752267532675426755267562675726758267592676026761267622676326764267652676626767267682676926770267712677226773267742677526776267772677826779267802678126782267832678426785267862678726788267892679026791267922679326794267952679626797267982679926800268012680226803268042680526806268072680826809268102681126812268132681426815268162681726818268192682026821268222682326824268252682626827268282682926830268312683226833268342683526836268372683826839268402684126842268432684426845268462684726848268492685026851268522685326854268552685626857268582685926860268612686226863268642686526866268672686826869268702687126872268732687426875268762687726878268792688026881268822688326884268852688626887268882688926890268912689226893268942689526896268972689826899269002690126902269032690426905269062690726908269092691026911269122691326914269152691626917269182691926920269212692226923269242692526926269272692826929269302693126932269332693426935269362693726938269392694026941269422694326944269452694626947269482694926950269512695226953269542695526956269572695826959269602696126962269632696426965269662696726968269692697026971269722697326974269752697626977269782697926980269812698226983269842698526986269872698826989269902699126992269932699426995269962699726998269992700027001270022700327004270052700627007270082700927010270112701227013270142701527016270172701827019270202702127022270232702427025270262702727028270292703027031270322703327034270352703627037270382703927040270412704227043270442704527046270472704827049270502705127052270532705427055270562705727058270592706027061270622706327064270652706627067270682706927070270712707227073270742707527076270772707827079270802708127082270832708427085270862708727088270892709027091270922709327094270952709627097270982709927100271012710227103271042710527106271072710827109271102711127112271132711427115271162711727118271192712027121271222712327124271252712627127271282712927130271312713227133271342713527136271372713827139271402714127142271432714427145271462714727148271492715027151271522715327154271552715627157271582715927160271612716227163271642716527166271672716827169271702717127172271732717427175271762717727178271792718027181271822718327184271852718627187271882718927190271912719227193271942719527196271972719827199272002720127202272032720427205272062720727208272092721027211272122721327214272152721627217272182721927220272212722227223272242722527226272272722827229272302723127232272332723427235272362723727238272392724027241272422724327244272452724627247272482724927250272512725227253272542725527256272572725827259272602726127262272632726427265272662726727268272692727027271272722727327274272752727627277272782727927280272812728227283272842728527286272872728827289272902729127292272932729427295272962729727298272992730027301273022730327304273052730627307273082730927310273112731227313273142731527316273172731827319273202732127322273232732427325273262732727328273292733027331273322733327334273352733627337273382733927340273412734227343273442734527346273472734827349273502735127352273532735427355273562735727358273592736027361273622736327364273652736627367273682736927370273712737227373273742737527376273772737827379273802738127382273832738427385273862738727388273892739027391273922739327394273952739627397273982739927400274012740227403274042740527406274072740827409274102741127412274132741427415274162741727418274192742027421274222742327424274252742627427274282742927430274312743227433274342743527436274372743827439274402744127442274432744427445274462744727448274492745027451274522745327454274552745627457274582745927460274612746227463274642746527466274672746827469274702747127472274732747427475274762747727478274792748027481274822748327484274852748627487274882748927490274912749227493274942749527496274972749827499275002750127502275032750427505275062750727508275092751027511275122751327514275152751627517275182751927520275212752227523275242752527526275272752827529275302753127532275332753427535275362753727538275392754027541275422754327544275452754627547275482754927550275512755227553275542755527556275572755827559275602756127562275632756427565275662756727568275692757027571275722757327574275752757627577275782757927580275812758227583275842758527586275872758827589275902759127592275932759427595275962759727598275992760027601276022760327604276052760627607276082760927610276112761227613276142761527616276172761827619276202762127622276232762427625276262762727628276292763027631276322763327634276352763627637276382763927640276412764227643276442764527646276472764827649276502765127652276532765427655276562765727658276592766027661276622766327664276652766627667276682766927670276712767227673276742767527676276772767827679276802768127682276832768427685276862768727688276892769027691276922769327694276952769627697276982769927700277012770227703277042770527706277072770827709277102771127712277132771427715277162771727718277192772027721277222772327724277252772627727277282772927730277312773227733277342773527736277372773827739277402774127742277432774427745277462774727748277492775027751277522775327754277552775627757277582775927760277612776227763277642776527766277672776827769277702777127772277732777427775277762777727778277792778027781277822778327784277852778627787277882778927790277912779227793277942779527796277972779827799278002780127802278032780427805278062780727808278092781027811278122781327814278152781627817278182781927820278212782227823278242782527826278272782827829278302783127832278332783427835278362783727838278392784027841278422784327844278452784627847278482784927850278512785227853278542785527856278572785827859278602786127862278632786427865278662786727868278692787027871278722787327874278752787627877278782787927880278812788227883278842788527886278872788827889278902789127892278932789427895278962789727898278992790027901279022790327904279052790627907279082790927910279112791227913279142791527916279172791827919279202792127922279232792427925279262792727928279292793027931279322793327934279352793627937279382793927940279412794227943279442794527946279472794827949279502795127952279532795427955279562795727958279592796027961279622796327964279652796627967279682796927970279712797227973279742797527976279772797827979279802798127982279832798427985279862798727988279892799027991279922799327994279952799627997279982799928000280012800228003280042800528006280072800828009280102801128012280132801428015280162801728018280192802028021280222802328024280252802628027280282802928030280312803228033280342803528036280372803828039280402804128042280432804428045280462804728048280492805028051280522805328054280552805628057280582805928060280612806228063280642806528066280672806828069280702807128072280732807428075280762807728078280792808028081280822808328084280852808628087280882808928090280912809228093280942809528096280972809828099281002810128102281032810428105281062810728108281092811028111281122811328114281152811628117281182811928120281212812228123281242812528126281272812828129281302813128132281332813428135281362813728138281392814028141281422814328144281452814628147281482814928150281512815228153281542815528156281572815828159281602816128162281632816428165281662816728168281692817028171281722817328174281752817628177281782817928180281812818228183281842818528186281872818828189281902819128192281932819428195281962819728198281992820028201282022820328204282052820628207282082820928210282112821228213282142821528216282172821828219282202822128222282232822428225282262822728228282292823028231282322823328234282352823628237282382823928240282412824228243282442824528246282472824828249282502825128252282532825428255282562825728258282592826028261282622826328264282652826628267282682826928270282712827228273282742827528276282772827828279282802828128282282832828428285282862828728288282892829028291282922829328294282952829628297282982829928300283012830228303283042830528306283072830828309283102831128312283132831428315283162831728318283192832028321283222832328324283252832628327283282832928330283312833228333283342833528336283372833828339283402834128342283432834428345283462834728348283492835028351283522835328354283552835628357283582835928360283612836228363283642836528366283672836828369283702837128372283732837428375283762837728378283792838028381283822838328384283852838628387283882838928390283912839228393283942839528396283972839828399284002840128402284032840428405284062840728408284092841028411284122841328414284152841628417284182841928420284212842228423284242842528426284272842828429284302843128432284332843428435284362843728438284392844028441284422844328444284452844628447284482844928450284512845228453284542845528456284572845828459284602846128462284632846428465284662846728468284692847028471284722847328474284752847628477284782847928480284812848228483284842848528486284872848828489284902849128492284932849428495284962849728498284992850028501285022850328504285052850628507285082850928510285112851228513285142851528516285172851828519285202852128522285232852428525285262852728528285292853028531285322853328534285352853628537285382853928540285412854228543285442854528546285472854828549285502855128552285532855428555285562855728558285592856028561285622856328564285652856628567285682856928570285712857228573285742857528576285772857828579285802858128582285832858428585285862858728588285892859028591285922859328594285952859628597285982859928600286012860228603286042860528606286072860828609286102861128612286132861428615286162861728618286192862028621286222862328624286252862628627286282862928630286312863228633286342863528636286372863828639286402864128642286432864428645286462864728648286492865028651286522865328654286552865628657286582865928660286612866228663286642866528666286672866828669286702867128672286732867428675286762867728678286792868028681286822868328684286852868628687286882868928690286912869228693286942869528696286972869828699287002870128702287032870428705287062870728708287092871028711287122871328714287152871628717287182871928720287212872228723287242872528726287272872828729287302873128732287332873428735287362873728738287392874028741287422874328744287452874628747287482874928750287512875228753287542875528756287572875828759287602876128762287632876428765287662876728768287692877028771287722877328774287752877628777287782877928780287812878228783287842878528786287872878828789287902879128792287932879428795287962879728798287992880028801288022880328804288052880628807288082880928810288112881228813288142881528816288172881828819288202882128822288232882428825288262882728828288292883028831288322883328834288352883628837288382883928840288412884228843288442884528846288472884828849288502885128852288532885428855288562885728858288592886028861288622886328864288652886628867288682886928870288712887228873288742887528876288772887828879288802888128882288832888428885288862888728888288892889028891288922889328894288952889628897288982889928900289012890228903289042890528906289072890828909289102891128912289132891428915289162891728918289192892028921289222892328924289252892628927289282892928930289312893228933289342893528936289372893828939289402894128942289432894428945289462894728948289492895028951289522895328954289552895628957289582895928960289612896228963289642896528966289672896828969289702897128972289732897428975289762897728978289792898028981289822898328984289852898628987289882898928990289912899228993289942899528996289972899828999290002900129002290032900429005290062900729008290092901029011290122901329014290152901629017290182901929020290212902229023290242902529026290272902829029290302903129032290332903429035290362903729038290392904029041290422904329044290452904629047290482904929050290512905229053290542905529056290572905829059290602906129062290632906429065290662906729068290692907029071290722907329074290752907629077290782907929080290812908229083290842908529086290872908829089290902909129092290932909429095290962909729098290992910029101291022910329104291052910629107291082910929110291112911229113291142911529116291172911829119291202912129122291232912429125291262912729128291292913029131291322913329134291352913629137291382913929140291412914229143291442914529146291472914829149291502915129152291532915429155291562915729158291592916029161291622916329164291652916629167291682916929170291712917229173291742917529176291772917829179291802918129182291832918429185291862918729188291892919029191291922919329194291952919629197291982919929200292012920229203292042920529206292072920829209292102921129212292132921429215292162921729218292192922029221292222922329224292252922629227292282922929230292312923229233292342923529236292372923829239292402924129242292432924429245292462924729248292492925029251292522925329254292552925629257292582925929260292612926229263292642926529266292672926829269292702927129272292732927429275292762927729278292792928029281292822928329284292852928629287292882928929290292912929229293292942929529296292972929829299293002930129302293032930429305293062930729308293092931029311293122931329314293152931629317293182931929320293212932229323293242932529326293272932829329293302933129332293332933429335293362933729338293392934029341293422934329344293452934629347293482934929350293512935229353293542935529356293572935829359293602936129362293632936429365293662936729368293692937029371293722937329374293752937629377293782937929380293812938229383293842938529386293872938829389293902939129392293932939429395293962939729398293992940029401294022940329404294052940629407294082940929410294112941229413294142941529416294172941829419294202942129422294232942429425294262942729428294292943029431294322943329434294352943629437294382943929440294412944229443294442944529446294472944829449294502945129452294532945429455294562945729458294592946029461294622946329464294652946629467294682946929470294712947229473294742947529476294772947829479294802948129482294832948429485294862948729488294892949029491294922949329494294952949629497294982949929500295012950229503295042950529506295072950829509295102951129512295132951429515295162951729518295192952029521295222952329524295252952629527295282952929530295312953229533295342953529536295372953829539295402954129542295432954429545295462954729548295492955029551295522955329554295552955629557295582955929560295612956229563295642956529566295672956829569295702957129572295732957429575295762957729578295792958029581295822958329584295852958629587295882958929590295912959229593295942959529596295972959829599296002960129602296032960429605296062960729608296092961029611296122961329614296152961629617296182961929620296212962229623296242962529626296272962829629296302963129632296332963429635296362963729638296392964029641296422964329644296452964629647296482964929650296512965229653296542965529656296572965829659296602966129662296632966429665296662966729668296692967029671296722967329674296752967629677296782967929680296812968229683296842968529686296872968829689296902969129692296932969429695296962969729698296992970029701297022970329704297052970629707297082970929710297112971229713297142971529716297172971829719297202972129722297232972429725297262972729728297292973029731297322973329734297352973629737297382973929740297412974229743297442974529746297472974829749297502975129752297532975429755297562975729758297592976029761297622976329764297652976629767297682976929770297712977229773297742977529776297772977829779297802978129782297832978429785297862978729788297892979029791297922979329794297952979629797297982979929800298012980229803298042980529806298072980829809298102981129812298132981429815298162981729818298192982029821298222982329824298252982629827298282982929830298312983229833298342983529836298372983829839298402984129842298432984429845298462984729848298492985029851298522985329854298552985629857298582985929860298612986229863298642986529866298672986829869298702987129872298732987429875298762987729878298792988029881298822988329884298852988629887298882988929890298912989229893298942989529896298972989829899299002990129902299032990429905299062990729908299092991029911299122991329914299152991629917299182991929920299212992229923299242992529926299272992829929299302993129932299332993429935299362993729938299392994029941299422994329944299452994629947299482994929950299512995229953299542995529956299572995829959299602996129962299632996429965299662996729968299692997029971299722997329974299752997629977299782997929980299812998229983299842998529986299872998829989299902999129992299932999429995299962999729998299993000030001300023000330004300053000630007300083000930010300113001230013300143001530016300173001830019300203002130022300233002430025300263002730028300293003030031300323003330034300353003630037300383003930040300413004230043300443004530046300473004830049300503005130052300533005430055300563005730058300593006030061300623006330064300653006630067300683006930070300713007230073300743007530076300773007830079300803008130082300833008430085300863008730088300893009030091300923009330094300953009630097300983009930100301013010230103301043010530106301073010830109301103011130112301133011430115301163011730118301193012030121301223012330124301253012630127301283012930130301313013230133301343013530136301373013830139301403014130142301433014430145301463014730148301493015030151301523015330154301553015630157301583015930160301613016230163301643016530166301673016830169301703017130172301733017430175301763017730178301793018030181301823018330184301853018630187301883018930190301913019230193301943019530196301973019830199302003020130202302033020430205302063020730208302093021030211302123021330214302153021630217302183021930220302213022230223302243022530226302273022830229302303023130232302333023430235302363023730238302393024030241302423024330244302453024630247302483024930250302513025230253302543025530256302573025830259302603026130262302633026430265302663026730268302693027030271302723027330274302753027630277302783027930280302813028230283302843028530286302873028830289302903029130292302933029430295302963029730298302993030030301303023030330304303053030630307303083030930310303113031230313303143031530316303173031830319303203032130322303233032430325303263032730328303293033030331303323033330334303353033630337303383033930340303413034230343303443034530346303473034830349303503035130352303533035430355303563035730358303593036030361303623036330364303653036630367303683036930370303713037230373303743037530376303773037830379303803038130382303833038430385303863038730388303893039030391303923039330394303953039630397303983039930400304013040230403304043040530406304073040830409304103041130412304133041430415304163041730418304193042030421304223042330424304253042630427304283042930430304313043230433304343043530436304373043830439304403044130442304433044430445304463044730448304493045030451304523045330454304553045630457304583045930460304613046230463304643046530466304673046830469304703047130472304733047430475304763047730478304793048030481304823048330484304853048630487304883048930490304913049230493304943049530496304973049830499305003050130502305033050430505305063050730508305093051030511305123051330514305153051630517305183051930520305213052230523305243052530526305273052830529305303053130532305333053430535305363053730538305393054030541305423054330544305453054630547305483054930550305513055230553305543055530556305573055830559305603056130562305633056430565305663056730568305693057030571305723057330574305753057630577305783057930580305813058230583305843058530586305873058830589305903059130592305933059430595305963059730598305993060030601306023060330604306053060630607306083060930610306113061230613306143061530616306173061830619306203062130622306233062430625306263062730628306293063030631306323063330634306353063630637306383063930640306413064230643306443064530646306473064830649306503065130652306533065430655306563065730658306593066030661306623066330664306653066630667306683066930670306713067230673306743067530676306773067830679306803068130682306833068430685306863068730688306893069030691306923069330694306953069630697306983069930700307013070230703307043070530706307073070830709307103071130712307133071430715307163071730718307193072030721307223072330724307253072630727307283072930730307313073230733307343073530736307373073830739307403074130742307433074430745307463074730748307493075030751307523075330754307553075630757307583075930760307613076230763307643076530766307673076830769307703077130772307733077430775307763077730778307793078030781307823078330784307853078630787307883078930790307913079230793307943079530796307973079830799308003080130802308033080430805308063080730808308093081030811308123081330814308153081630817308183081930820308213082230823308243082530826308273082830829308303083130832308333083430835308363083730838308393084030841308423084330844308453084630847308483084930850308513085230853308543085530856308573085830859308603086130862308633086430865308663086730868308693087030871308723087330874308753087630877308783087930880308813088230883308843088530886308873088830889308903089130892308933089430895308963089730898308993090030901309023090330904309053090630907309083090930910309113091230913309143091530916309173091830919309203092130922309233092430925309263092730928309293093030931309323093330934309353093630937309383093930940309413094230943309443094530946309473094830949309503095130952309533095430955309563095730958309593096030961309623096330964309653096630967309683096930970309713097230973309743097530976309773097830979309803098130982309833098430985309863098730988309893099030991309923099330994309953099630997309983099931000310013100231003310043100531006310073100831009310103101131012310133101431015310163101731018310193102031021310223102331024310253102631027310283102931030310313103231033310343103531036310373103831039310403104131042310433104431045310463104731048310493105031051310523105331054310553105631057310583105931060310613106231063310643106531066310673106831069310703107131072310733107431075310763107731078310793108031081310823108331084310853108631087310883108931090310913109231093310943109531096310973109831099311003110131102311033110431105311063110731108311093111031111311123111331114311153111631117311183111931120311213112231123311243112531126311273112831129311303113131132311333113431135311363113731138311393114031141311423114331144311453114631147311483114931150311513115231153311543115531156311573115831159311603116131162311633116431165311663116731168311693117031171311723117331174311753117631177311783117931180311813118231183311843118531186311873118831189311903119131192311933119431195311963119731198311993120031201312023120331204312053120631207312083120931210312113121231213312143121531216312173121831219312203122131222312233122431225312263122731228312293123031231312323123331234312353123631237312383123931240312413124231243312443124531246312473124831249312503125131252312533125431255312563125731258312593126031261312623126331264312653126631267312683126931270312713127231273312743127531276312773127831279312803128131282312833128431285312863128731288312893129031291312923129331294312953129631297312983129931300313013130231303313043130531306313073130831309313103131131312313133131431315313163131731318313193132031321313223132331324313253132631327313283132931330313313133231333313343133531336313373133831339313403134131342313433134431345313463134731348313493135031351313523135331354313553135631357313583135931360313613136231363313643136531366313673136831369313703137131372313733137431375313763137731378313793138031381313823138331384313853138631387313883138931390313913139231393313943139531396313973139831399314003140131402314033140431405314063140731408314093141031411314123141331414314153141631417314183141931420314213142231423314243142531426314273142831429314303143131432314333143431435314363143731438314393144031441314423144331444314453144631447314483144931450314513145231453314543145531456314573145831459314603146131462314633146431465314663146731468314693147031471314723147331474314753147631477314783147931480314813148231483314843148531486314873148831489314903149131492314933149431495314963149731498314993150031501315023150331504315053150631507315083150931510315113151231513315143151531516315173151831519315203152131522315233152431525315263152731528315293153031531315323153331534315353153631537315383153931540315413154231543315443154531546315473154831549315503155131552315533155431555315563155731558315593156031561315623156331564315653156631567315683156931570315713157231573315743157531576315773157831579315803158131582315833158431585315863158731588315893159031591315923159331594315953159631597315983159931600316013160231603316043160531606316073160831609316103161131612316133161431615316163161731618316193162031621316223162331624316253162631627316283162931630316313163231633316343163531636316373163831639316403164131642316433164431645316463164731648316493165031651316523165331654316553165631657316583165931660316613166231663316643166531666316673166831669316703167131672316733167431675316763167731678316793168031681316823168331684316853168631687316883168931690316913169231693316943169531696316973169831699317003170131702317033170431705317063170731708317093171031711317123171331714317153171631717317183171931720317213172231723317243172531726317273172831729317303173131732317333173431735317363173731738317393174031741317423174331744317453174631747317483174931750317513175231753317543175531756317573175831759317603176131762317633176431765317663176731768317693177031771317723177331774317753177631777317783177931780317813178231783317843178531786317873178831789317903179131792317933179431795317963179731798317993180031801318023180331804318053180631807318083180931810318113181231813318143181531816318173181831819318203182131822318233182431825318263182731828318293183031831318323183331834318353183631837318383183931840318413184231843318443184531846318473184831849318503185131852318533185431855318563185731858318593186031861318623186331864318653186631867318683186931870318713187231873318743187531876318773187831879318803188131882318833188431885318863188731888318893189031891318923189331894318953189631897318983189931900319013190231903319043190531906319073190831909319103191131912319133191431915319163191731918319193192031921319223192331924319253192631927319283192931930319313193231933319343193531936319373193831939319403194131942319433194431945319463194731948319493195031951319523195331954319553195631957319583195931960319613196231963319643196531966319673196831969319703197131972319733197431975319763197731978319793198031981319823198331984319853198631987319883198931990319913199231993319943199531996319973199831999320003200132002320033200432005320063200732008320093201032011320123201332014320153201632017320183201932020320213202232023320243202532026320273202832029320303203132032320333203432035320363203732038320393204032041320423204332044320453204632047320483204932050320513205232053320543205532056320573205832059320603206132062320633206432065320663206732068320693207032071320723207332074320753207632077320783207932080320813208232083320843208532086320873208832089320903209132092320933209432095320963209732098320993210032101321023210332104321053210632107321083210932110321113211232113321143211532116321173211832119321203212132122321233212432125321263212732128321293213032131321323213332134321353213632137321383213932140321413214232143321443214532146321473214832149321503215132152321533215432155321563215732158321593216032161321623216332164321653216632167321683216932170321713217232173321743217532176321773217832179321803218132182321833218432185321863218732188321893219032191321923219332194321953219632197321983219932200322013220232203322043220532206322073220832209322103221132212322133221432215322163221732218322193222032221322223222332224322253222632227322283222932230322313223232233322343223532236322373223832239322403224132242322433224432245322463224732248322493225032251322523225332254322553225632257322583225932260322613226232263322643226532266322673226832269322703227132272322733227432275322763227732278322793228032281322823228332284322853228632287322883228932290322913229232293322943229532296322973229832299323003230132302323033230432305323063230732308323093231032311323123231332314323153231632317323183231932320323213232232323323243232532326323273232832329323303233132332323333233432335323363233732338323393234032341323423234332344323453234632347323483234932350323513235232353323543235532356323573235832359323603236132362323633236432365323663236732368323693237032371323723237332374323753237632377323783237932380323813238232383323843238532386323873238832389323903239132392323933239432395323963239732398323993240032401324023240332404324053240632407324083240932410324113241232413324143241532416324173241832419324203242132422324233242432425324263242732428324293243032431324323243332434324353243632437324383243932440324413244232443324443244532446324473244832449324503245132452324533245432455324563245732458324593246032461324623246332464324653246632467324683246932470324713247232473324743247532476324773247832479324803248132482324833248432485324863248732488324893249032491324923249332494324953249632497324983249932500325013250232503325043250532506325073250832509325103251132512325133251432515325163251732518325193252032521325223252332524325253252632527325283252932530325313253232533325343253532536325373253832539325403254132542325433254432545325463254732548325493255032551325523255332554325553255632557325583255932560325613256232563325643256532566325673256832569325703257132572325733257432575325763257732578325793258032581325823258332584325853258632587325883258932590325913259232593325943259532596325973259832599326003260132602326033260432605326063260732608326093261032611326123261332614326153261632617326183261932620326213262232623326243262532626326273262832629326303263132632326333263432635326363263732638326393264032641326423264332644326453264632647326483264932650326513265232653326543265532656326573265832659326603266132662326633266432665326663266732668326693267032671326723267332674326753267632677326783267932680326813268232683326843268532686326873268832689326903269132692326933269432695326963269732698326993270032701327023270332704327053270632707327083270932710327113271232713327143271532716327173271832719327203272132722327233272432725327263272732728327293273032731327323273332734327353273632737327383273932740327413274232743327443274532746327473274832749327503275132752327533275432755327563275732758327593276032761327623276332764327653276632767327683276932770327713277232773327743277532776327773277832779327803278132782327833278432785327863278732788327893279032791327923279332794327953279632797327983279932800328013280232803328043280532806328073280832809328103281132812328133281432815328163281732818328193282032821328223282332824328253282632827328283282932830328313283232833328343283532836328373283832839328403284132842328433284432845328463284732848328493285032851328523285332854328553285632857328583285932860328613286232863328643286532866328673286832869328703287132872328733287432875328763287732878328793288032881328823288332884328853288632887328883288932890328913289232893328943289532896328973289832899329003290132902329033290432905329063290732908329093291032911329123291332914329153291632917329183291932920329213292232923329243292532926329273292832929329303293132932329333293432935329363293732938329393294032941329423294332944329453294632947329483294932950329513295232953329543295532956329573295832959329603296132962329633296432965329663296732968329693297032971329723297332974329753297632977329783297932980329813298232983329843298532986329873298832989329903299132992329933299432995329963299732998329993300033001330023300333004330053300633007330083300933010330113301233013330143301533016330173301833019330203302133022330233302433025330263302733028330293303033031330323303333034330353303633037330383303933040330413304233043330443304533046330473304833049330503305133052330533305433055330563305733058330593306033061330623306333064330653306633067330683306933070330713307233073330743307533076330773307833079330803308133082330833308433085330863308733088330893309033091330923309333094330953309633097330983309933100331013310233103331043310533106331073310833109331103311133112331133311433115331163311733118331193312033121331223312333124331253312633127331283312933130331313313233133331343313533136331373313833139331403314133142331433314433145331463314733148331493315033151331523315333154331553315633157331583315933160331613316233163331643316533166331673316833169331703317133172331733317433175331763317733178331793318033181331823318333184331853318633187331883318933190331913319233193331943319533196331973319833199332003320133202332033320433205332063320733208332093321033211332123321333214332153321633217332183321933220332213322233223332243322533226332273322833229332303323133232332333323433235332363323733238332393324033241332423324333244332453324633247332483324933250332513325233253332543325533256332573325833259332603326133262332633326433265332663326733268332693327033271332723327333274332753327633277332783327933280332813328233283332843328533286332873328833289332903329133292332933329433295332963329733298332993330033301333023330333304333053330633307333083330933310333113331233313333143331533316333173331833319333203332133322333233332433325333263332733328333293333033331333323333333334333353333633337333383333933340333413334233343333443334533346333473334833349333503335133352333533335433355333563335733358333593336033361333623336333364333653336633367333683336933370333713337233373333743337533376333773337833379333803338133382333833338433385333863338733388333893339033391333923339333394333953339633397333983339933400334013340233403334043340533406334073340833409334103341133412334133341433415334163341733418334193342033421334223342333424334253342633427334283342933430334313343233433334343343533436334373343833439334403344133442334433344433445334463344733448334493345033451334523345333454334553345633457334583345933460334613346233463334643346533466334673346833469334703347133472334733347433475334763347733478334793348033481334823348333484334853348633487334883348933490334913349233493334943349533496334973349833499335003350133502335033350433505335063350733508335093351033511335123351333514335153351633517335183351933520335213352233523335243352533526335273352833529335303353133532335333353433535335363353733538335393354033541335423354333544335453354633547335483354933550335513355233553335543355533556335573355833559335603356133562335633356433565335663356733568335693357033571335723357333574335753357633577335783357933580335813358233583335843358533586335873358833589335903359133592335933359433595335963359733598335993360033601336023360333604336053360633607336083360933610336113361233613336143361533616336173361833619336203362133622336233362433625336263362733628336293363033631336323363333634336353363633637336383363933640336413364233643336443364533646336473364833649336503365133652336533365433655336563365733658336593366033661336623366333664336653366633667336683366933670336713367233673336743367533676336773367833679336803368133682336833368433685336863368733688336893369033691336923369333694336953369633697336983369933700337013370233703337043370533706337073370833709337103371133712337133371433715337163371733718337193372033721337223372333724337253372633727337283372933730337313373233733337343373533736337373373833739337403374133742337433374433745337463374733748337493375033751337523375333754337553375633757337583375933760337613376233763337643376533766337673376833769337703377133772337733377433775337763377733778337793378033781337823378333784337853378633787337883378933790337913379233793337943379533796337973379833799338003380133802338033380433805338063380733808338093381033811338123381333814338153381633817338183381933820338213382233823338243382533826338273382833829338303383133832338333383433835338363383733838338393384033841338423384333844338453384633847338483384933850338513385233853338543385533856338573385833859338603386133862338633386433865338663386733868338693387033871338723387333874338753387633877338783387933880338813388233883338843388533886338873388833889338903389133892338933389433895338963389733898338993390033901339023390333904339053390633907339083390933910339113391233913339143391533916339173391833919339203392133922339233392433925339263392733928339293393033931339323393333934339353393633937339383393933940339413394233943339443394533946339473394833949339503395133952339533395433955339563395733958339593396033961339623396333964339653396633967339683396933970339713397233973339743397533976339773397833979339803398133982339833398433985339863398733988339893399033991339923399333994339953399633997339983399934000340013400234003340043400534006340073400834009340103401134012340133401434015340163401734018340193402034021340223402334024340253402634027340283402934030340313403234033340343403534036340373403834039340403404134042340433404434045340463404734048340493405034051340523405334054340553405634057340583405934060340613406234063340643406534066340673406834069340703407134072340733407434075340763407734078340793408034081340823408334084340853408634087340883408934090340913409234093340943409534096340973409834099341003410134102341033410434105341063410734108341093411034111341123411334114341153411634117341183411934120341213412234123341243412534126341273412834129341303413134132341333413434135341363413734138341393414034141341423414334144341453414634147341483414934150341513415234153341543415534156341573415834159341603416134162341633416434165341663416734168341693417034171341723417334174341753417634177341783417934180341813418234183341843418534186341873418834189341903419134192341933419434195341963419734198341993420034201342023420334204342053420634207342083420934210342113421234213342143421534216342173421834219342203422134222342233422434225342263422734228342293423034231342323423334234342353423634237342383423934240342413424234243342443424534246342473424834249342503425134252342533425434255342563425734258342593426034261342623426334264342653426634267342683426934270342713427234273342743427534276342773427834279342803428134282342833428434285342863428734288342893429034291342923429334294342953429634297342983429934300343013430234303343043430534306343073430834309343103431134312343133431434315343163431734318343193432034321343223432334324343253432634327343283432934330343313433234333343343433534336343373433834339343403434134342343433434434345343463434734348343493435034351343523435334354343553435634357343583435934360343613436234363343643436534366343673436834369343703437134372343733437434375343763437734378343793438034381343823438334384343853438634387343883438934390343913439234393343943439534396343973439834399344003440134402344033440434405344063440734408344093441034411344123441334414344153441634417344183441934420344213442234423344243442534426344273442834429344303443134432344333443434435344363443734438344393444034441344423444334444344453444634447344483444934450344513445234453344543445534456344573445834459344603446134462344633446434465344663446734468344693447034471344723447334474344753447634477344783447934480344813448234483344843448534486344873448834489344903449134492344933449434495344963449734498344993450034501345023450334504345053450634507345083450934510345113451234513345143451534516345173451834519345203452134522345233452434525345263452734528345293453034531345323453334534345353453634537345383453934540345413454234543345443454534546345473454834549345503455134552345533455434555345563455734558345593456034561345623456334564345653456634567345683456934570345713457234573345743457534576345773457834579345803458134582345833458434585345863458734588345893459034591345923459334594345953459634597345983459934600346013460234603346043460534606346073460834609346103461134612346133461434615346163461734618346193462034621346223462334624346253462634627346283462934630346313463234633346343463534636346373463834639346403464134642346433464434645346463464734648346493465034651346523465334654346553465634657346583465934660346613466234663346643466534666346673466834669346703467134672346733467434675346763467734678346793468034681346823468334684346853468634687346883468934690346913469234693346943469534696346973469834699347003470134702347033470434705347063470734708347093471034711347123471334714347153471634717347183471934720347213472234723347243472534726347273472834729347303473134732347333473434735347363473734738347393474034741347423474334744347453474634747347483474934750347513475234753347543475534756347573475834759347603476134762347633476434765347663476734768347693477034771347723477334774347753477634777347783477934780347813478234783347843478534786347873478834789347903479134792347933479434795347963479734798347993480034801348023480334804348053480634807348083480934810348113481234813348143481534816348173481834819348203482134822348233482434825348263482734828348293483034831348323483334834348353483634837348383483934840348413484234843348443484534846348473484834849348503485134852348533485434855348563485734858348593486034861348623486334864348653486634867348683486934870348713487234873348743487534876348773487834879348803488134882348833488434885348863488734888348893489034891348923489334894348953489634897348983489934900349013490234903349043490534906349073490834909349103491134912349133491434915349163491734918349193492034921349223492334924349253492634927349283492934930349313493234933349343493534936349373493834939349403494134942349433494434945349463494734948349493495034951349523495334954349553495634957349583495934960349613496234963349643496534966349673496834969349703497134972349733497434975349763497734978349793498034981349823498334984349853498634987349883498934990349913499234993349943499534996349973499834999350003500135002350033500435005350063500735008350093501035011350123501335014350153501635017350183501935020350213502235023350243502535026350273502835029350303503135032350333503435035350363503735038350393504035041350423504335044350453504635047350483504935050350513505235053350543505535056350573505835059350603506135062350633506435065350663506735068350693507035071350723507335074350753507635077350783507935080350813508235083350843508535086350873508835089350903509135092350933509435095350963509735098350993510035101351023510335104351053510635107351083510935110351113511235113351143511535116351173511835119351203512135122351233512435125351263512735128351293513035131351323513335134351353513635137351383513935140351413514235143351443514535146351473514835149351503515135152351533515435155351563515735158351593516035161351623516335164351653516635167351683516935170351713517235173351743517535176351773517835179351803518135182351833518435185351863518735188351893519035191351923519335194351953519635197351983519935200352013520235203352043520535206352073520835209352103521135212352133521435215352163521735218352193522035221352223522335224352253522635227352283522935230352313523235233352343523535236352373523835239352403524135242352433524435245352463524735248352493525035251352523525335254352553525635257352583525935260352613526235263352643526535266352673526835269352703527135272352733527435275352763527735278352793528035281352823528335284352853528635287352883528935290352913529235293352943529535296352973529835299353003530135302353033530435305353063530735308353093531035311353123531335314353153531635317353183531935320353213532235323353243532535326353273532835329353303533135332353333533435335353363533735338353393534035341353423534335344353453534635347353483534935350353513535235353353543535535356353573535835359353603536135362353633536435365353663536735368353693537035371353723537335374353753537635377353783537935380353813538235383353843538535386353873538835389353903539135392353933539435395353963539735398353993540035401354023540335404354053540635407354083540935410354113541235413354143541535416354173541835419354203542135422354233542435425354263542735428354293543035431
  1. <!doctype html>
  2. <html lang="en" class="no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <link rel="prev" href="../generator/sshkey/">
  7. <link rel="next" href="../controller-options/">
  8. <link rel="icon" href="../../pictures/eso-round-logo.svg">
  9. <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
  10. <title>API specification - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
  12. <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
  13. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  14. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
  15. <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
  16. <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
  17. <script id="__analytics">function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-QP38TD8K7V"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-QP38TD8K7V",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-QP38TD8K7V",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script>
  18. <script>"undefined"!=typeof __md_analytics&&__md_analytics()</script>
  19. </head>
  20. <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
  21. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  22. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  23. <label class="md-overlay" for="__drawer"></label>
  24. <div data-md-component="skip">
  25. </div>
  26. <div data-md-component="announce">
  27. </div>
  28. <div data-md-color-scheme="default" data-md-component="outdated" hidden>
  29. <aside class="md-banner md-banner--warning">
  30. <div class="md-banner__inner md-grid md-typeset">
  31. You're not viewing the latest version.
  32. <a href="../../..">
  33. <strong>Click here to go to latest.</strong>
  34. </a>
  35. </div>
  36. <script>var el=document.querySelector("[data-md-component=outdated]"),base=new URL("../.."),outdated=__md_get("__outdated",sessionStorage,base);!0===outdated&&el&&(el.hidden=!1)</script>
  37. </aside>
  38. </div>
  39. <header class="md-header" data-md-component="header">
  40. <nav class="md-header__inner md-grid" aria-label="Header">
  41. <a href="../.." title="External Secrets Operator" class="md-header__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  42. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  43. </a>
  44. <label class="md-header__button md-icon" for="__drawer">
  45. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
  46. </label>
  47. <div class="md-header__title" data-md-component="header-title">
  48. <div class="md-header__ellipsis">
  49. <div class="md-header__topic">
  50. <span class="md-ellipsis">
  51. External Secrets Operator
  52. </span>
  53. </div>
  54. <div class="md-header__topic" data-md-component="header-topic">
  55. <span class="md-ellipsis">
  56. API specification
  57. </span>
  58. </div>
  59. </div>
  60. </div>
  61. <form class="md-header__option" data-md-component="palette">
  62. <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0">
  63. <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
  64. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
  65. </label>
  66. <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1">
  67. <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
  68. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
  69. </label>
  70. </form>
  71. <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
  72. <label class="md-header__button md-icon" for="__search">
  73. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
  74. </label>
  75. <div class="md-search" data-md-component="search" role="dialog">
  76. <label class="md-search__overlay" for="__search"></label>
  77. <div class="md-search__inner" role="search">
  78. <form class="md-search__form" name="search">
  79. <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
  80. <label class="md-search__icon md-icon" for="__search">
  81. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
  82. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
  83. </label>
  84. <nav class="md-search__options" aria-label="Search">
  85. <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
  86. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
  87. </button>
  88. </nav>
  89. </form>
  90. <div class="md-search__output">
  91. <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
  92. <div class="md-search-result" data-md-component="search-result">
  93. <div class="md-search-result__meta">
  94. Initializing search
  95. </div>
  96. <ol class="md-search-result__list" role="presentation"></ol>
  97. </div>
  98. </div>
  99. </div>
  100. </div>
  101. </div>
  102. <div class="md-header__source">
  103. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  104. <div class="md-source__icon md-icon">
  105. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
  106. </div>
  107. <div class="md-source__repository">
  108. External Secrets Operator
  109. </div>
  110. </a>
  111. </div>
  112. </nav>
  113. </header>
  114. <div class="md-container" data-md-component="container">
  115. <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
  116. <div class="md-grid">
  117. <ul class="md-tabs__list">
  118. <li class="md-tabs__item">
  119. <a href="../.." class="md-tabs__link">
  120. Introduction
  121. </a>
  122. </li>
  123. <li class="md-tabs__item md-tabs__item--active">
  124. <a href="../components/" class="md-tabs__link">
  125. API
  126. </a>
  127. </li>
  128. <li class="md-tabs__item">
  129. <a href="../../guides/introduction/" class="md-tabs__link">
  130. Guides
  131. </a>
  132. </li>
  133. <li class="md-tabs__item">
  134. <a href="../../provider/aws-secrets-manager/" class="md-tabs__link">
  135. Provider
  136. </a>
  137. </li>
  138. <li class="md-tabs__item">
  139. <a href="../../examples/gitops-using-fluxcd/" class="md-tabs__link">
  140. Examples
  141. </a>
  142. </li>
  143. <li class="md-tabs__item">
  144. <a href="../../contributing/devguide/" class="md-tabs__link">
  145. Community
  146. </a>
  147. </li>
  148. </ul>
  149. </div>
  150. </nav>
  151. <main class="md-main" data-md-component="main">
  152. <div class="md-main__inner md-grid">
  153. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  154. <div class="md-sidebar__scrollwrap">
  155. <div class="md-sidebar__inner">
  156. <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
  157. <label class="md-nav__title" for="__drawer">
  158. <a href="../.." title="External Secrets Operator" class="md-nav__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  159. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  160. </a>
  161. External Secrets Operator
  162. </label>
  163. <div class="md-nav__source">
  164. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  165. <div class="md-source__icon md-icon">
  166. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
  167. </div>
  168. <div class="md-source__repository">
  169. External Secrets Operator
  170. </div>
  171. </a>
  172. </div>
  173. <ul class="md-nav__list" data-md-scrollfix>
  174. <li class="md-nav__item md-nav__item--nested">
  175. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_1" >
  176. <div class="md-nav__link md-nav__container">
  177. <a href="../.." class="md-nav__link ">
  178. <span class="md-ellipsis">
  179. Introduction
  180. </span>
  181. </a>
  182. <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
  183. <span class="md-nav__icon md-icon"></span>
  184. </label>
  185. </div>
  186. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
  187. <label class="md-nav__title" for="__nav_1">
  188. <span class="md-nav__icon md-icon"></span>
  189. Introduction
  190. </label>
  191. <ul class="md-nav__list" data-md-scrollfix>
  192. <li class="md-nav__item">
  193. <a href="../../introduction/overview/" class="md-nav__link">
  194. <span class="md-ellipsis">
  195. Overview
  196. </span>
  197. </a>
  198. </li>
  199. <li class="md-nav__item">
  200. <a href="../../introduction/glossary/" class="md-nav__link">
  201. <span class="md-ellipsis">
  202. Glossary
  203. </span>
  204. </a>
  205. </li>
  206. <li class="md-nav__item">
  207. <a href="../../introduction/prerequisites/" class="md-nav__link">
  208. <span class="md-ellipsis">
  209. Prerequisites
  210. </span>
  211. </a>
  212. </li>
  213. <li class="md-nav__item">
  214. <a href="../../introduction/getting-started/" class="md-nav__link">
  215. <span class="md-ellipsis">
  216. Getting started
  217. </span>
  218. </a>
  219. </li>
  220. <li class="md-nav__item">
  221. <a href="../../introduction/faq/" class="md-nav__link">
  222. <span class="md-ellipsis">
  223. FAQ
  224. </span>
  225. </a>
  226. </li>
  227. <li class="md-nav__item">
  228. <a href="../../introduction/stability-support/" class="md-nav__link">
  229. <span class="md-ellipsis">
  230. Stability and Support
  231. </span>
  232. </a>
  233. </li>
  234. <li class="md-nav__item">
  235. <a href="../../introduction/deprecation-policy/" class="md-nav__link">
  236. <span class="md-ellipsis">
  237. Deprecation Policy
  238. </span>
  239. </a>
  240. </li>
  241. </ul>
  242. </nav>
  243. </li>
  244. <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
  245. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
  246. <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="">
  247. <span class="md-ellipsis">
  248. API
  249. </span>
  250. <span class="md-nav__icon md-icon"></span>
  251. </label>
  252. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
  253. <label class="md-nav__title" for="__nav_2">
  254. <span class="md-nav__icon md-icon"></span>
  255. API
  256. </label>
  257. <ul class="md-nav__list" data-md-scrollfix>
  258. <li class="md-nav__item">
  259. <a href="../components/" class="md-nav__link">
  260. <span class="md-ellipsis">
  261. Components
  262. </span>
  263. </a>
  264. </li>
  265. <li class="md-nav__item md-nav__item--nested">
  266. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_2" >
  267. <label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
  268. <span class="md-ellipsis">
  269. Core Resources
  270. </span>
  271. <span class="md-nav__icon md-icon"></span>
  272. </label>
  273. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
  274. <label class="md-nav__title" for="__nav_2_2">
  275. <span class="md-nav__icon md-icon"></span>
  276. Core Resources
  277. </label>
  278. <ul class="md-nav__list" data-md-scrollfix>
  279. <li class="md-nav__item">
  280. <a href="../externalsecret/" class="md-nav__link">
  281. <span class="md-ellipsis">
  282. ExternalSecret
  283. </span>
  284. </a>
  285. </li>
  286. <li class="md-nav__item">
  287. <a href="../secretstore/" class="md-nav__link">
  288. <span class="md-ellipsis">
  289. SecretStore
  290. </span>
  291. </a>
  292. </li>
  293. <li class="md-nav__item">
  294. <a href="../clustersecretstore/" class="md-nav__link">
  295. <span class="md-ellipsis">
  296. ClusterSecretStore
  297. </span>
  298. </a>
  299. </li>
  300. <li class="md-nav__item">
  301. <a href="../clusterexternalsecret/" class="md-nav__link">
  302. <span class="md-ellipsis">
  303. ClusterExternalSecret
  304. </span>
  305. </a>
  306. </li>
  307. <li class="md-nav__item">
  308. <a href="../clusterpushsecret/" class="md-nav__link">
  309. <span class="md-ellipsis">
  310. ClusterPushSecret
  311. </span>
  312. </a>
  313. </li>
  314. <li class="md-nav__item">
  315. <a href="../pushsecret/" class="md-nav__link">
  316. <span class="md-ellipsis">
  317. PushSecret
  318. </span>
  319. </a>
  320. </li>
  321. </ul>
  322. </nav>
  323. </li>
  324. <li class="md-nav__item md-nav__item--nested">
  325. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_3" >
  326. <div class="md-nav__link md-nav__container">
  327. <a href="../generator/" class="md-nav__link ">
  328. <span class="md-ellipsis">
  329. Generators
  330. </span>
  331. </a>
  332. <label class="md-nav__link " for="__nav_2_3" id="__nav_2_3_label" tabindex="0">
  333. <span class="md-nav__icon md-icon"></span>
  334. </label>
  335. </div>
  336. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
  337. <label class="md-nav__title" for="__nav_2_3">
  338. <span class="md-nav__icon md-icon"></span>
  339. Generators
  340. </label>
  341. <ul class="md-nav__list" data-md-scrollfix>
  342. <li class="md-nav__item">
  343. <a href="../generator/acr/" class="md-nav__link">
  344. <span class="md-ellipsis">
  345. Azure Container Registry
  346. </span>
  347. </a>
  348. </li>
  349. <li class="md-nav__item">
  350. <a href="../generator/ecr/" class="md-nav__link">
  351. <span class="md-ellipsis">
  352. AWS Elastic Container Registry
  353. </span>
  354. </a>
  355. </li>
  356. <li class="md-nav__item">
  357. <a href="../generator/sts/" class="md-nav__link">
  358. <span class="md-ellipsis">
  359. AWS STS Session Token
  360. </span>
  361. </a>
  362. </li>
  363. <li class="md-nav__item">
  364. <a href="../generator/cloudsmith/" class="md-nav__link">
  365. <span class="md-ellipsis">
  366. Cloudsmith
  367. </span>
  368. </a>
  369. </li>
  370. <li class="md-nav__item">
  371. <a href="../generator/cluster/" class="md-nav__link">
  372. <span class="md-ellipsis">
  373. Cluster Generator
  374. </span>
  375. </a>
  376. </li>
  377. <li class="md-nav__item">
  378. <a href="../generator/gcr/" class="md-nav__link">
  379. <span class="md-ellipsis">
  380. Google Container Registry
  381. </span>
  382. </a>
  383. </li>
  384. <li class="md-nav__item">
  385. <a href="../generator/grafana/" class="md-nav__link">
  386. <span class="md-ellipsis">
  387. Grafana
  388. </span>
  389. </a>
  390. </li>
  391. <li class="md-nav__item">
  392. <a href="../generator/quay/" class="md-nav__link">
  393. <span class="md-ellipsis">
  394. Quay
  395. </span>
  396. </a>
  397. </li>
  398. <li class="md-nav__item">
  399. <a href="../generator/vault/" class="md-nav__link">
  400. <span class="md-ellipsis">
  401. Vault Dynamic Secret
  402. </span>
  403. </a>
  404. </li>
  405. <li class="md-nav__item">
  406. <a href="../generator/password/" class="md-nav__link">
  407. <span class="md-ellipsis">
  408. Password
  409. </span>
  410. </a>
  411. </li>
  412. <li class="md-nav__item">
  413. <a href="../generator/fake/" class="md-nav__link">
  414. <span class="md-ellipsis">
  415. Fake
  416. </span>
  417. </a>
  418. </li>
  419. <li class="md-nav__item">
  420. <a href="../generator/webhook/" class="md-nav__link">
  421. <span class="md-ellipsis">
  422. Webhook
  423. </span>
  424. </a>
  425. </li>
  426. <li class="md-nav__item">
  427. <a href="../generator/github/" class="md-nav__link">
  428. <span class="md-ellipsis">
  429. Github
  430. </span>
  431. </a>
  432. </li>
  433. <li class="md-nav__item">
  434. <a href="../generator/uuid/" class="md-nav__link">
  435. <span class="md-ellipsis">
  436. UUID
  437. </span>
  438. </a>
  439. </li>
  440. <li class="md-nav__item">
  441. <a href="../generator/mfa/" class="md-nav__link">
  442. <span class="md-ellipsis">
  443. MFA
  444. </span>
  445. </a>
  446. </li>
  447. <li class="md-nav__item">
  448. <a href="../generator/sshkey/" class="md-nav__link">
  449. <span class="md-ellipsis">
  450. SSHKey
  451. </span>
  452. </a>
  453. </li>
  454. </ul>
  455. </nav>
  456. </li>
  457. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  458. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4" checked>
  459. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  460. <span class="md-ellipsis">
  461. Reference Docs
  462. </span>
  463. <span class="md-nav__icon md-icon"></span>
  464. </label>
  465. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="true">
  466. <label class="md-nav__title" for="__nav_2_4">
  467. <span class="md-nav__icon md-icon"></span>
  468. Reference Docs
  469. </label>
  470. <ul class="md-nav__list" data-md-scrollfix>
  471. <li class="md-nav__item md-nav__item--active">
  472. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  473. <a href="./" class="md-nav__link md-nav__link--active">
  474. <span class="md-ellipsis">
  475. API specification
  476. </span>
  477. </a>
  478. </li>
  479. <li class="md-nav__item">
  480. <a href="../controller-options/" class="md-nav__link">
  481. <span class="md-ellipsis">
  482. Controller Options
  483. </span>
  484. </a>
  485. </li>
  486. <li class="md-nav__item">
  487. <a href="../metrics/" class="md-nav__link">
  488. <span class="md-ellipsis">
  489. Metrics
  490. </span>
  491. </a>
  492. </li>
  493. <li class="md-nav__item">
  494. <a href="../selectable-fields/" class="md-nav__link">
  495. <span class="md-ellipsis">
  496. Selectable Fields
  497. </span>
  498. </a>
  499. </li>
  500. </ul>
  501. </nav>
  502. </li>
  503. </ul>
  504. </nav>
  505. </li>
  506. <li class="md-nav__item md-nav__item--nested">
  507. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  508. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  509. <span class="md-ellipsis">
  510. Guides
  511. </span>
  512. <span class="md-nav__icon md-icon"></span>
  513. </label>
  514. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  515. <label class="md-nav__title" for="__nav_3">
  516. <span class="md-nav__icon md-icon"></span>
  517. Guides
  518. </label>
  519. <ul class="md-nav__list" data-md-scrollfix>
  520. <li class="md-nav__item">
  521. <a href="../../guides/introduction/" class="md-nav__link">
  522. <span class="md-ellipsis">
  523. Introduction
  524. </span>
  525. </a>
  526. </li>
  527. <li class="md-nav__item md-nav__item--nested">
  528. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  529. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  530. <span class="md-ellipsis">
  531. External Secrets
  532. </span>
  533. <span class="md-nav__icon md-icon"></span>
  534. </label>
  535. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  536. <label class="md-nav__title" for="__nav_3_2">
  537. <span class="md-nav__icon md-icon"></span>
  538. External Secrets
  539. </label>
  540. <ul class="md-nav__list" data-md-scrollfix>
  541. <li class="md-nav__item">
  542. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  543. <span class="md-ellipsis">
  544. Extract structured data
  545. </span>
  546. </a>
  547. </li>
  548. <li class="md-nav__item">
  549. <a href="../../guides/getallsecrets/" class="md-nav__link">
  550. <span class="md-ellipsis">
  551. Find Secrets by Name or Metadata
  552. </span>
  553. </a>
  554. </li>
  555. <li class="md-nav__item">
  556. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  557. <span class="md-ellipsis">
  558. Rewriting Keys
  559. </span>
  560. </a>
  561. </li>
  562. <li class="md-nav__item md-nav__item--nested">
  563. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  564. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  565. <span class="md-ellipsis">
  566. Advanced Templating
  567. </span>
  568. <span class="md-nav__icon md-icon"></span>
  569. </label>
  570. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  571. <label class="md-nav__title" for="__nav_3_2_4">
  572. <span class="md-nav__icon md-icon"></span>
  573. Advanced Templating
  574. </label>
  575. <ul class="md-nav__list" data-md-scrollfix>
  576. <li class="md-nav__item">
  577. <a href="../../guides/templating/" class="md-nav__link">
  578. <span class="md-ellipsis">
  579. v2
  580. </span>
  581. </a>
  582. </li>
  583. <li class="md-nav__item">
  584. <a href="../../guides/templating-v1/" class="md-nav__link">
  585. <span class="md-ellipsis">
  586. v1
  587. </span>
  588. </a>
  589. </li>
  590. </ul>
  591. </nav>
  592. </li>
  593. <li class="md-nav__item">
  594. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  595. <span class="md-ellipsis">
  596. Kubernetes Secret Types
  597. </span>
  598. </a>
  599. </li>
  600. <li class="md-nav__item">
  601. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  602. <span class="md-ellipsis">
  603. Lifecycle: ownership & deletion
  604. </span>
  605. </a>
  606. </li>
  607. <li class="md-nav__item">
  608. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  609. <span class="md-ellipsis">
  610. Decoding Strategies
  611. </span>
  612. </a>
  613. </li>
  614. <li class="md-nav__item">
  615. <a href="../../guides/controller-class/" class="md-nav__link">
  616. <span class="md-ellipsis">
  617. Controller Classes
  618. </span>
  619. </a>
  620. </li>
  621. </ul>
  622. </nav>
  623. </li>
  624. <li class="md-nav__item">
  625. <a href="../../guides/targeting-custom-resources/" class="md-nav__link">
  626. <span class="md-ellipsis">
  627. Targeting Custom Resources
  628. </span>
  629. </a>
  630. </li>
  631. <li class="md-nav__item">
  632. <a href="../../guides/generator/" class="md-nav__link">
  633. <span class="md-ellipsis">
  634. Generators
  635. </span>
  636. </a>
  637. </li>
  638. <li class="md-nav__item">
  639. <a href="../../guides/pushsecrets/" class="md-nav__link">
  640. <span class="md-ellipsis">
  641. Push Secrets
  642. </span>
  643. </a>
  644. </li>
  645. <li class="md-nav__item md-nav__item--nested">
  646. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_6" >
  647. <label class="md-nav__link" for="__nav_3_6" id="__nav_3_6_label" tabindex="0">
  648. <span class="md-ellipsis">
  649. Operations
  650. </span>
  651. <span class="md-nav__icon md-icon"></span>
  652. </label>
  653. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_6_label" aria-expanded="false">
  654. <label class="md-nav__title" for="__nav_3_6">
  655. <span class="md-nav__icon md-icon"></span>
  656. Operations
  657. </label>
  658. <ul class="md-nav__list" data-md-scrollfix>
  659. <li class="md-nav__item">
  660. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  661. <span class="md-ellipsis">
  662. Multi Tenancy
  663. </span>
  664. </a>
  665. </li>
  666. <li class="md-nav__item">
  667. <a href="../../guides/security-best-practices/" class="md-nav__link">
  668. <span class="md-ellipsis">
  669. Security Best Practices
  670. </span>
  671. </a>
  672. </li>
  673. <li class="md-nav__item">
  674. <a href="../../guides/threat-model/" class="md-nav__link">
  675. <span class="md-ellipsis">
  676. Threat Model
  677. </span>
  678. </a>
  679. </li>
  680. <li class="md-nav__item">
  681. <a href="../../guides/v1beta1/" class="md-nav__link">
  682. <span class="md-ellipsis">
  683. Upgrading to v1beta1
  684. </span>
  685. </a>
  686. </li>
  687. <li class="md-nav__item">
  688. <a href="../../guides/using-latest-image/" class="md-nav__link">
  689. <span class="md-ellipsis">
  690. Using Latest Image
  691. </span>
  692. </a>
  693. </li>
  694. <li class="md-nav__item">
  695. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  696. <span class="md-ellipsis">
  697. Disable Cluster Features
  698. </span>
  699. </a>
  700. </li>
  701. </ul>
  702. </nav>
  703. </li>
  704. <li class="md-nav__item md-nav__item--nested">
  705. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_7" >
  706. <label class="md-nav__link" for="__nav_3_7" id="__nav_3_7_label" tabindex="0">
  707. <span class="md-ellipsis">
  708. Tooling
  709. </span>
  710. <span class="md-nav__icon md-icon"></span>
  711. </label>
  712. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_7_label" aria-expanded="false">
  713. <label class="md-nav__title" for="__nav_3_7">
  714. <span class="md-nav__icon md-icon"></span>
  715. Tooling
  716. </label>
  717. <ul class="md-nav__list" data-md-scrollfix>
  718. <li class="md-nav__item">
  719. <a href="../../guides/using-esoctl-tool/" class="md-nav__link">
  720. <span class="md-ellipsis">
  721. Using the esoctl tool
  722. </span>
  723. </a>
  724. </li>
  725. </ul>
  726. </nav>
  727. </li>
  728. </ul>
  729. </nav>
  730. </li>
  731. <li class="md-nav__item md-nav__item--nested">
  732. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
  733. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  734. <span class="md-ellipsis">
  735. Provider
  736. </span>
  737. <span class="md-nav__icon md-icon"></span>
  738. </label>
  739. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  740. <label class="md-nav__title" for="__nav_4">
  741. <span class="md-nav__icon md-icon"></span>
  742. Provider
  743. </label>
  744. <ul class="md-nav__list" data-md-scrollfix>
  745. <li class="md-nav__item">
  746. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  747. <span class="md-ellipsis">
  748. AWS Secrets Manager
  749. </span>
  750. </a>
  751. </li>
  752. <li class="md-nav__item">
  753. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  754. <span class="md-ellipsis">
  755. AWS Parameter Store
  756. </span>
  757. </a>
  758. </li>
  759. <li class="md-nav__item">
  760. <a href="../../provider/aws-access/" class="md-nav__link">
  761. <span class="md-ellipsis">
  762. AWS Access
  763. </span>
  764. </a>
  765. </li>
  766. <li class="md-nav__item">
  767. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  768. <span class="md-ellipsis">
  769. Azure Key Vault
  770. </span>
  771. </a>
  772. </li>
  773. <li class="md-nav__item">
  774. <a href="../../provider/barbican/" class="md-nav__link">
  775. <span class="md-ellipsis">
  776. Barbican
  777. </span>
  778. </a>
  779. </li>
  780. <li class="md-nav__item">
  781. <a href="../../provider/beyondtrust/" class="md-nav__link">
  782. <span class="md-ellipsis">
  783. BeyondTrust
  784. </span>
  785. </a>
  786. </li>
  787. <li class="md-nav__item">
  788. <a href="../../provider/bitwarden-secrets-manager/" class="md-nav__link">
  789. <span class="md-ellipsis">
  790. Bitwarden Secrets Manager
  791. </span>
  792. </a>
  793. </li>
  794. <li class="md-nav__item">
  795. <a href="../../provider/chef/" class="md-nav__link">
  796. <span class="md-ellipsis">
  797. Chef
  798. </span>
  799. </a>
  800. </li>
  801. <li class="md-nav__item">
  802. <a href="../../provider/cloudru/" class="md-nav__link">
  803. <span class="md-ellipsis">
  804. Cloud.ru Secret Manager
  805. </span>
  806. </a>
  807. </li>
  808. <li class="md-nav__item">
  809. <a href="../../provider/conjur/" class="md-nav__link">
  810. <span class="md-ellipsis">
  811. CyberArk Conjur
  812. </span>
  813. </a>
  814. </li>
  815. <li class="md-nav__item">
  816. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  817. <span class="md-ellipsis">
  818. Google Cloud Secret Manager
  819. </span>
  820. </a>
  821. </li>
  822. <li class="md-nav__item">
  823. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  824. <span class="md-ellipsis">
  825. HashiCorp Vault
  826. </span>
  827. </a>
  828. </li>
  829. <li class="md-nav__item">
  830. <a href="../../provider/kubernetes/" class="md-nav__link">
  831. <span class="md-ellipsis">
  832. Kubernetes
  833. </span>
  834. </a>
  835. </li>
  836. <li class="md-nav__item">
  837. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  838. <span class="md-ellipsis">
  839. IBM Secrets Manager
  840. </span>
  841. </a>
  842. </li>
  843. <li class="md-nav__item">
  844. <a href="../../provider/akeyless/" class="md-nav__link">
  845. <span class="md-ellipsis">
  846. Akeyless
  847. </span>
  848. </a>
  849. </li>
  850. <li class="md-nav__item">
  851. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  852. <span class="md-ellipsis">
  853. Yandex Certificate Manager
  854. </span>
  855. </a>
  856. </li>
  857. <li class="md-nav__item">
  858. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  859. <span class="md-ellipsis">
  860. Yandex Lockbox
  861. </span>
  862. </a>
  863. </li>
  864. <li class="md-nav__item">
  865. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  866. <span class="md-ellipsis">
  867. GitLab Variables
  868. </span>
  869. </a>
  870. </li>
  871. <li class="md-nav__item">
  872. <a href="../../provider/github/" class="md-nav__link">
  873. <span class="md-ellipsis">
  874. Github Actions Secrets
  875. </span>
  876. </a>
  877. </li>
  878. <li class="md-nav__item">
  879. <a href="../../provider/oracle-vault/" class="md-nav__link">
  880. <span class="md-ellipsis">
  881. Oracle Vault
  882. </span>
  883. </a>
  884. </li>
  885. <li class="md-nav__item">
  886. <a href="../../provider/ovhcloud/" class="md-nav__link">
  887. <span class="md-ellipsis">
  888. OVHcloud
  889. </span>
  890. </a>
  891. </li>
  892. <li class="md-nav__item">
  893. <a href="../../provider/1password-automation/" class="md-nav__link">
  894. <span class="md-ellipsis">
  895. 1Password Connect Server
  896. </span>
  897. </a>
  898. </li>
  899. <li class="md-nav__item">
  900. <a href="../../provider/1password-sdk/" class="md-nav__link">
  901. <span class="md-ellipsis">
  902. 1Password SDK
  903. </span>
  904. </a>
  905. </li>
  906. <li class="md-nav__item">
  907. <a href="../../provider/webhook/" class="md-nav__link">
  908. <span class="md-ellipsis">
  909. Webhook
  910. </span>
  911. </a>
  912. </li>
  913. <li class="md-nav__item">
  914. <a href="../../provider/fake/" class="md-nav__link">
  915. <span class="md-ellipsis">
  916. Fake
  917. </span>
  918. </a>
  919. </li>
  920. <li class="md-nav__item">
  921. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  922. <span class="md-ellipsis">
  923. senhasegura DevOps Secrets Management (DSM)
  924. </span>
  925. </a>
  926. </li>
  927. <li class="md-nav__item">
  928. <a href="../../provider/doppler/" class="md-nav__link">
  929. <span class="md-ellipsis">
  930. Doppler
  931. </span>
  932. </a>
  933. </li>
  934. <li class="md-nav__item">
  935. <a href="../../provider/keeper-security/" class="md-nav__link">
  936. <span class="md-ellipsis">
  937. Keeper Security
  938. </span>
  939. </a>
  940. </li>
  941. <li class="md-nav__item">
  942. <a href="../../provider/cloak/" class="md-nav__link">
  943. <span class="md-ellipsis">
  944. Cloak End 2 End Encrypted Secrets
  945. </span>
  946. </a>
  947. </li>
  948. <li class="md-nav__item">
  949. <a href="../../provider/scaleway/" class="md-nav__link">
  950. <span class="md-ellipsis">
  951. Scaleway
  952. </span>
  953. </a>
  954. </li>
  955. <li class="md-nav__item">
  956. <a href="../../provider/delinea/" class="md-nav__link">
  957. <span class="md-ellipsis">
  958. Delinea
  959. </span>
  960. </a>
  961. </li>
  962. <li class="md-nav__item">
  963. <a href="../../provider/secretserver/" class="md-nav__link">
  964. <span class="md-ellipsis">
  965. Secret Server
  966. </span>
  967. </a>
  968. </li>
  969. <li class="md-nav__item">
  970. <a href="../../provider/passbolt/" class="md-nav__link">
  971. <span class="md-ellipsis">
  972. Passbolt
  973. </span>
  974. </a>
  975. </li>
  976. <li class="md-nav__item">
  977. <a href="../../provider/pulumi/" class="md-nav__link">
  978. <span class="md-ellipsis">
  979. Pulumi ESC
  980. </span>
  981. </a>
  982. </li>
  983. <li class="md-nav__item">
  984. <a href="../../provider/onboardbase/" class="md-nav__link">
  985. <span class="md-ellipsis">
  986. Onboardbase
  987. </span>
  988. </a>
  989. </li>
  990. <li class="md-nav__item">
  991. <a href="../../provider-passworddepot/" class="md-nav__link">
  992. <span class="md-ellipsis">
  993. Password Depot
  994. </span>
  995. </a>
  996. </li>
  997. <li class="md-nav__item">
  998. <a href="../../provider/fortanix/" class="md-nav__link">
  999. <span class="md-ellipsis">
  1000. Fortanix
  1001. </span>
  1002. </a>
  1003. </li>
  1004. <li class="md-nav__item">
  1005. <a href="../../provider/infisical/" class="md-nav__link">
  1006. <span class="md-ellipsis">
  1007. Infisical
  1008. </span>
  1009. </a>
  1010. </li>
  1011. <li class="md-nav__item">
  1012. <a href="../../provider/previder/" class="md-nav__link">
  1013. <span class="md-ellipsis">
  1014. Previder
  1015. </span>
  1016. </a>
  1017. </li>
  1018. <li class="md-nav__item">
  1019. <a href="../../provider/openbao/" class="md-nav__link">
  1020. <span class="md-ellipsis">
  1021. OpenBao
  1022. </span>
  1023. </a>
  1024. </li>
  1025. <li class="md-nav__item">
  1026. <a href="../../provider/volcengine/" class="md-nav__link">
  1027. <span class="md-ellipsis">
  1028. Volcengine
  1029. </span>
  1030. </a>
  1031. </li>
  1032. <li class="md-nav__item">
  1033. <a href="../../provider/ngrok/" class="md-nav__link">
  1034. <span class="md-ellipsis">
  1035. ngrok
  1036. </span>
  1037. </a>
  1038. </li>
  1039. <li class="md-nav__item">
  1040. <a href="../../provider/devolutions-server/" class="md-nav__link">
  1041. <span class="md-ellipsis">
  1042. Devolutions Server
  1043. </span>
  1044. </a>
  1045. </li>
  1046. <li class="md-nav__item">
  1047. <a href="../../provider/nebius-mysterybox/" class="md-nav__link">
  1048. <span class="md-ellipsis">
  1049. Nebius MysteryBox
  1050. </span>
  1051. </a>
  1052. </li>
  1053. </ul>
  1054. </nav>
  1055. </li>
  1056. <li class="md-nav__item md-nav__item--nested">
  1057. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  1058. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  1059. <span class="md-ellipsis">
  1060. Examples
  1061. </span>
  1062. <span class="md-nav__icon md-icon"></span>
  1063. </label>
  1064. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  1065. <label class="md-nav__title" for="__nav_5">
  1066. <span class="md-nav__icon md-icon"></span>
  1067. Examples
  1068. </label>
  1069. <ul class="md-nav__list" data-md-scrollfix>
  1070. <li class="md-nav__item">
  1071. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  1072. <span class="md-ellipsis">
  1073. FluxCD
  1074. </span>
  1075. </a>
  1076. </li>
  1077. <li class="md-nav__item">
  1078. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  1079. <span class="md-ellipsis">
  1080. Anchore Engine
  1081. </span>
  1082. </a>
  1083. </li>
  1084. <li class="md-nav__item">
  1085. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  1086. <span class="md-ellipsis">
  1087. Jenkins
  1088. </span>
  1089. </a>
  1090. </li>
  1091. <li class="md-nav__item">
  1092. <a href="../../examples/bitwarden/" class="md-nav__link">
  1093. <span class="md-ellipsis">
  1094. Bitwarden
  1095. </span>
  1096. </a>
  1097. </li>
  1098. </ul>
  1099. </nav>
  1100. </li>
  1101. <li class="md-nav__item md-nav__item--nested">
  1102. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  1103. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  1104. <span class="md-ellipsis">
  1105. Community
  1106. </span>
  1107. <span class="md-nav__icon md-icon"></span>
  1108. </label>
  1109. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  1110. <label class="md-nav__title" for="__nav_6">
  1111. <span class="md-nav__icon md-icon"></span>
  1112. Community
  1113. </label>
  1114. <ul class="md-nav__list" data-md-scrollfix>
  1115. <li class="md-nav__item md-nav__item--nested">
  1116. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  1117. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  1118. <span class="md-ellipsis">
  1119. Contributing
  1120. </span>
  1121. <span class="md-nav__icon md-icon"></span>
  1122. </label>
  1123. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  1124. <label class="md-nav__title" for="__nav_6_1">
  1125. <span class="md-nav__icon md-icon"></span>
  1126. Contributing
  1127. </label>
  1128. <ul class="md-nav__list" data-md-scrollfix>
  1129. <li class="md-nav__item">
  1130. <a href="../../contributing/devguide/" class="md-nav__link">
  1131. <span class="md-ellipsis">
  1132. Developer guide
  1133. </span>
  1134. </a>
  1135. </li>
  1136. <li class="md-nav__item">
  1137. <a href="../../contributing/process/" class="md-nav__link">
  1138. <span class="md-ellipsis">
  1139. Contributing Process
  1140. </span>
  1141. </a>
  1142. </li>
  1143. <li class="md-nav__item">
  1144. <a href="../../contributing/release/" class="md-nav__link">
  1145. <span class="md-ellipsis">
  1146. Release Process
  1147. </span>
  1148. </a>
  1149. </li>
  1150. <li class="md-nav__item">
  1151. <a href="../../contributing/coc/" class="md-nav__link">
  1152. <span class="md-ellipsis">
  1153. Code of Conduct
  1154. </span>
  1155. </a>
  1156. </li>
  1157. <li class="md-nav__item">
  1158. <a href="../../contributing/calendar/" class="md-nav__link">
  1159. <span class="md-ellipsis">
  1160. Community meetings calendar
  1161. </span>
  1162. </a>
  1163. </li>
  1164. <li class="md-nav__item">
  1165. <a href="../../contributing/roadmap/" class="md-nav__link">
  1166. <span class="md-ellipsis">
  1167. Roadmap
  1168. </span>
  1169. </a>
  1170. </li>
  1171. <li class="md-nav__item">
  1172. <a href="../../contributing/burnout-mitigation/" class="md-nav__link">
  1173. <span class="md-ellipsis">
  1174. Burnout Prevention
  1175. </span>
  1176. </a>
  1177. </li>
  1178. <li class="md-nav__item">
  1179. <a href="../../contributing/llm-policy/" class="md-nav__link">
  1180. <span class="md-ellipsis">
  1181. LLM Policy
  1182. </span>
  1183. </a>
  1184. </li>
  1185. </ul>
  1186. </nav>
  1187. </li>
  1188. <li class="md-nav__item md-nav__item--nested">
  1189. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1190. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1191. <span class="md-ellipsis">
  1192. External Resources
  1193. </span>
  1194. <span class="md-nav__icon md-icon"></span>
  1195. </label>
  1196. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1197. <label class="md-nav__title" for="__nav_6_2">
  1198. <span class="md-nav__icon md-icon"></span>
  1199. External Resources
  1200. </label>
  1201. <ul class="md-nav__list" data-md-scrollfix>
  1202. <li class="md-nav__item">
  1203. <a href="../../eso-talks/" class="md-nav__link">
  1204. <span class="md-ellipsis">
  1205. Talks
  1206. </span>
  1207. </a>
  1208. </li>
  1209. <li class="md-nav__item">
  1210. <a href="../../eso-demos/" class="md-nav__link">
  1211. <span class="md-ellipsis">
  1212. Demos
  1213. </span>
  1214. </a>
  1215. </li>
  1216. <li class="md-nav__item">
  1217. <a href="../../eso-blogs/" class="md-nav__link">
  1218. <span class="md-ellipsis">
  1219. Blogs
  1220. </span>
  1221. </a>
  1222. </li>
  1223. <li class="md-nav__item">
  1224. <a href="../../eso-tools/" class="md-nav__link">
  1225. <span class="md-ellipsis">
  1226. Tools
  1227. </span>
  1228. </a>
  1229. </li>
  1230. </ul>
  1231. </nav>
  1232. </li>
  1233. </ul>
  1234. </nav>
  1235. </li>
  1236. </ul>
  1237. </nav>
  1238. </div>
  1239. </div>
  1240. </div>
  1241. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1242. <div class="md-sidebar__scrollwrap">
  1243. <div class="md-sidebar__inner">
  1244. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1245. </nav>
  1246. </div>
  1247. </div>
  1248. </div>
  1249. <div class="md-content" data-md-component="content">
  1250. <article class="md-content__inner md-typeset">
  1251. <h1>API specification</h1>
  1252. <p>Packages:</p>
  1253. <ul>
  1254. <li>
  1255. <a href="#external-secrets.io%2fv1">external-secrets.io/v1</a>
  1256. </li>
  1257. <li>
  1258. <a href="#external-secrets.io%2fv1alpha1">external-secrets.io/v1alpha1</a>
  1259. </li>
  1260. <li>
  1261. <a href="#external-secrets.io%2fv1beta1">external-secrets.io/v1beta1</a>
  1262. </li>
  1263. <li>
  1264. <a href="#generators.external-secrets.io%2fv1alpha1">generators.external-secrets.io/v1alpha1</a>
  1265. </li>
  1266. </ul>
  1267. <h2 id="external-secrets.io/v1">external-secrets.io/v1</h2>
  1268. <p>
  1269. <p>Package v1 contains resources for external-secrets</p>
  1270. </p>
  1271. <p>Resource Types:</p>
  1272. <ul></ul>
  1273. <h3 id="external-secrets.io/v1.AWSAuth">AWSAuth
  1274. </h3>
  1275. <p>
  1276. (<em>Appears on:</em>
  1277. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1278. </p>
  1279. <p>
  1280. <p>AWSAuth tells the controller how to do authentication with aws.
  1281. Only one of secretRef or jwt can be specified.
  1282. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  1283. </p>
  1284. <table>
  1285. <thead>
  1286. <tr>
  1287. <th>Field</th>
  1288. <th>Description</th>
  1289. </tr>
  1290. </thead>
  1291. <tbody>
  1292. <tr>
  1293. <td>
  1294. <code>secretRef</code></br>
  1295. <em>
  1296. <a href="#external-secrets.io/v1.AWSAuthSecretRef">
  1297. AWSAuthSecretRef
  1298. </a>
  1299. </em>
  1300. </td>
  1301. <td>
  1302. <em>(Optional)</em>
  1303. </td>
  1304. </tr>
  1305. <tr>
  1306. <td>
  1307. <code>jwt</code></br>
  1308. <em>
  1309. <a href="#external-secrets.io/v1.AWSJWTAuth">
  1310. AWSJWTAuth
  1311. </a>
  1312. </em>
  1313. </td>
  1314. <td>
  1315. <em>(Optional)</em>
  1316. </td>
  1317. </tr>
  1318. </tbody>
  1319. </table>
  1320. <h3 id="external-secrets.io/v1.AWSAuthSecretRef">AWSAuthSecretRef
  1321. </h3>
  1322. <p>
  1323. (<em>Appears on:</em>
  1324. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1325. </p>
  1326. <p>
  1327. <p>AWSAuthSecretRef holds secret references for AWS credentials
  1328. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  1329. </p>
  1330. <table>
  1331. <thead>
  1332. <tr>
  1333. <th>Field</th>
  1334. <th>Description</th>
  1335. </tr>
  1336. </thead>
  1337. <tbody>
  1338. <tr>
  1339. <td>
  1340. <code>accessKeyIDSecretRef</code></br>
  1341. <em>
  1342. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1343. External Secrets meta/v1.SecretKeySelector
  1344. </a>
  1345. </em>
  1346. </td>
  1347. <td>
  1348. <p>The AccessKeyID is used for authentication</p>
  1349. </td>
  1350. </tr>
  1351. <tr>
  1352. <td>
  1353. <code>secretAccessKeySecretRef</code></br>
  1354. <em>
  1355. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1356. External Secrets meta/v1.SecretKeySelector
  1357. </a>
  1358. </em>
  1359. </td>
  1360. <td>
  1361. <p>The SecretAccessKey is used for authentication</p>
  1362. </td>
  1363. </tr>
  1364. <tr>
  1365. <td>
  1366. <code>sessionTokenSecretRef</code></br>
  1367. <em>
  1368. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1369. External Secrets meta/v1.SecretKeySelector
  1370. </a>
  1371. </em>
  1372. </td>
  1373. <td>
  1374. <p>The SessionToken used for authentication
  1375. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  1376. 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>
  1377. </td>
  1378. </tr>
  1379. </tbody>
  1380. </table>
  1381. <h3 id="external-secrets.io/v1.AWSJWTAuth">AWSJWTAuth
  1382. </h3>
  1383. <p>
  1384. (<em>Appears on:</em>
  1385. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1386. </p>
  1387. <p>
  1388. <p>AWSJWTAuth stores reference to Authenticate against AWS using service account tokens.</p>
  1389. </p>
  1390. <table>
  1391. <thead>
  1392. <tr>
  1393. <th>Field</th>
  1394. <th>Description</th>
  1395. </tr>
  1396. </thead>
  1397. <tbody>
  1398. <tr>
  1399. <td>
  1400. <code>serviceAccountRef</code></br>
  1401. <em>
  1402. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1403. External Secrets meta/v1.ServiceAccountSelector
  1404. </a>
  1405. </em>
  1406. </td>
  1407. <td>
  1408. </td>
  1409. </tr>
  1410. </tbody>
  1411. </table>
  1412. <h3 id="external-secrets.io/v1.AWSProvider">AWSProvider
  1413. </h3>
  1414. <p>
  1415. (<em>Appears on:</em>
  1416. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1417. </p>
  1418. <p>
  1419. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  1420. </p>
  1421. <table>
  1422. <thead>
  1423. <tr>
  1424. <th>Field</th>
  1425. <th>Description</th>
  1426. </tr>
  1427. </thead>
  1428. <tbody>
  1429. <tr>
  1430. <td>
  1431. <code>service</code></br>
  1432. <em>
  1433. <a href="#external-secrets.io/v1.AWSServiceType">
  1434. AWSServiceType
  1435. </a>
  1436. </em>
  1437. </td>
  1438. <td>
  1439. <p>Service defines which service should be used to fetch the secrets</p>
  1440. </td>
  1441. </tr>
  1442. <tr>
  1443. <td>
  1444. <code>auth</code></br>
  1445. <em>
  1446. <a href="#external-secrets.io/v1.AWSAuth">
  1447. AWSAuth
  1448. </a>
  1449. </em>
  1450. </td>
  1451. <td>
  1452. <em>(Optional)</em>
  1453. <p>Auth defines the information necessary to authenticate against AWS
  1454. if not set aws sdk will infer credentials from your environment
  1455. 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>
  1456. </td>
  1457. </tr>
  1458. <tr>
  1459. <td>
  1460. <code>role</code></br>
  1461. <em>
  1462. string
  1463. </em>
  1464. </td>
  1465. <td>
  1466. <em>(Optional)</em>
  1467. <p>Role is a Role ARN which the provider will assume</p>
  1468. </td>
  1469. </tr>
  1470. <tr>
  1471. <td>
  1472. <code>region</code></br>
  1473. <em>
  1474. string
  1475. </em>
  1476. </td>
  1477. <td>
  1478. <p>AWS Region to be used for the provider</p>
  1479. </td>
  1480. </tr>
  1481. <tr>
  1482. <td>
  1483. <code>additionalRoles</code></br>
  1484. <em>
  1485. []string
  1486. </em>
  1487. </td>
  1488. <td>
  1489. <em>(Optional)</em>
  1490. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  1491. </td>
  1492. </tr>
  1493. <tr>
  1494. <td>
  1495. <code>externalID</code></br>
  1496. <em>
  1497. string
  1498. </em>
  1499. </td>
  1500. <td>
  1501. <p>AWS External ID set on assumed IAM roles</p>
  1502. </td>
  1503. </tr>
  1504. <tr>
  1505. <td>
  1506. <code>sessionTags</code></br>
  1507. <em>
  1508. <a href="#external-secrets.io/v1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag">
  1509. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag
  1510. </a>
  1511. </em>
  1512. </td>
  1513. <td>
  1514. <em>(Optional)</em>
  1515. <p>AWS STS assume role session tags</p>
  1516. </td>
  1517. </tr>
  1518. <tr>
  1519. <td>
  1520. <code>secretsManager</code></br>
  1521. <em>
  1522. <a href="#external-secrets.io/v1.SecretsManager">
  1523. SecretsManager
  1524. </a>
  1525. </em>
  1526. </td>
  1527. <td>
  1528. <em>(Optional)</em>
  1529. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  1530. </td>
  1531. </tr>
  1532. <tr>
  1533. <td>
  1534. <code>transitiveTagKeys</code></br>
  1535. <em>
  1536. []string
  1537. </em>
  1538. </td>
  1539. <td>
  1540. <em>(Optional)</em>
  1541. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  1542. </td>
  1543. </tr>
  1544. <tr>
  1545. <td>
  1546. <code>sessionTagsPolicy</code></br>
  1547. <em>
  1548. <a href="#external-secrets.io/v1.SessionTagsPolicy">
  1549. SessionTagsPolicy
  1550. </a>
  1551. </em>
  1552. </td>
  1553. <td>
  1554. <em>(Optional)</em>
  1555. <p>SessionTagsPolicy controls whether and how STS session tags are added when assuming roles.
  1556. None (default): no tags are added.
  1557. Simple: automatically adds esoNamespace (from the ExternalSecret), esoStoreName, and esoStoreKind tags.
  1558. Custom: adds esoNamespace, esoStoreName, and esoStoreKind plus any tags defined in CustomSessionTags.
  1559. Note: the IAM role must have sts:TagSession permission when using Simple or Custom.</p>
  1560. </td>
  1561. </tr>
  1562. <tr>
  1563. <td>
  1564. <code>customSessionTags</code></br>
  1565. <em>
  1566. map[string]string
  1567. </em>
  1568. </td>
  1569. <td>
  1570. <em>(Optional)</em>
  1571. <p>CustomSessionTags defines additional STS session tags to include when SessionTagsPolicy is Custom.
  1572. These are merged with the automatically injected esoNamespace, esoStoreName, and esoStoreKind tags.</p>
  1573. </td>
  1574. </tr>
  1575. <tr>
  1576. <td>
  1577. <code>prefix</code></br>
  1578. <em>
  1579. string
  1580. </em>
  1581. </td>
  1582. <td>
  1583. <em>(Optional)</em>
  1584. <p>Prefix adds a prefix to all retrieved values.</p>
  1585. </td>
  1586. </tr>
  1587. </tbody>
  1588. </table>
  1589. <h3 id="external-secrets.io/v1.AWSServiceType">AWSServiceType
  1590. (<code>string</code> alias)</p></h3>
  1591. <p>
  1592. (<em>Appears on:</em>
  1593. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1594. </p>
  1595. <p>
  1596. <p>AWSServiceType is a enum that defines the service/API that is used to fetch the secrets.</p>
  1597. </p>
  1598. <table>
  1599. <thead>
  1600. <tr>
  1601. <th>Value</th>
  1602. <th>Description</th>
  1603. </tr>
  1604. </thead>
  1605. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  1606. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  1607. 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>
  1608. </td>
  1609. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  1610. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  1611. 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>
  1612. </td>
  1613. </tr></tbody>
  1614. </table>
  1615. <h3 id="external-secrets.io/v1.AkeylessAuth">AkeylessAuth
  1616. </h3>
  1617. <p>
  1618. (<em>Appears on:</em>
  1619. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>)
  1620. </p>
  1621. <p>
  1622. <p>AkeylessAuth configures how the operator authenticates with Akeyless.</p>
  1623. </p>
  1624. <table>
  1625. <thead>
  1626. <tr>
  1627. <th>Field</th>
  1628. <th>Description</th>
  1629. </tr>
  1630. </thead>
  1631. <tbody>
  1632. <tr>
  1633. <td>
  1634. <code>secretRef</code></br>
  1635. <em>
  1636. <a href="#external-secrets.io/v1.AkeylessAuthSecretRef">
  1637. AkeylessAuthSecretRef
  1638. </a>
  1639. </em>
  1640. </td>
  1641. <td>
  1642. <em>(Optional)</em>
  1643. <p>Reference to a Secret that contains the details
  1644. to authenticate with Akeyless.</p>
  1645. </td>
  1646. </tr>
  1647. <tr>
  1648. <td>
  1649. <code>kubernetesAuth</code></br>
  1650. <em>
  1651. <a href="#external-secrets.io/v1.AkeylessKubernetesAuth">
  1652. AkeylessKubernetesAuth
  1653. </a>
  1654. </em>
  1655. </td>
  1656. <td>
  1657. <em>(Optional)</em>
  1658. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  1659. token stored in the named Secret resource.</p>
  1660. </td>
  1661. </tr>
  1662. </tbody>
  1663. </table>
  1664. <h3 id="external-secrets.io/v1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  1665. </h3>
  1666. <p>
  1667. (<em>Appears on:</em>
  1668. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1669. </p>
  1670. <p>
  1671. <p>AkeylessAuthSecretRef references a Secret that contains the details
  1672. to authenticate with Akeyless.
  1673. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  1674. </p>
  1675. <table>
  1676. <thead>
  1677. <tr>
  1678. <th>Field</th>
  1679. <th>Description</th>
  1680. </tr>
  1681. </thead>
  1682. <tbody>
  1683. <tr>
  1684. <td>
  1685. <code>accessID</code></br>
  1686. <em>
  1687. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1688. External Secrets meta/v1.SecretKeySelector
  1689. </a>
  1690. </em>
  1691. </td>
  1692. <td>
  1693. <p>The SecretAccessID is used for authentication</p>
  1694. </td>
  1695. </tr>
  1696. <tr>
  1697. <td>
  1698. <code>accessType</code></br>
  1699. <em>
  1700. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1701. External Secrets meta/v1.SecretKeySelector
  1702. </a>
  1703. </em>
  1704. </td>
  1705. <td>
  1706. </td>
  1707. </tr>
  1708. <tr>
  1709. <td>
  1710. <code>accessTypeParam</code></br>
  1711. <em>
  1712. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1713. External Secrets meta/v1.SecretKeySelector
  1714. </a>
  1715. </em>
  1716. </td>
  1717. <td>
  1718. </td>
  1719. </tr>
  1720. </tbody>
  1721. </table>
  1722. <h3 id="external-secrets.io/v1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  1723. </h3>
  1724. <p>
  1725. (<em>Appears on:</em>
  1726. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1727. </p>
  1728. <p>
  1729. <p>AkeylessKubernetesAuth configures Kubernetes authentication with Akeyless.
  1730. It authenticates with Kubernetes ServiceAccount token stored.</p>
  1731. </p>
  1732. <table>
  1733. <thead>
  1734. <tr>
  1735. <th>Field</th>
  1736. <th>Description</th>
  1737. </tr>
  1738. </thead>
  1739. <tbody>
  1740. <tr>
  1741. <td>
  1742. <code>accessID</code></br>
  1743. <em>
  1744. string
  1745. </em>
  1746. </td>
  1747. <td>
  1748. <p>the Akeyless Kubernetes auth-method access-id</p>
  1749. </td>
  1750. </tr>
  1751. <tr>
  1752. <td>
  1753. <code>k8sConfName</code></br>
  1754. <em>
  1755. string
  1756. </em>
  1757. </td>
  1758. <td>
  1759. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  1760. </td>
  1761. </tr>
  1762. <tr>
  1763. <td>
  1764. <code>serviceAccountRef</code></br>
  1765. <em>
  1766. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1767. External Secrets meta/v1.ServiceAccountSelector
  1768. </a>
  1769. </em>
  1770. </td>
  1771. <td>
  1772. <em>(Optional)</em>
  1773. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  1774. If the service account is specified, the service account secret token JWT will be used
  1775. for authenticating with Akeyless. If the service account selector is not supplied,
  1776. the secretRef will be used instead.</p>
  1777. </td>
  1778. </tr>
  1779. <tr>
  1780. <td>
  1781. <code>secretRef</code></br>
  1782. <em>
  1783. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1784. External Secrets meta/v1.SecretKeySelector
  1785. </a>
  1786. </em>
  1787. </td>
  1788. <td>
  1789. <em>(Optional)</em>
  1790. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  1791. for authenticating with Akeyless. If a name is specified without a key,
  1792. <code>token</code> is the default. If one is not specified, the one bound to
  1793. the controller will be used.</p>
  1794. </td>
  1795. </tr>
  1796. </tbody>
  1797. </table>
  1798. <h3 id="external-secrets.io/v1.AkeylessProvider">AkeylessProvider
  1799. </h3>
  1800. <p>
  1801. (<em>Appears on:</em>
  1802. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1803. </p>
  1804. <p>
  1805. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  1806. </p>
  1807. <table>
  1808. <thead>
  1809. <tr>
  1810. <th>Field</th>
  1811. <th>Description</th>
  1812. </tr>
  1813. </thead>
  1814. <tbody>
  1815. <tr>
  1816. <td>
  1817. <code>akeylessGWApiURL</code></br>
  1818. <em>
  1819. string
  1820. </em>
  1821. </td>
  1822. <td>
  1823. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  1824. </td>
  1825. </tr>
  1826. <tr>
  1827. <td>
  1828. <code>authSecretRef</code></br>
  1829. <em>
  1830. <a href="#external-secrets.io/v1.AkeylessAuth">
  1831. AkeylessAuth
  1832. </a>
  1833. </em>
  1834. </td>
  1835. <td>
  1836. <p>Auth configures how the operator authenticates with Akeyless.</p>
  1837. </td>
  1838. </tr>
  1839. <tr>
  1840. <td>
  1841. <code>caBundle</code></br>
  1842. <em>
  1843. []byte
  1844. </em>
  1845. </td>
  1846. <td>
  1847. <em>(Optional)</em>
  1848. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  1849. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  1850. are used to validate the TLS connection.</p>
  1851. </td>
  1852. </tr>
  1853. <tr>
  1854. <td>
  1855. <code>caProvider</code></br>
  1856. <em>
  1857. <a href="#external-secrets.io/v1.CAProvider">
  1858. CAProvider
  1859. </a>
  1860. </em>
  1861. </td>
  1862. <td>
  1863. <em>(Optional)</em>
  1864. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  1865. </td>
  1866. </tr>
  1867. </tbody>
  1868. </table>
  1869. <h3 id="external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol
  1870. </h3>
  1871. <p>
  1872. (<em>Appears on:</em>
  1873. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  1874. </p>
  1875. <p>
  1876. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  1877. </p>
  1878. <table>
  1879. <thead>
  1880. <tr>
  1881. <th>Field</th>
  1882. <th>Description</th>
  1883. </tr>
  1884. </thead>
  1885. <tbody>
  1886. <tr>
  1887. <td>
  1888. <code>ntlm</code></br>
  1889. <em>
  1890. <a href="#external-secrets.io/v1.NTLMProtocol">
  1891. NTLMProtocol
  1892. </a>
  1893. </em>
  1894. </td>
  1895. <td>
  1896. <em>(Optional)</em>
  1897. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  1898. </td>
  1899. </tr>
  1900. </tbody>
  1901. </table>
  1902. <h3 id="external-secrets.io/v1.AwsAuthCredentials">AwsAuthCredentials
  1903. </h3>
  1904. <p>
  1905. (<em>Appears on:</em>
  1906. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1907. </p>
  1908. <p>
  1909. <p>AwsAuthCredentials represents the credentials for AWS authentication.</p>
  1910. </p>
  1911. <table>
  1912. <thead>
  1913. <tr>
  1914. <th>Field</th>
  1915. <th>Description</th>
  1916. </tr>
  1917. </thead>
  1918. <tbody>
  1919. <tr>
  1920. <td>
  1921. <code>identityId</code></br>
  1922. <em>
  1923. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1924. External Secrets meta/v1.SecretKeySelector
  1925. </a>
  1926. </em>
  1927. </td>
  1928. <td>
  1929. </td>
  1930. </tr>
  1931. </tbody>
  1932. </table>
  1933. <h3 id="external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig
  1934. </h3>
  1935. <p>
  1936. (<em>Appears on:</em>
  1937. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  1938. </p>
  1939. <p>
  1940. <p>AwsCredentialsConfig holds the region and the Secret reference which contains the AWS credentials.</p>
  1941. </p>
  1942. <table>
  1943. <thead>
  1944. <tr>
  1945. <th>Field</th>
  1946. <th>Description</th>
  1947. </tr>
  1948. </thead>
  1949. <tbody>
  1950. <tr>
  1951. <td>
  1952. <code>region</code></br>
  1953. <em>
  1954. string
  1955. </em>
  1956. </td>
  1957. <td>
  1958. <p>region is for configuring the AWS region to be used.</p>
  1959. </td>
  1960. </tr>
  1961. <tr>
  1962. <td>
  1963. <code>awsCredentialsSecretRef</code></br>
  1964. <em>
  1965. <a href="#external-secrets.io/v1.SecretReference">
  1966. SecretReference
  1967. </a>
  1968. </em>
  1969. </td>
  1970. <td>
  1971. <p>awsCredentialsSecretRef is the reference to the secret which holds the AWS credentials.
  1972. Secret should be created with below names for keys
  1973. - aws_access_key_id: Access Key ID, which is the unique identifier for the AWS account or the IAM user.
  1974. - aws_secret_access_key: Secret Access Key, which is used to authenticate requests made to AWS services.
  1975. - aws_session_token: Session Token, is the short-lived token to authenticate requests made to AWS services.</p>
  1976. </td>
  1977. </tr>
  1978. </tbody>
  1979. </table>
  1980. <h3 id="external-secrets.io/v1.AzureAuthCredentials">AzureAuthCredentials
  1981. </h3>
  1982. <p>
  1983. (<em>Appears on:</em>
  1984. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1985. </p>
  1986. <p>
  1987. <p>AzureAuthCredentials represents the credentials for Azure authentication.</p>
  1988. </p>
  1989. <table>
  1990. <thead>
  1991. <tr>
  1992. <th>Field</th>
  1993. <th>Description</th>
  1994. </tr>
  1995. </thead>
  1996. <tbody>
  1997. <tr>
  1998. <td>
  1999. <code>identityId</code></br>
  2000. <em>
  2001. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2002. External Secrets meta/v1.SecretKeySelector
  2003. </a>
  2004. </em>
  2005. </td>
  2006. <td>
  2007. </td>
  2008. </tr>
  2009. <tr>
  2010. <td>
  2011. <code>resource</code></br>
  2012. <em>
  2013. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2014. External Secrets meta/v1.SecretKeySelector
  2015. </a>
  2016. </em>
  2017. </td>
  2018. <td>
  2019. <em>(Optional)</em>
  2020. </td>
  2021. </tr>
  2022. </tbody>
  2023. </table>
  2024. <h3 id="external-secrets.io/v1.AzureAuthType">AzureAuthType
  2025. (<code>string</code> alias)</p></h3>
  2026. <p>
  2027. (<em>Appears on:</em>
  2028. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2029. </p>
  2030. <p>
  2031. <p>AzureAuthType describes how to authenticate to the Azure Keyvault
  2032. Only one of the following auth types may be specified.
  2033. If none of the following auth type is specified, the default one
  2034. is ServicePrincipal.</p>
  2035. </p>
  2036. <table>
  2037. <thead>
  2038. <tr>
  2039. <th>Value</th>
  2040. <th>Description</th>
  2041. </tr>
  2042. </thead>
  2043. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  2044. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  2045. </td>
  2046. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  2047. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  2048. </td>
  2049. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  2050. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  2051. </td>
  2052. </tr></tbody>
  2053. </table>
  2054. <h3 id="external-secrets.io/v1.AzureCustomCloudConfig">AzureCustomCloudConfig
  2055. </h3>
  2056. <p>
  2057. (<em>Appears on:</em>
  2058. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2059. </p>
  2060. <p>
  2061. <p>AzureCustomCloudConfig specifies custom cloud configuration for private Azure environments
  2062. IMPORTANT: Custom cloud configuration is ONLY supported when UseAzureSDK is true.
  2063. The legacy go-autorest SDK does not support custom cloud endpoints.</p>
  2064. </p>
  2065. <table>
  2066. <thead>
  2067. <tr>
  2068. <th>Field</th>
  2069. <th>Description</th>
  2070. </tr>
  2071. </thead>
  2072. <tbody>
  2073. <tr>
  2074. <td>
  2075. <code>activeDirectoryEndpoint</code></br>
  2076. <em>
  2077. string
  2078. </em>
  2079. </td>
  2080. <td>
  2081. <p>ActiveDirectoryEndpoint is the AAD endpoint for authentication
  2082. Required when using custom cloud configuration</p>
  2083. </td>
  2084. </tr>
  2085. <tr>
  2086. <td>
  2087. <code>keyVaultEndpoint</code></br>
  2088. <em>
  2089. string
  2090. </em>
  2091. </td>
  2092. <td>
  2093. <em>(Optional)</em>
  2094. <p>KeyVaultEndpoint is the Key Vault service endpoint</p>
  2095. </td>
  2096. </tr>
  2097. <tr>
  2098. <td>
  2099. <code>keyVaultDNSSuffix</code></br>
  2100. <em>
  2101. string
  2102. </em>
  2103. </td>
  2104. <td>
  2105. <em>(Optional)</em>
  2106. <p>KeyVaultDNSSuffix is the DNS suffix for Key Vault URLs</p>
  2107. </td>
  2108. </tr>
  2109. <tr>
  2110. <td>
  2111. <code>resourceManagerEndpoint</code></br>
  2112. <em>
  2113. string
  2114. </em>
  2115. </td>
  2116. <td>
  2117. <em>(Optional)</em>
  2118. <p>ResourceManagerEndpoint is the Azure Resource Manager endpoint</p>
  2119. </td>
  2120. </tr>
  2121. </tbody>
  2122. </table>
  2123. <h3 id="external-secrets.io/v1.AzureEnvironmentType">AzureEnvironmentType
  2124. (<code>string</code> alias)</p></h3>
  2125. <p>
  2126. (<em>Appears on:</em>
  2127. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>,
  2128. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  2129. </p>
  2130. <p>
  2131. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  2132. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  2133. 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>
  2134. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud</p>
  2135. </p>
  2136. <table>
  2137. <thead>
  2138. <tr>
  2139. <th>Value</th>
  2140. <th>Description</th>
  2141. </tr>
  2142. </thead>
  2143. <tbody><tr><td><p>&#34;AzureStackCloud&#34;</p></td>
  2144. <td></td>
  2145. </tr><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  2146. <td></td>
  2147. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  2148. <td></td>
  2149. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  2150. <td></td>
  2151. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  2152. <td></td>
  2153. </tr></tbody>
  2154. </table>
  2155. <h3 id="external-secrets.io/v1.AzureKVAuth">AzureKVAuth
  2156. </h3>
  2157. <p>
  2158. (<em>Appears on:</em>
  2159. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2160. </p>
  2161. <p>
  2162. <p>AzureKVAuth is the configuration used to authenticate with Azure.</p>
  2163. </p>
  2164. <table>
  2165. <thead>
  2166. <tr>
  2167. <th>Field</th>
  2168. <th>Description</th>
  2169. </tr>
  2170. </thead>
  2171. <tbody>
  2172. <tr>
  2173. <td>
  2174. <code>clientId</code></br>
  2175. <em>
  2176. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2177. External Secrets meta/v1.SecretKeySelector
  2178. </a>
  2179. </em>
  2180. </td>
  2181. <td>
  2182. <em>(Optional)</em>
  2183. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  2184. </td>
  2185. </tr>
  2186. <tr>
  2187. <td>
  2188. <code>tenantId</code></br>
  2189. <em>
  2190. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2191. External Secrets meta/v1.SecretKeySelector
  2192. </a>
  2193. </em>
  2194. </td>
  2195. <td>
  2196. <em>(Optional)</em>
  2197. <p>The Azure tenantId of the managed identity used for authentication.</p>
  2198. </td>
  2199. </tr>
  2200. <tr>
  2201. <td>
  2202. <code>clientSecret</code></br>
  2203. <em>
  2204. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2205. External Secrets meta/v1.SecretKeySelector
  2206. </a>
  2207. </em>
  2208. </td>
  2209. <td>
  2210. <em>(Optional)</em>
  2211. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  2212. </td>
  2213. </tr>
  2214. <tr>
  2215. <td>
  2216. <code>clientCertificate</code></br>
  2217. <em>
  2218. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2219. External Secrets meta/v1.SecretKeySelector
  2220. </a>
  2221. </em>
  2222. </td>
  2223. <td>
  2224. <em>(Optional)</em>
  2225. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  2226. </td>
  2227. </tr>
  2228. </tbody>
  2229. </table>
  2230. <h3 id="external-secrets.io/v1.AzureKVProvider">AzureKVProvider
  2231. </h3>
  2232. <p>
  2233. (<em>Appears on:</em>
  2234. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2235. </p>
  2236. <p>
  2237. <p>AzureKVProvider configures a store to sync secrets using Azure KV.</p>
  2238. </p>
  2239. <table>
  2240. <thead>
  2241. <tr>
  2242. <th>Field</th>
  2243. <th>Description</th>
  2244. </tr>
  2245. </thead>
  2246. <tbody>
  2247. <tr>
  2248. <td>
  2249. <code>authType</code></br>
  2250. <em>
  2251. <a href="#external-secrets.io/v1.AzureAuthType">
  2252. AzureAuthType
  2253. </a>
  2254. </em>
  2255. </td>
  2256. <td>
  2257. <em>(Optional)</em>
  2258. <p>Auth type defines how to authenticate to the keyvault service.
  2259. Valid values are:
  2260. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  2261. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)
  2262. - &ldquo;WorkloadIdentity&rdquo;: Using a Kubernetes ServiceAccount federated with Entra ID</p>
  2263. </td>
  2264. </tr>
  2265. <tr>
  2266. <td>
  2267. <code>vaultUrl</code></br>
  2268. <em>
  2269. string
  2270. </em>
  2271. </td>
  2272. <td>
  2273. <p>Vault Url from which the secrets to be fetched from.</p>
  2274. </td>
  2275. </tr>
  2276. <tr>
  2277. <td>
  2278. <code>tenantId</code></br>
  2279. <em>
  2280. string
  2281. </em>
  2282. </td>
  2283. <td>
  2284. <em>(Optional)</em>
  2285. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2286. </td>
  2287. </tr>
  2288. <tr>
  2289. <td>
  2290. <code>environmentType</code></br>
  2291. <em>
  2292. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  2293. AzureEnvironmentType
  2294. </a>
  2295. </em>
  2296. </td>
  2297. <td>
  2298. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  2299. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  2300. 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>
  2301. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud
  2302. Use AzureStackCloud when you need to configure custom Azure Stack Hub or Azure Stack Edge endpoints.</p>
  2303. </td>
  2304. </tr>
  2305. <tr>
  2306. <td>
  2307. <code>authSecretRef</code></br>
  2308. <em>
  2309. <a href="#external-secrets.io/v1.AzureKVAuth">
  2310. AzureKVAuth
  2311. </a>
  2312. </em>
  2313. </td>
  2314. <td>
  2315. <em>(Optional)</em>
  2316. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2317. </td>
  2318. </tr>
  2319. <tr>
  2320. <td>
  2321. <code>serviceAccountRef</code></br>
  2322. <em>
  2323. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  2324. External Secrets meta/v1.ServiceAccountSelector
  2325. </a>
  2326. </em>
  2327. </td>
  2328. <td>
  2329. <em>(Optional)</em>
  2330. <p>ServiceAccountRef specified the service account
  2331. that should be used when authenticating with WorkloadIdentity.</p>
  2332. </td>
  2333. </tr>
  2334. <tr>
  2335. <td>
  2336. <code>identityId</code></br>
  2337. <em>
  2338. string
  2339. </em>
  2340. </td>
  2341. <td>
  2342. <em>(Optional)</em>
  2343. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  2344. </td>
  2345. </tr>
  2346. <tr>
  2347. <td>
  2348. <code>useAzureSDK</code></br>
  2349. <em>
  2350. bool
  2351. </em>
  2352. </td>
  2353. <td>
  2354. <em>(Optional)</em>
  2355. <p>UseAzureSDK enables the use of the new Azure SDK for Go (azcore-based) instead of the legacy go-autorest SDK.
  2356. This is experimental and may have behavioral differences. Defaults to false (legacy SDK).</p>
  2357. </td>
  2358. </tr>
  2359. <tr>
  2360. <td>
  2361. <code>customCloudConfig</code></br>
  2362. <em>
  2363. <a href="#external-secrets.io/v1.AzureCustomCloudConfig">
  2364. AzureCustomCloudConfig
  2365. </a>
  2366. </em>
  2367. </td>
  2368. <td>
  2369. <em>(Optional)</em>
  2370. <p>CustomCloudConfig defines custom Azure endpoints for non-standard clouds.
  2371. Required when EnvironmentType is AzureStackCloud.
  2372. Optional for other environment types - useful for Azure China when using Workload Identity
  2373. with AKS, where the OIDC issuer (login.partner.microsoftonline.cn) differs from the
  2374. standard China Cloud endpoint (login.chinacloudapi.cn).
  2375. IMPORTANT: This feature REQUIRES UseAzureSDK to be set to true. Custom cloud
  2376. configuration is not supported with the legacy go-autorest SDK.</p>
  2377. </td>
  2378. </tr>
  2379. </tbody>
  2380. </table>
  2381. <h3 id="external-secrets.io/v1.BarbicanAuth">BarbicanAuth
  2382. </h3>
  2383. <p>
  2384. (<em>Appears on:</em>
  2385. <a href="#external-secrets.io/v1.BarbicanProvider">BarbicanProvider</a>)
  2386. </p>
  2387. <p>
  2388. <p>BarbicanAuth contains the authentication information for Barbican.</p>
  2389. </p>
  2390. <table>
  2391. <thead>
  2392. <tr>
  2393. <th>Field</th>
  2394. <th>Description</th>
  2395. </tr>
  2396. </thead>
  2397. <tbody>
  2398. <tr>
  2399. <td>
  2400. <code>username</code></br>
  2401. <em>
  2402. <a href="#external-secrets.io/v1.BarbicanProviderUsernameRef">
  2403. BarbicanProviderUsernameRef
  2404. </a>
  2405. </em>
  2406. </td>
  2407. <td>
  2408. </td>
  2409. </tr>
  2410. <tr>
  2411. <td>
  2412. <code>password</code></br>
  2413. <em>
  2414. <a href="#external-secrets.io/v1.BarbicanProviderPasswordRef">
  2415. BarbicanProviderPasswordRef
  2416. </a>
  2417. </em>
  2418. </td>
  2419. <td>
  2420. </td>
  2421. </tr>
  2422. </tbody>
  2423. </table>
  2424. <h3 id="external-secrets.io/v1.BarbicanProvider">BarbicanProvider
  2425. </h3>
  2426. <p>
  2427. (<em>Appears on:</em>
  2428. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2429. </p>
  2430. <p>
  2431. <p>BarbicanProvider setup a store to sync secrets with barbican.</p>
  2432. </p>
  2433. <table>
  2434. <thead>
  2435. <tr>
  2436. <th>Field</th>
  2437. <th>Description</th>
  2438. </tr>
  2439. </thead>
  2440. <tbody>
  2441. <tr>
  2442. <td>
  2443. <code>authURL</code></br>
  2444. <em>
  2445. string
  2446. </em>
  2447. </td>
  2448. <td>
  2449. </td>
  2450. </tr>
  2451. <tr>
  2452. <td>
  2453. <code>tenantName</code></br>
  2454. <em>
  2455. string
  2456. </em>
  2457. </td>
  2458. <td>
  2459. </td>
  2460. </tr>
  2461. <tr>
  2462. <td>
  2463. <code>domainName</code></br>
  2464. <em>
  2465. string
  2466. </em>
  2467. </td>
  2468. <td>
  2469. </td>
  2470. </tr>
  2471. <tr>
  2472. <td>
  2473. <code>region</code></br>
  2474. <em>
  2475. string
  2476. </em>
  2477. </td>
  2478. <td>
  2479. </td>
  2480. </tr>
  2481. <tr>
  2482. <td>
  2483. <code>auth</code></br>
  2484. <em>
  2485. <a href="#external-secrets.io/v1.BarbicanAuth">
  2486. BarbicanAuth
  2487. </a>
  2488. </em>
  2489. </td>
  2490. <td>
  2491. </td>
  2492. </tr>
  2493. </tbody>
  2494. </table>
  2495. <h3 id="external-secrets.io/v1.BarbicanProviderPasswordRef">BarbicanProviderPasswordRef
  2496. </h3>
  2497. <p>
  2498. (<em>Appears on:</em>
  2499. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2500. </p>
  2501. <p>
  2502. <p>BarbicanProviderPasswordRef defines a reference to a secret containing password for the Barbican provider.</p>
  2503. </p>
  2504. <table>
  2505. <thead>
  2506. <tr>
  2507. <th>Field</th>
  2508. <th>Description</th>
  2509. </tr>
  2510. </thead>
  2511. <tbody>
  2512. <tr>
  2513. <td>
  2514. <code>secretRef</code></br>
  2515. <em>
  2516. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2517. External Secrets meta/v1.SecretKeySelector
  2518. </a>
  2519. </em>
  2520. </td>
  2521. <td>
  2522. </td>
  2523. </tr>
  2524. </tbody>
  2525. </table>
  2526. <h3 id="external-secrets.io/v1.BarbicanProviderUsernameRef">BarbicanProviderUsernameRef
  2527. </h3>
  2528. <p>
  2529. (<em>Appears on:</em>
  2530. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2531. </p>
  2532. <p>
  2533. <p>BarbicanProviderUsernameRef defines a reference to a secret containing username for the Barbican provider.</p>
  2534. </p>
  2535. <table>
  2536. <thead>
  2537. <tr>
  2538. <th>Field</th>
  2539. <th>Description</th>
  2540. </tr>
  2541. </thead>
  2542. <tbody>
  2543. <tr>
  2544. <td>
  2545. <code>value</code></br>
  2546. <em>
  2547. string
  2548. </em>
  2549. </td>
  2550. <td>
  2551. </td>
  2552. </tr>
  2553. <tr>
  2554. <td>
  2555. <code>secretRef</code></br>
  2556. <em>
  2557. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2558. External Secrets meta/v1.SecretKeySelector
  2559. </a>
  2560. </em>
  2561. </td>
  2562. <td>
  2563. </td>
  2564. </tr>
  2565. </tbody>
  2566. </table>
  2567. <h3 id="external-secrets.io/v1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  2568. </h3>
  2569. <p>
  2570. (<em>Appears on:</em>
  2571. <a href="#external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth</a>)
  2572. </p>
  2573. <p>
  2574. <p>BeyondTrustProviderSecretRef references a value that can be specified directly or via a secret
  2575. for a BeyondTrustProvider.</p>
  2576. </p>
  2577. <table>
  2578. <thead>
  2579. <tr>
  2580. <th>Field</th>
  2581. <th>Description</th>
  2582. </tr>
  2583. </thead>
  2584. <tbody>
  2585. <tr>
  2586. <td>
  2587. <code>value</code></br>
  2588. <em>
  2589. string
  2590. </em>
  2591. </td>
  2592. <td>
  2593. <em>(Optional)</em>
  2594. <p>Value can be specified directly to set a value without using a secret.</p>
  2595. </td>
  2596. </tr>
  2597. <tr>
  2598. <td>
  2599. <code>secretRef</code></br>
  2600. <em>
  2601. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2602. External Secrets meta/v1.SecretKeySelector
  2603. </a>
  2604. </em>
  2605. </td>
  2606. <td>
  2607. <em>(Optional)</em>
  2608. <p>SecretRef references a key in a secret that will be used as value.</p>
  2609. </td>
  2610. </tr>
  2611. </tbody>
  2612. </table>
  2613. <h3 id="external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth
  2614. </h3>
  2615. <p>
  2616. (<em>Appears on:</em>
  2617. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2618. </p>
  2619. <p>
  2620. <p>BeyondtrustAuth provides different ways to authenticate to a BeyondtrustProvider server.</p>
  2621. </p>
  2622. <table>
  2623. <thead>
  2624. <tr>
  2625. <th>Field</th>
  2626. <th>Description</th>
  2627. </tr>
  2628. </thead>
  2629. <tbody>
  2630. <tr>
  2631. <td>
  2632. <code>apiKey</code></br>
  2633. <em>
  2634. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2635. BeyondTrustProviderSecretRef
  2636. </a>
  2637. </em>
  2638. </td>
  2639. <td>
  2640. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  2641. </td>
  2642. </tr>
  2643. <tr>
  2644. <td>
  2645. <code>clientId</code></br>
  2646. <em>
  2647. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2648. BeyondTrustProviderSecretRef
  2649. </a>
  2650. </em>
  2651. </td>
  2652. <td>
  2653. <p>ClientID is the API OAuth Client ID.</p>
  2654. </td>
  2655. </tr>
  2656. <tr>
  2657. <td>
  2658. <code>clientSecret</code></br>
  2659. <em>
  2660. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2661. BeyondTrustProviderSecretRef
  2662. </a>
  2663. </em>
  2664. </td>
  2665. <td>
  2666. <p>ClientSecret is the API OAuth Client Secret.</p>
  2667. </td>
  2668. </tr>
  2669. <tr>
  2670. <td>
  2671. <code>certificate</code></br>
  2672. <em>
  2673. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2674. BeyondTrustProviderSecretRef
  2675. </a>
  2676. </em>
  2677. </td>
  2678. <td>
  2679. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  2680. </td>
  2681. </tr>
  2682. <tr>
  2683. <td>
  2684. <code>certificateKey</code></br>
  2685. <em>
  2686. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2687. BeyondTrustProviderSecretRef
  2688. </a>
  2689. </em>
  2690. </td>
  2691. <td>
  2692. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  2693. </td>
  2694. </tr>
  2695. </tbody>
  2696. </table>
  2697. <h3 id="external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider
  2698. </h3>
  2699. <p>
  2700. (<em>Appears on:</em>
  2701. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2702. </p>
  2703. <p>
  2704. <p>BeyondtrustProvider provides access to a BeyondTrust secrets provider.</p>
  2705. </p>
  2706. <table>
  2707. <thead>
  2708. <tr>
  2709. <th>Field</th>
  2710. <th>Description</th>
  2711. </tr>
  2712. </thead>
  2713. <tbody>
  2714. <tr>
  2715. <td>
  2716. <code>auth</code></br>
  2717. <em>
  2718. <a href="#external-secrets.io/v1.BeyondtrustAuth">
  2719. BeyondtrustAuth
  2720. </a>
  2721. </em>
  2722. </td>
  2723. <td>
  2724. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  2725. </td>
  2726. </tr>
  2727. <tr>
  2728. <td>
  2729. <code>server</code></br>
  2730. <em>
  2731. <a href="#external-secrets.io/v1.BeyondtrustServer">
  2732. BeyondtrustServer
  2733. </a>
  2734. </em>
  2735. </td>
  2736. <td>
  2737. <p>Auth configures how API server works.</p>
  2738. </td>
  2739. </tr>
  2740. </tbody>
  2741. </table>
  2742. <h3 id="external-secrets.io/v1.BeyondtrustServer">BeyondtrustServer
  2743. </h3>
  2744. <p>
  2745. (<em>Appears on:</em>
  2746. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2747. </p>
  2748. <p>
  2749. <p>BeyondtrustServer configures a store to sync secrets using BeyondTrust Password Safe.</p>
  2750. </p>
  2751. <table>
  2752. <thead>
  2753. <tr>
  2754. <th>Field</th>
  2755. <th>Description</th>
  2756. </tr>
  2757. </thead>
  2758. <tbody>
  2759. <tr>
  2760. <td>
  2761. <code>apiUrl</code></br>
  2762. <em>
  2763. string
  2764. </em>
  2765. </td>
  2766. <td>
  2767. </td>
  2768. </tr>
  2769. <tr>
  2770. <td>
  2771. <code>apiVersion</code></br>
  2772. <em>
  2773. string
  2774. </em>
  2775. </td>
  2776. <td>
  2777. </td>
  2778. </tr>
  2779. <tr>
  2780. <td>
  2781. <code>retrievalType</code></br>
  2782. <em>
  2783. string
  2784. </em>
  2785. </td>
  2786. <td>
  2787. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  2788. </td>
  2789. </tr>
  2790. <tr>
  2791. <td>
  2792. <code>separator</code></br>
  2793. <em>
  2794. string
  2795. </em>
  2796. </td>
  2797. <td>
  2798. <p>A character that separates the folder names.</p>
  2799. </td>
  2800. </tr>
  2801. <tr>
  2802. <td>
  2803. <code>decrypt</code></br>
  2804. <em>
  2805. bool
  2806. </em>
  2807. </td>
  2808. <td>
  2809. <em>(Optional)</em>
  2810. <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>
  2811. </td>
  2812. </tr>
  2813. <tr>
  2814. <td>
  2815. <code>verifyCA</code></br>
  2816. <em>
  2817. bool
  2818. </em>
  2819. </td>
  2820. <td>
  2821. </td>
  2822. </tr>
  2823. <tr>
  2824. <td>
  2825. <code>clientTimeOutSeconds</code></br>
  2826. <em>
  2827. int
  2828. </em>
  2829. </td>
  2830. <td>
  2831. <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>
  2832. </td>
  2833. </tr>
  2834. </tbody>
  2835. </table>
  2836. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">BeyondtrustWorkloadCredentialsAuth
  2837. </h3>
  2838. <p>
  2839. (<em>Appears on:</em>
  2840. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>)
  2841. </p>
  2842. <p>
  2843. <p>BeyondtrustWorkloadCredentialsAuth defines the authentication method for the BeyondTrust Workload Credentials provider.
  2844. Currently supports API key authentication via Kubernetes secret reference.
  2845. 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>
  2846. </p>
  2847. <table>
  2848. <thead>
  2849. <tr>
  2850. <th>Field</th>
  2851. <th>Description</th>
  2852. </tr>
  2853. </thead>
  2854. <tbody>
  2855. <tr>
  2856. <td>
  2857. <code>apikey</code></br>
  2858. <em>
  2859. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuthSecretRef">
  2860. BeyondtrustWorkloadCredentialsAuthSecretRef
  2861. </a>
  2862. </em>
  2863. </td>
  2864. <td>
  2865. <p>APIKey configures API token authentication for BeyondTrust Workload Credentials.
  2866. The token is retrieved from a Kubernetes secret and used as a Bearer token for API requests.</p>
  2867. </td>
  2868. </tr>
  2869. </tbody>
  2870. </table>
  2871. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuthSecretRef">BeyondtrustWorkloadCredentialsAuthSecretRef
  2872. </h3>
  2873. <p>
  2874. (<em>Appears on:</em>
  2875. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">BeyondtrustWorkloadCredentialsAuth</a>)
  2876. </p>
  2877. <p>
  2878. <p>BeyondtrustWorkloadCredentialsAuthSecretRef defines a reference to a secret containing credentials for the BeyondTrust Workload Credentials provider.
  2879. The nested structure supports multiple authentication methods (currently only API token is supported).
  2880. 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>
  2881. </p>
  2882. <table>
  2883. <thead>
  2884. <tr>
  2885. <th>Field</th>
  2886. <th>Description</th>
  2887. </tr>
  2888. </thead>
  2889. <tbody>
  2890. <tr>
  2891. <td>
  2892. <code>token</code></br>
  2893. <em>
  2894. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2895. External Secrets meta/v1.SecretKeySelector
  2896. </a>
  2897. </em>
  2898. </td>
  2899. <td>
  2900. <p>Token references the Kubernetes secret containing the BeyondTrust Workload Credentials API token.
  2901. The secret should contain the API key used to authenticate with BeyondTrust Workload Credentials.
  2902. Create an API token in your BeyondTrust Workload Credentials console and store it in a Kubernetes secret.
  2903. 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>
  2904. </td>
  2905. </tr>
  2906. </tbody>
  2907. </table>
  2908. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider
  2909. </h3>
  2910. <p>
  2911. (<em>Appears on:</em>
  2912. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  2913. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec</a>)
  2914. </p>
  2915. <p>
  2916. <p>BeyondtrustWorkloadCredentialsProvider configures a store to sync secrets using the BeyondTrust Workload Credentials provider.
  2917. BeyondTrust Workload Credentials provides secure storage for static secrets and dynamic credential generation.
  2918. This provider supports reading secrets and generating dynamic credentials (e.g., temporary AWS credentials).
  2919. 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>
  2920. </p>
  2921. <table>
  2922. <thead>
  2923. <tr>
  2924. <th>Field</th>
  2925. <th>Description</th>
  2926. </tr>
  2927. </thead>
  2928. <tbody>
  2929. <tr>
  2930. <td>
  2931. <code>auth</code></br>
  2932. <em>
  2933. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsAuth">
  2934. BeyondtrustWorkloadCredentialsAuth
  2935. </a>
  2936. </em>
  2937. </td>
  2938. <td>
  2939. <p>Auth configures how the Operator authenticates with the BeyondTrust Workload Credentials API.
  2940. Currently supports API key authentication via Kubernetes secret reference.
  2941. 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>
  2942. </td>
  2943. </tr>
  2944. <tr>
  2945. <td>
  2946. <code>server</code></br>
  2947. <em>
  2948. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsServer">
  2949. BeyondtrustWorkloadCredentialsServer
  2950. </a>
  2951. </em>
  2952. </td>
  2953. <td>
  2954. <p>Server configures the BeyondTrust Workload Credentials server connection details.
  2955. Includes the API URL and Site ID for your BeyondTrust instance.
  2956. 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>
  2957. </td>
  2958. </tr>
  2959. <tr>
  2960. <td>
  2961. <code>folderPath</code></br>
  2962. <em>
  2963. string
  2964. </em>
  2965. </td>
  2966. <td>
  2967. <em>(Optional)</em>
  2968. <p>FolderPath specifies the default folder path for secret retrieval.
  2969. Secrets will be fetched from this folder unless overridden in the ExternalSecret spec.
  2970. Example: &ldquo;production/database&rdquo; or &ldquo;dev/api-keys&rdquo;
  2971. Leave empty to retrieve secrets from the root folder.
  2972. 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>
  2973. </td>
  2974. </tr>
  2975. <tr>
  2976. <td>
  2977. <code>caBundle</code></br>
  2978. <em>
  2979. []byte
  2980. </em>
  2981. </td>
  2982. <td>
  2983. <em>(Optional)</em>
  2984. <p>CABundle is a base64-encoded CA certificate used to validate the BeyondTrust Workload Credentials API TLS certificate.
  2985. Use this when your BeyondTrust instance uses a self-signed certificate or internal CA.
  2986. If not set, the system&rsquo;s trusted root certificates are used.</p>
  2987. </td>
  2988. </tr>
  2989. <tr>
  2990. <td>
  2991. <code>caProvider</code></br>
  2992. <em>
  2993. <a href="#external-secrets.io/v1.CAProvider">
  2994. CAProvider
  2995. </a>
  2996. </em>
  2997. </td>
  2998. <td>
  2999. <em>(Optional)</em>
  3000. <p>CAProvider points to a Secret or ConfigMap containing a PEM-encoded CA certificate.
  3001. This is used to validate the BeyondTrust Workload Credentials API TLS certificate.
  3002. Use this as an alternative to CABundle when you want to reference an existing Kubernetes resource.</p>
  3003. </td>
  3004. </tr>
  3005. </tbody>
  3006. </table>
  3007. <h3 id="external-secrets.io/v1.BeyondtrustWorkloadCredentialsServer">BeyondtrustWorkloadCredentialsServer
  3008. </h3>
  3009. <p>
  3010. (<em>Appears on:</em>
  3011. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>)
  3012. </p>
  3013. <p>
  3014. <p>BeyondtrustWorkloadCredentialsServer defines connection configuration for BeyondTrust Workload Credentials.
  3015. 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>
  3016. </p>
  3017. <table>
  3018. <thead>
  3019. <tr>
  3020. <th>Field</th>
  3021. <th>Description</th>
  3022. </tr>
  3023. </thead>
  3024. <tbody>
  3025. <tr>
  3026. <td>
  3027. <code>apiUrl</code></br>
  3028. <em>
  3029. string
  3030. </em>
  3031. </td>
  3032. <td>
  3033. <p>APIURL is the base URL of your BeyondTrust Workload Credentials API server.
  3034. This should be the full URL to your BeyondTrust instance.
  3035. Example: <a href="https://api.beyondtrust.io/siie">https://api.beyondtrust.io/siie</a>
  3036. 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>
  3037. </td>
  3038. </tr>
  3039. <tr>
  3040. <td>
  3041. <code>siteId</code></br>
  3042. <em>
  3043. string
  3044. </em>
  3045. </td>
  3046. <td>
  3047. <p>SiteID is your BeyondTrust Workload Credentials site identifier (UUID format).
  3048. This identifier is unique to your BeyondTrust Workload Credentials instance.
  3049. You can find your Site ID in the BeyondTrust Workload Credentials admin console.
  3050. Example: a1b2c3d4-e5f6-4890-abcd-ef1234567890
  3051. 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>
  3052. </td>
  3053. </tr>
  3054. </tbody>
  3055. </table>
  3056. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  3057. </h3>
  3058. <p>
  3059. (<em>Appears on:</em>
  3060. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  3061. </p>
  3062. <p>
  3063. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  3064. </p>
  3065. <table>
  3066. <thead>
  3067. <tr>
  3068. <th>Field</th>
  3069. <th>Description</th>
  3070. </tr>
  3071. </thead>
  3072. <tbody>
  3073. <tr>
  3074. <td>
  3075. <code>secretRef</code></br>
  3076. <em>
  3077. <a href="#external-secrets.io/v1.BitwardenSecretsManagerSecretRef">
  3078. BitwardenSecretsManagerSecretRef
  3079. </a>
  3080. </em>
  3081. </td>
  3082. <td>
  3083. </td>
  3084. </tr>
  3085. </tbody>
  3086. </table>
  3087. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  3088. </h3>
  3089. <p>
  3090. (<em>Appears on:</em>
  3091. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3092. </p>
  3093. <p>
  3094. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  3095. </p>
  3096. <table>
  3097. <thead>
  3098. <tr>
  3099. <th>Field</th>
  3100. <th>Description</th>
  3101. </tr>
  3102. </thead>
  3103. <tbody>
  3104. <tr>
  3105. <td>
  3106. <code>apiURL</code></br>
  3107. <em>
  3108. string
  3109. </em>
  3110. </td>
  3111. <td>
  3112. </td>
  3113. </tr>
  3114. <tr>
  3115. <td>
  3116. <code>identityURL</code></br>
  3117. <em>
  3118. string
  3119. </em>
  3120. </td>
  3121. <td>
  3122. </td>
  3123. </tr>
  3124. <tr>
  3125. <td>
  3126. <code>bitwardenServerSDKURL</code></br>
  3127. <em>
  3128. string
  3129. </em>
  3130. </td>
  3131. <td>
  3132. </td>
  3133. </tr>
  3134. <tr>
  3135. <td>
  3136. <code>caBundle</code></br>
  3137. <em>
  3138. string
  3139. </em>
  3140. </td>
  3141. <td>
  3142. <em>(Optional)</em>
  3143. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  3144. can be performed.</p>
  3145. </td>
  3146. </tr>
  3147. <tr>
  3148. <td>
  3149. <code>caProvider</code></br>
  3150. <em>
  3151. <a href="#external-secrets.io/v1.CAProvider">
  3152. CAProvider
  3153. </a>
  3154. </em>
  3155. </td>
  3156. <td>
  3157. <em>(Optional)</em>
  3158. <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>
  3159. </td>
  3160. </tr>
  3161. <tr>
  3162. <td>
  3163. <code>organizationID</code></br>
  3164. <em>
  3165. string
  3166. </em>
  3167. </td>
  3168. <td>
  3169. <p>OrganizationID determines which organization this secret store manages.</p>
  3170. </td>
  3171. </tr>
  3172. <tr>
  3173. <td>
  3174. <code>projectID</code></br>
  3175. <em>
  3176. string
  3177. </em>
  3178. </td>
  3179. <td>
  3180. <p>ProjectID determines which project this secret store manages.</p>
  3181. </td>
  3182. </tr>
  3183. <tr>
  3184. <td>
  3185. <code>auth</code></br>
  3186. <em>
  3187. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">
  3188. BitwardenSecretsManagerAuth
  3189. </a>
  3190. </em>
  3191. </td>
  3192. <td>
  3193. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  3194. Make sure that the token being used has permissions on the given secret.</p>
  3195. </td>
  3196. </tr>
  3197. </tbody>
  3198. </table>
  3199. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  3200. </h3>
  3201. <p>
  3202. (<em>Appears on:</em>
  3203. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  3204. </p>
  3205. <p>
  3206. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  3207. </p>
  3208. <table>
  3209. <thead>
  3210. <tr>
  3211. <th>Field</th>
  3212. <th>Description</th>
  3213. </tr>
  3214. </thead>
  3215. <tbody>
  3216. <tr>
  3217. <td>
  3218. <code>credentials</code></br>
  3219. <em>
  3220. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3221. External Secrets meta/v1.SecretKeySelector
  3222. </a>
  3223. </em>
  3224. </td>
  3225. <td>
  3226. <p>AccessToken used for the bitwarden instance.</p>
  3227. </td>
  3228. </tr>
  3229. </tbody>
  3230. </table>
  3231. <h3 id="external-secrets.io/v1.ByID">ByID
  3232. </h3>
  3233. <p>
  3234. (<em>Appears on:</em>
  3235. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  3236. </p>
  3237. <p>
  3238. <p>ByID configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID.</p>
  3239. </p>
  3240. <h3 id="external-secrets.io/v1.ByName">ByName
  3241. </h3>
  3242. <p>
  3243. (<em>Appears on:</em>
  3244. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  3245. </p>
  3246. <p>
  3247. <p>ByName configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret name.</p>
  3248. </p>
  3249. <table>
  3250. <thead>
  3251. <tr>
  3252. <th>Field</th>
  3253. <th>Description</th>
  3254. </tr>
  3255. </thead>
  3256. <tbody>
  3257. <tr>
  3258. <td>
  3259. <code>folderID</code></br>
  3260. <em>
  3261. string
  3262. </em>
  3263. </td>
  3264. <td>
  3265. <p>The folder to fetch secrets from</p>
  3266. </td>
  3267. </tr>
  3268. </tbody>
  3269. </table>
  3270. <h3 id="external-secrets.io/v1.CAProvider">CAProvider
  3271. </h3>
  3272. <p>
  3273. (<em>Appears on:</em>
  3274. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>,
  3275. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">BeyondtrustWorkloadCredentialsProvider</a>,
  3276. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  3277. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>,
  3278. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>,
  3279. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>,
  3280. <a href="#external-secrets.io/v1.KubernetesServer">KubernetesServer</a>,
  3281. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>,
  3282. <a href="#external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS</a>,
  3283. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>,
  3284. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>,
  3285. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  3286. </p>
  3287. <p>
  3288. <p>CAProvider provides a custom certificate authority for accessing the provider&rsquo;s store.
  3289. The CAProvider points to a Secret or ConfigMap resource that contains a PEM-encoded certificate.</p>
  3290. </p>
  3291. <table>
  3292. <thead>
  3293. <tr>
  3294. <th>Field</th>
  3295. <th>Description</th>
  3296. </tr>
  3297. </thead>
  3298. <tbody>
  3299. <tr>
  3300. <td>
  3301. <code>type</code></br>
  3302. <em>
  3303. <a href="#external-secrets.io/v1.CAProviderType">
  3304. CAProviderType
  3305. </a>
  3306. </em>
  3307. </td>
  3308. <td>
  3309. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  3310. </td>
  3311. </tr>
  3312. <tr>
  3313. <td>
  3314. <code>name</code></br>
  3315. <em>
  3316. string
  3317. </em>
  3318. </td>
  3319. <td>
  3320. <p>The name of the object located at the provider type.</p>
  3321. </td>
  3322. </tr>
  3323. <tr>
  3324. <td>
  3325. <code>key</code></br>
  3326. <em>
  3327. string
  3328. </em>
  3329. </td>
  3330. <td>
  3331. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  3332. </td>
  3333. </tr>
  3334. <tr>
  3335. <td>
  3336. <code>namespace</code></br>
  3337. <em>
  3338. string
  3339. </em>
  3340. </td>
  3341. <td>
  3342. <em>(Optional)</em>
  3343. <p>The namespace the Provider type is in.
  3344. Can only be defined when used in a ClusterSecretStore.</p>
  3345. </td>
  3346. </tr>
  3347. </tbody>
  3348. </table>
  3349. <h3 id="external-secrets.io/v1.CAProviderType">CAProviderType
  3350. (<code>string</code> alias)</p></h3>
  3351. <p>
  3352. (<em>Appears on:</em>
  3353. <a href="#external-secrets.io/v1.CAProvider">CAProvider</a>)
  3354. </p>
  3355. <p>
  3356. <p>CAProviderType defines the type of provider for certificate authority.</p>
  3357. </p>
  3358. <table>
  3359. <thead>
  3360. <tr>
  3361. <th>Value</th>
  3362. <th>Description</th>
  3363. </tr>
  3364. </thead>
  3365. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  3366. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  3367. </td>
  3368. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  3369. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  3370. </td>
  3371. </tr></tbody>
  3372. </table>
  3373. <h3 id="external-secrets.io/v1.CSMAuth">CSMAuth
  3374. </h3>
  3375. <p>
  3376. (<em>Appears on:</em>
  3377. <a href="#external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider</a>)
  3378. </p>
  3379. <p>
  3380. <p>CSMAuth contains a secretRef for credentials.</p>
  3381. </p>
  3382. <table>
  3383. <thead>
  3384. <tr>
  3385. <th>Field</th>
  3386. <th>Description</th>
  3387. </tr>
  3388. </thead>
  3389. <tbody>
  3390. <tr>
  3391. <td>
  3392. <code>secretRef</code></br>
  3393. <em>
  3394. <a href="#external-secrets.io/v1.CSMAuthSecretRef">
  3395. CSMAuthSecretRef
  3396. </a>
  3397. </em>
  3398. </td>
  3399. <td>
  3400. <em>(Optional)</em>
  3401. </td>
  3402. </tr>
  3403. </tbody>
  3404. </table>
  3405. <h3 id="external-secrets.io/v1.CSMAuthSecretRef">CSMAuthSecretRef
  3406. </h3>
  3407. <p>
  3408. (<em>Appears on:</em>
  3409. <a href="#external-secrets.io/v1.CSMAuth">CSMAuth</a>)
  3410. </p>
  3411. <p>
  3412. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  3413. </p>
  3414. <table>
  3415. <thead>
  3416. <tr>
  3417. <th>Field</th>
  3418. <th>Description</th>
  3419. </tr>
  3420. </thead>
  3421. <tbody>
  3422. <tr>
  3423. <td>
  3424. <code>accessKeyIDSecretRef</code></br>
  3425. <em>
  3426. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3427. External Secrets meta/v1.SecretKeySelector
  3428. </a>
  3429. </em>
  3430. </td>
  3431. <td>
  3432. <p>The AccessKeyID is used for authentication</p>
  3433. </td>
  3434. </tr>
  3435. <tr>
  3436. <td>
  3437. <code>accessKeySecretSecretRef</code></br>
  3438. <em>
  3439. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3440. External Secrets meta/v1.SecretKeySelector
  3441. </a>
  3442. </em>
  3443. </td>
  3444. <td>
  3445. <p>The AccessKeySecret is used for authentication</p>
  3446. </td>
  3447. </tr>
  3448. </tbody>
  3449. </table>
  3450. <h3 id="external-secrets.io/v1.CacheConfig">CacheConfig
  3451. </h3>
  3452. <p>
  3453. (<em>Appears on:</em>
  3454. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  3455. </p>
  3456. <p>
  3457. <p>CacheConfig configures client-side caching for read operations.</p>
  3458. </p>
  3459. <table>
  3460. <thead>
  3461. <tr>
  3462. <th>Field</th>
  3463. <th>Description</th>
  3464. </tr>
  3465. </thead>
  3466. <tbody>
  3467. <tr>
  3468. <td>
  3469. <code>ttl</code></br>
  3470. <em>
  3471. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3472. Kubernetes meta/v1.Duration
  3473. </a>
  3474. </em>
  3475. </td>
  3476. <td>
  3477. <em>(Optional)</em>
  3478. <p>TTL is the time-to-live for cached secrets.
  3479. Format: duration string (e.g., &ldquo;5m&rdquo;, &ldquo;1h&rdquo;, &ldquo;30s&rdquo;)</p>
  3480. </td>
  3481. </tr>
  3482. <tr>
  3483. <td>
  3484. <code>maxSize</code></br>
  3485. <em>
  3486. int
  3487. </em>
  3488. </td>
  3489. <td>
  3490. <em>(Optional)</em>
  3491. <p>MaxSize is the maximum number of secrets to cache.
  3492. When the cache is full, least-recently-used entries are evicted.</p>
  3493. </td>
  3494. </tr>
  3495. </tbody>
  3496. </table>
  3497. <h3 id="external-secrets.io/v1.CertAuth">CertAuth
  3498. </h3>
  3499. <p>
  3500. (<em>Appears on:</em>
  3501. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  3502. </p>
  3503. <p>
  3504. <p>CertAuth defines certificate-based authentication configuration for Kubernetes.</p>
  3505. </p>
  3506. <table>
  3507. <thead>
  3508. <tr>
  3509. <th>Field</th>
  3510. <th>Description</th>
  3511. </tr>
  3512. </thead>
  3513. <tbody>
  3514. <tr>
  3515. <td>
  3516. <code>clientCert</code></br>
  3517. <em>
  3518. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3519. External Secrets meta/v1.SecretKeySelector
  3520. </a>
  3521. </em>
  3522. </td>
  3523. <td>
  3524. </td>
  3525. </tr>
  3526. <tr>
  3527. <td>
  3528. <code>clientKey</code></br>
  3529. <em>
  3530. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3531. External Secrets meta/v1.SecretKeySelector
  3532. </a>
  3533. </em>
  3534. </td>
  3535. <td>
  3536. </td>
  3537. </tr>
  3538. </tbody>
  3539. </table>
  3540. <h3 id="external-secrets.io/v1.ChefAuth">ChefAuth
  3541. </h3>
  3542. <p>
  3543. (<em>Appears on:</em>
  3544. <a href="#external-secrets.io/v1.ChefProvider">ChefProvider</a>)
  3545. </p>
  3546. <p>
  3547. <p>ChefAuth contains a secretRef for credentials.</p>
  3548. </p>
  3549. <table>
  3550. <thead>
  3551. <tr>
  3552. <th>Field</th>
  3553. <th>Description</th>
  3554. </tr>
  3555. </thead>
  3556. <tbody>
  3557. <tr>
  3558. <td>
  3559. <code>secretRef</code></br>
  3560. <em>
  3561. <a href="#external-secrets.io/v1.ChefAuthSecretRef">
  3562. ChefAuthSecretRef
  3563. </a>
  3564. </em>
  3565. </td>
  3566. <td>
  3567. </td>
  3568. </tr>
  3569. </tbody>
  3570. </table>
  3571. <h3 id="external-secrets.io/v1.ChefAuthSecretRef">ChefAuthSecretRef
  3572. </h3>
  3573. <p>
  3574. (<em>Appears on:</em>
  3575. <a href="#external-secrets.io/v1.ChefAuth">ChefAuth</a>)
  3576. </p>
  3577. <p>
  3578. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  3579. </p>
  3580. <table>
  3581. <thead>
  3582. <tr>
  3583. <th>Field</th>
  3584. <th>Description</th>
  3585. </tr>
  3586. </thead>
  3587. <tbody>
  3588. <tr>
  3589. <td>
  3590. <code>privateKeySecretRef</code></br>
  3591. <em>
  3592. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3593. External Secrets meta/v1.SecretKeySelector
  3594. </a>
  3595. </em>
  3596. </td>
  3597. <td>
  3598. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  3599. </td>
  3600. </tr>
  3601. </tbody>
  3602. </table>
  3603. <h3 id="external-secrets.io/v1.ChefProvider">ChefProvider
  3604. </h3>
  3605. <p>
  3606. (<em>Appears on:</em>
  3607. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3608. </p>
  3609. <p>
  3610. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  3611. </p>
  3612. <table>
  3613. <thead>
  3614. <tr>
  3615. <th>Field</th>
  3616. <th>Description</th>
  3617. </tr>
  3618. </thead>
  3619. <tbody>
  3620. <tr>
  3621. <td>
  3622. <code>auth</code></br>
  3623. <em>
  3624. <a href="#external-secrets.io/v1.ChefAuth">
  3625. ChefAuth
  3626. </a>
  3627. </em>
  3628. </td>
  3629. <td>
  3630. <p>Auth defines the information necessary to authenticate against chef Server</p>
  3631. </td>
  3632. </tr>
  3633. <tr>
  3634. <td>
  3635. <code>username</code></br>
  3636. <em>
  3637. string
  3638. </em>
  3639. </td>
  3640. <td>
  3641. <p>UserName should be the user ID on the chef server</p>
  3642. </td>
  3643. </tr>
  3644. <tr>
  3645. <td>
  3646. <code>serverUrl</code></br>
  3647. <em>
  3648. string
  3649. </em>
  3650. </td>
  3651. <td>
  3652. <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>
  3653. </td>
  3654. </tr>
  3655. </tbody>
  3656. </table>
  3657. <h3 id="external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider
  3658. </h3>
  3659. <p>
  3660. (<em>Appears on:</em>
  3661. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3662. </p>
  3663. <p>
  3664. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  3665. </p>
  3666. <table>
  3667. <thead>
  3668. <tr>
  3669. <th>Field</th>
  3670. <th>Description</th>
  3671. </tr>
  3672. </thead>
  3673. <tbody>
  3674. <tr>
  3675. <td>
  3676. <code>auth</code></br>
  3677. <em>
  3678. <a href="#external-secrets.io/v1.CSMAuth">
  3679. CSMAuth
  3680. </a>
  3681. </em>
  3682. </td>
  3683. <td>
  3684. </td>
  3685. </tr>
  3686. <tr>
  3687. <td>
  3688. <code>projectID</code></br>
  3689. <em>
  3690. string
  3691. </em>
  3692. </td>
  3693. <td>
  3694. <p>ProjectID is the project, which the secrets are stored in.</p>
  3695. </td>
  3696. </tr>
  3697. </tbody>
  3698. </table>
  3699. <h3 id="external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret
  3700. </h3>
  3701. <p>
  3702. <p>ClusterExternalSecret is the Schema for the clusterexternalsecrets API.</p>
  3703. </p>
  3704. <table>
  3705. <thead>
  3706. <tr>
  3707. <th>Field</th>
  3708. <th>Description</th>
  3709. </tr>
  3710. </thead>
  3711. <tbody>
  3712. <tr>
  3713. <td>
  3714. <code>metadata</code></br>
  3715. <em>
  3716. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  3717. Kubernetes meta/v1.ObjectMeta
  3718. </a>
  3719. </em>
  3720. </td>
  3721. <td>
  3722. Refer to the Kubernetes API documentation for the fields of the
  3723. <code>metadata</code> field.
  3724. </td>
  3725. </tr>
  3726. <tr>
  3727. <td>
  3728. <code>spec</code></br>
  3729. <em>
  3730. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">
  3731. ClusterExternalSecretSpec
  3732. </a>
  3733. </em>
  3734. </td>
  3735. <td>
  3736. <br/>
  3737. <br/>
  3738. <table>
  3739. <tr>
  3740. <td>
  3741. <code>externalSecretSpec</code></br>
  3742. <em>
  3743. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3744. ExternalSecretSpec
  3745. </a>
  3746. </em>
  3747. </td>
  3748. <td>
  3749. <p>The spec for the ExternalSecrets to be created</p>
  3750. </td>
  3751. </tr>
  3752. <tr>
  3753. <td>
  3754. <code>externalSecretName</code></br>
  3755. <em>
  3756. string
  3757. </em>
  3758. </td>
  3759. <td>
  3760. <em>(Optional)</em>
  3761. <p>The name of the external secrets to be created.
  3762. Defaults to the name of the ClusterExternalSecret</p>
  3763. </td>
  3764. </tr>
  3765. <tr>
  3766. <td>
  3767. <code>externalSecretMetadata</code></br>
  3768. <em>
  3769. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3770. ExternalSecretMetadata
  3771. </a>
  3772. </em>
  3773. </td>
  3774. <td>
  3775. <em>(Optional)</em>
  3776. <p>The metadata of the external secrets to be created</p>
  3777. </td>
  3778. </tr>
  3779. <tr>
  3780. <td>
  3781. <code>namespaceSelector</code></br>
  3782. <em>
  3783. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3784. Kubernetes meta/v1.LabelSelector
  3785. </a>
  3786. </em>
  3787. </td>
  3788. <td>
  3789. <em>(Optional)</em>
  3790. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3791. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3792. </td>
  3793. </tr>
  3794. <tr>
  3795. <td>
  3796. <code>namespaceSelectors</code></br>
  3797. <em>
  3798. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3799. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3800. </a>
  3801. </em>
  3802. </td>
  3803. <td>
  3804. <em>(Optional)</em>
  3805. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  3806. </td>
  3807. </tr>
  3808. <tr>
  3809. <td>
  3810. <code>namespaces</code></br>
  3811. <em>
  3812. []string
  3813. </em>
  3814. </td>
  3815. <td>
  3816. <em>(Optional)</em>
  3817. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  3818. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3819. </td>
  3820. </tr>
  3821. <tr>
  3822. <td>
  3823. <code>refreshTime</code></br>
  3824. <em>
  3825. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3826. Kubernetes meta/v1.Duration
  3827. </a>
  3828. </em>
  3829. </td>
  3830. <td>
  3831. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  3832. </td>
  3833. </tr>
  3834. </table>
  3835. </td>
  3836. </tr>
  3837. <tr>
  3838. <td>
  3839. <code>status</code></br>
  3840. <em>
  3841. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">
  3842. ClusterExternalSecretStatus
  3843. </a>
  3844. </em>
  3845. </td>
  3846. <td>
  3847. </td>
  3848. </tr>
  3849. </tbody>
  3850. </table>
  3851. <h3 id="external-secrets.io/v1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  3852. (<code>string</code> alias)</p></h3>
  3853. <p>
  3854. (<em>Appears on:</em>
  3855. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  3856. </p>
  3857. <p>
  3858. <p>ClusterExternalSecretConditionType defines a value type for ClusterExternalSecret conditions.</p>
  3859. </p>
  3860. <table>
  3861. <thead>
  3862. <tr>
  3863. <th>Value</th>
  3864. <th>Description</th>
  3865. </tr>
  3866. </thead>
  3867. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  3868. <td><p>ClusterExternalSecretReady is a ClusterExternalSecretConditionType set when the ClusterExternalSecret is ready.</p>
  3869. </td>
  3870. </tr></tbody>
  3871. </table>
  3872. <h3 id="external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  3873. </h3>
  3874. <p>
  3875. (<em>Appears on:</em>
  3876. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  3877. </p>
  3878. <p>
  3879. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  3880. </p>
  3881. <table>
  3882. <thead>
  3883. <tr>
  3884. <th>Field</th>
  3885. <th>Description</th>
  3886. </tr>
  3887. </thead>
  3888. <tbody>
  3889. <tr>
  3890. <td>
  3891. <code>namespace</code></br>
  3892. <em>
  3893. string
  3894. </em>
  3895. </td>
  3896. <td>
  3897. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  3898. </td>
  3899. </tr>
  3900. <tr>
  3901. <td>
  3902. <code>reason</code></br>
  3903. <em>
  3904. string
  3905. </em>
  3906. </td>
  3907. <td>
  3908. <em>(Optional)</em>
  3909. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  3910. </td>
  3911. </tr>
  3912. </tbody>
  3913. </table>
  3914. <h3 id="external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  3915. </h3>
  3916. <p>
  3917. (<em>Appears on:</em>
  3918. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  3919. </p>
  3920. <p>
  3921. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  3922. </p>
  3923. <table>
  3924. <thead>
  3925. <tr>
  3926. <th>Field</th>
  3927. <th>Description</th>
  3928. </tr>
  3929. </thead>
  3930. <tbody>
  3931. <tr>
  3932. <td>
  3933. <code>externalSecretSpec</code></br>
  3934. <em>
  3935. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3936. ExternalSecretSpec
  3937. </a>
  3938. </em>
  3939. </td>
  3940. <td>
  3941. <p>The spec for the ExternalSecrets to be created</p>
  3942. </td>
  3943. </tr>
  3944. <tr>
  3945. <td>
  3946. <code>externalSecretName</code></br>
  3947. <em>
  3948. string
  3949. </em>
  3950. </td>
  3951. <td>
  3952. <em>(Optional)</em>
  3953. <p>The name of the external secrets to be created.
  3954. Defaults to the name of the ClusterExternalSecret</p>
  3955. </td>
  3956. </tr>
  3957. <tr>
  3958. <td>
  3959. <code>externalSecretMetadata</code></br>
  3960. <em>
  3961. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3962. ExternalSecretMetadata
  3963. </a>
  3964. </em>
  3965. </td>
  3966. <td>
  3967. <em>(Optional)</em>
  3968. <p>The metadata of the external secrets to be created</p>
  3969. </td>
  3970. </tr>
  3971. <tr>
  3972. <td>
  3973. <code>namespaceSelector</code></br>
  3974. <em>
  3975. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3976. Kubernetes meta/v1.LabelSelector
  3977. </a>
  3978. </em>
  3979. </td>
  3980. <td>
  3981. <em>(Optional)</em>
  3982. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3983. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3984. </td>
  3985. </tr>
  3986. <tr>
  3987. <td>
  3988. <code>namespaceSelectors</code></br>
  3989. <em>
  3990. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3991. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3992. </a>
  3993. </em>
  3994. </td>
  3995. <td>
  3996. <em>(Optional)</em>
  3997. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  3998. </td>
  3999. </tr>
  4000. <tr>
  4001. <td>
  4002. <code>namespaces</code></br>
  4003. <em>
  4004. []string
  4005. </em>
  4006. </td>
  4007. <td>
  4008. <em>(Optional)</em>
  4009. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  4010. <p>Deprecated: Use NamespaceSelectors instead.</p>
  4011. </td>
  4012. </tr>
  4013. <tr>
  4014. <td>
  4015. <code>refreshTime</code></br>
  4016. <em>
  4017. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  4018. Kubernetes meta/v1.Duration
  4019. </a>
  4020. </em>
  4021. </td>
  4022. <td>
  4023. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  4024. </td>
  4025. </tr>
  4026. </tbody>
  4027. </table>
  4028. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  4029. </h3>
  4030. <p>
  4031. (<em>Appears on:</em>
  4032. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  4033. </p>
  4034. <p>
  4035. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  4036. </p>
  4037. <table>
  4038. <thead>
  4039. <tr>
  4040. <th>Field</th>
  4041. <th>Description</th>
  4042. </tr>
  4043. </thead>
  4044. <tbody>
  4045. <tr>
  4046. <td>
  4047. <code>externalSecretName</code></br>
  4048. <em>
  4049. string
  4050. </em>
  4051. </td>
  4052. <td>
  4053. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  4054. </td>
  4055. </tr>
  4056. <tr>
  4057. <td>
  4058. <code>failedNamespaces</code></br>
  4059. <em>
  4060. <a href="#external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">
  4061. []ClusterExternalSecretNamespaceFailure
  4062. </a>
  4063. </em>
  4064. </td>
  4065. <td>
  4066. <em>(Optional)</em>
  4067. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  4068. </td>
  4069. </tr>
  4070. <tr>
  4071. <td>
  4072. <code>provisionedNamespaces</code></br>
  4073. <em>
  4074. []string
  4075. </em>
  4076. </td>
  4077. <td>
  4078. <em>(Optional)</em>
  4079. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  4080. </td>
  4081. </tr>
  4082. <tr>
  4083. <td>
  4084. <code>conditions</code></br>
  4085. <em>
  4086. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">
  4087. []ClusterExternalSecretStatusCondition
  4088. </a>
  4089. </em>
  4090. </td>
  4091. <td>
  4092. <em>(Optional)</em>
  4093. </td>
  4094. </tr>
  4095. </tbody>
  4096. </table>
  4097. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  4098. </h3>
  4099. <p>
  4100. (<em>Appears on:</em>
  4101. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  4102. </p>
  4103. <p>
  4104. <p>ClusterExternalSecretStatusCondition defines the observed state of a ClusterExternalSecret resource.</p>
  4105. </p>
  4106. <table>
  4107. <thead>
  4108. <tr>
  4109. <th>Field</th>
  4110. <th>Description</th>
  4111. </tr>
  4112. </thead>
  4113. <tbody>
  4114. <tr>
  4115. <td>
  4116. <code>type</code></br>
  4117. <em>
  4118. <a href="#external-secrets.io/v1.ClusterExternalSecretConditionType">
  4119. ClusterExternalSecretConditionType
  4120. </a>
  4121. </em>
  4122. </td>
  4123. <td>
  4124. </td>
  4125. </tr>
  4126. <tr>
  4127. <td>
  4128. <code>status</code></br>
  4129. <em>
  4130. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  4131. Kubernetes core/v1.ConditionStatus
  4132. </a>
  4133. </em>
  4134. </td>
  4135. <td>
  4136. </td>
  4137. </tr>
  4138. <tr>
  4139. <td>
  4140. <code>message</code></br>
  4141. <em>
  4142. string
  4143. </em>
  4144. </td>
  4145. <td>
  4146. <em>(Optional)</em>
  4147. </td>
  4148. </tr>
  4149. </tbody>
  4150. </table>
  4151. <h3 id="external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore
  4152. </h3>
  4153. <p>
  4154. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  4155. </p>
  4156. <table>
  4157. <thead>
  4158. <tr>
  4159. <th>Field</th>
  4160. <th>Description</th>
  4161. </tr>
  4162. </thead>
  4163. <tbody>
  4164. <tr>
  4165. <td>
  4166. <code>metadata</code></br>
  4167. <em>
  4168. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  4169. Kubernetes meta/v1.ObjectMeta
  4170. </a>
  4171. </em>
  4172. </td>
  4173. <td>
  4174. Refer to the Kubernetes API documentation for the fields of the
  4175. <code>metadata</code> field.
  4176. </td>
  4177. </tr>
  4178. <tr>
  4179. <td>
  4180. <code>spec</code></br>
  4181. <em>
  4182. <a href="#external-secrets.io/v1.SecretStoreSpec">
  4183. SecretStoreSpec
  4184. </a>
  4185. </em>
  4186. </td>
  4187. <td>
  4188. <br/>
  4189. <br/>
  4190. <table>
  4191. <tr>
  4192. <td>
  4193. <code>controller</code></br>
  4194. <em>
  4195. string
  4196. </em>
  4197. </td>
  4198. <td>
  4199. <em>(Optional)</em>
  4200. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  4201. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  4202. </td>
  4203. </tr>
  4204. <tr>
  4205. <td>
  4206. <code>provider</code></br>
  4207. <em>
  4208. <a href="#external-secrets.io/v1.SecretStoreProvider">
  4209. SecretStoreProvider
  4210. </a>
  4211. </em>
  4212. </td>
  4213. <td>
  4214. <p>Used to configure the provider. Only one provider may be set</p>
  4215. </td>
  4216. </tr>
  4217. <tr>
  4218. <td>
  4219. <code>retrySettings</code></br>
  4220. <em>
  4221. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  4222. SecretStoreRetrySettings
  4223. </a>
  4224. </em>
  4225. </td>
  4226. <td>
  4227. <em>(Optional)</em>
  4228. <p>Used to configure HTTP retries on failures.</p>
  4229. </td>
  4230. </tr>
  4231. <tr>
  4232. <td>
  4233. <code>refreshInterval</code></br>
  4234. <em>
  4235. int
  4236. </em>
  4237. </td>
  4238. <td>
  4239. <em>(Optional)</em>
  4240. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  4241. </td>
  4242. </tr>
  4243. <tr>
  4244. <td>
  4245. <code>conditions</code></br>
  4246. <em>
  4247. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  4248. []ClusterSecretStoreCondition
  4249. </a>
  4250. </em>
  4251. </td>
  4252. <td>
  4253. <em>(Optional)</em>
  4254. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  4255. </td>
  4256. </tr>
  4257. </table>
  4258. </td>
  4259. </tr>
  4260. <tr>
  4261. <td>
  4262. <code>status</code></br>
  4263. <em>
  4264. <a href="#external-secrets.io/v1.SecretStoreStatus">
  4265. SecretStoreStatus
  4266. </a>
  4267. </em>
  4268. </td>
  4269. <td>
  4270. </td>
  4271. </tr>
  4272. </tbody>
  4273. </table>
  4274. <h3 id="external-secrets.io/v1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  4275. </h3>
  4276. <p>
  4277. (<em>Appears on:</em>
  4278. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  4279. </p>
  4280. <p>
  4281. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  4282. for a ClusterSecretStore instance.</p>
  4283. </p>
  4284. <table>
  4285. <thead>
  4286. <tr>
  4287. <th>Field</th>
  4288. <th>Description</th>
  4289. </tr>
  4290. </thead>
  4291. <tbody>
  4292. <tr>
  4293. <td>
  4294. <code>namespaceSelector</code></br>
  4295. <em>
  4296. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4297. Kubernetes meta/v1.LabelSelector
  4298. </a>
  4299. </em>
  4300. </td>
  4301. <td>
  4302. <em>(Optional)</em>
  4303. <p>Choose namespace using a labelSelector</p>
  4304. </td>
  4305. </tr>
  4306. <tr>
  4307. <td>
  4308. <code>namespaces</code></br>
  4309. <em>
  4310. []string
  4311. </em>
  4312. </td>
  4313. <td>
  4314. <em>(Optional)</em>
  4315. <p>Choose namespaces by name</p>
  4316. </td>
  4317. </tr>
  4318. <tr>
  4319. <td>
  4320. <code>namespaceRegexes</code></br>
  4321. <em>
  4322. []string
  4323. </em>
  4324. </td>
  4325. <td>
  4326. <em>(Optional)</em>
  4327. <p>Choose namespaces by using regex matching</p>
  4328. </td>
  4329. </tr>
  4330. </tbody>
  4331. </table>
  4332. <h3 id="external-secrets.io/v1.ConfigMapReference">ConfigMapReference
  4333. </h3>
  4334. <p>
  4335. (<em>Appears on:</em>
  4336. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  4337. </p>
  4338. <p>
  4339. <p>ConfigMapReference holds the details of a configmap.</p>
  4340. </p>
  4341. <table>
  4342. <thead>
  4343. <tr>
  4344. <th>Field</th>
  4345. <th>Description</th>
  4346. </tr>
  4347. </thead>
  4348. <tbody>
  4349. <tr>
  4350. <td>
  4351. <code>name</code></br>
  4352. <em>
  4353. string
  4354. </em>
  4355. </td>
  4356. <td>
  4357. <p>name of the configmap.</p>
  4358. </td>
  4359. </tr>
  4360. <tr>
  4361. <td>
  4362. <code>namespace</code></br>
  4363. <em>
  4364. string
  4365. </em>
  4366. </td>
  4367. <td>
  4368. <p>namespace in which the configmap exists. If empty, configmap will looked up in local namespace.</p>
  4369. </td>
  4370. </tr>
  4371. <tr>
  4372. <td>
  4373. <code>key</code></br>
  4374. <em>
  4375. string
  4376. </em>
  4377. </td>
  4378. <td>
  4379. <p>key name holding the external account credential config.</p>
  4380. </td>
  4381. </tr>
  4382. </tbody>
  4383. </table>
  4384. <h3 id="external-secrets.io/v1.ConjurAPIKey">ConjurAPIKey
  4385. </h3>
  4386. <p>
  4387. (<em>Appears on:</em>
  4388. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4389. </p>
  4390. <p>
  4391. <p>ConjurAPIKey contains references to a Secret resource that holds
  4392. the Conjur username and API key.</p>
  4393. </p>
  4394. <table>
  4395. <thead>
  4396. <tr>
  4397. <th>Field</th>
  4398. <th>Description</th>
  4399. </tr>
  4400. </thead>
  4401. <tbody>
  4402. <tr>
  4403. <td>
  4404. <code>account</code></br>
  4405. <em>
  4406. string
  4407. </em>
  4408. </td>
  4409. <td>
  4410. <p>Account is the Conjur organization account name.</p>
  4411. </td>
  4412. </tr>
  4413. <tr>
  4414. <td>
  4415. <code>userRef</code></br>
  4416. <em>
  4417. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4418. External Secrets meta/v1.SecretKeySelector
  4419. </a>
  4420. </em>
  4421. </td>
  4422. <td>
  4423. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  4424. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4425. </td>
  4426. </tr>
  4427. <tr>
  4428. <td>
  4429. <code>apiKeyRef</code></br>
  4430. <em>
  4431. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4432. External Secrets meta/v1.SecretKeySelector
  4433. </a>
  4434. </em>
  4435. </td>
  4436. <td>
  4437. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  4438. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4439. </td>
  4440. </tr>
  4441. </tbody>
  4442. </table>
  4443. <h3 id="external-secrets.io/v1.ConjurAuth">ConjurAuth
  4444. </h3>
  4445. <p>
  4446. (<em>Appears on:</em>
  4447. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>)
  4448. </p>
  4449. <p>
  4450. <p>ConjurAuth is the way to provide authentication credentials to the ConjurProvider.</p>
  4451. </p>
  4452. <table>
  4453. <thead>
  4454. <tr>
  4455. <th>Field</th>
  4456. <th>Description</th>
  4457. </tr>
  4458. </thead>
  4459. <tbody>
  4460. <tr>
  4461. <td>
  4462. <code>apikey</code></br>
  4463. <em>
  4464. <a href="#external-secrets.io/v1.ConjurAPIKey">
  4465. ConjurAPIKey
  4466. </a>
  4467. </em>
  4468. </td>
  4469. <td>
  4470. <em>(Optional)</em>
  4471. <p>Authenticates with Conjur using an API key.</p>
  4472. </td>
  4473. </tr>
  4474. <tr>
  4475. <td>
  4476. <code>jwt</code></br>
  4477. <em>
  4478. <a href="#external-secrets.io/v1.ConjurJWT">
  4479. ConjurJWT
  4480. </a>
  4481. </em>
  4482. </td>
  4483. <td>
  4484. <em>(Optional)</em>
  4485. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  4486. </td>
  4487. </tr>
  4488. </tbody>
  4489. </table>
  4490. <h3 id="external-secrets.io/v1.ConjurJWT">ConjurJWT
  4491. </h3>
  4492. <p>
  4493. (<em>Appears on:</em>
  4494. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4495. </p>
  4496. <p>
  4497. <p>ConjurJWT defines the JWT authentication configuration for Conjur provider.</p>
  4498. </p>
  4499. <table>
  4500. <thead>
  4501. <tr>
  4502. <th>Field</th>
  4503. <th>Description</th>
  4504. </tr>
  4505. </thead>
  4506. <tbody>
  4507. <tr>
  4508. <td>
  4509. <code>account</code></br>
  4510. <em>
  4511. string
  4512. </em>
  4513. </td>
  4514. <td>
  4515. <p>Account is the Conjur organization account name.</p>
  4516. </td>
  4517. </tr>
  4518. <tr>
  4519. <td>
  4520. <code>serviceID</code></br>
  4521. <em>
  4522. string
  4523. </em>
  4524. </td>
  4525. <td>
  4526. <p>The conjur authn jwt webservice id</p>
  4527. </td>
  4528. </tr>
  4529. <tr>
  4530. <td>
  4531. <code>hostId</code></br>
  4532. <em>
  4533. string
  4534. </em>
  4535. </td>
  4536. <td>
  4537. <em>(Optional)</em>
  4538. <p>Optional HostID for JWT authentication. This may be used depending
  4539. on how the Conjur JWT authenticator policy is configured.</p>
  4540. </td>
  4541. </tr>
  4542. <tr>
  4543. <td>
  4544. <code>secretRef</code></br>
  4545. <em>
  4546. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4547. External Secrets meta/v1.SecretKeySelector
  4548. </a>
  4549. </em>
  4550. </td>
  4551. <td>
  4552. <em>(Optional)</em>
  4553. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  4554. authenticate with Conjur using the JWT authentication method.</p>
  4555. </td>
  4556. </tr>
  4557. <tr>
  4558. <td>
  4559. <code>serviceAccountRef</code></br>
  4560. <em>
  4561. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  4562. External Secrets meta/v1.ServiceAccountSelector
  4563. </a>
  4564. </em>
  4565. </td>
  4566. <td>
  4567. <em>(Optional)</em>
  4568. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  4569. a token for with the <code>TokenRequest</code> API.</p>
  4570. </td>
  4571. </tr>
  4572. </tbody>
  4573. </table>
  4574. <h3 id="external-secrets.io/v1.ConjurProvider">ConjurProvider
  4575. </h3>
  4576. <p>
  4577. (<em>Appears on:</em>
  4578. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4579. </p>
  4580. <p>
  4581. <p>ConjurProvider provides access to a Conjur provider.</p>
  4582. </p>
  4583. <table>
  4584. <thead>
  4585. <tr>
  4586. <th>Field</th>
  4587. <th>Description</th>
  4588. </tr>
  4589. </thead>
  4590. <tbody>
  4591. <tr>
  4592. <td>
  4593. <code>url</code></br>
  4594. <em>
  4595. string
  4596. </em>
  4597. </td>
  4598. <td>
  4599. <p>URL is the endpoint of the Conjur instance.</p>
  4600. </td>
  4601. </tr>
  4602. <tr>
  4603. <td>
  4604. <code>caBundle</code></br>
  4605. <em>
  4606. string
  4607. </em>
  4608. </td>
  4609. <td>
  4610. <em>(Optional)</em>
  4611. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  4612. </td>
  4613. </tr>
  4614. <tr>
  4615. <td>
  4616. <code>caProvider</code></br>
  4617. <em>
  4618. <a href="#external-secrets.io/v1.CAProvider">
  4619. CAProvider
  4620. </a>
  4621. </em>
  4622. </td>
  4623. <td>
  4624. <em>(Optional)</em>
  4625. <p>Used to provide custom certificate authority (CA) certificates
  4626. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  4627. that contains a PEM-encoded certificate.</p>
  4628. </td>
  4629. </tr>
  4630. <tr>
  4631. <td>
  4632. <code>auth</code></br>
  4633. <em>
  4634. <a href="#external-secrets.io/v1.ConjurAuth">
  4635. ConjurAuth
  4636. </a>
  4637. </em>
  4638. </td>
  4639. <td>
  4640. <p>Defines authentication settings for connecting to Conjur.</p>
  4641. </td>
  4642. </tr>
  4643. </tbody>
  4644. </table>
  4645. <h3 id="external-secrets.io/v1.DVLSAuth">DVLSAuth
  4646. </h3>
  4647. <p>
  4648. (<em>Appears on:</em>
  4649. <a href="#external-secrets.io/v1.DVLSProvider">DVLSProvider</a>)
  4650. </p>
  4651. <p>
  4652. <p>DVLSAuth defines the authentication method for the DVLS provider.</p>
  4653. </p>
  4654. <table>
  4655. <thead>
  4656. <tr>
  4657. <th>Field</th>
  4658. <th>Description</th>
  4659. </tr>
  4660. </thead>
  4661. <tbody>
  4662. <tr>
  4663. <td>
  4664. <code>secretRef</code></br>
  4665. <em>
  4666. <a href="#external-secrets.io/v1.DVLSAuthSecretRef">
  4667. DVLSAuthSecretRef
  4668. </a>
  4669. </em>
  4670. </td>
  4671. <td>
  4672. <p>SecretRef contains the Application ID and Application Secret for authentication.</p>
  4673. </td>
  4674. </tr>
  4675. </tbody>
  4676. </table>
  4677. <h3 id="external-secrets.io/v1.DVLSAuthSecretRef">DVLSAuthSecretRef
  4678. </h3>
  4679. <p>
  4680. (<em>Appears on:</em>
  4681. <a href="#external-secrets.io/v1.DVLSAuth">DVLSAuth</a>)
  4682. </p>
  4683. <p>
  4684. <p>DVLSAuthSecretRef defines the secret references for DVLS authentication credentials.</p>
  4685. </p>
  4686. <table>
  4687. <thead>
  4688. <tr>
  4689. <th>Field</th>
  4690. <th>Description</th>
  4691. </tr>
  4692. </thead>
  4693. <tbody>
  4694. <tr>
  4695. <td>
  4696. <code>appId</code></br>
  4697. <em>
  4698. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4699. External Secrets meta/v1.SecretKeySelector
  4700. </a>
  4701. </em>
  4702. </td>
  4703. <td>
  4704. <p>AppID is the reference to the secret containing the Application ID.</p>
  4705. </td>
  4706. </tr>
  4707. <tr>
  4708. <td>
  4709. <code>appSecret</code></br>
  4710. <em>
  4711. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4712. External Secrets meta/v1.SecretKeySelector
  4713. </a>
  4714. </em>
  4715. </td>
  4716. <td>
  4717. <p>AppSecret is the reference to the secret containing the Application Secret.</p>
  4718. </td>
  4719. </tr>
  4720. </tbody>
  4721. </table>
  4722. <h3 id="external-secrets.io/v1.DVLSProvider">DVLSProvider
  4723. </h3>
  4724. <p>
  4725. (<em>Appears on:</em>
  4726. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4727. </p>
  4728. <p>
  4729. <p>DVLSProvider configures a store to sync secrets using Devolutions Server.</p>
  4730. </p>
  4731. <table>
  4732. <thead>
  4733. <tr>
  4734. <th>Field</th>
  4735. <th>Description</th>
  4736. </tr>
  4737. </thead>
  4738. <tbody>
  4739. <tr>
  4740. <td>
  4741. <code>serverUrl</code></br>
  4742. <em>
  4743. string
  4744. </em>
  4745. </td>
  4746. <td>
  4747. <p>ServerURL is the DVLS instance URL (e.g., <a href="https://dvls.example.com">https://dvls.example.com</a>).</p>
  4748. </td>
  4749. </tr>
  4750. <tr>
  4751. <td>
  4752. <code>vault</code></br>
  4753. <em>
  4754. string
  4755. </em>
  4756. </td>
  4757. <td>
  4758. <em>(Optional)</em>
  4759. <p>Vault is the name or UUID of the vault to fetch secrets from.
  4760. When omitted, the vault must be specified in the secret key using the legacy format &ldquo;<vault-id>/<entry-id>&rdquo;.</p>
  4761. </td>
  4762. </tr>
  4763. <tr>
  4764. <td>
  4765. <code>insecure</code></br>
  4766. <em>
  4767. bool
  4768. </em>
  4769. </td>
  4770. <td>
  4771. <em>(Optional)</em>
  4772. <p>Insecure allows connecting to DVLS over plain HTTP.
  4773. This is NOT RECOMMENDED for production use.
  4774. Set to true only if you understand the security implications.</p>
  4775. </td>
  4776. </tr>
  4777. <tr>
  4778. <td>
  4779. <code>auth</code></br>
  4780. <em>
  4781. <a href="#external-secrets.io/v1.DVLSAuth">
  4782. DVLSAuth
  4783. </a>
  4784. </em>
  4785. </td>
  4786. <td>
  4787. <p>Auth defines the authentication method to use.</p>
  4788. </td>
  4789. </tr>
  4790. </tbody>
  4791. </table>
  4792. <h3 id="external-secrets.io/v1.DelineaProvider">DelineaProvider
  4793. </h3>
  4794. <p>
  4795. (<em>Appears on:</em>
  4796. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4797. </p>
  4798. <p>
  4799. <p>DelineaProvider provides access to Delinea secrets vault Server.
  4800. 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>
  4801. </p>
  4802. <table>
  4803. <thead>
  4804. <tr>
  4805. <th>Field</th>
  4806. <th>Description</th>
  4807. </tr>
  4808. </thead>
  4809. <tbody>
  4810. <tr>
  4811. <td>
  4812. <code>clientId</code></br>
  4813. <em>
  4814. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4815. DelineaProviderSecretRef
  4816. </a>
  4817. </em>
  4818. </td>
  4819. <td>
  4820. <p>ClientID is the non-secret part of the credential.</p>
  4821. </td>
  4822. </tr>
  4823. <tr>
  4824. <td>
  4825. <code>clientSecret</code></br>
  4826. <em>
  4827. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4828. DelineaProviderSecretRef
  4829. </a>
  4830. </em>
  4831. </td>
  4832. <td>
  4833. <p>ClientSecret is the secret part of the credential.</p>
  4834. </td>
  4835. </tr>
  4836. <tr>
  4837. <td>
  4838. <code>tenant</code></br>
  4839. <em>
  4840. string
  4841. </em>
  4842. </td>
  4843. <td>
  4844. <p>Tenant is the chosen hostname / site name.</p>
  4845. </td>
  4846. </tr>
  4847. <tr>
  4848. <td>
  4849. <code>urlTemplate</code></br>
  4850. <em>
  4851. string
  4852. </em>
  4853. </td>
  4854. <td>
  4855. <em>(Optional)</em>
  4856. <p>URLTemplate
  4857. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  4858. </td>
  4859. </tr>
  4860. <tr>
  4861. <td>
  4862. <code>tld</code></br>
  4863. <em>
  4864. string
  4865. </em>
  4866. </td>
  4867. <td>
  4868. <em>(Optional)</em>
  4869. <p>TLD is based on the server location that was chosen during provisioning.
  4870. If unset, defaults to &ldquo;com&rdquo;.</p>
  4871. </td>
  4872. </tr>
  4873. </tbody>
  4874. </table>
  4875. <h3 id="external-secrets.io/v1.DelineaProviderSecretRef">DelineaProviderSecretRef
  4876. </h3>
  4877. <p>
  4878. (<em>Appears on:</em>
  4879. <a href="#external-secrets.io/v1.DelineaProvider">DelineaProvider</a>)
  4880. </p>
  4881. <p>
  4882. <p>DelineaProviderSecretRef is a secret reference containing either a direct value or a reference to a secret key.</p>
  4883. </p>
  4884. <table>
  4885. <thead>
  4886. <tr>
  4887. <th>Field</th>
  4888. <th>Description</th>
  4889. </tr>
  4890. </thead>
  4891. <tbody>
  4892. <tr>
  4893. <td>
  4894. <code>value</code></br>
  4895. <em>
  4896. string
  4897. </em>
  4898. </td>
  4899. <td>
  4900. <em>(Optional)</em>
  4901. <p>Value can be specified directly to set a value without using a secret.</p>
  4902. </td>
  4903. </tr>
  4904. <tr>
  4905. <td>
  4906. <code>secretRef</code></br>
  4907. <em>
  4908. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4909. External Secrets meta/v1.SecretKeySelector
  4910. </a>
  4911. </em>
  4912. </td>
  4913. <td>
  4914. <em>(Optional)</em>
  4915. <p>SecretRef references a key in a secret that will be used as value.</p>
  4916. </td>
  4917. </tr>
  4918. </tbody>
  4919. </table>
  4920. <h3 id="external-secrets.io/v1.DopplerAuth">DopplerAuth
  4921. </h3>
  4922. <p>
  4923. (<em>Appears on:</em>
  4924. <a href="#external-secrets.io/v1.DopplerProvider">DopplerProvider</a>)
  4925. </p>
  4926. <p>
  4927. <p>DopplerAuth configures authentication with the Doppler API.
  4928. Exactly one of secretRef or oidcConfig must be specified.</p>
  4929. </p>
  4930. <table>
  4931. <thead>
  4932. <tr>
  4933. <th>Field</th>
  4934. <th>Description</th>
  4935. </tr>
  4936. </thead>
  4937. <tbody>
  4938. <tr>
  4939. <td>
  4940. <code>secretRef</code></br>
  4941. <em>
  4942. <a href="#external-secrets.io/v1.DopplerAuthSecretRef">
  4943. DopplerAuthSecretRef
  4944. </a>
  4945. </em>
  4946. </td>
  4947. <td>
  4948. <em>(Optional)</em>
  4949. <p>SecretRef authenticates using a Doppler service token stored in a Kubernetes Secret.</p>
  4950. </td>
  4951. </tr>
  4952. <tr>
  4953. <td>
  4954. <code>oidcConfig</code></br>
  4955. <em>
  4956. <a href="#external-secrets.io/v1.DopplerOIDCAuth">
  4957. DopplerOIDCAuth
  4958. </a>
  4959. </em>
  4960. </td>
  4961. <td>
  4962. <em>(Optional)</em>
  4963. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  4964. </td>
  4965. </tr>
  4966. </tbody>
  4967. </table>
  4968. <h3 id="external-secrets.io/v1.DopplerAuthSecretRef">DopplerAuthSecretRef
  4969. </h3>
  4970. <p>
  4971. (<em>Appears on:</em>
  4972. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  4973. </p>
  4974. <p>
  4975. <p>DopplerAuthSecretRef contains the secret reference for accessing the Doppler API.</p>
  4976. </p>
  4977. <table>
  4978. <thead>
  4979. <tr>
  4980. <th>Field</th>
  4981. <th>Description</th>
  4982. </tr>
  4983. </thead>
  4984. <tbody>
  4985. <tr>
  4986. <td>
  4987. <code>dopplerToken</code></br>
  4988. <em>
  4989. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4990. External Secrets meta/v1.SecretKeySelector
  4991. </a>
  4992. </em>
  4993. </td>
  4994. <td>
  4995. <p>The DopplerToken is used for authentication.
  4996. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  4997. The Key attribute defaults to dopplerToken if not specified.</p>
  4998. </td>
  4999. </tr>
  5000. </tbody>
  5001. </table>
  5002. <h3 id="external-secrets.io/v1.DopplerOIDCAuth">DopplerOIDCAuth
  5003. </h3>
  5004. <p>
  5005. (<em>Appears on:</em>
  5006. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  5007. </p>
  5008. <p>
  5009. <p>DopplerOIDCAuth configures OIDC authentication with Doppler using Kubernetes ServiceAccount tokens.</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>identity</code></br>
  5022. <em>
  5023. string
  5024. </em>
  5025. </td>
  5026. <td>
  5027. <p>Identity is the Doppler Service Account Identity ID configured for OIDC authentication.</p>
  5028. </td>
  5029. </tr>
  5030. <tr>
  5031. <td>
  5032. <code>serviceAccountRef</code></br>
  5033. <em>
  5034. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  5035. External Secrets meta/v1.ServiceAccountSelector
  5036. </a>
  5037. </em>
  5038. </td>
  5039. <td>
  5040. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  5041. </td>
  5042. </tr>
  5043. <tr>
  5044. <td>
  5045. <code>expirationSeconds</code></br>
  5046. <em>
  5047. int64
  5048. </em>
  5049. </td>
  5050. <td>
  5051. <em>(Optional)</em>
  5052. <p>ExpirationSeconds sets the ServiceAccount token validity duration.
  5053. Defaults to 10 minutes.</p>
  5054. </td>
  5055. </tr>
  5056. </tbody>
  5057. </table>
  5058. <h3 id="external-secrets.io/v1.DopplerProvider">DopplerProvider
  5059. </h3>
  5060. <p>
  5061. (<em>Appears on:</em>
  5062. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  5063. </p>
  5064. <p>
  5065. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  5066. Project and Config are required if not using a Service Token.</p>
  5067. </p>
  5068. <table>
  5069. <thead>
  5070. <tr>
  5071. <th>Field</th>
  5072. <th>Description</th>
  5073. </tr>
  5074. </thead>
  5075. <tbody>
  5076. <tr>
  5077. <td>
  5078. <code>auth</code></br>
  5079. <em>
  5080. <a href="#external-secrets.io/v1.DopplerAuth">
  5081. DopplerAuth
  5082. </a>
  5083. </em>
  5084. </td>
  5085. <td>
  5086. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  5087. </td>
  5088. </tr>
  5089. <tr>
  5090. <td>
  5091. <code>project</code></br>
  5092. <em>
  5093. string
  5094. </em>
  5095. </td>
  5096. <td>
  5097. <em>(Optional)</em>
  5098. <p>Doppler project (required if not using a Service Token)</p>
  5099. </td>
  5100. </tr>
  5101. <tr>
  5102. <td>
  5103. <code>config</code></br>
  5104. <em>
  5105. string
  5106. </em>
  5107. </td>
  5108. <td>
  5109. <em>(Optional)</em>
  5110. <p>Doppler config (required if not using a Service Token)</p>
  5111. </td>
  5112. </tr>
  5113. <tr>
  5114. <td>
  5115. <code>nameTransformer</code></br>
  5116. <em>
  5117. string
  5118. </em>
  5119. </td>
  5120. <td>
  5121. <em>(Optional)</em>
  5122. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  5123. </td>
  5124. </tr>
  5125. <tr>
  5126. <td>
  5127. <code>format</code></br>
  5128. <em>
  5129. string
  5130. </em>
  5131. </td>
  5132. <td>
  5133. <em>(Optional)</em>
  5134. <p>Format enables the downloading of secrets as a file (string)</p>
  5135. </td>
  5136. </tr>
  5137. </tbody>
  5138. </table>
  5139. <h3 id="external-secrets.io/v1.ExternalSecret">ExternalSecret
  5140. </h3>
  5141. <p>
  5142. <p>ExternalSecret is the Schema for the external-secrets API.
  5143. It defines how to fetch data from external APIs and make it available as Kubernetes Secrets.</p>
  5144. </p>
  5145. <table>
  5146. <thead>
  5147. <tr>
  5148. <th>Field</th>
  5149. <th>Description</th>
  5150. </tr>
  5151. </thead>
  5152. <tbody>
  5153. <tr>
  5154. <td>
  5155. <code>metadata</code></br>
  5156. <em>
  5157. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  5158. Kubernetes meta/v1.ObjectMeta
  5159. </a>
  5160. </em>
  5161. </td>
  5162. <td>
  5163. Refer to the Kubernetes API documentation for the fields of the
  5164. <code>metadata</code> field.
  5165. </td>
  5166. </tr>
  5167. <tr>
  5168. <td>
  5169. <code>spec</code></br>
  5170. <em>
  5171. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  5172. ExternalSecretSpec
  5173. </a>
  5174. </em>
  5175. </td>
  5176. <td>
  5177. <br/>
  5178. <br/>
  5179. <table>
  5180. <tr>
  5181. <td>
  5182. <code>secretStoreRef</code></br>
  5183. <em>
  5184. <a href="#external-secrets.io/v1.SecretStoreRef">
  5185. SecretStoreRef
  5186. </a>
  5187. </em>
  5188. </td>
  5189. <td>
  5190. <em>(Optional)</em>
  5191. </td>
  5192. </tr>
  5193. <tr>
  5194. <td>
  5195. <code>target</code></br>
  5196. <em>
  5197. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  5198. ExternalSecretTarget
  5199. </a>
  5200. </em>
  5201. </td>
  5202. <td>
  5203. <em>(Optional)</em>
  5204. </td>
  5205. </tr>
  5206. <tr>
  5207. <td>
  5208. <code>refreshPolicy</code></br>
  5209. <em>
  5210. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  5211. ExternalSecretRefreshPolicy
  5212. </a>
  5213. </em>
  5214. </td>
  5215. <td>
  5216. <em>(Optional)</em>
  5217. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  5218. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  5219. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  5220. No periodic updates occur if refreshInterval is 0.
  5221. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  5222. </td>
  5223. </tr>
  5224. <tr>
  5225. <td>
  5226. <code>refreshInterval</code></br>
  5227. <em>
  5228. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  5229. Kubernetes meta/v1.Duration
  5230. </a>
  5231. </em>
  5232. </td>
  5233. <td>
  5234. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  5235. specified as Golang Duration strings.
  5236. 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;
  5237. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  5238. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  5239. </td>
  5240. </tr>
  5241. <tr>
  5242. <td>
  5243. <code>syncWindows</code></br>
  5244. <em>
  5245. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">
  5246. ExternalSecretSyncWindows
  5247. </a>
  5248. </em>
  5249. </td>
  5250. <td>
  5251. <em>(Optional)</em>
  5252. <p>SyncWindows optionally restricts when periodic refreshes may occur.
  5253. Evaluated in UTC, only for Periodic refresh policy (or when refreshPolicy is unset).</p>
  5254. </td>
  5255. </tr>
  5256. <tr>
  5257. <td>
  5258. <code>data</code></br>
  5259. <em>
  5260. <a href="#external-secrets.io/v1.ExternalSecretData">
  5261. []ExternalSecretData
  5262. </a>
  5263. </em>
  5264. </td>
  5265. <td>
  5266. <em>(Optional)</em>
  5267. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  5268. </td>
  5269. </tr>
  5270. <tr>
  5271. <td>
  5272. <code>dataFrom</code></br>
  5273. <em>
  5274. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  5275. []ExternalSecretDataFromRemoteRef
  5276. </a>
  5277. </em>
  5278. </td>
  5279. <td>
  5280. <em>(Optional)</em>
  5281. <p>DataFrom is used to fetch all properties from a specific Provider data
  5282. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  5283. </td>
  5284. </tr>
  5285. </table>
  5286. </td>
  5287. </tr>
  5288. <tr>
  5289. <td>
  5290. <code>status</code></br>
  5291. <em>
  5292. <a href="#external-secrets.io/v1.ExternalSecretStatus">
  5293. ExternalSecretStatus
  5294. </a>
  5295. </em>
  5296. </td>
  5297. <td>
  5298. </td>
  5299. </tr>
  5300. </tbody>
  5301. </table>
  5302. <h3 id="external-secrets.io/v1.ExternalSecretConditionType">ExternalSecretConditionType
  5303. (<code>string</code> alias)</p></h3>
  5304. <p>
  5305. (<em>Appears on:</em>
  5306. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  5307. </p>
  5308. <p>
  5309. <p>ExternalSecretConditionType defines a value type for ExternalSecret conditions.</p>
  5310. </p>
  5311. <table>
  5312. <thead>
  5313. <tr>
  5314. <th>Value</th>
  5315. <th>Description</th>
  5316. </tr>
  5317. </thead>
  5318. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  5319. <td><p>ExternalSecretDeleted indicates that the external secret has been deleted.</p>
  5320. </td>
  5321. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  5322. <td><p>ExternalSecretReady indicates that the external secret is ready and synced.</p>
  5323. </td>
  5324. </tr></tbody>
  5325. </table>
  5326. <h3 id="external-secrets.io/v1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  5327. (<code>string</code> alias)</p></h3>
  5328. <p>
  5329. (<em>Appears on:</em>
  5330. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5331. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5332. </p>
  5333. <p>
  5334. <p>ExternalSecretConversionStrategy defines strategies for converting secret values.</p>
  5335. </p>
  5336. <table>
  5337. <thead>
  5338. <tr>
  5339. <th>Value</th>
  5340. <th>Description</th>
  5341. </tr>
  5342. </thead>
  5343. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  5344. <td><p>ExternalSecretConversionDefault specifies the default conversion strategy.</p>
  5345. </td>
  5346. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  5347. <td><p>ExternalSecretConversionUnicode specifies that values should be treated as Unicode.</p>
  5348. </td>
  5349. </tr></tbody>
  5350. </table>
  5351. <h3 id="external-secrets.io/v1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  5352. (<code>string</code> alias)</p></h3>
  5353. <p>
  5354. (<em>Appears on:</em>
  5355. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5356. </p>
  5357. <p>
  5358. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  5359. </p>
  5360. <table>
  5361. <thead>
  5362. <tr>
  5363. <th>Value</th>
  5364. <th>Description</th>
  5365. </tr>
  5366. </thead>
  5367. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  5368. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  5369. </td>
  5370. </tr><tr><td><p>&#34;None&#34;</p></td>
  5371. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  5372. </td>
  5373. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  5374. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  5375. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  5376. </td>
  5377. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  5378. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  5379. </td>
  5380. </tr></tbody>
  5381. </table>
  5382. <h3 id="external-secrets.io/v1.ExternalSecretData">ExternalSecretData
  5383. </h3>
  5384. <p>
  5385. (<em>Appears on:</em>
  5386. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5387. </p>
  5388. <p>
  5389. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  5390. </p>
  5391. <table>
  5392. <thead>
  5393. <tr>
  5394. <th>Field</th>
  5395. <th>Description</th>
  5396. </tr>
  5397. </thead>
  5398. <tbody>
  5399. <tr>
  5400. <td>
  5401. <code>secretKey</code></br>
  5402. <em>
  5403. string
  5404. </em>
  5405. </td>
  5406. <td>
  5407. <p>The key in the Kubernetes Secret to store the value.</p>
  5408. </td>
  5409. </tr>
  5410. <tr>
  5411. <td>
  5412. <code>remoteRef</code></br>
  5413. <em>
  5414. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5415. ExternalSecretDataRemoteRef
  5416. </a>
  5417. </em>
  5418. </td>
  5419. <td>
  5420. <p>RemoteRef points to the remote secret and defines
  5421. which secret (version/property/..) to fetch.</p>
  5422. </td>
  5423. </tr>
  5424. <tr>
  5425. <td>
  5426. <code>sourceRef</code></br>
  5427. <em>
  5428. <a href="#external-secrets.io/v1.StoreSourceRef">
  5429. StoreSourceRef
  5430. </a>
  5431. </em>
  5432. </td>
  5433. <td>
  5434. <p>SourceRef allows you to override the source
  5435. from which the value will be pulled.</p>
  5436. </td>
  5437. </tr>
  5438. </tbody>
  5439. </table>
  5440. <h3 id="external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  5441. </h3>
  5442. <p>
  5443. (<em>Appears on:</em>
  5444. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5445. </p>
  5446. <p>
  5447. <p>ExternalSecretDataFromRemoteRef defines the connection between the Kubernetes Secret keys and the Provider data
  5448. when using DataFrom to fetch multiple values from a Provider.</p>
  5449. </p>
  5450. <table>
  5451. <thead>
  5452. <tr>
  5453. <th>Field</th>
  5454. <th>Description</th>
  5455. </tr>
  5456. </thead>
  5457. <tbody>
  5458. <tr>
  5459. <td>
  5460. <code>extract</code></br>
  5461. <em>
  5462. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5463. ExternalSecretDataRemoteRef
  5464. </a>
  5465. </em>
  5466. </td>
  5467. <td>
  5468. <em>(Optional)</em>
  5469. <p>Used to extract multiple key/value pairs from one secret
  5470. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5471. </td>
  5472. </tr>
  5473. <tr>
  5474. <td>
  5475. <code>find</code></br>
  5476. <em>
  5477. <a href="#external-secrets.io/v1.ExternalSecretFind">
  5478. ExternalSecretFind
  5479. </a>
  5480. </em>
  5481. </td>
  5482. <td>
  5483. <em>(Optional)</em>
  5484. <p>Used to find secrets based on tags or regular expressions
  5485. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5486. </td>
  5487. </tr>
  5488. <tr>
  5489. <td>
  5490. <code>rewrite</code></br>
  5491. <em>
  5492. <a href="#external-secrets.io/v1.ExternalSecretRewrite">
  5493. []ExternalSecretRewrite
  5494. </a>
  5495. </em>
  5496. </td>
  5497. <td>
  5498. <em>(Optional)</em>
  5499. <p>Used to rewrite secret Keys after getting them from the secret Provider
  5500. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  5501. </td>
  5502. </tr>
  5503. <tr>
  5504. <td>
  5505. <code>sourceRef</code></br>
  5506. <em>
  5507. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">
  5508. StoreGeneratorSourceRef
  5509. </a>
  5510. </em>
  5511. </td>
  5512. <td>
  5513. <p>SourceRef points to a store or generator
  5514. which contains secret values ready to use.
  5515. Use this in combination with Extract or Find pull values out of
  5516. a specific SecretStore.
  5517. When sourceRef points to a generator Extract or Find is not supported.
  5518. The generator returns a static map of values</p>
  5519. </td>
  5520. </tr>
  5521. </tbody>
  5522. </table>
  5523. <h3 id="external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  5524. </h3>
  5525. <p>
  5526. (<em>Appears on:</em>
  5527. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>,
  5528. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5529. </p>
  5530. <p>
  5531. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  5532. </p>
  5533. <table>
  5534. <thead>
  5535. <tr>
  5536. <th>Field</th>
  5537. <th>Description</th>
  5538. </tr>
  5539. </thead>
  5540. <tbody>
  5541. <tr>
  5542. <td>
  5543. <code>key</code></br>
  5544. <em>
  5545. string
  5546. </em>
  5547. </td>
  5548. <td>
  5549. <p>Key is the key used in the Provider, mandatory</p>
  5550. </td>
  5551. </tr>
  5552. <tr>
  5553. <td>
  5554. <code>metadataPolicy</code></br>
  5555. <em>
  5556. <a href="#external-secrets.io/v1.ExternalSecretMetadataPolicy">
  5557. ExternalSecretMetadataPolicy
  5558. </a>
  5559. </em>
  5560. </td>
  5561. <td>
  5562. <em>(Optional)</em>
  5563. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  5564. </td>
  5565. </tr>
  5566. <tr>
  5567. <td>
  5568. <code>property</code></br>
  5569. <em>
  5570. string
  5571. </em>
  5572. </td>
  5573. <td>
  5574. <em>(Optional)</em>
  5575. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  5576. </td>
  5577. </tr>
  5578. <tr>
  5579. <td>
  5580. <code>version</code></br>
  5581. <em>
  5582. string
  5583. </em>
  5584. </td>
  5585. <td>
  5586. <em>(Optional)</em>
  5587. <p>Used to select a specific version of the Provider value, if supported</p>
  5588. </td>
  5589. </tr>
  5590. <tr>
  5591. <td>
  5592. <code>conversionStrategy</code></br>
  5593. <em>
  5594. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5595. ExternalSecretConversionStrategy
  5596. </a>
  5597. </em>
  5598. </td>
  5599. <td>
  5600. <em>(Optional)</em>
  5601. <p>Used to define a conversion Strategy</p>
  5602. </td>
  5603. </tr>
  5604. <tr>
  5605. <td>
  5606. <code>decodingStrategy</code></br>
  5607. <em>
  5608. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5609. ExternalSecretDecodingStrategy
  5610. </a>
  5611. </em>
  5612. </td>
  5613. <td>
  5614. <em>(Optional)</em>
  5615. <p>Used to define a decoding Strategy</p>
  5616. </td>
  5617. </tr>
  5618. <tr>
  5619. <td>
  5620. <code>nullBytePolicy</code></br>
  5621. <em>
  5622. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  5623. ExternalSecretNullBytePolicy
  5624. </a>
  5625. </em>
  5626. </td>
  5627. <td>
  5628. <em>(Optional)</em>
  5629. <p>Controls how ESO handles fetched secret data containing NUL bytes for this source.</p>
  5630. </td>
  5631. </tr>
  5632. </tbody>
  5633. </table>
  5634. <h3 id="external-secrets.io/v1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  5635. (<code>string</code> alias)</p></h3>
  5636. <p>
  5637. (<em>Appears on:</em>
  5638. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5639. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>,
  5640. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  5641. </p>
  5642. <p>
  5643. <p>ExternalSecretDecodingStrategy defines strategies for decoding secret values.</p>
  5644. </p>
  5645. <table>
  5646. <thead>
  5647. <tr>
  5648. <th>Value</th>
  5649. <th>Description</th>
  5650. </tr>
  5651. </thead>
  5652. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  5653. <td><p>ExternalSecretDecodeAuto specifies automatic detection of the decoding method.</p>
  5654. </td>
  5655. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  5656. <td><p>ExternalSecretDecodeBase64 specifies that values should be decoded using Base64.</p>
  5657. </td>
  5658. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  5659. <td><p>ExternalSecretDecodeBase64URL specifies that values should be decoded using Base64URL.</p>
  5660. </td>
  5661. </tr><tr><td><p>&#34;None&#34;</p></td>
  5662. <td><p>ExternalSecretDecodeNone specifies that no decoding should be performed.</p>
  5663. </td>
  5664. </tr></tbody>
  5665. </table>
  5666. <h3 id="external-secrets.io/v1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  5667. (<code>string</code> alias)</p></h3>
  5668. <p>
  5669. (<em>Appears on:</em>
  5670. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5671. </p>
  5672. <p>
  5673. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  5674. </p>
  5675. <table>
  5676. <thead>
  5677. <tr>
  5678. <th>Value</th>
  5679. <th>Description</th>
  5680. </tr>
  5681. </thead>
  5682. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  5683. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  5684. If a secret gets deleted on the provider side and is not accessible
  5685. anymore this is not considered an error and the ExternalSecret
  5686. does not go into SecretSyncedError status.</p>
  5687. </td>
  5688. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  5689. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  5690. If a secret gets deleted on the provider side and is not accessible
  5691. anymore this is not considered an error and the ExternalSecret
  5692. does not go into SecretSyncedError status.</p>
  5693. </td>
  5694. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  5695. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  5696. If a provider secret does not exist the ExternalSecret gets into the
  5697. SecretSyncedError status.</p>
  5698. </td>
  5699. </tr></tbody>
  5700. </table>
  5701. <h3 id="external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind
  5702. </h3>
  5703. <p>
  5704. (<em>Appears on:</em>
  5705. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5706. </p>
  5707. <p>
  5708. <p>ExternalSecretFind defines configuration for finding secrets in the provider.</p>
  5709. </p>
  5710. <table>
  5711. <thead>
  5712. <tr>
  5713. <th>Field</th>
  5714. <th>Description</th>
  5715. </tr>
  5716. </thead>
  5717. <tbody>
  5718. <tr>
  5719. <td>
  5720. <code>path</code></br>
  5721. <em>
  5722. string
  5723. </em>
  5724. </td>
  5725. <td>
  5726. <em>(Optional)</em>
  5727. <p>A root path to start the find operations.</p>
  5728. </td>
  5729. </tr>
  5730. <tr>
  5731. <td>
  5732. <code>name</code></br>
  5733. <em>
  5734. <a href="#external-secrets.io/v1.FindName">
  5735. FindName
  5736. </a>
  5737. </em>
  5738. </td>
  5739. <td>
  5740. <em>(Optional)</em>
  5741. <p>Finds secrets based on the name.</p>
  5742. </td>
  5743. </tr>
  5744. <tr>
  5745. <td>
  5746. <code>tags</code></br>
  5747. <em>
  5748. map[string]string
  5749. </em>
  5750. </td>
  5751. <td>
  5752. <em>(Optional)</em>
  5753. <p>Find secrets based on tags.</p>
  5754. </td>
  5755. </tr>
  5756. <tr>
  5757. <td>
  5758. <code>conversionStrategy</code></br>
  5759. <em>
  5760. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5761. ExternalSecretConversionStrategy
  5762. </a>
  5763. </em>
  5764. </td>
  5765. <td>
  5766. <em>(Optional)</em>
  5767. <p>Used to define a conversion Strategy</p>
  5768. </td>
  5769. </tr>
  5770. <tr>
  5771. <td>
  5772. <code>decodingStrategy</code></br>
  5773. <em>
  5774. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5775. ExternalSecretDecodingStrategy
  5776. </a>
  5777. </em>
  5778. </td>
  5779. <td>
  5780. <em>(Optional)</em>
  5781. <p>Used to define a decoding Strategy</p>
  5782. </td>
  5783. </tr>
  5784. <tr>
  5785. <td>
  5786. <code>nullBytePolicy</code></br>
  5787. <em>
  5788. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  5789. ExternalSecretNullBytePolicy
  5790. </a>
  5791. </em>
  5792. </td>
  5793. <td>
  5794. <em>(Optional)</em>
  5795. <p>Controls how ESO handles fetched secret data containing NUL bytes for this find source.</p>
  5796. </td>
  5797. </tr>
  5798. </tbody>
  5799. </table>
  5800. <h3 id="external-secrets.io/v1.ExternalSecretMetadata">ExternalSecretMetadata
  5801. </h3>
  5802. <p>
  5803. (<em>Appears on:</em>
  5804. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  5805. </p>
  5806. <p>
  5807. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  5808. </p>
  5809. <table>
  5810. <thead>
  5811. <tr>
  5812. <th>Field</th>
  5813. <th>Description</th>
  5814. </tr>
  5815. </thead>
  5816. <tbody>
  5817. <tr>
  5818. <td>
  5819. <code>annotations</code></br>
  5820. <em>
  5821. map[string]string
  5822. </em>
  5823. </td>
  5824. <td>
  5825. <em>(Optional)</em>
  5826. </td>
  5827. </tr>
  5828. <tr>
  5829. <td>
  5830. <code>labels</code></br>
  5831. <em>
  5832. map[string]string
  5833. </em>
  5834. </td>
  5835. <td>
  5836. <em>(Optional)</em>
  5837. </td>
  5838. </tr>
  5839. </tbody>
  5840. </table>
  5841. <h3 id="external-secrets.io/v1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  5842. (<code>string</code> alias)</p></h3>
  5843. <p>
  5844. (<em>Appears on:</em>
  5845. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  5846. </p>
  5847. <p>
  5848. <p>ExternalSecretMetadataPolicy defines policies for fetching metadata from provider secrets.</p>
  5849. </p>
  5850. <table>
  5851. <thead>
  5852. <tr>
  5853. <th>Value</th>
  5854. <th>Description</th>
  5855. </tr>
  5856. </thead>
  5857. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  5858. <td><p>ExternalSecretMetadataPolicyFetch specifies that metadata should be fetched from the provider.</p>
  5859. </td>
  5860. </tr><tr><td><p>&#34;None&#34;</p></td>
  5861. <td><p>ExternalSecretMetadataPolicyNone specifies that no metadata should be fetched from the provider.</p>
  5862. </td>
  5863. </tr></tbody>
  5864. </table>
  5865. <h3 id="external-secrets.io/v1.ExternalSecretNullBytePolicy">ExternalSecretNullBytePolicy
  5866. (<code>string</code> alias)</p></h3>
  5867. <p>
  5868. (<em>Appears on:</em>
  5869. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5870. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5871. </p>
  5872. <p>
  5873. <p>ExternalSecretNullBytePolicy defines how fetched secret data containing NUL bytes should be handled.</p>
  5874. </p>
  5875. <table>
  5876. <thead>
  5877. <tr>
  5878. <th>Value</th>
  5879. <th>Description</th>
  5880. </tr>
  5881. </thead>
  5882. <tbody><tr><td><p>&#34;Fail&#34;</p></td>
  5883. <td><p>ExternalSecretNullBytePolicyFail fails reconciliation if fetched secret data contains NUL bytes.</p>
  5884. </td>
  5885. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  5886. <td><p>ExternalSecretNullBytePolicyIgnore allows fetched secret data to contain NUL bytes.</p>
  5887. </td>
  5888. </tr></tbody>
  5889. </table>
  5890. <h3 id="external-secrets.io/v1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  5891. (<code>string</code> alias)</p></h3>
  5892. <p>
  5893. (<em>Appears on:</em>
  5894. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5895. </p>
  5896. <p>
  5897. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  5898. </p>
  5899. <table>
  5900. <thead>
  5901. <tr>
  5902. <th>Value</th>
  5903. <th>Description</th>
  5904. </tr>
  5905. </thead>
  5906. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  5907. <td><p>RefreshPolicyCreatedOnce creates the Secret once and does not update it thereafter.</p>
  5908. </td>
  5909. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  5910. <td><p>RefreshPolicyOnChange only synchronizes when the ExternalSecret&rsquo;s metadata or spec changes.</p>
  5911. </td>
  5912. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  5913. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the provider at regular intervals.</p>
  5914. </td>
  5915. </tr></tbody>
  5916. </table>
  5917. <h3 id="external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite
  5918. </h3>
  5919. <p>
  5920. (<em>Appears on:</em>
  5921. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5922. </p>
  5923. <p>
  5924. <p>ExternalSecretRewrite defines how to rewrite secret data values before they are written to the Secret.</p>
  5925. </p>
  5926. <table>
  5927. <thead>
  5928. <tr>
  5929. <th>Field</th>
  5930. <th>Description</th>
  5931. </tr>
  5932. </thead>
  5933. <tbody>
  5934. <tr>
  5935. <td>
  5936. <code>merge</code></br>
  5937. <em>
  5938. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">
  5939. ExternalSecretRewriteMerge
  5940. </a>
  5941. </em>
  5942. </td>
  5943. <td>
  5944. <em>(Optional)</em>
  5945. <p>Used to merge key/values in one single Secret
  5946. The resulting key will contain all values from the specified secrets</p>
  5947. </td>
  5948. </tr>
  5949. <tr>
  5950. <td>
  5951. <code>regexp</code></br>
  5952. <em>
  5953. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  5954. ExternalSecretRewriteRegexp
  5955. </a>
  5956. </em>
  5957. </td>
  5958. <td>
  5959. <em>(Optional)</em>
  5960. <p>Used to rewrite with regular expressions.
  5961. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  5962. </td>
  5963. </tr>
  5964. <tr>
  5965. <td>
  5966. <code>transform</code></br>
  5967. <em>
  5968. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  5969. ExternalSecretRewriteTransform
  5970. </a>
  5971. </em>
  5972. </td>
  5973. <td>
  5974. <em>(Optional)</em>
  5975. <p>Used to apply string transformation on the secrets.
  5976. The resulting key will be the output of the template applied by the operation.</p>
  5977. </td>
  5978. </tr>
  5979. </tbody>
  5980. </table>
  5981. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge
  5982. </h3>
  5983. <p>
  5984. (<em>Appears on:</em>
  5985. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  5986. </p>
  5987. <p>
  5988. <p>ExternalSecretRewriteMerge defines configuration for merging secret values.</p>
  5989. </p>
  5990. <table>
  5991. <thead>
  5992. <tr>
  5993. <th>Field</th>
  5994. <th>Description</th>
  5995. </tr>
  5996. </thead>
  5997. <tbody>
  5998. <tr>
  5999. <td>
  6000. <code>into</code></br>
  6001. <em>
  6002. string
  6003. </em>
  6004. </td>
  6005. <td>
  6006. <em>(Optional)</em>
  6007. <p>Used to define the target key of the merge operation.
  6008. Required if strategy is JSON. Ignored otherwise.</p>
  6009. </td>
  6010. </tr>
  6011. <tr>
  6012. <td>
  6013. <code>priority</code></br>
  6014. <em>
  6015. []string
  6016. </em>
  6017. </td>
  6018. <td>
  6019. <em>(Optional)</em>
  6020. <p>Used to define key priority in conflict resolution.</p>
  6021. </td>
  6022. </tr>
  6023. <tr>
  6024. <td>
  6025. <code>priorityPolicy</code></br>
  6026. <em>
  6027. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">
  6028. ExternalSecretRewriteMergePriorityPolicy
  6029. </a>
  6030. </em>
  6031. </td>
  6032. <td>
  6033. <em>(Optional)</em>
  6034. <p>Used to define the policy when a key in the priority list does not exist in the input.</p>
  6035. </td>
  6036. </tr>
  6037. <tr>
  6038. <td>
  6039. <code>conflictPolicy</code></br>
  6040. <em>
  6041. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">
  6042. ExternalSecretRewriteMergeConflictPolicy
  6043. </a>
  6044. </em>
  6045. </td>
  6046. <td>
  6047. <em>(Optional)</em>
  6048. <p>Used to define the policy to use in conflict resolution.</p>
  6049. </td>
  6050. </tr>
  6051. <tr>
  6052. <td>
  6053. <code>strategy</code></br>
  6054. <em>
  6055. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">
  6056. ExternalSecretRewriteMergeStrategy
  6057. </a>
  6058. </em>
  6059. </td>
  6060. <td>
  6061. <em>(Optional)</em>
  6062. <p>Used to define the strategy to use in the merge operation.</p>
  6063. </td>
  6064. </tr>
  6065. </tbody>
  6066. </table>
  6067. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">ExternalSecretRewriteMergeConflictPolicy
  6068. (<code>string</code> alias)</p></h3>
  6069. <p>
  6070. (<em>Appears on:</em>
  6071. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6072. </p>
  6073. <p>
  6074. <p>ExternalSecretRewriteMergeConflictPolicy defines the policy for resolving conflicts when merging secrets.</p>
  6075. </p>
  6076. <table>
  6077. <thead>
  6078. <tr>
  6079. <th>Value</th>
  6080. <th>Description</th>
  6081. </tr>
  6082. </thead>
  6083. <tbody><tr><td><p>&#34;Error&#34;</p></td>
  6084. <td><p>ExternalSecretRewriteMergeConflictPolicyError returns an error when conflicts occur during merge.</p>
  6085. </td>
  6086. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  6087. <td><p>ExternalSecretRewriteMergeConflictPolicyIgnore ignores conflicts when merging secret values.</p>
  6088. </td>
  6089. </tr></tbody>
  6090. </table>
  6091. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">ExternalSecretRewriteMergePriorityPolicy
  6092. (<code>string</code> alias)</p></h3>
  6093. <p>
  6094. (<em>Appears on:</em>
  6095. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6096. </p>
  6097. <p>
  6098. <p>ExternalSecretRewriteMergePriorityPolicy defines the policy for handling missing keys in the priority
  6099. list during merge operations.</p>
  6100. </p>
  6101. <table>
  6102. <thead>
  6103. <tr>
  6104. <th>Value</th>
  6105. <th>Description</th>
  6106. </tr>
  6107. </thead>
  6108. <tbody><tr><td><p>&#34;IgnoreNotFound&#34;</p></td>
  6109. <td></td>
  6110. </tr><tr><td><p>&#34;Strict&#34;</p></td>
  6111. <td></td>
  6112. </tr></tbody>
  6113. </table>
  6114. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">ExternalSecretRewriteMergeStrategy
  6115. (<code>string</code> alias)</p></h3>
  6116. <p>
  6117. (<em>Appears on:</em>
  6118. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  6119. </p>
  6120. <p>
  6121. <p>ExternalSecretRewriteMergeStrategy defines the strategy for merging secrets.</p>
  6122. </p>
  6123. <table>
  6124. <thead>
  6125. <tr>
  6126. <th>Value</th>
  6127. <th>Description</th>
  6128. </tr>
  6129. </thead>
  6130. <tbody><tr><td><p>&#34;Extract&#34;</p></td>
  6131. <td><p>ExternalSecretRewriteMergeStrategyExtract merges secrets by extracting values.</p>
  6132. </td>
  6133. </tr><tr><td><p>&#34;JSON&#34;</p></td>
  6134. <td><p>ExternalSecretRewriteMergeStrategyJSON merges secrets using JSON merge strategy.</p>
  6135. </td>
  6136. </tr></tbody>
  6137. </table>
  6138. <h3 id="external-secrets.io/v1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  6139. </h3>
  6140. <p>
  6141. (<em>Appears on:</em>
  6142. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  6143. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  6144. </p>
  6145. <p>
  6146. <p>ExternalSecretRewriteRegexp defines configuration for rewriting secrets using regular expressions.</p>
  6147. </p>
  6148. <table>
  6149. <thead>
  6150. <tr>
  6151. <th>Field</th>
  6152. <th>Description</th>
  6153. </tr>
  6154. </thead>
  6155. <tbody>
  6156. <tr>
  6157. <td>
  6158. <code>source</code></br>
  6159. <em>
  6160. string
  6161. </em>
  6162. </td>
  6163. <td>
  6164. <p>Used to define the regular expression of a re.Compiler.</p>
  6165. </td>
  6166. </tr>
  6167. <tr>
  6168. <td>
  6169. <code>target</code></br>
  6170. <em>
  6171. string
  6172. </em>
  6173. </td>
  6174. <td>
  6175. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  6176. </td>
  6177. </tr>
  6178. </tbody>
  6179. </table>
  6180. <h3 id="external-secrets.io/v1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  6181. </h3>
  6182. <p>
  6183. (<em>Appears on:</em>
  6184. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  6185. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  6186. </p>
  6187. <p>
  6188. <p>ExternalSecretRewriteTransform defines configuration for transforming secrets using templates.</p>
  6189. </p>
  6190. <table>
  6191. <thead>
  6192. <tr>
  6193. <th>Field</th>
  6194. <th>Description</th>
  6195. </tr>
  6196. </thead>
  6197. <tbody>
  6198. <tr>
  6199. <td>
  6200. <code>template</code></br>
  6201. <em>
  6202. string
  6203. </em>
  6204. </td>
  6205. <td>
  6206. <p>Used to define the template to apply on the secret name.
  6207. <code>.value</code> will specify the secret name in the template.</p>
  6208. </td>
  6209. </tr>
  6210. </tbody>
  6211. </table>
  6212. <h3 id="external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec
  6213. </h3>
  6214. <p>
  6215. (<em>Appears on:</em>
  6216. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  6217. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6218. </p>
  6219. <p>
  6220. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  6221. </p>
  6222. <table>
  6223. <thead>
  6224. <tr>
  6225. <th>Field</th>
  6226. <th>Description</th>
  6227. </tr>
  6228. </thead>
  6229. <tbody>
  6230. <tr>
  6231. <td>
  6232. <code>secretStoreRef</code></br>
  6233. <em>
  6234. <a href="#external-secrets.io/v1.SecretStoreRef">
  6235. SecretStoreRef
  6236. </a>
  6237. </em>
  6238. </td>
  6239. <td>
  6240. <em>(Optional)</em>
  6241. </td>
  6242. </tr>
  6243. <tr>
  6244. <td>
  6245. <code>target</code></br>
  6246. <em>
  6247. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  6248. ExternalSecretTarget
  6249. </a>
  6250. </em>
  6251. </td>
  6252. <td>
  6253. <em>(Optional)</em>
  6254. </td>
  6255. </tr>
  6256. <tr>
  6257. <td>
  6258. <code>refreshPolicy</code></br>
  6259. <em>
  6260. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  6261. ExternalSecretRefreshPolicy
  6262. </a>
  6263. </em>
  6264. </td>
  6265. <td>
  6266. <em>(Optional)</em>
  6267. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  6268. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  6269. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  6270. No periodic updates occur if refreshInterval is 0.
  6271. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  6272. </td>
  6273. </tr>
  6274. <tr>
  6275. <td>
  6276. <code>refreshInterval</code></br>
  6277. <em>
  6278. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6279. Kubernetes meta/v1.Duration
  6280. </a>
  6281. </em>
  6282. </td>
  6283. <td>
  6284. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  6285. specified as Golang Duration strings.
  6286. 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;
  6287. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  6288. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  6289. </td>
  6290. </tr>
  6291. <tr>
  6292. <td>
  6293. <code>syncWindows</code></br>
  6294. <em>
  6295. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">
  6296. ExternalSecretSyncWindows
  6297. </a>
  6298. </em>
  6299. </td>
  6300. <td>
  6301. <em>(Optional)</em>
  6302. <p>SyncWindows optionally restricts when periodic refreshes may occur.
  6303. Evaluated in UTC, only for Periodic refresh policy (or when refreshPolicy is unset).</p>
  6304. </td>
  6305. </tr>
  6306. <tr>
  6307. <td>
  6308. <code>data</code></br>
  6309. <em>
  6310. <a href="#external-secrets.io/v1.ExternalSecretData">
  6311. []ExternalSecretData
  6312. </a>
  6313. </em>
  6314. </td>
  6315. <td>
  6316. <em>(Optional)</em>
  6317. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  6318. </td>
  6319. </tr>
  6320. <tr>
  6321. <td>
  6322. <code>dataFrom</code></br>
  6323. <em>
  6324. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  6325. []ExternalSecretDataFromRemoteRef
  6326. </a>
  6327. </em>
  6328. </td>
  6329. <td>
  6330. <em>(Optional)</em>
  6331. <p>DataFrom is used to fetch all properties from a specific Provider data
  6332. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  6333. </td>
  6334. </tr>
  6335. </tbody>
  6336. </table>
  6337. <h3 id="external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus
  6338. </h3>
  6339. <p>
  6340. (<em>Appears on:</em>
  6341. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6342. </p>
  6343. <p>
  6344. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  6345. </p>
  6346. <table>
  6347. <thead>
  6348. <tr>
  6349. <th>Field</th>
  6350. <th>Description</th>
  6351. </tr>
  6352. </thead>
  6353. <tbody>
  6354. <tr>
  6355. <td>
  6356. <code>refreshTime</code></br>
  6357. <em>
  6358. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6359. Kubernetes meta/v1.Time
  6360. </a>
  6361. </em>
  6362. </td>
  6363. <td>
  6364. <p>refreshTime is the time and date the external secret was fetched and
  6365. the target secret updated</p>
  6366. </td>
  6367. </tr>
  6368. <tr>
  6369. <td>
  6370. <code>syncedResourceVersion</code></br>
  6371. <em>
  6372. string
  6373. </em>
  6374. </td>
  6375. <td>
  6376. <p>SyncedResourceVersion keeps track of the last synced version</p>
  6377. </td>
  6378. </tr>
  6379. <tr>
  6380. <td>
  6381. <code>conditions</code></br>
  6382. <em>
  6383. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">
  6384. []ExternalSecretStatusCondition
  6385. </a>
  6386. </em>
  6387. </td>
  6388. <td>
  6389. <em>(Optional)</em>
  6390. </td>
  6391. </tr>
  6392. <tr>
  6393. <td>
  6394. <code>binding</code></br>
  6395. <em>
  6396. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  6397. Kubernetes core/v1.LocalObjectReference
  6398. </a>
  6399. </em>
  6400. </td>
  6401. <td>
  6402. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  6403. </td>
  6404. </tr>
  6405. </tbody>
  6406. </table>
  6407. <h3 id="external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  6408. </h3>
  6409. <p>
  6410. (<em>Appears on:</em>
  6411. <a href="#external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus</a>)
  6412. </p>
  6413. <p>
  6414. <p>ExternalSecretStatusCondition defines a status condition of an ExternalSecret resource.</p>
  6415. </p>
  6416. <table>
  6417. <thead>
  6418. <tr>
  6419. <th>Field</th>
  6420. <th>Description</th>
  6421. </tr>
  6422. </thead>
  6423. <tbody>
  6424. <tr>
  6425. <td>
  6426. <code>type</code></br>
  6427. <em>
  6428. <a href="#external-secrets.io/v1.ExternalSecretConditionType">
  6429. ExternalSecretConditionType
  6430. </a>
  6431. </em>
  6432. </td>
  6433. <td>
  6434. </td>
  6435. </tr>
  6436. <tr>
  6437. <td>
  6438. <code>status</code></br>
  6439. <em>
  6440. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  6441. Kubernetes core/v1.ConditionStatus
  6442. </a>
  6443. </em>
  6444. </td>
  6445. <td>
  6446. </td>
  6447. </tr>
  6448. <tr>
  6449. <td>
  6450. <code>reason</code></br>
  6451. <em>
  6452. string
  6453. </em>
  6454. </td>
  6455. <td>
  6456. <em>(Optional)</em>
  6457. </td>
  6458. </tr>
  6459. <tr>
  6460. <td>
  6461. <code>message</code></br>
  6462. <em>
  6463. string
  6464. </em>
  6465. </td>
  6466. <td>
  6467. <em>(Optional)</em>
  6468. </td>
  6469. </tr>
  6470. <tr>
  6471. <td>
  6472. <code>lastTransitionTime</code></br>
  6473. <em>
  6474. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6475. Kubernetes meta/v1.Time
  6476. </a>
  6477. </em>
  6478. </td>
  6479. <td>
  6480. <em>(Optional)</em>
  6481. </td>
  6482. </tr>
  6483. </tbody>
  6484. </table>
  6485. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindowEntry">ExternalSecretSyncWindowEntry
  6486. </h3>
  6487. <p>
  6488. (<em>Appears on:</em>
  6489. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows</a>)
  6490. </p>
  6491. <p>
  6492. <p>ExternalSecretSyncWindowEntry defines a single cron-schedule + duration pair
  6493. within a SyncWindows block.</p>
  6494. </p>
  6495. <table>
  6496. <thead>
  6497. <tr>
  6498. <th>Field</th>
  6499. <th>Description</th>
  6500. </tr>
  6501. </thead>
  6502. <tbody>
  6503. <tr>
  6504. <td>
  6505. <code>schedule</code></br>
  6506. <em>
  6507. string
  6508. </em>
  6509. </td>
  6510. <td>
  6511. <p>Schedule is a standard 5-field cron expression evaluated in UTC, or a
  6512. named shorthand such as @daily or @every 1h. It marks the start time of
  6513. each window occurrence.
  6514. Example: &ldquo;0 22 * * 1-5&rdquo; opens a window every weekday at 22:00 UTC.</p>
  6515. </td>
  6516. </tr>
  6517. <tr>
  6518. <td>
  6519. <code>duration</code></br>
  6520. <em>
  6521. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6522. Kubernetes meta/v1.Duration
  6523. </a>
  6524. </em>
  6525. </td>
  6526. <td>
  6527. <p>Duration specifies how long the window stays open after each Schedule
  6528. firing. Example: &ldquo;8h&rdquo;.</p>
  6529. </td>
  6530. </tr>
  6531. </tbody>
  6532. </table>
  6533. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindowKind">ExternalSecretSyncWindowKind
  6534. (<code>string</code> alias)</p></h3>
  6535. <p>
  6536. (<em>Appears on:</em>
  6537. <a href="#external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows</a>)
  6538. </p>
  6539. <p>
  6540. <p>ExternalSecretSyncWindowKind defines whether a SyncWindow permits or
  6541. blocks periodic refreshes.</p>
  6542. </p>
  6543. <table>
  6544. <thead>
  6545. <tr>
  6546. <th>Value</th>
  6547. <th>Description</th>
  6548. </tr>
  6549. </thead>
  6550. <tbody><tr><td><p>&#34;allow&#34;</p></td>
  6551. <td><p>SyncWindowAllow allows periodic refreshes only while at least one window
  6552. in the list is active. Refreshes are blocked at all other times.</p>
  6553. </td>
  6554. </tr><tr><td><p>&#34;deny&#34;</p></td>
  6555. <td><p>SyncWindowDeny blocks periodic refreshes while any window in the list is
  6556. active. Refreshes proceed normally at all other times.</p>
  6557. </td>
  6558. </tr></tbody>
  6559. </table>
  6560. <h3 id="external-secrets.io/v1.ExternalSecretSyncWindows">ExternalSecretSyncWindows
  6561. </h3>
  6562. <p>
  6563. (<em>Appears on:</em>
  6564. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6565. </p>
  6566. <p>
  6567. <p>ExternalSecretSyncWindows optionally restricts when periodic syncs may occur.
  6568. All windows in the list share the same Kind.</p>
  6569. </p>
  6570. <table>
  6571. <thead>
  6572. <tr>
  6573. <th>Field</th>
  6574. <th>Description</th>
  6575. </tr>
  6576. </thead>
  6577. <tbody>
  6578. <tr>
  6579. <td>
  6580. <code>kind</code></br>
  6581. <em>
  6582. <a href="#external-secrets.io/v1.ExternalSecretSyncWindowKind">
  6583. ExternalSecretSyncWindowKind
  6584. </a>
  6585. </em>
  6586. </td>
  6587. <td>
  6588. <p>Kind applies to every window in the list.
  6589. &ldquo;allow&rdquo; &ndash; syncs are permitted only while at least one window is active;
  6590. all other times are blocked.
  6591. &ldquo;deny&rdquo; &ndash; syncs are blocked while any window is active;
  6592. all other times are permitted.</p>
  6593. </td>
  6594. </tr>
  6595. <tr>
  6596. <td>
  6597. <code>windows</code></br>
  6598. <em>
  6599. <a href="#external-secrets.io/v1.ExternalSecretSyncWindowEntry">
  6600. []ExternalSecretSyncWindowEntry
  6601. </a>
  6602. </em>
  6603. </td>
  6604. <td>
  6605. <p>Windows is the list of schedule+duration pairs.</p>
  6606. </td>
  6607. </tr>
  6608. </tbody>
  6609. </table>
  6610. <h3 id="external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget
  6611. </h3>
  6612. <p>
  6613. (<em>Appears on:</em>
  6614. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6615. </p>
  6616. <p>
  6617. <p>ExternalSecretTarget defines the Kubernetes Secret to be created,
  6618. there can be only one target per ExternalSecret.</p>
  6619. </p>
  6620. <table>
  6621. <thead>
  6622. <tr>
  6623. <th>Field</th>
  6624. <th>Description</th>
  6625. </tr>
  6626. </thead>
  6627. <tbody>
  6628. <tr>
  6629. <td>
  6630. <code>name</code></br>
  6631. <em>
  6632. string
  6633. </em>
  6634. </td>
  6635. <td>
  6636. <em>(Optional)</em>
  6637. <p>The name of the Secret resource to be managed.
  6638. Defaults to the .metadata.name of the ExternalSecret resource</p>
  6639. </td>
  6640. </tr>
  6641. <tr>
  6642. <td>
  6643. <code>creationPolicy</code></br>
  6644. <em>
  6645. <a href="#external-secrets.io/v1.ExternalSecretCreationPolicy">
  6646. ExternalSecretCreationPolicy
  6647. </a>
  6648. </em>
  6649. </td>
  6650. <td>
  6651. <em>(Optional)</em>
  6652. <p>CreationPolicy defines rules on how to create the resulting Secret.
  6653. Defaults to &ldquo;Owner&rdquo;</p>
  6654. </td>
  6655. </tr>
  6656. <tr>
  6657. <td>
  6658. <code>deletionPolicy</code></br>
  6659. <em>
  6660. <a href="#external-secrets.io/v1.ExternalSecretDeletionPolicy">
  6661. ExternalSecretDeletionPolicy
  6662. </a>
  6663. </em>
  6664. </td>
  6665. <td>
  6666. <em>(Optional)</em>
  6667. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  6668. Defaults to &ldquo;Retain&rdquo;</p>
  6669. </td>
  6670. </tr>
  6671. <tr>
  6672. <td>
  6673. <code>template</code></br>
  6674. <em>
  6675. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  6676. ExternalSecretTemplate
  6677. </a>
  6678. </em>
  6679. </td>
  6680. <td>
  6681. <em>(Optional)</em>
  6682. <p>Template defines a blueprint for the created Secret resource.</p>
  6683. </td>
  6684. </tr>
  6685. <tr>
  6686. <td>
  6687. <code>manifest</code></br>
  6688. <em>
  6689. <a href="#external-secrets.io/v1.ManifestReference">
  6690. ManifestReference
  6691. </a>
  6692. </em>
  6693. </td>
  6694. <td>
  6695. <em>(Optional)</em>
  6696. <p>Manifest defines a custom Kubernetes resource to create instead of a Secret.
  6697. When specified, ExternalSecret will create the resource type defined here
  6698. (e.g., ConfigMap, Custom Resource) instead of a Secret.
  6699. Warning: Using Generic target. Make sure access policies and encryption are properly configured.</p>
  6700. </td>
  6701. </tr>
  6702. <tr>
  6703. <td>
  6704. <code>immutable</code></br>
  6705. <em>
  6706. bool
  6707. </em>
  6708. </td>
  6709. <td>
  6710. <em>(Optional)</em>
  6711. <p>Immutable defines if the final secret will be immutable</p>
  6712. </td>
  6713. </tr>
  6714. </tbody>
  6715. </table>
  6716. <h3 id="external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate
  6717. </h3>
  6718. <p>
  6719. (<em>Appears on:</em>
  6720. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>,
  6721. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  6722. </p>
  6723. <p>
  6724. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  6725. 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>
  6726. </p>
  6727. <table>
  6728. <thead>
  6729. <tr>
  6730. <th>Field</th>
  6731. <th>Description</th>
  6732. </tr>
  6733. </thead>
  6734. <tbody>
  6735. <tr>
  6736. <td>
  6737. <code>type</code></br>
  6738. <em>
  6739. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  6740. Kubernetes core/v1.SecretType
  6741. </a>
  6742. </em>
  6743. </td>
  6744. <td>
  6745. <em>(Optional)</em>
  6746. </td>
  6747. </tr>
  6748. <tr>
  6749. <td>
  6750. <code>engineVersion</code></br>
  6751. <em>
  6752. <a href="#external-secrets.io/v1.TemplateEngineVersion">
  6753. TemplateEngineVersion
  6754. </a>
  6755. </em>
  6756. </td>
  6757. <td>
  6758. <p>EngineVersion specifies the template engine version
  6759. that should be used to compile/execute the
  6760. template specified in .data and .templateFrom[].</p>
  6761. </td>
  6762. </tr>
  6763. <tr>
  6764. <td>
  6765. <code>metadata</code></br>
  6766. <em>
  6767. <a href="#external-secrets.io/v1.ExternalSecretTemplateMetadata">
  6768. ExternalSecretTemplateMetadata
  6769. </a>
  6770. </em>
  6771. </td>
  6772. <td>
  6773. <em>(Optional)</em>
  6774. </td>
  6775. </tr>
  6776. <tr>
  6777. <td>
  6778. <code>mergePolicy</code></br>
  6779. <em>
  6780. <a href="#external-secrets.io/v1.TemplateMergePolicy">
  6781. TemplateMergePolicy
  6782. </a>
  6783. </em>
  6784. </td>
  6785. <td>
  6786. </td>
  6787. </tr>
  6788. <tr>
  6789. <td>
  6790. <code>data</code></br>
  6791. <em>
  6792. map[string]string
  6793. </em>
  6794. </td>
  6795. <td>
  6796. <em>(Optional)</em>
  6797. </td>
  6798. </tr>
  6799. <tr>
  6800. <td>
  6801. <code>templateFrom</code></br>
  6802. <em>
  6803. <a href="#external-secrets.io/v1.TemplateFrom">
  6804. []TemplateFrom
  6805. </a>
  6806. </em>
  6807. </td>
  6808. <td>
  6809. <em>(Optional)</em>
  6810. </td>
  6811. </tr>
  6812. </tbody>
  6813. </table>
  6814. <h3 id="external-secrets.io/v1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  6815. </h3>
  6816. <p>
  6817. (<em>Appears on:</em>
  6818. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  6819. </p>
  6820. <p>
  6821. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  6822. </p>
  6823. <table>
  6824. <thead>
  6825. <tr>
  6826. <th>Field</th>
  6827. <th>Description</th>
  6828. </tr>
  6829. </thead>
  6830. <tbody>
  6831. <tr>
  6832. <td>
  6833. <code>annotations</code></br>
  6834. <em>
  6835. map[string]string
  6836. </em>
  6837. </td>
  6838. <td>
  6839. <em>(Optional)</em>
  6840. </td>
  6841. </tr>
  6842. <tr>
  6843. <td>
  6844. <code>labels</code></br>
  6845. <em>
  6846. map[string]string
  6847. </em>
  6848. </td>
  6849. <td>
  6850. <em>(Optional)</em>
  6851. </td>
  6852. </tr>
  6853. <tr>
  6854. <td>
  6855. <code>finalizers</code></br>
  6856. <em>
  6857. []string
  6858. </em>
  6859. </td>
  6860. <td>
  6861. <em>(Optional)</em>
  6862. </td>
  6863. </tr>
  6864. </tbody>
  6865. </table>
  6866. <h3 id="external-secrets.io/v1.ExternalSecretValidator">ExternalSecretValidator
  6867. </h3>
  6868. <p>
  6869. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  6870. </p>
  6871. <h3 id="external-secrets.io/v1.FakeProvider">FakeProvider
  6872. </h3>
  6873. <p>
  6874. (<em>Appears on:</em>
  6875. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  6876. </p>
  6877. <p>
  6878. <p>FakeProvider configures a fake provider that returns static values.</p>
  6879. </p>
  6880. <table>
  6881. <thead>
  6882. <tr>
  6883. <th>Field</th>
  6884. <th>Description</th>
  6885. </tr>
  6886. </thead>
  6887. <tbody>
  6888. <tr>
  6889. <td>
  6890. <code>data</code></br>
  6891. <em>
  6892. <a href="#external-secrets.io/v1.FakeProviderData">
  6893. []FakeProviderData
  6894. </a>
  6895. </em>
  6896. </td>
  6897. <td>
  6898. </td>
  6899. </tr>
  6900. <tr>
  6901. <td>
  6902. <code>validationResult</code></br>
  6903. <em>
  6904. <a href="#external-secrets.io/v1.ValidationResult">
  6905. ValidationResult
  6906. </a>
  6907. </em>
  6908. </td>
  6909. <td>
  6910. </td>
  6911. </tr>
  6912. </tbody>
  6913. </table>
  6914. <h3 id="external-secrets.io/v1.FakeProviderData">FakeProviderData
  6915. </h3>
  6916. <p>
  6917. (<em>Appears on:</em>
  6918. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  6919. </p>
  6920. <p>
  6921. <p>FakeProviderData defines a key-value pair with optional version for the fake provider.</p>
  6922. </p>
  6923. <table>
  6924. <thead>
  6925. <tr>
  6926. <th>Field</th>
  6927. <th>Description</th>
  6928. </tr>
  6929. </thead>
  6930. <tbody>
  6931. <tr>
  6932. <td>
  6933. <code>key</code></br>
  6934. <em>
  6935. string
  6936. </em>
  6937. </td>
  6938. <td>
  6939. </td>
  6940. </tr>
  6941. <tr>
  6942. <td>
  6943. <code>value</code></br>
  6944. <em>
  6945. string
  6946. </em>
  6947. </td>
  6948. <td>
  6949. </td>
  6950. </tr>
  6951. <tr>
  6952. <td>
  6953. <code>version</code></br>
  6954. <em>
  6955. string
  6956. </em>
  6957. </td>
  6958. <td>
  6959. </td>
  6960. </tr>
  6961. </tbody>
  6962. </table>
  6963. <h3 id="external-secrets.io/v1.FetchingPolicy">FetchingPolicy
  6964. </h3>
  6965. <p>
  6966. (<em>Appears on:</em>
  6967. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  6968. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  6969. </p>
  6970. <p>
  6971. <p>FetchingPolicy configures how the provider interprets the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret.</p>
  6972. </p>
  6973. <table>
  6974. <thead>
  6975. <tr>
  6976. <th>Field</th>
  6977. <th>Description</th>
  6978. </tr>
  6979. </thead>
  6980. <tbody>
  6981. <tr>
  6982. <td>
  6983. <code>byID</code></br>
  6984. <em>
  6985. <a href="#external-secrets.io/v1.ByID">
  6986. ByID
  6987. </a>
  6988. </em>
  6989. </td>
  6990. <td>
  6991. </td>
  6992. </tr>
  6993. <tr>
  6994. <td>
  6995. <code>byName</code></br>
  6996. <em>
  6997. <a href="#external-secrets.io/v1.ByName">
  6998. ByName
  6999. </a>
  7000. </em>
  7001. </td>
  7002. <td>
  7003. </td>
  7004. </tr>
  7005. </tbody>
  7006. </table>
  7007. <h3 id="external-secrets.io/v1.FindName">FindName
  7008. </h3>
  7009. <p>
  7010. (<em>Appears on:</em>
  7011. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  7012. </p>
  7013. <p>
  7014. <p>FindName defines criteria for finding secrets by name patterns.</p>
  7015. </p>
  7016. <table>
  7017. <thead>
  7018. <tr>
  7019. <th>Field</th>
  7020. <th>Description</th>
  7021. </tr>
  7022. </thead>
  7023. <tbody>
  7024. <tr>
  7025. <td>
  7026. <code>regexp</code></br>
  7027. <em>
  7028. string
  7029. </em>
  7030. </td>
  7031. <td>
  7032. <em>(Optional)</em>
  7033. <p>Finds secrets base</p>
  7034. </td>
  7035. </tr>
  7036. </tbody>
  7037. </table>
  7038. <h3 id="external-secrets.io/v1.FortanixProvider">FortanixProvider
  7039. </h3>
  7040. <p>
  7041. (<em>Appears on:</em>
  7042. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7043. </p>
  7044. <p>
  7045. <p>FortanixProvider provides access to Fortanix SDKMS API using the provided credentials.</p>
  7046. </p>
  7047. <table>
  7048. <thead>
  7049. <tr>
  7050. <th>Field</th>
  7051. <th>Description</th>
  7052. </tr>
  7053. </thead>
  7054. <tbody>
  7055. <tr>
  7056. <td>
  7057. <code>apiUrl</code></br>
  7058. <em>
  7059. string
  7060. </em>
  7061. </td>
  7062. <td>
  7063. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  7064. </td>
  7065. </tr>
  7066. <tr>
  7067. <td>
  7068. <code>apiKey</code></br>
  7069. <em>
  7070. <a href="#external-secrets.io/v1.FortanixProviderSecretRef">
  7071. FortanixProviderSecretRef
  7072. </a>
  7073. </em>
  7074. </td>
  7075. <td>
  7076. <p>APIKey is the API token to access SDKMS Applications.</p>
  7077. </td>
  7078. </tr>
  7079. </tbody>
  7080. </table>
  7081. <h3 id="external-secrets.io/v1.FortanixProviderSecretRef">FortanixProviderSecretRef
  7082. </h3>
  7083. <p>
  7084. (<em>Appears on:</em>
  7085. <a href="#external-secrets.io/v1.FortanixProvider">FortanixProvider</a>)
  7086. </p>
  7087. <p>
  7088. <p>FortanixProviderSecretRef is a secret reference containing the SDKMS API Key.</p>
  7089. </p>
  7090. <table>
  7091. <thead>
  7092. <tr>
  7093. <th>Field</th>
  7094. <th>Description</th>
  7095. </tr>
  7096. </thead>
  7097. <tbody>
  7098. <tr>
  7099. <td>
  7100. <code>secretRef</code></br>
  7101. <em>
  7102. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7103. External Secrets meta/v1.SecretKeySelector
  7104. </a>
  7105. </em>
  7106. </td>
  7107. <td>
  7108. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  7109. </td>
  7110. </tr>
  7111. </tbody>
  7112. </table>
  7113. <h3 id="external-secrets.io/v1.GCPSMAuth">GCPSMAuth
  7114. </h3>
  7115. <p>
  7116. (<em>Appears on:</em>
  7117. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  7118. </p>
  7119. <p>
  7120. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform Secret Manager.</p>
  7121. </p>
  7122. <table>
  7123. <thead>
  7124. <tr>
  7125. <th>Field</th>
  7126. <th>Description</th>
  7127. </tr>
  7128. </thead>
  7129. <tbody>
  7130. <tr>
  7131. <td>
  7132. <code>secretRef</code></br>
  7133. <em>
  7134. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  7135. GCPSMAuthSecretRef
  7136. </a>
  7137. </em>
  7138. </td>
  7139. <td>
  7140. <em>(Optional)</em>
  7141. </td>
  7142. </tr>
  7143. <tr>
  7144. <td>
  7145. <code>workloadIdentity</code></br>
  7146. <em>
  7147. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  7148. GCPWorkloadIdentity
  7149. </a>
  7150. </em>
  7151. </td>
  7152. <td>
  7153. <em>(Optional)</em>
  7154. </td>
  7155. </tr>
  7156. <tr>
  7157. <td>
  7158. <code>workloadIdentityFederation</code></br>
  7159. <em>
  7160. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  7161. GCPWorkloadIdentityFederation
  7162. </a>
  7163. </em>
  7164. </td>
  7165. <td>
  7166. <em>(Optional)</em>
  7167. </td>
  7168. </tr>
  7169. </tbody>
  7170. </table>
  7171. <h3 id="external-secrets.io/v1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  7172. </h3>
  7173. <p>
  7174. (<em>Appears on:</em>
  7175. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7176. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  7177. </p>
  7178. <p>
  7179. <p>GCPSMAuthSecretRef contains the secret references for GCP Secret Manager authentication.</p>
  7180. </p>
  7181. <table>
  7182. <thead>
  7183. <tr>
  7184. <th>Field</th>
  7185. <th>Description</th>
  7186. </tr>
  7187. </thead>
  7188. <tbody>
  7189. <tr>
  7190. <td>
  7191. <code>secretAccessKeySecretRef</code></br>
  7192. <em>
  7193. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7194. External Secrets meta/v1.SecretKeySelector
  7195. </a>
  7196. </em>
  7197. </td>
  7198. <td>
  7199. <em>(Optional)</em>
  7200. <p>The SecretAccessKey is used for authentication</p>
  7201. </td>
  7202. </tr>
  7203. </tbody>
  7204. </table>
  7205. <h3 id="external-secrets.io/v1.GCPSMProvider">GCPSMProvider
  7206. </h3>
  7207. <p>
  7208. (<em>Appears on:</em>
  7209. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7210. </p>
  7211. <p>
  7212. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  7213. </p>
  7214. <table>
  7215. <thead>
  7216. <tr>
  7217. <th>Field</th>
  7218. <th>Description</th>
  7219. </tr>
  7220. </thead>
  7221. <tbody>
  7222. <tr>
  7223. <td>
  7224. <code>auth</code></br>
  7225. <em>
  7226. <a href="#external-secrets.io/v1.GCPSMAuth">
  7227. GCPSMAuth
  7228. </a>
  7229. </em>
  7230. </td>
  7231. <td>
  7232. <em>(Optional)</em>
  7233. <p>Auth defines the information necessary to authenticate against GCP</p>
  7234. </td>
  7235. </tr>
  7236. <tr>
  7237. <td>
  7238. <code>projectID</code></br>
  7239. <em>
  7240. string
  7241. </em>
  7242. </td>
  7243. <td>
  7244. <p>ProjectID project where secret is located</p>
  7245. </td>
  7246. </tr>
  7247. <tr>
  7248. <td>
  7249. <code>location</code></br>
  7250. <em>
  7251. string
  7252. </em>
  7253. </td>
  7254. <td>
  7255. <p>Location optionally defines a location for a secret</p>
  7256. </td>
  7257. </tr>
  7258. <tr>
  7259. <td>
  7260. <code>secretVersionSelectionPolicy</code></br>
  7261. <em>
  7262. <a href="#external-secrets.io/v1.SecretVersionSelectionPolicy">
  7263. SecretVersionSelectionPolicy
  7264. </a>
  7265. </em>
  7266. </td>
  7267. <td>
  7268. <em>(Optional)</em>
  7269. <p>SecretVersionSelectionPolicy specifies how the provider selects a secret version
  7270. when &ldquo;latest&rdquo; is disabled or destroyed.
  7271. Possible values are:
  7272. - LatestOrFail: the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.
  7273. - LatestOrFetch: the provider falls back to fetching the latest version if the version is DESTROYED or DISABLED</p>
  7274. </td>
  7275. </tr>
  7276. </tbody>
  7277. </table>
  7278. <h3 id="external-secrets.io/v1.GCPWorkloadIdentity">GCPWorkloadIdentity
  7279. </h3>
  7280. <p>
  7281. (<em>Appears on:</em>
  7282. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7283. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  7284. </p>
  7285. <p>
  7286. <p>GCPWorkloadIdentity defines configuration for workload identity authentication to GCP.</p>
  7287. </p>
  7288. <table>
  7289. <thead>
  7290. <tr>
  7291. <th>Field</th>
  7292. <th>Description</th>
  7293. </tr>
  7294. </thead>
  7295. <tbody>
  7296. <tr>
  7297. <td>
  7298. <code>serviceAccountRef</code></br>
  7299. <em>
  7300. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7301. External Secrets meta/v1.ServiceAccountSelector
  7302. </a>
  7303. </em>
  7304. </td>
  7305. <td>
  7306. </td>
  7307. </tr>
  7308. <tr>
  7309. <td>
  7310. <code>clusterLocation</code></br>
  7311. <em>
  7312. string
  7313. </em>
  7314. </td>
  7315. <td>
  7316. <em>(Optional)</em>
  7317. <p>ClusterLocation is the location of the cluster
  7318. If not specified, it fetches information from the metadata server</p>
  7319. </td>
  7320. </tr>
  7321. <tr>
  7322. <td>
  7323. <code>clusterName</code></br>
  7324. <em>
  7325. string
  7326. </em>
  7327. </td>
  7328. <td>
  7329. <em>(Optional)</em>
  7330. <p>ClusterName is the name of the cluster
  7331. If not specified, it fetches information from the metadata server</p>
  7332. </td>
  7333. </tr>
  7334. <tr>
  7335. <td>
  7336. <code>clusterProjectID</code></br>
  7337. <em>
  7338. string
  7339. </em>
  7340. </td>
  7341. <td>
  7342. <em>(Optional)</em>
  7343. <p>ClusterProjectID is the project ID of the cluster
  7344. If not specified, it fetches information from the metadata server</p>
  7345. </td>
  7346. </tr>
  7347. </tbody>
  7348. </table>
  7349. <h3 id="external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation
  7350. </h3>
  7351. <p>
  7352. (<em>Appears on:</em>
  7353. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  7354. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  7355. </p>
  7356. <p>
  7357. <p>GCPWorkloadIdentityFederation holds the configurations required for generating federated access tokens.</p>
  7358. </p>
  7359. <table>
  7360. <thead>
  7361. <tr>
  7362. <th>Field</th>
  7363. <th>Description</th>
  7364. </tr>
  7365. </thead>
  7366. <tbody>
  7367. <tr>
  7368. <td>
  7369. <code>credConfig</code></br>
  7370. <em>
  7371. <a href="#external-secrets.io/v1.ConfigMapReference">
  7372. ConfigMapReference
  7373. </a>
  7374. </em>
  7375. </td>
  7376. <td>
  7377. <p>credConfig holds the configmap reference containing the GCP external account credential configuration in JSON format and the key name containing the json data.
  7378. For using Kubernetes cluster as the identity provider, use serviceAccountRef instead. Operators mounted serviceaccount token cannot be used as the token source, instead
  7379. serviceAccountRef must be used by providing operators service account details.</p>
  7380. </td>
  7381. </tr>
  7382. <tr>
  7383. <td>
  7384. <code>serviceAccountRef</code></br>
  7385. <em>
  7386. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7387. External Secrets meta/v1.ServiceAccountSelector
  7388. </a>
  7389. </em>
  7390. </td>
  7391. <td>
  7392. <p>serviceAccountRef is the reference to the kubernetes ServiceAccount to be used for obtaining the tokens,
  7393. when Kubernetes is configured as provider in workload identity pool.</p>
  7394. </td>
  7395. </tr>
  7396. <tr>
  7397. <td>
  7398. <code>awsSecurityCredentials</code></br>
  7399. <em>
  7400. <a href="#external-secrets.io/v1.AwsCredentialsConfig">
  7401. AwsCredentialsConfig
  7402. </a>
  7403. </em>
  7404. </td>
  7405. <td>
  7406. <p>awsSecurityCredentials is for configuring AWS region and credentials to use for obtaining the access token,
  7407. when using the AWS metadata server is not an option.</p>
  7408. </td>
  7409. </tr>
  7410. <tr>
  7411. <td>
  7412. <code>audience</code></br>
  7413. <em>
  7414. string
  7415. </em>
  7416. </td>
  7417. <td>
  7418. <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.
  7419. If specified, Audience found in the external account credential config will be overridden with the configured value.
  7420. audience must be provided when serviceAccountRef or awsSecurityCredentials is configured.</p>
  7421. </td>
  7422. </tr>
  7423. <tr>
  7424. <td>
  7425. <code>externalTokenEndpoint</code></br>
  7426. <em>
  7427. string
  7428. </em>
  7429. </td>
  7430. <td>
  7431. <p>externalTokenEndpoint is the endpoint explicitly set up to provide tokens, which will be matched against the
  7432. credential_source.url in the provided credConfig. This field is merely to double-check the external token source
  7433. URL is having the expected value.</p>
  7434. </td>
  7435. </tr>
  7436. <tr>
  7437. <td>
  7438. <code>gcpServiceAccountEmail</code></br>
  7439. <em>
  7440. string
  7441. </em>
  7442. </td>
  7443. <td>
  7444. <p>GCPServiceAccountEmail is the email of the Google Cloud service account to impersonate
  7445. after Workload Identity Federation. Use this to grant access through the service account&rsquo;s
  7446. IAM bindings (for example roles/secretmanager.secretAccessor). When set, it overrides
  7447. service_account_impersonation_url in the external account JSON from credConfig;
  7448. when serviceAccountRef is set, it also overrides the &ldquo;iam.gke.io/gcp-service-account&rdquo; annotation
  7449. on that ServiceAccount.</p>
  7450. </td>
  7451. </tr>
  7452. </tbody>
  7453. </table>
  7454. <h3 id="external-secrets.io/v1.GcpIDTokenAuthCredentials">GcpIDTokenAuthCredentials
  7455. </h3>
  7456. <p>
  7457. (<em>Appears on:</em>
  7458. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7459. </p>
  7460. <p>
  7461. <p>GcpIDTokenAuthCredentials represents the credentials for GCP ID token authentication.</p>
  7462. </p>
  7463. <table>
  7464. <thead>
  7465. <tr>
  7466. <th>Field</th>
  7467. <th>Description</th>
  7468. </tr>
  7469. </thead>
  7470. <tbody>
  7471. <tr>
  7472. <td>
  7473. <code>identityId</code></br>
  7474. <em>
  7475. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7476. External Secrets meta/v1.SecretKeySelector
  7477. </a>
  7478. </em>
  7479. </td>
  7480. <td>
  7481. </td>
  7482. </tr>
  7483. </tbody>
  7484. </table>
  7485. <h3 id="external-secrets.io/v1.GcpIamAuthCredentials">GcpIamAuthCredentials
  7486. </h3>
  7487. <p>
  7488. (<em>Appears on:</em>
  7489. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7490. </p>
  7491. <p>
  7492. <p>GcpIamAuthCredentials represents the credentials for GCP IAM authentication.</p>
  7493. </p>
  7494. <table>
  7495. <thead>
  7496. <tr>
  7497. <th>Field</th>
  7498. <th>Description</th>
  7499. </tr>
  7500. </thead>
  7501. <tbody>
  7502. <tr>
  7503. <td>
  7504. <code>identityId</code></br>
  7505. <em>
  7506. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7507. External Secrets meta/v1.SecretKeySelector
  7508. </a>
  7509. </em>
  7510. </td>
  7511. <td>
  7512. </td>
  7513. </tr>
  7514. <tr>
  7515. <td>
  7516. <code>serviceAccountKeyFilePath</code></br>
  7517. <em>
  7518. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7519. External Secrets meta/v1.SecretKeySelector
  7520. </a>
  7521. </em>
  7522. </td>
  7523. <td>
  7524. </td>
  7525. </tr>
  7526. </tbody>
  7527. </table>
  7528. <h3 id="external-secrets.io/v1.GeneratorRef">GeneratorRef
  7529. </h3>
  7530. <p>
  7531. (<em>Appears on:</em>
  7532. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  7533. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>,
  7534. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  7535. </p>
  7536. <p>
  7537. <p>GeneratorRef points to a generator custom resource.</p>
  7538. </p>
  7539. <table>
  7540. <thead>
  7541. <tr>
  7542. <th>Field</th>
  7543. <th>Description</th>
  7544. </tr>
  7545. </thead>
  7546. <tbody>
  7547. <tr>
  7548. <td>
  7549. <code>apiVersion</code></br>
  7550. <em>
  7551. string
  7552. </em>
  7553. </td>
  7554. <td>
  7555. <p>Specify the apiVersion of the generator resource</p>
  7556. </td>
  7557. </tr>
  7558. <tr>
  7559. <td>
  7560. <code>kind</code></br>
  7561. <em>
  7562. string
  7563. </em>
  7564. </td>
  7565. <td>
  7566. <p>Specify the Kind of the generator resource</p>
  7567. </td>
  7568. </tr>
  7569. <tr>
  7570. <td>
  7571. <code>name</code></br>
  7572. <em>
  7573. string
  7574. </em>
  7575. </td>
  7576. <td>
  7577. <p>Specify the name of the generator resource</p>
  7578. </td>
  7579. </tr>
  7580. </tbody>
  7581. </table>
  7582. <h3 id="external-secrets.io/v1.GenericClusterStoreValidator">GenericClusterStoreValidator
  7583. </h3>
  7584. <p>
  7585. <p>GenericClusterStoreValidator implements webhook validation for ClusterSecretStore resources.</p>
  7586. </p>
  7587. <h3 id="external-secrets.io/v1.GenericStore">GenericStore
  7588. </h3>
  7589. <p>
  7590. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  7591. or a namespaced SecretStore.</p>
  7592. </p>
  7593. <h3 id="external-secrets.io/v1.GenericStoreValidator">GenericStoreValidator
  7594. </h3>
  7595. <p>
  7596. <p>GenericStoreValidator implements webhook validation for SecretStore resources.</p>
  7597. </p>
  7598. <h3 id="external-secrets.io/v1.GithubAppAuth">GithubAppAuth
  7599. </h3>
  7600. <p>
  7601. (<em>Appears on:</em>
  7602. <a href="#external-secrets.io/v1.GithubProvider">GithubProvider</a>)
  7603. </p>
  7604. <p>
  7605. <p>GithubAppAuth defines authentication configuration using a GitHub App for accessing GitHub API.</p>
  7606. </p>
  7607. <table>
  7608. <thead>
  7609. <tr>
  7610. <th>Field</th>
  7611. <th>Description</th>
  7612. </tr>
  7613. </thead>
  7614. <tbody>
  7615. <tr>
  7616. <td>
  7617. <code>privateKey</code></br>
  7618. <em>
  7619. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7620. External Secrets meta/v1.SecretKeySelector
  7621. </a>
  7622. </em>
  7623. </td>
  7624. <td>
  7625. </td>
  7626. </tr>
  7627. </tbody>
  7628. </table>
  7629. <h3 id="external-secrets.io/v1.GithubProvider">GithubProvider
  7630. </h3>
  7631. <p>
  7632. (<em>Appears on:</em>
  7633. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7634. </p>
  7635. <p>
  7636. <p>GithubProvider provides access and authentication to a GitHub instance .</p>
  7637. </p>
  7638. <table>
  7639. <thead>
  7640. <tr>
  7641. <th>Field</th>
  7642. <th>Description</th>
  7643. </tr>
  7644. </thead>
  7645. <tbody>
  7646. <tr>
  7647. <td>
  7648. <code>url</code></br>
  7649. <em>
  7650. string
  7651. </em>
  7652. </td>
  7653. <td>
  7654. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  7655. </td>
  7656. </tr>
  7657. <tr>
  7658. <td>
  7659. <code>uploadURL</code></br>
  7660. <em>
  7661. string
  7662. </em>
  7663. </td>
  7664. <td>
  7665. <em>(Optional)</em>
  7666. <p>Upload URL for enterprise instances. Default to URL.</p>
  7667. </td>
  7668. </tr>
  7669. <tr>
  7670. <td>
  7671. <code>auth</code></br>
  7672. <em>
  7673. <a href="#external-secrets.io/v1.GithubAppAuth">
  7674. GithubAppAuth
  7675. </a>
  7676. </em>
  7677. </td>
  7678. <td>
  7679. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  7680. </td>
  7681. </tr>
  7682. <tr>
  7683. <td>
  7684. <code>appID</code></br>
  7685. <em>
  7686. int64
  7687. </em>
  7688. </td>
  7689. <td>
  7690. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  7691. </td>
  7692. </tr>
  7693. <tr>
  7694. <td>
  7695. <code>installationID</code></br>
  7696. <em>
  7697. int64
  7698. </em>
  7699. </td>
  7700. <td>
  7701. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  7702. </td>
  7703. </tr>
  7704. <tr>
  7705. <td>
  7706. <code>organization</code></br>
  7707. <em>
  7708. string
  7709. </em>
  7710. </td>
  7711. <td>
  7712. <p>organization will be used to fetch secrets from the Github organization</p>
  7713. </td>
  7714. </tr>
  7715. <tr>
  7716. <td>
  7717. <code>repository</code></br>
  7718. <em>
  7719. string
  7720. </em>
  7721. </td>
  7722. <td>
  7723. <em>(Optional)</em>
  7724. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  7725. </td>
  7726. </tr>
  7727. <tr>
  7728. <td>
  7729. <code>environment</code></br>
  7730. <em>
  7731. string
  7732. </em>
  7733. </td>
  7734. <td>
  7735. <em>(Optional)</em>
  7736. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  7737. </td>
  7738. </tr>
  7739. <tr>
  7740. <td>
  7741. <code>orgSecretVisibility</code></br>
  7742. <em>
  7743. string
  7744. </em>
  7745. </td>
  7746. <td>
  7747. <em>(Optional)</em>
  7748. <p>orgSecretVisibility controls the visibility of organization secrets pushed via PushSecret.
  7749. Valid values are &ldquo;all&rdquo; or &ldquo;private&rdquo;.
  7750. When unset, new secrets are created with visibility &ldquo;all&rdquo; and existing secrets preserve
  7751. whatever visibility they already have in GitHub.</p>
  7752. </td>
  7753. </tr>
  7754. </tbody>
  7755. </table>
  7756. <h3 id="external-secrets.io/v1.GitlabAuth">GitlabAuth
  7757. </h3>
  7758. <p>
  7759. (<em>Appears on:</em>
  7760. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>)
  7761. </p>
  7762. <p>
  7763. <p>GitlabAuth defines the authentication method for accessing GitLab API.</p>
  7764. </p>
  7765. <table>
  7766. <thead>
  7767. <tr>
  7768. <th>Field</th>
  7769. <th>Description</th>
  7770. </tr>
  7771. </thead>
  7772. <tbody>
  7773. <tr>
  7774. <td>
  7775. <code>SecretRef</code></br>
  7776. <em>
  7777. <a href="#external-secrets.io/v1.GitlabSecretRef">
  7778. GitlabSecretRef
  7779. </a>
  7780. </em>
  7781. </td>
  7782. <td>
  7783. </td>
  7784. </tr>
  7785. </tbody>
  7786. </table>
  7787. <h3 id="external-secrets.io/v1.GitlabProvider">GitlabProvider
  7788. </h3>
  7789. <p>
  7790. (<em>Appears on:</em>
  7791. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7792. </p>
  7793. <p>
  7794. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  7795. </p>
  7796. <table>
  7797. <thead>
  7798. <tr>
  7799. <th>Field</th>
  7800. <th>Description</th>
  7801. </tr>
  7802. </thead>
  7803. <tbody>
  7804. <tr>
  7805. <td>
  7806. <code>url</code></br>
  7807. <em>
  7808. string
  7809. </em>
  7810. </td>
  7811. <td>
  7812. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  7813. </td>
  7814. </tr>
  7815. <tr>
  7816. <td>
  7817. <code>auth</code></br>
  7818. <em>
  7819. <a href="#external-secrets.io/v1.GitlabAuth">
  7820. GitlabAuth
  7821. </a>
  7822. </em>
  7823. </td>
  7824. <td>
  7825. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  7826. </td>
  7827. </tr>
  7828. <tr>
  7829. <td>
  7830. <code>projectID</code></br>
  7831. <em>
  7832. string
  7833. </em>
  7834. </td>
  7835. <td>
  7836. <p>ProjectID specifies a project where secrets are located.</p>
  7837. </td>
  7838. </tr>
  7839. <tr>
  7840. <td>
  7841. <code>inheritFromGroups</code></br>
  7842. <em>
  7843. bool
  7844. </em>
  7845. </td>
  7846. <td>
  7847. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  7848. </td>
  7849. </tr>
  7850. <tr>
  7851. <td>
  7852. <code>groupIDs</code></br>
  7853. <em>
  7854. []string
  7855. </em>
  7856. </td>
  7857. <td>
  7858. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  7859. </td>
  7860. </tr>
  7861. <tr>
  7862. <td>
  7863. <code>environment</code></br>
  7864. <em>
  7865. string
  7866. </em>
  7867. </td>
  7868. <td>
  7869. <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>
  7870. </td>
  7871. </tr>
  7872. <tr>
  7873. <td>
  7874. <code>caBundle</code></br>
  7875. <em>
  7876. []byte
  7877. </em>
  7878. </td>
  7879. <td>
  7880. <em>(Optional)</em>
  7881. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  7882. can be performed.</p>
  7883. </td>
  7884. </tr>
  7885. <tr>
  7886. <td>
  7887. <code>caProvider</code></br>
  7888. <em>
  7889. <a href="#external-secrets.io/v1.CAProvider">
  7890. CAProvider
  7891. </a>
  7892. </em>
  7893. </td>
  7894. <td>
  7895. <em>(Optional)</em>
  7896. <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>
  7897. </td>
  7898. </tr>
  7899. </tbody>
  7900. </table>
  7901. <h3 id="external-secrets.io/v1.GitlabSecretRef">GitlabSecretRef
  7902. </h3>
  7903. <p>
  7904. (<em>Appears on:</em>
  7905. <a href="#external-secrets.io/v1.GitlabAuth">GitlabAuth</a>)
  7906. </p>
  7907. <p>
  7908. <p>GitlabSecretRef contains the secret reference for GitLab authentication credentials.</p>
  7909. </p>
  7910. <table>
  7911. <thead>
  7912. <tr>
  7913. <th>Field</th>
  7914. <th>Description</th>
  7915. </tr>
  7916. </thead>
  7917. <tbody>
  7918. <tr>
  7919. <td>
  7920. <code>accessToken</code></br>
  7921. <em>
  7922. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7923. External Secrets meta/v1.SecretKeySelector
  7924. </a>
  7925. </em>
  7926. </td>
  7927. <td>
  7928. <p>AccessToken is used for authentication.</p>
  7929. </td>
  7930. </tr>
  7931. </tbody>
  7932. </table>
  7933. <h3 id="external-secrets.io/v1.IBMAuth">IBMAuth
  7934. </h3>
  7935. <p>
  7936. (<em>Appears on:</em>
  7937. <a href="#external-secrets.io/v1.IBMProvider">IBMProvider</a>)
  7938. </p>
  7939. <p>
  7940. <p>IBMAuth defines authentication options for connecting to IBM Cloud Secrets Manager.</p>
  7941. </p>
  7942. <table>
  7943. <thead>
  7944. <tr>
  7945. <th>Field</th>
  7946. <th>Description</th>
  7947. </tr>
  7948. </thead>
  7949. <tbody>
  7950. <tr>
  7951. <td>
  7952. <code>secretRef</code></br>
  7953. <em>
  7954. <a href="#external-secrets.io/v1.IBMAuthSecretRef">
  7955. IBMAuthSecretRef
  7956. </a>
  7957. </em>
  7958. </td>
  7959. <td>
  7960. </td>
  7961. </tr>
  7962. <tr>
  7963. <td>
  7964. <code>containerAuth</code></br>
  7965. <em>
  7966. <a href="#external-secrets.io/v1.IBMAuthContainerAuth">
  7967. IBMAuthContainerAuth
  7968. </a>
  7969. </em>
  7970. </td>
  7971. <td>
  7972. </td>
  7973. </tr>
  7974. </tbody>
  7975. </table>
  7976. <h3 id="external-secrets.io/v1.IBMAuthContainerAuth">IBMAuthContainerAuth
  7977. </h3>
  7978. <p>
  7979. (<em>Appears on:</em>
  7980. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  7981. </p>
  7982. <p>
  7983. <p>IBMAuthContainerAuth defines container-based authentication with IAM Trusted Profile.</p>
  7984. </p>
  7985. <table>
  7986. <thead>
  7987. <tr>
  7988. <th>Field</th>
  7989. <th>Description</th>
  7990. </tr>
  7991. </thead>
  7992. <tbody>
  7993. <tr>
  7994. <td>
  7995. <code>profile</code></br>
  7996. <em>
  7997. string
  7998. </em>
  7999. </td>
  8000. <td>
  8001. <p>the IBM Trusted Profile</p>
  8002. </td>
  8003. </tr>
  8004. <tr>
  8005. <td>
  8006. <code>tokenLocation</code></br>
  8007. <em>
  8008. string
  8009. </em>
  8010. </td>
  8011. <td>
  8012. <p>Location the token is mounted on the pod</p>
  8013. </td>
  8014. </tr>
  8015. <tr>
  8016. <td>
  8017. <code>iamEndpoint</code></br>
  8018. <em>
  8019. string
  8020. </em>
  8021. </td>
  8022. <td>
  8023. </td>
  8024. </tr>
  8025. </tbody>
  8026. </table>
  8027. <h3 id="external-secrets.io/v1.IBMAuthSecretRef">IBMAuthSecretRef
  8028. </h3>
  8029. <p>
  8030. (<em>Appears on:</em>
  8031. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  8032. </p>
  8033. <p>
  8034. <p>IBMAuthSecretRef contains the secret reference for IBM Cloud API key authentication.</p>
  8035. </p>
  8036. <table>
  8037. <thead>
  8038. <tr>
  8039. <th>Field</th>
  8040. <th>Description</th>
  8041. </tr>
  8042. </thead>
  8043. <tbody>
  8044. <tr>
  8045. <td>
  8046. <code>secretApiKeySecretRef</code></br>
  8047. <em>
  8048. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8049. External Secrets meta/v1.SecretKeySelector
  8050. </a>
  8051. </em>
  8052. </td>
  8053. <td>
  8054. <p>The SecretAccessKey is used for authentication</p>
  8055. </td>
  8056. </tr>
  8057. <tr>
  8058. <td>
  8059. <code>iamEndpoint</code></br>
  8060. <em>
  8061. string
  8062. </em>
  8063. </td>
  8064. <td>
  8065. <p>The IAM endpoint used to obain a token</p>
  8066. </td>
  8067. </tr>
  8068. </tbody>
  8069. </table>
  8070. <h3 id="external-secrets.io/v1.IBMProvider">IBMProvider
  8071. </h3>
  8072. <p>
  8073. (<em>Appears on:</em>
  8074. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8075. </p>
  8076. <p>
  8077. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager
  8078. backend.</p>
  8079. </p>
  8080. <table>
  8081. <thead>
  8082. <tr>
  8083. <th>Field</th>
  8084. <th>Description</th>
  8085. </tr>
  8086. </thead>
  8087. <tbody>
  8088. <tr>
  8089. <td>
  8090. <code>auth</code></br>
  8091. <em>
  8092. <a href="#external-secrets.io/v1.IBMAuth">
  8093. IBMAuth
  8094. </a>
  8095. </em>
  8096. </td>
  8097. <td>
  8098. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  8099. </td>
  8100. </tr>
  8101. <tr>
  8102. <td>
  8103. <code>serviceUrl</code></br>
  8104. <em>
  8105. string
  8106. </em>
  8107. </td>
  8108. <td>
  8109. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  8110. </td>
  8111. </tr>
  8112. </tbody>
  8113. </table>
  8114. <h3 id="external-secrets.io/v1.InfisicalAuth">InfisicalAuth
  8115. </h3>
  8116. <p>
  8117. (<em>Appears on:</em>
  8118. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8119. </p>
  8120. <p>
  8121. <p>InfisicalAuth specifies the authentication configuration for Infisical.</p>
  8122. </p>
  8123. <table>
  8124. <thead>
  8125. <tr>
  8126. <th>Field</th>
  8127. <th>Description</th>
  8128. </tr>
  8129. </thead>
  8130. <tbody>
  8131. <tr>
  8132. <td>
  8133. <code>universalAuthCredentials</code></br>
  8134. <em>
  8135. <a href="#external-secrets.io/v1.UniversalAuthCredentials">
  8136. UniversalAuthCredentials
  8137. </a>
  8138. </em>
  8139. </td>
  8140. <td>
  8141. <em>(Optional)</em>
  8142. </td>
  8143. </tr>
  8144. <tr>
  8145. <td>
  8146. <code>azureAuthCredentials</code></br>
  8147. <em>
  8148. <a href="#external-secrets.io/v1.AzureAuthCredentials">
  8149. AzureAuthCredentials
  8150. </a>
  8151. </em>
  8152. </td>
  8153. <td>
  8154. <em>(Optional)</em>
  8155. </td>
  8156. </tr>
  8157. <tr>
  8158. <td>
  8159. <code>gcpIdTokenAuthCredentials</code></br>
  8160. <em>
  8161. <a href="#external-secrets.io/v1.GcpIDTokenAuthCredentials">
  8162. GcpIDTokenAuthCredentials
  8163. </a>
  8164. </em>
  8165. </td>
  8166. <td>
  8167. <em>(Optional)</em>
  8168. </td>
  8169. </tr>
  8170. <tr>
  8171. <td>
  8172. <code>gcpIamAuthCredentials</code></br>
  8173. <em>
  8174. <a href="#external-secrets.io/v1.GcpIamAuthCredentials">
  8175. GcpIamAuthCredentials
  8176. </a>
  8177. </em>
  8178. </td>
  8179. <td>
  8180. <em>(Optional)</em>
  8181. </td>
  8182. </tr>
  8183. <tr>
  8184. <td>
  8185. <code>jwtAuthCredentials</code></br>
  8186. <em>
  8187. <a href="#external-secrets.io/v1.JwtAuthCredentials">
  8188. JwtAuthCredentials
  8189. </a>
  8190. </em>
  8191. </td>
  8192. <td>
  8193. <em>(Optional)</em>
  8194. </td>
  8195. </tr>
  8196. <tr>
  8197. <td>
  8198. <code>ldapAuthCredentials</code></br>
  8199. <em>
  8200. <a href="#external-secrets.io/v1.LdapAuthCredentials">
  8201. LdapAuthCredentials
  8202. </a>
  8203. </em>
  8204. </td>
  8205. <td>
  8206. <em>(Optional)</em>
  8207. </td>
  8208. </tr>
  8209. <tr>
  8210. <td>
  8211. <code>ociAuthCredentials</code></br>
  8212. <em>
  8213. <a href="#external-secrets.io/v1.OciAuthCredentials">
  8214. OciAuthCredentials
  8215. </a>
  8216. </em>
  8217. </td>
  8218. <td>
  8219. <em>(Optional)</em>
  8220. </td>
  8221. </tr>
  8222. <tr>
  8223. <td>
  8224. <code>kubernetesAuthCredentials</code></br>
  8225. <em>
  8226. <a href="#external-secrets.io/v1.KubernetesAuthCredentials">
  8227. KubernetesAuthCredentials
  8228. </a>
  8229. </em>
  8230. </td>
  8231. <td>
  8232. <em>(Optional)</em>
  8233. </td>
  8234. </tr>
  8235. <tr>
  8236. <td>
  8237. <code>awsAuthCredentials</code></br>
  8238. <em>
  8239. <a href="#external-secrets.io/v1.AwsAuthCredentials">
  8240. AwsAuthCredentials
  8241. </a>
  8242. </em>
  8243. </td>
  8244. <td>
  8245. <em>(Optional)</em>
  8246. </td>
  8247. </tr>
  8248. <tr>
  8249. <td>
  8250. <code>tokenAuthCredentials</code></br>
  8251. <em>
  8252. <a href="#external-secrets.io/v1.TokenAuthCredentials">
  8253. TokenAuthCredentials
  8254. </a>
  8255. </em>
  8256. </td>
  8257. <td>
  8258. <em>(Optional)</em>
  8259. </td>
  8260. </tr>
  8261. </tbody>
  8262. </table>
  8263. <h3 id="external-secrets.io/v1.InfisicalProvider">InfisicalProvider
  8264. </h3>
  8265. <p>
  8266. (<em>Appears on:</em>
  8267. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8268. </p>
  8269. <p>
  8270. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  8271. </p>
  8272. <table>
  8273. <thead>
  8274. <tr>
  8275. <th>Field</th>
  8276. <th>Description</th>
  8277. </tr>
  8278. </thead>
  8279. <tbody>
  8280. <tr>
  8281. <td>
  8282. <code>auth</code></br>
  8283. <em>
  8284. <a href="#external-secrets.io/v1.InfisicalAuth">
  8285. InfisicalAuth
  8286. </a>
  8287. </em>
  8288. </td>
  8289. <td>
  8290. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  8291. </td>
  8292. </tr>
  8293. <tr>
  8294. <td>
  8295. <code>secretsScope</code></br>
  8296. <em>
  8297. <a href="#external-secrets.io/v1.MachineIdentityScopeInWorkspace">
  8298. MachineIdentityScopeInWorkspace
  8299. </a>
  8300. </em>
  8301. </td>
  8302. <td>
  8303. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  8304. </td>
  8305. </tr>
  8306. <tr>
  8307. <td>
  8308. <code>hostAPI</code></br>
  8309. <em>
  8310. string
  8311. </em>
  8312. </td>
  8313. <td>
  8314. <em>(Optional)</em>
  8315. <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>
  8316. </td>
  8317. </tr>
  8318. <tr>
  8319. <td>
  8320. <code>caBundle</code></br>
  8321. <em>
  8322. []byte
  8323. </em>
  8324. </td>
  8325. <td>
  8326. <em>(Optional)</em>
  8327. <p>CABundle is a PEM-encoded CA certificate bundle used to validate
  8328. the Infisical server&rsquo;s TLS certificate. Mutually exclusive with CAProvider.</p>
  8329. </td>
  8330. </tr>
  8331. <tr>
  8332. <td>
  8333. <code>caProvider</code></br>
  8334. <em>
  8335. <a href="#external-secrets.io/v1.CAProvider">
  8336. CAProvider
  8337. </a>
  8338. </em>
  8339. </td>
  8340. <td>
  8341. <em>(Optional)</em>
  8342. <p>CAProvider is a reference to a Secret or ConfigMap that contains a CA certificate.
  8343. The certificate is used to validate the Infisical server&rsquo;s TLS certificate.
  8344. Mutually exclusive with CABundle.</p>
  8345. </td>
  8346. </tr>
  8347. </tbody>
  8348. </table>
  8349. <h3 id="external-secrets.io/v1.IntegrationInfo">IntegrationInfo
  8350. </h3>
  8351. <p>
  8352. (<em>Appears on:</em>
  8353. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  8354. </p>
  8355. <p>
  8356. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.</p>
  8357. </p>
  8358. <table>
  8359. <thead>
  8360. <tr>
  8361. <th>Field</th>
  8362. <th>Description</th>
  8363. </tr>
  8364. </thead>
  8365. <tbody>
  8366. <tr>
  8367. <td>
  8368. <code>name</code></br>
  8369. <em>
  8370. string
  8371. </em>
  8372. </td>
  8373. <td>
  8374. <p>Name defaults to &ldquo;1Password SDK&rdquo;.</p>
  8375. </td>
  8376. </tr>
  8377. <tr>
  8378. <td>
  8379. <code>version</code></br>
  8380. <em>
  8381. string
  8382. </em>
  8383. </td>
  8384. <td>
  8385. <p>Version defaults to &ldquo;v1.0.0&rdquo;.</p>
  8386. </td>
  8387. </tr>
  8388. </tbody>
  8389. </table>
  8390. <h3 id="external-secrets.io/v1.JwtAuthCredentials">JwtAuthCredentials
  8391. </h3>
  8392. <p>
  8393. (<em>Appears on:</em>
  8394. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8395. </p>
  8396. <p>
  8397. <p>JwtAuthCredentials represents the credentials for JWT authentication.</p>
  8398. </p>
  8399. <table>
  8400. <thead>
  8401. <tr>
  8402. <th>Field</th>
  8403. <th>Description</th>
  8404. </tr>
  8405. </thead>
  8406. <tbody>
  8407. <tr>
  8408. <td>
  8409. <code>identityId</code></br>
  8410. <em>
  8411. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8412. External Secrets meta/v1.SecretKeySelector
  8413. </a>
  8414. </em>
  8415. </td>
  8416. <td>
  8417. </td>
  8418. </tr>
  8419. <tr>
  8420. <td>
  8421. <code>jwt</code></br>
  8422. <em>
  8423. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8424. External Secrets meta/v1.SecretKeySelector
  8425. </a>
  8426. </em>
  8427. </td>
  8428. <td>
  8429. </td>
  8430. </tr>
  8431. </tbody>
  8432. </table>
  8433. <h3 id="external-secrets.io/v1.KeeperSecurityProvider">KeeperSecurityProvider
  8434. </h3>
  8435. <p>
  8436. (<em>Appears on:</em>
  8437. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8438. </p>
  8439. <p>
  8440. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  8441. </p>
  8442. <table>
  8443. <thead>
  8444. <tr>
  8445. <th>Field</th>
  8446. <th>Description</th>
  8447. </tr>
  8448. </thead>
  8449. <tbody>
  8450. <tr>
  8451. <td>
  8452. <code>authRef</code></br>
  8453. <em>
  8454. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8455. External Secrets meta/v1.SecretKeySelector
  8456. </a>
  8457. </em>
  8458. </td>
  8459. <td>
  8460. </td>
  8461. </tr>
  8462. <tr>
  8463. <td>
  8464. <code>folderID</code></br>
  8465. <em>
  8466. string
  8467. </em>
  8468. </td>
  8469. <td>
  8470. </td>
  8471. </tr>
  8472. <tr>
  8473. <td>
  8474. <code>getByTitleFallback</code></br>
  8475. <em>
  8476. bool
  8477. </em>
  8478. </td>
  8479. <td>
  8480. </td>
  8481. </tr>
  8482. </tbody>
  8483. </table>
  8484. <h3 id="external-secrets.io/v1.KubernetesAuth">KubernetesAuth
  8485. </h3>
  8486. <p>
  8487. (<em>Appears on:</em>
  8488. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8489. </p>
  8490. <p>
  8491. <p>KubernetesAuth defines authentication options for connecting to a Kubernetes cluster.</p>
  8492. </p>
  8493. <table>
  8494. <thead>
  8495. <tr>
  8496. <th>Field</th>
  8497. <th>Description</th>
  8498. </tr>
  8499. </thead>
  8500. <tbody>
  8501. <tr>
  8502. <td>
  8503. <code>cert</code></br>
  8504. <em>
  8505. <a href="#external-secrets.io/v1.CertAuth">
  8506. CertAuth
  8507. </a>
  8508. </em>
  8509. </td>
  8510. <td>
  8511. <em>(Optional)</em>
  8512. <p>has both clientCert and clientKey as secretKeySelector</p>
  8513. </td>
  8514. </tr>
  8515. <tr>
  8516. <td>
  8517. <code>token</code></br>
  8518. <em>
  8519. <a href="#external-secrets.io/v1.TokenAuth">
  8520. TokenAuth
  8521. </a>
  8522. </em>
  8523. </td>
  8524. <td>
  8525. <em>(Optional)</em>
  8526. <p>use static token to authenticate with</p>
  8527. </td>
  8528. </tr>
  8529. <tr>
  8530. <td>
  8531. <code>serviceAccount</code></br>
  8532. <em>
  8533. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  8534. External Secrets meta/v1.ServiceAccountSelector
  8535. </a>
  8536. </em>
  8537. </td>
  8538. <td>
  8539. <em>(Optional)</em>
  8540. <p>points to a service account that should be used for authentication</p>
  8541. </td>
  8542. </tr>
  8543. </tbody>
  8544. </table>
  8545. <h3 id="external-secrets.io/v1.KubernetesAuthCredentials">KubernetesAuthCredentials
  8546. </h3>
  8547. <p>
  8548. (<em>Appears on:</em>
  8549. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8550. </p>
  8551. <p>
  8552. <p>KubernetesAuthCredentials represents the credentials for Kubernetes authentication.</p>
  8553. </p>
  8554. <table>
  8555. <thead>
  8556. <tr>
  8557. <th>Field</th>
  8558. <th>Description</th>
  8559. </tr>
  8560. </thead>
  8561. <tbody>
  8562. <tr>
  8563. <td>
  8564. <code>identityId</code></br>
  8565. <em>
  8566. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8567. External Secrets meta/v1.SecretKeySelector
  8568. </a>
  8569. </em>
  8570. </td>
  8571. <td>
  8572. </td>
  8573. </tr>
  8574. <tr>
  8575. <td>
  8576. <code>serviceAccountTokenPath</code></br>
  8577. <em>
  8578. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8579. External Secrets meta/v1.SecretKeySelector
  8580. </a>
  8581. </em>
  8582. </td>
  8583. <td>
  8584. <em>(Optional)</em>
  8585. </td>
  8586. </tr>
  8587. </tbody>
  8588. </table>
  8589. <h3 id="external-secrets.io/v1.KubernetesProvider">KubernetesProvider
  8590. </h3>
  8591. <p>
  8592. (<em>Appears on:</em>
  8593. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8594. </p>
  8595. <p>
  8596. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  8597. </p>
  8598. <table>
  8599. <thead>
  8600. <tr>
  8601. <th>Field</th>
  8602. <th>Description</th>
  8603. </tr>
  8604. </thead>
  8605. <tbody>
  8606. <tr>
  8607. <td>
  8608. <code>server</code></br>
  8609. <em>
  8610. <a href="#external-secrets.io/v1.KubernetesServer">
  8611. KubernetesServer
  8612. </a>
  8613. </em>
  8614. </td>
  8615. <td>
  8616. <em>(Optional)</em>
  8617. <p>configures the Kubernetes server Address.</p>
  8618. </td>
  8619. </tr>
  8620. <tr>
  8621. <td>
  8622. <code>auth</code></br>
  8623. <em>
  8624. <a href="#external-secrets.io/v1.KubernetesAuth">
  8625. KubernetesAuth
  8626. </a>
  8627. </em>
  8628. </td>
  8629. <td>
  8630. <em>(Optional)</em>
  8631. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  8632. </td>
  8633. </tr>
  8634. <tr>
  8635. <td>
  8636. <code>authRef</code></br>
  8637. <em>
  8638. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8639. External Secrets meta/v1.SecretKeySelector
  8640. </a>
  8641. </em>
  8642. </td>
  8643. <td>
  8644. <em>(Optional)</em>
  8645. <p>A reference to a secret that contains the auth information.</p>
  8646. </td>
  8647. </tr>
  8648. <tr>
  8649. <td>
  8650. <code>remoteNamespace</code></br>
  8651. <em>
  8652. string
  8653. </em>
  8654. </td>
  8655. <td>
  8656. <em>(Optional)</em>
  8657. <p>Remote namespace to fetch the secrets from</p>
  8658. </td>
  8659. </tr>
  8660. </tbody>
  8661. </table>
  8662. <h3 id="external-secrets.io/v1.KubernetesServer">KubernetesServer
  8663. </h3>
  8664. <p>
  8665. (<em>Appears on:</em>
  8666. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8667. </p>
  8668. <p>
  8669. <p>KubernetesServer defines configuration for connecting to a Kubernetes API server.</p>
  8670. </p>
  8671. <table>
  8672. <thead>
  8673. <tr>
  8674. <th>Field</th>
  8675. <th>Description</th>
  8676. </tr>
  8677. </thead>
  8678. <tbody>
  8679. <tr>
  8680. <td>
  8681. <code>url</code></br>
  8682. <em>
  8683. string
  8684. </em>
  8685. </td>
  8686. <td>
  8687. <em>(Optional)</em>
  8688. <p>configures the Kubernetes server Address.</p>
  8689. </td>
  8690. </tr>
  8691. <tr>
  8692. <td>
  8693. <code>caBundle</code></br>
  8694. <em>
  8695. []byte
  8696. </em>
  8697. </td>
  8698. <td>
  8699. <em>(Optional)</em>
  8700. <p>CABundle is a base64-encoded CA certificate</p>
  8701. </td>
  8702. </tr>
  8703. <tr>
  8704. <td>
  8705. <code>caProvider</code></br>
  8706. <em>
  8707. <a href="#external-secrets.io/v1.CAProvider">
  8708. CAProvider
  8709. </a>
  8710. </em>
  8711. </td>
  8712. <td>
  8713. <em>(Optional)</em>
  8714. <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>
  8715. </td>
  8716. </tr>
  8717. </tbody>
  8718. </table>
  8719. <h3 id="external-secrets.io/v1.LdapAuthCredentials">LdapAuthCredentials
  8720. </h3>
  8721. <p>
  8722. (<em>Appears on:</em>
  8723. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8724. </p>
  8725. <p>
  8726. <p>LdapAuthCredentials represents the credentials for LDAP authentication.</p>
  8727. </p>
  8728. <table>
  8729. <thead>
  8730. <tr>
  8731. <th>Field</th>
  8732. <th>Description</th>
  8733. </tr>
  8734. </thead>
  8735. <tbody>
  8736. <tr>
  8737. <td>
  8738. <code>identityId</code></br>
  8739. <em>
  8740. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8741. External Secrets meta/v1.SecretKeySelector
  8742. </a>
  8743. </em>
  8744. </td>
  8745. <td>
  8746. </td>
  8747. </tr>
  8748. <tr>
  8749. <td>
  8750. <code>ldapPassword</code></br>
  8751. <em>
  8752. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8753. External Secrets meta/v1.SecretKeySelector
  8754. </a>
  8755. </em>
  8756. </td>
  8757. <td>
  8758. </td>
  8759. </tr>
  8760. <tr>
  8761. <td>
  8762. <code>ldapUsername</code></br>
  8763. <em>
  8764. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8765. External Secrets meta/v1.SecretKeySelector
  8766. </a>
  8767. </em>
  8768. </td>
  8769. <td>
  8770. </td>
  8771. </tr>
  8772. </tbody>
  8773. </table>
  8774. <h3 id="external-secrets.io/v1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  8775. </h3>
  8776. <p>
  8777. (<em>Appears on:</em>
  8778. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8779. </p>
  8780. <p>
  8781. <p>MachineIdentityScopeInWorkspace defines the scope for machine identity within a workspace.</p>
  8782. </p>
  8783. <table>
  8784. <thead>
  8785. <tr>
  8786. <th>Field</th>
  8787. <th>Description</th>
  8788. </tr>
  8789. </thead>
  8790. <tbody>
  8791. <tr>
  8792. <td>
  8793. <code>secretsPath</code></br>
  8794. <em>
  8795. string
  8796. </em>
  8797. </td>
  8798. <td>
  8799. <em>(Optional)</em>
  8800. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  8801. </td>
  8802. </tr>
  8803. <tr>
  8804. <td>
  8805. <code>recursive</code></br>
  8806. <em>
  8807. bool
  8808. </em>
  8809. </td>
  8810. <td>
  8811. <em>(Optional)</em>
  8812. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  8813. </td>
  8814. </tr>
  8815. <tr>
  8816. <td>
  8817. <code>environmentSlug</code></br>
  8818. <em>
  8819. string
  8820. </em>
  8821. </td>
  8822. <td>
  8823. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  8824. </td>
  8825. </tr>
  8826. <tr>
  8827. <td>
  8828. <code>projectSlug</code></br>
  8829. <em>
  8830. string
  8831. </em>
  8832. </td>
  8833. <td>
  8834. <p>ProjectSlug is the required slug identifier for the project.</p>
  8835. </td>
  8836. </tr>
  8837. <tr>
  8838. <td>
  8839. <code>organizationSlug</code></br>
  8840. <em>
  8841. string
  8842. </em>
  8843. </td>
  8844. <td>
  8845. <p>OrganizationSlug is the optional slug that identifies the organization that will be used
  8846. during authentication. Useful for sub-organization setups</p>
  8847. </td>
  8848. </tr>
  8849. <tr>
  8850. <td>
  8851. <code>expandSecretReferences</code></br>
  8852. <em>
  8853. bool
  8854. </em>
  8855. </td>
  8856. <td>
  8857. <em>(Optional)</em>
  8858. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  8859. </td>
  8860. </tr>
  8861. </tbody>
  8862. </table>
  8863. <h3 id="external-secrets.io/v1.MaintenanceStatus">MaintenanceStatus
  8864. (<code>string</code> alias)</p></h3>
  8865. <p>
  8866. <p>MaintenanceStatus defines a type for different maintenance states of a provider schema.</p>
  8867. </p>
  8868. <table>
  8869. <thead>
  8870. <tr>
  8871. <th>Value</th>
  8872. <th>Description</th>
  8873. </tr>
  8874. </thead>
  8875. <tbody><tr><td><p>&#34;Deprecated&#34;</p></td>
  8876. <td></td>
  8877. </tr><tr><td><p>&#34;Maintained&#34;</p></td>
  8878. <td></td>
  8879. </tr><tr><td><p>&#34;NotMaintained&#34;</p></td>
  8880. <td></td>
  8881. </tr></tbody>
  8882. </table>
  8883. <h3 id="external-secrets.io/v1.ManifestReference">ManifestReference
  8884. </h3>
  8885. <p>
  8886. (<em>Appears on:</em>
  8887. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  8888. </p>
  8889. <p>
  8890. <p>ManifestReference defines a custom Kubernetes resource type to be created
  8891. instead of a Secret. This allows ExternalSecret to create ConfigMaps,
  8892. Custom Resources, or any other Kubernetes resource type.</p>
  8893. </p>
  8894. <table>
  8895. <thead>
  8896. <tr>
  8897. <th>Field</th>
  8898. <th>Description</th>
  8899. </tr>
  8900. </thead>
  8901. <tbody>
  8902. <tr>
  8903. <td>
  8904. <code>apiVersion</code></br>
  8905. <em>
  8906. string
  8907. </em>
  8908. </td>
  8909. <td>
  8910. <p>APIVersion of the target resource (e.g., &ldquo;v1&rdquo; for ConfigMap, &ldquo;argoproj.io/v1alpha1&rdquo; for ArgoCD Application)</p>
  8911. </td>
  8912. </tr>
  8913. <tr>
  8914. <td>
  8915. <code>kind</code></br>
  8916. <em>
  8917. string
  8918. </em>
  8919. </td>
  8920. <td>
  8921. <p>Kind of the target resource (e.g., &ldquo;ConfigMap&rdquo;, &ldquo;Application&rdquo;)</p>
  8922. </td>
  8923. </tr>
  8924. </tbody>
  8925. </table>
  8926. <h3 id="external-secrets.io/v1.NTLMProtocol">NTLMProtocol
  8927. </h3>
  8928. <p>
  8929. (<em>Appears on:</em>
  8930. <a href="#external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol</a>)
  8931. </p>
  8932. <p>
  8933. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  8934. </p>
  8935. <table>
  8936. <thead>
  8937. <tr>
  8938. <th>Field</th>
  8939. <th>Description</th>
  8940. </tr>
  8941. </thead>
  8942. <tbody>
  8943. <tr>
  8944. <td>
  8945. <code>usernameSecret</code></br>
  8946. <em>
  8947. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8948. External Secrets meta/v1.SecretKeySelector
  8949. </a>
  8950. </em>
  8951. </td>
  8952. <td>
  8953. </td>
  8954. </tr>
  8955. <tr>
  8956. <td>
  8957. <code>passwordSecret</code></br>
  8958. <em>
  8959. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8960. External Secrets meta/v1.SecretKeySelector
  8961. </a>
  8962. </em>
  8963. </td>
  8964. <td>
  8965. </td>
  8966. </tr>
  8967. </tbody>
  8968. </table>
  8969. <h3 id="external-secrets.io/v1.NebiusAuth">NebiusAuth
  8970. </h3>
  8971. <p>
  8972. (<em>Appears on:</em>
  8973. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  8974. </p>
  8975. <p>
  8976. <p>NebiusAuth defines the authentication method for the Nebius provider.</p>
  8977. </p>
  8978. <table>
  8979. <thead>
  8980. <tr>
  8981. <th>Field</th>
  8982. <th>Description</th>
  8983. </tr>
  8984. </thead>
  8985. <tbody>
  8986. <tr>
  8987. <td>
  8988. <code>serviceAccountCredsSecretRef</code></br>
  8989. <em>
  8990. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8991. External Secrets meta/v1.SecretKeySelector
  8992. </a>
  8993. </em>
  8994. </td>
  8995. <td>
  8996. <em>(Optional)</em>
  8997. <p>ServiceAccountCreds references a Kubernetes Secret key that contains a JSON
  8998. document with service account credentials used to get an IAM token.</p>
  8999. <p>Expected JSON structure:
  9000. {
  9001. &ldquo;subject-credentials&rdquo;: {
  9002. &ldquo;alg&rdquo;: &ldquo;RS256&rdquo;,
  9003. &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;,
  9004. &ldquo;kid&rdquo;: &ldquo;<public-key-id>&rdquo;,
  9005. &ldquo;iss&rdquo;: &ldquo;<issuer-service-account-id>&rdquo;,
  9006. &ldquo;sub&rdquo;: &ldquo;<subject-service-account-id>&rdquo;
  9007. }
  9008. }</p>
  9009. </td>
  9010. </tr>
  9011. <tr>
  9012. <td>
  9013. <code>tokenSecretRef</code></br>
  9014. <em>
  9015. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9016. External Secrets meta/v1.SecretKeySelector
  9017. </a>
  9018. </em>
  9019. </td>
  9020. <td>
  9021. <em>(Optional)</em>
  9022. <p>Token authenticates with Nebius Mysterybox by presenting a token.</p>
  9023. </td>
  9024. </tr>
  9025. </tbody>
  9026. </table>
  9027. <h3 id="external-secrets.io/v1.NebiusCAProvider">NebiusCAProvider
  9028. </h3>
  9029. <p>
  9030. (<em>Appears on:</em>
  9031. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  9032. </p>
  9033. <p>
  9034. <p>NebiusCAProvider The provider for the CA bundle to use to validate Nebius server certificate.</p>
  9035. </p>
  9036. <table>
  9037. <thead>
  9038. <tr>
  9039. <th>Field</th>
  9040. <th>Description</th>
  9041. </tr>
  9042. </thead>
  9043. <tbody>
  9044. <tr>
  9045. <td>
  9046. <code>certSecretRef</code></br>
  9047. <em>
  9048. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9049. External Secrets meta/v1.SecretKeySelector
  9050. </a>
  9051. </em>
  9052. </td>
  9053. <td>
  9054. <em>(Optional)</em>
  9055. </td>
  9056. </tr>
  9057. </tbody>
  9058. </table>
  9059. <h3 id="external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider
  9060. </h3>
  9061. <p>
  9062. (<em>Appears on:</em>
  9063. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9064. </p>
  9065. <p>
  9066. <p>NebiusMysteryboxProvider Configures a store to sync secrets using the Nebius Mysterybox provider.</p>
  9067. </p>
  9068. <table>
  9069. <thead>
  9070. <tr>
  9071. <th>Field</th>
  9072. <th>Description</th>
  9073. </tr>
  9074. </thead>
  9075. <tbody>
  9076. <tr>
  9077. <td>
  9078. <code>apiDomain</code></br>
  9079. <em>
  9080. string
  9081. </em>
  9082. </td>
  9083. <td>
  9084. <p>NebiusMysterybox API endpoint</p>
  9085. </td>
  9086. </tr>
  9087. <tr>
  9088. <td>
  9089. <code>auth</code></br>
  9090. <em>
  9091. <a href="#external-secrets.io/v1.NebiusAuth">
  9092. NebiusAuth
  9093. </a>
  9094. </em>
  9095. </td>
  9096. <td>
  9097. <p>Auth defines parameters to authenticate in MysteryBox</p>
  9098. </td>
  9099. </tr>
  9100. <tr>
  9101. <td>
  9102. <code>caProvider</code></br>
  9103. <em>
  9104. <a href="#external-secrets.io/v1.NebiusCAProvider">
  9105. NebiusCAProvider
  9106. </a>
  9107. </em>
  9108. </td>
  9109. <td>
  9110. <em>(Optional)</em>
  9111. <p>The provider for the CA bundle to use to validate NebiusMysterybox server certificate.</p>
  9112. </td>
  9113. </tr>
  9114. </tbody>
  9115. </table>
  9116. <h3 id="external-secrets.io/v1.NgrokAuth">NgrokAuth
  9117. </h3>
  9118. <p>
  9119. (<em>Appears on:</em>
  9120. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  9121. </p>
  9122. <p>
  9123. <p>NgrokAuth configures the authentication method for the ngrok provider.</p>
  9124. </p>
  9125. <table>
  9126. <thead>
  9127. <tr>
  9128. <th>Field</th>
  9129. <th>Description</th>
  9130. </tr>
  9131. </thead>
  9132. <tbody>
  9133. <tr>
  9134. <td>
  9135. <code>apiKey</code></br>
  9136. <em>
  9137. <a href="#external-secrets.io/v1.NgrokProviderSecretRef">
  9138. NgrokProviderSecretRef
  9139. </a>
  9140. </em>
  9141. </td>
  9142. <td>
  9143. <em>(Optional)</em>
  9144. <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>
  9145. </td>
  9146. </tr>
  9147. </tbody>
  9148. </table>
  9149. <h3 id="external-secrets.io/v1.NgrokProvider">NgrokProvider
  9150. </h3>
  9151. <p>
  9152. (<em>Appears on:</em>
  9153. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9154. </p>
  9155. <p>
  9156. <p>NgrokProvider configures a store to sync secrets with a ngrok vault to use in traffic policies.
  9157. See: <a href="https://ngrok.com/blog-post/secrets-for-traffic-policy">https://ngrok.com/blog-post/secrets-for-traffic-policy</a></p>
  9158. </p>
  9159. <table>
  9160. <thead>
  9161. <tr>
  9162. <th>Field</th>
  9163. <th>Description</th>
  9164. </tr>
  9165. </thead>
  9166. <tbody>
  9167. <tr>
  9168. <td>
  9169. <code>apiUrl</code></br>
  9170. <em>
  9171. string
  9172. </em>
  9173. </td>
  9174. <td>
  9175. <p>APIURL is the URL of the ngrok API.</p>
  9176. </td>
  9177. </tr>
  9178. <tr>
  9179. <td>
  9180. <code>auth</code></br>
  9181. <em>
  9182. <a href="#external-secrets.io/v1.NgrokAuth">
  9183. NgrokAuth
  9184. </a>
  9185. </em>
  9186. </td>
  9187. <td>
  9188. <p>Auth configures how the ngrok provider authenticates with the ngrok API.</p>
  9189. </td>
  9190. </tr>
  9191. <tr>
  9192. <td>
  9193. <code>vault</code></br>
  9194. <em>
  9195. <a href="#external-secrets.io/v1.NgrokVault">
  9196. NgrokVault
  9197. </a>
  9198. </em>
  9199. </td>
  9200. <td>
  9201. <p>Vault configures the ngrok vault to sync secrets with.</p>
  9202. </td>
  9203. </tr>
  9204. </tbody>
  9205. </table>
  9206. <h3 id="external-secrets.io/v1.NgrokProviderSecretRef">NgrokProviderSecretRef
  9207. </h3>
  9208. <p>
  9209. (<em>Appears on:</em>
  9210. <a href="#external-secrets.io/v1.NgrokAuth">NgrokAuth</a>)
  9211. </p>
  9212. <p>
  9213. <p>NgrokProviderSecretRef contains the secret reference for the ngrok provider.</p>
  9214. </p>
  9215. <table>
  9216. <thead>
  9217. <tr>
  9218. <th>Field</th>
  9219. <th>Description</th>
  9220. </tr>
  9221. </thead>
  9222. <tbody>
  9223. <tr>
  9224. <td>
  9225. <code>secretRef</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. <em>(Optional)</em>
  9234. <p>SecretRef is a reference to a secret containing the ngrok API key.</p>
  9235. </td>
  9236. </tr>
  9237. </tbody>
  9238. </table>
  9239. <h3 id="external-secrets.io/v1.NgrokVault">NgrokVault
  9240. </h3>
  9241. <p>
  9242. (<em>Appears on:</em>
  9243. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  9244. </p>
  9245. <p>
  9246. <p>NgrokVault configures the ngrok vault to sync secrets with.</p>
  9247. </p>
  9248. <table>
  9249. <thead>
  9250. <tr>
  9251. <th>Field</th>
  9252. <th>Description</th>
  9253. </tr>
  9254. </thead>
  9255. <tbody>
  9256. <tr>
  9257. <td>
  9258. <code>name</code></br>
  9259. <em>
  9260. string
  9261. </em>
  9262. </td>
  9263. <td>
  9264. <p>Name is the name of the ngrok vault to sync secrets with.</p>
  9265. </td>
  9266. </tr>
  9267. </tbody>
  9268. </table>
  9269. <h3 id="external-secrets.io/v1.NoSecretError">NoSecretError
  9270. </h3>
  9271. <p>
  9272. <p>NoSecretError shall be returned when a GetSecret can not find the
  9273. desired secret. This is used for deletionPolicy.</p>
  9274. </p>
  9275. <h3 id="external-secrets.io/v1.NotModifiedError">NotModifiedError
  9276. </h3>
  9277. <p>
  9278. <p>NotModifiedError to signal that the webhook received no changes,
  9279. and it should just return without doing anything.</p>
  9280. </p>
  9281. <h3 id="external-secrets.io/v1.OciAuthCredentials">OciAuthCredentials
  9282. </h3>
  9283. <p>
  9284. (<em>Appears on:</em>
  9285. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  9286. </p>
  9287. <p>
  9288. <p>OciAuthCredentials represents the credentials for OCI authentication.</p>
  9289. </p>
  9290. <table>
  9291. <thead>
  9292. <tr>
  9293. <th>Field</th>
  9294. <th>Description</th>
  9295. </tr>
  9296. </thead>
  9297. <tbody>
  9298. <tr>
  9299. <td>
  9300. <code>identityId</code></br>
  9301. <em>
  9302. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9303. External Secrets meta/v1.SecretKeySelector
  9304. </a>
  9305. </em>
  9306. </td>
  9307. <td>
  9308. </td>
  9309. </tr>
  9310. <tr>
  9311. <td>
  9312. <code>privateKey</code></br>
  9313. <em>
  9314. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9315. External Secrets meta/v1.SecretKeySelector
  9316. </a>
  9317. </em>
  9318. </td>
  9319. <td>
  9320. </td>
  9321. </tr>
  9322. <tr>
  9323. <td>
  9324. <code>privateKeyPassphrase</code></br>
  9325. <em>
  9326. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9327. External Secrets meta/v1.SecretKeySelector
  9328. </a>
  9329. </em>
  9330. </td>
  9331. <td>
  9332. <em>(Optional)</em>
  9333. </td>
  9334. </tr>
  9335. <tr>
  9336. <td>
  9337. <code>fingerprint</code></br>
  9338. <em>
  9339. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9340. External Secrets meta/v1.SecretKeySelector
  9341. </a>
  9342. </em>
  9343. </td>
  9344. <td>
  9345. </td>
  9346. </tr>
  9347. <tr>
  9348. <td>
  9349. <code>userId</code></br>
  9350. <em>
  9351. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9352. External Secrets meta/v1.SecretKeySelector
  9353. </a>
  9354. </em>
  9355. </td>
  9356. <td>
  9357. </td>
  9358. </tr>
  9359. <tr>
  9360. <td>
  9361. <code>tenancyId</code></br>
  9362. <em>
  9363. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9364. External Secrets meta/v1.SecretKeySelector
  9365. </a>
  9366. </em>
  9367. </td>
  9368. <td>
  9369. </td>
  9370. </tr>
  9371. <tr>
  9372. <td>
  9373. <code>region</code></br>
  9374. <em>
  9375. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9376. External Secrets meta/v1.SecretKeySelector
  9377. </a>
  9378. </em>
  9379. </td>
  9380. <td>
  9381. </td>
  9382. </tr>
  9383. </tbody>
  9384. </table>
  9385. <h3 id="external-secrets.io/v1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  9386. </h3>
  9387. <p>
  9388. (<em>Appears on:</em>
  9389. <a href="#external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider</a>)
  9390. </p>
  9391. <p>
  9392. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  9393. </p>
  9394. <table>
  9395. <thead>
  9396. <tr>
  9397. <th>Field</th>
  9398. <th>Description</th>
  9399. </tr>
  9400. </thead>
  9401. <tbody>
  9402. <tr>
  9403. <td>
  9404. <code>apiKeyRef</code></br>
  9405. <em>
  9406. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9407. External Secrets meta/v1.SecretKeySelector
  9408. </a>
  9409. </em>
  9410. </td>
  9411. <td>
  9412. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  9413. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  9414. </td>
  9415. </tr>
  9416. <tr>
  9417. <td>
  9418. <code>passcodeRef</code></br>
  9419. <em>
  9420. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9421. External Secrets meta/v1.SecretKeySelector
  9422. </a>
  9423. </em>
  9424. </td>
  9425. <td>
  9426. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  9427. </td>
  9428. </tr>
  9429. </tbody>
  9430. </table>
  9431. <h3 id="external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider
  9432. </h3>
  9433. <p>
  9434. (<em>Appears on:</em>
  9435. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9436. </p>
  9437. <p>
  9438. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  9439. Project and Config are required if not using a Service Token.</p>
  9440. </p>
  9441. <table>
  9442. <thead>
  9443. <tr>
  9444. <th>Field</th>
  9445. <th>Description</th>
  9446. </tr>
  9447. </thead>
  9448. <tbody>
  9449. <tr>
  9450. <td>
  9451. <code>auth</code></br>
  9452. <em>
  9453. <a href="#external-secrets.io/v1.OnboardbaseAuthSecretRef">
  9454. OnboardbaseAuthSecretRef
  9455. </a>
  9456. </em>
  9457. </td>
  9458. <td>
  9459. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  9460. </td>
  9461. </tr>
  9462. <tr>
  9463. <td>
  9464. <code>apiHost</code></br>
  9465. <em>
  9466. string
  9467. </em>
  9468. </td>
  9469. <td>
  9470. <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>
  9471. </td>
  9472. </tr>
  9473. <tr>
  9474. <td>
  9475. <code>project</code></br>
  9476. <em>
  9477. string
  9478. </em>
  9479. </td>
  9480. <td>
  9481. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  9482. </td>
  9483. </tr>
  9484. <tr>
  9485. <td>
  9486. <code>environment</code></br>
  9487. <em>
  9488. string
  9489. </em>
  9490. </td>
  9491. <td>
  9492. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  9493. </td>
  9494. </tr>
  9495. </tbody>
  9496. </table>
  9497. <h3 id="external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth
  9498. </h3>
  9499. <p>
  9500. (<em>Appears on:</em>
  9501. <a href="#external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider</a>)
  9502. </p>
  9503. <p>
  9504. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  9505. </p>
  9506. <table>
  9507. <thead>
  9508. <tr>
  9509. <th>Field</th>
  9510. <th>Description</th>
  9511. </tr>
  9512. </thead>
  9513. <tbody>
  9514. <tr>
  9515. <td>
  9516. <code>secretRef</code></br>
  9517. <em>
  9518. <a href="#external-secrets.io/v1.OnePasswordAuthSecretRef">
  9519. OnePasswordAuthSecretRef
  9520. </a>
  9521. </em>
  9522. </td>
  9523. <td>
  9524. </td>
  9525. </tr>
  9526. </tbody>
  9527. </table>
  9528. <h3 id="external-secrets.io/v1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  9529. </h3>
  9530. <p>
  9531. (<em>Appears on:</em>
  9532. <a href="#external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth</a>)
  9533. </p>
  9534. <p>
  9535. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  9536. </p>
  9537. <table>
  9538. <thead>
  9539. <tr>
  9540. <th>Field</th>
  9541. <th>Description</th>
  9542. </tr>
  9543. </thead>
  9544. <tbody>
  9545. <tr>
  9546. <td>
  9547. <code>connectTokenSecretRef</code></br>
  9548. <em>
  9549. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9550. External Secrets meta/v1.SecretKeySelector
  9551. </a>
  9552. </em>
  9553. </td>
  9554. <td>
  9555. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  9556. </td>
  9557. </tr>
  9558. </tbody>
  9559. </table>
  9560. <h3 id="external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider
  9561. </h3>
  9562. <p>
  9563. (<em>Appears on:</em>
  9564. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9565. </p>
  9566. <p>
  9567. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  9568. </p>
  9569. <table>
  9570. <thead>
  9571. <tr>
  9572. <th>Field</th>
  9573. <th>Description</th>
  9574. </tr>
  9575. </thead>
  9576. <tbody>
  9577. <tr>
  9578. <td>
  9579. <code>auth</code></br>
  9580. <em>
  9581. <a href="#external-secrets.io/v1.OnePasswordAuth">
  9582. OnePasswordAuth
  9583. </a>
  9584. </em>
  9585. </td>
  9586. <td>
  9587. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  9588. </td>
  9589. </tr>
  9590. <tr>
  9591. <td>
  9592. <code>connectHost</code></br>
  9593. <em>
  9594. string
  9595. </em>
  9596. </td>
  9597. <td>
  9598. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  9599. </td>
  9600. </tr>
  9601. <tr>
  9602. <td>
  9603. <code>vaults</code></br>
  9604. <em>
  9605. map[string]int
  9606. </em>
  9607. </td>
  9608. <td>
  9609. <p>Vaults defines which OnePassword vaults to search in which order</p>
  9610. </td>
  9611. </tr>
  9612. </tbody>
  9613. </table>
  9614. <h3 id="external-secrets.io/v1.OnePasswordSDKAuth">OnePasswordSDKAuth
  9615. </h3>
  9616. <p>
  9617. (<em>Appears on:</em>
  9618. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  9619. </p>
  9620. <p>
  9621. <p>OnePasswordSDKAuth contains a secretRef for the service account token.</p>
  9622. </p>
  9623. <table>
  9624. <thead>
  9625. <tr>
  9626. <th>Field</th>
  9627. <th>Description</th>
  9628. </tr>
  9629. </thead>
  9630. <tbody>
  9631. <tr>
  9632. <td>
  9633. <code>serviceAccountSecretRef</code></br>
  9634. <em>
  9635. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9636. External Secrets meta/v1.SecretKeySelector
  9637. </a>
  9638. </em>
  9639. </td>
  9640. <td>
  9641. <p>ServiceAccountSecretRef points to the secret containing the token to access 1Password vault.</p>
  9642. </td>
  9643. </tr>
  9644. </tbody>
  9645. </table>
  9646. <h3 id="external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider
  9647. </h3>
  9648. <p>
  9649. (<em>Appears on:</em>
  9650. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9651. </p>
  9652. <p>
  9653. <p>OnePasswordSDKProvider configures a store to sync secrets using the 1Password sdk.</p>
  9654. </p>
  9655. <table>
  9656. <thead>
  9657. <tr>
  9658. <th>Field</th>
  9659. <th>Description</th>
  9660. </tr>
  9661. </thead>
  9662. <tbody>
  9663. <tr>
  9664. <td>
  9665. <code>vault</code></br>
  9666. <em>
  9667. string
  9668. </em>
  9669. </td>
  9670. <td>
  9671. <p>Vault defines the vault&rsquo;s name or uuid to access. Do NOT add op:// prefix. This will be done automatically.</p>
  9672. </td>
  9673. </tr>
  9674. <tr>
  9675. <td>
  9676. <code>integrationInfo</code></br>
  9677. <em>
  9678. <a href="#external-secrets.io/v1.IntegrationInfo">
  9679. IntegrationInfo
  9680. </a>
  9681. </em>
  9682. </td>
  9683. <td>
  9684. <em>(Optional)</em>
  9685. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.
  9686. If you don&rsquo;t know which name and version to use, use <code>DefaultIntegrationName</code> and <code>DefaultIntegrationVersion</code>, respectively.</p>
  9687. </td>
  9688. </tr>
  9689. <tr>
  9690. <td>
  9691. <code>auth</code></br>
  9692. <em>
  9693. <a href="#external-secrets.io/v1.OnePasswordSDKAuth">
  9694. OnePasswordSDKAuth
  9695. </a>
  9696. </em>
  9697. </td>
  9698. <td>
  9699. <p>Auth defines the information necessary to authenticate against OnePassword API.</p>
  9700. </td>
  9701. </tr>
  9702. <tr>
  9703. <td>
  9704. <code>cache</code></br>
  9705. <em>
  9706. <a href="#external-secrets.io/v1.CacheConfig">
  9707. CacheConfig
  9708. </a>
  9709. </em>
  9710. </td>
  9711. <td>
  9712. <em>(Optional)</em>
  9713. <p>Cache configures client-side caching for read operations (GetSecret, GetSecretMap).
  9714. When enabled, secrets are cached with the specified TTL.
  9715. Write operations (PushSecret, DeleteSecret) automatically invalidate relevant cache entries.
  9716. If omitted, caching is disabled (default).
  9717. cache: {} is a valid option to set.</p>
  9718. </td>
  9719. </tr>
  9720. </tbody>
  9721. </table>
  9722. <h3 id="external-secrets.io/v1.OpenBaoAppRole">OpenBaoAppRole
  9723. </h3>
  9724. <p>
  9725. (<em>Appears on:</em>
  9726. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  9727. </p>
  9728. <p>
  9729. <p>OpenBaoAppRole authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/approle/">App Role auth
  9730. mechanism</a>, with the role and secret stored in a Kubernetes Secret resource.
  9731. The role ID has to be specified either inline via <code>roleId</code> or by referencing
  9732. a secret via <code>roleRef</code>.</p>
  9733. </p>
  9734. <table>
  9735. <thead>
  9736. <tr>
  9737. <th>Field</th>
  9738. <th>Description</th>
  9739. </tr>
  9740. </thead>
  9741. <tbody>
  9742. <tr>
  9743. <td>
  9744. <code>path</code></br>
  9745. <em>
  9746. string
  9747. </em>
  9748. </td>
  9749. <td>
  9750. <p>Path where the App Role authentication backend is mounted
  9751. in OpenBao, e.g: &ldquo;approle&rdquo;</p>
  9752. </td>
  9753. </tr>
  9754. <tr>
  9755. <td>
  9756. <code>roleId</code></br>
  9757. <em>
  9758. string
  9759. </em>
  9760. </td>
  9761. <td>
  9762. <em>(Optional)</em>
  9763. <p>RoleID configured in the App Role authentication backend when setting
  9764. up the authentication backend in OpenBao.</p>
  9765. </td>
  9766. </tr>
  9767. <tr>
  9768. <td>
  9769. <code>roleRef</code></br>
  9770. <em>
  9771. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9772. External Secrets meta/v1.SecretKeySelector
  9773. </a>
  9774. </em>
  9775. </td>
  9776. <td>
  9777. <em>(Optional)</em>
  9778. <p>Reference to a key in a Secret that contains the App Role ID used
  9779. to authenticate with OpenBao.
  9780. The <code>key</code> field must be specified and denotes which entry within the Secret
  9781. resource is used as the app role id.</p>
  9782. </td>
  9783. </tr>
  9784. <tr>
  9785. <td>
  9786. <code>secretRef</code></br>
  9787. <em>
  9788. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9789. External Secrets meta/v1.SecretKeySelector
  9790. </a>
  9791. </em>
  9792. </td>
  9793. <td>
  9794. <p>Reference to a key in a Secret that contains the App Role secret used
  9795. to authenticate with OpenBao.
  9796. The <code>key</code> field must be specified and denotes which entry within the Secret
  9797. resource is used as the app role secret.</p>
  9798. </td>
  9799. </tr>
  9800. </tbody>
  9801. </table>
  9802. <h3 id="external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth
  9803. </h3>
  9804. <p>
  9805. (<em>Appears on:</em>
  9806. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>)
  9807. </p>
  9808. <p>
  9809. <p>OpenBaoAuth is the configuration used to authenticate with an OpenBao server.
  9810. Currently the following authentication methods are supported: <a href="https://openbao.org/docs/auth/approle/">AppRole</a>,
  9811. <a href="https://openbao.org/docs/auth/token/">Token</a> and <a href="https://openbao.org/docs/auth/userpass/">UserPass</a></p>
  9812. <p>Additional authentication methods are planned for future releases.</p>
  9813. </p>
  9814. <table>
  9815. <thead>
  9816. <tr>
  9817. <th>Field</th>
  9818. <th>Description</th>
  9819. </tr>
  9820. </thead>
  9821. <tbody>
  9822. <tr>
  9823. <td>
  9824. <code>appRole</code></br>
  9825. <em>
  9826. <a href="#external-secrets.io/v1.OpenBaoAppRole">
  9827. OpenBaoAppRole
  9828. </a>
  9829. </em>
  9830. </td>
  9831. <td>
  9832. <em>(Optional)</em>
  9833. <p>AppRole authenticates with OpenBao using the <a href="https://openbao.org/docs/auth/approle/">App Role auth mechanism</a>,
  9834. with the role and secret stored in a Kubernetes Secret resource.</p>
  9835. </td>
  9836. </tr>
  9837. <tr>
  9838. <td>
  9839. <code>namespace</code></br>
  9840. <em>
  9841. string
  9842. </em>
  9843. </td>
  9844. <td>
  9845. <em>(Optional)</em>
  9846. <p>Name of the <a href="https://openbao.org/docs/concepts/namespaces/">OpenBao Namespace</a> to authenticate to. This can be different
  9847. than the namespace your secret is in. Namespaces is a set of features
  9848. within OpenBao that allows OpenBao environments to support secure
  9849. multi-tenancy. e.g: &ldquo;ns1&rdquo;. This will default to OpenBao.Namespace field
  9850. if set, or empty otherwise</p>
  9851. </td>
  9852. </tr>
  9853. <tr>
  9854. <td>
  9855. <code>tokenSecretRef</code></br>
  9856. <em>
  9857. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9858. External Secrets meta/v1.SecretKeySelector
  9859. </a>
  9860. </em>
  9861. </td>
  9862. <td>
  9863. <em>(Optional)</em>
  9864. <p>TokenSecretRef authenticates with OpenBao by presenting a token.</p>
  9865. </td>
  9866. </tr>
  9867. <tr>
  9868. <td>
  9869. <code>userPass</code></br>
  9870. <em>
  9871. <a href="#external-secrets.io/v1.OpenBaoUserPassAuth">
  9872. OpenBaoUserPassAuth
  9873. </a>
  9874. </em>
  9875. </td>
  9876. <td>
  9877. <em>(Optional)</em>
  9878. <p>UserPass authenticates with OpenBao by passing a username/password pair</p>
  9879. </td>
  9880. </tr>
  9881. </tbody>
  9882. </table>
  9883. <h3 id="external-secrets.io/v1.OpenBaoKVStoreVersion">OpenBaoKVStoreVersion
  9884. (<code>string</code> alias)</p></h3>
  9885. <p>
  9886. (<em>Appears on:</em>
  9887. <a href="#external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider</a>)
  9888. </p>
  9889. <p>
  9890. <p>OpenBaoKVStoreVersion represents the version of the OpenBao KV secret engine.</p>
  9891. </p>
  9892. <table>
  9893. <thead>
  9894. <tr>
  9895. <th>Value</th>
  9896. <th>Description</th>
  9897. </tr>
  9898. </thead>
  9899. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  9900. <td></td>
  9901. </tr><tr><td><p>&#34;v2&#34;</p></td>
  9902. <td></td>
  9903. </tr></tbody>
  9904. </table>
  9905. <h3 id="external-secrets.io/v1.OpenBaoProvider">OpenBaoProvider
  9906. </h3>
  9907. <p>
  9908. (<em>Appears on:</em>
  9909. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9910. </p>
  9911. <p>
  9912. <p>OpenBaoProvider configures a store to sync secrets using an OpenBao KV backend.</p>
  9913. </p>
  9914. <table>
  9915. <thead>
  9916. <tr>
  9917. <th>Field</th>
  9918. <th>Description</th>
  9919. </tr>
  9920. </thead>
  9921. <tbody>
  9922. <tr>
  9923. <td>
  9924. <code>auth</code></br>
  9925. <em>
  9926. <a href="#external-secrets.io/v1.OpenBaoAuth">
  9927. OpenBaoAuth
  9928. </a>
  9929. </em>
  9930. </td>
  9931. <td>
  9932. <em>(Optional)</em>
  9933. <p>Auth configures how secret-manager authenticates with the OpenBao server.</p>
  9934. </td>
  9935. </tr>
  9936. <tr>
  9937. <td>
  9938. <code>caBundle</code></br>
  9939. <em>
  9940. []byte
  9941. </em>
  9942. </td>
  9943. <td>
  9944. <em>(Optional)</em>
  9945. <p>PEM encoded CA bundle used to validate the OpenBao server certificate. If
  9946. this and <code>caProvider</code> are not set the system root certificates are used
  9947. to validate the TLS connection.</p>
  9948. </td>
  9949. </tr>
  9950. <tr>
  9951. <td>
  9952. <code>caProvider</code></br>
  9953. <em>
  9954. <a href="#external-secrets.io/v1.CAProvider">
  9955. CAProvider
  9956. </a>
  9957. </em>
  9958. </td>
  9959. <td>
  9960. <em>(Optional)</em>
  9961. <p>The provider for the CA bundle to use to validate OpenBao server
  9962. certificate. If this and <code>caBundle</code> are not set the system root
  9963. certificates are used to validate the TLS connection.</p>
  9964. </td>
  9965. </tr>
  9966. <tr>
  9967. <td>
  9968. <code>namespace</code></br>
  9969. <em>
  9970. string
  9971. </em>
  9972. </td>
  9973. <td>
  9974. <em>(Optional)</em>
  9975. <p>Name of the <a href="https://openbao.org/docs/concepts/namespaces/">OpenBao Namespace</a>. Namespaces is a set of features within
  9976. OpenBao that allows OpenBao environments to support secure multi-tenancy.
  9977. e.g: &ldquo;ns1&rdquo;.</p>
  9978. </td>
  9979. </tr>
  9980. <tr>
  9981. <td>
  9982. <code>server</code></br>
  9983. <em>
  9984. string
  9985. </em>
  9986. </td>
  9987. <td>
  9988. <p>Server is the connection address for the OpenBao server, e.g: <code>https://openbao.example.com:8200</code>.</p>
  9989. </td>
  9990. </tr>
  9991. <tr>
  9992. <td>
  9993. <code>path</code></br>
  9994. <em>
  9995. string
  9996. </em>
  9997. </td>
  9998. <td>
  9999. <em>(Optional)</em>
  10000. <p>Path is the mount path of the OpenBao KV backend endpoint, e.g:
  10001. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  10002. for fetching secrets from OpenBao is optional and will be appended
  10003. if not present in specified path.</p>
  10004. </td>
  10005. </tr>
  10006. <tr>
  10007. <td>
  10008. <code>version</code></br>
  10009. <em>
  10010. <a href="#external-secrets.io/v1.OpenBaoKVStoreVersion">
  10011. OpenBaoKVStoreVersion
  10012. </a>
  10013. </em>
  10014. </td>
  10015. <td>
  10016. <p>Version is the OpenBao KV secret engine version. This can be either &ldquo;v1&rdquo; or
  10017. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  10018. </td>
  10019. </tr>
  10020. </tbody>
  10021. </table>
  10022. <h3 id="external-secrets.io/v1.OpenBaoUserPassAuth">OpenBaoUserPassAuth
  10023. </h3>
  10024. <p>
  10025. (<em>Appears on:</em>
  10026. <a href="#external-secrets.io/v1.OpenBaoAuth">OpenBaoAuth</a>)
  10027. </p>
  10028. <p>
  10029. <p>OpenBaoUserPassAuth authenticates with OpenBao using <a href="https://openbao.org/docs/auth/userpass/">UserPass authentication
  10030. method</a>, with the username and password stored in a Kubernetes Secret
  10031. resource.</p>
  10032. </p>
  10033. <table>
  10034. <thead>
  10035. <tr>
  10036. <th>Field</th>
  10037. <th>Description</th>
  10038. </tr>
  10039. </thead>
  10040. <tbody>
  10041. <tr>
  10042. <td>
  10043. <code>path</code></br>
  10044. <em>
  10045. string
  10046. </em>
  10047. </td>
  10048. <td>
  10049. <p>Path where the UserPassword authentication backend is mounted
  10050. in OpenBao, e.g: &ldquo;userpass&rdquo;</p>
  10051. </td>
  10052. </tr>
  10053. <tr>
  10054. <td>
  10055. <code>username</code></br>
  10056. <em>
  10057. string
  10058. </em>
  10059. </td>
  10060. <td>
  10061. <p>Username is a username used to authenticate using the <a href="https://openbao.org/docs/auth/userpass/">UserPass
  10062. authentication method</a></p>
  10063. </td>
  10064. </tr>
  10065. <tr>
  10066. <td>
  10067. <code>secretRef</code></br>
  10068. <em>
  10069. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10070. External Secrets meta/v1.SecretKeySelector
  10071. </a>
  10072. </em>
  10073. </td>
  10074. <td>
  10075. <p>SecretRef to a key in a Secret resource containing password for the user
  10076. used to authenticate with OpenBao using the <a href="https://openbao.org/docs/auth/userpass/">UserPass authentication
  10077. method</a></p>
  10078. </td>
  10079. </tr>
  10080. </tbody>
  10081. </table>
  10082. <h3 id="external-secrets.io/v1.OracleAuth">OracleAuth
  10083. </h3>
  10084. <p>
  10085. (<em>Appears on:</em>
  10086. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  10087. </p>
  10088. <p>
  10089. <p>OracleAuth defines the authentication method for the Oracle Vault provider.</p>
  10090. </p>
  10091. <table>
  10092. <thead>
  10093. <tr>
  10094. <th>Field</th>
  10095. <th>Description</th>
  10096. </tr>
  10097. </thead>
  10098. <tbody>
  10099. <tr>
  10100. <td>
  10101. <code>tenancy</code></br>
  10102. <em>
  10103. string
  10104. </em>
  10105. </td>
  10106. <td>
  10107. <p>Tenancy is the tenancy OCID where user is located.</p>
  10108. </td>
  10109. </tr>
  10110. <tr>
  10111. <td>
  10112. <code>user</code></br>
  10113. <em>
  10114. string
  10115. </em>
  10116. </td>
  10117. <td>
  10118. <p>User is an access OCID specific to the account.</p>
  10119. </td>
  10120. </tr>
  10121. <tr>
  10122. <td>
  10123. <code>secretRef</code></br>
  10124. <em>
  10125. <a href="#external-secrets.io/v1.OracleSecretRef">
  10126. OracleSecretRef
  10127. </a>
  10128. </em>
  10129. </td>
  10130. <td>
  10131. <p>SecretRef to pass through sensitive information.</p>
  10132. </td>
  10133. </tr>
  10134. </tbody>
  10135. </table>
  10136. <h3 id="external-secrets.io/v1.OraclePrincipalType">OraclePrincipalType
  10137. (<code>string</code> alias)</p></h3>
  10138. <p>
  10139. (<em>Appears on:</em>
  10140. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  10141. </p>
  10142. <p>
  10143. <p>OraclePrincipalType defines the type of principal used for authentication with Oracle Vault.</p>
  10144. </p>
  10145. <table>
  10146. <thead>
  10147. <tr>
  10148. <th>Value</th>
  10149. <th>Description</th>
  10150. </tr>
  10151. </thead>
  10152. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  10153. <td><p>InstancePrincipal represents a instance principal.</p>
  10154. </td>
  10155. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  10156. <td><p>UserPrincipal represents a user principal.</p>
  10157. </td>
  10158. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  10159. <td><p>WorkloadPrincipal represents a workload principal.</p>
  10160. </td>
  10161. </tr></tbody>
  10162. </table>
  10163. <h3 id="external-secrets.io/v1.OracleProvider">OracleProvider
  10164. </h3>
  10165. <p>
  10166. (<em>Appears on:</em>
  10167. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10168. </p>
  10169. <p>
  10170. <p>OracleProvider configures a store to sync secrets using an Oracle Vault
  10171. backend.</p>
  10172. </p>
  10173. <table>
  10174. <thead>
  10175. <tr>
  10176. <th>Field</th>
  10177. <th>Description</th>
  10178. </tr>
  10179. </thead>
  10180. <tbody>
  10181. <tr>
  10182. <td>
  10183. <code>region</code></br>
  10184. <em>
  10185. string
  10186. </em>
  10187. </td>
  10188. <td>
  10189. <p>Region is the region where vault is located.</p>
  10190. </td>
  10191. </tr>
  10192. <tr>
  10193. <td>
  10194. <code>vault</code></br>
  10195. <em>
  10196. string
  10197. </em>
  10198. </td>
  10199. <td>
  10200. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  10201. </td>
  10202. </tr>
  10203. <tr>
  10204. <td>
  10205. <code>compartment</code></br>
  10206. <em>
  10207. string
  10208. </em>
  10209. </td>
  10210. <td>
  10211. <em>(Optional)</em>
  10212. <p>Compartment is the vault compartment OCID.
  10213. Required for PushSecret</p>
  10214. </td>
  10215. </tr>
  10216. <tr>
  10217. <td>
  10218. <code>encryptionKey</code></br>
  10219. <em>
  10220. string
  10221. </em>
  10222. </td>
  10223. <td>
  10224. <em>(Optional)</em>
  10225. <p>EncryptionKey is the OCID of the encryption key within the vault.
  10226. Required for PushSecret</p>
  10227. </td>
  10228. </tr>
  10229. <tr>
  10230. <td>
  10231. <code>principalType</code></br>
  10232. <em>
  10233. <a href="#external-secrets.io/v1.OraclePrincipalType">
  10234. OraclePrincipalType
  10235. </a>
  10236. </em>
  10237. </td>
  10238. <td>
  10239. <em>(Optional)</em>
  10240. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  10241. determine the principal type. This optional field must be specified if using
  10242. workload identity.</p>
  10243. </td>
  10244. </tr>
  10245. <tr>
  10246. <td>
  10247. <code>auth</code></br>
  10248. <em>
  10249. <a href="#external-secrets.io/v1.OracleAuth">
  10250. OracleAuth
  10251. </a>
  10252. </em>
  10253. </td>
  10254. <td>
  10255. <em>(Optional)</em>
  10256. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  10257. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  10258. </td>
  10259. </tr>
  10260. <tr>
  10261. <td>
  10262. <code>serviceAccountRef</code></br>
  10263. <em>
  10264. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  10265. External Secrets meta/v1.ServiceAccountSelector
  10266. </a>
  10267. </em>
  10268. </td>
  10269. <td>
  10270. <em>(Optional)</em>
  10271. <p>ServiceAccountRef specified the service account
  10272. that should be used when authenticating with WorkloadIdentity.</p>
  10273. </td>
  10274. </tr>
  10275. </tbody>
  10276. </table>
  10277. <h3 id="external-secrets.io/v1.OracleSecretRef">OracleSecretRef
  10278. </h3>
  10279. <p>
  10280. (<em>Appears on:</em>
  10281. <a href="#external-secrets.io/v1.OracleAuth">OracleAuth</a>)
  10282. </p>
  10283. <p>
  10284. <p>OracleSecretRef contains the secret reference for Oracle Vault authentication credentials.</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>privatekey</code></br>
  10297. <em>
  10298. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10299. External Secrets meta/v1.SecretKeySelector
  10300. </a>
  10301. </em>
  10302. </td>
  10303. <td>
  10304. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  10305. </td>
  10306. </tr>
  10307. <tr>
  10308. <td>
  10309. <code>fingerprint</code></br>
  10310. <em>
  10311. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10312. External Secrets meta/v1.SecretKeySelector
  10313. </a>
  10314. </em>
  10315. </td>
  10316. <td>
  10317. <p>Fingerprint is the fingerprint of the API private key.</p>
  10318. </td>
  10319. </tr>
  10320. </tbody>
  10321. </table>
  10322. <h3 id="external-secrets.io/v1.OvhAuth">OvhAuth
  10323. </h3>
  10324. <p>
  10325. (<em>Appears on:</em>
  10326. <a href="#external-secrets.io/v1.OvhProvider">OvhProvider</a>)
  10327. </p>
  10328. <p>
  10329. <p>OvhAuth tells the controller how to authenticate to OVHcloud&rsquo;s Secret Manager, either using mTLS or a token.</p>
  10330. </p>
  10331. <table>
  10332. <thead>
  10333. <tr>
  10334. <th>Field</th>
  10335. <th>Description</th>
  10336. </tr>
  10337. </thead>
  10338. <tbody>
  10339. <tr>
  10340. <td>
  10341. <code>mtls</code></br>
  10342. <em>
  10343. <a href="#external-secrets.io/v1.OvhClientMTLS">
  10344. OvhClientMTLS
  10345. </a>
  10346. </em>
  10347. </td>
  10348. <td>
  10349. <em>(Optional)</em>
  10350. </td>
  10351. </tr>
  10352. <tr>
  10353. <td>
  10354. <code>token</code></br>
  10355. <em>
  10356. <a href="#external-secrets.io/v1.OvhClientToken">
  10357. OvhClientToken
  10358. </a>
  10359. </em>
  10360. </td>
  10361. <td>
  10362. <em>(Optional)</em>
  10363. </td>
  10364. </tr>
  10365. </tbody>
  10366. </table>
  10367. <h3 id="external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS
  10368. </h3>
  10369. <p>
  10370. (<em>Appears on:</em>
  10371. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  10372. </p>
  10373. <p>
  10374. <p>OvhClientMTLS defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using mTLS.</p>
  10375. </p>
  10376. <table>
  10377. <thead>
  10378. <tr>
  10379. <th>Field</th>
  10380. <th>Description</th>
  10381. </tr>
  10382. </thead>
  10383. <tbody>
  10384. <tr>
  10385. <td>
  10386. <code>certSecretRef</code></br>
  10387. <em>
  10388. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10389. External Secrets meta/v1.SecretKeySelector
  10390. </a>
  10391. </em>
  10392. </td>
  10393. <td>
  10394. </td>
  10395. </tr>
  10396. <tr>
  10397. <td>
  10398. <code>keySecretRef</code></br>
  10399. <em>
  10400. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10401. External Secrets meta/v1.SecretKeySelector
  10402. </a>
  10403. </em>
  10404. </td>
  10405. <td>
  10406. </td>
  10407. </tr>
  10408. <tr>
  10409. <td>
  10410. <code>caBundle</code></br>
  10411. <em>
  10412. []byte
  10413. </em>
  10414. </td>
  10415. <td>
  10416. <em>(Optional)</em>
  10417. </td>
  10418. </tr>
  10419. <tr>
  10420. <td>
  10421. <code>caProvider</code></br>
  10422. <em>
  10423. <a href="#external-secrets.io/v1.CAProvider">
  10424. CAProvider
  10425. </a>
  10426. </em>
  10427. </td>
  10428. <td>
  10429. <em>(Optional)</em>
  10430. </td>
  10431. </tr>
  10432. </tbody>
  10433. </table>
  10434. <h3 id="external-secrets.io/v1.OvhClientToken">OvhClientToken
  10435. </h3>
  10436. <p>
  10437. (<em>Appears on:</em>
  10438. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  10439. </p>
  10440. <p>
  10441. <p>OvhClientToken defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using a token.</p>
  10442. </p>
  10443. <table>
  10444. <thead>
  10445. <tr>
  10446. <th>Field</th>
  10447. <th>Description</th>
  10448. </tr>
  10449. </thead>
  10450. <tbody>
  10451. <tr>
  10452. <td>
  10453. <code>tokenSecretRef</code></br>
  10454. <em>
  10455. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10456. External Secrets meta/v1.SecretKeySelector
  10457. </a>
  10458. </em>
  10459. </td>
  10460. <td>
  10461. </td>
  10462. </tr>
  10463. </tbody>
  10464. </table>
  10465. <h3 id="external-secrets.io/v1.OvhProvider">OvhProvider
  10466. </h3>
  10467. <p>
  10468. (<em>Appears on:</em>
  10469. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10470. </p>
  10471. <p>
  10472. <p>OvhProvider holds the configuration to synchronize secrets with OVHcloud&rsquo;s Secret Manager.</p>
  10473. </p>
  10474. <table>
  10475. <thead>
  10476. <tr>
  10477. <th>Field</th>
  10478. <th>Description</th>
  10479. </tr>
  10480. </thead>
  10481. <tbody>
  10482. <tr>
  10483. <td>
  10484. <code>server</code></br>
  10485. <em>
  10486. string
  10487. </em>
  10488. </td>
  10489. <td>
  10490. <p>specifies the OKMS server endpoint.</p>
  10491. </td>
  10492. </tr>
  10493. <tr>
  10494. <td>
  10495. <code>okmsid</code></br>
  10496. <em>
  10497. string
  10498. </em>
  10499. </td>
  10500. <td>
  10501. <p>specifies the OKMS ID.</p>
  10502. </td>
  10503. </tr>
  10504. <tr>
  10505. <td>
  10506. <code>casRequired</code></br>
  10507. <em>
  10508. bool
  10509. </em>
  10510. </td>
  10511. <td>
  10512. <em>(Optional)</em>
  10513. <p>Enables or disables check-and-set (CAS) (default: false).</p>
  10514. </td>
  10515. </tr>
  10516. <tr>
  10517. <td>
  10518. <code>okmsTimeout</code></br>
  10519. <em>
  10520. uint32
  10521. </em>
  10522. </td>
  10523. <td>
  10524. <em>(Optional)</em>
  10525. <p>Setup a timeout in seconds when requests to the KMS are made (default: 30).</p>
  10526. </td>
  10527. </tr>
  10528. <tr>
  10529. <td>
  10530. <code>auth</code></br>
  10531. <em>
  10532. <a href="#external-secrets.io/v1.OvhAuth">
  10533. OvhAuth
  10534. </a>
  10535. </em>
  10536. </td>
  10537. <td>
  10538. <p>Authentication method (mtls or token).</p>
  10539. </td>
  10540. </tr>
  10541. </tbody>
  10542. </table>
  10543. <h3 id="external-secrets.io/v1.PassboltAuth">PassboltAuth
  10544. </h3>
  10545. <p>
  10546. (<em>Appears on:</em>
  10547. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>)
  10548. </p>
  10549. <p>
  10550. <p>PassboltAuth contains a secretRef for the passbolt credentials.</p>
  10551. </p>
  10552. <table>
  10553. <thead>
  10554. <tr>
  10555. <th>Field</th>
  10556. <th>Description</th>
  10557. </tr>
  10558. </thead>
  10559. <tbody>
  10560. <tr>
  10561. <td>
  10562. <code>passwordSecretRef</code></br>
  10563. <em>
  10564. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10565. External Secrets meta/v1.SecretKeySelector
  10566. </a>
  10567. </em>
  10568. </td>
  10569. <td>
  10570. </td>
  10571. </tr>
  10572. <tr>
  10573. <td>
  10574. <code>privateKeySecretRef</code></br>
  10575. <em>
  10576. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10577. External Secrets meta/v1.SecretKeySelector
  10578. </a>
  10579. </em>
  10580. </td>
  10581. <td>
  10582. </td>
  10583. </tr>
  10584. </tbody>
  10585. </table>
  10586. <h3 id="external-secrets.io/v1.PassboltProvider">PassboltProvider
  10587. </h3>
  10588. <p>
  10589. (<em>Appears on:</em>
  10590. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10591. </p>
  10592. <p>
  10593. <p>PassboltProvider provides access to Passbolt secrets manager.
  10594. See: <a href="https://www.passbolt.com">https://www.passbolt.com</a>.</p>
  10595. </p>
  10596. <table>
  10597. <thead>
  10598. <tr>
  10599. <th>Field</th>
  10600. <th>Description</th>
  10601. </tr>
  10602. </thead>
  10603. <tbody>
  10604. <tr>
  10605. <td>
  10606. <code>auth</code></br>
  10607. <em>
  10608. <a href="#external-secrets.io/v1.PassboltAuth">
  10609. PassboltAuth
  10610. </a>
  10611. </em>
  10612. </td>
  10613. <td>
  10614. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  10615. </td>
  10616. </tr>
  10617. <tr>
  10618. <td>
  10619. <code>host</code></br>
  10620. <em>
  10621. string
  10622. </em>
  10623. </td>
  10624. <td>
  10625. <p>Host defines the Passbolt Server to connect to</p>
  10626. </td>
  10627. </tr>
  10628. <tr>
  10629. <td>
  10630. <code>caBundle</code></br>
  10631. <em>
  10632. []byte
  10633. </em>
  10634. </td>
  10635. <td>
  10636. <em>(Optional)</em>
  10637. <p>PEM encoded CA bundle used to validate Passbolt server certificate. Only used
  10638. if the Host URL is using HTTPS protocol. If not set the system root certificates
  10639. are used to validate the TLS connection.</p>
  10640. </td>
  10641. </tr>
  10642. <tr>
  10643. <td>
  10644. <code>caProvider</code></br>
  10645. <em>
  10646. <a href="#external-secrets.io/v1.CAProvider">
  10647. CAProvider
  10648. </a>
  10649. </em>
  10650. </td>
  10651. <td>
  10652. <em>(Optional)</em>
  10653. <p>The provider for the CA bundle to use to validate Passbolt server certificate.</p>
  10654. </td>
  10655. </tr>
  10656. </tbody>
  10657. </table>
  10658. <h3 id="external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth
  10659. </h3>
  10660. <p>
  10661. (<em>Appears on:</em>
  10662. <a href="#external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider</a>)
  10663. </p>
  10664. <p>
  10665. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  10666. </p>
  10667. <table>
  10668. <thead>
  10669. <tr>
  10670. <th>Field</th>
  10671. <th>Description</th>
  10672. </tr>
  10673. </thead>
  10674. <tbody>
  10675. <tr>
  10676. <td>
  10677. <code>secretRef</code></br>
  10678. <em>
  10679. <a href="#external-secrets.io/v1.PasswordDepotSecretRef">
  10680. PasswordDepotSecretRef
  10681. </a>
  10682. </em>
  10683. </td>
  10684. <td>
  10685. </td>
  10686. </tr>
  10687. </tbody>
  10688. </table>
  10689. <h3 id="external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider
  10690. </h3>
  10691. <p>
  10692. (<em>Appears on:</em>
  10693. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10694. </p>
  10695. <p>
  10696. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  10697. </p>
  10698. <table>
  10699. <thead>
  10700. <tr>
  10701. <th>Field</th>
  10702. <th>Description</th>
  10703. </tr>
  10704. </thead>
  10705. <tbody>
  10706. <tr>
  10707. <td>
  10708. <code>host</code></br>
  10709. <em>
  10710. string
  10711. </em>
  10712. </td>
  10713. <td>
  10714. <p>URL configures the Password Depot instance URL.</p>
  10715. </td>
  10716. </tr>
  10717. <tr>
  10718. <td>
  10719. <code>database</code></br>
  10720. <em>
  10721. string
  10722. </em>
  10723. </td>
  10724. <td>
  10725. <p>Database to use as source</p>
  10726. </td>
  10727. </tr>
  10728. <tr>
  10729. <td>
  10730. <code>auth</code></br>
  10731. <em>
  10732. <a href="#external-secrets.io/v1.PasswordDepotAuth">
  10733. PasswordDepotAuth
  10734. </a>
  10735. </em>
  10736. </td>
  10737. <td>
  10738. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  10739. </td>
  10740. </tr>
  10741. </tbody>
  10742. </table>
  10743. <h3 id="external-secrets.io/v1.PasswordDepotSecretRef">PasswordDepotSecretRef
  10744. </h3>
  10745. <p>
  10746. (<em>Appears on:</em>
  10747. <a href="#external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth</a>)
  10748. </p>
  10749. <p>
  10750. <p>PasswordDepotSecretRef contains the secret reference for Password Depot authentication.</p>
  10751. </p>
  10752. <table>
  10753. <thead>
  10754. <tr>
  10755. <th>Field</th>
  10756. <th>Description</th>
  10757. </tr>
  10758. </thead>
  10759. <tbody>
  10760. <tr>
  10761. <td>
  10762. <code>credentials</code></br>
  10763. <em>
  10764. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10765. External Secrets meta/v1.SecretKeySelector
  10766. </a>
  10767. </em>
  10768. </td>
  10769. <td>
  10770. <em>(Optional)</em>
  10771. <p>Username / Password is used for authentication.</p>
  10772. </td>
  10773. </tr>
  10774. </tbody>
  10775. </table>
  10776. <h3 id="external-secrets.io/v1.PreviderAuth">PreviderAuth
  10777. </h3>
  10778. <p>
  10779. (<em>Appears on:</em>
  10780. <a href="#external-secrets.io/v1.PreviderProvider">PreviderProvider</a>)
  10781. </p>
  10782. <p>
  10783. <p>PreviderAuth contains a secretRef for credentials.</p>
  10784. </p>
  10785. <table>
  10786. <thead>
  10787. <tr>
  10788. <th>Field</th>
  10789. <th>Description</th>
  10790. </tr>
  10791. </thead>
  10792. <tbody>
  10793. <tr>
  10794. <td>
  10795. <code>secretRef</code></br>
  10796. <em>
  10797. <a href="#external-secrets.io/v1.PreviderAuthSecretRef">
  10798. PreviderAuthSecretRef
  10799. </a>
  10800. </em>
  10801. </td>
  10802. <td>
  10803. <em>(Optional)</em>
  10804. </td>
  10805. </tr>
  10806. </tbody>
  10807. </table>
  10808. <h3 id="external-secrets.io/v1.PreviderAuthSecretRef">PreviderAuthSecretRef
  10809. </h3>
  10810. <p>
  10811. (<em>Appears on:</em>
  10812. <a href="#external-secrets.io/v1.PreviderAuth">PreviderAuth</a>)
  10813. </p>
  10814. <p>
  10815. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  10816. </p>
  10817. <table>
  10818. <thead>
  10819. <tr>
  10820. <th>Field</th>
  10821. <th>Description</th>
  10822. </tr>
  10823. </thead>
  10824. <tbody>
  10825. <tr>
  10826. <td>
  10827. <code>accessToken</code></br>
  10828. <em>
  10829. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10830. External Secrets meta/v1.SecretKeySelector
  10831. </a>
  10832. </em>
  10833. </td>
  10834. <td>
  10835. <p>The AccessToken is used for authentication</p>
  10836. </td>
  10837. </tr>
  10838. </tbody>
  10839. </table>
  10840. <h3 id="external-secrets.io/v1.PreviderProvider">PreviderProvider
  10841. </h3>
  10842. <p>
  10843. (<em>Appears on:</em>
  10844. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10845. </p>
  10846. <p>
  10847. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  10848. </p>
  10849. <table>
  10850. <thead>
  10851. <tr>
  10852. <th>Field</th>
  10853. <th>Description</th>
  10854. </tr>
  10855. </thead>
  10856. <tbody>
  10857. <tr>
  10858. <td>
  10859. <code>auth</code></br>
  10860. <em>
  10861. <a href="#external-secrets.io/v1.PreviderAuth">
  10862. PreviderAuth
  10863. </a>
  10864. </em>
  10865. </td>
  10866. <td>
  10867. </td>
  10868. </tr>
  10869. <tr>
  10870. <td>
  10871. <code>baseUri</code></br>
  10872. <em>
  10873. string
  10874. </em>
  10875. </td>
  10876. <td>
  10877. <em>(Optional)</em>
  10878. </td>
  10879. </tr>
  10880. </tbody>
  10881. </table>
  10882. <h3 id="external-secrets.io/v1.Provider">Provider
  10883. </h3>
  10884. <p>
  10885. <p>Provider is a common interface for interacting with secret backends.</p>
  10886. </p>
  10887. <h3 id="external-secrets.io/v1.PulumiAuth">PulumiAuth
  10888. </h3>
  10889. <p>
  10890. (<em>Appears on:</em>
  10891. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  10892. </p>
  10893. <p>
  10894. <p>PulumiAuth configures authentication with the Pulumi API.
  10895. Exactly one of accessToken or oidcConfig must be specified.</p>
  10896. </p>
  10897. <table>
  10898. <thead>
  10899. <tr>
  10900. <th>Field</th>
  10901. <th>Description</th>
  10902. </tr>
  10903. </thead>
  10904. <tbody>
  10905. <tr>
  10906. <td>
  10907. <code>accessToken</code></br>
  10908. <em>
  10909. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  10910. PulumiProviderSecretRef
  10911. </a>
  10912. </em>
  10913. </td>
  10914. <td>
  10915. <em>(Optional)</em>
  10916. <p>AccessToken authenticates using a Pulumi access token stored in a Kubernetes Secret.</p>
  10917. </td>
  10918. </tr>
  10919. <tr>
  10920. <td>
  10921. <code>oidcConfig</code></br>
  10922. <em>
  10923. <a href="#external-secrets.io/v1.PulumiOIDCAuth">
  10924. PulumiOIDCAuth
  10925. </a>
  10926. </em>
  10927. </td>
  10928. <td>
  10929. <em>(Optional)</em>
  10930. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  10931. </td>
  10932. </tr>
  10933. </tbody>
  10934. </table>
  10935. <h3 id="external-secrets.io/v1.PulumiOIDCAuth">PulumiOIDCAuth
  10936. </h3>
  10937. <p>
  10938. (<em>Appears on:</em>
  10939. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>)
  10940. </p>
  10941. <p>
  10942. <p>PulumiOIDCAuth configures OIDC authentication with Pulumi using Kubernetes ServiceAccount tokens.</p>
  10943. </p>
  10944. <table>
  10945. <thead>
  10946. <tr>
  10947. <th>Field</th>
  10948. <th>Description</th>
  10949. </tr>
  10950. </thead>
  10951. <tbody>
  10952. <tr>
  10953. <td>
  10954. <code>organization</code></br>
  10955. <em>
  10956. string
  10957. </em>
  10958. </td>
  10959. <td>
  10960. <p>Organization is the name of the Pulumi organization configured for OIDC authentication.</p>
  10961. </td>
  10962. </tr>
  10963. <tr>
  10964. <td>
  10965. <code>serviceAccountRef</code></br>
  10966. <em>
  10967. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  10968. External Secrets meta/v1.ServiceAccountSelector
  10969. </a>
  10970. </em>
  10971. </td>
  10972. <td>
  10973. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  10974. </td>
  10975. </tr>
  10976. <tr>
  10977. <td>
  10978. <code>expirationSeconds</code></br>
  10979. <em>
  10980. int64
  10981. </em>
  10982. </td>
  10983. <td>
  10984. <em>(Optional)</em>
  10985. <p>ExpirationSeconds sets the token validity duration for service account and OIDC token.
  10986. Defaults to 10 minutes.</p>
  10987. </td>
  10988. </tr>
  10989. </tbody>
  10990. </table>
  10991. <h3 id="external-secrets.io/v1.PulumiProvider">PulumiProvider
  10992. </h3>
  10993. <p>
  10994. (<em>Appears on:</em>
  10995. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10996. </p>
  10997. <p>
  10998. <p>PulumiProvider defines configuration for accessing secrets from Pulumi ESC.</p>
  10999. </p>
  11000. <table>
  11001. <thead>
  11002. <tr>
  11003. <th>Field</th>
  11004. <th>Description</th>
  11005. </tr>
  11006. </thead>
  11007. <tbody>
  11008. <tr>
  11009. <td>
  11010. <code>apiUrl</code></br>
  11011. <em>
  11012. string
  11013. </em>
  11014. </td>
  11015. <td>
  11016. <p>APIURL is the URL of the Pulumi API.</p>
  11017. </td>
  11018. </tr>
  11019. <tr>
  11020. <td>
  11021. <code>auth</code></br>
  11022. <em>
  11023. <a href="#external-secrets.io/v1.PulumiAuth">
  11024. PulumiAuth
  11025. </a>
  11026. </em>
  11027. </td>
  11028. <td>
  11029. <em>(Optional)</em>
  11030. <p>Auth configures how the Operator authenticates with the Pulumi API.
  11031. Either auth or the deprecated accessToken field must be specified.</p>
  11032. </td>
  11033. </tr>
  11034. <tr>
  11035. <td>
  11036. <code>organization</code></br>
  11037. <em>
  11038. string
  11039. </em>
  11040. </td>
  11041. <td>
  11042. <p>Organization are a space to collaborate on shared projects and stacks.
  11043. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  11044. </td>
  11045. </tr>
  11046. <tr>
  11047. <td>
  11048. <code>project</code></br>
  11049. <em>
  11050. string
  11051. </em>
  11052. </td>
  11053. <td>
  11054. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  11055. </td>
  11056. </tr>
  11057. <tr>
  11058. <td>
  11059. <code>environment</code></br>
  11060. <em>
  11061. string
  11062. </em>
  11063. </td>
  11064. <td>
  11065. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  11066. dynamically retrieved values from supported providers including all major clouds,
  11067. and other Pulumi ESC environments.
  11068. 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>
  11069. </td>
  11070. </tr>
  11071. <tr>
  11072. <td>
  11073. <code>accessToken</code></br>
  11074. <em>
  11075. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  11076. PulumiProviderSecretRef
  11077. </a>
  11078. </em>
  11079. </td>
  11080. <td>
  11081. <em>(Optional)</em>
  11082. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  11083. <p>Deprecated: Use auth.accessToken instead.</p>
  11084. </td>
  11085. </tr>
  11086. </tbody>
  11087. </table>
  11088. <h3 id="external-secrets.io/v1.PulumiProviderSecretRef">PulumiProviderSecretRef
  11089. </h3>
  11090. <p>
  11091. (<em>Appears on:</em>
  11092. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>,
  11093. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  11094. </p>
  11095. <p>
  11096. <p>PulumiProviderSecretRef contains the secret reference for Pulumi authentication.</p>
  11097. </p>
  11098. <table>
  11099. <thead>
  11100. <tr>
  11101. <th>Field</th>
  11102. <th>Description</th>
  11103. </tr>
  11104. </thead>
  11105. <tbody>
  11106. <tr>
  11107. <td>
  11108. <code>secretRef</code></br>
  11109. <em>
  11110. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11111. External Secrets meta/v1.SecretKeySelector
  11112. </a>
  11113. </em>
  11114. </td>
  11115. <td>
  11116. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  11117. </td>
  11118. </tr>
  11119. </tbody>
  11120. </table>
  11121. <h3 id="external-secrets.io/v1.PushSecretData">PushSecretData
  11122. </h3>
  11123. <p>
  11124. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1.</p>
  11125. </p>
  11126. <h3 id="external-secrets.io/v1.PushSecretRemoteRef">PushSecretRemoteRef
  11127. </h3>
  11128. <p>
  11129. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1.</p>
  11130. </p>
  11131. <h3 id="external-secrets.io/v1.ScalewayProvider">ScalewayProvider
  11132. </h3>
  11133. <p>
  11134. (<em>Appears on:</em>
  11135. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11136. </p>
  11137. <p>
  11138. <p>ScalewayProvider defines the configuration for the Scaleway Secret Manager provider.</p>
  11139. </p>
  11140. <table>
  11141. <thead>
  11142. <tr>
  11143. <th>Field</th>
  11144. <th>Description</th>
  11145. </tr>
  11146. </thead>
  11147. <tbody>
  11148. <tr>
  11149. <td>
  11150. <code>apiUrl</code></br>
  11151. <em>
  11152. string
  11153. </em>
  11154. </td>
  11155. <td>
  11156. <em>(Optional)</em>
  11157. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  11158. </td>
  11159. </tr>
  11160. <tr>
  11161. <td>
  11162. <code>region</code></br>
  11163. <em>
  11164. string
  11165. </em>
  11166. </td>
  11167. <td>
  11168. <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>
  11169. </td>
  11170. </tr>
  11171. <tr>
  11172. <td>
  11173. <code>projectId</code></br>
  11174. <em>
  11175. string
  11176. </em>
  11177. </td>
  11178. <td>
  11179. <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>
  11180. </td>
  11181. </tr>
  11182. <tr>
  11183. <td>
  11184. <code>accessKey</code></br>
  11185. <em>
  11186. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  11187. ScalewayProviderSecretRef
  11188. </a>
  11189. </em>
  11190. </td>
  11191. <td>
  11192. <p>AccessKey is the non-secret part of the api key.</p>
  11193. </td>
  11194. </tr>
  11195. <tr>
  11196. <td>
  11197. <code>secretKey</code></br>
  11198. <em>
  11199. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  11200. ScalewayProviderSecretRef
  11201. </a>
  11202. </em>
  11203. </td>
  11204. <td>
  11205. <p>SecretKey is the non-secret part of the api key.</p>
  11206. </td>
  11207. </tr>
  11208. </tbody>
  11209. </table>
  11210. <h3 id="external-secrets.io/v1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  11211. </h3>
  11212. <p>
  11213. (<em>Appears on:</em>
  11214. <a href="#external-secrets.io/v1.ScalewayProvider">ScalewayProvider</a>)
  11215. </p>
  11216. <p>
  11217. <p>ScalewayProviderSecretRef defines the configuration for Scaleway secret references.</p>
  11218. </p>
  11219. <table>
  11220. <thead>
  11221. <tr>
  11222. <th>Field</th>
  11223. <th>Description</th>
  11224. </tr>
  11225. </thead>
  11226. <tbody>
  11227. <tr>
  11228. <td>
  11229. <code>value</code></br>
  11230. <em>
  11231. string
  11232. </em>
  11233. </td>
  11234. <td>
  11235. <em>(Optional)</em>
  11236. <p>Value can be specified directly to set a value without using a secret.</p>
  11237. </td>
  11238. </tr>
  11239. <tr>
  11240. <td>
  11241. <code>secretRef</code></br>
  11242. <em>
  11243. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11244. External Secrets meta/v1.SecretKeySelector
  11245. </a>
  11246. </em>
  11247. </td>
  11248. <td>
  11249. <em>(Optional)</em>
  11250. <p>SecretRef references a key in a secret that will be used as value.</p>
  11251. </td>
  11252. </tr>
  11253. </tbody>
  11254. </table>
  11255. <h3 id="external-secrets.io/v1.SecretReference">SecretReference
  11256. </h3>
  11257. <p>
  11258. (<em>Appears on:</em>
  11259. <a href="#external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig</a>)
  11260. </p>
  11261. <p>
  11262. <p>SecretReference holds the details of a secret.</p>
  11263. </p>
  11264. <table>
  11265. <thead>
  11266. <tr>
  11267. <th>Field</th>
  11268. <th>Description</th>
  11269. </tr>
  11270. </thead>
  11271. <tbody>
  11272. <tr>
  11273. <td>
  11274. <code>name</code></br>
  11275. <em>
  11276. string
  11277. </em>
  11278. </td>
  11279. <td>
  11280. <p>name of the secret.</p>
  11281. </td>
  11282. </tr>
  11283. <tr>
  11284. <td>
  11285. <code>namespace</code></br>
  11286. <em>
  11287. string
  11288. </em>
  11289. </td>
  11290. <td>
  11291. <p>namespace in which the secret exists. If empty, secret will looked up in local namespace.</p>
  11292. </td>
  11293. </tr>
  11294. </tbody>
  11295. </table>
  11296. <h3 id="external-secrets.io/v1.SecretServerProvider">SecretServerProvider
  11297. </h3>
  11298. <p>
  11299. (<em>Appears on:</em>
  11300. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11301. </p>
  11302. <p>
  11303. <p>SecretServerProvider provides access to authenticate to a secrets provider server.
  11304. 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>
  11305. </p>
  11306. <table>
  11307. <thead>
  11308. <tr>
  11309. <th>Field</th>
  11310. <th>Description</th>
  11311. </tr>
  11312. </thead>
  11313. <tbody>
  11314. <tr>
  11315. <td>
  11316. <code>username</code></br>
  11317. <em>
  11318. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11319. SecretServerProviderRef
  11320. </a>
  11321. </em>
  11322. </td>
  11323. <td>
  11324. <p>Username is the secret server account username.</p>
  11325. </td>
  11326. </tr>
  11327. <tr>
  11328. <td>
  11329. <code>password</code></br>
  11330. <em>
  11331. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  11332. SecretServerProviderRef
  11333. </a>
  11334. </em>
  11335. </td>
  11336. <td>
  11337. <p>Password is the secret server account password.</p>
  11338. </td>
  11339. </tr>
  11340. <tr>
  11341. <td>
  11342. <code>domain</code></br>
  11343. <em>
  11344. string
  11345. </em>
  11346. </td>
  11347. <td>
  11348. <em>(Optional)</em>
  11349. <p>Domain is the secret server domain.</p>
  11350. </td>
  11351. </tr>
  11352. <tr>
  11353. <td>
  11354. <code>serverURL</code></br>
  11355. <em>
  11356. string
  11357. </em>
  11358. </td>
  11359. <td>
  11360. <p>ServerURL
  11361. URL to your secret server installation</p>
  11362. </td>
  11363. </tr>
  11364. <tr>
  11365. <td>
  11366. <code>caBundle</code></br>
  11367. <em>
  11368. []byte
  11369. </em>
  11370. </td>
  11371. <td>
  11372. <em>(Optional)</em>
  11373. <p>PEM/base64 encoded CA bundle used to validate Secret ServerURL. Only used
  11374. if the ServerURL URL is using HTTPS protocol. If not set the system root certificates
  11375. are used to validate the TLS connection.</p>
  11376. </td>
  11377. </tr>
  11378. <tr>
  11379. <td>
  11380. <code>caProvider</code></br>
  11381. <em>
  11382. <a href="#external-secrets.io/v1.CAProvider">
  11383. CAProvider
  11384. </a>
  11385. </em>
  11386. </td>
  11387. <td>
  11388. <em>(Optional)</em>
  11389. <p>The provider for the CA bundle to use to validate Secret ServerURL certificate.</p>
  11390. </td>
  11391. </tr>
  11392. </tbody>
  11393. </table>
  11394. <h3 id="external-secrets.io/v1.SecretServerProviderRef">SecretServerProviderRef
  11395. </h3>
  11396. <p>
  11397. (<em>Appears on:</em>
  11398. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>)
  11399. </p>
  11400. <p>
  11401. <p>SecretServerProviderRef references a value that can be specified directly or via a secret
  11402. for a SecretServerProvider.</p>
  11403. </p>
  11404. <table>
  11405. <thead>
  11406. <tr>
  11407. <th>Field</th>
  11408. <th>Description</th>
  11409. </tr>
  11410. </thead>
  11411. <tbody>
  11412. <tr>
  11413. <td>
  11414. <code>value</code></br>
  11415. <em>
  11416. string
  11417. </em>
  11418. </td>
  11419. <td>
  11420. <em>(Optional)</em>
  11421. <p>Value can be specified directly to set a value without using a secret.</p>
  11422. </td>
  11423. </tr>
  11424. <tr>
  11425. <td>
  11426. <code>secretRef</code></br>
  11427. <em>
  11428. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11429. External Secrets meta/v1.SecretKeySelector
  11430. </a>
  11431. </em>
  11432. </td>
  11433. <td>
  11434. <em>(Optional)</em>
  11435. <p>SecretRef references a key in a secret that will be used as value.</p>
  11436. </td>
  11437. </tr>
  11438. </tbody>
  11439. </table>
  11440. <h3 id="external-secrets.io/v1.SecretStore">SecretStore
  11441. </h3>
  11442. <p>
  11443. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  11444. </p>
  11445. <table>
  11446. <thead>
  11447. <tr>
  11448. <th>Field</th>
  11449. <th>Description</th>
  11450. </tr>
  11451. </thead>
  11452. <tbody>
  11453. <tr>
  11454. <td>
  11455. <code>metadata</code></br>
  11456. <em>
  11457. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  11458. Kubernetes meta/v1.ObjectMeta
  11459. </a>
  11460. </em>
  11461. </td>
  11462. <td>
  11463. Refer to the Kubernetes API documentation for the fields of the
  11464. <code>metadata</code> field.
  11465. </td>
  11466. </tr>
  11467. <tr>
  11468. <td>
  11469. <code>spec</code></br>
  11470. <em>
  11471. <a href="#external-secrets.io/v1.SecretStoreSpec">
  11472. SecretStoreSpec
  11473. </a>
  11474. </em>
  11475. </td>
  11476. <td>
  11477. <br/>
  11478. <br/>
  11479. <table>
  11480. <tr>
  11481. <td>
  11482. <code>controller</code></br>
  11483. <em>
  11484. string
  11485. </em>
  11486. </td>
  11487. <td>
  11488. <em>(Optional)</em>
  11489. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  11490. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  11491. </td>
  11492. </tr>
  11493. <tr>
  11494. <td>
  11495. <code>provider</code></br>
  11496. <em>
  11497. <a href="#external-secrets.io/v1.SecretStoreProvider">
  11498. SecretStoreProvider
  11499. </a>
  11500. </em>
  11501. </td>
  11502. <td>
  11503. <p>Used to configure the provider. Only one provider may be set</p>
  11504. </td>
  11505. </tr>
  11506. <tr>
  11507. <td>
  11508. <code>retrySettings</code></br>
  11509. <em>
  11510. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  11511. SecretStoreRetrySettings
  11512. </a>
  11513. </em>
  11514. </td>
  11515. <td>
  11516. <em>(Optional)</em>
  11517. <p>Used to configure HTTP retries on failures.</p>
  11518. </td>
  11519. </tr>
  11520. <tr>
  11521. <td>
  11522. <code>refreshInterval</code></br>
  11523. <em>
  11524. int
  11525. </em>
  11526. </td>
  11527. <td>
  11528. <em>(Optional)</em>
  11529. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  11530. </td>
  11531. </tr>
  11532. <tr>
  11533. <td>
  11534. <code>conditions</code></br>
  11535. <em>
  11536. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  11537. []ClusterSecretStoreCondition
  11538. </a>
  11539. </em>
  11540. </td>
  11541. <td>
  11542. <em>(Optional)</em>
  11543. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  11544. </td>
  11545. </tr>
  11546. </table>
  11547. </td>
  11548. </tr>
  11549. <tr>
  11550. <td>
  11551. <code>status</code></br>
  11552. <em>
  11553. <a href="#external-secrets.io/v1.SecretStoreStatus">
  11554. SecretStoreStatus
  11555. </a>
  11556. </em>
  11557. </td>
  11558. <td>
  11559. </td>
  11560. </tr>
  11561. </tbody>
  11562. </table>
  11563. <h3 id="external-secrets.io/v1.SecretStoreCapabilities">SecretStoreCapabilities
  11564. (<code>string</code> alias)</p></h3>
  11565. <p>
  11566. (<em>Appears on:</em>
  11567. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  11568. </p>
  11569. <p>
  11570. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  11571. </p>
  11572. <table>
  11573. <thead>
  11574. <tr>
  11575. <th>Value</th>
  11576. <th>Description</th>
  11577. </tr>
  11578. </thead>
  11579. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  11580. <td><p>SecretStoreReadOnly indicates that the store can only read secrets.</p>
  11581. </td>
  11582. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  11583. <td><p>SecretStoreReadWrite indicates that the store can both read and write secrets.</p>
  11584. </td>
  11585. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  11586. <td><p>SecretStoreWriteOnly indicates that the store can only write secrets.</p>
  11587. </td>
  11588. </tr></tbody>
  11589. </table>
  11590. <h3 id="external-secrets.io/v1.SecretStoreConditionType">SecretStoreConditionType
  11591. (<code>string</code> alias)</p></h3>
  11592. <p>
  11593. (<em>Appears on:</em>
  11594. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  11595. </p>
  11596. <p>
  11597. <p>SecretStoreConditionType represents the condition of the SecretStore.</p>
  11598. </p>
  11599. <table>
  11600. <thead>
  11601. <tr>
  11602. <th>Value</th>
  11603. <th>Description</th>
  11604. </tr>
  11605. </thead>
  11606. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  11607. <td><p>SecretStoreReady indicates that the store is ready and able to serve requests.</p>
  11608. </td>
  11609. </tr></tbody>
  11610. </table>
  11611. <h3 id="external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider
  11612. </h3>
  11613. <p>
  11614. (<em>Appears on:</em>
  11615. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  11616. </p>
  11617. <p>
  11618. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  11619. </p>
  11620. <table>
  11621. <thead>
  11622. <tr>
  11623. <th>Field</th>
  11624. <th>Description</th>
  11625. </tr>
  11626. </thead>
  11627. <tbody>
  11628. <tr>
  11629. <td>
  11630. <code>aws</code></br>
  11631. <em>
  11632. <a href="#external-secrets.io/v1.AWSProvider">
  11633. AWSProvider
  11634. </a>
  11635. </em>
  11636. </td>
  11637. <td>
  11638. <em>(Optional)</em>
  11639. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  11640. </td>
  11641. </tr>
  11642. <tr>
  11643. <td>
  11644. <code>azurekv</code></br>
  11645. <em>
  11646. <a href="#external-secrets.io/v1.AzureKVProvider">
  11647. AzureKVProvider
  11648. </a>
  11649. </em>
  11650. </td>
  11651. <td>
  11652. <em>(Optional)</em>
  11653. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  11654. </td>
  11655. </tr>
  11656. <tr>
  11657. <td>
  11658. <code>akeyless</code></br>
  11659. <em>
  11660. <a href="#external-secrets.io/v1.AkeylessProvider">
  11661. AkeylessProvider
  11662. </a>
  11663. </em>
  11664. </td>
  11665. <td>
  11666. <em>(Optional)</em>
  11667. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  11668. </td>
  11669. </tr>
  11670. <tr>
  11671. <td>
  11672. <code>bitwardensecretsmanager</code></br>
  11673. <em>
  11674. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">
  11675. BitwardenSecretsManagerProvider
  11676. </a>
  11677. </em>
  11678. </td>
  11679. <td>
  11680. <em>(Optional)</em>
  11681. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  11682. </td>
  11683. </tr>
  11684. <tr>
  11685. <td>
  11686. <code>vault</code></br>
  11687. <em>
  11688. <a href="#external-secrets.io/v1.VaultProvider">
  11689. VaultProvider
  11690. </a>
  11691. </em>
  11692. </td>
  11693. <td>
  11694. <em>(Optional)</em>
  11695. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  11696. </td>
  11697. </tr>
  11698. <tr>
  11699. <td>
  11700. <code>ovh</code></br>
  11701. <em>
  11702. <a href="#external-secrets.io/v1.OvhProvider">
  11703. OvhProvider
  11704. </a>
  11705. </em>
  11706. </td>
  11707. <td>
  11708. <em>(Optional)</em>
  11709. <p>OVHcloud configures this store to sync secrets using the OVHcloud provider.</p>
  11710. </td>
  11711. </tr>
  11712. <tr>
  11713. <td>
  11714. <code>gcpsm</code></br>
  11715. <em>
  11716. <a href="#external-secrets.io/v1.GCPSMProvider">
  11717. GCPSMProvider
  11718. </a>
  11719. </em>
  11720. </td>
  11721. <td>
  11722. <em>(Optional)</em>
  11723. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  11724. </td>
  11725. </tr>
  11726. <tr>
  11727. <td>
  11728. <code>oracle</code></br>
  11729. <em>
  11730. <a href="#external-secrets.io/v1.OracleProvider">
  11731. OracleProvider
  11732. </a>
  11733. </em>
  11734. </td>
  11735. <td>
  11736. <em>(Optional)</em>
  11737. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  11738. </td>
  11739. </tr>
  11740. <tr>
  11741. <td>
  11742. <code>ibm</code></br>
  11743. <em>
  11744. <a href="#external-secrets.io/v1.IBMProvider">
  11745. IBMProvider
  11746. </a>
  11747. </em>
  11748. </td>
  11749. <td>
  11750. <em>(Optional)</em>
  11751. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  11752. </td>
  11753. </tr>
  11754. <tr>
  11755. <td>
  11756. <code>yandexcertificatemanager</code></br>
  11757. <em>
  11758. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">
  11759. YandexCertificateManagerProvider
  11760. </a>
  11761. </em>
  11762. </td>
  11763. <td>
  11764. <em>(Optional)</em>
  11765. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  11766. </td>
  11767. </tr>
  11768. <tr>
  11769. <td>
  11770. <code>yandexlockbox</code></br>
  11771. <em>
  11772. <a href="#external-secrets.io/v1.YandexLockboxProvider">
  11773. YandexLockboxProvider
  11774. </a>
  11775. </em>
  11776. </td>
  11777. <td>
  11778. <em>(Optional)</em>
  11779. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  11780. </td>
  11781. </tr>
  11782. <tr>
  11783. <td>
  11784. <code>github</code></br>
  11785. <em>
  11786. <a href="#external-secrets.io/v1.GithubProvider">
  11787. GithubProvider
  11788. </a>
  11789. </em>
  11790. </td>
  11791. <td>
  11792. <em>(Optional)</em>
  11793. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.
  11794. Note: This provider only supports write operations (PushSecret) and cannot fetch secrets from GitHub</p>
  11795. </td>
  11796. </tr>
  11797. <tr>
  11798. <td>
  11799. <code>gitlab</code></br>
  11800. <em>
  11801. <a href="#external-secrets.io/v1.GitlabProvider">
  11802. GitlabProvider
  11803. </a>
  11804. </em>
  11805. </td>
  11806. <td>
  11807. <em>(Optional)</em>
  11808. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  11809. </td>
  11810. </tr>
  11811. <tr>
  11812. <td>
  11813. <code>onepassword</code></br>
  11814. <em>
  11815. <a href="#external-secrets.io/v1.OnePasswordProvider">
  11816. OnePasswordProvider
  11817. </a>
  11818. </em>
  11819. </td>
  11820. <td>
  11821. <em>(Optional)</em>
  11822. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  11823. </td>
  11824. </tr>
  11825. <tr>
  11826. <td>
  11827. <code>onepasswordSDK</code></br>
  11828. <em>
  11829. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">
  11830. OnePasswordSDKProvider
  11831. </a>
  11832. </em>
  11833. </td>
  11834. <td>
  11835. <em>(Optional)</em>
  11836. <p>OnePasswordSDK configures this store to use 1Password&rsquo;s new Go SDK to sync secrets.</p>
  11837. </td>
  11838. </tr>
  11839. <tr>
  11840. <td>
  11841. <code>webhook</code></br>
  11842. <em>
  11843. <a href="#external-secrets.io/v1.WebhookProvider">
  11844. WebhookProvider
  11845. </a>
  11846. </em>
  11847. </td>
  11848. <td>
  11849. <em>(Optional)</em>
  11850. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  11851. </td>
  11852. </tr>
  11853. <tr>
  11854. <td>
  11855. <code>kubernetes</code></br>
  11856. <em>
  11857. <a href="#external-secrets.io/v1.KubernetesProvider">
  11858. KubernetesProvider
  11859. </a>
  11860. </em>
  11861. </td>
  11862. <td>
  11863. <em>(Optional)</em>
  11864. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  11865. </td>
  11866. </tr>
  11867. <tr>
  11868. <td>
  11869. <code>fake</code></br>
  11870. <em>
  11871. <a href="#external-secrets.io/v1.FakeProvider">
  11872. FakeProvider
  11873. </a>
  11874. </em>
  11875. </td>
  11876. <td>
  11877. <em>(Optional)</em>
  11878. <p>Fake configures a store with static key/value pairs</p>
  11879. </td>
  11880. </tr>
  11881. <tr>
  11882. <td>
  11883. <code>senhasegura</code></br>
  11884. <em>
  11885. <a href="#external-secrets.io/v1.SenhaseguraProvider">
  11886. SenhaseguraProvider
  11887. </a>
  11888. </em>
  11889. </td>
  11890. <td>
  11891. <em>(Optional)</em>
  11892. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  11893. </td>
  11894. </tr>
  11895. <tr>
  11896. <td>
  11897. <code>scaleway</code></br>
  11898. <em>
  11899. <a href="#external-secrets.io/v1.ScalewayProvider">
  11900. ScalewayProvider
  11901. </a>
  11902. </em>
  11903. </td>
  11904. <td>
  11905. <em>(Optional)</em>
  11906. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  11907. </td>
  11908. </tr>
  11909. <tr>
  11910. <td>
  11911. <code>doppler</code></br>
  11912. <em>
  11913. <a href="#external-secrets.io/v1.DopplerProvider">
  11914. DopplerProvider
  11915. </a>
  11916. </em>
  11917. </td>
  11918. <td>
  11919. <em>(Optional)</em>
  11920. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  11921. </td>
  11922. </tr>
  11923. <tr>
  11924. <td>
  11925. <code>previder</code></br>
  11926. <em>
  11927. <a href="#external-secrets.io/v1.PreviderProvider">
  11928. PreviderProvider
  11929. </a>
  11930. </em>
  11931. </td>
  11932. <td>
  11933. <em>(Optional)</em>
  11934. <p>Previder configures this store to sync secrets using the Previder provider</p>
  11935. </td>
  11936. </tr>
  11937. <tr>
  11938. <td>
  11939. <code>onboardbase</code></br>
  11940. <em>
  11941. <a href="#external-secrets.io/v1.OnboardbaseProvider">
  11942. OnboardbaseProvider
  11943. </a>
  11944. </em>
  11945. </td>
  11946. <td>
  11947. <em>(Optional)</em>
  11948. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  11949. </td>
  11950. </tr>
  11951. <tr>
  11952. <td>
  11953. <code>keepersecurity</code></br>
  11954. <em>
  11955. <a href="#external-secrets.io/v1.KeeperSecurityProvider">
  11956. KeeperSecurityProvider
  11957. </a>
  11958. </em>
  11959. </td>
  11960. <td>
  11961. <em>(Optional)</em>
  11962. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  11963. </td>
  11964. </tr>
  11965. <tr>
  11966. <td>
  11967. <code>conjur</code></br>
  11968. <em>
  11969. <a href="#external-secrets.io/v1.ConjurProvider">
  11970. ConjurProvider
  11971. </a>
  11972. </em>
  11973. </td>
  11974. <td>
  11975. <em>(Optional)</em>
  11976. <p>Conjur configures this store to sync secrets using conjur provider</p>
  11977. </td>
  11978. </tr>
  11979. <tr>
  11980. <td>
  11981. <code>delinea</code></br>
  11982. <em>
  11983. <a href="#external-secrets.io/v1.DelineaProvider">
  11984. DelineaProvider
  11985. </a>
  11986. </em>
  11987. </td>
  11988. <td>
  11989. <em>(Optional)</em>
  11990. <p>Delinea DevOps Secrets Vault
  11991. <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>
  11992. </td>
  11993. </tr>
  11994. <tr>
  11995. <td>
  11996. <code>secretserver</code></br>
  11997. <em>
  11998. <a href="#external-secrets.io/v1.SecretServerProvider">
  11999. SecretServerProvider
  12000. </a>
  12001. </em>
  12002. </td>
  12003. <td>
  12004. <em>(Optional)</em>
  12005. <p>SecretServer configures this store to sync secrets using SecretServer provider
  12006. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  12007. </td>
  12008. </tr>
  12009. <tr>
  12010. <td>
  12011. <code>chef</code></br>
  12012. <em>
  12013. <a href="#external-secrets.io/v1.ChefProvider">
  12014. ChefProvider
  12015. </a>
  12016. </em>
  12017. </td>
  12018. <td>
  12019. <em>(Optional)</em>
  12020. <p>Chef configures this store to sync secrets with chef server</p>
  12021. </td>
  12022. </tr>
  12023. <tr>
  12024. <td>
  12025. <code>pulumi</code></br>
  12026. <em>
  12027. <a href="#external-secrets.io/v1.PulumiProvider">
  12028. PulumiProvider
  12029. </a>
  12030. </em>
  12031. </td>
  12032. <td>
  12033. <em>(Optional)</em>
  12034. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  12035. </td>
  12036. </tr>
  12037. <tr>
  12038. <td>
  12039. <code>fortanix</code></br>
  12040. <em>
  12041. <a href="#external-secrets.io/v1.FortanixProvider">
  12042. FortanixProvider
  12043. </a>
  12044. </em>
  12045. </td>
  12046. <td>
  12047. <em>(Optional)</em>
  12048. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  12049. </td>
  12050. </tr>
  12051. <tr>
  12052. <td>
  12053. <code>passworddepot</code></br>
  12054. <em>
  12055. <a href="#external-secrets.io/v1.PasswordDepotProvider">
  12056. PasswordDepotProvider
  12057. </a>
  12058. </em>
  12059. </td>
  12060. <td>
  12061. <em>(Optional)</em>
  12062. </td>
  12063. </tr>
  12064. <tr>
  12065. <td>
  12066. <code>passbolt</code></br>
  12067. <em>
  12068. <a href="#external-secrets.io/v1.PassboltProvider">
  12069. PassboltProvider
  12070. </a>
  12071. </em>
  12072. </td>
  12073. <td>
  12074. <em>(Optional)</em>
  12075. </td>
  12076. </tr>
  12077. <tr>
  12078. <td>
  12079. <code>dvls</code></br>
  12080. <em>
  12081. <a href="#external-secrets.io/v1.DVLSProvider">
  12082. DVLSProvider
  12083. </a>
  12084. </em>
  12085. </td>
  12086. <td>
  12087. <em>(Optional)</em>
  12088. <p>DVLS configures this store to sync secrets using Devolutions Server provider</p>
  12089. </td>
  12090. </tr>
  12091. <tr>
  12092. <td>
  12093. <code>infisical</code></br>
  12094. <em>
  12095. <a href="#external-secrets.io/v1.InfisicalProvider">
  12096. InfisicalProvider
  12097. </a>
  12098. </em>
  12099. </td>
  12100. <td>
  12101. <em>(Optional)</em>
  12102. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  12103. </td>
  12104. </tr>
  12105. <tr>
  12106. <td>
  12107. <code>beyondtrust</code></br>
  12108. <em>
  12109. <a href="#external-secrets.io/v1.BeyondtrustProvider">
  12110. BeyondtrustProvider
  12111. </a>
  12112. </em>
  12113. </td>
  12114. <td>
  12115. <em>(Optional)</em>
  12116. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  12117. </td>
  12118. </tr>
  12119. <tr>
  12120. <td>
  12121. <code>beyondtrustworkloadcredentials</code></br>
  12122. <em>
  12123. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  12124. BeyondtrustWorkloadCredentialsProvider
  12125. </a>
  12126. </em>
  12127. </td>
  12128. <td>
  12129. <em>(Optional)</em>
  12130. <p>BeyondtrustWorkloadCredentials configures this store to sync secrets using the BeyondTrust Workload Credentials provider.</p>
  12131. </td>
  12132. </tr>
  12133. <tr>
  12134. <td>
  12135. <code>cloudrusm</code></br>
  12136. <em>
  12137. <a href="#external-secrets.io/v1.CloudruSMProvider">
  12138. CloudruSMProvider
  12139. </a>
  12140. </em>
  12141. </td>
  12142. <td>
  12143. <em>(Optional)</em>
  12144. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  12145. </td>
  12146. </tr>
  12147. <tr>
  12148. <td>
  12149. <code>volcengine</code></br>
  12150. <em>
  12151. <a href="#external-secrets.io/v1.VolcengineProvider">
  12152. VolcengineProvider
  12153. </a>
  12154. </em>
  12155. </td>
  12156. <td>
  12157. <em>(Optional)</em>
  12158. <p>Volcengine configures this store to sync secrets using the Volcengine provider</p>
  12159. </td>
  12160. </tr>
  12161. <tr>
  12162. <td>
  12163. <code>ngrok</code></br>
  12164. <em>
  12165. <a href="#external-secrets.io/v1.NgrokProvider">
  12166. NgrokProvider
  12167. </a>
  12168. </em>
  12169. </td>
  12170. <td>
  12171. <em>(Optional)</em>
  12172. <p>Ngrok configures this store to sync secrets using the ngrok provider.</p>
  12173. </td>
  12174. </tr>
  12175. <tr>
  12176. <td>
  12177. <code>barbican</code></br>
  12178. <em>
  12179. <a href="#external-secrets.io/v1.BarbicanProvider">
  12180. BarbicanProvider
  12181. </a>
  12182. </em>
  12183. </td>
  12184. <td>
  12185. <em>(Optional)</em>
  12186. <p>Barbican configures this store to sync secrets using the OpenStack Barbican provider</p>
  12187. </td>
  12188. </tr>
  12189. <tr>
  12190. <td>
  12191. <code>nebiusmysterybox</code></br>
  12192. <em>
  12193. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">
  12194. NebiusMysteryboxProvider
  12195. </a>
  12196. </em>
  12197. </td>
  12198. <td>
  12199. <em>(Optional)</em>
  12200. <p>NebiusMysterybox configures this store to sync secrets using NebiusMysterybox provider</p>
  12201. </td>
  12202. </tr>
  12203. <tr>
  12204. <td>
  12205. <code>openBao</code></br>
  12206. <em>
  12207. <a href="#external-secrets.io/v1.OpenBaoProvider">
  12208. OpenBaoProvider
  12209. </a>
  12210. </em>
  12211. </td>
  12212. <td>
  12213. <em>(Optional)</em>
  12214. <p>OpenBao configures this store to sync secrets using the OpenBao provider.</p>
  12215. </td>
  12216. </tr>
  12217. </tbody>
  12218. </table>
  12219. <h3 id="external-secrets.io/v1.SecretStoreRef">SecretStoreRef
  12220. </h3>
  12221. <p>
  12222. (<em>Appears on:</em>
  12223. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>,
  12224. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  12225. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>)
  12226. </p>
  12227. <p>
  12228. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  12229. </p>
  12230. <table>
  12231. <thead>
  12232. <tr>
  12233. <th>Field</th>
  12234. <th>Description</th>
  12235. </tr>
  12236. </thead>
  12237. <tbody>
  12238. <tr>
  12239. <td>
  12240. <code>name</code></br>
  12241. <em>
  12242. string
  12243. </em>
  12244. </td>
  12245. <td>
  12246. <p>Name of the SecretStore resource</p>
  12247. </td>
  12248. </tr>
  12249. <tr>
  12250. <td>
  12251. <code>kind</code></br>
  12252. <em>
  12253. string
  12254. </em>
  12255. </td>
  12256. <td>
  12257. <em>(Optional)</em>
  12258. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  12259. Defaults to <code>SecretStore</code></p>
  12260. </td>
  12261. </tr>
  12262. </tbody>
  12263. </table>
  12264. <h3 id="external-secrets.io/v1.SecretStoreRetrySettings">SecretStoreRetrySettings
  12265. </h3>
  12266. <p>
  12267. (<em>Appears on:</em>
  12268. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>,
  12269. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec</a>,
  12270. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  12271. </p>
  12272. <p>
  12273. <p>SecretStoreRetrySettings defines the retry settings for accessing external secrets manager stores.</p>
  12274. </p>
  12275. <table>
  12276. <thead>
  12277. <tr>
  12278. <th>Field</th>
  12279. <th>Description</th>
  12280. </tr>
  12281. </thead>
  12282. <tbody>
  12283. <tr>
  12284. <td>
  12285. <code>maxRetries</code></br>
  12286. <em>
  12287. int32
  12288. </em>
  12289. </td>
  12290. <td>
  12291. </td>
  12292. </tr>
  12293. <tr>
  12294. <td>
  12295. <code>retryInterval</code></br>
  12296. <em>
  12297. string
  12298. </em>
  12299. </td>
  12300. <td>
  12301. </td>
  12302. </tr>
  12303. </tbody>
  12304. </table>
  12305. <h3 id="external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec
  12306. </h3>
  12307. <p>
  12308. (<em>Appears on:</em>
  12309. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  12310. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  12311. </p>
  12312. <p>
  12313. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  12314. </p>
  12315. <table>
  12316. <thead>
  12317. <tr>
  12318. <th>Field</th>
  12319. <th>Description</th>
  12320. </tr>
  12321. </thead>
  12322. <tbody>
  12323. <tr>
  12324. <td>
  12325. <code>controller</code></br>
  12326. <em>
  12327. string
  12328. </em>
  12329. </td>
  12330. <td>
  12331. <em>(Optional)</em>
  12332. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  12333. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  12334. </td>
  12335. </tr>
  12336. <tr>
  12337. <td>
  12338. <code>provider</code></br>
  12339. <em>
  12340. <a href="#external-secrets.io/v1.SecretStoreProvider">
  12341. SecretStoreProvider
  12342. </a>
  12343. </em>
  12344. </td>
  12345. <td>
  12346. <p>Used to configure the provider. Only one provider may be set</p>
  12347. </td>
  12348. </tr>
  12349. <tr>
  12350. <td>
  12351. <code>retrySettings</code></br>
  12352. <em>
  12353. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  12354. SecretStoreRetrySettings
  12355. </a>
  12356. </em>
  12357. </td>
  12358. <td>
  12359. <em>(Optional)</em>
  12360. <p>Used to configure HTTP retries on failures.</p>
  12361. </td>
  12362. </tr>
  12363. <tr>
  12364. <td>
  12365. <code>refreshInterval</code></br>
  12366. <em>
  12367. int
  12368. </em>
  12369. </td>
  12370. <td>
  12371. <em>(Optional)</em>
  12372. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  12373. </td>
  12374. </tr>
  12375. <tr>
  12376. <td>
  12377. <code>conditions</code></br>
  12378. <em>
  12379. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  12380. []ClusterSecretStoreCondition
  12381. </a>
  12382. </em>
  12383. </td>
  12384. <td>
  12385. <em>(Optional)</em>
  12386. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  12387. </td>
  12388. </tr>
  12389. </tbody>
  12390. </table>
  12391. <h3 id="external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus
  12392. </h3>
  12393. <p>
  12394. (<em>Appears on:</em>
  12395. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  12396. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  12397. </p>
  12398. <p>
  12399. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  12400. </p>
  12401. <table>
  12402. <thead>
  12403. <tr>
  12404. <th>Field</th>
  12405. <th>Description</th>
  12406. </tr>
  12407. </thead>
  12408. <tbody>
  12409. <tr>
  12410. <td>
  12411. <code>conditions</code></br>
  12412. <em>
  12413. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">
  12414. []SecretStoreStatusCondition
  12415. </a>
  12416. </em>
  12417. </td>
  12418. <td>
  12419. <em>(Optional)</em>
  12420. </td>
  12421. </tr>
  12422. <tr>
  12423. <td>
  12424. <code>capabilities</code></br>
  12425. <em>
  12426. <a href="#external-secrets.io/v1.SecretStoreCapabilities">
  12427. SecretStoreCapabilities
  12428. </a>
  12429. </em>
  12430. </td>
  12431. <td>
  12432. <em>(Optional)</em>
  12433. </td>
  12434. </tr>
  12435. </tbody>
  12436. </table>
  12437. <h3 id="external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition
  12438. </h3>
  12439. <p>
  12440. (<em>Appears on:</em>
  12441. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  12442. </p>
  12443. <p>
  12444. <p>SecretStoreStatusCondition contains condition information for a SecretStore.</p>
  12445. </p>
  12446. <table>
  12447. <thead>
  12448. <tr>
  12449. <th>Field</th>
  12450. <th>Description</th>
  12451. </tr>
  12452. </thead>
  12453. <tbody>
  12454. <tr>
  12455. <td>
  12456. <code>type</code></br>
  12457. <em>
  12458. <a href="#external-secrets.io/v1.SecretStoreConditionType">
  12459. SecretStoreConditionType
  12460. </a>
  12461. </em>
  12462. </td>
  12463. <td>
  12464. </td>
  12465. </tr>
  12466. <tr>
  12467. <td>
  12468. <code>status</code></br>
  12469. <em>
  12470. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  12471. Kubernetes core/v1.ConditionStatus
  12472. </a>
  12473. </em>
  12474. </td>
  12475. <td>
  12476. </td>
  12477. </tr>
  12478. <tr>
  12479. <td>
  12480. <code>reason</code></br>
  12481. <em>
  12482. string
  12483. </em>
  12484. </td>
  12485. <td>
  12486. <em>(Optional)</em>
  12487. </td>
  12488. </tr>
  12489. <tr>
  12490. <td>
  12491. <code>message</code></br>
  12492. <em>
  12493. string
  12494. </em>
  12495. </td>
  12496. <td>
  12497. <em>(Optional)</em>
  12498. </td>
  12499. </tr>
  12500. <tr>
  12501. <td>
  12502. <code>lastTransitionTime</code></br>
  12503. <em>
  12504. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  12505. Kubernetes meta/v1.Time
  12506. </a>
  12507. </em>
  12508. </td>
  12509. <td>
  12510. <em>(Optional)</em>
  12511. </td>
  12512. </tr>
  12513. </tbody>
  12514. </table>
  12515. <h3 id="external-secrets.io/v1.SecretVersionSelectionPolicy">SecretVersionSelectionPolicy
  12516. (<code>string</code> alias)</p></h3>
  12517. <p>
  12518. (<em>Appears on:</em>
  12519. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  12520. </p>
  12521. <p>
  12522. <p>SecretVersionSelectionPolicy defines the policy for selecting secret versions in GCP Secret Manager.</p>
  12523. </p>
  12524. <table>
  12525. <thead>
  12526. <tr>
  12527. <th>Value</th>
  12528. <th>Description</th>
  12529. </tr>
  12530. </thead>
  12531. <tbody><tr><td><p>&#34;LatestOrFail&#34;</p></td>
  12532. <td><p>SecretVersionSelectionPolicyLatestOrFail means the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.</p>
  12533. </td>
  12534. </tr><tr><td><p>&#34;LatestOrFetch&#34;</p></td>
  12535. <td><p>SecretVersionSelectionPolicyLatestOrFetch behaves like SecretVersionSelectionPolicyLatestOrFail but falls back to fetching the latest version if the version is DESTROYED or DISABLED.</p>
  12536. </td>
  12537. </tr></tbody>
  12538. </table>
  12539. <h3 id="external-secrets.io/v1.SecretsClient">SecretsClient
  12540. </h3>
  12541. <p>
  12542. <p>SecretsClient provides access to secrets.</p>
  12543. </p>
  12544. <h3 id="external-secrets.io/v1.SecretsManager">SecretsManager
  12545. </h3>
  12546. <p>
  12547. (<em>Appears on:</em>
  12548. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  12549. </p>
  12550. <p>
  12551. <p>SecretsManager defines how the provider behaves when interacting with AWS
  12552. SecretsManager. Some of these settings are only applicable to controlling how
  12553. secrets are deleted, and hence only apply to PushSecret (and only when
  12554. deletionPolicy is set to Delete).</p>
  12555. </p>
  12556. <table>
  12557. <thead>
  12558. <tr>
  12559. <th>Field</th>
  12560. <th>Description</th>
  12561. </tr>
  12562. </thead>
  12563. <tbody>
  12564. <tr>
  12565. <td>
  12566. <code>forceDeleteWithoutRecovery</code></br>
  12567. <em>
  12568. bool
  12569. </em>
  12570. </td>
  12571. <td>
  12572. <em>(Optional)</em>
  12573. <p>Specifies whether to delete the secret without any recovery window. You
  12574. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  12575. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  12576. recovery window.
  12577. 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>
  12578. </td>
  12579. </tr>
  12580. <tr>
  12581. <td>
  12582. <code>recoveryWindowInDays</code></br>
  12583. <em>
  12584. int64
  12585. </em>
  12586. </td>
  12587. <td>
  12588. <em>(Optional)</em>
  12589. <p>The number of days from 7 to 30 that Secrets Manager waits before
  12590. permanently deleting the secret. You can&rsquo;t use both this parameter and
  12591. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  12592. then by default Secrets Manager uses a 30-day recovery window.
  12593. 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>
  12594. </td>
  12595. </tr>
  12596. </tbody>
  12597. </table>
  12598. <h3 id="external-secrets.io/v1.SenhaseguraAuth">SenhaseguraAuth
  12599. </h3>
  12600. <p>
  12601. (<em>Appears on:</em>
  12602. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  12603. </p>
  12604. <p>
  12605. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  12606. </p>
  12607. <table>
  12608. <thead>
  12609. <tr>
  12610. <th>Field</th>
  12611. <th>Description</th>
  12612. </tr>
  12613. </thead>
  12614. <tbody>
  12615. <tr>
  12616. <td>
  12617. <code>clientId</code></br>
  12618. <em>
  12619. string
  12620. </em>
  12621. </td>
  12622. <td>
  12623. </td>
  12624. </tr>
  12625. <tr>
  12626. <td>
  12627. <code>clientSecretSecretRef</code></br>
  12628. <em>
  12629. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12630. External Secrets meta/v1.SecretKeySelector
  12631. </a>
  12632. </em>
  12633. </td>
  12634. <td>
  12635. </td>
  12636. </tr>
  12637. </tbody>
  12638. </table>
  12639. <h3 id="external-secrets.io/v1.SenhaseguraModuleType">SenhaseguraModuleType
  12640. (<code>string</code> alias)</p></h3>
  12641. <p>
  12642. (<em>Appears on:</em>
  12643. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  12644. </p>
  12645. <p>
  12646. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  12647. </p>
  12648. <table>
  12649. <thead>
  12650. <tr>
  12651. <th>Value</th>
  12652. <th>Description</th>
  12653. </tr>
  12654. </thead>
  12655. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  12656. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  12657. see: https://senhasegura.com/devops
  12658. </code></pre>
  12659. </td>
  12660. </tr></tbody>
  12661. </table>
  12662. <h3 id="external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider
  12663. </h3>
  12664. <p>
  12665. (<em>Appears on:</em>
  12666. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  12667. </p>
  12668. <p>
  12669. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  12670. </p>
  12671. <table>
  12672. <thead>
  12673. <tr>
  12674. <th>Field</th>
  12675. <th>Description</th>
  12676. </tr>
  12677. </thead>
  12678. <tbody>
  12679. <tr>
  12680. <td>
  12681. <code>url</code></br>
  12682. <em>
  12683. string
  12684. </em>
  12685. </td>
  12686. <td>
  12687. <p>URL of senhasegura</p>
  12688. </td>
  12689. </tr>
  12690. <tr>
  12691. <td>
  12692. <code>module</code></br>
  12693. <em>
  12694. <a href="#external-secrets.io/v1.SenhaseguraModuleType">
  12695. SenhaseguraModuleType
  12696. </a>
  12697. </em>
  12698. </td>
  12699. <td>
  12700. <p>Module defines which senhasegura module should be used to get secrets</p>
  12701. </td>
  12702. </tr>
  12703. <tr>
  12704. <td>
  12705. <code>auth</code></br>
  12706. <em>
  12707. <a href="#external-secrets.io/v1.SenhaseguraAuth">
  12708. SenhaseguraAuth
  12709. </a>
  12710. </em>
  12711. </td>
  12712. <td>
  12713. <p>Auth defines parameters to authenticate in senhasegura</p>
  12714. </td>
  12715. </tr>
  12716. <tr>
  12717. <td>
  12718. <code>ignoreSslCertificate</code></br>
  12719. <em>
  12720. bool
  12721. </em>
  12722. </td>
  12723. <td>
  12724. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  12725. </td>
  12726. </tr>
  12727. </tbody>
  12728. </table>
  12729. <h3 id="external-secrets.io/v1.SessionTagsPolicy">SessionTagsPolicy
  12730. (<code>string</code> alias)</p></h3>
  12731. <p>
  12732. (<em>Appears on:</em>
  12733. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  12734. </p>
  12735. <p>
  12736. <p>SessionTagsPolicy defines how STS session tags are handled.</p>
  12737. </p>
  12738. <table>
  12739. <thead>
  12740. <tr>
  12741. <th>Value</th>
  12742. <th>Description</th>
  12743. </tr>
  12744. </thead>
  12745. <tbody><tr><td><p>&#34;Custom&#34;</p></td>
  12746. <td><p>SessionTagsPolicyCustom adds the tags defined in CustomSessionTags in addition to
  12747. the esoNamespace, esoStoreName, and esoStoreKind tags.</p>
  12748. </td>
  12749. </tr><tr><td><p>&#34;None&#34;</p></td>
  12750. <td><p>SessionTagsPolicyNone is the default behavior - no session tags are added.</p>
  12751. </td>
  12752. </tr><tr><td><p>&#34;Simple&#34;</p></td>
  12753. <td><p>SessionTagsPolicySimple automatically adds esoNamespace, esoStoreName, and esoStoreKind
  12754. session tags.</p>
  12755. </td>
  12756. </tr></tbody>
  12757. </table>
  12758. <h3 id="external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  12759. </h3>
  12760. <p>
  12761. (<em>Appears on:</em>
  12762. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  12763. </p>
  12764. <p>
  12765. <p>StoreGeneratorSourceRef allows you to override the source
  12766. from which the secret will be pulled from.
  12767. You can define at maximum one property.</p>
  12768. </p>
  12769. <table>
  12770. <thead>
  12771. <tr>
  12772. <th>Field</th>
  12773. <th>Description</th>
  12774. </tr>
  12775. </thead>
  12776. <tbody>
  12777. <tr>
  12778. <td>
  12779. <code>storeRef</code></br>
  12780. <em>
  12781. <a href="#external-secrets.io/v1.SecretStoreRef">
  12782. SecretStoreRef
  12783. </a>
  12784. </em>
  12785. </td>
  12786. <td>
  12787. <em>(Optional)</em>
  12788. </td>
  12789. </tr>
  12790. <tr>
  12791. <td>
  12792. <code>generatorRef</code></br>
  12793. <em>
  12794. <a href="#external-secrets.io/v1.GeneratorRef">
  12795. GeneratorRef
  12796. </a>
  12797. </em>
  12798. </td>
  12799. <td>
  12800. <em>(Optional)</em>
  12801. <p>GeneratorRef points to a generator custom resource.</p>
  12802. </td>
  12803. </tr>
  12804. </tbody>
  12805. </table>
  12806. <h3 id="external-secrets.io/v1.StoreSourceRef">StoreSourceRef
  12807. </h3>
  12808. <p>
  12809. (<em>Appears on:</em>
  12810. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>)
  12811. </p>
  12812. <p>
  12813. <p>StoreSourceRef allows you to override the SecretStore source
  12814. from which the secret will be pulled from.
  12815. You can define at maximum one property.</p>
  12816. </p>
  12817. <table>
  12818. <thead>
  12819. <tr>
  12820. <th>Field</th>
  12821. <th>Description</th>
  12822. </tr>
  12823. </thead>
  12824. <tbody>
  12825. <tr>
  12826. <td>
  12827. <code>storeRef</code></br>
  12828. <em>
  12829. <a href="#external-secrets.io/v1.SecretStoreRef">
  12830. SecretStoreRef
  12831. </a>
  12832. </em>
  12833. </td>
  12834. <td>
  12835. <em>(Optional)</em>
  12836. </td>
  12837. </tr>
  12838. <tr>
  12839. <td>
  12840. <code>generatorRef</code></br>
  12841. <em>
  12842. <a href="#external-secrets.io/v1.GeneratorRef">
  12843. GeneratorRef
  12844. </a>
  12845. </em>
  12846. </td>
  12847. <td>
  12848. <p>GeneratorRef points to a generator custom resource.</p>
  12849. <p>Deprecated: The generatorRef is not implemented in .data[].
  12850. this will be removed with v1.</p>
  12851. </td>
  12852. </tr>
  12853. </tbody>
  12854. </table>
  12855. <h3 id="external-secrets.io/v1.Tag">Tag
  12856. </h3>
  12857. <p>
  12858. <p>Tag is a key-value pair that can be attached to an AWS resource.
  12859. 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>
  12860. </p>
  12861. <table>
  12862. <thead>
  12863. <tr>
  12864. <th>Field</th>
  12865. <th>Description</th>
  12866. </tr>
  12867. </thead>
  12868. <tbody>
  12869. <tr>
  12870. <td>
  12871. <code>key</code></br>
  12872. <em>
  12873. string
  12874. </em>
  12875. </td>
  12876. <td>
  12877. </td>
  12878. </tr>
  12879. <tr>
  12880. <td>
  12881. <code>value</code></br>
  12882. <em>
  12883. string
  12884. </em>
  12885. </td>
  12886. <td>
  12887. </td>
  12888. </tr>
  12889. </tbody>
  12890. </table>
  12891. <h3 id="external-secrets.io/v1.TemplateEngineVersion">TemplateEngineVersion
  12892. (<code>string</code> alias)</p></h3>
  12893. <p>
  12894. (<em>Appears on:</em>
  12895. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  12896. </p>
  12897. <p>
  12898. <p>TemplateEngineVersion specifies the template engine version that should be used to
  12899. compile/execute the template.</p>
  12900. </p>
  12901. <table>
  12902. <thead>
  12903. <tr>
  12904. <th>Value</th>
  12905. <th>Description</th>
  12906. </tr>
  12907. </thead>
  12908. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  12909. <td><p>TemplateEngineV2 is the currently supported template engine version.</p>
  12910. </td>
  12911. </tr></tbody>
  12912. </table>
  12913. <h3 id="external-secrets.io/v1.TemplateFrom">TemplateFrom
  12914. </h3>
  12915. <p>
  12916. (<em>Appears on:</em>
  12917. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  12918. </p>
  12919. <p>
  12920. <p>TemplateFrom specifies a source for templates.
  12921. Each item in the list can either reference a ConfigMap or a Secret resource.</p>
  12922. </p>
  12923. <table>
  12924. <thead>
  12925. <tr>
  12926. <th>Field</th>
  12927. <th>Description</th>
  12928. </tr>
  12929. </thead>
  12930. <tbody>
  12931. <tr>
  12932. <td>
  12933. <code>configMap</code></br>
  12934. <em>
  12935. <a href="#external-secrets.io/v1.TemplateRef">
  12936. TemplateRef
  12937. </a>
  12938. </em>
  12939. </td>
  12940. <td>
  12941. </td>
  12942. </tr>
  12943. <tr>
  12944. <td>
  12945. <code>secret</code></br>
  12946. <em>
  12947. <a href="#external-secrets.io/v1.TemplateRef">
  12948. TemplateRef
  12949. </a>
  12950. </em>
  12951. </td>
  12952. <td>
  12953. </td>
  12954. </tr>
  12955. <tr>
  12956. <td>
  12957. <code>target</code></br>
  12958. <em>
  12959. string
  12960. </em>
  12961. </td>
  12962. <td>
  12963. <em>(Optional)</em>
  12964. <p>Target specifies where to place the template result.
  12965. For Secret resources, common values are: &ldquo;Data&rdquo;, &ldquo;Annotations&rdquo;, &ldquo;Labels&rdquo;.
  12966. For custom resources (when spec.target.manifest is set), this supports
  12967. nested paths like &ldquo;spec.database.config&rdquo; or &ldquo;data&rdquo;.</p>
  12968. </td>
  12969. </tr>
  12970. <tr>
  12971. <td>
  12972. <code>literal</code></br>
  12973. <em>
  12974. string
  12975. </em>
  12976. </td>
  12977. <td>
  12978. <em>(Optional)</em>
  12979. </td>
  12980. </tr>
  12981. <tr>
  12982. <td>
  12983. <code>valuesDecodingStrategy</code></br>
  12984. <em>
  12985. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  12986. ExternalSecretDecodingStrategy
  12987. </a>
  12988. </em>
  12989. </td>
  12990. <td>
  12991. <em>(Optional)</em>
  12992. <p>Used to define a decoding Strategy for the rendered template values.</p>
  12993. </td>
  12994. </tr>
  12995. </tbody>
  12996. </table>
  12997. <h3 id="external-secrets.io/v1.TemplateMergePolicy">TemplateMergePolicy
  12998. (<code>string</code> alias)</p></h3>
  12999. <p>
  13000. (<em>Appears on:</em>
  13001. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  13002. </p>
  13003. <p>
  13004. <p>TemplateMergePolicy defines how the rendered template should be merged with the existing Secret data.</p>
  13005. </p>
  13006. <table>
  13007. <thead>
  13008. <tr>
  13009. <th>Value</th>
  13010. <th>Description</th>
  13011. </tr>
  13012. </thead>
  13013. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  13014. <td></td>
  13015. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  13016. <td></td>
  13017. </tr></tbody>
  13018. </table>
  13019. <h3 id="external-secrets.io/v1.TemplateRef">TemplateRef
  13020. </h3>
  13021. <p>
  13022. (<em>Appears on:</em>
  13023. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  13024. </p>
  13025. <p>
  13026. <p>TemplateRef specifies a reference to either a ConfigMap or a Secret resource.</p>
  13027. </p>
  13028. <table>
  13029. <thead>
  13030. <tr>
  13031. <th>Field</th>
  13032. <th>Description</th>
  13033. </tr>
  13034. </thead>
  13035. <tbody>
  13036. <tr>
  13037. <td>
  13038. <code>name</code></br>
  13039. <em>
  13040. string
  13041. </em>
  13042. </td>
  13043. <td>
  13044. <p>The name of the ConfigMap/Secret resource</p>
  13045. </td>
  13046. </tr>
  13047. <tr>
  13048. <td>
  13049. <code>items</code></br>
  13050. <em>
  13051. <a href="#external-secrets.io/v1.TemplateRefItem">
  13052. []TemplateRefItem
  13053. </a>
  13054. </em>
  13055. </td>
  13056. <td>
  13057. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  13058. </td>
  13059. </tr>
  13060. </tbody>
  13061. </table>
  13062. <h3 id="external-secrets.io/v1.TemplateRefItem">TemplateRefItem
  13063. </h3>
  13064. <p>
  13065. (<em>Appears on:</em>
  13066. <a href="#external-secrets.io/v1.TemplateRef">TemplateRef</a>)
  13067. </p>
  13068. <p>
  13069. <p>TemplateRefItem specifies a key in the ConfigMap/Secret to use as a template for Secret data.</p>
  13070. </p>
  13071. <table>
  13072. <thead>
  13073. <tr>
  13074. <th>Field</th>
  13075. <th>Description</th>
  13076. </tr>
  13077. </thead>
  13078. <tbody>
  13079. <tr>
  13080. <td>
  13081. <code>key</code></br>
  13082. <em>
  13083. string
  13084. </em>
  13085. </td>
  13086. <td>
  13087. <p>A key in the ConfigMap/Secret</p>
  13088. </td>
  13089. </tr>
  13090. <tr>
  13091. <td>
  13092. <code>templateAs</code></br>
  13093. <em>
  13094. <a href="#external-secrets.io/v1.TemplateScope">
  13095. TemplateScope
  13096. </a>
  13097. </em>
  13098. </td>
  13099. <td>
  13100. </td>
  13101. </tr>
  13102. </tbody>
  13103. </table>
  13104. <h3 id="external-secrets.io/v1.TemplateScope">TemplateScope
  13105. (<code>string</code> alias)</p></h3>
  13106. <p>
  13107. (<em>Appears on:</em>
  13108. <a href="#external-secrets.io/v1.TemplateRefItem">TemplateRefItem</a>)
  13109. </p>
  13110. <p>
  13111. <p>TemplateScope specifies how the template keys should be interpreted.</p>
  13112. </p>
  13113. <table>
  13114. <thead>
  13115. <tr>
  13116. <th>Value</th>
  13117. <th>Description</th>
  13118. </tr>
  13119. </thead>
  13120. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  13121. <td></td>
  13122. </tr><tr><td><p>&#34;Values&#34;</p></td>
  13123. <td></td>
  13124. </tr></tbody>
  13125. </table>
  13126. <h3 id="external-secrets.io/v1.TokenAuth">TokenAuth
  13127. </h3>
  13128. <p>
  13129. (<em>Appears on:</em>
  13130. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  13131. </p>
  13132. <p>
  13133. <p>TokenAuth defines token-based authentication configuration for Kubernetes.</p>
  13134. </p>
  13135. <table>
  13136. <thead>
  13137. <tr>
  13138. <th>Field</th>
  13139. <th>Description</th>
  13140. </tr>
  13141. </thead>
  13142. <tbody>
  13143. <tr>
  13144. <td>
  13145. <code>bearerToken</code></br>
  13146. <em>
  13147. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13148. External Secrets meta/v1.SecretKeySelector
  13149. </a>
  13150. </em>
  13151. </td>
  13152. <td>
  13153. </td>
  13154. </tr>
  13155. </tbody>
  13156. </table>
  13157. <h3 id="external-secrets.io/v1.TokenAuthCredentials">TokenAuthCredentials
  13158. </h3>
  13159. <p>
  13160. (<em>Appears on:</em>
  13161. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  13162. </p>
  13163. <p>
  13164. <p>TokenAuthCredentials represents the credentials for access token-based authentication.</p>
  13165. </p>
  13166. <table>
  13167. <thead>
  13168. <tr>
  13169. <th>Field</th>
  13170. <th>Description</th>
  13171. </tr>
  13172. </thead>
  13173. <tbody>
  13174. <tr>
  13175. <td>
  13176. <code>accessToken</code></br>
  13177. <em>
  13178. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13179. External Secrets meta/v1.SecretKeySelector
  13180. </a>
  13181. </em>
  13182. </td>
  13183. <td>
  13184. </td>
  13185. </tr>
  13186. </tbody>
  13187. </table>
  13188. <h3 id="external-secrets.io/v1.UniversalAuthCredentials">UniversalAuthCredentials
  13189. </h3>
  13190. <p>
  13191. (<em>Appears on:</em>
  13192. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  13193. </p>
  13194. <p>
  13195. <p>UniversalAuthCredentials represents the client credentials for universal authentication.</p>
  13196. </p>
  13197. <table>
  13198. <thead>
  13199. <tr>
  13200. <th>Field</th>
  13201. <th>Description</th>
  13202. </tr>
  13203. </thead>
  13204. <tbody>
  13205. <tr>
  13206. <td>
  13207. <code>clientId</code></br>
  13208. <em>
  13209. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13210. External Secrets meta/v1.SecretKeySelector
  13211. </a>
  13212. </em>
  13213. </td>
  13214. <td>
  13215. </td>
  13216. </tr>
  13217. <tr>
  13218. <td>
  13219. <code>clientSecret</code></br>
  13220. <em>
  13221. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13222. External Secrets meta/v1.SecretKeySelector
  13223. </a>
  13224. </em>
  13225. </td>
  13226. <td>
  13227. </td>
  13228. </tr>
  13229. </tbody>
  13230. </table>
  13231. <h3 id="external-secrets.io/v1.ValidationResult">ValidationResult
  13232. (<code>byte</code> alias)</p></h3>
  13233. <p>
  13234. (<em>Appears on:</em>
  13235. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  13236. </p>
  13237. <p>
  13238. <p>ValidationResult is defined type for the number of validation results.</p>
  13239. </p>
  13240. <table>
  13241. <thead>
  13242. <tr>
  13243. <th>Value</th>
  13244. <th>Description</th>
  13245. </tr>
  13246. </thead>
  13247. <tbody><tr><td><p>2</p></td>
  13248. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  13249. </td>
  13250. </tr><tr><td><p>0</p></td>
  13251. <td><p>ValidationResultReady indicates that the client is configured correctly
  13252. and can be used.</p>
  13253. </td>
  13254. </tr><tr><td><p>1</p></td>
  13255. <td><p>ValidationResultUnknown indicates that the client can be used
  13256. but information is missing, and it can not be validated.</p>
  13257. </td>
  13258. </tr></tbody>
  13259. </table>
  13260. <h3 id="external-secrets.io/v1.VaultAppRole">VaultAppRole
  13261. </h3>
  13262. <p>
  13263. (<em>Appears on:</em>
  13264. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13265. </p>
  13266. <p>
  13267. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  13268. with the role and secret stored in a Kubernetes Secret resource.</p>
  13269. </p>
  13270. <table>
  13271. <thead>
  13272. <tr>
  13273. <th>Field</th>
  13274. <th>Description</th>
  13275. </tr>
  13276. </thead>
  13277. <tbody>
  13278. <tr>
  13279. <td>
  13280. <code>path</code></br>
  13281. <em>
  13282. string
  13283. </em>
  13284. </td>
  13285. <td>
  13286. <p>Path where the App Role authentication backend is mounted
  13287. in Vault, e.g: &ldquo;approle&rdquo;</p>
  13288. </td>
  13289. </tr>
  13290. <tr>
  13291. <td>
  13292. <code>roleId</code></br>
  13293. <em>
  13294. string
  13295. </em>
  13296. </td>
  13297. <td>
  13298. <em>(Optional)</em>
  13299. <p>RoleID configured in the App Role authentication backend when setting
  13300. up the authentication backend in Vault.</p>
  13301. </td>
  13302. </tr>
  13303. <tr>
  13304. <td>
  13305. <code>roleRef</code></br>
  13306. <em>
  13307. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13308. External Secrets meta/v1.SecretKeySelector
  13309. </a>
  13310. </em>
  13311. </td>
  13312. <td>
  13313. <em>(Optional)</em>
  13314. <p>Reference to a key in a Secret that contains the App Role ID used
  13315. to authenticate with Vault.
  13316. The <code>key</code> field must be specified and denotes which entry within the Secret
  13317. resource is used as the app role id.</p>
  13318. </td>
  13319. </tr>
  13320. <tr>
  13321. <td>
  13322. <code>secretRef</code></br>
  13323. <em>
  13324. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13325. External Secrets meta/v1.SecretKeySelector
  13326. </a>
  13327. </em>
  13328. </td>
  13329. <td>
  13330. <p>Reference to a key in a Secret that contains the App Role secret used
  13331. to authenticate with Vault.
  13332. The <code>key</code> field must be specified and denotes which entry within the Secret
  13333. resource is used as the app role secret.</p>
  13334. </td>
  13335. </tr>
  13336. </tbody>
  13337. </table>
  13338. <h3 id="external-secrets.io/v1.VaultAuth">VaultAuth
  13339. </h3>
  13340. <p>
  13341. (<em>Appears on:</em>
  13342. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13343. </p>
  13344. <p>
  13345. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  13346. 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>
  13347. can be specified. A namespace to authenticate against can optionally be specified.</p>
  13348. </p>
  13349. <table>
  13350. <thead>
  13351. <tr>
  13352. <th>Field</th>
  13353. <th>Description</th>
  13354. </tr>
  13355. </thead>
  13356. <tbody>
  13357. <tr>
  13358. <td>
  13359. <code>namespace</code></br>
  13360. <em>
  13361. string
  13362. </em>
  13363. </td>
  13364. <td>
  13365. <em>(Optional)</em>
  13366. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  13367. Namespaces is a set of features within Vault Enterprise that allows
  13368. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  13369. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  13370. This will default to Vault.Namespace field if set, or empty otherwise</p>
  13371. </td>
  13372. </tr>
  13373. <tr>
  13374. <td>
  13375. <code>tokenSecretRef</code></br>
  13376. <em>
  13377. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13378. External Secrets meta/v1.SecretKeySelector
  13379. </a>
  13380. </em>
  13381. </td>
  13382. <td>
  13383. <em>(Optional)</em>
  13384. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  13385. </td>
  13386. </tr>
  13387. <tr>
  13388. <td>
  13389. <code>appRole</code></br>
  13390. <em>
  13391. <a href="#external-secrets.io/v1.VaultAppRole">
  13392. VaultAppRole
  13393. </a>
  13394. </em>
  13395. </td>
  13396. <td>
  13397. <em>(Optional)</em>
  13398. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  13399. with the role and secret stored in a Kubernetes Secret resource.</p>
  13400. </td>
  13401. </tr>
  13402. <tr>
  13403. <td>
  13404. <code>kubernetes</code></br>
  13405. <em>
  13406. <a href="#external-secrets.io/v1.VaultKubernetesAuth">
  13407. VaultKubernetesAuth
  13408. </a>
  13409. </em>
  13410. </td>
  13411. <td>
  13412. <em>(Optional)</em>
  13413. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  13414. token stored in the named Secret resource to the Vault server.</p>
  13415. </td>
  13416. </tr>
  13417. <tr>
  13418. <td>
  13419. <code>ldap</code></br>
  13420. <em>
  13421. <a href="#external-secrets.io/v1.VaultLdapAuth">
  13422. VaultLdapAuth
  13423. </a>
  13424. </em>
  13425. </td>
  13426. <td>
  13427. <em>(Optional)</em>
  13428. <p>Ldap authenticates with Vault by passing username/password pair using
  13429. the LDAP authentication method</p>
  13430. </td>
  13431. </tr>
  13432. <tr>
  13433. <td>
  13434. <code>jwt</code></br>
  13435. <em>
  13436. <a href="#external-secrets.io/v1.VaultJwtAuth">
  13437. VaultJwtAuth
  13438. </a>
  13439. </em>
  13440. </td>
  13441. <td>
  13442. <em>(Optional)</em>
  13443. <p>Jwt authenticates with Vault by passing role and JWT token using the
  13444. JWT/OIDC authentication method</p>
  13445. </td>
  13446. </tr>
  13447. <tr>
  13448. <td>
  13449. <code>cert</code></br>
  13450. <em>
  13451. <a href="#external-secrets.io/v1.VaultCertAuth">
  13452. VaultCertAuth
  13453. </a>
  13454. </em>
  13455. </td>
  13456. <td>
  13457. <em>(Optional)</em>
  13458. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  13459. Cert authentication method</p>
  13460. </td>
  13461. </tr>
  13462. <tr>
  13463. <td>
  13464. <code>iam</code></br>
  13465. <em>
  13466. <a href="#external-secrets.io/v1.VaultIamAuth">
  13467. VaultIamAuth
  13468. </a>
  13469. </em>
  13470. </td>
  13471. <td>
  13472. <em>(Optional)</em>
  13473. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  13474. AWS IAM authentication method</p>
  13475. </td>
  13476. </tr>
  13477. <tr>
  13478. <td>
  13479. <code>userPass</code></br>
  13480. <em>
  13481. <a href="#external-secrets.io/v1.VaultUserPassAuth">
  13482. VaultUserPassAuth
  13483. </a>
  13484. </em>
  13485. </td>
  13486. <td>
  13487. <em>(Optional)</em>
  13488. <p>UserPass authenticates with Vault by passing username/password pair</p>
  13489. </td>
  13490. </tr>
  13491. <tr>
  13492. <td>
  13493. <code>gcp</code></br>
  13494. <em>
  13495. <a href="#external-secrets.io/v1.VaultGCPAuth">
  13496. VaultGCPAuth
  13497. </a>
  13498. </em>
  13499. </td>
  13500. <td>
  13501. <em>(Optional)</em>
  13502. <p>Gcp authenticates with Vault using Google Cloud Platform authentication method
  13503. GCP authentication method</p>
  13504. </td>
  13505. </tr>
  13506. </tbody>
  13507. </table>
  13508. <h3 id="external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth
  13509. </h3>
  13510. <p>
  13511. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  13512. Only one of secretRef or jwt can be specified.
  13513. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  13514. </p>
  13515. <table>
  13516. <thead>
  13517. <tr>
  13518. <th>Field</th>
  13519. <th>Description</th>
  13520. </tr>
  13521. </thead>
  13522. <tbody>
  13523. <tr>
  13524. <td>
  13525. <code>secretRef</code></br>
  13526. <em>
  13527. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  13528. VaultAwsAuthSecretRef
  13529. </a>
  13530. </em>
  13531. </td>
  13532. <td>
  13533. <em>(Optional)</em>
  13534. </td>
  13535. </tr>
  13536. <tr>
  13537. <td>
  13538. <code>jwt</code></br>
  13539. <em>
  13540. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  13541. VaultAwsJWTAuth
  13542. </a>
  13543. </em>
  13544. </td>
  13545. <td>
  13546. <em>(Optional)</em>
  13547. </td>
  13548. </tr>
  13549. </tbody>
  13550. </table>
  13551. <h3 id="external-secrets.io/v1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  13552. </h3>
  13553. <p>
  13554. (<em>Appears on:</em>
  13555. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  13556. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  13557. </p>
  13558. <p>
  13559. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  13560. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  13561. </p>
  13562. <table>
  13563. <thead>
  13564. <tr>
  13565. <th>Field</th>
  13566. <th>Description</th>
  13567. </tr>
  13568. </thead>
  13569. <tbody>
  13570. <tr>
  13571. <td>
  13572. <code>accessKeyIDSecretRef</code></br>
  13573. <em>
  13574. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13575. External Secrets meta/v1.SecretKeySelector
  13576. </a>
  13577. </em>
  13578. </td>
  13579. <td>
  13580. <em>(Optional)</em>
  13581. <p>The AccessKeyID is used for authentication</p>
  13582. </td>
  13583. </tr>
  13584. <tr>
  13585. <td>
  13586. <code>secretAccessKeySecretRef</code></br>
  13587. <em>
  13588. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13589. External Secrets meta/v1.SecretKeySelector
  13590. </a>
  13591. </em>
  13592. </td>
  13593. <td>
  13594. <em>(Optional)</em>
  13595. <p>The SecretAccessKey is used for authentication</p>
  13596. </td>
  13597. </tr>
  13598. <tr>
  13599. <td>
  13600. <code>sessionTokenSecretRef</code></br>
  13601. <em>
  13602. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13603. External Secrets meta/v1.SecretKeySelector
  13604. </a>
  13605. </em>
  13606. </td>
  13607. <td>
  13608. <em>(Optional)</em>
  13609. <p>The SessionToken used for authentication
  13610. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  13611. 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>
  13612. </td>
  13613. </tr>
  13614. </tbody>
  13615. </table>
  13616. <h3 id="external-secrets.io/v1.VaultAwsJWTAuth">VaultAwsJWTAuth
  13617. </h3>
  13618. <p>
  13619. (<em>Appears on:</em>
  13620. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  13621. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  13622. </p>
  13623. <p>
  13624. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  13625. </p>
  13626. <table>
  13627. <thead>
  13628. <tr>
  13629. <th>Field</th>
  13630. <th>Description</th>
  13631. </tr>
  13632. </thead>
  13633. <tbody>
  13634. <tr>
  13635. <td>
  13636. <code>serviceAccountRef</code></br>
  13637. <em>
  13638. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  13639. External Secrets meta/v1.ServiceAccountSelector
  13640. </a>
  13641. </em>
  13642. </td>
  13643. <td>
  13644. <em>(Optional)</em>
  13645. </td>
  13646. </tr>
  13647. </tbody>
  13648. </table>
  13649. <h3 id="external-secrets.io/v1.VaultCertAuth">VaultCertAuth
  13650. </h3>
  13651. <p>
  13652. (<em>Appears on:</em>
  13653. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13654. </p>
  13655. <p>
  13656. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  13657. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  13658. </p>
  13659. <table>
  13660. <thead>
  13661. <tr>
  13662. <th>Field</th>
  13663. <th>Description</th>
  13664. </tr>
  13665. </thead>
  13666. <tbody>
  13667. <tr>
  13668. <td>
  13669. <code>path</code></br>
  13670. <em>
  13671. string
  13672. </em>
  13673. </td>
  13674. <td>
  13675. <em>(Optional)</em>
  13676. <p>Path where the Certificate authentication backend is mounted
  13677. in Vault, e.g: &ldquo;cert&rdquo;</p>
  13678. </td>
  13679. </tr>
  13680. <tr>
  13681. <td>
  13682. <code>vaultRole</code></br>
  13683. <em>
  13684. string
  13685. </em>
  13686. </td>
  13687. <td>
  13688. <em>(Optional)</em>
  13689. <p>VaultRole specifies the Vault role to use for TLS certificate authentication.</p>
  13690. </td>
  13691. </tr>
  13692. <tr>
  13693. <td>
  13694. <code>clientCert</code></br>
  13695. <em>
  13696. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13697. External Secrets meta/v1.SecretKeySelector
  13698. </a>
  13699. </em>
  13700. </td>
  13701. <td>
  13702. <em>(Optional)</em>
  13703. <p>ClientCert is a certificate to authenticate using the Cert Vault
  13704. authentication method</p>
  13705. </td>
  13706. </tr>
  13707. <tr>
  13708. <td>
  13709. <code>secretRef</code></br>
  13710. <em>
  13711. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13712. External Secrets meta/v1.SecretKeySelector
  13713. </a>
  13714. </em>
  13715. </td>
  13716. <td>
  13717. <em>(Optional)</em>
  13718. <p>SecretRef to a key in a Secret resource containing client private key to
  13719. authenticate with Vault using the Cert authentication method</p>
  13720. </td>
  13721. </tr>
  13722. </tbody>
  13723. </table>
  13724. <h3 id="external-secrets.io/v1.VaultCheckAndSet">VaultCheckAndSet
  13725. </h3>
  13726. <p>
  13727. (<em>Appears on:</em>
  13728. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13729. </p>
  13730. <p>
  13731. <p>VaultCheckAndSet defines the Check-And-Set (CAS) settings for Vault KV v2 PushSecret operations.</p>
  13732. </p>
  13733. <table>
  13734. <thead>
  13735. <tr>
  13736. <th>Field</th>
  13737. <th>Description</th>
  13738. </tr>
  13739. </thead>
  13740. <tbody>
  13741. <tr>
  13742. <td>
  13743. <code>required</code></br>
  13744. <em>
  13745. bool
  13746. </em>
  13747. </td>
  13748. <td>
  13749. <em>(Optional)</em>
  13750. <p>Required when true, all write operations must include a check-and-set parameter.
  13751. This helps prevent unintentional overwrites of secrets.</p>
  13752. </td>
  13753. </tr>
  13754. </tbody>
  13755. </table>
  13756. <h3 id="external-secrets.io/v1.VaultClientTLS">VaultClientTLS
  13757. </h3>
  13758. <p>
  13759. (<em>Appears on:</em>
  13760. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13761. </p>
  13762. <p>
  13763. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  13764. when the Vault server requires mutual authentication.</p>
  13765. </p>
  13766. <table>
  13767. <thead>
  13768. <tr>
  13769. <th>Field</th>
  13770. <th>Description</th>
  13771. </tr>
  13772. </thead>
  13773. <tbody>
  13774. <tr>
  13775. <td>
  13776. <code>certSecretRef</code></br>
  13777. <em>
  13778. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13779. External Secrets meta/v1.SecretKeySelector
  13780. </a>
  13781. </em>
  13782. </td>
  13783. <td>
  13784. <em>(Optional)</em>
  13785. <p>CertSecretRef is a certificate added to the transport layer
  13786. when communicating with the Vault server.
  13787. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  13788. </td>
  13789. </tr>
  13790. <tr>
  13791. <td>
  13792. <code>keySecretRef</code></br>
  13793. <em>
  13794. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13795. External Secrets meta/v1.SecretKeySelector
  13796. </a>
  13797. </em>
  13798. </td>
  13799. <td>
  13800. <em>(Optional)</em>
  13801. <p>KeySecretRef to a key in a Secret resource containing client private key
  13802. added to the transport layer when communicating with the Vault server.
  13803. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  13804. </td>
  13805. </tr>
  13806. </tbody>
  13807. </table>
  13808. <h3 id="external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth
  13809. </h3>
  13810. <p>
  13811. (<em>Appears on:</em>
  13812. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13813. </p>
  13814. <p>
  13815. <p>VaultGCPAuth authenticates with Vault using Google Cloud Platform authentication method.
  13816. Refer: <a href="https://developer.hashicorp.com/vault/docs/auth/gcp">https://developer.hashicorp.com/vault/docs/auth/gcp</a></p>
  13817. <p>When ServiceAccountRef, SecretRef and WorkloadIdentity are not specified, the provider will use the controller pod&rsquo;s
  13818. identity to authenticate with GCP. This supports both GKE Workload Identity and service account keys.</p>
  13819. </p>
  13820. <table>
  13821. <thead>
  13822. <tr>
  13823. <th>Field</th>
  13824. <th>Description</th>
  13825. </tr>
  13826. </thead>
  13827. <tbody>
  13828. <tr>
  13829. <td>
  13830. <code>path</code></br>
  13831. <em>
  13832. string
  13833. </em>
  13834. </td>
  13835. <td>
  13836. <em>(Optional)</em>
  13837. <p>Path where the GCP auth method is enabled in Vault, e.g: &ldquo;gcp&rdquo;</p>
  13838. </td>
  13839. </tr>
  13840. <tr>
  13841. <td>
  13842. <code>role</code></br>
  13843. <em>
  13844. string
  13845. </em>
  13846. </td>
  13847. <td>
  13848. <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>
  13849. </td>
  13850. </tr>
  13851. <tr>
  13852. <td>
  13853. <code>projectID</code></br>
  13854. <em>
  13855. string
  13856. </em>
  13857. </td>
  13858. <td>
  13859. <em>(Optional)</em>
  13860. <p>Project ID of the Google Cloud Platform project</p>
  13861. </td>
  13862. </tr>
  13863. <tr>
  13864. <td>
  13865. <code>location</code></br>
  13866. <em>
  13867. string
  13868. </em>
  13869. </td>
  13870. <td>
  13871. <em>(Optional)</em>
  13872. <p>Location optionally defines a location/region for the secret</p>
  13873. </td>
  13874. </tr>
  13875. <tr>
  13876. <td>
  13877. <code>secretRef</code></br>
  13878. <em>
  13879. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  13880. GCPSMAuthSecretRef
  13881. </a>
  13882. </em>
  13883. </td>
  13884. <td>
  13885. <em>(Optional)</em>
  13886. <p>Specify credentials in a Secret object</p>
  13887. </td>
  13888. </tr>
  13889. <tr>
  13890. <td>
  13891. <code>workloadIdentity</code></br>
  13892. <em>
  13893. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  13894. GCPWorkloadIdentity
  13895. </a>
  13896. </em>
  13897. </td>
  13898. <td>
  13899. <em>(Optional)</em>
  13900. <p>Specify a service account with Workload Identity</p>
  13901. </td>
  13902. </tr>
  13903. <tr>
  13904. <td>
  13905. <code>serviceAccountRef</code></br>
  13906. <em>
  13907. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  13908. External Secrets meta/v1.ServiceAccountSelector
  13909. </a>
  13910. </em>
  13911. </td>
  13912. <td>
  13913. <em>(Optional)</em>
  13914. <p>ServiceAccountRef to a service account for impersonation</p>
  13915. </td>
  13916. </tr>
  13917. </tbody>
  13918. </table>
  13919. <h3 id="external-secrets.io/v1.VaultIamAuth">VaultIamAuth
  13920. </h3>
  13921. <p>
  13922. (<em>Appears on:</em>
  13923. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13924. </p>
  13925. <p>
  13926. <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>
  13927. <p>When JWTAuth and SecretRef are not specified, the provider will use the controller pod&rsquo;s
  13928. identity to authenticate with AWS. This supports both IRSA and EKS Pod Identity.</p>
  13929. </p>
  13930. <table>
  13931. <thead>
  13932. <tr>
  13933. <th>Field</th>
  13934. <th>Description</th>
  13935. </tr>
  13936. </thead>
  13937. <tbody>
  13938. <tr>
  13939. <td>
  13940. <code>path</code></br>
  13941. <em>
  13942. string
  13943. </em>
  13944. </td>
  13945. <td>
  13946. <em>(Optional)</em>
  13947. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  13948. </td>
  13949. </tr>
  13950. <tr>
  13951. <td>
  13952. <code>region</code></br>
  13953. <em>
  13954. string
  13955. </em>
  13956. </td>
  13957. <td>
  13958. <em>(Optional)</em>
  13959. <p>AWS region</p>
  13960. </td>
  13961. </tr>
  13962. <tr>
  13963. <td>
  13964. <code>role</code></br>
  13965. <em>
  13966. string
  13967. </em>
  13968. </td>
  13969. <td>
  13970. <em>(Optional)</em>
  13971. <p>This is the AWS role to be assumed before talking to vault</p>
  13972. </td>
  13973. </tr>
  13974. <tr>
  13975. <td>
  13976. <code>vaultRole</code></br>
  13977. <em>
  13978. string
  13979. </em>
  13980. </td>
  13981. <td>
  13982. <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>
  13983. </td>
  13984. </tr>
  13985. <tr>
  13986. <td>
  13987. <code>externalID</code></br>
  13988. <em>
  13989. string
  13990. </em>
  13991. </td>
  13992. <td>
  13993. <p>AWS External ID set on assumed IAM roles</p>
  13994. </td>
  13995. </tr>
  13996. <tr>
  13997. <td>
  13998. <code>vaultAwsIamServerID</code></br>
  13999. <em>
  14000. string
  14001. </em>
  14002. </td>
  14003. <td>
  14004. <em>(Optional)</em>
  14005. <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>
  14006. </td>
  14007. </tr>
  14008. <tr>
  14009. <td>
  14010. <code>secretRef</code></br>
  14011. <em>
  14012. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  14013. VaultAwsAuthSecretRef
  14014. </a>
  14015. </em>
  14016. </td>
  14017. <td>
  14018. <em>(Optional)</em>
  14019. <p>Specify credentials in a Secret object</p>
  14020. </td>
  14021. </tr>
  14022. <tr>
  14023. <td>
  14024. <code>jwt</code></br>
  14025. <em>
  14026. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  14027. VaultAwsJWTAuth
  14028. </a>
  14029. </em>
  14030. </td>
  14031. <td>
  14032. <em>(Optional)</em>
  14033. <p>Specify a service account with IRSA enabled</p>
  14034. </td>
  14035. </tr>
  14036. </tbody>
  14037. </table>
  14038. <h3 id="external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth
  14039. </h3>
  14040. <p>
  14041. (<em>Appears on:</em>
  14042. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14043. </p>
  14044. <p>
  14045. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  14046. method, with the role name and a token stored in a Kubernetes Secret resource or
  14047. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  14048. </p>
  14049. <table>
  14050. <thead>
  14051. <tr>
  14052. <th>Field</th>
  14053. <th>Description</th>
  14054. </tr>
  14055. </thead>
  14056. <tbody>
  14057. <tr>
  14058. <td>
  14059. <code>path</code></br>
  14060. <em>
  14061. string
  14062. </em>
  14063. </td>
  14064. <td>
  14065. <p>Path where the JWT authentication backend is mounted
  14066. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  14067. </td>
  14068. </tr>
  14069. <tr>
  14070. <td>
  14071. <code>role</code></br>
  14072. <em>
  14073. string
  14074. </em>
  14075. </td>
  14076. <td>
  14077. <em>(Optional)</em>
  14078. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  14079. authentication method</p>
  14080. </td>
  14081. </tr>
  14082. <tr>
  14083. <td>
  14084. <code>secretRef</code></br>
  14085. <em>
  14086. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14087. External Secrets meta/v1.SecretKeySelector
  14088. </a>
  14089. </em>
  14090. </td>
  14091. <td>
  14092. <em>(Optional)</em>
  14093. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  14094. authenticate with Vault using the JWT/OIDC authentication method.</p>
  14095. </td>
  14096. </tr>
  14097. <tr>
  14098. <td>
  14099. <code>kubernetesServiceAccountToken</code></br>
  14100. <em>
  14101. <a href="#external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">
  14102. VaultKubernetesServiceAccountTokenAuth
  14103. </a>
  14104. </em>
  14105. </td>
  14106. <td>
  14107. <em>(Optional)</em>
  14108. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  14109. a token for with the <code>TokenRequest</code> API.</p>
  14110. </td>
  14111. </tr>
  14112. </tbody>
  14113. </table>
  14114. <h3 id="external-secrets.io/v1.VaultKVStoreVersion">VaultKVStoreVersion
  14115. (<code>string</code> alias)</p></h3>
  14116. <p>
  14117. (<em>Appears on:</em>
  14118. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  14119. </p>
  14120. <p>
  14121. <p>VaultKVStoreVersion represents the version of the Vault KV secret engine.</p>
  14122. </p>
  14123. <table>
  14124. <thead>
  14125. <tr>
  14126. <th>Value</th>
  14127. <th>Description</th>
  14128. </tr>
  14129. </thead>
  14130. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  14131. <td></td>
  14132. </tr><tr><td><p>&#34;v2&#34;</p></td>
  14133. <td></td>
  14134. </tr></tbody>
  14135. </table>
  14136. <h3 id="external-secrets.io/v1.VaultKubernetesAuth">VaultKubernetesAuth
  14137. </h3>
  14138. <p>
  14139. (<em>Appears on:</em>
  14140. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14141. </p>
  14142. <p>
  14143. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in
  14144. a Secret.</p>
  14145. </p>
  14146. <table>
  14147. <thead>
  14148. <tr>
  14149. <th>Field</th>
  14150. <th>Description</th>
  14151. </tr>
  14152. </thead>
  14153. <tbody>
  14154. <tr>
  14155. <td>
  14156. <code>mountPath</code></br>
  14157. <em>
  14158. string
  14159. </em>
  14160. </td>
  14161. <td>
  14162. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  14163. &ldquo;kubernetes&rdquo;</p>
  14164. </td>
  14165. </tr>
  14166. <tr>
  14167. <td>
  14168. <code>serviceAccountRef</code></br>
  14169. <em>
  14170. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14171. External Secrets meta/v1.ServiceAccountSelector
  14172. </a>
  14173. </em>
  14174. </td>
  14175. <td>
  14176. <em>(Optional)</em>
  14177. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  14178. If the service account is specified, the service account secret token JWT will be used
  14179. for authenticating with Vault. If the service account selector is not supplied,
  14180. the secretRef will be used instead.</p>
  14181. </td>
  14182. </tr>
  14183. <tr>
  14184. <td>
  14185. <code>secretRef</code></br>
  14186. <em>
  14187. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14188. External Secrets meta/v1.SecretKeySelector
  14189. </a>
  14190. </em>
  14191. </td>
  14192. <td>
  14193. <em>(Optional)</em>
  14194. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  14195. for authenticating with Vault. If a name is specified without a key,
  14196. <code>token</code> is the default. If one is not specified, the one bound to
  14197. the controller will be used.</p>
  14198. </td>
  14199. </tr>
  14200. <tr>
  14201. <td>
  14202. <code>role</code></br>
  14203. <em>
  14204. string
  14205. </em>
  14206. </td>
  14207. <td>
  14208. <p>A required field containing the Vault Role to assume. A Role binds a
  14209. Kubernetes ServiceAccount with a set of Vault policies.</p>
  14210. </td>
  14211. </tr>
  14212. </tbody>
  14213. </table>
  14214. <h3 id="external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  14215. </h3>
  14216. <p>
  14217. (<em>Appears on:</em>
  14218. <a href="#external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth</a>)
  14219. </p>
  14220. <p>
  14221. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  14222. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  14223. </p>
  14224. <table>
  14225. <thead>
  14226. <tr>
  14227. <th>Field</th>
  14228. <th>Description</th>
  14229. </tr>
  14230. </thead>
  14231. <tbody>
  14232. <tr>
  14233. <td>
  14234. <code>serviceAccountRef</code></br>
  14235. <em>
  14236. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  14237. External Secrets meta/v1.ServiceAccountSelector
  14238. </a>
  14239. </em>
  14240. </td>
  14241. <td>
  14242. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  14243. </td>
  14244. </tr>
  14245. <tr>
  14246. <td>
  14247. <code>audiences</code></br>
  14248. <em>
  14249. []string
  14250. </em>
  14251. </td>
  14252. <td>
  14253. <em>(Optional)</em>
  14254. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  14255. account token for the service account referenced by <code>serviceAccountRef</code>.
  14256. Defaults to a single audience <code>vault</code> it not specified.</p>
  14257. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  14258. </td>
  14259. </tr>
  14260. <tr>
  14261. <td>
  14262. <code>expirationSeconds</code></br>
  14263. <em>
  14264. int64
  14265. </em>
  14266. </td>
  14267. <td>
  14268. <em>(Optional)</em>
  14269. <p>Optional expiration time in seconds that will be used to request a temporary
  14270. Kubernetes service account token for the service account referenced by
  14271. <code>serviceAccountRef</code>.</p>
  14272. <p>Deprecated: this will be removed in the future.
  14273. Defaults to 10 minutes.</p>
  14274. </td>
  14275. </tr>
  14276. </tbody>
  14277. </table>
  14278. <h3 id="external-secrets.io/v1.VaultLdapAuth">VaultLdapAuth
  14279. </h3>
  14280. <p>
  14281. (<em>Appears on:</em>
  14282. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14283. </p>
  14284. <p>
  14285. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  14286. with the username and password stored in a Kubernetes Secret resource.</p>
  14287. </p>
  14288. <table>
  14289. <thead>
  14290. <tr>
  14291. <th>Field</th>
  14292. <th>Description</th>
  14293. </tr>
  14294. </thead>
  14295. <tbody>
  14296. <tr>
  14297. <td>
  14298. <code>path</code></br>
  14299. <em>
  14300. string
  14301. </em>
  14302. </td>
  14303. <td>
  14304. <p>Path where the LDAP authentication backend is mounted
  14305. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  14306. </td>
  14307. </tr>
  14308. <tr>
  14309. <td>
  14310. <code>username</code></br>
  14311. <em>
  14312. string
  14313. </em>
  14314. </td>
  14315. <td>
  14316. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  14317. authentication method</p>
  14318. </td>
  14319. </tr>
  14320. <tr>
  14321. <td>
  14322. <code>secretRef</code></br>
  14323. <em>
  14324. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14325. External Secrets meta/v1.SecretKeySelector
  14326. </a>
  14327. </em>
  14328. </td>
  14329. <td>
  14330. <em>(Optional)</em>
  14331. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  14332. user used to authenticate with Vault using the LDAP authentication
  14333. method</p>
  14334. </td>
  14335. </tr>
  14336. </tbody>
  14337. </table>
  14338. <h3 id="external-secrets.io/v1.VaultProvider">VaultProvider
  14339. </h3>
  14340. <p>
  14341. (<em>Appears on:</em>
  14342. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  14343. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  14344. </p>
  14345. <p>
  14346. <p>VaultProvider configures a store to sync secrets using a Hashicorp Vault KV backend.</p>
  14347. </p>
  14348. <table>
  14349. <thead>
  14350. <tr>
  14351. <th>Field</th>
  14352. <th>Description</th>
  14353. </tr>
  14354. </thead>
  14355. <tbody>
  14356. <tr>
  14357. <td>
  14358. <code>auth</code></br>
  14359. <em>
  14360. <a href="#external-secrets.io/v1.VaultAuth">
  14361. VaultAuth
  14362. </a>
  14363. </em>
  14364. </td>
  14365. <td>
  14366. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  14367. </td>
  14368. </tr>
  14369. <tr>
  14370. <td>
  14371. <code>server</code></br>
  14372. <em>
  14373. string
  14374. </em>
  14375. </td>
  14376. <td>
  14377. <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>
  14378. </td>
  14379. </tr>
  14380. <tr>
  14381. <td>
  14382. <code>path</code></br>
  14383. <em>
  14384. string
  14385. </em>
  14386. </td>
  14387. <td>
  14388. <em>(Optional)</em>
  14389. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  14390. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  14391. for fetching secrets from Vault is optional and will be appended
  14392. if not present in specified path.</p>
  14393. </td>
  14394. </tr>
  14395. <tr>
  14396. <td>
  14397. <code>version</code></br>
  14398. <em>
  14399. <a href="#external-secrets.io/v1.VaultKVStoreVersion">
  14400. VaultKVStoreVersion
  14401. </a>
  14402. </em>
  14403. </td>
  14404. <td>
  14405. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  14406. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  14407. </td>
  14408. </tr>
  14409. <tr>
  14410. <td>
  14411. <code>namespace</code></br>
  14412. <em>
  14413. string
  14414. </em>
  14415. </td>
  14416. <td>
  14417. <em>(Optional)</em>
  14418. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  14419. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  14420. 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>
  14421. </td>
  14422. </tr>
  14423. <tr>
  14424. <td>
  14425. <code>caBundle</code></br>
  14426. <em>
  14427. []byte
  14428. </em>
  14429. </td>
  14430. <td>
  14431. <em>(Optional)</em>
  14432. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  14433. if the Server URL is using HTTPS protocol. This parameter is ignored for
  14434. plain HTTP protocol connection. If not set the system root certificates
  14435. are used to validate the TLS connection.</p>
  14436. </td>
  14437. </tr>
  14438. <tr>
  14439. <td>
  14440. <code>tls</code></br>
  14441. <em>
  14442. <a href="#external-secrets.io/v1.VaultClientTLS">
  14443. VaultClientTLS
  14444. </a>
  14445. </em>
  14446. </td>
  14447. <td>
  14448. <em>(Optional)</em>
  14449. <p>The configuration used for client side related TLS communication, when the Vault server
  14450. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  14451. This parameter is ignored for plain HTTP protocol connection.
  14452. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  14453. which is available under the <code>auth.cert</code> section.</p>
  14454. </td>
  14455. </tr>
  14456. <tr>
  14457. <td>
  14458. <code>caProvider</code></br>
  14459. <em>
  14460. <a href="#external-secrets.io/v1.CAProvider">
  14461. CAProvider
  14462. </a>
  14463. </em>
  14464. </td>
  14465. <td>
  14466. <em>(Optional)</em>
  14467. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  14468. </td>
  14469. </tr>
  14470. <tr>
  14471. <td>
  14472. <code>readYourWrites</code></br>
  14473. <em>
  14474. bool
  14475. </em>
  14476. </td>
  14477. <td>
  14478. <em>(Optional)</em>
  14479. <p>ReadYourWrites ensures isolated read-after-write semantics by
  14480. providing discovered cluster replication states in each request.
  14481. More information about eventual consistency in Vault can be found here
  14482. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  14483. </td>
  14484. </tr>
  14485. <tr>
  14486. <td>
  14487. <code>forwardInconsistent</code></br>
  14488. <em>
  14489. bool
  14490. </em>
  14491. </td>
  14492. <td>
  14493. <em>(Optional)</em>
  14494. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  14495. leader instead of simply retrying within a loop. This can increase performance if
  14496. the option is enabled serverside.
  14497. <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>
  14498. </td>
  14499. </tr>
  14500. <tr>
  14501. <td>
  14502. <code>headers</code></br>
  14503. <em>
  14504. map[string]string
  14505. </em>
  14506. </td>
  14507. <td>
  14508. <em>(Optional)</em>
  14509. <p>Headers to be added in Vault request</p>
  14510. </td>
  14511. </tr>
  14512. <tr>
  14513. <td>
  14514. <code>checkAndSet</code></br>
  14515. <em>
  14516. <a href="#external-secrets.io/v1.VaultCheckAndSet">
  14517. VaultCheckAndSet
  14518. </a>
  14519. </em>
  14520. </td>
  14521. <td>
  14522. <em>(Optional)</em>
  14523. <p>CheckAndSet defines the Check-And-Set (CAS) settings for PushSecret operations.
  14524. Only applies to Vault KV v2 stores. When enabled, write operations must include
  14525. the current version of the secret to prevent unintentional overwrites.</p>
  14526. </td>
  14527. </tr>
  14528. </tbody>
  14529. </table>
  14530. <h3 id="external-secrets.io/v1.VaultUserPassAuth">VaultUserPassAuth
  14531. </h3>
  14532. <p>
  14533. (<em>Appears on:</em>
  14534. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  14535. </p>
  14536. <p>
  14537. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  14538. with the username and password stored in a Kubernetes Secret resource.</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. <p>Path where the UserPassword authentication backend is mounted
  14557. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  14558. </td>
  14559. </tr>
  14560. <tr>
  14561. <td>
  14562. <code>username</code></br>
  14563. <em>
  14564. string
  14565. </em>
  14566. </td>
  14567. <td>
  14568. <p>Username is a username used to authenticate using the UserPass Vault
  14569. authentication method</p>
  14570. </td>
  14571. </tr>
  14572. <tr>
  14573. <td>
  14574. <code>secretRef</code></br>
  14575. <em>
  14576. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14577. External Secrets meta/v1.SecretKeySelector
  14578. </a>
  14579. </em>
  14580. </td>
  14581. <td>
  14582. <em>(Optional)</em>
  14583. <p>SecretRef to a key in a Secret resource containing password for the
  14584. user used to authenticate with Vault using the UserPass authentication
  14585. method</p>
  14586. </td>
  14587. </tr>
  14588. </tbody>
  14589. </table>
  14590. <h3 id="external-secrets.io/v1.VolcengineAuth">VolcengineAuth
  14591. </h3>
  14592. <p>
  14593. (<em>Appears on:</em>
  14594. <a href="#external-secrets.io/v1.VolcengineProvider">VolcengineProvider</a>)
  14595. </p>
  14596. <p>
  14597. <p>VolcengineAuth defines the authentication method for the Volcengine provider.
  14598. Only one of the fields should be set.</p>
  14599. </p>
  14600. <table>
  14601. <thead>
  14602. <tr>
  14603. <th>Field</th>
  14604. <th>Description</th>
  14605. </tr>
  14606. </thead>
  14607. <tbody>
  14608. <tr>
  14609. <td>
  14610. <code>secretRef</code></br>
  14611. <em>
  14612. <a href="#external-secrets.io/v1.VolcengineAuthSecretRef">
  14613. VolcengineAuthSecretRef
  14614. </a>
  14615. </em>
  14616. </td>
  14617. <td>
  14618. <em>(Optional)</em>
  14619. <p>SecretRef defines the static credentials to use for authentication.
  14620. If not set, IRSA is used.</p>
  14621. </td>
  14622. </tr>
  14623. </tbody>
  14624. </table>
  14625. <h3 id="external-secrets.io/v1.VolcengineAuthSecretRef">VolcengineAuthSecretRef
  14626. </h3>
  14627. <p>
  14628. (<em>Appears on:</em>
  14629. <a href="#external-secrets.io/v1.VolcengineAuth">VolcengineAuth</a>)
  14630. </p>
  14631. <p>
  14632. <p>VolcengineAuthSecretRef defines the secret reference for static credentials.</p>
  14633. </p>
  14634. <table>
  14635. <thead>
  14636. <tr>
  14637. <th>Field</th>
  14638. <th>Description</th>
  14639. </tr>
  14640. </thead>
  14641. <tbody>
  14642. <tr>
  14643. <td>
  14644. <code>accessKeyID</code></br>
  14645. <em>
  14646. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14647. External Secrets meta/v1.SecretKeySelector
  14648. </a>
  14649. </em>
  14650. </td>
  14651. <td>
  14652. <p>AccessKeyID is the reference to the secret containing the Access Key ID.</p>
  14653. </td>
  14654. </tr>
  14655. <tr>
  14656. <td>
  14657. <code>secretAccessKey</code></br>
  14658. <em>
  14659. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14660. External Secrets meta/v1.SecretKeySelector
  14661. </a>
  14662. </em>
  14663. </td>
  14664. <td>
  14665. <p>SecretAccessKey is the reference to the secret containing the Secret Access Key.</p>
  14666. </td>
  14667. </tr>
  14668. <tr>
  14669. <td>
  14670. <code>token</code></br>
  14671. <em>
  14672. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14673. External Secrets meta/v1.SecretKeySelector
  14674. </a>
  14675. </em>
  14676. </td>
  14677. <td>
  14678. <em>(Optional)</em>
  14679. <p>Token is the reference to the secret containing the STS(Security Token Service) Token.</p>
  14680. </td>
  14681. </tr>
  14682. </tbody>
  14683. </table>
  14684. <h3 id="external-secrets.io/v1.VolcengineProvider">VolcengineProvider
  14685. </h3>
  14686. <p>
  14687. (<em>Appears on:</em>
  14688. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  14689. </p>
  14690. <p>
  14691. <p>VolcengineProvider defines the configuration for the Volcengine provider.</p>
  14692. </p>
  14693. <table>
  14694. <thead>
  14695. <tr>
  14696. <th>Field</th>
  14697. <th>Description</th>
  14698. </tr>
  14699. </thead>
  14700. <tbody>
  14701. <tr>
  14702. <td>
  14703. <code>region</code></br>
  14704. <em>
  14705. string
  14706. </em>
  14707. </td>
  14708. <td>
  14709. <p>Region specifies the Volcengine region to connect to.</p>
  14710. </td>
  14711. </tr>
  14712. <tr>
  14713. <td>
  14714. <code>auth</code></br>
  14715. <em>
  14716. <a href="#external-secrets.io/v1.VolcengineAuth">
  14717. VolcengineAuth
  14718. </a>
  14719. </em>
  14720. </td>
  14721. <td>
  14722. <em>(Optional)</em>
  14723. <p>Auth defines the authentication method to use.
  14724. If not specified, the provider will try to use IRSA (IAM Role for Service Account).</p>
  14725. </td>
  14726. </tr>
  14727. </tbody>
  14728. </table>
  14729. <h3 id="external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider
  14730. </h3>
  14731. <p>
  14732. (<em>Appears on:</em>
  14733. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  14734. </p>
  14735. <p>
  14736. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  14737. </p>
  14738. <table>
  14739. <thead>
  14740. <tr>
  14741. <th>Field</th>
  14742. <th>Description</th>
  14743. </tr>
  14744. </thead>
  14745. <tbody>
  14746. <tr>
  14747. <td>
  14748. <code>type</code></br>
  14749. <em>
  14750. <a href="#external-secrets.io/v1.WebhookCAProviderType">
  14751. WebhookCAProviderType
  14752. </a>
  14753. </em>
  14754. </td>
  14755. <td>
  14756. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  14757. </td>
  14758. </tr>
  14759. <tr>
  14760. <td>
  14761. <code>name</code></br>
  14762. <em>
  14763. string
  14764. </em>
  14765. </td>
  14766. <td>
  14767. <p>The name of the object located at the provider type.</p>
  14768. </td>
  14769. </tr>
  14770. <tr>
  14771. <td>
  14772. <code>key</code></br>
  14773. <em>
  14774. string
  14775. </em>
  14776. </td>
  14777. <td>
  14778. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  14779. </td>
  14780. </tr>
  14781. <tr>
  14782. <td>
  14783. <code>namespace</code></br>
  14784. <em>
  14785. string
  14786. </em>
  14787. </td>
  14788. <td>
  14789. <em>(Optional)</em>
  14790. <p>The namespace the Provider type is in.</p>
  14791. </td>
  14792. </tr>
  14793. </tbody>
  14794. </table>
  14795. <h3 id="external-secrets.io/v1.WebhookCAProviderType">WebhookCAProviderType
  14796. (<code>string</code> alias)</p></h3>
  14797. <p>
  14798. (<em>Appears on:</em>
  14799. <a href="#external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider</a>)
  14800. </p>
  14801. <p>
  14802. <p>WebhookCAProviderType defines the type of provider for certificate authority in webhook connections.</p>
  14803. </p>
  14804. <table>
  14805. <thead>
  14806. <tr>
  14807. <th>Value</th>
  14808. <th>Description</th>
  14809. </tr>
  14810. </thead>
  14811. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  14812. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  14813. </td>
  14814. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  14815. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  14816. </td>
  14817. </tr></tbody>
  14818. </table>
  14819. <h3 id="external-secrets.io/v1.WebhookProvider">WebhookProvider
  14820. </h3>
  14821. <p>
  14822. (<em>Appears on:</em>
  14823. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  14824. </p>
  14825. <p>
  14826. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  14827. </p>
  14828. <table>
  14829. <thead>
  14830. <tr>
  14831. <th>Field</th>
  14832. <th>Description</th>
  14833. </tr>
  14834. </thead>
  14835. <tbody>
  14836. <tr>
  14837. <td>
  14838. <code>method</code></br>
  14839. <em>
  14840. string
  14841. </em>
  14842. </td>
  14843. <td>
  14844. <p>Webhook Method</p>
  14845. </td>
  14846. </tr>
  14847. <tr>
  14848. <td>
  14849. <code>url</code></br>
  14850. <em>
  14851. string
  14852. </em>
  14853. </td>
  14854. <td>
  14855. <p>Webhook url to call</p>
  14856. </td>
  14857. </tr>
  14858. <tr>
  14859. <td>
  14860. <code>headers</code></br>
  14861. <em>
  14862. map[string]string
  14863. </em>
  14864. </td>
  14865. <td>
  14866. <em>(Optional)</em>
  14867. <p>Headers</p>
  14868. </td>
  14869. </tr>
  14870. <tr>
  14871. <td>
  14872. <code>auth</code></br>
  14873. <em>
  14874. <a href="#external-secrets.io/v1.AuthorizationProtocol">
  14875. AuthorizationProtocol
  14876. </a>
  14877. </em>
  14878. </td>
  14879. <td>
  14880. <em>(Optional)</em>
  14881. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  14882. </td>
  14883. </tr>
  14884. <tr>
  14885. <td>
  14886. <code>body</code></br>
  14887. <em>
  14888. string
  14889. </em>
  14890. </td>
  14891. <td>
  14892. <em>(Optional)</em>
  14893. <p>Body</p>
  14894. </td>
  14895. </tr>
  14896. <tr>
  14897. <td>
  14898. <code>timeout</code></br>
  14899. <em>
  14900. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14901. Kubernetes meta/v1.Duration
  14902. </a>
  14903. </em>
  14904. </td>
  14905. <td>
  14906. <em>(Optional)</em>
  14907. <p>Timeout</p>
  14908. </td>
  14909. </tr>
  14910. <tr>
  14911. <td>
  14912. <code>result</code></br>
  14913. <em>
  14914. <a href="#external-secrets.io/v1.WebhookResult">
  14915. WebhookResult
  14916. </a>
  14917. </em>
  14918. </td>
  14919. <td>
  14920. <em>(Optional)</em>
  14921. <p>Result formatting</p>
  14922. </td>
  14923. </tr>
  14924. <tr>
  14925. <td>
  14926. <code>secrets</code></br>
  14927. <em>
  14928. <a href="#external-secrets.io/v1.WebhookSecret">
  14929. []WebhookSecret
  14930. </a>
  14931. </em>
  14932. </td>
  14933. <td>
  14934. <em>(Optional)</em>
  14935. <p>Secrets to fill in templates
  14936. These secrets will be passed to the templating function as key value pairs under the given name</p>
  14937. </td>
  14938. </tr>
  14939. <tr>
  14940. <td>
  14941. <code>caBundle</code></br>
  14942. <em>
  14943. []byte
  14944. </em>
  14945. </td>
  14946. <td>
  14947. <em>(Optional)</em>
  14948. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  14949. if the Server URL is using HTTPS protocol. This parameter is ignored for
  14950. plain HTTP protocol connection. If not set the system root certificates
  14951. are used to validate the TLS connection.</p>
  14952. </td>
  14953. </tr>
  14954. <tr>
  14955. <td>
  14956. <code>caProvider</code></br>
  14957. <em>
  14958. <a href="#external-secrets.io/v1.WebhookCAProvider">
  14959. WebhookCAProvider
  14960. </a>
  14961. </em>
  14962. </td>
  14963. <td>
  14964. <em>(Optional)</em>
  14965. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  14966. </td>
  14967. </tr>
  14968. </tbody>
  14969. </table>
  14970. <h3 id="external-secrets.io/v1.WebhookResult">WebhookResult
  14971. </h3>
  14972. <p>
  14973. (<em>Appears on:</em>
  14974. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  14975. </p>
  14976. <p>
  14977. <p>WebhookResult defines how to process and extract secrets from the webhook response.</p>
  14978. </p>
  14979. <table>
  14980. <thead>
  14981. <tr>
  14982. <th>Field</th>
  14983. <th>Description</th>
  14984. </tr>
  14985. </thead>
  14986. <tbody>
  14987. <tr>
  14988. <td>
  14989. <code>jsonPath</code></br>
  14990. <em>
  14991. string
  14992. </em>
  14993. </td>
  14994. <td>
  14995. <em>(Optional)</em>
  14996. <p>Json path of return value</p>
  14997. </td>
  14998. </tr>
  14999. </tbody>
  15000. </table>
  15001. <h3 id="external-secrets.io/v1.WebhookSecret">WebhookSecret
  15002. </h3>
  15003. <p>
  15004. (<em>Appears on:</em>
  15005. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  15006. </p>
  15007. <p>
  15008. <p>WebhookSecret defines a secret that will be passed to the webhook request.</p>
  15009. </p>
  15010. <table>
  15011. <thead>
  15012. <tr>
  15013. <th>Field</th>
  15014. <th>Description</th>
  15015. </tr>
  15016. </thead>
  15017. <tbody>
  15018. <tr>
  15019. <td>
  15020. <code>name</code></br>
  15021. <em>
  15022. string
  15023. </em>
  15024. </td>
  15025. <td>
  15026. <p>Name of this secret in templates</p>
  15027. </td>
  15028. </tr>
  15029. <tr>
  15030. <td>
  15031. <code>secretRef</code></br>
  15032. <em>
  15033. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15034. External Secrets meta/v1.SecretKeySelector
  15035. </a>
  15036. </em>
  15037. </td>
  15038. <td>
  15039. <p>Secret ref to fill in credentials</p>
  15040. </td>
  15041. </tr>
  15042. </tbody>
  15043. </table>
  15044. <h3 id="external-secrets.io/v1.YandexAuth">YandexAuth
  15045. </h3>
  15046. <p>
  15047. (<em>Appears on:</em>
  15048. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  15049. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  15050. </p>
  15051. <p>
  15052. <p>YandexAuth defines the authentication method for the Yandex provider.</p>
  15053. </p>
  15054. <table>
  15055. <thead>
  15056. <tr>
  15057. <th>Field</th>
  15058. <th>Description</th>
  15059. </tr>
  15060. </thead>
  15061. <tbody>
  15062. <tr>
  15063. <td>
  15064. <code>authorizedKeySecretRef</code></br>
  15065. <em>
  15066. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15067. External Secrets meta/v1.SecretKeySelector
  15068. </a>
  15069. </em>
  15070. </td>
  15071. <td>
  15072. <em>(Optional)</em>
  15073. <p>The authorized key used for authentication</p>
  15074. </td>
  15075. </tr>
  15076. </tbody>
  15077. </table>
  15078. <h3 id="external-secrets.io/v1.YandexCAProvider">YandexCAProvider
  15079. </h3>
  15080. <p>
  15081. (<em>Appears on:</em>
  15082. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  15083. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  15084. </p>
  15085. <p>
  15086. <p>YandexCAProvider defines the configuration for Yandex custom certificate authority.</p>
  15087. </p>
  15088. <table>
  15089. <thead>
  15090. <tr>
  15091. <th>Field</th>
  15092. <th>Description</th>
  15093. </tr>
  15094. </thead>
  15095. <tbody>
  15096. <tr>
  15097. <td>
  15098. <code>certSecretRef</code></br>
  15099. <em>
  15100. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15101. External Secrets meta/v1.SecretKeySelector
  15102. </a>
  15103. </em>
  15104. </td>
  15105. <td>
  15106. </td>
  15107. </tr>
  15108. </tbody>
  15109. </table>
  15110. <h3 id="external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  15111. </h3>
  15112. <p>
  15113. (<em>Appears on:</em>
  15114. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15115. </p>
  15116. <p>
  15117. <p>YandexCertificateManagerProvider Configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  15118. </p>
  15119. <table>
  15120. <thead>
  15121. <tr>
  15122. <th>Field</th>
  15123. <th>Description</th>
  15124. </tr>
  15125. </thead>
  15126. <tbody>
  15127. <tr>
  15128. <td>
  15129. <code>apiEndpoint</code></br>
  15130. <em>
  15131. string
  15132. </em>
  15133. </td>
  15134. <td>
  15135. <em>(Optional)</em>
  15136. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  15137. </td>
  15138. </tr>
  15139. <tr>
  15140. <td>
  15141. <code>auth</code></br>
  15142. <em>
  15143. <a href="#external-secrets.io/v1.YandexAuth">
  15144. YandexAuth
  15145. </a>
  15146. </em>
  15147. </td>
  15148. <td>
  15149. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  15150. </td>
  15151. </tr>
  15152. <tr>
  15153. <td>
  15154. <code>caProvider</code></br>
  15155. <em>
  15156. <a href="#external-secrets.io/v1.YandexCAProvider">
  15157. YandexCAProvider
  15158. </a>
  15159. </em>
  15160. </td>
  15161. <td>
  15162. <em>(Optional)</em>
  15163. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  15164. </td>
  15165. </tr>
  15166. <tr>
  15167. <td>
  15168. <code>fetching</code></br>
  15169. <em>
  15170. <a href="#external-secrets.io/v1.FetchingPolicy">
  15171. FetchingPolicy
  15172. </a>
  15173. </em>
  15174. </td>
  15175. <td>
  15176. <em>(Optional)</em>
  15177. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as certificate ID or certificate name</p>
  15178. </td>
  15179. </tr>
  15180. </tbody>
  15181. </table>
  15182. <h3 id="external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider
  15183. </h3>
  15184. <p>
  15185. (<em>Appears on:</em>
  15186. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  15187. </p>
  15188. <p>
  15189. <p>YandexLockboxProvider Configures a store to sync secrets using the Yandex Lockbox provider.</p>
  15190. </p>
  15191. <table>
  15192. <thead>
  15193. <tr>
  15194. <th>Field</th>
  15195. <th>Description</th>
  15196. </tr>
  15197. </thead>
  15198. <tbody>
  15199. <tr>
  15200. <td>
  15201. <code>apiEndpoint</code></br>
  15202. <em>
  15203. string
  15204. </em>
  15205. </td>
  15206. <td>
  15207. <em>(Optional)</em>
  15208. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  15209. </td>
  15210. </tr>
  15211. <tr>
  15212. <td>
  15213. <code>auth</code></br>
  15214. <em>
  15215. <a href="#external-secrets.io/v1.YandexAuth">
  15216. YandexAuth
  15217. </a>
  15218. </em>
  15219. </td>
  15220. <td>
  15221. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  15222. </td>
  15223. </tr>
  15224. <tr>
  15225. <td>
  15226. <code>caProvider</code></br>
  15227. <em>
  15228. <a href="#external-secrets.io/v1.YandexCAProvider">
  15229. YandexCAProvider
  15230. </a>
  15231. </em>
  15232. </td>
  15233. <td>
  15234. <em>(Optional)</em>
  15235. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  15236. </td>
  15237. </tr>
  15238. <tr>
  15239. <td>
  15240. <code>fetching</code></br>
  15241. <em>
  15242. <a href="#external-secrets.io/v1.FetchingPolicy">
  15243. FetchingPolicy
  15244. </a>
  15245. </em>
  15246. </td>
  15247. <td>
  15248. <em>(Optional)</em>
  15249. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID or secret name</p>
  15250. </td>
  15251. </tr>
  15252. </tbody>
  15253. </table>
  15254. <hr/>
  15255. <h2 id="external-secrets.io/v1alpha1">external-secrets.io/v1alpha1</h2>
  15256. <p>
  15257. <p>Package v1alpha1 contains resources for external-secrets</p>
  15258. </p>
  15259. <p>Resource Types:</p>
  15260. <ul></ul>
  15261. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret
  15262. </h3>
  15263. <p>
  15264. <p>ClusterPushSecret is the Schema for the ClusterPushSecrets API that enables cluster-wide management of pushing Kubernetes secrets to external providers.</p>
  15265. </p>
  15266. <table>
  15267. <thead>
  15268. <tr>
  15269. <th>Field</th>
  15270. <th>Description</th>
  15271. </tr>
  15272. </thead>
  15273. <tbody>
  15274. <tr>
  15275. <td>
  15276. <code>metadata</code></br>
  15277. <em>
  15278. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  15279. Kubernetes meta/v1.ObjectMeta
  15280. </a>
  15281. </em>
  15282. </td>
  15283. <td>
  15284. Refer to the Kubernetes API documentation for the fields of the
  15285. <code>metadata</code> field.
  15286. </td>
  15287. </tr>
  15288. <tr>
  15289. <td>
  15290. <code>spec</code></br>
  15291. <em>
  15292. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">
  15293. ClusterPushSecretSpec
  15294. </a>
  15295. </em>
  15296. </td>
  15297. <td>
  15298. <br/>
  15299. <br/>
  15300. <table>
  15301. <tr>
  15302. <td>
  15303. <code>pushSecretSpec</code></br>
  15304. <em>
  15305. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15306. PushSecretSpec
  15307. </a>
  15308. </em>
  15309. </td>
  15310. <td>
  15311. <p>PushSecretSpec defines what to do with the secrets.</p>
  15312. </td>
  15313. </tr>
  15314. <tr>
  15315. <td>
  15316. <code>refreshTime</code></br>
  15317. <em>
  15318. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15319. Kubernetes meta/v1.Duration
  15320. </a>
  15321. </em>
  15322. </td>
  15323. <td>
  15324. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  15325. </td>
  15326. </tr>
  15327. <tr>
  15328. <td>
  15329. <code>pushSecretName</code></br>
  15330. <em>
  15331. string
  15332. </em>
  15333. </td>
  15334. <td>
  15335. <em>(Optional)</em>
  15336. <p>The name of the push secrets to be created.
  15337. Defaults to the name of the ClusterPushSecret</p>
  15338. </td>
  15339. </tr>
  15340. <tr>
  15341. <td>
  15342. <code>pushSecretMetadata</code></br>
  15343. <em>
  15344. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  15345. PushSecretMetadata
  15346. </a>
  15347. </em>
  15348. </td>
  15349. <td>
  15350. <em>(Optional)</em>
  15351. <p>The metadata of the external secrets to be created</p>
  15352. </td>
  15353. </tr>
  15354. <tr>
  15355. <td>
  15356. <code>namespaceSelectors</code></br>
  15357. <em>
  15358. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  15359. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  15360. </a>
  15361. </em>
  15362. </td>
  15363. <td>
  15364. <em>(Optional)</em>
  15365. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  15366. </td>
  15367. </tr>
  15368. </table>
  15369. </td>
  15370. </tr>
  15371. <tr>
  15372. <td>
  15373. <code>status</code></br>
  15374. <em>
  15375. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">
  15376. ClusterPushSecretStatus
  15377. </a>
  15378. </em>
  15379. </td>
  15380. <td>
  15381. </td>
  15382. </tr>
  15383. </tbody>
  15384. </table>
  15385. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretCondition">ClusterPushSecretCondition
  15386. </h3>
  15387. <p>
  15388. <p>ClusterPushSecretCondition used to refine PushSecrets to specific namespaces and names.</p>
  15389. </p>
  15390. <table>
  15391. <thead>
  15392. <tr>
  15393. <th>Field</th>
  15394. <th>Description</th>
  15395. </tr>
  15396. </thead>
  15397. <tbody>
  15398. <tr>
  15399. <td>
  15400. <code>namespaceSelector</code></br>
  15401. <em>
  15402. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  15403. Kubernetes meta/v1.LabelSelector
  15404. </a>
  15405. </em>
  15406. </td>
  15407. <td>
  15408. <em>(Optional)</em>
  15409. <p>Choose namespace using a labelSelector</p>
  15410. </td>
  15411. </tr>
  15412. <tr>
  15413. <td>
  15414. <code>namespaces</code></br>
  15415. <em>
  15416. []string
  15417. </em>
  15418. </td>
  15419. <td>
  15420. <em>(Optional)</em>
  15421. <p>Choose namespaces by name</p>
  15422. </td>
  15423. </tr>
  15424. </tbody>
  15425. </table>
  15426. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">ClusterPushSecretNamespaceFailure
  15427. </h3>
  15428. <p>
  15429. (<em>Appears on:</em>
  15430. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>)
  15431. </p>
  15432. <p>
  15433. <p>ClusterPushSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  15434. </p>
  15435. <table>
  15436. <thead>
  15437. <tr>
  15438. <th>Field</th>
  15439. <th>Description</th>
  15440. </tr>
  15441. </thead>
  15442. <tbody>
  15443. <tr>
  15444. <td>
  15445. <code>namespace</code></br>
  15446. <em>
  15447. string
  15448. </em>
  15449. </td>
  15450. <td>
  15451. <p>Namespace is the namespace that failed when trying to apply an PushSecret</p>
  15452. </td>
  15453. </tr>
  15454. <tr>
  15455. <td>
  15456. <code>reason</code></br>
  15457. <em>
  15458. string
  15459. </em>
  15460. </td>
  15461. <td>
  15462. <em>(Optional)</em>
  15463. <p>Reason is why the PushSecret failed to apply to the namespace</p>
  15464. </td>
  15465. </tr>
  15466. </tbody>
  15467. </table>
  15468. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec
  15469. </h3>
  15470. <p>
  15471. (<em>Appears on:</em>
  15472. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  15473. </p>
  15474. <p>
  15475. <p>ClusterPushSecretSpec defines the configuration for a ClusterPushSecret resource.</p>
  15476. </p>
  15477. <table>
  15478. <thead>
  15479. <tr>
  15480. <th>Field</th>
  15481. <th>Description</th>
  15482. </tr>
  15483. </thead>
  15484. <tbody>
  15485. <tr>
  15486. <td>
  15487. <code>pushSecretSpec</code></br>
  15488. <em>
  15489. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15490. PushSecretSpec
  15491. </a>
  15492. </em>
  15493. </td>
  15494. <td>
  15495. <p>PushSecretSpec defines what to do with the secrets.</p>
  15496. </td>
  15497. </tr>
  15498. <tr>
  15499. <td>
  15500. <code>refreshTime</code></br>
  15501. <em>
  15502. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15503. Kubernetes meta/v1.Duration
  15504. </a>
  15505. </em>
  15506. </td>
  15507. <td>
  15508. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  15509. </td>
  15510. </tr>
  15511. <tr>
  15512. <td>
  15513. <code>pushSecretName</code></br>
  15514. <em>
  15515. string
  15516. </em>
  15517. </td>
  15518. <td>
  15519. <em>(Optional)</em>
  15520. <p>The name of the push secrets to be created.
  15521. Defaults to the name of the ClusterPushSecret</p>
  15522. </td>
  15523. </tr>
  15524. <tr>
  15525. <td>
  15526. <code>pushSecretMetadata</code></br>
  15527. <em>
  15528. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  15529. PushSecretMetadata
  15530. </a>
  15531. </em>
  15532. </td>
  15533. <td>
  15534. <em>(Optional)</em>
  15535. <p>The metadata of the external secrets to be created</p>
  15536. </td>
  15537. </tr>
  15538. <tr>
  15539. <td>
  15540. <code>namespaceSelectors</code></br>
  15541. <em>
  15542. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  15543. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  15544. </a>
  15545. </em>
  15546. </td>
  15547. <td>
  15548. <em>(Optional)</em>
  15549. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  15550. </td>
  15551. </tr>
  15552. </tbody>
  15553. </table>
  15554. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus
  15555. </h3>
  15556. <p>
  15557. (<em>Appears on:</em>
  15558. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  15559. </p>
  15560. <p>
  15561. <p>ClusterPushSecretStatus contains the status information for the ClusterPushSecret resource.</p>
  15562. </p>
  15563. <table>
  15564. <thead>
  15565. <tr>
  15566. <th>Field</th>
  15567. <th>Description</th>
  15568. </tr>
  15569. </thead>
  15570. <tbody>
  15571. <tr>
  15572. <td>
  15573. <code>failedNamespaces</code></br>
  15574. <em>
  15575. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">
  15576. []ClusterPushSecretNamespaceFailure
  15577. </a>
  15578. </em>
  15579. </td>
  15580. <td>
  15581. <em>(Optional)</em>
  15582. <p>Failed namespaces are the namespaces that failed to apply an PushSecret</p>
  15583. </td>
  15584. </tr>
  15585. <tr>
  15586. <td>
  15587. <code>provisionedNamespaces</code></br>
  15588. <em>
  15589. []string
  15590. </em>
  15591. </td>
  15592. <td>
  15593. <em>(Optional)</em>
  15594. <p>ProvisionedNamespaces are the namespaces where the ClusterPushSecret has secrets</p>
  15595. </td>
  15596. </tr>
  15597. <tr>
  15598. <td>
  15599. <code>pushSecretName</code></br>
  15600. <em>
  15601. string
  15602. </em>
  15603. </td>
  15604. <td>
  15605. </td>
  15606. </tr>
  15607. <tr>
  15608. <td>
  15609. <code>conditions</code></br>
  15610. <em>
  15611. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  15612. []PushSecretStatusCondition
  15613. </a>
  15614. </em>
  15615. </td>
  15616. <td>
  15617. <em>(Optional)</em>
  15618. </td>
  15619. </tr>
  15620. </tbody>
  15621. </table>
  15622. <h3 id="external-secrets.io/v1alpha1.PushSecret">PushSecret
  15623. </h3>
  15624. <p>
  15625. <p>PushSecret is the Schema for the PushSecrets API that enables pushing Kubernetes secrets to external secret providers.</p>
  15626. </p>
  15627. <table>
  15628. <thead>
  15629. <tr>
  15630. <th>Field</th>
  15631. <th>Description</th>
  15632. </tr>
  15633. </thead>
  15634. <tbody>
  15635. <tr>
  15636. <td>
  15637. <code>metadata</code></br>
  15638. <em>
  15639. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  15640. Kubernetes meta/v1.ObjectMeta
  15641. </a>
  15642. </em>
  15643. </td>
  15644. <td>
  15645. Refer to the Kubernetes API documentation for the fields of the
  15646. <code>metadata</code> field.
  15647. </td>
  15648. </tr>
  15649. <tr>
  15650. <td>
  15651. <code>spec</code></br>
  15652. <em>
  15653. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  15654. PushSecretSpec
  15655. </a>
  15656. </em>
  15657. </td>
  15658. <td>
  15659. <br/>
  15660. <br/>
  15661. <table>
  15662. <tr>
  15663. <td>
  15664. <code>refreshInterval</code></br>
  15665. <em>
  15666. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15667. Kubernetes meta/v1.Duration
  15668. </a>
  15669. </em>
  15670. </td>
  15671. <td>
  15672. <p>The Interval to which External Secrets will try to push a secret definition</p>
  15673. </td>
  15674. </tr>
  15675. <tr>
  15676. <td>
  15677. <code>secretStoreRefs</code></br>
  15678. <em>
  15679. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  15680. []PushSecretStoreRef
  15681. </a>
  15682. </em>
  15683. </td>
  15684. <td>
  15685. </td>
  15686. </tr>
  15687. <tr>
  15688. <td>
  15689. <code>updatePolicy</code></br>
  15690. <em>
  15691. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  15692. PushSecretUpdatePolicy
  15693. </a>
  15694. </em>
  15695. </td>
  15696. <td>
  15697. <em>(Optional)</em>
  15698. <p>UpdatePolicy to handle Secrets in the provider.</p>
  15699. </td>
  15700. </tr>
  15701. <tr>
  15702. <td>
  15703. <code>deletionPolicy</code></br>
  15704. <em>
  15705. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  15706. PushSecretDeletionPolicy
  15707. </a>
  15708. </em>
  15709. </td>
  15710. <td>
  15711. <em>(Optional)</em>
  15712. <p>Deletion Policy to handle Secrets in the provider.</p>
  15713. </td>
  15714. </tr>
  15715. <tr>
  15716. <td>
  15717. <code>selector</code></br>
  15718. <em>
  15719. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  15720. PushSecretSelector
  15721. </a>
  15722. </em>
  15723. </td>
  15724. <td>
  15725. <p>The Secret Selector (k8s source) for the Push Secret</p>
  15726. </td>
  15727. </tr>
  15728. <tr>
  15729. <td>
  15730. <code>data</code></br>
  15731. <em>
  15732. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  15733. []PushSecretData
  15734. </a>
  15735. </em>
  15736. </td>
  15737. <td>
  15738. <em>(Optional)</em>
  15739. <p>Secret Data that should be pushed to providers</p>
  15740. </td>
  15741. </tr>
  15742. <tr>
  15743. <td>
  15744. <code>dataTo</code></br>
  15745. <em>
  15746. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  15747. []PushSecretDataTo
  15748. </a>
  15749. </em>
  15750. </td>
  15751. <td>
  15752. <em>(Optional)</em>
  15753. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  15754. </td>
  15755. </tr>
  15756. <tr>
  15757. <td>
  15758. <code>template</code></br>
  15759. <em>
  15760. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  15761. ExternalSecretTemplate
  15762. </a>
  15763. </em>
  15764. </td>
  15765. <td>
  15766. <em>(Optional)</em>
  15767. <p>Template defines a blueprint for the created Secret resource.</p>
  15768. </td>
  15769. </tr>
  15770. </table>
  15771. </td>
  15772. </tr>
  15773. <tr>
  15774. <td>
  15775. <code>status</code></br>
  15776. <em>
  15777. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">
  15778. PushSecretStatus
  15779. </a>
  15780. </em>
  15781. </td>
  15782. <td>
  15783. </td>
  15784. </tr>
  15785. </tbody>
  15786. </table>
  15787. <h3 id="external-secrets.io/v1alpha1.PushSecretConditionType">PushSecretConditionType
  15788. (<code>string</code> alias)</p></h3>
  15789. <p>
  15790. (<em>Appears on:</em>
  15791. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition</a>)
  15792. </p>
  15793. <p>
  15794. <p>PushSecretConditionType indicates the condition of the PushSecret.</p>
  15795. </p>
  15796. <table>
  15797. <thead>
  15798. <tr>
  15799. <th>Value</th>
  15800. <th>Description</th>
  15801. </tr>
  15802. </thead>
  15803. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  15804. <td><p>PushSecretReady indicates the PushSecret resource is ready.</p>
  15805. </td>
  15806. </tr></tbody>
  15807. </table>
  15808. <h3 id="external-secrets.io/v1alpha1.PushSecretConversionStrategy">PushSecretConversionStrategy
  15809. (<code>string</code> alias)</p></h3>
  15810. <p>
  15811. (<em>Appears on:</em>
  15812. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>,
  15813. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  15814. </p>
  15815. <p>
  15816. <p>PushSecretConversionStrategy defines how secret values are converted when pushed to providers.</p>
  15817. </p>
  15818. <table>
  15819. <thead>
  15820. <tr>
  15821. <th>Value</th>
  15822. <th>Description</th>
  15823. </tr>
  15824. </thead>
  15825. <tbody><tr><td><p>&#34;None&#34;</p></td>
  15826. <td><p>PushSecretConversionNone indicates no conversion will be performed on the secret value.</p>
  15827. </td>
  15828. </tr><tr><td><p>&#34;ReverseUnicode&#34;</p></td>
  15829. <td><p>PushSecretConversionReverseUnicode indicates that unicode escape sequences will be reversed.</p>
  15830. </td>
  15831. </tr></tbody>
  15832. </table>
  15833. <h3 id="external-secrets.io/v1alpha1.PushSecretData">PushSecretData
  15834. </h3>
  15835. <p>
  15836. (<em>Appears on:</em>
  15837. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15838. </p>
  15839. <p>
  15840. <p>PushSecretData defines data to be pushed to the provider and associated metadata.</p>
  15841. </p>
  15842. <table>
  15843. <thead>
  15844. <tr>
  15845. <th>Field</th>
  15846. <th>Description</th>
  15847. </tr>
  15848. </thead>
  15849. <tbody>
  15850. <tr>
  15851. <td>
  15852. <code>match</code></br>
  15853. <em>
  15854. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">
  15855. PushSecretMatch
  15856. </a>
  15857. </em>
  15858. </td>
  15859. <td>
  15860. <p>Match a given Secret Key to be pushed to the provider.</p>
  15861. </td>
  15862. </tr>
  15863. <tr>
  15864. <td>
  15865. <code>metadata</code></br>
  15866. <em>
  15867. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  15868. </em>
  15869. </td>
  15870. <td>
  15871. <em>(Optional)</em>
  15872. <p>Metadata is metadata attached to the secret.
  15873. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  15874. </td>
  15875. </tr>
  15876. <tr>
  15877. <td>
  15878. <code>conversionStrategy</code></br>
  15879. <em>
  15880. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  15881. PushSecretConversionStrategy
  15882. </a>
  15883. </em>
  15884. </td>
  15885. <td>
  15886. <em>(Optional)</em>
  15887. <p>Used to define a conversion Strategy for the secret keys</p>
  15888. </td>
  15889. </tr>
  15890. </tbody>
  15891. </table>
  15892. <h3 id="external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo
  15893. </h3>
  15894. <p>
  15895. (<em>Appears on:</em>
  15896. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15897. </p>
  15898. <p>
  15899. <p>PushSecretDataTo defines how to bulk-push secrets to providers without explicit per-key mappings.</p>
  15900. </p>
  15901. <table>
  15902. <thead>
  15903. <tr>
  15904. <th>Field</th>
  15905. <th>Description</th>
  15906. </tr>
  15907. </thead>
  15908. <tbody>
  15909. <tr>
  15910. <td>
  15911. <code>storeRef</code></br>
  15912. <em>
  15913. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  15914. PushSecretStoreRef
  15915. </a>
  15916. </em>
  15917. </td>
  15918. <td>
  15919. <p>StoreRef specifies which SecretStore to push to. Required.</p>
  15920. </td>
  15921. </tr>
  15922. <tr>
  15923. <td>
  15924. <code>remoteKey</code></br>
  15925. <em>
  15926. string
  15927. </em>
  15928. </td>
  15929. <td>
  15930. <em>(Optional)</em>
  15931. <p>RemoteKey is the name of the single provider secret that will receive ALL
  15932. matched keys bundled as a JSON object (e.g. {&ldquo;DB_HOST&rdquo;:&ldquo;&hellip;&rdquo;,&ldquo;DB_USER&rdquo;:&ldquo;&hellip;&rdquo;}).
  15933. When set, per-key expansion is skipped and a single push is performed.
  15934. The provider&rsquo;s store prefix (if any) is still prepended to this value.
  15935. When not set, each matched key is pushed as its own individual provider secret.</p>
  15936. </td>
  15937. </tr>
  15938. <tr>
  15939. <td>
  15940. <code>match</code></br>
  15941. <em>
  15942. <a href="#external-secrets.io/v1alpha1.PushSecretDataToMatch">
  15943. PushSecretDataToMatch
  15944. </a>
  15945. </em>
  15946. </td>
  15947. <td>
  15948. <em>(Optional)</em>
  15949. <p>Match pattern for selecting keys from the source Secret.
  15950. If not specified, all keys are selected.</p>
  15951. </td>
  15952. </tr>
  15953. <tr>
  15954. <td>
  15955. <code>rewrite</code></br>
  15956. <em>
  15957. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">
  15958. []PushSecretRewrite
  15959. </a>
  15960. </em>
  15961. </td>
  15962. <td>
  15963. <em>(Optional)</em>
  15964. <p>Rewrite operations to transform keys before pushing to the provider.
  15965. Operations are applied sequentially.</p>
  15966. </td>
  15967. </tr>
  15968. <tr>
  15969. <td>
  15970. <code>metadata</code></br>
  15971. <em>
  15972. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  15973. </em>
  15974. </td>
  15975. <td>
  15976. <em>(Optional)</em>
  15977. <p>Metadata is metadata attached to the secret.
  15978. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  15979. </td>
  15980. </tr>
  15981. <tr>
  15982. <td>
  15983. <code>conversionStrategy</code></br>
  15984. <em>
  15985. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  15986. PushSecretConversionStrategy
  15987. </a>
  15988. </em>
  15989. </td>
  15990. <td>
  15991. <em>(Optional)</em>
  15992. <p>Used to define a conversion Strategy for the secret keys</p>
  15993. </td>
  15994. </tr>
  15995. </tbody>
  15996. </table>
  15997. <h3 id="external-secrets.io/v1alpha1.PushSecretDataToMatch">PushSecretDataToMatch
  15998. </h3>
  15999. <p>
  16000. (<em>Appears on:</em>
  16001. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16002. </p>
  16003. <p>
  16004. <p>PushSecretDataToMatch defines pattern matching for key selection.</p>
  16005. </p>
  16006. <table>
  16007. <thead>
  16008. <tr>
  16009. <th>Field</th>
  16010. <th>Description</th>
  16011. </tr>
  16012. </thead>
  16013. <tbody>
  16014. <tr>
  16015. <td>
  16016. <code>regexp</code></br>
  16017. <em>
  16018. string
  16019. </em>
  16020. </td>
  16021. <td>
  16022. <em>(Optional)</em>
  16023. <p>Regexp matches keys by regular expression.
  16024. If not specified, all keys are matched.</p>
  16025. </td>
  16026. </tr>
  16027. </tbody>
  16028. </table>
  16029. <h3 id="external-secrets.io/v1alpha1.PushSecretDeletionPolicy">PushSecretDeletionPolicy
  16030. (<code>string</code> alias)</p></h3>
  16031. <p>
  16032. (<em>Appears on:</em>
  16033. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16034. </p>
  16035. <p>
  16036. <p>PushSecretDeletionPolicy defines how push secrets are deleted in the provider.</p>
  16037. </p>
  16038. <table>
  16039. <thead>
  16040. <tr>
  16041. <th>Value</th>
  16042. <th>Description</th>
  16043. </tr>
  16044. </thead>
  16045. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  16046. <td><p>PushSecretDeletionPolicyDelete deletes secrets from the provider when the PushSecret is deleted.</p>
  16047. </td>
  16048. </tr><tr><td><p>&#34;None&#34;</p></td>
  16049. <td><p>PushSecretDeletionPolicyNone keeps secrets in the provider when the PushSecret is deleted.</p>
  16050. </td>
  16051. </tr></tbody>
  16052. </table>
  16053. <h3 id="external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch
  16054. </h3>
  16055. <p>
  16056. (<em>Appears on:</em>
  16057. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>)
  16058. </p>
  16059. <p>
  16060. <p>PushSecretMatch defines how a source Secret key maps to a destination in the provider.</p>
  16061. </p>
  16062. <table>
  16063. <thead>
  16064. <tr>
  16065. <th>Field</th>
  16066. <th>Description</th>
  16067. </tr>
  16068. </thead>
  16069. <tbody>
  16070. <tr>
  16071. <td>
  16072. <code>secretKey</code></br>
  16073. <em>
  16074. string
  16075. </em>
  16076. </td>
  16077. <td>
  16078. <em>(Optional)</em>
  16079. <p>Secret Key to be pushed</p>
  16080. </td>
  16081. </tr>
  16082. <tr>
  16083. <td>
  16084. <code>remoteRef</code></br>
  16085. <em>
  16086. <a href="#external-secrets.io/v1alpha1.PushSecretRemoteRef">
  16087. PushSecretRemoteRef
  16088. </a>
  16089. </em>
  16090. </td>
  16091. <td>
  16092. <p>Remote Refs to push to providers.</p>
  16093. </td>
  16094. </tr>
  16095. </tbody>
  16096. </table>
  16097. <h3 id="external-secrets.io/v1alpha1.PushSecretMetadata">PushSecretMetadata
  16098. </h3>
  16099. <p>
  16100. (<em>Appears on:</em>
  16101. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>)
  16102. </p>
  16103. <p>
  16104. <p>PushSecretMetadata defines metadata fields for the PushSecret generated by the ClusterPushSecret.</p>
  16105. </p>
  16106. <table>
  16107. <thead>
  16108. <tr>
  16109. <th>Field</th>
  16110. <th>Description</th>
  16111. </tr>
  16112. </thead>
  16113. <tbody>
  16114. <tr>
  16115. <td>
  16116. <code>annotations</code></br>
  16117. <em>
  16118. map[string]string
  16119. </em>
  16120. </td>
  16121. <td>
  16122. <em>(Optional)</em>
  16123. </td>
  16124. </tr>
  16125. <tr>
  16126. <td>
  16127. <code>labels</code></br>
  16128. <em>
  16129. map[string]string
  16130. </em>
  16131. </td>
  16132. <td>
  16133. <em>(Optional)</em>
  16134. </td>
  16135. </tr>
  16136. </tbody>
  16137. </table>
  16138. <h3 id="external-secrets.io/v1alpha1.PushSecretRemoteRef">PushSecretRemoteRef
  16139. </h3>
  16140. <p>
  16141. (<em>Appears on:</em>
  16142. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch</a>)
  16143. </p>
  16144. <p>
  16145. <p>PushSecretRemoteRef defines the location of the secret in the provider.</p>
  16146. </p>
  16147. <table>
  16148. <thead>
  16149. <tr>
  16150. <th>Field</th>
  16151. <th>Description</th>
  16152. </tr>
  16153. </thead>
  16154. <tbody>
  16155. <tr>
  16156. <td>
  16157. <code>remoteKey</code></br>
  16158. <em>
  16159. string
  16160. </em>
  16161. </td>
  16162. <td>
  16163. <p>Name of the resulting provider secret.</p>
  16164. </td>
  16165. </tr>
  16166. <tr>
  16167. <td>
  16168. <code>property</code></br>
  16169. <em>
  16170. string
  16171. </em>
  16172. </td>
  16173. <td>
  16174. <em>(Optional)</em>
  16175. <p>Name of the property in the resulting secret</p>
  16176. </td>
  16177. </tr>
  16178. </tbody>
  16179. </table>
  16180. <h3 id="external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite
  16181. </h3>
  16182. <p>
  16183. (<em>Appears on:</em>
  16184. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  16185. </p>
  16186. <p>
  16187. <p>PushSecretRewrite defines how to transform secret keys before pushing.</p>
  16188. </p>
  16189. <table>
  16190. <thead>
  16191. <tr>
  16192. <th>Field</th>
  16193. <th>Description</th>
  16194. </tr>
  16195. </thead>
  16196. <tbody>
  16197. <tr>
  16198. <td>
  16199. <code>regexp</code></br>
  16200. <em>
  16201. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  16202. ExternalSecretRewriteRegexp
  16203. </a>
  16204. </em>
  16205. </td>
  16206. <td>
  16207. <em>(Optional)</em>
  16208. <p>Used to rewrite with regular expressions.</p>
  16209. </td>
  16210. </tr>
  16211. <tr>
  16212. <td>
  16213. <code>transform</code></br>
  16214. <em>
  16215. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  16216. ExternalSecretRewriteTransform
  16217. </a>
  16218. </em>
  16219. </td>
  16220. <td>
  16221. <em>(Optional)</em>
  16222. <p>Used to apply string transformation on the secrets.</p>
  16223. </td>
  16224. </tr>
  16225. </tbody>
  16226. </table>
  16227. <h3 id="external-secrets.io/v1alpha1.PushSecretSecret">PushSecretSecret
  16228. </h3>
  16229. <p>
  16230. (<em>Appears on:</em>
  16231. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  16232. </p>
  16233. <p>
  16234. <p>PushSecretSecret defines a Secret that will be used as a source for pushing to providers.</p>
  16235. </p>
  16236. <table>
  16237. <thead>
  16238. <tr>
  16239. <th>Field</th>
  16240. <th>Description</th>
  16241. </tr>
  16242. </thead>
  16243. <tbody>
  16244. <tr>
  16245. <td>
  16246. <code>name</code></br>
  16247. <em>
  16248. string
  16249. </em>
  16250. </td>
  16251. <td>
  16252. <em>(Optional)</em>
  16253. <p>Name of the Secret.
  16254. The Secret must exist in the same namespace as the PushSecret manifest.</p>
  16255. </td>
  16256. </tr>
  16257. <tr>
  16258. <td>
  16259. <code>selector</code></br>
  16260. <em>
  16261. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  16262. Kubernetes meta/v1.LabelSelector
  16263. </a>
  16264. </em>
  16265. </td>
  16266. <td>
  16267. <em>(Optional)</em>
  16268. <p>Selector chooses secrets using a labelSelector.</p>
  16269. </td>
  16270. </tr>
  16271. </tbody>
  16272. </table>
  16273. <h3 id="external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector
  16274. </h3>
  16275. <p>
  16276. (<em>Appears on:</em>
  16277. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16278. </p>
  16279. <p>
  16280. <p>PushSecretSelector defines criteria for selecting the source Secret for pushing to providers.</p>
  16281. </p>
  16282. <table>
  16283. <thead>
  16284. <tr>
  16285. <th>Field</th>
  16286. <th>Description</th>
  16287. </tr>
  16288. </thead>
  16289. <tbody>
  16290. <tr>
  16291. <td>
  16292. <code>secret</code></br>
  16293. <em>
  16294. <a href="#external-secrets.io/v1alpha1.PushSecretSecret">
  16295. PushSecretSecret
  16296. </a>
  16297. </em>
  16298. </td>
  16299. <td>
  16300. <em>(Optional)</em>
  16301. <p>Select a Secret to Push.</p>
  16302. </td>
  16303. </tr>
  16304. <tr>
  16305. <td>
  16306. <code>generatorRef</code></br>
  16307. <em>
  16308. <a href="#external-secrets.io/v1.GeneratorRef">
  16309. GeneratorRef
  16310. </a>
  16311. </em>
  16312. </td>
  16313. <td>
  16314. <em>(Optional)</em>
  16315. <p>Point to a generator to create a Secret.</p>
  16316. </td>
  16317. </tr>
  16318. </tbody>
  16319. </table>
  16320. <h3 id="external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec
  16321. </h3>
  16322. <p>
  16323. (<em>Appears on:</em>
  16324. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>,
  16325. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  16326. </p>
  16327. <p>
  16328. <p>PushSecretSpec configures the behavior of the PushSecret.</p>
  16329. </p>
  16330. <table>
  16331. <thead>
  16332. <tr>
  16333. <th>Field</th>
  16334. <th>Description</th>
  16335. </tr>
  16336. </thead>
  16337. <tbody>
  16338. <tr>
  16339. <td>
  16340. <code>refreshInterval</code></br>
  16341. <em>
  16342. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  16343. Kubernetes meta/v1.Duration
  16344. </a>
  16345. </em>
  16346. </td>
  16347. <td>
  16348. <p>The Interval to which External Secrets will try to push a secret definition</p>
  16349. </td>
  16350. </tr>
  16351. <tr>
  16352. <td>
  16353. <code>secretStoreRefs</code></br>
  16354. <em>
  16355. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  16356. []PushSecretStoreRef
  16357. </a>
  16358. </em>
  16359. </td>
  16360. <td>
  16361. </td>
  16362. </tr>
  16363. <tr>
  16364. <td>
  16365. <code>updatePolicy</code></br>
  16366. <em>
  16367. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  16368. PushSecretUpdatePolicy
  16369. </a>
  16370. </em>
  16371. </td>
  16372. <td>
  16373. <em>(Optional)</em>
  16374. <p>UpdatePolicy to handle Secrets in the provider.</p>
  16375. </td>
  16376. </tr>
  16377. <tr>
  16378. <td>
  16379. <code>deletionPolicy</code></br>
  16380. <em>
  16381. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  16382. PushSecretDeletionPolicy
  16383. </a>
  16384. </em>
  16385. </td>
  16386. <td>
  16387. <em>(Optional)</em>
  16388. <p>Deletion Policy to handle Secrets in the provider.</p>
  16389. </td>
  16390. </tr>
  16391. <tr>
  16392. <td>
  16393. <code>selector</code></br>
  16394. <em>
  16395. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  16396. PushSecretSelector
  16397. </a>
  16398. </em>
  16399. </td>
  16400. <td>
  16401. <p>The Secret Selector (k8s source) for the Push Secret</p>
  16402. </td>
  16403. </tr>
  16404. <tr>
  16405. <td>
  16406. <code>data</code></br>
  16407. <em>
  16408. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  16409. []PushSecretData
  16410. </a>
  16411. </em>
  16412. </td>
  16413. <td>
  16414. <em>(Optional)</em>
  16415. <p>Secret Data that should be pushed to providers</p>
  16416. </td>
  16417. </tr>
  16418. <tr>
  16419. <td>
  16420. <code>dataTo</code></br>
  16421. <em>
  16422. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  16423. []PushSecretDataTo
  16424. </a>
  16425. </em>
  16426. </td>
  16427. <td>
  16428. <em>(Optional)</em>
  16429. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  16430. </td>
  16431. </tr>
  16432. <tr>
  16433. <td>
  16434. <code>template</code></br>
  16435. <em>
  16436. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  16437. ExternalSecretTemplate
  16438. </a>
  16439. </em>
  16440. </td>
  16441. <td>
  16442. <em>(Optional)</em>
  16443. <p>Template defines a blueprint for the created Secret resource.</p>
  16444. </td>
  16445. </tr>
  16446. </tbody>
  16447. </table>
  16448. <h3 id="external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus
  16449. </h3>
  16450. <p>
  16451. (<em>Appears on:</em>
  16452. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  16453. </p>
  16454. <p>
  16455. <p>PushSecretStatus indicates the history of the status of PushSecret.</p>
  16456. </p>
  16457. <table>
  16458. <thead>
  16459. <tr>
  16460. <th>Field</th>
  16461. <th>Description</th>
  16462. </tr>
  16463. </thead>
  16464. <tbody>
  16465. <tr>
  16466. <td>
  16467. <code>refreshTime</code></br>
  16468. <em>
  16469. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  16470. Kubernetes meta/v1.Time
  16471. </a>
  16472. </em>
  16473. </td>
  16474. <td>
  16475. <p>refreshTime is the time and date the external secret was fetched and
  16476. the target secret updated</p>
  16477. </td>
  16478. </tr>
  16479. <tr>
  16480. <td>
  16481. <code>syncedResourceVersion</code></br>
  16482. <em>
  16483. string
  16484. </em>
  16485. </td>
  16486. <td>
  16487. <p>SyncedResourceVersion keeps track of the last synced version.</p>
  16488. </td>
  16489. </tr>
  16490. <tr>
  16491. <td>
  16492. <code>syncedPushSecrets</code></br>
  16493. <em>
  16494. <a href="#external-secrets.io/v1alpha1.SyncedPushSecretsMap">
  16495. SyncedPushSecretsMap
  16496. </a>
  16497. </em>
  16498. </td>
  16499. <td>
  16500. <em>(Optional)</em>
  16501. <p>Synced PushSecrets, including secrets that already exist in provider.
  16502. Matches secret stores to PushSecretData that was stored to that secret store.</p>
  16503. </td>
  16504. </tr>
  16505. <tr>
  16506. <td>
  16507. <code>conditions</code></br>
  16508. <em>
  16509. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  16510. []PushSecretStatusCondition
  16511. </a>
  16512. </em>
  16513. </td>
  16514. <td>
  16515. <em>(Optional)</em>
  16516. </td>
  16517. </tr>
  16518. </tbody>
  16519. </table>
  16520. <h3 id="external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition
  16521. </h3>
  16522. <p>
  16523. (<em>Appears on:</em>
  16524. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>,
  16525. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  16526. </p>
  16527. <p>
  16528. <p>PushSecretStatusCondition indicates the status of the PushSecret.</p>
  16529. </p>
  16530. <table>
  16531. <thead>
  16532. <tr>
  16533. <th>Field</th>
  16534. <th>Description</th>
  16535. </tr>
  16536. </thead>
  16537. <tbody>
  16538. <tr>
  16539. <td>
  16540. <code>type</code></br>
  16541. <em>
  16542. <a href="#external-secrets.io/v1alpha1.PushSecretConditionType">
  16543. PushSecretConditionType
  16544. </a>
  16545. </em>
  16546. </td>
  16547. <td>
  16548. </td>
  16549. </tr>
  16550. <tr>
  16551. <td>
  16552. <code>status</code></br>
  16553. <em>
  16554. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  16555. Kubernetes core/v1.ConditionStatus
  16556. </a>
  16557. </em>
  16558. </td>
  16559. <td>
  16560. </td>
  16561. </tr>
  16562. <tr>
  16563. <td>
  16564. <code>reason</code></br>
  16565. <em>
  16566. string
  16567. </em>
  16568. </td>
  16569. <td>
  16570. <em>(Optional)</em>
  16571. </td>
  16572. </tr>
  16573. <tr>
  16574. <td>
  16575. <code>message</code></br>
  16576. <em>
  16577. string
  16578. </em>
  16579. </td>
  16580. <td>
  16581. <em>(Optional)</em>
  16582. </td>
  16583. </tr>
  16584. <tr>
  16585. <td>
  16586. <code>lastTransitionTime</code></br>
  16587. <em>
  16588. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  16589. Kubernetes meta/v1.Time
  16590. </a>
  16591. </em>
  16592. </td>
  16593. <td>
  16594. <em>(Optional)</em>
  16595. </td>
  16596. </tr>
  16597. </tbody>
  16598. </table>
  16599. <h3 id="external-secrets.io/v1alpha1.PushSecretStoreRef">PushSecretStoreRef
  16600. </h3>
  16601. <p>
  16602. (<em>Appears on:</em>
  16603. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>,
  16604. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16605. </p>
  16606. <p>
  16607. <p>PushSecretStoreRef contains a reference on how to sync to a SecretStore.</p>
  16608. </p>
  16609. <table>
  16610. <thead>
  16611. <tr>
  16612. <th>Field</th>
  16613. <th>Description</th>
  16614. </tr>
  16615. </thead>
  16616. <tbody>
  16617. <tr>
  16618. <td>
  16619. <code>name</code></br>
  16620. <em>
  16621. string
  16622. </em>
  16623. </td>
  16624. <td>
  16625. <em>(Optional)</em>
  16626. <p>Optionally, sync to the SecretStore of the given name</p>
  16627. </td>
  16628. </tr>
  16629. <tr>
  16630. <td>
  16631. <code>labelSelector</code></br>
  16632. <em>
  16633. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  16634. Kubernetes meta/v1.LabelSelector
  16635. </a>
  16636. </em>
  16637. </td>
  16638. <td>
  16639. <em>(Optional)</em>
  16640. <p>Optionally, sync to secret stores with label selector</p>
  16641. </td>
  16642. </tr>
  16643. <tr>
  16644. <td>
  16645. <code>kind</code></br>
  16646. <em>
  16647. string
  16648. </em>
  16649. </td>
  16650. <td>
  16651. <em>(Optional)</em>
  16652. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)</p>
  16653. </td>
  16654. </tr>
  16655. </tbody>
  16656. </table>
  16657. <h3 id="external-secrets.io/v1alpha1.PushSecretUpdatePolicy">PushSecretUpdatePolicy
  16658. (<code>string</code> alias)</p></h3>
  16659. <p>
  16660. (<em>Appears on:</em>
  16661. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  16662. </p>
  16663. <p>
  16664. <p>PushSecretUpdatePolicy defines how push secrets are updated in the provider.</p>
  16665. </p>
  16666. <table>
  16667. <thead>
  16668. <tr>
  16669. <th>Value</th>
  16670. <th>Description</th>
  16671. </tr>
  16672. </thead>
  16673. <tbody><tr><td><p>&#34;IfNotExists&#34;</p></td>
  16674. <td><p>PushSecretUpdatePolicyIfNotExists only creates secrets that don&rsquo;t exist in the provider.</p>
  16675. </td>
  16676. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  16677. <td><p>PushSecretUpdatePolicyReplace replaces existing secrets in the provider.</p>
  16678. </td>
  16679. </tr></tbody>
  16680. </table>
  16681. <h3 id="external-secrets.io/v1alpha1.SyncedPushSecretsMap">SyncedPushSecretsMap
  16682. (<code>map[string]map[string]github.com/external-secrets/external-secrets/apis/externalsecrets/v1alpha1.PushSecretData</code> alias)</p></h3>
  16683. <p>
  16684. (<em>Appears on:</em>
  16685. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  16686. </p>
  16687. <p>
  16688. <p>SyncedPushSecretsMap is a map that tracks which PushSecretData was stored to which secret store.
  16689. The outer map&rsquo;s key is the secret store name, and the inner map&rsquo;s key is the remote key name.</p>
  16690. </p>
  16691. <hr/>
  16692. <h2 id="external-secrets.io/v1beta1">external-secrets.io/v1beta1</h2>
  16693. <p>
  16694. <p>Package v1beta1 contains resources for external-secrets</p>
  16695. </p>
  16696. <p>Resource Types:</p>
  16697. <ul></ul>
  16698. <h3 id="external-secrets.io/v1beta1.AWSAuth">AWSAuth
  16699. </h3>
  16700. <p>
  16701. (<em>Appears on:</em>
  16702. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  16703. </p>
  16704. <p>
  16705. <p>AWSAuth tells the controller how to do authentication with aws.
  16706. Only one of secretRef or jwt can be specified.
  16707. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  16708. </p>
  16709. <table>
  16710. <thead>
  16711. <tr>
  16712. <th>Field</th>
  16713. <th>Description</th>
  16714. </tr>
  16715. </thead>
  16716. <tbody>
  16717. <tr>
  16718. <td>
  16719. <code>secretRef</code></br>
  16720. <em>
  16721. <a href="#external-secrets.io/v1beta1.AWSAuthSecretRef">
  16722. AWSAuthSecretRef
  16723. </a>
  16724. </em>
  16725. </td>
  16726. <td>
  16727. <em>(Optional)</em>
  16728. </td>
  16729. </tr>
  16730. <tr>
  16731. <td>
  16732. <code>jwt</code></br>
  16733. <em>
  16734. <a href="#external-secrets.io/v1beta1.AWSJWTAuth">
  16735. AWSJWTAuth
  16736. </a>
  16737. </em>
  16738. </td>
  16739. <td>
  16740. <em>(Optional)</em>
  16741. </td>
  16742. </tr>
  16743. </tbody>
  16744. </table>
  16745. <h3 id="external-secrets.io/v1beta1.AWSAuthSecretRef">AWSAuthSecretRef
  16746. </h3>
  16747. <p>
  16748. (<em>Appears on:</em>
  16749. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  16750. </p>
  16751. <p>
  16752. <p>AWSAuthSecretRef holds secret references for AWS credentials
  16753. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  16754. </p>
  16755. <table>
  16756. <thead>
  16757. <tr>
  16758. <th>Field</th>
  16759. <th>Description</th>
  16760. </tr>
  16761. </thead>
  16762. <tbody>
  16763. <tr>
  16764. <td>
  16765. <code>accessKeyIDSecretRef</code></br>
  16766. <em>
  16767. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16768. External Secrets meta/v1.SecretKeySelector
  16769. </a>
  16770. </em>
  16771. </td>
  16772. <td>
  16773. <p>The AccessKeyID is used for authentication</p>
  16774. </td>
  16775. </tr>
  16776. <tr>
  16777. <td>
  16778. <code>secretAccessKeySecretRef</code></br>
  16779. <em>
  16780. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16781. External Secrets meta/v1.SecretKeySelector
  16782. </a>
  16783. </em>
  16784. </td>
  16785. <td>
  16786. <p>The SecretAccessKey is used for authentication</p>
  16787. </td>
  16788. </tr>
  16789. <tr>
  16790. <td>
  16791. <code>sessionTokenSecretRef</code></br>
  16792. <em>
  16793. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16794. External Secrets meta/v1.SecretKeySelector
  16795. </a>
  16796. </em>
  16797. </td>
  16798. <td>
  16799. <p>The SessionToken used for authentication
  16800. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  16801. 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>
  16802. </td>
  16803. </tr>
  16804. </tbody>
  16805. </table>
  16806. <h3 id="external-secrets.io/v1beta1.AWSJWTAuth">AWSJWTAuth
  16807. </h3>
  16808. <p>
  16809. (<em>Appears on:</em>
  16810. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  16811. </p>
  16812. <p>
  16813. <p>AWSJWTAuth authenticates against AWS using service account tokens from the Kubernetes cluster.</p>
  16814. </p>
  16815. <table>
  16816. <thead>
  16817. <tr>
  16818. <th>Field</th>
  16819. <th>Description</th>
  16820. </tr>
  16821. </thead>
  16822. <tbody>
  16823. <tr>
  16824. <td>
  16825. <code>serviceAccountRef</code></br>
  16826. <em>
  16827. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  16828. External Secrets meta/v1.ServiceAccountSelector
  16829. </a>
  16830. </em>
  16831. </td>
  16832. <td>
  16833. </td>
  16834. </tr>
  16835. </tbody>
  16836. </table>
  16837. <h3 id="external-secrets.io/v1beta1.AWSProvider">AWSProvider
  16838. </h3>
  16839. <p>
  16840. (<em>Appears on:</em>
  16841. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16842. </p>
  16843. <p>
  16844. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  16845. </p>
  16846. <table>
  16847. <thead>
  16848. <tr>
  16849. <th>Field</th>
  16850. <th>Description</th>
  16851. </tr>
  16852. </thead>
  16853. <tbody>
  16854. <tr>
  16855. <td>
  16856. <code>service</code></br>
  16857. <em>
  16858. <a href="#external-secrets.io/v1beta1.AWSServiceType">
  16859. AWSServiceType
  16860. </a>
  16861. </em>
  16862. </td>
  16863. <td>
  16864. <p>Service defines which service should be used to fetch the secrets</p>
  16865. </td>
  16866. </tr>
  16867. <tr>
  16868. <td>
  16869. <code>auth</code></br>
  16870. <em>
  16871. <a href="#external-secrets.io/v1beta1.AWSAuth">
  16872. AWSAuth
  16873. </a>
  16874. </em>
  16875. </td>
  16876. <td>
  16877. <em>(Optional)</em>
  16878. <p>Auth defines the information necessary to authenticate against AWS
  16879. if not set aws sdk will infer credentials from your environment
  16880. 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>
  16881. </td>
  16882. </tr>
  16883. <tr>
  16884. <td>
  16885. <code>role</code></br>
  16886. <em>
  16887. string
  16888. </em>
  16889. </td>
  16890. <td>
  16891. <em>(Optional)</em>
  16892. <p>Role is a Role ARN which the provider will assume</p>
  16893. </td>
  16894. </tr>
  16895. <tr>
  16896. <td>
  16897. <code>region</code></br>
  16898. <em>
  16899. string
  16900. </em>
  16901. </td>
  16902. <td>
  16903. <p>AWS Region to be used for the provider</p>
  16904. </td>
  16905. </tr>
  16906. <tr>
  16907. <td>
  16908. <code>additionalRoles</code></br>
  16909. <em>
  16910. []string
  16911. </em>
  16912. </td>
  16913. <td>
  16914. <em>(Optional)</em>
  16915. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  16916. </td>
  16917. </tr>
  16918. <tr>
  16919. <td>
  16920. <code>externalID</code></br>
  16921. <em>
  16922. string
  16923. </em>
  16924. </td>
  16925. <td>
  16926. <p>AWS External ID set on assumed IAM roles</p>
  16927. </td>
  16928. </tr>
  16929. <tr>
  16930. <td>
  16931. <code>sessionTags</code></br>
  16932. <em>
  16933. <a href="#external-secrets.io/v1beta1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag">
  16934. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag
  16935. </a>
  16936. </em>
  16937. </td>
  16938. <td>
  16939. <em>(Optional)</em>
  16940. <p>AWS STS assume role session tags</p>
  16941. </td>
  16942. </tr>
  16943. <tr>
  16944. <td>
  16945. <code>secretsManager</code></br>
  16946. <em>
  16947. <a href="#external-secrets.io/v1beta1.SecretsManager">
  16948. SecretsManager
  16949. </a>
  16950. </em>
  16951. </td>
  16952. <td>
  16953. <em>(Optional)</em>
  16954. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  16955. </td>
  16956. </tr>
  16957. <tr>
  16958. <td>
  16959. <code>transitiveTagKeys</code></br>
  16960. <em>
  16961. []*string
  16962. </em>
  16963. </td>
  16964. <td>
  16965. <em>(Optional)</em>
  16966. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  16967. </td>
  16968. </tr>
  16969. <tr>
  16970. <td>
  16971. <code>prefix</code></br>
  16972. <em>
  16973. string
  16974. </em>
  16975. </td>
  16976. <td>
  16977. <em>(Optional)</em>
  16978. <p>Prefix adds a prefix to all retrieved values.</p>
  16979. </td>
  16980. </tr>
  16981. </tbody>
  16982. </table>
  16983. <h3 id="external-secrets.io/v1beta1.AWSServiceType">AWSServiceType
  16984. (<code>string</code> alias)</p></h3>
  16985. <p>
  16986. (<em>Appears on:</em>
  16987. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  16988. </p>
  16989. <p>
  16990. <p>AWSServiceType is an enum that defines the service/API that is used to fetch the secrets.</p>
  16991. </p>
  16992. <table>
  16993. <thead>
  16994. <tr>
  16995. <th>Value</th>
  16996. <th>Description</th>
  16997. </tr>
  16998. </thead>
  16999. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  17000. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  17001. 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>
  17002. </td>
  17003. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  17004. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  17005. 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>
  17006. </td>
  17007. </tr></tbody>
  17008. </table>
  17009. <h3 id="external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth
  17010. </h3>
  17011. <p>
  17012. (<em>Appears on:</em>
  17013. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>)
  17014. </p>
  17015. <p>
  17016. <p>AkeylessAuth defines methods of authentication with Akeyless Vault.</p>
  17017. </p>
  17018. <table>
  17019. <thead>
  17020. <tr>
  17021. <th>Field</th>
  17022. <th>Description</th>
  17023. </tr>
  17024. </thead>
  17025. <tbody>
  17026. <tr>
  17027. <td>
  17028. <code>secretRef</code></br>
  17029. <em>
  17030. <a href="#external-secrets.io/v1beta1.AkeylessAuthSecretRef">
  17031. AkeylessAuthSecretRef
  17032. </a>
  17033. </em>
  17034. </td>
  17035. <td>
  17036. <em>(Optional)</em>
  17037. <p>Reference to a Secret that contains the details
  17038. to authenticate with Akeyless.</p>
  17039. </td>
  17040. </tr>
  17041. <tr>
  17042. <td>
  17043. <code>kubernetesAuth</code></br>
  17044. <em>
  17045. <a href="#external-secrets.io/v1beta1.AkeylessKubernetesAuth">
  17046. AkeylessKubernetesAuth
  17047. </a>
  17048. </em>
  17049. </td>
  17050. <td>
  17051. <em>(Optional)</em>
  17052. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  17053. token stored in the named Secret resource.</p>
  17054. </td>
  17055. </tr>
  17056. </tbody>
  17057. </table>
  17058. <h3 id="external-secrets.io/v1beta1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  17059. </h3>
  17060. <p>
  17061. (<em>Appears on:</em>
  17062. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  17063. </p>
  17064. <p>
  17065. <p>AkeylessAuthSecretRef defines how to authenticate using a secret reference.
  17066. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  17067. </p>
  17068. <table>
  17069. <thead>
  17070. <tr>
  17071. <th>Field</th>
  17072. <th>Description</th>
  17073. </tr>
  17074. </thead>
  17075. <tbody>
  17076. <tr>
  17077. <td>
  17078. <code>accessID</code></br>
  17079. <em>
  17080. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17081. External Secrets meta/v1.SecretKeySelector
  17082. </a>
  17083. </em>
  17084. </td>
  17085. <td>
  17086. <p>The SecretAccessID is used for authentication</p>
  17087. </td>
  17088. </tr>
  17089. <tr>
  17090. <td>
  17091. <code>accessType</code></br>
  17092. <em>
  17093. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17094. External Secrets meta/v1.SecretKeySelector
  17095. </a>
  17096. </em>
  17097. </td>
  17098. <td>
  17099. </td>
  17100. </tr>
  17101. <tr>
  17102. <td>
  17103. <code>accessTypeParam</code></br>
  17104. <em>
  17105. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17106. External Secrets meta/v1.SecretKeySelector
  17107. </a>
  17108. </em>
  17109. </td>
  17110. <td>
  17111. </td>
  17112. </tr>
  17113. </tbody>
  17114. </table>
  17115. <h3 id="external-secrets.io/v1beta1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  17116. </h3>
  17117. <p>
  17118. (<em>Appears on:</em>
  17119. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  17120. </p>
  17121. <p>
  17122. <p>AkeylessKubernetesAuth authenticates with Akeyless using a Kubernetes ServiceAccount token.</p>
  17123. </p>
  17124. <table>
  17125. <thead>
  17126. <tr>
  17127. <th>Field</th>
  17128. <th>Description</th>
  17129. </tr>
  17130. </thead>
  17131. <tbody>
  17132. <tr>
  17133. <td>
  17134. <code>accessID</code></br>
  17135. <em>
  17136. string
  17137. </em>
  17138. </td>
  17139. <td>
  17140. <p>the Akeyless Kubernetes auth-method access-id</p>
  17141. </td>
  17142. </tr>
  17143. <tr>
  17144. <td>
  17145. <code>k8sConfName</code></br>
  17146. <em>
  17147. string
  17148. </em>
  17149. </td>
  17150. <td>
  17151. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  17152. </td>
  17153. </tr>
  17154. <tr>
  17155. <td>
  17156. <code>serviceAccountRef</code></br>
  17157. <em>
  17158. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17159. External Secrets meta/v1.ServiceAccountSelector
  17160. </a>
  17161. </em>
  17162. </td>
  17163. <td>
  17164. <em>(Optional)</em>
  17165. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  17166. If the service account is specified, the service account secret token JWT will be used
  17167. for authenticating with Akeyless. If the service account selector is not supplied,
  17168. the secretRef will be used instead.</p>
  17169. </td>
  17170. </tr>
  17171. <tr>
  17172. <td>
  17173. <code>secretRef</code></br>
  17174. <em>
  17175. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17176. External Secrets meta/v1.SecretKeySelector
  17177. </a>
  17178. </em>
  17179. </td>
  17180. <td>
  17181. <em>(Optional)</em>
  17182. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  17183. for authenticating with Akeyless. If a name is specified without a key,
  17184. <code>token</code> is the default. If one is not specified, the one bound to
  17185. the controller will be used.</p>
  17186. </td>
  17187. </tr>
  17188. </tbody>
  17189. </table>
  17190. <h3 id="external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider
  17191. </h3>
  17192. <p>
  17193. (<em>Appears on:</em>
  17194. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17195. </p>
  17196. <p>
  17197. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  17198. </p>
  17199. <table>
  17200. <thead>
  17201. <tr>
  17202. <th>Field</th>
  17203. <th>Description</th>
  17204. </tr>
  17205. </thead>
  17206. <tbody>
  17207. <tr>
  17208. <td>
  17209. <code>akeylessGWApiURL</code></br>
  17210. <em>
  17211. string
  17212. </em>
  17213. </td>
  17214. <td>
  17215. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  17216. </td>
  17217. </tr>
  17218. <tr>
  17219. <td>
  17220. <code>authSecretRef</code></br>
  17221. <em>
  17222. <a href="#external-secrets.io/v1beta1.AkeylessAuth">
  17223. AkeylessAuth
  17224. </a>
  17225. </em>
  17226. </td>
  17227. <td>
  17228. <p>Auth configures how the operator authenticates with Akeyless.</p>
  17229. </td>
  17230. </tr>
  17231. <tr>
  17232. <td>
  17233. <code>caBundle</code></br>
  17234. <em>
  17235. []byte
  17236. </em>
  17237. </td>
  17238. <td>
  17239. <em>(Optional)</em>
  17240. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  17241. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  17242. are used to validate the TLS connection.</p>
  17243. </td>
  17244. </tr>
  17245. <tr>
  17246. <td>
  17247. <code>caProvider</code></br>
  17248. <em>
  17249. <a href="#external-secrets.io/v1beta1.CAProvider">
  17250. CAProvider
  17251. </a>
  17252. </em>
  17253. </td>
  17254. <td>
  17255. <em>(Optional)</em>
  17256. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  17257. </td>
  17258. </tr>
  17259. </tbody>
  17260. </table>
  17261. <h3 id="external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth
  17262. </h3>
  17263. <p>
  17264. (<em>Appears on:</em>
  17265. <a href="#external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider</a>)
  17266. </p>
  17267. <p>
  17268. <p>AlibabaAuth contains a secretRef for credentials.</p>
  17269. </p>
  17270. <table>
  17271. <thead>
  17272. <tr>
  17273. <th>Field</th>
  17274. <th>Description</th>
  17275. </tr>
  17276. </thead>
  17277. <tbody>
  17278. <tr>
  17279. <td>
  17280. <code>secretRef</code></br>
  17281. <em>
  17282. <a href="#external-secrets.io/v1beta1.AlibabaAuthSecretRef">
  17283. AlibabaAuthSecretRef
  17284. </a>
  17285. </em>
  17286. </td>
  17287. <td>
  17288. <em>(Optional)</em>
  17289. </td>
  17290. </tr>
  17291. <tr>
  17292. <td>
  17293. <code>rrsa</code></br>
  17294. <em>
  17295. <a href="#external-secrets.io/v1beta1.AlibabaRRSAAuth">
  17296. AlibabaRRSAAuth
  17297. </a>
  17298. </em>
  17299. </td>
  17300. <td>
  17301. <em>(Optional)</em>
  17302. </td>
  17303. </tr>
  17304. </tbody>
  17305. </table>
  17306. <h3 id="external-secrets.io/v1beta1.AlibabaAuthSecretRef">AlibabaAuthSecretRef
  17307. </h3>
  17308. <p>
  17309. (<em>Appears on:</em>
  17310. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  17311. </p>
  17312. <p>
  17313. <p>AlibabaAuthSecretRef holds secret references for Alibaba credentials.</p>
  17314. </p>
  17315. <table>
  17316. <thead>
  17317. <tr>
  17318. <th>Field</th>
  17319. <th>Description</th>
  17320. </tr>
  17321. </thead>
  17322. <tbody>
  17323. <tr>
  17324. <td>
  17325. <code>accessKeyIDSecretRef</code></br>
  17326. <em>
  17327. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17328. External Secrets meta/v1.SecretKeySelector
  17329. </a>
  17330. </em>
  17331. </td>
  17332. <td>
  17333. <p>The AccessKeyID is used for authentication</p>
  17334. </td>
  17335. </tr>
  17336. <tr>
  17337. <td>
  17338. <code>accessKeySecretSecretRef</code></br>
  17339. <em>
  17340. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17341. External Secrets meta/v1.SecretKeySelector
  17342. </a>
  17343. </em>
  17344. </td>
  17345. <td>
  17346. <p>The AccessKeySecret is used for authentication</p>
  17347. </td>
  17348. </tr>
  17349. </tbody>
  17350. </table>
  17351. <h3 id="external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider
  17352. </h3>
  17353. <p>
  17354. (<em>Appears on:</em>
  17355. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17356. </p>
  17357. <p>
  17358. <p>AlibabaProvider configures a store to sync secrets using the Alibaba Secret Manager provider.</p>
  17359. </p>
  17360. <table>
  17361. <thead>
  17362. <tr>
  17363. <th>Field</th>
  17364. <th>Description</th>
  17365. </tr>
  17366. </thead>
  17367. <tbody>
  17368. <tr>
  17369. <td>
  17370. <code>auth</code></br>
  17371. <em>
  17372. <a href="#external-secrets.io/v1beta1.AlibabaAuth">
  17373. AlibabaAuth
  17374. </a>
  17375. </em>
  17376. </td>
  17377. <td>
  17378. </td>
  17379. </tr>
  17380. <tr>
  17381. <td>
  17382. <code>regionID</code></br>
  17383. <em>
  17384. string
  17385. </em>
  17386. </td>
  17387. <td>
  17388. <p>Alibaba Region to be used for the provider</p>
  17389. </td>
  17390. </tr>
  17391. </tbody>
  17392. </table>
  17393. <h3 id="external-secrets.io/v1beta1.AlibabaRRSAAuth">AlibabaRRSAAuth
  17394. </h3>
  17395. <p>
  17396. (<em>Appears on:</em>
  17397. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  17398. </p>
  17399. <p>
  17400. <p>AlibabaRRSAAuth authenticates against Alibaba using RRSA (Resource-oriented RAM-based Service Authentication).</p>
  17401. </p>
  17402. <table>
  17403. <thead>
  17404. <tr>
  17405. <th>Field</th>
  17406. <th>Description</th>
  17407. </tr>
  17408. </thead>
  17409. <tbody>
  17410. <tr>
  17411. <td>
  17412. <code>oidcProviderArn</code></br>
  17413. <em>
  17414. string
  17415. </em>
  17416. </td>
  17417. <td>
  17418. </td>
  17419. </tr>
  17420. <tr>
  17421. <td>
  17422. <code>oidcTokenFilePath</code></br>
  17423. <em>
  17424. string
  17425. </em>
  17426. </td>
  17427. <td>
  17428. </td>
  17429. </tr>
  17430. <tr>
  17431. <td>
  17432. <code>roleArn</code></br>
  17433. <em>
  17434. string
  17435. </em>
  17436. </td>
  17437. <td>
  17438. </td>
  17439. </tr>
  17440. <tr>
  17441. <td>
  17442. <code>sessionName</code></br>
  17443. <em>
  17444. string
  17445. </em>
  17446. </td>
  17447. <td>
  17448. </td>
  17449. </tr>
  17450. </tbody>
  17451. </table>
  17452. <h3 id="external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol
  17453. </h3>
  17454. <p>
  17455. (<em>Appears on:</em>
  17456. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  17457. </p>
  17458. <p>
  17459. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  17460. </p>
  17461. <table>
  17462. <thead>
  17463. <tr>
  17464. <th>Field</th>
  17465. <th>Description</th>
  17466. </tr>
  17467. </thead>
  17468. <tbody>
  17469. <tr>
  17470. <td>
  17471. <code>ntlm</code></br>
  17472. <em>
  17473. <a href="#external-secrets.io/v1beta1.NTLMProtocol">
  17474. NTLMProtocol
  17475. </a>
  17476. </em>
  17477. </td>
  17478. <td>
  17479. <em>(Optional)</em>
  17480. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  17481. </td>
  17482. </tr>
  17483. </tbody>
  17484. </table>
  17485. <h3 id="external-secrets.io/v1beta1.AzureAuthType">AzureAuthType
  17486. (<code>string</code> alias)</p></h3>
  17487. <p>
  17488. (<em>Appears on:</em>
  17489. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17490. </p>
  17491. <p>
  17492. <p>AzureAuthType describes how to authenticate to the Azure Keyvault.
  17493. Only one of the following auth types may be specified.
  17494. If none of the following auth type is specified, the default one
  17495. is ServicePrincipal.</p>
  17496. </p>
  17497. <table>
  17498. <thead>
  17499. <tr>
  17500. <th>Value</th>
  17501. <th>Description</th>
  17502. </tr>
  17503. </thead>
  17504. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  17505. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  17506. </td>
  17507. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  17508. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  17509. </td>
  17510. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  17511. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  17512. </td>
  17513. </tr></tbody>
  17514. </table>
  17515. <h3 id="external-secrets.io/v1beta1.AzureEnvironmentType">AzureEnvironmentType
  17516. (<code>string</code> alias)</p></h3>
  17517. <p>
  17518. (<em>Appears on:</em>
  17519. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17520. </p>
  17521. <p>
  17522. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  17523. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  17524. 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>
  17525. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  17526. </p>
  17527. <table>
  17528. <thead>
  17529. <tr>
  17530. <th>Value</th>
  17531. <th>Description</th>
  17532. </tr>
  17533. </thead>
  17534. <tbody><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  17535. <td><p>AzureEnvironmentChinaCloud represents the Azure China cloud environment.</p>
  17536. </td>
  17537. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  17538. <td><p>AzureEnvironmentGermanCloud represents the Azure German cloud environment.</p>
  17539. </td>
  17540. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  17541. <td><p>AzureEnvironmentPublicCloud represents the Azure public cloud environment.</p>
  17542. </td>
  17543. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  17544. <td><p>AzureEnvironmentUSGovernmentCloud represents the Azure US government cloud environment.</p>
  17545. </td>
  17546. </tr></tbody>
  17547. </table>
  17548. <h3 id="external-secrets.io/v1beta1.AzureKVAuth">AzureKVAuth
  17549. </h3>
  17550. <p>
  17551. (<em>Appears on:</em>
  17552. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  17553. </p>
  17554. <p>
  17555. <p>AzureKVAuth defines configuration for authentication with Azure Key Vault.</p>
  17556. </p>
  17557. <table>
  17558. <thead>
  17559. <tr>
  17560. <th>Field</th>
  17561. <th>Description</th>
  17562. </tr>
  17563. </thead>
  17564. <tbody>
  17565. <tr>
  17566. <td>
  17567. <code>clientId</code></br>
  17568. <em>
  17569. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17570. External Secrets meta/v1.SecretKeySelector
  17571. </a>
  17572. </em>
  17573. </td>
  17574. <td>
  17575. <em>(Optional)</em>
  17576. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  17577. </td>
  17578. </tr>
  17579. <tr>
  17580. <td>
  17581. <code>tenantId</code></br>
  17582. <em>
  17583. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17584. External Secrets meta/v1.SecretKeySelector
  17585. </a>
  17586. </em>
  17587. </td>
  17588. <td>
  17589. <em>(Optional)</em>
  17590. <p>The Azure tenantId of the managed identity used for authentication.</p>
  17591. </td>
  17592. </tr>
  17593. <tr>
  17594. <td>
  17595. <code>clientSecret</code></br>
  17596. <em>
  17597. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17598. External Secrets meta/v1.SecretKeySelector
  17599. </a>
  17600. </em>
  17601. </td>
  17602. <td>
  17603. <em>(Optional)</em>
  17604. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  17605. </td>
  17606. </tr>
  17607. <tr>
  17608. <td>
  17609. <code>clientCertificate</code></br>
  17610. <em>
  17611. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17612. External Secrets meta/v1.SecretKeySelector
  17613. </a>
  17614. </em>
  17615. </td>
  17616. <td>
  17617. <em>(Optional)</em>
  17618. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  17619. </td>
  17620. </tr>
  17621. </tbody>
  17622. </table>
  17623. <h3 id="external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider
  17624. </h3>
  17625. <p>
  17626. (<em>Appears on:</em>
  17627. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17628. </p>
  17629. <p>
  17630. <p>AzureKVProvider configures a store to sync secrets using Azure Key Vault.</p>
  17631. </p>
  17632. <table>
  17633. <thead>
  17634. <tr>
  17635. <th>Field</th>
  17636. <th>Description</th>
  17637. </tr>
  17638. </thead>
  17639. <tbody>
  17640. <tr>
  17641. <td>
  17642. <code>authType</code></br>
  17643. <em>
  17644. <a href="#external-secrets.io/v1beta1.AzureAuthType">
  17645. AzureAuthType
  17646. </a>
  17647. </em>
  17648. </td>
  17649. <td>
  17650. <em>(Optional)</em>
  17651. <p>Auth type defines how to authenticate to the keyvault service.
  17652. Valid values are:
  17653. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  17654. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)</p>
  17655. </td>
  17656. </tr>
  17657. <tr>
  17658. <td>
  17659. <code>vaultUrl</code></br>
  17660. <em>
  17661. string
  17662. </em>
  17663. </td>
  17664. <td>
  17665. <p>Vault Url from which the secrets to be fetched from.</p>
  17666. </td>
  17667. </tr>
  17668. <tr>
  17669. <td>
  17670. <code>tenantId</code></br>
  17671. <em>
  17672. string
  17673. </em>
  17674. </td>
  17675. <td>
  17676. <em>(Optional)</em>
  17677. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  17678. </td>
  17679. </tr>
  17680. <tr>
  17681. <td>
  17682. <code>environmentType</code></br>
  17683. <em>
  17684. <a href="#external-secrets.io/v1beta1.AzureEnvironmentType">
  17685. AzureEnvironmentType
  17686. </a>
  17687. </em>
  17688. </td>
  17689. <td>
  17690. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  17691. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  17692. 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>
  17693. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  17694. </td>
  17695. </tr>
  17696. <tr>
  17697. <td>
  17698. <code>authSecretRef</code></br>
  17699. <em>
  17700. <a href="#external-secrets.io/v1beta1.AzureKVAuth">
  17701. AzureKVAuth
  17702. </a>
  17703. </em>
  17704. </td>
  17705. <td>
  17706. <em>(Optional)</em>
  17707. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  17708. </td>
  17709. </tr>
  17710. <tr>
  17711. <td>
  17712. <code>serviceAccountRef</code></br>
  17713. <em>
  17714. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17715. External Secrets meta/v1.ServiceAccountSelector
  17716. </a>
  17717. </em>
  17718. </td>
  17719. <td>
  17720. <em>(Optional)</em>
  17721. <p>ServiceAccountRef specified the service account
  17722. that should be used when authenticating with WorkloadIdentity.</p>
  17723. </td>
  17724. </tr>
  17725. <tr>
  17726. <td>
  17727. <code>identityId</code></br>
  17728. <em>
  17729. string
  17730. </em>
  17731. </td>
  17732. <td>
  17733. <em>(Optional)</em>
  17734. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  17735. </td>
  17736. </tr>
  17737. </tbody>
  17738. </table>
  17739. <h3 id="external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  17740. </h3>
  17741. <p>
  17742. (<em>Appears on:</em>
  17743. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth</a>)
  17744. </p>
  17745. <p>
  17746. <p>BeyondTrustProviderSecretRef defines a reference to a secret containing credentials for the BeyondTrust provider.</p>
  17747. </p>
  17748. <table>
  17749. <thead>
  17750. <tr>
  17751. <th>Field</th>
  17752. <th>Description</th>
  17753. </tr>
  17754. </thead>
  17755. <tbody>
  17756. <tr>
  17757. <td>
  17758. <code>value</code></br>
  17759. <em>
  17760. string
  17761. </em>
  17762. </td>
  17763. <td>
  17764. <em>(Optional)</em>
  17765. <p>Value can be specified directly to set a value without using a secret.</p>
  17766. </td>
  17767. </tr>
  17768. <tr>
  17769. <td>
  17770. <code>secretRef</code></br>
  17771. <em>
  17772. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17773. External Secrets meta/v1.SecretKeySelector
  17774. </a>
  17775. </em>
  17776. </td>
  17777. <td>
  17778. <em>(Optional)</em>
  17779. <p>SecretRef references a key in a secret that will be used as value.</p>
  17780. </td>
  17781. </tr>
  17782. </tbody>
  17783. </table>
  17784. <h3 id="external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth
  17785. </h3>
  17786. <p>
  17787. (<em>Appears on:</em>
  17788. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  17789. </p>
  17790. <p>
  17791. <p>BeyondtrustAuth configures authentication for BeyondTrust Password Safe.</p>
  17792. </p>
  17793. <table>
  17794. <thead>
  17795. <tr>
  17796. <th>Field</th>
  17797. <th>Description</th>
  17798. </tr>
  17799. </thead>
  17800. <tbody>
  17801. <tr>
  17802. <td>
  17803. <code>apiKey</code></br>
  17804. <em>
  17805. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17806. BeyondTrustProviderSecretRef
  17807. </a>
  17808. </em>
  17809. </td>
  17810. <td>
  17811. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  17812. </td>
  17813. </tr>
  17814. <tr>
  17815. <td>
  17816. <code>clientId</code></br>
  17817. <em>
  17818. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17819. BeyondTrustProviderSecretRef
  17820. </a>
  17821. </em>
  17822. </td>
  17823. <td>
  17824. <p>ClientID is the API OAuth Client ID.</p>
  17825. </td>
  17826. </tr>
  17827. <tr>
  17828. <td>
  17829. <code>clientSecret</code></br>
  17830. <em>
  17831. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17832. BeyondTrustProviderSecretRef
  17833. </a>
  17834. </em>
  17835. </td>
  17836. <td>
  17837. <p>ClientSecret is the API OAuth Client Secret.</p>
  17838. </td>
  17839. </tr>
  17840. <tr>
  17841. <td>
  17842. <code>certificate</code></br>
  17843. <em>
  17844. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17845. BeyondTrustProviderSecretRef
  17846. </a>
  17847. </em>
  17848. </td>
  17849. <td>
  17850. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  17851. </td>
  17852. </tr>
  17853. <tr>
  17854. <td>
  17855. <code>certificateKey</code></br>
  17856. <em>
  17857. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17858. BeyondTrustProviderSecretRef
  17859. </a>
  17860. </em>
  17861. </td>
  17862. <td>
  17863. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  17864. </td>
  17865. </tr>
  17866. </tbody>
  17867. </table>
  17868. <h3 id="external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider
  17869. </h3>
  17870. <p>
  17871. (<em>Appears on:</em>
  17872. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17873. </p>
  17874. <p>
  17875. <p>BeyondtrustProvider defines configuration for the BeyondTrust Password Safe provider.</p>
  17876. </p>
  17877. <table>
  17878. <thead>
  17879. <tr>
  17880. <th>Field</th>
  17881. <th>Description</th>
  17882. </tr>
  17883. </thead>
  17884. <tbody>
  17885. <tr>
  17886. <td>
  17887. <code>auth</code></br>
  17888. <em>
  17889. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">
  17890. BeyondtrustAuth
  17891. </a>
  17892. </em>
  17893. </td>
  17894. <td>
  17895. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  17896. </td>
  17897. </tr>
  17898. <tr>
  17899. <td>
  17900. <code>server</code></br>
  17901. <em>
  17902. <a href="#external-secrets.io/v1beta1.BeyondtrustServer">
  17903. BeyondtrustServer
  17904. </a>
  17905. </em>
  17906. </td>
  17907. <td>
  17908. <p>Auth configures how API server works.</p>
  17909. </td>
  17910. </tr>
  17911. </tbody>
  17912. </table>
  17913. <h3 id="external-secrets.io/v1beta1.BeyondtrustServer">BeyondtrustServer
  17914. </h3>
  17915. <p>
  17916. (<em>Appears on:</em>
  17917. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  17918. </p>
  17919. <p>
  17920. <p>BeyondtrustServer defines configuration for connecting to BeyondTrust Password Safe server.</p>
  17921. </p>
  17922. <table>
  17923. <thead>
  17924. <tr>
  17925. <th>Field</th>
  17926. <th>Description</th>
  17927. </tr>
  17928. </thead>
  17929. <tbody>
  17930. <tr>
  17931. <td>
  17932. <code>apiUrl</code></br>
  17933. <em>
  17934. string
  17935. </em>
  17936. </td>
  17937. <td>
  17938. </td>
  17939. </tr>
  17940. <tr>
  17941. <td>
  17942. <code>apiVersion</code></br>
  17943. <em>
  17944. string
  17945. </em>
  17946. </td>
  17947. <td>
  17948. </td>
  17949. </tr>
  17950. <tr>
  17951. <td>
  17952. <code>retrievalType</code></br>
  17953. <em>
  17954. string
  17955. </em>
  17956. </td>
  17957. <td>
  17958. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  17959. </td>
  17960. </tr>
  17961. <tr>
  17962. <td>
  17963. <code>separator</code></br>
  17964. <em>
  17965. string
  17966. </em>
  17967. </td>
  17968. <td>
  17969. <p>A character that separates the folder names.</p>
  17970. </td>
  17971. </tr>
  17972. <tr>
  17973. <td>
  17974. <code>decrypt</code></br>
  17975. <em>
  17976. bool
  17977. </em>
  17978. </td>
  17979. <td>
  17980. <em>(Optional)</em>
  17981. <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>
  17982. </td>
  17983. </tr>
  17984. <tr>
  17985. <td>
  17986. <code>verifyCA</code></br>
  17987. <em>
  17988. bool
  17989. </em>
  17990. </td>
  17991. <td>
  17992. </td>
  17993. </tr>
  17994. <tr>
  17995. <td>
  17996. <code>clientTimeOutSeconds</code></br>
  17997. <em>
  17998. int
  17999. </em>
  18000. </td>
  18001. <td>
  18002. <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>
  18003. </td>
  18004. </tr>
  18005. </tbody>
  18006. </table>
  18007. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  18008. </h3>
  18009. <p>
  18010. (<em>Appears on:</em>
  18011. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  18012. </p>
  18013. <p>
  18014. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  18015. </p>
  18016. <table>
  18017. <thead>
  18018. <tr>
  18019. <th>Field</th>
  18020. <th>Description</th>
  18021. </tr>
  18022. </thead>
  18023. <tbody>
  18024. <tr>
  18025. <td>
  18026. <code>secretRef</code></br>
  18027. <em>
  18028. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">
  18029. BitwardenSecretsManagerSecretRef
  18030. </a>
  18031. </em>
  18032. </td>
  18033. <td>
  18034. </td>
  18035. </tr>
  18036. </tbody>
  18037. </table>
  18038. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  18039. </h3>
  18040. <p>
  18041. (<em>Appears on:</em>
  18042. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18043. </p>
  18044. <p>
  18045. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  18046. </p>
  18047. <table>
  18048. <thead>
  18049. <tr>
  18050. <th>Field</th>
  18051. <th>Description</th>
  18052. </tr>
  18053. </thead>
  18054. <tbody>
  18055. <tr>
  18056. <td>
  18057. <code>apiURL</code></br>
  18058. <em>
  18059. string
  18060. </em>
  18061. </td>
  18062. <td>
  18063. </td>
  18064. </tr>
  18065. <tr>
  18066. <td>
  18067. <code>identityURL</code></br>
  18068. <em>
  18069. string
  18070. </em>
  18071. </td>
  18072. <td>
  18073. </td>
  18074. </tr>
  18075. <tr>
  18076. <td>
  18077. <code>bitwardenServerSDKURL</code></br>
  18078. <em>
  18079. string
  18080. </em>
  18081. </td>
  18082. <td>
  18083. </td>
  18084. </tr>
  18085. <tr>
  18086. <td>
  18087. <code>caBundle</code></br>
  18088. <em>
  18089. string
  18090. </em>
  18091. </td>
  18092. <td>
  18093. <em>(Optional)</em>
  18094. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  18095. can be performed.</p>
  18096. </td>
  18097. </tr>
  18098. <tr>
  18099. <td>
  18100. <code>caProvider</code></br>
  18101. <em>
  18102. <a href="#external-secrets.io/v1beta1.CAProvider">
  18103. CAProvider
  18104. </a>
  18105. </em>
  18106. </td>
  18107. <td>
  18108. <em>(Optional)</em>
  18109. <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>
  18110. </td>
  18111. </tr>
  18112. <tr>
  18113. <td>
  18114. <code>organizationID</code></br>
  18115. <em>
  18116. string
  18117. </em>
  18118. </td>
  18119. <td>
  18120. <p>OrganizationID determines which organization this secret store manages.</p>
  18121. </td>
  18122. </tr>
  18123. <tr>
  18124. <td>
  18125. <code>projectID</code></br>
  18126. <em>
  18127. string
  18128. </em>
  18129. </td>
  18130. <td>
  18131. <p>ProjectID determines which project this secret store manages.</p>
  18132. </td>
  18133. </tr>
  18134. <tr>
  18135. <td>
  18136. <code>auth</code></br>
  18137. <em>
  18138. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">
  18139. BitwardenSecretsManagerAuth
  18140. </a>
  18141. </em>
  18142. </td>
  18143. <td>
  18144. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  18145. Make sure that the token being used has permissions on the given secret.</p>
  18146. </td>
  18147. </tr>
  18148. </tbody>
  18149. </table>
  18150. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  18151. </h3>
  18152. <p>
  18153. (<em>Appears on:</em>
  18154. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  18155. </p>
  18156. <p>
  18157. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  18158. </p>
  18159. <table>
  18160. <thead>
  18161. <tr>
  18162. <th>Field</th>
  18163. <th>Description</th>
  18164. </tr>
  18165. </thead>
  18166. <tbody>
  18167. <tr>
  18168. <td>
  18169. <code>credentials</code></br>
  18170. <em>
  18171. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18172. External Secrets meta/v1.SecretKeySelector
  18173. </a>
  18174. </em>
  18175. </td>
  18176. <td>
  18177. <p>AccessToken used for the bitwarden instance.</p>
  18178. </td>
  18179. </tr>
  18180. </tbody>
  18181. </table>
  18182. <h3 id="external-secrets.io/v1beta1.CAProvider">CAProvider
  18183. </h3>
  18184. <p>
  18185. (<em>Appears on:</em>
  18186. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>,
  18187. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  18188. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>,
  18189. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>,
  18190. <a href="#external-secrets.io/v1beta1.KubernetesServer">KubernetesServer</a>,
  18191. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  18192. </p>
  18193. <p>
  18194. <p>CAProvider provides custom certificate authority (CA) certificates
  18195. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  18196. that contains a PEM-encoded certificate.</p>
  18197. </p>
  18198. <table>
  18199. <thead>
  18200. <tr>
  18201. <th>Field</th>
  18202. <th>Description</th>
  18203. </tr>
  18204. </thead>
  18205. <tbody>
  18206. <tr>
  18207. <td>
  18208. <code>type</code></br>
  18209. <em>
  18210. <a href="#external-secrets.io/v1beta1.CAProviderType">
  18211. CAProviderType
  18212. </a>
  18213. </em>
  18214. </td>
  18215. <td>
  18216. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  18217. </td>
  18218. </tr>
  18219. <tr>
  18220. <td>
  18221. <code>name</code></br>
  18222. <em>
  18223. string
  18224. </em>
  18225. </td>
  18226. <td>
  18227. <p>The name of the object located at the provider type.</p>
  18228. </td>
  18229. </tr>
  18230. <tr>
  18231. <td>
  18232. <code>key</code></br>
  18233. <em>
  18234. string
  18235. </em>
  18236. </td>
  18237. <td>
  18238. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  18239. </td>
  18240. </tr>
  18241. <tr>
  18242. <td>
  18243. <code>namespace</code></br>
  18244. <em>
  18245. string
  18246. </em>
  18247. </td>
  18248. <td>
  18249. <em>(Optional)</em>
  18250. <p>The namespace the Provider type is in.
  18251. Can only be defined when used in a ClusterSecretStore.</p>
  18252. </td>
  18253. </tr>
  18254. </tbody>
  18255. </table>
  18256. <h3 id="external-secrets.io/v1beta1.CAProviderType">CAProviderType
  18257. (<code>string</code> alias)</p></h3>
  18258. <p>
  18259. (<em>Appears on:</em>
  18260. <a href="#external-secrets.io/v1beta1.CAProvider">CAProvider</a>)
  18261. </p>
  18262. <p>
  18263. <p>CAProviderType defines the type of provider to use for CA certificates.</p>
  18264. </p>
  18265. <table>
  18266. <thead>
  18267. <tr>
  18268. <th>Value</th>
  18269. <th>Description</th>
  18270. </tr>
  18271. </thead>
  18272. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  18273. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  18274. </td>
  18275. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  18276. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  18277. </td>
  18278. </tr></tbody>
  18279. </table>
  18280. <h3 id="external-secrets.io/v1beta1.CSMAuth">CSMAuth
  18281. </h3>
  18282. <p>
  18283. (<em>Appears on:</em>
  18284. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider</a>)
  18285. </p>
  18286. <p>
  18287. <p>CSMAuth contains a secretRef for credentials.</p>
  18288. </p>
  18289. <table>
  18290. <thead>
  18291. <tr>
  18292. <th>Field</th>
  18293. <th>Description</th>
  18294. </tr>
  18295. </thead>
  18296. <tbody>
  18297. <tr>
  18298. <td>
  18299. <code>secretRef</code></br>
  18300. <em>
  18301. <a href="#external-secrets.io/v1beta1.CSMAuthSecretRef">
  18302. CSMAuthSecretRef
  18303. </a>
  18304. </em>
  18305. </td>
  18306. <td>
  18307. <em>(Optional)</em>
  18308. </td>
  18309. </tr>
  18310. </tbody>
  18311. </table>
  18312. <h3 id="external-secrets.io/v1beta1.CSMAuthSecretRef">CSMAuthSecretRef
  18313. </h3>
  18314. <p>
  18315. (<em>Appears on:</em>
  18316. <a href="#external-secrets.io/v1beta1.CSMAuth">CSMAuth</a>)
  18317. </p>
  18318. <p>
  18319. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  18320. </p>
  18321. <table>
  18322. <thead>
  18323. <tr>
  18324. <th>Field</th>
  18325. <th>Description</th>
  18326. </tr>
  18327. </thead>
  18328. <tbody>
  18329. <tr>
  18330. <td>
  18331. <code>accessKeyIDSecretRef</code></br>
  18332. <em>
  18333. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18334. External Secrets meta/v1.SecretKeySelector
  18335. </a>
  18336. </em>
  18337. </td>
  18338. <td>
  18339. <p>The AccessKeyID is used for authentication</p>
  18340. </td>
  18341. </tr>
  18342. <tr>
  18343. <td>
  18344. <code>accessKeySecretSecretRef</code></br>
  18345. <em>
  18346. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18347. External Secrets meta/v1.SecretKeySelector
  18348. </a>
  18349. </em>
  18350. </td>
  18351. <td>
  18352. <p>The AccessKeySecret is used for authentication</p>
  18353. </td>
  18354. </tr>
  18355. </tbody>
  18356. </table>
  18357. <h3 id="external-secrets.io/v1beta1.CertAuth">CertAuth
  18358. </h3>
  18359. <p>
  18360. (<em>Appears on:</em>
  18361. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  18362. </p>
  18363. <p>
  18364. <p>CertAuth defines certificate-based authentication for the Kubernetes provider.</p>
  18365. </p>
  18366. <table>
  18367. <thead>
  18368. <tr>
  18369. <th>Field</th>
  18370. <th>Description</th>
  18371. </tr>
  18372. </thead>
  18373. <tbody>
  18374. <tr>
  18375. <td>
  18376. <code>clientCert</code></br>
  18377. <em>
  18378. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18379. External Secrets meta/v1.SecretKeySelector
  18380. </a>
  18381. </em>
  18382. </td>
  18383. <td>
  18384. </td>
  18385. </tr>
  18386. <tr>
  18387. <td>
  18388. <code>clientKey</code></br>
  18389. <em>
  18390. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18391. External Secrets meta/v1.SecretKeySelector
  18392. </a>
  18393. </em>
  18394. </td>
  18395. <td>
  18396. </td>
  18397. </tr>
  18398. </tbody>
  18399. </table>
  18400. <h3 id="external-secrets.io/v1beta1.ChefAuth">ChefAuth
  18401. </h3>
  18402. <p>
  18403. (<em>Appears on:</em>
  18404. <a href="#external-secrets.io/v1beta1.ChefProvider">ChefProvider</a>)
  18405. </p>
  18406. <p>
  18407. <p>ChefAuth contains a secretRef for credentials.</p>
  18408. </p>
  18409. <table>
  18410. <thead>
  18411. <tr>
  18412. <th>Field</th>
  18413. <th>Description</th>
  18414. </tr>
  18415. </thead>
  18416. <tbody>
  18417. <tr>
  18418. <td>
  18419. <code>secretRef</code></br>
  18420. <em>
  18421. <a href="#external-secrets.io/v1beta1.ChefAuthSecretRef">
  18422. ChefAuthSecretRef
  18423. </a>
  18424. </em>
  18425. </td>
  18426. <td>
  18427. </td>
  18428. </tr>
  18429. </tbody>
  18430. </table>
  18431. <h3 id="external-secrets.io/v1beta1.ChefAuthSecretRef">ChefAuthSecretRef
  18432. </h3>
  18433. <p>
  18434. (<em>Appears on:</em>
  18435. <a href="#external-secrets.io/v1beta1.ChefAuth">ChefAuth</a>)
  18436. </p>
  18437. <p>
  18438. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  18439. </p>
  18440. <table>
  18441. <thead>
  18442. <tr>
  18443. <th>Field</th>
  18444. <th>Description</th>
  18445. </tr>
  18446. </thead>
  18447. <tbody>
  18448. <tr>
  18449. <td>
  18450. <code>privateKeySecretRef</code></br>
  18451. <em>
  18452. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18453. External Secrets meta/v1.SecretKeySelector
  18454. </a>
  18455. </em>
  18456. </td>
  18457. <td>
  18458. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  18459. </td>
  18460. </tr>
  18461. </tbody>
  18462. </table>
  18463. <h3 id="external-secrets.io/v1beta1.ChefProvider">ChefProvider
  18464. </h3>
  18465. <p>
  18466. (<em>Appears on:</em>
  18467. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18468. </p>
  18469. <p>
  18470. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  18471. </p>
  18472. <table>
  18473. <thead>
  18474. <tr>
  18475. <th>Field</th>
  18476. <th>Description</th>
  18477. </tr>
  18478. </thead>
  18479. <tbody>
  18480. <tr>
  18481. <td>
  18482. <code>auth</code></br>
  18483. <em>
  18484. <a href="#external-secrets.io/v1beta1.ChefAuth">
  18485. ChefAuth
  18486. </a>
  18487. </em>
  18488. </td>
  18489. <td>
  18490. <p>Auth defines the information necessary to authenticate against chef Server</p>
  18491. </td>
  18492. </tr>
  18493. <tr>
  18494. <td>
  18495. <code>username</code></br>
  18496. <em>
  18497. string
  18498. </em>
  18499. </td>
  18500. <td>
  18501. <p>UserName should be the user ID on the chef server</p>
  18502. </td>
  18503. </tr>
  18504. <tr>
  18505. <td>
  18506. <code>serverUrl</code></br>
  18507. <em>
  18508. string
  18509. </em>
  18510. </td>
  18511. <td>
  18512. <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>
  18513. </td>
  18514. </tr>
  18515. </tbody>
  18516. </table>
  18517. <h3 id="external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider
  18518. </h3>
  18519. <p>
  18520. (<em>Appears on:</em>
  18521. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18522. </p>
  18523. <p>
  18524. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  18525. </p>
  18526. <table>
  18527. <thead>
  18528. <tr>
  18529. <th>Field</th>
  18530. <th>Description</th>
  18531. </tr>
  18532. </thead>
  18533. <tbody>
  18534. <tr>
  18535. <td>
  18536. <code>auth</code></br>
  18537. <em>
  18538. <a href="#external-secrets.io/v1beta1.CSMAuth">
  18539. CSMAuth
  18540. </a>
  18541. </em>
  18542. </td>
  18543. <td>
  18544. </td>
  18545. </tr>
  18546. <tr>
  18547. <td>
  18548. <code>projectID</code></br>
  18549. <em>
  18550. string
  18551. </em>
  18552. </td>
  18553. <td>
  18554. <p>ProjectID is the project, which the secrets are stored in.</p>
  18555. </td>
  18556. </tr>
  18557. </tbody>
  18558. </table>
  18559. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret
  18560. </h3>
  18561. <p>
  18562. <p>ClusterExternalSecret is the schema for the clusterexternalsecrets API.</p>
  18563. </p>
  18564. <table>
  18565. <thead>
  18566. <tr>
  18567. <th>Field</th>
  18568. <th>Description</th>
  18569. </tr>
  18570. </thead>
  18571. <tbody>
  18572. <tr>
  18573. <td>
  18574. <code>metadata</code></br>
  18575. <em>
  18576. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  18577. Kubernetes meta/v1.ObjectMeta
  18578. </a>
  18579. </em>
  18580. </td>
  18581. <td>
  18582. Refer to the Kubernetes API documentation for the fields of the
  18583. <code>metadata</code> field.
  18584. </td>
  18585. </tr>
  18586. <tr>
  18587. <td>
  18588. <code>spec</code></br>
  18589. <em>
  18590. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">
  18591. ClusterExternalSecretSpec
  18592. </a>
  18593. </em>
  18594. </td>
  18595. <td>
  18596. <br/>
  18597. <br/>
  18598. <table>
  18599. <tr>
  18600. <td>
  18601. <code>externalSecretSpec</code></br>
  18602. <em>
  18603. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  18604. ExternalSecretSpec
  18605. </a>
  18606. </em>
  18607. </td>
  18608. <td>
  18609. <p>The spec for the ExternalSecrets to be created</p>
  18610. </td>
  18611. </tr>
  18612. <tr>
  18613. <td>
  18614. <code>externalSecretName</code></br>
  18615. <em>
  18616. string
  18617. </em>
  18618. </td>
  18619. <td>
  18620. <em>(Optional)</em>
  18621. <p>The name of the external secrets to be created.
  18622. Defaults to the name of the ClusterExternalSecret</p>
  18623. </td>
  18624. </tr>
  18625. <tr>
  18626. <td>
  18627. <code>externalSecretMetadata</code></br>
  18628. <em>
  18629. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  18630. ExternalSecretMetadata
  18631. </a>
  18632. </em>
  18633. </td>
  18634. <td>
  18635. <em>(Optional)</em>
  18636. <p>The metadata of the external secrets to be created</p>
  18637. </td>
  18638. </tr>
  18639. <tr>
  18640. <td>
  18641. <code>namespaceSelector</code></br>
  18642. <em>
  18643. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  18644. Kubernetes meta/v1.LabelSelector
  18645. </a>
  18646. </em>
  18647. </td>
  18648. <td>
  18649. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  18650. </td>
  18651. </tr>
  18652. <tr>
  18653. <td>
  18654. <code>namespaceSelectors</code></br>
  18655. <em>
  18656. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  18657. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  18658. </a>
  18659. </em>
  18660. </td>
  18661. <td>
  18662. <em>(Optional)</em>
  18663. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  18664. </td>
  18665. </tr>
  18666. <tr>
  18667. <td>
  18668. <code>namespaces</code></br>
  18669. <em>
  18670. []string
  18671. </em>
  18672. </td>
  18673. <td>
  18674. <em>(Optional)</em>
  18675. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  18676. <p>Deprecated: Use NamespaceSelectors instead.</p>
  18677. </td>
  18678. </tr>
  18679. <tr>
  18680. <td>
  18681. <code>refreshTime</code></br>
  18682. <em>
  18683. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  18684. Kubernetes meta/v1.Duration
  18685. </a>
  18686. </em>
  18687. </td>
  18688. <td>
  18689. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  18690. </td>
  18691. </tr>
  18692. </table>
  18693. </td>
  18694. </tr>
  18695. <tr>
  18696. <td>
  18697. <code>status</code></br>
  18698. <em>
  18699. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">
  18700. ClusterExternalSecretStatus
  18701. </a>
  18702. </em>
  18703. </td>
  18704. <td>
  18705. </td>
  18706. </tr>
  18707. </tbody>
  18708. </table>
  18709. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  18710. (<code>string</code> alias)</p></h3>
  18711. <p>
  18712. (<em>Appears on:</em>
  18713. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  18714. </p>
  18715. <p>
  18716. <p>ClusterExternalSecretConditionType indicates the condition of the ClusterExternalSecret.</p>
  18717. </p>
  18718. <table>
  18719. <thead>
  18720. <tr>
  18721. <th>Value</th>
  18722. <th>Description</th>
  18723. </tr>
  18724. </thead>
  18725. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  18726. <td><p>ClusterExternalSecretReady indicates the ClusterExternalSecret resource is ready.</p>
  18727. </td>
  18728. </tr></tbody>
  18729. </table>
  18730. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  18731. </h3>
  18732. <p>
  18733. (<em>Appears on:</em>
  18734. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  18735. </p>
  18736. <p>
  18737. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  18738. </p>
  18739. <table>
  18740. <thead>
  18741. <tr>
  18742. <th>Field</th>
  18743. <th>Description</th>
  18744. </tr>
  18745. </thead>
  18746. <tbody>
  18747. <tr>
  18748. <td>
  18749. <code>namespace</code></br>
  18750. <em>
  18751. string
  18752. </em>
  18753. </td>
  18754. <td>
  18755. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  18756. </td>
  18757. </tr>
  18758. <tr>
  18759. <td>
  18760. <code>reason</code></br>
  18761. <em>
  18762. string
  18763. </em>
  18764. </td>
  18765. <td>
  18766. <em>(Optional)</em>
  18767. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  18768. </td>
  18769. </tr>
  18770. </tbody>
  18771. </table>
  18772. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  18773. </h3>
  18774. <p>
  18775. (<em>Appears on:</em>
  18776. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  18777. </p>
  18778. <p>
  18779. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  18780. </p>
  18781. <table>
  18782. <thead>
  18783. <tr>
  18784. <th>Field</th>
  18785. <th>Description</th>
  18786. </tr>
  18787. </thead>
  18788. <tbody>
  18789. <tr>
  18790. <td>
  18791. <code>externalSecretSpec</code></br>
  18792. <em>
  18793. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  18794. ExternalSecretSpec
  18795. </a>
  18796. </em>
  18797. </td>
  18798. <td>
  18799. <p>The spec for the ExternalSecrets to be created</p>
  18800. </td>
  18801. </tr>
  18802. <tr>
  18803. <td>
  18804. <code>externalSecretName</code></br>
  18805. <em>
  18806. string
  18807. </em>
  18808. </td>
  18809. <td>
  18810. <em>(Optional)</em>
  18811. <p>The name of the external secrets to be created.
  18812. Defaults to the name of the ClusterExternalSecret</p>
  18813. </td>
  18814. </tr>
  18815. <tr>
  18816. <td>
  18817. <code>externalSecretMetadata</code></br>
  18818. <em>
  18819. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  18820. ExternalSecretMetadata
  18821. </a>
  18822. </em>
  18823. </td>
  18824. <td>
  18825. <em>(Optional)</em>
  18826. <p>The metadata of the external secrets to be created</p>
  18827. </td>
  18828. </tr>
  18829. <tr>
  18830. <td>
  18831. <code>namespaceSelector</code></br>
  18832. <em>
  18833. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  18834. Kubernetes meta/v1.LabelSelector
  18835. </a>
  18836. </em>
  18837. </td>
  18838. <td>
  18839. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  18840. </td>
  18841. </tr>
  18842. <tr>
  18843. <td>
  18844. <code>namespaceSelectors</code></br>
  18845. <em>
  18846. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  18847. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  18848. </a>
  18849. </em>
  18850. </td>
  18851. <td>
  18852. <em>(Optional)</em>
  18853. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  18854. </td>
  18855. </tr>
  18856. <tr>
  18857. <td>
  18858. <code>namespaces</code></br>
  18859. <em>
  18860. []string
  18861. </em>
  18862. </td>
  18863. <td>
  18864. <em>(Optional)</em>
  18865. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  18866. <p>Deprecated: Use NamespaceSelectors instead.</p>
  18867. </td>
  18868. </tr>
  18869. <tr>
  18870. <td>
  18871. <code>refreshTime</code></br>
  18872. <em>
  18873. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  18874. Kubernetes meta/v1.Duration
  18875. </a>
  18876. </em>
  18877. </td>
  18878. <td>
  18879. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  18880. </td>
  18881. </tr>
  18882. </tbody>
  18883. </table>
  18884. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  18885. </h3>
  18886. <p>
  18887. (<em>Appears on:</em>
  18888. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  18889. </p>
  18890. <p>
  18891. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  18892. </p>
  18893. <table>
  18894. <thead>
  18895. <tr>
  18896. <th>Field</th>
  18897. <th>Description</th>
  18898. </tr>
  18899. </thead>
  18900. <tbody>
  18901. <tr>
  18902. <td>
  18903. <code>externalSecretName</code></br>
  18904. <em>
  18905. string
  18906. </em>
  18907. </td>
  18908. <td>
  18909. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  18910. </td>
  18911. </tr>
  18912. <tr>
  18913. <td>
  18914. <code>failedNamespaces</code></br>
  18915. <em>
  18916. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">
  18917. []ClusterExternalSecretNamespaceFailure
  18918. </a>
  18919. </em>
  18920. </td>
  18921. <td>
  18922. <em>(Optional)</em>
  18923. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  18924. </td>
  18925. </tr>
  18926. <tr>
  18927. <td>
  18928. <code>provisionedNamespaces</code></br>
  18929. <em>
  18930. []string
  18931. </em>
  18932. </td>
  18933. <td>
  18934. <em>(Optional)</em>
  18935. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  18936. </td>
  18937. </tr>
  18938. <tr>
  18939. <td>
  18940. <code>conditions</code></br>
  18941. <em>
  18942. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">
  18943. []ClusterExternalSecretStatusCondition
  18944. </a>
  18945. </em>
  18946. </td>
  18947. <td>
  18948. <em>(Optional)</em>
  18949. </td>
  18950. </tr>
  18951. </tbody>
  18952. </table>
  18953. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  18954. </h3>
  18955. <p>
  18956. (<em>Appears on:</em>
  18957. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  18958. </p>
  18959. <p>
  18960. <p>ClusterExternalSecretStatusCondition indicates the status of the ClusterExternalSecret.</p>
  18961. </p>
  18962. <table>
  18963. <thead>
  18964. <tr>
  18965. <th>Field</th>
  18966. <th>Description</th>
  18967. </tr>
  18968. </thead>
  18969. <tbody>
  18970. <tr>
  18971. <td>
  18972. <code>type</code></br>
  18973. <em>
  18974. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretConditionType">
  18975. ClusterExternalSecretConditionType
  18976. </a>
  18977. </em>
  18978. </td>
  18979. <td>
  18980. </td>
  18981. </tr>
  18982. <tr>
  18983. <td>
  18984. <code>status</code></br>
  18985. <em>
  18986. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  18987. Kubernetes core/v1.ConditionStatus
  18988. </a>
  18989. </em>
  18990. </td>
  18991. <td>
  18992. </td>
  18993. </tr>
  18994. <tr>
  18995. <td>
  18996. <code>message</code></br>
  18997. <em>
  18998. string
  18999. </em>
  19000. </td>
  19001. <td>
  19002. <em>(Optional)</em>
  19003. </td>
  19004. </tr>
  19005. </tbody>
  19006. </table>
  19007. <h3 id="external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore
  19008. </h3>
  19009. <p>
  19010. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  19011. </p>
  19012. <table>
  19013. <thead>
  19014. <tr>
  19015. <th>Field</th>
  19016. <th>Description</th>
  19017. </tr>
  19018. </thead>
  19019. <tbody>
  19020. <tr>
  19021. <td>
  19022. <code>metadata</code></br>
  19023. <em>
  19024. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  19025. Kubernetes meta/v1.ObjectMeta
  19026. </a>
  19027. </em>
  19028. </td>
  19029. <td>
  19030. Refer to the Kubernetes API documentation for the fields of the
  19031. <code>metadata</code> field.
  19032. </td>
  19033. </tr>
  19034. <tr>
  19035. <td>
  19036. <code>spec</code></br>
  19037. <em>
  19038. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  19039. SecretStoreSpec
  19040. </a>
  19041. </em>
  19042. </td>
  19043. <td>
  19044. <br/>
  19045. <br/>
  19046. <table>
  19047. <tr>
  19048. <td>
  19049. <code>controller</code></br>
  19050. <em>
  19051. string
  19052. </em>
  19053. </td>
  19054. <td>
  19055. <em>(Optional)</em>
  19056. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  19057. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  19058. </td>
  19059. </tr>
  19060. <tr>
  19061. <td>
  19062. <code>provider</code></br>
  19063. <em>
  19064. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  19065. SecretStoreProvider
  19066. </a>
  19067. </em>
  19068. </td>
  19069. <td>
  19070. <p>Used to configure the provider. Only one provider may be set</p>
  19071. </td>
  19072. </tr>
  19073. <tr>
  19074. <td>
  19075. <code>retrySettings</code></br>
  19076. <em>
  19077. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  19078. SecretStoreRetrySettings
  19079. </a>
  19080. </em>
  19081. </td>
  19082. <td>
  19083. <em>(Optional)</em>
  19084. <p>Used to configure HTTP retries on failures.</p>
  19085. </td>
  19086. </tr>
  19087. <tr>
  19088. <td>
  19089. <code>refreshInterval</code></br>
  19090. <em>
  19091. int
  19092. </em>
  19093. </td>
  19094. <td>
  19095. <em>(Optional)</em>
  19096. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  19097. </td>
  19098. </tr>
  19099. <tr>
  19100. <td>
  19101. <code>conditions</code></br>
  19102. <em>
  19103. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  19104. []ClusterSecretStoreCondition
  19105. </a>
  19106. </em>
  19107. </td>
  19108. <td>
  19109. <em>(Optional)</em>
  19110. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  19111. </td>
  19112. </tr>
  19113. </table>
  19114. </td>
  19115. </tr>
  19116. <tr>
  19117. <td>
  19118. <code>status</code></br>
  19119. <em>
  19120. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  19121. SecretStoreStatus
  19122. </a>
  19123. </em>
  19124. </td>
  19125. <td>
  19126. </td>
  19127. </tr>
  19128. </tbody>
  19129. </table>
  19130. <h3 id="external-secrets.io/v1beta1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  19131. </h3>
  19132. <p>
  19133. (<em>Appears on:</em>
  19134. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  19135. </p>
  19136. <p>
  19137. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  19138. for a ClusterSecretStore instance.</p>
  19139. </p>
  19140. <table>
  19141. <thead>
  19142. <tr>
  19143. <th>Field</th>
  19144. <th>Description</th>
  19145. </tr>
  19146. </thead>
  19147. <tbody>
  19148. <tr>
  19149. <td>
  19150. <code>namespaceSelector</code></br>
  19151. <em>
  19152. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  19153. Kubernetes meta/v1.LabelSelector
  19154. </a>
  19155. </em>
  19156. </td>
  19157. <td>
  19158. <em>(Optional)</em>
  19159. <p>Choose namespace using a labelSelector</p>
  19160. </td>
  19161. </tr>
  19162. <tr>
  19163. <td>
  19164. <code>namespaces</code></br>
  19165. <em>
  19166. []string
  19167. </em>
  19168. </td>
  19169. <td>
  19170. <em>(Optional)</em>
  19171. <p>Choose namespaces by name</p>
  19172. </td>
  19173. </tr>
  19174. <tr>
  19175. <td>
  19176. <code>namespaceRegexes</code></br>
  19177. <em>
  19178. []string
  19179. </em>
  19180. </td>
  19181. <td>
  19182. <em>(Optional)</em>
  19183. <p>Choose namespaces by using regex matching</p>
  19184. </td>
  19185. </tr>
  19186. </tbody>
  19187. </table>
  19188. <h3 id="external-secrets.io/v1beta1.ConjurAPIKey">ConjurAPIKey
  19189. </h3>
  19190. <p>
  19191. (<em>Appears on:</em>
  19192. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  19193. </p>
  19194. <p>
  19195. <p>ConjurAPIKey defines authentication using a Conjur API key.</p>
  19196. </p>
  19197. <table>
  19198. <thead>
  19199. <tr>
  19200. <th>Field</th>
  19201. <th>Description</th>
  19202. </tr>
  19203. </thead>
  19204. <tbody>
  19205. <tr>
  19206. <td>
  19207. <code>account</code></br>
  19208. <em>
  19209. string
  19210. </em>
  19211. </td>
  19212. <td>
  19213. <p>Account is the Conjur organization account name.</p>
  19214. </td>
  19215. </tr>
  19216. <tr>
  19217. <td>
  19218. <code>userRef</code></br>
  19219. <em>
  19220. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19221. External Secrets meta/v1.SecretKeySelector
  19222. </a>
  19223. </em>
  19224. </td>
  19225. <td>
  19226. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  19227. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  19228. </td>
  19229. </tr>
  19230. <tr>
  19231. <td>
  19232. <code>apiKeyRef</code></br>
  19233. <em>
  19234. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19235. External Secrets meta/v1.SecretKeySelector
  19236. </a>
  19237. </em>
  19238. </td>
  19239. <td>
  19240. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  19241. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  19242. </td>
  19243. </tr>
  19244. </tbody>
  19245. </table>
  19246. <h3 id="external-secrets.io/v1beta1.ConjurAuth">ConjurAuth
  19247. </h3>
  19248. <p>
  19249. (<em>Appears on:</em>
  19250. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>)
  19251. </p>
  19252. <p>
  19253. <p>ConjurAuth defines the methods of authentication with Conjur.</p>
  19254. </p>
  19255. <table>
  19256. <thead>
  19257. <tr>
  19258. <th>Field</th>
  19259. <th>Description</th>
  19260. </tr>
  19261. </thead>
  19262. <tbody>
  19263. <tr>
  19264. <td>
  19265. <code>apikey</code></br>
  19266. <em>
  19267. <a href="#external-secrets.io/v1beta1.ConjurAPIKey">
  19268. ConjurAPIKey
  19269. </a>
  19270. </em>
  19271. </td>
  19272. <td>
  19273. <em>(Optional)</em>
  19274. <p>Authenticates with Conjur using an API key.</p>
  19275. </td>
  19276. </tr>
  19277. <tr>
  19278. <td>
  19279. <code>jwt</code></br>
  19280. <em>
  19281. <a href="#external-secrets.io/v1beta1.ConjurJWT">
  19282. ConjurJWT
  19283. </a>
  19284. </em>
  19285. </td>
  19286. <td>
  19287. <em>(Optional)</em>
  19288. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  19289. </td>
  19290. </tr>
  19291. </tbody>
  19292. </table>
  19293. <h3 id="external-secrets.io/v1beta1.ConjurJWT">ConjurJWT
  19294. </h3>
  19295. <p>
  19296. (<em>Appears on:</em>
  19297. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  19298. </p>
  19299. <p>
  19300. <p>ConjurJWT defines authentication using a JWT service account token.</p>
  19301. </p>
  19302. <table>
  19303. <thead>
  19304. <tr>
  19305. <th>Field</th>
  19306. <th>Description</th>
  19307. </tr>
  19308. </thead>
  19309. <tbody>
  19310. <tr>
  19311. <td>
  19312. <code>account</code></br>
  19313. <em>
  19314. string
  19315. </em>
  19316. </td>
  19317. <td>
  19318. <p>Account is the Conjur organization account name.</p>
  19319. </td>
  19320. </tr>
  19321. <tr>
  19322. <td>
  19323. <code>serviceID</code></br>
  19324. <em>
  19325. string
  19326. </em>
  19327. </td>
  19328. <td>
  19329. <p>The conjur authn jwt webservice id</p>
  19330. </td>
  19331. </tr>
  19332. <tr>
  19333. <td>
  19334. <code>hostId</code></br>
  19335. <em>
  19336. string
  19337. </em>
  19338. </td>
  19339. <td>
  19340. <em>(Optional)</em>
  19341. <p>Optional HostID for JWT authentication. This may be used depending
  19342. on how the Conjur JWT authenticator policy is configured.</p>
  19343. </td>
  19344. </tr>
  19345. <tr>
  19346. <td>
  19347. <code>secretRef</code></br>
  19348. <em>
  19349. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19350. External Secrets meta/v1.SecretKeySelector
  19351. </a>
  19352. </em>
  19353. </td>
  19354. <td>
  19355. <em>(Optional)</em>
  19356. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  19357. authenticate with Conjur using the JWT authentication method.</p>
  19358. </td>
  19359. </tr>
  19360. <tr>
  19361. <td>
  19362. <code>serviceAccountRef</code></br>
  19363. <em>
  19364. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  19365. External Secrets meta/v1.ServiceAccountSelector
  19366. </a>
  19367. </em>
  19368. </td>
  19369. <td>
  19370. <em>(Optional)</em>
  19371. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  19372. a token for with the <code>TokenRequest</code> API.</p>
  19373. </td>
  19374. </tr>
  19375. </tbody>
  19376. </table>
  19377. <h3 id="external-secrets.io/v1beta1.ConjurProvider">ConjurProvider
  19378. </h3>
  19379. <p>
  19380. (<em>Appears on:</em>
  19381. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19382. </p>
  19383. <p>
  19384. <p>ConjurProvider defines configuration for the CyberArk Conjur provider.</p>
  19385. </p>
  19386. <table>
  19387. <thead>
  19388. <tr>
  19389. <th>Field</th>
  19390. <th>Description</th>
  19391. </tr>
  19392. </thead>
  19393. <tbody>
  19394. <tr>
  19395. <td>
  19396. <code>url</code></br>
  19397. <em>
  19398. string
  19399. </em>
  19400. </td>
  19401. <td>
  19402. <p>URL is the endpoint of the Conjur instance.</p>
  19403. </td>
  19404. </tr>
  19405. <tr>
  19406. <td>
  19407. <code>caBundle</code></br>
  19408. <em>
  19409. string
  19410. </em>
  19411. </td>
  19412. <td>
  19413. <em>(Optional)</em>
  19414. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  19415. </td>
  19416. </tr>
  19417. <tr>
  19418. <td>
  19419. <code>caProvider</code></br>
  19420. <em>
  19421. <a href="#external-secrets.io/v1beta1.CAProvider">
  19422. CAProvider
  19423. </a>
  19424. </em>
  19425. </td>
  19426. <td>
  19427. <em>(Optional)</em>
  19428. <p>Used to provide custom certificate authority (CA) certificates
  19429. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  19430. that contains a PEM-encoded certificate.</p>
  19431. </td>
  19432. </tr>
  19433. <tr>
  19434. <td>
  19435. <code>auth</code></br>
  19436. <em>
  19437. <a href="#external-secrets.io/v1beta1.ConjurAuth">
  19438. ConjurAuth
  19439. </a>
  19440. </em>
  19441. </td>
  19442. <td>
  19443. <p>Defines authentication settings for connecting to Conjur.</p>
  19444. </td>
  19445. </tr>
  19446. </tbody>
  19447. </table>
  19448. <h3 id="external-secrets.io/v1beta1.DelineaProvider">DelineaProvider
  19449. </h3>
  19450. <p>
  19451. (<em>Appears on:</em>
  19452. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19453. </p>
  19454. <p>
  19455. <p>DelineaProvider defines configuration for the Delinea DevOps Secrets Vault provider.
  19456. 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>
  19457. </p>
  19458. <table>
  19459. <thead>
  19460. <tr>
  19461. <th>Field</th>
  19462. <th>Description</th>
  19463. </tr>
  19464. </thead>
  19465. <tbody>
  19466. <tr>
  19467. <td>
  19468. <code>clientId</code></br>
  19469. <em>
  19470. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  19471. DelineaProviderSecretRef
  19472. </a>
  19473. </em>
  19474. </td>
  19475. <td>
  19476. <p>ClientID is the non-secret part of the credential.</p>
  19477. </td>
  19478. </tr>
  19479. <tr>
  19480. <td>
  19481. <code>clientSecret</code></br>
  19482. <em>
  19483. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  19484. DelineaProviderSecretRef
  19485. </a>
  19486. </em>
  19487. </td>
  19488. <td>
  19489. <p>ClientSecret is the secret part of the credential.</p>
  19490. </td>
  19491. </tr>
  19492. <tr>
  19493. <td>
  19494. <code>tenant</code></br>
  19495. <em>
  19496. string
  19497. </em>
  19498. </td>
  19499. <td>
  19500. <p>Tenant is the chosen hostname / site name.</p>
  19501. </td>
  19502. </tr>
  19503. <tr>
  19504. <td>
  19505. <code>urlTemplate</code></br>
  19506. <em>
  19507. string
  19508. </em>
  19509. </td>
  19510. <td>
  19511. <em>(Optional)</em>
  19512. <p>URLTemplate
  19513. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  19514. </td>
  19515. </tr>
  19516. <tr>
  19517. <td>
  19518. <code>tld</code></br>
  19519. <em>
  19520. string
  19521. </em>
  19522. </td>
  19523. <td>
  19524. <em>(Optional)</em>
  19525. <p>TLD is based on the server location that was chosen during provisioning.
  19526. If unset, defaults to &ldquo;com&rdquo;.</p>
  19527. </td>
  19528. </tr>
  19529. </tbody>
  19530. </table>
  19531. <h3 id="external-secrets.io/v1beta1.DelineaProviderSecretRef">DelineaProviderSecretRef
  19532. </h3>
  19533. <p>
  19534. (<em>Appears on:</em>
  19535. <a href="#external-secrets.io/v1beta1.DelineaProvider">DelineaProvider</a>)
  19536. </p>
  19537. <p>
  19538. <p>DelineaProviderSecretRef defines a reference to a secret containing credentials for the Delinea provider.</p>
  19539. </p>
  19540. <table>
  19541. <thead>
  19542. <tr>
  19543. <th>Field</th>
  19544. <th>Description</th>
  19545. </tr>
  19546. </thead>
  19547. <tbody>
  19548. <tr>
  19549. <td>
  19550. <code>value</code></br>
  19551. <em>
  19552. string
  19553. </em>
  19554. </td>
  19555. <td>
  19556. <em>(Optional)</em>
  19557. <p>Value can be specified directly to set a value without using a secret.</p>
  19558. </td>
  19559. </tr>
  19560. <tr>
  19561. <td>
  19562. <code>secretRef</code></br>
  19563. <em>
  19564. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19565. External Secrets meta/v1.SecretKeySelector
  19566. </a>
  19567. </em>
  19568. </td>
  19569. <td>
  19570. <em>(Optional)</em>
  19571. <p>SecretRef references a key in a secret that will be used as value.</p>
  19572. </td>
  19573. </tr>
  19574. </tbody>
  19575. </table>
  19576. <h3 id="external-secrets.io/v1beta1.Device42Auth">Device42Auth
  19577. </h3>
  19578. <p>
  19579. (<em>Appears on:</em>
  19580. <a href="#external-secrets.io/v1beta1.Device42Provider">Device42Provider</a>)
  19581. </p>
  19582. <p>
  19583. <p>Device42Auth defines the authentication method for the Device42 provider.</p>
  19584. </p>
  19585. <table>
  19586. <thead>
  19587. <tr>
  19588. <th>Field</th>
  19589. <th>Description</th>
  19590. </tr>
  19591. </thead>
  19592. <tbody>
  19593. <tr>
  19594. <td>
  19595. <code>secretRef</code></br>
  19596. <em>
  19597. <a href="#external-secrets.io/v1beta1.Device42SecretRef">
  19598. Device42SecretRef
  19599. </a>
  19600. </em>
  19601. </td>
  19602. <td>
  19603. </td>
  19604. </tr>
  19605. </tbody>
  19606. </table>
  19607. <h3 id="external-secrets.io/v1beta1.Device42Provider">Device42Provider
  19608. </h3>
  19609. <p>
  19610. (<em>Appears on:</em>
  19611. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19612. </p>
  19613. <p>
  19614. <p>Device42Provider configures a store to sync secrets with a Device42 instance.</p>
  19615. </p>
  19616. <table>
  19617. <thead>
  19618. <tr>
  19619. <th>Field</th>
  19620. <th>Description</th>
  19621. </tr>
  19622. </thead>
  19623. <tbody>
  19624. <tr>
  19625. <td>
  19626. <code>host</code></br>
  19627. <em>
  19628. string
  19629. </em>
  19630. </td>
  19631. <td>
  19632. <p>URL configures the Device42 instance URL.</p>
  19633. </td>
  19634. </tr>
  19635. <tr>
  19636. <td>
  19637. <code>auth</code></br>
  19638. <em>
  19639. <a href="#external-secrets.io/v1beta1.Device42Auth">
  19640. Device42Auth
  19641. </a>
  19642. </em>
  19643. </td>
  19644. <td>
  19645. <p>Auth configures how secret-manager authenticates with a Device42 instance.</p>
  19646. </td>
  19647. </tr>
  19648. </tbody>
  19649. </table>
  19650. <h3 id="external-secrets.io/v1beta1.Device42SecretRef">Device42SecretRef
  19651. </h3>
  19652. <p>
  19653. (<em>Appears on:</em>
  19654. <a href="#external-secrets.io/v1beta1.Device42Auth">Device42Auth</a>)
  19655. </p>
  19656. <p>
  19657. <p>Device42SecretRef defines a reference to a secret containing credentials for the Device42 provider.</p>
  19658. </p>
  19659. <table>
  19660. <thead>
  19661. <tr>
  19662. <th>Field</th>
  19663. <th>Description</th>
  19664. </tr>
  19665. </thead>
  19666. <tbody>
  19667. <tr>
  19668. <td>
  19669. <code>credentials</code></br>
  19670. <em>
  19671. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19672. External Secrets meta/v1.SecretKeySelector
  19673. </a>
  19674. </em>
  19675. </td>
  19676. <td>
  19677. <em>(Optional)</em>
  19678. <p>Username / Password is used for authentication.</p>
  19679. </td>
  19680. </tr>
  19681. </tbody>
  19682. </table>
  19683. <h3 id="external-secrets.io/v1beta1.DopplerAuth">DopplerAuth
  19684. </h3>
  19685. <p>
  19686. (<em>Appears on:</em>
  19687. <a href="#external-secrets.io/v1beta1.DopplerProvider">DopplerProvider</a>)
  19688. </p>
  19689. <p>
  19690. <p>DopplerAuth defines the authentication method for the Doppler provider.</p>
  19691. </p>
  19692. <table>
  19693. <thead>
  19694. <tr>
  19695. <th>Field</th>
  19696. <th>Description</th>
  19697. </tr>
  19698. </thead>
  19699. <tbody>
  19700. <tr>
  19701. <td>
  19702. <code>secretRef</code></br>
  19703. <em>
  19704. <a href="#external-secrets.io/v1beta1.DopplerAuthSecretRef">
  19705. DopplerAuthSecretRef
  19706. </a>
  19707. </em>
  19708. </td>
  19709. <td>
  19710. </td>
  19711. </tr>
  19712. </tbody>
  19713. </table>
  19714. <h3 id="external-secrets.io/v1beta1.DopplerAuthSecretRef">DopplerAuthSecretRef
  19715. </h3>
  19716. <p>
  19717. (<em>Appears on:</em>
  19718. <a href="#external-secrets.io/v1beta1.DopplerAuth">DopplerAuth</a>)
  19719. </p>
  19720. <p>
  19721. <p>DopplerAuthSecretRef defines a reference to a secret containing credentials for the Doppler provider.</p>
  19722. </p>
  19723. <table>
  19724. <thead>
  19725. <tr>
  19726. <th>Field</th>
  19727. <th>Description</th>
  19728. </tr>
  19729. </thead>
  19730. <tbody>
  19731. <tr>
  19732. <td>
  19733. <code>dopplerToken</code></br>
  19734. <em>
  19735. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19736. External Secrets meta/v1.SecretKeySelector
  19737. </a>
  19738. </em>
  19739. </td>
  19740. <td>
  19741. <p>The DopplerToken is used for authentication.
  19742. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  19743. The Key attribute defaults to dopplerToken if not specified.</p>
  19744. </td>
  19745. </tr>
  19746. </tbody>
  19747. </table>
  19748. <h3 id="external-secrets.io/v1beta1.DopplerProvider">DopplerProvider
  19749. </h3>
  19750. <p>
  19751. (<em>Appears on:</em>
  19752. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19753. </p>
  19754. <p>
  19755. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  19756. Project and Config are required if not using a Service Token.</p>
  19757. </p>
  19758. <table>
  19759. <thead>
  19760. <tr>
  19761. <th>Field</th>
  19762. <th>Description</th>
  19763. </tr>
  19764. </thead>
  19765. <tbody>
  19766. <tr>
  19767. <td>
  19768. <code>auth</code></br>
  19769. <em>
  19770. <a href="#external-secrets.io/v1beta1.DopplerAuth">
  19771. DopplerAuth
  19772. </a>
  19773. </em>
  19774. </td>
  19775. <td>
  19776. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  19777. </td>
  19778. </tr>
  19779. <tr>
  19780. <td>
  19781. <code>project</code></br>
  19782. <em>
  19783. string
  19784. </em>
  19785. </td>
  19786. <td>
  19787. <em>(Optional)</em>
  19788. <p>Doppler project (required if not using a Service Token)</p>
  19789. </td>
  19790. </tr>
  19791. <tr>
  19792. <td>
  19793. <code>config</code></br>
  19794. <em>
  19795. string
  19796. </em>
  19797. </td>
  19798. <td>
  19799. <em>(Optional)</em>
  19800. <p>Doppler config (required if not using a Service Token)</p>
  19801. </td>
  19802. </tr>
  19803. <tr>
  19804. <td>
  19805. <code>nameTransformer</code></br>
  19806. <em>
  19807. string
  19808. </em>
  19809. </td>
  19810. <td>
  19811. <em>(Optional)</em>
  19812. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  19813. </td>
  19814. </tr>
  19815. <tr>
  19816. <td>
  19817. <code>format</code></br>
  19818. <em>
  19819. string
  19820. </em>
  19821. </td>
  19822. <td>
  19823. <em>(Optional)</em>
  19824. <p>Format enables the downloading of secrets as a file (string)</p>
  19825. </td>
  19826. </tr>
  19827. </tbody>
  19828. </table>
  19829. <h3 id="external-secrets.io/v1beta1.ExternalSecret">ExternalSecret
  19830. </h3>
  19831. <p>
  19832. <p>ExternalSecret is the schema for the external-secrets API.</p>
  19833. </p>
  19834. <table>
  19835. <thead>
  19836. <tr>
  19837. <th>Field</th>
  19838. <th>Description</th>
  19839. </tr>
  19840. </thead>
  19841. <tbody>
  19842. <tr>
  19843. <td>
  19844. <code>metadata</code></br>
  19845. <em>
  19846. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  19847. Kubernetes meta/v1.ObjectMeta
  19848. </a>
  19849. </em>
  19850. </td>
  19851. <td>
  19852. Refer to the Kubernetes API documentation for the fields of the
  19853. <code>metadata</code> field.
  19854. </td>
  19855. </tr>
  19856. <tr>
  19857. <td>
  19858. <code>spec</code></br>
  19859. <em>
  19860. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  19861. ExternalSecretSpec
  19862. </a>
  19863. </em>
  19864. </td>
  19865. <td>
  19866. <br/>
  19867. <br/>
  19868. <table>
  19869. <tr>
  19870. <td>
  19871. <code>secretStoreRef</code></br>
  19872. <em>
  19873. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  19874. SecretStoreRef
  19875. </a>
  19876. </em>
  19877. </td>
  19878. <td>
  19879. <em>(Optional)</em>
  19880. </td>
  19881. </tr>
  19882. <tr>
  19883. <td>
  19884. <code>target</code></br>
  19885. <em>
  19886. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  19887. ExternalSecretTarget
  19888. </a>
  19889. </em>
  19890. </td>
  19891. <td>
  19892. <em>(Optional)</em>
  19893. </td>
  19894. </tr>
  19895. <tr>
  19896. <td>
  19897. <code>refreshPolicy</code></br>
  19898. <em>
  19899. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  19900. ExternalSecretRefreshPolicy
  19901. </a>
  19902. </em>
  19903. </td>
  19904. <td>
  19905. <em>(Optional)</em>
  19906. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  19907. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  19908. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  19909. No periodic updates occur if refreshInterval is 0.
  19910. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  19911. </td>
  19912. </tr>
  19913. <tr>
  19914. <td>
  19915. <code>refreshInterval</code></br>
  19916. <em>
  19917. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  19918. Kubernetes meta/v1.Duration
  19919. </a>
  19920. </em>
  19921. </td>
  19922. <td>
  19923. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  19924. specified as Golang Duration strings.
  19925. 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;
  19926. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  19927. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  19928. </td>
  19929. </tr>
  19930. <tr>
  19931. <td>
  19932. <code>data</code></br>
  19933. <em>
  19934. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  19935. []ExternalSecretData
  19936. </a>
  19937. </em>
  19938. </td>
  19939. <td>
  19940. <em>(Optional)</em>
  19941. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  19942. </td>
  19943. </tr>
  19944. <tr>
  19945. <td>
  19946. <code>dataFrom</code></br>
  19947. <em>
  19948. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  19949. []ExternalSecretDataFromRemoteRef
  19950. </a>
  19951. </em>
  19952. </td>
  19953. <td>
  19954. <em>(Optional)</em>
  19955. <p>DataFrom is used to fetch all properties from a specific Provider data
  19956. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  19957. </td>
  19958. </tr>
  19959. </table>
  19960. </td>
  19961. </tr>
  19962. <tr>
  19963. <td>
  19964. <code>status</code></br>
  19965. <em>
  19966. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">
  19967. ExternalSecretStatus
  19968. </a>
  19969. </em>
  19970. </td>
  19971. <td>
  19972. </td>
  19973. </tr>
  19974. </tbody>
  19975. </table>
  19976. <h3 id="external-secrets.io/v1beta1.ExternalSecretConditionType">ExternalSecretConditionType
  19977. (<code>string</code> alias)</p></h3>
  19978. <p>
  19979. (<em>Appears on:</em>
  19980. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  19981. </p>
  19982. <p>
  19983. <p>ExternalSecretConditionType defines the condition type for an ExternalSecret.</p>
  19984. </p>
  19985. <table>
  19986. <thead>
  19987. <tr>
  19988. <th>Value</th>
  19989. <th>Description</th>
  19990. </tr>
  19991. </thead>
  19992. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  19993. <td><p>ExternalSecretDeleted indicates the ExternalSecret has been deleted.</p>
  19994. </td>
  19995. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  19996. <td><p>ExternalSecretReady indicates the ExternalSecret has been successfully reconciled.</p>
  19997. </td>
  19998. </tr></tbody>
  19999. </table>
  20000. <h3 id="external-secrets.io/v1beta1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  20001. (<code>string</code> alias)</p></h3>
  20002. <p>
  20003. (<em>Appears on:</em>
  20004. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  20005. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  20006. </p>
  20007. <p>
  20008. <p>ExternalSecretConversionStrategy defines how secret values are converted.</p>
  20009. </p>
  20010. <table>
  20011. <thead>
  20012. <tr>
  20013. <th>Value</th>
  20014. <th>Description</th>
  20015. </tr>
  20016. </thead>
  20017. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  20018. <td><p>ExternalSecretConversionDefault indicates the default conversion strategy.</p>
  20019. </td>
  20020. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  20021. <td><p>ExternalSecretConversionUnicode indicates that unicode conversion will be performed.</p>
  20022. </td>
  20023. </tr></tbody>
  20024. </table>
  20025. <h3 id="external-secrets.io/v1beta1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  20026. (<code>string</code> alias)</p></h3>
  20027. <p>
  20028. (<em>Appears on:</em>
  20029. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  20030. </p>
  20031. <p>
  20032. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  20033. </p>
  20034. <table>
  20035. <thead>
  20036. <tr>
  20037. <th>Value</th>
  20038. <th>Description</th>
  20039. </tr>
  20040. </thead>
  20041. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  20042. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  20043. </td>
  20044. </tr><tr><td><p>&#34;None&#34;</p></td>
  20045. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  20046. </td>
  20047. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  20048. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  20049. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  20050. </td>
  20051. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  20052. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  20053. </td>
  20054. </tr></tbody>
  20055. </table>
  20056. <h3 id="external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData
  20057. </h3>
  20058. <p>
  20059. (<em>Appears on:</em>
  20060. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20061. </p>
  20062. <p>
  20063. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  20064. </p>
  20065. <table>
  20066. <thead>
  20067. <tr>
  20068. <th>Field</th>
  20069. <th>Description</th>
  20070. </tr>
  20071. </thead>
  20072. <tbody>
  20073. <tr>
  20074. <td>
  20075. <code>secretKey</code></br>
  20076. <em>
  20077. string
  20078. </em>
  20079. </td>
  20080. <td>
  20081. <p>The key in the Kubernetes Secret to store the value.</p>
  20082. </td>
  20083. </tr>
  20084. <tr>
  20085. <td>
  20086. <code>remoteRef</code></br>
  20087. <em>
  20088. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  20089. ExternalSecretDataRemoteRef
  20090. </a>
  20091. </em>
  20092. </td>
  20093. <td>
  20094. <p>RemoteRef points to the remote secret and defines
  20095. which secret (version/property/..) to fetch.</p>
  20096. </td>
  20097. </tr>
  20098. <tr>
  20099. <td>
  20100. <code>sourceRef</code></br>
  20101. <em>
  20102. <a href="#external-secrets.io/v1beta1.StoreSourceRef">
  20103. StoreSourceRef
  20104. </a>
  20105. </em>
  20106. </td>
  20107. <td>
  20108. <p>SourceRef allows you to override the source
  20109. from which the value will be pulled.</p>
  20110. </td>
  20111. </tr>
  20112. </tbody>
  20113. </table>
  20114. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  20115. </h3>
  20116. <p>
  20117. (<em>Appears on:</em>
  20118. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20119. </p>
  20120. <p>
  20121. <p>ExternalSecretDataFromRemoteRef defines a reference to multiple secrets in the provider to be fetched using options.</p>
  20122. </p>
  20123. <table>
  20124. <thead>
  20125. <tr>
  20126. <th>Field</th>
  20127. <th>Description</th>
  20128. </tr>
  20129. </thead>
  20130. <tbody>
  20131. <tr>
  20132. <td>
  20133. <code>extract</code></br>
  20134. <em>
  20135. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  20136. ExternalSecretDataRemoteRef
  20137. </a>
  20138. </em>
  20139. </td>
  20140. <td>
  20141. <em>(Optional)</em>
  20142. <p>Used to extract multiple key/value pairs from one secret
  20143. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  20144. </td>
  20145. </tr>
  20146. <tr>
  20147. <td>
  20148. <code>find</code></br>
  20149. <em>
  20150. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">
  20151. ExternalSecretFind
  20152. </a>
  20153. </em>
  20154. </td>
  20155. <td>
  20156. <em>(Optional)</em>
  20157. <p>Used to find secrets based on tags or regular expressions
  20158. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  20159. </td>
  20160. </tr>
  20161. <tr>
  20162. <td>
  20163. <code>rewrite</code></br>
  20164. <em>
  20165. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">
  20166. []ExternalSecretRewrite
  20167. </a>
  20168. </em>
  20169. </td>
  20170. <td>
  20171. <em>(Optional)</em>
  20172. <p>Used to rewrite secret Keys after getting them from the secret Provider
  20173. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  20174. </td>
  20175. </tr>
  20176. <tr>
  20177. <td>
  20178. <code>sourceRef</code></br>
  20179. <em>
  20180. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">
  20181. StoreGeneratorSourceRef
  20182. </a>
  20183. </em>
  20184. </td>
  20185. <td>
  20186. <p>SourceRef points to a store or generator
  20187. which contains secret values ready to use.
  20188. Use this in combination with Extract or Find pull values out of
  20189. a specific SecretStore.
  20190. When sourceRef points to a generator Extract or Find is not supported.
  20191. The generator returns a static map of values</p>
  20192. </td>
  20193. </tr>
  20194. </tbody>
  20195. </table>
  20196. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  20197. </h3>
  20198. <p>
  20199. (<em>Appears on:</em>
  20200. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>,
  20201. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20202. </p>
  20203. <p>
  20204. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  20205. </p>
  20206. <table>
  20207. <thead>
  20208. <tr>
  20209. <th>Field</th>
  20210. <th>Description</th>
  20211. </tr>
  20212. </thead>
  20213. <tbody>
  20214. <tr>
  20215. <td>
  20216. <code>key</code></br>
  20217. <em>
  20218. string
  20219. </em>
  20220. </td>
  20221. <td>
  20222. <p>Key is the key used in the Provider, mandatory</p>
  20223. </td>
  20224. </tr>
  20225. <tr>
  20226. <td>
  20227. <code>metadataPolicy</code></br>
  20228. <em>
  20229. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">
  20230. ExternalSecretMetadataPolicy
  20231. </a>
  20232. </em>
  20233. </td>
  20234. <td>
  20235. <em>(Optional)</em>
  20236. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  20237. </td>
  20238. </tr>
  20239. <tr>
  20240. <td>
  20241. <code>property</code></br>
  20242. <em>
  20243. string
  20244. </em>
  20245. </td>
  20246. <td>
  20247. <em>(Optional)</em>
  20248. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  20249. </td>
  20250. </tr>
  20251. <tr>
  20252. <td>
  20253. <code>version</code></br>
  20254. <em>
  20255. string
  20256. </em>
  20257. </td>
  20258. <td>
  20259. <em>(Optional)</em>
  20260. <p>Used to select a specific version of the Provider value, if supported</p>
  20261. </td>
  20262. </tr>
  20263. <tr>
  20264. <td>
  20265. <code>conversionStrategy</code></br>
  20266. <em>
  20267. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  20268. ExternalSecretConversionStrategy
  20269. </a>
  20270. </em>
  20271. </td>
  20272. <td>
  20273. <em>(Optional)</em>
  20274. <p>Used to define a conversion Strategy</p>
  20275. </td>
  20276. </tr>
  20277. <tr>
  20278. <td>
  20279. <code>decodingStrategy</code></br>
  20280. <em>
  20281. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  20282. ExternalSecretDecodingStrategy
  20283. </a>
  20284. </em>
  20285. </td>
  20286. <td>
  20287. <em>(Optional)</em>
  20288. <p>Used to define a decoding Strategy</p>
  20289. </td>
  20290. </tr>
  20291. </tbody>
  20292. </table>
  20293. <h3 id="external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  20294. (<code>string</code> alias)</p></h3>
  20295. <p>
  20296. (<em>Appears on:</em>
  20297. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  20298. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  20299. </p>
  20300. <p>
  20301. <p>ExternalSecretDecodingStrategy defines how secret values are decoded.</p>
  20302. </p>
  20303. <table>
  20304. <thead>
  20305. <tr>
  20306. <th>Value</th>
  20307. <th>Description</th>
  20308. </tr>
  20309. </thead>
  20310. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  20311. <td><p>ExternalSecretDecodeAuto indicates that the decoding strategy will be automatically determined.</p>
  20312. </td>
  20313. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  20314. <td><p>ExternalSecretDecodeBase64 indicates that base64 decoding will be used.</p>
  20315. </td>
  20316. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  20317. <td><p>ExternalSecretDecodeBase64URL indicates that base64url decoding will be used.</p>
  20318. </td>
  20319. </tr><tr><td><p>&#34;None&#34;</p></td>
  20320. <td><p>ExternalSecretDecodeNone indicates that no decoding will be performed.</p>
  20321. </td>
  20322. </tr></tbody>
  20323. </table>
  20324. <h3 id="external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  20325. (<code>string</code> alias)</p></h3>
  20326. <p>
  20327. (<em>Appears on:</em>
  20328. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  20329. </p>
  20330. <p>
  20331. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  20332. </p>
  20333. <table>
  20334. <thead>
  20335. <tr>
  20336. <th>Value</th>
  20337. <th>Description</th>
  20338. </tr>
  20339. </thead>
  20340. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  20341. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  20342. If a secret gets deleted on the provider side and is not accessible
  20343. anymore this is not considered an error and the ExternalSecret
  20344. does not go into SecretSyncedError status.</p>
  20345. </td>
  20346. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  20347. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  20348. If a secret gets deleted on the provider side and is not accessible
  20349. anymore this is not considered an error and the ExternalSecret
  20350. does not go into SecretSyncedError status.</p>
  20351. </td>
  20352. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  20353. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  20354. If a provider secret does not exist the ExternalSecret gets into the
  20355. SecretSyncedError status.</p>
  20356. </td>
  20357. </tr></tbody>
  20358. </table>
  20359. <h3 id="external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind
  20360. </h3>
  20361. <p>
  20362. (<em>Appears on:</em>
  20363. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20364. </p>
  20365. <p>
  20366. <p>ExternalSecretFind defines criteria for finding secrets in the provider.</p>
  20367. </p>
  20368. <table>
  20369. <thead>
  20370. <tr>
  20371. <th>Field</th>
  20372. <th>Description</th>
  20373. </tr>
  20374. </thead>
  20375. <tbody>
  20376. <tr>
  20377. <td>
  20378. <code>path</code></br>
  20379. <em>
  20380. string
  20381. </em>
  20382. </td>
  20383. <td>
  20384. <em>(Optional)</em>
  20385. <p>A root path to start the find operations.</p>
  20386. </td>
  20387. </tr>
  20388. <tr>
  20389. <td>
  20390. <code>name</code></br>
  20391. <em>
  20392. <a href="#external-secrets.io/v1beta1.FindName">
  20393. FindName
  20394. </a>
  20395. </em>
  20396. </td>
  20397. <td>
  20398. <em>(Optional)</em>
  20399. <p>Finds secrets based on the name.</p>
  20400. </td>
  20401. </tr>
  20402. <tr>
  20403. <td>
  20404. <code>tags</code></br>
  20405. <em>
  20406. map[string]string
  20407. </em>
  20408. </td>
  20409. <td>
  20410. <em>(Optional)</em>
  20411. <p>Find secrets based on tags.</p>
  20412. </td>
  20413. </tr>
  20414. <tr>
  20415. <td>
  20416. <code>conversionStrategy</code></br>
  20417. <em>
  20418. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  20419. ExternalSecretConversionStrategy
  20420. </a>
  20421. </em>
  20422. </td>
  20423. <td>
  20424. <em>(Optional)</em>
  20425. <p>Used to define a conversion Strategy</p>
  20426. </td>
  20427. </tr>
  20428. <tr>
  20429. <td>
  20430. <code>decodingStrategy</code></br>
  20431. <em>
  20432. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  20433. ExternalSecretDecodingStrategy
  20434. </a>
  20435. </em>
  20436. </td>
  20437. <td>
  20438. <em>(Optional)</em>
  20439. <p>Used to define a decoding Strategy</p>
  20440. </td>
  20441. </tr>
  20442. </tbody>
  20443. </table>
  20444. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadata">ExternalSecretMetadata
  20445. </h3>
  20446. <p>
  20447. (<em>Appears on:</em>
  20448. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  20449. </p>
  20450. <p>
  20451. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  20452. </p>
  20453. <table>
  20454. <thead>
  20455. <tr>
  20456. <th>Field</th>
  20457. <th>Description</th>
  20458. </tr>
  20459. </thead>
  20460. <tbody>
  20461. <tr>
  20462. <td>
  20463. <code>annotations</code></br>
  20464. <em>
  20465. map[string]string
  20466. </em>
  20467. </td>
  20468. <td>
  20469. <em>(Optional)</em>
  20470. </td>
  20471. </tr>
  20472. <tr>
  20473. <td>
  20474. <code>labels</code></br>
  20475. <em>
  20476. map[string]string
  20477. </em>
  20478. </td>
  20479. <td>
  20480. <em>(Optional)</em>
  20481. </td>
  20482. </tr>
  20483. </tbody>
  20484. </table>
  20485. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  20486. (<code>string</code> alias)</p></h3>
  20487. <p>
  20488. (<em>Appears on:</em>
  20489. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  20490. </p>
  20491. <p>
  20492. <p>ExternalSecretMetadataPolicy defines the policy for fetching tags/labels from provider secrets.</p>
  20493. </p>
  20494. <table>
  20495. <thead>
  20496. <tr>
  20497. <th>Value</th>
  20498. <th>Description</th>
  20499. </tr>
  20500. </thead>
  20501. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  20502. <td><p>ExternalSecretMetadataPolicyFetch indicates that metadata will be fetched from the provider.</p>
  20503. </td>
  20504. </tr><tr><td><p>&#34;None&#34;</p></td>
  20505. <td><p>ExternalSecretMetadataPolicyNone indicates that no metadata will be fetched.</p>
  20506. </td>
  20507. </tr></tbody>
  20508. </table>
  20509. <h3 id="external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  20510. (<code>string</code> alias)</p></h3>
  20511. <p>
  20512. (<em>Appears on:</em>
  20513. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20514. </p>
  20515. <p>
  20516. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  20517. </p>
  20518. <table>
  20519. <thead>
  20520. <tr>
  20521. <th>Value</th>
  20522. <th>Description</th>
  20523. </tr>
  20524. </thead>
  20525. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  20526. <td><p>RefreshPolicyCreatedOnce creates the Secret only if it does not exist and does not update it thereafter.</p>
  20527. </td>
  20528. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  20529. <td><p>RefreshPolicyOnChange only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes.</p>
  20530. </td>
  20531. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  20532. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the external source at regular intervals.</p>
  20533. </td>
  20534. </tr></tbody>
  20535. </table>
  20536. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite
  20537. </h3>
  20538. <p>
  20539. (<em>Appears on:</em>
  20540. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  20541. </p>
  20542. <p>
  20543. <p>ExternalSecretRewrite defines rules on how to rewrite secret keys.</p>
  20544. </p>
  20545. <table>
  20546. <thead>
  20547. <tr>
  20548. <th>Field</th>
  20549. <th>Description</th>
  20550. </tr>
  20551. </thead>
  20552. <tbody>
  20553. <tr>
  20554. <td>
  20555. <code>regexp</code></br>
  20556. <em>
  20557. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">
  20558. ExternalSecretRewriteRegexp
  20559. </a>
  20560. </em>
  20561. </td>
  20562. <td>
  20563. <em>(Optional)</em>
  20564. <p>Used to rewrite with regular expressions.
  20565. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  20566. </td>
  20567. </tr>
  20568. <tr>
  20569. <td>
  20570. <code>transform</code></br>
  20571. <em>
  20572. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteTransform">
  20573. ExternalSecretRewriteTransform
  20574. </a>
  20575. </em>
  20576. </td>
  20577. <td>
  20578. <em>(Optional)</em>
  20579. <p>Used to apply string transformation on the secrets.
  20580. The resulting key will be the output of the template applied by the operation.</p>
  20581. </td>
  20582. </tr>
  20583. </tbody>
  20584. </table>
  20585. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  20586. </h3>
  20587. <p>
  20588. (<em>Appears on:</em>
  20589. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  20590. </p>
  20591. <p>
  20592. <p>ExternalSecretRewriteRegexp defines how to use regular expressions for rewriting secret keys.</p>
  20593. </p>
  20594. <table>
  20595. <thead>
  20596. <tr>
  20597. <th>Field</th>
  20598. <th>Description</th>
  20599. </tr>
  20600. </thead>
  20601. <tbody>
  20602. <tr>
  20603. <td>
  20604. <code>source</code></br>
  20605. <em>
  20606. string
  20607. </em>
  20608. </td>
  20609. <td>
  20610. <p>Used to define the regular expression of a re.Compiler.</p>
  20611. </td>
  20612. </tr>
  20613. <tr>
  20614. <td>
  20615. <code>target</code></br>
  20616. <em>
  20617. string
  20618. </em>
  20619. </td>
  20620. <td>
  20621. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  20622. </td>
  20623. </tr>
  20624. </tbody>
  20625. </table>
  20626. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  20627. </h3>
  20628. <p>
  20629. (<em>Appears on:</em>
  20630. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  20631. </p>
  20632. <p>
  20633. <p>ExternalSecretRewriteTransform defines how to use string templates for transforming secret keys.</p>
  20634. </p>
  20635. <table>
  20636. <thead>
  20637. <tr>
  20638. <th>Field</th>
  20639. <th>Description</th>
  20640. </tr>
  20641. </thead>
  20642. <tbody>
  20643. <tr>
  20644. <td>
  20645. <code>template</code></br>
  20646. <em>
  20647. string
  20648. </em>
  20649. </td>
  20650. <td>
  20651. <p>Used to define the template to apply on the secret name.
  20652. <code>.value</code> will specify the secret name in the template.</p>
  20653. </td>
  20654. </tr>
  20655. </tbody>
  20656. </table>
  20657. <h3 id="external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec
  20658. </h3>
  20659. <p>
  20660. (<em>Appears on:</em>
  20661. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  20662. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  20663. </p>
  20664. <p>
  20665. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  20666. </p>
  20667. <table>
  20668. <thead>
  20669. <tr>
  20670. <th>Field</th>
  20671. <th>Description</th>
  20672. </tr>
  20673. </thead>
  20674. <tbody>
  20675. <tr>
  20676. <td>
  20677. <code>secretStoreRef</code></br>
  20678. <em>
  20679. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  20680. SecretStoreRef
  20681. </a>
  20682. </em>
  20683. </td>
  20684. <td>
  20685. <em>(Optional)</em>
  20686. </td>
  20687. </tr>
  20688. <tr>
  20689. <td>
  20690. <code>target</code></br>
  20691. <em>
  20692. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  20693. ExternalSecretTarget
  20694. </a>
  20695. </em>
  20696. </td>
  20697. <td>
  20698. <em>(Optional)</em>
  20699. </td>
  20700. </tr>
  20701. <tr>
  20702. <td>
  20703. <code>refreshPolicy</code></br>
  20704. <em>
  20705. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  20706. ExternalSecretRefreshPolicy
  20707. </a>
  20708. </em>
  20709. </td>
  20710. <td>
  20711. <em>(Optional)</em>
  20712. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  20713. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  20714. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  20715. No periodic updates occur if refreshInterval is 0.
  20716. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  20717. </td>
  20718. </tr>
  20719. <tr>
  20720. <td>
  20721. <code>refreshInterval</code></br>
  20722. <em>
  20723. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  20724. Kubernetes meta/v1.Duration
  20725. </a>
  20726. </em>
  20727. </td>
  20728. <td>
  20729. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  20730. specified as Golang Duration strings.
  20731. 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;
  20732. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  20733. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  20734. </td>
  20735. </tr>
  20736. <tr>
  20737. <td>
  20738. <code>data</code></br>
  20739. <em>
  20740. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  20741. []ExternalSecretData
  20742. </a>
  20743. </em>
  20744. </td>
  20745. <td>
  20746. <em>(Optional)</em>
  20747. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  20748. </td>
  20749. </tr>
  20750. <tr>
  20751. <td>
  20752. <code>dataFrom</code></br>
  20753. <em>
  20754. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  20755. []ExternalSecretDataFromRemoteRef
  20756. </a>
  20757. </em>
  20758. </td>
  20759. <td>
  20760. <em>(Optional)</em>
  20761. <p>DataFrom is used to fetch all properties from a specific Provider data
  20762. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  20763. </td>
  20764. </tr>
  20765. </tbody>
  20766. </table>
  20767. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus
  20768. </h3>
  20769. <p>
  20770. (<em>Appears on:</em>
  20771. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  20772. </p>
  20773. <p>
  20774. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  20775. </p>
  20776. <table>
  20777. <thead>
  20778. <tr>
  20779. <th>Field</th>
  20780. <th>Description</th>
  20781. </tr>
  20782. </thead>
  20783. <tbody>
  20784. <tr>
  20785. <td>
  20786. <code>refreshTime</code></br>
  20787. <em>
  20788. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  20789. Kubernetes meta/v1.Time
  20790. </a>
  20791. </em>
  20792. </td>
  20793. <td>
  20794. <p>refreshTime is the time and date the external secret was fetched and
  20795. the target secret updated</p>
  20796. </td>
  20797. </tr>
  20798. <tr>
  20799. <td>
  20800. <code>syncedResourceVersion</code></br>
  20801. <em>
  20802. string
  20803. </em>
  20804. </td>
  20805. <td>
  20806. <p>SyncedResourceVersion keeps track of the last synced version</p>
  20807. </td>
  20808. </tr>
  20809. <tr>
  20810. <td>
  20811. <code>conditions</code></br>
  20812. <em>
  20813. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">
  20814. []ExternalSecretStatusCondition
  20815. </a>
  20816. </em>
  20817. </td>
  20818. <td>
  20819. <em>(Optional)</em>
  20820. </td>
  20821. </tr>
  20822. <tr>
  20823. <td>
  20824. <code>binding</code></br>
  20825. <em>
  20826. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  20827. Kubernetes core/v1.LocalObjectReference
  20828. </a>
  20829. </em>
  20830. </td>
  20831. <td>
  20832. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  20833. </td>
  20834. </tr>
  20835. </tbody>
  20836. </table>
  20837. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  20838. </h3>
  20839. <p>
  20840. (<em>Appears on:</em>
  20841. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus</a>)
  20842. </p>
  20843. <p>
  20844. <p>ExternalSecretStatusCondition contains condition information for an ExternalSecret.</p>
  20845. </p>
  20846. <table>
  20847. <thead>
  20848. <tr>
  20849. <th>Field</th>
  20850. <th>Description</th>
  20851. </tr>
  20852. </thead>
  20853. <tbody>
  20854. <tr>
  20855. <td>
  20856. <code>type</code></br>
  20857. <em>
  20858. <a href="#external-secrets.io/v1beta1.ExternalSecretConditionType">
  20859. ExternalSecretConditionType
  20860. </a>
  20861. </em>
  20862. </td>
  20863. <td>
  20864. </td>
  20865. </tr>
  20866. <tr>
  20867. <td>
  20868. <code>status</code></br>
  20869. <em>
  20870. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  20871. Kubernetes core/v1.ConditionStatus
  20872. </a>
  20873. </em>
  20874. </td>
  20875. <td>
  20876. </td>
  20877. </tr>
  20878. <tr>
  20879. <td>
  20880. <code>reason</code></br>
  20881. <em>
  20882. string
  20883. </em>
  20884. </td>
  20885. <td>
  20886. <em>(Optional)</em>
  20887. </td>
  20888. </tr>
  20889. <tr>
  20890. <td>
  20891. <code>message</code></br>
  20892. <em>
  20893. string
  20894. </em>
  20895. </td>
  20896. <td>
  20897. <em>(Optional)</em>
  20898. </td>
  20899. </tr>
  20900. <tr>
  20901. <td>
  20902. <code>lastTransitionTime</code></br>
  20903. <em>
  20904. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  20905. Kubernetes meta/v1.Time
  20906. </a>
  20907. </em>
  20908. </td>
  20909. <td>
  20910. <em>(Optional)</em>
  20911. </td>
  20912. </tr>
  20913. </tbody>
  20914. </table>
  20915. <h3 id="external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget
  20916. </h3>
  20917. <p>
  20918. (<em>Appears on:</em>
  20919. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20920. </p>
  20921. <p>
  20922. <p>ExternalSecretTarget defines the Kubernetes Secret to be created
  20923. There can be only one target per ExternalSecret.</p>
  20924. </p>
  20925. <table>
  20926. <thead>
  20927. <tr>
  20928. <th>Field</th>
  20929. <th>Description</th>
  20930. </tr>
  20931. </thead>
  20932. <tbody>
  20933. <tr>
  20934. <td>
  20935. <code>name</code></br>
  20936. <em>
  20937. string
  20938. </em>
  20939. </td>
  20940. <td>
  20941. <em>(Optional)</em>
  20942. <p>The name of the Secret resource to be managed.
  20943. Defaults to the .metadata.name of the ExternalSecret resource</p>
  20944. </td>
  20945. </tr>
  20946. <tr>
  20947. <td>
  20948. <code>creationPolicy</code></br>
  20949. <em>
  20950. <a href="#external-secrets.io/v1beta1.ExternalSecretCreationPolicy">
  20951. ExternalSecretCreationPolicy
  20952. </a>
  20953. </em>
  20954. </td>
  20955. <td>
  20956. <em>(Optional)</em>
  20957. <p>CreationPolicy defines rules on how to create the resulting Secret.
  20958. Defaults to &ldquo;Owner&rdquo;</p>
  20959. </td>
  20960. </tr>
  20961. <tr>
  20962. <td>
  20963. <code>deletionPolicy</code></br>
  20964. <em>
  20965. <a href="#external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">
  20966. ExternalSecretDeletionPolicy
  20967. </a>
  20968. </em>
  20969. </td>
  20970. <td>
  20971. <em>(Optional)</em>
  20972. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  20973. Defaults to &ldquo;Retain&rdquo;</p>
  20974. </td>
  20975. </tr>
  20976. <tr>
  20977. <td>
  20978. <code>template</code></br>
  20979. <em>
  20980. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">
  20981. ExternalSecretTemplate
  20982. </a>
  20983. </em>
  20984. </td>
  20985. <td>
  20986. <em>(Optional)</em>
  20987. <p>Template defines a blueprint for the created Secret resource.</p>
  20988. </td>
  20989. </tr>
  20990. <tr>
  20991. <td>
  20992. <code>immutable</code></br>
  20993. <em>
  20994. bool
  20995. </em>
  20996. </td>
  20997. <td>
  20998. <em>(Optional)</em>
  20999. <p>Immutable defines if the final secret will be immutable</p>
  21000. </td>
  21001. </tr>
  21002. </tbody>
  21003. </table>
  21004. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate
  21005. </h3>
  21006. <p>
  21007. (<em>Appears on:</em>
  21008. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  21009. </p>
  21010. <p>
  21011. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  21012. 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>
  21013. </p>
  21014. <table>
  21015. <thead>
  21016. <tr>
  21017. <th>Field</th>
  21018. <th>Description</th>
  21019. </tr>
  21020. </thead>
  21021. <tbody>
  21022. <tr>
  21023. <td>
  21024. <code>type</code></br>
  21025. <em>
  21026. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  21027. Kubernetes core/v1.SecretType
  21028. </a>
  21029. </em>
  21030. </td>
  21031. <td>
  21032. <em>(Optional)</em>
  21033. </td>
  21034. </tr>
  21035. <tr>
  21036. <td>
  21037. <code>engineVersion</code></br>
  21038. <em>
  21039. <a href="#external-secrets.io/v1beta1.TemplateEngineVersion">
  21040. TemplateEngineVersion
  21041. </a>
  21042. </em>
  21043. </td>
  21044. <td>
  21045. <p>EngineVersion specifies the template engine version
  21046. that should be used to compile/execute the
  21047. template specified in .data and .templateFrom[].</p>
  21048. </td>
  21049. </tr>
  21050. <tr>
  21051. <td>
  21052. <code>metadata</code></br>
  21053. <em>
  21054. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">
  21055. ExternalSecretTemplateMetadata
  21056. </a>
  21057. </em>
  21058. </td>
  21059. <td>
  21060. <em>(Optional)</em>
  21061. </td>
  21062. </tr>
  21063. <tr>
  21064. <td>
  21065. <code>mergePolicy</code></br>
  21066. <em>
  21067. <a href="#external-secrets.io/v1beta1.TemplateMergePolicy">
  21068. TemplateMergePolicy
  21069. </a>
  21070. </em>
  21071. </td>
  21072. <td>
  21073. </td>
  21074. </tr>
  21075. <tr>
  21076. <td>
  21077. <code>data</code></br>
  21078. <em>
  21079. map[string]string
  21080. </em>
  21081. </td>
  21082. <td>
  21083. <em>(Optional)</em>
  21084. </td>
  21085. </tr>
  21086. <tr>
  21087. <td>
  21088. <code>templateFrom</code></br>
  21089. <em>
  21090. <a href="#external-secrets.io/v1beta1.TemplateFrom">
  21091. []TemplateFrom
  21092. </a>
  21093. </em>
  21094. </td>
  21095. <td>
  21096. <em>(Optional)</em>
  21097. </td>
  21098. </tr>
  21099. </tbody>
  21100. </table>
  21101. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  21102. </h3>
  21103. <p>
  21104. (<em>Appears on:</em>
  21105. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  21106. </p>
  21107. <p>
  21108. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  21109. </p>
  21110. <table>
  21111. <thead>
  21112. <tr>
  21113. <th>Field</th>
  21114. <th>Description</th>
  21115. </tr>
  21116. </thead>
  21117. <tbody>
  21118. <tr>
  21119. <td>
  21120. <code>annotations</code></br>
  21121. <em>
  21122. map[string]string
  21123. </em>
  21124. </td>
  21125. <td>
  21126. <em>(Optional)</em>
  21127. </td>
  21128. </tr>
  21129. <tr>
  21130. <td>
  21131. <code>labels</code></br>
  21132. <em>
  21133. map[string]string
  21134. </em>
  21135. </td>
  21136. <td>
  21137. <em>(Optional)</em>
  21138. </td>
  21139. </tr>
  21140. </tbody>
  21141. </table>
  21142. <h3 id="external-secrets.io/v1beta1.ExternalSecretValidator">ExternalSecretValidator
  21143. </h3>
  21144. <p>
  21145. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  21146. </p>
  21147. <h3 id="external-secrets.io/v1beta1.FakeProvider">FakeProvider
  21148. </h3>
  21149. <p>
  21150. (<em>Appears on:</em>
  21151. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21152. </p>
  21153. <p>
  21154. <p>FakeProvider configures a fake provider that returns static values.</p>
  21155. </p>
  21156. <table>
  21157. <thead>
  21158. <tr>
  21159. <th>Field</th>
  21160. <th>Description</th>
  21161. </tr>
  21162. </thead>
  21163. <tbody>
  21164. <tr>
  21165. <td>
  21166. <code>data</code></br>
  21167. <em>
  21168. <a href="#external-secrets.io/v1beta1.FakeProviderData">
  21169. []FakeProviderData
  21170. </a>
  21171. </em>
  21172. </td>
  21173. <td>
  21174. </td>
  21175. </tr>
  21176. </tbody>
  21177. </table>
  21178. <h3 id="external-secrets.io/v1beta1.FakeProviderData">FakeProviderData
  21179. </h3>
  21180. <p>
  21181. (<em>Appears on:</em>
  21182. <a href="#external-secrets.io/v1beta1.FakeProvider">FakeProvider</a>)
  21183. </p>
  21184. <p>
  21185. <p>FakeProviderData defines a key-value pair for the fake provider used in testing.</p>
  21186. </p>
  21187. <table>
  21188. <thead>
  21189. <tr>
  21190. <th>Field</th>
  21191. <th>Description</th>
  21192. </tr>
  21193. </thead>
  21194. <tbody>
  21195. <tr>
  21196. <td>
  21197. <code>key</code></br>
  21198. <em>
  21199. string
  21200. </em>
  21201. </td>
  21202. <td>
  21203. </td>
  21204. </tr>
  21205. <tr>
  21206. <td>
  21207. <code>value</code></br>
  21208. <em>
  21209. string
  21210. </em>
  21211. </td>
  21212. <td>
  21213. </td>
  21214. </tr>
  21215. <tr>
  21216. <td>
  21217. <code>version</code></br>
  21218. <em>
  21219. string
  21220. </em>
  21221. </td>
  21222. <td>
  21223. </td>
  21224. </tr>
  21225. </tbody>
  21226. </table>
  21227. <h3 id="external-secrets.io/v1beta1.FindName">FindName
  21228. </h3>
  21229. <p>
  21230. (<em>Appears on:</em>
  21231. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  21232. </p>
  21233. <p>
  21234. <p>FindName defines name matching criteria for finding secrets.</p>
  21235. </p>
  21236. <table>
  21237. <thead>
  21238. <tr>
  21239. <th>Field</th>
  21240. <th>Description</th>
  21241. </tr>
  21242. </thead>
  21243. <tbody>
  21244. <tr>
  21245. <td>
  21246. <code>regexp</code></br>
  21247. <em>
  21248. string
  21249. </em>
  21250. </td>
  21251. <td>
  21252. <em>(Optional)</em>
  21253. <p>Finds secrets base</p>
  21254. </td>
  21255. </tr>
  21256. </tbody>
  21257. </table>
  21258. <h3 id="external-secrets.io/v1beta1.FortanixProvider">FortanixProvider
  21259. </h3>
  21260. <p>
  21261. (<em>Appears on:</em>
  21262. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21263. </p>
  21264. <p>
  21265. <p>FortanixProvider configures a store to sync secrets using the Fortanix SDKMS provider.</p>
  21266. </p>
  21267. <table>
  21268. <thead>
  21269. <tr>
  21270. <th>Field</th>
  21271. <th>Description</th>
  21272. </tr>
  21273. </thead>
  21274. <tbody>
  21275. <tr>
  21276. <td>
  21277. <code>apiUrl</code></br>
  21278. <em>
  21279. string
  21280. </em>
  21281. </td>
  21282. <td>
  21283. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  21284. </td>
  21285. </tr>
  21286. <tr>
  21287. <td>
  21288. <code>apiKey</code></br>
  21289. <em>
  21290. <a href="#external-secrets.io/v1beta1.FortanixProviderSecretRef">
  21291. FortanixProviderSecretRef
  21292. </a>
  21293. </em>
  21294. </td>
  21295. <td>
  21296. <p>APIKey is the API token to access SDKMS Applications.</p>
  21297. </td>
  21298. </tr>
  21299. </tbody>
  21300. </table>
  21301. <h3 id="external-secrets.io/v1beta1.FortanixProviderSecretRef">FortanixProviderSecretRef
  21302. </h3>
  21303. <p>
  21304. (<em>Appears on:</em>
  21305. <a href="#external-secrets.io/v1beta1.FortanixProvider">FortanixProvider</a>)
  21306. </p>
  21307. <p>
  21308. <p>FortanixProviderSecretRef defines a reference to a secret containing credentials for the Fortanix provider.</p>
  21309. </p>
  21310. <table>
  21311. <thead>
  21312. <tr>
  21313. <th>Field</th>
  21314. <th>Description</th>
  21315. </tr>
  21316. </thead>
  21317. <tbody>
  21318. <tr>
  21319. <td>
  21320. <code>secretRef</code></br>
  21321. <em>
  21322. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21323. External Secrets meta/v1.SecretKeySelector
  21324. </a>
  21325. </em>
  21326. </td>
  21327. <td>
  21328. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  21329. </td>
  21330. </tr>
  21331. </tbody>
  21332. </table>
  21333. <h3 id="external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth
  21334. </h3>
  21335. <p>
  21336. (<em>Appears on:</em>
  21337. <a href="#external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider</a>)
  21338. </p>
  21339. <p>
  21340. <p>GCPSMAuth defines the authentication methods for the GCP Secret Manager provider.</p>
  21341. </p>
  21342. <table>
  21343. <thead>
  21344. <tr>
  21345. <th>Field</th>
  21346. <th>Description</th>
  21347. </tr>
  21348. </thead>
  21349. <tbody>
  21350. <tr>
  21351. <td>
  21352. <code>secretRef</code></br>
  21353. <em>
  21354. <a href="#external-secrets.io/v1beta1.GCPSMAuthSecretRef">
  21355. GCPSMAuthSecretRef
  21356. </a>
  21357. </em>
  21358. </td>
  21359. <td>
  21360. <em>(Optional)</em>
  21361. </td>
  21362. </tr>
  21363. <tr>
  21364. <td>
  21365. <code>workloadIdentity</code></br>
  21366. <em>
  21367. <a href="#external-secrets.io/v1beta1.GCPWorkloadIdentity">
  21368. GCPWorkloadIdentity
  21369. </a>
  21370. </em>
  21371. </td>
  21372. <td>
  21373. <em>(Optional)</em>
  21374. </td>
  21375. </tr>
  21376. </tbody>
  21377. </table>
  21378. <h3 id="external-secrets.io/v1beta1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  21379. </h3>
  21380. <p>
  21381. (<em>Appears on:</em>
  21382. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  21383. </p>
  21384. <p>
  21385. <p>GCPSMAuthSecretRef defines a reference to a secret containing credentials for the GCP Secret Manager provider.</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>secretAccessKeySecretRef</code></br>
  21398. <em>
  21399. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21400. External Secrets meta/v1.SecretKeySelector
  21401. </a>
  21402. </em>
  21403. </td>
  21404. <td>
  21405. <em>(Optional)</em>
  21406. <p>The SecretAccessKey is used for authentication</p>
  21407. </td>
  21408. </tr>
  21409. </tbody>
  21410. </table>
  21411. <h3 id="external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider
  21412. </h3>
  21413. <p>
  21414. (<em>Appears on:</em>
  21415. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21416. </p>
  21417. <p>
  21418. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  21419. </p>
  21420. <table>
  21421. <thead>
  21422. <tr>
  21423. <th>Field</th>
  21424. <th>Description</th>
  21425. </tr>
  21426. </thead>
  21427. <tbody>
  21428. <tr>
  21429. <td>
  21430. <code>auth</code></br>
  21431. <em>
  21432. <a href="#external-secrets.io/v1beta1.GCPSMAuth">
  21433. GCPSMAuth
  21434. </a>
  21435. </em>
  21436. </td>
  21437. <td>
  21438. <em>(Optional)</em>
  21439. <p>Auth defines the information necessary to authenticate against GCP</p>
  21440. </td>
  21441. </tr>
  21442. <tr>
  21443. <td>
  21444. <code>projectID</code></br>
  21445. <em>
  21446. string
  21447. </em>
  21448. </td>
  21449. <td>
  21450. <p>ProjectID project where secret is located</p>
  21451. </td>
  21452. </tr>
  21453. <tr>
  21454. <td>
  21455. <code>location</code></br>
  21456. <em>
  21457. string
  21458. </em>
  21459. </td>
  21460. <td>
  21461. <p>Location optionally defines a location for a secret</p>
  21462. </td>
  21463. </tr>
  21464. </tbody>
  21465. </table>
  21466. <h3 id="external-secrets.io/v1beta1.GCPWorkloadIdentity">GCPWorkloadIdentity
  21467. </h3>
  21468. <p>
  21469. (<em>Appears on:</em>
  21470. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  21471. </p>
  21472. <p>
  21473. <p>GCPWorkloadIdentity defines configuration for using GCP Workload Identity authentication.</p>
  21474. </p>
  21475. <table>
  21476. <thead>
  21477. <tr>
  21478. <th>Field</th>
  21479. <th>Description</th>
  21480. </tr>
  21481. </thead>
  21482. <tbody>
  21483. <tr>
  21484. <td>
  21485. <code>serviceAccountRef</code></br>
  21486. <em>
  21487. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  21488. External Secrets meta/v1.ServiceAccountSelector
  21489. </a>
  21490. </em>
  21491. </td>
  21492. <td>
  21493. </td>
  21494. </tr>
  21495. <tr>
  21496. <td>
  21497. <code>clusterLocation</code></br>
  21498. <em>
  21499. string
  21500. </em>
  21501. </td>
  21502. <td>
  21503. <em>(Optional)</em>
  21504. <p>ClusterLocation is the location of the cluster
  21505. If not specified, it fetches information from the metadata server</p>
  21506. </td>
  21507. </tr>
  21508. <tr>
  21509. <td>
  21510. <code>clusterName</code></br>
  21511. <em>
  21512. string
  21513. </em>
  21514. </td>
  21515. <td>
  21516. <em>(Optional)</em>
  21517. <p>ClusterName is the name of the cluster
  21518. If not specified, it fetches information from the metadata server</p>
  21519. </td>
  21520. </tr>
  21521. <tr>
  21522. <td>
  21523. <code>clusterProjectID</code></br>
  21524. <em>
  21525. string
  21526. </em>
  21527. </td>
  21528. <td>
  21529. <em>(Optional)</em>
  21530. <p>ClusterProjectID is the project ID of the cluster
  21531. If not specified, it fetches information from the metadata server</p>
  21532. </td>
  21533. </tr>
  21534. </tbody>
  21535. </table>
  21536. <h3 id="external-secrets.io/v1beta1.GeneratorRef">GeneratorRef
  21537. </h3>
  21538. <p>
  21539. (<em>Appears on:</em>
  21540. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  21541. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  21542. </p>
  21543. <p>
  21544. <p>GeneratorRef points to a generator custom resource.</p>
  21545. </p>
  21546. <table>
  21547. <thead>
  21548. <tr>
  21549. <th>Field</th>
  21550. <th>Description</th>
  21551. </tr>
  21552. </thead>
  21553. <tbody>
  21554. <tr>
  21555. <td>
  21556. <code>apiVersion</code></br>
  21557. <em>
  21558. string
  21559. </em>
  21560. </td>
  21561. <td>
  21562. <p>Specify the apiVersion of the generator resource</p>
  21563. </td>
  21564. </tr>
  21565. <tr>
  21566. <td>
  21567. <code>kind</code></br>
  21568. <em>
  21569. string
  21570. </em>
  21571. </td>
  21572. <td>
  21573. <p>Specify the Kind of the generator resource</p>
  21574. </td>
  21575. </tr>
  21576. <tr>
  21577. <td>
  21578. <code>name</code></br>
  21579. <em>
  21580. string
  21581. </em>
  21582. </td>
  21583. <td>
  21584. <p>Specify the name of the generator resource</p>
  21585. </td>
  21586. </tr>
  21587. </tbody>
  21588. </table>
  21589. <h3 id="external-secrets.io/v1beta1.GenericClusterStoreValidator">GenericClusterStoreValidator
  21590. </h3>
  21591. <p>
  21592. <p>GenericClusterStoreValidator provides validation for ClusterSecretStore resources.</p>
  21593. </p>
  21594. <h3 id="external-secrets.io/v1beta1.GenericStore">GenericStore
  21595. </h3>
  21596. <p>
  21597. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  21598. or a namespaced SecretStore.</p>
  21599. </p>
  21600. <h3 id="external-secrets.io/v1beta1.GenericStoreValidator">GenericStoreValidator
  21601. </h3>
  21602. <p>
  21603. <p>GenericStoreValidator provides validation for SecretStore resources.</p>
  21604. </p>
  21605. <h3 id="external-secrets.io/v1beta1.GithubAppAuth">GithubAppAuth
  21606. </h3>
  21607. <p>
  21608. (<em>Appears on:</em>
  21609. <a href="#external-secrets.io/v1beta1.GithubProvider">GithubProvider</a>)
  21610. </p>
  21611. <p>
  21612. <p>GithubAppAuth defines the GitHub App authentication mechanism for the GitHub provider.</p>
  21613. </p>
  21614. <table>
  21615. <thead>
  21616. <tr>
  21617. <th>Field</th>
  21618. <th>Description</th>
  21619. </tr>
  21620. </thead>
  21621. <tbody>
  21622. <tr>
  21623. <td>
  21624. <code>privateKey</code></br>
  21625. <em>
  21626. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21627. External Secrets meta/v1.SecretKeySelector
  21628. </a>
  21629. </em>
  21630. </td>
  21631. <td>
  21632. </td>
  21633. </tr>
  21634. </tbody>
  21635. </table>
  21636. <h3 id="external-secrets.io/v1beta1.GithubProvider">GithubProvider
  21637. </h3>
  21638. <p>
  21639. (<em>Appears on:</em>
  21640. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21641. </p>
  21642. <p>
  21643. <p>GithubProvider configures a store to push secrets to Github Actions.</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>url</code></br>
  21656. <em>
  21657. string
  21658. </em>
  21659. </td>
  21660. <td>
  21661. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  21662. </td>
  21663. </tr>
  21664. <tr>
  21665. <td>
  21666. <code>uploadURL</code></br>
  21667. <em>
  21668. string
  21669. </em>
  21670. </td>
  21671. <td>
  21672. <em>(Optional)</em>
  21673. <p>Upload URL for enterprise instances. Default to URL.</p>
  21674. </td>
  21675. </tr>
  21676. <tr>
  21677. <td>
  21678. <code>auth</code></br>
  21679. <em>
  21680. <a href="#external-secrets.io/v1beta1.GithubAppAuth">
  21681. GithubAppAuth
  21682. </a>
  21683. </em>
  21684. </td>
  21685. <td>
  21686. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  21687. </td>
  21688. </tr>
  21689. <tr>
  21690. <td>
  21691. <code>appID</code></br>
  21692. <em>
  21693. int64
  21694. </em>
  21695. </td>
  21696. <td>
  21697. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  21698. </td>
  21699. </tr>
  21700. <tr>
  21701. <td>
  21702. <code>installationID</code></br>
  21703. <em>
  21704. int64
  21705. </em>
  21706. </td>
  21707. <td>
  21708. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  21709. </td>
  21710. </tr>
  21711. <tr>
  21712. <td>
  21713. <code>organization</code></br>
  21714. <em>
  21715. string
  21716. </em>
  21717. </td>
  21718. <td>
  21719. <p>organization will be used to fetch secrets from the Github organization</p>
  21720. </td>
  21721. </tr>
  21722. <tr>
  21723. <td>
  21724. <code>repository</code></br>
  21725. <em>
  21726. string
  21727. </em>
  21728. </td>
  21729. <td>
  21730. <em>(Optional)</em>
  21731. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  21732. </td>
  21733. </tr>
  21734. <tr>
  21735. <td>
  21736. <code>environment</code></br>
  21737. <em>
  21738. string
  21739. </em>
  21740. </td>
  21741. <td>
  21742. <em>(Optional)</em>
  21743. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  21744. </td>
  21745. </tr>
  21746. </tbody>
  21747. </table>
  21748. <h3 id="external-secrets.io/v1beta1.GitlabAuth">GitlabAuth
  21749. </h3>
  21750. <p>
  21751. (<em>Appears on:</em>
  21752. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>)
  21753. </p>
  21754. <p>
  21755. <p>GitlabAuth defines the authentication method for the GitLab provider.</p>
  21756. </p>
  21757. <table>
  21758. <thead>
  21759. <tr>
  21760. <th>Field</th>
  21761. <th>Description</th>
  21762. </tr>
  21763. </thead>
  21764. <tbody>
  21765. <tr>
  21766. <td>
  21767. <code>SecretRef</code></br>
  21768. <em>
  21769. <a href="#external-secrets.io/v1beta1.GitlabSecretRef">
  21770. GitlabSecretRef
  21771. </a>
  21772. </em>
  21773. </td>
  21774. <td>
  21775. </td>
  21776. </tr>
  21777. </tbody>
  21778. </table>
  21779. <h3 id="external-secrets.io/v1beta1.GitlabProvider">GitlabProvider
  21780. </h3>
  21781. <p>
  21782. (<em>Appears on:</em>
  21783. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21784. </p>
  21785. <p>
  21786. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  21787. </p>
  21788. <table>
  21789. <thead>
  21790. <tr>
  21791. <th>Field</th>
  21792. <th>Description</th>
  21793. </tr>
  21794. </thead>
  21795. <tbody>
  21796. <tr>
  21797. <td>
  21798. <code>url</code></br>
  21799. <em>
  21800. string
  21801. </em>
  21802. </td>
  21803. <td>
  21804. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  21805. </td>
  21806. </tr>
  21807. <tr>
  21808. <td>
  21809. <code>auth</code></br>
  21810. <em>
  21811. <a href="#external-secrets.io/v1beta1.GitlabAuth">
  21812. GitlabAuth
  21813. </a>
  21814. </em>
  21815. </td>
  21816. <td>
  21817. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  21818. </td>
  21819. </tr>
  21820. <tr>
  21821. <td>
  21822. <code>projectID</code></br>
  21823. <em>
  21824. string
  21825. </em>
  21826. </td>
  21827. <td>
  21828. <p>ProjectID specifies a project where secrets are located.</p>
  21829. </td>
  21830. </tr>
  21831. <tr>
  21832. <td>
  21833. <code>inheritFromGroups</code></br>
  21834. <em>
  21835. bool
  21836. </em>
  21837. </td>
  21838. <td>
  21839. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  21840. </td>
  21841. </tr>
  21842. <tr>
  21843. <td>
  21844. <code>groupIDs</code></br>
  21845. <em>
  21846. []string
  21847. </em>
  21848. </td>
  21849. <td>
  21850. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  21851. </td>
  21852. </tr>
  21853. <tr>
  21854. <td>
  21855. <code>environment</code></br>
  21856. <em>
  21857. string
  21858. </em>
  21859. </td>
  21860. <td>
  21861. <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>
  21862. </td>
  21863. </tr>
  21864. <tr>
  21865. <td>
  21866. <code>caBundle</code></br>
  21867. <em>
  21868. []byte
  21869. </em>
  21870. </td>
  21871. <td>
  21872. <em>(Optional)</em>
  21873. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  21874. can be performed.</p>
  21875. </td>
  21876. </tr>
  21877. <tr>
  21878. <td>
  21879. <code>caProvider</code></br>
  21880. <em>
  21881. <a href="#external-secrets.io/v1beta1.CAProvider">
  21882. CAProvider
  21883. </a>
  21884. </em>
  21885. </td>
  21886. <td>
  21887. <em>(Optional)</em>
  21888. <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>
  21889. </td>
  21890. </tr>
  21891. </tbody>
  21892. </table>
  21893. <h3 id="external-secrets.io/v1beta1.GitlabSecretRef">GitlabSecretRef
  21894. </h3>
  21895. <p>
  21896. (<em>Appears on:</em>
  21897. <a href="#external-secrets.io/v1beta1.GitlabAuth">GitlabAuth</a>)
  21898. </p>
  21899. <p>
  21900. <p>GitlabSecretRef defines a reference to a secret containing credentials for the GitLab provider.</p>
  21901. </p>
  21902. <table>
  21903. <thead>
  21904. <tr>
  21905. <th>Field</th>
  21906. <th>Description</th>
  21907. </tr>
  21908. </thead>
  21909. <tbody>
  21910. <tr>
  21911. <td>
  21912. <code>accessToken</code></br>
  21913. <em>
  21914. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21915. External Secrets meta/v1.SecretKeySelector
  21916. </a>
  21917. </em>
  21918. </td>
  21919. <td>
  21920. <p>AccessToken is used for authentication.</p>
  21921. </td>
  21922. </tr>
  21923. </tbody>
  21924. </table>
  21925. <h3 id="external-secrets.io/v1beta1.IBMAuth">IBMAuth
  21926. </h3>
  21927. <p>
  21928. (<em>Appears on:</em>
  21929. <a href="#external-secrets.io/v1beta1.IBMProvider">IBMProvider</a>)
  21930. </p>
  21931. <p>
  21932. <p>IBMAuth defines the authentication methods for the IBM Cloud Secrets Manager provider.</p>
  21933. </p>
  21934. <table>
  21935. <thead>
  21936. <tr>
  21937. <th>Field</th>
  21938. <th>Description</th>
  21939. </tr>
  21940. </thead>
  21941. <tbody>
  21942. <tr>
  21943. <td>
  21944. <code>secretRef</code></br>
  21945. <em>
  21946. <a href="#external-secrets.io/v1beta1.IBMAuthSecretRef">
  21947. IBMAuthSecretRef
  21948. </a>
  21949. </em>
  21950. </td>
  21951. <td>
  21952. </td>
  21953. </tr>
  21954. <tr>
  21955. <td>
  21956. <code>containerAuth</code></br>
  21957. <em>
  21958. <a href="#external-secrets.io/v1beta1.IBMAuthContainerAuth">
  21959. IBMAuthContainerAuth
  21960. </a>
  21961. </em>
  21962. </td>
  21963. <td>
  21964. </td>
  21965. </tr>
  21966. </tbody>
  21967. </table>
  21968. <h3 id="external-secrets.io/v1beta1.IBMAuthContainerAuth">IBMAuthContainerAuth
  21969. </h3>
  21970. <p>
  21971. (<em>Appears on:</em>
  21972. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  21973. </p>
  21974. <p>
  21975. <p>IBMAuthContainerAuth defines authentication using IBM Container-based auth with IAM Trusted Profile.</p>
  21976. </p>
  21977. <table>
  21978. <thead>
  21979. <tr>
  21980. <th>Field</th>
  21981. <th>Description</th>
  21982. </tr>
  21983. </thead>
  21984. <tbody>
  21985. <tr>
  21986. <td>
  21987. <code>profile</code></br>
  21988. <em>
  21989. string
  21990. </em>
  21991. </td>
  21992. <td>
  21993. <p>the IBM Trusted Profile</p>
  21994. </td>
  21995. </tr>
  21996. <tr>
  21997. <td>
  21998. <code>tokenLocation</code></br>
  21999. <em>
  22000. string
  22001. </em>
  22002. </td>
  22003. <td>
  22004. <p>Location the token is mounted on the pod</p>
  22005. </td>
  22006. </tr>
  22007. <tr>
  22008. <td>
  22009. <code>iamEndpoint</code></br>
  22010. <em>
  22011. string
  22012. </em>
  22013. </td>
  22014. <td>
  22015. </td>
  22016. </tr>
  22017. </tbody>
  22018. </table>
  22019. <h3 id="external-secrets.io/v1beta1.IBMAuthSecretRef">IBMAuthSecretRef
  22020. </h3>
  22021. <p>
  22022. (<em>Appears on:</em>
  22023. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  22024. </p>
  22025. <p>
  22026. <p>IBMAuthSecretRef defines a reference to a secret containing credentials for the IBM provider.</p>
  22027. </p>
  22028. <table>
  22029. <thead>
  22030. <tr>
  22031. <th>Field</th>
  22032. <th>Description</th>
  22033. </tr>
  22034. </thead>
  22035. <tbody>
  22036. <tr>
  22037. <td>
  22038. <code>secretApiKeySecretRef</code></br>
  22039. <em>
  22040. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22041. External Secrets meta/v1.SecretKeySelector
  22042. </a>
  22043. </em>
  22044. </td>
  22045. <td>
  22046. <p>The SecretAccessKey is used for authentication</p>
  22047. </td>
  22048. </tr>
  22049. </tbody>
  22050. </table>
  22051. <h3 id="external-secrets.io/v1beta1.IBMProvider">IBMProvider
  22052. </h3>
  22053. <p>
  22054. (<em>Appears on:</em>
  22055. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22056. </p>
  22057. <p>
  22058. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager backend.</p>
  22059. </p>
  22060. <table>
  22061. <thead>
  22062. <tr>
  22063. <th>Field</th>
  22064. <th>Description</th>
  22065. </tr>
  22066. </thead>
  22067. <tbody>
  22068. <tr>
  22069. <td>
  22070. <code>auth</code></br>
  22071. <em>
  22072. <a href="#external-secrets.io/v1beta1.IBMAuth">
  22073. IBMAuth
  22074. </a>
  22075. </em>
  22076. </td>
  22077. <td>
  22078. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  22079. </td>
  22080. </tr>
  22081. <tr>
  22082. <td>
  22083. <code>serviceUrl</code></br>
  22084. <em>
  22085. string
  22086. </em>
  22087. </td>
  22088. <td>
  22089. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  22090. </td>
  22091. </tr>
  22092. </tbody>
  22093. </table>
  22094. <h3 id="external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth
  22095. </h3>
  22096. <p>
  22097. (<em>Appears on:</em>
  22098. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  22099. </p>
  22100. <p>
  22101. <p>InfisicalAuth defines the authentication methods for the Infisical provider.</p>
  22102. </p>
  22103. <table>
  22104. <thead>
  22105. <tr>
  22106. <th>Field</th>
  22107. <th>Description</th>
  22108. </tr>
  22109. </thead>
  22110. <tbody>
  22111. <tr>
  22112. <td>
  22113. <code>universalAuthCredentials</code></br>
  22114. <em>
  22115. <a href="#external-secrets.io/v1beta1.UniversalAuthCredentials">
  22116. UniversalAuthCredentials
  22117. </a>
  22118. </em>
  22119. </td>
  22120. <td>
  22121. <em>(Optional)</em>
  22122. </td>
  22123. </tr>
  22124. </tbody>
  22125. </table>
  22126. <h3 id="external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider
  22127. </h3>
  22128. <p>
  22129. (<em>Appears on:</em>
  22130. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22131. </p>
  22132. <p>
  22133. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  22134. </p>
  22135. <table>
  22136. <thead>
  22137. <tr>
  22138. <th>Field</th>
  22139. <th>Description</th>
  22140. </tr>
  22141. </thead>
  22142. <tbody>
  22143. <tr>
  22144. <td>
  22145. <code>auth</code></br>
  22146. <em>
  22147. <a href="#external-secrets.io/v1beta1.InfisicalAuth">
  22148. InfisicalAuth
  22149. </a>
  22150. </em>
  22151. </td>
  22152. <td>
  22153. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  22154. </td>
  22155. </tr>
  22156. <tr>
  22157. <td>
  22158. <code>secretsScope</code></br>
  22159. <em>
  22160. <a href="#external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">
  22161. MachineIdentityScopeInWorkspace
  22162. </a>
  22163. </em>
  22164. </td>
  22165. <td>
  22166. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  22167. </td>
  22168. </tr>
  22169. <tr>
  22170. <td>
  22171. <code>hostAPI</code></br>
  22172. <em>
  22173. string
  22174. </em>
  22175. </td>
  22176. <td>
  22177. <em>(Optional)</em>
  22178. <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>
  22179. </td>
  22180. </tr>
  22181. </tbody>
  22182. </table>
  22183. <h3 id="external-secrets.io/v1beta1.KeeperSecurityProvider">KeeperSecurityProvider
  22184. </h3>
  22185. <p>
  22186. (<em>Appears on:</em>
  22187. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22188. </p>
  22189. <p>
  22190. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  22191. </p>
  22192. <table>
  22193. <thead>
  22194. <tr>
  22195. <th>Field</th>
  22196. <th>Description</th>
  22197. </tr>
  22198. </thead>
  22199. <tbody>
  22200. <tr>
  22201. <td>
  22202. <code>authRef</code></br>
  22203. <em>
  22204. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22205. External Secrets meta/v1.SecretKeySelector
  22206. </a>
  22207. </em>
  22208. </td>
  22209. <td>
  22210. </td>
  22211. </tr>
  22212. <tr>
  22213. <td>
  22214. <code>folderID</code></br>
  22215. <em>
  22216. string
  22217. </em>
  22218. </td>
  22219. <td>
  22220. </td>
  22221. </tr>
  22222. </tbody>
  22223. </table>
  22224. <h3 id="external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth
  22225. </h3>
  22226. <p>
  22227. (<em>Appears on:</em>
  22228. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  22229. </p>
  22230. <p>
  22231. <p>KubernetesAuth defines authentication methods for the Kubernetes provider.</p>
  22232. </p>
  22233. <table>
  22234. <thead>
  22235. <tr>
  22236. <th>Field</th>
  22237. <th>Description</th>
  22238. </tr>
  22239. </thead>
  22240. <tbody>
  22241. <tr>
  22242. <td>
  22243. <code>cert</code></br>
  22244. <em>
  22245. <a href="#external-secrets.io/v1beta1.CertAuth">
  22246. CertAuth
  22247. </a>
  22248. </em>
  22249. </td>
  22250. <td>
  22251. <em>(Optional)</em>
  22252. <p>has both clientCert and clientKey as secretKeySelector</p>
  22253. </td>
  22254. </tr>
  22255. <tr>
  22256. <td>
  22257. <code>token</code></br>
  22258. <em>
  22259. <a href="#external-secrets.io/v1beta1.TokenAuth">
  22260. TokenAuth
  22261. </a>
  22262. </em>
  22263. </td>
  22264. <td>
  22265. <em>(Optional)</em>
  22266. <p>use static token to authenticate with</p>
  22267. </td>
  22268. </tr>
  22269. <tr>
  22270. <td>
  22271. <code>serviceAccount</code></br>
  22272. <em>
  22273. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  22274. External Secrets meta/v1.ServiceAccountSelector
  22275. </a>
  22276. </em>
  22277. </td>
  22278. <td>
  22279. <em>(Optional)</em>
  22280. <p>points to a service account that should be used for authentication</p>
  22281. </td>
  22282. </tr>
  22283. </tbody>
  22284. </table>
  22285. <h3 id="external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider
  22286. </h3>
  22287. <p>
  22288. (<em>Appears on:</em>
  22289. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22290. </p>
  22291. <p>
  22292. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  22293. </p>
  22294. <table>
  22295. <thead>
  22296. <tr>
  22297. <th>Field</th>
  22298. <th>Description</th>
  22299. </tr>
  22300. </thead>
  22301. <tbody>
  22302. <tr>
  22303. <td>
  22304. <code>server</code></br>
  22305. <em>
  22306. <a href="#external-secrets.io/v1beta1.KubernetesServer">
  22307. KubernetesServer
  22308. </a>
  22309. </em>
  22310. </td>
  22311. <td>
  22312. <em>(Optional)</em>
  22313. <p>configures the Kubernetes server Address.</p>
  22314. </td>
  22315. </tr>
  22316. <tr>
  22317. <td>
  22318. <code>auth</code></br>
  22319. <em>
  22320. <a href="#external-secrets.io/v1beta1.KubernetesAuth">
  22321. KubernetesAuth
  22322. </a>
  22323. </em>
  22324. </td>
  22325. <td>
  22326. <em>(Optional)</em>
  22327. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  22328. </td>
  22329. </tr>
  22330. <tr>
  22331. <td>
  22332. <code>authRef</code></br>
  22333. <em>
  22334. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22335. External Secrets meta/v1.SecretKeySelector
  22336. </a>
  22337. </em>
  22338. </td>
  22339. <td>
  22340. <em>(Optional)</em>
  22341. <p>A reference to a secret that contains the auth information.</p>
  22342. </td>
  22343. </tr>
  22344. <tr>
  22345. <td>
  22346. <code>remoteNamespace</code></br>
  22347. <em>
  22348. string
  22349. </em>
  22350. </td>
  22351. <td>
  22352. <em>(Optional)</em>
  22353. <p>Remote namespace to fetch the secrets from</p>
  22354. </td>
  22355. </tr>
  22356. </tbody>
  22357. </table>
  22358. <h3 id="external-secrets.io/v1beta1.KubernetesServer">KubernetesServer
  22359. </h3>
  22360. <p>
  22361. (<em>Appears on:</em>
  22362. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  22363. </p>
  22364. <p>
  22365. <p>KubernetesServer defines the Kubernetes server connection configuration.</p>
  22366. </p>
  22367. <table>
  22368. <thead>
  22369. <tr>
  22370. <th>Field</th>
  22371. <th>Description</th>
  22372. </tr>
  22373. </thead>
  22374. <tbody>
  22375. <tr>
  22376. <td>
  22377. <code>url</code></br>
  22378. <em>
  22379. string
  22380. </em>
  22381. </td>
  22382. <td>
  22383. <em>(Optional)</em>
  22384. <p>configures the Kubernetes server Address.</p>
  22385. </td>
  22386. </tr>
  22387. <tr>
  22388. <td>
  22389. <code>caBundle</code></br>
  22390. <em>
  22391. []byte
  22392. </em>
  22393. </td>
  22394. <td>
  22395. <em>(Optional)</em>
  22396. <p>CABundle is a base64-encoded CA certificate</p>
  22397. </td>
  22398. </tr>
  22399. <tr>
  22400. <td>
  22401. <code>caProvider</code></br>
  22402. <em>
  22403. <a href="#external-secrets.io/v1beta1.CAProvider">
  22404. CAProvider
  22405. </a>
  22406. </em>
  22407. </td>
  22408. <td>
  22409. <em>(Optional)</em>
  22410. <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>
  22411. </td>
  22412. </tr>
  22413. </tbody>
  22414. </table>
  22415. <h3 id="external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  22416. </h3>
  22417. <p>
  22418. (<em>Appears on:</em>
  22419. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  22420. </p>
  22421. <p>
  22422. <p>MachineIdentityScopeInWorkspace defines the scope of a machine identity in an Infisical workspace.</p>
  22423. </p>
  22424. <table>
  22425. <thead>
  22426. <tr>
  22427. <th>Field</th>
  22428. <th>Description</th>
  22429. </tr>
  22430. </thead>
  22431. <tbody>
  22432. <tr>
  22433. <td>
  22434. <code>secretsPath</code></br>
  22435. <em>
  22436. string
  22437. </em>
  22438. </td>
  22439. <td>
  22440. <em>(Optional)</em>
  22441. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  22442. </td>
  22443. </tr>
  22444. <tr>
  22445. <td>
  22446. <code>recursive</code></br>
  22447. <em>
  22448. bool
  22449. </em>
  22450. </td>
  22451. <td>
  22452. <em>(Optional)</em>
  22453. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  22454. </td>
  22455. </tr>
  22456. <tr>
  22457. <td>
  22458. <code>environmentSlug</code></br>
  22459. <em>
  22460. string
  22461. </em>
  22462. </td>
  22463. <td>
  22464. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  22465. </td>
  22466. </tr>
  22467. <tr>
  22468. <td>
  22469. <code>projectSlug</code></br>
  22470. <em>
  22471. string
  22472. </em>
  22473. </td>
  22474. <td>
  22475. <p>ProjectSlug is the required slug identifier for the project.</p>
  22476. </td>
  22477. </tr>
  22478. <tr>
  22479. <td>
  22480. <code>expandSecretReferences</code></br>
  22481. <em>
  22482. bool
  22483. </em>
  22484. </td>
  22485. <td>
  22486. <em>(Optional)</em>
  22487. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  22488. </td>
  22489. </tr>
  22490. </tbody>
  22491. </table>
  22492. <h3 id="external-secrets.io/v1beta1.NTLMProtocol">NTLMProtocol
  22493. </h3>
  22494. <p>
  22495. (<em>Appears on:</em>
  22496. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol</a>)
  22497. </p>
  22498. <p>
  22499. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  22500. </p>
  22501. <table>
  22502. <thead>
  22503. <tr>
  22504. <th>Field</th>
  22505. <th>Description</th>
  22506. </tr>
  22507. </thead>
  22508. <tbody>
  22509. <tr>
  22510. <td>
  22511. <code>usernameSecret</code></br>
  22512. <em>
  22513. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22514. External Secrets meta/v1.SecretKeySelector
  22515. </a>
  22516. </em>
  22517. </td>
  22518. <td>
  22519. </td>
  22520. </tr>
  22521. <tr>
  22522. <td>
  22523. <code>passwordSecret</code></br>
  22524. <em>
  22525. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22526. External Secrets meta/v1.SecretKeySelector
  22527. </a>
  22528. </em>
  22529. </td>
  22530. <td>
  22531. </td>
  22532. </tr>
  22533. </tbody>
  22534. </table>
  22535. <h3 id="external-secrets.io/v1beta1.NoSecretError">NoSecretError
  22536. </h3>
  22537. <p>
  22538. <p>NoSecretError shall be returned when a GetSecret can not find the
  22539. desired secret. This is used for deletionPolicy.</p>
  22540. </p>
  22541. <h3 id="external-secrets.io/v1beta1.NotModifiedError">NotModifiedError
  22542. </h3>
  22543. <p>
  22544. <p>NotModifiedError to signal that the webhook received no changes,
  22545. and it should just return without doing anything.</p>
  22546. </p>
  22547. <h3 id="external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  22548. </h3>
  22549. <p>
  22550. (<em>Appears on:</em>
  22551. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider</a>)
  22552. </p>
  22553. <p>
  22554. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  22555. </p>
  22556. <table>
  22557. <thead>
  22558. <tr>
  22559. <th>Field</th>
  22560. <th>Description</th>
  22561. </tr>
  22562. </thead>
  22563. <tbody>
  22564. <tr>
  22565. <td>
  22566. <code>apiKeyRef</code></br>
  22567. <em>
  22568. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22569. External Secrets meta/v1.SecretKeySelector
  22570. </a>
  22571. </em>
  22572. </td>
  22573. <td>
  22574. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  22575. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  22576. </td>
  22577. </tr>
  22578. <tr>
  22579. <td>
  22580. <code>passcodeRef</code></br>
  22581. <em>
  22582. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22583. External Secrets meta/v1.SecretKeySelector
  22584. </a>
  22585. </em>
  22586. </td>
  22587. <td>
  22588. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  22589. </td>
  22590. </tr>
  22591. </tbody>
  22592. </table>
  22593. <h3 id="external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider
  22594. </h3>
  22595. <p>
  22596. (<em>Appears on:</em>
  22597. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22598. </p>
  22599. <p>
  22600. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  22601. Project and Config are required if not using a Service Token.</p>
  22602. </p>
  22603. <table>
  22604. <thead>
  22605. <tr>
  22606. <th>Field</th>
  22607. <th>Description</th>
  22608. </tr>
  22609. </thead>
  22610. <tbody>
  22611. <tr>
  22612. <td>
  22613. <code>auth</code></br>
  22614. <em>
  22615. <a href="#external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">
  22616. OnboardbaseAuthSecretRef
  22617. </a>
  22618. </em>
  22619. </td>
  22620. <td>
  22621. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  22622. </td>
  22623. </tr>
  22624. <tr>
  22625. <td>
  22626. <code>apiHost</code></br>
  22627. <em>
  22628. string
  22629. </em>
  22630. </td>
  22631. <td>
  22632. <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>
  22633. </td>
  22634. </tr>
  22635. <tr>
  22636. <td>
  22637. <code>project</code></br>
  22638. <em>
  22639. string
  22640. </em>
  22641. </td>
  22642. <td>
  22643. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  22644. </td>
  22645. </tr>
  22646. <tr>
  22647. <td>
  22648. <code>environment</code></br>
  22649. <em>
  22650. string
  22651. </em>
  22652. </td>
  22653. <td>
  22654. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  22655. </td>
  22656. </tr>
  22657. </tbody>
  22658. </table>
  22659. <h3 id="external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth
  22660. </h3>
  22661. <p>
  22662. (<em>Appears on:</em>
  22663. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider</a>)
  22664. </p>
  22665. <p>
  22666. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  22667. </p>
  22668. <table>
  22669. <thead>
  22670. <tr>
  22671. <th>Field</th>
  22672. <th>Description</th>
  22673. </tr>
  22674. </thead>
  22675. <tbody>
  22676. <tr>
  22677. <td>
  22678. <code>secretRef</code></br>
  22679. <em>
  22680. <a href="#external-secrets.io/v1beta1.OnePasswordAuthSecretRef">
  22681. OnePasswordAuthSecretRef
  22682. </a>
  22683. </em>
  22684. </td>
  22685. <td>
  22686. </td>
  22687. </tr>
  22688. </tbody>
  22689. </table>
  22690. <h3 id="external-secrets.io/v1beta1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  22691. </h3>
  22692. <p>
  22693. (<em>Appears on:</em>
  22694. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth</a>)
  22695. </p>
  22696. <p>
  22697. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  22698. </p>
  22699. <table>
  22700. <thead>
  22701. <tr>
  22702. <th>Field</th>
  22703. <th>Description</th>
  22704. </tr>
  22705. </thead>
  22706. <tbody>
  22707. <tr>
  22708. <td>
  22709. <code>connectTokenSecretRef</code></br>
  22710. <em>
  22711. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22712. External Secrets meta/v1.SecretKeySelector
  22713. </a>
  22714. </em>
  22715. </td>
  22716. <td>
  22717. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  22718. </td>
  22719. </tr>
  22720. </tbody>
  22721. </table>
  22722. <h3 id="external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider
  22723. </h3>
  22724. <p>
  22725. (<em>Appears on:</em>
  22726. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22727. </p>
  22728. <p>
  22729. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  22730. </p>
  22731. <table>
  22732. <thead>
  22733. <tr>
  22734. <th>Field</th>
  22735. <th>Description</th>
  22736. </tr>
  22737. </thead>
  22738. <tbody>
  22739. <tr>
  22740. <td>
  22741. <code>auth</code></br>
  22742. <em>
  22743. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">
  22744. OnePasswordAuth
  22745. </a>
  22746. </em>
  22747. </td>
  22748. <td>
  22749. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  22750. </td>
  22751. </tr>
  22752. <tr>
  22753. <td>
  22754. <code>connectHost</code></br>
  22755. <em>
  22756. string
  22757. </em>
  22758. </td>
  22759. <td>
  22760. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  22761. </td>
  22762. </tr>
  22763. <tr>
  22764. <td>
  22765. <code>vaults</code></br>
  22766. <em>
  22767. map[string]int
  22768. </em>
  22769. </td>
  22770. <td>
  22771. <p>Vaults defines which OnePassword vaults to search in which order</p>
  22772. </td>
  22773. </tr>
  22774. </tbody>
  22775. </table>
  22776. <h3 id="external-secrets.io/v1beta1.OracleAuth">OracleAuth
  22777. </h3>
  22778. <p>
  22779. (<em>Appears on:</em>
  22780. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  22781. </p>
  22782. <p>
  22783. <p>OracleAuth defines authentication configuration for the Oracle Vault provider.</p>
  22784. </p>
  22785. <table>
  22786. <thead>
  22787. <tr>
  22788. <th>Field</th>
  22789. <th>Description</th>
  22790. </tr>
  22791. </thead>
  22792. <tbody>
  22793. <tr>
  22794. <td>
  22795. <code>tenancy</code></br>
  22796. <em>
  22797. string
  22798. </em>
  22799. </td>
  22800. <td>
  22801. <p>Tenancy is the tenancy OCID where user is located.</p>
  22802. </td>
  22803. </tr>
  22804. <tr>
  22805. <td>
  22806. <code>user</code></br>
  22807. <em>
  22808. string
  22809. </em>
  22810. </td>
  22811. <td>
  22812. <p>User is an access OCID specific to the account.</p>
  22813. </td>
  22814. </tr>
  22815. <tr>
  22816. <td>
  22817. <code>secretRef</code></br>
  22818. <em>
  22819. <a href="#external-secrets.io/v1beta1.OracleSecretRef">
  22820. OracleSecretRef
  22821. </a>
  22822. </em>
  22823. </td>
  22824. <td>
  22825. <p>SecretRef to pass through sensitive information.</p>
  22826. </td>
  22827. </tr>
  22828. </tbody>
  22829. </table>
  22830. <h3 id="external-secrets.io/v1beta1.OraclePrincipalType">OraclePrincipalType
  22831. (<code>string</code> alias)</p></h3>
  22832. <p>
  22833. (<em>Appears on:</em>
  22834. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  22835. </p>
  22836. <p>
  22837. <p>OraclePrincipalType defines the type of principal used for authentication to Oracle Vault.</p>
  22838. </p>
  22839. <table>
  22840. <thead>
  22841. <tr>
  22842. <th>Value</th>
  22843. <th>Description</th>
  22844. </tr>
  22845. </thead>
  22846. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  22847. <td><p>InstancePrincipal represents a instance principal.</p>
  22848. </td>
  22849. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  22850. <td><p>UserPrincipal represents a user principal.</p>
  22851. </td>
  22852. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  22853. <td><p>WorkloadPrincipal represents a workload principal.</p>
  22854. </td>
  22855. </tr></tbody>
  22856. </table>
  22857. <h3 id="external-secrets.io/v1beta1.OracleProvider">OracleProvider
  22858. </h3>
  22859. <p>
  22860. (<em>Appears on:</em>
  22861. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22862. </p>
  22863. <p>
  22864. <p>OracleProvider configures a store to sync secrets using an Oracle Vault backend.</p>
  22865. </p>
  22866. <table>
  22867. <thead>
  22868. <tr>
  22869. <th>Field</th>
  22870. <th>Description</th>
  22871. </tr>
  22872. </thead>
  22873. <tbody>
  22874. <tr>
  22875. <td>
  22876. <code>region</code></br>
  22877. <em>
  22878. string
  22879. </em>
  22880. </td>
  22881. <td>
  22882. <p>Region is the region where vault is located.</p>
  22883. </td>
  22884. </tr>
  22885. <tr>
  22886. <td>
  22887. <code>vault</code></br>
  22888. <em>
  22889. string
  22890. </em>
  22891. </td>
  22892. <td>
  22893. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  22894. </td>
  22895. </tr>
  22896. <tr>
  22897. <td>
  22898. <code>compartment</code></br>
  22899. <em>
  22900. string
  22901. </em>
  22902. </td>
  22903. <td>
  22904. <em>(Optional)</em>
  22905. <p>Compartment is the vault compartment OCID.
  22906. Required for PushSecret</p>
  22907. </td>
  22908. </tr>
  22909. <tr>
  22910. <td>
  22911. <code>encryptionKey</code></br>
  22912. <em>
  22913. string
  22914. </em>
  22915. </td>
  22916. <td>
  22917. <em>(Optional)</em>
  22918. <p>EncryptionKey is the OCID of the encryption key within the vault.
  22919. Required for PushSecret</p>
  22920. </td>
  22921. </tr>
  22922. <tr>
  22923. <td>
  22924. <code>principalType</code></br>
  22925. <em>
  22926. <a href="#external-secrets.io/v1beta1.OraclePrincipalType">
  22927. OraclePrincipalType
  22928. </a>
  22929. </em>
  22930. </td>
  22931. <td>
  22932. <em>(Optional)</em>
  22933. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  22934. determine the principal type. This optional field must be specified if using
  22935. workload identity.</p>
  22936. </td>
  22937. </tr>
  22938. <tr>
  22939. <td>
  22940. <code>auth</code></br>
  22941. <em>
  22942. <a href="#external-secrets.io/v1beta1.OracleAuth">
  22943. OracleAuth
  22944. </a>
  22945. </em>
  22946. </td>
  22947. <td>
  22948. <em>(Optional)</em>
  22949. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  22950. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  22951. </td>
  22952. </tr>
  22953. <tr>
  22954. <td>
  22955. <code>serviceAccountRef</code></br>
  22956. <em>
  22957. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  22958. External Secrets meta/v1.ServiceAccountSelector
  22959. </a>
  22960. </em>
  22961. </td>
  22962. <td>
  22963. <em>(Optional)</em>
  22964. <p>ServiceAccountRef specified the service account
  22965. that should be used when authenticating with WorkloadIdentity.</p>
  22966. </td>
  22967. </tr>
  22968. </tbody>
  22969. </table>
  22970. <h3 id="external-secrets.io/v1beta1.OracleSecretRef">OracleSecretRef
  22971. </h3>
  22972. <p>
  22973. (<em>Appears on:</em>
  22974. <a href="#external-secrets.io/v1beta1.OracleAuth">OracleAuth</a>)
  22975. </p>
  22976. <p>
  22977. <p>OracleSecretRef defines references to secrets containing Oracle credentials.</p>
  22978. </p>
  22979. <table>
  22980. <thead>
  22981. <tr>
  22982. <th>Field</th>
  22983. <th>Description</th>
  22984. </tr>
  22985. </thead>
  22986. <tbody>
  22987. <tr>
  22988. <td>
  22989. <code>privatekey</code></br>
  22990. <em>
  22991. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22992. External Secrets meta/v1.SecretKeySelector
  22993. </a>
  22994. </em>
  22995. </td>
  22996. <td>
  22997. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  22998. </td>
  22999. </tr>
  23000. <tr>
  23001. <td>
  23002. <code>fingerprint</code></br>
  23003. <em>
  23004. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23005. External Secrets meta/v1.SecretKeySelector
  23006. </a>
  23007. </em>
  23008. </td>
  23009. <td>
  23010. <p>Fingerprint is the fingerprint of the API private key.</p>
  23011. </td>
  23012. </tr>
  23013. </tbody>
  23014. </table>
  23015. <h3 id="external-secrets.io/v1beta1.PassboltAuth">PassboltAuth
  23016. </h3>
  23017. <p>
  23018. (<em>Appears on:</em>
  23019. <a href="#external-secrets.io/v1beta1.PassboltProvider">PassboltProvider</a>)
  23020. </p>
  23021. <p>
  23022. <p>PassboltAuth contains credentials and configuration for authenticating with the Passbolt server.</p>
  23023. </p>
  23024. <table>
  23025. <thead>
  23026. <tr>
  23027. <th>Field</th>
  23028. <th>Description</th>
  23029. </tr>
  23030. </thead>
  23031. <tbody>
  23032. <tr>
  23033. <td>
  23034. <code>passwordSecretRef</code></br>
  23035. <em>
  23036. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23037. External Secrets meta/v1.SecretKeySelector
  23038. </a>
  23039. </em>
  23040. </td>
  23041. <td>
  23042. <p>PasswordSecretRef is a reference to the secret containing the Passbolt password</p>
  23043. </td>
  23044. </tr>
  23045. <tr>
  23046. <td>
  23047. <code>privateKeySecretRef</code></br>
  23048. <em>
  23049. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23050. External Secrets meta/v1.SecretKeySelector
  23051. </a>
  23052. </em>
  23053. </td>
  23054. <td>
  23055. <p>PrivateKeySecretRef is a reference to the secret containing the Passbolt private key</p>
  23056. </td>
  23057. </tr>
  23058. </tbody>
  23059. </table>
  23060. <h3 id="external-secrets.io/v1beta1.PassboltProvider">PassboltProvider
  23061. </h3>
  23062. <p>
  23063. (<em>Appears on:</em>
  23064. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23065. </p>
  23066. <p>
  23067. <p>PassboltProvider defines configuration for the Passbolt provider.</p>
  23068. </p>
  23069. <table>
  23070. <thead>
  23071. <tr>
  23072. <th>Field</th>
  23073. <th>Description</th>
  23074. </tr>
  23075. </thead>
  23076. <tbody>
  23077. <tr>
  23078. <td>
  23079. <code>auth</code></br>
  23080. <em>
  23081. <a href="#external-secrets.io/v1beta1.PassboltAuth">
  23082. PassboltAuth
  23083. </a>
  23084. </em>
  23085. </td>
  23086. <td>
  23087. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  23088. </td>
  23089. </tr>
  23090. <tr>
  23091. <td>
  23092. <code>host</code></br>
  23093. <em>
  23094. string
  23095. </em>
  23096. </td>
  23097. <td>
  23098. <p>Host defines the Passbolt Server to connect to</p>
  23099. </td>
  23100. </tr>
  23101. </tbody>
  23102. </table>
  23103. <h3 id="external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth
  23104. </h3>
  23105. <p>
  23106. (<em>Appears on:</em>
  23107. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider</a>)
  23108. </p>
  23109. <p>
  23110. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  23111. </p>
  23112. <table>
  23113. <thead>
  23114. <tr>
  23115. <th>Field</th>
  23116. <th>Description</th>
  23117. </tr>
  23118. </thead>
  23119. <tbody>
  23120. <tr>
  23121. <td>
  23122. <code>secretRef</code></br>
  23123. <em>
  23124. <a href="#external-secrets.io/v1beta1.PasswordDepotSecretRef">
  23125. PasswordDepotSecretRef
  23126. </a>
  23127. </em>
  23128. </td>
  23129. <td>
  23130. </td>
  23131. </tr>
  23132. </tbody>
  23133. </table>
  23134. <h3 id="external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider
  23135. </h3>
  23136. <p>
  23137. (<em>Appears on:</em>
  23138. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23139. </p>
  23140. <p>
  23141. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  23142. </p>
  23143. <table>
  23144. <thead>
  23145. <tr>
  23146. <th>Field</th>
  23147. <th>Description</th>
  23148. </tr>
  23149. </thead>
  23150. <tbody>
  23151. <tr>
  23152. <td>
  23153. <code>host</code></br>
  23154. <em>
  23155. string
  23156. </em>
  23157. </td>
  23158. <td>
  23159. <p>URL configures the Password Depot instance URL.</p>
  23160. </td>
  23161. </tr>
  23162. <tr>
  23163. <td>
  23164. <code>database</code></br>
  23165. <em>
  23166. string
  23167. </em>
  23168. </td>
  23169. <td>
  23170. <p>Database to use as source</p>
  23171. </td>
  23172. </tr>
  23173. <tr>
  23174. <td>
  23175. <code>auth</code></br>
  23176. <em>
  23177. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">
  23178. PasswordDepotAuth
  23179. </a>
  23180. </em>
  23181. </td>
  23182. <td>
  23183. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  23184. </td>
  23185. </tr>
  23186. </tbody>
  23187. </table>
  23188. <h3 id="external-secrets.io/v1beta1.PasswordDepotSecretRef">PasswordDepotSecretRef
  23189. </h3>
  23190. <p>
  23191. (<em>Appears on:</em>
  23192. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth</a>)
  23193. </p>
  23194. <p>
  23195. <p>PasswordDepotSecretRef defines a reference to a secret containing credentials for the Password Depot provider.</p>
  23196. </p>
  23197. <table>
  23198. <thead>
  23199. <tr>
  23200. <th>Field</th>
  23201. <th>Description</th>
  23202. </tr>
  23203. </thead>
  23204. <tbody>
  23205. <tr>
  23206. <td>
  23207. <code>credentials</code></br>
  23208. <em>
  23209. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23210. External Secrets meta/v1.SecretKeySelector
  23211. </a>
  23212. </em>
  23213. </td>
  23214. <td>
  23215. <em>(Optional)</em>
  23216. <p>Username / Password is used for authentication.</p>
  23217. </td>
  23218. </tr>
  23219. </tbody>
  23220. </table>
  23221. <h3 id="external-secrets.io/v1beta1.PreviderAuth">PreviderAuth
  23222. </h3>
  23223. <p>
  23224. (<em>Appears on:</em>
  23225. <a href="#external-secrets.io/v1beta1.PreviderProvider">PreviderProvider</a>)
  23226. </p>
  23227. <p>
  23228. <p>PreviderAuth contains a secretRef for credentials.</p>
  23229. </p>
  23230. <table>
  23231. <thead>
  23232. <tr>
  23233. <th>Field</th>
  23234. <th>Description</th>
  23235. </tr>
  23236. </thead>
  23237. <tbody>
  23238. <tr>
  23239. <td>
  23240. <code>secretRef</code></br>
  23241. <em>
  23242. <a href="#external-secrets.io/v1beta1.PreviderAuthSecretRef">
  23243. PreviderAuthSecretRef
  23244. </a>
  23245. </em>
  23246. </td>
  23247. <td>
  23248. <em>(Optional)</em>
  23249. </td>
  23250. </tr>
  23251. </tbody>
  23252. </table>
  23253. <h3 id="external-secrets.io/v1beta1.PreviderAuthSecretRef">PreviderAuthSecretRef
  23254. </h3>
  23255. <p>
  23256. (<em>Appears on:</em>
  23257. <a href="#external-secrets.io/v1beta1.PreviderAuth">PreviderAuth</a>)
  23258. </p>
  23259. <p>
  23260. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  23261. </p>
  23262. <table>
  23263. <thead>
  23264. <tr>
  23265. <th>Field</th>
  23266. <th>Description</th>
  23267. </tr>
  23268. </thead>
  23269. <tbody>
  23270. <tr>
  23271. <td>
  23272. <code>accessToken</code></br>
  23273. <em>
  23274. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23275. External Secrets meta/v1.SecretKeySelector
  23276. </a>
  23277. </em>
  23278. </td>
  23279. <td>
  23280. <p>The AccessToken is used for authentication</p>
  23281. </td>
  23282. </tr>
  23283. </tbody>
  23284. </table>
  23285. <h3 id="external-secrets.io/v1beta1.PreviderProvider">PreviderProvider
  23286. </h3>
  23287. <p>
  23288. (<em>Appears on:</em>
  23289. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23290. </p>
  23291. <p>
  23292. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  23293. </p>
  23294. <table>
  23295. <thead>
  23296. <tr>
  23297. <th>Field</th>
  23298. <th>Description</th>
  23299. </tr>
  23300. </thead>
  23301. <tbody>
  23302. <tr>
  23303. <td>
  23304. <code>auth</code></br>
  23305. <em>
  23306. <a href="#external-secrets.io/v1beta1.PreviderAuth">
  23307. PreviderAuth
  23308. </a>
  23309. </em>
  23310. </td>
  23311. <td>
  23312. </td>
  23313. </tr>
  23314. <tr>
  23315. <td>
  23316. <code>baseUri</code></br>
  23317. <em>
  23318. string
  23319. </em>
  23320. </td>
  23321. <td>
  23322. <em>(Optional)</em>
  23323. </td>
  23324. </tr>
  23325. </tbody>
  23326. </table>
  23327. <h3 id="external-secrets.io/v1beta1.Provider">Provider
  23328. </h3>
  23329. <p>
  23330. <p>Provider is a common interface for interacting with secret backends.</p>
  23331. </p>
  23332. <h3 id="external-secrets.io/v1beta1.PulumiProvider">PulumiProvider
  23333. </h3>
  23334. <p>
  23335. (<em>Appears on:</em>
  23336. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23337. </p>
  23338. <p>
  23339. <p>PulumiProvider defines configuration for the Pulumi provider.</p>
  23340. </p>
  23341. <table>
  23342. <thead>
  23343. <tr>
  23344. <th>Field</th>
  23345. <th>Description</th>
  23346. </tr>
  23347. </thead>
  23348. <tbody>
  23349. <tr>
  23350. <td>
  23351. <code>apiUrl</code></br>
  23352. <em>
  23353. string
  23354. </em>
  23355. </td>
  23356. <td>
  23357. <p>APIURL is the URL of the Pulumi API.</p>
  23358. </td>
  23359. </tr>
  23360. <tr>
  23361. <td>
  23362. <code>accessToken</code></br>
  23363. <em>
  23364. <a href="#external-secrets.io/v1beta1.PulumiProviderSecretRef">
  23365. PulumiProviderSecretRef
  23366. </a>
  23367. </em>
  23368. </td>
  23369. <td>
  23370. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  23371. </td>
  23372. </tr>
  23373. <tr>
  23374. <td>
  23375. <code>organization</code></br>
  23376. <em>
  23377. string
  23378. </em>
  23379. </td>
  23380. <td>
  23381. <p>Organization are a space to collaborate on shared projects and stacks.
  23382. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  23383. </td>
  23384. </tr>
  23385. <tr>
  23386. <td>
  23387. <code>project</code></br>
  23388. <em>
  23389. string
  23390. </em>
  23391. </td>
  23392. <td>
  23393. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  23394. </td>
  23395. </tr>
  23396. <tr>
  23397. <td>
  23398. <code>environment</code></br>
  23399. <em>
  23400. string
  23401. </em>
  23402. </td>
  23403. <td>
  23404. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  23405. dynamically retrieved values from supported providers including all major clouds,
  23406. and other Pulumi ESC environments.
  23407. 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>
  23408. </td>
  23409. </tr>
  23410. </tbody>
  23411. </table>
  23412. <h3 id="external-secrets.io/v1beta1.PulumiProviderSecretRef">PulumiProviderSecretRef
  23413. </h3>
  23414. <p>
  23415. (<em>Appears on:</em>
  23416. <a href="#external-secrets.io/v1beta1.PulumiProvider">PulumiProvider</a>)
  23417. </p>
  23418. <p>
  23419. <p>PulumiProviderSecretRef defines a reference to a secret containing credentials for the Pulumi provider.</p>
  23420. </p>
  23421. <table>
  23422. <thead>
  23423. <tr>
  23424. <th>Field</th>
  23425. <th>Description</th>
  23426. </tr>
  23427. </thead>
  23428. <tbody>
  23429. <tr>
  23430. <td>
  23431. <code>secretRef</code></br>
  23432. <em>
  23433. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23434. External Secrets meta/v1.SecretKeySelector
  23435. </a>
  23436. </em>
  23437. </td>
  23438. <td>
  23439. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  23440. </td>
  23441. </tr>
  23442. </tbody>
  23443. </table>
  23444. <h3 id="external-secrets.io/v1beta1.PushSecretData">PushSecretData
  23445. </h3>
  23446. <p>
  23447. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1beta1.</p>
  23448. </p>
  23449. <h3 id="external-secrets.io/v1beta1.PushSecretRemoteRef">PushSecretRemoteRef
  23450. </h3>
  23451. <p>
  23452. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1beta1.</p>
  23453. </p>
  23454. <h3 id="external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider
  23455. </h3>
  23456. <p>
  23457. (<em>Appears on:</em>
  23458. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23459. </p>
  23460. <p>
  23461. <p>ScalewayProvider defines configuration for the Scaleway provider.</p>
  23462. </p>
  23463. <table>
  23464. <thead>
  23465. <tr>
  23466. <th>Field</th>
  23467. <th>Description</th>
  23468. </tr>
  23469. </thead>
  23470. <tbody>
  23471. <tr>
  23472. <td>
  23473. <code>apiUrl</code></br>
  23474. <em>
  23475. string
  23476. </em>
  23477. </td>
  23478. <td>
  23479. <em>(Optional)</em>
  23480. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  23481. </td>
  23482. </tr>
  23483. <tr>
  23484. <td>
  23485. <code>region</code></br>
  23486. <em>
  23487. string
  23488. </em>
  23489. </td>
  23490. <td>
  23491. <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>
  23492. </td>
  23493. </tr>
  23494. <tr>
  23495. <td>
  23496. <code>projectId</code></br>
  23497. <em>
  23498. string
  23499. </em>
  23500. </td>
  23501. <td>
  23502. <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>
  23503. </td>
  23504. </tr>
  23505. <tr>
  23506. <td>
  23507. <code>accessKey</code></br>
  23508. <em>
  23509. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  23510. ScalewayProviderSecretRef
  23511. </a>
  23512. </em>
  23513. </td>
  23514. <td>
  23515. <p>AccessKey is the non-secret part of the api key.</p>
  23516. </td>
  23517. </tr>
  23518. <tr>
  23519. <td>
  23520. <code>secretKey</code></br>
  23521. <em>
  23522. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  23523. ScalewayProviderSecretRef
  23524. </a>
  23525. </em>
  23526. </td>
  23527. <td>
  23528. <p>SecretKey is the non-secret part of the api key.</p>
  23529. </td>
  23530. </tr>
  23531. </tbody>
  23532. </table>
  23533. <h3 id="external-secrets.io/v1beta1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  23534. </h3>
  23535. <p>
  23536. (<em>Appears on:</em>
  23537. <a href="#external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider</a>)
  23538. </p>
  23539. <p>
  23540. <p>ScalewayProviderSecretRef defines a reference to a secret containing credentials for the Scaleway provider.</p>
  23541. </p>
  23542. <table>
  23543. <thead>
  23544. <tr>
  23545. <th>Field</th>
  23546. <th>Description</th>
  23547. </tr>
  23548. </thead>
  23549. <tbody>
  23550. <tr>
  23551. <td>
  23552. <code>value</code></br>
  23553. <em>
  23554. string
  23555. </em>
  23556. </td>
  23557. <td>
  23558. <em>(Optional)</em>
  23559. <p>Value can be specified directly to set a value without using a secret.</p>
  23560. </td>
  23561. </tr>
  23562. <tr>
  23563. <td>
  23564. <code>secretRef</code></br>
  23565. <em>
  23566. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23567. External Secrets meta/v1.SecretKeySelector
  23568. </a>
  23569. </em>
  23570. </td>
  23571. <td>
  23572. <em>(Optional)</em>
  23573. <p>SecretRef references a key in a secret that will be used as value.</p>
  23574. </td>
  23575. </tr>
  23576. </tbody>
  23577. </table>
  23578. <h3 id="external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider
  23579. </h3>
  23580. <p>
  23581. (<em>Appears on:</em>
  23582. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23583. </p>
  23584. <p>
  23585. <p>SecretServerProvider defines configuration for the Delinea Secret Server provider.
  23586. 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>
  23587. </p>
  23588. <table>
  23589. <thead>
  23590. <tr>
  23591. <th>Field</th>
  23592. <th>Description</th>
  23593. </tr>
  23594. </thead>
  23595. <tbody>
  23596. <tr>
  23597. <td>
  23598. <code>username</code></br>
  23599. <em>
  23600. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  23601. SecretServerProviderRef
  23602. </a>
  23603. </em>
  23604. </td>
  23605. <td>
  23606. <p>Username is the secret server account username.</p>
  23607. </td>
  23608. </tr>
  23609. <tr>
  23610. <td>
  23611. <code>password</code></br>
  23612. <em>
  23613. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  23614. SecretServerProviderRef
  23615. </a>
  23616. </em>
  23617. </td>
  23618. <td>
  23619. <p>Password is the secret server account password.</p>
  23620. </td>
  23621. </tr>
  23622. <tr>
  23623. <td>
  23624. <code>serverURL</code></br>
  23625. <em>
  23626. string
  23627. </em>
  23628. </td>
  23629. <td>
  23630. <p>ServerURL
  23631. URL to your secret server installation</p>
  23632. </td>
  23633. </tr>
  23634. </tbody>
  23635. </table>
  23636. <h3 id="external-secrets.io/v1beta1.SecretServerProviderRef">SecretServerProviderRef
  23637. </h3>
  23638. <p>
  23639. (<em>Appears on:</em>
  23640. <a href="#external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider</a>)
  23641. </p>
  23642. <p>
  23643. <p>SecretServerProviderRef defines a reference to a secret containing credentials for the Secret Server provider.</p>
  23644. </p>
  23645. <table>
  23646. <thead>
  23647. <tr>
  23648. <th>Field</th>
  23649. <th>Description</th>
  23650. </tr>
  23651. </thead>
  23652. <tbody>
  23653. <tr>
  23654. <td>
  23655. <code>value</code></br>
  23656. <em>
  23657. string
  23658. </em>
  23659. </td>
  23660. <td>
  23661. <em>(Optional)</em>
  23662. <p>Value can be specified directly to set a value without using a secret.</p>
  23663. </td>
  23664. </tr>
  23665. <tr>
  23666. <td>
  23667. <code>secretRef</code></br>
  23668. <em>
  23669. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23670. External Secrets meta/v1.SecretKeySelector
  23671. </a>
  23672. </em>
  23673. </td>
  23674. <td>
  23675. <em>(Optional)</em>
  23676. <p>SecretRef references a key in a secret that will be used as value.</p>
  23677. </td>
  23678. </tr>
  23679. </tbody>
  23680. </table>
  23681. <h3 id="external-secrets.io/v1beta1.SecretStore">SecretStore
  23682. </h3>
  23683. <p>
  23684. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  23685. </p>
  23686. <table>
  23687. <thead>
  23688. <tr>
  23689. <th>Field</th>
  23690. <th>Description</th>
  23691. </tr>
  23692. </thead>
  23693. <tbody>
  23694. <tr>
  23695. <td>
  23696. <code>metadata</code></br>
  23697. <em>
  23698. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  23699. Kubernetes meta/v1.ObjectMeta
  23700. </a>
  23701. </em>
  23702. </td>
  23703. <td>
  23704. Refer to the Kubernetes API documentation for the fields of the
  23705. <code>metadata</code> field.
  23706. </td>
  23707. </tr>
  23708. <tr>
  23709. <td>
  23710. <code>spec</code></br>
  23711. <em>
  23712. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  23713. SecretStoreSpec
  23714. </a>
  23715. </em>
  23716. </td>
  23717. <td>
  23718. <br/>
  23719. <br/>
  23720. <table>
  23721. <tr>
  23722. <td>
  23723. <code>controller</code></br>
  23724. <em>
  23725. string
  23726. </em>
  23727. </td>
  23728. <td>
  23729. <em>(Optional)</em>
  23730. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  23731. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  23732. </td>
  23733. </tr>
  23734. <tr>
  23735. <td>
  23736. <code>provider</code></br>
  23737. <em>
  23738. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  23739. SecretStoreProvider
  23740. </a>
  23741. </em>
  23742. </td>
  23743. <td>
  23744. <p>Used to configure the provider. Only one provider may be set</p>
  23745. </td>
  23746. </tr>
  23747. <tr>
  23748. <td>
  23749. <code>retrySettings</code></br>
  23750. <em>
  23751. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  23752. SecretStoreRetrySettings
  23753. </a>
  23754. </em>
  23755. </td>
  23756. <td>
  23757. <em>(Optional)</em>
  23758. <p>Used to configure HTTP retries on failures.</p>
  23759. </td>
  23760. </tr>
  23761. <tr>
  23762. <td>
  23763. <code>refreshInterval</code></br>
  23764. <em>
  23765. int
  23766. </em>
  23767. </td>
  23768. <td>
  23769. <em>(Optional)</em>
  23770. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  23771. </td>
  23772. </tr>
  23773. <tr>
  23774. <td>
  23775. <code>conditions</code></br>
  23776. <em>
  23777. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  23778. []ClusterSecretStoreCondition
  23779. </a>
  23780. </em>
  23781. </td>
  23782. <td>
  23783. <em>(Optional)</em>
  23784. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  23785. </td>
  23786. </tr>
  23787. </table>
  23788. </td>
  23789. </tr>
  23790. <tr>
  23791. <td>
  23792. <code>status</code></br>
  23793. <em>
  23794. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  23795. SecretStoreStatus
  23796. </a>
  23797. </em>
  23798. </td>
  23799. <td>
  23800. </td>
  23801. </tr>
  23802. </tbody>
  23803. </table>
  23804. <h3 id="external-secrets.io/v1beta1.SecretStoreCapabilities">SecretStoreCapabilities
  23805. (<code>string</code> alias)</p></h3>
  23806. <p>
  23807. (<em>Appears on:</em>
  23808. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  23809. </p>
  23810. <p>
  23811. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  23812. </p>
  23813. <table>
  23814. <thead>
  23815. <tr>
  23816. <th>Value</th>
  23817. <th>Description</th>
  23818. </tr>
  23819. </thead>
  23820. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  23821. <td><p>SecretStoreReadOnly indicates that the SecretStore only supports reading secrets.</p>
  23822. </td>
  23823. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  23824. <td><p>SecretStoreReadWrite indicates that the SecretStore supports both reading and writing secrets.</p>
  23825. </td>
  23826. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  23827. <td><p>SecretStoreWriteOnly indicates that the SecretStore only supports writing secrets.</p>
  23828. </td>
  23829. </tr></tbody>
  23830. </table>
  23831. <h3 id="external-secrets.io/v1beta1.SecretStoreConditionType">SecretStoreConditionType
  23832. (<code>string</code> alias)</p></h3>
  23833. <p>
  23834. (<em>Appears on:</em>
  23835. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  23836. </p>
  23837. <p>
  23838. <p>SecretStoreConditionType represents the condition type of the SecretStore.</p>
  23839. </p>
  23840. <table>
  23841. <thead>
  23842. <tr>
  23843. <th>Value</th>
  23844. <th>Description</th>
  23845. </tr>
  23846. </thead>
  23847. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  23848. <td><p>SecretStoreReady indicates that the SecretStore has been successfully configured.</p>
  23849. </td>
  23850. </tr></tbody>
  23851. </table>
  23852. <h3 id="external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider
  23853. </h3>
  23854. <p>
  23855. (<em>Appears on:</em>
  23856. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  23857. </p>
  23858. <p>
  23859. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  23860. </p>
  23861. <table>
  23862. <thead>
  23863. <tr>
  23864. <th>Field</th>
  23865. <th>Description</th>
  23866. </tr>
  23867. </thead>
  23868. <tbody>
  23869. <tr>
  23870. <td>
  23871. <code>aws</code></br>
  23872. <em>
  23873. <a href="#external-secrets.io/v1beta1.AWSProvider">
  23874. AWSProvider
  23875. </a>
  23876. </em>
  23877. </td>
  23878. <td>
  23879. <em>(Optional)</em>
  23880. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  23881. </td>
  23882. </tr>
  23883. <tr>
  23884. <td>
  23885. <code>azurekv</code></br>
  23886. <em>
  23887. <a href="#external-secrets.io/v1beta1.AzureKVProvider">
  23888. AzureKVProvider
  23889. </a>
  23890. </em>
  23891. </td>
  23892. <td>
  23893. <em>(Optional)</em>
  23894. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  23895. </td>
  23896. </tr>
  23897. <tr>
  23898. <td>
  23899. <code>akeyless</code></br>
  23900. <em>
  23901. <a href="#external-secrets.io/v1beta1.AkeylessProvider">
  23902. AkeylessProvider
  23903. </a>
  23904. </em>
  23905. </td>
  23906. <td>
  23907. <em>(Optional)</em>
  23908. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  23909. </td>
  23910. </tr>
  23911. <tr>
  23912. <td>
  23913. <code>bitwardensecretsmanager</code></br>
  23914. <em>
  23915. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">
  23916. BitwardenSecretsManagerProvider
  23917. </a>
  23918. </em>
  23919. </td>
  23920. <td>
  23921. <em>(Optional)</em>
  23922. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  23923. </td>
  23924. </tr>
  23925. <tr>
  23926. <td>
  23927. <code>vault</code></br>
  23928. <em>
  23929. <a href="#external-secrets.io/v1beta1.VaultProvider">
  23930. VaultProvider
  23931. </a>
  23932. </em>
  23933. </td>
  23934. <td>
  23935. <em>(Optional)</em>
  23936. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  23937. </td>
  23938. </tr>
  23939. <tr>
  23940. <td>
  23941. <code>gcpsm</code></br>
  23942. <em>
  23943. <a href="#external-secrets.io/v1beta1.GCPSMProvider">
  23944. GCPSMProvider
  23945. </a>
  23946. </em>
  23947. </td>
  23948. <td>
  23949. <em>(Optional)</em>
  23950. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  23951. </td>
  23952. </tr>
  23953. <tr>
  23954. <td>
  23955. <code>oracle</code></br>
  23956. <em>
  23957. <a href="#external-secrets.io/v1beta1.OracleProvider">
  23958. OracleProvider
  23959. </a>
  23960. </em>
  23961. </td>
  23962. <td>
  23963. <em>(Optional)</em>
  23964. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  23965. </td>
  23966. </tr>
  23967. <tr>
  23968. <td>
  23969. <code>ibm</code></br>
  23970. <em>
  23971. <a href="#external-secrets.io/v1beta1.IBMProvider">
  23972. IBMProvider
  23973. </a>
  23974. </em>
  23975. </td>
  23976. <td>
  23977. <em>(Optional)</em>
  23978. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  23979. </td>
  23980. </tr>
  23981. <tr>
  23982. <td>
  23983. <code>yandexcertificatemanager</code></br>
  23984. <em>
  23985. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">
  23986. YandexCertificateManagerProvider
  23987. </a>
  23988. </em>
  23989. </td>
  23990. <td>
  23991. <em>(Optional)</em>
  23992. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  23993. </td>
  23994. </tr>
  23995. <tr>
  23996. <td>
  23997. <code>yandexlockbox</code></br>
  23998. <em>
  23999. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">
  24000. YandexLockboxProvider
  24001. </a>
  24002. </em>
  24003. </td>
  24004. <td>
  24005. <em>(Optional)</em>
  24006. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  24007. </td>
  24008. </tr>
  24009. <tr>
  24010. <td>
  24011. <code>github</code></br>
  24012. <em>
  24013. <a href="#external-secrets.io/v1beta1.GithubProvider">
  24014. GithubProvider
  24015. </a>
  24016. </em>
  24017. </td>
  24018. <td>
  24019. <em>(Optional)</em>
  24020. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.</p>
  24021. </td>
  24022. </tr>
  24023. <tr>
  24024. <td>
  24025. <code>gitlab</code></br>
  24026. <em>
  24027. <a href="#external-secrets.io/v1beta1.GitlabProvider">
  24028. GitlabProvider
  24029. </a>
  24030. </em>
  24031. </td>
  24032. <td>
  24033. <em>(Optional)</em>
  24034. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  24035. </td>
  24036. </tr>
  24037. <tr>
  24038. <td>
  24039. <code>alibaba</code></br>
  24040. <em>
  24041. <a href="#external-secrets.io/v1beta1.AlibabaProvider">
  24042. AlibabaProvider
  24043. </a>
  24044. </em>
  24045. </td>
  24046. <td>
  24047. <em>(Optional)</em>
  24048. <p>Alibaba configures this store to sync secrets using Alibaba Cloud provider</p>
  24049. </td>
  24050. </tr>
  24051. <tr>
  24052. <td>
  24053. <code>onepassword</code></br>
  24054. <em>
  24055. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">
  24056. OnePasswordProvider
  24057. </a>
  24058. </em>
  24059. </td>
  24060. <td>
  24061. <em>(Optional)</em>
  24062. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  24063. </td>
  24064. </tr>
  24065. <tr>
  24066. <td>
  24067. <code>webhook</code></br>
  24068. <em>
  24069. <a href="#external-secrets.io/v1beta1.WebhookProvider">
  24070. WebhookProvider
  24071. </a>
  24072. </em>
  24073. </td>
  24074. <td>
  24075. <em>(Optional)</em>
  24076. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  24077. </td>
  24078. </tr>
  24079. <tr>
  24080. <td>
  24081. <code>kubernetes</code></br>
  24082. <em>
  24083. <a href="#external-secrets.io/v1beta1.KubernetesProvider">
  24084. KubernetesProvider
  24085. </a>
  24086. </em>
  24087. </td>
  24088. <td>
  24089. <em>(Optional)</em>
  24090. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  24091. </td>
  24092. </tr>
  24093. <tr>
  24094. <td>
  24095. <code>fake</code></br>
  24096. <em>
  24097. <a href="#external-secrets.io/v1beta1.FakeProvider">
  24098. FakeProvider
  24099. </a>
  24100. </em>
  24101. </td>
  24102. <td>
  24103. <em>(Optional)</em>
  24104. <p>Fake configures a store with static key/value pairs</p>
  24105. </td>
  24106. </tr>
  24107. <tr>
  24108. <td>
  24109. <code>senhasegura</code></br>
  24110. <em>
  24111. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">
  24112. SenhaseguraProvider
  24113. </a>
  24114. </em>
  24115. </td>
  24116. <td>
  24117. <em>(Optional)</em>
  24118. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  24119. </td>
  24120. </tr>
  24121. <tr>
  24122. <td>
  24123. <code>scaleway</code></br>
  24124. <em>
  24125. <a href="#external-secrets.io/v1beta1.ScalewayProvider">
  24126. ScalewayProvider
  24127. </a>
  24128. </em>
  24129. </td>
  24130. <td>
  24131. <em>(Optional)</em>
  24132. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  24133. </td>
  24134. </tr>
  24135. <tr>
  24136. <td>
  24137. <code>doppler</code></br>
  24138. <em>
  24139. <a href="#external-secrets.io/v1beta1.DopplerProvider">
  24140. DopplerProvider
  24141. </a>
  24142. </em>
  24143. </td>
  24144. <td>
  24145. <em>(Optional)</em>
  24146. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  24147. </td>
  24148. </tr>
  24149. <tr>
  24150. <td>
  24151. <code>previder</code></br>
  24152. <em>
  24153. <a href="#external-secrets.io/v1beta1.PreviderProvider">
  24154. PreviderProvider
  24155. </a>
  24156. </em>
  24157. </td>
  24158. <td>
  24159. <em>(Optional)</em>
  24160. <p>Previder configures this store to sync secrets using the Previder provider</p>
  24161. </td>
  24162. </tr>
  24163. <tr>
  24164. <td>
  24165. <code>onboardbase</code></br>
  24166. <em>
  24167. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">
  24168. OnboardbaseProvider
  24169. </a>
  24170. </em>
  24171. </td>
  24172. <td>
  24173. <em>(Optional)</em>
  24174. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  24175. </td>
  24176. </tr>
  24177. <tr>
  24178. <td>
  24179. <code>keepersecurity</code></br>
  24180. <em>
  24181. <a href="#external-secrets.io/v1beta1.KeeperSecurityProvider">
  24182. KeeperSecurityProvider
  24183. </a>
  24184. </em>
  24185. </td>
  24186. <td>
  24187. <em>(Optional)</em>
  24188. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  24189. </td>
  24190. </tr>
  24191. <tr>
  24192. <td>
  24193. <code>conjur</code></br>
  24194. <em>
  24195. <a href="#external-secrets.io/v1beta1.ConjurProvider">
  24196. ConjurProvider
  24197. </a>
  24198. </em>
  24199. </td>
  24200. <td>
  24201. <em>(Optional)</em>
  24202. <p>Conjur configures this store to sync secrets using conjur provider</p>
  24203. </td>
  24204. </tr>
  24205. <tr>
  24206. <td>
  24207. <code>delinea</code></br>
  24208. <em>
  24209. <a href="#external-secrets.io/v1beta1.DelineaProvider">
  24210. DelineaProvider
  24211. </a>
  24212. </em>
  24213. </td>
  24214. <td>
  24215. <em>(Optional)</em>
  24216. <p>Delinea DevOps Secrets Vault
  24217. <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>
  24218. </td>
  24219. </tr>
  24220. <tr>
  24221. <td>
  24222. <code>secretserver</code></br>
  24223. <em>
  24224. <a href="#external-secrets.io/v1beta1.SecretServerProvider">
  24225. SecretServerProvider
  24226. </a>
  24227. </em>
  24228. </td>
  24229. <td>
  24230. <em>(Optional)</em>
  24231. <p>SecretServer configures this store to sync secrets using SecretServer provider
  24232. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  24233. </td>
  24234. </tr>
  24235. <tr>
  24236. <td>
  24237. <code>chef</code></br>
  24238. <em>
  24239. <a href="#external-secrets.io/v1beta1.ChefProvider">
  24240. ChefProvider
  24241. </a>
  24242. </em>
  24243. </td>
  24244. <td>
  24245. <em>(Optional)</em>
  24246. <p>Chef configures this store to sync secrets with chef server</p>
  24247. </td>
  24248. </tr>
  24249. <tr>
  24250. <td>
  24251. <code>pulumi</code></br>
  24252. <em>
  24253. <a href="#external-secrets.io/v1beta1.PulumiProvider">
  24254. PulumiProvider
  24255. </a>
  24256. </em>
  24257. </td>
  24258. <td>
  24259. <em>(Optional)</em>
  24260. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  24261. </td>
  24262. </tr>
  24263. <tr>
  24264. <td>
  24265. <code>fortanix</code></br>
  24266. <em>
  24267. <a href="#external-secrets.io/v1beta1.FortanixProvider">
  24268. FortanixProvider
  24269. </a>
  24270. </em>
  24271. </td>
  24272. <td>
  24273. <em>(Optional)</em>
  24274. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  24275. </td>
  24276. </tr>
  24277. <tr>
  24278. <td>
  24279. <code>passworddepot</code></br>
  24280. <em>
  24281. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">
  24282. PasswordDepotProvider
  24283. </a>
  24284. </em>
  24285. </td>
  24286. <td>
  24287. <em>(Optional)</em>
  24288. </td>
  24289. </tr>
  24290. <tr>
  24291. <td>
  24292. <code>passbolt</code></br>
  24293. <em>
  24294. <a href="#external-secrets.io/v1beta1.PassboltProvider">
  24295. PassboltProvider
  24296. </a>
  24297. </em>
  24298. </td>
  24299. <td>
  24300. <em>(Optional)</em>
  24301. </td>
  24302. </tr>
  24303. <tr>
  24304. <td>
  24305. <code>device42</code></br>
  24306. <em>
  24307. <a href="#external-secrets.io/v1beta1.Device42Provider">
  24308. Device42Provider
  24309. </a>
  24310. </em>
  24311. </td>
  24312. <td>
  24313. <em>(Optional)</em>
  24314. <p>Device42 configures this store to sync secrets using the Device42 provider</p>
  24315. </td>
  24316. </tr>
  24317. <tr>
  24318. <td>
  24319. <code>infisical</code></br>
  24320. <em>
  24321. <a href="#external-secrets.io/v1beta1.InfisicalProvider">
  24322. InfisicalProvider
  24323. </a>
  24324. </em>
  24325. </td>
  24326. <td>
  24327. <em>(Optional)</em>
  24328. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  24329. </td>
  24330. </tr>
  24331. <tr>
  24332. <td>
  24333. <code>beyondtrust</code></br>
  24334. <em>
  24335. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">
  24336. BeyondtrustProvider
  24337. </a>
  24338. </em>
  24339. </td>
  24340. <td>
  24341. <em>(Optional)</em>
  24342. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  24343. </td>
  24344. </tr>
  24345. <tr>
  24346. <td>
  24347. <code>cloudrusm</code></br>
  24348. <em>
  24349. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">
  24350. CloudruSMProvider
  24351. </a>
  24352. </em>
  24353. </td>
  24354. <td>
  24355. <em>(Optional)</em>
  24356. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  24357. </td>
  24358. </tr>
  24359. </tbody>
  24360. </table>
  24361. <h3 id="external-secrets.io/v1beta1.SecretStoreRef">SecretStoreRef
  24362. </h3>
  24363. <p>
  24364. (<em>Appears on:</em>
  24365. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>,
  24366. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  24367. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  24368. </p>
  24369. <p>
  24370. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  24371. </p>
  24372. <table>
  24373. <thead>
  24374. <tr>
  24375. <th>Field</th>
  24376. <th>Description</th>
  24377. </tr>
  24378. </thead>
  24379. <tbody>
  24380. <tr>
  24381. <td>
  24382. <code>name</code></br>
  24383. <em>
  24384. string
  24385. </em>
  24386. </td>
  24387. <td>
  24388. <p>Name of the SecretStore resource</p>
  24389. </td>
  24390. </tr>
  24391. <tr>
  24392. <td>
  24393. <code>kind</code></br>
  24394. <em>
  24395. string
  24396. </em>
  24397. </td>
  24398. <td>
  24399. <em>(Optional)</em>
  24400. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  24401. Defaults to <code>SecretStore</code></p>
  24402. </td>
  24403. </tr>
  24404. </tbody>
  24405. </table>
  24406. <h3 id="external-secrets.io/v1beta1.SecretStoreRetrySettings">SecretStoreRetrySettings
  24407. </h3>
  24408. <p>
  24409. (<em>Appears on:</em>
  24410. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  24411. </p>
  24412. <p>
  24413. <p>SecretStoreRetrySettings defines configuration for retrying failed requests to the provider.</p>
  24414. </p>
  24415. <table>
  24416. <thead>
  24417. <tr>
  24418. <th>Field</th>
  24419. <th>Description</th>
  24420. </tr>
  24421. </thead>
  24422. <tbody>
  24423. <tr>
  24424. <td>
  24425. <code>maxRetries</code></br>
  24426. <em>
  24427. int32
  24428. </em>
  24429. </td>
  24430. <td>
  24431. <p>MaxRetries is the maximum number of retry attempts.</p>
  24432. </td>
  24433. </tr>
  24434. <tr>
  24435. <td>
  24436. <code>retryInterval</code></br>
  24437. <em>
  24438. string
  24439. </em>
  24440. </td>
  24441. <td>
  24442. <p>RetryInterval is the interval between retry attempts.</p>
  24443. </td>
  24444. </tr>
  24445. </tbody>
  24446. </table>
  24447. <h3 id="external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec
  24448. </h3>
  24449. <p>
  24450. (<em>Appears on:</em>
  24451. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  24452. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  24453. </p>
  24454. <p>
  24455. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  24456. </p>
  24457. <table>
  24458. <thead>
  24459. <tr>
  24460. <th>Field</th>
  24461. <th>Description</th>
  24462. </tr>
  24463. </thead>
  24464. <tbody>
  24465. <tr>
  24466. <td>
  24467. <code>controller</code></br>
  24468. <em>
  24469. string
  24470. </em>
  24471. </td>
  24472. <td>
  24473. <em>(Optional)</em>
  24474. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  24475. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  24476. </td>
  24477. </tr>
  24478. <tr>
  24479. <td>
  24480. <code>provider</code></br>
  24481. <em>
  24482. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  24483. SecretStoreProvider
  24484. </a>
  24485. </em>
  24486. </td>
  24487. <td>
  24488. <p>Used to configure the provider. Only one provider may be set</p>
  24489. </td>
  24490. </tr>
  24491. <tr>
  24492. <td>
  24493. <code>retrySettings</code></br>
  24494. <em>
  24495. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  24496. SecretStoreRetrySettings
  24497. </a>
  24498. </em>
  24499. </td>
  24500. <td>
  24501. <em>(Optional)</em>
  24502. <p>Used to configure HTTP retries on failures.</p>
  24503. </td>
  24504. </tr>
  24505. <tr>
  24506. <td>
  24507. <code>refreshInterval</code></br>
  24508. <em>
  24509. int
  24510. </em>
  24511. </td>
  24512. <td>
  24513. <em>(Optional)</em>
  24514. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  24515. </td>
  24516. </tr>
  24517. <tr>
  24518. <td>
  24519. <code>conditions</code></br>
  24520. <em>
  24521. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  24522. []ClusterSecretStoreCondition
  24523. </a>
  24524. </em>
  24525. </td>
  24526. <td>
  24527. <em>(Optional)</em>
  24528. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  24529. </td>
  24530. </tr>
  24531. </tbody>
  24532. </table>
  24533. <h3 id="external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus
  24534. </h3>
  24535. <p>
  24536. (<em>Appears on:</em>
  24537. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  24538. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  24539. </p>
  24540. <p>
  24541. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  24542. </p>
  24543. <table>
  24544. <thead>
  24545. <tr>
  24546. <th>Field</th>
  24547. <th>Description</th>
  24548. </tr>
  24549. </thead>
  24550. <tbody>
  24551. <tr>
  24552. <td>
  24553. <code>conditions</code></br>
  24554. <em>
  24555. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">
  24556. []SecretStoreStatusCondition
  24557. </a>
  24558. </em>
  24559. </td>
  24560. <td>
  24561. <em>(Optional)</em>
  24562. </td>
  24563. </tr>
  24564. <tr>
  24565. <td>
  24566. <code>capabilities</code></br>
  24567. <em>
  24568. <a href="#external-secrets.io/v1beta1.SecretStoreCapabilities">
  24569. SecretStoreCapabilities
  24570. </a>
  24571. </em>
  24572. </td>
  24573. <td>
  24574. <em>(Optional)</em>
  24575. </td>
  24576. </tr>
  24577. </tbody>
  24578. </table>
  24579. <h3 id="external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition
  24580. </h3>
  24581. <p>
  24582. (<em>Appears on:</em>
  24583. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  24584. </p>
  24585. <p>
  24586. <p>SecretStoreStatusCondition defines the observed condition of the SecretStore.</p>
  24587. </p>
  24588. <table>
  24589. <thead>
  24590. <tr>
  24591. <th>Field</th>
  24592. <th>Description</th>
  24593. </tr>
  24594. </thead>
  24595. <tbody>
  24596. <tr>
  24597. <td>
  24598. <code>type</code></br>
  24599. <em>
  24600. <a href="#external-secrets.io/v1beta1.SecretStoreConditionType">
  24601. SecretStoreConditionType
  24602. </a>
  24603. </em>
  24604. </td>
  24605. <td>
  24606. </td>
  24607. </tr>
  24608. <tr>
  24609. <td>
  24610. <code>status</code></br>
  24611. <em>
  24612. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  24613. Kubernetes core/v1.ConditionStatus
  24614. </a>
  24615. </em>
  24616. </td>
  24617. <td>
  24618. </td>
  24619. </tr>
  24620. <tr>
  24621. <td>
  24622. <code>reason</code></br>
  24623. <em>
  24624. string
  24625. </em>
  24626. </td>
  24627. <td>
  24628. <em>(Optional)</em>
  24629. </td>
  24630. </tr>
  24631. <tr>
  24632. <td>
  24633. <code>message</code></br>
  24634. <em>
  24635. string
  24636. </em>
  24637. </td>
  24638. <td>
  24639. <em>(Optional)</em>
  24640. </td>
  24641. </tr>
  24642. <tr>
  24643. <td>
  24644. <code>lastTransitionTime</code></br>
  24645. <em>
  24646. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  24647. Kubernetes meta/v1.Time
  24648. </a>
  24649. </em>
  24650. </td>
  24651. <td>
  24652. <em>(Optional)</em>
  24653. </td>
  24654. </tr>
  24655. </tbody>
  24656. </table>
  24657. <h3 id="external-secrets.io/v1beta1.SecretsClient">SecretsClient
  24658. </h3>
  24659. <p>
  24660. <p>SecretsClient provides access to secrets.</p>
  24661. </p>
  24662. <h3 id="external-secrets.io/v1beta1.SecretsManager">SecretsManager
  24663. </h3>
  24664. <p>
  24665. (<em>Appears on:</em>
  24666. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  24667. </p>
  24668. <p>
  24669. <p>SecretsManager defines how the provider behaves when interacting with AWS
  24670. SecretsManager. Some of these settings are only applicable to controlling how
  24671. secrets are deleted, and hence only apply to PushSecret (and only when
  24672. deletionPolicy is set to Delete).</p>
  24673. </p>
  24674. <table>
  24675. <thead>
  24676. <tr>
  24677. <th>Field</th>
  24678. <th>Description</th>
  24679. </tr>
  24680. </thead>
  24681. <tbody>
  24682. <tr>
  24683. <td>
  24684. <code>forceDeleteWithoutRecovery</code></br>
  24685. <em>
  24686. bool
  24687. </em>
  24688. </td>
  24689. <td>
  24690. <em>(Optional)</em>
  24691. <p>Specifies whether to delete the secret without any recovery window. You
  24692. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  24693. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  24694. recovery window.
  24695. 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>
  24696. </td>
  24697. </tr>
  24698. <tr>
  24699. <td>
  24700. <code>recoveryWindowInDays</code></br>
  24701. <em>
  24702. int64
  24703. </em>
  24704. </td>
  24705. <td>
  24706. <em>(Optional)</em>
  24707. <p>The number of days from 7 to 30 that Secrets Manager waits before
  24708. permanently deleting the secret. You can&rsquo;t use both this parameter and
  24709. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  24710. then by default Secrets Manager uses a 30 day recovery window.
  24711. 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>
  24712. </td>
  24713. </tr>
  24714. </tbody>
  24715. </table>
  24716. <h3 id="external-secrets.io/v1beta1.SenhaseguraAuth">SenhaseguraAuth
  24717. </h3>
  24718. <p>
  24719. (<em>Appears on:</em>
  24720. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  24721. </p>
  24722. <p>
  24723. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  24724. </p>
  24725. <table>
  24726. <thead>
  24727. <tr>
  24728. <th>Field</th>
  24729. <th>Description</th>
  24730. </tr>
  24731. </thead>
  24732. <tbody>
  24733. <tr>
  24734. <td>
  24735. <code>clientId</code></br>
  24736. <em>
  24737. string
  24738. </em>
  24739. </td>
  24740. <td>
  24741. </td>
  24742. </tr>
  24743. <tr>
  24744. <td>
  24745. <code>clientSecretSecretRef</code></br>
  24746. <em>
  24747. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24748. External Secrets meta/v1.SecretKeySelector
  24749. </a>
  24750. </em>
  24751. </td>
  24752. <td>
  24753. </td>
  24754. </tr>
  24755. </tbody>
  24756. </table>
  24757. <h3 id="external-secrets.io/v1beta1.SenhaseguraModuleType">SenhaseguraModuleType
  24758. (<code>string</code> alias)</p></h3>
  24759. <p>
  24760. (<em>Appears on:</em>
  24761. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  24762. </p>
  24763. <p>
  24764. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  24765. </p>
  24766. <table>
  24767. <thead>
  24768. <tr>
  24769. <th>Value</th>
  24770. <th>Description</th>
  24771. </tr>
  24772. </thead>
  24773. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  24774. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  24775. see: https://senhasegura.com/devops
  24776. </code></pre>
  24777. </td>
  24778. </tr></tbody>
  24779. </table>
  24780. <h3 id="external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider
  24781. </h3>
  24782. <p>
  24783. (<em>Appears on:</em>
  24784. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24785. </p>
  24786. <p>
  24787. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  24788. </p>
  24789. <table>
  24790. <thead>
  24791. <tr>
  24792. <th>Field</th>
  24793. <th>Description</th>
  24794. </tr>
  24795. </thead>
  24796. <tbody>
  24797. <tr>
  24798. <td>
  24799. <code>url</code></br>
  24800. <em>
  24801. string
  24802. </em>
  24803. </td>
  24804. <td>
  24805. <p>URL of senhasegura</p>
  24806. </td>
  24807. </tr>
  24808. <tr>
  24809. <td>
  24810. <code>module</code></br>
  24811. <em>
  24812. <a href="#external-secrets.io/v1beta1.SenhaseguraModuleType">
  24813. SenhaseguraModuleType
  24814. </a>
  24815. </em>
  24816. </td>
  24817. <td>
  24818. <p>Module defines which senhasegura module should be used to get secrets</p>
  24819. </td>
  24820. </tr>
  24821. <tr>
  24822. <td>
  24823. <code>auth</code></br>
  24824. <em>
  24825. <a href="#external-secrets.io/v1beta1.SenhaseguraAuth">
  24826. SenhaseguraAuth
  24827. </a>
  24828. </em>
  24829. </td>
  24830. <td>
  24831. <p>Auth defines parameters to authenticate in senhasegura</p>
  24832. </td>
  24833. </tr>
  24834. <tr>
  24835. <td>
  24836. <code>ignoreSslCertificate</code></br>
  24837. <em>
  24838. bool
  24839. </em>
  24840. </td>
  24841. <td>
  24842. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  24843. </td>
  24844. </tr>
  24845. </tbody>
  24846. </table>
  24847. <h3 id="external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  24848. </h3>
  24849. <p>
  24850. (<em>Appears on:</em>
  24851. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  24852. </p>
  24853. <p>
  24854. <p>StoreGeneratorSourceRef allows you to override the source
  24855. from which the secret will be pulled from.
  24856. You can define at maximum one property.</p>
  24857. </p>
  24858. <table>
  24859. <thead>
  24860. <tr>
  24861. <th>Field</th>
  24862. <th>Description</th>
  24863. </tr>
  24864. </thead>
  24865. <tbody>
  24866. <tr>
  24867. <td>
  24868. <code>storeRef</code></br>
  24869. <em>
  24870. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  24871. SecretStoreRef
  24872. </a>
  24873. </em>
  24874. </td>
  24875. <td>
  24876. <em>(Optional)</em>
  24877. </td>
  24878. </tr>
  24879. <tr>
  24880. <td>
  24881. <code>generatorRef</code></br>
  24882. <em>
  24883. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  24884. GeneratorRef
  24885. </a>
  24886. </em>
  24887. </td>
  24888. <td>
  24889. <em>(Optional)</em>
  24890. <p>GeneratorRef points to a generator custom resource.</p>
  24891. </td>
  24892. </tr>
  24893. </tbody>
  24894. </table>
  24895. <h3 id="external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef
  24896. </h3>
  24897. <p>
  24898. (<em>Appears on:</em>
  24899. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>)
  24900. </p>
  24901. <p>
  24902. <p>StoreSourceRef allows you to override the SecretStore source
  24903. from which the secret will be pulled from.
  24904. You can define at maximum one property.</p>
  24905. </p>
  24906. <table>
  24907. <thead>
  24908. <tr>
  24909. <th>Field</th>
  24910. <th>Description</th>
  24911. </tr>
  24912. </thead>
  24913. <tbody>
  24914. <tr>
  24915. <td>
  24916. <code>storeRef</code></br>
  24917. <em>
  24918. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  24919. SecretStoreRef
  24920. </a>
  24921. </em>
  24922. </td>
  24923. <td>
  24924. <em>(Optional)</em>
  24925. </td>
  24926. </tr>
  24927. <tr>
  24928. <td>
  24929. <code>generatorRef</code></br>
  24930. <em>
  24931. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  24932. GeneratorRef
  24933. </a>
  24934. </em>
  24935. </td>
  24936. <td>
  24937. <p>GeneratorRef points to a generator custom resource.</p>
  24938. <p>Deprecated: The generatorRef is not implemented in .data[].
  24939. this will be removed with v1.</p>
  24940. </td>
  24941. </tr>
  24942. </tbody>
  24943. </table>
  24944. <h3 id="external-secrets.io/v1beta1.Tag">Tag
  24945. </h3>
  24946. <p>
  24947. <p>Tag defines a tag key and value for AWS resources.</p>
  24948. </p>
  24949. <table>
  24950. <thead>
  24951. <tr>
  24952. <th>Field</th>
  24953. <th>Description</th>
  24954. </tr>
  24955. </thead>
  24956. <tbody>
  24957. <tr>
  24958. <td>
  24959. <code>key</code></br>
  24960. <em>
  24961. string
  24962. </em>
  24963. </td>
  24964. <td>
  24965. </td>
  24966. </tr>
  24967. <tr>
  24968. <td>
  24969. <code>value</code></br>
  24970. <em>
  24971. string
  24972. </em>
  24973. </td>
  24974. <td>
  24975. </td>
  24976. </tr>
  24977. </tbody>
  24978. </table>
  24979. <h3 id="external-secrets.io/v1beta1.TemplateEngineVersion">TemplateEngineVersion
  24980. (<code>string</code> alias)</p></h3>
  24981. <p>
  24982. (<em>Appears on:</em>
  24983. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  24984. </p>
  24985. <p>
  24986. <p>TemplateEngineVersion defines the version of the template engine to use.</p>
  24987. </p>
  24988. <table>
  24989. <thead>
  24990. <tr>
  24991. <th>Value</th>
  24992. <th>Description</th>
  24993. </tr>
  24994. </thead>
  24995. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  24996. <td><p>TemplateEngineV2 specifies the v2 template engine version.</p>
  24997. </td>
  24998. </tr></tbody>
  24999. </table>
  25000. <h3 id="external-secrets.io/v1beta1.TemplateFrom">TemplateFrom
  25001. </h3>
  25002. <p>
  25003. (<em>Appears on:</em>
  25004. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25005. </p>
  25006. <p>
  25007. <p>TemplateFrom defines a source for template data.</p>
  25008. </p>
  25009. <table>
  25010. <thead>
  25011. <tr>
  25012. <th>Field</th>
  25013. <th>Description</th>
  25014. </tr>
  25015. </thead>
  25016. <tbody>
  25017. <tr>
  25018. <td>
  25019. <code>configMap</code></br>
  25020. <em>
  25021. <a href="#external-secrets.io/v1beta1.TemplateRef">
  25022. TemplateRef
  25023. </a>
  25024. </em>
  25025. </td>
  25026. <td>
  25027. </td>
  25028. </tr>
  25029. <tr>
  25030. <td>
  25031. <code>secret</code></br>
  25032. <em>
  25033. <a href="#external-secrets.io/v1beta1.TemplateRef">
  25034. TemplateRef
  25035. </a>
  25036. </em>
  25037. </td>
  25038. <td>
  25039. </td>
  25040. </tr>
  25041. <tr>
  25042. <td>
  25043. <code>target</code></br>
  25044. <em>
  25045. <a href="#external-secrets.io/v1beta1.TemplateTarget">
  25046. TemplateTarget
  25047. </a>
  25048. </em>
  25049. </td>
  25050. <td>
  25051. <em>(Optional)</em>
  25052. </td>
  25053. </tr>
  25054. <tr>
  25055. <td>
  25056. <code>literal</code></br>
  25057. <em>
  25058. string
  25059. </em>
  25060. </td>
  25061. <td>
  25062. <em>(Optional)</em>
  25063. </td>
  25064. </tr>
  25065. </tbody>
  25066. </table>
  25067. <h3 id="external-secrets.io/v1beta1.TemplateMergePolicy">TemplateMergePolicy
  25068. (<code>string</code> alias)</p></h3>
  25069. <p>
  25070. (<em>Appears on:</em>
  25071. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  25072. </p>
  25073. <p>
  25074. <p>TemplateMergePolicy defines how template values should be merged when generating a secret.</p>
  25075. </p>
  25076. <table>
  25077. <thead>
  25078. <tr>
  25079. <th>Value</th>
  25080. <th>Description</th>
  25081. </tr>
  25082. </thead>
  25083. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  25084. <td><p>MergePolicyMerge merges the template content with existing values.</p>
  25085. </td>
  25086. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  25087. <td><p>MergePolicyReplace replaces the entire template content during merge operations.</p>
  25088. </td>
  25089. </tr></tbody>
  25090. </table>
  25091. <h3 id="external-secrets.io/v1beta1.TemplateRef">TemplateRef
  25092. </h3>
  25093. <p>
  25094. (<em>Appears on:</em>
  25095. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  25096. </p>
  25097. <p>
  25098. <p>TemplateRef defines a reference to a template source in a ConfigMap or Secret.</p>
  25099. </p>
  25100. <table>
  25101. <thead>
  25102. <tr>
  25103. <th>Field</th>
  25104. <th>Description</th>
  25105. </tr>
  25106. </thead>
  25107. <tbody>
  25108. <tr>
  25109. <td>
  25110. <code>name</code></br>
  25111. <em>
  25112. string
  25113. </em>
  25114. </td>
  25115. <td>
  25116. <p>The name of the ConfigMap/Secret resource</p>
  25117. </td>
  25118. </tr>
  25119. <tr>
  25120. <td>
  25121. <code>items</code></br>
  25122. <em>
  25123. <a href="#external-secrets.io/v1beta1.TemplateRefItem">
  25124. []TemplateRefItem
  25125. </a>
  25126. </em>
  25127. </td>
  25128. <td>
  25129. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  25130. </td>
  25131. </tr>
  25132. </tbody>
  25133. </table>
  25134. <h3 id="external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem
  25135. </h3>
  25136. <p>
  25137. (<em>Appears on:</em>
  25138. <a href="#external-secrets.io/v1beta1.TemplateRef">TemplateRef</a>)
  25139. </p>
  25140. <p>
  25141. <p>TemplateRefItem defines which key in the referenced ConfigMap or Secret to use as a template.</p>
  25142. </p>
  25143. <table>
  25144. <thead>
  25145. <tr>
  25146. <th>Field</th>
  25147. <th>Description</th>
  25148. </tr>
  25149. </thead>
  25150. <tbody>
  25151. <tr>
  25152. <td>
  25153. <code>key</code></br>
  25154. <em>
  25155. string
  25156. </em>
  25157. </td>
  25158. <td>
  25159. <p>A key in the ConfigMap/Secret</p>
  25160. </td>
  25161. </tr>
  25162. <tr>
  25163. <td>
  25164. <code>templateAs</code></br>
  25165. <em>
  25166. <a href="#external-secrets.io/v1beta1.TemplateScope">
  25167. TemplateScope
  25168. </a>
  25169. </em>
  25170. </td>
  25171. <td>
  25172. </td>
  25173. </tr>
  25174. </tbody>
  25175. </table>
  25176. <h3 id="external-secrets.io/v1beta1.TemplateScope">TemplateScope
  25177. (<code>string</code> alias)</p></h3>
  25178. <p>
  25179. (<em>Appears on:</em>
  25180. <a href="#external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem</a>)
  25181. </p>
  25182. <p>
  25183. <p>TemplateScope defines the scope of the template when processing template data.</p>
  25184. </p>
  25185. <table>
  25186. <thead>
  25187. <tr>
  25188. <th>Value</th>
  25189. <th>Description</th>
  25190. </tr>
  25191. </thead>
  25192. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  25193. <td><p>TemplateScopeKeysAndValues processes both keys and values of the data.</p>
  25194. </td>
  25195. </tr><tr><td><p>&#34;Values&#34;</p></td>
  25196. <td><p>TemplateScopeValues processes only the values of the data.</p>
  25197. </td>
  25198. </tr></tbody>
  25199. </table>
  25200. <h3 id="external-secrets.io/v1beta1.TemplateTarget">TemplateTarget
  25201. (<code>string</code> alias)</p></h3>
  25202. <p>
  25203. (<em>Appears on:</em>
  25204. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  25205. </p>
  25206. <p>
  25207. <p>TemplateTarget defines the target field where the template result will be stored.</p>
  25208. </p>
  25209. <table>
  25210. <thead>
  25211. <tr>
  25212. <th>Value</th>
  25213. <th>Description</th>
  25214. </tr>
  25215. </thead>
  25216. <tbody><tr><td><p>&#34;Annotations&#34;</p></td>
  25217. <td><p>TemplateTargetAnnotations stores template results in the annotations field of the secret.</p>
  25218. </td>
  25219. </tr><tr><td><p>&#34;Data&#34;</p></td>
  25220. <td><p>TemplateTargetData stores template results in the data field of the secret.</p>
  25221. </td>
  25222. </tr><tr><td><p>&#34;Labels&#34;</p></td>
  25223. <td><p>TemplateTargetLabels stores template results in the labels field of the secret.</p>
  25224. </td>
  25225. </tr></tbody>
  25226. </table>
  25227. <h3 id="external-secrets.io/v1beta1.TokenAuth">TokenAuth
  25228. </h3>
  25229. <p>
  25230. (<em>Appears on:</em>
  25231. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  25232. </p>
  25233. <p>
  25234. <p>TokenAuth defines token-based authentication for the Kubernetes provider.</p>
  25235. </p>
  25236. <table>
  25237. <thead>
  25238. <tr>
  25239. <th>Field</th>
  25240. <th>Description</th>
  25241. </tr>
  25242. </thead>
  25243. <tbody>
  25244. <tr>
  25245. <td>
  25246. <code>bearerToken</code></br>
  25247. <em>
  25248. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25249. External Secrets meta/v1.SecretKeySelector
  25250. </a>
  25251. </em>
  25252. </td>
  25253. <td>
  25254. </td>
  25255. </tr>
  25256. </tbody>
  25257. </table>
  25258. <h3 id="external-secrets.io/v1beta1.UniversalAuthCredentials">UniversalAuthCredentials
  25259. </h3>
  25260. <p>
  25261. (<em>Appears on:</em>
  25262. <a href="#external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth</a>)
  25263. </p>
  25264. <p>
  25265. <p>UniversalAuthCredentials defines the credentials for Infisical Universal Auth.</p>
  25266. </p>
  25267. <table>
  25268. <thead>
  25269. <tr>
  25270. <th>Field</th>
  25271. <th>Description</th>
  25272. </tr>
  25273. </thead>
  25274. <tbody>
  25275. <tr>
  25276. <td>
  25277. <code>clientId</code></br>
  25278. <em>
  25279. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25280. External Secrets meta/v1.SecretKeySelector
  25281. </a>
  25282. </em>
  25283. </td>
  25284. <td>
  25285. </td>
  25286. </tr>
  25287. <tr>
  25288. <td>
  25289. <code>clientSecret</code></br>
  25290. <em>
  25291. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25292. External Secrets meta/v1.SecretKeySelector
  25293. </a>
  25294. </em>
  25295. </td>
  25296. <td>
  25297. </td>
  25298. </tr>
  25299. </tbody>
  25300. </table>
  25301. <h3 id="external-secrets.io/v1beta1.ValidationResult">ValidationResult
  25302. (<code>byte</code> alias)</p></h3>
  25303. <p>
  25304. <p>ValidationResult represents the result of validating a provider client configuration.</p>
  25305. </p>
  25306. <table>
  25307. <thead>
  25308. <tr>
  25309. <th>Value</th>
  25310. <th>Description</th>
  25311. </tr>
  25312. </thead>
  25313. <tbody><tr><td><p>2</p></td>
  25314. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  25315. </td>
  25316. </tr><tr><td><p>0</p></td>
  25317. <td><p>ValidationResultReady indicates that the client is configured correctly and can be used.</p>
  25318. </td>
  25319. </tr><tr><td><p>1</p></td>
  25320. <td><p>ValidationResultUnknown indicates that the client can be used but information is missing and it can not be validated.</p>
  25321. </td>
  25322. </tr></tbody>
  25323. </table>
  25324. <h3 id="external-secrets.io/v1beta1.VaultAppRole">VaultAppRole
  25325. </h3>
  25326. <p>
  25327. (<em>Appears on:</em>
  25328. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25329. </p>
  25330. <p>
  25331. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  25332. with the role and secret stored in a Kubernetes Secret resource.</p>
  25333. </p>
  25334. <table>
  25335. <thead>
  25336. <tr>
  25337. <th>Field</th>
  25338. <th>Description</th>
  25339. </tr>
  25340. </thead>
  25341. <tbody>
  25342. <tr>
  25343. <td>
  25344. <code>path</code></br>
  25345. <em>
  25346. string
  25347. </em>
  25348. </td>
  25349. <td>
  25350. <p>Path where the App Role authentication backend is mounted
  25351. in Vault, e.g: &ldquo;approle&rdquo;</p>
  25352. </td>
  25353. </tr>
  25354. <tr>
  25355. <td>
  25356. <code>roleId</code></br>
  25357. <em>
  25358. string
  25359. </em>
  25360. </td>
  25361. <td>
  25362. <em>(Optional)</em>
  25363. <p>RoleID configured in the App Role authentication backend when setting
  25364. up the authentication backend in Vault.</p>
  25365. </td>
  25366. </tr>
  25367. <tr>
  25368. <td>
  25369. <code>roleRef</code></br>
  25370. <em>
  25371. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25372. External Secrets meta/v1.SecretKeySelector
  25373. </a>
  25374. </em>
  25375. </td>
  25376. <td>
  25377. <em>(Optional)</em>
  25378. <p>Reference to a key in a Secret that contains the App Role ID used
  25379. to authenticate with Vault.
  25380. The <code>key</code> field must be specified and denotes which entry within the Secret
  25381. resource is used as the app role id.</p>
  25382. </td>
  25383. </tr>
  25384. <tr>
  25385. <td>
  25386. <code>secretRef</code></br>
  25387. <em>
  25388. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25389. External Secrets meta/v1.SecretKeySelector
  25390. </a>
  25391. </em>
  25392. </td>
  25393. <td>
  25394. <p>Reference to a key in a Secret that contains the App Role secret used
  25395. to authenticate with Vault.
  25396. The <code>key</code> field must be specified and denotes which entry within the Secret
  25397. resource is used as the app role secret.</p>
  25398. </td>
  25399. </tr>
  25400. </tbody>
  25401. </table>
  25402. <h3 id="external-secrets.io/v1beta1.VaultAuth">VaultAuth
  25403. </h3>
  25404. <p>
  25405. (<em>Appears on:</em>
  25406. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  25407. </p>
  25408. <p>
  25409. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  25410. 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>
  25411. can be specified. A namespace to authenticate against can optionally be specified.</p>
  25412. </p>
  25413. <table>
  25414. <thead>
  25415. <tr>
  25416. <th>Field</th>
  25417. <th>Description</th>
  25418. </tr>
  25419. </thead>
  25420. <tbody>
  25421. <tr>
  25422. <td>
  25423. <code>namespace</code></br>
  25424. <em>
  25425. string
  25426. </em>
  25427. </td>
  25428. <td>
  25429. <em>(Optional)</em>
  25430. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  25431. Namespaces is a set of features within Vault Enterprise that allows
  25432. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  25433. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  25434. This will default to Vault.Namespace field if set, or empty otherwise</p>
  25435. </td>
  25436. </tr>
  25437. <tr>
  25438. <td>
  25439. <code>tokenSecretRef</code></br>
  25440. <em>
  25441. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25442. External Secrets meta/v1.SecretKeySelector
  25443. </a>
  25444. </em>
  25445. </td>
  25446. <td>
  25447. <em>(Optional)</em>
  25448. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  25449. </td>
  25450. </tr>
  25451. <tr>
  25452. <td>
  25453. <code>appRole</code></br>
  25454. <em>
  25455. <a href="#external-secrets.io/v1beta1.VaultAppRole">
  25456. VaultAppRole
  25457. </a>
  25458. </em>
  25459. </td>
  25460. <td>
  25461. <em>(Optional)</em>
  25462. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  25463. with the role and secret stored in a Kubernetes Secret resource.</p>
  25464. </td>
  25465. </tr>
  25466. <tr>
  25467. <td>
  25468. <code>kubernetes</code></br>
  25469. <em>
  25470. <a href="#external-secrets.io/v1beta1.VaultKubernetesAuth">
  25471. VaultKubernetesAuth
  25472. </a>
  25473. </em>
  25474. </td>
  25475. <td>
  25476. <em>(Optional)</em>
  25477. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  25478. token stored in the named Secret resource to the Vault server.</p>
  25479. </td>
  25480. </tr>
  25481. <tr>
  25482. <td>
  25483. <code>ldap</code></br>
  25484. <em>
  25485. <a href="#external-secrets.io/v1beta1.VaultLdapAuth">
  25486. VaultLdapAuth
  25487. </a>
  25488. </em>
  25489. </td>
  25490. <td>
  25491. <em>(Optional)</em>
  25492. <p>Ldap authenticates with Vault by passing username/password pair using
  25493. the LDAP authentication method</p>
  25494. </td>
  25495. </tr>
  25496. <tr>
  25497. <td>
  25498. <code>jwt</code></br>
  25499. <em>
  25500. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">
  25501. VaultJwtAuth
  25502. </a>
  25503. </em>
  25504. </td>
  25505. <td>
  25506. <em>(Optional)</em>
  25507. <p>Jwt authenticates with Vault by passing role and JWT token using the
  25508. JWT/OIDC authentication method</p>
  25509. </td>
  25510. </tr>
  25511. <tr>
  25512. <td>
  25513. <code>cert</code></br>
  25514. <em>
  25515. <a href="#external-secrets.io/v1beta1.VaultCertAuth">
  25516. VaultCertAuth
  25517. </a>
  25518. </em>
  25519. </td>
  25520. <td>
  25521. <em>(Optional)</em>
  25522. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  25523. Cert authentication method</p>
  25524. </td>
  25525. </tr>
  25526. <tr>
  25527. <td>
  25528. <code>iam</code></br>
  25529. <em>
  25530. <a href="#external-secrets.io/v1beta1.VaultIamAuth">
  25531. VaultIamAuth
  25532. </a>
  25533. </em>
  25534. </td>
  25535. <td>
  25536. <em>(Optional)</em>
  25537. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  25538. AWS IAM authentication method</p>
  25539. </td>
  25540. </tr>
  25541. <tr>
  25542. <td>
  25543. <code>userPass</code></br>
  25544. <em>
  25545. <a href="#external-secrets.io/v1beta1.VaultUserPassAuth">
  25546. VaultUserPassAuth
  25547. </a>
  25548. </em>
  25549. </td>
  25550. <td>
  25551. <em>(Optional)</em>
  25552. <p>UserPass authenticates with Vault by passing username/password pair</p>
  25553. </td>
  25554. </tr>
  25555. </tbody>
  25556. </table>
  25557. <h3 id="external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth
  25558. </h3>
  25559. <p>
  25560. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  25561. Only one of secretRef or jwt can be specified.
  25562. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  25563. </p>
  25564. <table>
  25565. <thead>
  25566. <tr>
  25567. <th>Field</th>
  25568. <th>Description</th>
  25569. </tr>
  25570. </thead>
  25571. <tbody>
  25572. <tr>
  25573. <td>
  25574. <code>secretRef</code></br>
  25575. <em>
  25576. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  25577. VaultAwsAuthSecretRef
  25578. </a>
  25579. </em>
  25580. </td>
  25581. <td>
  25582. <em>(Optional)</em>
  25583. </td>
  25584. </tr>
  25585. <tr>
  25586. <td>
  25587. <code>jwt</code></br>
  25588. <em>
  25589. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  25590. VaultAwsJWTAuth
  25591. </a>
  25592. </em>
  25593. </td>
  25594. <td>
  25595. <em>(Optional)</em>
  25596. </td>
  25597. </tr>
  25598. </tbody>
  25599. </table>
  25600. <h3 id="external-secrets.io/v1beta1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  25601. </h3>
  25602. <p>
  25603. (<em>Appears on:</em>
  25604. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  25605. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  25606. </p>
  25607. <p>
  25608. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  25609. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  25610. </p>
  25611. <table>
  25612. <thead>
  25613. <tr>
  25614. <th>Field</th>
  25615. <th>Description</th>
  25616. </tr>
  25617. </thead>
  25618. <tbody>
  25619. <tr>
  25620. <td>
  25621. <code>accessKeyIDSecretRef</code></br>
  25622. <em>
  25623. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25624. External Secrets meta/v1.SecretKeySelector
  25625. </a>
  25626. </em>
  25627. </td>
  25628. <td>
  25629. <em>(Optional)</em>
  25630. <p>The AccessKeyID is used for authentication</p>
  25631. </td>
  25632. </tr>
  25633. <tr>
  25634. <td>
  25635. <code>secretAccessKeySecretRef</code></br>
  25636. <em>
  25637. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25638. External Secrets meta/v1.SecretKeySelector
  25639. </a>
  25640. </em>
  25641. </td>
  25642. <td>
  25643. <em>(Optional)</em>
  25644. <p>The SecretAccessKey is used for authentication</p>
  25645. </td>
  25646. </tr>
  25647. <tr>
  25648. <td>
  25649. <code>sessionTokenSecretRef</code></br>
  25650. <em>
  25651. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25652. External Secrets meta/v1.SecretKeySelector
  25653. </a>
  25654. </em>
  25655. </td>
  25656. <td>
  25657. <em>(Optional)</em>
  25658. <p>The SessionToken used for authentication
  25659. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  25660. 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>
  25661. </td>
  25662. </tr>
  25663. </tbody>
  25664. </table>
  25665. <h3 id="external-secrets.io/v1beta1.VaultAwsJWTAuth">VaultAwsJWTAuth
  25666. </h3>
  25667. <p>
  25668. (<em>Appears on:</em>
  25669. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  25670. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  25671. </p>
  25672. <p>
  25673. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  25674. </p>
  25675. <table>
  25676. <thead>
  25677. <tr>
  25678. <th>Field</th>
  25679. <th>Description</th>
  25680. </tr>
  25681. </thead>
  25682. <tbody>
  25683. <tr>
  25684. <td>
  25685. <code>serviceAccountRef</code></br>
  25686. <em>
  25687. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  25688. External Secrets meta/v1.ServiceAccountSelector
  25689. </a>
  25690. </em>
  25691. </td>
  25692. <td>
  25693. <em>(Optional)</em>
  25694. </td>
  25695. </tr>
  25696. </tbody>
  25697. </table>
  25698. <h3 id="external-secrets.io/v1beta1.VaultCertAuth">VaultCertAuth
  25699. </h3>
  25700. <p>
  25701. (<em>Appears on:</em>
  25702. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25703. </p>
  25704. <p>
  25705. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  25706. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  25707. </p>
  25708. <table>
  25709. <thead>
  25710. <tr>
  25711. <th>Field</th>
  25712. <th>Description</th>
  25713. </tr>
  25714. </thead>
  25715. <tbody>
  25716. <tr>
  25717. <td>
  25718. <code>clientCert</code></br>
  25719. <em>
  25720. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25721. External Secrets meta/v1.SecretKeySelector
  25722. </a>
  25723. </em>
  25724. </td>
  25725. <td>
  25726. <em>(Optional)</em>
  25727. <p>ClientCert is a certificate to authenticate using the Cert Vault
  25728. authentication method</p>
  25729. </td>
  25730. </tr>
  25731. <tr>
  25732. <td>
  25733. <code>secretRef</code></br>
  25734. <em>
  25735. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25736. External Secrets meta/v1.SecretKeySelector
  25737. </a>
  25738. </em>
  25739. </td>
  25740. <td>
  25741. <em>(Optional)</em>
  25742. <p>SecretRef to a key in a Secret resource containing client private key to
  25743. authenticate with Vault using the Cert authentication method</p>
  25744. </td>
  25745. </tr>
  25746. </tbody>
  25747. </table>
  25748. <h3 id="external-secrets.io/v1beta1.VaultClientTLS">VaultClientTLS
  25749. </h3>
  25750. <p>
  25751. (<em>Appears on:</em>
  25752. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  25753. </p>
  25754. <p>
  25755. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  25756. when the Vault server requires mutual authentication.</p>
  25757. </p>
  25758. <table>
  25759. <thead>
  25760. <tr>
  25761. <th>Field</th>
  25762. <th>Description</th>
  25763. </tr>
  25764. </thead>
  25765. <tbody>
  25766. <tr>
  25767. <td>
  25768. <code>certSecretRef</code></br>
  25769. <em>
  25770. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25771. External Secrets meta/v1.SecretKeySelector
  25772. </a>
  25773. </em>
  25774. </td>
  25775. <td>
  25776. <em>(Optional)</em>
  25777. <p>CertSecretRef is a certificate added to the transport layer
  25778. when communicating with the Vault server.
  25779. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  25780. </td>
  25781. </tr>
  25782. <tr>
  25783. <td>
  25784. <code>keySecretRef</code></br>
  25785. <em>
  25786. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25787. External Secrets meta/v1.SecretKeySelector
  25788. </a>
  25789. </em>
  25790. </td>
  25791. <td>
  25792. <em>(Optional)</em>
  25793. <p>KeySecretRef to a key in a Secret resource containing client private key
  25794. added to the transport layer when communicating with the Vault server.
  25795. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  25796. </td>
  25797. </tr>
  25798. </tbody>
  25799. </table>
  25800. <h3 id="external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth
  25801. </h3>
  25802. <p>
  25803. (<em>Appears on:</em>
  25804. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25805. </p>
  25806. <p>
  25807. <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>
  25808. </p>
  25809. <table>
  25810. <thead>
  25811. <tr>
  25812. <th>Field</th>
  25813. <th>Description</th>
  25814. </tr>
  25815. </thead>
  25816. <tbody>
  25817. <tr>
  25818. <td>
  25819. <code>path</code></br>
  25820. <em>
  25821. string
  25822. </em>
  25823. </td>
  25824. <td>
  25825. <em>(Optional)</em>
  25826. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  25827. </td>
  25828. </tr>
  25829. <tr>
  25830. <td>
  25831. <code>region</code></br>
  25832. <em>
  25833. string
  25834. </em>
  25835. </td>
  25836. <td>
  25837. <em>(Optional)</em>
  25838. <p>AWS region</p>
  25839. </td>
  25840. </tr>
  25841. <tr>
  25842. <td>
  25843. <code>role</code></br>
  25844. <em>
  25845. string
  25846. </em>
  25847. </td>
  25848. <td>
  25849. <em>(Optional)</em>
  25850. <p>This is the AWS role to be assumed before talking to vault</p>
  25851. </td>
  25852. </tr>
  25853. <tr>
  25854. <td>
  25855. <code>vaultRole</code></br>
  25856. <em>
  25857. string
  25858. </em>
  25859. </td>
  25860. <td>
  25861. <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>
  25862. </td>
  25863. </tr>
  25864. <tr>
  25865. <td>
  25866. <code>externalID</code></br>
  25867. <em>
  25868. string
  25869. </em>
  25870. </td>
  25871. <td>
  25872. <p>AWS External ID set on assumed IAM roles</p>
  25873. </td>
  25874. </tr>
  25875. <tr>
  25876. <td>
  25877. <code>vaultAwsIamServerID</code></br>
  25878. <em>
  25879. string
  25880. </em>
  25881. </td>
  25882. <td>
  25883. <em>(Optional)</em>
  25884. <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>
  25885. </td>
  25886. </tr>
  25887. <tr>
  25888. <td>
  25889. <code>secretRef</code></br>
  25890. <em>
  25891. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  25892. VaultAwsAuthSecretRef
  25893. </a>
  25894. </em>
  25895. </td>
  25896. <td>
  25897. <em>(Optional)</em>
  25898. <p>Specify credentials in a Secret object</p>
  25899. </td>
  25900. </tr>
  25901. <tr>
  25902. <td>
  25903. <code>jwt</code></br>
  25904. <em>
  25905. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  25906. VaultAwsJWTAuth
  25907. </a>
  25908. </em>
  25909. </td>
  25910. <td>
  25911. <em>(Optional)</em>
  25912. <p>Specify a service account with IRSA enabled</p>
  25913. </td>
  25914. </tr>
  25915. </tbody>
  25916. </table>
  25917. <h3 id="external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth
  25918. </h3>
  25919. <p>
  25920. (<em>Appears on:</em>
  25921. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25922. </p>
  25923. <p>
  25924. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  25925. method, with the role name and a token stored in a Kubernetes Secret resource or
  25926. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  25927. </p>
  25928. <table>
  25929. <thead>
  25930. <tr>
  25931. <th>Field</th>
  25932. <th>Description</th>
  25933. </tr>
  25934. </thead>
  25935. <tbody>
  25936. <tr>
  25937. <td>
  25938. <code>path</code></br>
  25939. <em>
  25940. string
  25941. </em>
  25942. </td>
  25943. <td>
  25944. <p>Path where the JWT authentication backend is mounted
  25945. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  25946. </td>
  25947. </tr>
  25948. <tr>
  25949. <td>
  25950. <code>role</code></br>
  25951. <em>
  25952. string
  25953. </em>
  25954. </td>
  25955. <td>
  25956. <em>(Optional)</em>
  25957. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  25958. authentication method</p>
  25959. </td>
  25960. </tr>
  25961. <tr>
  25962. <td>
  25963. <code>secretRef</code></br>
  25964. <em>
  25965. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25966. External Secrets meta/v1.SecretKeySelector
  25967. </a>
  25968. </em>
  25969. </td>
  25970. <td>
  25971. <em>(Optional)</em>
  25972. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  25973. authenticate with Vault using the JWT/OIDC authentication method.</p>
  25974. </td>
  25975. </tr>
  25976. <tr>
  25977. <td>
  25978. <code>kubernetesServiceAccountToken</code></br>
  25979. <em>
  25980. <a href="#external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">
  25981. VaultKubernetesServiceAccountTokenAuth
  25982. </a>
  25983. </em>
  25984. </td>
  25985. <td>
  25986. <em>(Optional)</em>
  25987. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  25988. a token for with the <code>TokenRequest</code> API.</p>
  25989. </td>
  25990. </tr>
  25991. </tbody>
  25992. </table>
  25993. <h3 id="external-secrets.io/v1beta1.VaultKVStoreVersion">VaultKVStoreVersion
  25994. (<code>string</code> alias)</p></h3>
  25995. <p>
  25996. (<em>Appears on:</em>
  25997. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  25998. </p>
  25999. <p>
  26000. <p>VaultKVStoreVersion defines the version of the KV store in Vault.</p>
  26001. </p>
  26002. <table>
  26003. <thead>
  26004. <tr>
  26005. <th>Value</th>
  26006. <th>Description</th>
  26007. </tr>
  26008. </thead>
  26009. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  26010. <td><p>VaultKVStoreV1 represents version 1 of the Vault KV store.</p>
  26011. </td>
  26012. </tr><tr><td><p>&#34;v2&#34;</p></td>
  26013. <td><p>VaultKVStoreV2 represents version 2 of the Vault KV store.</p>
  26014. </td>
  26015. </tr></tbody>
  26016. </table>
  26017. <h3 id="external-secrets.io/v1beta1.VaultKubernetesAuth">VaultKubernetesAuth
  26018. </h3>
  26019. <p>
  26020. (<em>Appears on:</em>
  26021. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26022. </p>
  26023. <p>
  26024. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in a Secret.</p>
  26025. </p>
  26026. <table>
  26027. <thead>
  26028. <tr>
  26029. <th>Field</th>
  26030. <th>Description</th>
  26031. </tr>
  26032. </thead>
  26033. <tbody>
  26034. <tr>
  26035. <td>
  26036. <code>mountPath</code></br>
  26037. <em>
  26038. string
  26039. </em>
  26040. </td>
  26041. <td>
  26042. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  26043. &ldquo;kubernetes&rdquo;</p>
  26044. </td>
  26045. </tr>
  26046. <tr>
  26047. <td>
  26048. <code>serviceAccountRef</code></br>
  26049. <em>
  26050. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26051. External Secrets meta/v1.ServiceAccountSelector
  26052. </a>
  26053. </em>
  26054. </td>
  26055. <td>
  26056. <em>(Optional)</em>
  26057. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  26058. If the service account is specified, the service account secret token JWT will be used
  26059. for authenticating with Vault. If the service account selector is not supplied,
  26060. the secretRef will be used instead.</p>
  26061. </td>
  26062. </tr>
  26063. <tr>
  26064. <td>
  26065. <code>secretRef</code></br>
  26066. <em>
  26067. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26068. External Secrets meta/v1.SecretKeySelector
  26069. </a>
  26070. </em>
  26071. </td>
  26072. <td>
  26073. <em>(Optional)</em>
  26074. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  26075. for authenticating with Vault. If a name is specified without a key,
  26076. <code>token</code> is the default. If one is not specified, the one bound to
  26077. the controller will be used.</p>
  26078. </td>
  26079. </tr>
  26080. <tr>
  26081. <td>
  26082. <code>role</code></br>
  26083. <em>
  26084. string
  26085. </em>
  26086. </td>
  26087. <td>
  26088. <p>A required field containing the Vault Role to assume. A Role binds a
  26089. Kubernetes ServiceAccount with a set of Vault policies.</p>
  26090. </td>
  26091. </tr>
  26092. </tbody>
  26093. </table>
  26094. <h3 id="external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  26095. </h3>
  26096. <p>
  26097. (<em>Appears on:</em>
  26098. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth</a>)
  26099. </p>
  26100. <p>
  26101. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  26102. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  26103. </p>
  26104. <table>
  26105. <thead>
  26106. <tr>
  26107. <th>Field</th>
  26108. <th>Description</th>
  26109. </tr>
  26110. </thead>
  26111. <tbody>
  26112. <tr>
  26113. <td>
  26114. <code>serviceAccountRef</code></br>
  26115. <em>
  26116. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26117. External Secrets meta/v1.ServiceAccountSelector
  26118. </a>
  26119. </em>
  26120. </td>
  26121. <td>
  26122. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  26123. </td>
  26124. </tr>
  26125. <tr>
  26126. <td>
  26127. <code>audiences</code></br>
  26128. <em>
  26129. []string
  26130. </em>
  26131. </td>
  26132. <td>
  26133. <em>(Optional)</em>
  26134. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  26135. account token for the service account referenced by <code>serviceAccountRef</code>.
  26136. Defaults to a single audience <code>vault</code> it not specified.</p>
  26137. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  26138. </td>
  26139. </tr>
  26140. <tr>
  26141. <td>
  26142. <code>expirationSeconds</code></br>
  26143. <em>
  26144. int64
  26145. </em>
  26146. </td>
  26147. <td>
  26148. <em>(Optional)</em>
  26149. <p>Optional expiration time in seconds that will be used to request a temporary
  26150. Kubernetes service account token for the service account referenced by
  26151. <code>serviceAccountRef</code>.</p>
  26152. <p>Deprecated: this will be removed in the future.
  26153. Defaults to 10 minutes.</p>
  26154. </td>
  26155. </tr>
  26156. </tbody>
  26157. </table>
  26158. <h3 id="external-secrets.io/v1beta1.VaultLdapAuth">VaultLdapAuth
  26159. </h3>
  26160. <p>
  26161. (<em>Appears on:</em>
  26162. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26163. </p>
  26164. <p>
  26165. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  26166. with the username and password stored in a Kubernetes Secret resource.</p>
  26167. </p>
  26168. <table>
  26169. <thead>
  26170. <tr>
  26171. <th>Field</th>
  26172. <th>Description</th>
  26173. </tr>
  26174. </thead>
  26175. <tbody>
  26176. <tr>
  26177. <td>
  26178. <code>path</code></br>
  26179. <em>
  26180. string
  26181. </em>
  26182. </td>
  26183. <td>
  26184. <p>Path where the LDAP authentication backend is mounted
  26185. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  26186. </td>
  26187. </tr>
  26188. <tr>
  26189. <td>
  26190. <code>username</code></br>
  26191. <em>
  26192. string
  26193. </em>
  26194. </td>
  26195. <td>
  26196. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  26197. authentication method</p>
  26198. </td>
  26199. </tr>
  26200. <tr>
  26201. <td>
  26202. <code>secretRef</code></br>
  26203. <em>
  26204. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26205. External Secrets meta/v1.SecretKeySelector
  26206. </a>
  26207. </em>
  26208. </td>
  26209. <td>
  26210. <em>(Optional)</em>
  26211. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  26212. user used to authenticate with Vault using the LDAP authentication
  26213. method</p>
  26214. </td>
  26215. </tr>
  26216. </tbody>
  26217. </table>
  26218. <h3 id="external-secrets.io/v1beta1.VaultProvider">VaultProvider
  26219. </h3>
  26220. <p>
  26221. (<em>Appears on:</em>
  26222. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26223. </p>
  26224. <p>
  26225. <p>VaultProvider configures a store to sync secrets using a HashiCorp Vault KV backend.</p>
  26226. </p>
  26227. <table>
  26228. <thead>
  26229. <tr>
  26230. <th>Field</th>
  26231. <th>Description</th>
  26232. </tr>
  26233. </thead>
  26234. <tbody>
  26235. <tr>
  26236. <td>
  26237. <code>auth</code></br>
  26238. <em>
  26239. <a href="#external-secrets.io/v1beta1.VaultAuth">
  26240. VaultAuth
  26241. </a>
  26242. </em>
  26243. </td>
  26244. <td>
  26245. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  26246. </td>
  26247. </tr>
  26248. <tr>
  26249. <td>
  26250. <code>server</code></br>
  26251. <em>
  26252. string
  26253. </em>
  26254. </td>
  26255. <td>
  26256. <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>
  26257. </td>
  26258. </tr>
  26259. <tr>
  26260. <td>
  26261. <code>path</code></br>
  26262. <em>
  26263. string
  26264. </em>
  26265. </td>
  26266. <td>
  26267. <em>(Optional)</em>
  26268. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  26269. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  26270. for fetching secrets from Vault is optional and will be appended
  26271. if not present in specified path.</p>
  26272. </td>
  26273. </tr>
  26274. <tr>
  26275. <td>
  26276. <code>version</code></br>
  26277. <em>
  26278. <a href="#external-secrets.io/v1beta1.VaultKVStoreVersion">
  26279. VaultKVStoreVersion
  26280. </a>
  26281. </em>
  26282. </td>
  26283. <td>
  26284. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  26285. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  26286. </td>
  26287. </tr>
  26288. <tr>
  26289. <td>
  26290. <code>namespace</code></br>
  26291. <em>
  26292. string
  26293. </em>
  26294. </td>
  26295. <td>
  26296. <em>(Optional)</em>
  26297. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  26298. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  26299. 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>
  26300. </td>
  26301. </tr>
  26302. <tr>
  26303. <td>
  26304. <code>caBundle</code></br>
  26305. <em>
  26306. []byte
  26307. </em>
  26308. </td>
  26309. <td>
  26310. <em>(Optional)</em>
  26311. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  26312. if the Server URL is using HTTPS protocol. This parameter is ignored for
  26313. plain HTTP protocol connection. If not set the system root certificates
  26314. are used to validate the TLS connection.</p>
  26315. </td>
  26316. </tr>
  26317. <tr>
  26318. <td>
  26319. <code>tls</code></br>
  26320. <em>
  26321. <a href="#external-secrets.io/v1beta1.VaultClientTLS">
  26322. VaultClientTLS
  26323. </a>
  26324. </em>
  26325. </td>
  26326. <td>
  26327. <em>(Optional)</em>
  26328. <p>The configuration used for client side related TLS communication, when the Vault server
  26329. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  26330. This parameter is ignored for plain HTTP protocol connection.
  26331. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  26332. which is available under the <code>auth.cert</code> section.</p>
  26333. </td>
  26334. </tr>
  26335. <tr>
  26336. <td>
  26337. <code>caProvider</code></br>
  26338. <em>
  26339. <a href="#external-secrets.io/v1beta1.CAProvider">
  26340. CAProvider
  26341. </a>
  26342. </em>
  26343. </td>
  26344. <td>
  26345. <em>(Optional)</em>
  26346. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  26347. </td>
  26348. </tr>
  26349. <tr>
  26350. <td>
  26351. <code>readYourWrites</code></br>
  26352. <em>
  26353. bool
  26354. </em>
  26355. </td>
  26356. <td>
  26357. <em>(Optional)</em>
  26358. <p>ReadYourWrites ensures isolated read-after-write semantics by
  26359. providing discovered cluster replication states in each request.
  26360. More information about eventual consistency in Vault can be found here
  26361. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  26362. </td>
  26363. </tr>
  26364. <tr>
  26365. <td>
  26366. <code>forwardInconsistent</code></br>
  26367. <em>
  26368. bool
  26369. </em>
  26370. </td>
  26371. <td>
  26372. <em>(Optional)</em>
  26373. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  26374. leader instead of simply retrying within a loop. This can increase performance if
  26375. the option is enabled serverside.
  26376. <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>
  26377. </td>
  26378. </tr>
  26379. <tr>
  26380. <td>
  26381. <code>headers</code></br>
  26382. <em>
  26383. map[string]string
  26384. </em>
  26385. </td>
  26386. <td>
  26387. <em>(Optional)</em>
  26388. <p>Headers to be added in Vault request</p>
  26389. </td>
  26390. </tr>
  26391. </tbody>
  26392. </table>
  26393. <h3 id="external-secrets.io/v1beta1.VaultUserPassAuth">VaultUserPassAuth
  26394. </h3>
  26395. <p>
  26396. (<em>Appears on:</em>
  26397. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  26398. </p>
  26399. <p>
  26400. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  26401. with the username and password stored in a Kubernetes Secret resource.</p>
  26402. </p>
  26403. <table>
  26404. <thead>
  26405. <tr>
  26406. <th>Field</th>
  26407. <th>Description</th>
  26408. </tr>
  26409. </thead>
  26410. <tbody>
  26411. <tr>
  26412. <td>
  26413. <code>path</code></br>
  26414. <em>
  26415. string
  26416. </em>
  26417. </td>
  26418. <td>
  26419. <p>Path where the UserPassword authentication backend is mounted
  26420. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  26421. </td>
  26422. </tr>
  26423. <tr>
  26424. <td>
  26425. <code>username</code></br>
  26426. <em>
  26427. string
  26428. </em>
  26429. </td>
  26430. <td>
  26431. <p>Username is a username used to authenticate using the UserPass Vault
  26432. authentication method</p>
  26433. </td>
  26434. </tr>
  26435. <tr>
  26436. <td>
  26437. <code>secretRef</code></br>
  26438. <em>
  26439. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26440. External Secrets meta/v1.SecretKeySelector
  26441. </a>
  26442. </em>
  26443. </td>
  26444. <td>
  26445. <em>(Optional)</em>
  26446. <p>SecretRef to a key in a Secret resource containing password for the
  26447. user used to authenticate with Vault using the UserPass authentication
  26448. method</p>
  26449. </td>
  26450. </tr>
  26451. </tbody>
  26452. </table>
  26453. <h3 id="external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider
  26454. </h3>
  26455. <p>
  26456. (<em>Appears on:</em>
  26457. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26458. </p>
  26459. <p>
  26460. <p>WebhookCAProvider defines a location to fetch the certificate for the webhook provider.</p>
  26461. </p>
  26462. <table>
  26463. <thead>
  26464. <tr>
  26465. <th>Field</th>
  26466. <th>Description</th>
  26467. </tr>
  26468. </thead>
  26469. <tbody>
  26470. <tr>
  26471. <td>
  26472. <code>type</code></br>
  26473. <em>
  26474. <a href="#external-secrets.io/v1beta1.WebhookCAProviderType">
  26475. WebhookCAProviderType
  26476. </a>
  26477. </em>
  26478. </td>
  26479. <td>
  26480. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  26481. </td>
  26482. </tr>
  26483. <tr>
  26484. <td>
  26485. <code>name</code></br>
  26486. <em>
  26487. string
  26488. </em>
  26489. </td>
  26490. <td>
  26491. <p>The name of the object located at the provider type.</p>
  26492. </td>
  26493. </tr>
  26494. <tr>
  26495. <td>
  26496. <code>key</code></br>
  26497. <em>
  26498. string
  26499. </em>
  26500. </td>
  26501. <td>
  26502. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  26503. </td>
  26504. </tr>
  26505. <tr>
  26506. <td>
  26507. <code>namespace</code></br>
  26508. <em>
  26509. string
  26510. </em>
  26511. </td>
  26512. <td>
  26513. <em>(Optional)</em>
  26514. <p>The namespace the Provider type is in.</p>
  26515. </td>
  26516. </tr>
  26517. </tbody>
  26518. </table>
  26519. <h3 id="external-secrets.io/v1beta1.WebhookCAProviderType">WebhookCAProviderType
  26520. (<code>string</code> alias)</p></h3>
  26521. <p>
  26522. (<em>Appears on:</em>
  26523. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider</a>)
  26524. </p>
  26525. <p>
  26526. <p>WebhookCAProviderType defines the type of provider to use for CA certificates with Webhook providers.</p>
  26527. </p>
  26528. <table>
  26529. <thead>
  26530. <tr>
  26531. <th>Value</th>
  26532. <th>Description</th>
  26533. </tr>
  26534. </thead>
  26535. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  26536. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  26537. </td>
  26538. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  26539. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  26540. </td>
  26541. </tr></tbody>
  26542. </table>
  26543. <h3 id="external-secrets.io/v1beta1.WebhookProvider">WebhookProvider
  26544. </h3>
  26545. <p>
  26546. (<em>Appears on:</em>
  26547. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26548. </p>
  26549. <p>
  26550. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  26551. </p>
  26552. <table>
  26553. <thead>
  26554. <tr>
  26555. <th>Field</th>
  26556. <th>Description</th>
  26557. </tr>
  26558. </thead>
  26559. <tbody>
  26560. <tr>
  26561. <td>
  26562. <code>method</code></br>
  26563. <em>
  26564. string
  26565. </em>
  26566. </td>
  26567. <td>
  26568. <p>Webhook Method</p>
  26569. </td>
  26570. </tr>
  26571. <tr>
  26572. <td>
  26573. <code>url</code></br>
  26574. <em>
  26575. string
  26576. </em>
  26577. </td>
  26578. <td>
  26579. <p>Webhook url to call</p>
  26580. </td>
  26581. </tr>
  26582. <tr>
  26583. <td>
  26584. <code>headers</code></br>
  26585. <em>
  26586. map[string]string
  26587. </em>
  26588. </td>
  26589. <td>
  26590. <em>(Optional)</em>
  26591. <p>Headers</p>
  26592. </td>
  26593. </tr>
  26594. <tr>
  26595. <td>
  26596. <code>auth</code></br>
  26597. <em>
  26598. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">
  26599. AuthorizationProtocol
  26600. </a>
  26601. </em>
  26602. </td>
  26603. <td>
  26604. <em>(Optional)</em>
  26605. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  26606. </td>
  26607. </tr>
  26608. <tr>
  26609. <td>
  26610. <code>body</code></br>
  26611. <em>
  26612. string
  26613. </em>
  26614. </td>
  26615. <td>
  26616. <em>(Optional)</em>
  26617. <p>Body</p>
  26618. </td>
  26619. </tr>
  26620. <tr>
  26621. <td>
  26622. <code>timeout</code></br>
  26623. <em>
  26624. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  26625. Kubernetes meta/v1.Duration
  26626. </a>
  26627. </em>
  26628. </td>
  26629. <td>
  26630. <em>(Optional)</em>
  26631. <p>Timeout</p>
  26632. </td>
  26633. </tr>
  26634. <tr>
  26635. <td>
  26636. <code>result</code></br>
  26637. <em>
  26638. <a href="#external-secrets.io/v1beta1.WebhookResult">
  26639. WebhookResult
  26640. </a>
  26641. </em>
  26642. </td>
  26643. <td>
  26644. <p>Result formatting</p>
  26645. </td>
  26646. </tr>
  26647. <tr>
  26648. <td>
  26649. <code>secrets</code></br>
  26650. <em>
  26651. <a href="#external-secrets.io/v1beta1.WebhookSecret">
  26652. []WebhookSecret
  26653. </a>
  26654. </em>
  26655. </td>
  26656. <td>
  26657. <em>(Optional)</em>
  26658. <p>Secrets to fill in templates
  26659. These secrets will be passed to the templating function as key value pairs under the given name</p>
  26660. </td>
  26661. </tr>
  26662. <tr>
  26663. <td>
  26664. <code>caBundle</code></br>
  26665. <em>
  26666. []byte
  26667. </em>
  26668. </td>
  26669. <td>
  26670. <em>(Optional)</em>
  26671. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  26672. if the Server URL is using HTTPS protocol. This parameter is ignored for
  26673. plain HTTP protocol connection. If not set the system root certificates
  26674. are used to validate the TLS connection.</p>
  26675. </td>
  26676. </tr>
  26677. <tr>
  26678. <td>
  26679. <code>caProvider</code></br>
  26680. <em>
  26681. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">
  26682. WebhookCAProvider
  26683. </a>
  26684. </em>
  26685. </td>
  26686. <td>
  26687. <em>(Optional)</em>
  26688. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  26689. </td>
  26690. </tr>
  26691. </tbody>
  26692. </table>
  26693. <h3 id="external-secrets.io/v1beta1.WebhookResult">WebhookResult
  26694. </h3>
  26695. <p>
  26696. (<em>Appears on:</em>
  26697. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26698. </p>
  26699. <p>
  26700. <p>WebhookResult defines how to extract and format the result from the webhook response.</p>
  26701. </p>
  26702. <table>
  26703. <thead>
  26704. <tr>
  26705. <th>Field</th>
  26706. <th>Description</th>
  26707. </tr>
  26708. </thead>
  26709. <tbody>
  26710. <tr>
  26711. <td>
  26712. <code>jsonPath</code></br>
  26713. <em>
  26714. string
  26715. </em>
  26716. </td>
  26717. <td>
  26718. <em>(Optional)</em>
  26719. <p>Json path of return value</p>
  26720. </td>
  26721. </tr>
  26722. </tbody>
  26723. </table>
  26724. <h3 id="external-secrets.io/v1beta1.WebhookSecret">WebhookSecret
  26725. </h3>
  26726. <p>
  26727. (<em>Appears on:</em>
  26728. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  26729. </p>
  26730. <p>
  26731. <p>WebhookSecret defines a secret to be used in webhook templates.</p>
  26732. </p>
  26733. <table>
  26734. <thead>
  26735. <tr>
  26736. <th>Field</th>
  26737. <th>Description</th>
  26738. </tr>
  26739. </thead>
  26740. <tbody>
  26741. <tr>
  26742. <td>
  26743. <code>name</code></br>
  26744. <em>
  26745. string
  26746. </em>
  26747. </td>
  26748. <td>
  26749. <p>Name of this secret in templates</p>
  26750. </td>
  26751. </tr>
  26752. <tr>
  26753. <td>
  26754. <code>secretRef</code></br>
  26755. <em>
  26756. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26757. External Secrets meta/v1.SecretKeySelector
  26758. </a>
  26759. </em>
  26760. </td>
  26761. <td>
  26762. <p>Secret ref to fill in credentials</p>
  26763. </td>
  26764. </tr>
  26765. </tbody>
  26766. </table>
  26767. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerAuth">YandexCertificateManagerAuth
  26768. </h3>
  26769. <p>
  26770. (<em>Appears on:</em>
  26771. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  26772. </p>
  26773. <p>
  26774. <p>YandexCertificateManagerAuth defines authentication configuration for the Yandex Certificate Manager provider.</p>
  26775. </p>
  26776. <table>
  26777. <thead>
  26778. <tr>
  26779. <th>Field</th>
  26780. <th>Description</th>
  26781. </tr>
  26782. </thead>
  26783. <tbody>
  26784. <tr>
  26785. <td>
  26786. <code>authorizedKeySecretRef</code></br>
  26787. <em>
  26788. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26789. External Secrets meta/v1.SecretKeySelector
  26790. </a>
  26791. </em>
  26792. </td>
  26793. <td>
  26794. <em>(Optional)</em>
  26795. <p>The authorized key used for authentication</p>
  26796. </td>
  26797. </tr>
  26798. </tbody>
  26799. </table>
  26800. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">YandexCertificateManagerCAProvider
  26801. </h3>
  26802. <p>
  26803. (<em>Appears on:</em>
  26804. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  26805. </p>
  26806. <p>
  26807. <p>YandexCertificateManagerCAProvider defines CA certificate configuration for Yandex Certificate Manager.</p>
  26808. </p>
  26809. <table>
  26810. <thead>
  26811. <tr>
  26812. <th>Field</th>
  26813. <th>Description</th>
  26814. </tr>
  26815. </thead>
  26816. <tbody>
  26817. <tr>
  26818. <td>
  26819. <code>certSecretRef</code></br>
  26820. <em>
  26821. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26822. External Secrets meta/v1.SecretKeySelector
  26823. </a>
  26824. </em>
  26825. </td>
  26826. <td>
  26827. </td>
  26828. </tr>
  26829. </tbody>
  26830. </table>
  26831. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  26832. </h3>
  26833. <p>
  26834. (<em>Appears on:</em>
  26835. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26836. </p>
  26837. <p>
  26838. <p>YandexCertificateManagerProvider configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  26839. </p>
  26840. <table>
  26841. <thead>
  26842. <tr>
  26843. <th>Field</th>
  26844. <th>Description</th>
  26845. </tr>
  26846. </thead>
  26847. <tbody>
  26848. <tr>
  26849. <td>
  26850. <code>apiEndpoint</code></br>
  26851. <em>
  26852. string
  26853. </em>
  26854. </td>
  26855. <td>
  26856. <em>(Optional)</em>
  26857. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  26858. </td>
  26859. </tr>
  26860. <tr>
  26861. <td>
  26862. <code>auth</code></br>
  26863. <em>
  26864. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerAuth">
  26865. YandexCertificateManagerAuth
  26866. </a>
  26867. </em>
  26868. </td>
  26869. <td>
  26870. <p>Auth defines the information necessary to authenticate against Yandex Certificate Manager</p>
  26871. </td>
  26872. </tr>
  26873. <tr>
  26874. <td>
  26875. <code>caProvider</code></br>
  26876. <em>
  26877. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">
  26878. YandexCertificateManagerCAProvider
  26879. </a>
  26880. </em>
  26881. </td>
  26882. <td>
  26883. <em>(Optional)</em>
  26884. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  26885. </td>
  26886. </tr>
  26887. </tbody>
  26888. </table>
  26889. <h3 id="external-secrets.io/v1beta1.YandexLockboxAuth">YandexLockboxAuth
  26890. </h3>
  26891. <p>
  26892. (<em>Appears on:</em>
  26893. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  26894. </p>
  26895. <p>
  26896. <p>YandexLockboxAuth defines authentication configuration for the Yandex Lockbox provider.</p>
  26897. </p>
  26898. <table>
  26899. <thead>
  26900. <tr>
  26901. <th>Field</th>
  26902. <th>Description</th>
  26903. </tr>
  26904. </thead>
  26905. <tbody>
  26906. <tr>
  26907. <td>
  26908. <code>authorizedKeySecretRef</code></br>
  26909. <em>
  26910. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26911. External Secrets meta/v1.SecretKeySelector
  26912. </a>
  26913. </em>
  26914. </td>
  26915. <td>
  26916. <em>(Optional)</em>
  26917. <p>The authorized key used for authentication</p>
  26918. </td>
  26919. </tr>
  26920. </tbody>
  26921. </table>
  26922. <h3 id="external-secrets.io/v1beta1.YandexLockboxCAProvider">YandexLockboxCAProvider
  26923. </h3>
  26924. <p>
  26925. (<em>Appears on:</em>
  26926. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  26927. </p>
  26928. <p>
  26929. <p>YandexLockboxCAProvider defines CA certificate configuration for Yandex Lockbox.</p>
  26930. </p>
  26931. <table>
  26932. <thead>
  26933. <tr>
  26934. <th>Field</th>
  26935. <th>Description</th>
  26936. </tr>
  26937. </thead>
  26938. <tbody>
  26939. <tr>
  26940. <td>
  26941. <code>certSecretRef</code></br>
  26942. <em>
  26943. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26944. External Secrets meta/v1.SecretKeySelector
  26945. </a>
  26946. </em>
  26947. </td>
  26948. <td>
  26949. </td>
  26950. </tr>
  26951. </tbody>
  26952. </table>
  26953. <h3 id="external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider
  26954. </h3>
  26955. <p>
  26956. (<em>Appears on:</em>
  26957. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26958. </p>
  26959. <p>
  26960. <p>YandexLockboxProvider configures a store to sync secrets using the Yandex Lockbox provider.</p>
  26961. </p>
  26962. <table>
  26963. <thead>
  26964. <tr>
  26965. <th>Field</th>
  26966. <th>Description</th>
  26967. </tr>
  26968. </thead>
  26969. <tbody>
  26970. <tr>
  26971. <td>
  26972. <code>apiEndpoint</code></br>
  26973. <em>
  26974. string
  26975. </em>
  26976. </td>
  26977. <td>
  26978. <em>(Optional)</em>
  26979. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  26980. </td>
  26981. </tr>
  26982. <tr>
  26983. <td>
  26984. <code>auth</code></br>
  26985. <em>
  26986. <a href="#external-secrets.io/v1beta1.YandexLockboxAuth">
  26987. YandexLockboxAuth
  26988. </a>
  26989. </em>
  26990. </td>
  26991. <td>
  26992. <p>Auth defines the information necessary to authenticate against Yandex Lockbox</p>
  26993. </td>
  26994. </tr>
  26995. <tr>
  26996. <td>
  26997. <code>caProvider</code></br>
  26998. <em>
  26999. <a href="#external-secrets.io/v1beta1.YandexLockboxCAProvider">
  27000. YandexLockboxCAProvider
  27001. </a>
  27002. </em>
  27003. </td>
  27004. <td>
  27005. <em>(Optional)</em>
  27006. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  27007. </td>
  27008. </tr>
  27009. </tbody>
  27010. </table>
  27011. <hr/>
  27012. <h2 id="generators.external-secrets.io/v1alpha1">generators.external-secrets.io/v1alpha1</h2>
  27013. <p>
  27014. <p>Package v1alpha1 contains resources for generators</p>
  27015. </p>
  27016. <p>Resource Types:</p>
  27017. <ul></ul>
  27018. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken
  27019. </h3>
  27020. <p>
  27021. <p>ACRAccessToken returns an Azure Container Registry token
  27022. that can be used for pushing/pulling images.
  27023. Note: by default it will return an ACR Refresh Token with full access
  27024. (depending on the identity).
  27025. This can be scoped down to the repository level using .spec.scope.
  27026. In case scope is defined it will return an ACR Access Token.</p>
  27027. <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>
  27028. </p>
  27029. <table>
  27030. <thead>
  27031. <tr>
  27032. <th>Field</th>
  27033. <th>Description</th>
  27034. </tr>
  27035. </thead>
  27036. <tbody>
  27037. <tr>
  27038. <td>
  27039. <code>metadata</code></br>
  27040. <em>
  27041. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27042. Kubernetes meta/v1.ObjectMeta
  27043. </a>
  27044. </em>
  27045. </td>
  27046. <td>
  27047. Refer to the Kubernetes API documentation for the fields of the
  27048. <code>metadata</code> field.
  27049. </td>
  27050. </tr>
  27051. <tr>
  27052. <td>
  27053. <code>spec</code></br>
  27054. <em>
  27055. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  27056. ACRAccessTokenSpec
  27057. </a>
  27058. </em>
  27059. </td>
  27060. <td>
  27061. <br/>
  27062. <br/>
  27063. <table>
  27064. <tr>
  27065. <td>
  27066. <code>auth</code></br>
  27067. <em>
  27068. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  27069. ACRAuth
  27070. </a>
  27071. </em>
  27072. </td>
  27073. <td>
  27074. </td>
  27075. </tr>
  27076. <tr>
  27077. <td>
  27078. <code>tenantId</code></br>
  27079. <em>
  27080. string
  27081. </em>
  27082. </td>
  27083. <td>
  27084. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  27085. </td>
  27086. </tr>
  27087. <tr>
  27088. <td>
  27089. <code>registry</code></br>
  27090. <em>
  27091. string
  27092. </em>
  27093. </td>
  27094. <td>
  27095. <p>the domain name of the ACR registry
  27096. e.g. foobarexample.azurecr.io</p>
  27097. </td>
  27098. </tr>
  27099. <tr>
  27100. <td>
  27101. <code>scope</code></br>
  27102. <em>
  27103. string
  27104. </em>
  27105. </td>
  27106. <td>
  27107. <em>(Optional)</em>
  27108. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  27109. if not provided it will return a refresh token that has full scope.
  27110. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  27111. <p>examples:
  27112. repository:my-repository:pull,push
  27113. repository:my-repository:pull</p>
  27114. <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>
  27115. </td>
  27116. </tr>
  27117. <tr>
  27118. <td>
  27119. <code>environmentType</code></br>
  27120. <em>
  27121. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  27122. AzureEnvironmentType
  27123. </a>
  27124. </em>
  27125. </td>
  27126. <td>
  27127. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  27128. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  27129. 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>
  27130. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  27131. </td>
  27132. </tr>
  27133. </table>
  27134. </td>
  27135. </tr>
  27136. </tbody>
  27137. </table>
  27138. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec
  27139. </h3>
  27140. <p>
  27141. (<em>Appears on:</em>
  27142. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken</a>,
  27143. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27144. </p>
  27145. <p>
  27146. <p>ACRAccessTokenSpec defines how to generate the access token
  27147. e.g. how to authenticate and which registry to use.
  27148. 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>
  27149. </p>
  27150. <table>
  27151. <thead>
  27152. <tr>
  27153. <th>Field</th>
  27154. <th>Description</th>
  27155. </tr>
  27156. </thead>
  27157. <tbody>
  27158. <tr>
  27159. <td>
  27160. <code>auth</code></br>
  27161. <em>
  27162. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  27163. ACRAuth
  27164. </a>
  27165. </em>
  27166. </td>
  27167. <td>
  27168. </td>
  27169. </tr>
  27170. <tr>
  27171. <td>
  27172. <code>tenantId</code></br>
  27173. <em>
  27174. string
  27175. </em>
  27176. </td>
  27177. <td>
  27178. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  27179. </td>
  27180. </tr>
  27181. <tr>
  27182. <td>
  27183. <code>registry</code></br>
  27184. <em>
  27185. string
  27186. </em>
  27187. </td>
  27188. <td>
  27189. <p>the domain name of the ACR registry
  27190. e.g. foobarexample.azurecr.io</p>
  27191. </td>
  27192. </tr>
  27193. <tr>
  27194. <td>
  27195. <code>scope</code></br>
  27196. <em>
  27197. string
  27198. </em>
  27199. </td>
  27200. <td>
  27201. <em>(Optional)</em>
  27202. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  27203. if not provided it will return a refresh token that has full scope.
  27204. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  27205. <p>examples:
  27206. repository:my-repository:pull,push
  27207. repository:my-repository:pull</p>
  27208. <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>
  27209. </td>
  27210. </tr>
  27211. <tr>
  27212. <td>
  27213. <code>environmentType</code></br>
  27214. <em>
  27215. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  27216. AzureEnvironmentType
  27217. </a>
  27218. </em>
  27219. </td>
  27220. <td>
  27221. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  27222. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  27223. 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>
  27224. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  27225. </td>
  27226. </tr>
  27227. </tbody>
  27228. </table>
  27229. <h3 id="generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth
  27230. </h3>
  27231. <p>
  27232. (<em>Appears on:</em>
  27233. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  27234. </p>
  27235. <p>
  27236. <p>ACRAuth defines the authentication methods for Azure Container Registry.</p>
  27237. </p>
  27238. <table>
  27239. <thead>
  27240. <tr>
  27241. <th>Field</th>
  27242. <th>Description</th>
  27243. </tr>
  27244. </thead>
  27245. <tbody>
  27246. <tr>
  27247. <td>
  27248. <code>servicePrincipal</code></br>
  27249. <em>
  27250. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">
  27251. AzureACRServicePrincipalAuth
  27252. </a>
  27253. </em>
  27254. </td>
  27255. <td>
  27256. <em>(Optional)</em>
  27257. <p>ServicePrincipal uses Azure Service Principal credentials to authenticate with Azure.</p>
  27258. </td>
  27259. </tr>
  27260. <tr>
  27261. <td>
  27262. <code>managedIdentity</code></br>
  27263. <em>
  27264. <a href="#generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">
  27265. AzureACRManagedIdentityAuth
  27266. </a>
  27267. </em>
  27268. </td>
  27269. <td>
  27270. <em>(Optional)</em>
  27271. <p>ManagedIdentity uses Azure Managed Identity to authenticate with Azure.</p>
  27272. </td>
  27273. </tr>
  27274. <tr>
  27275. <td>
  27276. <code>workloadIdentity</code></br>
  27277. <em>
  27278. <a href="#generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">
  27279. AzureACRWorkloadIdentityAuth
  27280. </a>
  27281. </em>
  27282. </td>
  27283. <td>
  27284. <em>(Optional)</em>
  27285. <p>WorkloadIdentity uses Azure Workload Identity to authenticate with Azure.</p>
  27286. </td>
  27287. </tr>
  27288. </tbody>
  27289. </table>
  27290. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth
  27291. </h3>
  27292. <p>
  27293. (<em>Appears on:</em>
  27294. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec</a>,
  27295. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  27296. </p>
  27297. <p>
  27298. <p>AWSAuth tells the controller how to do authentication with aws.
  27299. Only one of secretRef or jwt can be specified.
  27300. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  27301. </p>
  27302. <table>
  27303. <thead>
  27304. <tr>
  27305. <th>Field</th>
  27306. <th>Description</th>
  27307. </tr>
  27308. </thead>
  27309. <tbody>
  27310. <tr>
  27311. <td>
  27312. <code>secretRef</code></br>
  27313. <em>
  27314. <a href="#generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">
  27315. AWSAuthSecretRef
  27316. </a>
  27317. </em>
  27318. </td>
  27319. <td>
  27320. <em>(Optional)</em>
  27321. </td>
  27322. </tr>
  27323. <tr>
  27324. <td>
  27325. <code>jwt</code></br>
  27326. <em>
  27327. <a href="#generators.external-secrets.io/v1alpha1.AWSJWTAuth">
  27328. AWSJWTAuth
  27329. </a>
  27330. </em>
  27331. </td>
  27332. <td>
  27333. <em>(Optional)</em>
  27334. </td>
  27335. </tr>
  27336. </tbody>
  27337. </table>
  27338. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">AWSAuthSecretRef
  27339. </h3>
  27340. <p>
  27341. (<em>Appears on:</em>
  27342. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  27343. </p>
  27344. <p>
  27345. <p>AWSAuthSecretRef holds secret references for AWS credentials
  27346. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  27347. </p>
  27348. <table>
  27349. <thead>
  27350. <tr>
  27351. <th>Field</th>
  27352. <th>Description</th>
  27353. </tr>
  27354. </thead>
  27355. <tbody>
  27356. <tr>
  27357. <td>
  27358. <code>accessKeyIDSecretRef</code></br>
  27359. <em>
  27360. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27361. External Secrets meta/v1.SecretKeySelector
  27362. </a>
  27363. </em>
  27364. </td>
  27365. <td>
  27366. <p>The AccessKeyID is used for authentication</p>
  27367. </td>
  27368. </tr>
  27369. <tr>
  27370. <td>
  27371. <code>secretAccessKeySecretRef</code></br>
  27372. <em>
  27373. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27374. External Secrets meta/v1.SecretKeySelector
  27375. </a>
  27376. </em>
  27377. </td>
  27378. <td>
  27379. <p>The SecretAccessKey is used for authentication</p>
  27380. </td>
  27381. </tr>
  27382. <tr>
  27383. <td>
  27384. <code>sessionTokenSecretRef</code></br>
  27385. <em>
  27386. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27387. External Secrets meta/v1.SecretKeySelector
  27388. </a>
  27389. </em>
  27390. </td>
  27391. <td>
  27392. <p>The SessionToken used for authentication
  27393. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  27394. 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>
  27395. </td>
  27396. </tr>
  27397. </tbody>
  27398. </table>
  27399. <h3 id="generators.external-secrets.io/v1alpha1.AWSJWTAuth">AWSJWTAuth
  27400. </h3>
  27401. <p>
  27402. (<em>Appears on:</em>
  27403. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  27404. </p>
  27405. <p>
  27406. <p>AWSJWTAuth provides configuration to authenticate against AWS using service account tokens.</p>
  27407. </p>
  27408. <table>
  27409. <thead>
  27410. <tr>
  27411. <th>Field</th>
  27412. <th>Description</th>
  27413. </tr>
  27414. </thead>
  27415. <tbody>
  27416. <tr>
  27417. <td>
  27418. <code>serviceAccountRef</code></br>
  27419. <em>
  27420. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27421. External Secrets meta/v1.ServiceAccountSelector
  27422. </a>
  27423. </em>
  27424. </td>
  27425. <td>
  27426. </td>
  27427. </tr>
  27428. </tbody>
  27429. </table>
  27430. <h3 id="generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol
  27431. </h3>
  27432. <p>
  27433. (<em>Appears on:</em>
  27434. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  27435. </p>
  27436. <p>
  27437. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  27438. </p>
  27439. <table>
  27440. <thead>
  27441. <tr>
  27442. <th>Field</th>
  27443. <th>Description</th>
  27444. </tr>
  27445. </thead>
  27446. <tbody>
  27447. <tr>
  27448. <td>
  27449. <code>ntlm</code></br>
  27450. <em>
  27451. <a href="#generators.external-secrets.io/v1alpha1.NTLMProtocol">
  27452. NTLMProtocol
  27453. </a>
  27454. </em>
  27455. </td>
  27456. <td>
  27457. <em>(Optional)</em>
  27458. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  27459. </td>
  27460. </tr>
  27461. </tbody>
  27462. </table>
  27463. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">AzureACRManagedIdentityAuth
  27464. </h3>
  27465. <p>
  27466. (<em>Appears on:</em>
  27467. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27468. </p>
  27469. <p>
  27470. <p>AzureACRManagedIdentityAuth defines the configuration for using Azure Managed Identity authentication.</p>
  27471. </p>
  27472. <table>
  27473. <thead>
  27474. <tr>
  27475. <th>Field</th>
  27476. <th>Description</th>
  27477. </tr>
  27478. </thead>
  27479. <tbody>
  27480. <tr>
  27481. <td>
  27482. <code>identityId</code></br>
  27483. <em>
  27484. string
  27485. </em>
  27486. </td>
  27487. <td>
  27488. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  27489. </td>
  27490. </tr>
  27491. </tbody>
  27492. </table>
  27493. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth
  27494. </h3>
  27495. <p>
  27496. (<em>Appears on:</em>
  27497. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27498. </p>
  27499. <p>
  27500. <p>AzureACRServicePrincipalAuth defines the configuration for using Azure Service Principal authentication.</p>
  27501. </p>
  27502. <table>
  27503. <thead>
  27504. <tr>
  27505. <th>Field</th>
  27506. <th>Description</th>
  27507. </tr>
  27508. </thead>
  27509. <tbody>
  27510. <tr>
  27511. <td>
  27512. <code>secretRef</code></br>
  27513. <em>
  27514. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">
  27515. AzureACRServicePrincipalAuthSecretRef
  27516. </a>
  27517. </em>
  27518. </td>
  27519. <td>
  27520. </td>
  27521. </tr>
  27522. </tbody>
  27523. </table>
  27524. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">AzureACRServicePrincipalAuthSecretRef
  27525. </h3>
  27526. <p>
  27527. (<em>Appears on:</em>
  27528. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth</a>)
  27529. </p>
  27530. <p>
  27531. <p>AzureACRServicePrincipalAuthSecretRef defines the secret references for Azure Service Principal authentication.
  27532. It uses static credentials stored in a Kind=Secret.</p>
  27533. </p>
  27534. <table>
  27535. <thead>
  27536. <tr>
  27537. <th>Field</th>
  27538. <th>Description</th>
  27539. </tr>
  27540. </thead>
  27541. <tbody>
  27542. <tr>
  27543. <td>
  27544. <code>clientId</code></br>
  27545. <em>
  27546. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27547. External Secrets meta/v1.SecretKeySelector
  27548. </a>
  27549. </em>
  27550. </td>
  27551. <td>
  27552. <p>The Azure clientId of the service principle used for authentication.</p>
  27553. </td>
  27554. </tr>
  27555. <tr>
  27556. <td>
  27557. <code>clientSecret</code></br>
  27558. <em>
  27559. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27560. External Secrets meta/v1.SecretKeySelector
  27561. </a>
  27562. </em>
  27563. </td>
  27564. <td>
  27565. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  27566. </td>
  27567. </tr>
  27568. </tbody>
  27569. </table>
  27570. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">AzureACRWorkloadIdentityAuth
  27571. </h3>
  27572. <p>
  27573. (<em>Appears on:</em>
  27574. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  27575. </p>
  27576. <p>
  27577. <p>AzureACRWorkloadIdentityAuth defines the configuration for using Azure Workload Identity authentication.</p>
  27578. </p>
  27579. <table>
  27580. <thead>
  27581. <tr>
  27582. <th>Field</th>
  27583. <th>Description</th>
  27584. </tr>
  27585. </thead>
  27586. <tbody>
  27587. <tr>
  27588. <td>
  27589. <code>serviceAccountRef</code></br>
  27590. <em>
  27591. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27592. External Secrets meta/v1.ServiceAccountSelector
  27593. </a>
  27594. </em>
  27595. </td>
  27596. <td>
  27597. <em>(Optional)</em>
  27598. <p>ServiceAccountRef specified the service account
  27599. that should be used when authenticating with WorkloadIdentity.</p>
  27600. </td>
  27601. </tr>
  27602. </tbody>
  27603. </table>
  27604. <h3 id="generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecret">BeyondtrustWorkloadCredentialsDynamicSecret
  27605. </h3>
  27606. <p>
  27607. <p>BeyondtrustWorkloadCredentialsDynamicSecret represents a generator that requests dynamic credentials from BeyondTrust Workload Credentials.
  27608. This generator calls the BeyondTrust Workload Credentials API to generate fresh, temporary credentials
  27609. (such as AWS STS credentials) each time an ExternalSecret is refreshed.
  27610. Dynamic secret definitions must be created in BeyondTrust Workload Credentials before they can be referenced.
  27611. 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>
  27612. </p>
  27613. <table>
  27614. <thead>
  27615. <tr>
  27616. <th>Field</th>
  27617. <th>Description</th>
  27618. </tr>
  27619. </thead>
  27620. <tbody>
  27621. <tr>
  27622. <td>
  27623. <code>metadata</code></br>
  27624. <em>
  27625. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27626. Kubernetes meta/v1.ObjectMeta
  27627. </a>
  27628. </em>
  27629. </td>
  27630. <td>
  27631. Refer to the Kubernetes API documentation for the fields of the
  27632. <code>metadata</code> field.
  27633. </td>
  27634. </tr>
  27635. <tr>
  27636. <td>
  27637. <code>spec</code></br>
  27638. <em>
  27639. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">
  27640. BeyondtrustWorkloadCredentialsDynamicSecretSpec
  27641. </a>
  27642. </em>
  27643. </td>
  27644. <td>
  27645. <br/>
  27646. <br/>
  27647. <table>
  27648. <tr>
  27649. <td>
  27650. <code>controller</code></br>
  27651. <em>
  27652. string
  27653. </em>
  27654. </td>
  27655. <td>
  27656. <em>(Optional)</em>
  27657. <p>Controller selects the controller that should handle this generator.
  27658. Leave empty to use the default controller.</p>
  27659. </td>
  27660. </tr>
  27661. <tr>
  27662. <td>
  27663. <code>provider</code></br>
  27664. <em>
  27665. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  27666. BeyondtrustWorkloadCredentialsProvider
  27667. </a>
  27668. </em>
  27669. </td>
  27670. <td>
  27671. <p>Provider contains the BeyondtrustWorkloadCredentials provider configuration including authentication,
  27672. server connection details, and the folder path to the dynamic secret definition.
  27673. The folderPath should point to a dynamic secret definition that has been created in
  27674. BeyondTrust Workload Credentials (e.g., &ldquo;production/aws-temp&rdquo;).
  27675. 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>
  27676. </td>
  27677. </tr>
  27678. <tr>
  27679. <td>
  27680. <code>retrySettings</code></br>
  27681. <em>
  27682. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  27683. SecretStoreRetrySettings
  27684. </a>
  27685. </em>
  27686. </td>
  27687. <td>
  27688. <em>(Optional)</em>
  27689. <p>RetrySettings configures exponential backoff for failed API requests.
  27690. If not specified, uses the default retry settings.</p>
  27691. </td>
  27692. </tr>
  27693. </table>
  27694. </td>
  27695. </tr>
  27696. </tbody>
  27697. </table>
  27698. <h3 id="generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">BeyondtrustWorkloadCredentialsDynamicSecretSpec
  27699. </h3>
  27700. <p>
  27701. (<em>Appears on:</em>
  27702. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecret">BeyondtrustWorkloadCredentialsDynamicSecret</a>,
  27703. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27704. </p>
  27705. <p>
  27706. <p>BeyondtrustWorkloadCredentialsDynamicSecretSpec defines the desired spec for BeyondtrustWorkloadCredentials dynamic generator.
  27707. This generator enables obtaining temporary, short-lived credentials from BeyondTrust Workload Credentials.
  27708. 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>
  27709. </p>
  27710. <table>
  27711. <thead>
  27712. <tr>
  27713. <th>Field</th>
  27714. <th>Description</th>
  27715. </tr>
  27716. </thead>
  27717. <tbody>
  27718. <tr>
  27719. <td>
  27720. <code>controller</code></br>
  27721. <em>
  27722. string
  27723. </em>
  27724. </td>
  27725. <td>
  27726. <em>(Optional)</em>
  27727. <p>Controller selects the controller that should handle this generator.
  27728. Leave empty to use the default controller.</p>
  27729. </td>
  27730. </tr>
  27731. <tr>
  27732. <td>
  27733. <code>provider</code></br>
  27734. <em>
  27735. <a href="#external-secrets.io/v1.BeyondtrustWorkloadCredentialsProvider">
  27736. BeyondtrustWorkloadCredentialsProvider
  27737. </a>
  27738. </em>
  27739. </td>
  27740. <td>
  27741. <p>Provider contains the BeyondtrustWorkloadCredentials provider configuration including authentication,
  27742. server connection details, and the folder path to the dynamic secret definition.
  27743. The folderPath should point to a dynamic secret definition that has been created in
  27744. BeyondTrust Workload Credentials (e.g., &ldquo;production/aws-temp&rdquo;).
  27745. 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>
  27746. </td>
  27747. </tr>
  27748. <tr>
  27749. <td>
  27750. <code>retrySettings</code></br>
  27751. <em>
  27752. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  27753. SecretStoreRetrySettings
  27754. </a>
  27755. </em>
  27756. </td>
  27757. <td>
  27758. <em>(Optional)</em>
  27759. <p>RetrySettings configures exponential backoff for failed API requests.
  27760. If not specified, uses the default retry settings.</p>
  27761. </td>
  27762. </tr>
  27763. </tbody>
  27764. </table>
  27765. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken
  27766. </h3>
  27767. <p>
  27768. <p>CloudsmithAccessToken generates Cloudsmith access token using OIDC authentication</p>
  27769. </p>
  27770. <table>
  27771. <thead>
  27772. <tr>
  27773. <th>Field</th>
  27774. <th>Description</th>
  27775. </tr>
  27776. </thead>
  27777. <tbody>
  27778. <tr>
  27779. <td>
  27780. <code>metadata</code></br>
  27781. <em>
  27782. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27783. Kubernetes meta/v1.ObjectMeta
  27784. </a>
  27785. </em>
  27786. </td>
  27787. <td>
  27788. Refer to the Kubernetes API documentation for the fields of the
  27789. <code>metadata</code> field.
  27790. </td>
  27791. </tr>
  27792. <tr>
  27793. <td>
  27794. <code>spec</code></br>
  27795. <em>
  27796. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  27797. CloudsmithAccessTokenSpec
  27798. </a>
  27799. </em>
  27800. </td>
  27801. <td>
  27802. <br/>
  27803. <br/>
  27804. <table>
  27805. <tr>
  27806. <td>
  27807. <code>apiUrl</code></br>
  27808. <em>
  27809. string
  27810. </em>
  27811. </td>
  27812. <td>
  27813. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  27814. </td>
  27815. </tr>
  27816. <tr>
  27817. <td>
  27818. <code>orgSlug</code></br>
  27819. <em>
  27820. string
  27821. </em>
  27822. </td>
  27823. <td>
  27824. <p>OrgSlug is the organization slug in Cloudsmith</p>
  27825. </td>
  27826. </tr>
  27827. <tr>
  27828. <td>
  27829. <code>serviceSlug</code></br>
  27830. <em>
  27831. string
  27832. </em>
  27833. </td>
  27834. <td>
  27835. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  27836. </td>
  27837. </tr>
  27838. <tr>
  27839. <td>
  27840. <code>serviceAccountRef</code></br>
  27841. <em>
  27842. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27843. External Secrets meta/v1.ServiceAccountSelector
  27844. </a>
  27845. </em>
  27846. </td>
  27847. <td>
  27848. <p>Name of the service account you are federating with</p>
  27849. </td>
  27850. </tr>
  27851. </table>
  27852. </td>
  27853. </tr>
  27854. </tbody>
  27855. </table>
  27856. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">CloudsmithAccessTokenSpec
  27857. </h3>
  27858. <p>
  27859. (<em>Appears on:</em>
  27860. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken</a>,
  27861. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27862. </p>
  27863. <p>
  27864. <p>CloudsmithAccessTokenSpec defines the configuration for generating a Cloudsmith access token using OIDC authentication.</p>
  27865. </p>
  27866. <table>
  27867. <thead>
  27868. <tr>
  27869. <th>Field</th>
  27870. <th>Description</th>
  27871. </tr>
  27872. </thead>
  27873. <tbody>
  27874. <tr>
  27875. <td>
  27876. <code>apiUrl</code></br>
  27877. <em>
  27878. string
  27879. </em>
  27880. </td>
  27881. <td>
  27882. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  27883. </td>
  27884. </tr>
  27885. <tr>
  27886. <td>
  27887. <code>orgSlug</code></br>
  27888. <em>
  27889. string
  27890. </em>
  27891. </td>
  27892. <td>
  27893. <p>OrgSlug is the organization slug in Cloudsmith</p>
  27894. </td>
  27895. </tr>
  27896. <tr>
  27897. <td>
  27898. <code>serviceSlug</code></br>
  27899. <em>
  27900. string
  27901. </em>
  27902. </td>
  27903. <td>
  27904. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  27905. </td>
  27906. </tr>
  27907. <tr>
  27908. <td>
  27909. <code>serviceAccountRef</code></br>
  27910. <em>
  27911. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27912. External Secrets meta/v1.ServiceAccountSelector
  27913. </a>
  27914. </em>
  27915. </td>
  27916. <td>
  27917. <p>Name of the service account you are federating with</p>
  27918. </td>
  27919. </tr>
  27920. </tbody>
  27921. </table>
  27922. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator
  27923. </h3>
  27924. <p>
  27925. <p>ClusterGenerator represents a cluster-wide generator which can be referenced as part of <code>generatorRef</code> fields.</p>
  27926. </p>
  27927. <table>
  27928. <thead>
  27929. <tr>
  27930. <th>Field</th>
  27931. <th>Description</th>
  27932. </tr>
  27933. </thead>
  27934. <tbody>
  27935. <tr>
  27936. <td>
  27937. <code>metadata</code></br>
  27938. <em>
  27939. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27940. Kubernetes meta/v1.ObjectMeta
  27941. </a>
  27942. </em>
  27943. </td>
  27944. <td>
  27945. Refer to the Kubernetes API documentation for the fields of the
  27946. <code>metadata</code> field.
  27947. </td>
  27948. </tr>
  27949. <tr>
  27950. <td>
  27951. <code>spec</code></br>
  27952. <em>
  27953. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">
  27954. ClusterGeneratorSpec
  27955. </a>
  27956. </em>
  27957. </td>
  27958. <td>
  27959. <br/>
  27960. <br/>
  27961. <table>
  27962. <tr>
  27963. <td>
  27964. <code>kind</code></br>
  27965. <em>
  27966. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  27967. GeneratorKind
  27968. </a>
  27969. </em>
  27970. </td>
  27971. <td>
  27972. <p>Kind the kind of this generator.</p>
  27973. </td>
  27974. </tr>
  27975. <tr>
  27976. <td>
  27977. <code>generator</code></br>
  27978. <em>
  27979. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  27980. GeneratorSpec
  27981. </a>
  27982. </em>
  27983. </td>
  27984. <td>
  27985. <p>Generator the spec for this generator, must match the kind.</p>
  27986. </td>
  27987. </tr>
  27988. </table>
  27989. </td>
  27990. </tr>
  27991. </tbody>
  27992. </table>
  27993. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec
  27994. </h3>
  27995. <p>
  27996. (<em>Appears on:</em>
  27997. <a href="#generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator</a>)
  27998. </p>
  27999. <p>
  28000. <p>ClusterGeneratorSpec defines the desired state of a ClusterGenerator.</p>
  28001. </p>
  28002. <table>
  28003. <thead>
  28004. <tr>
  28005. <th>Field</th>
  28006. <th>Description</th>
  28007. </tr>
  28008. </thead>
  28009. <tbody>
  28010. <tr>
  28011. <td>
  28012. <code>kind</code></br>
  28013. <em>
  28014. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  28015. GeneratorKind
  28016. </a>
  28017. </em>
  28018. </td>
  28019. <td>
  28020. <p>Kind the kind of this generator.</p>
  28021. </td>
  28022. </tr>
  28023. <tr>
  28024. <td>
  28025. <code>generator</code></br>
  28026. <em>
  28027. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  28028. GeneratorSpec
  28029. </a>
  28030. </em>
  28031. </td>
  28032. <td>
  28033. <p>Generator the spec for this generator, must match the kind.</p>
  28034. </td>
  28035. </tr>
  28036. </tbody>
  28037. </table>
  28038. <h3 id="generators.external-secrets.io/v1alpha1.ControllerClassResource">ControllerClassResource
  28039. </h3>
  28040. <p>
  28041. <p>ControllerClassResource defines a resource that can be assigned to a specific controller class.</p>
  28042. </p>
  28043. <table>
  28044. <thead>
  28045. <tr>
  28046. <th>Field</th>
  28047. <th>Description</th>
  28048. </tr>
  28049. </thead>
  28050. <tbody>
  28051. <tr>
  28052. <td>
  28053. <code>spec</code></br>
  28054. <em>
  28055. struct{ControllerClass string &#34;json:\&#34;controller\&#34;&#34;}
  28056. </em>
  28057. </td>
  28058. <td>
  28059. <br/>
  28060. <br/>
  28061. <table>
  28062. <tr>
  28063. <td>
  28064. <code>controller</code></br>
  28065. <em>
  28066. string
  28067. </em>
  28068. </td>
  28069. <td>
  28070. </td>
  28071. </tr>
  28072. </table>
  28073. </td>
  28074. </tr>
  28075. </tbody>
  28076. </table>
  28077. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken
  28078. </h3>
  28079. <p>
  28080. <p>ECRAuthorizationToken uses the GetAuthorizationToken API to retrieve an authorization token.
  28081. The authorization token is valid for 12 hours.
  28082. The authorizationToken returned is a base64 encoded string that can be decoded
  28083. and used in a docker login command to authenticate to a registry.
  28084. 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>
  28085. </p>
  28086. <table>
  28087. <thead>
  28088. <tr>
  28089. <th>Field</th>
  28090. <th>Description</th>
  28091. </tr>
  28092. </thead>
  28093. <tbody>
  28094. <tr>
  28095. <td>
  28096. <code>metadata</code></br>
  28097. <em>
  28098. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28099. Kubernetes meta/v1.ObjectMeta
  28100. </a>
  28101. </em>
  28102. </td>
  28103. <td>
  28104. Refer to the Kubernetes API documentation for the fields of the
  28105. <code>metadata</code> field.
  28106. </td>
  28107. </tr>
  28108. <tr>
  28109. <td>
  28110. <code>spec</code></br>
  28111. <em>
  28112. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  28113. ECRAuthorizationTokenSpec
  28114. </a>
  28115. </em>
  28116. </td>
  28117. <td>
  28118. <br/>
  28119. <br/>
  28120. <table>
  28121. <tr>
  28122. <td>
  28123. <code>region</code></br>
  28124. <em>
  28125. string
  28126. </em>
  28127. </td>
  28128. <td>
  28129. <p>Region specifies the region to operate in.</p>
  28130. </td>
  28131. </tr>
  28132. <tr>
  28133. <td>
  28134. <code>auth</code></br>
  28135. <em>
  28136. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28137. AWSAuth
  28138. </a>
  28139. </em>
  28140. </td>
  28141. <td>
  28142. <em>(Optional)</em>
  28143. <p>Auth defines how to authenticate with AWS</p>
  28144. </td>
  28145. </tr>
  28146. <tr>
  28147. <td>
  28148. <code>role</code></br>
  28149. <em>
  28150. string
  28151. </em>
  28152. </td>
  28153. <td>
  28154. <em>(Optional)</em>
  28155. <p>You can assume a role before making calls to the
  28156. desired AWS service.</p>
  28157. </td>
  28158. </tr>
  28159. <tr>
  28160. <td>
  28161. <code>scope</code></br>
  28162. <em>
  28163. string
  28164. </em>
  28165. </td>
  28166. <td>
  28167. <em>(Optional)</em>
  28168. <p>Scope specifies the ECR service scope.
  28169. Valid options are private and public.</p>
  28170. </td>
  28171. </tr>
  28172. </table>
  28173. </td>
  28174. </tr>
  28175. </tbody>
  28176. </table>
  28177. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec
  28178. </h3>
  28179. <p>
  28180. (<em>Appears on:</em>
  28181. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken</a>,
  28182. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28183. </p>
  28184. <p>
  28185. <p>ECRAuthorizationTokenSpec defines the desired state to generate an AWS ECR authorization token.</p>
  28186. </p>
  28187. <table>
  28188. <thead>
  28189. <tr>
  28190. <th>Field</th>
  28191. <th>Description</th>
  28192. </tr>
  28193. </thead>
  28194. <tbody>
  28195. <tr>
  28196. <td>
  28197. <code>region</code></br>
  28198. <em>
  28199. string
  28200. </em>
  28201. </td>
  28202. <td>
  28203. <p>Region specifies the region to operate in.</p>
  28204. </td>
  28205. </tr>
  28206. <tr>
  28207. <td>
  28208. <code>auth</code></br>
  28209. <em>
  28210. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28211. AWSAuth
  28212. </a>
  28213. </em>
  28214. </td>
  28215. <td>
  28216. <em>(Optional)</em>
  28217. <p>Auth defines how to authenticate with AWS</p>
  28218. </td>
  28219. </tr>
  28220. <tr>
  28221. <td>
  28222. <code>role</code></br>
  28223. <em>
  28224. string
  28225. </em>
  28226. </td>
  28227. <td>
  28228. <em>(Optional)</em>
  28229. <p>You can assume a role before making calls to the
  28230. desired AWS service.</p>
  28231. </td>
  28232. </tr>
  28233. <tr>
  28234. <td>
  28235. <code>scope</code></br>
  28236. <em>
  28237. string
  28238. </em>
  28239. </td>
  28240. <td>
  28241. <em>(Optional)</em>
  28242. <p>Scope specifies the ECR service scope.
  28243. Valid options are private and public.</p>
  28244. </td>
  28245. </tr>
  28246. </tbody>
  28247. </table>
  28248. <h3 id="generators.external-secrets.io/v1alpha1.Fake">Fake
  28249. </h3>
  28250. <p>
  28251. <p>Fake generator is used for testing. It lets you define
  28252. a static set of credentials that is always returned.</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>metadata</code></br>
  28265. <em>
  28266. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28267. Kubernetes meta/v1.ObjectMeta
  28268. </a>
  28269. </em>
  28270. </td>
  28271. <td>
  28272. Refer to the Kubernetes API documentation for the fields of the
  28273. <code>metadata</code> field.
  28274. </td>
  28275. </tr>
  28276. <tr>
  28277. <td>
  28278. <code>spec</code></br>
  28279. <em>
  28280. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  28281. FakeSpec
  28282. </a>
  28283. </em>
  28284. </td>
  28285. <td>
  28286. <br/>
  28287. <br/>
  28288. <table>
  28289. <tr>
  28290. <td>
  28291. <code>controller</code></br>
  28292. <em>
  28293. string
  28294. </em>
  28295. </td>
  28296. <td>
  28297. <em>(Optional)</em>
  28298. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  28299. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  28300. </td>
  28301. </tr>
  28302. <tr>
  28303. <td>
  28304. <code>data</code></br>
  28305. <em>
  28306. map[string]string
  28307. </em>
  28308. </td>
  28309. <td>
  28310. <p>Data defines the static data returned
  28311. by this generator.</p>
  28312. </td>
  28313. </tr>
  28314. </table>
  28315. </td>
  28316. </tr>
  28317. </tbody>
  28318. </table>
  28319. <h3 id="generators.external-secrets.io/v1alpha1.FakeSpec">FakeSpec
  28320. </h3>
  28321. <p>
  28322. (<em>Appears on:</em>
  28323. <a href="#generators.external-secrets.io/v1alpha1.Fake">Fake</a>,
  28324. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28325. </p>
  28326. <p>
  28327. <p>FakeSpec contains the static data.</p>
  28328. </p>
  28329. <table>
  28330. <thead>
  28331. <tr>
  28332. <th>Field</th>
  28333. <th>Description</th>
  28334. </tr>
  28335. </thead>
  28336. <tbody>
  28337. <tr>
  28338. <td>
  28339. <code>controller</code></br>
  28340. <em>
  28341. string
  28342. </em>
  28343. </td>
  28344. <td>
  28345. <em>(Optional)</em>
  28346. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  28347. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  28348. </td>
  28349. </tr>
  28350. <tr>
  28351. <td>
  28352. <code>data</code></br>
  28353. <em>
  28354. map[string]string
  28355. </em>
  28356. </td>
  28357. <td>
  28358. <p>Data defines the static data returned
  28359. by this generator.</p>
  28360. </td>
  28361. </tr>
  28362. </tbody>
  28363. </table>
  28364. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth
  28365. </h3>
  28366. <p>
  28367. (<em>Appears on:</em>
  28368. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec</a>)
  28369. </p>
  28370. <p>
  28371. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform.</p>
  28372. </p>
  28373. <table>
  28374. <thead>
  28375. <tr>
  28376. <th>Field</th>
  28377. <th>Description</th>
  28378. </tr>
  28379. </thead>
  28380. <tbody>
  28381. <tr>
  28382. <td>
  28383. <code>secretRef</code></br>
  28384. <em>
  28385. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">
  28386. GCPSMAuthSecretRef
  28387. </a>
  28388. </em>
  28389. </td>
  28390. <td>
  28391. <em>(Optional)</em>
  28392. </td>
  28393. </tr>
  28394. <tr>
  28395. <td>
  28396. <code>workloadIdentity</code></br>
  28397. <em>
  28398. <a href="#generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">
  28399. GCPWorkloadIdentity
  28400. </a>
  28401. </em>
  28402. </td>
  28403. <td>
  28404. <em>(Optional)</em>
  28405. </td>
  28406. </tr>
  28407. <tr>
  28408. <td>
  28409. <code>workloadIdentityFederation</code></br>
  28410. <em>
  28411. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  28412. GCPWorkloadIdentityFederation
  28413. </a>
  28414. </em>
  28415. </td>
  28416. <td>
  28417. <em>(Optional)</em>
  28418. </td>
  28419. </tr>
  28420. </tbody>
  28421. </table>
  28422. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  28423. </h3>
  28424. <p>
  28425. (<em>Appears on:</em>
  28426. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  28427. </p>
  28428. <p>
  28429. <p>GCPSMAuthSecretRef defines the reference to a secret containing Google Cloud Platform credentials.</p>
  28430. </p>
  28431. <table>
  28432. <thead>
  28433. <tr>
  28434. <th>Field</th>
  28435. <th>Description</th>
  28436. </tr>
  28437. </thead>
  28438. <tbody>
  28439. <tr>
  28440. <td>
  28441. <code>secretAccessKeySecretRef</code></br>
  28442. <em>
  28443. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28444. External Secrets meta/v1.SecretKeySelector
  28445. </a>
  28446. </em>
  28447. </td>
  28448. <td>
  28449. <em>(Optional)</em>
  28450. <p>The SecretAccessKey is used for authentication</p>
  28451. </td>
  28452. </tr>
  28453. </tbody>
  28454. </table>
  28455. <h3 id="generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">GCPWorkloadIdentity
  28456. </h3>
  28457. <p>
  28458. (<em>Appears on:</em>
  28459. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  28460. </p>
  28461. <p>
  28462. <p>GCPWorkloadIdentity defines the configuration for using GCP Workload Identity authentication.</p>
  28463. </p>
  28464. <table>
  28465. <thead>
  28466. <tr>
  28467. <th>Field</th>
  28468. <th>Description</th>
  28469. </tr>
  28470. </thead>
  28471. <tbody>
  28472. <tr>
  28473. <td>
  28474. <code>serviceAccountRef</code></br>
  28475. <em>
  28476. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28477. External Secrets meta/v1.ServiceAccountSelector
  28478. </a>
  28479. </em>
  28480. </td>
  28481. <td>
  28482. </td>
  28483. </tr>
  28484. <tr>
  28485. <td>
  28486. <code>clusterLocation</code></br>
  28487. <em>
  28488. string
  28489. </em>
  28490. </td>
  28491. <td>
  28492. </td>
  28493. </tr>
  28494. <tr>
  28495. <td>
  28496. <code>clusterName</code></br>
  28497. <em>
  28498. string
  28499. </em>
  28500. </td>
  28501. <td>
  28502. </td>
  28503. </tr>
  28504. <tr>
  28505. <td>
  28506. <code>clusterProjectID</code></br>
  28507. <em>
  28508. string
  28509. </em>
  28510. </td>
  28511. <td>
  28512. </td>
  28513. </tr>
  28514. </tbody>
  28515. </table>
  28516. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken
  28517. </h3>
  28518. <p>
  28519. <p>GCRAccessToken generates an GCP access token
  28520. that can be used to authenticate with GCR.</p>
  28521. </p>
  28522. <table>
  28523. <thead>
  28524. <tr>
  28525. <th>Field</th>
  28526. <th>Description</th>
  28527. </tr>
  28528. </thead>
  28529. <tbody>
  28530. <tr>
  28531. <td>
  28532. <code>metadata</code></br>
  28533. <em>
  28534. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28535. Kubernetes meta/v1.ObjectMeta
  28536. </a>
  28537. </em>
  28538. </td>
  28539. <td>
  28540. Refer to the Kubernetes API documentation for the fields of the
  28541. <code>metadata</code> field.
  28542. </td>
  28543. </tr>
  28544. <tr>
  28545. <td>
  28546. <code>spec</code></br>
  28547. <em>
  28548. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  28549. GCRAccessTokenSpec
  28550. </a>
  28551. </em>
  28552. </td>
  28553. <td>
  28554. <br/>
  28555. <br/>
  28556. <table>
  28557. <tr>
  28558. <td>
  28559. <code>auth</code></br>
  28560. <em>
  28561. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  28562. GCPSMAuth
  28563. </a>
  28564. </em>
  28565. </td>
  28566. <td>
  28567. <p>Auth defines the means for authenticating with GCP</p>
  28568. </td>
  28569. </tr>
  28570. <tr>
  28571. <td>
  28572. <code>projectID</code></br>
  28573. <em>
  28574. string
  28575. </em>
  28576. </td>
  28577. <td>
  28578. <p>ProjectID defines which project to use to authenticate with</p>
  28579. </td>
  28580. </tr>
  28581. </table>
  28582. </td>
  28583. </tr>
  28584. </tbody>
  28585. </table>
  28586. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec
  28587. </h3>
  28588. <p>
  28589. (<em>Appears on:</em>
  28590. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken</a>,
  28591. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  28592. </p>
  28593. <p>
  28594. <p>GCRAccessTokenSpec defines the desired state to generate a Google Container Registry access token.</p>
  28595. </p>
  28596. <table>
  28597. <thead>
  28598. <tr>
  28599. <th>Field</th>
  28600. <th>Description</th>
  28601. </tr>
  28602. </thead>
  28603. <tbody>
  28604. <tr>
  28605. <td>
  28606. <code>auth</code></br>
  28607. <em>
  28608. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  28609. GCPSMAuth
  28610. </a>
  28611. </em>
  28612. </td>
  28613. <td>
  28614. <p>Auth defines the means for authenticating with GCP</p>
  28615. </td>
  28616. </tr>
  28617. <tr>
  28618. <td>
  28619. <code>projectID</code></br>
  28620. <em>
  28621. string
  28622. </em>
  28623. </td>
  28624. <td>
  28625. <p>ProjectID defines which project to use to authenticate with</p>
  28626. </td>
  28627. </tr>
  28628. </tbody>
  28629. </table>
  28630. <h3 id="generators.external-secrets.io/v1alpha1.Generator">Generator
  28631. </h3>
  28632. <p>
  28633. <p>Generator is the common interface for all generators that is actually used to generate whatever is needed.</p>
  28634. </p>
  28635. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorKind">GeneratorKind
  28636. (<code>string</code> alias)</p></h3>
  28637. <p>
  28638. (<em>Appears on:</em>
  28639. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  28640. </p>
  28641. <p>
  28642. <p>GeneratorKind represents a kind of generator.</p>
  28643. </p>
  28644. <table>
  28645. <thead>
  28646. <tr>
  28647. <th>Value</th>
  28648. <th>Description</th>
  28649. </tr>
  28650. </thead>
  28651. <tbody><tr><td><p>&#34;ACRAccessToken&#34;</p></td>
  28652. <td><p>GeneratorKindACRAccessToken represents an Azure Container Registry access token generator.</p>
  28653. </td>
  28654. </tr><tr><td><p>&#34;BeyondtrustWorkloadCredentialsDynamicSecret&#34;</p></td>
  28655. <td><p>GeneratorKindBeyondtrustWorkloadCredentialsDynamicSecret represents a BeyondTrust Workload Credentials dynamic secret generator.</p>
  28656. </td>
  28657. </tr><tr><td><p>&#34;CloudsmithAccessToken&#34;</p></td>
  28658. <td><p>GeneratorKindCloudsmithAccessToken represents a Cloudsmith access token generator.</p>
  28659. </td>
  28660. </tr><tr><td><p>&#34;ECRAuthorizationToken&#34;</p></td>
  28661. <td><p>GeneratorKindECRAuthorizationToken represents an AWS ECR authorization token generator.</p>
  28662. </td>
  28663. </tr><tr><td><p>&#34;Fake&#34;</p></td>
  28664. <td><p>GeneratorKindFake represents a fake generator for testing purposes.</p>
  28665. </td>
  28666. </tr><tr><td><p>&#34;GCRAccessToken&#34;</p></td>
  28667. <td><p>GeneratorKindGCRAccessToken represents a Google Container Registry access token generator.</p>
  28668. </td>
  28669. </tr><tr><td><p>&#34;GithubAccessToken&#34;</p></td>
  28670. <td><p>GeneratorKindGithubAccessToken represents a GitHub access token generator.</p>
  28671. </td>
  28672. </tr><tr><td><p>&#34;Grafana&#34;</p></td>
  28673. <td><p>GeneratorKindGrafana represents a Grafana token generator.</p>
  28674. </td>
  28675. </tr><tr><td><p>&#34;MFA&#34;</p></td>
  28676. <td><p>GeneratorKindMFA represents a Multi-Factor Authentication generator.</p>
  28677. </td>
  28678. </tr><tr><td><p>&#34;Password&#34;</p></td>
  28679. <td><p>GeneratorKindPassword represents a password generator.</p>
  28680. </td>
  28681. </tr><tr><td><p>&#34;QuayAccessToken&#34;</p></td>
  28682. <td><p>GeneratorKindQuayAccessToken represents a Quay access token generator.</p>
  28683. </td>
  28684. </tr><tr><td><p>&#34;SSHKey&#34;</p></td>
  28685. <td><p>GeneratorKindSSHKey represents an SSH key generator.</p>
  28686. </td>
  28687. </tr><tr><td><p>&#34;STSSessionToken&#34;</p></td>
  28688. <td><p>GeneratorKindSTSSessionToken represents an AWS STS session token generator.</p>
  28689. </td>
  28690. </tr><tr><td><p>&#34;UUID&#34;</p></td>
  28691. <td><p>GeneratorKindUUID represents a UUID generator.</p>
  28692. </td>
  28693. </tr><tr><td><p>&#34;VaultDynamicSecret&#34;</p></td>
  28694. <td><p>GeneratorKindVaultDynamicSecret represents a HashiCorp Vault dynamic secret generator.</p>
  28695. </td>
  28696. </tr><tr><td><p>&#34;Webhook&#34;</p></td>
  28697. <td><p>GeneratorKindWebhook represents a webhook-based generator.</p>
  28698. </td>
  28699. </tr></tbody>
  28700. </table>
  28701. <h3 id="&lt;UNKNOWN_API_GROUP&gt;.GeneratorProviderState">GeneratorProviderState
  28702. </h3>
  28703. <p>
  28704. <p>GeneratorProviderState represents the state of a generator provider that can be stored and retrieved.</p>
  28705. </p>
  28706. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec
  28707. </h3>
  28708. <p>
  28709. (<em>Appears on:</em>
  28710. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  28711. </p>
  28712. <p>
  28713. <p>GeneratorSpec defines the configuration for various supported generator types.</p>
  28714. </p>
  28715. <table>
  28716. <thead>
  28717. <tr>
  28718. <th>Field</th>
  28719. <th>Description</th>
  28720. </tr>
  28721. </thead>
  28722. <tbody>
  28723. <tr>
  28724. <td>
  28725. <code>acrAccessTokenSpec</code></br>
  28726. <em>
  28727. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  28728. ACRAccessTokenSpec
  28729. </a>
  28730. </em>
  28731. </td>
  28732. <td>
  28733. </td>
  28734. </tr>
  28735. <tr>
  28736. <td>
  28737. <code>beyondtrustWorkloadCredentialsDynamicSecretSpec</code></br>
  28738. <em>
  28739. <a href="#generators.external-secrets.io/v1alpha1.BeyondtrustWorkloadCredentialsDynamicSecretSpec">
  28740. BeyondtrustWorkloadCredentialsDynamicSecretSpec
  28741. </a>
  28742. </em>
  28743. </td>
  28744. <td>
  28745. </td>
  28746. </tr>
  28747. <tr>
  28748. <td>
  28749. <code>cloudsmithAccessTokenSpec</code></br>
  28750. <em>
  28751. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  28752. CloudsmithAccessTokenSpec
  28753. </a>
  28754. </em>
  28755. </td>
  28756. <td>
  28757. </td>
  28758. </tr>
  28759. <tr>
  28760. <td>
  28761. <code>ecrAuthorizationTokenSpec</code></br>
  28762. <em>
  28763. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  28764. ECRAuthorizationTokenSpec
  28765. </a>
  28766. </em>
  28767. </td>
  28768. <td>
  28769. </td>
  28770. </tr>
  28771. <tr>
  28772. <td>
  28773. <code>fakeSpec</code></br>
  28774. <em>
  28775. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  28776. FakeSpec
  28777. </a>
  28778. </em>
  28779. </td>
  28780. <td>
  28781. </td>
  28782. </tr>
  28783. <tr>
  28784. <td>
  28785. <code>gcrAccessTokenSpec</code></br>
  28786. <em>
  28787. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  28788. GCRAccessTokenSpec
  28789. </a>
  28790. </em>
  28791. </td>
  28792. <td>
  28793. </td>
  28794. </tr>
  28795. <tr>
  28796. <td>
  28797. <code>githubAccessTokenSpec</code></br>
  28798. <em>
  28799. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  28800. GithubAccessTokenSpec
  28801. </a>
  28802. </em>
  28803. </td>
  28804. <td>
  28805. </td>
  28806. </tr>
  28807. <tr>
  28808. <td>
  28809. <code>quayAccessTokenSpec</code></br>
  28810. <em>
  28811. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  28812. QuayAccessTokenSpec
  28813. </a>
  28814. </em>
  28815. </td>
  28816. <td>
  28817. </td>
  28818. </tr>
  28819. <tr>
  28820. <td>
  28821. <code>passwordSpec</code></br>
  28822. <em>
  28823. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  28824. PasswordSpec
  28825. </a>
  28826. </em>
  28827. </td>
  28828. <td>
  28829. </td>
  28830. </tr>
  28831. <tr>
  28832. <td>
  28833. <code>sshKeySpec</code></br>
  28834. <em>
  28835. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  28836. SSHKeySpec
  28837. </a>
  28838. </em>
  28839. </td>
  28840. <td>
  28841. </td>
  28842. </tr>
  28843. <tr>
  28844. <td>
  28845. <code>stsSessionTokenSpec</code></br>
  28846. <em>
  28847. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  28848. STSSessionTokenSpec
  28849. </a>
  28850. </em>
  28851. </td>
  28852. <td>
  28853. </td>
  28854. </tr>
  28855. <tr>
  28856. <td>
  28857. <code>uuidSpec</code></br>
  28858. <em>
  28859. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  28860. UUIDSpec
  28861. </a>
  28862. </em>
  28863. </td>
  28864. <td>
  28865. </td>
  28866. </tr>
  28867. <tr>
  28868. <td>
  28869. <code>vaultDynamicSecretSpec</code></br>
  28870. <em>
  28871. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  28872. VaultDynamicSecretSpec
  28873. </a>
  28874. </em>
  28875. </td>
  28876. <td>
  28877. </td>
  28878. </tr>
  28879. <tr>
  28880. <td>
  28881. <code>webhookSpec</code></br>
  28882. <em>
  28883. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  28884. WebhookSpec
  28885. </a>
  28886. </em>
  28887. </td>
  28888. <td>
  28889. </td>
  28890. </tr>
  28891. <tr>
  28892. <td>
  28893. <code>grafanaSpec</code></br>
  28894. <em>
  28895. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  28896. GrafanaSpec
  28897. </a>
  28898. </em>
  28899. </td>
  28900. <td>
  28901. </td>
  28902. </tr>
  28903. <tr>
  28904. <td>
  28905. <code>mfaSpec</code></br>
  28906. <em>
  28907. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  28908. MFASpec
  28909. </a>
  28910. </em>
  28911. </td>
  28912. <td>
  28913. </td>
  28914. </tr>
  28915. </tbody>
  28916. </table>
  28917. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState
  28918. </h3>
  28919. <p>
  28920. <p>GeneratorState represents the state created and managed by a generator resource.</p>
  28921. </p>
  28922. <table>
  28923. <thead>
  28924. <tr>
  28925. <th>Field</th>
  28926. <th>Description</th>
  28927. </tr>
  28928. </thead>
  28929. <tbody>
  28930. <tr>
  28931. <td>
  28932. <code>metadata</code></br>
  28933. <em>
  28934. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28935. Kubernetes meta/v1.ObjectMeta
  28936. </a>
  28937. </em>
  28938. </td>
  28939. <td>
  28940. Refer to the Kubernetes API documentation for the fields of the
  28941. <code>metadata</code> field.
  28942. </td>
  28943. </tr>
  28944. <tr>
  28945. <td>
  28946. <code>spec</code></br>
  28947. <em>
  28948. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateSpec">
  28949. GeneratorStateSpec
  28950. </a>
  28951. </em>
  28952. </td>
  28953. <td>
  28954. <br/>
  28955. <br/>
  28956. <table>
  28957. <tr>
  28958. <td>
  28959. <code>garbageCollectionDeadline</code></br>
  28960. <em>
  28961. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  28962. Kubernetes meta/v1.Time
  28963. </a>
  28964. </em>
  28965. </td>
  28966. <td>
  28967. <p>GarbageCollectionDeadline is the time after which the generator state
  28968. will be deleted.
  28969. It is set by the controller which creates the generator state and
  28970. can be set configured by the user.
  28971. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  28972. </td>
  28973. </tr>
  28974. <tr>
  28975. <td>
  28976. <code>resource</code></br>
  28977. <em>
  28978. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  28979. </em>
  28980. </td>
  28981. <td>
  28982. <p>Resource is the generator manifest that produced the state.
  28983. It is a snapshot of the generator manifest at the time the state was produced.
  28984. This manifest will be used to delete the resource. Any configuration that is referenced
  28985. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  28986. be blocked by a finalizer.</p>
  28987. </td>
  28988. </tr>
  28989. <tr>
  28990. <td>
  28991. <code>state</code></br>
  28992. <em>
  28993. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  28994. </em>
  28995. </td>
  28996. <td>
  28997. <p>State is the state that was produced by the generator implementation.</p>
  28998. </td>
  28999. </tr>
  29000. </table>
  29001. </td>
  29002. </tr>
  29003. <tr>
  29004. <td>
  29005. <code>status</code></br>
  29006. <em>
  29007. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">
  29008. GeneratorStateStatus
  29009. </a>
  29010. </em>
  29011. </td>
  29012. <td>
  29013. </td>
  29014. </tr>
  29015. </tbody>
  29016. </table>
  29017. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">GeneratorStateConditionType
  29018. (<code>string</code> alias)</p></h3>
  29019. <p>
  29020. (<em>Appears on:</em>
  29021. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition</a>)
  29022. </p>
  29023. <p>
  29024. <p>GeneratorStateConditionType represents the type of condition for a generator state.</p>
  29025. </p>
  29026. <table>
  29027. <thead>
  29028. <tr>
  29029. <th>Value</th>
  29030. <th>Description</th>
  29031. </tr>
  29032. </thead>
  29033. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  29034. <td><p>GeneratorStateReady indicates the generator state is ready and available.</p>
  29035. </td>
  29036. </tr></tbody>
  29037. </table>
  29038. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateSpec">GeneratorStateSpec
  29039. </h3>
  29040. <p>
  29041. (<em>Appears on:</em>
  29042. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  29043. </p>
  29044. <p>
  29045. <p>GeneratorStateSpec defines the desired state of a generator state resource.</p>
  29046. </p>
  29047. <table>
  29048. <thead>
  29049. <tr>
  29050. <th>Field</th>
  29051. <th>Description</th>
  29052. </tr>
  29053. </thead>
  29054. <tbody>
  29055. <tr>
  29056. <td>
  29057. <code>garbageCollectionDeadline</code></br>
  29058. <em>
  29059. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29060. Kubernetes meta/v1.Time
  29061. </a>
  29062. </em>
  29063. </td>
  29064. <td>
  29065. <p>GarbageCollectionDeadline is the time after which the generator state
  29066. will be deleted.
  29067. It is set by the controller which creates the generator state and
  29068. can be set configured by the user.
  29069. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  29070. </td>
  29071. </tr>
  29072. <tr>
  29073. <td>
  29074. <code>resource</code></br>
  29075. <em>
  29076. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29077. </em>
  29078. </td>
  29079. <td>
  29080. <p>Resource is the generator manifest that produced the state.
  29081. It is a snapshot of the generator manifest at the time the state was produced.
  29082. This manifest will be used to delete the resource. Any configuration that is referenced
  29083. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  29084. be blocked by a finalizer.</p>
  29085. </td>
  29086. </tr>
  29087. <tr>
  29088. <td>
  29089. <code>state</code></br>
  29090. <em>
  29091. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29092. </em>
  29093. </td>
  29094. <td>
  29095. <p>State is the state that was produced by the generator implementation.</p>
  29096. </td>
  29097. </tr>
  29098. </tbody>
  29099. </table>
  29100. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus
  29101. </h3>
  29102. <p>
  29103. (<em>Appears on:</em>
  29104. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  29105. </p>
  29106. <p>
  29107. <p>GeneratorStateStatus defines the observed state of a generator state resource.</p>
  29108. </p>
  29109. <table>
  29110. <thead>
  29111. <tr>
  29112. <th>Field</th>
  29113. <th>Description</th>
  29114. </tr>
  29115. </thead>
  29116. <tbody>
  29117. <tr>
  29118. <td>
  29119. <code>conditions</code></br>
  29120. <em>
  29121. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">
  29122. []GeneratorStateStatusCondition
  29123. </a>
  29124. </em>
  29125. </td>
  29126. <td>
  29127. </td>
  29128. </tr>
  29129. </tbody>
  29130. </table>
  29131. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition
  29132. </h3>
  29133. <p>
  29134. (<em>Appears on:</em>
  29135. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus</a>)
  29136. </p>
  29137. <p>
  29138. <p>GeneratorStateStatusCondition represents the observed condition of a generator state.</p>
  29139. </p>
  29140. <table>
  29141. <thead>
  29142. <tr>
  29143. <th>Field</th>
  29144. <th>Description</th>
  29145. </tr>
  29146. </thead>
  29147. <tbody>
  29148. <tr>
  29149. <td>
  29150. <code>type</code></br>
  29151. <em>
  29152. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">
  29153. GeneratorStateConditionType
  29154. </a>
  29155. </em>
  29156. </td>
  29157. <td>
  29158. </td>
  29159. </tr>
  29160. <tr>
  29161. <td>
  29162. <code>status</code></br>
  29163. <em>
  29164. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  29165. Kubernetes core/v1.ConditionStatus
  29166. </a>
  29167. </em>
  29168. </td>
  29169. <td>
  29170. </td>
  29171. </tr>
  29172. <tr>
  29173. <td>
  29174. <code>reason</code></br>
  29175. <em>
  29176. string
  29177. </em>
  29178. </td>
  29179. <td>
  29180. <em>(Optional)</em>
  29181. </td>
  29182. </tr>
  29183. <tr>
  29184. <td>
  29185. <code>message</code></br>
  29186. <em>
  29187. string
  29188. </em>
  29189. </td>
  29190. <td>
  29191. <em>(Optional)</em>
  29192. </td>
  29193. </tr>
  29194. <tr>
  29195. <td>
  29196. <code>lastTransitionTime</code></br>
  29197. <em>
  29198. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29199. Kubernetes meta/v1.Time
  29200. </a>
  29201. </em>
  29202. </td>
  29203. <td>
  29204. <em>(Optional)</em>
  29205. </td>
  29206. </tr>
  29207. </tbody>
  29208. </table>
  29209. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken
  29210. </h3>
  29211. <p>
  29212. <p>GithubAccessToken generates ghs_ accessToken</p>
  29213. </p>
  29214. <table>
  29215. <thead>
  29216. <tr>
  29217. <th>Field</th>
  29218. <th>Description</th>
  29219. </tr>
  29220. </thead>
  29221. <tbody>
  29222. <tr>
  29223. <td>
  29224. <code>metadata</code></br>
  29225. <em>
  29226. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29227. Kubernetes meta/v1.ObjectMeta
  29228. </a>
  29229. </em>
  29230. </td>
  29231. <td>
  29232. Refer to the Kubernetes API documentation for the fields of the
  29233. <code>metadata</code> field.
  29234. </td>
  29235. </tr>
  29236. <tr>
  29237. <td>
  29238. <code>spec</code></br>
  29239. <em>
  29240. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  29241. GithubAccessTokenSpec
  29242. </a>
  29243. </em>
  29244. </td>
  29245. <td>
  29246. <br/>
  29247. <br/>
  29248. <table>
  29249. <tr>
  29250. <td>
  29251. <code>url</code></br>
  29252. <em>
  29253. string
  29254. </em>
  29255. </td>
  29256. <td>
  29257. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  29258. </td>
  29259. </tr>
  29260. <tr>
  29261. <td>
  29262. <code>appID</code></br>
  29263. <em>
  29264. string
  29265. </em>
  29266. </td>
  29267. <td>
  29268. </td>
  29269. </tr>
  29270. <tr>
  29271. <td>
  29272. <code>installID</code></br>
  29273. <em>
  29274. string
  29275. </em>
  29276. </td>
  29277. <td>
  29278. </td>
  29279. </tr>
  29280. <tr>
  29281. <td>
  29282. <code>repositories</code></br>
  29283. <em>
  29284. []string
  29285. </em>
  29286. </td>
  29287. <td>
  29288. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  29289. is installed to.</p>
  29290. </td>
  29291. </tr>
  29292. <tr>
  29293. <td>
  29294. <code>permissions</code></br>
  29295. <em>
  29296. map[string]string
  29297. </em>
  29298. </td>
  29299. <td>
  29300. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  29301. </td>
  29302. </tr>
  29303. <tr>
  29304. <td>
  29305. <code>auth</code></br>
  29306. <em>
  29307. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  29308. GithubAuth
  29309. </a>
  29310. </em>
  29311. </td>
  29312. <td>
  29313. <p>Auth configures how ESO authenticates with a Github instance.</p>
  29314. </td>
  29315. </tr>
  29316. </table>
  29317. </td>
  29318. </tr>
  29319. </tbody>
  29320. </table>
  29321. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec
  29322. </h3>
  29323. <p>
  29324. (<em>Appears on:</em>
  29325. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29326. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken</a>)
  29327. </p>
  29328. <p>
  29329. <p>GithubAccessTokenSpec defines the desired state to generate a GitHub access token.</p>
  29330. </p>
  29331. <table>
  29332. <thead>
  29333. <tr>
  29334. <th>Field</th>
  29335. <th>Description</th>
  29336. </tr>
  29337. </thead>
  29338. <tbody>
  29339. <tr>
  29340. <td>
  29341. <code>url</code></br>
  29342. <em>
  29343. string
  29344. </em>
  29345. </td>
  29346. <td>
  29347. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  29348. </td>
  29349. </tr>
  29350. <tr>
  29351. <td>
  29352. <code>appID</code></br>
  29353. <em>
  29354. string
  29355. </em>
  29356. </td>
  29357. <td>
  29358. </td>
  29359. </tr>
  29360. <tr>
  29361. <td>
  29362. <code>installID</code></br>
  29363. <em>
  29364. string
  29365. </em>
  29366. </td>
  29367. <td>
  29368. </td>
  29369. </tr>
  29370. <tr>
  29371. <td>
  29372. <code>repositories</code></br>
  29373. <em>
  29374. []string
  29375. </em>
  29376. </td>
  29377. <td>
  29378. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  29379. is installed to.</p>
  29380. </td>
  29381. </tr>
  29382. <tr>
  29383. <td>
  29384. <code>permissions</code></br>
  29385. <em>
  29386. map[string]string
  29387. </em>
  29388. </td>
  29389. <td>
  29390. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  29391. </td>
  29392. </tr>
  29393. <tr>
  29394. <td>
  29395. <code>auth</code></br>
  29396. <em>
  29397. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  29398. GithubAuth
  29399. </a>
  29400. </em>
  29401. </td>
  29402. <td>
  29403. <p>Auth configures how ESO authenticates with a Github instance.</p>
  29404. </td>
  29405. </tr>
  29406. </tbody>
  29407. </table>
  29408. <h3 id="generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth
  29409. </h3>
  29410. <p>
  29411. (<em>Appears on:</em>
  29412. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec</a>)
  29413. </p>
  29414. <p>
  29415. <p>GithubAuth defines the authentication configuration for GitHub access.</p>
  29416. </p>
  29417. <table>
  29418. <thead>
  29419. <tr>
  29420. <th>Field</th>
  29421. <th>Description</th>
  29422. </tr>
  29423. </thead>
  29424. <tbody>
  29425. <tr>
  29426. <td>
  29427. <code>privateKey</code></br>
  29428. <em>
  29429. <a href="#generators.external-secrets.io/v1alpha1.GithubSecretRef">
  29430. GithubSecretRef
  29431. </a>
  29432. </em>
  29433. </td>
  29434. <td>
  29435. </td>
  29436. </tr>
  29437. </tbody>
  29438. </table>
  29439. <h3 id="generators.external-secrets.io/v1alpha1.GithubSecretRef">GithubSecretRef
  29440. </h3>
  29441. <p>
  29442. (<em>Appears on:</em>
  29443. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth</a>)
  29444. </p>
  29445. <p>
  29446. <p>GithubSecretRef references a secret containing GitHub credentials.</p>
  29447. </p>
  29448. <table>
  29449. <thead>
  29450. <tr>
  29451. <th>Field</th>
  29452. <th>Description</th>
  29453. </tr>
  29454. </thead>
  29455. <tbody>
  29456. <tr>
  29457. <td>
  29458. <code>secretRef</code></br>
  29459. <em>
  29460. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29461. External Secrets meta/v1.SecretKeySelector
  29462. </a>
  29463. </em>
  29464. </td>
  29465. <td>
  29466. </td>
  29467. </tr>
  29468. </tbody>
  29469. </table>
  29470. <h3 id="generators.external-secrets.io/v1alpha1.Grafana">Grafana
  29471. </h3>
  29472. <p>
  29473. <p>Grafana represents a generator for Grafana service account tokens.</p>
  29474. </p>
  29475. <table>
  29476. <thead>
  29477. <tr>
  29478. <th>Field</th>
  29479. <th>Description</th>
  29480. </tr>
  29481. </thead>
  29482. <tbody>
  29483. <tr>
  29484. <td>
  29485. <code>metadata</code></br>
  29486. <em>
  29487. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29488. Kubernetes meta/v1.ObjectMeta
  29489. </a>
  29490. </em>
  29491. </td>
  29492. <td>
  29493. Refer to the Kubernetes API documentation for the fields of the
  29494. <code>metadata</code> field.
  29495. </td>
  29496. </tr>
  29497. <tr>
  29498. <td>
  29499. <code>spec</code></br>
  29500. <em>
  29501. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  29502. GrafanaSpec
  29503. </a>
  29504. </em>
  29505. </td>
  29506. <td>
  29507. <br/>
  29508. <br/>
  29509. <table>
  29510. <tr>
  29511. <td>
  29512. <code>url</code></br>
  29513. <em>
  29514. string
  29515. </em>
  29516. </td>
  29517. <td>
  29518. <p>URL is the URL of the Grafana instance.</p>
  29519. </td>
  29520. </tr>
  29521. <tr>
  29522. <td>
  29523. <code>auth</code></br>
  29524. <em>
  29525. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  29526. GrafanaAuth
  29527. </a>
  29528. </em>
  29529. </td>
  29530. <td>
  29531. <p>Auth is the authentication configuration to authenticate
  29532. against the Grafana instance.</p>
  29533. </td>
  29534. </tr>
  29535. <tr>
  29536. <td>
  29537. <code>serviceAccount</code></br>
  29538. <em>
  29539. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  29540. GrafanaServiceAccount
  29541. </a>
  29542. </em>
  29543. </td>
  29544. <td>
  29545. <p>ServiceAccount is the configuration for the service account that
  29546. is supposed to be generated by the generator.</p>
  29547. </td>
  29548. </tr>
  29549. </table>
  29550. </td>
  29551. </tr>
  29552. </tbody>
  29553. </table>
  29554. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth
  29555. </h3>
  29556. <p>
  29557. (<em>Appears on:</em>
  29558. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  29559. </p>
  29560. <p>
  29561. <p>GrafanaAuth defines the authentication methods for connecting to a Grafana instance.</p>
  29562. </p>
  29563. <table>
  29564. <thead>
  29565. <tr>
  29566. <th>Field</th>
  29567. <th>Description</th>
  29568. </tr>
  29569. </thead>
  29570. <tbody>
  29571. <tr>
  29572. <td>
  29573. <code>token</code></br>
  29574. <em>
  29575. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  29576. SecretKeySelector
  29577. </a>
  29578. </em>
  29579. </td>
  29580. <td>
  29581. <em>(Optional)</em>
  29582. <p>A service account token used to authenticate against the Grafana instance.
  29583. Note: you need a token which has elevated permissions to create service accounts.
  29584. See here for the documentation on basic roles offered by Grafana:
  29585. <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>
  29586. </td>
  29587. </tr>
  29588. <tr>
  29589. <td>
  29590. <code>basic</code></br>
  29591. <em>
  29592. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">
  29593. GrafanaBasicAuth
  29594. </a>
  29595. </em>
  29596. </td>
  29597. <td>
  29598. <em>(Optional)</em>
  29599. <p>Basic auth credentials used to authenticate against the Grafana instance.
  29600. Note: you need a token which has elevated permissions to create service accounts.
  29601. See here for the documentation on basic roles offered by Grafana:
  29602. <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>
  29603. </td>
  29604. </tr>
  29605. </tbody>
  29606. </table>
  29607. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth
  29608. </h3>
  29609. <p>
  29610. (<em>Appears on:</em>
  29611. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>)
  29612. </p>
  29613. <p>
  29614. <p>GrafanaBasicAuth defines the credentials for basic authentication with Grafana.</p>
  29615. </p>
  29616. <table>
  29617. <thead>
  29618. <tr>
  29619. <th>Field</th>
  29620. <th>Description</th>
  29621. </tr>
  29622. </thead>
  29623. <tbody>
  29624. <tr>
  29625. <td>
  29626. <code>username</code></br>
  29627. <em>
  29628. string
  29629. </em>
  29630. </td>
  29631. <td>
  29632. <p>A basic auth username used to authenticate against the Grafana instance.</p>
  29633. </td>
  29634. </tr>
  29635. <tr>
  29636. <td>
  29637. <code>password</code></br>
  29638. <em>
  29639. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  29640. SecretKeySelector
  29641. </a>
  29642. </em>
  29643. </td>
  29644. <td>
  29645. <p>A basic auth password used to authenticate against the Grafana instance.</p>
  29646. </td>
  29647. </tr>
  29648. </tbody>
  29649. </table>
  29650. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">GrafanaServiceAccount
  29651. </h3>
  29652. <p>
  29653. (<em>Appears on:</em>
  29654. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  29655. </p>
  29656. <p>
  29657. <p>GrafanaServiceAccount defines the configuration for a Grafana service account to be created.</p>
  29658. </p>
  29659. <table>
  29660. <thead>
  29661. <tr>
  29662. <th>Field</th>
  29663. <th>Description</th>
  29664. </tr>
  29665. </thead>
  29666. <tbody>
  29667. <tr>
  29668. <td>
  29669. <code>name</code></br>
  29670. <em>
  29671. string
  29672. </em>
  29673. </td>
  29674. <td>
  29675. <p>Name is the name of the service account that will be created by ESO.</p>
  29676. </td>
  29677. </tr>
  29678. <tr>
  29679. <td>
  29680. <code>role</code></br>
  29681. <em>
  29682. string
  29683. </em>
  29684. </td>
  29685. <td>
  29686. <p>Role is the role of the service account.
  29687. See here for the documentation on basic roles offered by Grafana:
  29688. <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>
  29689. </td>
  29690. </tr>
  29691. </tbody>
  29692. </table>
  29693. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState
  29694. </h3>
  29695. <p>
  29696. <p>GrafanaServiceAccountTokenState is the state type produced by the Grafana generator.
  29697. It contains the service account ID, login and token ID which is enough to
  29698. identify the service account.</p>
  29699. </p>
  29700. <table>
  29701. <thead>
  29702. <tr>
  29703. <th>Field</th>
  29704. <th>Description</th>
  29705. </tr>
  29706. </thead>
  29707. <tbody>
  29708. <tr>
  29709. <td>
  29710. <code>serviceAccount</code></br>
  29711. <em>
  29712. <a href="#generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">
  29713. GrafanaStateServiceAccount
  29714. </a>
  29715. </em>
  29716. </td>
  29717. <td>
  29718. </td>
  29719. </tr>
  29720. </tbody>
  29721. </table>
  29722. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec
  29723. </h3>
  29724. <p>
  29725. (<em>Appears on:</em>
  29726. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29727. <a href="#generators.external-secrets.io/v1alpha1.Grafana">Grafana</a>)
  29728. </p>
  29729. <p>
  29730. <p>GrafanaSpec controls the behavior of the grafana generator.</p>
  29731. </p>
  29732. <table>
  29733. <thead>
  29734. <tr>
  29735. <th>Field</th>
  29736. <th>Description</th>
  29737. </tr>
  29738. </thead>
  29739. <tbody>
  29740. <tr>
  29741. <td>
  29742. <code>url</code></br>
  29743. <em>
  29744. string
  29745. </em>
  29746. </td>
  29747. <td>
  29748. <p>URL is the URL of the Grafana instance.</p>
  29749. </td>
  29750. </tr>
  29751. <tr>
  29752. <td>
  29753. <code>auth</code></br>
  29754. <em>
  29755. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  29756. GrafanaAuth
  29757. </a>
  29758. </em>
  29759. </td>
  29760. <td>
  29761. <p>Auth is the authentication configuration to authenticate
  29762. against the Grafana instance.</p>
  29763. </td>
  29764. </tr>
  29765. <tr>
  29766. <td>
  29767. <code>serviceAccount</code></br>
  29768. <em>
  29769. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  29770. GrafanaServiceAccount
  29771. </a>
  29772. </em>
  29773. </td>
  29774. <td>
  29775. <p>ServiceAccount is the configuration for the service account that
  29776. is supposed to be generated by the generator.</p>
  29777. </td>
  29778. </tr>
  29779. </tbody>
  29780. </table>
  29781. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">GrafanaStateServiceAccount
  29782. </h3>
  29783. <p>
  29784. (<em>Appears on:</em>
  29785. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState</a>)
  29786. </p>
  29787. <p>
  29788. <p>GrafanaStateServiceAccount contains the service account ID, login and token ID.</p>
  29789. </p>
  29790. <table>
  29791. <thead>
  29792. <tr>
  29793. <th>Field</th>
  29794. <th>Description</th>
  29795. </tr>
  29796. </thead>
  29797. <tbody>
  29798. <tr>
  29799. <td>
  29800. <code>id</code></br>
  29801. <em>
  29802. int64
  29803. </em>
  29804. </td>
  29805. <td>
  29806. </td>
  29807. </tr>
  29808. <tr>
  29809. <td>
  29810. <code>login</code></br>
  29811. <em>
  29812. string
  29813. </em>
  29814. </td>
  29815. <td>
  29816. </td>
  29817. </tr>
  29818. <tr>
  29819. <td>
  29820. <code>tokenID</code></br>
  29821. <em>
  29822. int64
  29823. </em>
  29824. </td>
  29825. <td>
  29826. </td>
  29827. </tr>
  29828. </tbody>
  29829. </table>
  29830. <h3 id="generators.external-secrets.io/v1alpha1.MFA">MFA
  29831. </h3>
  29832. <p>
  29833. <p>MFA generates a new TOTP token that is compliant with RFC 6238.</p>
  29834. </p>
  29835. <table>
  29836. <thead>
  29837. <tr>
  29838. <th>Field</th>
  29839. <th>Description</th>
  29840. </tr>
  29841. </thead>
  29842. <tbody>
  29843. <tr>
  29844. <td>
  29845. <code>metadata</code></br>
  29846. <em>
  29847. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29848. Kubernetes meta/v1.ObjectMeta
  29849. </a>
  29850. </em>
  29851. </td>
  29852. <td>
  29853. Refer to the Kubernetes API documentation for the fields of the
  29854. <code>metadata</code> field.
  29855. </td>
  29856. </tr>
  29857. <tr>
  29858. <td>
  29859. <code>spec</code></br>
  29860. <em>
  29861. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  29862. MFASpec
  29863. </a>
  29864. </em>
  29865. </td>
  29866. <td>
  29867. <br/>
  29868. <br/>
  29869. <table>
  29870. <tr>
  29871. <td>
  29872. <code>secret</code></br>
  29873. <em>
  29874. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29875. External Secrets meta/v1.SecretKeySelector
  29876. </a>
  29877. </em>
  29878. </td>
  29879. <td>
  29880. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  29881. </td>
  29882. </tr>
  29883. <tr>
  29884. <td>
  29885. <code>length</code></br>
  29886. <em>
  29887. int
  29888. </em>
  29889. </td>
  29890. <td>
  29891. <p>Length defines the token length. Defaults to 6 characters.</p>
  29892. </td>
  29893. </tr>
  29894. <tr>
  29895. <td>
  29896. <code>timePeriod</code></br>
  29897. <em>
  29898. int
  29899. </em>
  29900. </td>
  29901. <td>
  29902. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  29903. </td>
  29904. </tr>
  29905. <tr>
  29906. <td>
  29907. <code>algorithm</code></br>
  29908. <em>
  29909. string
  29910. </em>
  29911. </td>
  29912. <td>
  29913. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  29914. </td>
  29915. </tr>
  29916. <tr>
  29917. <td>
  29918. <code>when</code></br>
  29919. <em>
  29920. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  29921. Kubernetes meta/v1.Time
  29922. </a>
  29923. </em>
  29924. </td>
  29925. <td>
  29926. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  29927. </td>
  29928. </tr>
  29929. </table>
  29930. </td>
  29931. </tr>
  29932. </tbody>
  29933. </table>
  29934. <h3 id="generators.external-secrets.io/v1alpha1.MFASpec">MFASpec
  29935. </h3>
  29936. <p>
  29937. (<em>Appears on:</em>
  29938. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29939. <a href="#generators.external-secrets.io/v1alpha1.MFA">MFA</a>)
  29940. </p>
  29941. <p>
  29942. <p>MFASpec controls the behavior of the mfa generator.</p>
  29943. </p>
  29944. <table>
  29945. <thead>
  29946. <tr>
  29947. <th>Field</th>
  29948. <th>Description</th>
  29949. </tr>
  29950. </thead>
  29951. <tbody>
  29952. <tr>
  29953. <td>
  29954. <code>secret</code></br>
  29955. <em>
  29956. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29957. External Secrets meta/v1.SecretKeySelector
  29958. </a>
  29959. </em>
  29960. </td>
  29961. <td>
  29962. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  29963. </td>
  29964. </tr>
  29965. <tr>
  29966. <td>
  29967. <code>length</code></br>
  29968. <em>
  29969. int
  29970. </em>
  29971. </td>
  29972. <td>
  29973. <p>Length defines the token length. Defaults to 6 characters.</p>
  29974. </td>
  29975. </tr>
  29976. <tr>
  29977. <td>
  29978. <code>timePeriod</code></br>
  29979. <em>
  29980. int
  29981. </em>
  29982. </td>
  29983. <td>
  29984. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  29985. </td>
  29986. </tr>
  29987. <tr>
  29988. <td>
  29989. <code>algorithm</code></br>
  29990. <em>
  29991. string
  29992. </em>
  29993. </td>
  29994. <td>
  29995. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  29996. </td>
  29997. </tr>
  29998. <tr>
  29999. <td>
  30000. <code>when</code></br>
  30001. <em>
  30002. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  30003. Kubernetes meta/v1.Time
  30004. </a>
  30005. </em>
  30006. </td>
  30007. <td>
  30008. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  30009. </td>
  30010. </tr>
  30011. </tbody>
  30012. </table>
  30013. <h3 id="generators.external-secrets.io/v1alpha1.NTLMProtocol">NTLMProtocol
  30014. </h3>
  30015. <p>
  30016. (<em>Appears on:</em>
  30017. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol</a>)
  30018. </p>
  30019. <p>
  30020. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  30021. </p>
  30022. <table>
  30023. <thead>
  30024. <tr>
  30025. <th>Field</th>
  30026. <th>Description</th>
  30027. </tr>
  30028. </thead>
  30029. <tbody>
  30030. <tr>
  30031. <td>
  30032. <code>usernameSecret</code></br>
  30033. <em>
  30034. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30035. External Secrets meta/v1.SecretKeySelector
  30036. </a>
  30037. </em>
  30038. </td>
  30039. <td>
  30040. </td>
  30041. </tr>
  30042. <tr>
  30043. <td>
  30044. <code>passwordSecret</code></br>
  30045. <em>
  30046. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  30047. External Secrets meta/v1.SecretKeySelector
  30048. </a>
  30049. </em>
  30050. </td>
  30051. <td>
  30052. </td>
  30053. </tr>
  30054. </tbody>
  30055. </table>
  30056. <h3 id="generators.external-secrets.io/v1alpha1.Password">Password
  30057. </h3>
  30058. <p>
  30059. <p>Password generates a random password based on the
  30060. configuration parameters in spec.
  30061. You can specify the length, characterset and other attributes.</p>
  30062. </p>
  30063. <table>
  30064. <thead>
  30065. <tr>
  30066. <th>Field</th>
  30067. <th>Description</th>
  30068. </tr>
  30069. </thead>
  30070. <tbody>
  30071. <tr>
  30072. <td>
  30073. <code>metadata</code></br>
  30074. <em>
  30075. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30076. Kubernetes meta/v1.ObjectMeta
  30077. </a>
  30078. </em>
  30079. </td>
  30080. <td>
  30081. Refer to the Kubernetes API documentation for the fields of the
  30082. <code>metadata</code> field.
  30083. </td>
  30084. </tr>
  30085. <tr>
  30086. <td>
  30087. <code>spec</code></br>
  30088. <em>
  30089. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  30090. PasswordSpec
  30091. </a>
  30092. </em>
  30093. </td>
  30094. <td>
  30095. <br/>
  30096. <br/>
  30097. <table>
  30098. <tr>
  30099. <td>
  30100. <code>length</code></br>
  30101. <em>
  30102. int
  30103. </em>
  30104. </td>
  30105. <td>
  30106. <p>Length of the password to be generated.
  30107. Defaults to 24</p>
  30108. </td>
  30109. </tr>
  30110. <tr>
  30111. <td>
  30112. <code>digits</code></br>
  30113. <em>
  30114. int
  30115. </em>
  30116. </td>
  30117. <td>
  30118. <p>Digits specifies the number of digits in the generated
  30119. password. If omitted it defaults to 25% of the length of the password</p>
  30120. </td>
  30121. </tr>
  30122. <tr>
  30123. <td>
  30124. <code>symbols</code></br>
  30125. <em>
  30126. int
  30127. </em>
  30128. </td>
  30129. <td>
  30130. <p>Symbols specifies the number of symbol characters in the generated
  30131. password. If omitted it defaults to 25% of the length of the password</p>
  30132. </td>
  30133. </tr>
  30134. <tr>
  30135. <td>
  30136. <code>symbolCharacters</code></br>
  30137. <em>
  30138. string
  30139. </em>
  30140. </td>
  30141. <td>
  30142. <p>SymbolCharacters specifies the special characters that should be used
  30143. in the generated password.</p>
  30144. </td>
  30145. </tr>
  30146. <tr>
  30147. <td>
  30148. <code>noUpper</code></br>
  30149. <em>
  30150. bool
  30151. </em>
  30152. </td>
  30153. <td>
  30154. <p>Set NoUpper to disable uppercase characters</p>
  30155. </td>
  30156. </tr>
  30157. <tr>
  30158. <td>
  30159. <code>allowRepeat</code></br>
  30160. <em>
  30161. bool
  30162. </em>
  30163. </td>
  30164. <td>
  30165. <p>set AllowRepeat to true to allow repeating characters.</p>
  30166. </td>
  30167. </tr>
  30168. <tr>
  30169. <td>
  30170. <code>secretKeys</code></br>
  30171. <em>
  30172. []string
  30173. </em>
  30174. </td>
  30175. <td>
  30176. <em>(Optional)</em>
  30177. <p>SecretKeys defines the keys that will be populated with generated passwords.
  30178. Defaults to &ldquo;password&rdquo; when not set.</p>
  30179. </td>
  30180. </tr>
  30181. <tr>
  30182. <td>
  30183. <code>encoding</code></br>
  30184. <em>
  30185. string
  30186. </em>
  30187. </td>
  30188. <td>
  30189. <p>Encoding specifies the encoding of the generated password.
  30190. Valid values are:
  30191. - &ldquo;raw&rdquo; (default): no encoding
  30192. - &ldquo;base64&rdquo;: standard base64 encoding
  30193. - &ldquo;base64url&rdquo;: base64url encoding
  30194. - &ldquo;base32&rdquo;: base32 encoding
  30195. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  30196. </td>
  30197. </tr>
  30198. </table>
  30199. </td>
  30200. </tr>
  30201. </tbody>
  30202. </table>
  30203. <h3 id="generators.external-secrets.io/v1alpha1.PasswordSpec">PasswordSpec
  30204. </h3>
  30205. <p>
  30206. (<em>Appears on:</em>
  30207. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30208. <a href="#generators.external-secrets.io/v1alpha1.Password">Password</a>)
  30209. </p>
  30210. <p>
  30211. <p>PasswordSpec controls the behavior of the password generator.</p>
  30212. </p>
  30213. <table>
  30214. <thead>
  30215. <tr>
  30216. <th>Field</th>
  30217. <th>Description</th>
  30218. </tr>
  30219. </thead>
  30220. <tbody>
  30221. <tr>
  30222. <td>
  30223. <code>length</code></br>
  30224. <em>
  30225. int
  30226. </em>
  30227. </td>
  30228. <td>
  30229. <p>Length of the password to be generated.
  30230. Defaults to 24</p>
  30231. </td>
  30232. </tr>
  30233. <tr>
  30234. <td>
  30235. <code>digits</code></br>
  30236. <em>
  30237. int
  30238. </em>
  30239. </td>
  30240. <td>
  30241. <p>Digits specifies the number of digits in the generated
  30242. password. If omitted it defaults to 25% of the length of the password</p>
  30243. </td>
  30244. </tr>
  30245. <tr>
  30246. <td>
  30247. <code>symbols</code></br>
  30248. <em>
  30249. int
  30250. </em>
  30251. </td>
  30252. <td>
  30253. <p>Symbols specifies the number of symbol characters in the generated
  30254. password. If omitted it defaults to 25% of the length of the password</p>
  30255. </td>
  30256. </tr>
  30257. <tr>
  30258. <td>
  30259. <code>symbolCharacters</code></br>
  30260. <em>
  30261. string
  30262. </em>
  30263. </td>
  30264. <td>
  30265. <p>SymbolCharacters specifies the special characters that should be used
  30266. in the generated password.</p>
  30267. </td>
  30268. </tr>
  30269. <tr>
  30270. <td>
  30271. <code>noUpper</code></br>
  30272. <em>
  30273. bool
  30274. </em>
  30275. </td>
  30276. <td>
  30277. <p>Set NoUpper to disable uppercase characters</p>
  30278. </td>
  30279. </tr>
  30280. <tr>
  30281. <td>
  30282. <code>allowRepeat</code></br>
  30283. <em>
  30284. bool
  30285. </em>
  30286. </td>
  30287. <td>
  30288. <p>set AllowRepeat to true to allow repeating characters.</p>
  30289. </td>
  30290. </tr>
  30291. <tr>
  30292. <td>
  30293. <code>secretKeys</code></br>
  30294. <em>
  30295. []string
  30296. </em>
  30297. </td>
  30298. <td>
  30299. <em>(Optional)</em>
  30300. <p>SecretKeys defines the keys that will be populated with generated passwords.
  30301. Defaults to &ldquo;password&rdquo; when not set.</p>
  30302. </td>
  30303. </tr>
  30304. <tr>
  30305. <td>
  30306. <code>encoding</code></br>
  30307. <em>
  30308. string
  30309. </em>
  30310. </td>
  30311. <td>
  30312. <p>Encoding specifies the encoding of the generated password.
  30313. Valid values are:
  30314. - &ldquo;raw&rdquo; (default): no encoding
  30315. - &ldquo;base64&rdquo;: standard base64 encoding
  30316. - &ldquo;base64url&rdquo;: base64url encoding
  30317. - &ldquo;base32&rdquo;: base32 encoding
  30318. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  30319. </td>
  30320. </tr>
  30321. </tbody>
  30322. </table>
  30323. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken
  30324. </h3>
  30325. <p>
  30326. <p>QuayAccessToken generates Quay oauth token for pulling/pushing images</p>
  30327. </p>
  30328. <table>
  30329. <thead>
  30330. <tr>
  30331. <th>Field</th>
  30332. <th>Description</th>
  30333. </tr>
  30334. </thead>
  30335. <tbody>
  30336. <tr>
  30337. <td>
  30338. <code>metadata</code></br>
  30339. <em>
  30340. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30341. Kubernetes meta/v1.ObjectMeta
  30342. </a>
  30343. </em>
  30344. </td>
  30345. <td>
  30346. Refer to the Kubernetes API documentation for the fields of the
  30347. <code>metadata</code> field.
  30348. </td>
  30349. </tr>
  30350. <tr>
  30351. <td>
  30352. <code>spec</code></br>
  30353. <em>
  30354. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  30355. QuayAccessTokenSpec
  30356. </a>
  30357. </em>
  30358. </td>
  30359. <td>
  30360. <br/>
  30361. <br/>
  30362. <table>
  30363. <tr>
  30364. <td>
  30365. <code>url</code></br>
  30366. <em>
  30367. string
  30368. </em>
  30369. </td>
  30370. <td>
  30371. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  30372. </td>
  30373. </tr>
  30374. <tr>
  30375. <td>
  30376. <code>robotAccount</code></br>
  30377. <em>
  30378. string
  30379. </em>
  30380. </td>
  30381. <td>
  30382. <p>Name of the robot account you are federating with</p>
  30383. </td>
  30384. </tr>
  30385. <tr>
  30386. <td>
  30387. <code>serviceAccountRef</code></br>
  30388. <em>
  30389. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  30390. External Secrets meta/v1.ServiceAccountSelector
  30391. </a>
  30392. </em>
  30393. </td>
  30394. <td>
  30395. <p>Name of the service account you are federating with</p>
  30396. </td>
  30397. </tr>
  30398. </table>
  30399. </td>
  30400. </tr>
  30401. </tbody>
  30402. </table>
  30403. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">QuayAccessTokenSpec
  30404. </h3>
  30405. <p>
  30406. (<em>Appears on:</em>
  30407. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30408. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken</a>)
  30409. </p>
  30410. <p>
  30411. <p>QuayAccessTokenSpec defines the desired state to generate a Quay access token.</p>
  30412. </p>
  30413. <table>
  30414. <thead>
  30415. <tr>
  30416. <th>Field</th>
  30417. <th>Description</th>
  30418. </tr>
  30419. </thead>
  30420. <tbody>
  30421. <tr>
  30422. <td>
  30423. <code>url</code></br>
  30424. <em>
  30425. string
  30426. </em>
  30427. </td>
  30428. <td>
  30429. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  30430. </td>
  30431. </tr>
  30432. <tr>
  30433. <td>
  30434. <code>robotAccount</code></br>
  30435. <em>
  30436. string
  30437. </em>
  30438. </td>
  30439. <td>
  30440. <p>Name of the robot account you are federating with</p>
  30441. </td>
  30442. </tr>
  30443. <tr>
  30444. <td>
  30445. <code>serviceAccountRef</code></br>
  30446. <em>
  30447. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  30448. External Secrets meta/v1.ServiceAccountSelector
  30449. </a>
  30450. </em>
  30451. </td>
  30452. <td>
  30453. <p>Name of the service account you are federating with</p>
  30454. </td>
  30455. </tr>
  30456. </tbody>
  30457. </table>
  30458. <h3 id="generators.external-secrets.io/v1alpha1.RequestParameters">RequestParameters
  30459. </h3>
  30460. <p>
  30461. (<em>Appears on:</em>
  30462. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  30463. </p>
  30464. <p>
  30465. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  30466. </p>
  30467. <table>
  30468. <thead>
  30469. <tr>
  30470. <th>Field</th>
  30471. <th>Description</th>
  30472. </tr>
  30473. </thead>
  30474. <tbody>
  30475. <tr>
  30476. <td>
  30477. <code>sessionDuration</code></br>
  30478. <em>
  30479. int32
  30480. </em>
  30481. </td>
  30482. <td>
  30483. <em>(Optional)</em>
  30484. </td>
  30485. </tr>
  30486. <tr>
  30487. <td>
  30488. <code>serialNumber</code></br>
  30489. <em>
  30490. string
  30491. </em>
  30492. </td>
  30493. <td>
  30494. <em>(Optional)</em>
  30495. <p>SerialNumber is the identification number of the MFA device that is associated with the IAM user who is making
  30496. the GetSessionToken call.
  30497. Possible values: hardware device (such as GAHT12345678) or an Amazon Resource Name (ARN) for a virtual device
  30498. (such as arn:aws:iam::123456789012:mfa/user)</p>
  30499. </td>
  30500. </tr>
  30501. <tr>
  30502. <td>
  30503. <code>tokenCode</code></br>
  30504. <em>
  30505. string
  30506. </em>
  30507. </td>
  30508. <td>
  30509. <em>(Optional)</em>
  30510. <p>TokenCode is the value provided by the MFA device, if MFA is required.</p>
  30511. </td>
  30512. </tr>
  30513. </tbody>
  30514. </table>
  30515. <h3 id="generators.external-secrets.io/v1alpha1.SSHKey">SSHKey
  30516. </h3>
  30517. <p>
  30518. <p>SSHKey generates SSH key pairs.</p>
  30519. </p>
  30520. <table>
  30521. <thead>
  30522. <tr>
  30523. <th>Field</th>
  30524. <th>Description</th>
  30525. </tr>
  30526. </thead>
  30527. <tbody>
  30528. <tr>
  30529. <td>
  30530. <code>metadata</code></br>
  30531. <em>
  30532. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30533. Kubernetes meta/v1.ObjectMeta
  30534. </a>
  30535. </em>
  30536. </td>
  30537. <td>
  30538. Refer to the Kubernetes API documentation for the fields of the
  30539. <code>metadata</code> field.
  30540. </td>
  30541. </tr>
  30542. <tr>
  30543. <td>
  30544. <code>spec</code></br>
  30545. <em>
  30546. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  30547. SSHKeySpec
  30548. </a>
  30549. </em>
  30550. </td>
  30551. <td>
  30552. <br/>
  30553. <br/>
  30554. <table>
  30555. <tr>
  30556. <td>
  30557. <code>keyType</code></br>
  30558. <em>
  30559. string
  30560. </em>
  30561. </td>
  30562. <td>
  30563. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  30564. </td>
  30565. </tr>
  30566. <tr>
  30567. <td>
  30568. <code>keySize</code></br>
  30569. <em>
  30570. int
  30571. </em>
  30572. </td>
  30573. <td>
  30574. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  30575. For RSA keys: 2048, 3072, 4096
  30576. For ECDSA keys: 256, 384, 521
  30577. Ignored for ed25519 keys</p>
  30578. </td>
  30579. </tr>
  30580. <tr>
  30581. <td>
  30582. <code>comment</code></br>
  30583. <em>
  30584. string
  30585. </em>
  30586. </td>
  30587. <td>
  30588. <p>Comment specifies an optional comment for the SSH key</p>
  30589. </td>
  30590. </tr>
  30591. </table>
  30592. </td>
  30593. </tr>
  30594. </tbody>
  30595. </table>
  30596. <h3 id="generators.external-secrets.io/v1alpha1.SSHKeySpec">SSHKeySpec
  30597. </h3>
  30598. <p>
  30599. (<em>Appears on:</em>
  30600. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30601. <a href="#generators.external-secrets.io/v1alpha1.SSHKey">SSHKey</a>)
  30602. </p>
  30603. <p>
  30604. <p>SSHKeySpec controls the behavior of the ssh key generator.</p>
  30605. </p>
  30606. <table>
  30607. <thead>
  30608. <tr>
  30609. <th>Field</th>
  30610. <th>Description</th>
  30611. </tr>
  30612. </thead>
  30613. <tbody>
  30614. <tr>
  30615. <td>
  30616. <code>keyType</code></br>
  30617. <em>
  30618. string
  30619. </em>
  30620. </td>
  30621. <td>
  30622. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  30623. </td>
  30624. </tr>
  30625. <tr>
  30626. <td>
  30627. <code>keySize</code></br>
  30628. <em>
  30629. int
  30630. </em>
  30631. </td>
  30632. <td>
  30633. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  30634. For RSA keys: 2048, 3072, 4096
  30635. For ECDSA keys: 256, 384, 521
  30636. Ignored for ed25519 keys</p>
  30637. </td>
  30638. </tr>
  30639. <tr>
  30640. <td>
  30641. <code>comment</code></br>
  30642. <em>
  30643. string
  30644. </em>
  30645. </td>
  30646. <td>
  30647. <p>Comment specifies an optional comment for the SSH key</p>
  30648. </td>
  30649. </tr>
  30650. </tbody>
  30651. </table>
  30652. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken
  30653. </h3>
  30654. <p>
  30655. <p>STSSessionToken uses the GetSessionToken API to retrieve an authorization token.
  30656. The authorization token is valid for 12 hours.
  30657. The authorizationToken returned is a base64 encoded string that can be decoded.
  30658. 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>
  30659. </p>
  30660. <table>
  30661. <thead>
  30662. <tr>
  30663. <th>Field</th>
  30664. <th>Description</th>
  30665. </tr>
  30666. </thead>
  30667. <tbody>
  30668. <tr>
  30669. <td>
  30670. <code>metadata</code></br>
  30671. <em>
  30672. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30673. Kubernetes meta/v1.ObjectMeta
  30674. </a>
  30675. </em>
  30676. </td>
  30677. <td>
  30678. Refer to the Kubernetes API documentation for the fields of the
  30679. <code>metadata</code> field.
  30680. </td>
  30681. </tr>
  30682. <tr>
  30683. <td>
  30684. <code>spec</code></br>
  30685. <em>
  30686. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  30687. STSSessionTokenSpec
  30688. </a>
  30689. </em>
  30690. </td>
  30691. <td>
  30692. <br/>
  30693. <br/>
  30694. <table>
  30695. <tr>
  30696. <td>
  30697. <code>region</code></br>
  30698. <em>
  30699. string
  30700. </em>
  30701. </td>
  30702. <td>
  30703. <p>Region specifies the region to operate in.</p>
  30704. </td>
  30705. </tr>
  30706. <tr>
  30707. <td>
  30708. <code>auth</code></br>
  30709. <em>
  30710. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  30711. AWSAuth
  30712. </a>
  30713. </em>
  30714. </td>
  30715. <td>
  30716. <em>(Optional)</em>
  30717. <p>Auth defines how to authenticate with AWS</p>
  30718. </td>
  30719. </tr>
  30720. <tr>
  30721. <td>
  30722. <code>role</code></br>
  30723. <em>
  30724. string
  30725. </em>
  30726. </td>
  30727. <td>
  30728. <em>(Optional)</em>
  30729. <p>You can assume a role before making calls to the
  30730. desired AWS service.</p>
  30731. </td>
  30732. </tr>
  30733. <tr>
  30734. <td>
  30735. <code>requestParameters</code></br>
  30736. <em>
  30737. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  30738. RequestParameters
  30739. </a>
  30740. </em>
  30741. </td>
  30742. <td>
  30743. <em>(Optional)</em>
  30744. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  30745. </td>
  30746. </tr>
  30747. </table>
  30748. </td>
  30749. </tr>
  30750. </tbody>
  30751. </table>
  30752. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec
  30753. </h3>
  30754. <p>
  30755. (<em>Appears on:</em>
  30756. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30757. <a href="#generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken</a>)
  30758. </p>
  30759. <p>
  30760. <p>STSSessionTokenSpec defines the desired state to generate an AWS STS session token.</p>
  30761. </p>
  30762. <table>
  30763. <thead>
  30764. <tr>
  30765. <th>Field</th>
  30766. <th>Description</th>
  30767. </tr>
  30768. </thead>
  30769. <tbody>
  30770. <tr>
  30771. <td>
  30772. <code>region</code></br>
  30773. <em>
  30774. string
  30775. </em>
  30776. </td>
  30777. <td>
  30778. <p>Region specifies the region to operate in.</p>
  30779. </td>
  30780. </tr>
  30781. <tr>
  30782. <td>
  30783. <code>auth</code></br>
  30784. <em>
  30785. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  30786. AWSAuth
  30787. </a>
  30788. </em>
  30789. </td>
  30790. <td>
  30791. <em>(Optional)</em>
  30792. <p>Auth defines how to authenticate with AWS</p>
  30793. </td>
  30794. </tr>
  30795. <tr>
  30796. <td>
  30797. <code>role</code></br>
  30798. <em>
  30799. string
  30800. </em>
  30801. </td>
  30802. <td>
  30803. <em>(Optional)</em>
  30804. <p>You can assume a role before making calls to the
  30805. desired AWS service.</p>
  30806. </td>
  30807. </tr>
  30808. <tr>
  30809. <td>
  30810. <code>requestParameters</code></br>
  30811. <em>
  30812. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  30813. RequestParameters
  30814. </a>
  30815. </em>
  30816. </td>
  30817. <td>
  30818. <em>(Optional)</em>
  30819. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  30820. </td>
  30821. </tr>
  30822. </tbody>
  30823. </table>
  30824. <h3 id="generators.external-secrets.io/v1alpha1.SecretKeySelector">SecretKeySelector
  30825. </h3>
  30826. <p>
  30827. (<em>Appears on:</em>
  30828. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>,
  30829. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth</a>,
  30830. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret</a>)
  30831. </p>
  30832. <p>
  30833. <p>SecretKeySelector defines a reference to a specific key within a Kubernetes Secret.</p>
  30834. </p>
  30835. <table>
  30836. <thead>
  30837. <tr>
  30838. <th>Field</th>
  30839. <th>Description</th>
  30840. </tr>
  30841. </thead>
  30842. <tbody>
  30843. <tr>
  30844. <td>
  30845. <code>name</code></br>
  30846. <em>
  30847. string
  30848. </em>
  30849. </td>
  30850. <td>
  30851. <p>The name of the Secret resource being referred to.</p>
  30852. </td>
  30853. </tr>
  30854. <tr>
  30855. <td>
  30856. <code>key</code></br>
  30857. <em>
  30858. string
  30859. </em>
  30860. </td>
  30861. <td>
  30862. <p>The key where the token is found.</p>
  30863. </td>
  30864. </tr>
  30865. </tbody>
  30866. </table>
  30867. <h3 id="generators.external-secrets.io/v1alpha1.StatefulResource">StatefulResource
  30868. </h3>
  30869. <p>
  30870. <p>StatefulResource represents a Kubernetes resource that has state which can be tracked.</p>
  30871. </p>
  30872. <h3 id="generators.external-secrets.io/v1alpha1.UUID">UUID
  30873. </h3>
  30874. <p>
  30875. <p>UUID generates a version 1 UUID (e56657e3-764f-11ef-a397-65231a88c216).</p>
  30876. </p>
  30877. <table>
  30878. <thead>
  30879. <tr>
  30880. <th>Field</th>
  30881. <th>Description</th>
  30882. </tr>
  30883. </thead>
  30884. <tbody>
  30885. <tr>
  30886. <td>
  30887. <code>metadata</code></br>
  30888. <em>
  30889. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30890. Kubernetes meta/v1.ObjectMeta
  30891. </a>
  30892. </em>
  30893. </td>
  30894. <td>
  30895. Refer to the Kubernetes API documentation for the fields of the
  30896. <code>metadata</code> field.
  30897. </td>
  30898. </tr>
  30899. <tr>
  30900. <td>
  30901. <code>spec</code></br>
  30902. <em>
  30903. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  30904. UUIDSpec
  30905. </a>
  30906. </em>
  30907. </td>
  30908. <td>
  30909. <br/>
  30910. <br/>
  30911. <table>
  30912. </table>
  30913. </td>
  30914. </tr>
  30915. </tbody>
  30916. </table>
  30917. <h3 id="generators.external-secrets.io/v1alpha1.UUIDSpec">UUIDSpec
  30918. </h3>
  30919. <p>
  30920. (<em>Appears on:</em>
  30921. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30922. <a href="#generators.external-secrets.io/v1alpha1.UUID">UUID</a>)
  30923. </p>
  30924. <p>
  30925. <p>UUIDSpec controls the behavior of the uuid generator.</p>
  30926. </p>
  30927. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret
  30928. </h3>
  30929. <p>
  30930. <p>VaultDynamicSecret represents a generator that can create dynamic secrets from HashiCorp Vault.</p>
  30931. </p>
  30932. <table>
  30933. <thead>
  30934. <tr>
  30935. <th>Field</th>
  30936. <th>Description</th>
  30937. </tr>
  30938. </thead>
  30939. <tbody>
  30940. <tr>
  30941. <td>
  30942. <code>metadata</code></br>
  30943. <em>
  30944. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30945. Kubernetes meta/v1.ObjectMeta
  30946. </a>
  30947. </em>
  30948. </td>
  30949. <td>
  30950. Refer to the Kubernetes API documentation for the fields of the
  30951. <code>metadata</code> field.
  30952. </td>
  30953. </tr>
  30954. <tr>
  30955. <td>
  30956. <code>spec</code></br>
  30957. <em>
  30958. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  30959. VaultDynamicSecretSpec
  30960. </a>
  30961. </em>
  30962. </td>
  30963. <td>
  30964. <br/>
  30965. <br/>
  30966. <table>
  30967. <tr>
  30968. <td>
  30969. <code>controller</code></br>
  30970. <em>
  30971. string
  30972. </em>
  30973. </td>
  30974. <td>
  30975. <em>(Optional)</em>
  30976. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  30977. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  30978. </td>
  30979. </tr>
  30980. <tr>
  30981. <td>
  30982. <code>method</code></br>
  30983. <em>
  30984. string
  30985. </em>
  30986. </td>
  30987. <td>
  30988. <p>Vault API method to use (GET/POST/other)</p>
  30989. </td>
  30990. </tr>
  30991. <tr>
  30992. <td>
  30993. <code>parameters</code></br>
  30994. <em>
  30995. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  30996. </em>
  30997. </td>
  30998. <td>
  30999. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  31000. </td>
  31001. </tr>
  31002. <tr>
  31003. <td>
  31004. <code>getParameters</code></br>
  31005. <em>
  31006. map[string][]string
  31007. </em>
  31008. </td>
  31009. <td>
  31010. <em>(Optional)</em>
  31011. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  31012. Each key may map to multiple values, matching HTTP query-string semantics.
  31013. Ignored for non-GET methods; use Parameters for write bodies.</p>
  31014. </td>
  31015. </tr>
  31016. <tr>
  31017. <td>
  31018. <code>resultType</code></br>
  31019. <em>
  31020. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  31021. VaultDynamicSecretResultType
  31022. </a>
  31023. </em>
  31024. </td>
  31025. <td>
  31026. <p>Result type defines which data is returned from the generator.
  31027. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  31028. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  31029. the &ldquo;auth&rdquo; section contains the generated token.
  31030. Please refer to the vault docs regarding the result data structure.
  31031. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  31032. </td>
  31033. </tr>
  31034. <tr>
  31035. <td>
  31036. <code>retrySettings</code></br>
  31037. <em>
  31038. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  31039. SecretStoreRetrySettings
  31040. </a>
  31041. </em>
  31042. </td>
  31043. <td>
  31044. <em>(Optional)</em>
  31045. <p>Used to configure http retries if failed</p>
  31046. </td>
  31047. </tr>
  31048. <tr>
  31049. <td>
  31050. <code>provider</code></br>
  31051. <em>
  31052. <a href="#external-secrets.io/v1.VaultProvider">
  31053. VaultProvider
  31054. </a>
  31055. </em>
  31056. </td>
  31057. <td>
  31058. <p>Vault provider common spec</p>
  31059. </td>
  31060. </tr>
  31061. <tr>
  31062. <td>
  31063. <code>path</code></br>
  31064. <em>
  31065. string
  31066. </em>
  31067. </td>
  31068. <td>
  31069. <p>Vault path to obtain the dynamic secret from</p>
  31070. </td>
  31071. </tr>
  31072. <tr>
  31073. <td>
  31074. <code>allowEmptyResponse</code></br>
  31075. <em>
  31076. bool
  31077. </em>
  31078. </td>
  31079. <td>
  31080. <em>(Optional)</em>
  31081. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  31082. </td>
  31083. </tr>
  31084. </table>
  31085. </td>
  31086. </tr>
  31087. </tbody>
  31088. </table>
  31089. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">VaultDynamicSecretResultType
  31090. (<code>string</code> alias)</p></h3>
  31091. <p>
  31092. (<em>Appears on:</em>
  31093. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  31094. </p>
  31095. <p>
  31096. <p>VaultDynamicSecretResultType defines which part of the Vault API response should be returned.</p>
  31097. </p>
  31098. <table>
  31099. <thead>
  31100. <tr>
  31101. <th>Value</th>
  31102. <th>Description</th>
  31103. </tr>
  31104. </thead>
  31105. <tbody><tr><td><p>&#34;Auth&#34;</p></td>
  31106. <td><p>VaultDynamicSecretResultTypeAuth specifies to return the &ldquo;auth&rdquo; section of the Vault API response.</p>
  31107. </td>
  31108. </tr><tr><td><p>&#34;Data&#34;</p></td>
  31109. <td><p>VaultDynamicSecretResultTypeData specifies to return the &ldquo;data&rdquo; section of the Vault API response.</p>
  31110. </td>
  31111. </tr><tr><td><p>&#34;Raw&#34;</p></td>
  31112. <td><p>VaultDynamicSecretResultTypeRaw specifies to return the raw response from the Vault API.</p>
  31113. </td>
  31114. </tr></tbody>
  31115. </table>
  31116. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec
  31117. </h3>
  31118. <p>
  31119. (<em>Appears on:</em>
  31120. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31121. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret</a>)
  31122. </p>
  31123. <p>
  31124. <p>VaultDynamicSecretSpec defines the desired spec of VaultDynamicSecret.</p>
  31125. </p>
  31126. <table>
  31127. <thead>
  31128. <tr>
  31129. <th>Field</th>
  31130. <th>Description</th>
  31131. </tr>
  31132. </thead>
  31133. <tbody>
  31134. <tr>
  31135. <td>
  31136. <code>controller</code></br>
  31137. <em>
  31138. string
  31139. </em>
  31140. </td>
  31141. <td>
  31142. <em>(Optional)</em>
  31143. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  31144. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  31145. </td>
  31146. </tr>
  31147. <tr>
  31148. <td>
  31149. <code>method</code></br>
  31150. <em>
  31151. string
  31152. </em>
  31153. </td>
  31154. <td>
  31155. <p>Vault API method to use (GET/POST/other)</p>
  31156. </td>
  31157. </tr>
  31158. <tr>
  31159. <td>
  31160. <code>parameters</code></br>
  31161. <em>
  31162. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  31163. </em>
  31164. </td>
  31165. <td>
  31166. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  31167. </td>
  31168. </tr>
  31169. <tr>
  31170. <td>
  31171. <code>getParameters</code></br>
  31172. <em>
  31173. map[string][]string
  31174. </em>
  31175. </td>
  31176. <td>
  31177. <em>(Optional)</em>
  31178. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  31179. Each key may map to multiple values, matching HTTP query-string semantics.
  31180. Ignored for non-GET methods; use Parameters for write bodies.</p>
  31181. </td>
  31182. </tr>
  31183. <tr>
  31184. <td>
  31185. <code>resultType</code></br>
  31186. <em>
  31187. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  31188. VaultDynamicSecretResultType
  31189. </a>
  31190. </em>
  31191. </td>
  31192. <td>
  31193. <p>Result type defines which data is returned from the generator.
  31194. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  31195. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  31196. the &ldquo;auth&rdquo; section contains the generated token.
  31197. Please refer to the vault docs regarding the result data structure.
  31198. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  31199. </td>
  31200. </tr>
  31201. <tr>
  31202. <td>
  31203. <code>retrySettings</code></br>
  31204. <em>
  31205. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  31206. SecretStoreRetrySettings
  31207. </a>
  31208. </em>
  31209. </td>
  31210. <td>
  31211. <em>(Optional)</em>
  31212. <p>Used to configure http retries if failed</p>
  31213. </td>
  31214. </tr>
  31215. <tr>
  31216. <td>
  31217. <code>provider</code></br>
  31218. <em>
  31219. <a href="#external-secrets.io/v1.VaultProvider">
  31220. VaultProvider
  31221. </a>
  31222. </em>
  31223. </td>
  31224. <td>
  31225. <p>Vault provider common spec</p>
  31226. </td>
  31227. </tr>
  31228. <tr>
  31229. <td>
  31230. <code>path</code></br>
  31231. <em>
  31232. string
  31233. </em>
  31234. </td>
  31235. <td>
  31236. <p>Vault path to obtain the dynamic secret from</p>
  31237. </td>
  31238. </tr>
  31239. <tr>
  31240. <td>
  31241. <code>allowEmptyResponse</code></br>
  31242. <em>
  31243. bool
  31244. </em>
  31245. </td>
  31246. <td>
  31247. <em>(Optional)</em>
  31248. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  31249. </td>
  31250. </tr>
  31251. </tbody>
  31252. </table>
  31253. <h3 id="generators.external-secrets.io/v1alpha1.Webhook">Webhook
  31254. </h3>
  31255. <p>
  31256. <p>Webhook connects to a third party API server to handle the secrets generation
  31257. configuration parameters in spec.
  31258. You can specify the server, the token, and additional body parameters.
  31259. See documentation for the full API specification for requests and responses.</p>
  31260. </p>
  31261. <table>
  31262. <thead>
  31263. <tr>
  31264. <th>Field</th>
  31265. <th>Description</th>
  31266. </tr>
  31267. </thead>
  31268. <tbody>
  31269. <tr>
  31270. <td>
  31271. <code>metadata</code></br>
  31272. <em>
  31273. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  31274. Kubernetes meta/v1.ObjectMeta
  31275. </a>
  31276. </em>
  31277. </td>
  31278. <td>
  31279. Refer to the Kubernetes API documentation for the fields of the
  31280. <code>metadata</code> field.
  31281. </td>
  31282. </tr>
  31283. <tr>
  31284. <td>
  31285. <code>spec</code></br>
  31286. <em>
  31287. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  31288. WebhookSpec
  31289. </a>
  31290. </em>
  31291. </td>
  31292. <td>
  31293. <br/>
  31294. <br/>
  31295. <table>
  31296. <tr>
  31297. <td>
  31298. <code>method</code></br>
  31299. <em>
  31300. string
  31301. </em>
  31302. </td>
  31303. <td>
  31304. <p>Webhook Method</p>
  31305. </td>
  31306. </tr>
  31307. <tr>
  31308. <td>
  31309. <code>url</code></br>
  31310. <em>
  31311. string
  31312. </em>
  31313. </td>
  31314. <td>
  31315. <p>Webhook url to call</p>
  31316. </td>
  31317. </tr>
  31318. <tr>
  31319. <td>
  31320. <code>headers</code></br>
  31321. <em>
  31322. map[string]string
  31323. </em>
  31324. </td>
  31325. <td>
  31326. <em>(Optional)</em>
  31327. <p>Headers</p>
  31328. </td>
  31329. </tr>
  31330. <tr>
  31331. <td>
  31332. <code>auth</code></br>
  31333. <em>
  31334. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  31335. AuthorizationProtocol
  31336. </a>
  31337. </em>
  31338. </td>
  31339. <td>
  31340. <em>(Optional)</em>
  31341. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  31342. </td>
  31343. </tr>
  31344. <tr>
  31345. <td>
  31346. <code>body</code></br>
  31347. <em>
  31348. string
  31349. </em>
  31350. </td>
  31351. <td>
  31352. <em>(Optional)</em>
  31353. <p>Body</p>
  31354. </td>
  31355. </tr>
  31356. <tr>
  31357. <td>
  31358. <code>timeout</code></br>
  31359. <em>
  31360. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  31361. Kubernetes meta/v1.Duration
  31362. </a>
  31363. </em>
  31364. </td>
  31365. <td>
  31366. <em>(Optional)</em>
  31367. <p>Timeout</p>
  31368. </td>
  31369. </tr>
  31370. <tr>
  31371. <td>
  31372. <code>result</code></br>
  31373. <em>
  31374. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  31375. WebhookResult
  31376. </a>
  31377. </em>
  31378. </td>
  31379. <td>
  31380. <p>Result formatting</p>
  31381. </td>
  31382. </tr>
  31383. <tr>
  31384. <td>
  31385. <code>secrets</code></br>
  31386. <em>
  31387. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  31388. []WebhookSecret
  31389. </a>
  31390. </em>
  31391. </td>
  31392. <td>
  31393. <em>(Optional)</em>
  31394. <p>Secrets to fill in templates
  31395. These secrets will be passed to the templating function as key value pairs under the given name</p>
  31396. </td>
  31397. </tr>
  31398. <tr>
  31399. <td>
  31400. <code>caBundle</code></br>
  31401. <em>
  31402. []byte
  31403. </em>
  31404. </td>
  31405. <td>
  31406. <em>(Optional)</em>
  31407. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  31408. if the Server URL is using HTTPS protocol. This parameter is ignored for
  31409. plain HTTP protocol connection. If not set the system root certificates
  31410. are used to validate the TLS connection.</p>
  31411. </td>
  31412. </tr>
  31413. <tr>
  31414. <td>
  31415. <code>caProvider</code></br>
  31416. <em>
  31417. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  31418. WebhookCAProvider
  31419. </a>
  31420. </em>
  31421. </td>
  31422. <td>
  31423. <em>(Optional)</em>
  31424. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  31425. </td>
  31426. </tr>
  31427. </table>
  31428. </td>
  31429. </tr>
  31430. </tbody>
  31431. </table>
  31432. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider
  31433. </h3>
  31434. <p>
  31435. (<em>Appears on:</em>
  31436. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  31437. </p>
  31438. <p>
  31439. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  31440. </p>
  31441. <table>
  31442. <thead>
  31443. <tr>
  31444. <th>Field</th>
  31445. <th>Description</th>
  31446. </tr>
  31447. </thead>
  31448. <tbody>
  31449. <tr>
  31450. <td>
  31451. <code>type</code></br>
  31452. <em>
  31453. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProviderType">
  31454. WebhookCAProviderType
  31455. </a>
  31456. </em>
  31457. </td>
  31458. <td>
  31459. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  31460. </td>
  31461. </tr>
  31462. <tr>
  31463. <td>
  31464. <code>name</code></br>
  31465. <em>
  31466. string
  31467. </em>
  31468. </td>
  31469. <td>
  31470. <p>The name of the object located at the provider type.</p>
  31471. </td>
  31472. </tr>
  31473. <tr>
  31474. <td>
  31475. <code>key</code></br>
  31476. <em>
  31477. string
  31478. </em>
  31479. </td>
  31480. <td>
  31481. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  31482. </td>
  31483. </tr>
  31484. <tr>
  31485. <td>
  31486. <code>namespace</code></br>
  31487. <em>
  31488. string
  31489. </em>
  31490. </td>
  31491. <td>
  31492. <em>(Optional)</em>
  31493. <p>The namespace the Provider type is in.</p>
  31494. </td>
  31495. </tr>
  31496. </tbody>
  31497. </table>
  31498. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProviderType">WebhookCAProviderType
  31499. (<code>string</code> alias)</p></h3>
  31500. <p>
  31501. (<em>Appears on:</em>
  31502. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider</a>)
  31503. </p>
  31504. <p>
  31505. <p>WebhookCAProviderType defines the type of provider for webhook CA certificates.</p>
  31506. </p>
  31507. <table>
  31508. <thead>
  31509. <tr>
  31510. <th>Value</th>
  31511. <th>Description</th>
  31512. </tr>
  31513. </thead>
  31514. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  31515. <td><p>WebhookCAProviderTypeConfigMap indicates the CA provider is a ConfigMap resource.</p>
  31516. </td>
  31517. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  31518. <td><p>WebhookCAProviderTypeSecret indicates the CA provider is a Secret resource.</p>
  31519. </td>
  31520. </tr></tbody>
  31521. </table>
  31522. <h3 id="generators.external-secrets.io/v1alpha1.WebhookResult">WebhookResult
  31523. </h3>
  31524. <p>
  31525. (<em>Appears on:</em>
  31526. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  31527. </p>
  31528. <p>
  31529. <p>WebhookResult defines how to format and extract results from the webhook response.</p>
  31530. </p>
  31531. <table>
  31532. <thead>
  31533. <tr>
  31534. <th>Field</th>
  31535. <th>Description</th>
  31536. </tr>
  31537. </thead>
  31538. <tbody>
  31539. <tr>
  31540. <td>
  31541. <code>jsonPath</code></br>
  31542. <em>
  31543. string
  31544. </em>
  31545. </td>
  31546. <td>
  31547. <em>(Optional)</em>
  31548. <p>Json path of return value</p>
  31549. </td>
  31550. </tr>
  31551. </tbody>
  31552. </table>
  31553. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret
  31554. </h3>
  31555. <p>
  31556. (<em>Appears on:</em>
  31557. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  31558. </p>
  31559. <p>
  31560. <p>WebhookSecret defines a secret reference that will be used in webhook templates.</p>
  31561. </p>
  31562. <table>
  31563. <thead>
  31564. <tr>
  31565. <th>Field</th>
  31566. <th>Description</th>
  31567. </tr>
  31568. </thead>
  31569. <tbody>
  31570. <tr>
  31571. <td>
  31572. <code>name</code></br>
  31573. <em>
  31574. string
  31575. </em>
  31576. </td>
  31577. <td>
  31578. <p>Name of this secret in templates</p>
  31579. </td>
  31580. </tr>
  31581. <tr>
  31582. <td>
  31583. <code>secretRef</code></br>
  31584. <em>
  31585. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  31586. SecretKeySelector
  31587. </a>
  31588. </em>
  31589. </td>
  31590. <td>
  31591. <p>Secret ref to fill in credentials</p>
  31592. </td>
  31593. </tr>
  31594. </tbody>
  31595. </table>
  31596. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec
  31597. </h3>
  31598. <p>
  31599. (<em>Appears on:</em>
  31600. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  31601. <a href="#generators.external-secrets.io/v1alpha1.Webhook">Webhook</a>)
  31602. </p>
  31603. <p>
  31604. <p>WebhookSpec controls the behavior of the external generator. Any body parameters should be passed to the server through the parameters field.</p>
  31605. </p>
  31606. <table>
  31607. <thead>
  31608. <tr>
  31609. <th>Field</th>
  31610. <th>Description</th>
  31611. </tr>
  31612. </thead>
  31613. <tbody>
  31614. <tr>
  31615. <td>
  31616. <code>method</code></br>
  31617. <em>
  31618. string
  31619. </em>
  31620. </td>
  31621. <td>
  31622. <p>Webhook Method</p>
  31623. </td>
  31624. </tr>
  31625. <tr>
  31626. <td>
  31627. <code>url</code></br>
  31628. <em>
  31629. string
  31630. </em>
  31631. </td>
  31632. <td>
  31633. <p>Webhook url to call</p>
  31634. </td>
  31635. </tr>
  31636. <tr>
  31637. <td>
  31638. <code>headers</code></br>
  31639. <em>
  31640. map[string]string
  31641. </em>
  31642. </td>
  31643. <td>
  31644. <em>(Optional)</em>
  31645. <p>Headers</p>
  31646. </td>
  31647. </tr>
  31648. <tr>
  31649. <td>
  31650. <code>auth</code></br>
  31651. <em>
  31652. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  31653. AuthorizationProtocol
  31654. </a>
  31655. </em>
  31656. </td>
  31657. <td>
  31658. <em>(Optional)</em>
  31659. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  31660. </td>
  31661. </tr>
  31662. <tr>
  31663. <td>
  31664. <code>body</code></br>
  31665. <em>
  31666. string
  31667. </em>
  31668. </td>
  31669. <td>
  31670. <em>(Optional)</em>
  31671. <p>Body</p>
  31672. </td>
  31673. </tr>
  31674. <tr>
  31675. <td>
  31676. <code>timeout</code></br>
  31677. <em>
  31678. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  31679. Kubernetes meta/v1.Duration
  31680. </a>
  31681. </em>
  31682. </td>
  31683. <td>
  31684. <em>(Optional)</em>
  31685. <p>Timeout</p>
  31686. </td>
  31687. </tr>
  31688. <tr>
  31689. <td>
  31690. <code>result</code></br>
  31691. <em>
  31692. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  31693. WebhookResult
  31694. </a>
  31695. </em>
  31696. </td>
  31697. <td>
  31698. <p>Result formatting</p>
  31699. </td>
  31700. </tr>
  31701. <tr>
  31702. <td>
  31703. <code>secrets</code></br>
  31704. <em>
  31705. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  31706. []WebhookSecret
  31707. </a>
  31708. </em>
  31709. </td>
  31710. <td>
  31711. <em>(Optional)</em>
  31712. <p>Secrets to fill in templates
  31713. These secrets will be passed to the templating function as key value pairs under the given name</p>
  31714. </td>
  31715. </tr>
  31716. <tr>
  31717. <td>
  31718. <code>caBundle</code></br>
  31719. <em>
  31720. []byte
  31721. </em>
  31722. </td>
  31723. <td>
  31724. <em>(Optional)</em>
  31725. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  31726. if the Server URL is using HTTPS protocol. This parameter is ignored for
  31727. plain HTTP protocol connection. If not set the system root certificates
  31728. are used to validate the TLS connection.</p>
  31729. </td>
  31730. </tr>
  31731. <tr>
  31732. <td>
  31733. <code>caProvider</code></br>
  31734. <em>
  31735. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  31736. WebhookCAProvider
  31737. </a>
  31738. </em>
  31739. </td>
  31740. <td>
  31741. <em>(Optional)</em>
  31742. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  31743. </td>
  31744. </tr>
  31745. </tbody>
  31746. </table>
  31747. <hr/>
  31748. <p><em>
  31749. Generated with <code>gen-crd-api-reference-docs</code>.
  31750. </em></p>
  31751. </article>
  31752. </div>
  31753. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  31754. </div>
  31755. </main>
  31756. <img referrerpolicy="no-referrer-when-downgrade"
  31757. src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""
  31758. hidden />
  31759. <footer class="md-footer">
  31760. <div class="md-footer-meta md-typeset">
  31761. <div class="md-footer-meta__inner md-grid">
  31762. <div class="md-copyright">
  31763. <div class="md-copyright__highlight">
  31764. &copy; 2025 The external-secrets Authors.<br/>
  31765. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  31766. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  31767. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  31768. </div>
  31769. Made with
  31770. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  31771. Material for MkDocs
  31772. </a>
  31773. </div>
  31774. </div>
  31775. </div>
  31776. </footer>
  31777. </div>
  31778. <div class="md-dialog" data-md-component="dialog">
  31779. <div class="md-dialog__inner md-typeset"></div>
  31780. </div>
  31781. <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>
  31782. <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
  31783. </body>
  31784. </html>