index.html 636 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180918191829183918491859186918791889189919091919192919391949195919691979198919992009201920292039204920592069207920892099210921192129213921492159216921792189219922092219222922392249225922692279228922992309231923292339234923592369237923892399240924192429243924492459246924792489249925092519252925392549255925692579258925992609261926292639264926592669267926892699270927192729273927492759276927792789279928092819282928392849285928692879288928992909291929292939294929592969297929892999300930193029303930493059306930793089309931093119312931393149315931693179318931993209321932293239324932593269327932893299330933193329333933493359336933793389339934093419342934393449345934693479348934993509351935293539354935593569357935893599360936193629363936493659366936793689369937093719372937393749375937693779378937993809381938293839384938593869387938893899390939193929393939493959396939793989399940094019402940394049405940694079408940994109411941294139414941594169417941894199420942194229423942494259426942794289429943094319432943394349435943694379438943994409441944294439444944594469447944894499450945194529453945494559456945794589459946094619462946394649465946694679468946994709471947294739474947594769477947894799480948194829483948494859486948794889489949094919492949394949495949694979498949995009501950295039504950595069507950895099510951195129513951495159516951795189519952095219522952395249525952695279528952995309531953295339534953595369537953895399540954195429543954495459546954795489549955095519552955395549555955695579558955995609561956295639564956595669567956895699570957195729573957495759576957795789579958095819582958395849585958695879588958995909591959295939594959595969597959895999600960196029603960496059606960796089609961096119612961396149615961696179618961996209621962296239624962596269627962896299630963196329633963496359636963796389639964096419642964396449645964696479648964996509651965296539654965596569657965896599660966196629663966496659666966796689669967096719672967396749675967696779678967996809681968296839684968596869687968896899690969196929693969496959696969796989699970097019702970397049705970697079708970997109711971297139714971597169717971897199720972197229723972497259726972797289729973097319732973397349735973697379738973997409741974297439744974597469747974897499750975197529753975497559756975797589759976097619762976397649765976697679768976997709771977297739774977597769777977897799780978197829783978497859786978797889789979097919792979397949795979697979798979998009801980298039804980598069807980898099810981198129813981498159816981798189819982098219822982398249825982698279828982998309831983298339834983598369837983898399840984198429843984498459846984798489849985098519852985398549855985698579858985998609861986298639864986598669867986898699870987198729873987498759876987798789879988098819882988398849885988698879888988998909891989298939894989598969897989898999900990199029903990499059906990799089909991099119912991399149915991699179918991999209921992299239924992599269927992899299930993199329933993499359936993799389939994099419942994399449945994699479948994999509951995299539954995599569957995899599960996199629963996499659966996799689969997099719972997399749975997699779978997999809981998299839984998599869987998899899990999199929993999499959996999799989999100001000110002100031000410005100061000710008100091001010011100121001310014100151001610017100181001910020100211002210023100241002510026100271002810029100301003110032100331003410035100361003710038100391004010041100421004310044100451004610047100481004910050100511005210053100541005510056100571005810059100601006110062100631006410065100661006710068100691007010071100721007310074100751007610077100781007910080100811008210083100841008510086100871008810089100901009110092100931009410095100961009710098100991010010101101021010310104101051010610107101081010910110101111011210113101141011510116101171011810119101201012110122101231012410125101261012710128101291013010131101321013310134101351013610137101381013910140101411014210143101441014510146101471014810149101501015110152101531015410155101561015710158101591016010161101621016310164101651016610167101681016910170101711017210173101741017510176101771017810179101801018110182101831018410185101861018710188101891019010191101921019310194101951019610197101981019910200102011020210203102041020510206102071020810209102101021110212102131021410215102161021710218102191022010221102221022310224102251022610227102281022910230102311023210233102341023510236102371023810239102401024110242102431024410245102461024710248102491025010251102521025310254102551025610257102581025910260102611026210263102641026510266102671026810269102701027110272102731027410275102761027710278102791028010281102821028310284102851028610287102881028910290102911029210293102941029510296102971029810299103001030110302103031030410305103061030710308103091031010311103121031310314103151031610317103181031910320103211032210323103241032510326103271032810329103301033110332103331033410335103361033710338103391034010341103421034310344103451034610347103481034910350103511035210353103541035510356103571035810359103601036110362103631036410365103661036710368103691037010371103721037310374103751037610377103781037910380103811038210383103841038510386103871038810389103901039110392103931039410395103961039710398103991040010401104021040310404104051040610407104081040910410104111041210413104141041510416104171041810419104201042110422104231042410425104261042710428104291043010431104321043310434104351043610437104381043910440104411044210443104441044510446104471044810449104501045110452104531045410455104561045710458104591046010461104621046310464104651046610467104681046910470104711047210473104741047510476104771047810479104801048110482104831048410485104861048710488104891049010491104921049310494104951049610497104981049910500105011050210503105041050510506105071050810509105101051110512105131051410515105161051710518105191052010521105221052310524105251052610527105281052910530105311053210533105341053510536105371053810539105401054110542105431054410545105461054710548105491055010551105521055310554105551055610557105581055910560105611056210563105641056510566105671056810569105701057110572105731057410575105761057710578105791058010581105821058310584105851058610587105881058910590105911059210593105941059510596105971059810599106001060110602106031060410605106061060710608106091061010611106121061310614106151061610617106181061910620106211062210623106241062510626106271062810629106301063110632106331063410635106361063710638106391064010641106421064310644106451064610647106481064910650106511065210653106541065510656106571065810659106601066110662106631066410665106661066710668106691067010671106721067310674106751067610677106781067910680106811068210683106841068510686106871068810689106901069110692106931069410695106961069710698106991070010701107021070310704107051070610707107081070910710107111071210713107141071510716107171071810719107201072110722107231072410725107261072710728107291073010731107321073310734107351073610737107381073910740107411074210743107441074510746107471074810749107501075110752107531075410755107561075710758107591076010761107621076310764107651076610767107681076910770107711077210773107741077510776107771077810779107801078110782107831078410785107861078710788107891079010791107921079310794107951079610797107981079910800108011080210803108041080510806108071080810809108101081110812108131081410815108161081710818108191082010821108221082310824108251082610827108281082910830108311083210833108341083510836108371083810839108401084110842108431084410845108461084710848108491085010851108521085310854108551085610857108581085910860108611086210863108641086510866108671086810869108701087110872108731087410875108761087710878108791088010881108821088310884108851088610887108881088910890108911089210893108941089510896108971089810899109001090110902109031090410905109061090710908109091091010911109121091310914109151091610917109181091910920109211092210923109241092510926109271092810929109301093110932109331093410935109361093710938109391094010941109421094310944109451094610947109481094910950109511095210953109541095510956109571095810959109601096110962109631096410965109661096710968109691097010971109721097310974109751097610977109781097910980109811098210983109841098510986109871098810989109901099110992109931099410995109961099710998109991100011001110021100311004110051100611007110081100911010110111101211013110141101511016110171101811019110201102111022110231102411025110261102711028110291103011031110321103311034110351103611037110381103911040110411104211043110441104511046110471104811049110501105111052110531105411055110561105711058110591106011061110621106311064110651106611067110681106911070110711107211073110741107511076110771107811079110801108111082110831108411085110861108711088110891109011091110921109311094110951109611097110981109911100111011110211103111041110511106111071110811109111101111111112111131111411115111161111711118111191112011121111221112311124111251112611127111281112911130111311113211133111341113511136111371113811139111401114111142111431114411145111461114711148111491115011151111521115311154111551115611157111581115911160111611116211163111641116511166111671116811169111701117111172111731117411175111761117711178111791118011181111821118311184111851118611187111881118911190111911119211193111941119511196111971119811199112001120111202112031120411205112061120711208112091121011211112121121311214112151121611217112181121911220112211122211223112241122511226112271122811229112301123111232112331123411235112361123711238112391124011241112421124311244112451124611247112481124911250112511125211253112541125511256112571125811259112601126111262112631126411265112661126711268112691127011271112721127311274112751127611277112781127911280112811128211283112841128511286112871128811289112901129111292112931129411295112961129711298112991130011301113021130311304113051130611307113081130911310113111131211313113141131511316113171131811319113201132111322113231132411325113261132711328113291133011331113321133311334113351133611337113381133911340113411134211343113441134511346113471134811349113501135111352113531135411355113561135711358113591136011361113621136311364113651136611367113681136911370113711137211373113741137511376113771137811379113801138111382113831138411385113861138711388113891139011391113921139311394113951139611397113981139911400114011140211403114041140511406114071140811409114101141111412114131141411415114161141711418114191142011421114221142311424114251142611427114281142911430114311143211433114341143511436114371143811439114401144111442114431144411445114461144711448114491145011451114521145311454114551145611457114581145911460114611146211463114641146511466114671146811469114701147111472114731147411475114761147711478114791148011481114821148311484114851148611487114881148911490114911149211493114941149511496114971149811499115001150111502115031150411505115061150711508115091151011511115121151311514115151151611517115181151911520115211152211523115241152511526115271152811529115301153111532115331153411535115361153711538115391154011541115421154311544115451154611547115481154911550115511155211553115541155511556115571155811559115601156111562115631156411565115661156711568115691157011571115721157311574115751157611577115781157911580115811158211583115841158511586115871158811589115901159111592115931159411595115961159711598115991160011601116021160311604116051160611607116081160911610116111161211613116141161511616116171161811619116201162111622116231162411625116261162711628116291163011631116321163311634116351163611637116381163911640116411164211643116441164511646116471164811649116501165111652116531165411655116561165711658116591166011661116621166311664116651166611667116681166911670116711167211673116741167511676116771167811679116801168111682116831168411685116861168711688116891169011691116921169311694116951169611697116981169911700117011170211703117041170511706117071170811709117101171111712117131171411715117161171711718117191172011721117221172311724117251172611727117281172911730117311173211733117341173511736117371173811739117401174111742117431174411745117461174711748117491175011751117521175311754117551175611757117581175911760117611176211763117641176511766117671176811769117701177111772117731177411775117761177711778117791178011781117821178311784117851178611787117881178911790117911179211793117941179511796117971179811799118001180111802118031180411805118061180711808118091181011811118121181311814118151181611817118181181911820118211182211823118241182511826118271182811829118301183111832118331183411835118361183711838118391184011841118421184311844118451184611847118481184911850118511185211853118541185511856118571185811859118601186111862118631186411865118661186711868118691187011871118721187311874118751187611877118781187911880118811188211883118841188511886118871188811889118901189111892118931189411895118961189711898118991190011901119021190311904119051190611907119081190911910119111191211913119141191511916119171191811919119201192111922119231192411925119261192711928119291193011931119321193311934119351193611937119381193911940119411194211943119441194511946119471194811949119501195111952119531195411955119561195711958119591196011961119621196311964119651196611967119681196911970119711197211973119741197511976119771197811979119801198111982119831198411985119861198711988119891199011991119921199311994119951199611997119981199912000120011200212003120041200512006120071200812009120101201112012120131201412015120161201712018120191202012021120221202312024120251202612027120281202912030120311203212033120341203512036120371203812039120401204112042120431204412045120461204712048120491205012051120521205312054120551205612057120581205912060120611206212063120641206512066120671206812069120701207112072120731207412075120761207712078120791208012081120821208312084120851208612087120881208912090120911209212093120941209512096120971209812099121001210112102121031210412105121061210712108121091211012111121121211312114121151211612117121181211912120121211212212123121241212512126121271212812129121301213112132121331213412135121361213712138121391214012141121421214312144121451214612147121481214912150121511215212153121541215512156121571215812159121601216112162121631216412165121661216712168121691217012171121721217312174121751217612177121781217912180121811218212183121841218512186121871218812189121901219112192121931219412195121961219712198121991220012201122021220312204122051220612207122081220912210122111221212213122141221512216122171221812219122201222112222122231222412225122261222712228122291223012231122321223312234122351223612237122381223912240122411224212243122441224512246122471224812249122501225112252122531225412255122561225712258122591226012261122621226312264122651226612267122681226912270122711227212273122741227512276122771227812279122801228112282122831228412285122861228712288122891229012291122921229312294122951229612297122981229912300123011230212303123041230512306123071230812309123101231112312123131231412315123161231712318123191232012321123221232312324123251232612327123281232912330123311233212333123341233512336123371233812339123401234112342123431234412345123461234712348123491235012351123521235312354123551235612357123581235912360123611236212363123641236512366123671236812369123701237112372123731237412375123761237712378123791238012381123821238312384123851238612387123881238912390123911239212393123941239512396123971239812399124001240112402124031240412405124061240712408124091241012411124121241312414124151241612417124181241912420124211242212423124241242512426124271242812429124301243112432124331243412435124361243712438124391244012441124421244312444124451244612447124481244912450124511245212453124541245512456124571245812459124601246112462124631246412465124661246712468124691247012471124721247312474124751247612477124781247912480124811248212483124841248512486124871248812489124901249112492124931249412495124961249712498124991250012501125021250312504125051250612507125081250912510125111251212513125141251512516125171251812519125201252112522125231252412525125261252712528125291253012531125321253312534125351253612537125381253912540125411254212543125441254512546125471254812549125501255112552125531255412555125561255712558125591256012561125621256312564125651256612567125681256912570125711257212573125741257512576125771257812579125801258112582125831258412585125861258712588125891259012591125921259312594125951259612597125981259912600126011260212603126041260512606126071260812609126101261112612126131261412615126161261712618126191262012621126221262312624126251262612627126281262912630126311263212633126341263512636126371263812639126401264112642126431264412645126461264712648126491265012651126521265312654126551265612657126581265912660126611266212663126641266512666126671266812669126701267112672126731267412675126761267712678126791268012681126821268312684126851268612687126881268912690126911269212693126941269512696126971269812699127001270112702127031270412705127061270712708127091271012711127121271312714127151271612717127181271912720127211272212723127241272512726127271272812729127301273112732127331273412735127361273712738127391274012741127421274312744127451274612747127481274912750127511275212753127541275512756127571275812759127601276112762127631276412765127661276712768127691277012771127721277312774127751277612777127781277912780127811278212783127841278512786127871278812789127901279112792127931279412795127961279712798127991280012801128021280312804128051280612807128081280912810128111281212813128141281512816128171281812819128201282112822128231282412825128261282712828128291283012831128321283312834128351283612837128381283912840128411284212843128441284512846128471284812849128501285112852128531285412855128561285712858128591286012861128621286312864128651286612867128681286912870128711287212873128741287512876128771287812879128801288112882128831288412885128861288712888128891289012891128921289312894128951289612897128981289912900129011290212903129041290512906129071290812909129101291112912129131291412915129161291712918129191292012921129221292312924129251292612927129281292912930129311293212933129341293512936129371293812939129401294112942129431294412945129461294712948129491295012951129521295312954129551295612957129581295912960129611296212963129641296512966129671296812969129701297112972129731297412975129761297712978129791298012981129821298312984129851298612987129881298912990129911299212993129941299512996129971299812999130001300113002130031300413005130061300713008130091301013011130121301313014130151301613017130181301913020130211302213023130241302513026130271302813029130301303113032130331303413035130361303713038130391304013041130421304313044130451304613047130481304913050130511305213053130541305513056130571305813059130601306113062130631306413065130661306713068130691307013071130721307313074130751307613077130781307913080130811308213083130841308513086130871308813089130901309113092130931309413095130961309713098130991310013101131021310313104131051310613107131081310913110131111311213113131141311513116131171311813119131201312113122131231312413125131261312713128131291313013131131321313313134131351313613137131381313913140131411314213143131441314513146131471314813149131501315113152131531315413155131561315713158131591316013161131621316313164131651316613167131681316913170131711317213173131741317513176131771317813179131801318113182131831318413185131861318713188131891319013191131921319313194131951319613197131981319913200132011320213203132041320513206132071320813209132101321113212132131321413215132161321713218132191322013221132221322313224132251322613227132281322913230132311323213233132341323513236132371323813239132401324113242132431324413245132461324713248132491325013251132521325313254132551325613257132581325913260132611326213263132641326513266132671326813269132701327113272132731327413275132761327713278132791328013281132821328313284132851328613287132881328913290132911329213293132941329513296132971329813299133001330113302133031330413305133061330713308133091331013311133121331313314133151331613317133181331913320133211332213323133241332513326133271332813329133301333113332133331333413335133361333713338133391334013341133421334313344133451334613347133481334913350133511335213353133541335513356133571335813359133601336113362133631336413365133661336713368133691337013371133721337313374133751337613377133781337913380133811338213383133841338513386133871338813389133901339113392133931339413395133961339713398133991340013401134021340313404134051340613407134081340913410134111341213413134141341513416134171341813419134201342113422134231342413425134261342713428134291343013431134321343313434134351343613437134381343913440134411344213443134441344513446134471344813449134501345113452134531345413455134561345713458134591346013461134621346313464134651346613467134681346913470134711347213473134741347513476134771347813479134801348113482134831348413485134861348713488134891349013491134921349313494134951349613497134981349913500135011350213503135041350513506135071350813509135101351113512135131351413515135161351713518135191352013521135221352313524135251352613527135281352913530135311353213533135341353513536135371353813539135401354113542135431354413545135461354713548135491355013551135521355313554135551355613557135581355913560135611356213563135641356513566135671356813569135701357113572135731357413575135761357713578135791358013581135821358313584135851358613587135881358913590135911359213593135941359513596135971359813599136001360113602136031360413605136061360713608136091361013611136121361313614136151361613617136181361913620136211362213623136241362513626136271362813629136301363113632136331363413635136361363713638136391364013641136421364313644136451364613647136481364913650136511365213653136541365513656136571365813659136601366113662136631366413665136661366713668136691367013671136721367313674136751367613677136781367913680136811368213683136841368513686136871368813689136901369113692136931369413695136961369713698136991370013701137021370313704137051370613707137081370913710137111371213713137141371513716137171371813719137201372113722137231372413725137261372713728137291373013731137321373313734137351373613737137381373913740137411374213743137441374513746137471374813749137501375113752137531375413755137561375713758137591376013761137621376313764137651376613767137681376913770137711377213773137741377513776137771377813779137801378113782137831378413785137861378713788137891379013791137921379313794137951379613797137981379913800138011380213803138041380513806138071380813809138101381113812138131381413815138161381713818138191382013821138221382313824138251382613827138281382913830138311383213833138341383513836138371383813839138401384113842138431384413845138461384713848138491385013851138521385313854138551385613857138581385913860138611386213863138641386513866138671386813869138701387113872138731387413875138761387713878138791388013881138821388313884138851388613887138881388913890138911389213893138941389513896138971389813899139001390113902139031390413905139061390713908139091391013911139121391313914139151391613917139181391913920139211392213923139241392513926139271392813929139301393113932139331393413935139361393713938139391394013941139421394313944139451394613947139481394913950139511395213953139541395513956139571395813959139601396113962139631396413965139661396713968139691397013971139721397313974139751397613977139781397913980139811398213983139841398513986139871398813989139901399113992139931399413995139961399713998139991400014001140021400314004140051400614007140081400914010140111401214013140141401514016140171401814019140201402114022140231402414025140261402714028140291403014031140321403314034140351403614037140381403914040140411404214043140441404514046140471404814049140501405114052140531405414055140561405714058140591406014061140621406314064140651406614067140681406914070140711407214073140741407514076140771407814079140801408114082140831408414085140861408714088140891409014091140921409314094140951409614097140981409914100141011410214103141041410514106141071410814109141101411114112141131411414115141161411714118141191412014121141221412314124141251412614127141281412914130141311413214133141341413514136141371413814139141401414114142141431414414145141461414714148141491415014151141521415314154141551415614157141581415914160141611416214163141641416514166141671416814169141701417114172141731417414175141761417714178141791418014181141821418314184141851418614187141881418914190141911419214193141941419514196141971419814199142001420114202142031420414205142061420714208142091421014211142121421314214142151421614217142181421914220142211422214223142241422514226142271422814229142301423114232142331423414235142361423714238142391424014241142421424314244142451424614247142481424914250142511425214253142541425514256142571425814259142601426114262142631426414265142661426714268142691427014271142721427314274142751427614277142781427914280142811428214283142841428514286142871428814289142901429114292142931429414295142961429714298142991430014301143021430314304143051430614307143081430914310143111431214313143141431514316143171431814319143201432114322143231432414325143261432714328143291433014331143321433314334143351433614337143381433914340143411434214343143441434514346143471434814349143501435114352143531435414355143561435714358143591436014361143621436314364143651436614367143681436914370143711437214373143741437514376143771437814379143801438114382143831438414385143861438714388143891439014391143921439314394143951439614397143981439914400144011440214403144041440514406144071440814409144101441114412144131441414415144161441714418144191442014421144221442314424144251442614427144281442914430144311443214433144341443514436144371443814439144401444114442144431444414445144461444714448144491445014451144521445314454144551445614457144581445914460144611446214463144641446514466144671446814469144701447114472144731447414475144761447714478144791448014481144821448314484144851448614487144881448914490144911449214493144941449514496144971449814499145001450114502145031450414505145061450714508145091451014511145121451314514145151451614517145181451914520145211452214523145241452514526145271452814529145301453114532145331453414535145361453714538145391454014541145421454314544145451454614547145481454914550145511455214553145541455514556145571455814559145601456114562145631456414565145661456714568145691457014571145721457314574145751457614577145781457914580145811458214583145841458514586145871458814589145901459114592145931459414595145961459714598145991460014601146021460314604146051460614607146081460914610146111461214613146141461514616146171461814619146201462114622146231462414625146261462714628146291463014631146321463314634146351463614637146381463914640146411464214643146441464514646146471464814649146501465114652146531465414655146561465714658146591466014661146621466314664146651466614667146681466914670146711467214673146741467514676146771467814679146801468114682146831468414685146861468714688146891469014691146921469314694146951469614697146981469914700147011470214703147041470514706147071470814709147101471114712147131471414715147161471714718147191472014721147221472314724147251472614727147281472914730147311473214733147341473514736147371473814739147401474114742147431474414745147461474714748147491475014751147521475314754147551475614757147581475914760147611476214763147641476514766147671476814769147701477114772147731477414775147761477714778147791478014781147821478314784147851478614787147881478914790147911479214793147941479514796147971479814799148001480114802148031480414805148061480714808148091481014811148121481314814148151481614817148181481914820148211482214823148241482514826148271482814829148301483114832148331483414835148361483714838148391484014841148421484314844148451484614847148481484914850148511485214853148541485514856148571485814859148601486114862148631486414865148661486714868148691487014871148721487314874148751487614877148781487914880148811488214883148841488514886148871488814889148901489114892148931489414895148961489714898148991490014901149021490314904149051490614907149081490914910149111491214913149141491514916149171491814919149201492114922149231492414925149261492714928149291493014931149321493314934149351493614937149381493914940149411494214943149441494514946149471494814949149501495114952149531495414955149561495714958149591496014961149621496314964149651496614967149681496914970149711497214973149741497514976149771497814979149801498114982149831498414985149861498714988149891499014991149921499314994149951499614997149981499915000150011500215003150041500515006150071500815009150101501115012150131501415015150161501715018150191502015021150221502315024150251502615027150281502915030150311503215033150341503515036150371503815039150401504115042150431504415045150461504715048150491505015051150521505315054150551505615057150581505915060150611506215063150641506515066150671506815069150701507115072150731507415075150761507715078150791508015081150821508315084150851508615087150881508915090150911509215093150941509515096150971509815099151001510115102151031510415105151061510715108151091511015111151121511315114151151511615117151181511915120151211512215123151241512515126151271512815129151301513115132151331513415135151361513715138151391514015141151421514315144151451514615147151481514915150151511515215153151541515515156151571515815159151601516115162151631516415165151661516715168151691517015171151721517315174151751517615177151781517915180151811518215183151841518515186151871518815189151901519115192151931519415195151961519715198151991520015201152021520315204152051520615207152081520915210152111521215213152141521515216152171521815219152201522115222152231522415225152261522715228152291523015231152321523315234152351523615237152381523915240152411524215243152441524515246152471524815249152501525115252152531525415255152561525715258152591526015261152621526315264152651526615267152681526915270152711527215273152741527515276152771527815279152801528115282152831528415285152861528715288152891529015291152921529315294152951529615297152981529915300153011530215303153041530515306153071530815309153101531115312153131531415315153161531715318153191532015321153221532315324153251532615327153281532915330153311533215333153341533515336153371533815339153401534115342153431534415345153461534715348153491535015351153521535315354153551535615357153581535915360153611536215363153641536515366153671536815369153701537115372153731537415375153761537715378153791538015381153821538315384153851538615387153881538915390153911539215393153941539515396153971539815399154001540115402154031540415405154061540715408154091541015411154121541315414154151541615417154181541915420154211542215423154241542515426154271542815429154301543115432154331543415435154361543715438154391544015441154421544315444154451544615447154481544915450154511545215453154541545515456154571545815459154601546115462154631546415465154661546715468154691547015471154721547315474154751547615477154781547915480154811548215483154841548515486154871548815489154901549115492154931549415495154961549715498154991550015501155021550315504155051550615507155081550915510155111551215513155141551515516155171551815519155201552115522155231552415525155261552715528155291553015531155321553315534155351553615537155381553915540155411554215543155441554515546155471554815549155501555115552155531555415555155561555715558155591556015561155621556315564155651556615567155681556915570155711557215573155741557515576155771557815579155801558115582155831558415585155861558715588155891559015591155921559315594155951559615597155981559915600156011560215603156041560515606156071560815609156101561115612156131561415615156161561715618156191562015621156221562315624156251562615627156281562915630156311563215633156341563515636156371563815639156401564115642156431564415645156461564715648156491565015651156521565315654156551565615657156581565915660156611566215663156641566515666156671566815669156701567115672156731567415675156761567715678156791568015681156821568315684156851568615687156881568915690156911569215693156941569515696156971569815699157001570115702157031570415705157061570715708157091571015711157121571315714157151571615717157181571915720157211572215723157241572515726157271572815729157301573115732157331573415735157361573715738157391574015741157421574315744157451574615747157481574915750157511575215753157541575515756157571575815759157601576115762157631576415765157661576715768157691577015771157721577315774157751577615777157781577915780157811578215783157841578515786157871578815789157901579115792157931579415795157961579715798157991580015801158021580315804158051580615807158081580915810158111581215813158141581515816158171581815819158201582115822158231582415825158261582715828158291583015831158321583315834158351583615837158381583915840158411584215843158441584515846158471584815849158501585115852158531585415855158561585715858158591586015861158621586315864158651586615867158681586915870158711587215873158741587515876158771587815879158801588115882158831588415885158861588715888158891589015891158921589315894158951589615897158981589915900159011590215903159041590515906159071590815909159101591115912159131591415915159161591715918159191592015921159221592315924159251592615927159281592915930159311593215933159341593515936159371593815939159401594115942159431594415945159461594715948159491595015951159521595315954159551595615957159581595915960159611596215963159641596515966159671596815969159701597115972159731597415975159761597715978159791598015981159821598315984159851598615987159881598915990159911599215993159941599515996159971599815999160001600116002160031600416005160061600716008160091601016011160121601316014160151601616017160181601916020160211602216023160241602516026160271602816029160301603116032160331603416035160361603716038160391604016041160421604316044160451604616047160481604916050160511605216053160541605516056160571605816059160601606116062160631606416065160661606716068160691607016071160721607316074160751607616077160781607916080160811608216083160841608516086160871608816089160901609116092160931609416095160961609716098160991610016101161021610316104161051610616107161081610916110161111611216113161141611516116161171611816119161201612116122161231612416125161261612716128161291613016131161321613316134161351613616137161381613916140161411614216143161441614516146161471614816149161501615116152161531615416155161561615716158161591616016161161621616316164161651616616167161681616916170161711617216173161741617516176161771617816179161801618116182161831618416185161861618716188161891619016191161921619316194161951619616197161981619916200162011620216203162041620516206162071620816209162101621116212162131621416215162161621716218162191622016221162221622316224162251622616227162281622916230162311623216233162341623516236162371623816239162401624116242162431624416245162461624716248162491625016251162521625316254162551625616257162581625916260162611626216263162641626516266162671626816269162701627116272162731627416275162761627716278162791628016281162821628316284162851628616287162881628916290162911629216293162941629516296162971629816299163001630116302163031630416305163061630716308163091631016311163121631316314163151631616317163181631916320163211632216323163241632516326163271632816329163301633116332163331633416335163361633716338163391634016341163421634316344163451634616347163481634916350163511635216353163541635516356163571635816359163601636116362163631636416365163661636716368163691637016371163721637316374163751637616377163781637916380163811638216383163841638516386163871638816389163901639116392163931639416395163961639716398163991640016401164021640316404164051640616407164081640916410164111641216413164141641516416164171641816419164201642116422164231642416425164261642716428164291643016431164321643316434164351643616437164381643916440164411644216443164441644516446164471644816449164501645116452164531645416455164561645716458164591646016461164621646316464164651646616467164681646916470164711647216473164741647516476164771647816479164801648116482164831648416485164861648716488164891649016491164921649316494164951649616497164981649916500165011650216503165041650516506165071650816509165101651116512165131651416515165161651716518165191652016521165221652316524165251652616527165281652916530165311653216533165341653516536165371653816539165401654116542165431654416545165461654716548165491655016551165521655316554165551655616557165581655916560165611656216563165641656516566165671656816569165701657116572165731657416575165761657716578165791658016581165821658316584165851658616587165881658916590165911659216593165941659516596165971659816599166001660116602166031660416605166061660716608166091661016611166121661316614166151661616617166181661916620166211662216623166241662516626166271662816629166301663116632166331663416635166361663716638166391664016641166421664316644166451664616647166481664916650166511665216653166541665516656166571665816659166601666116662166631666416665166661666716668166691667016671166721667316674166751667616677166781667916680166811668216683166841668516686166871668816689166901669116692166931669416695166961669716698166991670016701167021670316704167051670616707167081670916710167111671216713167141671516716167171671816719167201672116722167231672416725167261672716728167291673016731167321673316734167351673616737167381673916740167411674216743167441674516746167471674816749167501675116752167531675416755167561675716758167591676016761167621676316764167651676616767167681676916770167711677216773167741677516776167771677816779167801678116782167831678416785167861678716788167891679016791167921679316794167951679616797167981679916800168011680216803168041680516806168071680816809168101681116812168131681416815168161681716818168191682016821168221682316824168251682616827168281682916830168311683216833168341683516836168371683816839168401684116842168431684416845168461684716848168491685016851168521685316854168551685616857168581685916860168611686216863168641686516866168671686816869168701687116872168731687416875168761687716878168791688016881168821688316884168851688616887168881688916890168911689216893168941689516896168971689816899169001690116902169031690416905169061690716908169091691016911169121691316914169151691616917169181691916920169211692216923169241692516926169271692816929169301693116932169331693416935169361693716938169391694016941169421694316944169451694616947169481694916950169511695216953169541695516956169571695816959169601696116962169631696416965169661696716968169691697016971169721697316974169751697616977169781697916980169811698216983169841698516986169871698816989169901699116992169931699416995169961699716998169991700017001170021700317004170051700617007170081700917010170111701217013170141701517016170171701817019170201702117022170231702417025170261702717028170291703017031170321703317034170351703617037170381703917040170411704217043170441704517046170471704817049170501705117052170531705417055170561705717058170591706017061170621706317064170651706617067170681706917070170711707217073170741707517076170771707817079170801708117082170831708417085170861708717088170891709017091170921709317094170951709617097170981709917100171011710217103171041710517106171071710817109171101711117112171131711417115171161711717118171191712017121171221712317124171251712617127171281712917130171311713217133171341713517136171371713817139171401714117142171431714417145171461714717148171491715017151171521715317154171551715617157171581715917160171611716217163171641716517166171671716817169171701717117172171731717417175171761717717178171791718017181171821718317184171851718617187171881718917190171911719217193171941719517196171971719817199172001720117202172031720417205172061720717208172091721017211172121721317214172151721617217172181721917220172211722217223172241722517226172271722817229172301723117232172331723417235172361723717238172391724017241172421724317244172451724617247172481724917250172511725217253172541725517256172571725817259172601726117262172631726417265172661726717268172691727017271172721727317274172751727617277172781727917280172811728217283172841728517286172871728817289172901729117292172931729417295172961729717298172991730017301173021730317304173051730617307173081730917310173111731217313173141731517316173171731817319173201732117322173231732417325173261732717328173291733017331173321733317334173351733617337173381733917340173411734217343173441734517346173471734817349173501735117352173531735417355173561735717358173591736017361173621736317364173651736617367173681736917370173711737217373173741737517376173771737817379173801738117382173831738417385173861738717388173891739017391173921739317394173951739617397173981739917400174011740217403174041740517406174071740817409174101741117412174131741417415174161741717418174191742017421174221742317424174251742617427174281742917430174311743217433174341743517436174371743817439174401744117442174431744417445174461744717448174491745017451174521745317454174551745617457174581745917460174611746217463174641746517466174671746817469174701747117472174731747417475174761747717478174791748017481174821748317484174851748617487174881748917490174911749217493174941749517496174971749817499175001750117502175031750417505175061750717508175091751017511175121751317514175151751617517175181751917520175211752217523175241752517526175271752817529175301753117532175331753417535175361753717538175391754017541175421754317544175451754617547175481754917550175511755217553175541755517556175571755817559175601756117562175631756417565175661756717568175691757017571175721757317574175751757617577175781757917580175811758217583175841758517586175871758817589175901759117592175931759417595175961759717598175991760017601176021760317604176051760617607176081760917610176111761217613176141761517616176171761817619176201762117622176231762417625176261762717628176291763017631176321763317634176351763617637176381763917640176411764217643176441764517646176471764817649176501765117652176531765417655176561765717658176591766017661176621766317664176651766617667176681766917670176711767217673176741767517676176771767817679176801768117682176831768417685176861768717688176891769017691176921769317694176951769617697176981769917700177011770217703177041770517706177071770817709177101771117712177131771417715177161771717718177191772017721177221772317724177251772617727177281772917730177311773217733177341773517736177371773817739177401774117742177431774417745177461774717748177491775017751177521775317754177551775617757177581775917760177611776217763177641776517766177671776817769177701777117772177731777417775177761777717778177791778017781177821778317784177851778617787177881778917790177911779217793177941779517796177971779817799178001780117802178031780417805178061780717808178091781017811178121781317814178151781617817178181781917820178211782217823178241782517826178271782817829178301783117832178331783417835178361783717838178391784017841178421784317844178451784617847178481784917850178511785217853178541785517856178571785817859178601786117862178631786417865178661786717868178691787017871178721787317874178751787617877178781787917880178811788217883178841788517886178871788817889178901789117892178931789417895178961789717898178991790017901179021790317904179051790617907179081790917910179111791217913179141791517916179171791817919179201792117922179231792417925179261792717928179291793017931179321793317934179351793617937179381793917940179411794217943179441794517946179471794817949179501795117952179531795417955179561795717958179591796017961179621796317964179651796617967179681796917970179711797217973179741797517976179771797817979179801798117982179831798417985179861798717988179891799017991179921799317994179951799617997179981799918000180011800218003180041800518006180071800818009180101801118012180131801418015180161801718018180191802018021180221802318024180251802618027180281802918030180311803218033180341803518036180371803818039180401804118042180431804418045180461804718048180491805018051180521805318054180551805618057180581805918060180611806218063180641806518066180671806818069180701807118072180731807418075180761807718078180791808018081180821808318084180851808618087180881808918090180911809218093180941809518096180971809818099181001810118102181031810418105181061810718108181091811018111181121811318114181151811618117181181811918120181211812218123181241812518126181271812818129181301813118132181331813418135181361813718138181391814018141181421814318144181451814618147181481814918150181511815218153181541815518156181571815818159181601816118162181631816418165181661816718168181691817018171181721817318174181751817618177181781817918180181811818218183181841818518186181871818818189181901819118192181931819418195181961819718198181991820018201182021820318204182051820618207182081820918210182111821218213182141821518216182171821818219182201822118222182231822418225182261822718228182291823018231182321823318234182351823618237182381823918240182411824218243182441824518246182471824818249182501825118252182531825418255182561825718258182591826018261182621826318264182651826618267182681826918270182711827218273182741827518276182771827818279182801828118282182831828418285182861828718288182891829018291182921829318294182951829618297182981829918300183011830218303183041830518306183071830818309183101831118312183131831418315183161831718318183191832018321183221832318324183251832618327183281832918330183311833218333183341833518336183371833818339183401834118342183431834418345183461834718348183491835018351183521835318354183551835618357183581835918360183611836218363183641836518366183671836818369183701837118372183731837418375183761837718378183791838018381183821838318384183851838618387183881838918390183911839218393183941839518396183971839818399184001840118402184031840418405184061840718408184091841018411184121841318414184151841618417184181841918420184211842218423184241842518426184271842818429184301843118432184331843418435184361843718438184391844018441184421844318444184451844618447184481844918450184511845218453184541845518456184571845818459184601846118462184631846418465184661846718468184691847018471184721847318474184751847618477184781847918480184811848218483184841848518486184871848818489184901849118492184931849418495184961849718498184991850018501185021850318504185051850618507185081850918510185111851218513185141851518516185171851818519185201852118522185231852418525185261852718528185291853018531185321853318534185351853618537185381853918540185411854218543185441854518546185471854818549185501855118552185531855418555185561855718558185591856018561185621856318564185651856618567185681856918570185711857218573185741857518576185771857818579185801858118582185831858418585185861858718588185891859018591185921859318594185951859618597185981859918600186011860218603186041860518606186071860818609186101861118612186131861418615186161861718618186191862018621186221862318624186251862618627186281862918630186311863218633186341863518636186371863818639186401864118642186431864418645186461864718648186491865018651186521865318654186551865618657186581865918660186611866218663186641866518666186671866818669186701867118672186731867418675186761867718678186791868018681186821868318684186851868618687186881868918690186911869218693186941869518696186971869818699187001870118702187031870418705187061870718708187091871018711187121871318714187151871618717187181871918720187211872218723187241872518726187271872818729187301873118732187331873418735187361873718738187391874018741187421874318744187451874618747187481874918750187511875218753187541875518756187571875818759187601876118762187631876418765187661876718768187691877018771187721877318774187751877618777187781877918780187811878218783187841878518786187871878818789187901879118792187931879418795187961879718798187991880018801188021880318804188051880618807188081880918810188111881218813188141881518816188171881818819188201882118822188231882418825188261882718828188291883018831188321883318834188351883618837188381883918840188411884218843188441884518846188471884818849188501885118852188531885418855188561885718858188591886018861188621886318864188651886618867188681886918870188711887218873188741887518876188771887818879188801888118882188831888418885188861888718888188891889018891188921889318894188951889618897188981889918900189011890218903189041890518906189071890818909189101891118912189131891418915189161891718918189191892018921189221892318924189251892618927189281892918930189311893218933189341893518936189371893818939189401894118942189431894418945189461894718948189491895018951189521895318954189551895618957189581895918960189611896218963189641896518966189671896818969189701897118972189731897418975189761897718978189791898018981189821898318984189851898618987189881898918990189911899218993189941899518996189971899818999190001900119002190031900419005190061900719008190091901019011190121901319014190151901619017190181901919020190211902219023190241902519026190271902819029190301903119032190331903419035190361903719038190391904019041190421904319044190451904619047190481904919050190511905219053190541905519056190571905819059190601906119062190631906419065190661906719068190691907019071190721907319074190751907619077190781907919080190811908219083190841908519086190871908819089190901909119092190931909419095190961909719098190991910019101191021910319104191051910619107191081910919110191111911219113191141911519116191171911819119191201912119122191231912419125191261912719128191291913019131191321913319134191351913619137191381913919140191411914219143191441914519146191471914819149191501915119152191531915419155191561915719158191591916019161191621916319164191651916619167191681916919170191711917219173191741917519176191771917819179191801918119182191831918419185191861918719188191891919019191191921919319194191951919619197191981919919200192011920219203192041920519206192071920819209192101921119212192131921419215192161921719218192191922019221192221922319224192251922619227192281922919230192311923219233192341923519236192371923819239192401924119242192431924419245192461924719248192491925019251192521925319254192551925619257192581925919260192611926219263192641926519266192671926819269192701927119272192731927419275192761927719278192791928019281192821928319284192851928619287192881928919290192911929219293192941929519296192971929819299193001930119302193031930419305193061930719308193091931019311193121931319314193151931619317193181931919320193211932219323193241932519326193271932819329193301933119332193331933419335193361933719338193391934019341193421934319344193451934619347193481934919350193511935219353193541935519356193571935819359193601936119362193631936419365193661936719368193691937019371193721937319374193751937619377193781937919380193811938219383193841938519386193871938819389193901939119392193931939419395193961939719398193991940019401194021940319404194051940619407194081940919410194111941219413194141941519416194171941819419194201942119422194231942419425194261942719428194291943019431194321943319434194351943619437194381943919440194411944219443194441944519446194471944819449194501945119452194531945419455194561945719458194591946019461194621946319464194651946619467194681946919470194711947219473194741947519476194771947819479194801948119482194831948419485194861948719488194891949019491194921949319494194951949619497194981949919500195011950219503195041950519506195071950819509195101951119512195131951419515195161951719518195191952019521195221952319524195251952619527195281952919530195311953219533195341953519536195371953819539195401954119542195431954419545195461954719548195491955019551195521955319554195551955619557195581955919560195611956219563195641956519566195671956819569195701957119572195731957419575195761957719578195791958019581195821958319584195851958619587195881958919590195911959219593195941959519596195971959819599196001960119602196031960419605196061960719608196091961019611196121961319614196151961619617196181961919620196211962219623196241962519626196271962819629196301963119632196331963419635196361963719638196391964019641196421964319644196451964619647196481964919650196511965219653196541965519656196571965819659196601966119662196631966419665196661966719668196691967019671196721967319674196751967619677196781967919680196811968219683196841968519686196871968819689196901969119692196931969419695196961969719698196991970019701197021970319704197051970619707197081970919710197111971219713197141971519716197171971819719197201972119722197231972419725197261972719728197291973019731197321973319734197351973619737197381973919740197411974219743197441974519746197471974819749197501975119752197531975419755197561975719758197591976019761197621976319764197651976619767197681976919770197711977219773197741977519776197771977819779197801978119782197831978419785197861978719788197891979019791197921979319794197951979619797197981979919800198011980219803198041980519806198071980819809198101981119812198131981419815198161981719818198191982019821198221982319824198251982619827198281982919830198311983219833198341983519836198371983819839198401984119842198431984419845198461984719848198491985019851198521985319854198551985619857198581985919860198611986219863198641986519866198671986819869198701987119872198731987419875198761987719878198791988019881198821988319884198851988619887198881988919890198911989219893198941989519896198971989819899199001990119902199031990419905199061990719908199091991019911199121991319914199151991619917199181991919920199211992219923199241992519926199271992819929199301993119932199331993419935199361993719938199391994019941199421994319944199451994619947199481994919950199511995219953199541995519956199571995819959199601996119962199631996419965199661996719968199691997019971199721997319974199751997619977199781997919980199811998219983199841998519986199871998819989199901999119992199931999419995199961999719998199992000020001200022000320004200052000620007200082000920010200112001220013200142001520016200172001820019200202002120022200232002420025200262002720028200292003020031200322003320034200352003620037200382003920040200412004220043200442004520046200472004820049200502005120052200532005420055200562005720058200592006020061200622006320064200652006620067200682006920070200712007220073200742007520076200772007820079200802008120082200832008420085200862008720088200892009020091200922009320094200952009620097200982009920100201012010220103201042010520106201072010820109201102011120112201132011420115201162011720118201192012020121201222012320124201252012620127201282012920130201312013220133201342013520136201372013820139201402014120142201432014420145201462014720148201492015020151201522015320154201552015620157201582015920160201612016220163201642016520166201672016820169201702017120172201732017420175201762017720178201792018020181201822018320184201852018620187201882018920190201912019220193201942019520196201972019820199202002020120202202032020420205202062020720208202092021020211202122021320214202152021620217202182021920220202212022220223202242022520226202272022820229202302023120232202332023420235202362023720238202392024020241202422024320244202452024620247202482024920250202512025220253202542025520256202572025820259202602026120262202632026420265202662026720268202692027020271202722027320274202752027620277202782027920280202812028220283202842028520286202872028820289202902029120292202932029420295202962029720298202992030020301203022030320304203052030620307203082030920310203112031220313203142031520316203172031820319203202032120322203232032420325203262032720328203292033020331203322033320334203352033620337203382033920340203412034220343203442034520346203472034820349203502035120352203532035420355203562035720358203592036020361203622036320364203652036620367203682036920370203712037220373203742037520376203772037820379203802038120382203832038420385203862038720388203892039020391203922039320394203952039620397203982039920400204012040220403204042040520406204072040820409204102041120412204132041420415204162041720418204192042020421204222042320424204252042620427204282042920430204312043220433204342043520436204372043820439204402044120442204432044420445204462044720448204492045020451204522045320454204552045620457204582045920460204612046220463204642046520466204672046820469204702047120472204732047420475204762047720478204792048020481204822048320484204852048620487204882048920490204912049220493204942049520496204972049820499205002050120502205032050420505205062050720508205092051020511205122051320514205152051620517205182051920520205212052220523205242052520526205272052820529205302053120532205332053420535205362053720538205392054020541205422054320544205452054620547205482054920550205512055220553205542055520556205572055820559205602056120562205632056420565205662056720568205692057020571205722057320574205752057620577205782057920580205812058220583205842058520586205872058820589205902059120592205932059420595205962059720598205992060020601206022060320604206052060620607206082060920610206112061220613206142061520616206172061820619206202062120622206232062420625206262062720628206292063020631206322063320634206352063620637206382063920640206412064220643206442064520646206472064820649206502065120652206532065420655206562065720658206592066020661206622066320664206652066620667206682066920670206712067220673206742067520676206772067820679206802068120682206832068420685206862068720688206892069020691206922069320694206952069620697206982069920700207012070220703207042070520706207072070820709207102071120712207132071420715207162071720718207192072020721207222072320724207252072620727207282072920730207312073220733207342073520736207372073820739207402074120742207432074420745207462074720748207492075020751207522075320754207552075620757207582075920760207612076220763207642076520766207672076820769207702077120772207732077420775207762077720778207792078020781207822078320784207852078620787207882078920790207912079220793207942079520796207972079820799208002080120802208032080420805208062080720808208092081020811208122081320814208152081620817208182081920820208212082220823208242082520826208272082820829208302083120832208332083420835208362083720838208392084020841208422084320844208452084620847208482084920850208512085220853208542085520856208572085820859208602086120862208632086420865208662086720868208692087020871208722087320874208752087620877208782087920880208812088220883208842088520886208872088820889208902089120892208932089420895208962089720898208992090020901209022090320904209052090620907209082090920910209112091220913209142091520916209172091820919209202092120922209232092420925209262092720928209292093020931209322093320934209352093620937209382093920940209412094220943209442094520946209472094820949209502095120952209532095420955209562095720958209592096020961209622096320964209652096620967209682096920970209712097220973209742097520976209772097820979209802098120982209832098420985209862098720988209892099020991209922099320994209952099620997209982099921000210012100221003210042100521006210072100821009210102101121012210132101421015210162101721018210192102021021210222102321024210252102621027210282102921030210312103221033210342103521036210372103821039210402104121042210432104421045210462104721048210492105021051210522105321054210552105621057210582105921060210612106221063210642106521066210672106821069210702107121072210732107421075210762107721078210792108021081210822108321084210852108621087210882108921090210912109221093210942109521096210972109821099211002110121102211032110421105211062110721108211092111021111211122111321114211152111621117211182111921120211212112221123211242112521126211272112821129211302113121132211332113421135211362113721138211392114021141211422114321144211452114621147211482114921150211512115221153211542115521156211572115821159211602116121162211632116421165211662116721168211692117021171211722117321174211752117621177211782117921180211812118221183211842118521186211872118821189211902119121192211932119421195211962119721198211992120021201212022120321204212052120621207212082120921210212112121221213212142121521216212172121821219212202122121222212232122421225212262122721228212292123021231212322123321234212352123621237212382123921240212412124221243212442124521246212472124821249212502125121252212532125421255212562125721258212592126021261212622126321264212652126621267212682126921270212712127221273212742127521276212772127821279212802128121282212832128421285212862128721288212892129021291212922129321294212952129621297212982129921300213012130221303213042130521306213072130821309213102131121312213132131421315213162131721318213192132021321213222132321324213252132621327213282132921330213312133221333213342133521336213372133821339213402134121342213432134421345213462134721348213492135021351213522135321354213552135621357213582135921360213612136221363213642136521366213672136821369213702137121372213732137421375213762137721378213792138021381213822138321384213852138621387213882138921390213912139221393213942139521396213972139821399214002140121402214032140421405214062140721408214092141021411214122141321414214152141621417214182141921420214212142221423214242142521426214272142821429214302143121432214332143421435214362143721438214392144021441214422144321444214452144621447214482144921450214512145221453214542145521456214572145821459214602146121462214632146421465214662146721468214692147021471214722147321474214752147621477214782147921480214812148221483214842148521486214872148821489214902149121492214932149421495214962149721498214992150021501215022150321504215052150621507215082150921510215112151221513215142151521516215172151821519215202152121522215232152421525215262152721528215292153021531215322153321534215352153621537215382153921540215412154221543215442154521546215472154821549215502155121552215532155421555215562155721558215592156021561215622156321564215652156621567215682156921570215712157221573215742157521576215772157821579215802158121582215832158421585215862158721588215892159021591215922159321594215952159621597215982159921600216012160221603216042160521606216072160821609216102161121612216132161421615216162161721618216192162021621216222162321624216252162621627216282162921630216312163221633216342163521636216372163821639216402164121642216432164421645216462164721648216492165021651216522165321654216552165621657216582165921660216612166221663216642166521666216672166821669216702167121672216732167421675216762167721678216792168021681216822168321684216852168621687216882168921690216912169221693216942169521696216972169821699217002170121702217032170421705217062170721708217092171021711217122171321714217152171621717217182171921720217212172221723217242172521726217272172821729217302173121732217332173421735217362173721738217392174021741217422174321744217452174621747217482174921750217512175221753217542175521756217572175821759217602176121762217632176421765217662176721768217692177021771217722177321774217752177621777217782177921780217812178221783217842178521786217872178821789217902179121792217932179421795217962179721798217992180021801218022180321804218052180621807218082180921810218112181221813218142181521816218172181821819218202182121822218232182421825218262182721828218292183021831218322183321834218352183621837218382183921840218412184221843218442184521846218472184821849218502185121852218532185421855218562185721858218592186021861218622186321864218652186621867218682186921870218712187221873218742187521876218772187821879218802188121882218832188421885218862188721888218892189021891218922189321894218952189621897218982189921900219012190221903219042190521906219072190821909219102191121912219132191421915219162191721918219192192021921219222192321924219252192621927219282192921930219312193221933219342193521936219372193821939219402194121942219432194421945219462194721948219492195021951219522195321954219552195621957219582195921960219612196221963219642196521966219672196821969219702197121972219732197421975219762197721978219792198021981219822198321984219852198621987219882198921990219912199221993219942199521996219972199821999220002200122002220032200422005220062200722008220092201022011220122201322014220152201622017220182201922020220212202222023220242202522026220272202822029220302203122032220332203422035220362203722038220392204022041220422204322044220452204622047220482204922050220512205222053220542205522056220572205822059220602206122062220632206422065220662206722068220692207022071220722207322074220752207622077220782207922080220812208222083220842208522086220872208822089220902209122092220932209422095220962209722098220992210022101221022210322104221052210622107221082210922110221112211222113221142211522116221172211822119221202212122122221232212422125221262212722128221292213022131221322213322134221352213622137221382213922140221412214222143221442214522146221472214822149221502215122152221532215422155221562215722158221592216022161221622216322164221652216622167221682216922170221712217222173221742217522176221772217822179221802218122182221832218422185221862218722188221892219022191221922219322194221952219622197221982219922200222012220222203222042220522206222072220822209222102221122212222132221422215222162221722218222192222022221222222222322224222252222622227222282222922230222312223222233222342223522236222372223822239222402224122242222432224422245222462224722248222492225022251222522225322254222552225622257222582225922260222612226222263222642226522266222672226822269222702227122272222732227422275222762227722278222792228022281222822228322284222852228622287222882228922290222912229222293222942229522296222972229822299223002230122302223032230422305223062230722308223092231022311223122231322314223152231622317223182231922320223212232222323223242232522326223272232822329223302233122332223332233422335223362233722338223392234022341223422234322344223452234622347223482234922350223512235222353223542235522356223572235822359223602236122362223632236422365223662236722368223692237022371223722237322374223752237622377223782237922380223812238222383223842238522386223872238822389223902239122392223932239422395223962239722398223992240022401224022240322404224052240622407224082240922410224112241222413224142241522416224172241822419224202242122422224232242422425224262242722428224292243022431224322243322434224352243622437224382243922440224412244222443224442244522446224472244822449224502245122452224532245422455224562245722458224592246022461224622246322464224652246622467224682246922470224712247222473224742247522476224772247822479224802248122482224832248422485224862248722488224892249022491224922249322494224952249622497224982249922500225012250222503225042250522506225072250822509225102251122512225132251422515225162251722518225192252022521225222252322524225252252622527225282252922530225312253222533225342253522536225372253822539225402254122542225432254422545225462254722548225492255022551225522255322554225552255622557225582255922560225612256222563225642256522566225672256822569225702257122572225732257422575225762257722578225792258022581225822258322584225852258622587225882258922590225912259222593225942259522596225972259822599226002260122602226032260422605226062260722608226092261022611226122261322614226152261622617226182261922620226212262222623226242262522626226272262822629226302263122632226332263422635226362263722638226392264022641226422264322644226452264622647226482264922650226512265222653226542265522656226572265822659226602266122662226632266422665226662266722668226692267022671226722267322674226752267622677226782267922680226812268222683226842268522686226872268822689226902269122692226932269422695226962269722698226992270022701227022270322704227052270622707227082270922710227112271222713227142271522716227172271822719227202272122722227232272422725227262272722728227292273022731227322273322734227352273622737227382273922740227412274222743227442274522746227472274822749227502275122752227532275422755227562275722758227592276022761227622276322764227652276622767227682276922770227712277222773227742277522776227772277822779227802278122782227832278422785227862278722788227892279022791227922279322794227952279622797227982279922800228012280222803228042280522806228072280822809228102281122812228132281422815228162281722818228192282022821228222282322824228252282622827228282282922830228312283222833228342283522836228372283822839228402284122842228432284422845228462284722848228492285022851228522285322854228552285622857228582285922860228612286222863228642286522866228672286822869228702287122872228732287422875228762287722878228792288022881228822288322884228852288622887228882288922890228912289222893228942289522896228972289822899229002290122902229032290422905229062290722908229092291022911229122291322914229152291622917229182291922920229212292222923229242292522926229272292822929229302293122932229332293422935229362293722938229392294022941229422294322944229452294622947229482294922950229512295222953229542295522956229572295822959229602296122962229632296422965229662296722968229692297022971229722297322974229752297622977229782297922980229812298222983229842298522986229872298822989229902299122992229932299422995229962299722998229992300023001230022300323004230052300623007230082300923010230112301223013230142301523016230172301823019230202302123022230232302423025230262302723028230292303023031230322303323034230352303623037230382303923040230412304223043230442304523046230472304823049230502305123052230532305423055230562305723058230592306023061230622306323064230652306623067230682306923070230712307223073230742307523076230772307823079230802308123082230832308423085230862308723088230892309023091230922309323094230952309623097230982309923100231012310223103231042310523106231072310823109231102311123112231132311423115231162311723118231192312023121231222312323124231252312623127231282312923130231312313223133231342313523136231372313823139231402314123142231432314423145231462314723148231492315023151231522315323154231552315623157231582315923160231612316223163231642316523166231672316823169231702317123172231732317423175231762317723178231792318023181231822318323184231852318623187231882318923190231912319223193231942319523196231972319823199232002320123202232032320423205232062320723208232092321023211232122321323214232152321623217232182321923220232212322223223232242322523226232272322823229232302323123232232332323423235232362323723238232392324023241232422324323244232452324623247232482324923250232512325223253232542325523256232572325823259232602326123262232632326423265232662326723268232692327023271232722327323274232752327623277232782327923280232812328223283232842328523286232872328823289232902329123292232932329423295232962329723298232992330023301233022330323304233052330623307233082330923310233112331223313233142331523316233172331823319233202332123322233232332423325233262332723328233292333023331233322333323334233352333623337233382333923340233412334223343233442334523346233472334823349233502335123352233532335423355233562335723358233592336023361233622336323364233652336623367233682336923370233712337223373233742337523376233772337823379233802338123382233832338423385233862338723388233892339023391233922339323394233952339623397233982339923400234012340223403234042340523406234072340823409234102341123412234132341423415234162341723418234192342023421234222342323424234252342623427234282342923430234312343223433234342343523436234372343823439234402344123442234432344423445234462344723448234492345023451234522345323454234552345623457234582345923460234612346223463234642346523466234672346823469234702347123472234732347423475234762347723478234792348023481234822348323484234852348623487234882348923490234912349223493234942349523496234972349823499235002350123502235032350423505235062350723508235092351023511235122351323514235152351623517235182351923520235212352223523235242352523526235272352823529235302353123532235332353423535235362353723538235392354023541235422354323544235452354623547235482354923550235512355223553235542355523556235572355823559235602356123562235632356423565235662356723568235692357023571235722357323574235752357623577235782357923580235812358223583235842358523586235872358823589235902359123592235932359423595235962359723598235992360023601236022360323604236052360623607236082360923610236112361223613236142361523616236172361823619236202362123622236232362423625236262362723628236292363023631236322363323634236352363623637236382363923640236412364223643236442364523646236472364823649236502365123652236532365423655236562365723658236592366023661236622366323664236652366623667236682366923670236712367223673236742367523676236772367823679236802368123682236832368423685236862368723688236892369023691236922369323694236952369623697236982369923700237012370223703237042370523706237072370823709237102371123712237132371423715237162371723718237192372023721237222372323724237252372623727237282372923730237312373223733237342373523736237372373823739237402374123742237432374423745237462374723748237492375023751237522375323754237552375623757237582375923760237612376223763237642376523766237672376823769237702377123772237732377423775237762377723778237792378023781237822378323784237852378623787237882378923790237912379223793237942379523796237972379823799238002380123802238032380423805238062380723808238092381023811238122381323814238152381623817238182381923820238212382223823238242382523826238272382823829238302383123832238332383423835238362383723838238392384023841238422384323844238452384623847238482384923850238512385223853238542385523856238572385823859238602386123862238632386423865238662386723868238692387023871238722387323874238752387623877238782387923880238812388223883238842388523886238872388823889238902389123892238932389423895238962389723898238992390023901239022390323904239052390623907239082390923910239112391223913239142391523916239172391823919239202392123922239232392423925239262392723928239292393023931239322393323934239352393623937239382393923940239412394223943239442394523946239472394823949239502395123952239532395423955239562395723958239592396023961239622396323964239652396623967239682396923970239712397223973239742397523976239772397823979239802398123982239832398423985239862398723988239892399023991239922399323994239952399623997239982399924000240012400224003240042400524006240072400824009240102401124012240132401424015240162401724018240192402024021240222402324024240252402624027240282402924030240312403224033240342403524036240372403824039240402404124042240432404424045240462404724048240492405024051240522405324054240552405624057240582405924060240612406224063240642406524066240672406824069240702407124072240732407424075240762407724078240792408024081240822408324084240852408624087240882408924090240912409224093240942409524096240972409824099241002410124102241032410424105241062410724108241092411024111241122411324114241152411624117241182411924120241212412224123241242412524126241272412824129241302413124132241332413424135241362413724138241392414024141241422414324144241452414624147241482414924150241512415224153241542415524156241572415824159241602416124162241632416424165241662416724168241692417024171241722417324174241752417624177241782417924180241812418224183241842418524186241872418824189241902419124192241932419424195241962419724198241992420024201242022420324204242052420624207242082420924210242112421224213242142421524216242172421824219242202422124222242232422424225242262422724228242292423024231242322423324234242352423624237242382423924240242412424224243242442424524246242472424824249242502425124252242532425424255242562425724258242592426024261242622426324264242652426624267242682426924270242712427224273242742427524276242772427824279242802428124282242832428424285242862428724288242892429024291242922429324294242952429624297242982429924300243012430224303243042430524306243072430824309243102431124312243132431424315243162431724318243192432024321243222432324324243252432624327243282432924330243312433224333243342433524336243372433824339243402434124342243432434424345243462434724348243492435024351243522435324354243552435624357243582435924360243612436224363243642436524366243672436824369243702437124372243732437424375243762437724378243792438024381243822438324384243852438624387243882438924390243912439224393243942439524396243972439824399244002440124402244032440424405244062440724408244092441024411244122441324414244152441624417244182441924420244212442224423244242442524426244272442824429244302443124432244332443424435244362443724438244392444024441244422444324444244452444624447244482444924450244512445224453244542445524456244572445824459244602446124462244632446424465244662446724468244692447024471244722447324474244752447624477244782447924480244812448224483244842448524486244872448824489244902449124492244932449424495244962449724498244992450024501245022450324504245052450624507245082450924510245112451224513245142451524516245172451824519245202452124522245232452424525245262452724528245292453024531245322453324534245352453624537245382453924540245412454224543245442454524546245472454824549245502455124552245532455424555245562455724558245592456024561245622456324564245652456624567245682456924570245712457224573245742457524576245772457824579245802458124582245832458424585245862458724588245892459024591245922459324594245952459624597245982459924600246012460224603246042460524606246072460824609246102461124612246132461424615246162461724618246192462024621246222462324624246252462624627246282462924630246312463224633246342463524636246372463824639246402464124642246432464424645246462464724648246492465024651246522465324654246552465624657246582465924660246612466224663246642466524666246672466824669246702467124672246732467424675246762467724678246792468024681246822468324684246852468624687246882468924690246912469224693246942469524696246972469824699247002470124702247032470424705247062470724708247092471024711247122471324714247152471624717247182471924720247212472224723247242472524726247272472824729247302473124732247332473424735247362473724738247392474024741247422474324744247452474624747247482474924750247512475224753247542475524756247572475824759247602476124762247632476424765247662476724768247692477024771247722477324774247752477624777247782477924780247812478224783247842478524786247872478824789247902479124792247932479424795247962479724798247992480024801248022480324804248052480624807248082480924810248112481224813248142481524816248172481824819248202482124822248232482424825248262482724828248292483024831248322483324834248352483624837248382483924840248412484224843248442484524846248472484824849248502485124852248532485424855248562485724858248592486024861248622486324864248652486624867248682486924870248712487224873248742487524876248772487824879248802488124882248832488424885248862488724888248892489024891248922489324894248952489624897248982489924900249012490224903249042490524906249072490824909249102491124912249132491424915249162491724918249192492024921249222492324924249252492624927249282492924930249312493224933249342493524936249372493824939249402494124942249432494424945249462494724948249492495024951249522495324954249552495624957249582495924960249612496224963249642496524966249672496824969249702497124972249732497424975249762497724978249792498024981249822498324984249852498624987249882498924990249912499224993249942499524996249972499824999250002500125002250032500425005250062500725008250092501025011250122501325014250152501625017250182501925020250212502225023250242502525026250272502825029250302503125032250332503425035250362503725038250392504025041250422504325044250452504625047250482504925050250512505225053250542505525056250572505825059250602506125062250632506425065250662506725068250692507025071250722507325074250752507625077250782507925080250812508225083250842508525086250872508825089250902509125092250932509425095250962509725098250992510025101251022510325104251052510625107251082510925110251112511225113251142511525116251172511825119251202512125122251232512425125251262512725128251292513025131251322513325134251352513625137251382513925140251412514225143251442514525146251472514825149251502515125152251532515425155251562515725158251592516025161251622516325164251652516625167251682516925170251712517225173251742517525176251772517825179251802518125182251832518425185251862518725188251892519025191251922519325194251952519625197251982519925200252012520225203252042520525206252072520825209252102521125212252132521425215252162521725218252192522025221252222522325224252252522625227252282522925230252312523225233252342523525236252372523825239252402524125242252432524425245252462524725248252492525025251252522525325254252552525625257252582525925260252612526225263252642526525266252672526825269252702527125272252732527425275252762527725278252792528025281252822528325284252852528625287252882528925290252912529225293252942529525296252972529825299253002530125302253032530425305253062530725308253092531025311253122531325314253152531625317253182531925320253212532225323253242532525326253272532825329253302533125332253332533425335253362533725338253392534025341253422534325344253452534625347253482534925350253512535225353253542535525356253572535825359253602536125362253632536425365253662536725368253692537025371253722537325374253752537625377253782537925380253812538225383253842538525386253872538825389253902539125392253932539425395253962539725398253992540025401254022540325404254052540625407254082540925410254112541225413254142541525416254172541825419254202542125422254232542425425254262542725428254292543025431254322543325434254352543625437254382543925440254412544225443254442544525446254472544825449254502545125452254532545425455254562545725458254592546025461254622546325464254652546625467254682546925470254712547225473254742547525476254772547825479254802548125482254832548425485254862548725488254892549025491254922549325494254952549625497254982549925500255012550225503255042550525506255072550825509255102551125512255132551425515255162551725518255192552025521255222552325524255252552625527255282552925530255312553225533255342553525536255372553825539255402554125542255432554425545255462554725548255492555025551255522555325554255552555625557255582555925560255612556225563255642556525566255672556825569255702557125572255732557425575255762557725578255792558025581255822558325584255852558625587255882558925590255912559225593255942559525596255972559825599256002560125602256032560425605256062560725608256092561025611256122561325614256152561625617256182561925620256212562225623256242562525626256272562825629256302563125632256332563425635256362563725638256392564025641256422564325644256452564625647256482564925650256512565225653256542565525656256572565825659256602566125662256632566425665256662566725668256692567025671256722567325674256752567625677256782567925680256812568225683256842568525686256872568825689256902569125692256932569425695256962569725698256992570025701257022570325704257052570625707257082570925710257112571225713257142571525716257172571825719257202572125722257232572425725257262572725728257292573025731257322573325734257352573625737257382573925740257412574225743257442574525746257472574825749257502575125752257532575425755257562575725758257592576025761257622576325764257652576625767257682576925770257712577225773257742577525776257772577825779257802578125782257832578425785257862578725788257892579025791257922579325794257952579625797257982579925800258012580225803258042580525806258072580825809258102581125812258132581425815258162581725818258192582025821258222582325824258252582625827258282582925830258312583225833258342583525836258372583825839258402584125842258432584425845258462584725848258492585025851258522585325854258552585625857258582585925860258612586225863258642586525866258672586825869258702587125872258732587425875258762587725878258792588025881258822588325884258852588625887258882588925890258912589225893258942589525896258972589825899259002590125902259032590425905259062590725908259092591025911259122591325914259152591625917259182591925920259212592225923259242592525926259272592825929259302593125932259332593425935259362593725938259392594025941259422594325944259452594625947259482594925950259512595225953259542595525956259572595825959259602596125962259632596425965259662596725968259692597025971259722597325974259752597625977259782597925980259812598225983259842598525986259872598825989259902599125992259932599425995259962599725998259992600026001260022600326004260052600626007260082600926010260112601226013260142601526016260172601826019260202602126022260232602426025260262602726028260292603026031260322603326034260352603626037260382603926040260412604226043260442604526046260472604826049260502605126052260532605426055260562605726058260592606026061260622606326064260652606626067260682606926070260712607226073260742607526076260772607826079260802608126082260832608426085260862608726088260892609026091260922609326094260952609626097260982609926100261012610226103261042610526106261072610826109261102611126112261132611426115261162611726118261192612026121261222612326124261252612626127261282612926130261312613226133261342613526136261372613826139261402614126142261432614426145261462614726148261492615026151261522615326154261552615626157261582615926160261612616226163261642616526166261672616826169261702617126172261732617426175261762617726178261792618026181261822618326184261852618626187261882618926190261912619226193261942619526196261972619826199262002620126202262032620426205262062620726208262092621026211262122621326214262152621626217262182621926220262212622226223262242622526226262272622826229262302623126232262332623426235262362623726238262392624026241262422624326244262452624626247262482624926250262512625226253262542625526256262572625826259262602626126262262632626426265262662626726268262692627026271262722627326274262752627626277262782627926280262812628226283262842628526286262872628826289262902629126292262932629426295262962629726298262992630026301263022630326304263052630626307263082630926310263112631226313263142631526316263172631826319263202632126322263232632426325263262632726328263292633026331263322633326334263352633626337263382633926340263412634226343263442634526346263472634826349263502635126352263532635426355263562635726358263592636026361263622636326364263652636626367263682636926370263712637226373263742637526376263772637826379263802638126382263832638426385263862638726388263892639026391263922639326394263952639626397263982639926400264012640226403264042640526406264072640826409264102641126412264132641426415264162641726418264192642026421264222642326424264252642626427264282642926430264312643226433264342643526436264372643826439264402644126442264432644426445264462644726448264492645026451264522645326454264552645626457264582645926460264612646226463264642646526466264672646826469264702647126472264732647426475264762647726478264792648026481264822648326484264852648626487264882648926490264912649226493264942649526496264972649826499265002650126502265032650426505265062650726508265092651026511265122651326514265152651626517265182651926520265212652226523265242652526526265272652826529265302653126532265332653426535265362653726538265392654026541265422654326544265452654626547265482654926550265512655226553265542655526556265572655826559265602656126562265632656426565265662656726568265692657026571265722657326574265752657626577265782657926580265812658226583265842658526586265872658826589265902659126592265932659426595265962659726598265992660026601266022660326604266052660626607266082660926610266112661226613266142661526616266172661826619266202662126622266232662426625266262662726628266292663026631266322663326634266352663626637266382663926640266412664226643266442664526646266472664826649266502665126652266532665426655266562665726658266592666026661266622666326664266652666626667266682666926670266712667226673266742667526676266772667826679266802668126682266832668426685266862668726688266892669026691266922669326694266952669626697266982669926700267012670226703267042670526706267072670826709267102671126712267132671426715267162671726718267192672026721267222672326724267252672626727267282672926730267312673226733267342673526736267372673826739267402674126742267432674426745267462674726748267492675026751267522675326754267552675626757267582675926760267612676226763267642676526766267672676826769267702677126772267732677426775267762677726778267792678026781267822678326784267852678626787267882678926790267912679226793267942679526796267972679826799268002680126802268032680426805268062680726808268092681026811268122681326814268152681626817268182681926820268212682226823268242682526826268272682826829268302683126832268332683426835268362683726838268392684026841268422684326844268452684626847268482684926850268512685226853268542685526856268572685826859268602686126862268632686426865268662686726868268692687026871268722687326874268752687626877268782687926880268812688226883268842688526886268872688826889268902689126892268932689426895268962689726898268992690026901269022690326904269052690626907269082690926910269112691226913269142691526916269172691826919269202692126922269232692426925269262692726928269292693026931269322693326934269352693626937269382693926940269412694226943269442694526946269472694826949269502695126952269532695426955269562695726958269592696026961269622696326964269652696626967269682696926970269712697226973269742697526976269772697826979269802698126982269832698426985269862698726988269892699026991269922699326994269952699626997269982699927000270012700227003270042700527006270072700827009270102701127012270132701427015270162701727018270192702027021270222702327024270252702627027270282702927030270312703227033270342703527036270372703827039270402704127042270432704427045270462704727048270492705027051270522705327054270552705627057270582705927060270612706227063270642706527066270672706827069270702707127072270732707427075270762707727078270792708027081270822708327084270852708627087270882708927090270912709227093270942709527096270972709827099271002710127102271032710427105271062710727108271092711027111271122711327114271152711627117271182711927120271212712227123271242712527126271272712827129271302713127132271332713427135271362713727138271392714027141271422714327144271452714627147271482714927150271512715227153271542715527156271572715827159271602716127162271632716427165271662716727168271692717027171271722717327174271752717627177271782717927180271812718227183271842718527186271872718827189271902719127192271932719427195271962719727198271992720027201272022720327204272052720627207272082720927210272112721227213272142721527216272172721827219272202722127222272232722427225272262722727228272292723027231272322723327234272352723627237272382723927240272412724227243272442724527246272472724827249272502725127252272532725427255272562725727258272592726027261272622726327264272652726627267272682726927270272712727227273272742727527276272772727827279272802728127282272832728427285272862728727288272892729027291272922729327294272952729627297272982729927300273012730227303273042730527306273072730827309273102731127312273132731427315273162731727318273192732027321273222732327324273252732627327273282732927330273312733227333273342733527336273372733827339273402734127342273432734427345273462734727348273492735027351273522735327354273552735627357273582735927360273612736227363273642736527366273672736827369273702737127372273732737427375273762737727378273792738027381273822738327384273852738627387273882738927390273912739227393273942739527396273972739827399274002740127402274032740427405274062740727408274092741027411274122741327414274152741627417274182741927420274212742227423274242742527426274272742827429274302743127432274332743427435274362743727438274392744027441274422744327444274452744627447274482744927450274512745227453274542745527456274572745827459274602746127462274632746427465274662746727468274692747027471274722747327474274752747627477274782747927480274812748227483274842748527486274872748827489274902749127492274932749427495274962749727498274992750027501275022750327504275052750627507275082750927510275112751227513275142751527516275172751827519275202752127522275232752427525275262752727528275292753027531275322753327534275352753627537275382753927540275412754227543275442754527546275472754827549275502755127552275532755427555275562755727558275592756027561275622756327564275652756627567275682756927570275712757227573275742757527576275772757827579275802758127582275832758427585275862758727588275892759027591275922759327594275952759627597275982759927600276012760227603276042760527606276072760827609276102761127612276132761427615276162761727618276192762027621276222762327624276252762627627276282762927630276312763227633276342763527636276372763827639276402764127642276432764427645276462764727648276492765027651276522765327654276552765627657276582765927660276612766227663276642766527666276672766827669276702767127672276732767427675276762767727678276792768027681276822768327684276852768627687276882768927690276912769227693276942769527696276972769827699277002770127702277032770427705277062770727708277092771027711277122771327714277152771627717277182771927720277212772227723277242772527726277272772827729277302773127732277332773427735277362773727738277392774027741277422774327744277452774627747277482774927750277512775227753277542775527756277572775827759277602776127762277632776427765277662776727768277692777027771277722777327774277752777627777277782777927780277812778227783277842778527786277872778827789277902779127792277932779427795277962779727798277992780027801278022780327804278052780627807278082780927810278112781227813278142781527816278172781827819278202782127822278232782427825278262782727828278292783027831278322783327834278352783627837278382783927840278412784227843278442784527846278472784827849278502785127852278532785427855278562785727858278592786027861278622786327864278652786627867278682786927870278712787227873278742787527876278772787827879278802788127882278832788427885278862788727888278892789027891278922789327894278952789627897278982789927900279012790227903279042790527906279072790827909279102791127912279132791427915279162791727918279192792027921279222792327924279252792627927279282792927930279312793227933279342793527936279372793827939279402794127942279432794427945279462794727948279492795027951279522795327954279552795627957279582795927960279612796227963279642796527966279672796827969279702797127972279732797427975279762797727978279792798027981279822798327984279852798627987279882798927990279912799227993279942799527996279972799827999280002800128002280032800428005280062800728008280092801028011280122801328014280152801628017280182801928020280212802228023280242802528026280272802828029280302803128032280332803428035280362803728038280392804028041280422804328044280452804628047280482804928050280512805228053280542805528056280572805828059280602806128062280632806428065280662806728068280692807028071280722807328074280752807628077280782807928080280812808228083280842808528086280872808828089280902809128092280932809428095280962809728098280992810028101281022810328104281052810628107281082810928110281112811228113281142811528116281172811828119281202812128122281232812428125281262812728128281292813028131281322813328134281352813628137281382813928140281412814228143281442814528146281472814828149281502815128152281532815428155281562815728158281592816028161281622816328164281652816628167281682816928170281712817228173281742817528176281772817828179281802818128182281832818428185281862818728188281892819028191281922819328194281952819628197281982819928200282012820228203282042820528206282072820828209282102821128212282132821428215282162821728218282192822028221282222822328224282252822628227282282822928230282312823228233282342823528236282372823828239282402824128242282432824428245282462824728248282492825028251282522825328254282552825628257282582825928260282612826228263282642826528266282672826828269282702827128272282732827428275282762827728278282792828028281282822828328284282852828628287282882828928290282912829228293282942829528296282972829828299283002830128302283032830428305283062830728308283092831028311283122831328314283152831628317283182831928320283212832228323283242832528326283272832828329283302833128332283332833428335283362833728338283392834028341283422834328344283452834628347283482834928350283512835228353283542835528356283572835828359283602836128362283632836428365283662836728368283692837028371283722837328374283752837628377283782837928380283812838228383283842838528386283872838828389283902839128392283932839428395283962839728398283992840028401284022840328404284052840628407284082840928410284112841228413284142841528416284172841828419284202842128422284232842428425284262842728428284292843028431284322843328434284352843628437284382843928440284412844228443284442844528446284472844828449284502845128452284532845428455284562845728458284592846028461284622846328464284652846628467284682846928470284712847228473284742847528476284772847828479284802848128482284832848428485284862848728488284892849028491284922849328494284952849628497284982849928500285012850228503285042850528506285072850828509285102851128512285132851428515285162851728518285192852028521285222852328524285252852628527285282852928530285312853228533285342853528536285372853828539285402854128542285432854428545285462854728548285492855028551285522855328554285552855628557285582855928560285612856228563285642856528566285672856828569285702857128572285732857428575285762857728578285792858028581285822858328584285852858628587285882858928590285912859228593285942859528596285972859828599286002860128602286032860428605286062860728608286092861028611286122861328614286152861628617286182861928620286212862228623286242862528626286272862828629286302863128632286332863428635286362863728638286392864028641286422864328644286452864628647286482864928650286512865228653286542865528656286572865828659286602866128662286632866428665286662866728668286692867028671286722867328674286752867628677286782867928680286812868228683286842868528686286872868828689286902869128692286932869428695286962869728698286992870028701287022870328704287052870628707287082870928710287112871228713287142871528716287172871828719287202872128722287232872428725287262872728728287292873028731287322873328734287352873628737287382873928740287412874228743287442874528746287472874828749287502875128752287532875428755287562875728758287592876028761287622876328764287652876628767287682876928770287712877228773287742877528776287772877828779287802878128782287832878428785287862878728788287892879028791287922879328794287952879628797287982879928800288012880228803288042880528806288072880828809288102881128812288132881428815288162881728818288192882028821288222882328824288252882628827288282882928830288312883228833288342883528836288372883828839288402884128842288432884428845288462884728848288492885028851288522885328854288552885628857288582885928860288612886228863288642886528866288672886828869288702887128872288732887428875288762887728878288792888028881288822888328884288852888628887288882888928890288912889228893288942889528896288972889828899289002890128902289032890428905289062890728908289092891028911289122891328914289152891628917289182891928920289212892228923289242892528926289272892828929289302893128932289332893428935289362893728938289392894028941289422894328944289452894628947289482894928950289512895228953289542895528956289572895828959289602896128962289632896428965289662896728968289692897028971289722897328974289752897628977289782897928980289812898228983289842898528986289872898828989289902899128992289932899428995289962899728998289992900029001290022900329004290052900629007290082900929010290112901229013290142901529016290172901829019290202902129022290232902429025290262902729028290292903029031290322903329034290352903629037290382903929040290412904229043290442904529046290472904829049290502905129052290532905429055290562905729058290592906029061290622906329064290652906629067290682906929070290712907229073290742907529076290772907829079290802908129082290832908429085290862908729088290892909029091290922909329094290952909629097290982909929100291012910229103291042910529106291072910829109291102911129112291132911429115291162911729118291192912029121291222912329124291252912629127291282912929130291312913229133291342913529136291372913829139291402914129142291432914429145291462914729148291492915029151291522915329154291552915629157291582915929160291612916229163291642916529166291672916829169291702917129172291732917429175291762917729178291792918029181291822918329184291852918629187291882918929190291912919229193291942919529196291972919829199292002920129202292032920429205292062920729208292092921029211292122921329214292152921629217292182921929220292212922229223292242922529226292272922829229292302923129232292332923429235292362923729238292392924029241292422924329244292452924629247292482924929250292512925229253292542925529256292572925829259292602926129262292632926429265292662926729268292692927029271292722927329274292752927629277292782927929280292812928229283292842928529286292872928829289292902929129292292932929429295292962929729298292992930029301293022930329304293052930629307293082930929310293112931229313293142931529316293172931829319293202932129322293232932429325293262932729328293292933029331293322933329334293352933629337293382933929340293412934229343293442934529346293472934829349293502935129352293532935429355293562935729358293592936029361293622936329364293652936629367293682936929370293712937229373293742937529376293772937829379293802938129382293832938429385293862938729388293892939029391293922939329394293952939629397293982939929400294012940229403294042940529406294072940829409294102941129412294132941429415294162941729418294192942029421294222942329424294252942629427294282942929430294312943229433294342943529436294372943829439294402944129442294432944429445294462944729448294492945029451294522945329454294552945629457294582945929460294612946229463294642946529466294672946829469294702947129472294732947429475294762947729478294792948029481294822948329484294852948629487294882948929490294912949229493294942949529496294972949829499295002950129502295032950429505295062950729508295092951029511295122951329514295152951629517295182951929520295212952229523295242952529526295272952829529295302953129532295332953429535295362953729538295392954029541295422954329544295452954629547295482954929550295512955229553295542955529556295572955829559295602956129562295632956429565295662956729568295692957029571295722957329574295752957629577295782957929580295812958229583295842958529586295872958829589295902959129592295932959429595295962959729598295992960029601296022960329604296052960629607296082960929610296112961229613296142961529616296172961829619296202962129622296232962429625296262962729628296292963029631296322963329634296352963629637296382963929640296412964229643296442964529646296472964829649296502965129652296532965429655296562965729658296592966029661296622966329664296652966629667296682966929670296712967229673296742967529676296772967829679296802968129682296832968429685296862968729688296892969029691296922969329694296952969629697296982969929700297012970229703297042970529706297072970829709297102971129712297132971429715297162971729718297192972029721297222972329724297252972629727297282972929730297312973229733297342973529736297372973829739297402974129742297432974429745297462974729748297492975029751297522975329754297552975629757297582975929760297612976229763297642976529766297672976829769297702977129772297732977429775297762977729778297792978029781297822978329784297852978629787297882978929790297912979229793297942979529796297972979829799298002980129802298032980429805298062980729808298092981029811298122981329814298152981629817298182981929820298212982229823298242982529826298272982829829298302983129832298332983429835298362983729838298392984029841298422984329844298452984629847298482984929850298512985229853298542985529856298572985829859298602986129862298632986429865298662986729868298692987029871298722987329874298752987629877298782987929880298812988229883298842988529886298872988829889298902989129892298932989429895298962989729898298992990029901299022990329904299052990629907299082990929910299112991229913299142991529916299172991829919299202992129922299232992429925299262992729928299292993029931299322993329934299352993629937299382993929940299412994229943299442994529946299472994829949299502995129952299532995429955299562995729958299592996029961299622996329964299652996629967299682996929970299712997229973299742997529976299772997829979299802998129982299832998429985299862998729988299892999029991299922999329994299952999629997299982999930000300013000230003300043000530006300073000830009300103001130012300133001430015300163001730018300193002030021300223002330024300253002630027300283002930030300313003230033300343003530036300373003830039300403004130042300433004430045300463004730048300493005030051300523005330054300553005630057300583005930060300613006230063300643006530066300673006830069300703007130072300733007430075300763007730078300793008030081300823008330084300853008630087300883008930090300913009230093300943009530096300973009830099301003010130102301033010430105301063010730108301093011030111301123011330114301153011630117301183011930120301213012230123301243012530126301273012830129301303013130132301333013430135301363013730138301393014030141301423014330144301453014630147301483014930150301513015230153301543015530156301573015830159301603016130162301633016430165301663016730168301693017030171301723017330174301753017630177301783017930180301813018230183301843018530186301873018830189301903019130192301933019430195301963019730198301993020030201302023020330204302053020630207302083020930210302113021230213302143021530216302173021830219302203022130222302233022430225302263022730228302293023030231302323023330234302353023630237302383023930240302413024230243302443024530246302473024830249302503025130252302533025430255302563025730258302593026030261302623026330264302653026630267302683026930270302713027230273302743027530276302773027830279302803028130282302833028430285302863028730288302893029030291302923029330294302953029630297302983029930300303013030230303303043030530306303073030830309303103031130312303133031430315303163031730318303193032030321303223032330324303253032630327303283032930330303313033230333303343033530336303373033830339303403034130342303433034430345303463034730348303493035030351303523035330354303553035630357303583035930360303613036230363303643036530366303673036830369303703037130372303733037430375303763037730378303793038030381303823038330384303853038630387303883038930390303913039230393303943039530396303973039830399304003040130402304033040430405304063040730408304093041030411304123041330414304153041630417304183041930420304213042230423304243042530426304273042830429304303043130432304333043430435304363043730438304393044030441304423044330444304453044630447304483044930450304513045230453304543045530456304573045830459304603046130462304633046430465304663046730468304693047030471304723047330474304753047630477304783047930480304813048230483304843048530486304873048830489304903049130492304933049430495304963049730498304993050030501305023050330504305053050630507305083050930510305113051230513305143051530516305173051830519305203052130522305233052430525305263052730528305293053030531305323053330534305353053630537305383053930540305413054230543305443054530546305473054830549305503055130552305533055430555305563055730558305593056030561305623056330564305653056630567305683056930570305713057230573305743057530576305773057830579305803058130582305833058430585305863058730588305893059030591305923059330594305953059630597305983059930600306013060230603306043060530606306073060830609306103061130612306133061430615306163061730618306193062030621306223062330624306253062630627306283062930630306313063230633306343063530636306373063830639306403064130642306433064430645306463064730648306493065030651306523065330654306553065630657306583065930660306613066230663306643066530666306673066830669306703067130672306733067430675306763067730678306793068030681306823068330684306853068630687306883068930690306913069230693306943069530696306973069830699307003070130702307033070430705307063070730708307093071030711307123071330714307153071630717307183071930720307213072230723307243072530726307273072830729307303073130732307333073430735307363073730738307393074030741307423074330744307453074630747307483074930750307513075230753307543075530756307573075830759307603076130762307633076430765307663076730768307693077030771307723077330774307753077630777307783077930780307813078230783307843078530786307873078830789307903079130792307933079430795307963079730798307993080030801308023080330804308053080630807308083080930810308113081230813308143081530816308173081830819308203082130822308233082430825308263082730828308293083030831308323083330834308353083630837308383083930840308413084230843308443084530846308473084830849308503085130852308533085430855308563085730858308593086030861308623086330864308653086630867308683086930870308713087230873308743087530876308773087830879308803088130882308833088430885308863088730888308893089030891308923089330894308953089630897308983089930900309013090230903309043090530906309073090830909309103091130912309133091430915309163091730918309193092030921309223092330924309253092630927309283092930930309313093230933309343093530936309373093830939309403094130942309433094430945309463094730948309493095030951309523095330954309553095630957309583095930960309613096230963309643096530966309673096830969309703097130972309733097430975309763097730978309793098030981309823098330984309853098630987309883098930990309913099230993309943099530996309973099830999310003100131002310033100431005310063100731008310093101031011310123101331014310153101631017310183101931020310213102231023310243102531026310273102831029310303103131032310333103431035310363103731038310393104031041310423104331044310453104631047310483104931050310513105231053310543105531056310573105831059310603106131062310633106431065310663106731068310693107031071310723107331074310753107631077310783107931080310813108231083310843108531086310873108831089310903109131092310933109431095310963109731098310993110031101311023110331104311053110631107311083110931110311113111231113311143111531116311173111831119311203112131122311233112431125311263112731128311293113031131311323113331134311353113631137311383113931140311413114231143311443114531146311473114831149311503115131152311533115431155311563115731158311593116031161311623116331164311653116631167311683116931170311713117231173311743117531176311773117831179311803118131182311833118431185311863118731188311893119031191311923119331194311953119631197311983119931200312013120231203312043120531206312073120831209312103121131212312133121431215312163121731218312193122031221312223122331224312253122631227312283122931230312313123231233312343123531236312373123831239312403124131242312433124431245312463124731248312493125031251312523125331254312553125631257312583125931260312613126231263312643126531266312673126831269312703127131272312733127431275312763127731278312793128031281312823128331284312853128631287312883128931290312913129231293312943129531296312973129831299313003130131302313033130431305313063130731308313093131031311313123131331314313153131631317313183131931320313213132231323313243132531326313273132831329313303133131332313333133431335313363133731338313393134031341313423134331344313453134631347313483134931350313513135231353313543135531356313573135831359313603136131362313633136431365313663136731368313693137031371313723137331374313753137631377313783137931380313813138231383313843138531386313873138831389313903139131392313933139431395313963139731398313993140031401314023140331404314053140631407314083140931410314113141231413314143141531416314173141831419314203142131422314233142431425314263142731428314293143031431314323143331434314353143631437314383143931440314413144231443314443144531446314473144831449314503145131452314533145431455314563145731458314593146031461314623146331464314653146631467314683146931470314713147231473314743147531476314773147831479314803148131482314833148431485314863148731488314893149031491314923149331494314953149631497314983149931500315013150231503315043150531506315073150831509315103151131512315133151431515315163151731518315193152031521315223152331524315253152631527315283152931530315313153231533315343153531536315373153831539315403154131542315433154431545315463154731548315493155031551315523155331554315553155631557315583155931560315613156231563315643156531566315673156831569315703157131572315733157431575315763157731578315793158031581315823158331584315853158631587315883158931590315913159231593315943159531596315973159831599316003160131602316033160431605316063160731608316093161031611316123161331614316153161631617316183161931620316213162231623316243162531626316273162831629316303163131632316333163431635316363163731638316393164031641316423164331644316453164631647316483164931650316513165231653316543165531656316573165831659316603166131662316633166431665316663166731668316693167031671316723167331674316753167631677316783167931680316813168231683316843168531686316873168831689316903169131692316933169431695316963169731698316993170031701317023170331704317053170631707317083170931710317113171231713317143171531716317173171831719317203172131722317233172431725317263172731728317293173031731317323173331734317353173631737317383173931740317413174231743317443174531746317473174831749317503175131752317533175431755317563175731758317593176031761317623176331764317653176631767317683176931770317713177231773317743177531776317773177831779317803178131782317833178431785317863178731788317893179031791317923179331794317953179631797317983179931800318013180231803318043180531806318073180831809318103181131812318133181431815318163181731818318193182031821318223182331824318253182631827318283182931830318313183231833318343183531836318373183831839318403184131842318433184431845318463184731848318493185031851318523185331854318553185631857318583185931860318613186231863318643186531866318673186831869318703187131872318733187431875318763187731878318793188031881318823188331884318853188631887318883188931890318913189231893318943189531896318973189831899319003190131902319033190431905319063190731908319093191031911319123191331914319153191631917319183191931920319213192231923319243192531926319273192831929319303193131932319333193431935319363193731938319393194031941319423194331944319453194631947319483194931950319513195231953319543195531956319573195831959319603196131962319633196431965319663196731968319693197031971319723197331974319753197631977319783197931980319813198231983319843198531986319873198831989319903199131992319933199431995319963199731998319993200032001320023200332004320053200632007320083200932010320113201232013320143201532016320173201832019320203202132022320233202432025320263202732028320293203032031320323203332034320353203632037320383203932040320413204232043320443204532046320473204832049320503205132052320533205432055320563205732058320593206032061320623206332064320653206632067320683206932070320713207232073320743207532076320773207832079320803208132082320833208432085320863208732088320893209032091320923209332094320953209632097320983209932100321013210232103321043210532106321073210832109321103211132112321133211432115321163211732118321193212032121321223212332124321253212632127321283212932130321313213232133321343213532136321373213832139321403214132142321433214432145321463214732148321493215032151321523215332154321553215632157321583215932160321613216232163321643216532166321673216832169321703217132172321733217432175321763217732178321793218032181321823218332184321853218632187321883218932190321913219232193321943219532196321973219832199322003220132202322033220432205322063220732208322093221032211322123221332214322153221632217322183221932220322213222232223322243222532226322273222832229322303223132232322333223432235322363223732238322393224032241322423224332244322453224632247322483224932250322513225232253322543225532256322573225832259322603226132262322633226432265322663226732268322693227032271322723227332274322753227632277322783227932280322813228232283322843228532286322873228832289322903229132292322933229432295322963229732298322993230032301323023230332304323053230632307323083230932310323113231232313323143231532316323173231832319323203232132322323233232432325323263232732328323293233032331323323233332334323353233632337323383233932340323413234232343323443234532346323473234832349323503235132352323533235432355323563235732358323593236032361323623236332364323653236632367323683236932370323713237232373323743237532376323773237832379323803238132382323833238432385323863238732388323893239032391323923239332394323953239632397323983239932400324013240232403324043240532406324073240832409324103241132412324133241432415324163241732418324193242032421324223242332424324253242632427324283242932430324313243232433324343243532436324373243832439324403244132442324433244432445324463244732448324493245032451324523245332454324553245632457324583245932460324613246232463324643246532466324673246832469324703247132472324733247432475324763247732478324793248032481324823248332484324853248632487324883248932490324913249232493324943249532496324973249832499325003250132502325033250432505325063250732508325093251032511325123251332514325153251632517325183251932520325213252232523325243252532526325273252832529325303253132532325333253432535325363253732538325393254032541325423254332544325453254632547325483254932550325513255232553325543255532556325573255832559325603256132562325633256432565325663256732568325693257032571325723257332574325753257632577325783257932580325813258232583325843258532586325873258832589325903259132592325933259432595325963259732598325993260032601326023260332604326053260632607326083260932610326113261232613326143261532616326173261832619326203262132622326233262432625326263262732628326293263032631326323263332634326353263632637326383263932640326413264232643326443264532646326473264832649326503265132652326533265432655326563265732658326593266032661326623266332664326653266632667326683266932670326713267232673326743267532676326773267832679326803268132682326833268432685326863268732688326893269032691326923269332694326953269632697326983269932700327013270232703327043270532706327073270832709327103271132712327133271432715327163271732718327193272032721327223272332724327253272632727327283272932730327313273232733327343273532736327373273832739327403274132742327433274432745327463274732748327493275032751327523275332754327553275632757327583275932760327613276232763327643276532766327673276832769327703277132772327733277432775327763277732778327793278032781327823278332784327853278632787327883278932790327913279232793327943279532796327973279832799328003280132802328033280432805328063280732808328093281032811328123281332814328153281632817328183281932820328213282232823328243282532826328273282832829328303283132832328333283432835328363283732838328393284032841328423284332844328453284632847328483284932850328513285232853328543285532856328573285832859328603286132862328633286432865328663286732868328693287032871328723287332874328753287632877328783287932880328813288232883328843288532886328873288832889328903289132892328933289432895328963289732898328993290032901329023290332904329053290632907329083290932910329113291232913329143291532916329173291832919329203292132922329233292432925329263292732928329293293032931329323293332934329353293632937329383293932940329413294232943329443294532946329473294832949329503295132952329533295432955329563295732958329593296032961329623296332964329653296632967329683296932970329713297232973329743297532976329773297832979329803298132982329833298432985329863298732988329893299032991329923299332994329953299632997329983299933000330013300233003330043300533006330073300833009330103301133012330133301433015330163301733018330193302033021330223302333024330253302633027330283302933030330313303233033330343303533036330373303833039330403304133042330433304433045330463304733048330493305033051330523305333054330553305633057330583305933060330613306233063330643306533066330673306833069330703307133072330733307433075330763307733078330793308033081330823308333084330853308633087330883308933090330913309233093330943309533096330973309833099331003310133102331033310433105331063310733108331093311033111331123311333114331153311633117331183311933120331213312233123331243312533126331273312833129331303313133132331333313433135331363313733138331393314033141331423314333144331453314633147331483314933150331513315233153331543315533156331573315833159331603316133162331633316433165331663316733168331693317033171331723317333174331753317633177331783317933180331813318233183331843318533186331873318833189331903319133192331933319433195331963319733198331993320033201332023320333204332053320633207332083320933210332113321233213332143321533216332173321833219332203322133222332233322433225332263322733228332293323033231332323323333234332353323633237332383323933240332413324233243332443324533246332473324833249332503325133252332533325433255332563325733258332593326033261332623326333264332653326633267332683326933270332713327233273332743327533276332773327833279332803328133282332833328433285332863328733288332893329033291332923329333294332953329633297332983329933300333013330233303333043330533306333073330833309333103331133312333133331433315333163331733318333193332033321333223332333324333253332633327333283332933330333313333233333333343333533336333373333833339333403334133342333433334433345333463334733348333493335033351333523335333354333553335633357333583335933360333613336233363333643336533366333673336833369333703337133372333733337433375333763337733378333793338033381333823338333384333853338633387333883338933390333913339233393333943339533396333973339833399334003340133402334033340433405334063340733408334093341033411334123341333414334153341633417334183341933420334213342233423334243342533426334273342833429334303343133432334333343433435334363343733438334393344033441334423344333444334453344633447334483344933450334513345233453334543345533456334573345833459334603346133462334633346433465334663346733468334693347033471334723347333474334753347633477334783347933480334813348233483334843348533486334873348833489334903349133492334933349433495334963349733498334993350033501335023350333504335053350633507335083350933510335113351233513335143351533516335173351833519335203352133522335233352433525335263352733528335293353033531335323353333534335353353633537335383353933540335413354233543335443354533546335473354833549335503355133552335533355433555335563355733558335593356033561335623356333564335653356633567335683356933570335713357233573335743357533576335773357833579335803358133582335833358433585335863358733588335893359033591335923359333594335953359633597335983359933600336013360233603336043360533606336073360833609336103361133612336133361433615336163361733618336193362033621336223362333624336253362633627336283362933630336313363233633336343363533636336373363833639336403364133642336433364433645336463364733648336493365033651336523365333654336553365633657336583365933660336613366233663336643366533666336673366833669336703367133672336733367433675336763367733678336793368033681336823368333684336853368633687336883368933690336913369233693336943369533696336973369833699337003370133702337033370433705337063370733708337093371033711337123371333714337153371633717337183371933720337213372233723337243372533726337273372833729337303373133732337333373433735337363373733738337393374033741337423374333744337453374633747337483374933750337513375233753337543375533756337573375833759337603376133762337633376433765337663376733768337693377033771337723377333774337753377633777337783377933780337813378233783337843378533786337873378833789337903379133792337933379433795337963379733798337993380033801338023380333804338053380633807338083380933810338113381233813338143381533816338173381833819338203382133822338233382433825338263382733828338293383033831338323383333834338353383633837338383383933840338413384233843338443384533846338473384833849338503385133852338533385433855338563385733858338593386033861338623386333864338653386633867338683386933870338713387233873338743387533876338773387833879338803388133882338833388433885338863388733888338893389033891338923389333894338953389633897338983389933900339013390233903339043390533906339073390833909339103391133912339133391433915339163391733918339193392033921339223392333924339253392633927339283392933930339313393233933339343393533936339373393833939339403394133942339433394433945339463394733948339493395033951339523395333954339553395633957339583395933960339613396233963339643396533966339673396833969339703397133972339733397433975339763397733978339793398033981339823398333984339853398633987339883398933990339913399233993339943399533996339973399833999340003400134002340033400434005340063400734008340093401034011340123401334014340153401634017340183401934020340213402234023340243402534026340273402834029340303403134032340333403434035340363403734038340393404034041340423404334044340453404634047340483404934050340513405234053340543405534056340573405834059340603406134062340633406434065340663406734068340693407034071340723407334074340753407634077340783407934080340813408234083340843408534086340873408834089340903409134092340933409434095340963409734098340993410034101341023410334104341053410634107341083410934110341113411234113341143411534116341173411834119341203412134122341233412434125341263412734128341293413034131341323413334134341353413634137341383413934140341413414234143341443414534146341473414834149341503415134152341533415434155341563415734158341593416034161341623416334164341653416634167341683416934170341713417234173341743417534176341773417834179341803418134182341833418434185341863418734188341893419034191341923419334194341953419634197341983419934200342013420234203342043420534206342073420834209342103421134212342133421434215342163421734218342193422034221342223422334224342253422634227342283422934230342313423234233342343423534236342373423834239342403424134242342433424434245342463424734248342493425034251342523425334254342553425634257342583425934260342613426234263342643426534266342673426834269342703427134272342733427434275342763427734278342793428034281342823428334284342853428634287342883428934290342913429234293342943429534296342973429834299343003430134302343033430434305343063430734308343093431034311343123431334314343153431634317343183431934320343213432234323343243432534326343273432834329343303433134332343333433434335343363433734338343393434034341343423434334344343453434634347343483434934350343513435234353343543435534356343573435834359343603436134362343633436434365343663436734368343693437034371343723437334374343753437634377343783437934380343813438234383343843438534386343873438834389343903439134392343933439434395343963439734398343993440034401
  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>prefix</code></br>
  1547. <em>
  1548. string
  1549. </em>
  1550. </td>
  1551. <td>
  1552. <em>(Optional)</em>
  1553. <p>Prefix adds a prefix to all retrieved values.</p>
  1554. </td>
  1555. </tr>
  1556. </tbody>
  1557. </table>
  1558. <h3 id="external-secrets.io/v1.AWSServiceType">AWSServiceType
  1559. (<code>string</code> alias)</p></h3>
  1560. <p>
  1561. (<em>Appears on:</em>
  1562. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1563. </p>
  1564. <p>
  1565. <p>AWSServiceType is a enum that defines the service/API that is used to fetch the secrets.</p>
  1566. </p>
  1567. <table>
  1568. <thead>
  1569. <tr>
  1570. <th>Value</th>
  1571. <th>Description</th>
  1572. </tr>
  1573. </thead>
  1574. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  1575. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  1576. 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>
  1577. </td>
  1578. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  1579. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  1580. 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>
  1581. </td>
  1582. </tr></tbody>
  1583. </table>
  1584. <h3 id="external-secrets.io/v1.AkeylessAuth">AkeylessAuth
  1585. </h3>
  1586. <p>
  1587. (<em>Appears on:</em>
  1588. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>)
  1589. </p>
  1590. <p>
  1591. <p>AkeylessAuth configures how the operator authenticates with Akeyless.</p>
  1592. </p>
  1593. <table>
  1594. <thead>
  1595. <tr>
  1596. <th>Field</th>
  1597. <th>Description</th>
  1598. </tr>
  1599. </thead>
  1600. <tbody>
  1601. <tr>
  1602. <td>
  1603. <code>secretRef</code></br>
  1604. <em>
  1605. <a href="#external-secrets.io/v1.AkeylessAuthSecretRef">
  1606. AkeylessAuthSecretRef
  1607. </a>
  1608. </em>
  1609. </td>
  1610. <td>
  1611. <em>(Optional)</em>
  1612. <p>Reference to a Secret that contains the details
  1613. to authenticate with Akeyless.</p>
  1614. </td>
  1615. </tr>
  1616. <tr>
  1617. <td>
  1618. <code>kubernetesAuth</code></br>
  1619. <em>
  1620. <a href="#external-secrets.io/v1.AkeylessKubernetesAuth">
  1621. AkeylessKubernetesAuth
  1622. </a>
  1623. </em>
  1624. </td>
  1625. <td>
  1626. <em>(Optional)</em>
  1627. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  1628. token stored in the named Secret resource.</p>
  1629. </td>
  1630. </tr>
  1631. </tbody>
  1632. </table>
  1633. <h3 id="external-secrets.io/v1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  1634. </h3>
  1635. <p>
  1636. (<em>Appears on:</em>
  1637. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1638. </p>
  1639. <p>
  1640. <p>AkeylessAuthSecretRef references a Secret that contains the details
  1641. to authenticate with Akeyless.
  1642. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  1643. </p>
  1644. <table>
  1645. <thead>
  1646. <tr>
  1647. <th>Field</th>
  1648. <th>Description</th>
  1649. </tr>
  1650. </thead>
  1651. <tbody>
  1652. <tr>
  1653. <td>
  1654. <code>accessID</code></br>
  1655. <em>
  1656. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1657. External Secrets meta/v1.SecretKeySelector
  1658. </a>
  1659. </em>
  1660. </td>
  1661. <td>
  1662. <p>The SecretAccessID is used for authentication</p>
  1663. </td>
  1664. </tr>
  1665. <tr>
  1666. <td>
  1667. <code>accessType</code></br>
  1668. <em>
  1669. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1670. External Secrets meta/v1.SecretKeySelector
  1671. </a>
  1672. </em>
  1673. </td>
  1674. <td>
  1675. </td>
  1676. </tr>
  1677. <tr>
  1678. <td>
  1679. <code>accessTypeParam</code></br>
  1680. <em>
  1681. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1682. External Secrets meta/v1.SecretKeySelector
  1683. </a>
  1684. </em>
  1685. </td>
  1686. <td>
  1687. </td>
  1688. </tr>
  1689. </tbody>
  1690. </table>
  1691. <h3 id="external-secrets.io/v1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  1692. </h3>
  1693. <p>
  1694. (<em>Appears on:</em>
  1695. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1696. </p>
  1697. <p>
  1698. <p>AkeylessKubernetesAuth configures Kubernetes authentication with Akeyless.
  1699. It authenticates with Kubernetes ServiceAccount token stored.</p>
  1700. </p>
  1701. <table>
  1702. <thead>
  1703. <tr>
  1704. <th>Field</th>
  1705. <th>Description</th>
  1706. </tr>
  1707. </thead>
  1708. <tbody>
  1709. <tr>
  1710. <td>
  1711. <code>accessID</code></br>
  1712. <em>
  1713. string
  1714. </em>
  1715. </td>
  1716. <td>
  1717. <p>the Akeyless Kubernetes auth-method access-id</p>
  1718. </td>
  1719. </tr>
  1720. <tr>
  1721. <td>
  1722. <code>k8sConfName</code></br>
  1723. <em>
  1724. string
  1725. </em>
  1726. </td>
  1727. <td>
  1728. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  1729. </td>
  1730. </tr>
  1731. <tr>
  1732. <td>
  1733. <code>serviceAccountRef</code></br>
  1734. <em>
  1735. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1736. External Secrets meta/v1.ServiceAccountSelector
  1737. </a>
  1738. </em>
  1739. </td>
  1740. <td>
  1741. <em>(Optional)</em>
  1742. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  1743. If the service account is specified, the service account secret token JWT will be used
  1744. for authenticating with Akeyless. If the service account selector is not supplied,
  1745. the secretRef will be used instead.</p>
  1746. </td>
  1747. </tr>
  1748. <tr>
  1749. <td>
  1750. <code>secretRef</code></br>
  1751. <em>
  1752. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1753. External Secrets meta/v1.SecretKeySelector
  1754. </a>
  1755. </em>
  1756. </td>
  1757. <td>
  1758. <em>(Optional)</em>
  1759. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  1760. for authenticating with Akeyless. If a name is specified without a key,
  1761. <code>token</code> is the default. If one is not specified, the one bound to
  1762. the controller will be used.</p>
  1763. </td>
  1764. </tr>
  1765. </tbody>
  1766. </table>
  1767. <h3 id="external-secrets.io/v1.AkeylessProvider">AkeylessProvider
  1768. </h3>
  1769. <p>
  1770. (<em>Appears on:</em>
  1771. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1772. </p>
  1773. <p>
  1774. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  1775. </p>
  1776. <table>
  1777. <thead>
  1778. <tr>
  1779. <th>Field</th>
  1780. <th>Description</th>
  1781. </tr>
  1782. </thead>
  1783. <tbody>
  1784. <tr>
  1785. <td>
  1786. <code>akeylessGWApiURL</code></br>
  1787. <em>
  1788. string
  1789. </em>
  1790. </td>
  1791. <td>
  1792. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  1793. </td>
  1794. </tr>
  1795. <tr>
  1796. <td>
  1797. <code>authSecretRef</code></br>
  1798. <em>
  1799. <a href="#external-secrets.io/v1.AkeylessAuth">
  1800. AkeylessAuth
  1801. </a>
  1802. </em>
  1803. </td>
  1804. <td>
  1805. <p>Auth configures how the operator authenticates with Akeyless.</p>
  1806. </td>
  1807. </tr>
  1808. <tr>
  1809. <td>
  1810. <code>caBundle</code></br>
  1811. <em>
  1812. []byte
  1813. </em>
  1814. </td>
  1815. <td>
  1816. <em>(Optional)</em>
  1817. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  1818. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  1819. are used to validate the TLS connection.</p>
  1820. </td>
  1821. </tr>
  1822. <tr>
  1823. <td>
  1824. <code>caProvider</code></br>
  1825. <em>
  1826. <a href="#external-secrets.io/v1.CAProvider">
  1827. CAProvider
  1828. </a>
  1829. </em>
  1830. </td>
  1831. <td>
  1832. <em>(Optional)</em>
  1833. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  1834. </td>
  1835. </tr>
  1836. </tbody>
  1837. </table>
  1838. <h3 id="external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol
  1839. </h3>
  1840. <p>
  1841. (<em>Appears on:</em>
  1842. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  1843. </p>
  1844. <p>
  1845. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  1846. </p>
  1847. <table>
  1848. <thead>
  1849. <tr>
  1850. <th>Field</th>
  1851. <th>Description</th>
  1852. </tr>
  1853. </thead>
  1854. <tbody>
  1855. <tr>
  1856. <td>
  1857. <code>ntlm</code></br>
  1858. <em>
  1859. <a href="#external-secrets.io/v1.NTLMProtocol">
  1860. NTLMProtocol
  1861. </a>
  1862. </em>
  1863. </td>
  1864. <td>
  1865. <em>(Optional)</em>
  1866. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  1867. </td>
  1868. </tr>
  1869. </tbody>
  1870. </table>
  1871. <h3 id="external-secrets.io/v1.AwsAuthCredentials">AwsAuthCredentials
  1872. </h3>
  1873. <p>
  1874. (<em>Appears on:</em>
  1875. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1876. </p>
  1877. <p>
  1878. <p>AwsAuthCredentials represents the credentials for AWS authentication.</p>
  1879. </p>
  1880. <table>
  1881. <thead>
  1882. <tr>
  1883. <th>Field</th>
  1884. <th>Description</th>
  1885. </tr>
  1886. </thead>
  1887. <tbody>
  1888. <tr>
  1889. <td>
  1890. <code>identityId</code></br>
  1891. <em>
  1892. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1893. External Secrets meta/v1.SecretKeySelector
  1894. </a>
  1895. </em>
  1896. </td>
  1897. <td>
  1898. </td>
  1899. </tr>
  1900. </tbody>
  1901. </table>
  1902. <h3 id="external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig
  1903. </h3>
  1904. <p>
  1905. (<em>Appears on:</em>
  1906. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  1907. </p>
  1908. <p>
  1909. <p>AwsCredentialsConfig holds the region and the Secret reference which contains the AWS credentials.</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>region</code></br>
  1922. <em>
  1923. string
  1924. </em>
  1925. </td>
  1926. <td>
  1927. <p>region is for configuring the AWS region to be used.</p>
  1928. </td>
  1929. </tr>
  1930. <tr>
  1931. <td>
  1932. <code>awsCredentialsSecretRef</code></br>
  1933. <em>
  1934. <a href="#external-secrets.io/v1.SecretReference">
  1935. SecretReference
  1936. </a>
  1937. </em>
  1938. </td>
  1939. <td>
  1940. <p>awsCredentialsSecretRef is the reference to the secret which holds the AWS credentials.
  1941. Secret should be created with below names for keys
  1942. - aws_access_key_id: Access Key ID, which is the unique identifier for the AWS account or the IAM user.
  1943. - aws_secret_access_key: Secret Access Key, which is used to authenticate requests made to AWS services.
  1944. - aws_session_token: Session Token, is the short-lived token to authenticate requests made to AWS services.</p>
  1945. </td>
  1946. </tr>
  1947. </tbody>
  1948. </table>
  1949. <h3 id="external-secrets.io/v1.AzureAuthCredentials">AzureAuthCredentials
  1950. </h3>
  1951. <p>
  1952. (<em>Appears on:</em>
  1953. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1954. </p>
  1955. <p>
  1956. <p>AzureAuthCredentials represents the credentials for Azure authentication.</p>
  1957. </p>
  1958. <table>
  1959. <thead>
  1960. <tr>
  1961. <th>Field</th>
  1962. <th>Description</th>
  1963. </tr>
  1964. </thead>
  1965. <tbody>
  1966. <tr>
  1967. <td>
  1968. <code>identityId</code></br>
  1969. <em>
  1970. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1971. External Secrets meta/v1.SecretKeySelector
  1972. </a>
  1973. </em>
  1974. </td>
  1975. <td>
  1976. </td>
  1977. </tr>
  1978. <tr>
  1979. <td>
  1980. <code>resource</code></br>
  1981. <em>
  1982. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1983. External Secrets meta/v1.SecretKeySelector
  1984. </a>
  1985. </em>
  1986. </td>
  1987. <td>
  1988. <em>(Optional)</em>
  1989. </td>
  1990. </tr>
  1991. </tbody>
  1992. </table>
  1993. <h3 id="external-secrets.io/v1.AzureAuthType">AzureAuthType
  1994. (<code>string</code> alias)</p></h3>
  1995. <p>
  1996. (<em>Appears on:</em>
  1997. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  1998. </p>
  1999. <p>
  2000. <p>AzureAuthType describes how to authenticate to the Azure Keyvault
  2001. Only one of the following auth types may be specified.
  2002. If none of the following auth type is specified, the default one
  2003. is ServicePrincipal.</p>
  2004. </p>
  2005. <table>
  2006. <thead>
  2007. <tr>
  2008. <th>Value</th>
  2009. <th>Description</th>
  2010. </tr>
  2011. </thead>
  2012. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  2013. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  2014. </td>
  2015. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  2016. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  2017. </td>
  2018. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  2019. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  2020. </td>
  2021. </tr></tbody>
  2022. </table>
  2023. <h3 id="external-secrets.io/v1.AzureCustomCloudConfig">AzureCustomCloudConfig
  2024. </h3>
  2025. <p>
  2026. (<em>Appears on:</em>
  2027. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2028. </p>
  2029. <p>
  2030. <p>AzureCustomCloudConfig specifies custom cloud configuration for private Azure environments
  2031. IMPORTANT: Custom cloud configuration is ONLY supported when UseAzureSDK is true.
  2032. The legacy go-autorest SDK does not support custom cloud endpoints.</p>
  2033. </p>
  2034. <table>
  2035. <thead>
  2036. <tr>
  2037. <th>Field</th>
  2038. <th>Description</th>
  2039. </tr>
  2040. </thead>
  2041. <tbody>
  2042. <tr>
  2043. <td>
  2044. <code>activeDirectoryEndpoint</code></br>
  2045. <em>
  2046. string
  2047. </em>
  2048. </td>
  2049. <td>
  2050. <p>ActiveDirectoryEndpoint is the AAD endpoint for authentication
  2051. Required when using custom cloud configuration</p>
  2052. </td>
  2053. </tr>
  2054. <tr>
  2055. <td>
  2056. <code>keyVaultEndpoint</code></br>
  2057. <em>
  2058. string
  2059. </em>
  2060. </td>
  2061. <td>
  2062. <em>(Optional)</em>
  2063. <p>KeyVaultEndpoint is the Key Vault service endpoint</p>
  2064. </td>
  2065. </tr>
  2066. <tr>
  2067. <td>
  2068. <code>keyVaultDNSSuffix</code></br>
  2069. <em>
  2070. string
  2071. </em>
  2072. </td>
  2073. <td>
  2074. <em>(Optional)</em>
  2075. <p>KeyVaultDNSSuffix is the DNS suffix for Key Vault URLs</p>
  2076. </td>
  2077. </tr>
  2078. <tr>
  2079. <td>
  2080. <code>resourceManagerEndpoint</code></br>
  2081. <em>
  2082. string
  2083. </em>
  2084. </td>
  2085. <td>
  2086. <em>(Optional)</em>
  2087. <p>ResourceManagerEndpoint is the Azure Resource Manager endpoint</p>
  2088. </td>
  2089. </tr>
  2090. </tbody>
  2091. </table>
  2092. <h3 id="external-secrets.io/v1.AzureEnvironmentType">AzureEnvironmentType
  2093. (<code>string</code> alias)</p></h3>
  2094. <p>
  2095. (<em>Appears on:</em>
  2096. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>,
  2097. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  2098. </p>
  2099. <p>
  2100. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  2101. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  2102. 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>
  2103. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud</p>
  2104. </p>
  2105. <table>
  2106. <thead>
  2107. <tr>
  2108. <th>Value</th>
  2109. <th>Description</th>
  2110. </tr>
  2111. </thead>
  2112. <tbody><tr><td><p>&#34;AzureStackCloud&#34;</p></td>
  2113. <td></td>
  2114. </tr><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  2115. <td></td>
  2116. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  2117. <td></td>
  2118. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  2119. <td></td>
  2120. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  2121. <td></td>
  2122. </tr></tbody>
  2123. </table>
  2124. <h3 id="external-secrets.io/v1.AzureKVAuth">AzureKVAuth
  2125. </h3>
  2126. <p>
  2127. (<em>Appears on:</em>
  2128. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2129. </p>
  2130. <p>
  2131. <p>AzureKVAuth is the configuration used to authenticate with Azure.</p>
  2132. </p>
  2133. <table>
  2134. <thead>
  2135. <tr>
  2136. <th>Field</th>
  2137. <th>Description</th>
  2138. </tr>
  2139. </thead>
  2140. <tbody>
  2141. <tr>
  2142. <td>
  2143. <code>clientId</code></br>
  2144. <em>
  2145. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2146. External Secrets meta/v1.SecretKeySelector
  2147. </a>
  2148. </em>
  2149. </td>
  2150. <td>
  2151. <em>(Optional)</em>
  2152. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  2153. </td>
  2154. </tr>
  2155. <tr>
  2156. <td>
  2157. <code>tenantId</code></br>
  2158. <em>
  2159. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2160. External Secrets meta/v1.SecretKeySelector
  2161. </a>
  2162. </em>
  2163. </td>
  2164. <td>
  2165. <em>(Optional)</em>
  2166. <p>The Azure tenantId of the managed identity used for authentication.</p>
  2167. </td>
  2168. </tr>
  2169. <tr>
  2170. <td>
  2171. <code>clientSecret</code></br>
  2172. <em>
  2173. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2174. External Secrets meta/v1.SecretKeySelector
  2175. </a>
  2176. </em>
  2177. </td>
  2178. <td>
  2179. <em>(Optional)</em>
  2180. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  2181. </td>
  2182. </tr>
  2183. <tr>
  2184. <td>
  2185. <code>clientCertificate</code></br>
  2186. <em>
  2187. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2188. External Secrets meta/v1.SecretKeySelector
  2189. </a>
  2190. </em>
  2191. </td>
  2192. <td>
  2193. <em>(Optional)</em>
  2194. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  2195. </td>
  2196. </tr>
  2197. </tbody>
  2198. </table>
  2199. <h3 id="external-secrets.io/v1.AzureKVProvider">AzureKVProvider
  2200. </h3>
  2201. <p>
  2202. (<em>Appears on:</em>
  2203. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2204. </p>
  2205. <p>
  2206. <p>AzureKVProvider configures a store to sync secrets using Azure KV.</p>
  2207. </p>
  2208. <table>
  2209. <thead>
  2210. <tr>
  2211. <th>Field</th>
  2212. <th>Description</th>
  2213. </tr>
  2214. </thead>
  2215. <tbody>
  2216. <tr>
  2217. <td>
  2218. <code>authType</code></br>
  2219. <em>
  2220. <a href="#external-secrets.io/v1.AzureAuthType">
  2221. AzureAuthType
  2222. </a>
  2223. </em>
  2224. </td>
  2225. <td>
  2226. <em>(Optional)</em>
  2227. <p>Auth type defines how to authenticate to the keyvault service.
  2228. Valid values are:
  2229. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  2230. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)</p>
  2231. </td>
  2232. </tr>
  2233. <tr>
  2234. <td>
  2235. <code>vaultUrl</code></br>
  2236. <em>
  2237. string
  2238. </em>
  2239. </td>
  2240. <td>
  2241. <p>Vault Url from which the secrets to be fetched from.</p>
  2242. </td>
  2243. </tr>
  2244. <tr>
  2245. <td>
  2246. <code>tenantId</code></br>
  2247. <em>
  2248. string
  2249. </em>
  2250. </td>
  2251. <td>
  2252. <em>(Optional)</em>
  2253. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2254. </td>
  2255. </tr>
  2256. <tr>
  2257. <td>
  2258. <code>environmentType</code></br>
  2259. <em>
  2260. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  2261. AzureEnvironmentType
  2262. </a>
  2263. </em>
  2264. </td>
  2265. <td>
  2266. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  2267. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  2268. 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>
  2269. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud
  2270. Use AzureStackCloud when you need to configure custom Azure Stack Hub or Azure Stack Edge endpoints.</p>
  2271. </td>
  2272. </tr>
  2273. <tr>
  2274. <td>
  2275. <code>authSecretRef</code></br>
  2276. <em>
  2277. <a href="#external-secrets.io/v1.AzureKVAuth">
  2278. AzureKVAuth
  2279. </a>
  2280. </em>
  2281. </td>
  2282. <td>
  2283. <em>(Optional)</em>
  2284. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2285. </td>
  2286. </tr>
  2287. <tr>
  2288. <td>
  2289. <code>serviceAccountRef</code></br>
  2290. <em>
  2291. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  2292. External Secrets meta/v1.ServiceAccountSelector
  2293. </a>
  2294. </em>
  2295. </td>
  2296. <td>
  2297. <em>(Optional)</em>
  2298. <p>ServiceAccountRef specified the service account
  2299. that should be used when authenticating with WorkloadIdentity.</p>
  2300. </td>
  2301. </tr>
  2302. <tr>
  2303. <td>
  2304. <code>identityId</code></br>
  2305. <em>
  2306. string
  2307. </em>
  2308. </td>
  2309. <td>
  2310. <em>(Optional)</em>
  2311. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  2312. </td>
  2313. </tr>
  2314. <tr>
  2315. <td>
  2316. <code>useAzureSDK</code></br>
  2317. <em>
  2318. bool
  2319. </em>
  2320. </td>
  2321. <td>
  2322. <em>(Optional)</em>
  2323. <p>UseAzureSDK enables the use of the new Azure SDK for Go (azcore-based) instead of the legacy go-autorest SDK.
  2324. This is experimental and may have behavioral differences. Defaults to false (legacy SDK).</p>
  2325. </td>
  2326. </tr>
  2327. <tr>
  2328. <td>
  2329. <code>customCloudConfig</code></br>
  2330. <em>
  2331. <a href="#external-secrets.io/v1.AzureCustomCloudConfig">
  2332. AzureCustomCloudConfig
  2333. </a>
  2334. </em>
  2335. </td>
  2336. <td>
  2337. <em>(Optional)</em>
  2338. <p>CustomCloudConfig defines custom Azure endpoints for non-standard clouds.
  2339. Required when EnvironmentType is AzureStackCloud.
  2340. Optional for other environment types - useful for Azure China when using Workload Identity
  2341. with AKS, where the OIDC issuer (login.partner.microsoftonline.cn) differs from the
  2342. standard China Cloud endpoint (login.chinacloudapi.cn).
  2343. IMPORTANT: This feature REQUIRES UseAzureSDK to be set to true. Custom cloud
  2344. configuration is not supported with the legacy go-autorest SDK.</p>
  2345. </td>
  2346. </tr>
  2347. </tbody>
  2348. </table>
  2349. <h3 id="external-secrets.io/v1.BarbicanAuth">BarbicanAuth
  2350. </h3>
  2351. <p>
  2352. (<em>Appears on:</em>
  2353. <a href="#external-secrets.io/v1.BarbicanProvider">BarbicanProvider</a>)
  2354. </p>
  2355. <p>
  2356. <p>BarbicanAuth contains the authentication information for Barbican.</p>
  2357. </p>
  2358. <table>
  2359. <thead>
  2360. <tr>
  2361. <th>Field</th>
  2362. <th>Description</th>
  2363. </tr>
  2364. </thead>
  2365. <tbody>
  2366. <tr>
  2367. <td>
  2368. <code>username</code></br>
  2369. <em>
  2370. <a href="#external-secrets.io/v1.BarbicanProviderUsernameRef">
  2371. BarbicanProviderUsernameRef
  2372. </a>
  2373. </em>
  2374. </td>
  2375. <td>
  2376. </td>
  2377. </tr>
  2378. <tr>
  2379. <td>
  2380. <code>password</code></br>
  2381. <em>
  2382. <a href="#external-secrets.io/v1.BarbicanProviderPasswordRef">
  2383. BarbicanProviderPasswordRef
  2384. </a>
  2385. </em>
  2386. </td>
  2387. <td>
  2388. </td>
  2389. </tr>
  2390. </tbody>
  2391. </table>
  2392. <h3 id="external-secrets.io/v1.BarbicanProvider">BarbicanProvider
  2393. </h3>
  2394. <p>
  2395. (<em>Appears on:</em>
  2396. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2397. </p>
  2398. <p>
  2399. <p>BarbicanProvider setup a store to sync secrets with barbican.</p>
  2400. </p>
  2401. <table>
  2402. <thead>
  2403. <tr>
  2404. <th>Field</th>
  2405. <th>Description</th>
  2406. </tr>
  2407. </thead>
  2408. <tbody>
  2409. <tr>
  2410. <td>
  2411. <code>authURL</code></br>
  2412. <em>
  2413. string
  2414. </em>
  2415. </td>
  2416. <td>
  2417. </td>
  2418. </tr>
  2419. <tr>
  2420. <td>
  2421. <code>tenantName</code></br>
  2422. <em>
  2423. string
  2424. </em>
  2425. </td>
  2426. <td>
  2427. </td>
  2428. </tr>
  2429. <tr>
  2430. <td>
  2431. <code>domainName</code></br>
  2432. <em>
  2433. string
  2434. </em>
  2435. </td>
  2436. <td>
  2437. </td>
  2438. </tr>
  2439. <tr>
  2440. <td>
  2441. <code>region</code></br>
  2442. <em>
  2443. string
  2444. </em>
  2445. </td>
  2446. <td>
  2447. </td>
  2448. </tr>
  2449. <tr>
  2450. <td>
  2451. <code>auth</code></br>
  2452. <em>
  2453. <a href="#external-secrets.io/v1.BarbicanAuth">
  2454. BarbicanAuth
  2455. </a>
  2456. </em>
  2457. </td>
  2458. <td>
  2459. </td>
  2460. </tr>
  2461. </tbody>
  2462. </table>
  2463. <h3 id="external-secrets.io/v1.BarbicanProviderPasswordRef">BarbicanProviderPasswordRef
  2464. </h3>
  2465. <p>
  2466. (<em>Appears on:</em>
  2467. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2468. </p>
  2469. <p>
  2470. <p>BarbicanProviderPasswordRef defines a reference to a secret containing password for the Barbican provider.</p>
  2471. </p>
  2472. <table>
  2473. <thead>
  2474. <tr>
  2475. <th>Field</th>
  2476. <th>Description</th>
  2477. </tr>
  2478. </thead>
  2479. <tbody>
  2480. <tr>
  2481. <td>
  2482. <code>secretRef</code></br>
  2483. <em>
  2484. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2485. External Secrets meta/v1.SecretKeySelector
  2486. </a>
  2487. </em>
  2488. </td>
  2489. <td>
  2490. </td>
  2491. </tr>
  2492. </tbody>
  2493. </table>
  2494. <h3 id="external-secrets.io/v1.BarbicanProviderUsernameRef">BarbicanProviderUsernameRef
  2495. </h3>
  2496. <p>
  2497. (<em>Appears on:</em>
  2498. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2499. </p>
  2500. <p>
  2501. <p>BarbicanProviderUsernameRef defines a reference to a secret containing username for the Barbican provider.</p>
  2502. </p>
  2503. <table>
  2504. <thead>
  2505. <tr>
  2506. <th>Field</th>
  2507. <th>Description</th>
  2508. </tr>
  2509. </thead>
  2510. <tbody>
  2511. <tr>
  2512. <td>
  2513. <code>value</code></br>
  2514. <em>
  2515. string
  2516. </em>
  2517. </td>
  2518. <td>
  2519. </td>
  2520. </tr>
  2521. <tr>
  2522. <td>
  2523. <code>secretRef</code></br>
  2524. <em>
  2525. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2526. External Secrets meta/v1.SecretKeySelector
  2527. </a>
  2528. </em>
  2529. </td>
  2530. <td>
  2531. </td>
  2532. </tr>
  2533. </tbody>
  2534. </table>
  2535. <h3 id="external-secrets.io/v1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  2536. </h3>
  2537. <p>
  2538. (<em>Appears on:</em>
  2539. <a href="#external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth</a>)
  2540. </p>
  2541. <p>
  2542. <p>BeyondTrustProviderSecretRef references a value that can be specified directly or via a secret
  2543. for a BeyondTrustProvider.</p>
  2544. </p>
  2545. <table>
  2546. <thead>
  2547. <tr>
  2548. <th>Field</th>
  2549. <th>Description</th>
  2550. </tr>
  2551. </thead>
  2552. <tbody>
  2553. <tr>
  2554. <td>
  2555. <code>value</code></br>
  2556. <em>
  2557. string
  2558. </em>
  2559. </td>
  2560. <td>
  2561. <em>(Optional)</em>
  2562. <p>Value can be specified directly to set a value without using a secret.</p>
  2563. </td>
  2564. </tr>
  2565. <tr>
  2566. <td>
  2567. <code>secretRef</code></br>
  2568. <em>
  2569. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2570. External Secrets meta/v1.SecretKeySelector
  2571. </a>
  2572. </em>
  2573. </td>
  2574. <td>
  2575. <em>(Optional)</em>
  2576. <p>SecretRef references a key in a secret that will be used as value.</p>
  2577. </td>
  2578. </tr>
  2579. </tbody>
  2580. </table>
  2581. <h3 id="external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth
  2582. </h3>
  2583. <p>
  2584. (<em>Appears on:</em>
  2585. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2586. </p>
  2587. <p>
  2588. <p>BeyondtrustAuth provides different ways to authenticate to a BeyondtrustProvider server.</p>
  2589. </p>
  2590. <table>
  2591. <thead>
  2592. <tr>
  2593. <th>Field</th>
  2594. <th>Description</th>
  2595. </tr>
  2596. </thead>
  2597. <tbody>
  2598. <tr>
  2599. <td>
  2600. <code>apiKey</code></br>
  2601. <em>
  2602. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2603. BeyondTrustProviderSecretRef
  2604. </a>
  2605. </em>
  2606. </td>
  2607. <td>
  2608. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  2609. </td>
  2610. </tr>
  2611. <tr>
  2612. <td>
  2613. <code>clientId</code></br>
  2614. <em>
  2615. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2616. BeyondTrustProviderSecretRef
  2617. </a>
  2618. </em>
  2619. </td>
  2620. <td>
  2621. <p>ClientID is the API OAuth Client ID.</p>
  2622. </td>
  2623. </tr>
  2624. <tr>
  2625. <td>
  2626. <code>clientSecret</code></br>
  2627. <em>
  2628. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2629. BeyondTrustProviderSecretRef
  2630. </a>
  2631. </em>
  2632. </td>
  2633. <td>
  2634. <p>ClientSecret is the API OAuth Client Secret.</p>
  2635. </td>
  2636. </tr>
  2637. <tr>
  2638. <td>
  2639. <code>certificate</code></br>
  2640. <em>
  2641. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2642. BeyondTrustProviderSecretRef
  2643. </a>
  2644. </em>
  2645. </td>
  2646. <td>
  2647. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  2648. </td>
  2649. </tr>
  2650. <tr>
  2651. <td>
  2652. <code>certificateKey</code></br>
  2653. <em>
  2654. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2655. BeyondTrustProviderSecretRef
  2656. </a>
  2657. </em>
  2658. </td>
  2659. <td>
  2660. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  2661. </td>
  2662. </tr>
  2663. </tbody>
  2664. </table>
  2665. <h3 id="external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider
  2666. </h3>
  2667. <p>
  2668. (<em>Appears on:</em>
  2669. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2670. </p>
  2671. <p>
  2672. <p>BeyondtrustProvider provides access to a BeyondTrust secrets provider.</p>
  2673. </p>
  2674. <table>
  2675. <thead>
  2676. <tr>
  2677. <th>Field</th>
  2678. <th>Description</th>
  2679. </tr>
  2680. </thead>
  2681. <tbody>
  2682. <tr>
  2683. <td>
  2684. <code>auth</code></br>
  2685. <em>
  2686. <a href="#external-secrets.io/v1.BeyondtrustAuth">
  2687. BeyondtrustAuth
  2688. </a>
  2689. </em>
  2690. </td>
  2691. <td>
  2692. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  2693. </td>
  2694. </tr>
  2695. <tr>
  2696. <td>
  2697. <code>server</code></br>
  2698. <em>
  2699. <a href="#external-secrets.io/v1.BeyondtrustServer">
  2700. BeyondtrustServer
  2701. </a>
  2702. </em>
  2703. </td>
  2704. <td>
  2705. <p>Auth configures how API server works.</p>
  2706. </td>
  2707. </tr>
  2708. </tbody>
  2709. </table>
  2710. <h3 id="external-secrets.io/v1.BeyondtrustServer">BeyondtrustServer
  2711. </h3>
  2712. <p>
  2713. (<em>Appears on:</em>
  2714. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2715. </p>
  2716. <p>
  2717. <p>BeyondtrustServer configures a store to sync secrets using BeyondTrust Password Safe.</p>
  2718. </p>
  2719. <table>
  2720. <thead>
  2721. <tr>
  2722. <th>Field</th>
  2723. <th>Description</th>
  2724. </tr>
  2725. </thead>
  2726. <tbody>
  2727. <tr>
  2728. <td>
  2729. <code>apiUrl</code></br>
  2730. <em>
  2731. string
  2732. </em>
  2733. </td>
  2734. <td>
  2735. </td>
  2736. </tr>
  2737. <tr>
  2738. <td>
  2739. <code>apiVersion</code></br>
  2740. <em>
  2741. string
  2742. </em>
  2743. </td>
  2744. <td>
  2745. </td>
  2746. </tr>
  2747. <tr>
  2748. <td>
  2749. <code>retrievalType</code></br>
  2750. <em>
  2751. string
  2752. </em>
  2753. </td>
  2754. <td>
  2755. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  2756. </td>
  2757. </tr>
  2758. <tr>
  2759. <td>
  2760. <code>separator</code></br>
  2761. <em>
  2762. string
  2763. </em>
  2764. </td>
  2765. <td>
  2766. <p>A character that separates the folder names.</p>
  2767. </td>
  2768. </tr>
  2769. <tr>
  2770. <td>
  2771. <code>decrypt</code></br>
  2772. <em>
  2773. bool
  2774. </em>
  2775. </td>
  2776. <td>
  2777. <em>(Optional)</em>
  2778. <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>
  2779. </td>
  2780. </tr>
  2781. <tr>
  2782. <td>
  2783. <code>verifyCA</code></br>
  2784. <em>
  2785. bool
  2786. </em>
  2787. </td>
  2788. <td>
  2789. </td>
  2790. </tr>
  2791. <tr>
  2792. <td>
  2793. <code>clientTimeOutSeconds</code></br>
  2794. <em>
  2795. int
  2796. </em>
  2797. </td>
  2798. <td>
  2799. <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>
  2800. </td>
  2801. </tr>
  2802. </tbody>
  2803. </table>
  2804. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  2805. </h3>
  2806. <p>
  2807. (<em>Appears on:</em>
  2808. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  2809. </p>
  2810. <p>
  2811. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  2812. </p>
  2813. <table>
  2814. <thead>
  2815. <tr>
  2816. <th>Field</th>
  2817. <th>Description</th>
  2818. </tr>
  2819. </thead>
  2820. <tbody>
  2821. <tr>
  2822. <td>
  2823. <code>secretRef</code></br>
  2824. <em>
  2825. <a href="#external-secrets.io/v1.BitwardenSecretsManagerSecretRef">
  2826. BitwardenSecretsManagerSecretRef
  2827. </a>
  2828. </em>
  2829. </td>
  2830. <td>
  2831. </td>
  2832. </tr>
  2833. </tbody>
  2834. </table>
  2835. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  2836. </h3>
  2837. <p>
  2838. (<em>Appears on:</em>
  2839. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2840. </p>
  2841. <p>
  2842. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  2843. </p>
  2844. <table>
  2845. <thead>
  2846. <tr>
  2847. <th>Field</th>
  2848. <th>Description</th>
  2849. </tr>
  2850. </thead>
  2851. <tbody>
  2852. <tr>
  2853. <td>
  2854. <code>apiURL</code></br>
  2855. <em>
  2856. string
  2857. </em>
  2858. </td>
  2859. <td>
  2860. </td>
  2861. </tr>
  2862. <tr>
  2863. <td>
  2864. <code>identityURL</code></br>
  2865. <em>
  2866. string
  2867. </em>
  2868. </td>
  2869. <td>
  2870. </td>
  2871. </tr>
  2872. <tr>
  2873. <td>
  2874. <code>bitwardenServerSDKURL</code></br>
  2875. <em>
  2876. string
  2877. </em>
  2878. </td>
  2879. <td>
  2880. </td>
  2881. </tr>
  2882. <tr>
  2883. <td>
  2884. <code>caBundle</code></br>
  2885. <em>
  2886. string
  2887. </em>
  2888. </td>
  2889. <td>
  2890. <em>(Optional)</em>
  2891. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  2892. can be performed.</p>
  2893. </td>
  2894. </tr>
  2895. <tr>
  2896. <td>
  2897. <code>caProvider</code></br>
  2898. <em>
  2899. <a href="#external-secrets.io/v1.CAProvider">
  2900. CAProvider
  2901. </a>
  2902. </em>
  2903. </td>
  2904. <td>
  2905. <em>(Optional)</em>
  2906. <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>
  2907. </td>
  2908. </tr>
  2909. <tr>
  2910. <td>
  2911. <code>organizationID</code></br>
  2912. <em>
  2913. string
  2914. </em>
  2915. </td>
  2916. <td>
  2917. <p>OrganizationID determines which organization this secret store manages.</p>
  2918. </td>
  2919. </tr>
  2920. <tr>
  2921. <td>
  2922. <code>projectID</code></br>
  2923. <em>
  2924. string
  2925. </em>
  2926. </td>
  2927. <td>
  2928. <p>ProjectID determines which project this secret store manages.</p>
  2929. </td>
  2930. </tr>
  2931. <tr>
  2932. <td>
  2933. <code>auth</code></br>
  2934. <em>
  2935. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">
  2936. BitwardenSecretsManagerAuth
  2937. </a>
  2938. </em>
  2939. </td>
  2940. <td>
  2941. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  2942. Make sure that the token being used has permissions on the given secret.</p>
  2943. </td>
  2944. </tr>
  2945. </tbody>
  2946. </table>
  2947. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  2948. </h3>
  2949. <p>
  2950. (<em>Appears on:</em>
  2951. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  2952. </p>
  2953. <p>
  2954. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  2955. </p>
  2956. <table>
  2957. <thead>
  2958. <tr>
  2959. <th>Field</th>
  2960. <th>Description</th>
  2961. </tr>
  2962. </thead>
  2963. <tbody>
  2964. <tr>
  2965. <td>
  2966. <code>credentials</code></br>
  2967. <em>
  2968. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2969. External Secrets meta/v1.SecretKeySelector
  2970. </a>
  2971. </em>
  2972. </td>
  2973. <td>
  2974. <p>AccessToken used for the bitwarden instance.</p>
  2975. </td>
  2976. </tr>
  2977. </tbody>
  2978. </table>
  2979. <h3 id="external-secrets.io/v1.ByID">ByID
  2980. </h3>
  2981. <p>
  2982. (<em>Appears on:</em>
  2983. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  2984. </p>
  2985. <p>
  2986. <p>ByID configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID.</p>
  2987. </p>
  2988. <h3 id="external-secrets.io/v1.ByName">ByName
  2989. </h3>
  2990. <p>
  2991. (<em>Appears on:</em>
  2992. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  2993. </p>
  2994. <p>
  2995. <p>ByName configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret name.</p>
  2996. </p>
  2997. <table>
  2998. <thead>
  2999. <tr>
  3000. <th>Field</th>
  3001. <th>Description</th>
  3002. </tr>
  3003. </thead>
  3004. <tbody>
  3005. <tr>
  3006. <td>
  3007. <code>folderID</code></br>
  3008. <em>
  3009. string
  3010. </em>
  3011. </td>
  3012. <td>
  3013. <p>The folder to fetch secrets from</p>
  3014. </td>
  3015. </tr>
  3016. </tbody>
  3017. </table>
  3018. <h3 id="external-secrets.io/v1.CAProvider">CAProvider
  3019. </h3>
  3020. <p>
  3021. (<em>Appears on:</em>
  3022. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>,
  3023. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  3024. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>,
  3025. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>,
  3026. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>,
  3027. <a href="#external-secrets.io/v1.KubernetesServer">KubernetesServer</a>,
  3028. <a href="#external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS</a>,
  3029. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>,
  3030. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>,
  3031. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  3032. </p>
  3033. <p>
  3034. <p>CAProvider provides a custom certificate authority for accessing the provider&rsquo;s store.
  3035. The CAProvider points to a Secret or ConfigMap resource that contains a PEM-encoded certificate.</p>
  3036. </p>
  3037. <table>
  3038. <thead>
  3039. <tr>
  3040. <th>Field</th>
  3041. <th>Description</th>
  3042. </tr>
  3043. </thead>
  3044. <tbody>
  3045. <tr>
  3046. <td>
  3047. <code>type</code></br>
  3048. <em>
  3049. <a href="#external-secrets.io/v1.CAProviderType">
  3050. CAProviderType
  3051. </a>
  3052. </em>
  3053. </td>
  3054. <td>
  3055. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  3056. </td>
  3057. </tr>
  3058. <tr>
  3059. <td>
  3060. <code>name</code></br>
  3061. <em>
  3062. string
  3063. </em>
  3064. </td>
  3065. <td>
  3066. <p>The name of the object located at the provider type.</p>
  3067. </td>
  3068. </tr>
  3069. <tr>
  3070. <td>
  3071. <code>key</code></br>
  3072. <em>
  3073. string
  3074. </em>
  3075. </td>
  3076. <td>
  3077. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  3078. </td>
  3079. </tr>
  3080. <tr>
  3081. <td>
  3082. <code>namespace</code></br>
  3083. <em>
  3084. string
  3085. </em>
  3086. </td>
  3087. <td>
  3088. <em>(Optional)</em>
  3089. <p>The namespace the Provider type is in.
  3090. Can only be defined when used in a ClusterSecretStore.</p>
  3091. </td>
  3092. </tr>
  3093. </tbody>
  3094. </table>
  3095. <h3 id="external-secrets.io/v1.CAProviderType">CAProviderType
  3096. (<code>string</code> alias)</p></h3>
  3097. <p>
  3098. (<em>Appears on:</em>
  3099. <a href="#external-secrets.io/v1.CAProvider">CAProvider</a>)
  3100. </p>
  3101. <p>
  3102. <p>CAProviderType defines the type of provider for certificate authority.</p>
  3103. </p>
  3104. <table>
  3105. <thead>
  3106. <tr>
  3107. <th>Value</th>
  3108. <th>Description</th>
  3109. </tr>
  3110. </thead>
  3111. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  3112. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  3113. </td>
  3114. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  3115. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  3116. </td>
  3117. </tr></tbody>
  3118. </table>
  3119. <h3 id="external-secrets.io/v1.CSMAuth">CSMAuth
  3120. </h3>
  3121. <p>
  3122. (<em>Appears on:</em>
  3123. <a href="#external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider</a>)
  3124. </p>
  3125. <p>
  3126. <p>CSMAuth contains a secretRef for credentials.</p>
  3127. </p>
  3128. <table>
  3129. <thead>
  3130. <tr>
  3131. <th>Field</th>
  3132. <th>Description</th>
  3133. </tr>
  3134. </thead>
  3135. <tbody>
  3136. <tr>
  3137. <td>
  3138. <code>secretRef</code></br>
  3139. <em>
  3140. <a href="#external-secrets.io/v1.CSMAuthSecretRef">
  3141. CSMAuthSecretRef
  3142. </a>
  3143. </em>
  3144. </td>
  3145. <td>
  3146. <em>(Optional)</em>
  3147. </td>
  3148. </tr>
  3149. </tbody>
  3150. </table>
  3151. <h3 id="external-secrets.io/v1.CSMAuthSecretRef">CSMAuthSecretRef
  3152. </h3>
  3153. <p>
  3154. (<em>Appears on:</em>
  3155. <a href="#external-secrets.io/v1.CSMAuth">CSMAuth</a>)
  3156. </p>
  3157. <p>
  3158. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  3159. </p>
  3160. <table>
  3161. <thead>
  3162. <tr>
  3163. <th>Field</th>
  3164. <th>Description</th>
  3165. </tr>
  3166. </thead>
  3167. <tbody>
  3168. <tr>
  3169. <td>
  3170. <code>accessKeyIDSecretRef</code></br>
  3171. <em>
  3172. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3173. External Secrets meta/v1.SecretKeySelector
  3174. </a>
  3175. </em>
  3176. </td>
  3177. <td>
  3178. <p>The AccessKeyID is used for authentication</p>
  3179. </td>
  3180. </tr>
  3181. <tr>
  3182. <td>
  3183. <code>accessKeySecretSecretRef</code></br>
  3184. <em>
  3185. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3186. External Secrets meta/v1.SecretKeySelector
  3187. </a>
  3188. </em>
  3189. </td>
  3190. <td>
  3191. <p>The AccessKeySecret is used for authentication</p>
  3192. </td>
  3193. </tr>
  3194. </tbody>
  3195. </table>
  3196. <h3 id="external-secrets.io/v1.CacheConfig">CacheConfig
  3197. </h3>
  3198. <p>
  3199. (<em>Appears on:</em>
  3200. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  3201. </p>
  3202. <p>
  3203. <p>CacheConfig configures client-side caching for read operations.</p>
  3204. </p>
  3205. <table>
  3206. <thead>
  3207. <tr>
  3208. <th>Field</th>
  3209. <th>Description</th>
  3210. </tr>
  3211. </thead>
  3212. <tbody>
  3213. <tr>
  3214. <td>
  3215. <code>ttl</code></br>
  3216. <em>
  3217. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3218. Kubernetes meta/v1.Duration
  3219. </a>
  3220. </em>
  3221. </td>
  3222. <td>
  3223. <em>(Optional)</em>
  3224. <p>TTL is the time-to-live for cached secrets.
  3225. Format: duration string (e.g., &ldquo;5m&rdquo;, &ldquo;1h&rdquo;, &ldquo;30s&rdquo;)</p>
  3226. </td>
  3227. </tr>
  3228. <tr>
  3229. <td>
  3230. <code>maxSize</code></br>
  3231. <em>
  3232. int
  3233. </em>
  3234. </td>
  3235. <td>
  3236. <em>(Optional)</em>
  3237. <p>MaxSize is the maximum number of secrets to cache.
  3238. When the cache is full, least-recently-used entries are evicted.</p>
  3239. </td>
  3240. </tr>
  3241. </tbody>
  3242. </table>
  3243. <h3 id="external-secrets.io/v1.CertAuth">CertAuth
  3244. </h3>
  3245. <p>
  3246. (<em>Appears on:</em>
  3247. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  3248. </p>
  3249. <p>
  3250. <p>CertAuth defines certificate-based authentication configuration for Kubernetes.</p>
  3251. </p>
  3252. <table>
  3253. <thead>
  3254. <tr>
  3255. <th>Field</th>
  3256. <th>Description</th>
  3257. </tr>
  3258. </thead>
  3259. <tbody>
  3260. <tr>
  3261. <td>
  3262. <code>clientCert</code></br>
  3263. <em>
  3264. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3265. External Secrets meta/v1.SecretKeySelector
  3266. </a>
  3267. </em>
  3268. </td>
  3269. <td>
  3270. </td>
  3271. </tr>
  3272. <tr>
  3273. <td>
  3274. <code>clientKey</code></br>
  3275. <em>
  3276. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3277. External Secrets meta/v1.SecretKeySelector
  3278. </a>
  3279. </em>
  3280. </td>
  3281. <td>
  3282. </td>
  3283. </tr>
  3284. </tbody>
  3285. </table>
  3286. <h3 id="external-secrets.io/v1.ChefAuth">ChefAuth
  3287. </h3>
  3288. <p>
  3289. (<em>Appears on:</em>
  3290. <a href="#external-secrets.io/v1.ChefProvider">ChefProvider</a>)
  3291. </p>
  3292. <p>
  3293. <p>ChefAuth contains a secretRef for credentials.</p>
  3294. </p>
  3295. <table>
  3296. <thead>
  3297. <tr>
  3298. <th>Field</th>
  3299. <th>Description</th>
  3300. </tr>
  3301. </thead>
  3302. <tbody>
  3303. <tr>
  3304. <td>
  3305. <code>secretRef</code></br>
  3306. <em>
  3307. <a href="#external-secrets.io/v1.ChefAuthSecretRef">
  3308. ChefAuthSecretRef
  3309. </a>
  3310. </em>
  3311. </td>
  3312. <td>
  3313. </td>
  3314. </tr>
  3315. </tbody>
  3316. </table>
  3317. <h3 id="external-secrets.io/v1.ChefAuthSecretRef">ChefAuthSecretRef
  3318. </h3>
  3319. <p>
  3320. (<em>Appears on:</em>
  3321. <a href="#external-secrets.io/v1.ChefAuth">ChefAuth</a>)
  3322. </p>
  3323. <p>
  3324. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  3325. </p>
  3326. <table>
  3327. <thead>
  3328. <tr>
  3329. <th>Field</th>
  3330. <th>Description</th>
  3331. </tr>
  3332. </thead>
  3333. <tbody>
  3334. <tr>
  3335. <td>
  3336. <code>privateKeySecretRef</code></br>
  3337. <em>
  3338. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3339. External Secrets meta/v1.SecretKeySelector
  3340. </a>
  3341. </em>
  3342. </td>
  3343. <td>
  3344. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  3345. </td>
  3346. </tr>
  3347. </tbody>
  3348. </table>
  3349. <h3 id="external-secrets.io/v1.ChefProvider">ChefProvider
  3350. </h3>
  3351. <p>
  3352. (<em>Appears on:</em>
  3353. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3354. </p>
  3355. <p>
  3356. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  3357. </p>
  3358. <table>
  3359. <thead>
  3360. <tr>
  3361. <th>Field</th>
  3362. <th>Description</th>
  3363. </tr>
  3364. </thead>
  3365. <tbody>
  3366. <tr>
  3367. <td>
  3368. <code>auth</code></br>
  3369. <em>
  3370. <a href="#external-secrets.io/v1.ChefAuth">
  3371. ChefAuth
  3372. </a>
  3373. </em>
  3374. </td>
  3375. <td>
  3376. <p>Auth defines the information necessary to authenticate against chef Server</p>
  3377. </td>
  3378. </tr>
  3379. <tr>
  3380. <td>
  3381. <code>username</code></br>
  3382. <em>
  3383. string
  3384. </em>
  3385. </td>
  3386. <td>
  3387. <p>UserName should be the user ID on the chef server</p>
  3388. </td>
  3389. </tr>
  3390. <tr>
  3391. <td>
  3392. <code>serverUrl</code></br>
  3393. <em>
  3394. string
  3395. </em>
  3396. </td>
  3397. <td>
  3398. <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>
  3399. </td>
  3400. </tr>
  3401. </tbody>
  3402. </table>
  3403. <h3 id="external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider
  3404. </h3>
  3405. <p>
  3406. (<em>Appears on:</em>
  3407. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3408. </p>
  3409. <p>
  3410. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  3411. </p>
  3412. <table>
  3413. <thead>
  3414. <tr>
  3415. <th>Field</th>
  3416. <th>Description</th>
  3417. </tr>
  3418. </thead>
  3419. <tbody>
  3420. <tr>
  3421. <td>
  3422. <code>auth</code></br>
  3423. <em>
  3424. <a href="#external-secrets.io/v1.CSMAuth">
  3425. CSMAuth
  3426. </a>
  3427. </em>
  3428. </td>
  3429. <td>
  3430. </td>
  3431. </tr>
  3432. <tr>
  3433. <td>
  3434. <code>projectID</code></br>
  3435. <em>
  3436. string
  3437. </em>
  3438. </td>
  3439. <td>
  3440. <p>ProjectID is the project, which the secrets are stored in.</p>
  3441. </td>
  3442. </tr>
  3443. </tbody>
  3444. </table>
  3445. <h3 id="external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret
  3446. </h3>
  3447. <p>
  3448. <p>ClusterExternalSecret is the Schema for the clusterexternalsecrets API.</p>
  3449. </p>
  3450. <table>
  3451. <thead>
  3452. <tr>
  3453. <th>Field</th>
  3454. <th>Description</th>
  3455. </tr>
  3456. </thead>
  3457. <tbody>
  3458. <tr>
  3459. <td>
  3460. <code>metadata</code></br>
  3461. <em>
  3462. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  3463. Kubernetes meta/v1.ObjectMeta
  3464. </a>
  3465. </em>
  3466. </td>
  3467. <td>
  3468. Refer to the Kubernetes API documentation for the fields of the
  3469. <code>metadata</code> field.
  3470. </td>
  3471. </tr>
  3472. <tr>
  3473. <td>
  3474. <code>spec</code></br>
  3475. <em>
  3476. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">
  3477. ClusterExternalSecretSpec
  3478. </a>
  3479. </em>
  3480. </td>
  3481. <td>
  3482. <br/>
  3483. <br/>
  3484. <table>
  3485. <tr>
  3486. <td>
  3487. <code>externalSecretSpec</code></br>
  3488. <em>
  3489. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3490. ExternalSecretSpec
  3491. </a>
  3492. </em>
  3493. </td>
  3494. <td>
  3495. <p>The spec for the ExternalSecrets to be created</p>
  3496. </td>
  3497. </tr>
  3498. <tr>
  3499. <td>
  3500. <code>externalSecretName</code></br>
  3501. <em>
  3502. string
  3503. </em>
  3504. </td>
  3505. <td>
  3506. <em>(Optional)</em>
  3507. <p>The name of the external secrets to be created.
  3508. Defaults to the name of the ClusterExternalSecret</p>
  3509. </td>
  3510. </tr>
  3511. <tr>
  3512. <td>
  3513. <code>externalSecretMetadata</code></br>
  3514. <em>
  3515. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3516. ExternalSecretMetadata
  3517. </a>
  3518. </em>
  3519. </td>
  3520. <td>
  3521. <em>(Optional)</em>
  3522. <p>The metadata of the external secrets to be created</p>
  3523. </td>
  3524. </tr>
  3525. <tr>
  3526. <td>
  3527. <code>namespaceSelector</code></br>
  3528. <em>
  3529. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3530. Kubernetes meta/v1.LabelSelector
  3531. </a>
  3532. </em>
  3533. </td>
  3534. <td>
  3535. <em>(Optional)</em>
  3536. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3537. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3538. </td>
  3539. </tr>
  3540. <tr>
  3541. <td>
  3542. <code>namespaceSelectors</code></br>
  3543. <em>
  3544. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3545. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3546. </a>
  3547. </em>
  3548. </td>
  3549. <td>
  3550. <em>(Optional)</em>
  3551. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  3552. </td>
  3553. </tr>
  3554. <tr>
  3555. <td>
  3556. <code>namespaces</code></br>
  3557. <em>
  3558. []string
  3559. </em>
  3560. </td>
  3561. <td>
  3562. <em>(Optional)</em>
  3563. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  3564. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3565. </td>
  3566. </tr>
  3567. <tr>
  3568. <td>
  3569. <code>refreshTime</code></br>
  3570. <em>
  3571. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3572. Kubernetes meta/v1.Duration
  3573. </a>
  3574. </em>
  3575. </td>
  3576. <td>
  3577. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  3578. </td>
  3579. </tr>
  3580. </table>
  3581. </td>
  3582. </tr>
  3583. <tr>
  3584. <td>
  3585. <code>status</code></br>
  3586. <em>
  3587. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">
  3588. ClusterExternalSecretStatus
  3589. </a>
  3590. </em>
  3591. </td>
  3592. <td>
  3593. </td>
  3594. </tr>
  3595. </tbody>
  3596. </table>
  3597. <h3 id="external-secrets.io/v1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  3598. (<code>string</code> alias)</p></h3>
  3599. <p>
  3600. (<em>Appears on:</em>
  3601. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  3602. </p>
  3603. <p>
  3604. <p>ClusterExternalSecretConditionType defines a value type for ClusterExternalSecret conditions.</p>
  3605. </p>
  3606. <table>
  3607. <thead>
  3608. <tr>
  3609. <th>Value</th>
  3610. <th>Description</th>
  3611. </tr>
  3612. </thead>
  3613. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  3614. <td><p>ClusterExternalSecretReady is a ClusterExternalSecretConditionType set when the ClusterExternalSecret is ready.</p>
  3615. </td>
  3616. </tr></tbody>
  3617. </table>
  3618. <h3 id="external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  3619. </h3>
  3620. <p>
  3621. (<em>Appears on:</em>
  3622. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  3623. </p>
  3624. <p>
  3625. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  3626. </p>
  3627. <table>
  3628. <thead>
  3629. <tr>
  3630. <th>Field</th>
  3631. <th>Description</th>
  3632. </tr>
  3633. </thead>
  3634. <tbody>
  3635. <tr>
  3636. <td>
  3637. <code>namespace</code></br>
  3638. <em>
  3639. string
  3640. </em>
  3641. </td>
  3642. <td>
  3643. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  3644. </td>
  3645. </tr>
  3646. <tr>
  3647. <td>
  3648. <code>reason</code></br>
  3649. <em>
  3650. string
  3651. </em>
  3652. </td>
  3653. <td>
  3654. <em>(Optional)</em>
  3655. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  3656. </td>
  3657. </tr>
  3658. </tbody>
  3659. </table>
  3660. <h3 id="external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  3661. </h3>
  3662. <p>
  3663. (<em>Appears on:</em>
  3664. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  3665. </p>
  3666. <p>
  3667. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  3668. </p>
  3669. <table>
  3670. <thead>
  3671. <tr>
  3672. <th>Field</th>
  3673. <th>Description</th>
  3674. </tr>
  3675. </thead>
  3676. <tbody>
  3677. <tr>
  3678. <td>
  3679. <code>externalSecretSpec</code></br>
  3680. <em>
  3681. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3682. ExternalSecretSpec
  3683. </a>
  3684. </em>
  3685. </td>
  3686. <td>
  3687. <p>The spec for the ExternalSecrets to be created</p>
  3688. </td>
  3689. </tr>
  3690. <tr>
  3691. <td>
  3692. <code>externalSecretName</code></br>
  3693. <em>
  3694. string
  3695. </em>
  3696. </td>
  3697. <td>
  3698. <em>(Optional)</em>
  3699. <p>The name of the external secrets to be created.
  3700. Defaults to the name of the ClusterExternalSecret</p>
  3701. </td>
  3702. </tr>
  3703. <tr>
  3704. <td>
  3705. <code>externalSecretMetadata</code></br>
  3706. <em>
  3707. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3708. ExternalSecretMetadata
  3709. </a>
  3710. </em>
  3711. </td>
  3712. <td>
  3713. <em>(Optional)</em>
  3714. <p>The metadata of the external secrets to be created</p>
  3715. </td>
  3716. </tr>
  3717. <tr>
  3718. <td>
  3719. <code>namespaceSelector</code></br>
  3720. <em>
  3721. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3722. Kubernetes meta/v1.LabelSelector
  3723. </a>
  3724. </em>
  3725. </td>
  3726. <td>
  3727. <em>(Optional)</em>
  3728. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3729. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3730. </td>
  3731. </tr>
  3732. <tr>
  3733. <td>
  3734. <code>namespaceSelectors</code></br>
  3735. <em>
  3736. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3737. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3738. </a>
  3739. </em>
  3740. </td>
  3741. <td>
  3742. <em>(Optional)</em>
  3743. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  3744. </td>
  3745. </tr>
  3746. <tr>
  3747. <td>
  3748. <code>namespaces</code></br>
  3749. <em>
  3750. []string
  3751. </em>
  3752. </td>
  3753. <td>
  3754. <em>(Optional)</em>
  3755. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  3756. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3757. </td>
  3758. </tr>
  3759. <tr>
  3760. <td>
  3761. <code>refreshTime</code></br>
  3762. <em>
  3763. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3764. Kubernetes meta/v1.Duration
  3765. </a>
  3766. </em>
  3767. </td>
  3768. <td>
  3769. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  3770. </td>
  3771. </tr>
  3772. </tbody>
  3773. </table>
  3774. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  3775. </h3>
  3776. <p>
  3777. (<em>Appears on:</em>
  3778. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  3779. </p>
  3780. <p>
  3781. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  3782. </p>
  3783. <table>
  3784. <thead>
  3785. <tr>
  3786. <th>Field</th>
  3787. <th>Description</th>
  3788. </tr>
  3789. </thead>
  3790. <tbody>
  3791. <tr>
  3792. <td>
  3793. <code>externalSecretName</code></br>
  3794. <em>
  3795. string
  3796. </em>
  3797. </td>
  3798. <td>
  3799. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  3800. </td>
  3801. </tr>
  3802. <tr>
  3803. <td>
  3804. <code>failedNamespaces</code></br>
  3805. <em>
  3806. <a href="#external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">
  3807. []ClusterExternalSecretNamespaceFailure
  3808. </a>
  3809. </em>
  3810. </td>
  3811. <td>
  3812. <em>(Optional)</em>
  3813. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  3814. </td>
  3815. </tr>
  3816. <tr>
  3817. <td>
  3818. <code>provisionedNamespaces</code></br>
  3819. <em>
  3820. []string
  3821. </em>
  3822. </td>
  3823. <td>
  3824. <em>(Optional)</em>
  3825. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  3826. </td>
  3827. </tr>
  3828. <tr>
  3829. <td>
  3830. <code>conditions</code></br>
  3831. <em>
  3832. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">
  3833. []ClusterExternalSecretStatusCondition
  3834. </a>
  3835. </em>
  3836. </td>
  3837. <td>
  3838. <em>(Optional)</em>
  3839. </td>
  3840. </tr>
  3841. </tbody>
  3842. </table>
  3843. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  3844. </h3>
  3845. <p>
  3846. (<em>Appears on:</em>
  3847. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  3848. </p>
  3849. <p>
  3850. <p>ClusterExternalSecretStatusCondition defines the observed state of a ClusterExternalSecret resource.</p>
  3851. </p>
  3852. <table>
  3853. <thead>
  3854. <tr>
  3855. <th>Field</th>
  3856. <th>Description</th>
  3857. </tr>
  3858. </thead>
  3859. <tbody>
  3860. <tr>
  3861. <td>
  3862. <code>type</code></br>
  3863. <em>
  3864. <a href="#external-secrets.io/v1.ClusterExternalSecretConditionType">
  3865. ClusterExternalSecretConditionType
  3866. </a>
  3867. </em>
  3868. </td>
  3869. <td>
  3870. </td>
  3871. </tr>
  3872. <tr>
  3873. <td>
  3874. <code>status</code></br>
  3875. <em>
  3876. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  3877. Kubernetes core/v1.ConditionStatus
  3878. </a>
  3879. </em>
  3880. </td>
  3881. <td>
  3882. </td>
  3883. </tr>
  3884. <tr>
  3885. <td>
  3886. <code>message</code></br>
  3887. <em>
  3888. string
  3889. </em>
  3890. </td>
  3891. <td>
  3892. <em>(Optional)</em>
  3893. </td>
  3894. </tr>
  3895. </tbody>
  3896. </table>
  3897. <h3 id="external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore
  3898. </h3>
  3899. <p>
  3900. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  3901. </p>
  3902. <table>
  3903. <thead>
  3904. <tr>
  3905. <th>Field</th>
  3906. <th>Description</th>
  3907. </tr>
  3908. </thead>
  3909. <tbody>
  3910. <tr>
  3911. <td>
  3912. <code>metadata</code></br>
  3913. <em>
  3914. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  3915. Kubernetes meta/v1.ObjectMeta
  3916. </a>
  3917. </em>
  3918. </td>
  3919. <td>
  3920. Refer to the Kubernetes API documentation for the fields of the
  3921. <code>metadata</code> field.
  3922. </td>
  3923. </tr>
  3924. <tr>
  3925. <td>
  3926. <code>spec</code></br>
  3927. <em>
  3928. <a href="#external-secrets.io/v1.SecretStoreSpec">
  3929. SecretStoreSpec
  3930. </a>
  3931. </em>
  3932. </td>
  3933. <td>
  3934. <br/>
  3935. <br/>
  3936. <table>
  3937. <tr>
  3938. <td>
  3939. <code>controller</code></br>
  3940. <em>
  3941. string
  3942. </em>
  3943. </td>
  3944. <td>
  3945. <em>(Optional)</em>
  3946. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  3947. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  3948. </td>
  3949. </tr>
  3950. <tr>
  3951. <td>
  3952. <code>provider</code></br>
  3953. <em>
  3954. <a href="#external-secrets.io/v1.SecretStoreProvider">
  3955. SecretStoreProvider
  3956. </a>
  3957. </em>
  3958. </td>
  3959. <td>
  3960. <p>Used to configure the provider. Only one provider may be set</p>
  3961. </td>
  3962. </tr>
  3963. <tr>
  3964. <td>
  3965. <code>retrySettings</code></br>
  3966. <em>
  3967. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  3968. SecretStoreRetrySettings
  3969. </a>
  3970. </em>
  3971. </td>
  3972. <td>
  3973. <em>(Optional)</em>
  3974. <p>Used to configure HTTP retries on failures.</p>
  3975. </td>
  3976. </tr>
  3977. <tr>
  3978. <td>
  3979. <code>refreshInterval</code></br>
  3980. <em>
  3981. int
  3982. </em>
  3983. </td>
  3984. <td>
  3985. <em>(Optional)</em>
  3986. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  3987. </td>
  3988. </tr>
  3989. <tr>
  3990. <td>
  3991. <code>conditions</code></br>
  3992. <em>
  3993. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  3994. []ClusterSecretStoreCondition
  3995. </a>
  3996. </em>
  3997. </td>
  3998. <td>
  3999. <em>(Optional)</em>
  4000. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  4001. </td>
  4002. </tr>
  4003. </table>
  4004. </td>
  4005. </tr>
  4006. <tr>
  4007. <td>
  4008. <code>status</code></br>
  4009. <em>
  4010. <a href="#external-secrets.io/v1.SecretStoreStatus">
  4011. SecretStoreStatus
  4012. </a>
  4013. </em>
  4014. </td>
  4015. <td>
  4016. </td>
  4017. </tr>
  4018. </tbody>
  4019. </table>
  4020. <h3 id="external-secrets.io/v1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  4021. </h3>
  4022. <p>
  4023. (<em>Appears on:</em>
  4024. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  4025. </p>
  4026. <p>
  4027. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  4028. for a ClusterSecretStore instance.</p>
  4029. </p>
  4030. <table>
  4031. <thead>
  4032. <tr>
  4033. <th>Field</th>
  4034. <th>Description</th>
  4035. </tr>
  4036. </thead>
  4037. <tbody>
  4038. <tr>
  4039. <td>
  4040. <code>namespaceSelector</code></br>
  4041. <em>
  4042. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4043. Kubernetes meta/v1.LabelSelector
  4044. </a>
  4045. </em>
  4046. </td>
  4047. <td>
  4048. <em>(Optional)</em>
  4049. <p>Choose namespace using a labelSelector</p>
  4050. </td>
  4051. </tr>
  4052. <tr>
  4053. <td>
  4054. <code>namespaces</code></br>
  4055. <em>
  4056. []string
  4057. </em>
  4058. </td>
  4059. <td>
  4060. <em>(Optional)</em>
  4061. <p>Choose namespaces by name</p>
  4062. </td>
  4063. </tr>
  4064. <tr>
  4065. <td>
  4066. <code>namespaceRegexes</code></br>
  4067. <em>
  4068. []string
  4069. </em>
  4070. </td>
  4071. <td>
  4072. <em>(Optional)</em>
  4073. <p>Choose namespaces by using regex matching</p>
  4074. </td>
  4075. </tr>
  4076. </tbody>
  4077. </table>
  4078. <h3 id="external-secrets.io/v1.ConfigMapReference">ConfigMapReference
  4079. </h3>
  4080. <p>
  4081. (<em>Appears on:</em>
  4082. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  4083. </p>
  4084. <p>
  4085. <p>ConfigMapReference holds the details of a configmap.</p>
  4086. </p>
  4087. <table>
  4088. <thead>
  4089. <tr>
  4090. <th>Field</th>
  4091. <th>Description</th>
  4092. </tr>
  4093. </thead>
  4094. <tbody>
  4095. <tr>
  4096. <td>
  4097. <code>name</code></br>
  4098. <em>
  4099. string
  4100. </em>
  4101. </td>
  4102. <td>
  4103. <p>name of the configmap.</p>
  4104. </td>
  4105. </tr>
  4106. <tr>
  4107. <td>
  4108. <code>namespace</code></br>
  4109. <em>
  4110. string
  4111. </em>
  4112. </td>
  4113. <td>
  4114. <p>namespace in which the configmap exists. If empty, configmap will looked up in local namespace.</p>
  4115. </td>
  4116. </tr>
  4117. <tr>
  4118. <td>
  4119. <code>key</code></br>
  4120. <em>
  4121. string
  4122. </em>
  4123. </td>
  4124. <td>
  4125. <p>key name holding the external account credential config.</p>
  4126. </td>
  4127. </tr>
  4128. </tbody>
  4129. </table>
  4130. <h3 id="external-secrets.io/v1.ConjurAPIKey">ConjurAPIKey
  4131. </h3>
  4132. <p>
  4133. (<em>Appears on:</em>
  4134. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4135. </p>
  4136. <p>
  4137. <p>ConjurAPIKey contains references to a Secret resource that holds
  4138. the Conjur username and API key.</p>
  4139. </p>
  4140. <table>
  4141. <thead>
  4142. <tr>
  4143. <th>Field</th>
  4144. <th>Description</th>
  4145. </tr>
  4146. </thead>
  4147. <tbody>
  4148. <tr>
  4149. <td>
  4150. <code>account</code></br>
  4151. <em>
  4152. string
  4153. </em>
  4154. </td>
  4155. <td>
  4156. <p>Account is the Conjur organization account name.</p>
  4157. </td>
  4158. </tr>
  4159. <tr>
  4160. <td>
  4161. <code>userRef</code></br>
  4162. <em>
  4163. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4164. External Secrets meta/v1.SecretKeySelector
  4165. </a>
  4166. </em>
  4167. </td>
  4168. <td>
  4169. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  4170. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4171. </td>
  4172. </tr>
  4173. <tr>
  4174. <td>
  4175. <code>apiKeyRef</code></br>
  4176. <em>
  4177. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4178. External Secrets meta/v1.SecretKeySelector
  4179. </a>
  4180. </em>
  4181. </td>
  4182. <td>
  4183. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  4184. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4185. </td>
  4186. </tr>
  4187. </tbody>
  4188. </table>
  4189. <h3 id="external-secrets.io/v1.ConjurAuth">ConjurAuth
  4190. </h3>
  4191. <p>
  4192. (<em>Appears on:</em>
  4193. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>)
  4194. </p>
  4195. <p>
  4196. <p>ConjurAuth is the way to provide authentication credentials to the ConjurProvider.</p>
  4197. </p>
  4198. <table>
  4199. <thead>
  4200. <tr>
  4201. <th>Field</th>
  4202. <th>Description</th>
  4203. </tr>
  4204. </thead>
  4205. <tbody>
  4206. <tr>
  4207. <td>
  4208. <code>apikey</code></br>
  4209. <em>
  4210. <a href="#external-secrets.io/v1.ConjurAPIKey">
  4211. ConjurAPIKey
  4212. </a>
  4213. </em>
  4214. </td>
  4215. <td>
  4216. <em>(Optional)</em>
  4217. <p>Authenticates with Conjur using an API key.</p>
  4218. </td>
  4219. </tr>
  4220. <tr>
  4221. <td>
  4222. <code>jwt</code></br>
  4223. <em>
  4224. <a href="#external-secrets.io/v1.ConjurJWT">
  4225. ConjurJWT
  4226. </a>
  4227. </em>
  4228. </td>
  4229. <td>
  4230. <em>(Optional)</em>
  4231. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  4232. </td>
  4233. </tr>
  4234. </tbody>
  4235. </table>
  4236. <h3 id="external-secrets.io/v1.ConjurJWT">ConjurJWT
  4237. </h3>
  4238. <p>
  4239. (<em>Appears on:</em>
  4240. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4241. </p>
  4242. <p>
  4243. <p>ConjurJWT defines the JWT authentication configuration for Conjur provider.</p>
  4244. </p>
  4245. <table>
  4246. <thead>
  4247. <tr>
  4248. <th>Field</th>
  4249. <th>Description</th>
  4250. </tr>
  4251. </thead>
  4252. <tbody>
  4253. <tr>
  4254. <td>
  4255. <code>account</code></br>
  4256. <em>
  4257. string
  4258. </em>
  4259. </td>
  4260. <td>
  4261. <p>Account is the Conjur organization account name.</p>
  4262. </td>
  4263. </tr>
  4264. <tr>
  4265. <td>
  4266. <code>serviceID</code></br>
  4267. <em>
  4268. string
  4269. </em>
  4270. </td>
  4271. <td>
  4272. <p>The conjur authn jwt webservice id</p>
  4273. </td>
  4274. </tr>
  4275. <tr>
  4276. <td>
  4277. <code>hostId</code></br>
  4278. <em>
  4279. string
  4280. </em>
  4281. </td>
  4282. <td>
  4283. <em>(Optional)</em>
  4284. <p>Optional HostID for JWT authentication. This may be used depending
  4285. on how the Conjur JWT authenticator policy is configured.</p>
  4286. </td>
  4287. </tr>
  4288. <tr>
  4289. <td>
  4290. <code>secretRef</code></br>
  4291. <em>
  4292. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4293. External Secrets meta/v1.SecretKeySelector
  4294. </a>
  4295. </em>
  4296. </td>
  4297. <td>
  4298. <em>(Optional)</em>
  4299. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  4300. authenticate with Conjur using the JWT authentication method.</p>
  4301. </td>
  4302. </tr>
  4303. <tr>
  4304. <td>
  4305. <code>serviceAccountRef</code></br>
  4306. <em>
  4307. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  4308. External Secrets meta/v1.ServiceAccountSelector
  4309. </a>
  4310. </em>
  4311. </td>
  4312. <td>
  4313. <em>(Optional)</em>
  4314. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  4315. a token for with the <code>TokenRequest</code> API.</p>
  4316. </td>
  4317. </tr>
  4318. </tbody>
  4319. </table>
  4320. <h3 id="external-secrets.io/v1.ConjurProvider">ConjurProvider
  4321. </h3>
  4322. <p>
  4323. (<em>Appears on:</em>
  4324. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4325. </p>
  4326. <p>
  4327. <p>ConjurProvider provides access to a Conjur provider.</p>
  4328. </p>
  4329. <table>
  4330. <thead>
  4331. <tr>
  4332. <th>Field</th>
  4333. <th>Description</th>
  4334. </tr>
  4335. </thead>
  4336. <tbody>
  4337. <tr>
  4338. <td>
  4339. <code>url</code></br>
  4340. <em>
  4341. string
  4342. </em>
  4343. </td>
  4344. <td>
  4345. <p>URL is the endpoint of the Conjur instance.</p>
  4346. </td>
  4347. </tr>
  4348. <tr>
  4349. <td>
  4350. <code>caBundle</code></br>
  4351. <em>
  4352. string
  4353. </em>
  4354. </td>
  4355. <td>
  4356. <em>(Optional)</em>
  4357. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  4358. </td>
  4359. </tr>
  4360. <tr>
  4361. <td>
  4362. <code>caProvider</code></br>
  4363. <em>
  4364. <a href="#external-secrets.io/v1.CAProvider">
  4365. CAProvider
  4366. </a>
  4367. </em>
  4368. </td>
  4369. <td>
  4370. <em>(Optional)</em>
  4371. <p>Used to provide custom certificate authority (CA) certificates
  4372. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  4373. that contains a PEM-encoded certificate.</p>
  4374. </td>
  4375. </tr>
  4376. <tr>
  4377. <td>
  4378. <code>auth</code></br>
  4379. <em>
  4380. <a href="#external-secrets.io/v1.ConjurAuth">
  4381. ConjurAuth
  4382. </a>
  4383. </em>
  4384. </td>
  4385. <td>
  4386. <p>Defines authentication settings for connecting to Conjur.</p>
  4387. </td>
  4388. </tr>
  4389. </tbody>
  4390. </table>
  4391. <h3 id="external-secrets.io/v1.DVLSAuth">DVLSAuth
  4392. </h3>
  4393. <p>
  4394. (<em>Appears on:</em>
  4395. <a href="#external-secrets.io/v1.DVLSProvider">DVLSProvider</a>)
  4396. </p>
  4397. <p>
  4398. <p>DVLSAuth defines the authentication method for the DVLS provider.</p>
  4399. </p>
  4400. <table>
  4401. <thead>
  4402. <tr>
  4403. <th>Field</th>
  4404. <th>Description</th>
  4405. </tr>
  4406. </thead>
  4407. <tbody>
  4408. <tr>
  4409. <td>
  4410. <code>secretRef</code></br>
  4411. <em>
  4412. <a href="#external-secrets.io/v1.DVLSAuthSecretRef">
  4413. DVLSAuthSecretRef
  4414. </a>
  4415. </em>
  4416. </td>
  4417. <td>
  4418. <p>SecretRef contains the Application ID and Application Secret for authentication.</p>
  4419. </td>
  4420. </tr>
  4421. </tbody>
  4422. </table>
  4423. <h3 id="external-secrets.io/v1.DVLSAuthSecretRef">DVLSAuthSecretRef
  4424. </h3>
  4425. <p>
  4426. (<em>Appears on:</em>
  4427. <a href="#external-secrets.io/v1.DVLSAuth">DVLSAuth</a>)
  4428. </p>
  4429. <p>
  4430. <p>DVLSAuthSecretRef defines the secret references for DVLS authentication credentials.</p>
  4431. </p>
  4432. <table>
  4433. <thead>
  4434. <tr>
  4435. <th>Field</th>
  4436. <th>Description</th>
  4437. </tr>
  4438. </thead>
  4439. <tbody>
  4440. <tr>
  4441. <td>
  4442. <code>appId</code></br>
  4443. <em>
  4444. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4445. External Secrets meta/v1.SecretKeySelector
  4446. </a>
  4447. </em>
  4448. </td>
  4449. <td>
  4450. <p>AppID is the reference to the secret containing the Application ID.</p>
  4451. </td>
  4452. </tr>
  4453. <tr>
  4454. <td>
  4455. <code>appSecret</code></br>
  4456. <em>
  4457. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4458. External Secrets meta/v1.SecretKeySelector
  4459. </a>
  4460. </em>
  4461. </td>
  4462. <td>
  4463. <p>AppSecret is the reference to the secret containing the Application Secret.</p>
  4464. </td>
  4465. </tr>
  4466. </tbody>
  4467. </table>
  4468. <h3 id="external-secrets.io/v1.DVLSProvider">DVLSProvider
  4469. </h3>
  4470. <p>
  4471. (<em>Appears on:</em>
  4472. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4473. </p>
  4474. <p>
  4475. <p>DVLSProvider configures a store to sync secrets using Devolutions Server.</p>
  4476. </p>
  4477. <table>
  4478. <thead>
  4479. <tr>
  4480. <th>Field</th>
  4481. <th>Description</th>
  4482. </tr>
  4483. </thead>
  4484. <tbody>
  4485. <tr>
  4486. <td>
  4487. <code>serverUrl</code></br>
  4488. <em>
  4489. string
  4490. </em>
  4491. </td>
  4492. <td>
  4493. <p>ServerURL is the DVLS instance URL (e.g., <a href="https://dvls.example.com">https://dvls.example.com</a>).</p>
  4494. </td>
  4495. </tr>
  4496. <tr>
  4497. <td>
  4498. <code>vault</code></br>
  4499. <em>
  4500. string
  4501. </em>
  4502. </td>
  4503. <td>
  4504. <em>(Optional)</em>
  4505. <p>Vault is the name or UUID of the vault to fetch secrets from.
  4506. When omitted, the vault must be specified in the secret key using the legacy format &ldquo;<vault-id>/<entry-id>&rdquo;.</p>
  4507. </td>
  4508. </tr>
  4509. <tr>
  4510. <td>
  4511. <code>insecure</code></br>
  4512. <em>
  4513. bool
  4514. </em>
  4515. </td>
  4516. <td>
  4517. <em>(Optional)</em>
  4518. <p>Insecure allows connecting to DVLS over plain HTTP.
  4519. This is NOT RECOMMENDED for production use.
  4520. Set to true only if you understand the security implications.</p>
  4521. </td>
  4522. </tr>
  4523. <tr>
  4524. <td>
  4525. <code>auth</code></br>
  4526. <em>
  4527. <a href="#external-secrets.io/v1.DVLSAuth">
  4528. DVLSAuth
  4529. </a>
  4530. </em>
  4531. </td>
  4532. <td>
  4533. <p>Auth defines the authentication method to use.</p>
  4534. </td>
  4535. </tr>
  4536. </tbody>
  4537. </table>
  4538. <h3 id="external-secrets.io/v1.DelineaProvider">DelineaProvider
  4539. </h3>
  4540. <p>
  4541. (<em>Appears on:</em>
  4542. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4543. </p>
  4544. <p>
  4545. <p>DelineaProvider provides access to Delinea secrets vault Server.
  4546. 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>
  4547. </p>
  4548. <table>
  4549. <thead>
  4550. <tr>
  4551. <th>Field</th>
  4552. <th>Description</th>
  4553. </tr>
  4554. </thead>
  4555. <tbody>
  4556. <tr>
  4557. <td>
  4558. <code>clientId</code></br>
  4559. <em>
  4560. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4561. DelineaProviderSecretRef
  4562. </a>
  4563. </em>
  4564. </td>
  4565. <td>
  4566. <p>ClientID is the non-secret part of the credential.</p>
  4567. </td>
  4568. </tr>
  4569. <tr>
  4570. <td>
  4571. <code>clientSecret</code></br>
  4572. <em>
  4573. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4574. DelineaProviderSecretRef
  4575. </a>
  4576. </em>
  4577. </td>
  4578. <td>
  4579. <p>ClientSecret is the secret part of the credential.</p>
  4580. </td>
  4581. </tr>
  4582. <tr>
  4583. <td>
  4584. <code>tenant</code></br>
  4585. <em>
  4586. string
  4587. </em>
  4588. </td>
  4589. <td>
  4590. <p>Tenant is the chosen hostname / site name.</p>
  4591. </td>
  4592. </tr>
  4593. <tr>
  4594. <td>
  4595. <code>urlTemplate</code></br>
  4596. <em>
  4597. string
  4598. </em>
  4599. </td>
  4600. <td>
  4601. <em>(Optional)</em>
  4602. <p>URLTemplate
  4603. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  4604. </td>
  4605. </tr>
  4606. <tr>
  4607. <td>
  4608. <code>tld</code></br>
  4609. <em>
  4610. string
  4611. </em>
  4612. </td>
  4613. <td>
  4614. <em>(Optional)</em>
  4615. <p>TLD is based on the server location that was chosen during provisioning.
  4616. If unset, defaults to &ldquo;com&rdquo;.</p>
  4617. </td>
  4618. </tr>
  4619. </tbody>
  4620. </table>
  4621. <h3 id="external-secrets.io/v1.DelineaProviderSecretRef">DelineaProviderSecretRef
  4622. </h3>
  4623. <p>
  4624. (<em>Appears on:</em>
  4625. <a href="#external-secrets.io/v1.DelineaProvider">DelineaProvider</a>)
  4626. </p>
  4627. <p>
  4628. <p>DelineaProviderSecretRef is a secret reference containing either a direct value or a reference to a secret key.</p>
  4629. </p>
  4630. <table>
  4631. <thead>
  4632. <tr>
  4633. <th>Field</th>
  4634. <th>Description</th>
  4635. </tr>
  4636. </thead>
  4637. <tbody>
  4638. <tr>
  4639. <td>
  4640. <code>value</code></br>
  4641. <em>
  4642. string
  4643. </em>
  4644. </td>
  4645. <td>
  4646. <em>(Optional)</em>
  4647. <p>Value can be specified directly to set a value without using a secret.</p>
  4648. </td>
  4649. </tr>
  4650. <tr>
  4651. <td>
  4652. <code>secretRef</code></br>
  4653. <em>
  4654. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4655. External Secrets meta/v1.SecretKeySelector
  4656. </a>
  4657. </em>
  4658. </td>
  4659. <td>
  4660. <em>(Optional)</em>
  4661. <p>SecretRef references a key in a secret that will be used as value.</p>
  4662. </td>
  4663. </tr>
  4664. </tbody>
  4665. </table>
  4666. <h3 id="external-secrets.io/v1.DopplerAuth">DopplerAuth
  4667. </h3>
  4668. <p>
  4669. (<em>Appears on:</em>
  4670. <a href="#external-secrets.io/v1.DopplerProvider">DopplerProvider</a>)
  4671. </p>
  4672. <p>
  4673. <p>DopplerAuth configures authentication with the Doppler API.
  4674. Exactly one of secretRef or oidcConfig must be specified.</p>
  4675. </p>
  4676. <table>
  4677. <thead>
  4678. <tr>
  4679. <th>Field</th>
  4680. <th>Description</th>
  4681. </tr>
  4682. </thead>
  4683. <tbody>
  4684. <tr>
  4685. <td>
  4686. <code>secretRef</code></br>
  4687. <em>
  4688. <a href="#external-secrets.io/v1.DopplerAuthSecretRef">
  4689. DopplerAuthSecretRef
  4690. </a>
  4691. </em>
  4692. </td>
  4693. <td>
  4694. <em>(Optional)</em>
  4695. <p>SecretRef authenticates using a Doppler service token stored in a Kubernetes Secret.</p>
  4696. </td>
  4697. </tr>
  4698. <tr>
  4699. <td>
  4700. <code>oidcConfig</code></br>
  4701. <em>
  4702. <a href="#external-secrets.io/v1.DopplerOIDCAuth">
  4703. DopplerOIDCAuth
  4704. </a>
  4705. </em>
  4706. </td>
  4707. <td>
  4708. <em>(Optional)</em>
  4709. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  4710. </td>
  4711. </tr>
  4712. </tbody>
  4713. </table>
  4714. <h3 id="external-secrets.io/v1.DopplerAuthSecretRef">DopplerAuthSecretRef
  4715. </h3>
  4716. <p>
  4717. (<em>Appears on:</em>
  4718. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  4719. </p>
  4720. <p>
  4721. <p>DopplerAuthSecretRef contains the secret reference for accessing the Doppler API.</p>
  4722. </p>
  4723. <table>
  4724. <thead>
  4725. <tr>
  4726. <th>Field</th>
  4727. <th>Description</th>
  4728. </tr>
  4729. </thead>
  4730. <tbody>
  4731. <tr>
  4732. <td>
  4733. <code>dopplerToken</code></br>
  4734. <em>
  4735. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4736. External Secrets meta/v1.SecretKeySelector
  4737. </a>
  4738. </em>
  4739. </td>
  4740. <td>
  4741. <p>The DopplerToken is used for authentication.
  4742. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  4743. The Key attribute defaults to dopplerToken if not specified.</p>
  4744. </td>
  4745. </tr>
  4746. </tbody>
  4747. </table>
  4748. <h3 id="external-secrets.io/v1.DopplerOIDCAuth">DopplerOIDCAuth
  4749. </h3>
  4750. <p>
  4751. (<em>Appears on:</em>
  4752. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  4753. </p>
  4754. <p>
  4755. <p>DopplerOIDCAuth configures OIDC authentication with Doppler using Kubernetes ServiceAccount tokens.</p>
  4756. </p>
  4757. <table>
  4758. <thead>
  4759. <tr>
  4760. <th>Field</th>
  4761. <th>Description</th>
  4762. </tr>
  4763. </thead>
  4764. <tbody>
  4765. <tr>
  4766. <td>
  4767. <code>identity</code></br>
  4768. <em>
  4769. string
  4770. </em>
  4771. </td>
  4772. <td>
  4773. <p>Identity is the Doppler Service Account Identity ID configured for OIDC authentication.</p>
  4774. </td>
  4775. </tr>
  4776. <tr>
  4777. <td>
  4778. <code>serviceAccountRef</code></br>
  4779. <em>
  4780. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  4781. External Secrets meta/v1.ServiceAccountSelector
  4782. </a>
  4783. </em>
  4784. </td>
  4785. <td>
  4786. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  4787. </td>
  4788. </tr>
  4789. <tr>
  4790. <td>
  4791. <code>expirationSeconds</code></br>
  4792. <em>
  4793. int64
  4794. </em>
  4795. </td>
  4796. <td>
  4797. <em>(Optional)</em>
  4798. <p>ExpirationSeconds sets the ServiceAccount token validity duration.
  4799. Defaults to 10 minutes.</p>
  4800. </td>
  4801. </tr>
  4802. </tbody>
  4803. </table>
  4804. <h3 id="external-secrets.io/v1.DopplerProvider">DopplerProvider
  4805. </h3>
  4806. <p>
  4807. (<em>Appears on:</em>
  4808. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4809. </p>
  4810. <p>
  4811. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  4812. Project and Config are required if not using a Service Token.</p>
  4813. </p>
  4814. <table>
  4815. <thead>
  4816. <tr>
  4817. <th>Field</th>
  4818. <th>Description</th>
  4819. </tr>
  4820. </thead>
  4821. <tbody>
  4822. <tr>
  4823. <td>
  4824. <code>auth</code></br>
  4825. <em>
  4826. <a href="#external-secrets.io/v1.DopplerAuth">
  4827. DopplerAuth
  4828. </a>
  4829. </em>
  4830. </td>
  4831. <td>
  4832. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  4833. </td>
  4834. </tr>
  4835. <tr>
  4836. <td>
  4837. <code>project</code></br>
  4838. <em>
  4839. string
  4840. </em>
  4841. </td>
  4842. <td>
  4843. <em>(Optional)</em>
  4844. <p>Doppler project (required if not using a Service Token)</p>
  4845. </td>
  4846. </tr>
  4847. <tr>
  4848. <td>
  4849. <code>config</code></br>
  4850. <em>
  4851. string
  4852. </em>
  4853. </td>
  4854. <td>
  4855. <em>(Optional)</em>
  4856. <p>Doppler config (required if not using a Service Token)</p>
  4857. </td>
  4858. </tr>
  4859. <tr>
  4860. <td>
  4861. <code>nameTransformer</code></br>
  4862. <em>
  4863. string
  4864. </em>
  4865. </td>
  4866. <td>
  4867. <em>(Optional)</em>
  4868. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  4869. </td>
  4870. </tr>
  4871. <tr>
  4872. <td>
  4873. <code>format</code></br>
  4874. <em>
  4875. string
  4876. </em>
  4877. </td>
  4878. <td>
  4879. <em>(Optional)</em>
  4880. <p>Format enables the downloading of secrets as a file (string)</p>
  4881. </td>
  4882. </tr>
  4883. </tbody>
  4884. </table>
  4885. <h3 id="external-secrets.io/v1.ExternalSecret">ExternalSecret
  4886. </h3>
  4887. <p>
  4888. <p>ExternalSecret is the Schema for the external-secrets API.
  4889. It defines how to fetch data from external APIs and make it available as Kubernetes Secrets.</p>
  4890. </p>
  4891. <table>
  4892. <thead>
  4893. <tr>
  4894. <th>Field</th>
  4895. <th>Description</th>
  4896. </tr>
  4897. </thead>
  4898. <tbody>
  4899. <tr>
  4900. <td>
  4901. <code>metadata</code></br>
  4902. <em>
  4903. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  4904. Kubernetes meta/v1.ObjectMeta
  4905. </a>
  4906. </em>
  4907. </td>
  4908. <td>
  4909. Refer to the Kubernetes API documentation for the fields of the
  4910. <code>metadata</code> field.
  4911. </td>
  4912. </tr>
  4913. <tr>
  4914. <td>
  4915. <code>spec</code></br>
  4916. <em>
  4917. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  4918. ExternalSecretSpec
  4919. </a>
  4920. </em>
  4921. </td>
  4922. <td>
  4923. <br/>
  4924. <br/>
  4925. <table>
  4926. <tr>
  4927. <td>
  4928. <code>secretStoreRef</code></br>
  4929. <em>
  4930. <a href="#external-secrets.io/v1.SecretStoreRef">
  4931. SecretStoreRef
  4932. </a>
  4933. </em>
  4934. </td>
  4935. <td>
  4936. <em>(Optional)</em>
  4937. </td>
  4938. </tr>
  4939. <tr>
  4940. <td>
  4941. <code>target</code></br>
  4942. <em>
  4943. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  4944. ExternalSecretTarget
  4945. </a>
  4946. </em>
  4947. </td>
  4948. <td>
  4949. <em>(Optional)</em>
  4950. </td>
  4951. </tr>
  4952. <tr>
  4953. <td>
  4954. <code>refreshPolicy</code></br>
  4955. <em>
  4956. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  4957. ExternalSecretRefreshPolicy
  4958. </a>
  4959. </em>
  4960. </td>
  4961. <td>
  4962. <em>(Optional)</em>
  4963. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  4964. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  4965. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  4966. No periodic updates occur if refreshInterval is 0.
  4967. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  4968. </td>
  4969. </tr>
  4970. <tr>
  4971. <td>
  4972. <code>refreshInterval</code></br>
  4973. <em>
  4974. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  4975. Kubernetes meta/v1.Duration
  4976. </a>
  4977. </em>
  4978. </td>
  4979. <td>
  4980. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  4981. specified as Golang Duration strings.
  4982. 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;
  4983. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  4984. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  4985. </td>
  4986. </tr>
  4987. <tr>
  4988. <td>
  4989. <code>data</code></br>
  4990. <em>
  4991. <a href="#external-secrets.io/v1.ExternalSecretData">
  4992. []ExternalSecretData
  4993. </a>
  4994. </em>
  4995. </td>
  4996. <td>
  4997. <em>(Optional)</em>
  4998. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  4999. </td>
  5000. </tr>
  5001. <tr>
  5002. <td>
  5003. <code>dataFrom</code></br>
  5004. <em>
  5005. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  5006. []ExternalSecretDataFromRemoteRef
  5007. </a>
  5008. </em>
  5009. </td>
  5010. <td>
  5011. <em>(Optional)</em>
  5012. <p>DataFrom is used to fetch all properties from a specific Provider data
  5013. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  5014. </td>
  5015. </tr>
  5016. </table>
  5017. </td>
  5018. </tr>
  5019. <tr>
  5020. <td>
  5021. <code>status</code></br>
  5022. <em>
  5023. <a href="#external-secrets.io/v1.ExternalSecretStatus">
  5024. ExternalSecretStatus
  5025. </a>
  5026. </em>
  5027. </td>
  5028. <td>
  5029. </td>
  5030. </tr>
  5031. </tbody>
  5032. </table>
  5033. <h3 id="external-secrets.io/v1.ExternalSecretConditionType">ExternalSecretConditionType
  5034. (<code>string</code> alias)</p></h3>
  5035. <p>
  5036. (<em>Appears on:</em>
  5037. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  5038. </p>
  5039. <p>
  5040. <p>ExternalSecretConditionType defines a value type for ExternalSecret conditions.</p>
  5041. </p>
  5042. <table>
  5043. <thead>
  5044. <tr>
  5045. <th>Value</th>
  5046. <th>Description</th>
  5047. </tr>
  5048. </thead>
  5049. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  5050. <td><p>ExternalSecretDeleted indicates that the external secret has been deleted.</p>
  5051. </td>
  5052. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  5053. <td><p>ExternalSecretReady indicates that the external secret is ready and synced.</p>
  5054. </td>
  5055. </tr></tbody>
  5056. </table>
  5057. <h3 id="external-secrets.io/v1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  5058. (<code>string</code> alias)</p></h3>
  5059. <p>
  5060. (<em>Appears on:</em>
  5061. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5062. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5063. </p>
  5064. <p>
  5065. <p>ExternalSecretConversionStrategy defines strategies for converting secret values.</p>
  5066. </p>
  5067. <table>
  5068. <thead>
  5069. <tr>
  5070. <th>Value</th>
  5071. <th>Description</th>
  5072. </tr>
  5073. </thead>
  5074. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  5075. <td><p>ExternalSecretConversionDefault specifies the default conversion strategy.</p>
  5076. </td>
  5077. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  5078. <td><p>ExternalSecretConversionUnicode specifies that values should be treated as Unicode.</p>
  5079. </td>
  5080. </tr></tbody>
  5081. </table>
  5082. <h3 id="external-secrets.io/v1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  5083. (<code>string</code> alias)</p></h3>
  5084. <p>
  5085. (<em>Appears on:</em>
  5086. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5087. </p>
  5088. <p>
  5089. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  5090. </p>
  5091. <table>
  5092. <thead>
  5093. <tr>
  5094. <th>Value</th>
  5095. <th>Description</th>
  5096. </tr>
  5097. </thead>
  5098. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  5099. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  5100. </td>
  5101. </tr><tr><td><p>&#34;None&#34;</p></td>
  5102. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  5103. </td>
  5104. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  5105. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  5106. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  5107. </td>
  5108. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  5109. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  5110. </td>
  5111. </tr></tbody>
  5112. </table>
  5113. <h3 id="external-secrets.io/v1.ExternalSecretData">ExternalSecretData
  5114. </h3>
  5115. <p>
  5116. (<em>Appears on:</em>
  5117. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5118. </p>
  5119. <p>
  5120. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  5121. </p>
  5122. <table>
  5123. <thead>
  5124. <tr>
  5125. <th>Field</th>
  5126. <th>Description</th>
  5127. </tr>
  5128. </thead>
  5129. <tbody>
  5130. <tr>
  5131. <td>
  5132. <code>secretKey</code></br>
  5133. <em>
  5134. string
  5135. </em>
  5136. </td>
  5137. <td>
  5138. <p>The key in the Kubernetes Secret to store the value.</p>
  5139. </td>
  5140. </tr>
  5141. <tr>
  5142. <td>
  5143. <code>remoteRef</code></br>
  5144. <em>
  5145. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5146. ExternalSecretDataRemoteRef
  5147. </a>
  5148. </em>
  5149. </td>
  5150. <td>
  5151. <p>RemoteRef points to the remote secret and defines
  5152. which secret (version/property/..) to fetch.</p>
  5153. </td>
  5154. </tr>
  5155. <tr>
  5156. <td>
  5157. <code>sourceRef</code></br>
  5158. <em>
  5159. <a href="#external-secrets.io/v1.StoreSourceRef">
  5160. StoreSourceRef
  5161. </a>
  5162. </em>
  5163. </td>
  5164. <td>
  5165. <p>SourceRef allows you to override the source
  5166. from which the value will be pulled.</p>
  5167. </td>
  5168. </tr>
  5169. </tbody>
  5170. </table>
  5171. <h3 id="external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  5172. </h3>
  5173. <p>
  5174. (<em>Appears on:</em>
  5175. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5176. </p>
  5177. <p>
  5178. <p>ExternalSecretDataFromRemoteRef defines the connection between the Kubernetes Secret keys and the Provider data
  5179. when using DataFrom to fetch multiple values from a Provider.</p>
  5180. </p>
  5181. <table>
  5182. <thead>
  5183. <tr>
  5184. <th>Field</th>
  5185. <th>Description</th>
  5186. </tr>
  5187. </thead>
  5188. <tbody>
  5189. <tr>
  5190. <td>
  5191. <code>extract</code></br>
  5192. <em>
  5193. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5194. ExternalSecretDataRemoteRef
  5195. </a>
  5196. </em>
  5197. </td>
  5198. <td>
  5199. <em>(Optional)</em>
  5200. <p>Used to extract multiple key/value pairs from one secret
  5201. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5202. </td>
  5203. </tr>
  5204. <tr>
  5205. <td>
  5206. <code>find</code></br>
  5207. <em>
  5208. <a href="#external-secrets.io/v1.ExternalSecretFind">
  5209. ExternalSecretFind
  5210. </a>
  5211. </em>
  5212. </td>
  5213. <td>
  5214. <em>(Optional)</em>
  5215. <p>Used to find secrets based on tags or regular expressions
  5216. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5217. </td>
  5218. </tr>
  5219. <tr>
  5220. <td>
  5221. <code>rewrite</code></br>
  5222. <em>
  5223. <a href="#external-secrets.io/v1.ExternalSecretRewrite">
  5224. []ExternalSecretRewrite
  5225. </a>
  5226. </em>
  5227. </td>
  5228. <td>
  5229. <em>(Optional)</em>
  5230. <p>Used to rewrite secret Keys after getting them from the secret Provider
  5231. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  5232. </td>
  5233. </tr>
  5234. <tr>
  5235. <td>
  5236. <code>sourceRef</code></br>
  5237. <em>
  5238. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">
  5239. StoreGeneratorSourceRef
  5240. </a>
  5241. </em>
  5242. </td>
  5243. <td>
  5244. <p>SourceRef points to a store or generator
  5245. which contains secret values ready to use.
  5246. Use this in combination with Extract or Find pull values out of
  5247. a specific SecretStore.
  5248. When sourceRef points to a generator Extract or Find is not supported.
  5249. The generator returns a static map of values</p>
  5250. </td>
  5251. </tr>
  5252. </tbody>
  5253. </table>
  5254. <h3 id="external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  5255. </h3>
  5256. <p>
  5257. (<em>Appears on:</em>
  5258. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>,
  5259. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5260. </p>
  5261. <p>
  5262. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  5263. </p>
  5264. <table>
  5265. <thead>
  5266. <tr>
  5267. <th>Field</th>
  5268. <th>Description</th>
  5269. </tr>
  5270. </thead>
  5271. <tbody>
  5272. <tr>
  5273. <td>
  5274. <code>key</code></br>
  5275. <em>
  5276. string
  5277. </em>
  5278. </td>
  5279. <td>
  5280. <p>Key is the key used in the Provider, mandatory</p>
  5281. </td>
  5282. </tr>
  5283. <tr>
  5284. <td>
  5285. <code>metadataPolicy</code></br>
  5286. <em>
  5287. <a href="#external-secrets.io/v1.ExternalSecretMetadataPolicy">
  5288. ExternalSecretMetadataPolicy
  5289. </a>
  5290. </em>
  5291. </td>
  5292. <td>
  5293. <em>(Optional)</em>
  5294. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  5295. </td>
  5296. </tr>
  5297. <tr>
  5298. <td>
  5299. <code>property</code></br>
  5300. <em>
  5301. string
  5302. </em>
  5303. </td>
  5304. <td>
  5305. <em>(Optional)</em>
  5306. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  5307. </td>
  5308. </tr>
  5309. <tr>
  5310. <td>
  5311. <code>version</code></br>
  5312. <em>
  5313. string
  5314. </em>
  5315. </td>
  5316. <td>
  5317. <em>(Optional)</em>
  5318. <p>Used to select a specific version of the Provider value, if supported</p>
  5319. </td>
  5320. </tr>
  5321. <tr>
  5322. <td>
  5323. <code>conversionStrategy</code></br>
  5324. <em>
  5325. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5326. ExternalSecretConversionStrategy
  5327. </a>
  5328. </em>
  5329. </td>
  5330. <td>
  5331. <em>(Optional)</em>
  5332. <p>Used to define a conversion Strategy</p>
  5333. </td>
  5334. </tr>
  5335. <tr>
  5336. <td>
  5337. <code>decodingStrategy</code></br>
  5338. <em>
  5339. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5340. ExternalSecretDecodingStrategy
  5341. </a>
  5342. </em>
  5343. </td>
  5344. <td>
  5345. <em>(Optional)</em>
  5346. <p>Used to define a decoding Strategy</p>
  5347. </td>
  5348. </tr>
  5349. <tr>
  5350. <td>
  5351. <code>nullBytePolicy</code></br>
  5352. <em>
  5353. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  5354. ExternalSecretNullBytePolicy
  5355. </a>
  5356. </em>
  5357. </td>
  5358. <td>
  5359. <em>(Optional)</em>
  5360. <p>Controls how ESO handles fetched secret data containing NUL bytes for this source.</p>
  5361. </td>
  5362. </tr>
  5363. </tbody>
  5364. </table>
  5365. <h3 id="external-secrets.io/v1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  5366. (<code>string</code> alias)</p></h3>
  5367. <p>
  5368. (<em>Appears on:</em>
  5369. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5370. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5371. </p>
  5372. <p>
  5373. <p>ExternalSecretDecodingStrategy defines strategies for decoding secret values.</p>
  5374. </p>
  5375. <table>
  5376. <thead>
  5377. <tr>
  5378. <th>Value</th>
  5379. <th>Description</th>
  5380. </tr>
  5381. </thead>
  5382. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  5383. <td><p>ExternalSecretDecodeAuto specifies automatic detection of the decoding method.</p>
  5384. </td>
  5385. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  5386. <td><p>ExternalSecretDecodeBase64 specifies that values should be decoded using Base64.</p>
  5387. </td>
  5388. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  5389. <td><p>ExternalSecretDecodeBase64URL specifies that values should be decoded using Base64URL.</p>
  5390. </td>
  5391. </tr><tr><td><p>&#34;None&#34;</p></td>
  5392. <td><p>ExternalSecretDecodeNone specifies that no decoding should be performed.</p>
  5393. </td>
  5394. </tr></tbody>
  5395. </table>
  5396. <h3 id="external-secrets.io/v1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  5397. (<code>string</code> alias)</p></h3>
  5398. <p>
  5399. (<em>Appears on:</em>
  5400. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5401. </p>
  5402. <p>
  5403. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  5404. </p>
  5405. <table>
  5406. <thead>
  5407. <tr>
  5408. <th>Value</th>
  5409. <th>Description</th>
  5410. </tr>
  5411. </thead>
  5412. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  5413. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  5414. If a secret gets deleted on the provider side and is not accessible
  5415. anymore this is not considered an error and the ExternalSecret
  5416. does not go into SecretSyncedError status.</p>
  5417. </td>
  5418. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  5419. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  5420. If a secret gets deleted on the provider side and is not accessible
  5421. anymore this is not considered an error and the ExternalSecret
  5422. does not go into SecretSyncedError status.</p>
  5423. </td>
  5424. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  5425. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  5426. If a provider secret does not exist the ExternalSecret gets into the
  5427. SecretSyncedError status.</p>
  5428. </td>
  5429. </tr></tbody>
  5430. </table>
  5431. <h3 id="external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind
  5432. </h3>
  5433. <p>
  5434. (<em>Appears on:</em>
  5435. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5436. </p>
  5437. <p>
  5438. <p>ExternalSecretFind defines configuration for finding secrets in the provider.</p>
  5439. </p>
  5440. <table>
  5441. <thead>
  5442. <tr>
  5443. <th>Field</th>
  5444. <th>Description</th>
  5445. </tr>
  5446. </thead>
  5447. <tbody>
  5448. <tr>
  5449. <td>
  5450. <code>path</code></br>
  5451. <em>
  5452. string
  5453. </em>
  5454. </td>
  5455. <td>
  5456. <em>(Optional)</em>
  5457. <p>A root path to start the find operations.</p>
  5458. </td>
  5459. </tr>
  5460. <tr>
  5461. <td>
  5462. <code>name</code></br>
  5463. <em>
  5464. <a href="#external-secrets.io/v1.FindName">
  5465. FindName
  5466. </a>
  5467. </em>
  5468. </td>
  5469. <td>
  5470. <em>(Optional)</em>
  5471. <p>Finds secrets based on the name.</p>
  5472. </td>
  5473. </tr>
  5474. <tr>
  5475. <td>
  5476. <code>tags</code></br>
  5477. <em>
  5478. map[string]string
  5479. </em>
  5480. </td>
  5481. <td>
  5482. <em>(Optional)</em>
  5483. <p>Find secrets based on tags.</p>
  5484. </td>
  5485. </tr>
  5486. <tr>
  5487. <td>
  5488. <code>conversionStrategy</code></br>
  5489. <em>
  5490. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5491. ExternalSecretConversionStrategy
  5492. </a>
  5493. </em>
  5494. </td>
  5495. <td>
  5496. <em>(Optional)</em>
  5497. <p>Used to define a conversion Strategy</p>
  5498. </td>
  5499. </tr>
  5500. <tr>
  5501. <td>
  5502. <code>decodingStrategy</code></br>
  5503. <em>
  5504. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5505. ExternalSecretDecodingStrategy
  5506. </a>
  5507. </em>
  5508. </td>
  5509. <td>
  5510. <em>(Optional)</em>
  5511. <p>Used to define a decoding Strategy</p>
  5512. </td>
  5513. </tr>
  5514. <tr>
  5515. <td>
  5516. <code>nullBytePolicy</code></br>
  5517. <em>
  5518. <a href="#external-secrets.io/v1.ExternalSecretNullBytePolicy">
  5519. ExternalSecretNullBytePolicy
  5520. </a>
  5521. </em>
  5522. </td>
  5523. <td>
  5524. <em>(Optional)</em>
  5525. <p>Controls how ESO handles fetched secret data containing NUL bytes for this find source.</p>
  5526. </td>
  5527. </tr>
  5528. </tbody>
  5529. </table>
  5530. <h3 id="external-secrets.io/v1.ExternalSecretMetadata">ExternalSecretMetadata
  5531. </h3>
  5532. <p>
  5533. (<em>Appears on:</em>
  5534. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  5535. </p>
  5536. <p>
  5537. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  5538. </p>
  5539. <table>
  5540. <thead>
  5541. <tr>
  5542. <th>Field</th>
  5543. <th>Description</th>
  5544. </tr>
  5545. </thead>
  5546. <tbody>
  5547. <tr>
  5548. <td>
  5549. <code>annotations</code></br>
  5550. <em>
  5551. map[string]string
  5552. </em>
  5553. </td>
  5554. <td>
  5555. <em>(Optional)</em>
  5556. </td>
  5557. </tr>
  5558. <tr>
  5559. <td>
  5560. <code>labels</code></br>
  5561. <em>
  5562. map[string]string
  5563. </em>
  5564. </td>
  5565. <td>
  5566. <em>(Optional)</em>
  5567. </td>
  5568. </tr>
  5569. </tbody>
  5570. </table>
  5571. <h3 id="external-secrets.io/v1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  5572. (<code>string</code> alias)</p></h3>
  5573. <p>
  5574. (<em>Appears on:</em>
  5575. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  5576. </p>
  5577. <p>
  5578. <p>ExternalSecretMetadataPolicy defines policies for fetching metadata from provider secrets.</p>
  5579. </p>
  5580. <table>
  5581. <thead>
  5582. <tr>
  5583. <th>Value</th>
  5584. <th>Description</th>
  5585. </tr>
  5586. </thead>
  5587. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  5588. <td><p>ExternalSecretMetadataPolicyFetch specifies that metadata should be fetched from the provider.</p>
  5589. </td>
  5590. </tr><tr><td><p>&#34;None&#34;</p></td>
  5591. <td><p>ExternalSecretMetadataPolicyNone specifies that no metadata should be fetched from the provider.</p>
  5592. </td>
  5593. </tr></tbody>
  5594. </table>
  5595. <h3 id="external-secrets.io/v1.ExternalSecretNullBytePolicy">ExternalSecretNullBytePolicy
  5596. (<code>string</code> alias)</p></h3>
  5597. <p>
  5598. (<em>Appears on:</em>
  5599. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5600. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5601. </p>
  5602. <p>
  5603. <p>ExternalSecretNullBytePolicy defines how fetched secret data containing NUL bytes should be handled.</p>
  5604. </p>
  5605. <table>
  5606. <thead>
  5607. <tr>
  5608. <th>Value</th>
  5609. <th>Description</th>
  5610. </tr>
  5611. </thead>
  5612. <tbody><tr><td><p>&#34;Fail&#34;</p></td>
  5613. <td><p>ExternalSecretNullBytePolicyFail fails reconciliation if fetched secret data contains NUL bytes.</p>
  5614. </td>
  5615. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  5616. <td><p>ExternalSecretNullBytePolicyIgnore allows fetched secret data to contain NUL bytes.</p>
  5617. </td>
  5618. </tr></tbody>
  5619. </table>
  5620. <h3 id="external-secrets.io/v1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  5621. (<code>string</code> alias)</p></h3>
  5622. <p>
  5623. (<em>Appears on:</em>
  5624. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5625. </p>
  5626. <p>
  5627. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  5628. </p>
  5629. <table>
  5630. <thead>
  5631. <tr>
  5632. <th>Value</th>
  5633. <th>Description</th>
  5634. </tr>
  5635. </thead>
  5636. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  5637. <td><p>RefreshPolicyCreatedOnce creates the Secret once and does not update it thereafter.</p>
  5638. </td>
  5639. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  5640. <td><p>RefreshPolicyOnChange only synchronizes when the ExternalSecret&rsquo;s metadata or spec changes.</p>
  5641. </td>
  5642. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  5643. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the provider at regular intervals.</p>
  5644. </td>
  5645. </tr></tbody>
  5646. </table>
  5647. <h3 id="external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite
  5648. </h3>
  5649. <p>
  5650. (<em>Appears on:</em>
  5651. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5652. </p>
  5653. <p>
  5654. <p>ExternalSecretRewrite defines how to rewrite secret data values before they are written to the Secret.</p>
  5655. </p>
  5656. <table>
  5657. <thead>
  5658. <tr>
  5659. <th>Field</th>
  5660. <th>Description</th>
  5661. </tr>
  5662. </thead>
  5663. <tbody>
  5664. <tr>
  5665. <td>
  5666. <code>merge</code></br>
  5667. <em>
  5668. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">
  5669. ExternalSecretRewriteMerge
  5670. </a>
  5671. </em>
  5672. </td>
  5673. <td>
  5674. <em>(Optional)</em>
  5675. <p>Used to merge key/values in one single Secret
  5676. The resulting key will contain all values from the specified secrets</p>
  5677. </td>
  5678. </tr>
  5679. <tr>
  5680. <td>
  5681. <code>regexp</code></br>
  5682. <em>
  5683. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  5684. ExternalSecretRewriteRegexp
  5685. </a>
  5686. </em>
  5687. </td>
  5688. <td>
  5689. <em>(Optional)</em>
  5690. <p>Used to rewrite with regular expressions.
  5691. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  5692. </td>
  5693. </tr>
  5694. <tr>
  5695. <td>
  5696. <code>transform</code></br>
  5697. <em>
  5698. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  5699. ExternalSecretRewriteTransform
  5700. </a>
  5701. </em>
  5702. </td>
  5703. <td>
  5704. <em>(Optional)</em>
  5705. <p>Used to apply string transformation on the secrets.
  5706. The resulting key will be the output of the template applied by the operation.</p>
  5707. </td>
  5708. </tr>
  5709. </tbody>
  5710. </table>
  5711. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge
  5712. </h3>
  5713. <p>
  5714. (<em>Appears on:</em>
  5715. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  5716. </p>
  5717. <p>
  5718. <p>ExternalSecretRewriteMerge defines configuration for merging secret values.</p>
  5719. </p>
  5720. <table>
  5721. <thead>
  5722. <tr>
  5723. <th>Field</th>
  5724. <th>Description</th>
  5725. </tr>
  5726. </thead>
  5727. <tbody>
  5728. <tr>
  5729. <td>
  5730. <code>into</code></br>
  5731. <em>
  5732. string
  5733. </em>
  5734. </td>
  5735. <td>
  5736. <em>(Optional)</em>
  5737. <p>Used to define the target key of the merge operation.
  5738. Required if strategy is JSON. Ignored otherwise.</p>
  5739. </td>
  5740. </tr>
  5741. <tr>
  5742. <td>
  5743. <code>priority</code></br>
  5744. <em>
  5745. []string
  5746. </em>
  5747. </td>
  5748. <td>
  5749. <em>(Optional)</em>
  5750. <p>Used to define key priority in conflict resolution.</p>
  5751. </td>
  5752. </tr>
  5753. <tr>
  5754. <td>
  5755. <code>priorityPolicy</code></br>
  5756. <em>
  5757. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">
  5758. ExternalSecretRewriteMergePriorityPolicy
  5759. </a>
  5760. </em>
  5761. </td>
  5762. <td>
  5763. <em>(Optional)</em>
  5764. <p>Used to define the policy when a key in the priority list does not exist in the input.</p>
  5765. </td>
  5766. </tr>
  5767. <tr>
  5768. <td>
  5769. <code>conflictPolicy</code></br>
  5770. <em>
  5771. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">
  5772. ExternalSecretRewriteMergeConflictPolicy
  5773. </a>
  5774. </em>
  5775. </td>
  5776. <td>
  5777. <em>(Optional)</em>
  5778. <p>Used to define the policy to use in conflict resolution.</p>
  5779. </td>
  5780. </tr>
  5781. <tr>
  5782. <td>
  5783. <code>strategy</code></br>
  5784. <em>
  5785. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">
  5786. ExternalSecretRewriteMergeStrategy
  5787. </a>
  5788. </em>
  5789. </td>
  5790. <td>
  5791. <em>(Optional)</em>
  5792. <p>Used to define the strategy to use in the merge operation.</p>
  5793. </td>
  5794. </tr>
  5795. </tbody>
  5796. </table>
  5797. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">ExternalSecretRewriteMergeConflictPolicy
  5798. (<code>string</code> alias)</p></h3>
  5799. <p>
  5800. (<em>Appears on:</em>
  5801. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  5802. </p>
  5803. <p>
  5804. <p>ExternalSecretRewriteMergeConflictPolicy defines the policy for resolving conflicts when merging secrets.</p>
  5805. </p>
  5806. <table>
  5807. <thead>
  5808. <tr>
  5809. <th>Value</th>
  5810. <th>Description</th>
  5811. </tr>
  5812. </thead>
  5813. <tbody><tr><td><p>&#34;Error&#34;</p></td>
  5814. <td><p>ExternalSecretRewriteMergeConflictPolicyError returns an error when conflicts occur during merge.</p>
  5815. </td>
  5816. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  5817. <td><p>ExternalSecretRewriteMergeConflictPolicyIgnore ignores conflicts when merging secret values.</p>
  5818. </td>
  5819. </tr></tbody>
  5820. </table>
  5821. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">ExternalSecretRewriteMergePriorityPolicy
  5822. (<code>string</code> alias)</p></h3>
  5823. <p>
  5824. (<em>Appears on:</em>
  5825. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  5826. </p>
  5827. <p>
  5828. <p>ExternalSecretRewriteMergePriorityPolicy defines the policy for handling missing keys in the priority
  5829. list during merge operations.</p>
  5830. </p>
  5831. <table>
  5832. <thead>
  5833. <tr>
  5834. <th>Value</th>
  5835. <th>Description</th>
  5836. </tr>
  5837. </thead>
  5838. <tbody><tr><td><p>&#34;IgnoreNotFound&#34;</p></td>
  5839. <td></td>
  5840. </tr><tr><td><p>&#34;Strict&#34;</p></td>
  5841. <td></td>
  5842. </tr></tbody>
  5843. </table>
  5844. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">ExternalSecretRewriteMergeStrategy
  5845. (<code>string</code> alias)</p></h3>
  5846. <p>
  5847. (<em>Appears on:</em>
  5848. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  5849. </p>
  5850. <p>
  5851. <p>ExternalSecretRewriteMergeStrategy defines the strategy for merging secrets.</p>
  5852. </p>
  5853. <table>
  5854. <thead>
  5855. <tr>
  5856. <th>Value</th>
  5857. <th>Description</th>
  5858. </tr>
  5859. </thead>
  5860. <tbody><tr><td><p>&#34;Extract&#34;</p></td>
  5861. <td><p>ExternalSecretRewriteMergeStrategyExtract merges secrets by extracting values.</p>
  5862. </td>
  5863. </tr><tr><td><p>&#34;JSON&#34;</p></td>
  5864. <td><p>ExternalSecretRewriteMergeStrategyJSON merges secrets using JSON merge strategy.</p>
  5865. </td>
  5866. </tr></tbody>
  5867. </table>
  5868. <h3 id="external-secrets.io/v1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  5869. </h3>
  5870. <p>
  5871. (<em>Appears on:</em>
  5872. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  5873. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  5874. </p>
  5875. <p>
  5876. <p>ExternalSecretRewriteRegexp defines configuration for rewriting secrets using regular expressions.</p>
  5877. </p>
  5878. <table>
  5879. <thead>
  5880. <tr>
  5881. <th>Field</th>
  5882. <th>Description</th>
  5883. </tr>
  5884. </thead>
  5885. <tbody>
  5886. <tr>
  5887. <td>
  5888. <code>source</code></br>
  5889. <em>
  5890. string
  5891. </em>
  5892. </td>
  5893. <td>
  5894. <p>Used to define the regular expression of a re.Compiler.</p>
  5895. </td>
  5896. </tr>
  5897. <tr>
  5898. <td>
  5899. <code>target</code></br>
  5900. <em>
  5901. string
  5902. </em>
  5903. </td>
  5904. <td>
  5905. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  5906. </td>
  5907. </tr>
  5908. </tbody>
  5909. </table>
  5910. <h3 id="external-secrets.io/v1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  5911. </h3>
  5912. <p>
  5913. (<em>Appears on:</em>
  5914. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>,
  5915. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite</a>)
  5916. </p>
  5917. <p>
  5918. <p>ExternalSecretRewriteTransform defines configuration for transforming secrets using templates.</p>
  5919. </p>
  5920. <table>
  5921. <thead>
  5922. <tr>
  5923. <th>Field</th>
  5924. <th>Description</th>
  5925. </tr>
  5926. </thead>
  5927. <tbody>
  5928. <tr>
  5929. <td>
  5930. <code>template</code></br>
  5931. <em>
  5932. string
  5933. </em>
  5934. </td>
  5935. <td>
  5936. <p>Used to define the template to apply on the secret name.
  5937. <code>.value</code> will specify the secret name in the template.</p>
  5938. </td>
  5939. </tr>
  5940. </tbody>
  5941. </table>
  5942. <h3 id="external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec
  5943. </h3>
  5944. <p>
  5945. (<em>Appears on:</em>
  5946. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  5947. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  5948. </p>
  5949. <p>
  5950. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  5951. </p>
  5952. <table>
  5953. <thead>
  5954. <tr>
  5955. <th>Field</th>
  5956. <th>Description</th>
  5957. </tr>
  5958. </thead>
  5959. <tbody>
  5960. <tr>
  5961. <td>
  5962. <code>secretStoreRef</code></br>
  5963. <em>
  5964. <a href="#external-secrets.io/v1.SecretStoreRef">
  5965. SecretStoreRef
  5966. </a>
  5967. </em>
  5968. </td>
  5969. <td>
  5970. <em>(Optional)</em>
  5971. </td>
  5972. </tr>
  5973. <tr>
  5974. <td>
  5975. <code>target</code></br>
  5976. <em>
  5977. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  5978. ExternalSecretTarget
  5979. </a>
  5980. </em>
  5981. </td>
  5982. <td>
  5983. <em>(Optional)</em>
  5984. </td>
  5985. </tr>
  5986. <tr>
  5987. <td>
  5988. <code>refreshPolicy</code></br>
  5989. <em>
  5990. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  5991. ExternalSecretRefreshPolicy
  5992. </a>
  5993. </em>
  5994. </td>
  5995. <td>
  5996. <em>(Optional)</em>
  5997. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  5998. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  5999. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  6000. No periodic updates occur if refreshInterval is 0.
  6001. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  6002. </td>
  6003. </tr>
  6004. <tr>
  6005. <td>
  6006. <code>refreshInterval</code></br>
  6007. <em>
  6008. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  6009. Kubernetes meta/v1.Duration
  6010. </a>
  6011. </em>
  6012. </td>
  6013. <td>
  6014. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  6015. specified as Golang Duration strings.
  6016. 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;
  6017. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  6018. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  6019. </td>
  6020. </tr>
  6021. <tr>
  6022. <td>
  6023. <code>data</code></br>
  6024. <em>
  6025. <a href="#external-secrets.io/v1.ExternalSecretData">
  6026. []ExternalSecretData
  6027. </a>
  6028. </em>
  6029. </td>
  6030. <td>
  6031. <em>(Optional)</em>
  6032. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  6033. </td>
  6034. </tr>
  6035. <tr>
  6036. <td>
  6037. <code>dataFrom</code></br>
  6038. <em>
  6039. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  6040. []ExternalSecretDataFromRemoteRef
  6041. </a>
  6042. </em>
  6043. </td>
  6044. <td>
  6045. <em>(Optional)</em>
  6046. <p>DataFrom is used to fetch all properties from a specific Provider data
  6047. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  6048. </td>
  6049. </tr>
  6050. </tbody>
  6051. </table>
  6052. <h3 id="external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus
  6053. </h3>
  6054. <p>
  6055. (<em>Appears on:</em>
  6056. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  6057. </p>
  6058. <p>
  6059. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  6060. </p>
  6061. <table>
  6062. <thead>
  6063. <tr>
  6064. <th>Field</th>
  6065. <th>Description</th>
  6066. </tr>
  6067. </thead>
  6068. <tbody>
  6069. <tr>
  6070. <td>
  6071. <code>refreshTime</code></br>
  6072. <em>
  6073. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6074. Kubernetes meta/v1.Time
  6075. </a>
  6076. </em>
  6077. </td>
  6078. <td>
  6079. <p>refreshTime is the time and date the external secret was fetched and
  6080. the target secret updated</p>
  6081. </td>
  6082. </tr>
  6083. <tr>
  6084. <td>
  6085. <code>syncedResourceVersion</code></br>
  6086. <em>
  6087. string
  6088. </em>
  6089. </td>
  6090. <td>
  6091. <p>SyncedResourceVersion keeps track of the last synced version</p>
  6092. </td>
  6093. </tr>
  6094. <tr>
  6095. <td>
  6096. <code>conditions</code></br>
  6097. <em>
  6098. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">
  6099. []ExternalSecretStatusCondition
  6100. </a>
  6101. </em>
  6102. </td>
  6103. <td>
  6104. <em>(Optional)</em>
  6105. </td>
  6106. </tr>
  6107. <tr>
  6108. <td>
  6109. <code>binding</code></br>
  6110. <em>
  6111. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  6112. Kubernetes core/v1.LocalObjectReference
  6113. </a>
  6114. </em>
  6115. </td>
  6116. <td>
  6117. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  6118. </td>
  6119. </tr>
  6120. </tbody>
  6121. </table>
  6122. <h3 id="external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  6123. </h3>
  6124. <p>
  6125. (<em>Appears on:</em>
  6126. <a href="#external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus</a>)
  6127. </p>
  6128. <p>
  6129. <p>ExternalSecretStatusCondition defines a status condition of an ExternalSecret resource.</p>
  6130. </p>
  6131. <table>
  6132. <thead>
  6133. <tr>
  6134. <th>Field</th>
  6135. <th>Description</th>
  6136. </tr>
  6137. </thead>
  6138. <tbody>
  6139. <tr>
  6140. <td>
  6141. <code>type</code></br>
  6142. <em>
  6143. <a href="#external-secrets.io/v1.ExternalSecretConditionType">
  6144. ExternalSecretConditionType
  6145. </a>
  6146. </em>
  6147. </td>
  6148. <td>
  6149. </td>
  6150. </tr>
  6151. <tr>
  6152. <td>
  6153. <code>status</code></br>
  6154. <em>
  6155. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  6156. Kubernetes core/v1.ConditionStatus
  6157. </a>
  6158. </em>
  6159. </td>
  6160. <td>
  6161. </td>
  6162. </tr>
  6163. <tr>
  6164. <td>
  6165. <code>reason</code></br>
  6166. <em>
  6167. string
  6168. </em>
  6169. </td>
  6170. <td>
  6171. <em>(Optional)</em>
  6172. </td>
  6173. </tr>
  6174. <tr>
  6175. <td>
  6176. <code>message</code></br>
  6177. <em>
  6178. string
  6179. </em>
  6180. </td>
  6181. <td>
  6182. <em>(Optional)</em>
  6183. </td>
  6184. </tr>
  6185. <tr>
  6186. <td>
  6187. <code>lastTransitionTime</code></br>
  6188. <em>
  6189. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6190. Kubernetes meta/v1.Time
  6191. </a>
  6192. </em>
  6193. </td>
  6194. <td>
  6195. <em>(Optional)</em>
  6196. </td>
  6197. </tr>
  6198. </tbody>
  6199. </table>
  6200. <h3 id="external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget
  6201. </h3>
  6202. <p>
  6203. (<em>Appears on:</em>
  6204. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6205. </p>
  6206. <p>
  6207. <p>ExternalSecretTarget defines the Kubernetes Secret to be created,
  6208. there can be only one target per ExternalSecret.</p>
  6209. </p>
  6210. <table>
  6211. <thead>
  6212. <tr>
  6213. <th>Field</th>
  6214. <th>Description</th>
  6215. </tr>
  6216. </thead>
  6217. <tbody>
  6218. <tr>
  6219. <td>
  6220. <code>name</code></br>
  6221. <em>
  6222. string
  6223. </em>
  6224. </td>
  6225. <td>
  6226. <em>(Optional)</em>
  6227. <p>The name of the Secret resource to be managed.
  6228. Defaults to the .metadata.name of the ExternalSecret resource</p>
  6229. </td>
  6230. </tr>
  6231. <tr>
  6232. <td>
  6233. <code>creationPolicy</code></br>
  6234. <em>
  6235. <a href="#external-secrets.io/v1.ExternalSecretCreationPolicy">
  6236. ExternalSecretCreationPolicy
  6237. </a>
  6238. </em>
  6239. </td>
  6240. <td>
  6241. <em>(Optional)</em>
  6242. <p>CreationPolicy defines rules on how to create the resulting Secret.
  6243. Defaults to &ldquo;Owner&rdquo;</p>
  6244. </td>
  6245. </tr>
  6246. <tr>
  6247. <td>
  6248. <code>deletionPolicy</code></br>
  6249. <em>
  6250. <a href="#external-secrets.io/v1.ExternalSecretDeletionPolicy">
  6251. ExternalSecretDeletionPolicy
  6252. </a>
  6253. </em>
  6254. </td>
  6255. <td>
  6256. <em>(Optional)</em>
  6257. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  6258. Defaults to &ldquo;Retain&rdquo;</p>
  6259. </td>
  6260. </tr>
  6261. <tr>
  6262. <td>
  6263. <code>template</code></br>
  6264. <em>
  6265. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  6266. ExternalSecretTemplate
  6267. </a>
  6268. </em>
  6269. </td>
  6270. <td>
  6271. <em>(Optional)</em>
  6272. <p>Template defines a blueprint for the created Secret resource.</p>
  6273. </td>
  6274. </tr>
  6275. <tr>
  6276. <td>
  6277. <code>manifest</code></br>
  6278. <em>
  6279. <a href="#external-secrets.io/v1.ManifestReference">
  6280. ManifestReference
  6281. </a>
  6282. </em>
  6283. </td>
  6284. <td>
  6285. <em>(Optional)</em>
  6286. <p>Manifest defines a custom Kubernetes resource to create instead of a Secret.
  6287. When specified, ExternalSecret will create the resource type defined here
  6288. (e.g., ConfigMap, Custom Resource) instead of a Secret.
  6289. Warning: Using Generic target. Make sure access policies and encryption are properly configured.</p>
  6290. </td>
  6291. </tr>
  6292. <tr>
  6293. <td>
  6294. <code>immutable</code></br>
  6295. <em>
  6296. bool
  6297. </em>
  6298. </td>
  6299. <td>
  6300. <em>(Optional)</em>
  6301. <p>Immutable defines if the final secret will be immutable</p>
  6302. </td>
  6303. </tr>
  6304. </tbody>
  6305. </table>
  6306. <h3 id="external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate
  6307. </h3>
  6308. <p>
  6309. (<em>Appears on:</em>
  6310. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>,
  6311. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  6312. </p>
  6313. <p>
  6314. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  6315. 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>
  6316. </p>
  6317. <table>
  6318. <thead>
  6319. <tr>
  6320. <th>Field</th>
  6321. <th>Description</th>
  6322. </tr>
  6323. </thead>
  6324. <tbody>
  6325. <tr>
  6326. <td>
  6327. <code>type</code></br>
  6328. <em>
  6329. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  6330. Kubernetes core/v1.SecretType
  6331. </a>
  6332. </em>
  6333. </td>
  6334. <td>
  6335. <em>(Optional)</em>
  6336. </td>
  6337. </tr>
  6338. <tr>
  6339. <td>
  6340. <code>engineVersion</code></br>
  6341. <em>
  6342. <a href="#external-secrets.io/v1.TemplateEngineVersion">
  6343. TemplateEngineVersion
  6344. </a>
  6345. </em>
  6346. </td>
  6347. <td>
  6348. <p>EngineVersion specifies the template engine version
  6349. that should be used to compile/execute the
  6350. template specified in .data and .templateFrom[].</p>
  6351. </td>
  6352. </tr>
  6353. <tr>
  6354. <td>
  6355. <code>metadata</code></br>
  6356. <em>
  6357. <a href="#external-secrets.io/v1.ExternalSecretTemplateMetadata">
  6358. ExternalSecretTemplateMetadata
  6359. </a>
  6360. </em>
  6361. </td>
  6362. <td>
  6363. <em>(Optional)</em>
  6364. </td>
  6365. </tr>
  6366. <tr>
  6367. <td>
  6368. <code>mergePolicy</code></br>
  6369. <em>
  6370. <a href="#external-secrets.io/v1.TemplateMergePolicy">
  6371. TemplateMergePolicy
  6372. </a>
  6373. </em>
  6374. </td>
  6375. <td>
  6376. </td>
  6377. </tr>
  6378. <tr>
  6379. <td>
  6380. <code>data</code></br>
  6381. <em>
  6382. map[string]string
  6383. </em>
  6384. </td>
  6385. <td>
  6386. <em>(Optional)</em>
  6387. </td>
  6388. </tr>
  6389. <tr>
  6390. <td>
  6391. <code>templateFrom</code></br>
  6392. <em>
  6393. <a href="#external-secrets.io/v1.TemplateFrom">
  6394. []TemplateFrom
  6395. </a>
  6396. </em>
  6397. </td>
  6398. <td>
  6399. <em>(Optional)</em>
  6400. </td>
  6401. </tr>
  6402. </tbody>
  6403. </table>
  6404. <h3 id="external-secrets.io/v1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  6405. </h3>
  6406. <p>
  6407. (<em>Appears on:</em>
  6408. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  6409. </p>
  6410. <p>
  6411. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  6412. </p>
  6413. <table>
  6414. <thead>
  6415. <tr>
  6416. <th>Field</th>
  6417. <th>Description</th>
  6418. </tr>
  6419. </thead>
  6420. <tbody>
  6421. <tr>
  6422. <td>
  6423. <code>annotations</code></br>
  6424. <em>
  6425. map[string]string
  6426. </em>
  6427. </td>
  6428. <td>
  6429. <em>(Optional)</em>
  6430. </td>
  6431. </tr>
  6432. <tr>
  6433. <td>
  6434. <code>labels</code></br>
  6435. <em>
  6436. map[string]string
  6437. </em>
  6438. </td>
  6439. <td>
  6440. <em>(Optional)</em>
  6441. </td>
  6442. </tr>
  6443. <tr>
  6444. <td>
  6445. <code>finalizers</code></br>
  6446. <em>
  6447. []string
  6448. </em>
  6449. </td>
  6450. <td>
  6451. <em>(Optional)</em>
  6452. </td>
  6453. </tr>
  6454. </tbody>
  6455. </table>
  6456. <h3 id="external-secrets.io/v1.ExternalSecretValidator">ExternalSecretValidator
  6457. </h3>
  6458. <p>
  6459. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  6460. </p>
  6461. <h3 id="external-secrets.io/v1.FakeProvider">FakeProvider
  6462. </h3>
  6463. <p>
  6464. (<em>Appears on:</em>
  6465. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  6466. </p>
  6467. <p>
  6468. <p>FakeProvider configures a fake provider that returns static values.</p>
  6469. </p>
  6470. <table>
  6471. <thead>
  6472. <tr>
  6473. <th>Field</th>
  6474. <th>Description</th>
  6475. </tr>
  6476. </thead>
  6477. <tbody>
  6478. <tr>
  6479. <td>
  6480. <code>data</code></br>
  6481. <em>
  6482. <a href="#external-secrets.io/v1.FakeProviderData">
  6483. []FakeProviderData
  6484. </a>
  6485. </em>
  6486. </td>
  6487. <td>
  6488. </td>
  6489. </tr>
  6490. <tr>
  6491. <td>
  6492. <code>validationResult</code></br>
  6493. <em>
  6494. <a href="#external-secrets.io/v1.ValidationResult">
  6495. ValidationResult
  6496. </a>
  6497. </em>
  6498. </td>
  6499. <td>
  6500. </td>
  6501. </tr>
  6502. </tbody>
  6503. </table>
  6504. <h3 id="external-secrets.io/v1.FakeProviderData">FakeProviderData
  6505. </h3>
  6506. <p>
  6507. (<em>Appears on:</em>
  6508. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  6509. </p>
  6510. <p>
  6511. <p>FakeProviderData defines a key-value pair with optional version for the fake provider.</p>
  6512. </p>
  6513. <table>
  6514. <thead>
  6515. <tr>
  6516. <th>Field</th>
  6517. <th>Description</th>
  6518. </tr>
  6519. </thead>
  6520. <tbody>
  6521. <tr>
  6522. <td>
  6523. <code>key</code></br>
  6524. <em>
  6525. string
  6526. </em>
  6527. </td>
  6528. <td>
  6529. </td>
  6530. </tr>
  6531. <tr>
  6532. <td>
  6533. <code>value</code></br>
  6534. <em>
  6535. string
  6536. </em>
  6537. </td>
  6538. <td>
  6539. </td>
  6540. </tr>
  6541. <tr>
  6542. <td>
  6543. <code>version</code></br>
  6544. <em>
  6545. string
  6546. </em>
  6547. </td>
  6548. <td>
  6549. </td>
  6550. </tr>
  6551. </tbody>
  6552. </table>
  6553. <h3 id="external-secrets.io/v1.FetchingPolicy">FetchingPolicy
  6554. </h3>
  6555. <p>
  6556. (<em>Appears on:</em>
  6557. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  6558. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  6559. </p>
  6560. <p>
  6561. <p>FetchingPolicy configures how the provider interprets the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret.</p>
  6562. </p>
  6563. <table>
  6564. <thead>
  6565. <tr>
  6566. <th>Field</th>
  6567. <th>Description</th>
  6568. </tr>
  6569. </thead>
  6570. <tbody>
  6571. <tr>
  6572. <td>
  6573. <code>byID</code></br>
  6574. <em>
  6575. <a href="#external-secrets.io/v1.ByID">
  6576. ByID
  6577. </a>
  6578. </em>
  6579. </td>
  6580. <td>
  6581. </td>
  6582. </tr>
  6583. <tr>
  6584. <td>
  6585. <code>byName</code></br>
  6586. <em>
  6587. <a href="#external-secrets.io/v1.ByName">
  6588. ByName
  6589. </a>
  6590. </em>
  6591. </td>
  6592. <td>
  6593. </td>
  6594. </tr>
  6595. </tbody>
  6596. </table>
  6597. <h3 id="external-secrets.io/v1.FindName">FindName
  6598. </h3>
  6599. <p>
  6600. (<em>Appears on:</em>
  6601. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  6602. </p>
  6603. <p>
  6604. <p>FindName defines criteria for finding secrets by name patterns.</p>
  6605. </p>
  6606. <table>
  6607. <thead>
  6608. <tr>
  6609. <th>Field</th>
  6610. <th>Description</th>
  6611. </tr>
  6612. </thead>
  6613. <tbody>
  6614. <tr>
  6615. <td>
  6616. <code>regexp</code></br>
  6617. <em>
  6618. string
  6619. </em>
  6620. </td>
  6621. <td>
  6622. <em>(Optional)</em>
  6623. <p>Finds secrets base</p>
  6624. </td>
  6625. </tr>
  6626. </tbody>
  6627. </table>
  6628. <h3 id="external-secrets.io/v1.FortanixProvider">FortanixProvider
  6629. </h3>
  6630. <p>
  6631. (<em>Appears on:</em>
  6632. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  6633. </p>
  6634. <p>
  6635. <p>FortanixProvider provides access to Fortanix SDKMS API using the provided credentials.</p>
  6636. </p>
  6637. <table>
  6638. <thead>
  6639. <tr>
  6640. <th>Field</th>
  6641. <th>Description</th>
  6642. </tr>
  6643. </thead>
  6644. <tbody>
  6645. <tr>
  6646. <td>
  6647. <code>apiUrl</code></br>
  6648. <em>
  6649. string
  6650. </em>
  6651. </td>
  6652. <td>
  6653. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  6654. </td>
  6655. </tr>
  6656. <tr>
  6657. <td>
  6658. <code>apiKey</code></br>
  6659. <em>
  6660. <a href="#external-secrets.io/v1.FortanixProviderSecretRef">
  6661. FortanixProviderSecretRef
  6662. </a>
  6663. </em>
  6664. </td>
  6665. <td>
  6666. <p>APIKey is the API token to access SDKMS Applications.</p>
  6667. </td>
  6668. </tr>
  6669. </tbody>
  6670. </table>
  6671. <h3 id="external-secrets.io/v1.FortanixProviderSecretRef">FortanixProviderSecretRef
  6672. </h3>
  6673. <p>
  6674. (<em>Appears on:</em>
  6675. <a href="#external-secrets.io/v1.FortanixProvider">FortanixProvider</a>)
  6676. </p>
  6677. <p>
  6678. <p>FortanixProviderSecretRef is a secret reference containing the SDKMS API Key.</p>
  6679. </p>
  6680. <table>
  6681. <thead>
  6682. <tr>
  6683. <th>Field</th>
  6684. <th>Description</th>
  6685. </tr>
  6686. </thead>
  6687. <tbody>
  6688. <tr>
  6689. <td>
  6690. <code>secretRef</code></br>
  6691. <em>
  6692. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  6693. External Secrets meta/v1.SecretKeySelector
  6694. </a>
  6695. </em>
  6696. </td>
  6697. <td>
  6698. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  6699. </td>
  6700. </tr>
  6701. </tbody>
  6702. </table>
  6703. <h3 id="external-secrets.io/v1.GCPSMAuth">GCPSMAuth
  6704. </h3>
  6705. <p>
  6706. (<em>Appears on:</em>
  6707. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  6708. </p>
  6709. <p>
  6710. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform Secret Manager.</p>
  6711. </p>
  6712. <table>
  6713. <thead>
  6714. <tr>
  6715. <th>Field</th>
  6716. <th>Description</th>
  6717. </tr>
  6718. </thead>
  6719. <tbody>
  6720. <tr>
  6721. <td>
  6722. <code>secretRef</code></br>
  6723. <em>
  6724. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  6725. GCPSMAuthSecretRef
  6726. </a>
  6727. </em>
  6728. </td>
  6729. <td>
  6730. <em>(Optional)</em>
  6731. </td>
  6732. </tr>
  6733. <tr>
  6734. <td>
  6735. <code>workloadIdentity</code></br>
  6736. <em>
  6737. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  6738. GCPWorkloadIdentity
  6739. </a>
  6740. </em>
  6741. </td>
  6742. <td>
  6743. <em>(Optional)</em>
  6744. </td>
  6745. </tr>
  6746. <tr>
  6747. <td>
  6748. <code>workloadIdentityFederation</code></br>
  6749. <em>
  6750. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  6751. GCPWorkloadIdentityFederation
  6752. </a>
  6753. </em>
  6754. </td>
  6755. <td>
  6756. <em>(Optional)</em>
  6757. </td>
  6758. </tr>
  6759. </tbody>
  6760. </table>
  6761. <h3 id="external-secrets.io/v1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  6762. </h3>
  6763. <p>
  6764. (<em>Appears on:</em>
  6765. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  6766. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  6767. </p>
  6768. <p>
  6769. <p>GCPSMAuthSecretRef contains the secret references for GCP Secret Manager authentication.</p>
  6770. </p>
  6771. <table>
  6772. <thead>
  6773. <tr>
  6774. <th>Field</th>
  6775. <th>Description</th>
  6776. </tr>
  6777. </thead>
  6778. <tbody>
  6779. <tr>
  6780. <td>
  6781. <code>secretAccessKeySecretRef</code></br>
  6782. <em>
  6783. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  6784. External Secrets meta/v1.SecretKeySelector
  6785. </a>
  6786. </em>
  6787. </td>
  6788. <td>
  6789. <em>(Optional)</em>
  6790. <p>The SecretAccessKey is used for authentication</p>
  6791. </td>
  6792. </tr>
  6793. </tbody>
  6794. </table>
  6795. <h3 id="external-secrets.io/v1.GCPSMProvider">GCPSMProvider
  6796. </h3>
  6797. <p>
  6798. (<em>Appears on:</em>
  6799. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  6800. </p>
  6801. <p>
  6802. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  6803. </p>
  6804. <table>
  6805. <thead>
  6806. <tr>
  6807. <th>Field</th>
  6808. <th>Description</th>
  6809. </tr>
  6810. </thead>
  6811. <tbody>
  6812. <tr>
  6813. <td>
  6814. <code>auth</code></br>
  6815. <em>
  6816. <a href="#external-secrets.io/v1.GCPSMAuth">
  6817. GCPSMAuth
  6818. </a>
  6819. </em>
  6820. </td>
  6821. <td>
  6822. <em>(Optional)</em>
  6823. <p>Auth defines the information necessary to authenticate against GCP</p>
  6824. </td>
  6825. </tr>
  6826. <tr>
  6827. <td>
  6828. <code>projectID</code></br>
  6829. <em>
  6830. string
  6831. </em>
  6832. </td>
  6833. <td>
  6834. <p>ProjectID project where secret is located</p>
  6835. </td>
  6836. </tr>
  6837. <tr>
  6838. <td>
  6839. <code>location</code></br>
  6840. <em>
  6841. string
  6842. </em>
  6843. </td>
  6844. <td>
  6845. <p>Location optionally defines a location for a secret</p>
  6846. </td>
  6847. </tr>
  6848. <tr>
  6849. <td>
  6850. <code>secretVersionSelectionPolicy</code></br>
  6851. <em>
  6852. <a href="#external-secrets.io/v1.SecretVersionSelectionPolicy">
  6853. SecretVersionSelectionPolicy
  6854. </a>
  6855. </em>
  6856. </td>
  6857. <td>
  6858. <em>(Optional)</em>
  6859. <p>SecretVersionSelectionPolicy specifies how the provider selects a secret version
  6860. when &ldquo;latest&rdquo; is disabled or destroyed.
  6861. Possible values are:
  6862. - LatestOrFail: the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.
  6863. - LatestOrFetch: the provider falls back to fetching the latest version if the version is DESTROYED or DISABLED</p>
  6864. </td>
  6865. </tr>
  6866. </tbody>
  6867. </table>
  6868. <h3 id="external-secrets.io/v1.GCPWorkloadIdentity">GCPWorkloadIdentity
  6869. </h3>
  6870. <p>
  6871. (<em>Appears on:</em>
  6872. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  6873. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  6874. </p>
  6875. <p>
  6876. <p>GCPWorkloadIdentity defines configuration for workload identity authentication to GCP.</p>
  6877. </p>
  6878. <table>
  6879. <thead>
  6880. <tr>
  6881. <th>Field</th>
  6882. <th>Description</th>
  6883. </tr>
  6884. </thead>
  6885. <tbody>
  6886. <tr>
  6887. <td>
  6888. <code>serviceAccountRef</code></br>
  6889. <em>
  6890. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  6891. External Secrets meta/v1.ServiceAccountSelector
  6892. </a>
  6893. </em>
  6894. </td>
  6895. <td>
  6896. </td>
  6897. </tr>
  6898. <tr>
  6899. <td>
  6900. <code>clusterLocation</code></br>
  6901. <em>
  6902. string
  6903. </em>
  6904. </td>
  6905. <td>
  6906. <em>(Optional)</em>
  6907. <p>ClusterLocation is the location of the cluster
  6908. If not specified, it fetches information from the metadata server</p>
  6909. </td>
  6910. </tr>
  6911. <tr>
  6912. <td>
  6913. <code>clusterName</code></br>
  6914. <em>
  6915. string
  6916. </em>
  6917. </td>
  6918. <td>
  6919. <em>(Optional)</em>
  6920. <p>ClusterName is the name of the cluster
  6921. If not specified, it fetches information from the metadata server</p>
  6922. </td>
  6923. </tr>
  6924. <tr>
  6925. <td>
  6926. <code>clusterProjectID</code></br>
  6927. <em>
  6928. string
  6929. </em>
  6930. </td>
  6931. <td>
  6932. <em>(Optional)</em>
  6933. <p>ClusterProjectID is the project ID of the cluster
  6934. If not specified, it fetches information from the metadata server</p>
  6935. </td>
  6936. </tr>
  6937. </tbody>
  6938. </table>
  6939. <h3 id="external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation
  6940. </h3>
  6941. <p>
  6942. (<em>Appears on:</em>
  6943. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  6944. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  6945. </p>
  6946. <p>
  6947. <p>GCPWorkloadIdentityFederation holds the configurations required for generating federated access tokens.</p>
  6948. </p>
  6949. <table>
  6950. <thead>
  6951. <tr>
  6952. <th>Field</th>
  6953. <th>Description</th>
  6954. </tr>
  6955. </thead>
  6956. <tbody>
  6957. <tr>
  6958. <td>
  6959. <code>credConfig</code></br>
  6960. <em>
  6961. <a href="#external-secrets.io/v1.ConfigMapReference">
  6962. ConfigMapReference
  6963. </a>
  6964. </em>
  6965. </td>
  6966. <td>
  6967. <p>credConfig holds the configmap reference containing the GCP external account credential configuration in JSON format and the key name containing the json data.
  6968. For using Kubernetes cluster as the identity provider, use serviceAccountRef instead. Operators mounted serviceaccount token cannot be used as the token source, instead
  6969. serviceAccountRef must be used by providing operators service account details.</p>
  6970. </td>
  6971. </tr>
  6972. <tr>
  6973. <td>
  6974. <code>serviceAccountRef</code></br>
  6975. <em>
  6976. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  6977. External Secrets meta/v1.ServiceAccountSelector
  6978. </a>
  6979. </em>
  6980. </td>
  6981. <td>
  6982. <p>serviceAccountRef is the reference to the kubernetes ServiceAccount to be used for obtaining the tokens,
  6983. when Kubernetes is configured as provider in workload identity pool.</p>
  6984. </td>
  6985. </tr>
  6986. <tr>
  6987. <td>
  6988. <code>awsSecurityCredentials</code></br>
  6989. <em>
  6990. <a href="#external-secrets.io/v1.AwsCredentialsConfig">
  6991. AwsCredentialsConfig
  6992. </a>
  6993. </em>
  6994. </td>
  6995. <td>
  6996. <p>awsSecurityCredentials is for configuring AWS region and credentials to use for obtaining the access token,
  6997. when using the AWS metadata server is not an option.</p>
  6998. </td>
  6999. </tr>
  7000. <tr>
  7001. <td>
  7002. <code>audience</code></br>
  7003. <em>
  7004. string
  7005. </em>
  7006. </td>
  7007. <td>
  7008. <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.
  7009. If specified, Audience found in the external account credential config will be overridden with the configured value.
  7010. audience must be provided when serviceAccountRef or awsSecurityCredentials is configured.</p>
  7011. </td>
  7012. </tr>
  7013. <tr>
  7014. <td>
  7015. <code>externalTokenEndpoint</code></br>
  7016. <em>
  7017. string
  7018. </em>
  7019. </td>
  7020. <td>
  7021. <p>externalTokenEndpoint is the endpoint explicitly set up to provide tokens, which will be matched against the
  7022. credential_source.url in the provided credConfig. This field is merely to double-check the external token source
  7023. URL is having the expected value.</p>
  7024. </td>
  7025. </tr>
  7026. <tr>
  7027. <td>
  7028. <code>gcpServiceAccountEmail</code></br>
  7029. <em>
  7030. string
  7031. </em>
  7032. </td>
  7033. <td>
  7034. <p>GCPServiceAccountEmail is the email of the Google Cloud service account to impersonate
  7035. after Workload Identity Federation. Use this to grant access through the service account&rsquo;s
  7036. IAM bindings (for example roles/secretmanager.secretAccessor). When set, it overrides
  7037. service_account_impersonation_url in the external account JSON from credConfig;
  7038. when serviceAccountRef is set, it also overrides the &ldquo;iam.gke.io/gcp-service-account&rdquo; annotation
  7039. on that ServiceAccount.</p>
  7040. </td>
  7041. </tr>
  7042. </tbody>
  7043. </table>
  7044. <h3 id="external-secrets.io/v1.GcpIDTokenAuthCredentials">GcpIDTokenAuthCredentials
  7045. </h3>
  7046. <p>
  7047. (<em>Appears on:</em>
  7048. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7049. </p>
  7050. <p>
  7051. <p>GcpIDTokenAuthCredentials represents the credentials for GCP ID token authentication.</p>
  7052. </p>
  7053. <table>
  7054. <thead>
  7055. <tr>
  7056. <th>Field</th>
  7057. <th>Description</th>
  7058. </tr>
  7059. </thead>
  7060. <tbody>
  7061. <tr>
  7062. <td>
  7063. <code>identityId</code></br>
  7064. <em>
  7065. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7066. External Secrets meta/v1.SecretKeySelector
  7067. </a>
  7068. </em>
  7069. </td>
  7070. <td>
  7071. </td>
  7072. </tr>
  7073. </tbody>
  7074. </table>
  7075. <h3 id="external-secrets.io/v1.GcpIamAuthCredentials">GcpIamAuthCredentials
  7076. </h3>
  7077. <p>
  7078. (<em>Appears on:</em>
  7079. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7080. </p>
  7081. <p>
  7082. <p>GcpIamAuthCredentials represents the credentials for GCP IAM authentication.</p>
  7083. </p>
  7084. <table>
  7085. <thead>
  7086. <tr>
  7087. <th>Field</th>
  7088. <th>Description</th>
  7089. </tr>
  7090. </thead>
  7091. <tbody>
  7092. <tr>
  7093. <td>
  7094. <code>identityId</code></br>
  7095. <em>
  7096. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7097. External Secrets meta/v1.SecretKeySelector
  7098. </a>
  7099. </em>
  7100. </td>
  7101. <td>
  7102. </td>
  7103. </tr>
  7104. <tr>
  7105. <td>
  7106. <code>serviceAccountKeyFilePath</code></br>
  7107. <em>
  7108. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7109. External Secrets meta/v1.SecretKeySelector
  7110. </a>
  7111. </em>
  7112. </td>
  7113. <td>
  7114. </td>
  7115. </tr>
  7116. </tbody>
  7117. </table>
  7118. <h3 id="external-secrets.io/v1.GeneratorRef">GeneratorRef
  7119. </h3>
  7120. <p>
  7121. (<em>Appears on:</em>
  7122. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  7123. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>,
  7124. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  7125. </p>
  7126. <p>
  7127. <p>GeneratorRef points to a generator custom resource.</p>
  7128. </p>
  7129. <table>
  7130. <thead>
  7131. <tr>
  7132. <th>Field</th>
  7133. <th>Description</th>
  7134. </tr>
  7135. </thead>
  7136. <tbody>
  7137. <tr>
  7138. <td>
  7139. <code>apiVersion</code></br>
  7140. <em>
  7141. string
  7142. </em>
  7143. </td>
  7144. <td>
  7145. <p>Specify the apiVersion of the generator resource</p>
  7146. </td>
  7147. </tr>
  7148. <tr>
  7149. <td>
  7150. <code>kind</code></br>
  7151. <em>
  7152. string
  7153. </em>
  7154. </td>
  7155. <td>
  7156. <p>Specify the Kind of the generator resource</p>
  7157. </td>
  7158. </tr>
  7159. <tr>
  7160. <td>
  7161. <code>name</code></br>
  7162. <em>
  7163. string
  7164. </em>
  7165. </td>
  7166. <td>
  7167. <p>Specify the name of the generator resource</p>
  7168. </td>
  7169. </tr>
  7170. </tbody>
  7171. </table>
  7172. <h3 id="external-secrets.io/v1.GenericClusterStoreValidator">GenericClusterStoreValidator
  7173. </h3>
  7174. <p>
  7175. <p>GenericClusterStoreValidator implements webhook validation for ClusterSecretStore resources.</p>
  7176. </p>
  7177. <h3 id="external-secrets.io/v1.GenericStore">GenericStore
  7178. </h3>
  7179. <p>
  7180. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  7181. or a namespaced SecretStore.</p>
  7182. </p>
  7183. <h3 id="external-secrets.io/v1.GenericStoreValidator">GenericStoreValidator
  7184. </h3>
  7185. <p>
  7186. <p>GenericStoreValidator implements webhook validation for SecretStore resources.</p>
  7187. </p>
  7188. <h3 id="external-secrets.io/v1.GithubAppAuth">GithubAppAuth
  7189. </h3>
  7190. <p>
  7191. (<em>Appears on:</em>
  7192. <a href="#external-secrets.io/v1.GithubProvider">GithubProvider</a>)
  7193. </p>
  7194. <p>
  7195. <p>GithubAppAuth defines authentication configuration using a GitHub App for accessing GitHub API.</p>
  7196. </p>
  7197. <table>
  7198. <thead>
  7199. <tr>
  7200. <th>Field</th>
  7201. <th>Description</th>
  7202. </tr>
  7203. </thead>
  7204. <tbody>
  7205. <tr>
  7206. <td>
  7207. <code>privateKey</code></br>
  7208. <em>
  7209. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7210. External Secrets meta/v1.SecretKeySelector
  7211. </a>
  7212. </em>
  7213. </td>
  7214. <td>
  7215. </td>
  7216. </tr>
  7217. </tbody>
  7218. </table>
  7219. <h3 id="external-secrets.io/v1.GithubProvider">GithubProvider
  7220. </h3>
  7221. <p>
  7222. (<em>Appears on:</em>
  7223. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7224. </p>
  7225. <p>
  7226. <p>GithubProvider provides access and authentication to a GitHub instance .</p>
  7227. </p>
  7228. <table>
  7229. <thead>
  7230. <tr>
  7231. <th>Field</th>
  7232. <th>Description</th>
  7233. </tr>
  7234. </thead>
  7235. <tbody>
  7236. <tr>
  7237. <td>
  7238. <code>url</code></br>
  7239. <em>
  7240. string
  7241. </em>
  7242. </td>
  7243. <td>
  7244. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  7245. </td>
  7246. </tr>
  7247. <tr>
  7248. <td>
  7249. <code>uploadURL</code></br>
  7250. <em>
  7251. string
  7252. </em>
  7253. </td>
  7254. <td>
  7255. <em>(Optional)</em>
  7256. <p>Upload URL for enterprise instances. Default to URL.</p>
  7257. </td>
  7258. </tr>
  7259. <tr>
  7260. <td>
  7261. <code>auth</code></br>
  7262. <em>
  7263. <a href="#external-secrets.io/v1.GithubAppAuth">
  7264. GithubAppAuth
  7265. </a>
  7266. </em>
  7267. </td>
  7268. <td>
  7269. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  7270. </td>
  7271. </tr>
  7272. <tr>
  7273. <td>
  7274. <code>appID</code></br>
  7275. <em>
  7276. int64
  7277. </em>
  7278. </td>
  7279. <td>
  7280. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  7281. </td>
  7282. </tr>
  7283. <tr>
  7284. <td>
  7285. <code>installationID</code></br>
  7286. <em>
  7287. int64
  7288. </em>
  7289. </td>
  7290. <td>
  7291. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  7292. </td>
  7293. </tr>
  7294. <tr>
  7295. <td>
  7296. <code>organization</code></br>
  7297. <em>
  7298. string
  7299. </em>
  7300. </td>
  7301. <td>
  7302. <p>organization will be used to fetch secrets from the Github organization</p>
  7303. </td>
  7304. </tr>
  7305. <tr>
  7306. <td>
  7307. <code>repository</code></br>
  7308. <em>
  7309. string
  7310. </em>
  7311. </td>
  7312. <td>
  7313. <em>(Optional)</em>
  7314. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  7315. </td>
  7316. </tr>
  7317. <tr>
  7318. <td>
  7319. <code>environment</code></br>
  7320. <em>
  7321. string
  7322. </em>
  7323. </td>
  7324. <td>
  7325. <em>(Optional)</em>
  7326. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  7327. </td>
  7328. </tr>
  7329. <tr>
  7330. <td>
  7331. <code>orgSecretVisibility</code></br>
  7332. <em>
  7333. string
  7334. </em>
  7335. </td>
  7336. <td>
  7337. <em>(Optional)</em>
  7338. <p>orgSecretVisibility controls the visibility of organization secrets pushed via PushSecret.
  7339. Valid values are &ldquo;all&rdquo; or &ldquo;private&rdquo;.
  7340. When unset, new secrets are created with visibility &ldquo;all&rdquo; and existing secrets preserve
  7341. whatever visibility they already have in GitHub.</p>
  7342. </td>
  7343. </tr>
  7344. </tbody>
  7345. </table>
  7346. <h3 id="external-secrets.io/v1.GitlabAuth">GitlabAuth
  7347. </h3>
  7348. <p>
  7349. (<em>Appears on:</em>
  7350. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>)
  7351. </p>
  7352. <p>
  7353. <p>GitlabAuth defines the authentication method for accessing GitLab API.</p>
  7354. </p>
  7355. <table>
  7356. <thead>
  7357. <tr>
  7358. <th>Field</th>
  7359. <th>Description</th>
  7360. </tr>
  7361. </thead>
  7362. <tbody>
  7363. <tr>
  7364. <td>
  7365. <code>SecretRef</code></br>
  7366. <em>
  7367. <a href="#external-secrets.io/v1.GitlabSecretRef">
  7368. GitlabSecretRef
  7369. </a>
  7370. </em>
  7371. </td>
  7372. <td>
  7373. </td>
  7374. </tr>
  7375. </tbody>
  7376. </table>
  7377. <h3 id="external-secrets.io/v1.GitlabProvider">GitlabProvider
  7378. </h3>
  7379. <p>
  7380. (<em>Appears on:</em>
  7381. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7382. </p>
  7383. <p>
  7384. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  7385. </p>
  7386. <table>
  7387. <thead>
  7388. <tr>
  7389. <th>Field</th>
  7390. <th>Description</th>
  7391. </tr>
  7392. </thead>
  7393. <tbody>
  7394. <tr>
  7395. <td>
  7396. <code>url</code></br>
  7397. <em>
  7398. string
  7399. </em>
  7400. </td>
  7401. <td>
  7402. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  7403. </td>
  7404. </tr>
  7405. <tr>
  7406. <td>
  7407. <code>auth</code></br>
  7408. <em>
  7409. <a href="#external-secrets.io/v1.GitlabAuth">
  7410. GitlabAuth
  7411. </a>
  7412. </em>
  7413. </td>
  7414. <td>
  7415. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  7416. </td>
  7417. </tr>
  7418. <tr>
  7419. <td>
  7420. <code>projectID</code></br>
  7421. <em>
  7422. string
  7423. </em>
  7424. </td>
  7425. <td>
  7426. <p>ProjectID specifies a project where secrets are located.</p>
  7427. </td>
  7428. </tr>
  7429. <tr>
  7430. <td>
  7431. <code>inheritFromGroups</code></br>
  7432. <em>
  7433. bool
  7434. </em>
  7435. </td>
  7436. <td>
  7437. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  7438. </td>
  7439. </tr>
  7440. <tr>
  7441. <td>
  7442. <code>groupIDs</code></br>
  7443. <em>
  7444. []string
  7445. </em>
  7446. </td>
  7447. <td>
  7448. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  7449. </td>
  7450. </tr>
  7451. <tr>
  7452. <td>
  7453. <code>environment</code></br>
  7454. <em>
  7455. string
  7456. </em>
  7457. </td>
  7458. <td>
  7459. <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>
  7460. </td>
  7461. </tr>
  7462. <tr>
  7463. <td>
  7464. <code>caBundle</code></br>
  7465. <em>
  7466. []byte
  7467. </em>
  7468. </td>
  7469. <td>
  7470. <em>(Optional)</em>
  7471. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  7472. can be performed.</p>
  7473. </td>
  7474. </tr>
  7475. <tr>
  7476. <td>
  7477. <code>caProvider</code></br>
  7478. <em>
  7479. <a href="#external-secrets.io/v1.CAProvider">
  7480. CAProvider
  7481. </a>
  7482. </em>
  7483. </td>
  7484. <td>
  7485. <em>(Optional)</em>
  7486. <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>
  7487. </td>
  7488. </tr>
  7489. </tbody>
  7490. </table>
  7491. <h3 id="external-secrets.io/v1.GitlabSecretRef">GitlabSecretRef
  7492. </h3>
  7493. <p>
  7494. (<em>Appears on:</em>
  7495. <a href="#external-secrets.io/v1.GitlabAuth">GitlabAuth</a>)
  7496. </p>
  7497. <p>
  7498. <p>GitlabSecretRef contains the secret reference for GitLab authentication credentials.</p>
  7499. </p>
  7500. <table>
  7501. <thead>
  7502. <tr>
  7503. <th>Field</th>
  7504. <th>Description</th>
  7505. </tr>
  7506. </thead>
  7507. <tbody>
  7508. <tr>
  7509. <td>
  7510. <code>accessToken</code></br>
  7511. <em>
  7512. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7513. External Secrets meta/v1.SecretKeySelector
  7514. </a>
  7515. </em>
  7516. </td>
  7517. <td>
  7518. <p>AccessToken is used for authentication.</p>
  7519. </td>
  7520. </tr>
  7521. </tbody>
  7522. </table>
  7523. <h3 id="external-secrets.io/v1.IBMAuth">IBMAuth
  7524. </h3>
  7525. <p>
  7526. (<em>Appears on:</em>
  7527. <a href="#external-secrets.io/v1.IBMProvider">IBMProvider</a>)
  7528. </p>
  7529. <p>
  7530. <p>IBMAuth defines authentication options for connecting to IBM Cloud Secrets Manager.</p>
  7531. </p>
  7532. <table>
  7533. <thead>
  7534. <tr>
  7535. <th>Field</th>
  7536. <th>Description</th>
  7537. </tr>
  7538. </thead>
  7539. <tbody>
  7540. <tr>
  7541. <td>
  7542. <code>secretRef</code></br>
  7543. <em>
  7544. <a href="#external-secrets.io/v1.IBMAuthSecretRef">
  7545. IBMAuthSecretRef
  7546. </a>
  7547. </em>
  7548. </td>
  7549. <td>
  7550. </td>
  7551. </tr>
  7552. <tr>
  7553. <td>
  7554. <code>containerAuth</code></br>
  7555. <em>
  7556. <a href="#external-secrets.io/v1.IBMAuthContainerAuth">
  7557. IBMAuthContainerAuth
  7558. </a>
  7559. </em>
  7560. </td>
  7561. <td>
  7562. </td>
  7563. </tr>
  7564. </tbody>
  7565. </table>
  7566. <h3 id="external-secrets.io/v1.IBMAuthContainerAuth">IBMAuthContainerAuth
  7567. </h3>
  7568. <p>
  7569. (<em>Appears on:</em>
  7570. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  7571. </p>
  7572. <p>
  7573. <p>IBMAuthContainerAuth defines container-based authentication with IAM Trusted Profile.</p>
  7574. </p>
  7575. <table>
  7576. <thead>
  7577. <tr>
  7578. <th>Field</th>
  7579. <th>Description</th>
  7580. </tr>
  7581. </thead>
  7582. <tbody>
  7583. <tr>
  7584. <td>
  7585. <code>profile</code></br>
  7586. <em>
  7587. string
  7588. </em>
  7589. </td>
  7590. <td>
  7591. <p>the IBM Trusted Profile</p>
  7592. </td>
  7593. </tr>
  7594. <tr>
  7595. <td>
  7596. <code>tokenLocation</code></br>
  7597. <em>
  7598. string
  7599. </em>
  7600. </td>
  7601. <td>
  7602. <p>Location the token is mounted on the pod</p>
  7603. </td>
  7604. </tr>
  7605. <tr>
  7606. <td>
  7607. <code>iamEndpoint</code></br>
  7608. <em>
  7609. string
  7610. </em>
  7611. </td>
  7612. <td>
  7613. </td>
  7614. </tr>
  7615. </tbody>
  7616. </table>
  7617. <h3 id="external-secrets.io/v1.IBMAuthSecretRef">IBMAuthSecretRef
  7618. </h3>
  7619. <p>
  7620. (<em>Appears on:</em>
  7621. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  7622. </p>
  7623. <p>
  7624. <p>IBMAuthSecretRef contains the secret reference for IBM Cloud API key authentication.</p>
  7625. </p>
  7626. <table>
  7627. <thead>
  7628. <tr>
  7629. <th>Field</th>
  7630. <th>Description</th>
  7631. </tr>
  7632. </thead>
  7633. <tbody>
  7634. <tr>
  7635. <td>
  7636. <code>secretApiKeySecretRef</code></br>
  7637. <em>
  7638. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7639. External Secrets meta/v1.SecretKeySelector
  7640. </a>
  7641. </em>
  7642. </td>
  7643. <td>
  7644. <p>The SecretAccessKey is used for authentication</p>
  7645. </td>
  7646. </tr>
  7647. <tr>
  7648. <td>
  7649. <code>iamEndpoint</code></br>
  7650. <em>
  7651. string
  7652. </em>
  7653. </td>
  7654. <td>
  7655. <p>The IAM endpoint used to obain a token</p>
  7656. </td>
  7657. </tr>
  7658. </tbody>
  7659. </table>
  7660. <h3 id="external-secrets.io/v1.IBMProvider">IBMProvider
  7661. </h3>
  7662. <p>
  7663. (<em>Appears on:</em>
  7664. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7665. </p>
  7666. <p>
  7667. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager
  7668. backend.</p>
  7669. </p>
  7670. <table>
  7671. <thead>
  7672. <tr>
  7673. <th>Field</th>
  7674. <th>Description</th>
  7675. </tr>
  7676. </thead>
  7677. <tbody>
  7678. <tr>
  7679. <td>
  7680. <code>auth</code></br>
  7681. <em>
  7682. <a href="#external-secrets.io/v1.IBMAuth">
  7683. IBMAuth
  7684. </a>
  7685. </em>
  7686. </td>
  7687. <td>
  7688. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  7689. </td>
  7690. </tr>
  7691. <tr>
  7692. <td>
  7693. <code>serviceUrl</code></br>
  7694. <em>
  7695. string
  7696. </em>
  7697. </td>
  7698. <td>
  7699. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  7700. </td>
  7701. </tr>
  7702. </tbody>
  7703. </table>
  7704. <h3 id="external-secrets.io/v1.InfisicalAuth">InfisicalAuth
  7705. </h3>
  7706. <p>
  7707. (<em>Appears on:</em>
  7708. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  7709. </p>
  7710. <p>
  7711. <p>InfisicalAuth specifies the authentication configuration for Infisical.</p>
  7712. </p>
  7713. <table>
  7714. <thead>
  7715. <tr>
  7716. <th>Field</th>
  7717. <th>Description</th>
  7718. </tr>
  7719. </thead>
  7720. <tbody>
  7721. <tr>
  7722. <td>
  7723. <code>universalAuthCredentials</code></br>
  7724. <em>
  7725. <a href="#external-secrets.io/v1.UniversalAuthCredentials">
  7726. UniversalAuthCredentials
  7727. </a>
  7728. </em>
  7729. </td>
  7730. <td>
  7731. <em>(Optional)</em>
  7732. </td>
  7733. </tr>
  7734. <tr>
  7735. <td>
  7736. <code>azureAuthCredentials</code></br>
  7737. <em>
  7738. <a href="#external-secrets.io/v1.AzureAuthCredentials">
  7739. AzureAuthCredentials
  7740. </a>
  7741. </em>
  7742. </td>
  7743. <td>
  7744. <em>(Optional)</em>
  7745. </td>
  7746. </tr>
  7747. <tr>
  7748. <td>
  7749. <code>gcpIdTokenAuthCredentials</code></br>
  7750. <em>
  7751. <a href="#external-secrets.io/v1.GcpIDTokenAuthCredentials">
  7752. GcpIDTokenAuthCredentials
  7753. </a>
  7754. </em>
  7755. </td>
  7756. <td>
  7757. <em>(Optional)</em>
  7758. </td>
  7759. </tr>
  7760. <tr>
  7761. <td>
  7762. <code>gcpIamAuthCredentials</code></br>
  7763. <em>
  7764. <a href="#external-secrets.io/v1.GcpIamAuthCredentials">
  7765. GcpIamAuthCredentials
  7766. </a>
  7767. </em>
  7768. </td>
  7769. <td>
  7770. <em>(Optional)</em>
  7771. </td>
  7772. </tr>
  7773. <tr>
  7774. <td>
  7775. <code>jwtAuthCredentials</code></br>
  7776. <em>
  7777. <a href="#external-secrets.io/v1.JwtAuthCredentials">
  7778. JwtAuthCredentials
  7779. </a>
  7780. </em>
  7781. </td>
  7782. <td>
  7783. <em>(Optional)</em>
  7784. </td>
  7785. </tr>
  7786. <tr>
  7787. <td>
  7788. <code>ldapAuthCredentials</code></br>
  7789. <em>
  7790. <a href="#external-secrets.io/v1.LdapAuthCredentials">
  7791. LdapAuthCredentials
  7792. </a>
  7793. </em>
  7794. </td>
  7795. <td>
  7796. <em>(Optional)</em>
  7797. </td>
  7798. </tr>
  7799. <tr>
  7800. <td>
  7801. <code>ociAuthCredentials</code></br>
  7802. <em>
  7803. <a href="#external-secrets.io/v1.OciAuthCredentials">
  7804. OciAuthCredentials
  7805. </a>
  7806. </em>
  7807. </td>
  7808. <td>
  7809. <em>(Optional)</em>
  7810. </td>
  7811. </tr>
  7812. <tr>
  7813. <td>
  7814. <code>kubernetesAuthCredentials</code></br>
  7815. <em>
  7816. <a href="#external-secrets.io/v1.KubernetesAuthCredentials">
  7817. KubernetesAuthCredentials
  7818. </a>
  7819. </em>
  7820. </td>
  7821. <td>
  7822. <em>(Optional)</em>
  7823. </td>
  7824. </tr>
  7825. <tr>
  7826. <td>
  7827. <code>awsAuthCredentials</code></br>
  7828. <em>
  7829. <a href="#external-secrets.io/v1.AwsAuthCredentials">
  7830. AwsAuthCredentials
  7831. </a>
  7832. </em>
  7833. </td>
  7834. <td>
  7835. <em>(Optional)</em>
  7836. </td>
  7837. </tr>
  7838. <tr>
  7839. <td>
  7840. <code>tokenAuthCredentials</code></br>
  7841. <em>
  7842. <a href="#external-secrets.io/v1.TokenAuthCredentials">
  7843. TokenAuthCredentials
  7844. </a>
  7845. </em>
  7846. </td>
  7847. <td>
  7848. <em>(Optional)</em>
  7849. </td>
  7850. </tr>
  7851. </tbody>
  7852. </table>
  7853. <h3 id="external-secrets.io/v1.InfisicalProvider">InfisicalProvider
  7854. </h3>
  7855. <p>
  7856. (<em>Appears on:</em>
  7857. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7858. </p>
  7859. <p>
  7860. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  7861. </p>
  7862. <table>
  7863. <thead>
  7864. <tr>
  7865. <th>Field</th>
  7866. <th>Description</th>
  7867. </tr>
  7868. </thead>
  7869. <tbody>
  7870. <tr>
  7871. <td>
  7872. <code>auth</code></br>
  7873. <em>
  7874. <a href="#external-secrets.io/v1.InfisicalAuth">
  7875. InfisicalAuth
  7876. </a>
  7877. </em>
  7878. </td>
  7879. <td>
  7880. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  7881. </td>
  7882. </tr>
  7883. <tr>
  7884. <td>
  7885. <code>secretsScope</code></br>
  7886. <em>
  7887. <a href="#external-secrets.io/v1.MachineIdentityScopeInWorkspace">
  7888. MachineIdentityScopeInWorkspace
  7889. </a>
  7890. </em>
  7891. </td>
  7892. <td>
  7893. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  7894. </td>
  7895. </tr>
  7896. <tr>
  7897. <td>
  7898. <code>hostAPI</code></br>
  7899. <em>
  7900. string
  7901. </em>
  7902. </td>
  7903. <td>
  7904. <em>(Optional)</em>
  7905. <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>
  7906. </td>
  7907. </tr>
  7908. <tr>
  7909. <td>
  7910. <code>caBundle</code></br>
  7911. <em>
  7912. []byte
  7913. </em>
  7914. </td>
  7915. <td>
  7916. <em>(Optional)</em>
  7917. <p>CABundle is a PEM-encoded CA certificate bundle used to validate
  7918. the Infisical server&rsquo;s TLS certificate. Mutually exclusive with CAProvider.</p>
  7919. </td>
  7920. </tr>
  7921. <tr>
  7922. <td>
  7923. <code>caProvider</code></br>
  7924. <em>
  7925. <a href="#external-secrets.io/v1.CAProvider">
  7926. CAProvider
  7927. </a>
  7928. </em>
  7929. </td>
  7930. <td>
  7931. <em>(Optional)</em>
  7932. <p>CAProvider is a reference to a Secret or ConfigMap that contains a CA certificate.
  7933. The certificate is used to validate the Infisical server&rsquo;s TLS certificate.
  7934. Mutually exclusive with CABundle.</p>
  7935. </td>
  7936. </tr>
  7937. </tbody>
  7938. </table>
  7939. <h3 id="external-secrets.io/v1.IntegrationInfo">IntegrationInfo
  7940. </h3>
  7941. <p>
  7942. (<em>Appears on:</em>
  7943. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  7944. </p>
  7945. <p>
  7946. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.</p>
  7947. </p>
  7948. <table>
  7949. <thead>
  7950. <tr>
  7951. <th>Field</th>
  7952. <th>Description</th>
  7953. </tr>
  7954. </thead>
  7955. <tbody>
  7956. <tr>
  7957. <td>
  7958. <code>name</code></br>
  7959. <em>
  7960. string
  7961. </em>
  7962. </td>
  7963. <td>
  7964. <p>Name defaults to &ldquo;1Password SDK&rdquo;.</p>
  7965. </td>
  7966. </tr>
  7967. <tr>
  7968. <td>
  7969. <code>version</code></br>
  7970. <em>
  7971. string
  7972. </em>
  7973. </td>
  7974. <td>
  7975. <p>Version defaults to &ldquo;v1.0.0&rdquo;.</p>
  7976. </td>
  7977. </tr>
  7978. </tbody>
  7979. </table>
  7980. <h3 id="external-secrets.io/v1.JwtAuthCredentials">JwtAuthCredentials
  7981. </h3>
  7982. <p>
  7983. (<em>Appears on:</em>
  7984. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7985. </p>
  7986. <p>
  7987. <p>JwtAuthCredentials represents the credentials for JWT authentication.</p>
  7988. </p>
  7989. <table>
  7990. <thead>
  7991. <tr>
  7992. <th>Field</th>
  7993. <th>Description</th>
  7994. </tr>
  7995. </thead>
  7996. <tbody>
  7997. <tr>
  7998. <td>
  7999. <code>identityId</code></br>
  8000. <em>
  8001. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8002. External Secrets meta/v1.SecretKeySelector
  8003. </a>
  8004. </em>
  8005. </td>
  8006. <td>
  8007. </td>
  8008. </tr>
  8009. <tr>
  8010. <td>
  8011. <code>jwt</code></br>
  8012. <em>
  8013. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8014. External Secrets meta/v1.SecretKeySelector
  8015. </a>
  8016. </em>
  8017. </td>
  8018. <td>
  8019. </td>
  8020. </tr>
  8021. </tbody>
  8022. </table>
  8023. <h3 id="external-secrets.io/v1.KeeperSecurityProvider">KeeperSecurityProvider
  8024. </h3>
  8025. <p>
  8026. (<em>Appears on:</em>
  8027. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8028. </p>
  8029. <p>
  8030. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  8031. </p>
  8032. <table>
  8033. <thead>
  8034. <tr>
  8035. <th>Field</th>
  8036. <th>Description</th>
  8037. </tr>
  8038. </thead>
  8039. <tbody>
  8040. <tr>
  8041. <td>
  8042. <code>authRef</code></br>
  8043. <em>
  8044. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8045. External Secrets meta/v1.SecretKeySelector
  8046. </a>
  8047. </em>
  8048. </td>
  8049. <td>
  8050. </td>
  8051. </tr>
  8052. <tr>
  8053. <td>
  8054. <code>folderID</code></br>
  8055. <em>
  8056. string
  8057. </em>
  8058. </td>
  8059. <td>
  8060. </td>
  8061. </tr>
  8062. <tr>
  8063. <td>
  8064. <code>getByTitleFallback</code></br>
  8065. <em>
  8066. bool
  8067. </em>
  8068. </td>
  8069. <td>
  8070. </td>
  8071. </tr>
  8072. </tbody>
  8073. </table>
  8074. <h3 id="external-secrets.io/v1.KubernetesAuth">KubernetesAuth
  8075. </h3>
  8076. <p>
  8077. (<em>Appears on:</em>
  8078. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8079. </p>
  8080. <p>
  8081. <p>KubernetesAuth defines authentication options for connecting to a Kubernetes cluster.</p>
  8082. </p>
  8083. <table>
  8084. <thead>
  8085. <tr>
  8086. <th>Field</th>
  8087. <th>Description</th>
  8088. </tr>
  8089. </thead>
  8090. <tbody>
  8091. <tr>
  8092. <td>
  8093. <code>cert</code></br>
  8094. <em>
  8095. <a href="#external-secrets.io/v1.CertAuth">
  8096. CertAuth
  8097. </a>
  8098. </em>
  8099. </td>
  8100. <td>
  8101. <em>(Optional)</em>
  8102. <p>has both clientCert and clientKey as secretKeySelector</p>
  8103. </td>
  8104. </tr>
  8105. <tr>
  8106. <td>
  8107. <code>token</code></br>
  8108. <em>
  8109. <a href="#external-secrets.io/v1.TokenAuth">
  8110. TokenAuth
  8111. </a>
  8112. </em>
  8113. </td>
  8114. <td>
  8115. <em>(Optional)</em>
  8116. <p>use static token to authenticate with</p>
  8117. </td>
  8118. </tr>
  8119. <tr>
  8120. <td>
  8121. <code>serviceAccount</code></br>
  8122. <em>
  8123. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  8124. External Secrets meta/v1.ServiceAccountSelector
  8125. </a>
  8126. </em>
  8127. </td>
  8128. <td>
  8129. <em>(Optional)</em>
  8130. <p>points to a service account that should be used for authentication</p>
  8131. </td>
  8132. </tr>
  8133. </tbody>
  8134. </table>
  8135. <h3 id="external-secrets.io/v1.KubernetesAuthCredentials">KubernetesAuthCredentials
  8136. </h3>
  8137. <p>
  8138. (<em>Appears on:</em>
  8139. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8140. </p>
  8141. <p>
  8142. <p>KubernetesAuthCredentials represents the credentials for Kubernetes authentication.</p>
  8143. </p>
  8144. <table>
  8145. <thead>
  8146. <tr>
  8147. <th>Field</th>
  8148. <th>Description</th>
  8149. </tr>
  8150. </thead>
  8151. <tbody>
  8152. <tr>
  8153. <td>
  8154. <code>identityId</code></br>
  8155. <em>
  8156. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8157. External Secrets meta/v1.SecretKeySelector
  8158. </a>
  8159. </em>
  8160. </td>
  8161. <td>
  8162. </td>
  8163. </tr>
  8164. <tr>
  8165. <td>
  8166. <code>serviceAccountTokenPath</code></br>
  8167. <em>
  8168. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8169. External Secrets meta/v1.SecretKeySelector
  8170. </a>
  8171. </em>
  8172. </td>
  8173. <td>
  8174. <em>(Optional)</em>
  8175. </td>
  8176. </tr>
  8177. </tbody>
  8178. </table>
  8179. <h3 id="external-secrets.io/v1.KubernetesProvider">KubernetesProvider
  8180. </h3>
  8181. <p>
  8182. (<em>Appears on:</em>
  8183. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8184. </p>
  8185. <p>
  8186. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  8187. </p>
  8188. <table>
  8189. <thead>
  8190. <tr>
  8191. <th>Field</th>
  8192. <th>Description</th>
  8193. </tr>
  8194. </thead>
  8195. <tbody>
  8196. <tr>
  8197. <td>
  8198. <code>server</code></br>
  8199. <em>
  8200. <a href="#external-secrets.io/v1.KubernetesServer">
  8201. KubernetesServer
  8202. </a>
  8203. </em>
  8204. </td>
  8205. <td>
  8206. <em>(Optional)</em>
  8207. <p>configures the Kubernetes server Address.</p>
  8208. </td>
  8209. </tr>
  8210. <tr>
  8211. <td>
  8212. <code>auth</code></br>
  8213. <em>
  8214. <a href="#external-secrets.io/v1.KubernetesAuth">
  8215. KubernetesAuth
  8216. </a>
  8217. </em>
  8218. </td>
  8219. <td>
  8220. <em>(Optional)</em>
  8221. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  8222. </td>
  8223. </tr>
  8224. <tr>
  8225. <td>
  8226. <code>authRef</code></br>
  8227. <em>
  8228. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8229. External Secrets meta/v1.SecretKeySelector
  8230. </a>
  8231. </em>
  8232. </td>
  8233. <td>
  8234. <em>(Optional)</em>
  8235. <p>A reference to a secret that contains the auth information.</p>
  8236. </td>
  8237. </tr>
  8238. <tr>
  8239. <td>
  8240. <code>remoteNamespace</code></br>
  8241. <em>
  8242. string
  8243. </em>
  8244. </td>
  8245. <td>
  8246. <em>(Optional)</em>
  8247. <p>Remote namespace to fetch the secrets from</p>
  8248. </td>
  8249. </tr>
  8250. </tbody>
  8251. </table>
  8252. <h3 id="external-secrets.io/v1.KubernetesServer">KubernetesServer
  8253. </h3>
  8254. <p>
  8255. (<em>Appears on:</em>
  8256. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8257. </p>
  8258. <p>
  8259. <p>KubernetesServer defines configuration for connecting to a Kubernetes API server.</p>
  8260. </p>
  8261. <table>
  8262. <thead>
  8263. <tr>
  8264. <th>Field</th>
  8265. <th>Description</th>
  8266. </tr>
  8267. </thead>
  8268. <tbody>
  8269. <tr>
  8270. <td>
  8271. <code>url</code></br>
  8272. <em>
  8273. string
  8274. </em>
  8275. </td>
  8276. <td>
  8277. <em>(Optional)</em>
  8278. <p>configures the Kubernetes server Address.</p>
  8279. </td>
  8280. </tr>
  8281. <tr>
  8282. <td>
  8283. <code>caBundle</code></br>
  8284. <em>
  8285. []byte
  8286. </em>
  8287. </td>
  8288. <td>
  8289. <em>(Optional)</em>
  8290. <p>CABundle is a base64-encoded CA certificate</p>
  8291. </td>
  8292. </tr>
  8293. <tr>
  8294. <td>
  8295. <code>caProvider</code></br>
  8296. <em>
  8297. <a href="#external-secrets.io/v1.CAProvider">
  8298. CAProvider
  8299. </a>
  8300. </em>
  8301. </td>
  8302. <td>
  8303. <em>(Optional)</em>
  8304. <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>
  8305. </td>
  8306. </tr>
  8307. </tbody>
  8308. </table>
  8309. <h3 id="external-secrets.io/v1.LdapAuthCredentials">LdapAuthCredentials
  8310. </h3>
  8311. <p>
  8312. (<em>Appears on:</em>
  8313. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8314. </p>
  8315. <p>
  8316. <p>LdapAuthCredentials represents the credentials for LDAP authentication.</p>
  8317. </p>
  8318. <table>
  8319. <thead>
  8320. <tr>
  8321. <th>Field</th>
  8322. <th>Description</th>
  8323. </tr>
  8324. </thead>
  8325. <tbody>
  8326. <tr>
  8327. <td>
  8328. <code>identityId</code></br>
  8329. <em>
  8330. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8331. External Secrets meta/v1.SecretKeySelector
  8332. </a>
  8333. </em>
  8334. </td>
  8335. <td>
  8336. </td>
  8337. </tr>
  8338. <tr>
  8339. <td>
  8340. <code>ldapPassword</code></br>
  8341. <em>
  8342. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8343. External Secrets meta/v1.SecretKeySelector
  8344. </a>
  8345. </em>
  8346. </td>
  8347. <td>
  8348. </td>
  8349. </tr>
  8350. <tr>
  8351. <td>
  8352. <code>ldapUsername</code></br>
  8353. <em>
  8354. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8355. External Secrets meta/v1.SecretKeySelector
  8356. </a>
  8357. </em>
  8358. </td>
  8359. <td>
  8360. </td>
  8361. </tr>
  8362. </tbody>
  8363. </table>
  8364. <h3 id="external-secrets.io/v1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  8365. </h3>
  8366. <p>
  8367. (<em>Appears on:</em>
  8368. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8369. </p>
  8370. <p>
  8371. <p>MachineIdentityScopeInWorkspace defines the scope for machine identity within a workspace.</p>
  8372. </p>
  8373. <table>
  8374. <thead>
  8375. <tr>
  8376. <th>Field</th>
  8377. <th>Description</th>
  8378. </tr>
  8379. </thead>
  8380. <tbody>
  8381. <tr>
  8382. <td>
  8383. <code>secretsPath</code></br>
  8384. <em>
  8385. string
  8386. </em>
  8387. </td>
  8388. <td>
  8389. <em>(Optional)</em>
  8390. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  8391. </td>
  8392. </tr>
  8393. <tr>
  8394. <td>
  8395. <code>recursive</code></br>
  8396. <em>
  8397. bool
  8398. </em>
  8399. </td>
  8400. <td>
  8401. <em>(Optional)</em>
  8402. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  8403. </td>
  8404. </tr>
  8405. <tr>
  8406. <td>
  8407. <code>environmentSlug</code></br>
  8408. <em>
  8409. string
  8410. </em>
  8411. </td>
  8412. <td>
  8413. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  8414. </td>
  8415. </tr>
  8416. <tr>
  8417. <td>
  8418. <code>projectSlug</code></br>
  8419. <em>
  8420. string
  8421. </em>
  8422. </td>
  8423. <td>
  8424. <p>ProjectSlug is the required slug identifier for the project.</p>
  8425. </td>
  8426. </tr>
  8427. <tr>
  8428. <td>
  8429. <code>expandSecretReferences</code></br>
  8430. <em>
  8431. bool
  8432. </em>
  8433. </td>
  8434. <td>
  8435. <em>(Optional)</em>
  8436. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  8437. </td>
  8438. </tr>
  8439. </tbody>
  8440. </table>
  8441. <h3 id="external-secrets.io/v1.MaintenanceStatus">MaintenanceStatus
  8442. (<code>string</code> alias)</p></h3>
  8443. <p>
  8444. <p>MaintenanceStatus defines a type for different maintenance states of a provider schema.</p>
  8445. </p>
  8446. <table>
  8447. <thead>
  8448. <tr>
  8449. <th>Value</th>
  8450. <th>Description</th>
  8451. </tr>
  8452. </thead>
  8453. <tbody><tr><td><p>&#34;Deprecated&#34;</p></td>
  8454. <td></td>
  8455. </tr><tr><td><p>&#34;Maintained&#34;</p></td>
  8456. <td></td>
  8457. </tr><tr><td><p>&#34;NotMaintained&#34;</p></td>
  8458. <td></td>
  8459. </tr></tbody>
  8460. </table>
  8461. <h3 id="external-secrets.io/v1.ManifestReference">ManifestReference
  8462. </h3>
  8463. <p>
  8464. (<em>Appears on:</em>
  8465. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  8466. </p>
  8467. <p>
  8468. <p>ManifestReference defines a custom Kubernetes resource type to be created
  8469. instead of a Secret. This allows ExternalSecret to create ConfigMaps,
  8470. Custom Resources, or any other Kubernetes resource type.</p>
  8471. </p>
  8472. <table>
  8473. <thead>
  8474. <tr>
  8475. <th>Field</th>
  8476. <th>Description</th>
  8477. </tr>
  8478. </thead>
  8479. <tbody>
  8480. <tr>
  8481. <td>
  8482. <code>apiVersion</code></br>
  8483. <em>
  8484. string
  8485. </em>
  8486. </td>
  8487. <td>
  8488. <p>APIVersion of the target resource (e.g., &ldquo;v1&rdquo; for ConfigMap, &ldquo;argoproj.io/v1alpha1&rdquo; for ArgoCD Application)</p>
  8489. </td>
  8490. </tr>
  8491. <tr>
  8492. <td>
  8493. <code>kind</code></br>
  8494. <em>
  8495. string
  8496. </em>
  8497. </td>
  8498. <td>
  8499. <p>Kind of the target resource (e.g., &ldquo;ConfigMap&rdquo;, &ldquo;Application&rdquo;)</p>
  8500. </td>
  8501. </tr>
  8502. </tbody>
  8503. </table>
  8504. <h3 id="external-secrets.io/v1.NTLMProtocol">NTLMProtocol
  8505. </h3>
  8506. <p>
  8507. (<em>Appears on:</em>
  8508. <a href="#external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol</a>)
  8509. </p>
  8510. <p>
  8511. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  8512. </p>
  8513. <table>
  8514. <thead>
  8515. <tr>
  8516. <th>Field</th>
  8517. <th>Description</th>
  8518. </tr>
  8519. </thead>
  8520. <tbody>
  8521. <tr>
  8522. <td>
  8523. <code>usernameSecret</code></br>
  8524. <em>
  8525. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8526. External Secrets meta/v1.SecretKeySelector
  8527. </a>
  8528. </em>
  8529. </td>
  8530. <td>
  8531. </td>
  8532. </tr>
  8533. <tr>
  8534. <td>
  8535. <code>passwordSecret</code></br>
  8536. <em>
  8537. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8538. External Secrets meta/v1.SecretKeySelector
  8539. </a>
  8540. </em>
  8541. </td>
  8542. <td>
  8543. </td>
  8544. </tr>
  8545. </tbody>
  8546. </table>
  8547. <h3 id="external-secrets.io/v1.NebiusAuth">NebiusAuth
  8548. </h3>
  8549. <p>
  8550. (<em>Appears on:</em>
  8551. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  8552. </p>
  8553. <p>
  8554. <p>NebiusAuth defines the authentication method for the Nebius provider.</p>
  8555. </p>
  8556. <table>
  8557. <thead>
  8558. <tr>
  8559. <th>Field</th>
  8560. <th>Description</th>
  8561. </tr>
  8562. </thead>
  8563. <tbody>
  8564. <tr>
  8565. <td>
  8566. <code>serviceAccountCredsSecretRef</code></br>
  8567. <em>
  8568. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8569. External Secrets meta/v1.SecretKeySelector
  8570. </a>
  8571. </em>
  8572. </td>
  8573. <td>
  8574. <em>(Optional)</em>
  8575. <p>ServiceAccountCreds references a Kubernetes Secret key that contains a JSON
  8576. document with service account credentials used to get an IAM token.</p>
  8577. <p>Expected JSON structure:
  8578. {
  8579. &ldquo;subject-credentials&rdquo;: {
  8580. &ldquo;alg&rdquo;: &ldquo;RS256&rdquo;,
  8581. &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;,
  8582. &ldquo;kid&rdquo;: &ldquo;<public-key-id>&rdquo;,
  8583. &ldquo;iss&rdquo;: &ldquo;<issuer-service-account-id>&rdquo;,
  8584. &ldquo;sub&rdquo;: &ldquo;<subject-service-account-id>&rdquo;
  8585. }
  8586. }</p>
  8587. </td>
  8588. </tr>
  8589. <tr>
  8590. <td>
  8591. <code>tokenSecretRef</code></br>
  8592. <em>
  8593. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8594. External Secrets meta/v1.SecretKeySelector
  8595. </a>
  8596. </em>
  8597. </td>
  8598. <td>
  8599. <em>(Optional)</em>
  8600. <p>Token authenticates with Nebius Mysterybox by presenting a token.</p>
  8601. </td>
  8602. </tr>
  8603. </tbody>
  8604. </table>
  8605. <h3 id="external-secrets.io/v1.NebiusCAProvider">NebiusCAProvider
  8606. </h3>
  8607. <p>
  8608. (<em>Appears on:</em>
  8609. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  8610. </p>
  8611. <p>
  8612. <p>NebiusCAProvider The provider for the CA bundle to use to validate Nebius server certificate.</p>
  8613. </p>
  8614. <table>
  8615. <thead>
  8616. <tr>
  8617. <th>Field</th>
  8618. <th>Description</th>
  8619. </tr>
  8620. </thead>
  8621. <tbody>
  8622. <tr>
  8623. <td>
  8624. <code>certSecretRef</code></br>
  8625. <em>
  8626. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8627. External Secrets meta/v1.SecretKeySelector
  8628. </a>
  8629. </em>
  8630. </td>
  8631. <td>
  8632. <em>(Optional)</em>
  8633. </td>
  8634. </tr>
  8635. </tbody>
  8636. </table>
  8637. <h3 id="external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider
  8638. </h3>
  8639. <p>
  8640. (<em>Appears on:</em>
  8641. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8642. </p>
  8643. <p>
  8644. <p>NebiusMysteryboxProvider Configures a store to sync secrets using the Nebius Mysterybox provider.</p>
  8645. </p>
  8646. <table>
  8647. <thead>
  8648. <tr>
  8649. <th>Field</th>
  8650. <th>Description</th>
  8651. </tr>
  8652. </thead>
  8653. <tbody>
  8654. <tr>
  8655. <td>
  8656. <code>apiDomain</code></br>
  8657. <em>
  8658. string
  8659. </em>
  8660. </td>
  8661. <td>
  8662. <p>NebiusMysterybox API endpoint</p>
  8663. </td>
  8664. </tr>
  8665. <tr>
  8666. <td>
  8667. <code>auth</code></br>
  8668. <em>
  8669. <a href="#external-secrets.io/v1.NebiusAuth">
  8670. NebiusAuth
  8671. </a>
  8672. </em>
  8673. </td>
  8674. <td>
  8675. <p>Auth defines parameters to authenticate in MysteryBox</p>
  8676. </td>
  8677. </tr>
  8678. <tr>
  8679. <td>
  8680. <code>caProvider</code></br>
  8681. <em>
  8682. <a href="#external-secrets.io/v1.NebiusCAProvider">
  8683. NebiusCAProvider
  8684. </a>
  8685. </em>
  8686. </td>
  8687. <td>
  8688. <em>(Optional)</em>
  8689. <p>The provider for the CA bundle to use to validate NebiusMysterybox server certificate.</p>
  8690. </td>
  8691. </tr>
  8692. </tbody>
  8693. </table>
  8694. <h3 id="external-secrets.io/v1.NgrokAuth">NgrokAuth
  8695. </h3>
  8696. <p>
  8697. (<em>Appears on:</em>
  8698. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  8699. </p>
  8700. <p>
  8701. <p>NgrokAuth configures the authentication method for the ngrok provider.</p>
  8702. </p>
  8703. <table>
  8704. <thead>
  8705. <tr>
  8706. <th>Field</th>
  8707. <th>Description</th>
  8708. </tr>
  8709. </thead>
  8710. <tbody>
  8711. <tr>
  8712. <td>
  8713. <code>apiKey</code></br>
  8714. <em>
  8715. <a href="#external-secrets.io/v1.NgrokProviderSecretRef">
  8716. NgrokProviderSecretRef
  8717. </a>
  8718. </em>
  8719. </td>
  8720. <td>
  8721. <em>(Optional)</em>
  8722. <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>
  8723. </td>
  8724. </tr>
  8725. </tbody>
  8726. </table>
  8727. <h3 id="external-secrets.io/v1.NgrokProvider">NgrokProvider
  8728. </h3>
  8729. <p>
  8730. (<em>Appears on:</em>
  8731. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8732. </p>
  8733. <p>
  8734. <p>NgrokProvider configures a store to sync secrets with a ngrok vault to use in traffic policies.
  8735. See: <a href="https://ngrok.com/blog-post/secrets-for-traffic-policy">https://ngrok.com/blog-post/secrets-for-traffic-policy</a></p>
  8736. </p>
  8737. <table>
  8738. <thead>
  8739. <tr>
  8740. <th>Field</th>
  8741. <th>Description</th>
  8742. </tr>
  8743. </thead>
  8744. <tbody>
  8745. <tr>
  8746. <td>
  8747. <code>apiUrl</code></br>
  8748. <em>
  8749. string
  8750. </em>
  8751. </td>
  8752. <td>
  8753. <p>APIURL is the URL of the ngrok API.</p>
  8754. </td>
  8755. </tr>
  8756. <tr>
  8757. <td>
  8758. <code>auth</code></br>
  8759. <em>
  8760. <a href="#external-secrets.io/v1.NgrokAuth">
  8761. NgrokAuth
  8762. </a>
  8763. </em>
  8764. </td>
  8765. <td>
  8766. <p>Auth configures how the ngrok provider authenticates with the ngrok API.</p>
  8767. </td>
  8768. </tr>
  8769. <tr>
  8770. <td>
  8771. <code>vault</code></br>
  8772. <em>
  8773. <a href="#external-secrets.io/v1.NgrokVault">
  8774. NgrokVault
  8775. </a>
  8776. </em>
  8777. </td>
  8778. <td>
  8779. <p>Vault configures the ngrok vault to sync secrets with.</p>
  8780. </td>
  8781. </tr>
  8782. </tbody>
  8783. </table>
  8784. <h3 id="external-secrets.io/v1.NgrokProviderSecretRef">NgrokProviderSecretRef
  8785. </h3>
  8786. <p>
  8787. (<em>Appears on:</em>
  8788. <a href="#external-secrets.io/v1.NgrokAuth">NgrokAuth</a>)
  8789. </p>
  8790. <p>
  8791. <p>NgrokProviderSecretRef contains the secret reference for the ngrok provider.</p>
  8792. </p>
  8793. <table>
  8794. <thead>
  8795. <tr>
  8796. <th>Field</th>
  8797. <th>Description</th>
  8798. </tr>
  8799. </thead>
  8800. <tbody>
  8801. <tr>
  8802. <td>
  8803. <code>secretRef</code></br>
  8804. <em>
  8805. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8806. External Secrets meta/v1.SecretKeySelector
  8807. </a>
  8808. </em>
  8809. </td>
  8810. <td>
  8811. <em>(Optional)</em>
  8812. <p>SecretRef is a reference to a secret containing the ngrok API key.</p>
  8813. </td>
  8814. </tr>
  8815. </tbody>
  8816. </table>
  8817. <h3 id="external-secrets.io/v1.NgrokVault">NgrokVault
  8818. </h3>
  8819. <p>
  8820. (<em>Appears on:</em>
  8821. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  8822. </p>
  8823. <p>
  8824. <p>NgrokVault configures the ngrok vault to sync secrets with.</p>
  8825. </p>
  8826. <table>
  8827. <thead>
  8828. <tr>
  8829. <th>Field</th>
  8830. <th>Description</th>
  8831. </tr>
  8832. </thead>
  8833. <tbody>
  8834. <tr>
  8835. <td>
  8836. <code>name</code></br>
  8837. <em>
  8838. string
  8839. </em>
  8840. </td>
  8841. <td>
  8842. <p>Name is the name of the ngrok vault to sync secrets with.</p>
  8843. </td>
  8844. </tr>
  8845. </tbody>
  8846. </table>
  8847. <h3 id="external-secrets.io/v1.NoSecretError">NoSecretError
  8848. </h3>
  8849. <p>
  8850. <p>NoSecretError shall be returned when a GetSecret can not find the
  8851. desired secret. This is used for deletionPolicy.</p>
  8852. </p>
  8853. <h3 id="external-secrets.io/v1.NotModifiedError">NotModifiedError
  8854. </h3>
  8855. <p>
  8856. <p>NotModifiedError to signal that the webhook received no changes,
  8857. and it should just return without doing anything.</p>
  8858. </p>
  8859. <h3 id="external-secrets.io/v1.OciAuthCredentials">OciAuthCredentials
  8860. </h3>
  8861. <p>
  8862. (<em>Appears on:</em>
  8863. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8864. </p>
  8865. <p>
  8866. <p>OciAuthCredentials represents the credentials for OCI authentication.</p>
  8867. </p>
  8868. <table>
  8869. <thead>
  8870. <tr>
  8871. <th>Field</th>
  8872. <th>Description</th>
  8873. </tr>
  8874. </thead>
  8875. <tbody>
  8876. <tr>
  8877. <td>
  8878. <code>identityId</code></br>
  8879. <em>
  8880. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8881. External Secrets meta/v1.SecretKeySelector
  8882. </a>
  8883. </em>
  8884. </td>
  8885. <td>
  8886. </td>
  8887. </tr>
  8888. <tr>
  8889. <td>
  8890. <code>privateKey</code></br>
  8891. <em>
  8892. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8893. External Secrets meta/v1.SecretKeySelector
  8894. </a>
  8895. </em>
  8896. </td>
  8897. <td>
  8898. </td>
  8899. </tr>
  8900. <tr>
  8901. <td>
  8902. <code>privateKeyPassphrase</code></br>
  8903. <em>
  8904. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8905. External Secrets meta/v1.SecretKeySelector
  8906. </a>
  8907. </em>
  8908. </td>
  8909. <td>
  8910. <em>(Optional)</em>
  8911. </td>
  8912. </tr>
  8913. <tr>
  8914. <td>
  8915. <code>fingerprint</code></br>
  8916. <em>
  8917. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8918. External Secrets meta/v1.SecretKeySelector
  8919. </a>
  8920. </em>
  8921. </td>
  8922. <td>
  8923. </td>
  8924. </tr>
  8925. <tr>
  8926. <td>
  8927. <code>userId</code></br>
  8928. <em>
  8929. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8930. External Secrets meta/v1.SecretKeySelector
  8931. </a>
  8932. </em>
  8933. </td>
  8934. <td>
  8935. </td>
  8936. </tr>
  8937. <tr>
  8938. <td>
  8939. <code>tenancyId</code></br>
  8940. <em>
  8941. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8942. External Secrets meta/v1.SecretKeySelector
  8943. </a>
  8944. </em>
  8945. </td>
  8946. <td>
  8947. </td>
  8948. </tr>
  8949. <tr>
  8950. <td>
  8951. <code>region</code></br>
  8952. <em>
  8953. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8954. External Secrets meta/v1.SecretKeySelector
  8955. </a>
  8956. </em>
  8957. </td>
  8958. <td>
  8959. </td>
  8960. </tr>
  8961. </tbody>
  8962. </table>
  8963. <h3 id="external-secrets.io/v1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  8964. </h3>
  8965. <p>
  8966. (<em>Appears on:</em>
  8967. <a href="#external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider</a>)
  8968. </p>
  8969. <p>
  8970. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  8971. </p>
  8972. <table>
  8973. <thead>
  8974. <tr>
  8975. <th>Field</th>
  8976. <th>Description</th>
  8977. </tr>
  8978. </thead>
  8979. <tbody>
  8980. <tr>
  8981. <td>
  8982. <code>apiKeyRef</code></br>
  8983. <em>
  8984. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8985. External Secrets meta/v1.SecretKeySelector
  8986. </a>
  8987. </em>
  8988. </td>
  8989. <td>
  8990. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  8991. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  8992. </td>
  8993. </tr>
  8994. <tr>
  8995. <td>
  8996. <code>passcodeRef</code></br>
  8997. <em>
  8998. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8999. External Secrets meta/v1.SecretKeySelector
  9000. </a>
  9001. </em>
  9002. </td>
  9003. <td>
  9004. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  9005. </td>
  9006. </tr>
  9007. </tbody>
  9008. </table>
  9009. <h3 id="external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider
  9010. </h3>
  9011. <p>
  9012. (<em>Appears on:</em>
  9013. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9014. </p>
  9015. <p>
  9016. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  9017. Project and Config are required if not using a Service Token.</p>
  9018. </p>
  9019. <table>
  9020. <thead>
  9021. <tr>
  9022. <th>Field</th>
  9023. <th>Description</th>
  9024. </tr>
  9025. </thead>
  9026. <tbody>
  9027. <tr>
  9028. <td>
  9029. <code>auth</code></br>
  9030. <em>
  9031. <a href="#external-secrets.io/v1.OnboardbaseAuthSecretRef">
  9032. OnboardbaseAuthSecretRef
  9033. </a>
  9034. </em>
  9035. </td>
  9036. <td>
  9037. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  9038. </td>
  9039. </tr>
  9040. <tr>
  9041. <td>
  9042. <code>apiHost</code></br>
  9043. <em>
  9044. string
  9045. </em>
  9046. </td>
  9047. <td>
  9048. <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>
  9049. </td>
  9050. </tr>
  9051. <tr>
  9052. <td>
  9053. <code>project</code></br>
  9054. <em>
  9055. string
  9056. </em>
  9057. </td>
  9058. <td>
  9059. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  9060. </td>
  9061. </tr>
  9062. <tr>
  9063. <td>
  9064. <code>environment</code></br>
  9065. <em>
  9066. string
  9067. </em>
  9068. </td>
  9069. <td>
  9070. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  9071. </td>
  9072. </tr>
  9073. </tbody>
  9074. </table>
  9075. <h3 id="external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth
  9076. </h3>
  9077. <p>
  9078. (<em>Appears on:</em>
  9079. <a href="#external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider</a>)
  9080. </p>
  9081. <p>
  9082. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  9083. </p>
  9084. <table>
  9085. <thead>
  9086. <tr>
  9087. <th>Field</th>
  9088. <th>Description</th>
  9089. </tr>
  9090. </thead>
  9091. <tbody>
  9092. <tr>
  9093. <td>
  9094. <code>secretRef</code></br>
  9095. <em>
  9096. <a href="#external-secrets.io/v1.OnePasswordAuthSecretRef">
  9097. OnePasswordAuthSecretRef
  9098. </a>
  9099. </em>
  9100. </td>
  9101. <td>
  9102. </td>
  9103. </tr>
  9104. </tbody>
  9105. </table>
  9106. <h3 id="external-secrets.io/v1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  9107. </h3>
  9108. <p>
  9109. (<em>Appears on:</em>
  9110. <a href="#external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth</a>)
  9111. </p>
  9112. <p>
  9113. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  9114. </p>
  9115. <table>
  9116. <thead>
  9117. <tr>
  9118. <th>Field</th>
  9119. <th>Description</th>
  9120. </tr>
  9121. </thead>
  9122. <tbody>
  9123. <tr>
  9124. <td>
  9125. <code>connectTokenSecretRef</code></br>
  9126. <em>
  9127. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9128. External Secrets meta/v1.SecretKeySelector
  9129. </a>
  9130. </em>
  9131. </td>
  9132. <td>
  9133. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  9134. </td>
  9135. </tr>
  9136. </tbody>
  9137. </table>
  9138. <h3 id="external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider
  9139. </h3>
  9140. <p>
  9141. (<em>Appears on:</em>
  9142. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9143. </p>
  9144. <p>
  9145. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  9146. </p>
  9147. <table>
  9148. <thead>
  9149. <tr>
  9150. <th>Field</th>
  9151. <th>Description</th>
  9152. </tr>
  9153. </thead>
  9154. <tbody>
  9155. <tr>
  9156. <td>
  9157. <code>auth</code></br>
  9158. <em>
  9159. <a href="#external-secrets.io/v1.OnePasswordAuth">
  9160. OnePasswordAuth
  9161. </a>
  9162. </em>
  9163. </td>
  9164. <td>
  9165. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  9166. </td>
  9167. </tr>
  9168. <tr>
  9169. <td>
  9170. <code>connectHost</code></br>
  9171. <em>
  9172. string
  9173. </em>
  9174. </td>
  9175. <td>
  9176. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  9177. </td>
  9178. </tr>
  9179. <tr>
  9180. <td>
  9181. <code>vaults</code></br>
  9182. <em>
  9183. map[string]int
  9184. </em>
  9185. </td>
  9186. <td>
  9187. <p>Vaults defines which OnePassword vaults to search in which order</p>
  9188. </td>
  9189. </tr>
  9190. </tbody>
  9191. </table>
  9192. <h3 id="external-secrets.io/v1.OnePasswordSDKAuth">OnePasswordSDKAuth
  9193. </h3>
  9194. <p>
  9195. (<em>Appears on:</em>
  9196. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  9197. </p>
  9198. <p>
  9199. <p>OnePasswordSDKAuth contains a secretRef for the service account token.</p>
  9200. </p>
  9201. <table>
  9202. <thead>
  9203. <tr>
  9204. <th>Field</th>
  9205. <th>Description</th>
  9206. </tr>
  9207. </thead>
  9208. <tbody>
  9209. <tr>
  9210. <td>
  9211. <code>serviceAccountSecretRef</code></br>
  9212. <em>
  9213. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9214. External Secrets meta/v1.SecretKeySelector
  9215. </a>
  9216. </em>
  9217. </td>
  9218. <td>
  9219. <p>ServiceAccountSecretRef points to the secret containing the token to access 1Password vault.</p>
  9220. </td>
  9221. </tr>
  9222. </tbody>
  9223. </table>
  9224. <h3 id="external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider
  9225. </h3>
  9226. <p>
  9227. (<em>Appears on:</em>
  9228. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9229. </p>
  9230. <p>
  9231. <p>OnePasswordSDKProvider configures a store to sync secrets using the 1Password sdk.</p>
  9232. </p>
  9233. <table>
  9234. <thead>
  9235. <tr>
  9236. <th>Field</th>
  9237. <th>Description</th>
  9238. </tr>
  9239. </thead>
  9240. <tbody>
  9241. <tr>
  9242. <td>
  9243. <code>vault</code></br>
  9244. <em>
  9245. string
  9246. </em>
  9247. </td>
  9248. <td>
  9249. <p>Vault defines the vault&rsquo;s name or uuid to access. Do NOT add op:// prefix. This will be done automatically.</p>
  9250. </td>
  9251. </tr>
  9252. <tr>
  9253. <td>
  9254. <code>integrationInfo</code></br>
  9255. <em>
  9256. <a href="#external-secrets.io/v1.IntegrationInfo">
  9257. IntegrationInfo
  9258. </a>
  9259. </em>
  9260. </td>
  9261. <td>
  9262. <em>(Optional)</em>
  9263. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.
  9264. If you don&rsquo;t know which name and version to use, use <code>DefaultIntegrationName</code> and <code>DefaultIntegrationVersion</code>, respectively.</p>
  9265. </td>
  9266. </tr>
  9267. <tr>
  9268. <td>
  9269. <code>auth</code></br>
  9270. <em>
  9271. <a href="#external-secrets.io/v1.OnePasswordSDKAuth">
  9272. OnePasswordSDKAuth
  9273. </a>
  9274. </em>
  9275. </td>
  9276. <td>
  9277. <p>Auth defines the information necessary to authenticate against OnePassword API.</p>
  9278. </td>
  9279. </tr>
  9280. <tr>
  9281. <td>
  9282. <code>cache</code></br>
  9283. <em>
  9284. <a href="#external-secrets.io/v1.CacheConfig">
  9285. CacheConfig
  9286. </a>
  9287. </em>
  9288. </td>
  9289. <td>
  9290. <em>(Optional)</em>
  9291. <p>Cache configures client-side caching for read operations (GetSecret, GetSecretMap).
  9292. When enabled, secrets are cached with the specified TTL.
  9293. Write operations (PushSecret, DeleteSecret) automatically invalidate relevant cache entries.
  9294. If omitted, caching is disabled (default).
  9295. cache: {} is a valid option to set.</p>
  9296. </td>
  9297. </tr>
  9298. </tbody>
  9299. </table>
  9300. <h3 id="external-secrets.io/v1.OracleAuth">OracleAuth
  9301. </h3>
  9302. <p>
  9303. (<em>Appears on:</em>
  9304. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  9305. </p>
  9306. <p>
  9307. <p>OracleAuth defines the authentication method for the Oracle Vault provider.</p>
  9308. </p>
  9309. <table>
  9310. <thead>
  9311. <tr>
  9312. <th>Field</th>
  9313. <th>Description</th>
  9314. </tr>
  9315. </thead>
  9316. <tbody>
  9317. <tr>
  9318. <td>
  9319. <code>tenancy</code></br>
  9320. <em>
  9321. string
  9322. </em>
  9323. </td>
  9324. <td>
  9325. <p>Tenancy is the tenancy OCID where user is located.</p>
  9326. </td>
  9327. </tr>
  9328. <tr>
  9329. <td>
  9330. <code>user</code></br>
  9331. <em>
  9332. string
  9333. </em>
  9334. </td>
  9335. <td>
  9336. <p>User is an access OCID specific to the account.</p>
  9337. </td>
  9338. </tr>
  9339. <tr>
  9340. <td>
  9341. <code>secretRef</code></br>
  9342. <em>
  9343. <a href="#external-secrets.io/v1.OracleSecretRef">
  9344. OracleSecretRef
  9345. </a>
  9346. </em>
  9347. </td>
  9348. <td>
  9349. <p>SecretRef to pass through sensitive information.</p>
  9350. </td>
  9351. </tr>
  9352. </tbody>
  9353. </table>
  9354. <h3 id="external-secrets.io/v1.OraclePrincipalType">OraclePrincipalType
  9355. (<code>string</code> alias)</p></h3>
  9356. <p>
  9357. (<em>Appears on:</em>
  9358. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  9359. </p>
  9360. <p>
  9361. <p>OraclePrincipalType defines the type of principal used for authentication with Oracle Vault.</p>
  9362. </p>
  9363. <table>
  9364. <thead>
  9365. <tr>
  9366. <th>Value</th>
  9367. <th>Description</th>
  9368. </tr>
  9369. </thead>
  9370. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  9371. <td><p>InstancePrincipal represents a instance principal.</p>
  9372. </td>
  9373. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  9374. <td><p>UserPrincipal represents a user principal.</p>
  9375. </td>
  9376. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  9377. <td><p>WorkloadPrincipal represents a workload principal.</p>
  9378. </td>
  9379. </tr></tbody>
  9380. </table>
  9381. <h3 id="external-secrets.io/v1.OracleProvider">OracleProvider
  9382. </h3>
  9383. <p>
  9384. (<em>Appears on:</em>
  9385. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9386. </p>
  9387. <p>
  9388. <p>OracleProvider configures a store to sync secrets using an Oracle Vault
  9389. backend.</p>
  9390. </p>
  9391. <table>
  9392. <thead>
  9393. <tr>
  9394. <th>Field</th>
  9395. <th>Description</th>
  9396. </tr>
  9397. </thead>
  9398. <tbody>
  9399. <tr>
  9400. <td>
  9401. <code>region</code></br>
  9402. <em>
  9403. string
  9404. </em>
  9405. </td>
  9406. <td>
  9407. <p>Region is the region where vault is located.</p>
  9408. </td>
  9409. </tr>
  9410. <tr>
  9411. <td>
  9412. <code>vault</code></br>
  9413. <em>
  9414. string
  9415. </em>
  9416. </td>
  9417. <td>
  9418. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  9419. </td>
  9420. </tr>
  9421. <tr>
  9422. <td>
  9423. <code>compartment</code></br>
  9424. <em>
  9425. string
  9426. </em>
  9427. </td>
  9428. <td>
  9429. <em>(Optional)</em>
  9430. <p>Compartment is the vault compartment OCID.
  9431. Required for PushSecret</p>
  9432. </td>
  9433. </tr>
  9434. <tr>
  9435. <td>
  9436. <code>encryptionKey</code></br>
  9437. <em>
  9438. string
  9439. </em>
  9440. </td>
  9441. <td>
  9442. <em>(Optional)</em>
  9443. <p>EncryptionKey is the OCID of the encryption key within the vault.
  9444. Required for PushSecret</p>
  9445. </td>
  9446. </tr>
  9447. <tr>
  9448. <td>
  9449. <code>principalType</code></br>
  9450. <em>
  9451. <a href="#external-secrets.io/v1.OraclePrincipalType">
  9452. OraclePrincipalType
  9453. </a>
  9454. </em>
  9455. </td>
  9456. <td>
  9457. <em>(Optional)</em>
  9458. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  9459. determine the principal type. This optional field must be specified if using
  9460. workload identity.</p>
  9461. </td>
  9462. </tr>
  9463. <tr>
  9464. <td>
  9465. <code>auth</code></br>
  9466. <em>
  9467. <a href="#external-secrets.io/v1.OracleAuth">
  9468. OracleAuth
  9469. </a>
  9470. </em>
  9471. </td>
  9472. <td>
  9473. <em>(Optional)</em>
  9474. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  9475. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  9476. </td>
  9477. </tr>
  9478. <tr>
  9479. <td>
  9480. <code>serviceAccountRef</code></br>
  9481. <em>
  9482. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  9483. External Secrets meta/v1.ServiceAccountSelector
  9484. </a>
  9485. </em>
  9486. </td>
  9487. <td>
  9488. <em>(Optional)</em>
  9489. <p>ServiceAccountRef specified the service account
  9490. that should be used when authenticating with WorkloadIdentity.</p>
  9491. </td>
  9492. </tr>
  9493. </tbody>
  9494. </table>
  9495. <h3 id="external-secrets.io/v1.OracleSecretRef">OracleSecretRef
  9496. </h3>
  9497. <p>
  9498. (<em>Appears on:</em>
  9499. <a href="#external-secrets.io/v1.OracleAuth">OracleAuth</a>)
  9500. </p>
  9501. <p>
  9502. <p>OracleSecretRef contains the secret reference for Oracle Vault authentication credentials.</p>
  9503. </p>
  9504. <table>
  9505. <thead>
  9506. <tr>
  9507. <th>Field</th>
  9508. <th>Description</th>
  9509. </tr>
  9510. </thead>
  9511. <tbody>
  9512. <tr>
  9513. <td>
  9514. <code>privatekey</code></br>
  9515. <em>
  9516. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9517. External Secrets meta/v1.SecretKeySelector
  9518. </a>
  9519. </em>
  9520. </td>
  9521. <td>
  9522. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  9523. </td>
  9524. </tr>
  9525. <tr>
  9526. <td>
  9527. <code>fingerprint</code></br>
  9528. <em>
  9529. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9530. External Secrets meta/v1.SecretKeySelector
  9531. </a>
  9532. </em>
  9533. </td>
  9534. <td>
  9535. <p>Fingerprint is the fingerprint of the API private key.</p>
  9536. </td>
  9537. </tr>
  9538. </tbody>
  9539. </table>
  9540. <h3 id="external-secrets.io/v1.OvhAuth">OvhAuth
  9541. </h3>
  9542. <p>
  9543. (<em>Appears on:</em>
  9544. <a href="#external-secrets.io/v1.OvhProvider">OvhProvider</a>)
  9545. </p>
  9546. <p>
  9547. <p>OvhAuth tells the controller how to authenticate to OVHcloud&rsquo;s Secret Manager, either using mTLS or a token.</p>
  9548. </p>
  9549. <table>
  9550. <thead>
  9551. <tr>
  9552. <th>Field</th>
  9553. <th>Description</th>
  9554. </tr>
  9555. </thead>
  9556. <tbody>
  9557. <tr>
  9558. <td>
  9559. <code>mtls</code></br>
  9560. <em>
  9561. <a href="#external-secrets.io/v1.OvhClientMTLS">
  9562. OvhClientMTLS
  9563. </a>
  9564. </em>
  9565. </td>
  9566. <td>
  9567. <em>(Optional)</em>
  9568. </td>
  9569. </tr>
  9570. <tr>
  9571. <td>
  9572. <code>token</code></br>
  9573. <em>
  9574. <a href="#external-secrets.io/v1.OvhClientToken">
  9575. OvhClientToken
  9576. </a>
  9577. </em>
  9578. </td>
  9579. <td>
  9580. <em>(Optional)</em>
  9581. </td>
  9582. </tr>
  9583. </tbody>
  9584. </table>
  9585. <h3 id="external-secrets.io/v1.OvhClientMTLS">OvhClientMTLS
  9586. </h3>
  9587. <p>
  9588. (<em>Appears on:</em>
  9589. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  9590. </p>
  9591. <p>
  9592. <p>OvhClientMTLS defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using mTLS.</p>
  9593. </p>
  9594. <table>
  9595. <thead>
  9596. <tr>
  9597. <th>Field</th>
  9598. <th>Description</th>
  9599. </tr>
  9600. </thead>
  9601. <tbody>
  9602. <tr>
  9603. <td>
  9604. <code>certSecretRef</code></br>
  9605. <em>
  9606. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9607. External Secrets meta/v1.SecretKeySelector
  9608. </a>
  9609. </em>
  9610. </td>
  9611. <td>
  9612. </td>
  9613. </tr>
  9614. <tr>
  9615. <td>
  9616. <code>keySecretRef</code></br>
  9617. <em>
  9618. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9619. External Secrets meta/v1.SecretKeySelector
  9620. </a>
  9621. </em>
  9622. </td>
  9623. <td>
  9624. </td>
  9625. </tr>
  9626. <tr>
  9627. <td>
  9628. <code>caBundle</code></br>
  9629. <em>
  9630. []byte
  9631. </em>
  9632. </td>
  9633. <td>
  9634. <em>(Optional)</em>
  9635. </td>
  9636. </tr>
  9637. <tr>
  9638. <td>
  9639. <code>caProvider</code></br>
  9640. <em>
  9641. <a href="#external-secrets.io/v1.CAProvider">
  9642. CAProvider
  9643. </a>
  9644. </em>
  9645. </td>
  9646. <td>
  9647. <em>(Optional)</em>
  9648. </td>
  9649. </tr>
  9650. </tbody>
  9651. </table>
  9652. <h3 id="external-secrets.io/v1.OvhClientToken">OvhClientToken
  9653. </h3>
  9654. <p>
  9655. (<em>Appears on:</em>
  9656. <a href="#external-secrets.io/v1.OvhAuth">OvhAuth</a>)
  9657. </p>
  9658. <p>
  9659. <p>OvhClientToken defines the configuration required to authenticate to OVHcloud&rsquo;s Secret Manager using a token.</p>
  9660. </p>
  9661. <table>
  9662. <thead>
  9663. <tr>
  9664. <th>Field</th>
  9665. <th>Description</th>
  9666. </tr>
  9667. </thead>
  9668. <tbody>
  9669. <tr>
  9670. <td>
  9671. <code>tokenSecretRef</code></br>
  9672. <em>
  9673. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9674. External Secrets meta/v1.SecretKeySelector
  9675. </a>
  9676. </em>
  9677. </td>
  9678. <td>
  9679. </td>
  9680. </tr>
  9681. </tbody>
  9682. </table>
  9683. <h3 id="external-secrets.io/v1.OvhProvider">OvhProvider
  9684. </h3>
  9685. <p>
  9686. (<em>Appears on:</em>
  9687. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9688. </p>
  9689. <p>
  9690. <p>OvhProvider holds the configuration to synchronize secrets with OVHcloud&rsquo;s Secret Manager.</p>
  9691. </p>
  9692. <table>
  9693. <thead>
  9694. <tr>
  9695. <th>Field</th>
  9696. <th>Description</th>
  9697. </tr>
  9698. </thead>
  9699. <tbody>
  9700. <tr>
  9701. <td>
  9702. <code>server</code></br>
  9703. <em>
  9704. string
  9705. </em>
  9706. </td>
  9707. <td>
  9708. <p>specifies the OKMS server endpoint.</p>
  9709. </td>
  9710. </tr>
  9711. <tr>
  9712. <td>
  9713. <code>okmsid</code></br>
  9714. <em>
  9715. string
  9716. </em>
  9717. </td>
  9718. <td>
  9719. <p>specifies the OKMS ID.</p>
  9720. </td>
  9721. </tr>
  9722. <tr>
  9723. <td>
  9724. <code>casRequired</code></br>
  9725. <em>
  9726. bool
  9727. </em>
  9728. </td>
  9729. <td>
  9730. <em>(Optional)</em>
  9731. <p>Enables or disables check-and-set (CAS) (default: false).</p>
  9732. </td>
  9733. </tr>
  9734. <tr>
  9735. <td>
  9736. <code>okmsTimeout</code></br>
  9737. <em>
  9738. uint32
  9739. </em>
  9740. </td>
  9741. <td>
  9742. <em>(Optional)</em>
  9743. <p>Setup a timeout in seconds when requests to the KMS are made (default: 30).</p>
  9744. </td>
  9745. </tr>
  9746. <tr>
  9747. <td>
  9748. <code>auth</code></br>
  9749. <em>
  9750. <a href="#external-secrets.io/v1.OvhAuth">
  9751. OvhAuth
  9752. </a>
  9753. </em>
  9754. </td>
  9755. <td>
  9756. <p>Authentication method (mtls or token).</p>
  9757. </td>
  9758. </tr>
  9759. </tbody>
  9760. </table>
  9761. <h3 id="external-secrets.io/v1.PassboltAuth">PassboltAuth
  9762. </h3>
  9763. <p>
  9764. (<em>Appears on:</em>
  9765. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>)
  9766. </p>
  9767. <p>
  9768. <p>PassboltAuth contains a secretRef for the passbolt credentials.</p>
  9769. </p>
  9770. <table>
  9771. <thead>
  9772. <tr>
  9773. <th>Field</th>
  9774. <th>Description</th>
  9775. </tr>
  9776. </thead>
  9777. <tbody>
  9778. <tr>
  9779. <td>
  9780. <code>passwordSecretRef</code></br>
  9781. <em>
  9782. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9783. External Secrets meta/v1.SecretKeySelector
  9784. </a>
  9785. </em>
  9786. </td>
  9787. <td>
  9788. </td>
  9789. </tr>
  9790. <tr>
  9791. <td>
  9792. <code>privateKeySecretRef</code></br>
  9793. <em>
  9794. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9795. External Secrets meta/v1.SecretKeySelector
  9796. </a>
  9797. </em>
  9798. </td>
  9799. <td>
  9800. </td>
  9801. </tr>
  9802. </tbody>
  9803. </table>
  9804. <h3 id="external-secrets.io/v1.PassboltProvider">PassboltProvider
  9805. </h3>
  9806. <p>
  9807. (<em>Appears on:</em>
  9808. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9809. </p>
  9810. <p>
  9811. <p>PassboltProvider provides access to Passbolt secrets manager.
  9812. See: <a href="https://www.passbolt.com">https://www.passbolt.com</a>.</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>auth</code></br>
  9825. <em>
  9826. <a href="#external-secrets.io/v1.PassboltAuth">
  9827. PassboltAuth
  9828. </a>
  9829. </em>
  9830. </td>
  9831. <td>
  9832. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  9833. </td>
  9834. </tr>
  9835. <tr>
  9836. <td>
  9837. <code>host</code></br>
  9838. <em>
  9839. string
  9840. </em>
  9841. </td>
  9842. <td>
  9843. <p>Host defines the Passbolt Server to connect to</p>
  9844. </td>
  9845. </tr>
  9846. <tr>
  9847. <td>
  9848. <code>caBundle</code></br>
  9849. <em>
  9850. []byte
  9851. </em>
  9852. </td>
  9853. <td>
  9854. <em>(Optional)</em>
  9855. <p>PEM encoded CA bundle used to validate Passbolt server certificate. Only used
  9856. if the Host URL is using HTTPS protocol. If not set the system root certificates
  9857. are used to validate the TLS connection.</p>
  9858. </td>
  9859. </tr>
  9860. <tr>
  9861. <td>
  9862. <code>caProvider</code></br>
  9863. <em>
  9864. <a href="#external-secrets.io/v1.CAProvider">
  9865. CAProvider
  9866. </a>
  9867. </em>
  9868. </td>
  9869. <td>
  9870. <em>(Optional)</em>
  9871. <p>The provider for the CA bundle to use to validate Passbolt server certificate.</p>
  9872. </td>
  9873. </tr>
  9874. </tbody>
  9875. </table>
  9876. <h3 id="external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth
  9877. </h3>
  9878. <p>
  9879. (<em>Appears on:</em>
  9880. <a href="#external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider</a>)
  9881. </p>
  9882. <p>
  9883. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  9884. </p>
  9885. <table>
  9886. <thead>
  9887. <tr>
  9888. <th>Field</th>
  9889. <th>Description</th>
  9890. </tr>
  9891. </thead>
  9892. <tbody>
  9893. <tr>
  9894. <td>
  9895. <code>secretRef</code></br>
  9896. <em>
  9897. <a href="#external-secrets.io/v1.PasswordDepotSecretRef">
  9898. PasswordDepotSecretRef
  9899. </a>
  9900. </em>
  9901. </td>
  9902. <td>
  9903. </td>
  9904. </tr>
  9905. </tbody>
  9906. </table>
  9907. <h3 id="external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider
  9908. </h3>
  9909. <p>
  9910. (<em>Appears on:</em>
  9911. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9912. </p>
  9913. <p>
  9914. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  9915. </p>
  9916. <table>
  9917. <thead>
  9918. <tr>
  9919. <th>Field</th>
  9920. <th>Description</th>
  9921. </tr>
  9922. </thead>
  9923. <tbody>
  9924. <tr>
  9925. <td>
  9926. <code>host</code></br>
  9927. <em>
  9928. string
  9929. </em>
  9930. </td>
  9931. <td>
  9932. <p>URL configures the Password Depot instance URL.</p>
  9933. </td>
  9934. </tr>
  9935. <tr>
  9936. <td>
  9937. <code>database</code></br>
  9938. <em>
  9939. string
  9940. </em>
  9941. </td>
  9942. <td>
  9943. <p>Database to use as source</p>
  9944. </td>
  9945. </tr>
  9946. <tr>
  9947. <td>
  9948. <code>auth</code></br>
  9949. <em>
  9950. <a href="#external-secrets.io/v1.PasswordDepotAuth">
  9951. PasswordDepotAuth
  9952. </a>
  9953. </em>
  9954. </td>
  9955. <td>
  9956. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  9957. </td>
  9958. </tr>
  9959. </tbody>
  9960. </table>
  9961. <h3 id="external-secrets.io/v1.PasswordDepotSecretRef">PasswordDepotSecretRef
  9962. </h3>
  9963. <p>
  9964. (<em>Appears on:</em>
  9965. <a href="#external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth</a>)
  9966. </p>
  9967. <p>
  9968. <p>PasswordDepotSecretRef contains the secret reference for Password Depot authentication.</p>
  9969. </p>
  9970. <table>
  9971. <thead>
  9972. <tr>
  9973. <th>Field</th>
  9974. <th>Description</th>
  9975. </tr>
  9976. </thead>
  9977. <tbody>
  9978. <tr>
  9979. <td>
  9980. <code>credentials</code></br>
  9981. <em>
  9982. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9983. External Secrets meta/v1.SecretKeySelector
  9984. </a>
  9985. </em>
  9986. </td>
  9987. <td>
  9988. <em>(Optional)</em>
  9989. <p>Username / Password is used for authentication.</p>
  9990. </td>
  9991. </tr>
  9992. </tbody>
  9993. </table>
  9994. <h3 id="external-secrets.io/v1.PreviderAuth">PreviderAuth
  9995. </h3>
  9996. <p>
  9997. (<em>Appears on:</em>
  9998. <a href="#external-secrets.io/v1.PreviderProvider">PreviderProvider</a>)
  9999. </p>
  10000. <p>
  10001. <p>PreviderAuth contains a secretRef for credentials.</p>
  10002. </p>
  10003. <table>
  10004. <thead>
  10005. <tr>
  10006. <th>Field</th>
  10007. <th>Description</th>
  10008. </tr>
  10009. </thead>
  10010. <tbody>
  10011. <tr>
  10012. <td>
  10013. <code>secretRef</code></br>
  10014. <em>
  10015. <a href="#external-secrets.io/v1.PreviderAuthSecretRef">
  10016. PreviderAuthSecretRef
  10017. </a>
  10018. </em>
  10019. </td>
  10020. <td>
  10021. <em>(Optional)</em>
  10022. </td>
  10023. </tr>
  10024. </tbody>
  10025. </table>
  10026. <h3 id="external-secrets.io/v1.PreviderAuthSecretRef">PreviderAuthSecretRef
  10027. </h3>
  10028. <p>
  10029. (<em>Appears on:</em>
  10030. <a href="#external-secrets.io/v1.PreviderAuth">PreviderAuth</a>)
  10031. </p>
  10032. <p>
  10033. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  10034. </p>
  10035. <table>
  10036. <thead>
  10037. <tr>
  10038. <th>Field</th>
  10039. <th>Description</th>
  10040. </tr>
  10041. </thead>
  10042. <tbody>
  10043. <tr>
  10044. <td>
  10045. <code>accessToken</code></br>
  10046. <em>
  10047. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10048. External Secrets meta/v1.SecretKeySelector
  10049. </a>
  10050. </em>
  10051. </td>
  10052. <td>
  10053. <p>The AccessToken is used for authentication</p>
  10054. </td>
  10055. </tr>
  10056. </tbody>
  10057. </table>
  10058. <h3 id="external-secrets.io/v1.PreviderProvider">PreviderProvider
  10059. </h3>
  10060. <p>
  10061. (<em>Appears on:</em>
  10062. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10063. </p>
  10064. <p>
  10065. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  10066. </p>
  10067. <table>
  10068. <thead>
  10069. <tr>
  10070. <th>Field</th>
  10071. <th>Description</th>
  10072. </tr>
  10073. </thead>
  10074. <tbody>
  10075. <tr>
  10076. <td>
  10077. <code>auth</code></br>
  10078. <em>
  10079. <a href="#external-secrets.io/v1.PreviderAuth">
  10080. PreviderAuth
  10081. </a>
  10082. </em>
  10083. </td>
  10084. <td>
  10085. </td>
  10086. </tr>
  10087. <tr>
  10088. <td>
  10089. <code>baseUri</code></br>
  10090. <em>
  10091. string
  10092. </em>
  10093. </td>
  10094. <td>
  10095. <em>(Optional)</em>
  10096. </td>
  10097. </tr>
  10098. </tbody>
  10099. </table>
  10100. <h3 id="external-secrets.io/v1.Provider">Provider
  10101. </h3>
  10102. <p>
  10103. <p>Provider is a common interface for interacting with secret backends.</p>
  10104. </p>
  10105. <h3 id="external-secrets.io/v1.PulumiAuth">PulumiAuth
  10106. </h3>
  10107. <p>
  10108. (<em>Appears on:</em>
  10109. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  10110. </p>
  10111. <p>
  10112. <p>PulumiAuth configures authentication with the Pulumi API.
  10113. Exactly one of accessToken or oidcConfig must be specified.</p>
  10114. </p>
  10115. <table>
  10116. <thead>
  10117. <tr>
  10118. <th>Field</th>
  10119. <th>Description</th>
  10120. </tr>
  10121. </thead>
  10122. <tbody>
  10123. <tr>
  10124. <td>
  10125. <code>accessToken</code></br>
  10126. <em>
  10127. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  10128. PulumiProviderSecretRef
  10129. </a>
  10130. </em>
  10131. </td>
  10132. <td>
  10133. <em>(Optional)</em>
  10134. <p>AccessToken authenticates using a Pulumi access token stored in a Kubernetes Secret.</p>
  10135. </td>
  10136. </tr>
  10137. <tr>
  10138. <td>
  10139. <code>oidcConfig</code></br>
  10140. <em>
  10141. <a href="#external-secrets.io/v1.PulumiOIDCAuth">
  10142. PulumiOIDCAuth
  10143. </a>
  10144. </em>
  10145. </td>
  10146. <td>
  10147. <em>(Optional)</em>
  10148. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  10149. </td>
  10150. </tr>
  10151. </tbody>
  10152. </table>
  10153. <h3 id="external-secrets.io/v1.PulumiOIDCAuth">PulumiOIDCAuth
  10154. </h3>
  10155. <p>
  10156. (<em>Appears on:</em>
  10157. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>)
  10158. </p>
  10159. <p>
  10160. <p>PulumiOIDCAuth configures OIDC authentication with Pulumi using Kubernetes ServiceAccount tokens.</p>
  10161. </p>
  10162. <table>
  10163. <thead>
  10164. <tr>
  10165. <th>Field</th>
  10166. <th>Description</th>
  10167. </tr>
  10168. </thead>
  10169. <tbody>
  10170. <tr>
  10171. <td>
  10172. <code>organization</code></br>
  10173. <em>
  10174. string
  10175. </em>
  10176. </td>
  10177. <td>
  10178. <p>Organization is the name of the Pulumi organization configured for OIDC authentication.</p>
  10179. </td>
  10180. </tr>
  10181. <tr>
  10182. <td>
  10183. <code>serviceAccountRef</code></br>
  10184. <em>
  10185. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  10186. External Secrets meta/v1.ServiceAccountSelector
  10187. </a>
  10188. </em>
  10189. </td>
  10190. <td>
  10191. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  10192. </td>
  10193. </tr>
  10194. <tr>
  10195. <td>
  10196. <code>expirationSeconds</code></br>
  10197. <em>
  10198. int64
  10199. </em>
  10200. </td>
  10201. <td>
  10202. <em>(Optional)</em>
  10203. <p>ExpirationSeconds sets the token validity duration for service account and OIDC token.
  10204. Defaults to 10 minutes.</p>
  10205. </td>
  10206. </tr>
  10207. </tbody>
  10208. </table>
  10209. <h3 id="external-secrets.io/v1.PulumiProvider">PulumiProvider
  10210. </h3>
  10211. <p>
  10212. (<em>Appears on:</em>
  10213. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10214. </p>
  10215. <p>
  10216. <p>PulumiProvider defines configuration for accessing secrets from Pulumi ESC.</p>
  10217. </p>
  10218. <table>
  10219. <thead>
  10220. <tr>
  10221. <th>Field</th>
  10222. <th>Description</th>
  10223. </tr>
  10224. </thead>
  10225. <tbody>
  10226. <tr>
  10227. <td>
  10228. <code>apiUrl</code></br>
  10229. <em>
  10230. string
  10231. </em>
  10232. </td>
  10233. <td>
  10234. <p>APIURL is the URL of the Pulumi API.</p>
  10235. </td>
  10236. </tr>
  10237. <tr>
  10238. <td>
  10239. <code>auth</code></br>
  10240. <em>
  10241. <a href="#external-secrets.io/v1.PulumiAuth">
  10242. PulumiAuth
  10243. </a>
  10244. </em>
  10245. </td>
  10246. <td>
  10247. <em>(Optional)</em>
  10248. <p>Auth configures how the Operator authenticates with the Pulumi API.
  10249. Either auth or the deprecated accessToken field must be specified.</p>
  10250. </td>
  10251. </tr>
  10252. <tr>
  10253. <td>
  10254. <code>organization</code></br>
  10255. <em>
  10256. string
  10257. </em>
  10258. </td>
  10259. <td>
  10260. <p>Organization are a space to collaborate on shared projects and stacks.
  10261. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  10262. </td>
  10263. </tr>
  10264. <tr>
  10265. <td>
  10266. <code>project</code></br>
  10267. <em>
  10268. string
  10269. </em>
  10270. </td>
  10271. <td>
  10272. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  10273. </td>
  10274. </tr>
  10275. <tr>
  10276. <td>
  10277. <code>environment</code></br>
  10278. <em>
  10279. string
  10280. </em>
  10281. </td>
  10282. <td>
  10283. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  10284. dynamically retrieved values from supported providers including all major clouds,
  10285. and other Pulumi ESC environments.
  10286. 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>
  10287. </td>
  10288. </tr>
  10289. <tr>
  10290. <td>
  10291. <code>accessToken</code></br>
  10292. <em>
  10293. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  10294. PulumiProviderSecretRef
  10295. </a>
  10296. </em>
  10297. </td>
  10298. <td>
  10299. <em>(Optional)</em>
  10300. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  10301. <p>Deprecated: Use auth.accessToken instead.</p>
  10302. </td>
  10303. </tr>
  10304. </tbody>
  10305. </table>
  10306. <h3 id="external-secrets.io/v1.PulumiProviderSecretRef">PulumiProviderSecretRef
  10307. </h3>
  10308. <p>
  10309. (<em>Appears on:</em>
  10310. <a href="#external-secrets.io/v1.PulumiAuth">PulumiAuth</a>,
  10311. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  10312. </p>
  10313. <p>
  10314. <p>PulumiProviderSecretRef contains the secret reference for Pulumi authentication.</p>
  10315. </p>
  10316. <table>
  10317. <thead>
  10318. <tr>
  10319. <th>Field</th>
  10320. <th>Description</th>
  10321. </tr>
  10322. </thead>
  10323. <tbody>
  10324. <tr>
  10325. <td>
  10326. <code>secretRef</code></br>
  10327. <em>
  10328. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10329. External Secrets meta/v1.SecretKeySelector
  10330. </a>
  10331. </em>
  10332. </td>
  10333. <td>
  10334. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  10335. </td>
  10336. </tr>
  10337. </tbody>
  10338. </table>
  10339. <h3 id="external-secrets.io/v1.PushSecretData">PushSecretData
  10340. </h3>
  10341. <p>
  10342. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1.</p>
  10343. </p>
  10344. <h3 id="external-secrets.io/v1.PushSecretRemoteRef">PushSecretRemoteRef
  10345. </h3>
  10346. <p>
  10347. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1.</p>
  10348. </p>
  10349. <h3 id="external-secrets.io/v1.ScalewayProvider">ScalewayProvider
  10350. </h3>
  10351. <p>
  10352. (<em>Appears on:</em>
  10353. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10354. </p>
  10355. <p>
  10356. <p>ScalewayProvider defines the configuration for the Scaleway Secret Manager provider.</p>
  10357. </p>
  10358. <table>
  10359. <thead>
  10360. <tr>
  10361. <th>Field</th>
  10362. <th>Description</th>
  10363. </tr>
  10364. </thead>
  10365. <tbody>
  10366. <tr>
  10367. <td>
  10368. <code>apiUrl</code></br>
  10369. <em>
  10370. string
  10371. </em>
  10372. </td>
  10373. <td>
  10374. <em>(Optional)</em>
  10375. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  10376. </td>
  10377. </tr>
  10378. <tr>
  10379. <td>
  10380. <code>region</code></br>
  10381. <em>
  10382. string
  10383. </em>
  10384. </td>
  10385. <td>
  10386. <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>
  10387. </td>
  10388. </tr>
  10389. <tr>
  10390. <td>
  10391. <code>projectId</code></br>
  10392. <em>
  10393. string
  10394. </em>
  10395. </td>
  10396. <td>
  10397. <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>
  10398. </td>
  10399. </tr>
  10400. <tr>
  10401. <td>
  10402. <code>accessKey</code></br>
  10403. <em>
  10404. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  10405. ScalewayProviderSecretRef
  10406. </a>
  10407. </em>
  10408. </td>
  10409. <td>
  10410. <p>AccessKey is the non-secret part of the api key.</p>
  10411. </td>
  10412. </tr>
  10413. <tr>
  10414. <td>
  10415. <code>secretKey</code></br>
  10416. <em>
  10417. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  10418. ScalewayProviderSecretRef
  10419. </a>
  10420. </em>
  10421. </td>
  10422. <td>
  10423. <p>SecretKey is the non-secret part of the api key.</p>
  10424. </td>
  10425. </tr>
  10426. </tbody>
  10427. </table>
  10428. <h3 id="external-secrets.io/v1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  10429. </h3>
  10430. <p>
  10431. (<em>Appears on:</em>
  10432. <a href="#external-secrets.io/v1.ScalewayProvider">ScalewayProvider</a>)
  10433. </p>
  10434. <p>
  10435. <p>ScalewayProviderSecretRef defines the configuration for Scaleway secret references.</p>
  10436. </p>
  10437. <table>
  10438. <thead>
  10439. <tr>
  10440. <th>Field</th>
  10441. <th>Description</th>
  10442. </tr>
  10443. </thead>
  10444. <tbody>
  10445. <tr>
  10446. <td>
  10447. <code>value</code></br>
  10448. <em>
  10449. string
  10450. </em>
  10451. </td>
  10452. <td>
  10453. <em>(Optional)</em>
  10454. <p>Value can be specified directly to set a value without using a secret.</p>
  10455. </td>
  10456. </tr>
  10457. <tr>
  10458. <td>
  10459. <code>secretRef</code></br>
  10460. <em>
  10461. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10462. External Secrets meta/v1.SecretKeySelector
  10463. </a>
  10464. </em>
  10465. </td>
  10466. <td>
  10467. <em>(Optional)</em>
  10468. <p>SecretRef references a key in a secret that will be used as value.</p>
  10469. </td>
  10470. </tr>
  10471. </tbody>
  10472. </table>
  10473. <h3 id="external-secrets.io/v1.SecretReference">SecretReference
  10474. </h3>
  10475. <p>
  10476. (<em>Appears on:</em>
  10477. <a href="#external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig</a>)
  10478. </p>
  10479. <p>
  10480. <p>SecretReference holds the details of a secret.</p>
  10481. </p>
  10482. <table>
  10483. <thead>
  10484. <tr>
  10485. <th>Field</th>
  10486. <th>Description</th>
  10487. </tr>
  10488. </thead>
  10489. <tbody>
  10490. <tr>
  10491. <td>
  10492. <code>name</code></br>
  10493. <em>
  10494. string
  10495. </em>
  10496. </td>
  10497. <td>
  10498. <p>name of the secret.</p>
  10499. </td>
  10500. </tr>
  10501. <tr>
  10502. <td>
  10503. <code>namespace</code></br>
  10504. <em>
  10505. string
  10506. </em>
  10507. </td>
  10508. <td>
  10509. <p>namespace in which the secret exists. If empty, secret will looked up in local namespace.</p>
  10510. </td>
  10511. </tr>
  10512. </tbody>
  10513. </table>
  10514. <h3 id="external-secrets.io/v1.SecretServerProvider">SecretServerProvider
  10515. </h3>
  10516. <p>
  10517. (<em>Appears on:</em>
  10518. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10519. </p>
  10520. <p>
  10521. <p>SecretServerProvider provides access to authenticate to a secrets provider server.
  10522. 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>
  10523. </p>
  10524. <table>
  10525. <thead>
  10526. <tr>
  10527. <th>Field</th>
  10528. <th>Description</th>
  10529. </tr>
  10530. </thead>
  10531. <tbody>
  10532. <tr>
  10533. <td>
  10534. <code>username</code></br>
  10535. <em>
  10536. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  10537. SecretServerProviderRef
  10538. </a>
  10539. </em>
  10540. </td>
  10541. <td>
  10542. <p>Username is the secret server account username.</p>
  10543. </td>
  10544. </tr>
  10545. <tr>
  10546. <td>
  10547. <code>password</code></br>
  10548. <em>
  10549. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  10550. SecretServerProviderRef
  10551. </a>
  10552. </em>
  10553. </td>
  10554. <td>
  10555. <p>Password is the secret server account password.</p>
  10556. </td>
  10557. </tr>
  10558. <tr>
  10559. <td>
  10560. <code>domain</code></br>
  10561. <em>
  10562. string
  10563. </em>
  10564. </td>
  10565. <td>
  10566. <em>(Optional)</em>
  10567. <p>Domain is the secret server domain.</p>
  10568. </td>
  10569. </tr>
  10570. <tr>
  10571. <td>
  10572. <code>serverURL</code></br>
  10573. <em>
  10574. string
  10575. </em>
  10576. </td>
  10577. <td>
  10578. <p>ServerURL
  10579. URL to your secret server installation</p>
  10580. </td>
  10581. </tr>
  10582. <tr>
  10583. <td>
  10584. <code>caBundle</code></br>
  10585. <em>
  10586. []byte
  10587. </em>
  10588. </td>
  10589. <td>
  10590. <em>(Optional)</em>
  10591. <p>PEM/base64 encoded CA bundle used to validate Secret ServerURL. Only used
  10592. if the ServerURL URL is using HTTPS protocol. If not set the system root certificates
  10593. are used to validate the TLS connection.</p>
  10594. </td>
  10595. </tr>
  10596. <tr>
  10597. <td>
  10598. <code>caProvider</code></br>
  10599. <em>
  10600. <a href="#external-secrets.io/v1.CAProvider">
  10601. CAProvider
  10602. </a>
  10603. </em>
  10604. </td>
  10605. <td>
  10606. <em>(Optional)</em>
  10607. <p>The provider for the CA bundle to use to validate Secret ServerURL certificate.</p>
  10608. </td>
  10609. </tr>
  10610. </tbody>
  10611. </table>
  10612. <h3 id="external-secrets.io/v1.SecretServerProviderRef">SecretServerProviderRef
  10613. </h3>
  10614. <p>
  10615. (<em>Appears on:</em>
  10616. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>)
  10617. </p>
  10618. <p>
  10619. <p>SecretServerProviderRef references a value that can be specified directly or via a secret
  10620. for a SecretServerProvider.</p>
  10621. </p>
  10622. <table>
  10623. <thead>
  10624. <tr>
  10625. <th>Field</th>
  10626. <th>Description</th>
  10627. </tr>
  10628. </thead>
  10629. <tbody>
  10630. <tr>
  10631. <td>
  10632. <code>value</code></br>
  10633. <em>
  10634. string
  10635. </em>
  10636. </td>
  10637. <td>
  10638. <em>(Optional)</em>
  10639. <p>Value can be specified directly to set a value without using a secret.</p>
  10640. </td>
  10641. </tr>
  10642. <tr>
  10643. <td>
  10644. <code>secretRef</code></br>
  10645. <em>
  10646. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10647. External Secrets meta/v1.SecretKeySelector
  10648. </a>
  10649. </em>
  10650. </td>
  10651. <td>
  10652. <em>(Optional)</em>
  10653. <p>SecretRef references a key in a secret that will be used as value.</p>
  10654. </td>
  10655. </tr>
  10656. </tbody>
  10657. </table>
  10658. <h3 id="external-secrets.io/v1.SecretStore">SecretStore
  10659. </h3>
  10660. <p>
  10661. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  10662. </p>
  10663. <table>
  10664. <thead>
  10665. <tr>
  10666. <th>Field</th>
  10667. <th>Description</th>
  10668. </tr>
  10669. </thead>
  10670. <tbody>
  10671. <tr>
  10672. <td>
  10673. <code>metadata</code></br>
  10674. <em>
  10675. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  10676. Kubernetes meta/v1.ObjectMeta
  10677. </a>
  10678. </em>
  10679. </td>
  10680. <td>
  10681. Refer to the Kubernetes API documentation for the fields of the
  10682. <code>metadata</code> field.
  10683. </td>
  10684. </tr>
  10685. <tr>
  10686. <td>
  10687. <code>spec</code></br>
  10688. <em>
  10689. <a href="#external-secrets.io/v1.SecretStoreSpec">
  10690. SecretStoreSpec
  10691. </a>
  10692. </em>
  10693. </td>
  10694. <td>
  10695. <br/>
  10696. <br/>
  10697. <table>
  10698. <tr>
  10699. <td>
  10700. <code>controller</code></br>
  10701. <em>
  10702. string
  10703. </em>
  10704. </td>
  10705. <td>
  10706. <em>(Optional)</em>
  10707. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  10708. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  10709. </td>
  10710. </tr>
  10711. <tr>
  10712. <td>
  10713. <code>provider</code></br>
  10714. <em>
  10715. <a href="#external-secrets.io/v1.SecretStoreProvider">
  10716. SecretStoreProvider
  10717. </a>
  10718. </em>
  10719. </td>
  10720. <td>
  10721. <p>Used to configure the provider. Only one provider may be set</p>
  10722. </td>
  10723. </tr>
  10724. <tr>
  10725. <td>
  10726. <code>retrySettings</code></br>
  10727. <em>
  10728. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  10729. SecretStoreRetrySettings
  10730. </a>
  10731. </em>
  10732. </td>
  10733. <td>
  10734. <em>(Optional)</em>
  10735. <p>Used to configure HTTP retries on failures.</p>
  10736. </td>
  10737. </tr>
  10738. <tr>
  10739. <td>
  10740. <code>refreshInterval</code></br>
  10741. <em>
  10742. int
  10743. </em>
  10744. </td>
  10745. <td>
  10746. <em>(Optional)</em>
  10747. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  10748. </td>
  10749. </tr>
  10750. <tr>
  10751. <td>
  10752. <code>conditions</code></br>
  10753. <em>
  10754. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  10755. []ClusterSecretStoreCondition
  10756. </a>
  10757. </em>
  10758. </td>
  10759. <td>
  10760. <em>(Optional)</em>
  10761. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  10762. </td>
  10763. </tr>
  10764. </table>
  10765. </td>
  10766. </tr>
  10767. <tr>
  10768. <td>
  10769. <code>status</code></br>
  10770. <em>
  10771. <a href="#external-secrets.io/v1.SecretStoreStatus">
  10772. SecretStoreStatus
  10773. </a>
  10774. </em>
  10775. </td>
  10776. <td>
  10777. </td>
  10778. </tr>
  10779. </tbody>
  10780. </table>
  10781. <h3 id="external-secrets.io/v1.SecretStoreCapabilities">SecretStoreCapabilities
  10782. (<code>string</code> alias)</p></h3>
  10783. <p>
  10784. (<em>Appears on:</em>
  10785. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  10786. </p>
  10787. <p>
  10788. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  10789. </p>
  10790. <table>
  10791. <thead>
  10792. <tr>
  10793. <th>Value</th>
  10794. <th>Description</th>
  10795. </tr>
  10796. </thead>
  10797. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  10798. <td><p>SecretStoreReadOnly indicates that the store can only read secrets.</p>
  10799. </td>
  10800. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  10801. <td><p>SecretStoreReadWrite indicates that the store can both read and write secrets.</p>
  10802. </td>
  10803. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  10804. <td><p>SecretStoreWriteOnly indicates that the store can only write secrets.</p>
  10805. </td>
  10806. </tr></tbody>
  10807. </table>
  10808. <h3 id="external-secrets.io/v1.SecretStoreConditionType">SecretStoreConditionType
  10809. (<code>string</code> alias)</p></h3>
  10810. <p>
  10811. (<em>Appears on:</em>
  10812. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  10813. </p>
  10814. <p>
  10815. <p>SecretStoreConditionType represents the condition of the SecretStore.</p>
  10816. </p>
  10817. <table>
  10818. <thead>
  10819. <tr>
  10820. <th>Value</th>
  10821. <th>Description</th>
  10822. </tr>
  10823. </thead>
  10824. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  10825. <td><p>SecretStoreReady indicates that the store is ready and able to serve requests.</p>
  10826. </td>
  10827. </tr></tbody>
  10828. </table>
  10829. <h3 id="external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider
  10830. </h3>
  10831. <p>
  10832. (<em>Appears on:</em>
  10833. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  10834. </p>
  10835. <p>
  10836. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  10837. </p>
  10838. <table>
  10839. <thead>
  10840. <tr>
  10841. <th>Field</th>
  10842. <th>Description</th>
  10843. </tr>
  10844. </thead>
  10845. <tbody>
  10846. <tr>
  10847. <td>
  10848. <code>aws</code></br>
  10849. <em>
  10850. <a href="#external-secrets.io/v1.AWSProvider">
  10851. AWSProvider
  10852. </a>
  10853. </em>
  10854. </td>
  10855. <td>
  10856. <em>(Optional)</em>
  10857. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  10858. </td>
  10859. </tr>
  10860. <tr>
  10861. <td>
  10862. <code>azurekv</code></br>
  10863. <em>
  10864. <a href="#external-secrets.io/v1.AzureKVProvider">
  10865. AzureKVProvider
  10866. </a>
  10867. </em>
  10868. </td>
  10869. <td>
  10870. <em>(Optional)</em>
  10871. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  10872. </td>
  10873. </tr>
  10874. <tr>
  10875. <td>
  10876. <code>akeyless</code></br>
  10877. <em>
  10878. <a href="#external-secrets.io/v1.AkeylessProvider">
  10879. AkeylessProvider
  10880. </a>
  10881. </em>
  10882. </td>
  10883. <td>
  10884. <em>(Optional)</em>
  10885. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  10886. </td>
  10887. </tr>
  10888. <tr>
  10889. <td>
  10890. <code>bitwardensecretsmanager</code></br>
  10891. <em>
  10892. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">
  10893. BitwardenSecretsManagerProvider
  10894. </a>
  10895. </em>
  10896. </td>
  10897. <td>
  10898. <em>(Optional)</em>
  10899. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  10900. </td>
  10901. </tr>
  10902. <tr>
  10903. <td>
  10904. <code>vault</code></br>
  10905. <em>
  10906. <a href="#external-secrets.io/v1.VaultProvider">
  10907. VaultProvider
  10908. </a>
  10909. </em>
  10910. </td>
  10911. <td>
  10912. <em>(Optional)</em>
  10913. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  10914. </td>
  10915. </tr>
  10916. <tr>
  10917. <td>
  10918. <code>ovh</code></br>
  10919. <em>
  10920. <a href="#external-secrets.io/v1.OvhProvider">
  10921. OvhProvider
  10922. </a>
  10923. </em>
  10924. </td>
  10925. <td>
  10926. <em>(Optional)</em>
  10927. <p>OVHcloud configures this store to sync secrets using the OVHcloud provider.</p>
  10928. </td>
  10929. </tr>
  10930. <tr>
  10931. <td>
  10932. <code>gcpsm</code></br>
  10933. <em>
  10934. <a href="#external-secrets.io/v1.GCPSMProvider">
  10935. GCPSMProvider
  10936. </a>
  10937. </em>
  10938. </td>
  10939. <td>
  10940. <em>(Optional)</em>
  10941. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  10942. </td>
  10943. </tr>
  10944. <tr>
  10945. <td>
  10946. <code>oracle</code></br>
  10947. <em>
  10948. <a href="#external-secrets.io/v1.OracleProvider">
  10949. OracleProvider
  10950. </a>
  10951. </em>
  10952. </td>
  10953. <td>
  10954. <em>(Optional)</em>
  10955. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  10956. </td>
  10957. </tr>
  10958. <tr>
  10959. <td>
  10960. <code>ibm</code></br>
  10961. <em>
  10962. <a href="#external-secrets.io/v1.IBMProvider">
  10963. IBMProvider
  10964. </a>
  10965. </em>
  10966. </td>
  10967. <td>
  10968. <em>(Optional)</em>
  10969. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  10970. </td>
  10971. </tr>
  10972. <tr>
  10973. <td>
  10974. <code>yandexcertificatemanager</code></br>
  10975. <em>
  10976. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">
  10977. YandexCertificateManagerProvider
  10978. </a>
  10979. </em>
  10980. </td>
  10981. <td>
  10982. <em>(Optional)</em>
  10983. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  10984. </td>
  10985. </tr>
  10986. <tr>
  10987. <td>
  10988. <code>yandexlockbox</code></br>
  10989. <em>
  10990. <a href="#external-secrets.io/v1.YandexLockboxProvider">
  10991. YandexLockboxProvider
  10992. </a>
  10993. </em>
  10994. </td>
  10995. <td>
  10996. <em>(Optional)</em>
  10997. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  10998. </td>
  10999. </tr>
  11000. <tr>
  11001. <td>
  11002. <code>github</code></br>
  11003. <em>
  11004. <a href="#external-secrets.io/v1.GithubProvider">
  11005. GithubProvider
  11006. </a>
  11007. </em>
  11008. </td>
  11009. <td>
  11010. <em>(Optional)</em>
  11011. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.
  11012. Note: This provider only supports write operations (PushSecret) and cannot fetch secrets from GitHub</p>
  11013. </td>
  11014. </tr>
  11015. <tr>
  11016. <td>
  11017. <code>gitlab</code></br>
  11018. <em>
  11019. <a href="#external-secrets.io/v1.GitlabProvider">
  11020. GitlabProvider
  11021. </a>
  11022. </em>
  11023. </td>
  11024. <td>
  11025. <em>(Optional)</em>
  11026. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  11027. </td>
  11028. </tr>
  11029. <tr>
  11030. <td>
  11031. <code>onepassword</code></br>
  11032. <em>
  11033. <a href="#external-secrets.io/v1.OnePasswordProvider">
  11034. OnePasswordProvider
  11035. </a>
  11036. </em>
  11037. </td>
  11038. <td>
  11039. <em>(Optional)</em>
  11040. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  11041. </td>
  11042. </tr>
  11043. <tr>
  11044. <td>
  11045. <code>onepasswordSDK</code></br>
  11046. <em>
  11047. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">
  11048. OnePasswordSDKProvider
  11049. </a>
  11050. </em>
  11051. </td>
  11052. <td>
  11053. <em>(Optional)</em>
  11054. <p>OnePasswordSDK configures this store to use 1Password&rsquo;s new Go SDK to sync secrets.</p>
  11055. </td>
  11056. </tr>
  11057. <tr>
  11058. <td>
  11059. <code>webhook</code></br>
  11060. <em>
  11061. <a href="#external-secrets.io/v1.WebhookProvider">
  11062. WebhookProvider
  11063. </a>
  11064. </em>
  11065. </td>
  11066. <td>
  11067. <em>(Optional)</em>
  11068. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  11069. </td>
  11070. </tr>
  11071. <tr>
  11072. <td>
  11073. <code>kubernetes</code></br>
  11074. <em>
  11075. <a href="#external-secrets.io/v1.KubernetesProvider">
  11076. KubernetesProvider
  11077. </a>
  11078. </em>
  11079. </td>
  11080. <td>
  11081. <em>(Optional)</em>
  11082. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  11083. </td>
  11084. </tr>
  11085. <tr>
  11086. <td>
  11087. <code>fake</code></br>
  11088. <em>
  11089. <a href="#external-secrets.io/v1.FakeProvider">
  11090. FakeProvider
  11091. </a>
  11092. </em>
  11093. </td>
  11094. <td>
  11095. <em>(Optional)</em>
  11096. <p>Fake configures a store with static key/value pairs</p>
  11097. </td>
  11098. </tr>
  11099. <tr>
  11100. <td>
  11101. <code>senhasegura</code></br>
  11102. <em>
  11103. <a href="#external-secrets.io/v1.SenhaseguraProvider">
  11104. SenhaseguraProvider
  11105. </a>
  11106. </em>
  11107. </td>
  11108. <td>
  11109. <em>(Optional)</em>
  11110. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  11111. </td>
  11112. </tr>
  11113. <tr>
  11114. <td>
  11115. <code>scaleway</code></br>
  11116. <em>
  11117. <a href="#external-secrets.io/v1.ScalewayProvider">
  11118. ScalewayProvider
  11119. </a>
  11120. </em>
  11121. </td>
  11122. <td>
  11123. <em>(Optional)</em>
  11124. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  11125. </td>
  11126. </tr>
  11127. <tr>
  11128. <td>
  11129. <code>doppler</code></br>
  11130. <em>
  11131. <a href="#external-secrets.io/v1.DopplerProvider">
  11132. DopplerProvider
  11133. </a>
  11134. </em>
  11135. </td>
  11136. <td>
  11137. <em>(Optional)</em>
  11138. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  11139. </td>
  11140. </tr>
  11141. <tr>
  11142. <td>
  11143. <code>previder</code></br>
  11144. <em>
  11145. <a href="#external-secrets.io/v1.PreviderProvider">
  11146. PreviderProvider
  11147. </a>
  11148. </em>
  11149. </td>
  11150. <td>
  11151. <em>(Optional)</em>
  11152. <p>Previder configures this store to sync secrets using the Previder provider</p>
  11153. </td>
  11154. </tr>
  11155. <tr>
  11156. <td>
  11157. <code>onboardbase</code></br>
  11158. <em>
  11159. <a href="#external-secrets.io/v1.OnboardbaseProvider">
  11160. OnboardbaseProvider
  11161. </a>
  11162. </em>
  11163. </td>
  11164. <td>
  11165. <em>(Optional)</em>
  11166. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  11167. </td>
  11168. </tr>
  11169. <tr>
  11170. <td>
  11171. <code>keepersecurity</code></br>
  11172. <em>
  11173. <a href="#external-secrets.io/v1.KeeperSecurityProvider">
  11174. KeeperSecurityProvider
  11175. </a>
  11176. </em>
  11177. </td>
  11178. <td>
  11179. <em>(Optional)</em>
  11180. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  11181. </td>
  11182. </tr>
  11183. <tr>
  11184. <td>
  11185. <code>conjur</code></br>
  11186. <em>
  11187. <a href="#external-secrets.io/v1.ConjurProvider">
  11188. ConjurProvider
  11189. </a>
  11190. </em>
  11191. </td>
  11192. <td>
  11193. <em>(Optional)</em>
  11194. <p>Conjur configures this store to sync secrets using conjur provider</p>
  11195. </td>
  11196. </tr>
  11197. <tr>
  11198. <td>
  11199. <code>delinea</code></br>
  11200. <em>
  11201. <a href="#external-secrets.io/v1.DelineaProvider">
  11202. DelineaProvider
  11203. </a>
  11204. </em>
  11205. </td>
  11206. <td>
  11207. <em>(Optional)</em>
  11208. <p>Delinea DevOps Secrets Vault
  11209. <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>
  11210. </td>
  11211. </tr>
  11212. <tr>
  11213. <td>
  11214. <code>secretserver</code></br>
  11215. <em>
  11216. <a href="#external-secrets.io/v1.SecretServerProvider">
  11217. SecretServerProvider
  11218. </a>
  11219. </em>
  11220. </td>
  11221. <td>
  11222. <em>(Optional)</em>
  11223. <p>SecretServer configures this store to sync secrets using SecretServer provider
  11224. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  11225. </td>
  11226. </tr>
  11227. <tr>
  11228. <td>
  11229. <code>chef</code></br>
  11230. <em>
  11231. <a href="#external-secrets.io/v1.ChefProvider">
  11232. ChefProvider
  11233. </a>
  11234. </em>
  11235. </td>
  11236. <td>
  11237. <em>(Optional)</em>
  11238. <p>Chef configures this store to sync secrets with chef server</p>
  11239. </td>
  11240. </tr>
  11241. <tr>
  11242. <td>
  11243. <code>pulumi</code></br>
  11244. <em>
  11245. <a href="#external-secrets.io/v1.PulumiProvider">
  11246. PulumiProvider
  11247. </a>
  11248. </em>
  11249. </td>
  11250. <td>
  11251. <em>(Optional)</em>
  11252. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  11253. </td>
  11254. </tr>
  11255. <tr>
  11256. <td>
  11257. <code>fortanix</code></br>
  11258. <em>
  11259. <a href="#external-secrets.io/v1.FortanixProvider">
  11260. FortanixProvider
  11261. </a>
  11262. </em>
  11263. </td>
  11264. <td>
  11265. <em>(Optional)</em>
  11266. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  11267. </td>
  11268. </tr>
  11269. <tr>
  11270. <td>
  11271. <code>passworddepot</code></br>
  11272. <em>
  11273. <a href="#external-secrets.io/v1.PasswordDepotProvider">
  11274. PasswordDepotProvider
  11275. </a>
  11276. </em>
  11277. </td>
  11278. <td>
  11279. <em>(Optional)</em>
  11280. </td>
  11281. </tr>
  11282. <tr>
  11283. <td>
  11284. <code>passbolt</code></br>
  11285. <em>
  11286. <a href="#external-secrets.io/v1.PassboltProvider">
  11287. PassboltProvider
  11288. </a>
  11289. </em>
  11290. </td>
  11291. <td>
  11292. <em>(Optional)</em>
  11293. </td>
  11294. </tr>
  11295. <tr>
  11296. <td>
  11297. <code>dvls</code></br>
  11298. <em>
  11299. <a href="#external-secrets.io/v1.DVLSProvider">
  11300. DVLSProvider
  11301. </a>
  11302. </em>
  11303. </td>
  11304. <td>
  11305. <em>(Optional)</em>
  11306. <p>DVLS configures this store to sync secrets using Devolutions Server provider</p>
  11307. </td>
  11308. </tr>
  11309. <tr>
  11310. <td>
  11311. <code>infisical</code></br>
  11312. <em>
  11313. <a href="#external-secrets.io/v1.InfisicalProvider">
  11314. InfisicalProvider
  11315. </a>
  11316. </em>
  11317. </td>
  11318. <td>
  11319. <em>(Optional)</em>
  11320. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  11321. </td>
  11322. </tr>
  11323. <tr>
  11324. <td>
  11325. <code>beyondtrust</code></br>
  11326. <em>
  11327. <a href="#external-secrets.io/v1.BeyondtrustProvider">
  11328. BeyondtrustProvider
  11329. </a>
  11330. </em>
  11331. </td>
  11332. <td>
  11333. <em>(Optional)</em>
  11334. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  11335. </td>
  11336. </tr>
  11337. <tr>
  11338. <td>
  11339. <code>cloudrusm</code></br>
  11340. <em>
  11341. <a href="#external-secrets.io/v1.CloudruSMProvider">
  11342. CloudruSMProvider
  11343. </a>
  11344. </em>
  11345. </td>
  11346. <td>
  11347. <em>(Optional)</em>
  11348. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  11349. </td>
  11350. </tr>
  11351. <tr>
  11352. <td>
  11353. <code>volcengine</code></br>
  11354. <em>
  11355. <a href="#external-secrets.io/v1.VolcengineProvider">
  11356. VolcengineProvider
  11357. </a>
  11358. </em>
  11359. </td>
  11360. <td>
  11361. <em>(Optional)</em>
  11362. <p>Volcengine configures this store to sync secrets using the Volcengine provider</p>
  11363. </td>
  11364. </tr>
  11365. <tr>
  11366. <td>
  11367. <code>ngrok</code></br>
  11368. <em>
  11369. <a href="#external-secrets.io/v1.NgrokProvider">
  11370. NgrokProvider
  11371. </a>
  11372. </em>
  11373. </td>
  11374. <td>
  11375. <em>(Optional)</em>
  11376. <p>Ngrok configures this store to sync secrets using the ngrok provider.</p>
  11377. </td>
  11378. </tr>
  11379. <tr>
  11380. <td>
  11381. <code>barbican</code></br>
  11382. <em>
  11383. <a href="#external-secrets.io/v1.BarbicanProvider">
  11384. BarbicanProvider
  11385. </a>
  11386. </em>
  11387. </td>
  11388. <td>
  11389. <em>(Optional)</em>
  11390. <p>Barbican configures this store to sync secrets using the OpenStack Barbican provider</p>
  11391. </td>
  11392. </tr>
  11393. <tr>
  11394. <td>
  11395. <code>nebiusmysterybox</code></br>
  11396. <em>
  11397. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">
  11398. NebiusMysteryboxProvider
  11399. </a>
  11400. </em>
  11401. </td>
  11402. <td>
  11403. <em>(Optional)</em>
  11404. <p>NebiusMysterybox configures this store to sync secrets using NebiusMysterybox provider</p>
  11405. </td>
  11406. </tr>
  11407. </tbody>
  11408. </table>
  11409. <h3 id="external-secrets.io/v1.SecretStoreRef">SecretStoreRef
  11410. </h3>
  11411. <p>
  11412. (<em>Appears on:</em>
  11413. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>,
  11414. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  11415. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>)
  11416. </p>
  11417. <p>
  11418. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  11419. </p>
  11420. <table>
  11421. <thead>
  11422. <tr>
  11423. <th>Field</th>
  11424. <th>Description</th>
  11425. </tr>
  11426. </thead>
  11427. <tbody>
  11428. <tr>
  11429. <td>
  11430. <code>name</code></br>
  11431. <em>
  11432. string
  11433. </em>
  11434. </td>
  11435. <td>
  11436. <p>Name of the SecretStore resource</p>
  11437. </td>
  11438. </tr>
  11439. <tr>
  11440. <td>
  11441. <code>kind</code></br>
  11442. <em>
  11443. string
  11444. </em>
  11445. </td>
  11446. <td>
  11447. <em>(Optional)</em>
  11448. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  11449. Defaults to <code>SecretStore</code></p>
  11450. </td>
  11451. </tr>
  11452. </tbody>
  11453. </table>
  11454. <h3 id="external-secrets.io/v1.SecretStoreRetrySettings">SecretStoreRetrySettings
  11455. </h3>
  11456. <p>
  11457. (<em>Appears on:</em>
  11458. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>,
  11459. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  11460. </p>
  11461. <p>
  11462. <p>SecretStoreRetrySettings defines the retry settings for accessing external secrets manager stores.</p>
  11463. </p>
  11464. <table>
  11465. <thead>
  11466. <tr>
  11467. <th>Field</th>
  11468. <th>Description</th>
  11469. </tr>
  11470. </thead>
  11471. <tbody>
  11472. <tr>
  11473. <td>
  11474. <code>maxRetries</code></br>
  11475. <em>
  11476. int32
  11477. </em>
  11478. </td>
  11479. <td>
  11480. </td>
  11481. </tr>
  11482. <tr>
  11483. <td>
  11484. <code>retryInterval</code></br>
  11485. <em>
  11486. string
  11487. </em>
  11488. </td>
  11489. <td>
  11490. </td>
  11491. </tr>
  11492. </tbody>
  11493. </table>
  11494. <h3 id="external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec
  11495. </h3>
  11496. <p>
  11497. (<em>Appears on:</em>
  11498. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  11499. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  11500. </p>
  11501. <p>
  11502. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  11503. </p>
  11504. <table>
  11505. <thead>
  11506. <tr>
  11507. <th>Field</th>
  11508. <th>Description</th>
  11509. </tr>
  11510. </thead>
  11511. <tbody>
  11512. <tr>
  11513. <td>
  11514. <code>controller</code></br>
  11515. <em>
  11516. string
  11517. </em>
  11518. </td>
  11519. <td>
  11520. <em>(Optional)</em>
  11521. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  11522. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  11523. </td>
  11524. </tr>
  11525. <tr>
  11526. <td>
  11527. <code>provider</code></br>
  11528. <em>
  11529. <a href="#external-secrets.io/v1.SecretStoreProvider">
  11530. SecretStoreProvider
  11531. </a>
  11532. </em>
  11533. </td>
  11534. <td>
  11535. <p>Used to configure the provider. Only one provider may be set</p>
  11536. </td>
  11537. </tr>
  11538. <tr>
  11539. <td>
  11540. <code>retrySettings</code></br>
  11541. <em>
  11542. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  11543. SecretStoreRetrySettings
  11544. </a>
  11545. </em>
  11546. </td>
  11547. <td>
  11548. <em>(Optional)</em>
  11549. <p>Used to configure HTTP retries on failures.</p>
  11550. </td>
  11551. </tr>
  11552. <tr>
  11553. <td>
  11554. <code>refreshInterval</code></br>
  11555. <em>
  11556. int
  11557. </em>
  11558. </td>
  11559. <td>
  11560. <em>(Optional)</em>
  11561. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  11562. </td>
  11563. </tr>
  11564. <tr>
  11565. <td>
  11566. <code>conditions</code></br>
  11567. <em>
  11568. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  11569. []ClusterSecretStoreCondition
  11570. </a>
  11571. </em>
  11572. </td>
  11573. <td>
  11574. <em>(Optional)</em>
  11575. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  11576. </td>
  11577. </tr>
  11578. </tbody>
  11579. </table>
  11580. <h3 id="external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus
  11581. </h3>
  11582. <p>
  11583. (<em>Appears on:</em>
  11584. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  11585. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  11586. </p>
  11587. <p>
  11588. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  11589. </p>
  11590. <table>
  11591. <thead>
  11592. <tr>
  11593. <th>Field</th>
  11594. <th>Description</th>
  11595. </tr>
  11596. </thead>
  11597. <tbody>
  11598. <tr>
  11599. <td>
  11600. <code>conditions</code></br>
  11601. <em>
  11602. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">
  11603. []SecretStoreStatusCondition
  11604. </a>
  11605. </em>
  11606. </td>
  11607. <td>
  11608. <em>(Optional)</em>
  11609. </td>
  11610. </tr>
  11611. <tr>
  11612. <td>
  11613. <code>capabilities</code></br>
  11614. <em>
  11615. <a href="#external-secrets.io/v1.SecretStoreCapabilities">
  11616. SecretStoreCapabilities
  11617. </a>
  11618. </em>
  11619. </td>
  11620. <td>
  11621. <em>(Optional)</em>
  11622. </td>
  11623. </tr>
  11624. </tbody>
  11625. </table>
  11626. <h3 id="external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition
  11627. </h3>
  11628. <p>
  11629. (<em>Appears on:</em>
  11630. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  11631. </p>
  11632. <p>
  11633. <p>SecretStoreStatusCondition contains condition information for a SecretStore.</p>
  11634. </p>
  11635. <table>
  11636. <thead>
  11637. <tr>
  11638. <th>Field</th>
  11639. <th>Description</th>
  11640. </tr>
  11641. </thead>
  11642. <tbody>
  11643. <tr>
  11644. <td>
  11645. <code>type</code></br>
  11646. <em>
  11647. <a href="#external-secrets.io/v1.SecretStoreConditionType">
  11648. SecretStoreConditionType
  11649. </a>
  11650. </em>
  11651. </td>
  11652. <td>
  11653. </td>
  11654. </tr>
  11655. <tr>
  11656. <td>
  11657. <code>status</code></br>
  11658. <em>
  11659. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  11660. Kubernetes core/v1.ConditionStatus
  11661. </a>
  11662. </em>
  11663. </td>
  11664. <td>
  11665. </td>
  11666. </tr>
  11667. <tr>
  11668. <td>
  11669. <code>reason</code></br>
  11670. <em>
  11671. string
  11672. </em>
  11673. </td>
  11674. <td>
  11675. <em>(Optional)</em>
  11676. </td>
  11677. </tr>
  11678. <tr>
  11679. <td>
  11680. <code>message</code></br>
  11681. <em>
  11682. string
  11683. </em>
  11684. </td>
  11685. <td>
  11686. <em>(Optional)</em>
  11687. </td>
  11688. </tr>
  11689. <tr>
  11690. <td>
  11691. <code>lastTransitionTime</code></br>
  11692. <em>
  11693. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  11694. Kubernetes meta/v1.Time
  11695. </a>
  11696. </em>
  11697. </td>
  11698. <td>
  11699. <em>(Optional)</em>
  11700. </td>
  11701. </tr>
  11702. </tbody>
  11703. </table>
  11704. <h3 id="external-secrets.io/v1.SecretVersionSelectionPolicy">SecretVersionSelectionPolicy
  11705. (<code>string</code> alias)</p></h3>
  11706. <p>
  11707. (<em>Appears on:</em>
  11708. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  11709. </p>
  11710. <p>
  11711. <p>SecretVersionSelectionPolicy defines the policy for selecting secret versions in GCP Secret Manager.</p>
  11712. </p>
  11713. <table>
  11714. <thead>
  11715. <tr>
  11716. <th>Value</th>
  11717. <th>Description</th>
  11718. </tr>
  11719. </thead>
  11720. <tbody><tr><td><p>&#34;LatestOrFail&#34;</p></td>
  11721. <td><p>SecretVersionSelectionPolicyLatestOrFail means the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.</p>
  11722. </td>
  11723. </tr><tr><td><p>&#34;LatestOrFetch&#34;</p></td>
  11724. <td><p>SecretVersionSelectionPolicyLatestOrFetch behaves like SecretVersionSelectionPolicyLatestOrFail but falls back to fetching the latest version if the version is DESTROYED or DISABLED.</p>
  11725. </td>
  11726. </tr></tbody>
  11727. </table>
  11728. <h3 id="external-secrets.io/v1.SecretsClient">SecretsClient
  11729. </h3>
  11730. <p>
  11731. <p>SecretsClient provides access to secrets.</p>
  11732. </p>
  11733. <h3 id="external-secrets.io/v1.SecretsManager">SecretsManager
  11734. </h3>
  11735. <p>
  11736. (<em>Appears on:</em>
  11737. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  11738. </p>
  11739. <p>
  11740. <p>SecretsManager defines how the provider behaves when interacting with AWS
  11741. SecretsManager. Some of these settings are only applicable to controlling how
  11742. secrets are deleted, and hence only apply to PushSecret (and only when
  11743. deletionPolicy is set to Delete).</p>
  11744. </p>
  11745. <table>
  11746. <thead>
  11747. <tr>
  11748. <th>Field</th>
  11749. <th>Description</th>
  11750. </tr>
  11751. </thead>
  11752. <tbody>
  11753. <tr>
  11754. <td>
  11755. <code>forceDeleteWithoutRecovery</code></br>
  11756. <em>
  11757. bool
  11758. </em>
  11759. </td>
  11760. <td>
  11761. <em>(Optional)</em>
  11762. <p>Specifies whether to delete the secret without any recovery window. You
  11763. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  11764. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  11765. recovery window.
  11766. 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>
  11767. </td>
  11768. </tr>
  11769. <tr>
  11770. <td>
  11771. <code>recoveryWindowInDays</code></br>
  11772. <em>
  11773. int64
  11774. </em>
  11775. </td>
  11776. <td>
  11777. <em>(Optional)</em>
  11778. <p>The number of days from 7 to 30 that Secrets Manager waits before
  11779. permanently deleting the secret. You can&rsquo;t use both this parameter and
  11780. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  11781. then by default Secrets Manager uses a 30-day recovery window.
  11782. 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>
  11783. </td>
  11784. </tr>
  11785. </tbody>
  11786. </table>
  11787. <h3 id="external-secrets.io/v1.SenhaseguraAuth">SenhaseguraAuth
  11788. </h3>
  11789. <p>
  11790. (<em>Appears on:</em>
  11791. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  11792. </p>
  11793. <p>
  11794. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  11795. </p>
  11796. <table>
  11797. <thead>
  11798. <tr>
  11799. <th>Field</th>
  11800. <th>Description</th>
  11801. </tr>
  11802. </thead>
  11803. <tbody>
  11804. <tr>
  11805. <td>
  11806. <code>clientId</code></br>
  11807. <em>
  11808. string
  11809. </em>
  11810. </td>
  11811. <td>
  11812. </td>
  11813. </tr>
  11814. <tr>
  11815. <td>
  11816. <code>clientSecretSecretRef</code></br>
  11817. <em>
  11818. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11819. External Secrets meta/v1.SecretKeySelector
  11820. </a>
  11821. </em>
  11822. </td>
  11823. <td>
  11824. </td>
  11825. </tr>
  11826. </tbody>
  11827. </table>
  11828. <h3 id="external-secrets.io/v1.SenhaseguraModuleType">SenhaseguraModuleType
  11829. (<code>string</code> alias)</p></h3>
  11830. <p>
  11831. (<em>Appears on:</em>
  11832. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  11833. </p>
  11834. <p>
  11835. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  11836. </p>
  11837. <table>
  11838. <thead>
  11839. <tr>
  11840. <th>Value</th>
  11841. <th>Description</th>
  11842. </tr>
  11843. </thead>
  11844. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  11845. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  11846. see: https://senhasegura.com/devops
  11847. </code></pre>
  11848. </td>
  11849. </tr></tbody>
  11850. </table>
  11851. <h3 id="external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider
  11852. </h3>
  11853. <p>
  11854. (<em>Appears on:</em>
  11855. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11856. </p>
  11857. <p>
  11858. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  11859. </p>
  11860. <table>
  11861. <thead>
  11862. <tr>
  11863. <th>Field</th>
  11864. <th>Description</th>
  11865. </tr>
  11866. </thead>
  11867. <tbody>
  11868. <tr>
  11869. <td>
  11870. <code>url</code></br>
  11871. <em>
  11872. string
  11873. </em>
  11874. </td>
  11875. <td>
  11876. <p>URL of senhasegura</p>
  11877. </td>
  11878. </tr>
  11879. <tr>
  11880. <td>
  11881. <code>module</code></br>
  11882. <em>
  11883. <a href="#external-secrets.io/v1.SenhaseguraModuleType">
  11884. SenhaseguraModuleType
  11885. </a>
  11886. </em>
  11887. </td>
  11888. <td>
  11889. <p>Module defines which senhasegura module should be used to get secrets</p>
  11890. </td>
  11891. </tr>
  11892. <tr>
  11893. <td>
  11894. <code>auth</code></br>
  11895. <em>
  11896. <a href="#external-secrets.io/v1.SenhaseguraAuth">
  11897. SenhaseguraAuth
  11898. </a>
  11899. </em>
  11900. </td>
  11901. <td>
  11902. <p>Auth defines parameters to authenticate in senhasegura</p>
  11903. </td>
  11904. </tr>
  11905. <tr>
  11906. <td>
  11907. <code>ignoreSslCertificate</code></br>
  11908. <em>
  11909. bool
  11910. </em>
  11911. </td>
  11912. <td>
  11913. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  11914. </td>
  11915. </tr>
  11916. </tbody>
  11917. </table>
  11918. <h3 id="external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  11919. </h3>
  11920. <p>
  11921. (<em>Appears on:</em>
  11922. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  11923. </p>
  11924. <p>
  11925. <p>StoreGeneratorSourceRef allows you to override the source
  11926. from which the secret will be pulled from.
  11927. You can define at maximum one property.</p>
  11928. </p>
  11929. <table>
  11930. <thead>
  11931. <tr>
  11932. <th>Field</th>
  11933. <th>Description</th>
  11934. </tr>
  11935. </thead>
  11936. <tbody>
  11937. <tr>
  11938. <td>
  11939. <code>storeRef</code></br>
  11940. <em>
  11941. <a href="#external-secrets.io/v1.SecretStoreRef">
  11942. SecretStoreRef
  11943. </a>
  11944. </em>
  11945. </td>
  11946. <td>
  11947. <em>(Optional)</em>
  11948. </td>
  11949. </tr>
  11950. <tr>
  11951. <td>
  11952. <code>generatorRef</code></br>
  11953. <em>
  11954. <a href="#external-secrets.io/v1.GeneratorRef">
  11955. GeneratorRef
  11956. </a>
  11957. </em>
  11958. </td>
  11959. <td>
  11960. <em>(Optional)</em>
  11961. <p>GeneratorRef points to a generator custom resource.</p>
  11962. </td>
  11963. </tr>
  11964. </tbody>
  11965. </table>
  11966. <h3 id="external-secrets.io/v1.StoreSourceRef">StoreSourceRef
  11967. </h3>
  11968. <p>
  11969. (<em>Appears on:</em>
  11970. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>)
  11971. </p>
  11972. <p>
  11973. <p>StoreSourceRef allows you to override the SecretStore source
  11974. from which the secret will be pulled from.
  11975. You can define at maximum one property.</p>
  11976. </p>
  11977. <table>
  11978. <thead>
  11979. <tr>
  11980. <th>Field</th>
  11981. <th>Description</th>
  11982. </tr>
  11983. </thead>
  11984. <tbody>
  11985. <tr>
  11986. <td>
  11987. <code>storeRef</code></br>
  11988. <em>
  11989. <a href="#external-secrets.io/v1.SecretStoreRef">
  11990. SecretStoreRef
  11991. </a>
  11992. </em>
  11993. </td>
  11994. <td>
  11995. <em>(Optional)</em>
  11996. </td>
  11997. </tr>
  11998. <tr>
  11999. <td>
  12000. <code>generatorRef</code></br>
  12001. <em>
  12002. <a href="#external-secrets.io/v1.GeneratorRef">
  12003. GeneratorRef
  12004. </a>
  12005. </em>
  12006. </td>
  12007. <td>
  12008. <p>GeneratorRef points to a generator custom resource.</p>
  12009. <p>Deprecated: The generatorRef is not implemented in .data[].
  12010. this will be removed with v1.</p>
  12011. </td>
  12012. </tr>
  12013. </tbody>
  12014. </table>
  12015. <h3 id="external-secrets.io/v1.Tag">Tag
  12016. </h3>
  12017. <p>
  12018. <p>Tag is a key-value pair that can be attached to an AWS resource.
  12019. 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>
  12020. </p>
  12021. <table>
  12022. <thead>
  12023. <tr>
  12024. <th>Field</th>
  12025. <th>Description</th>
  12026. </tr>
  12027. </thead>
  12028. <tbody>
  12029. <tr>
  12030. <td>
  12031. <code>key</code></br>
  12032. <em>
  12033. string
  12034. </em>
  12035. </td>
  12036. <td>
  12037. </td>
  12038. </tr>
  12039. <tr>
  12040. <td>
  12041. <code>value</code></br>
  12042. <em>
  12043. string
  12044. </em>
  12045. </td>
  12046. <td>
  12047. </td>
  12048. </tr>
  12049. </tbody>
  12050. </table>
  12051. <h3 id="external-secrets.io/v1.TemplateEngineVersion">TemplateEngineVersion
  12052. (<code>string</code> alias)</p></h3>
  12053. <p>
  12054. (<em>Appears on:</em>
  12055. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  12056. </p>
  12057. <p>
  12058. <p>TemplateEngineVersion specifies the template engine version that should be used to
  12059. compile/execute the template.</p>
  12060. </p>
  12061. <table>
  12062. <thead>
  12063. <tr>
  12064. <th>Value</th>
  12065. <th>Description</th>
  12066. </tr>
  12067. </thead>
  12068. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  12069. <td><p>TemplateEngineV2 is the currently supported template engine version.</p>
  12070. </td>
  12071. </tr></tbody>
  12072. </table>
  12073. <h3 id="external-secrets.io/v1.TemplateFrom">TemplateFrom
  12074. </h3>
  12075. <p>
  12076. (<em>Appears on:</em>
  12077. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  12078. </p>
  12079. <p>
  12080. <p>TemplateFrom specifies a source for templates.
  12081. Each item in the list can either reference a ConfigMap or a Secret resource.</p>
  12082. </p>
  12083. <table>
  12084. <thead>
  12085. <tr>
  12086. <th>Field</th>
  12087. <th>Description</th>
  12088. </tr>
  12089. </thead>
  12090. <tbody>
  12091. <tr>
  12092. <td>
  12093. <code>configMap</code></br>
  12094. <em>
  12095. <a href="#external-secrets.io/v1.TemplateRef">
  12096. TemplateRef
  12097. </a>
  12098. </em>
  12099. </td>
  12100. <td>
  12101. </td>
  12102. </tr>
  12103. <tr>
  12104. <td>
  12105. <code>secret</code></br>
  12106. <em>
  12107. <a href="#external-secrets.io/v1.TemplateRef">
  12108. TemplateRef
  12109. </a>
  12110. </em>
  12111. </td>
  12112. <td>
  12113. </td>
  12114. </tr>
  12115. <tr>
  12116. <td>
  12117. <code>target</code></br>
  12118. <em>
  12119. string
  12120. </em>
  12121. </td>
  12122. <td>
  12123. <em>(Optional)</em>
  12124. <p>Target specifies where to place the template result.
  12125. For Secret resources, common values are: &ldquo;Data&rdquo;, &ldquo;Annotations&rdquo;, &ldquo;Labels&rdquo;.
  12126. For custom resources (when spec.target.manifest is set), this supports
  12127. nested paths like &ldquo;spec.database.config&rdquo; or &ldquo;data&rdquo;.</p>
  12128. </td>
  12129. </tr>
  12130. <tr>
  12131. <td>
  12132. <code>literal</code></br>
  12133. <em>
  12134. string
  12135. </em>
  12136. </td>
  12137. <td>
  12138. <em>(Optional)</em>
  12139. </td>
  12140. </tr>
  12141. </tbody>
  12142. </table>
  12143. <h3 id="external-secrets.io/v1.TemplateMergePolicy">TemplateMergePolicy
  12144. (<code>string</code> alias)</p></h3>
  12145. <p>
  12146. (<em>Appears on:</em>
  12147. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  12148. </p>
  12149. <p>
  12150. <p>TemplateMergePolicy defines how the rendered template should be merged with the existing Secret data.</p>
  12151. </p>
  12152. <table>
  12153. <thead>
  12154. <tr>
  12155. <th>Value</th>
  12156. <th>Description</th>
  12157. </tr>
  12158. </thead>
  12159. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  12160. <td></td>
  12161. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  12162. <td></td>
  12163. </tr></tbody>
  12164. </table>
  12165. <h3 id="external-secrets.io/v1.TemplateRef">TemplateRef
  12166. </h3>
  12167. <p>
  12168. (<em>Appears on:</em>
  12169. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  12170. </p>
  12171. <p>
  12172. <p>TemplateRef specifies a reference to either a ConfigMap or a Secret resource.</p>
  12173. </p>
  12174. <table>
  12175. <thead>
  12176. <tr>
  12177. <th>Field</th>
  12178. <th>Description</th>
  12179. </tr>
  12180. </thead>
  12181. <tbody>
  12182. <tr>
  12183. <td>
  12184. <code>name</code></br>
  12185. <em>
  12186. string
  12187. </em>
  12188. </td>
  12189. <td>
  12190. <p>The name of the ConfigMap/Secret resource</p>
  12191. </td>
  12192. </tr>
  12193. <tr>
  12194. <td>
  12195. <code>items</code></br>
  12196. <em>
  12197. <a href="#external-secrets.io/v1.TemplateRefItem">
  12198. []TemplateRefItem
  12199. </a>
  12200. </em>
  12201. </td>
  12202. <td>
  12203. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  12204. </td>
  12205. </tr>
  12206. </tbody>
  12207. </table>
  12208. <h3 id="external-secrets.io/v1.TemplateRefItem">TemplateRefItem
  12209. </h3>
  12210. <p>
  12211. (<em>Appears on:</em>
  12212. <a href="#external-secrets.io/v1.TemplateRef">TemplateRef</a>)
  12213. </p>
  12214. <p>
  12215. <p>TemplateRefItem specifies a key in the ConfigMap/Secret to use as a template for Secret data.</p>
  12216. </p>
  12217. <table>
  12218. <thead>
  12219. <tr>
  12220. <th>Field</th>
  12221. <th>Description</th>
  12222. </tr>
  12223. </thead>
  12224. <tbody>
  12225. <tr>
  12226. <td>
  12227. <code>key</code></br>
  12228. <em>
  12229. string
  12230. </em>
  12231. </td>
  12232. <td>
  12233. <p>A key in the ConfigMap/Secret</p>
  12234. </td>
  12235. </tr>
  12236. <tr>
  12237. <td>
  12238. <code>templateAs</code></br>
  12239. <em>
  12240. <a href="#external-secrets.io/v1.TemplateScope">
  12241. TemplateScope
  12242. </a>
  12243. </em>
  12244. </td>
  12245. <td>
  12246. </td>
  12247. </tr>
  12248. </tbody>
  12249. </table>
  12250. <h3 id="external-secrets.io/v1.TemplateScope">TemplateScope
  12251. (<code>string</code> alias)</p></h3>
  12252. <p>
  12253. (<em>Appears on:</em>
  12254. <a href="#external-secrets.io/v1.TemplateRefItem">TemplateRefItem</a>)
  12255. </p>
  12256. <p>
  12257. <p>TemplateScope specifies how the template keys should be interpreted.</p>
  12258. </p>
  12259. <table>
  12260. <thead>
  12261. <tr>
  12262. <th>Value</th>
  12263. <th>Description</th>
  12264. </tr>
  12265. </thead>
  12266. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  12267. <td></td>
  12268. </tr><tr><td><p>&#34;Values&#34;</p></td>
  12269. <td></td>
  12270. </tr></tbody>
  12271. </table>
  12272. <h3 id="external-secrets.io/v1.TokenAuth">TokenAuth
  12273. </h3>
  12274. <p>
  12275. (<em>Appears on:</em>
  12276. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  12277. </p>
  12278. <p>
  12279. <p>TokenAuth defines token-based authentication configuration for Kubernetes.</p>
  12280. </p>
  12281. <table>
  12282. <thead>
  12283. <tr>
  12284. <th>Field</th>
  12285. <th>Description</th>
  12286. </tr>
  12287. </thead>
  12288. <tbody>
  12289. <tr>
  12290. <td>
  12291. <code>bearerToken</code></br>
  12292. <em>
  12293. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12294. External Secrets meta/v1.SecretKeySelector
  12295. </a>
  12296. </em>
  12297. </td>
  12298. <td>
  12299. </td>
  12300. </tr>
  12301. </tbody>
  12302. </table>
  12303. <h3 id="external-secrets.io/v1.TokenAuthCredentials">TokenAuthCredentials
  12304. </h3>
  12305. <p>
  12306. (<em>Appears on:</em>
  12307. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  12308. </p>
  12309. <p>
  12310. <p>TokenAuthCredentials represents the credentials for access token-based authentication.</p>
  12311. </p>
  12312. <table>
  12313. <thead>
  12314. <tr>
  12315. <th>Field</th>
  12316. <th>Description</th>
  12317. </tr>
  12318. </thead>
  12319. <tbody>
  12320. <tr>
  12321. <td>
  12322. <code>accessToken</code></br>
  12323. <em>
  12324. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12325. External Secrets meta/v1.SecretKeySelector
  12326. </a>
  12327. </em>
  12328. </td>
  12329. <td>
  12330. </td>
  12331. </tr>
  12332. </tbody>
  12333. </table>
  12334. <h3 id="external-secrets.io/v1.UniversalAuthCredentials">UniversalAuthCredentials
  12335. </h3>
  12336. <p>
  12337. (<em>Appears on:</em>
  12338. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  12339. </p>
  12340. <p>
  12341. <p>UniversalAuthCredentials represents the client credentials for universal authentication.</p>
  12342. </p>
  12343. <table>
  12344. <thead>
  12345. <tr>
  12346. <th>Field</th>
  12347. <th>Description</th>
  12348. </tr>
  12349. </thead>
  12350. <tbody>
  12351. <tr>
  12352. <td>
  12353. <code>clientId</code></br>
  12354. <em>
  12355. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12356. External Secrets meta/v1.SecretKeySelector
  12357. </a>
  12358. </em>
  12359. </td>
  12360. <td>
  12361. </td>
  12362. </tr>
  12363. <tr>
  12364. <td>
  12365. <code>clientSecret</code></br>
  12366. <em>
  12367. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12368. External Secrets meta/v1.SecretKeySelector
  12369. </a>
  12370. </em>
  12371. </td>
  12372. <td>
  12373. </td>
  12374. </tr>
  12375. </tbody>
  12376. </table>
  12377. <h3 id="external-secrets.io/v1.ValidationResult">ValidationResult
  12378. (<code>byte</code> alias)</p></h3>
  12379. <p>
  12380. (<em>Appears on:</em>
  12381. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  12382. </p>
  12383. <p>
  12384. <p>ValidationResult is defined type for the number of validation results.</p>
  12385. </p>
  12386. <table>
  12387. <thead>
  12388. <tr>
  12389. <th>Value</th>
  12390. <th>Description</th>
  12391. </tr>
  12392. </thead>
  12393. <tbody><tr><td><p>2</p></td>
  12394. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  12395. </td>
  12396. </tr><tr><td><p>0</p></td>
  12397. <td><p>ValidationResultReady indicates that the client is configured correctly
  12398. and can be used.</p>
  12399. </td>
  12400. </tr><tr><td><p>1</p></td>
  12401. <td><p>ValidationResultUnknown indicates that the client can be used
  12402. but information is missing, and it can not be validated.</p>
  12403. </td>
  12404. </tr></tbody>
  12405. </table>
  12406. <h3 id="external-secrets.io/v1.VaultAppRole">VaultAppRole
  12407. </h3>
  12408. <p>
  12409. (<em>Appears on:</em>
  12410. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12411. </p>
  12412. <p>
  12413. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  12414. with the role and secret stored in a Kubernetes Secret resource.</p>
  12415. </p>
  12416. <table>
  12417. <thead>
  12418. <tr>
  12419. <th>Field</th>
  12420. <th>Description</th>
  12421. </tr>
  12422. </thead>
  12423. <tbody>
  12424. <tr>
  12425. <td>
  12426. <code>path</code></br>
  12427. <em>
  12428. string
  12429. </em>
  12430. </td>
  12431. <td>
  12432. <p>Path where the App Role authentication backend is mounted
  12433. in Vault, e.g: &ldquo;approle&rdquo;</p>
  12434. </td>
  12435. </tr>
  12436. <tr>
  12437. <td>
  12438. <code>roleId</code></br>
  12439. <em>
  12440. string
  12441. </em>
  12442. </td>
  12443. <td>
  12444. <em>(Optional)</em>
  12445. <p>RoleID configured in the App Role authentication backend when setting
  12446. up the authentication backend in Vault.</p>
  12447. </td>
  12448. </tr>
  12449. <tr>
  12450. <td>
  12451. <code>roleRef</code></br>
  12452. <em>
  12453. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12454. External Secrets meta/v1.SecretKeySelector
  12455. </a>
  12456. </em>
  12457. </td>
  12458. <td>
  12459. <em>(Optional)</em>
  12460. <p>Reference to a key in a Secret that contains the App Role ID used
  12461. to authenticate with Vault.
  12462. The <code>key</code> field must be specified and denotes which entry within the Secret
  12463. resource is used as the app role id.</p>
  12464. </td>
  12465. </tr>
  12466. <tr>
  12467. <td>
  12468. <code>secretRef</code></br>
  12469. <em>
  12470. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12471. External Secrets meta/v1.SecretKeySelector
  12472. </a>
  12473. </em>
  12474. </td>
  12475. <td>
  12476. <p>Reference to a key in a Secret that contains the App Role secret used
  12477. to authenticate with Vault.
  12478. The <code>key</code> field must be specified and denotes which entry within the Secret
  12479. resource is used as the app role secret.</p>
  12480. </td>
  12481. </tr>
  12482. </tbody>
  12483. </table>
  12484. <h3 id="external-secrets.io/v1.VaultAuth">VaultAuth
  12485. </h3>
  12486. <p>
  12487. (<em>Appears on:</em>
  12488. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  12489. </p>
  12490. <p>
  12491. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  12492. 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>
  12493. can be specified. A namespace to authenticate against can optionally be specified.</p>
  12494. </p>
  12495. <table>
  12496. <thead>
  12497. <tr>
  12498. <th>Field</th>
  12499. <th>Description</th>
  12500. </tr>
  12501. </thead>
  12502. <tbody>
  12503. <tr>
  12504. <td>
  12505. <code>namespace</code></br>
  12506. <em>
  12507. string
  12508. </em>
  12509. </td>
  12510. <td>
  12511. <em>(Optional)</em>
  12512. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  12513. Namespaces is a set of features within Vault Enterprise that allows
  12514. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  12515. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  12516. This will default to Vault.Namespace field if set, or empty otherwise</p>
  12517. </td>
  12518. </tr>
  12519. <tr>
  12520. <td>
  12521. <code>tokenSecretRef</code></br>
  12522. <em>
  12523. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12524. External Secrets meta/v1.SecretKeySelector
  12525. </a>
  12526. </em>
  12527. </td>
  12528. <td>
  12529. <em>(Optional)</em>
  12530. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  12531. </td>
  12532. </tr>
  12533. <tr>
  12534. <td>
  12535. <code>appRole</code></br>
  12536. <em>
  12537. <a href="#external-secrets.io/v1.VaultAppRole">
  12538. VaultAppRole
  12539. </a>
  12540. </em>
  12541. </td>
  12542. <td>
  12543. <em>(Optional)</em>
  12544. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  12545. with the role and secret stored in a Kubernetes Secret resource.</p>
  12546. </td>
  12547. </tr>
  12548. <tr>
  12549. <td>
  12550. <code>kubernetes</code></br>
  12551. <em>
  12552. <a href="#external-secrets.io/v1.VaultKubernetesAuth">
  12553. VaultKubernetesAuth
  12554. </a>
  12555. </em>
  12556. </td>
  12557. <td>
  12558. <em>(Optional)</em>
  12559. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  12560. token stored in the named Secret resource to the Vault server.</p>
  12561. </td>
  12562. </tr>
  12563. <tr>
  12564. <td>
  12565. <code>ldap</code></br>
  12566. <em>
  12567. <a href="#external-secrets.io/v1.VaultLdapAuth">
  12568. VaultLdapAuth
  12569. </a>
  12570. </em>
  12571. </td>
  12572. <td>
  12573. <em>(Optional)</em>
  12574. <p>Ldap authenticates with Vault by passing username/password pair using
  12575. the LDAP authentication method</p>
  12576. </td>
  12577. </tr>
  12578. <tr>
  12579. <td>
  12580. <code>jwt</code></br>
  12581. <em>
  12582. <a href="#external-secrets.io/v1.VaultJwtAuth">
  12583. VaultJwtAuth
  12584. </a>
  12585. </em>
  12586. </td>
  12587. <td>
  12588. <em>(Optional)</em>
  12589. <p>Jwt authenticates with Vault by passing role and JWT token using the
  12590. JWT/OIDC authentication method</p>
  12591. </td>
  12592. </tr>
  12593. <tr>
  12594. <td>
  12595. <code>cert</code></br>
  12596. <em>
  12597. <a href="#external-secrets.io/v1.VaultCertAuth">
  12598. VaultCertAuth
  12599. </a>
  12600. </em>
  12601. </td>
  12602. <td>
  12603. <em>(Optional)</em>
  12604. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  12605. Cert authentication method</p>
  12606. </td>
  12607. </tr>
  12608. <tr>
  12609. <td>
  12610. <code>iam</code></br>
  12611. <em>
  12612. <a href="#external-secrets.io/v1.VaultIamAuth">
  12613. VaultIamAuth
  12614. </a>
  12615. </em>
  12616. </td>
  12617. <td>
  12618. <em>(Optional)</em>
  12619. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  12620. AWS IAM authentication method</p>
  12621. </td>
  12622. </tr>
  12623. <tr>
  12624. <td>
  12625. <code>userPass</code></br>
  12626. <em>
  12627. <a href="#external-secrets.io/v1.VaultUserPassAuth">
  12628. VaultUserPassAuth
  12629. </a>
  12630. </em>
  12631. </td>
  12632. <td>
  12633. <em>(Optional)</em>
  12634. <p>UserPass authenticates with Vault by passing username/password pair</p>
  12635. </td>
  12636. </tr>
  12637. <tr>
  12638. <td>
  12639. <code>gcp</code></br>
  12640. <em>
  12641. <a href="#external-secrets.io/v1.VaultGCPAuth">
  12642. VaultGCPAuth
  12643. </a>
  12644. </em>
  12645. </td>
  12646. <td>
  12647. <em>(Optional)</em>
  12648. <p>Gcp authenticates with Vault using Google Cloud Platform authentication method
  12649. GCP authentication method</p>
  12650. </td>
  12651. </tr>
  12652. </tbody>
  12653. </table>
  12654. <h3 id="external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth
  12655. </h3>
  12656. <p>
  12657. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  12658. Only one of secretRef or jwt can be specified.
  12659. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  12660. </p>
  12661. <table>
  12662. <thead>
  12663. <tr>
  12664. <th>Field</th>
  12665. <th>Description</th>
  12666. </tr>
  12667. </thead>
  12668. <tbody>
  12669. <tr>
  12670. <td>
  12671. <code>secretRef</code></br>
  12672. <em>
  12673. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  12674. VaultAwsAuthSecretRef
  12675. </a>
  12676. </em>
  12677. </td>
  12678. <td>
  12679. <em>(Optional)</em>
  12680. </td>
  12681. </tr>
  12682. <tr>
  12683. <td>
  12684. <code>jwt</code></br>
  12685. <em>
  12686. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  12687. VaultAwsJWTAuth
  12688. </a>
  12689. </em>
  12690. </td>
  12691. <td>
  12692. <em>(Optional)</em>
  12693. </td>
  12694. </tr>
  12695. </tbody>
  12696. </table>
  12697. <h3 id="external-secrets.io/v1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  12698. </h3>
  12699. <p>
  12700. (<em>Appears on:</em>
  12701. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  12702. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  12703. </p>
  12704. <p>
  12705. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  12706. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  12707. </p>
  12708. <table>
  12709. <thead>
  12710. <tr>
  12711. <th>Field</th>
  12712. <th>Description</th>
  12713. </tr>
  12714. </thead>
  12715. <tbody>
  12716. <tr>
  12717. <td>
  12718. <code>accessKeyIDSecretRef</code></br>
  12719. <em>
  12720. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12721. External Secrets meta/v1.SecretKeySelector
  12722. </a>
  12723. </em>
  12724. </td>
  12725. <td>
  12726. <em>(Optional)</em>
  12727. <p>The AccessKeyID is used for authentication</p>
  12728. </td>
  12729. </tr>
  12730. <tr>
  12731. <td>
  12732. <code>secretAccessKeySecretRef</code></br>
  12733. <em>
  12734. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12735. External Secrets meta/v1.SecretKeySelector
  12736. </a>
  12737. </em>
  12738. </td>
  12739. <td>
  12740. <em>(Optional)</em>
  12741. <p>The SecretAccessKey is used for authentication</p>
  12742. </td>
  12743. </tr>
  12744. <tr>
  12745. <td>
  12746. <code>sessionTokenSecretRef</code></br>
  12747. <em>
  12748. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12749. External Secrets meta/v1.SecretKeySelector
  12750. </a>
  12751. </em>
  12752. </td>
  12753. <td>
  12754. <em>(Optional)</em>
  12755. <p>The SessionToken used for authentication
  12756. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  12757. 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>
  12758. </td>
  12759. </tr>
  12760. </tbody>
  12761. </table>
  12762. <h3 id="external-secrets.io/v1.VaultAwsJWTAuth">VaultAwsJWTAuth
  12763. </h3>
  12764. <p>
  12765. (<em>Appears on:</em>
  12766. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  12767. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  12768. </p>
  12769. <p>
  12770. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  12771. </p>
  12772. <table>
  12773. <thead>
  12774. <tr>
  12775. <th>Field</th>
  12776. <th>Description</th>
  12777. </tr>
  12778. </thead>
  12779. <tbody>
  12780. <tr>
  12781. <td>
  12782. <code>serviceAccountRef</code></br>
  12783. <em>
  12784. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  12785. External Secrets meta/v1.ServiceAccountSelector
  12786. </a>
  12787. </em>
  12788. </td>
  12789. <td>
  12790. <em>(Optional)</em>
  12791. </td>
  12792. </tr>
  12793. </tbody>
  12794. </table>
  12795. <h3 id="external-secrets.io/v1.VaultCertAuth">VaultCertAuth
  12796. </h3>
  12797. <p>
  12798. (<em>Appears on:</em>
  12799. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12800. </p>
  12801. <p>
  12802. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  12803. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  12804. </p>
  12805. <table>
  12806. <thead>
  12807. <tr>
  12808. <th>Field</th>
  12809. <th>Description</th>
  12810. </tr>
  12811. </thead>
  12812. <tbody>
  12813. <tr>
  12814. <td>
  12815. <code>path</code></br>
  12816. <em>
  12817. string
  12818. </em>
  12819. </td>
  12820. <td>
  12821. <em>(Optional)</em>
  12822. <p>Path where the Certificate authentication backend is mounted
  12823. in Vault, e.g: &ldquo;cert&rdquo;</p>
  12824. </td>
  12825. </tr>
  12826. <tr>
  12827. <td>
  12828. <code>vaultRole</code></br>
  12829. <em>
  12830. string
  12831. </em>
  12832. </td>
  12833. <td>
  12834. <em>(Optional)</em>
  12835. <p>VaultRole specifies the Vault role to use for TLS certificate authentication.</p>
  12836. </td>
  12837. </tr>
  12838. <tr>
  12839. <td>
  12840. <code>clientCert</code></br>
  12841. <em>
  12842. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12843. External Secrets meta/v1.SecretKeySelector
  12844. </a>
  12845. </em>
  12846. </td>
  12847. <td>
  12848. <em>(Optional)</em>
  12849. <p>ClientCert is a certificate to authenticate using the Cert Vault
  12850. authentication method</p>
  12851. </td>
  12852. </tr>
  12853. <tr>
  12854. <td>
  12855. <code>secretRef</code></br>
  12856. <em>
  12857. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12858. External Secrets meta/v1.SecretKeySelector
  12859. </a>
  12860. </em>
  12861. </td>
  12862. <td>
  12863. <em>(Optional)</em>
  12864. <p>SecretRef to a key in a Secret resource containing client private key to
  12865. authenticate with Vault using the Cert authentication method</p>
  12866. </td>
  12867. </tr>
  12868. </tbody>
  12869. </table>
  12870. <h3 id="external-secrets.io/v1.VaultCheckAndSet">VaultCheckAndSet
  12871. </h3>
  12872. <p>
  12873. (<em>Appears on:</em>
  12874. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  12875. </p>
  12876. <p>
  12877. <p>VaultCheckAndSet defines the Check-And-Set (CAS) settings for Vault KV v2 PushSecret operations.</p>
  12878. </p>
  12879. <table>
  12880. <thead>
  12881. <tr>
  12882. <th>Field</th>
  12883. <th>Description</th>
  12884. </tr>
  12885. </thead>
  12886. <tbody>
  12887. <tr>
  12888. <td>
  12889. <code>required</code></br>
  12890. <em>
  12891. bool
  12892. </em>
  12893. </td>
  12894. <td>
  12895. <em>(Optional)</em>
  12896. <p>Required when true, all write operations must include a check-and-set parameter.
  12897. This helps prevent unintentional overwrites of secrets.</p>
  12898. </td>
  12899. </tr>
  12900. </tbody>
  12901. </table>
  12902. <h3 id="external-secrets.io/v1.VaultClientTLS">VaultClientTLS
  12903. </h3>
  12904. <p>
  12905. (<em>Appears on:</em>
  12906. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  12907. </p>
  12908. <p>
  12909. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  12910. when the Vault server requires mutual authentication.</p>
  12911. </p>
  12912. <table>
  12913. <thead>
  12914. <tr>
  12915. <th>Field</th>
  12916. <th>Description</th>
  12917. </tr>
  12918. </thead>
  12919. <tbody>
  12920. <tr>
  12921. <td>
  12922. <code>certSecretRef</code></br>
  12923. <em>
  12924. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12925. External Secrets meta/v1.SecretKeySelector
  12926. </a>
  12927. </em>
  12928. </td>
  12929. <td>
  12930. <em>(Optional)</em>
  12931. <p>CertSecretRef is a certificate added to the transport layer
  12932. when communicating with the Vault server.
  12933. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  12934. </td>
  12935. </tr>
  12936. <tr>
  12937. <td>
  12938. <code>keySecretRef</code></br>
  12939. <em>
  12940. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12941. External Secrets meta/v1.SecretKeySelector
  12942. </a>
  12943. </em>
  12944. </td>
  12945. <td>
  12946. <em>(Optional)</em>
  12947. <p>KeySecretRef to a key in a Secret resource containing client private key
  12948. added to the transport layer when communicating with the Vault server.
  12949. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  12950. </td>
  12951. </tr>
  12952. </tbody>
  12953. </table>
  12954. <h3 id="external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth
  12955. </h3>
  12956. <p>
  12957. (<em>Appears on:</em>
  12958. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12959. </p>
  12960. <p>
  12961. <p>VaultGCPAuth authenticates with Vault using Google Cloud Platform authentication method.
  12962. Refer: <a href="https://developer.hashicorp.com/vault/docs/auth/gcp">https://developer.hashicorp.com/vault/docs/auth/gcp</a></p>
  12963. <p>When ServiceAccountRef, SecretRef and WorkloadIdentity are not specified, the provider will use the controller pod&rsquo;s
  12964. identity to authenticate with GCP. This supports both GKE Workload Identity and service account keys.</p>
  12965. </p>
  12966. <table>
  12967. <thead>
  12968. <tr>
  12969. <th>Field</th>
  12970. <th>Description</th>
  12971. </tr>
  12972. </thead>
  12973. <tbody>
  12974. <tr>
  12975. <td>
  12976. <code>path</code></br>
  12977. <em>
  12978. string
  12979. </em>
  12980. </td>
  12981. <td>
  12982. <em>(Optional)</em>
  12983. <p>Path where the GCP auth method is enabled in Vault, e.g: &ldquo;gcp&rdquo;</p>
  12984. </td>
  12985. </tr>
  12986. <tr>
  12987. <td>
  12988. <code>role</code></br>
  12989. <em>
  12990. string
  12991. </em>
  12992. </td>
  12993. <td>
  12994. <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>
  12995. </td>
  12996. </tr>
  12997. <tr>
  12998. <td>
  12999. <code>projectID</code></br>
  13000. <em>
  13001. string
  13002. </em>
  13003. </td>
  13004. <td>
  13005. <em>(Optional)</em>
  13006. <p>Project ID of the Google Cloud Platform project</p>
  13007. </td>
  13008. </tr>
  13009. <tr>
  13010. <td>
  13011. <code>location</code></br>
  13012. <em>
  13013. string
  13014. </em>
  13015. </td>
  13016. <td>
  13017. <em>(Optional)</em>
  13018. <p>Location optionally defines a location/region for the secret</p>
  13019. </td>
  13020. </tr>
  13021. <tr>
  13022. <td>
  13023. <code>secretRef</code></br>
  13024. <em>
  13025. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  13026. GCPSMAuthSecretRef
  13027. </a>
  13028. </em>
  13029. </td>
  13030. <td>
  13031. <em>(Optional)</em>
  13032. <p>Specify credentials in a Secret object</p>
  13033. </td>
  13034. </tr>
  13035. <tr>
  13036. <td>
  13037. <code>workloadIdentity</code></br>
  13038. <em>
  13039. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  13040. GCPWorkloadIdentity
  13041. </a>
  13042. </em>
  13043. </td>
  13044. <td>
  13045. <em>(Optional)</em>
  13046. <p>Specify a service account with Workload Identity</p>
  13047. </td>
  13048. </tr>
  13049. <tr>
  13050. <td>
  13051. <code>serviceAccountRef</code></br>
  13052. <em>
  13053. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  13054. External Secrets meta/v1.ServiceAccountSelector
  13055. </a>
  13056. </em>
  13057. </td>
  13058. <td>
  13059. <em>(Optional)</em>
  13060. <p>ServiceAccountRef to a service account for impersonation</p>
  13061. </td>
  13062. </tr>
  13063. </tbody>
  13064. </table>
  13065. <h3 id="external-secrets.io/v1.VaultIamAuth">VaultIamAuth
  13066. </h3>
  13067. <p>
  13068. (<em>Appears on:</em>
  13069. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13070. </p>
  13071. <p>
  13072. <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>
  13073. <p>When JWTAuth and SecretRef are not specified, the provider will use the controller pod&rsquo;s
  13074. identity to authenticate with AWS. This supports both IRSA and EKS Pod Identity.</p>
  13075. </p>
  13076. <table>
  13077. <thead>
  13078. <tr>
  13079. <th>Field</th>
  13080. <th>Description</th>
  13081. </tr>
  13082. </thead>
  13083. <tbody>
  13084. <tr>
  13085. <td>
  13086. <code>path</code></br>
  13087. <em>
  13088. string
  13089. </em>
  13090. </td>
  13091. <td>
  13092. <em>(Optional)</em>
  13093. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  13094. </td>
  13095. </tr>
  13096. <tr>
  13097. <td>
  13098. <code>region</code></br>
  13099. <em>
  13100. string
  13101. </em>
  13102. </td>
  13103. <td>
  13104. <em>(Optional)</em>
  13105. <p>AWS region</p>
  13106. </td>
  13107. </tr>
  13108. <tr>
  13109. <td>
  13110. <code>role</code></br>
  13111. <em>
  13112. string
  13113. </em>
  13114. </td>
  13115. <td>
  13116. <em>(Optional)</em>
  13117. <p>This is the AWS role to be assumed before talking to vault</p>
  13118. </td>
  13119. </tr>
  13120. <tr>
  13121. <td>
  13122. <code>vaultRole</code></br>
  13123. <em>
  13124. string
  13125. </em>
  13126. </td>
  13127. <td>
  13128. <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>
  13129. </td>
  13130. </tr>
  13131. <tr>
  13132. <td>
  13133. <code>externalID</code></br>
  13134. <em>
  13135. string
  13136. </em>
  13137. </td>
  13138. <td>
  13139. <p>AWS External ID set on assumed IAM roles</p>
  13140. </td>
  13141. </tr>
  13142. <tr>
  13143. <td>
  13144. <code>vaultAwsIamServerID</code></br>
  13145. <em>
  13146. string
  13147. </em>
  13148. </td>
  13149. <td>
  13150. <em>(Optional)</em>
  13151. <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>
  13152. </td>
  13153. </tr>
  13154. <tr>
  13155. <td>
  13156. <code>secretRef</code></br>
  13157. <em>
  13158. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  13159. VaultAwsAuthSecretRef
  13160. </a>
  13161. </em>
  13162. </td>
  13163. <td>
  13164. <em>(Optional)</em>
  13165. <p>Specify credentials in a Secret object</p>
  13166. </td>
  13167. </tr>
  13168. <tr>
  13169. <td>
  13170. <code>jwt</code></br>
  13171. <em>
  13172. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  13173. VaultAwsJWTAuth
  13174. </a>
  13175. </em>
  13176. </td>
  13177. <td>
  13178. <em>(Optional)</em>
  13179. <p>Specify a service account with IRSA enabled</p>
  13180. </td>
  13181. </tr>
  13182. </tbody>
  13183. </table>
  13184. <h3 id="external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth
  13185. </h3>
  13186. <p>
  13187. (<em>Appears on:</em>
  13188. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13189. </p>
  13190. <p>
  13191. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  13192. method, with the role name and a token stored in a Kubernetes Secret resource or
  13193. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  13194. </p>
  13195. <table>
  13196. <thead>
  13197. <tr>
  13198. <th>Field</th>
  13199. <th>Description</th>
  13200. </tr>
  13201. </thead>
  13202. <tbody>
  13203. <tr>
  13204. <td>
  13205. <code>path</code></br>
  13206. <em>
  13207. string
  13208. </em>
  13209. </td>
  13210. <td>
  13211. <p>Path where the JWT authentication backend is mounted
  13212. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  13213. </td>
  13214. </tr>
  13215. <tr>
  13216. <td>
  13217. <code>role</code></br>
  13218. <em>
  13219. string
  13220. </em>
  13221. </td>
  13222. <td>
  13223. <em>(Optional)</em>
  13224. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  13225. authentication method</p>
  13226. </td>
  13227. </tr>
  13228. <tr>
  13229. <td>
  13230. <code>secretRef</code></br>
  13231. <em>
  13232. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13233. External Secrets meta/v1.SecretKeySelector
  13234. </a>
  13235. </em>
  13236. </td>
  13237. <td>
  13238. <em>(Optional)</em>
  13239. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  13240. authenticate with Vault using the JWT/OIDC authentication method.</p>
  13241. </td>
  13242. </tr>
  13243. <tr>
  13244. <td>
  13245. <code>kubernetesServiceAccountToken</code></br>
  13246. <em>
  13247. <a href="#external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">
  13248. VaultKubernetesServiceAccountTokenAuth
  13249. </a>
  13250. </em>
  13251. </td>
  13252. <td>
  13253. <em>(Optional)</em>
  13254. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  13255. a token for with the <code>TokenRequest</code> API.</p>
  13256. </td>
  13257. </tr>
  13258. </tbody>
  13259. </table>
  13260. <h3 id="external-secrets.io/v1.VaultKVStoreVersion">VaultKVStoreVersion
  13261. (<code>string</code> alias)</p></h3>
  13262. <p>
  13263. (<em>Appears on:</em>
  13264. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  13265. </p>
  13266. <p>
  13267. <p>VaultKVStoreVersion represents the version of the Vault KV secret engine.</p>
  13268. </p>
  13269. <table>
  13270. <thead>
  13271. <tr>
  13272. <th>Value</th>
  13273. <th>Description</th>
  13274. </tr>
  13275. </thead>
  13276. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  13277. <td></td>
  13278. </tr><tr><td><p>&#34;v2&#34;</p></td>
  13279. <td></td>
  13280. </tr></tbody>
  13281. </table>
  13282. <h3 id="external-secrets.io/v1.VaultKubernetesAuth">VaultKubernetesAuth
  13283. </h3>
  13284. <p>
  13285. (<em>Appears on:</em>
  13286. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13287. </p>
  13288. <p>
  13289. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in
  13290. a Secret.</p>
  13291. </p>
  13292. <table>
  13293. <thead>
  13294. <tr>
  13295. <th>Field</th>
  13296. <th>Description</th>
  13297. </tr>
  13298. </thead>
  13299. <tbody>
  13300. <tr>
  13301. <td>
  13302. <code>mountPath</code></br>
  13303. <em>
  13304. string
  13305. </em>
  13306. </td>
  13307. <td>
  13308. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  13309. &ldquo;kubernetes&rdquo;</p>
  13310. </td>
  13311. </tr>
  13312. <tr>
  13313. <td>
  13314. <code>serviceAccountRef</code></br>
  13315. <em>
  13316. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  13317. External Secrets meta/v1.ServiceAccountSelector
  13318. </a>
  13319. </em>
  13320. </td>
  13321. <td>
  13322. <em>(Optional)</em>
  13323. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  13324. If the service account is specified, the service account secret token JWT will be used
  13325. for authenticating with Vault. If the service account selector is not supplied,
  13326. the secretRef will be used instead.</p>
  13327. </td>
  13328. </tr>
  13329. <tr>
  13330. <td>
  13331. <code>secretRef</code></br>
  13332. <em>
  13333. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13334. External Secrets meta/v1.SecretKeySelector
  13335. </a>
  13336. </em>
  13337. </td>
  13338. <td>
  13339. <em>(Optional)</em>
  13340. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  13341. for authenticating with Vault. If a name is specified without a key,
  13342. <code>token</code> is the default. If one is not specified, the one bound to
  13343. the controller will be used.</p>
  13344. </td>
  13345. </tr>
  13346. <tr>
  13347. <td>
  13348. <code>role</code></br>
  13349. <em>
  13350. string
  13351. </em>
  13352. </td>
  13353. <td>
  13354. <p>A required field containing the Vault Role to assume. A Role binds a
  13355. Kubernetes ServiceAccount with a set of Vault policies.</p>
  13356. </td>
  13357. </tr>
  13358. </tbody>
  13359. </table>
  13360. <h3 id="external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  13361. </h3>
  13362. <p>
  13363. (<em>Appears on:</em>
  13364. <a href="#external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth</a>)
  13365. </p>
  13366. <p>
  13367. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  13368. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  13369. </p>
  13370. <table>
  13371. <thead>
  13372. <tr>
  13373. <th>Field</th>
  13374. <th>Description</th>
  13375. </tr>
  13376. </thead>
  13377. <tbody>
  13378. <tr>
  13379. <td>
  13380. <code>serviceAccountRef</code></br>
  13381. <em>
  13382. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  13383. External Secrets meta/v1.ServiceAccountSelector
  13384. </a>
  13385. </em>
  13386. </td>
  13387. <td>
  13388. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  13389. </td>
  13390. </tr>
  13391. <tr>
  13392. <td>
  13393. <code>audiences</code></br>
  13394. <em>
  13395. []string
  13396. </em>
  13397. </td>
  13398. <td>
  13399. <em>(Optional)</em>
  13400. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  13401. account token for the service account referenced by <code>serviceAccountRef</code>.
  13402. Defaults to a single audience <code>vault</code> it not specified.</p>
  13403. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  13404. </td>
  13405. </tr>
  13406. <tr>
  13407. <td>
  13408. <code>expirationSeconds</code></br>
  13409. <em>
  13410. int64
  13411. </em>
  13412. </td>
  13413. <td>
  13414. <em>(Optional)</em>
  13415. <p>Optional expiration time in seconds that will be used to request a temporary
  13416. Kubernetes service account token for the service account referenced by
  13417. <code>serviceAccountRef</code>.</p>
  13418. <p>Deprecated: this will be removed in the future.
  13419. Defaults to 10 minutes.</p>
  13420. </td>
  13421. </tr>
  13422. </tbody>
  13423. </table>
  13424. <h3 id="external-secrets.io/v1.VaultLdapAuth">VaultLdapAuth
  13425. </h3>
  13426. <p>
  13427. (<em>Appears on:</em>
  13428. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13429. </p>
  13430. <p>
  13431. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  13432. with the username and password stored in a Kubernetes Secret resource.</p>
  13433. </p>
  13434. <table>
  13435. <thead>
  13436. <tr>
  13437. <th>Field</th>
  13438. <th>Description</th>
  13439. </tr>
  13440. </thead>
  13441. <tbody>
  13442. <tr>
  13443. <td>
  13444. <code>path</code></br>
  13445. <em>
  13446. string
  13447. </em>
  13448. </td>
  13449. <td>
  13450. <p>Path where the LDAP authentication backend is mounted
  13451. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  13452. </td>
  13453. </tr>
  13454. <tr>
  13455. <td>
  13456. <code>username</code></br>
  13457. <em>
  13458. string
  13459. </em>
  13460. </td>
  13461. <td>
  13462. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  13463. authentication method</p>
  13464. </td>
  13465. </tr>
  13466. <tr>
  13467. <td>
  13468. <code>secretRef</code></br>
  13469. <em>
  13470. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13471. External Secrets meta/v1.SecretKeySelector
  13472. </a>
  13473. </em>
  13474. </td>
  13475. <td>
  13476. <em>(Optional)</em>
  13477. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  13478. user used to authenticate with Vault using the LDAP authentication
  13479. method</p>
  13480. </td>
  13481. </tr>
  13482. </tbody>
  13483. </table>
  13484. <h3 id="external-secrets.io/v1.VaultProvider">VaultProvider
  13485. </h3>
  13486. <p>
  13487. (<em>Appears on:</em>
  13488. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  13489. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  13490. </p>
  13491. <p>
  13492. <p>VaultProvider configures a store to sync secrets using a Hashicorp Vault KV backend.</p>
  13493. </p>
  13494. <table>
  13495. <thead>
  13496. <tr>
  13497. <th>Field</th>
  13498. <th>Description</th>
  13499. </tr>
  13500. </thead>
  13501. <tbody>
  13502. <tr>
  13503. <td>
  13504. <code>auth</code></br>
  13505. <em>
  13506. <a href="#external-secrets.io/v1.VaultAuth">
  13507. VaultAuth
  13508. </a>
  13509. </em>
  13510. </td>
  13511. <td>
  13512. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  13513. </td>
  13514. </tr>
  13515. <tr>
  13516. <td>
  13517. <code>server</code></br>
  13518. <em>
  13519. string
  13520. </em>
  13521. </td>
  13522. <td>
  13523. <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>
  13524. </td>
  13525. </tr>
  13526. <tr>
  13527. <td>
  13528. <code>path</code></br>
  13529. <em>
  13530. string
  13531. </em>
  13532. </td>
  13533. <td>
  13534. <em>(Optional)</em>
  13535. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  13536. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  13537. for fetching secrets from Vault is optional and will be appended
  13538. if not present in specified path.</p>
  13539. </td>
  13540. </tr>
  13541. <tr>
  13542. <td>
  13543. <code>version</code></br>
  13544. <em>
  13545. <a href="#external-secrets.io/v1.VaultKVStoreVersion">
  13546. VaultKVStoreVersion
  13547. </a>
  13548. </em>
  13549. </td>
  13550. <td>
  13551. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  13552. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  13553. </td>
  13554. </tr>
  13555. <tr>
  13556. <td>
  13557. <code>namespace</code></br>
  13558. <em>
  13559. string
  13560. </em>
  13561. </td>
  13562. <td>
  13563. <em>(Optional)</em>
  13564. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  13565. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  13566. 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>
  13567. </td>
  13568. </tr>
  13569. <tr>
  13570. <td>
  13571. <code>caBundle</code></br>
  13572. <em>
  13573. []byte
  13574. </em>
  13575. </td>
  13576. <td>
  13577. <em>(Optional)</em>
  13578. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  13579. if the Server URL is using HTTPS protocol. This parameter is ignored for
  13580. plain HTTP protocol connection. If not set the system root certificates
  13581. are used to validate the TLS connection.</p>
  13582. </td>
  13583. </tr>
  13584. <tr>
  13585. <td>
  13586. <code>tls</code></br>
  13587. <em>
  13588. <a href="#external-secrets.io/v1.VaultClientTLS">
  13589. VaultClientTLS
  13590. </a>
  13591. </em>
  13592. </td>
  13593. <td>
  13594. <em>(Optional)</em>
  13595. <p>The configuration used for client side related TLS communication, when the Vault server
  13596. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  13597. This parameter is ignored for plain HTTP protocol connection.
  13598. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  13599. which is available under the <code>auth.cert</code> section.</p>
  13600. </td>
  13601. </tr>
  13602. <tr>
  13603. <td>
  13604. <code>caProvider</code></br>
  13605. <em>
  13606. <a href="#external-secrets.io/v1.CAProvider">
  13607. CAProvider
  13608. </a>
  13609. </em>
  13610. </td>
  13611. <td>
  13612. <em>(Optional)</em>
  13613. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  13614. </td>
  13615. </tr>
  13616. <tr>
  13617. <td>
  13618. <code>readYourWrites</code></br>
  13619. <em>
  13620. bool
  13621. </em>
  13622. </td>
  13623. <td>
  13624. <em>(Optional)</em>
  13625. <p>ReadYourWrites ensures isolated read-after-write semantics by
  13626. providing discovered cluster replication states in each request.
  13627. More information about eventual consistency in Vault can be found here
  13628. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  13629. </td>
  13630. </tr>
  13631. <tr>
  13632. <td>
  13633. <code>forwardInconsistent</code></br>
  13634. <em>
  13635. bool
  13636. </em>
  13637. </td>
  13638. <td>
  13639. <em>(Optional)</em>
  13640. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  13641. leader instead of simply retrying within a loop. This can increase performance if
  13642. the option is enabled serverside.
  13643. <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>
  13644. </td>
  13645. </tr>
  13646. <tr>
  13647. <td>
  13648. <code>headers</code></br>
  13649. <em>
  13650. map[string]string
  13651. </em>
  13652. </td>
  13653. <td>
  13654. <em>(Optional)</em>
  13655. <p>Headers to be added in Vault request</p>
  13656. </td>
  13657. </tr>
  13658. <tr>
  13659. <td>
  13660. <code>checkAndSet</code></br>
  13661. <em>
  13662. <a href="#external-secrets.io/v1.VaultCheckAndSet">
  13663. VaultCheckAndSet
  13664. </a>
  13665. </em>
  13666. </td>
  13667. <td>
  13668. <em>(Optional)</em>
  13669. <p>CheckAndSet defines the Check-And-Set (CAS) settings for PushSecret operations.
  13670. Only applies to Vault KV v2 stores. When enabled, write operations must include
  13671. the current version of the secret to prevent unintentional overwrites.</p>
  13672. </td>
  13673. </tr>
  13674. </tbody>
  13675. </table>
  13676. <h3 id="external-secrets.io/v1.VaultUserPassAuth">VaultUserPassAuth
  13677. </h3>
  13678. <p>
  13679. (<em>Appears on:</em>
  13680. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13681. </p>
  13682. <p>
  13683. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  13684. with the username and password stored in a Kubernetes Secret resource.</p>
  13685. </p>
  13686. <table>
  13687. <thead>
  13688. <tr>
  13689. <th>Field</th>
  13690. <th>Description</th>
  13691. </tr>
  13692. </thead>
  13693. <tbody>
  13694. <tr>
  13695. <td>
  13696. <code>path</code></br>
  13697. <em>
  13698. string
  13699. </em>
  13700. </td>
  13701. <td>
  13702. <p>Path where the UserPassword authentication backend is mounted
  13703. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  13704. </td>
  13705. </tr>
  13706. <tr>
  13707. <td>
  13708. <code>username</code></br>
  13709. <em>
  13710. string
  13711. </em>
  13712. </td>
  13713. <td>
  13714. <p>Username is a username used to authenticate using the UserPass Vault
  13715. authentication method</p>
  13716. </td>
  13717. </tr>
  13718. <tr>
  13719. <td>
  13720. <code>secretRef</code></br>
  13721. <em>
  13722. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13723. External Secrets meta/v1.SecretKeySelector
  13724. </a>
  13725. </em>
  13726. </td>
  13727. <td>
  13728. <em>(Optional)</em>
  13729. <p>SecretRef to a key in a Secret resource containing password for the
  13730. user used to authenticate with Vault using the UserPass authentication
  13731. method</p>
  13732. </td>
  13733. </tr>
  13734. </tbody>
  13735. </table>
  13736. <h3 id="external-secrets.io/v1.VolcengineAuth">VolcengineAuth
  13737. </h3>
  13738. <p>
  13739. (<em>Appears on:</em>
  13740. <a href="#external-secrets.io/v1.VolcengineProvider">VolcengineProvider</a>)
  13741. </p>
  13742. <p>
  13743. <p>VolcengineAuth defines the authentication method for the Volcengine provider.
  13744. Only one of the fields should be set.</p>
  13745. </p>
  13746. <table>
  13747. <thead>
  13748. <tr>
  13749. <th>Field</th>
  13750. <th>Description</th>
  13751. </tr>
  13752. </thead>
  13753. <tbody>
  13754. <tr>
  13755. <td>
  13756. <code>secretRef</code></br>
  13757. <em>
  13758. <a href="#external-secrets.io/v1.VolcengineAuthSecretRef">
  13759. VolcengineAuthSecretRef
  13760. </a>
  13761. </em>
  13762. </td>
  13763. <td>
  13764. <em>(Optional)</em>
  13765. <p>SecretRef defines the static credentials to use for authentication.
  13766. If not set, IRSA is used.</p>
  13767. </td>
  13768. </tr>
  13769. </tbody>
  13770. </table>
  13771. <h3 id="external-secrets.io/v1.VolcengineAuthSecretRef">VolcengineAuthSecretRef
  13772. </h3>
  13773. <p>
  13774. (<em>Appears on:</em>
  13775. <a href="#external-secrets.io/v1.VolcengineAuth">VolcengineAuth</a>)
  13776. </p>
  13777. <p>
  13778. <p>VolcengineAuthSecretRef defines the secret reference for static credentials.</p>
  13779. </p>
  13780. <table>
  13781. <thead>
  13782. <tr>
  13783. <th>Field</th>
  13784. <th>Description</th>
  13785. </tr>
  13786. </thead>
  13787. <tbody>
  13788. <tr>
  13789. <td>
  13790. <code>accessKeyID</code></br>
  13791. <em>
  13792. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13793. External Secrets meta/v1.SecretKeySelector
  13794. </a>
  13795. </em>
  13796. </td>
  13797. <td>
  13798. <p>AccessKeyID is the reference to the secret containing the Access Key ID.</p>
  13799. </td>
  13800. </tr>
  13801. <tr>
  13802. <td>
  13803. <code>secretAccessKey</code></br>
  13804. <em>
  13805. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13806. External Secrets meta/v1.SecretKeySelector
  13807. </a>
  13808. </em>
  13809. </td>
  13810. <td>
  13811. <p>SecretAccessKey is the reference to the secret containing the Secret Access Key.</p>
  13812. </td>
  13813. </tr>
  13814. <tr>
  13815. <td>
  13816. <code>token</code></br>
  13817. <em>
  13818. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13819. External Secrets meta/v1.SecretKeySelector
  13820. </a>
  13821. </em>
  13822. </td>
  13823. <td>
  13824. <em>(Optional)</em>
  13825. <p>Token is the reference to the secret containing the STS(Security Token Service) Token.</p>
  13826. </td>
  13827. </tr>
  13828. </tbody>
  13829. </table>
  13830. <h3 id="external-secrets.io/v1.VolcengineProvider">VolcengineProvider
  13831. </h3>
  13832. <p>
  13833. (<em>Appears on:</em>
  13834. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  13835. </p>
  13836. <p>
  13837. <p>VolcengineProvider defines the configuration for the Volcengine provider.</p>
  13838. </p>
  13839. <table>
  13840. <thead>
  13841. <tr>
  13842. <th>Field</th>
  13843. <th>Description</th>
  13844. </tr>
  13845. </thead>
  13846. <tbody>
  13847. <tr>
  13848. <td>
  13849. <code>region</code></br>
  13850. <em>
  13851. string
  13852. </em>
  13853. </td>
  13854. <td>
  13855. <p>Region specifies the Volcengine region to connect to.</p>
  13856. </td>
  13857. </tr>
  13858. <tr>
  13859. <td>
  13860. <code>auth</code></br>
  13861. <em>
  13862. <a href="#external-secrets.io/v1.VolcengineAuth">
  13863. VolcengineAuth
  13864. </a>
  13865. </em>
  13866. </td>
  13867. <td>
  13868. <em>(Optional)</em>
  13869. <p>Auth defines the authentication method to use.
  13870. If not specified, the provider will try to use IRSA (IAM Role for Service Account).</p>
  13871. </td>
  13872. </tr>
  13873. </tbody>
  13874. </table>
  13875. <h3 id="external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider
  13876. </h3>
  13877. <p>
  13878. (<em>Appears on:</em>
  13879. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  13880. </p>
  13881. <p>
  13882. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  13883. </p>
  13884. <table>
  13885. <thead>
  13886. <tr>
  13887. <th>Field</th>
  13888. <th>Description</th>
  13889. </tr>
  13890. </thead>
  13891. <tbody>
  13892. <tr>
  13893. <td>
  13894. <code>type</code></br>
  13895. <em>
  13896. <a href="#external-secrets.io/v1.WebhookCAProviderType">
  13897. WebhookCAProviderType
  13898. </a>
  13899. </em>
  13900. </td>
  13901. <td>
  13902. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  13903. </td>
  13904. </tr>
  13905. <tr>
  13906. <td>
  13907. <code>name</code></br>
  13908. <em>
  13909. string
  13910. </em>
  13911. </td>
  13912. <td>
  13913. <p>The name of the object located at the provider type.</p>
  13914. </td>
  13915. </tr>
  13916. <tr>
  13917. <td>
  13918. <code>key</code></br>
  13919. <em>
  13920. string
  13921. </em>
  13922. </td>
  13923. <td>
  13924. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  13925. </td>
  13926. </tr>
  13927. <tr>
  13928. <td>
  13929. <code>namespace</code></br>
  13930. <em>
  13931. string
  13932. </em>
  13933. </td>
  13934. <td>
  13935. <em>(Optional)</em>
  13936. <p>The namespace the Provider type is in.</p>
  13937. </td>
  13938. </tr>
  13939. </tbody>
  13940. </table>
  13941. <h3 id="external-secrets.io/v1.WebhookCAProviderType">WebhookCAProviderType
  13942. (<code>string</code> alias)</p></h3>
  13943. <p>
  13944. (<em>Appears on:</em>
  13945. <a href="#external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider</a>)
  13946. </p>
  13947. <p>
  13948. <p>WebhookCAProviderType defines the type of provider for certificate authority in webhook connections.</p>
  13949. </p>
  13950. <table>
  13951. <thead>
  13952. <tr>
  13953. <th>Value</th>
  13954. <th>Description</th>
  13955. </tr>
  13956. </thead>
  13957. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  13958. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  13959. </td>
  13960. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  13961. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  13962. </td>
  13963. </tr></tbody>
  13964. </table>
  13965. <h3 id="external-secrets.io/v1.WebhookProvider">WebhookProvider
  13966. </h3>
  13967. <p>
  13968. (<em>Appears on:</em>
  13969. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  13970. </p>
  13971. <p>
  13972. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  13973. </p>
  13974. <table>
  13975. <thead>
  13976. <tr>
  13977. <th>Field</th>
  13978. <th>Description</th>
  13979. </tr>
  13980. </thead>
  13981. <tbody>
  13982. <tr>
  13983. <td>
  13984. <code>method</code></br>
  13985. <em>
  13986. string
  13987. </em>
  13988. </td>
  13989. <td>
  13990. <p>Webhook Method</p>
  13991. </td>
  13992. </tr>
  13993. <tr>
  13994. <td>
  13995. <code>url</code></br>
  13996. <em>
  13997. string
  13998. </em>
  13999. </td>
  14000. <td>
  14001. <p>Webhook url to call</p>
  14002. </td>
  14003. </tr>
  14004. <tr>
  14005. <td>
  14006. <code>headers</code></br>
  14007. <em>
  14008. map[string]string
  14009. </em>
  14010. </td>
  14011. <td>
  14012. <em>(Optional)</em>
  14013. <p>Headers</p>
  14014. </td>
  14015. </tr>
  14016. <tr>
  14017. <td>
  14018. <code>auth</code></br>
  14019. <em>
  14020. <a href="#external-secrets.io/v1.AuthorizationProtocol">
  14021. AuthorizationProtocol
  14022. </a>
  14023. </em>
  14024. </td>
  14025. <td>
  14026. <em>(Optional)</em>
  14027. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  14028. </td>
  14029. </tr>
  14030. <tr>
  14031. <td>
  14032. <code>body</code></br>
  14033. <em>
  14034. string
  14035. </em>
  14036. </td>
  14037. <td>
  14038. <em>(Optional)</em>
  14039. <p>Body</p>
  14040. </td>
  14041. </tr>
  14042. <tr>
  14043. <td>
  14044. <code>timeout</code></br>
  14045. <em>
  14046. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14047. Kubernetes meta/v1.Duration
  14048. </a>
  14049. </em>
  14050. </td>
  14051. <td>
  14052. <em>(Optional)</em>
  14053. <p>Timeout</p>
  14054. </td>
  14055. </tr>
  14056. <tr>
  14057. <td>
  14058. <code>result</code></br>
  14059. <em>
  14060. <a href="#external-secrets.io/v1.WebhookResult">
  14061. WebhookResult
  14062. </a>
  14063. </em>
  14064. </td>
  14065. <td>
  14066. <em>(Optional)</em>
  14067. <p>Result formatting</p>
  14068. </td>
  14069. </tr>
  14070. <tr>
  14071. <td>
  14072. <code>secrets</code></br>
  14073. <em>
  14074. <a href="#external-secrets.io/v1.WebhookSecret">
  14075. []WebhookSecret
  14076. </a>
  14077. </em>
  14078. </td>
  14079. <td>
  14080. <em>(Optional)</em>
  14081. <p>Secrets to fill in templates
  14082. These secrets will be passed to the templating function as key value pairs under the given name</p>
  14083. </td>
  14084. </tr>
  14085. <tr>
  14086. <td>
  14087. <code>caBundle</code></br>
  14088. <em>
  14089. []byte
  14090. </em>
  14091. </td>
  14092. <td>
  14093. <em>(Optional)</em>
  14094. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  14095. if the Server URL is using HTTPS protocol. This parameter is ignored for
  14096. plain HTTP protocol connection. If not set the system root certificates
  14097. are used to validate the TLS connection.</p>
  14098. </td>
  14099. </tr>
  14100. <tr>
  14101. <td>
  14102. <code>caProvider</code></br>
  14103. <em>
  14104. <a href="#external-secrets.io/v1.WebhookCAProvider">
  14105. WebhookCAProvider
  14106. </a>
  14107. </em>
  14108. </td>
  14109. <td>
  14110. <em>(Optional)</em>
  14111. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  14112. </td>
  14113. </tr>
  14114. </tbody>
  14115. </table>
  14116. <h3 id="external-secrets.io/v1.WebhookResult">WebhookResult
  14117. </h3>
  14118. <p>
  14119. (<em>Appears on:</em>
  14120. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  14121. </p>
  14122. <p>
  14123. <p>WebhookResult defines how to process and extract secrets from the webhook response.</p>
  14124. </p>
  14125. <table>
  14126. <thead>
  14127. <tr>
  14128. <th>Field</th>
  14129. <th>Description</th>
  14130. </tr>
  14131. </thead>
  14132. <tbody>
  14133. <tr>
  14134. <td>
  14135. <code>jsonPath</code></br>
  14136. <em>
  14137. string
  14138. </em>
  14139. </td>
  14140. <td>
  14141. <em>(Optional)</em>
  14142. <p>Json path of return value</p>
  14143. </td>
  14144. </tr>
  14145. </tbody>
  14146. </table>
  14147. <h3 id="external-secrets.io/v1.WebhookSecret">WebhookSecret
  14148. </h3>
  14149. <p>
  14150. (<em>Appears on:</em>
  14151. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  14152. </p>
  14153. <p>
  14154. <p>WebhookSecret defines a secret that will be passed to the webhook request.</p>
  14155. </p>
  14156. <table>
  14157. <thead>
  14158. <tr>
  14159. <th>Field</th>
  14160. <th>Description</th>
  14161. </tr>
  14162. </thead>
  14163. <tbody>
  14164. <tr>
  14165. <td>
  14166. <code>name</code></br>
  14167. <em>
  14168. string
  14169. </em>
  14170. </td>
  14171. <td>
  14172. <p>Name of this secret in templates</p>
  14173. </td>
  14174. </tr>
  14175. <tr>
  14176. <td>
  14177. <code>secretRef</code></br>
  14178. <em>
  14179. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14180. External Secrets meta/v1.SecretKeySelector
  14181. </a>
  14182. </em>
  14183. </td>
  14184. <td>
  14185. <p>Secret ref to fill in credentials</p>
  14186. </td>
  14187. </tr>
  14188. </tbody>
  14189. </table>
  14190. <h3 id="external-secrets.io/v1.YandexAuth">YandexAuth
  14191. </h3>
  14192. <p>
  14193. (<em>Appears on:</em>
  14194. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  14195. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  14196. </p>
  14197. <p>
  14198. <p>YandexAuth defines the authentication method for the Yandex provider.</p>
  14199. </p>
  14200. <table>
  14201. <thead>
  14202. <tr>
  14203. <th>Field</th>
  14204. <th>Description</th>
  14205. </tr>
  14206. </thead>
  14207. <tbody>
  14208. <tr>
  14209. <td>
  14210. <code>authorizedKeySecretRef</code></br>
  14211. <em>
  14212. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14213. External Secrets meta/v1.SecretKeySelector
  14214. </a>
  14215. </em>
  14216. </td>
  14217. <td>
  14218. <em>(Optional)</em>
  14219. <p>The authorized key used for authentication</p>
  14220. </td>
  14221. </tr>
  14222. </tbody>
  14223. </table>
  14224. <h3 id="external-secrets.io/v1.YandexCAProvider">YandexCAProvider
  14225. </h3>
  14226. <p>
  14227. (<em>Appears on:</em>
  14228. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  14229. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  14230. </p>
  14231. <p>
  14232. <p>YandexCAProvider defines the configuration for Yandex custom certificate authority.</p>
  14233. </p>
  14234. <table>
  14235. <thead>
  14236. <tr>
  14237. <th>Field</th>
  14238. <th>Description</th>
  14239. </tr>
  14240. </thead>
  14241. <tbody>
  14242. <tr>
  14243. <td>
  14244. <code>certSecretRef</code></br>
  14245. <em>
  14246. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  14247. External Secrets meta/v1.SecretKeySelector
  14248. </a>
  14249. </em>
  14250. </td>
  14251. <td>
  14252. </td>
  14253. </tr>
  14254. </tbody>
  14255. </table>
  14256. <h3 id="external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  14257. </h3>
  14258. <p>
  14259. (<em>Appears on:</em>
  14260. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  14261. </p>
  14262. <p>
  14263. <p>YandexCertificateManagerProvider Configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  14264. </p>
  14265. <table>
  14266. <thead>
  14267. <tr>
  14268. <th>Field</th>
  14269. <th>Description</th>
  14270. </tr>
  14271. </thead>
  14272. <tbody>
  14273. <tr>
  14274. <td>
  14275. <code>apiEndpoint</code></br>
  14276. <em>
  14277. string
  14278. </em>
  14279. </td>
  14280. <td>
  14281. <em>(Optional)</em>
  14282. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  14283. </td>
  14284. </tr>
  14285. <tr>
  14286. <td>
  14287. <code>auth</code></br>
  14288. <em>
  14289. <a href="#external-secrets.io/v1.YandexAuth">
  14290. YandexAuth
  14291. </a>
  14292. </em>
  14293. </td>
  14294. <td>
  14295. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  14296. </td>
  14297. </tr>
  14298. <tr>
  14299. <td>
  14300. <code>caProvider</code></br>
  14301. <em>
  14302. <a href="#external-secrets.io/v1.YandexCAProvider">
  14303. YandexCAProvider
  14304. </a>
  14305. </em>
  14306. </td>
  14307. <td>
  14308. <em>(Optional)</em>
  14309. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  14310. </td>
  14311. </tr>
  14312. <tr>
  14313. <td>
  14314. <code>fetching</code></br>
  14315. <em>
  14316. <a href="#external-secrets.io/v1.FetchingPolicy">
  14317. FetchingPolicy
  14318. </a>
  14319. </em>
  14320. </td>
  14321. <td>
  14322. <em>(Optional)</em>
  14323. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as certificate ID or certificate name</p>
  14324. </td>
  14325. </tr>
  14326. </tbody>
  14327. </table>
  14328. <h3 id="external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider
  14329. </h3>
  14330. <p>
  14331. (<em>Appears on:</em>
  14332. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  14333. </p>
  14334. <p>
  14335. <p>YandexLockboxProvider Configures a store to sync secrets using the Yandex Lockbox provider.</p>
  14336. </p>
  14337. <table>
  14338. <thead>
  14339. <tr>
  14340. <th>Field</th>
  14341. <th>Description</th>
  14342. </tr>
  14343. </thead>
  14344. <tbody>
  14345. <tr>
  14346. <td>
  14347. <code>apiEndpoint</code></br>
  14348. <em>
  14349. string
  14350. </em>
  14351. </td>
  14352. <td>
  14353. <em>(Optional)</em>
  14354. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  14355. </td>
  14356. </tr>
  14357. <tr>
  14358. <td>
  14359. <code>auth</code></br>
  14360. <em>
  14361. <a href="#external-secrets.io/v1.YandexAuth">
  14362. YandexAuth
  14363. </a>
  14364. </em>
  14365. </td>
  14366. <td>
  14367. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  14368. </td>
  14369. </tr>
  14370. <tr>
  14371. <td>
  14372. <code>caProvider</code></br>
  14373. <em>
  14374. <a href="#external-secrets.io/v1.YandexCAProvider">
  14375. YandexCAProvider
  14376. </a>
  14377. </em>
  14378. </td>
  14379. <td>
  14380. <em>(Optional)</em>
  14381. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  14382. </td>
  14383. </tr>
  14384. <tr>
  14385. <td>
  14386. <code>fetching</code></br>
  14387. <em>
  14388. <a href="#external-secrets.io/v1.FetchingPolicy">
  14389. FetchingPolicy
  14390. </a>
  14391. </em>
  14392. </td>
  14393. <td>
  14394. <em>(Optional)</em>
  14395. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID or secret name</p>
  14396. </td>
  14397. </tr>
  14398. </tbody>
  14399. </table>
  14400. <hr/>
  14401. <h2 id="external-secrets.io/v1alpha1">external-secrets.io/v1alpha1</h2>
  14402. <p>
  14403. <p>Package v1alpha1 contains resources for external-secrets</p>
  14404. </p>
  14405. <p>Resource Types:</p>
  14406. <ul></ul>
  14407. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret
  14408. </h3>
  14409. <p>
  14410. <p>ClusterPushSecret is the Schema for the ClusterPushSecrets API that enables cluster-wide management of pushing Kubernetes secrets to external providers.</p>
  14411. </p>
  14412. <table>
  14413. <thead>
  14414. <tr>
  14415. <th>Field</th>
  14416. <th>Description</th>
  14417. </tr>
  14418. </thead>
  14419. <tbody>
  14420. <tr>
  14421. <td>
  14422. <code>metadata</code></br>
  14423. <em>
  14424. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  14425. Kubernetes meta/v1.ObjectMeta
  14426. </a>
  14427. </em>
  14428. </td>
  14429. <td>
  14430. Refer to the Kubernetes API documentation for the fields of the
  14431. <code>metadata</code> field.
  14432. </td>
  14433. </tr>
  14434. <tr>
  14435. <td>
  14436. <code>spec</code></br>
  14437. <em>
  14438. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">
  14439. ClusterPushSecretSpec
  14440. </a>
  14441. </em>
  14442. </td>
  14443. <td>
  14444. <br/>
  14445. <br/>
  14446. <table>
  14447. <tr>
  14448. <td>
  14449. <code>pushSecretSpec</code></br>
  14450. <em>
  14451. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  14452. PushSecretSpec
  14453. </a>
  14454. </em>
  14455. </td>
  14456. <td>
  14457. <p>PushSecretSpec defines what to do with the secrets.</p>
  14458. </td>
  14459. </tr>
  14460. <tr>
  14461. <td>
  14462. <code>refreshTime</code></br>
  14463. <em>
  14464. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14465. Kubernetes meta/v1.Duration
  14466. </a>
  14467. </em>
  14468. </td>
  14469. <td>
  14470. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  14471. </td>
  14472. </tr>
  14473. <tr>
  14474. <td>
  14475. <code>pushSecretName</code></br>
  14476. <em>
  14477. string
  14478. </em>
  14479. </td>
  14480. <td>
  14481. <em>(Optional)</em>
  14482. <p>The name of the push secrets to be created.
  14483. Defaults to the name of the ClusterPushSecret</p>
  14484. </td>
  14485. </tr>
  14486. <tr>
  14487. <td>
  14488. <code>pushSecretMetadata</code></br>
  14489. <em>
  14490. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  14491. PushSecretMetadata
  14492. </a>
  14493. </em>
  14494. </td>
  14495. <td>
  14496. <em>(Optional)</em>
  14497. <p>The metadata of the external secrets to be created</p>
  14498. </td>
  14499. </tr>
  14500. <tr>
  14501. <td>
  14502. <code>namespaceSelectors</code></br>
  14503. <em>
  14504. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  14505. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  14506. </a>
  14507. </em>
  14508. </td>
  14509. <td>
  14510. <em>(Optional)</em>
  14511. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  14512. </td>
  14513. </tr>
  14514. </table>
  14515. </td>
  14516. </tr>
  14517. <tr>
  14518. <td>
  14519. <code>status</code></br>
  14520. <em>
  14521. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">
  14522. ClusterPushSecretStatus
  14523. </a>
  14524. </em>
  14525. </td>
  14526. <td>
  14527. </td>
  14528. </tr>
  14529. </tbody>
  14530. </table>
  14531. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretCondition">ClusterPushSecretCondition
  14532. </h3>
  14533. <p>
  14534. <p>ClusterPushSecretCondition used to refine PushSecrets to specific namespaces and names.</p>
  14535. </p>
  14536. <table>
  14537. <thead>
  14538. <tr>
  14539. <th>Field</th>
  14540. <th>Description</th>
  14541. </tr>
  14542. </thead>
  14543. <tbody>
  14544. <tr>
  14545. <td>
  14546. <code>namespaceSelector</code></br>
  14547. <em>
  14548. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  14549. Kubernetes meta/v1.LabelSelector
  14550. </a>
  14551. </em>
  14552. </td>
  14553. <td>
  14554. <em>(Optional)</em>
  14555. <p>Choose namespace using a labelSelector</p>
  14556. </td>
  14557. </tr>
  14558. <tr>
  14559. <td>
  14560. <code>namespaces</code></br>
  14561. <em>
  14562. []string
  14563. </em>
  14564. </td>
  14565. <td>
  14566. <em>(Optional)</em>
  14567. <p>Choose namespaces by name</p>
  14568. </td>
  14569. </tr>
  14570. </tbody>
  14571. </table>
  14572. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">ClusterPushSecretNamespaceFailure
  14573. </h3>
  14574. <p>
  14575. (<em>Appears on:</em>
  14576. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>)
  14577. </p>
  14578. <p>
  14579. <p>ClusterPushSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  14580. </p>
  14581. <table>
  14582. <thead>
  14583. <tr>
  14584. <th>Field</th>
  14585. <th>Description</th>
  14586. </tr>
  14587. </thead>
  14588. <tbody>
  14589. <tr>
  14590. <td>
  14591. <code>namespace</code></br>
  14592. <em>
  14593. string
  14594. </em>
  14595. </td>
  14596. <td>
  14597. <p>Namespace is the namespace that failed when trying to apply an PushSecret</p>
  14598. </td>
  14599. </tr>
  14600. <tr>
  14601. <td>
  14602. <code>reason</code></br>
  14603. <em>
  14604. string
  14605. </em>
  14606. </td>
  14607. <td>
  14608. <em>(Optional)</em>
  14609. <p>Reason is why the PushSecret failed to apply to the namespace</p>
  14610. </td>
  14611. </tr>
  14612. </tbody>
  14613. </table>
  14614. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec
  14615. </h3>
  14616. <p>
  14617. (<em>Appears on:</em>
  14618. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  14619. </p>
  14620. <p>
  14621. <p>ClusterPushSecretSpec defines the configuration for a ClusterPushSecret resource.</p>
  14622. </p>
  14623. <table>
  14624. <thead>
  14625. <tr>
  14626. <th>Field</th>
  14627. <th>Description</th>
  14628. </tr>
  14629. </thead>
  14630. <tbody>
  14631. <tr>
  14632. <td>
  14633. <code>pushSecretSpec</code></br>
  14634. <em>
  14635. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  14636. PushSecretSpec
  14637. </a>
  14638. </em>
  14639. </td>
  14640. <td>
  14641. <p>PushSecretSpec defines what to do with the secrets.</p>
  14642. </td>
  14643. </tr>
  14644. <tr>
  14645. <td>
  14646. <code>refreshTime</code></br>
  14647. <em>
  14648. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14649. Kubernetes meta/v1.Duration
  14650. </a>
  14651. </em>
  14652. </td>
  14653. <td>
  14654. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  14655. </td>
  14656. </tr>
  14657. <tr>
  14658. <td>
  14659. <code>pushSecretName</code></br>
  14660. <em>
  14661. string
  14662. </em>
  14663. </td>
  14664. <td>
  14665. <em>(Optional)</em>
  14666. <p>The name of the push secrets to be created.
  14667. Defaults to the name of the ClusterPushSecret</p>
  14668. </td>
  14669. </tr>
  14670. <tr>
  14671. <td>
  14672. <code>pushSecretMetadata</code></br>
  14673. <em>
  14674. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  14675. PushSecretMetadata
  14676. </a>
  14677. </em>
  14678. </td>
  14679. <td>
  14680. <em>(Optional)</em>
  14681. <p>The metadata of the external secrets to be created</p>
  14682. </td>
  14683. </tr>
  14684. <tr>
  14685. <td>
  14686. <code>namespaceSelectors</code></br>
  14687. <em>
  14688. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  14689. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  14690. </a>
  14691. </em>
  14692. </td>
  14693. <td>
  14694. <em>(Optional)</em>
  14695. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  14696. </td>
  14697. </tr>
  14698. </tbody>
  14699. </table>
  14700. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus
  14701. </h3>
  14702. <p>
  14703. (<em>Appears on:</em>
  14704. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  14705. </p>
  14706. <p>
  14707. <p>ClusterPushSecretStatus contains the status information for the ClusterPushSecret resource.</p>
  14708. </p>
  14709. <table>
  14710. <thead>
  14711. <tr>
  14712. <th>Field</th>
  14713. <th>Description</th>
  14714. </tr>
  14715. </thead>
  14716. <tbody>
  14717. <tr>
  14718. <td>
  14719. <code>failedNamespaces</code></br>
  14720. <em>
  14721. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">
  14722. []ClusterPushSecretNamespaceFailure
  14723. </a>
  14724. </em>
  14725. </td>
  14726. <td>
  14727. <em>(Optional)</em>
  14728. <p>Failed namespaces are the namespaces that failed to apply an PushSecret</p>
  14729. </td>
  14730. </tr>
  14731. <tr>
  14732. <td>
  14733. <code>provisionedNamespaces</code></br>
  14734. <em>
  14735. []string
  14736. </em>
  14737. </td>
  14738. <td>
  14739. <em>(Optional)</em>
  14740. <p>ProvisionedNamespaces are the namespaces where the ClusterPushSecret has secrets</p>
  14741. </td>
  14742. </tr>
  14743. <tr>
  14744. <td>
  14745. <code>pushSecretName</code></br>
  14746. <em>
  14747. string
  14748. </em>
  14749. </td>
  14750. <td>
  14751. </td>
  14752. </tr>
  14753. <tr>
  14754. <td>
  14755. <code>conditions</code></br>
  14756. <em>
  14757. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  14758. []PushSecretStatusCondition
  14759. </a>
  14760. </em>
  14761. </td>
  14762. <td>
  14763. <em>(Optional)</em>
  14764. </td>
  14765. </tr>
  14766. </tbody>
  14767. </table>
  14768. <h3 id="external-secrets.io/v1alpha1.PushSecret">PushSecret
  14769. </h3>
  14770. <p>
  14771. <p>PushSecret is the Schema for the PushSecrets API that enables pushing Kubernetes secrets to external secret providers.</p>
  14772. </p>
  14773. <table>
  14774. <thead>
  14775. <tr>
  14776. <th>Field</th>
  14777. <th>Description</th>
  14778. </tr>
  14779. </thead>
  14780. <tbody>
  14781. <tr>
  14782. <td>
  14783. <code>metadata</code></br>
  14784. <em>
  14785. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  14786. Kubernetes meta/v1.ObjectMeta
  14787. </a>
  14788. </em>
  14789. </td>
  14790. <td>
  14791. Refer to the Kubernetes API documentation for the fields of the
  14792. <code>metadata</code> field.
  14793. </td>
  14794. </tr>
  14795. <tr>
  14796. <td>
  14797. <code>spec</code></br>
  14798. <em>
  14799. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  14800. PushSecretSpec
  14801. </a>
  14802. </em>
  14803. </td>
  14804. <td>
  14805. <br/>
  14806. <br/>
  14807. <table>
  14808. <tr>
  14809. <td>
  14810. <code>refreshInterval</code></br>
  14811. <em>
  14812. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14813. Kubernetes meta/v1.Duration
  14814. </a>
  14815. </em>
  14816. </td>
  14817. <td>
  14818. <p>The Interval to which External Secrets will try to push a secret definition</p>
  14819. </td>
  14820. </tr>
  14821. <tr>
  14822. <td>
  14823. <code>secretStoreRefs</code></br>
  14824. <em>
  14825. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  14826. []PushSecretStoreRef
  14827. </a>
  14828. </em>
  14829. </td>
  14830. <td>
  14831. </td>
  14832. </tr>
  14833. <tr>
  14834. <td>
  14835. <code>updatePolicy</code></br>
  14836. <em>
  14837. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  14838. PushSecretUpdatePolicy
  14839. </a>
  14840. </em>
  14841. </td>
  14842. <td>
  14843. <em>(Optional)</em>
  14844. <p>UpdatePolicy to handle Secrets in the provider.</p>
  14845. </td>
  14846. </tr>
  14847. <tr>
  14848. <td>
  14849. <code>deletionPolicy</code></br>
  14850. <em>
  14851. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  14852. PushSecretDeletionPolicy
  14853. </a>
  14854. </em>
  14855. </td>
  14856. <td>
  14857. <em>(Optional)</em>
  14858. <p>Deletion Policy to handle Secrets in the provider.</p>
  14859. </td>
  14860. </tr>
  14861. <tr>
  14862. <td>
  14863. <code>selector</code></br>
  14864. <em>
  14865. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  14866. PushSecretSelector
  14867. </a>
  14868. </em>
  14869. </td>
  14870. <td>
  14871. <p>The Secret Selector (k8s source) for the Push Secret</p>
  14872. </td>
  14873. </tr>
  14874. <tr>
  14875. <td>
  14876. <code>data</code></br>
  14877. <em>
  14878. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  14879. []PushSecretData
  14880. </a>
  14881. </em>
  14882. </td>
  14883. <td>
  14884. <em>(Optional)</em>
  14885. <p>Secret Data that should be pushed to providers</p>
  14886. </td>
  14887. </tr>
  14888. <tr>
  14889. <td>
  14890. <code>dataTo</code></br>
  14891. <em>
  14892. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  14893. []PushSecretDataTo
  14894. </a>
  14895. </em>
  14896. </td>
  14897. <td>
  14898. <em>(Optional)</em>
  14899. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  14900. </td>
  14901. </tr>
  14902. <tr>
  14903. <td>
  14904. <code>template</code></br>
  14905. <em>
  14906. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  14907. ExternalSecretTemplate
  14908. </a>
  14909. </em>
  14910. </td>
  14911. <td>
  14912. <em>(Optional)</em>
  14913. <p>Template defines a blueprint for the created Secret resource.</p>
  14914. </td>
  14915. </tr>
  14916. </table>
  14917. </td>
  14918. </tr>
  14919. <tr>
  14920. <td>
  14921. <code>status</code></br>
  14922. <em>
  14923. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">
  14924. PushSecretStatus
  14925. </a>
  14926. </em>
  14927. </td>
  14928. <td>
  14929. </td>
  14930. </tr>
  14931. </tbody>
  14932. </table>
  14933. <h3 id="external-secrets.io/v1alpha1.PushSecretConditionType">PushSecretConditionType
  14934. (<code>string</code> alias)</p></h3>
  14935. <p>
  14936. (<em>Appears on:</em>
  14937. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition</a>)
  14938. </p>
  14939. <p>
  14940. <p>PushSecretConditionType indicates the condition of the PushSecret.</p>
  14941. </p>
  14942. <table>
  14943. <thead>
  14944. <tr>
  14945. <th>Value</th>
  14946. <th>Description</th>
  14947. </tr>
  14948. </thead>
  14949. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  14950. <td><p>PushSecretReady indicates the PushSecret resource is ready.</p>
  14951. </td>
  14952. </tr></tbody>
  14953. </table>
  14954. <h3 id="external-secrets.io/v1alpha1.PushSecretConversionStrategy">PushSecretConversionStrategy
  14955. (<code>string</code> alias)</p></h3>
  14956. <p>
  14957. (<em>Appears on:</em>
  14958. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>,
  14959. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  14960. </p>
  14961. <p>
  14962. <p>PushSecretConversionStrategy defines how secret values are converted when pushed to providers.</p>
  14963. </p>
  14964. <table>
  14965. <thead>
  14966. <tr>
  14967. <th>Value</th>
  14968. <th>Description</th>
  14969. </tr>
  14970. </thead>
  14971. <tbody><tr><td><p>&#34;None&#34;</p></td>
  14972. <td><p>PushSecretConversionNone indicates no conversion will be performed on the secret value.</p>
  14973. </td>
  14974. </tr><tr><td><p>&#34;ReverseUnicode&#34;</p></td>
  14975. <td><p>PushSecretConversionReverseUnicode indicates that unicode escape sequences will be reversed.</p>
  14976. </td>
  14977. </tr></tbody>
  14978. </table>
  14979. <h3 id="external-secrets.io/v1alpha1.PushSecretData">PushSecretData
  14980. </h3>
  14981. <p>
  14982. (<em>Appears on:</em>
  14983. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  14984. </p>
  14985. <p>
  14986. <p>PushSecretData defines data to be pushed to the provider and associated metadata.</p>
  14987. </p>
  14988. <table>
  14989. <thead>
  14990. <tr>
  14991. <th>Field</th>
  14992. <th>Description</th>
  14993. </tr>
  14994. </thead>
  14995. <tbody>
  14996. <tr>
  14997. <td>
  14998. <code>match</code></br>
  14999. <em>
  15000. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">
  15001. PushSecretMatch
  15002. </a>
  15003. </em>
  15004. </td>
  15005. <td>
  15006. <p>Match a given Secret Key to be pushed to the provider.</p>
  15007. </td>
  15008. </tr>
  15009. <tr>
  15010. <td>
  15011. <code>metadata</code></br>
  15012. <em>
  15013. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  15014. </em>
  15015. </td>
  15016. <td>
  15017. <em>(Optional)</em>
  15018. <p>Metadata is metadata attached to the secret.
  15019. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  15020. </td>
  15021. </tr>
  15022. <tr>
  15023. <td>
  15024. <code>conversionStrategy</code></br>
  15025. <em>
  15026. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  15027. PushSecretConversionStrategy
  15028. </a>
  15029. </em>
  15030. </td>
  15031. <td>
  15032. <em>(Optional)</em>
  15033. <p>Used to define a conversion Strategy for the secret keys</p>
  15034. </td>
  15035. </tr>
  15036. </tbody>
  15037. </table>
  15038. <h3 id="external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo
  15039. </h3>
  15040. <p>
  15041. (<em>Appears on:</em>
  15042. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15043. </p>
  15044. <p>
  15045. <p>PushSecretDataTo defines how to bulk-push secrets to providers without explicit per-key mappings.</p>
  15046. </p>
  15047. <table>
  15048. <thead>
  15049. <tr>
  15050. <th>Field</th>
  15051. <th>Description</th>
  15052. </tr>
  15053. </thead>
  15054. <tbody>
  15055. <tr>
  15056. <td>
  15057. <code>storeRef</code></br>
  15058. <em>
  15059. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  15060. PushSecretStoreRef
  15061. </a>
  15062. </em>
  15063. </td>
  15064. <td>
  15065. <p>StoreRef specifies which SecretStore to push to. Required.</p>
  15066. </td>
  15067. </tr>
  15068. <tr>
  15069. <td>
  15070. <code>remoteKey</code></br>
  15071. <em>
  15072. string
  15073. </em>
  15074. </td>
  15075. <td>
  15076. <em>(Optional)</em>
  15077. <p>RemoteKey is the name of the single provider secret that will receive ALL
  15078. matched keys bundled as a JSON object (e.g. {&ldquo;DB_HOST&rdquo;:&ldquo;&hellip;&rdquo;,&ldquo;DB_USER&rdquo;:&ldquo;&hellip;&rdquo;}).
  15079. When set, per-key expansion is skipped and a single push is performed.
  15080. The provider&rsquo;s store prefix (if any) is still prepended to this value.
  15081. When not set, each matched key is pushed as its own individual provider secret.</p>
  15082. </td>
  15083. </tr>
  15084. <tr>
  15085. <td>
  15086. <code>match</code></br>
  15087. <em>
  15088. <a href="#external-secrets.io/v1alpha1.PushSecretDataToMatch">
  15089. PushSecretDataToMatch
  15090. </a>
  15091. </em>
  15092. </td>
  15093. <td>
  15094. <em>(Optional)</em>
  15095. <p>Match pattern for selecting keys from the source Secret.
  15096. If not specified, all keys are selected.</p>
  15097. </td>
  15098. </tr>
  15099. <tr>
  15100. <td>
  15101. <code>rewrite</code></br>
  15102. <em>
  15103. <a href="#external-secrets.io/v1alpha1.PushSecretRewrite">
  15104. []PushSecretRewrite
  15105. </a>
  15106. </em>
  15107. </td>
  15108. <td>
  15109. <em>(Optional)</em>
  15110. <p>Rewrite operations to transform keys before pushing to the provider.
  15111. Operations are applied sequentially.</p>
  15112. </td>
  15113. </tr>
  15114. <tr>
  15115. <td>
  15116. <code>metadata</code></br>
  15117. <em>
  15118. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  15119. </em>
  15120. </td>
  15121. <td>
  15122. <em>(Optional)</em>
  15123. <p>Metadata is metadata attached to the secret.
  15124. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  15125. </td>
  15126. </tr>
  15127. <tr>
  15128. <td>
  15129. <code>conversionStrategy</code></br>
  15130. <em>
  15131. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  15132. PushSecretConversionStrategy
  15133. </a>
  15134. </em>
  15135. </td>
  15136. <td>
  15137. <em>(Optional)</em>
  15138. <p>Used to define a conversion Strategy for the secret keys</p>
  15139. </td>
  15140. </tr>
  15141. </tbody>
  15142. </table>
  15143. <h3 id="external-secrets.io/v1alpha1.PushSecretDataToMatch">PushSecretDataToMatch
  15144. </h3>
  15145. <p>
  15146. (<em>Appears on:</em>
  15147. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  15148. </p>
  15149. <p>
  15150. <p>PushSecretDataToMatch defines pattern matching for key selection.</p>
  15151. </p>
  15152. <table>
  15153. <thead>
  15154. <tr>
  15155. <th>Field</th>
  15156. <th>Description</th>
  15157. </tr>
  15158. </thead>
  15159. <tbody>
  15160. <tr>
  15161. <td>
  15162. <code>regexp</code></br>
  15163. <em>
  15164. string
  15165. </em>
  15166. </td>
  15167. <td>
  15168. <em>(Optional)</em>
  15169. <p>Regexp matches keys by regular expression.
  15170. If not specified, all keys are matched.</p>
  15171. </td>
  15172. </tr>
  15173. </tbody>
  15174. </table>
  15175. <h3 id="external-secrets.io/v1alpha1.PushSecretDeletionPolicy">PushSecretDeletionPolicy
  15176. (<code>string</code> alias)</p></h3>
  15177. <p>
  15178. (<em>Appears on:</em>
  15179. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15180. </p>
  15181. <p>
  15182. <p>PushSecretDeletionPolicy defines how push secrets are deleted in the provider.</p>
  15183. </p>
  15184. <table>
  15185. <thead>
  15186. <tr>
  15187. <th>Value</th>
  15188. <th>Description</th>
  15189. </tr>
  15190. </thead>
  15191. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  15192. <td><p>PushSecretDeletionPolicyDelete deletes secrets from the provider when the PushSecret is deleted.</p>
  15193. </td>
  15194. </tr><tr><td><p>&#34;None&#34;</p></td>
  15195. <td><p>PushSecretDeletionPolicyNone keeps secrets in the provider when the PushSecret is deleted.</p>
  15196. </td>
  15197. </tr></tbody>
  15198. </table>
  15199. <h3 id="external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch
  15200. </h3>
  15201. <p>
  15202. (<em>Appears on:</em>
  15203. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>)
  15204. </p>
  15205. <p>
  15206. <p>PushSecretMatch defines how a source Secret key maps to a destination in the provider.</p>
  15207. </p>
  15208. <table>
  15209. <thead>
  15210. <tr>
  15211. <th>Field</th>
  15212. <th>Description</th>
  15213. </tr>
  15214. </thead>
  15215. <tbody>
  15216. <tr>
  15217. <td>
  15218. <code>secretKey</code></br>
  15219. <em>
  15220. string
  15221. </em>
  15222. </td>
  15223. <td>
  15224. <em>(Optional)</em>
  15225. <p>Secret Key to be pushed</p>
  15226. </td>
  15227. </tr>
  15228. <tr>
  15229. <td>
  15230. <code>remoteRef</code></br>
  15231. <em>
  15232. <a href="#external-secrets.io/v1alpha1.PushSecretRemoteRef">
  15233. PushSecretRemoteRef
  15234. </a>
  15235. </em>
  15236. </td>
  15237. <td>
  15238. <p>Remote Refs to push to providers.</p>
  15239. </td>
  15240. </tr>
  15241. </tbody>
  15242. </table>
  15243. <h3 id="external-secrets.io/v1alpha1.PushSecretMetadata">PushSecretMetadata
  15244. </h3>
  15245. <p>
  15246. (<em>Appears on:</em>
  15247. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>)
  15248. </p>
  15249. <p>
  15250. <p>PushSecretMetadata defines metadata fields for the PushSecret generated by the ClusterPushSecret.</p>
  15251. </p>
  15252. <table>
  15253. <thead>
  15254. <tr>
  15255. <th>Field</th>
  15256. <th>Description</th>
  15257. </tr>
  15258. </thead>
  15259. <tbody>
  15260. <tr>
  15261. <td>
  15262. <code>annotations</code></br>
  15263. <em>
  15264. map[string]string
  15265. </em>
  15266. </td>
  15267. <td>
  15268. <em>(Optional)</em>
  15269. </td>
  15270. </tr>
  15271. <tr>
  15272. <td>
  15273. <code>labels</code></br>
  15274. <em>
  15275. map[string]string
  15276. </em>
  15277. </td>
  15278. <td>
  15279. <em>(Optional)</em>
  15280. </td>
  15281. </tr>
  15282. </tbody>
  15283. </table>
  15284. <h3 id="external-secrets.io/v1alpha1.PushSecretRemoteRef">PushSecretRemoteRef
  15285. </h3>
  15286. <p>
  15287. (<em>Appears on:</em>
  15288. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch</a>)
  15289. </p>
  15290. <p>
  15291. <p>PushSecretRemoteRef defines the location of the secret in the provider.</p>
  15292. </p>
  15293. <table>
  15294. <thead>
  15295. <tr>
  15296. <th>Field</th>
  15297. <th>Description</th>
  15298. </tr>
  15299. </thead>
  15300. <tbody>
  15301. <tr>
  15302. <td>
  15303. <code>remoteKey</code></br>
  15304. <em>
  15305. string
  15306. </em>
  15307. </td>
  15308. <td>
  15309. <p>Name of the resulting provider secret.</p>
  15310. </td>
  15311. </tr>
  15312. <tr>
  15313. <td>
  15314. <code>property</code></br>
  15315. <em>
  15316. string
  15317. </em>
  15318. </td>
  15319. <td>
  15320. <em>(Optional)</em>
  15321. <p>Name of the property in the resulting secret</p>
  15322. </td>
  15323. </tr>
  15324. </tbody>
  15325. </table>
  15326. <h3 id="external-secrets.io/v1alpha1.PushSecretRewrite">PushSecretRewrite
  15327. </h3>
  15328. <p>
  15329. (<em>Appears on:</em>
  15330. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>)
  15331. </p>
  15332. <p>
  15333. <p>PushSecretRewrite defines how to transform secret keys before pushing.</p>
  15334. </p>
  15335. <table>
  15336. <thead>
  15337. <tr>
  15338. <th>Field</th>
  15339. <th>Description</th>
  15340. </tr>
  15341. </thead>
  15342. <tbody>
  15343. <tr>
  15344. <td>
  15345. <code>regexp</code></br>
  15346. <em>
  15347. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  15348. ExternalSecretRewriteRegexp
  15349. </a>
  15350. </em>
  15351. </td>
  15352. <td>
  15353. <em>(Optional)</em>
  15354. <p>Used to rewrite with regular expressions.</p>
  15355. </td>
  15356. </tr>
  15357. <tr>
  15358. <td>
  15359. <code>transform</code></br>
  15360. <em>
  15361. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  15362. ExternalSecretRewriteTransform
  15363. </a>
  15364. </em>
  15365. </td>
  15366. <td>
  15367. <em>(Optional)</em>
  15368. <p>Used to apply string transformation on the secrets.</p>
  15369. </td>
  15370. </tr>
  15371. </tbody>
  15372. </table>
  15373. <h3 id="external-secrets.io/v1alpha1.PushSecretSecret">PushSecretSecret
  15374. </h3>
  15375. <p>
  15376. (<em>Appears on:</em>
  15377. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  15378. </p>
  15379. <p>
  15380. <p>PushSecretSecret defines a Secret that will be used as a source for pushing to providers.</p>
  15381. </p>
  15382. <table>
  15383. <thead>
  15384. <tr>
  15385. <th>Field</th>
  15386. <th>Description</th>
  15387. </tr>
  15388. </thead>
  15389. <tbody>
  15390. <tr>
  15391. <td>
  15392. <code>name</code></br>
  15393. <em>
  15394. string
  15395. </em>
  15396. </td>
  15397. <td>
  15398. <em>(Optional)</em>
  15399. <p>Name of the Secret.
  15400. The Secret must exist in the same namespace as the PushSecret manifest.</p>
  15401. </td>
  15402. </tr>
  15403. <tr>
  15404. <td>
  15405. <code>selector</code></br>
  15406. <em>
  15407. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  15408. Kubernetes meta/v1.LabelSelector
  15409. </a>
  15410. </em>
  15411. </td>
  15412. <td>
  15413. <em>(Optional)</em>
  15414. <p>Selector chooses secrets using a labelSelector.</p>
  15415. </td>
  15416. </tr>
  15417. </tbody>
  15418. </table>
  15419. <h3 id="external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector
  15420. </h3>
  15421. <p>
  15422. (<em>Appears on:</em>
  15423. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15424. </p>
  15425. <p>
  15426. <p>PushSecretSelector defines criteria for selecting the source Secret for pushing to providers.</p>
  15427. </p>
  15428. <table>
  15429. <thead>
  15430. <tr>
  15431. <th>Field</th>
  15432. <th>Description</th>
  15433. </tr>
  15434. </thead>
  15435. <tbody>
  15436. <tr>
  15437. <td>
  15438. <code>secret</code></br>
  15439. <em>
  15440. <a href="#external-secrets.io/v1alpha1.PushSecretSecret">
  15441. PushSecretSecret
  15442. </a>
  15443. </em>
  15444. </td>
  15445. <td>
  15446. <em>(Optional)</em>
  15447. <p>Select a Secret to Push.</p>
  15448. </td>
  15449. </tr>
  15450. <tr>
  15451. <td>
  15452. <code>generatorRef</code></br>
  15453. <em>
  15454. <a href="#external-secrets.io/v1.GeneratorRef">
  15455. GeneratorRef
  15456. </a>
  15457. </em>
  15458. </td>
  15459. <td>
  15460. <em>(Optional)</em>
  15461. <p>Point to a generator to create a Secret.</p>
  15462. </td>
  15463. </tr>
  15464. </tbody>
  15465. </table>
  15466. <h3 id="external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec
  15467. </h3>
  15468. <p>
  15469. (<em>Appears on:</em>
  15470. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>,
  15471. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  15472. </p>
  15473. <p>
  15474. <p>PushSecretSpec configures the behavior of the PushSecret.</p>
  15475. </p>
  15476. <table>
  15477. <thead>
  15478. <tr>
  15479. <th>Field</th>
  15480. <th>Description</th>
  15481. </tr>
  15482. </thead>
  15483. <tbody>
  15484. <tr>
  15485. <td>
  15486. <code>refreshInterval</code></br>
  15487. <em>
  15488. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  15489. Kubernetes meta/v1.Duration
  15490. </a>
  15491. </em>
  15492. </td>
  15493. <td>
  15494. <p>The Interval to which External Secrets will try to push a secret definition</p>
  15495. </td>
  15496. </tr>
  15497. <tr>
  15498. <td>
  15499. <code>secretStoreRefs</code></br>
  15500. <em>
  15501. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  15502. []PushSecretStoreRef
  15503. </a>
  15504. </em>
  15505. </td>
  15506. <td>
  15507. </td>
  15508. </tr>
  15509. <tr>
  15510. <td>
  15511. <code>updatePolicy</code></br>
  15512. <em>
  15513. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  15514. PushSecretUpdatePolicy
  15515. </a>
  15516. </em>
  15517. </td>
  15518. <td>
  15519. <em>(Optional)</em>
  15520. <p>UpdatePolicy to handle Secrets in the provider.</p>
  15521. </td>
  15522. </tr>
  15523. <tr>
  15524. <td>
  15525. <code>deletionPolicy</code></br>
  15526. <em>
  15527. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  15528. PushSecretDeletionPolicy
  15529. </a>
  15530. </em>
  15531. </td>
  15532. <td>
  15533. <em>(Optional)</em>
  15534. <p>Deletion Policy to handle Secrets in the provider.</p>
  15535. </td>
  15536. </tr>
  15537. <tr>
  15538. <td>
  15539. <code>selector</code></br>
  15540. <em>
  15541. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  15542. PushSecretSelector
  15543. </a>
  15544. </em>
  15545. </td>
  15546. <td>
  15547. <p>The Secret Selector (k8s source) for the Push Secret</p>
  15548. </td>
  15549. </tr>
  15550. <tr>
  15551. <td>
  15552. <code>data</code></br>
  15553. <em>
  15554. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  15555. []PushSecretData
  15556. </a>
  15557. </em>
  15558. </td>
  15559. <td>
  15560. <em>(Optional)</em>
  15561. <p>Secret Data that should be pushed to providers</p>
  15562. </td>
  15563. </tr>
  15564. <tr>
  15565. <td>
  15566. <code>dataTo</code></br>
  15567. <em>
  15568. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">
  15569. []PushSecretDataTo
  15570. </a>
  15571. </em>
  15572. </td>
  15573. <td>
  15574. <em>(Optional)</em>
  15575. <p>DataTo defines bulk push rules that expand source Secret keys into provider entries.</p>
  15576. </td>
  15577. </tr>
  15578. <tr>
  15579. <td>
  15580. <code>template</code></br>
  15581. <em>
  15582. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  15583. ExternalSecretTemplate
  15584. </a>
  15585. </em>
  15586. </td>
  15587. <td>
  15588. <em>(Optional)</em>
  15589. <p>Template defines a blueprint for the created Secret resource.</p>
  15590. </td>
  15591. </tr>
  15592. </tbody>
  15593. </table>
  15594. <h3 id="external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus
  15595. </h3>
  15596. <p>
  15597. (<em>Appears on:</em>
  15598. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  15599. </p>
  15600. <p>
  15601. <p>PushSecretStatus indicates the history of the status of PushSecret.</p>
  15602. </p>
  15603. <table>
  15604. <thead>
  15605. <tr>
  15606. <th>Field</th>
  15607. <th>Description</th>
  15608. </tr>
  15609. </thead>
  15610. <tbody>
  15611. <tr>
  15612. <td>
  15613. <code>refreshTime</code></br>
  15614. <em>
  15615. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  15616. Kubernetes meta/v1.Time
  15617. </a>
  15618. </em>
  15619. </td>
  15620. <td>
  15621. <p>refreshTime is the time and date the external secret was fetched and
  15622. the target secret updated</p>
  15623. </td>
  15624. </tr>
  15625. <tr>
  15626. <td>
  15627. <code>syncedResourceVersion</code></br>
  15628. <em>
  15629. string
  15630. </em>
  15631. </td>
  15632. <td>
  15633. <p>SyncedResourceVersion keeps track of the last synced version.</p>
  15634. </td>
  15635. </tr>
  15636. <tr>
  15637. <td>
  15638. <code>syncedPushSecrets</code></br>
  15639. <em>
  15640. <a href="#external-secrets.io/v1alpha1.SyncedPushSecretsMap">
  15641. SyncedPushSecretsMap
  15642. </a>
  15643. </em>
  15644. </td>
  15645. <td>
  15646. <em>(Optional)</em>
  15647. <p>Synced PushSecrets, including secrets that already exist in provider.
  15648. Matches secret stores to PushSecretData that was stored to that secret store.</p>
  15649. </td>
  15650. </tr>
  15651. <tr>
  15652. <td>
  15653. <code>conditions</code></br>
  15654. <em>
  15655. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  15656. []PushSecretStatusCondition
  15657. </a>
  15658. </em>
  15659. </td>
  15660. <td>
  15661. <em>(Optional)</em>
  15662. </td>
  15663. </tr>
  15664. </tbody>
  15665. </table>
  15666. <h3 id="external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition
  15667. </h3>
  15668. <p>
  15669. (<em>Appears on:</em>
  15670. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>,
  15671. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  15672. </p>
  15673. <p>
  15674. <p>PushSecretStatusCondition indicates the status of the PushSecret.</p>
  15675. </p>
  15676. <table>
  15677. <thead>
  15678. <tr>
  15679. <th>Field</th>
  15680. <th>Description</th>
  15681. </tr>
  15682. </thead>
  15683. <tbody>
  15684. <tr>
  15685. <td>
  15686. <code>type</code></br>
  15687. <em>
  15688. <a href="#external-secrets.io/v1alpha1.PushSecretConditionType">
  15689. PushSecretConditionType
  15690. </a>
  15691. </em>
  15692. </td>
  15693. <td>
  15694. </td>
  15695. </tr>
  15696. <tr>
  15697. <td>
  15698. <code>status</code></br>
  15699. <em>
  15700. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  15701. Kubernetes core/v1.ConditionStatus
  15702. </a>
  15703. </em>
  15704. </td>
  15705. <td>
  15706. </td>
  15707. </tr>
  15708. <tr>
  15709. <td>
  15710. <code>reason</code></br>
  15711. <em>
  15712. string
  15713. </em>
  15714. </td>
  15715. <td>
  15716. <em>(Optional)</em>
  15717. </td>
  15718. </tr>
  15719. <tr>
  15720. <td>
  15721. <code>message</code></br>
  15722. <em>
  15723. string
  15724. </em>
  15725. </td>
  15726. <td>
  15727. <em>(Optional)</em>
  15728. </td>
  15729. </tr>
  15730. <tr>
  15731. <td>
  15732. <code>lastTransitionTime</code></br>
  15733. <em>
  15734. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  15735. Kubernetes meta/v1.Time
  15736. </a>
  15737. </em>
  15738. </td>
  15739. <td>
  15740. <em>(Optional)</em>
  15741. </td>
  15742. </tr>
  15743. </tbody>
  15744. </table>
  15745. <h3 id="external-secrets.io/v1alpha1.PushSecretStoreRef">PushSecretStoreRef
  15746. </h3>
  15747. <p>
  15748. (<em>Appears on:</em>
  15749. <a href="#external-secrets.io/v1alpha1.PushSecretDataTo">PushSecretDataTo</a>,
  15750. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15751. </p>
  15752. <p>
  15753. <p>PushSecretStoreRef contains a reference on how to sync to a SecretStore.</p>
  15754. </p>
  15755. <table>
  15756. <thead>
  15757. <tr>
  15758. <th>Field</th>
  15759. <th>Description</th>
  15760. </tr>
  15761. </thead>
  15762. <tbody>
  15763. <tr>
  15764. <td>
  15765. <code>name</code></br>
  15766. <em>
  15767. string
  15768. </em>
  15769. </td>
  15770. <td>
  15771. <em>(Optional)</em>
  15772. <p>Optionally, sync to the SecretStore of the given name</p>
  15773. </td>
  15774. </tr>
  15775. <tr>
  15776. <td>
  15777. <code>labelSelector</code></br>
  15778. <em>
  15779. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  15780. Kubernetes meta/v1.LabelSelector
  15781. </a>
  15782. </em>
  15783. </td>
  15784. <td>
  15785. <em>(Optional)</em>
  15786. <p>Optionally, sync to secret stores with label selector</p>
  15787. </td>
  15788. </tr>
  15789. <tr>
  15790. <td>
  15791. <code>kind</code></br>
  15792. <em>
  15793. string
  15794. </em>
  15795. </td>
  15796. <td>
  15797. <em>(Optional)</em>
  15798. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)</p>
  15799. </td>
  15800. </tr>
  15801. </tbody>
  15802. </table>
  15803. <h3 id="external-secrets.io/v1alpha1.PushSecretUpdatePolicy">PushSecretUpdatePolicy
  15804. (<code>string</code> alias)</p></h3>
  15805. <p>
  15806. (<em>Appears on:</em>
  15807. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15808. </p>
  15809. <p>
  15810. <p>PushSecretUpdatePolicy defines how push secrets are updated in the provider.</p>
  15811. </p>
  15812. <table>
  15813. <thead>
  15814. <tr>
  15815. <th>Value</th>
  15816. <th>Description</th>
  15817. </tr>
  15818. </thead>
  15819. <tbody><tr><td><p>&#34;IfNotExists&#34;</p></td>
  15820. <td><p>PushSecretUpdatePolicyIfNotExists only creates secrets that don&rsquo;t exist in the provider.</p>
  15821. </td>
  15822. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  15823. <td><p>PushSecretUpdatePolicyReplace replaces existing secrets in the provider.</p>
  15824. </td>
  15825. </tr></tbody>
  15826. </table>
  15827. <h3 id="external-secrets.io/v1alpha1.SyncedPushSecretsMap">SyncedPushSecretsMap
  15828. (<code>map[string]map[string]github.com/external-secrets/external-secrets/apis/externalsecrets/v1alpha1.PushSecretData</code> alias)</p></h3>
  15829. <p>
  15830. (<em>Appears on:</em>
  15831. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  15832. </p>
  15833. <p>
  15834. <p>SyncedPushSecretsMap is a map that tracks which PushSecretData was stored to which secret store.
  15835. The outer map&rsquo;s key is the secret store name, and the inner map&rsquo;s key is the remote key name.</p>
  15836. </p>
  15837. <hr/>
  15838. <h2 id="external-secrets.io/v1beta1">external-secrets.io/v1beta1</h2>
  15839. <p>
  15840. <p>Package v1beta1 contains resources for external-secrets</p>
  15841. </p>
  15842. <p>Resource Types:</p>
  15843. <ul></ul>
  15844. <h3 id="external-secrets.io/v1beta1.AWSAuth">AWSAuth
  15845. </h3>
  15846. <p>
  15847. (<em>Appears on:</em>
  15848. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  15849. </p>
  15850. <p>
  15851. <p>AWSAuth tells the controller how to do authentication with aws.
  15852. Only one of secretRef or jwt can be specified.
  15853. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  15854. </p>
  15855. <table>
  15856. <thead>
  15857. <tr>
  15858. <th>Field</th>
  15859. <th>Description</th>
  15860. </tr>
  15861. </thead>
  15862. <tbody>
  15863. <tr>
  15864. <td>
  15865. <code>secretRef</code></br>
  15866. <em>
  15867. <a href="#external-secrets.io/v1beta1.AWSAuthSecretRef">
  15868. AWSAuthSecretRef
  15869. </a>
  15870. </em>
  15871. </td>
  15872. <td>
  15873. <em>(Optional)</em>
  15874. </td>
  15875. </tr>
  15876. <tr>
  15877. <td>
  15878. <code>jwt</code></br>
  15879. <em>
  15880. <a href="#external-secrets.io/v1beta1.AWSJWTAuth">
  15881. AWSJWTAuth
  15882. </a>
  15883. </em>
  15884. </td>
  15885. <td>
  15886. <em>(Optional)</em>
  15887. </td>
  15888. </tr>
  15889. </tbody>
  15890. </table>
  15891. <h3 id="external-secrets.io/v1beta1.AWSAuthSecretRef">AWSAuthSecretRef
  15892. </h3>
  15893. <p>
  15894. (<em>Appears on:</em>
  15895. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  15896. </p>
  15897. <p>
  15898. <p>AWSAuthSecretRef holds secret references for AWS credentials
  15899. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</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>accessKeyIDSecretRef</code></br>
  15912. <em>
  15913. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15914. External Secrets meta/v1.SecretKeySelector
  15915. </a>
  15916. </em>
  15917. </td>
  15918. <td>
  15919. <p>The AccessKeyID is used for authentication</p>
  15920. </td>
  15921. </tr>
  15922. <tr>
  15923. <td>
  15924. <code>secretAccessKeySecretRef</code></br>
  15925. <em>
  15926. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15927. External Secrets meta/v1.SecretKeySelector
  15928. </a>
  15929. </em>
  15930. </td>
  15931. <td>
  15932. <p>The SecretAccessKey is used for authentication</p>
  15933. </td>
  15934. </tr>
  15935. <tr>
  15936. <td>
  15937. <code>sessionTokenSecretRef</code></br>
  15938. <em>
  15939. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15940. External Secrets meta/v1.SecretKeySelector
  15941. </a>
  15942. </em>
  15943. </td>
  15944. <td>
  15945. <p>The SessionToken used for authentication
  15946. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  15947. 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>
  15948. </td>
  15949. </tr>
  15950. </tbody>
  15951. </table>
  15952. <h3 id="external-secrets.io/v1beta1.AWSJWTAuth">AWSJWTAuth
  15953. </h3>
  15954. <p>
  15955. (<em>Appears on:</em>
  15956. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  15957. </p>
  15958. <p>
  15959. <p>AWSJWTAuth authenticates against AWS using service account tokens from the Kubernetes cluster.</p>
  15960. </p>
  15961. <table>
  15962. <thead>
  15963. <tr>
  15964. <th>Field</th>
  15965. <th>Description</th>
  15966. </tr>
  15967. </thead>
  15968. <tbody>
  15969. <tr>
  15970. <td>
  15971. <code>serviceAccountRef</code></br>
  15972. <em>
  15973. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  15974. External Secrets meta/v1.ServiceAccountSelector
  15975. </a>
  15976. </em>
  15977. </td>
  15978. <td>
  15979. </td>
  15980. </tr>
  15981. </tbody>
  15982. </table>
  15983. <h3 id="external-secrets.io/v1beta1.AWSProvider">AWSProvider
  15984. </h3>
  15985. <p>
  15986. (<em>Appears on:</em>
  15987. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  15988. </p>
  15989. <p>
  15990. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  15991. </p>
  15992. <table>
  15993. <thead>
  15994. <tr>
  15995. <th>Field</th>
  15996. <th>Description</th>
  15997. </tr>
  15998. </thead>
  15999. <tbody>
  16000. <tr>
  16001. <td>
  16002. <code>service</code></br>
  16003. <em>
  16004. <a href="#external-secrets.io/v1beta1.AWSServiceType">
  16005. AWSServiceType
  16006. </a>
  16007. </em>
  16008. </td>
  16009. <td>
  16010. <p>Service defines which service should be used to fetch the secrets</p>
  16011. </td>
  16012. </tr>
  16013. <tr>
  16014. <td>
  16015. <code>auth</code></br>
  16016. <em>
  16017. <a href="#external-secrets.io/v1beta1.AWSAuth">
  16018. AWSAuth
  16019. </a>
  16020. </em>
  16021. </td>
  16022. <td>
  16023. <em>(Optional)</em>
  16024. <p>Auth defines the information necessary to authenticate against AWS
  16025. if not set aws sdk will infer credentials from your environment
  16026. 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>
  16027. </td>
  16028. </tr>
  16029. <tr>
  16030. <td>
  16031. <code>role</code></br>
  16032. <em>
  16033. string
  16034. </em>
  16035. </td>
  16036. <td>
  16037. <em>(Optional)</em>
  16038. <p>Role is a Role ARN which the provider will assume</p>
  16039. </td>
  16040. </tr>
  16041. <tr>
  16042. <td>
  16043. <code>region</code></br>
  16044. <em>
  16045. string
  16046. </em>
  16047. </td>
  16048. <td>
  16049. <p>AWS Region to be used for the provider</p>
  16050. </td>
  16051. </tr>
  16052. <tr>
  16053. <td>
  16054. <code>additionalRoles</code></br>
  16055. <em>
  16056. []string
  16057. </em>
  16058. </td>
  16059. <td>
  16060. <em>(Optional)</em>
  16061. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  16062. </td>
  16063. </tr>
  16064. <tr>
  16065. <td>
  16066. <code>externalID</code></br>
  16067. <em>
  16068. string
  16069. </em>
  16070. </td>
  16071. <td>
  16072. <p>AWS External ID set on assumed IAM roles</p>
  16073. </td>
  16074. </tr>
  16075. <tr>
  16076. <td>
  16077. <code>sessionTags</code></br>
  16078. <em>
  16079. <a href="#external-secrets.io/v1beta1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag">
  16080. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag
  16081. </a>
  16082. </em>
  16083. </td>
  16084. <td>
  16085. <em>(Optional)</em>
  16086. <p>AWS STS assume role session tags</p>
  16087. </td>
  16088. </tr>
  16089. <tr>
  16090. <td>
  16091. <code>secretsManager</code></br>
  16092. <em>
  16093. <a href="#external-secrets.io/v1beta1.SecretsManager">
  16094. SecretsManager
  16095. </a>
  16096. </em>
  16097. </td>
  16098. <td>
  16099. <em>(Optional)</em>
  16100. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  16101. </td>
  16102. </tr>
  16103. <tr>
  16104. <td>
  16105. <code>transitiveTagKeys</code></br>
  16106. <em>
  16107. []*string
  16108. </em>
  16109. </td>
  16110. <td>
  16111. <em>(Optional)</em>
  16112. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  16113. </td>
  16114. </tr>
  16115. <tr>
  16116. <td>
  16117. <code>prefix</code></br>
  16118. <em>
  16119. string
  16120. </em>
  16121. </td>
  16122. <td>
  16123. <em>(Optional)</em>
  16124. <p>Prefix adds a prefix to all retrieved values.</p>
  16125. </td>
  16126. </tr>
  16127. </tbody>
  16128. </table>
  16129. <h3 id="external-secrets.io/v1beta1.AWSServiceType">AWSServiceType
  16130. (<code>string</code> alias)</p></h3>
  16131. <p>
  16132. (<em>Appears on:</em>
  16133. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  16134. </p>
  16135. <p>
  16136. <p>AWSServiceType is an enum that defines the service/API that is used to fetch the secrets.</p>
  16137. </p>
  16138. <table>
  16139. <thead>
  16140. <tr>
  16141. <th>Value</th>
  16142. <th>Description</th>
  16143. </tr>
  16144. </thead>
  16145. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  16146. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  16147. 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>
  16148. </td>
  16149. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  16150. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  16151. 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>
  16152. </td>
  16153. </tr></tbody>
  16154. </table>
  16155. <h3 id="external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth
  16156. </h3>
  16157. <p>
  16158. (<em>Appears on:</em>
  16159. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>)
  16160. </p>
  16161. <p>
  16162. <p>AkeylessAuth defines methods of authentication with Akeyless Vault.</p>
  16163. </p>
  16164. <table>
  16165. <thead>
  16166. <tr>
  16167. <th>Field</th>
  16168. <th>Description</th>
  16169. </tr>
  16170. </thead>
  16171. <tbody>
  16172. <tr>
  16173. <td>
  16174. <code>secretRef</code></br>
  16175. <em>
  16176. <a href="#external-secrets.io/v1beta1.AkeylessAuthSecretRef">
  16177. AkeylessAuthSecretRef
  16178. </a>
  16179. </em>
  16180. </td>
  16181. <td>
  16182. <em>(Optional)</em>
  16183. <p>Reference to a Secret that contains the details
  16184. to authenticate with Akeyless.</p>
  16185. </td>
  16186. </tr>
  16187. <tr>
  16188. <td>
  16189. <code>kubernetesAuth</code></br>
  16190. <em>
  16191. <a href="#external-secrets.io/v1beta1.AkeylessKubernetesAuth">
  16192. AkeylessKubernetesAuth
  16193. </a>
  16194. </em>
  16195. </td>
  16196. <td>
  16197. <em>(Optional)</em>
  16198. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  16199. token stored in the named Secret resource.</p>
  16200. </td>
  16201. </tr>
  16202. </tbody>
  16203. </table>
  16204. <h3 id="external-secrets.io/v1beta1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  16205. </h3>
  16206. <p>
  16207. (<em>Appears on:</em>
  16208. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  16209. </p>
  16210. <p>
  16211. <p>AkeylessAuthSecretRef defines how to authenticate using a secret reference.
  16212. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  16213. </p>
  16214. <table>
  16215. <thead>
  16216. <tr>
  16217. <th>Field</th>
  16218. <th>Description</th>
  16219. </tr>
  16220. </thead>
  16221. <tbody>
  16222. <tr>
  16223. <td>
  16224. <code>accessID</code></br>
  16225. <em>
  16226. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16227. External Secrets meta/v1.SecretKeySelector
  16228. </a>
  16229. </em>
  16230. </td>
  16231. <td>
  16232. <p>The SecretAccessID is used for authentication</p>
  16233. </td>
  16234. </tr>
  16235. <tr>
  16236. <td>
  16237. <code>accessType</code></br>
  16238. <em>
  16239. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16240. External Secrets meta/v1.SecretKeySelector
  16241. </a>
  16242. </em>
  16243. </td>
  16244. <td>
  16245. </td>
  16246. </tr>
  16247. <tr>
  16248. <td>
  16249. <code>accessTypeParam</code></br>
  16250. <em>
  16251. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16252. External Secrets meta/v1.SecretKeySelector
  16253. </a>
  16254. </em>
  16255. </td>
  16256. <td>
  16257. </td>
  16258. </tr>
  16259. </tbody>
  16260. </table>
  16261. <h3 id="external-secrets.io/v1beta1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  16262. </h3>
  16263. <p>
  16264. (<em>Appears on:</em>
  16265. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  16266. </p>
  16267. <p>
  16268. <p>AkeylessKubernetesAuth authenticates with Akeyless using a Kubernetes ServiceAccount token.</p>
  16269. </p>
  16270. <table>
  16271. <thead>
  16272. <tr>
  16273. <th>Field</th>
  16274. <th>Description</th>
  16275. </tr>
  16276. </thead>
  16277. <tbody>
  16278. <tr>
  16279. <td>
  16280. <code>accessID</code></br>
  16281. <em>
  16282. string
  16283. </em>
  16284. </td>
  16285. <td>
  16286. <p>the Akeyless Kubernetes auth-method access-id</p>
  16287. </td>
  16288. </tr>
  16289. <tr>
  16290. <td>
  16291. <code>k8sConfName</code></br>
  16292. <em>
  16293. string
  16294. </em>
  16295. </td>
  16296. <td>
  16297. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  16298. </td>
  16299. </tr>
  16300. <tr>
  16301. <td>
  16302. <code>serviceAccountRef</code></br>
  16303. <em>
  16304. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  16305. External Secrets meta/v1.ServiceAccountSelector
  16306. </a>
  16307. </em>
  16308. </td>
  16309. <td>
  16310. <em>(Optional)</em>
  16311. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  16312. If the service account is specified, the service account secret token JWT will be used
  16313. for authenticating with Akeyless. If the service account selector is not supplied,
  16314. the secretRef will be used instead.</p>
  16315. </td>
  16316. </tr>
  16317. <tr>
  16318. <td>
  16319. <code>secretRef</code></br>
  16320. <em>
  16321. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16322. External Secrets meta/v1.SecretKeySelector
  16323. </a>
  16324. </em>
  16325. </td>
  16326. <td>
  16327. <em>(Optional)</em>
  16328. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  16329. for authenticating with Akeyless. If a name is specified without a key,
  16330. <code>token</code> is the default. If one is not specified, the one bound to
  16331. the controller will be used.</p>
  16332. </td>
  16333. </tr>
  16334. </tbody>
  16335. </table>
  16336. <h3 id="external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider
  16337. </h3>
  16338. <p>
  16339. (<em>Appears on:</em>
  16340. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16341. </p>
  16342. <p>
  16343. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  16344. </p>
  16345. <table>
  16346. <thead>
  16347. <tr>
  16348. <th>Field</th>
  16349. <th>Description</th>
  16350. </tr>
  16351. </thead>
  16352. <tbody>
  16353. <tr>
  16354. <td>
  16355. <code>akeylessGWApiURL</code></br>
  16356. <em>
  16357. string
  16358. </em>
  16359. </td>
  16360. <td>
  16361. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  16362. </td>
  16363. </tr>
  16364. <tr>
  16365. <td>
  16366. <code>authSecretRef</code></br>
  16367. <em>
  16368. <a href="#external-secrets.io/v1beta1.AkeylessAuth">
  16369. AkeylessAuth
  16370. </a>
  16371. </em>
  16372. </td>
  16373. <td>
  16374. <p>Auth configures how the operator authenticates with Akeyless.</p>
  16375. </td>
  16376. </tr>
  16377. <tr>
  16378. <td>
  16379. <code>caBundle</code></br>
  16380. <em>
  16381. []byte
  16382. </em>
  16383. </td>
  16384. <td>
  16385. <em>(Optional)</em>
  16386. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  16387. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  16388. are used to validate the TLS connection.</p>
  16389. </td>
  16390. </tr>
  16391. <tr>
  16392. <td>
  16393. <code>caProvider</code></br>
  16394. <em>
  16395. <a href="#external-secrets.io/v1beta1.CAProvider">
  16396. CAProvider
  16397. </a>
  16398. </em>
  16399. </td>
  16400. <td>
  16401. <em>(Optional)</em>
  16402. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  16403. </td>
  16404. </tr>
  16405. </tbody>
  16406. </table>
  16407. <h3 id="external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth
  16408. </h3>
  16409. <p>
  16410. (<em>Appears on:</em>
  16411. <a href="#external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider</a>)
  16412. </p>
  16413. <p>
  16414. <p>AlibabaAuth contains a secretRef for credentials.</p>
  16415. </p>
  16416. <table>
  16417. <thead>
  16418. <tr>
  16419. <th>Field</th>
  16420. <th>Description</th>
  16421. </tr>
  16422. </thead>
  16423. <tbody>
  16424. <tr>
  16425. <td>
  16426. <code>secretRef</code></br>
  16427. <em>
  16428. <a href="#external-secrets.io/v1beta1.AlibabaAuthSecretRef">
  16429. AlibabaAuthSecretRef
  16430. </a>
  16431. </em>
  16432. </td>
  16433. <td>
  16434. <em>(Optional)</em>
  16435. </td>
  16436. </tr>
  16437. <tr>
  16438. <td>
  16439. <code>rrsa</code></br>
  16440. <em>
  16441. <a href="#external-secrets.io/v1beta1.AlibabaRRSAAuth">
  16442. AlibabaRRSAAuth
  16443. </a>
  16444. </em>
  16445. </td>
  16446. <td>
  16447. <em>(Optional)</em>
  16448. </td>
  16449. </tr>
  16450. </tbody>
  16451. </table>
  16452. <h3 id="external-secrets.io/v1beta1.AlibabaAuthSecretRef">AlibabaAuthSecretRef
  16453. </h3>
  16454. <p>
  16455. (<em>Appears on:</em>
  16456. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  16457. </p>
  16458. <p>
  16459. <p>AlibabaAuthSecretRef holds secret references for Alibaba credentials.</p>
  16460. </p>
  16461. <table>
  16462. <thead>
  16463. <tr>
  16464. <th>Field</th>
  16465. <th>Description</th>
  16466. </tr>
  16467. </thead>
  16468. <tbody>
  16469. <tr>
  16470. <td>
  16471. <code>accessKeyIDSecretRef</code></br>
  16472. <em>
  16473. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16474. External Secrets meta/v1.SecretKeySelector
  16475. </a>
  16476. </em>
  16477. </td>
  16478. <td>
  16479. <p>The AccessKeyID is used for authentication</p>
  16480. </td>
  16481. </tr>
  16482. <tr>
  16483. <td>
  16484. <code>accessKeySecretSecretRef</code></br>
  16485. <em>
  16486. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16487. External Secrets meta/v1.SecretKeySelector
  16488. </a>
  16489. </em>
  16490. </td>
  16491. <td>
  16492. <p>The AccessKeySecret is used for authentication</p>
  16493. </td>
  16494. </tr>
  16495. </tbody>
  16496. </table>
  16497. <h3 id="external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider
  16498. </h3>
  16499. <p>
  16500. (<em>Appears on:</em>
  16501. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16502. </p>
  16503. <p>
  16504. <p>AlibabaProvider configures a store to sync secrets using the Alibaba Secret Manager provider.</p>
  16505. </p>
  16506. <table>
  16507. <thead>
  16508. <tr>
  16509. <th>Field</th>
  16510. <th>Description</th>
  16511. </tr>
  16512. </thead>
  16513. <tbody>
  16514. <tr>
  16515. <td>
  16516. <code>auth</code></br>
  16517. <em>
  16518. <a href="#external-secrets.io/v1beta1.AlibabaAuth">
  16519. AlibabaAuth
  16520. </a>
  16521. </em>
  16522. </td>
  16523. <td>
  16524. </td>
  16525. </tr>
  16526. <tr>
  16527. <td>
  16528. <code>regionID</code></br>
  16529. <em>
  16530. string
  16531. </em>
  16532. </td>
  16533. <td>
  16534. <p>Alibaba Region to be used for the provider</p>
  16535. </td>
  16536. </tr>
  16537. </tbody>
  16538. </table>
  16539. <h3 id="external-secrets.io/v1beta1.AlibabaRRSAAuth">AlibabaRRSAAuth
  16540. </h3>
  16541. <p>
  16542. (<em>Appears on:</em>
  16543. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  16544. </p>
  16545. <p>
  16546. <p>AlibabaRRSAAuth authenticates against Alibaba using RRSA (Resource-oriented RAM-based Service Authentication).</p>
  16547. </p>
  16548. <table>
  16549. <thead>
  16550. <tr>
  16551. <th>Field</th>
  16552. <th>Description</th>
  16553. </tr>
  16554. </thead>
  16555. <tbody>
  16556. <tr>
  16557. <td>
  16558. <code>oidcProviderArn</code></br>
  16559. <em>
  16560. string
  16561. </em>
  16562. </td>
  16563. <td>
  16564. </td>
  16565. </tr>
  16566. <tr>
  16567. <td>
  16568. <code>oidcTokenFilePath</code></br>
  16569. <em>
  16570. string
  16571. </em>
  16572. </td>
  16573. <td>
  16574. </td>
  16575. </tr>
  16576. <tr>
  16577. <td>
  16578. <code>roleArn</code></br>
  16579. <em>
  16580. string
  16581. </em>
  16582. </td>
  16583. <td>
  16584. </td>
  16585. </tr>
  16586. <tr>
  16587. <td>
  16588. <code>sessionName</code></br>
  16589. <em>
  16590. string
  16591. </em>
  16592. </td>
  16593. <td>
  16594. </td>
  16595. </tr>
  16596. </tbody>
  16597. </table>
  16598. <h3 id="external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol
  16599. </h3>
  16600. <p>
  16601. (<em>Appears on:</em>
  16602. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  16603. </p>
  16604. <p>
  16605. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  16606. </p>
  16607. <table>
  16608. <thead>
  16609. <tr>
  16610. <th>Field</th>
  16611. <th>Description</th>
  16612. </tr>
  16613. </thead>
  16614. <tbody>
  16615. <tr>
  16616. <td>
  16617. <code>ntlm</code></br>
  16618. <em>
  16619. <a href="#external-secrets.io/v1beta1.NTLMProtocol">
  16620. NTLMProtocol
  16621. </a>
  16622. </em>
  16623. </td>
  16624. <td>
  16625. <em>(Optional)</em>
  16626. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  16627. </td>
  16628. </tr>
  16629. </tbody>
  16630. </table>
  16631. <h3 id="external-secrets.io/v1beta1.AzureAuthType">AzureAuthType
  16632. (<code>string</code> alias)</p></h3>
  16633. <p>
  16634. (<em>Appears on:</em>
  16635. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  16636. </p>
  16637. <p>
  16638. <p>AzureAuthType describes how to authenticate to the Azure Keyvault.
  16639. Only one of the following auth types may be specified.
  16640. If none of the following auth type is specified, the default one
  16641. is ServicePrincipal.</p>
  16642. </p>
  16643. <table>
  16644. <thead>
  16645. <tr>
  16646. <th>Value</th>
  16647. <th>Description</th>
  16648. </tr>
  16649. </thead>
  16650. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  16651. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  16652. </td>
  16653. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  16654. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  16655. </td>
  16656. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  16657. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  16658. </td>
  16659. </tr></tbody>
  16660. </table>
  16661. <h3 id="external-secrets.io/v1beta1.AzureEnvironmentType">AzureEnvironmentType
  16662. (<code>string</code> alias)</p></h3>
  16663. <p>
  16664. (<em>Appears on:</em>
  16665. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  16666. </p>
  16667. <p>
  16668. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  16669. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  16670. 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>
  16671. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  16672. </p>
  16673. <table>
  16674. <thead>
  16675. <tr>
  16676. <th>Value</th>
  16677. <th>Description</th>
  16678. </tr>
  16679. </thead>
  16680. <tbody><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  16681. <td><p>AzureEnvironmentChinaCloud represents the Azure China cloud environment.</p>
  16682. </td>
  16683. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  16684. <td><p>AzureEnvironmentGermanCloud represents the Azure German cloud environment.</p>
  16685. </td>
  16686. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  16687. <td><p>AzureEnvironmentPublicCloud represents the Azure public cloud environment.</p>
  16688. </td>
  16689. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  16690. <td><p>AzureEnvironmentUSGovernmentCloud represents the Azure US government cloud environment.</p>
  16691. </td>
  16692. </tr></tbody>
  16693. </table>
  16694. <h3 id="external-secrets.io/v1beta1.AzureKVAuth">AzureKVAuth
  16695. </h3>
  16696. <p>
  16697. (<em>Appears on:</em>
  16698. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  16699. </p>
  16700. <p>
  16701. <p>AzureKVAuth defines configuration for authentication with Azure Key Vault.</p>
  16702. </p>
  16703. <table>
  16704. <thead>
  16705. <tr>
  16706. <th>Field</th>
  16707. <th>Description</th>
  16708. </tr>
  16709. </thead>
  16710. <tbody>
  16711. <tr>
  16712. <td>
  16713. <code>clientId</code></br>
  16714. <em>
  16715. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16716. External Secrets meta/v1.SecretKeySelector
  16717. </a>
  16718. </em>
  16719. </td>
  16720. <td>
  16721. <em>(Optional)</em>
  16722. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  16723. </td>
  16724. </tr>
  16725. <tr>
  16726. <td>
  16727. <code>tenantId</code></br>
  16728. <em>
  16729. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16730. External Secrets meta/v1.SecretKeySelector
  16731. </a>
  16732. </em>
  16733. </td>
  16734. <td>
  16735. <em>(Optional)</em>
  16736. <p>The Azure tenantId of the managed identity used for authentication.</p>
  16737. </td>
  16738. </tr>
  16739. <tr>
  16740. <td>
  16741. <code>clientSecret</code></br>
  16742. <em>
  16743. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16744. External Secrets meta/v1.SecretKeySelector
  16745. </a>
  16746. </em>
  16747. </td>
  16748. <td>
  16749. <em>(Optional)</em>
  16750. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  16751. </td>
  16752. </tr>
  16753. <tr>
  16754. <td>
  16755. <code>clientCertificate</code></br>
  16756. <em>
  16757. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16758. External Secrets meta/v1.SecretKeySelector
  16759. </a>
  16760. </em>
  16761. </td>
  16762. <td>
  16763. <em>(Optional)</em>
  16764. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  16765. </td>
  16766. </tr>
  16767. </tbody>
  16768. </table>
  16769. <h3 id="external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider
  16770. </h3>
  16771. <p>
  16772. (<em>Appears on:</em>
  16773. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16774. </p>
  16775. <p>
  16776. <p>AzureKVProvider configures a store to sync secrets using Azure Key Vault.</p>
  16777. </p>
  16778. <table>
  16779. <thead>
  16780. <tr>
  16781. <th>Field</th>
  16782. <th>Description</th>
  16783. </tr>
  16784. </thead>
  16785. <tbody>
  16786. <tr>
  16787. <td>
  16788. <code>authType</code></br>
  16789. <em>
  16790. <a href="#external-secrets.io/v1beta1.AzureAuthType">
  16791. AzureAuthType
  16792. </a>
  16793. </em>
  16794. </td>
  16795. <td>
  16796. <em>(Optional)</em>
  16797. <p>Auth type defines how to authenticate to the keyvault service.
  16798. Valid values are:
  16799. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  16800. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)</p>
  16801. </td>
  16802. </tr>
  16803. <tr>
  16804. <td>
  16805. <code>vaultUrl</code></br>
  16806. <em>
  16807. string
  16808. </em>
  16809. </td>
  16810. <td>
  16811. <p>Vault Url from which the secrets to be fetched from.</p>
  16812. </td>
  16813. </tr>
  16814. <tr>
  16815. <td>
  16816. <code>tenantId</code></br>
  16817. <em>
  16818. string
  16819. </em>
  16820. </td>
  16821. <td>
  16822. <em>(Optional)</em>
  16823. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  16824. </td>
  16825. </tr>
  16826. <tr>
  16827. <td>
  16828. <code>environmentType</code></br>
  16829. <em>
  16830. <a href="#external-secrets.io/v1beta1.AzureEnvironmentType">
  16831. AzureEnvironmentType
  16832. </a>
  16833. </em>
  16834. </td>
  16835. <td>
  16836. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  16837. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  16838. 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>
  16839. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  16840. </td>
  16841. </tr>
  16842. <tr>
  16843. <td>
  16844. <code>authSecretRef</code></br>
  16845. <em>
  16846. <a href="#external-secrets.io/v1beta1.AzureKVAuth">
  16847. AzureKVAuth
  16848. </a>
  16849. </em>
  16850. </td>
  16851. <td>
  16852. <em>(Optional)</em>
  16853. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  16854. </td>
  16855. </tr>
  16856. <tr>
  16857. <td>
  16858. <code>serviceAccountRef</code></br>
  16859. <em>
  16860. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  16861. External Secrets meta/v1.ServiceAccountSelector
  16862. </a>
  16863. </em>
  16864. </td>
  16865. <td>
  16866. <em>(Optional)</em>
  16867. <p>ServiceAccountRef specified the service account
  16868. that should be used when authenticating with WorkloadIdentity.</p>
  16869. </td>
  16870. </tr>
  16871. <tr>
  16872. <td>
  16873. <code>identityId</code></br>
  16874. <em>
  16875. string
  16876. </em>
  16877. </td>
  16878. <td>
  16879. <em>(Optional)</em>
  16880. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  16881. </td>
  16882. </tr>
  16883. </tbody>
  16884. </table>
  16885. <h3 id="external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  16886. </h3>
  16887. <p>
  16888. (<em>Appears on:</em>
  16889. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth</a>)
  16890. </p>
  16891. <p>
  16892. <p>BeyondTrustProviderSecretRef defines a reference to a secret containing credentials for the BeyondTrust provider.</p>
  16893. </p>
  16894. <table>
  16895. <thead>
  16896. <tr>
  16897. <th>Field</th>
  16898. <th>Description</th>
  16899. </tr>
  16900. </thead>
  16901. <tbody>
  16902. <tr>
  16903. <td>
  16904. <code>value</code></br>
  16905. <em>
  16906. string
  16907. </em>
  16908. </td>
  16909. <td>
  16910. <em>(Optional)</em>
  16911. <p>Value can be specified directly to set a value without using a secret.</p>
  16912. </td>
  16913. </tr>
  16914. <tr>
  16915. <td>
  16916. <code>secretRef</code></br>
  16917. <em>
  16918. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16919. External Secrets meta/v1.SecretKeySelector
  16920. </a>
  16921. </em>
  16922. </td>
  16923. <td>
  16924. <em>(Optional)</em>
  16925. <p>SecretRef references a key in a secret that will be used as value.</p>
  16926. </td>
  16927. </tr>
  16928. </tbody>
  16929. </table>
  16930. <h3 id="external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth
  16931. </h3>
  16932. <p>
  16933. (<em>Appears on:</em>
  16934. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  16935. </p>
  16936. <p>
  16937. <p>BeyondtrustAuth configures authentication for BeyondTrust Password Safe.</p>
  16938. </p>
  16939. <table>
  16940. <thead>
  16941. <tr>
  16942. <th>Field</th>
  16943. <th>Description</th>
  16944. </tr>
  16945. </thead>
  16946. <tbody>
  16947. <tr>
  16948. <td>
  16949. <code>apiKey</code></br>
  16950. <em>
  16951. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16952. BeyondTrustProviderSecretRef
  16953. </a>
  16954. </em>
  16955. </td>
  16956. <td>
  16957. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  16958. </td>
  16959. </tr>
  16960. <tr>
  16961. <td>
  16962. <code>clientId</code></br>
  16963. <em>
  16964. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16965. BeyondTrustProviderSecretRef
  16966. </a>
  16967. </em>
  16968. </td>
  16969. <td>
  16970. <p>ClientID is the API OAuth Client ID.</p>
  16971. </td>
  16972. </tr>
  16973. <tr>
  16974. <td>
  16975. <code>clientSecret</code></br>
  16976. <em>
  16977. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16978. BeyondTrustProviderSecretRef
  16979. </a>
  16980. </em>
  16981. </td>
  16982. <td>
  16983. <p>ClientSecret is the API OAuth Client Secret.</p>
  16984. </td>
  16985. </tr>
  16986. <tr>
  16987. <td>
  16988. <code>certificate</code></br>
  16989. <em>
  16990. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16991. BeyondTrustProviderSecretRef
  16992. </a>
  16993. </em>
  16994. </td>
  16995. <td>
  16996. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  16997. </td>
  16998. </tr>
  16999. <tr>
  17000. <td>
  17001. <code>certificateKey</code></br>
  17002. <em>
  17003. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  17004. BeyondTrustProviderSecretRef
  17005. </a>
  17006. </em>
  17007. </td>
  17008. <td>
  17009. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  17010. </td>
  17011. </tr>
  17012. </tbody>
  17013. </table>
  17014. <h3 id="external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider
  17015. </h3>
  17016. <p>
  17017. (<em>Appears on:</em>
  17018. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17019. </p>
  17020. <p>
  17021. <p>BeyondtrustProvider defines configuration for the BeyondTrust Password Safe provider.</p>
  17022. </p>
  17023. <table>
  17024. <thead>
  17025. <tr>
  17026. <th>Field</th>
  17027. <th>Description</th>
  17028. </tr>
  17029. </thead>
  17030. <tbody>
  17031. <tr>
  17032. <td>
  17033. <code>auth</code></br>
  17034. <em>
  17035. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">
  17036. BeyondtrustAuth
  17037. </a>
  17038. </em>
  17039. </td>
  17040. <td>
  17041. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  17042. </td>
  17043. </tr>
  17044. <tr>
  17045. <td>
  17046. <code>server</code></br>
  17047. <em>
  17048. <a href="#external-secrets.io/v1beta1.BeyondtrustServer">
  17049. BeyondtrustServer
  17050. </a>
  17051. </em>
  17052. </td>
  17053. <td>
  17054. <p>Auth configures how API server works.</p>
  17055. </td>
  17056. </tr>
  17057. </tbody>
  17058. </table>
  17059. <h3 id="external-secrets.io/v1beta1.BeyondtrustServer">BeyondtrustServer
  17060. </h3>
  17061. <p>
  17062. (<em>Appears on:</em>
  17063. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  17064. </p>
  17065. <p>
  17066. <p>BeyondtrustServer defines configuration for connecting to BeyondTrust Password Safe server.</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>apiUrl</code></br>
  17079. <em>
  17080. string
  17081. </em>
  17082. </td>
  17083. <td>
  17084. </td>
  17085. </tr>
  17086. <tr>
  17087. <td>
  17088. <code>apiVersion</code></br>
  17089. <em>
  17090. string
  17091. </em>
  17092. </td>
  17093. <td>
  17094. </td>
  17095. </tr>
  17096. <tr>
  17097. <td>
  17098. <code>retrievalType</code></br>
  17099. <em>
  17100. string
  17101. </em>
  17102. </td>
  17103. <td>
  17104. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  17105. </td>
  17106. </tr>
  17107. <tr>
  17108. <td>
  17109. <code>separator</code></br>
  17110. <em>
  17111. string
  17112. </em>
  17113. </td>
  17114. <td>
  17115. <p>A character that separates the folder names.</p>
  17116. </td>
  17117. </tr>
  17118. <tr>
  17119. <td>
  17120. <code>decrypt</code></br>
  17121. <em>
  17122. bool
  17123. </em>
  17124. </td>
  17125. <td>
  17126. <em>(Optional)</em>
  17127. <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>
  17128. </td>
  17129. </tr>
  17130. <tr>
  17131. <td>
  17132. <code>verifyCA</code></br>
  17133. <em>
  17134. bool
  17135. </em>
  17136. </td>
  17137. <td>
  17138. </td>
  17139. </tr>
  17140. <tr>
  17141. <td>
  17142. <code>clientTimeOutSeconds</code></br>
  17143. <em>
  17144. int
  17145. </em>
  17146. </td>
  17147. <td>
  17148. <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>
  17149. </td>
  17150. </tr>
  17151. </tbody>
  17152. </table>
  17153. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  17154. </h3>
  17155. <p>
  17156. (<em>Appears on:</em>
  17157. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  17158. </p>
  17159. <p>
  17160. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  17161. </p>
  17162. <table>
  17163. <thead>
  17164. <tr>
  17165. <th>Field</th>
  17166. <th>Description</th>
  17167. </tr>
  17168. </thead>
  17169. <tbody>
  17170. <tr>
  17171. <td>
  17172. <code>secretRef</code></br>
  17173. <em>
  17174. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">
  17175. BitwardenSecretsManagerSecretRef
  17176. </a>
  17177. </em>
  17178. </td>
  17179. <td>
  17180. </td>
  17181. </tr>
  17182. </tbody>
  17183. </table>
  17184. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  17185. </h3>
  17186. <p>
  17187. (<em>Appears on:</em>
  17188. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17189. </p>
  17190. <p>
  17191. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  17192. </p>
  17193. <table>
  17194. <thead>
  17195. <tr>
  17196. <th>Field</th>
  17197. <th>Description</th>
  17198. </tr>
  17199. </thead>
  17200. <tbody>
  17201. <tr>
  17202. <td>
  17203. <code>apiURL</code></br>
  17204. <em>
  17205. string
  17206. </em>
  17207. </td>
  17208. <td>
  17209. </td>
  17210. </tr>
  17211. <tr>
  17212. <td>
  17213. <code>identityURL</code></br>
  17214. <em>
  17215. string
  17216. </em>
  17217. </td>
  17218. <td>
  17219. </td>
  17220. </tr>
  17221. <tr>
  17222. <td>
  17223. <code>bitwardenServerSDKURL</code></br>
  17224. <em>
  17225. string
  17226. </em>
  17227. </td>
  17228. <td>
  17229. </td>
  17230. </tr>
  17231. <tr>
  17232. <td>
  17233. <code>caBundle</code></br>
  17234. <em>
  17235. string
  17236. </em>
  17237. </td>
  17238. <td>
  17239. <em>(Optional)</em>
  17240. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  17241. can be performed.</p>
  17242. </td>
  17243. </tr>
  17244. <tr>
  17245. <td>
  17246. <code>caProvider</code></br>
  17247. <em>
  17248. <a href="#external-secrets.io/v1beta1.CAProvider">
  17249. CAProvider
  17250. </a>
  17251. </em>
  17252. </td>
  17253. <td>
  17254. <em>(Optional)</em>
  17255. <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>
  17256. </td>
  17257. </tr>
  17258. <tr>
  17259. <td>
  17260. <code>organizationID</code></br>
  17261. <em>
  17262. string
  17263. </em>
  17264. </td>
  17265. <td>
  17266. <p>OrganizationID determines which organization this secret store manages.</p>
  17267. </td>
  17268. </tr>
  17269. <tr>
  17270. <td>
  17271. <code>projectID</code></br>
  17272. <em>
  17273. string
  17274. </em>
  17275. </td>
  17276. <td>
  17277. <p>ProjectID determines which project this secret store manages.</p>
  17278. </td>
  17279. </tr>
  17280. <tr>
  17281. <td>
  17282. <code>auth</code></br>
  17283. <em>
  17284. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">
  17285. BitwardenSecretsManagerAuth
  17286. </a>
  17287. </em>
  17288. </td>
  17289. <td>
  17290. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  17291. Make sure that the token being used has permissions on the given secret.</p>
  17292. </td>
  17293. </tr>
  17294. </tbody>
  17295. </table>
  17296. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  17297. </h3>
  17298. <p>
  17299. (<em>Appears on:</em>
  17300. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  17301. </p>
  17302. <p>
  17303. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  17304. </p>
  17305. <table>
  17306. <thead>
  17307. <tr>
  17308. <th>Field</th>
  17309. <th>Description</th>
  17310. </tr>
  17311. </thead>
  17312. <tbody>
  17313. <tr>
  17314. <td>
  17315. <code>credentials</code></br>
  17316. <em>
  17317. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17318. External Secrets meta/v1.SecretKeySelector
  17319. </a>
  17320. </em>
  17321. </td>
  17322. <td>
  17323. <p>AccessToken used for the bitwarden instance.</p>
  17324. </td>
  17325. </tr>
  17326. </tbody>
  17327. </table>
  17328. <h3 id="external-secrets.io/v1beta1.CAProvider">CAProvider
  17329. </h3>
  17330. <p>
  17331. (<em>Appears on:</em>
  17332. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>,
  17333. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  17334. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>,
  17335. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>,
  17336. <a href="#external-secrets.io/v1beta1.KubernetesServer">KubernetesServer</a>,
  17337. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  17338. </p>
  17339. <p>
  17340. <p>CAProvider provides custom certificate authority (CA) certificates
  17341. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  17342. that contains a PEM-encoded certificate.</p>
  17343. </p>
  17344. <table>
  17345. <thead>
  17346. <tr>
  17347. <th>Field</th>
  17348. <th>Description</th>
  17349. </tr>
  17350. </thead>
  17351. <tbody>
  17352. <tr>
  17353. <td>
  17354. <code>type</code></br>
  17355. <em>
  17356. <a href="#external-secrets.io/v1beta1.CAProviderType">
  17357. CAProviderType
  17358. </a>
  17359. </em>
  17360. </td>
  17361. <td>
  17362. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  17363. </td>
  17364. </tr>
  17365. <tr>
  17366. <td>
  17367. <code>name</code></br>
  17368. <em>
  17369. string
  17370. </em>
  17371. </td>
  17372. <td>
  17373. <p>The name of the object located at the provider type.</p>
  17374. </td>
  17375. </tr>
  17376. <tr>
  17377. <td>
  17378. <code>key</code></br>
  17379. <em>
  17380. string
  17381. </em>
  17382. </td>
  17383. <td>
  17384. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  17385. </td>
  17386. </tr>
  17387. <tr>
  17388. <td>
  17389. <code>namespace</code></br>
  17390. <em>
  17391. string
  17392. </em>
  17393. </td>
  17394. <td>
  17395. <em>(Optional)</em>
  17396. <p>The namespace the Provider type is in.
  17397. Can only be defined when used in a ClusterSecretStore.</p>
  17398. </td>
  17399. </tr>
  17400. </tbody>
  17401. </table>
  17402. <h3 id="external-secrets.io/v1beta1.CAProviderType">CAProviderType
  17403. (<code>string</code> alias)</p></h3>
  17404. <p>
  17405. (<em>Appears on:</em>
  17406. <a href="#external-secrets.io/v1beta1.CAProvider">CAProvider</a>)
  17407. </p>
  17408. <p>
  17409. <p>CAProviderType defines the type of provider to use for CA certificates.</p>
  17410. </p>
  17411. <table>
  17412. <thead>
  17413. <tr>
  17414. <th>Value</th>
  17415. <th>Description</th>
  17416. </tr>
  17417. </thead>
  17418. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  17419. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  17420. </td>
  17421. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  17422. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  17423. </td>
  17424. </tr></tbody>
  17425. </table>
  17426. <h3 id="external-secrets.io/v1beta1.CSMAuth">CSMAuth
  17427. </h3>
  17428. <p>
  17429. (<em>Appears on:</em>
  17430. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider</a>)
  17431. </p>
  17432. <p>
  17433. <p>CSMAuth contains a secretRef for credentials.</p>
  17434. </p>
  17435. <table>
  17436. <thead>
  17437. <tr>
  17438. <th>Field</th>
  17439. <th>Description</th>
  17440. </tr>
  17441. </thead>
  17442. <tbody>
  17443. <tr>
  17444. <td>
  17445. <code>secretRef</code></br>
  17446. <em>
  17447. <a href="#external-secrets.io/v1beta1.CSMAuthSecretRef">
  17448. CSMAuthSecretRef
  17449. </a>
  17450. </em>
  17451. </td>
  17452. <td>
  17453. <em>(Optional)</em>
  17454. </td>
  17455. </tr>
  17456. </tbody>
  17457. </table>
  17458. <h3 id="external-secrets.io/v1beta1.CSMAuthSecretRef">CSMAuthSecretRef
  17459. </h3>
  17460. <p>
  17461. (<em>Appears on:</em>
  17462. <a href="#external-secrets.io/v1beta1.CSMAuth">CSMAuth</a>)
  17463. </p>
  17464. <p>
  17465. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  17466. </p>
  17467. <table>
  17468. <thead>
  17469. <tr>
  17470. <th>Field</th>
  17471. <th>Description</th>
  17472. </tr>
  17473. </thead>
  17474. <tbody>
  17475. <tr>
  17476. <td>
  17477. <code>accessKeyIDSecretRef</code></br>
  17478. <em>
  17479. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17480. External Secrets meta/v1.SecretKeySelector
  17481. </a>
  17482. </em>
  17483. </td>
  17484. <td>
  17485. <p>The AccessKeyID is used for authentication</p>
  17486. </td>
  17487. </tr>
  17488. <tr>
  17489. <td>
  17490. <code>accessKeySecretSecretRef</code></br>
  17491. <em>
  17492. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17493. External Secrets meta/v1.SecretKeySelector
  17494. </a>
  17495. </em>
  17496. </td>
  17497. <td>
  17498. <p>The AccessKeySecret is used for authentication</p>
  17499. </td>
  17500. </tr>
  17501. </tbody>
  17502. </table>
  17503. <h3 id="external-secrets.io/v1beta1.CertAuth">CertAuth
  17504. </h3>
  17505. <p>
  17506. (<em>Appears on:</em>
  17507. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  17508. </p>
  17509. <p>
  17510. <p>CertAuth defines certificate-based authentication for the Kubernetes provider.</p>
  17511. </p>
  17512. <table>
  17513. <thead>
  17514. <tr>
  17515. <th>Field</th>
  17516. <th>Description</th>
  17517. </tr>
  17518. </thead>
  17519. <tbody>
  17520. <tr>
  17521. <td>
  17522. <code>clientCert</code></br>
  17523. <em>
  17524. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17525. External Secrets meta/v1.SecretKeySelector
  17526. </a>
  17527. </em>
  17528. </td>
  17529. <td>
  17530. </td>
  17531. </tr>
  17532. <tr>
  17533. <td>
  17534. <code>clientKey</code></br>
  17535. <em>
  17536. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17537. External Secrets meta/v1.SecretKeySelector
  17538. </a>
  17539. </em>
  17540. </td>
  17541. <td>
  17542. </td>
  17543. </tr>
  17544. </tbody>
  17545. </table>
  17546. <h3 id="external-secrets.io/v1beta1.ChefAuth">ChefAuth
  17547. </h3>
  17548. <p>
  17549. (<em>Appears on:</em>
  17550. <a href="#external-secrets.io/v1beta1.ChefProvider">ChefProvider</a>)
  17551. </p>
  17552. <p>
  17553. <p>ChefAuth contains a secretRef for credentials.</p>
  17554. </p>
  17555. <table>
  17556. <thead>
  17557. <tr>
  17558. <th>Field</th>
  17559. <th>Description</th>
  17560. </tr>
  17561. </thead>
  17562. <tbody>
  17563. <tr>
  17564. <td>
  17565. <code>secretRef</code></br>
  17566. <em>
  17567. <a href="#external-secrets.io/v1beta1.ChefAuthSecretRef">
  17568. ChefAuthSecretRef
  17569. </a>
  17570. </em>
  17571. </td>
  17572. <td>
  17573. </td>
  17574. </tr>
  17575. </tbody>
  17576. </table>
  17577. <h3 id="external-secrets.io/v1beta1.ChefAuthSecretRef">ChefAuthSecretRef
  17578. </h3>
  17579. <p>
  17580. (<em>Appears on:</em>
  17581. <a href="#external-secrets.io/v1beta1.ChefAuth">ChefAuth</a>)
  17582. </p>
  17583. <p>
  17584. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  17585. </p>
  17586. <table>
  17587. <thead>
  17588. <tr>
  17589. <th>Field</th>
  17590. <th>Description</th>
  17591. </tr>
  17592. </thead>
  17593. <tbody>
  17594. <tr>
  17595. <td>
  17596. <code>privateKeySecretRef</code></br>
  17597. <em>
  17598. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17599. External Secrets meta/v1.SecretKeySelector
  17600. </a>
  17601. </em>
  17602. </td>
  17603. <td>
  17604. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  17605. </td>
  17606. </tr>
  17607. </tbody>
  17608. </table>
  17609. <h3 id="external-secrets.io/v1beta1.ChefProvider">ChefProvider
  17610. </h3>
  17611. <p>
  17612. (<em>Appears on:</em>
  17613. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17614. </p>
  17615. <p>
  17616. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  17617. </p>
  17618. <table>
  17619. <thead>
  17620. <tr>
  17621. <th>Field</th>
  17622. <th>Description</th>
  17623. </tr>
  17624. </thead>
  17625. <tbody>
  17626. <tr>
  17627. <td>
  17628. <code>auth</code></br>
  17629. <em>
  17630. <a href="#external-secrets.io/v1beta1.ChefAuth">
  17631. ChefAuth
  17632. </a>
  17633. </em>
  17634. </td>
  17635. <td>
  17636. <p>Auth defines the information necessary to authenticate against chef Server</p>
  17637. </td>
  17638. </tr>
  17639. <tr>
  17640. <td>
  17641. <code>username</code></br>
  17642. <em>
  17643. string
  17644. </em>
  17645. </td>
  17646. <td>
  17647. <p>UserName should be the user ID on the chef server</p>
  17648. </td>
  17649. </tr>
  17650. <tr>
  17651. <td>
  17652. <code>serverUrl</code></br>
  17653. <em>
  17654. string
  17655. </em>
  17656. </td>
  17657. <td>
  17658. <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>
  17659. </td>
  17660. </tr>
  17661. </tbody>
  17662. </table>
  17663. <h3 id="external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider
  17664. </h3>
  17665. <p>
  17666. (<em>Appears on:</em>
  17667. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17668. </p>
  17669. <p>
  17670. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  17671. </p>
  17672. <table>
  17673. <thead>
  17674. <tr>
  17675. <th>Field</th>
  17676. <th>Description</th>
  17677. </tr>
  17678. </thead>
  17679. <tbody>
  17680. <tr>
  17681. <td>
  17682. <code>auth</code></br>
  17683. <em>
  17684. <a href="#external-secrets.io/v1beta1.CSMAuth">
  17685. CSMAuth
  17686. </a>
  17687. </em>
  17688. </td>
  17689. <td>
  17690. </td>
  17691. </tr>
  17692. <tr>
  17693. <td>
  17694. <code>projectID</code></br>
  17695. <em>
  17696. string
  17697. </em>
  17698. </td>
  17699. <td>
  17700. <p>ProjectID is the project, which the secrets are stored in.</p>
  17701. </td>
  17702. </tr>
  17703. </tbody>
  17704. </table>
  17705. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret
  17706. </h3>
  17707. <p>
  17708. <p>ClusterExternalSecret is the schema for the clusterexternalsecrets API.</p>
  17709. </p>
  17710. <table>
  17711. <thead>
  17712. <tr>
  17713. <th>Field</th>
  17714. <th>Description</th>
  17715. </tr>
  17716. </thead>
  17717. <tbody>
  17718. <tr>
  17719. <td>
  17720. <code>metadata</code></br>
  17721. <em>
  17722. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  17723. Kubernetes meta/v1.ObjectMeta
  17724. </a>
  17725. </em>
  17726. </td>
  17727. <td>
  17728. Refer to the Kubernetes API documentation for the fields of the
  17729. <code>metadata</code> field.
  17730. </td>
  17731. </tr>
  17732. <tr>
  17733. <td>
  17734. <code>spec</code></br>
  17735. <em>
  17736. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">
  17737. ClusterExternalSecretSpec
  17738. </a>
  17739. </em>
  17740. </td>
  17741. <td>
  17742. <br/>
  17743. <br/>
  17744. <table>
  17745. <tr>
  17746. <td>
  17747. <code>externalSecretSpec</code></br>
  17748. <em>
  17749. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  17750. ExternalSecretSpec
  17751. </a>
  17752. </em>
  17753. </td>
  17754. <td>
  17755. <p>The spec for the ExternalSecrets to be created</p>
  17756. </td>
  17757. </tr>
  17758. <tr>
  17759. <td>
  17760. <code>externalSecretName</code></br>
  17761. <em>
  17762. string
  17763. </em>
  17764. </td>
  17765. <td>
  17766. <em>(Optional)</em>
  17767. <p>The name of the external secrets to be created.
  17768. Defaults to the name of the ClusterExternalSecret</p>
  17769. </td>
  17770. </tr>
  17771. <tr>
  17772. <td>
  17773. <code>externalSecretMetadata</code></br>
  17774. <em>
  17775. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  17776. ExternalSecretMetadata
  17777. </a>
  17778. </em>
  17779. </td>
  17780. <td>
  17781. <em>(Optional)</em>
  17782. <p>The metadata of the external secrets to be created</p>
  17783. </td>
  17784. </tr>
  17785. <tr>
  17786. <td>
  17787. <code>namespaceSelector</code></br>
  17788. <em>
  17789. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  17790. Kubernetes meta/v1.LabelSelector
  17791. </a>
  17792. </em>
  17793. </td>
  17794. <td>
  17795. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  17796. </td>
  17797. </tr>
  17798. <tr>
  17799. <td>
  17800. <code>namespaceSelectors</code></br>
  17801. <em>
  17802. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  17803. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  17804. </a>
  17805. </em>
  17806. </td>
  17807. <td>
  17808. <em>(Optional)</em>
  17809. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  17810. </td>
  17811. </tr>
  17812. <tr>
  17813. <td>
  17814. <code>namespaces</code></br>
  17815. <em>
  17816. []string
  17817. </em>
  17818. </td>
  17819. <td>
  17820. <em>(Optional)</em>
  17821. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  17822. <p>Deprecated: Use NamespaceSelectors instead.</p>
  17823. </td>
  17824. </tr>
  17825. <tr>
  17826. <td>
  17827. <code>refreshTime</code></br>
  17828. <em>
  17829. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  17830. Kubernetes meta/v1.Duration
  17831. </a>
  17832. </em>
  17833. </td>
  17834. <td>
  17835. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  17836. </td>
  17837. </tr>
  17838. </table>
  17839. </td>
  17840. </tr>
  17841. <tr>
  17842. <td>
  17843. <code>status</code></br>
  17844. <em>
  17845. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">
  17846. ClusterExternalSecretStatus
  17847. </a>
  17848. </em>
  17849. </td>
  17850. <td>
  17851. </td>
  17852. </tr>
  17853. </tbody>
  17854. </table>
  17855. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  17856. (<code>string</code> alias)</p></h3>
  17857. <p>
  17858. (<em>Appears on:</em>
  17859. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  17860. </p>
  17861. <p>
  17862. <p>ClusterExternalSecretConditionType indicates the condition of the ClusterExternalSecret.</p>
  17863. </p>
  17864. <table>
  17865. <thead>
  17866. <tr>
  17867. <th>Value</th>
  17868. <th>Description</th>
  17869. </tr>
  17870. </thead>
  17871. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  17872. <td><p>ClusterExternalSecretReady indicates the ClusterExternalSecret resource is ready.</p>
  17873. </td>
  17874. </tr></tbody>
  17875. </table>
  17876. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  17877. </h3>
  17878. <p>
  17879. (<em>Appears on:</em>
  17880. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  17881. </p>
  17882. <p>
  17883. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  17884. </p>
  17885. <table>
  17886. <thead>
  17887. <tr>
  17888. <th>Field</th>
  17889. <th>Description</th>
  17890. </tr>
  17891. </thead>
  17892. <tbody>
  17893. <tr>
  17894. <td>
  17895. <code>namespace</code></br>
  17896. <em>
  17897. string
  17898. </em>
  17899. </td>
  17900. <td>
  17901. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  17902. </td>
  17903. </tr>
  17904. <tr>
  17905. <td>
  17906. <code>reason</code></br>
  17907. <em>
  17908. string
  17909. </em>
  17910. </td>
  17911. <td>
  17912. <em>(Optional)</em>
  17913. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  17914. </td>
  17915. </tr>
  17916. </tbody>
  17917. </table>
  17918. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  17919. </h3>
  17920. <p>
  17921. (<em>Appears on:</em>
  17922. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  17923. </p>
  17924. <p>
  17925. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  17926. </p>
  17927. <table>
  17928. <thead>
  17929. <tr>
  17930. <th>Field</th>
  17931. <th>Description</th>
  17932. </tr>
  17933. </thead>
  17934. <tbody>
  17935. <tr>
  17936. <td>
  17937. <code>externalSecretSpec</code></br>
  17938. <em>
  17939. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  17940. ExternalSecretSpec
  17941. </a>
  17942. </em>
  17943. </td>
  17944. <td>
  17945. <p>The spec for the ExternalSecrets to be created</p>
  17946. </td>
  17947. </tr>
  17948. <tr>
  17949. <td>
  17950. <code>externalSecretName</code></br>
  17951. <em>
  17952. string
  17953. </em>
  17954. </td>
  17955. <td>
  17956. <em>(Optional)</em>
  17957. <p>The name of the external secrets to be created.
  17958. Defaults to the name of the ClusterExternalSecret</p>
  17959. </td>
  17960. </tr>
  17961. <tr>
  17962. <td>
  17963. <code>externalSecretMetadata</code></br>
  17964. <em>
  17965. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  17966. ExternalSecretMetadata
  17967. </a>
  17968. </em>
  17969. </td>
  17970. <td>
  17971. <em>(Optional)</em>
  17972. <p>The metadata of the external secrets to be created</p>
  17973. </td>
  17974. </tr>
  17975. <tr>
  17976. <td>
  17977. <code>namespaceSelector</code></br>
  17978. <em>
  17979. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  17980. Kubernetes meta/v1.LabelSelector
  17981. </a>
  17982. </em>
  17983. </td>
  17984. <td>
  17985. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  17986. </td>
  17987. </tr>
  17988. <tr>
  17989. <td>
  17990. <code>namespaceSelectors</code></br>
  17991. <em>
  17992. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  17993. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  17994. </a>
  17995. </em>
  17996. </td>
  17997. <td>
  17998. <em>(Optional)</em>
  17999. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  18000. </td>
  18001. </tr>
  18002. <tr>
  18003. <td>
  18004. <code>namespaces</code></br>
  18005. <em>
  18006. []string
  18007. </em>
  18008. </td>
  18009. <td>
  18010. <em>(Optional)</em>
  18011. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  18012. <p>Deprecated: Use NamespaceSelectors instead.</p>
  18013. </td>
  18014. </tr>
  18015. <tr>
  18016. <td>
  18017. <code>refreshTime</code></br>
  18018. <em>
  18019. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  18020. Kubernetes meta/v1.Duration
  18021. </a>
  18022. </em>
  18023. </td>
  18024. <td>
  18025. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  18026. </td>
  18027. </tr>
  18028. </tbody>
  18029. </table>
  18030. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  18031. </h3>
  18032. <p>
  18033. (<em>Appears on:</em>
  18034. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  18035. </p>
  18036. <p>
  18037. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  18038. </p>
  18039. <table>
  18040. <thead>
  18041. <tr>
  18042. <th>Field</th>
  18043. <th>Description</th>
  18044. </tr>
  18045. </thead>
  18046. <tbody>
  18047. <tr>
  18048. <td>
  18049. <code>externalSecretName</code></br>
  18050. <em>
  18051. string
  18052. </em>
  18053. </td>
  18054. <td>
  18055. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  18056. </td>
  18057. </tr>
  18058. <tr>
  18059. <td>
  18060. <code>failedNamespaces</code></br>
  18061. <em>
  18062. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">
  18063. []ClusterExternalSecretNamespaceFailure
  18064. </a>
  18065. </em>
  18066. </td>
  18067. <td>
  18068. <em>(Optional)</em>
  18069. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  18070. </td>
  18071. </tr>
  18072. <tr>
  18073. <td>
  18074. <code>provisionedNamespaces</code></br>
  18075. <em>
  18076. []string
  18077. </em>
  18078. </td>
  18079. <td>
  18080. <em>(Optional)</em>
  18081. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  18082. </td>
  18083. </tr>
  18084. <tr>
  18085. <td>
  18086. <code>conditions</code></br>
  18087. <em>
  18088. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">
  18089. []ClusterExternalSecretStatusCondition
  18090. </a>
  18091. </em>
  18092. </td>
  18093. <td>
  18094. <em>(Optional)</em>
  18095. </td>
  18096. </tr>
  18097. </tbody>
  18098. </table>
  18099. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  18100. </h3>
  18101. <p>
  18102. (<em>Appears on:</em>
  18103. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  18104. </p>
  18105. <p>
  18106. <p>ClusterExternalSecretStatusCondition indicates the status of the ClusterExternalSecret.</p>
  18107. </p>
  18108. <table>
  18109. <thead>
  18110. <tr>
  18111. <th>Field</th>
  18112. <th>Description</th>
  18113. </tr>
  18114. </thead>
  18115. <tbody>
  18116. <tr>
  18117. <td>
  18118. <code>type</code></br>
  18119. <em>
  18120. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretConditionType">
  18121. ClusterExternalSecretConditionType
  18122. </a>
  18123. </em>
  18124. </td>
  18125. <td>
  18126. </td>
  18127. </tr>
  18128. <tr>
  18129. <td>
  18130. <code>status</code></br>
  18131. <em>
  18132. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  18133. Kubernetes core/v1.ConditionStatus
  18134. </a>
  18135. </em>
  18136. </td>
  18137. <td>
  18138. </td>
  18139. </tr>
  18140. <tr>
  18141. <td>
  18142. <code>message</code></br>
  18143. <em>
  18144. string
  18145. </em>
  18146. </td>
  18147. <td>
  18148. <em>(Optional)</em>
  18149. </td>
  18150. </tr>
  18151. </tbody>
  18152. </table>
  18153. <h3 id="external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore
  18154. </h3>
  18155. <p>
  18156. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  18157. </p>
  18158. <table>
  18159. <thead>
  18160. <tr>
  18161. <th>Field</th>
  18162. <th>Description</th>
  18163. </tr>
  18164. </thead>
  18165. <tbody>
  18166. <tr>
  18167. <td>
  18168. <code>metadata</code></br>
  18169. <em>
  18170. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  18171. Kubernetes meta/v1.ObjectMeta
  18172. </a>
  18173. </em>
  18174. </td>
  18175. <td>
  18176. Refer to the Kubernetes API documentation for the fields of the
  18177. <code>metadata</code> field.
  18178. </td>
  18179. </tr>
  18180. <tr>
  18181. <td>
  18182. <code>spec</code></br>
  18183. <em>
  18184. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  18185. SecretStoreSpec
  18186. </a>
  18187. </em>
  18188. </td>
  18189. <td>
  18190. <br/>
  18191. <br/>
  18192. <table>
  18193. <tr>
  18194. <td>
  18195. <code>controller</code></br>
  18196. <em>
  18197. string
  18198. </em>
  18199. </td>
  18200. <td>
  18201. <em>(Optional)</em>
  18202. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  18203. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  18204. </td>
  18205. </tr>
  18206. <tr>
  18207. <td>
  18208. <code>provider</code></br>
  18209. <em>
  18210. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  18211. SecretStoreProvider
  18212. </a>
  18213. </em>
  18214. </td>
  18215. <td>
  18216. <p>Used to configure the provider. Only one provider may be set</p>
  18217. </td>
  18218. </tr>
  18219. <tr>
  18220. <td>
  18221. <code>retrySettings</code></br>
  18222. <em>
  18223. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  18224. SecretStoreRetrySettings
  18225. </a>
  18226. </em>
  18227. </td>
  18228. <td>
  18229. <em>(Optional)</em>
  18230. <p>Used to configure HTTP retries on failures.</p>
  18231. </td>
  18232. </tr>
  18233. <tr>
  18234. <td>
  18235. <code>refreshInterval</code></br>
  18236. <em>
  18237. int
  18238. </em>
  18239. </td>
  18240. <td>
  18241. <em>(Optional)</em>
  18242. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  18243. </td>
  18244. </tr>
  18245. <tr>
  18246. <td>
  18247. <code>conditions</code></br>
  18248. <em>
  18249. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  18250. []ClusterSecretStoreCondition
  18251. </a>
  18252. </em>
  18253. </td>
  18254. <td>
  18255. <em>(Optional)</em>
  18256. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  18257. </td>
  18258. </tr>
  18259. </table>
  18260. </td>
  18261. </tr>
  18262. <tr>
  18263. <td>
  18264. <code>status</code></br>
  18265. <em>
  18266. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  18267. SecretStoreStatus
  18268. </a>
  18269. </em>
  18270. </td>
  18271. <td>
  18272. </td>
  18273. </tr>
  18274. </tbody>
  18275. </table>
  18276. <h3 id="external-secrets.io/v1beta1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  18277. </h3>
  18278. <p>
  18279. (<em>Appears on:</em>
  18280. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  18281. </p>
  18282. <p>
  18283. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  18284. for a ClusterSecretStore instance.</p>
  18285. </p>
  18286. <table>
  18287. <thead>
  18288. <tr>
  18289. <th>Field</th>
  18290. <th>Description</th>
  18291. </tr>
  18292. </thead>
  18293. <tbody>
  18294. <tr>
  18295. <td>
  18296. <code>namespaceSelector</code></br>
  18297. <em>
  18298. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  18299. Kubernetes meta/v1.LabelSelector
  18300. </a>
  18301. </em>
  18302. </td>
  18303. <td>
  18304. <em>(Optional)</em>
  18305. <p>Choose namespace using a labelSelector</p>
  18306. </td>
  18307. </tr>
  18308. <tr>
  18309. <td>
  18310. <code>namespaces</code></br>
  18311. <em>
  18312. []string
  18313. </em>
  18314. </td>
  18315. <td>
  18316. <em>(Optional)</em>
  18317. <p>Choose namespaces by name</p>
  18318. </td>
  18319. </tr>
  18320. <tr>
  18321. <td>
  18322. <code>namespaceRegexes</code></br>
  18323. <em>
  18324. []string
  18325. </em>
  18326. </td>
  18327. <td>
  18328. <em>(Optional)</em>
  18329. <p>Choose namespaces by using regex matching</p>
  18330. </td>
  18331. </tr>
  18332. </tbody>
  18333. </table>
  18334. <h3 id="external-secrets.io/v1beta1.ConjurAPIKey">ConjurAPIKey
  18335. </h3>
  18336. <p>
  18337. (<em>Appears on:</em>
  18338. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  18339. </p>
  18340. <p>
  18341. <p>ConjurAPIKey defines authentication using a Conjur API key.</p>
  18342. </p>
  18343. <table>
  18344. <thead>
  18345. <tr>
  18346. <th>Field</th>
  18347. <th>Description</th>
  18348. </tr>
  18349. </thead>
  18350. <tbody>
  18351. <tr>
  18352. <td>
  18353. <code>account</code></br>
  18354. <em>
  18355. string
  18356. </em>
  18357. </td>
  18358. <td>
  18359. <p>Account is the Conjur organization account name.</p>
  18360. </td>
  18361. </tr>
  18362. <tr>
  18363. <td>
  18364. <code>userRef</code></br>
  18365. <em>
  18366. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18367. External Secrets meta/v1.SecretKeySelector
  18368. </a>
  18369. </em>
  18370. </td>
  18371. <td>
  18372. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  18373. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  18374. </td>
  18375. </tr>
  18376. <tr>
  18377. <td>
  18378. <code>apiKeyRef</code></br>
  18379. <em>
  18380. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18381. External Secrets meta/v1.SecretKeySelector
  18382. </a>
  18383. </em>
  18384. </td>
  18385. <td>
  18386. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  18387. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  18388. </td>
  18389. </tr>
  18390. </tbody>
  18391. </table>
  18392. <h3 id="external-secrets.io/v1beta1.ConjurAuth">ConjurAuth
  18393. </h3>
  18394. <p>
  18395. (<em>Appears on:</em>
  18396. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>)
  18397. </p>
  18398. <p>
  18399. <p>ConjurAuth defines the methods of authentication with Conjur.</p>
  18400. </p>
  18401. <table>
  18402. <thead>
  18403. <tr>
  18404. <th>Field</th>
  18405. <th>Description</th>
  18406. </tr>
  18407. </thead>
  18408. <tbody>
  18409. <tr>
  18410. <td>
  18411. <code>apikey</code></br>
  18412. <em>
  18413. <a href="#external-secrets.io/v1beta1.ConjurAPIKey">
  18414. ConjurAPIKey
  18415. </a>
  18416. </em>
  18417. </td>
  18418. <td>
  18419. <em>(Optional)</em>
  18420. <p>Authenticates with Conjur using an API key.</p>
  18421. </td>
  18422. </tr>
  18423. <tr>
  18424. <td>
  18425. <code>jwt</code></br>
  18426. <em>
  18427. <a href="#external-secrets.io/v1beta1.ConjurJWT">
  18428. ConjurJWT
  18429. </a>
  18430. </em>
  18431. </td>
  18432. <td>
  18433. <em>(Optional)</em>
  18434. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  18435. </td>
  18436. </tr>
  18437. </tbody>
  18438. </table>
  18439. <h3 id="external-secrets.io/v1beta1.ConjurJWT">ConjurJWT
  18440. </h3>
  18441. <p>
  18442. (<em>Appears on:</em>
  18443. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  18444. </p>
  18445. <p>
  18446. <p>ConjurJWT defines authentication using a JWT service account token.</p>
  18447. </p>
  18448. <table>
  18449. <thead>
  18450. <tr>
  18451. <th>Field</th>
  18452. <th>Description</th>
  18453. </tr>
  18454. </thead>
  18455. <tbody>
  18456. <tr>
  18457. <td>
  18458. <code>account</code></br>
  18459. <em>
  18460. string
  18461. </em>
  18462. </td>
  18463. <td>
  18464. <p>Account is the Conjur organization account name.</p>
  18465. </td>
  18466. </tr>
  18467. <tr>
  18468. <td>
  18469. <code>serviceID</code></br>
  18470. <em>
  18471. string
  18472. </em>
  18473. </td>
  18474. <td>
  18475. <p>The conjur authn jwt webservice id</p>
  18476. </td>
  18477. </tr>
  18478. <tr>
  18479. <td>
  18480. <code>hostId</code></br>
  18481. <em>
  18482. string
  18483. </em>
  18484. </td>
  18485. <td>
  18486. <em>(Optional)</em>
  18487. <p>Optional HostID for JWT authentication. This may be used depending
  18488. on how the Conjur JWT authenticator policy is configured.</p>
  18489. </td>
  18490. </tr>
  18491. <tr>
  18492. <td>
  18493. <code>secretRef</code></br>
  18494. <em>
  18495. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18496. External Secrets meta/v1.SecretKeySelector
  18497. </a>
  18498. </em>
  18499. </td>
  18500. <td>
  18501. <em>(Optional)</em>
  18502. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  18503. authenticate with Conjur using the JWT authentication method.</p>
  18504. </td>
  18505. </tr>
  18506. <tr>
  18507. <td>
  18508. <code>serviceAccountRef</code></br>
  18509. <em>
  18510. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  18511. External Secrets meta/v1.ServiceAccountSelector
  18512. </a>
  18513. </em>
  18514. </td>
  18515. <td>
  18516. <em>(Optional)</em>
  18517. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  18518. a token for with the <code>TokenRequest</code> API.</p>
  18519. </td>
  18520. </tr>
  18521. </tbody>
  18522. </table>
  18523. <h3 id="external-secrets.io/v1beta1.ConjurProvider">ConjurProvider
  18524. </h3>
  18525. <p>
  18526. (<em>Appears on:</em>
  18527. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18528. </p>
  18529. <p>
  18530. <p>ConjurProvider defines configuration for the CyberArk Conjur provider.</p>
  18531. </p>
  18532. <table>
  18533. <thead>
  18534. <tr>
  18535. <th>Field</th>
  18536. <th>Description</th>
  18537. </tr>
  18538. </thead>
  18539. <tbody>
  18540. <tr>
  18541. <td>
  18542. <code>url</code></br>
  18543. <em>
  18544. string
  18545. </em>
  18546. </td>
  18547. <td>
  18548. <p>URL is the endpoint of the Conjur instance.</p>
  18549. </td>
  18550. </tr>
  18551. <tr>
  18552. <td>
  18553. <code>caBundle</code></br>
  18554. <em>
  18555. string
  18556. </em>
  18557. </td>
  18558. <td>
  18559. <em>(Optional)</em>
  18560. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  18561. </td>
  18562. </tr>
  18563. <tr>
  18564. <td>
  18565. <code>caProvider</code></br>
  18566. <em>
  18567. <a href="#external-secrets.io/v1beta1.CAProvider">
  18568. CAProvider
  18569. </a>
  18570. </em>
  18571. </td>
  18572. <td>
  18573. <em>(Optional)</em>
  18574. <p>Used to provide custom certificate authority (CA) certificates
  18575. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  18576. that contains a PEM-encoded certificate.</p>
  18577. </td>
  18578. </tr>
  18579. <tr>
  18580. <td>
  18581. <code>auth</code></br>
  18582. <em>
  18583. <a href="#external-secrets.io/v1beta1.ConjurAuth">
  18584. ConjurAuth
  18585. </a>
  18586. </em>
  18587. </td>
  18588. <td>
  18589. <p>Defines authentication settings for connecting to Conjur.</p>
  18590. </td>
  18591. </tr>
  18592. </tbody>
  18593. </table>
  18594. <h3 id="external-secrets.io/v1beta1.DelineaProvider">DelineaProvider
  18595. </h3>
  18596. <p>
  18597. (<em>Appears on:</em>
  18598. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18599. </p>
  18600. <p>
  18601. <p>DelineaProvider defines configuration for the Delinea DevOps Secrets Vault provider.
  18602. 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>
  18603. </p>
  18604. <table>
  18605. <thead>
  18606. <tr>
  18607. <th>Field</th>
  18608. <th>Description</th>
  18609. </tr>
  18610. </thead>
  18611. <tbody>
  18612. <tr>
  18613. <td>
  18614. <code>clientId</code></br>
  18615. <em>
  18616. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  18617. DelineaProviderSecretRef
  18618. </a>
  18619. </em>
  18620. </td>
  18621. <td>
  18622. <p>ClientID is the non-secret part of the credential.</p>
  18623. </td>
  18624. </tr>
  18625. <tr>
  18626. <td>
  18627. <code>clientSecret</code></br>
  18628. <em>
  18629. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  18630. DelineaProviderSecretRef
  18631. </a>
  18632. </em>
  18633. </td>
  18634. <td>
  18635. <p>ClientSecret is the secret part of the credential.</p>
  18636. </td>
  18637. </tr>
  18638. <tr>
  18639. <td>
  18640. <code>tenant</code></br>
  18641. <em>
  18642. string
  18643. </em>
  18644. </td>
  18645. <td>
  18646. <p>Tenant is the chosen hostname / site name.</p>
  18647. </td>
  18648. </tr>
  18649. <tr>
  18650. <td>
  18651. <code>urlTemplate</code></br>
  18652. <em>
  18653. string
  18654. </em>
  18655. </td>
  18656. <td>
  18657. <em>(Optional)</em>
  18658. <p>URLTemplate
  18659. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  18660. </td>
  18661. </tr>
  18662. <tr>
  18663. <td>
  18664. <code>tld</code></br>
  18665. <em>
  18666. string
  18667. </em>
  18668. </td>
  18669. <td>
  18670. <em>(Optional)</em>
  18671. <p>TLD is based on the server location that was chosen during provisioning.
  18672. If unset, defaults to &ldquo;com&rdquo;.</p>
  18673. </td>
  18674. </tr>
  18675. </tbody>
  18676. </table>
  18677. <h3 id="external-secrets.io/v1beta1.DelineaProviderSecretRef">DelineaProviderSecretRef
  18678. </h3>
  18679. <p>
  18680. (<em>Appears on:</em>
  18681. <a href="#external-secrets.io/v1beta1.DelineaProvider">DelineaProvider</a>)
  18682. </p>
  18683. <p>
  18684. <p>DelineaProviderSecretRef defines a reference to a secret containing credentials for the Delinea provider.</p>
  18685. </p>
  18686. <table>
  18687. <thead>
  18688. <tr>
  18689. <th>Field</th>
  18690. <th>Description</th>
  18691. </tr>
  18692. </thead>
  18693. <tbody>
  18694. <tr>
  18695. <td>
  18696. <code>value</code></br>
  18697. <em>
  18698. string
  18699. </em>
  18700. </td>
  18701. <td>
  18702. <em>(Optional)</em>
  18703. <p>Value can be specified directly to set a value without using a secret.</p>
  18704. </td>
  18705. </tr>
  18706. <tr>
  18707. <td>
  18708. <code>secretRef</code></br>
  18709. <em>
  18710. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18711. External Secrets meta/v1.SecretKeySelector
  18712. </a>
  18713. </em>
  18714. </td>
  18715. <td>
  18716. <em>(Optional)</em>
  18717. <p>SecretRef references a key in a secret that will be used as value.</p>
  18718. </td>
  18719. </tr>
  18720. </tbody>
  18721. </table>
  18722. <h3 id="external-secrets.io/v1beta1.Device42Auth">Device42Auth
  18723. </h3>
  18724. <p>
  18725. (<em>Appears on:</em>
  18726. <a href="#external-secrets.io/v1beta1.Device42Provider">Device42Provider</a>)
  18727. </p>
  18728. <p>
  18729. <p>Device42Auth defines the authentication method for the Device42 provider.</p>
  18730. </p>
  18731. <table>
  18732. <thead>
  18733. <tr>
  18734. <th>Field</th>
  18735. <th>Description</th>
  18736. </tr>
  18737. </thead>
  18738. <tbody>
  18739. <tr>
  18740. <td>
  18741. <code>secretRef</code></br>
  18742. <em>
  18743. <a href="#external-secrets.io/v1beta1.Device42SecretRef">
  18744. Device42SecretRef
  18745. </a>
  18746. </em>
  18747. </td>
  18748. <td>
  18749. </td>
  18750. </tr>
  18751. </tbody>
  18752. </table>
  18753. <h3 id="external-secrets.io/v1beta1.Device42Provider">Device42Provider
  18754. </h3>
  18755. <p>
  18756. (<em>Appears on:</em>
  18757. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18758. </p>
  18759. <p>
  18760. <p>Device42Provider configures a store to sync secrets with a Device42 instance.</p>
  18761. </p>
  18762. <table>
  18763. <thead>
  18764. <tr>
  18765. <th>Field</th>
  18766. <th>Description</th>
  18767. </tr>
  18768. </thead>
  18769. <tbody>
  18770. <tr>
  18771. <td>
  18772. <code>host</code></br>
  18773. <em>
  18774. string
  18775. </em>
  18776. </td>
  18777. <td>
  18778. <p>URL configures the Device42 instance URL.</p>
  18779. </td>
  18780. </tr>
  18781. <tr>
  18782. <td>
  18783. <code>auth</code></br>
  18784. <em>
  18785. <a href="#external-secrets.io/v1beta1.Device42Auth">
  18786. Device42Auth
  18787. </a>
  18788. </em>
  18789. </td>
  18790. <td>
  18791. <p>Auth configures how secret-manager authenticates with a Device42 instance.</p>
  18792. </td>
  18793. </tr>
  18794. </tbody>
  18795. </table>
  18796. <h3 id="external-secrets.io/v1beta1.Device42SecretRef">Device42SecretRef
  18797. </h3>
  18798. <p>
  18799. (<em>Appears on:</em>
  18800. <a href="#external-secrets.io/v1beta1.Device42Auth">Device42Auth</a>)
  18801. </p>
  18802. <p>
  18803. <p>Device42SecretRef defines a reference to a secret containing credentials for the Device42 provider.</p>
  18804. </p>
  18805. <table>
  18806. <thead>
  18807. <tr>
  18808. <th>Field</th>
  18809. <th>Description</th>
  18810. </tr>
  18811. </thead>
  18812. <tbody>
  18813. <tr>
  18814. <td>
  18815. <code>credentials</code></br>
  18816. <em>
  18817. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18818. External Secrets meta/v1.SecretKeySelector
  18819. </a>
  18820. </em>
  18821. </td>
  18822. <td>
  18823. <em>(Optional)</em>
  18824. <p>Username / Password is used for authentication.</p>
  18825. </td>
  18826. </tr>
  18827. </tbody>
  18828. </table>
  18829. <h3 id="external-secrets.io/v1beta1.DopplerAuth">DopplerAuth
  18830. </h3>
  18831. <p>
  18832. (<em>Appears on:</em>
  18833. <a href="#external-secrets.io/v1beta1.DopplerProvider">DopplerProvider</a>)
  18834. </p>
  18835. <p>
  18836. <p>DopplerAuth defines the authentication method for the Doppler provider.</p>
  18837. </p>
  18838. <table>
  18839. <thead>
  18840. <tr>
  18841. <th>Field</th>
  18842. <th>Description</th>
  18843. </tr>
  18844. </thead>
  18845. <tbody>
  18846. <tr>
  18847. <td>
  18848. <code>secretRef</code></br>
  18849. <em>
  18850. <a href="#external-secrets.io/v1beta1.DopplerAuthSecretRef">
  18851. DopplerAuthSecretRef
  18852. </a>
  18853. </em>
  18854. </td>
  18855. <td>
  18856. </td>
  18857. </tr>
  18858. </tbody>
  18859. </table>
  18860. <h3 id="external-secrets.io/v1beta1.DopplerAuthSecretRef">DopplerAuthSecretRef
  18861. </h3>
  18862. <p>
  18863. (<em>Appears on:</em>
  18864. <a href="#external-secrets.io/v1beta1.DopplerAuth">DopplerAuth</a>)
  18865. </p>
  18866. <p>
  18867. <p>DopplerAuthSecretRef defines a reference to a secret containing credentials for the Doppler provider.</p>
  18868. </p>
  18869. <table>
  18870. <thead>
  18871. <tr>
  18872. <th>Field</th>
  18873. <th>Description</th>
  18874. </tr>
  18875. </thead>
  18876. <tbody>
  18877. <tr>
  18878. <td>
  18879. <code>dopplerToken</code></br>
  18880. <em>
  18881. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18882. External Secrets meta/v1.SecretKeySelector
  18883. </a>
  18884. </em>
  18885. </td>
  18886. <td>
  18887. <p>The DopplerToken is used for authentication.
  18888. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  18889. The Key attribute defaults to dopplerToken if not specified.</p>
  18890. </td>
  18891. </tr>
  18892. </tbody>
  18893. </table>
  18894. <h3 id="external-secrets.io/v1beta1.DopplerProvider">DopplerProvider
  18895. </h3>
  18896. <p>
  18897. (<em>Appears on:</em>
  18898. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18899. </p>
  18900. <p>
  18901. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  18902. Project and Config are required if not using a Service Token.</p>
  18903. </p>
  18904. <table>
  18905. <thead>
  18906. <tr>
  18907. <th>Field</th>
  18908. <th>Description</th>
  18909. </tr>
  18910. </thead>
  18911. <tbody>
  18912. <tr>
  18913. <td>
  18914. <code>auth</code></br>
  18915. <em>
  18916. <a href="#external-secrets.io/v1beta1.DopplerAuth">
  18917. DopplerAuth
  18918. </a>
  18919. </em>
  18920. </td>
  18921. <td>
  18922. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  18923. </td>
  18924. </tr>
  18925. <tr>
  18926. <td>
  18927. <code>project</code></br>
  18928. <em>
  18929. string
  18930. </em>
  18931. </td>
  18932. <td>
  18933. <em>(Optional)</em>
  18934. <p>Doppler project (required if not using a Service Token)</p>
  18935. </td>
  18936. </tr>
  18937. <tr>
  18938. <td>
  18939. <code>config</code></br>
  18940. <em>
  18941. string
  18942. </em>
  18943. </td>
  18944. <td>
  18945. <em>(Optional)</em>
  18946. <p>Doppler config (required if not using a Service Token)</p>
  18947. </td>
  18948. </tr>
  18949. <tr>
  18950. <td>
  18951. <code>nameTransformer</code></br>
  18952. <em>
  18953. string
  18954. </em>
  18955. </td>
  18956. <td>
  18957. <em>(Optional)</em>
  18958. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  18959. </td>
  18960. </tr>
  18961. <tr>
  18962. <td>
  18963. <code>format</code></br>
  18964. <em>
  18965. string
  18966. </em>
  18967. </td>
  18968. <td>
  18969. <em>(Optional)</em>
  18970. <p>Format enables the downloading of secrets as a file (string)</p>
  18971. </td>
  18972. </tr>
  18973. </tbody>
  18974. </table>
  18975. <h3 id="external-secrets.io/v1beta1.ExternalSecret">ExternalSecret
  18976. </h3>
  18977. <p>
  18978. <p>ExternalSecret is the schema for the external-secrets API.</p>
  18979. </p>
  18980. <table>
  18981. <thead>
  18982. <tr>
  18983. <th>Field</th>
  18984. <th>Description</th>
  18985. </tr>
  18986. </thead>
  18987. <tbody>
  18988. <tr>
  18989. <td>
  18990. <code>metadata</code></br>
  18991. <em>
  18992. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  18993. Kubernetes meta/v1.ObjectMeta
  18994. </a>
  18995. </em>
  18996. </td>
  18997. <td>
  18998. Refer to the Kubernetes API documentation for the fields of the
  18999. <code>metadata</code> field.
  19000. </td>
  19001. </tr>
  19002. <tr>
  19003. <td>
  19004. <code>spec</code></br>
  19005. <em>
  19006. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  19007. ExternalSecretSpec
  19008. </a>
  19009. </em>
  19010. </td>
  19011. <td>
  19012. <br/>
  19013. <br/>
  19014. <table>
  19015. <tr>
  19016. <td>
  19017. <code>secretStoreRef</code></br>
  19018. <em>
  19019. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  19020. SecretStoreRef
  19021. </a>
  19022. </em>
  19023. </td>
  19024. <td>
  19025. <em>(Optional)</em>
  19026. </td>
  19027. </tr>
  19028. <tr>
  19029. <td>
  19030. <code>target</code></br>
  19031. <em>
  19032. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  19033. ExternalSecretTarget
  19034. </a>
  19035. </em>
  19036. </td>
  19037. <td>
  19038. <em>(Optional)</em>
  19039. </td>
  19040. </tr>
  19041. <tr>
  19042. <td>
  19043. <code>refreshPolicy</code></br>
  19044. <em>
  19045. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  19046. ExternalSecretRefreshPolicy
  19047. </a>
  19048. </em>
  19049. </td>
  19050. <td>
  19051. <em>(Optional)</em>
  19052. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  19053. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  19054. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  19055. No periodic updates occur if refreshInterval is 0.
  19056. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  19057. </td>
  19058. </tr>
  19059. <tr>
  19060. <td>
  19061. <code>refreshInterval</code></br>
  19062. <em>
  19063. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  19064. Kubernetes meta/v1.Duration
  19065. </a>
  19066. </em>
  19067. </td>
  19068. <td>
  19069. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  19070. specified as Golang Duration strings.
  19071. 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;
  19072. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  19073. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  19074. </td>
  19075. </tr>
  19076. <tr>
  19077. <td>
  19078. <code>data</code></br>
  19079. <em>
  19080. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  19081. []ExternalSecretData
  19082. </a>
  19083. </em>
  19084. </td>
  19085. <td>
  19086. <em>(Optional)</em>
  19087. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  19088. </td>
  19089. </tr>
  19090. <tr>
  19091. <td>
  19092. <code>dataFrom</code></br>
  19093. <em>
  19094. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  19095. []ExternalSecretDataFromRemoteRef
  19096. </a>
  19097. </em>
  19098. </td>
  19099. <td>
  19100. <em>(Optional)</em>
  19101. <p>DataFrom is used to fetch all properties from a specific Provider data
  19102. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  19103. </td>
  19104. </tr>
  19105. </table>
  19106. </td>
  19107. </tr>
  19108. <tr>
  19109. <td>
  19110. <code>status</code></br>
  19111. <em>
  19112. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">
  19113. ExternalSecretStatus
  19114. </a>
  19115. </em>
  19116. </td>
  19117. <td>
  19118. </td>
  19119. </tr>
  19120. </tbody>
  19121. </table>
  19122. <h3 id="external-secrets.io/v1beta1.ExternalSecretConditionType">ExternalSecretConditionType
  19123. (<code>string</code> alias)</p></h3>
  19124. <p>
  19125. (<em>Appears on:</em>
  19126. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  19127. </p>
  19128. <p>
  19129. <p>ExternalSecretConditionType defines the condition type for an ExternalSecret.</p>
  19130. </p>
  19131. <table>
  19132. <thead>
  19133. <tr>
  19134. <th>Value</th>
  19135. <th>Description</th>
  19136. </tr>
  19137. </thead>
  19138. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  19139. <td><p>ExternalSecretDeleted indicates the ExternalSecret has been deleted.</p>
  19140. </td>
  19141. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  19142. <td><p>ExternalSecretReady indicates the ExternalSecret has been successfully reconciled.</p>
  19143. </td>
  19144. </tr></tbody>
  19145. </table>
  19146. <h3 id="external-secrets.io/v1beta1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  19147. (<code>string</code> alias)</p></h3>
  19148. <p>
  19149. (<em>Appears on:</em>
  19150. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  19151. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  19152. </p>
  19153. <p>
  19154. <p>ExternalSecretConversionStrategy defines how secret values are converted.</p>
  19155. </p>
  19156. <table>
  19157. <thead>
  19158. <tr>
  19159. <th>Value</th>
  19160. <th>Description</th>
  19161. </tr>
  19162. </thead>
  19163. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  19164. <td><p>ExternalSecretConversionDefault indicates the default conversion strategy.</p>
  19165. </td>
  19166. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  19167. <td><p>ExternalSecretConversionUnicode indicates that unicode conversion will be performed.</p>
  19168. </td>
  19169. </tr></tbody>
  19170. </table>
  19171. <h3 id="external-secrets.io/v1beta1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  19172. (<code>string</code> alias)</p></h3>
  19173. <p>
  19174. (<em>Appears on:</em>
  19175. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  19176. </p>
  19177. <p>
  19178. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  19179. </p>
  19180. <table>
  19181. <thead>
  19182. <tr>
  19183. <th>Value</th>
  19184. <th>Description</th>
  19185. </tr>
  19186. </thead>
  19187. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  19188. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  19189. </td>
  19190. </tr><tr><td><p>&#34;None&#34;</p></td>
  19191. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  19192. </td>
  19193. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  19194. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  19195. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  19196. </td>
  19197. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  19198. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  19199. </td>
  19200. </tr></tbody>
  19201. </table>
  19202. <h3 id="external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData
  19203. </h3>
  19204. <p>
  19205. (<em>Appears on:</em>
  19206. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  19207. </p>
  19208. <p>
  19209. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  19210. </p>
  19211. <table>
  19212. <thead>
  19213. <tr>
  19214. <th>Field</th>
  19215. <th>Description</th>
  19216. </tr>
  19217. </thead>
  19218. <tbody>
  19219. <tr>
  19220. <td>
  19221. <code>secretKey</code></br>
  19222. <em>
  19223. string
  19224. </em>
  19225. </td>
  19226. <td>
  19227. <p>The key in the Kubernetes Secret to store the value.</p>
  19228. </td>
  19229. </tr>
  19230. <tr>
  19231. <td>
  19232. <code>remoteRef</code></br>
  19233. <em>
  19234. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  19235. ExternalSecretDataRemoteRef
  19236. </a>
  19237. </em>
  19238. </td>
  19239. <td>
  19240. <p>RemoteRef points to the remote secret and defines
  19241. which secret (version/property/..) to fetch.</p>
  19242. </td>
  19243. </tr>
  19244. <tr>
  19245. <td>
  19246. <code>sourceRef</code></br>
  19247. <em>
  19248. <a href="#external-secrets.io/v1beta1.StoreSourceRef">
  19249. StoreSourceRef
  19250. </a>
  19251. </em>
  19252. </td>
  19253. <td>
  19254. <p>SourceRef allows you to override the source
  19255. from which the value will be pulled.</p>
  19256. </td>
  19257. </tr>
  19258. </tbody>
  19259. </table>
  19260. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  19261. </h3>
  19262. <p>
  19263. (<em>Appears on:</em>
  19264. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  19265. </p>
  19266. <p>
  19267. <p>ExternalSecretDataFromRemoteRef defines a reference to multiple secrets in the provider to be fetched using options.</p>
  19268. </p>
  19269. <table>
  19270. <thead>
  19271. <tr>
  19272. <th>Field</th>
  19273. <th>Description</th>
  19274. </tr>
  19275. </thead>
  19276. <tbody>
  19277. <tr>
  19278. <td>
  19279. <code>extract</code></br>
  19280. <em>
  19281. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  19282. ExternalSecretDataRemoteRef
  19283. </a>
  19284. </em>
  19285. </td>
  19286. <td>
  19287. <em>(Optional)</em>
  19288. <p>Used to extract multiple key/value pairs from one secret
  19289. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  19290. </td>
  19291. </tr>
  19292. <tr>
  19293. <td>
  19294. <code>find</code></br>
  19295. <em>
  19296. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">
  19297. ExternalSecretFind
  19298. </a>
  19299. </em>
  19300. </td>
  19301. <td>
  19302. <em>(Optional)</em>
  19303. <p>Used to find secrets based on tags or regular expressions
  19304. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  19305. </td>
  19306. </tr>
  19307. <tr>
  19308. <td>
  19309. <code>rewrite</code></br>
  19310. <em>
  19311. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">
  19312. []ExternalSecretRewrite
  19313. </a>
  19314. </em>
  19315. </td>
  19316. <td>
  19317. <em>(Optional)</em>
  19318. <p>Used to rewrite secret Keys after getting them from the secret Provider
  19319. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  19320. </td>
  19321. </tr>
  19322. <tr>
  19323. <td>
  19324. <code>sourceRef</code></br>
  19325. <em>
  19326. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">
  19327. StoreGeneratorSourceRef
  19328. </a>
  19329. </em>
  19330. </td>
  19331. <td>
  19332. <p>SourceRef points to a store or generator
  19333. which contains secret values ready to use.
  19334. Use this in combination with Extract or Find pull values out of
  19335. a specific SecretStore.
  19336. When sourceRef points to a generator Extract or Find is not supported.
  19337. The generator returns a static map of values</p>
  19338. </td>
  19339. </tr>
  19340. </tbody>
  19341. </table>
  19342. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  19343. </h3>
  19344. <p>
  19345. (<em>Appears on:</em>
  19346. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>,
  19347. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  19348. </p>
  19349. <p>
  19350. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  19351. </p>
  19352. <table>
  19353. <thead>
  19354. <tr>
  19355. <th>Field</th>
  19356. <th>Description</th>
  19357. </tr>
  19358. </thead>
  19359. <tbody>
  19360. <tr>
  19361. <td>
  19362. <code>key</code></br>
  19363. <em>
  19364. string
  19365. </em>
  19366. </td>
  19367. <td>
  19368. <p>Key is the key used in the Provider, mandatory</p>
  19369. </td>
  19370. </tr>
  19371. <tr>
  19372. <td>
  19373. <code>metadataPolicy</code></br>
  19374. <em>
  19375. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">
  19376. ExternalSecretMetadataPolicy
  19377. </a>
  19378. </em>
  19379. </td>
  19380. <td>
  19381. <em>(Optional)</em>
  19382. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  19383. </td>
  19384. </tr>
  19385. <tr>
  19386. <td>
  19387. <code>property</code></br>
  19388. <em>
  19389. string
  19390. </em>
  19391. </td>
  19392. <td>
  19393. <em>(Optional)</em>
  19394. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  19395. </td>
  19396. </tr>
  19397. <tr>
  19398. <td>
  19399. <code>version</code></br>
  19400. <em>
  19401. string
  19402. </em>
  19403. </td>
  19404. <td>
  19405. <em>(Optional)</em>
  19406. <p>Used to select a specific version of the Provider value, if supported</p>
  19407. </td>
  19408. </tr>
  19409. <tr>
  19410. <td>
  19411. <code>conversionStrategy</code></br>
  19412. <em>
  19413. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  19414. ExternalSecretConversionStrategy
  19415. </a>
  19416. </em>
  19417. </td>
  19418. <td>
  19419. <em>(Optional)</em>
  19420. <p>Used to define a conversion Strategy</p>
  19421. </td>
  19422. </tr>
  19423. <tr>
  19424. <td>
  19425. <code>decodingStrategy</code></br>
  19426. <em>
  19427. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  19428. ExternalSecretDecodingStrategy
  19429. </a>
  19430. </em>
  19431. </td>
  19432. <td>
  19433. <em>(Optional)</em>
  19434. <p>Used to define a decoding Strategy</p>
  19435. </td>
  19436. </tr>
  19437. </tbody>
  19438. </table>
  19439. <h3 id="external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  19440. (<code>string</code> alias)</p></h3>
  19441. <p>
  19442. (<em>Appears on:</em>
  19443. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  19444. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  19445. </p>
  19446. <p>
  19447. <p>ExternalSecretDecodingStrategy defines how secret values are decoded.</p>
  19448. </p>
  19449. <table>
  19450. <thead>
  19451. <tr>
  19452. <th>Value</th>
  19453. <th>Description</th>
  19454. </tr>
  19455. </thead>
  19456. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  19457. <td><p>ExternalSecretDecodeAuto indicates that the decoding strategy will be automatically determined.</p>
  19458. </td>
  19459. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  19460. <td><p>ExternalSecretDecodeBase64 indicates that base64 decoding will be used.</p>
  19461. </td>
  19462. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  19463. <td><p>ExternalSecretDecodeBase64URL indicates that base64url decoding will be used.</p>
  19464. </td>
  19465. </tr><tr><td><p>&#34;None&#34;</p></td>
  19466. <td><p>ExternalSecretDecodeNone indicates that no decoding will be performed.</p>
  19467. </td>
  19468. </tr></tbody>
  19469. </table>
  19470. <h3 id="external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  19471. (<code>string</code> alias)</p></h3>
  19472. <p>
  19473. (<em>Appears on:</em>
  19474. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  19475. </p>
  19476. <p>
  19477. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  19478. </p>
  19479. <table>
  19480. <thead>
  19481. <tr>
  19482. <th>Value</th>
  19483. <th>Description</th>
  19484. </tr>
  19485. </thead>
  19486. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  19487. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  19488. If a secret gets deleted on the provider side and is not accessible
  19489. anymore this is not considered an error and the ExternalSecret
  19490. does not go into SecretSyncedError status.</p>
  19491. </td>
  19492. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  19493. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  19494. If a secret gets deleted on the provider side and is not accessible
  19495. anymore this is not considered an error and the ExternalSecret
  19496. does not go into SecretSyncedError status.</p>
  19497. </td>
  19498. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  19499. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  19500. If a provider secret does not exist the ExternalSecret gets into the
  19501. SecretSyncedError status.</p>
  19502. </td>
  19503. </tr></tbody>
  19504. </table>
  19505. <h3 id="external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind
  19506. </h3>
  19507. <p>
  19508. (<em>Appears on:</em>
  19509. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  19510. </p>
  19511. <p>
  19512. <p>ExternalSecretFind defines criteria for finding secrets in the provider.</p>
  19513. </p>
  19514. <table>
  19515. <thead>
  19516. <tr>
  19517. <th>Field</th>
  19518. <th>Description</th>
  19519. </tr>
  19520. </thead>
  19521. <tbody>
  19522. <tr>
  19523. <td>
  19524. <code>path</code></br>
  19525. <em>
  19526. string
  19527. </em>
  19528. </td>
  19529. <td>
  19530. <em>(Optional)</em>
  19531. <p>A root path to start the find operations.</p>
  19532. </td>
  19533. </tr>
  19534. <tr>
  19535. <td>
  19536. <code>name</code></br>
  19537. <em>
  19538. <a href="#external-secrets.io/v1beta1.FindName">
  19539. FindName
  19540. </a>
  19541. </em>
  19542. </td>
  19543. <td>
  19544. <em>(Optional)</em>
  19545. <p>Finds secrets based on the name.</p>
  19546. </td>
  19547. </tr>
  19548. <tr>
  19549. <td>
  19550. <code>tags</code></br>
  19551. <em>
  19552. map[string]string
  19553. </em>
  19554. </td>
  19555. <td>
  19556. <em>(Optional)</em>
  19557. <p>Find secrets based on tags.</p>
  19558. </td>
  19559. </tr>
  19560. <tr>
  19561. <td>
  19562. <code>conversionStrategy</code></br>
  19563. <em>
  19564. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  19565. ExternalSecretConversionStrategy
  19566. </a>
  19567. </em>
  19568. </td>
  19569. <td>
  19570. <em>(Optional)</em>
  19571. <p>Used to define a conversion Strategy</p>
  19572. </td>
  19573. </tr>
  19574. <tr>
  19575. <td>
  19576. <code>decodingStrategy</code></br>
  19577. <em>
  19578. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  19579. ExternalSecretDecodingStrategy
  19580. </a>
  19581. </em>
  19582. </td>
  19583. <td>
  19584. <em>(Optional)</em>
  19585. <p>Used to define a decoding Strategy</p>
  19586. </td>
  19587. </tr>
  19588. </tbody>
  19589. </table>
  19590. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadata">ExternalSecretMetadata
  19591. </h3>
  19592. <p>
  19593. (<em>Appears on:</em>
  19594. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  19595. </p>
  19596. <p>
  19597. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  19598. </p>
  19599. <table>
  19600. <thead>
  19601. <tr>
  19602. <th>Field</th>
  19603. <th>Description</th>
  19604. </tr>
  19605. </thead>
  19606. <tbody>
  19607. <tr>
  19608. <td>
  19609. <code>annotations</code></br>
  19610. <em>
  19611. map[string]string
  19612. </em>
  19613. </td>
  19614. <td>
  19615. <em>(Optional)</em>
  19616. </td>
  19617. </tr>
  19618. <tr>
  19619. <td>
  19620. <code>labels</code></br>
  19621. <em>
  19622. map[string]string
  19623. </em>
  19624. </td>
  19625. <td>
  19626. <em>(Optional)</em>
  19627. </td>
  19628. </tr>
  19629. </tbody>
  19630. </table>
  19631. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  19632. (<code>string</code> alias)</p></h3>
  19633. <p>
  19634. (<em>Appears on:</em>
  19635. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  19636. </p>
  19637. <p>
  19638. <p>ExternalSecretMetadataPolicy defines the policy for fetching tags/labels from provider secrets.</p>
  19639. </p>
  19640. <table>
  19641. <thead>
  19642. <tr>
  19643. <th>Value</th>
  19644. <th>Description</th>
  19645. </tr>
  19646. </thead>
  19647. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  19648. <td><p>ExternalSecretMetadataPolicyFetch indicates that metadata will be fetched from the provider.</p>
  19649. </td>
  19650. </tr><tr><td><p>&#34;None&#34;</p></td>
  19651. <td><p>ExternalSecretMetadataPolicyNone indicates that no metadata will be fetched.</p>
  19652. </td>
  19653. </tr></tbody>
  19654. </table>
  19655. <h3 id="external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  19656. (<code>string</code> alias)</p></h3>
  19657. <p>
  19658. (<em>Appears on:</em>
  19659. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  19660. </p>
  19661. <p>
  19662. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  19663. </p>
  19664. <table>
  19665. <thead>
  19666. <tr>
  19667. <th>Value</th>
  19668. <th>Description</th>
  19669. </tr>
  19670. </thead>
  19671. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  19672. <td><p>RefreshPolicyCreatedOnce creates the Secret only if it does not exist and does not update it thereafter.</p>
  19673. </td>
  19674. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  19675. <td><p>RefreshPolicyOnChange only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes.</p>
  19676. </td>
  19677. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  19678. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the external source at regular intervals.</p>
  19679. </td>
  19680. </tr></tbody>
  19681. </table>
  19682. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite
  19683. </h3>
  19684. <p>
  19685. (<em>Appears on:</em>
  19686. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  19687. </p>
  19688. <p>
  19689. <p>ExternalSecretRewrite defines rules on how to rewrite secret keys.</p>
  19690. </p>
  19691. <table>
  19692. <thead>
  19693. <tr>
  19694. <th>Field</th>
  19695. <th>Description</th>
  19696. </tr>
  19697. </thead>
  19698. <tbody>
  19699. <tr>
  19700. <td>
  19701. <code>regexp</code></br>
  19702. <em>
  19703. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">
  19704. ExternalSecretRewriteRegexp
  19705. </a>
  19706. </em>
  19707. </td>
  19708. <td>
  19709. <em>(Optional)</em>
  19710. <p>Used to rewrite with regular expressions.
  19711. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  19712. </td>
  19713. </tr>
  19714. <tr>
  19715. <td>
  19716. <code>transform</code></br>
  19717. <em>
  19718. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteTransform">
  19719. ExternalSecretRewriteTransform
  19720. </a>
  19721. </em>
  19722. </td>
  19723. <td>
  19724. <em>(Optional)</em>
  19725. <p>Used to apply string transformation on the secrets.
  19726. The resulting key will be the output of the template applied by the operation.</p>
  19727. </td>
  19728. </tr>
  19729. </tbody>
  19730. </table>
  19731. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  19732. </h3>
  19733. <p>
  19734. (<em>Appears on:</em>
  19735. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  19736. </p>
  19737. <p>
  19738. <p>ExternalSecretRewriteRegexp defines how to use regular expressions for rewriting secret keys.</p>
  19739. </p>
  19740. <table>
  19741. <thead>
  19742. <tr>
  19743. <th>Field</th>
  19744. <th>Description</th>
  19745. </tr>
  19746. </thead>
  19747. <tbody>
  19748. <tr>
  19749. <td>
  19750. <code>source</code></br>
  19751. <em>
  19752. string
  19753. </em>
  19754. </td>
  19755. <td>
  19756. <p>Used to define the regular expression of a re.Compiler.</p>
  19757. </td>
  19758. </tr>
  19759. <tr>
  19760. <td>
  19761. <code>target</code></br>
  19762. <em>
  19763. string
  19764. </em>
  19765. </td>
  19766. <td>
  19767. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  19768. </td>
  19769. </tr>
  19770. </tbody>
  19771. </table>
  19772. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  19773. </h3>
  19774. <p>
  19775. (<em>Appears on:</em>
  19776. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  19777. </p>
  19778. <p>
  19779. <p>ExternalSecretRewriteTransform defines how to use string templates for transforming secret keys.</p>
  19780. </p>
  19781. <table>
  19782. <thead>
  19783. <tr>
  19784. <th>Field</th>
  19785. <th>Description</th>
  19786. </tr>
  19787. </thead>
  19788. <tbody>
  19789. <tr>
  19790. <td>
  19791. <code>template</code></br>
  19792. <em>
  19793. string
  19794. </em>
  19795. </td>
  19796. <td>
  19797. <p>Used to define the template to apply on the secret name.
  19798. <code>.value</code> will specify the secret name in the template.</p>
  19799. </td>
  19800. </tr>
  19801. </tbody>
  19802. </table>
  19803. <h3 id="external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec
  19804. </h3>
  19805. <p>
  19806. (<em>Appears on:</em>
  19807. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  19808. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  19809. </p>
  19810. <p>
  19811. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  19812. </p>
  19813. <table>
  19814. <thead>
  19815. <tr>
  19816. <th>Field</th>
  19817. <th>Description</th>
  19818. </tr>
  19819. </thead>
  19820. <tbody>
  19821. <tr>
  19822. <td>
  19823. <code>secretStoreRef</code></br>
  19824. <em>
  19825. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  19826. SecretStoreRef
  19827. </a>
  19828. </em>
  19829. </td>
  19830. <td>
  19831. <em>(Optional)</em>
  19832. </td>
  19833. </tr>
  19834. <tr>
  19835. <td>
  19836. <code>target</code></br>
  19837. <em>
  19838. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  19839. ExternalSecretTarget
  19840. </a>
  19841. </em>
  19842. </td>
  19843. <td>
  19844. <em>(Optional)</em>
  19845. </td>
  19846. </tr>
  19847. <tr>
  19848. <td>
  19849. <code>refreshPolicy</code></br>
  19850. <em>
  19851. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  19852. ExternalSecretRefreshPolicy
  19853. </a>
  19854. </em>
  19855. </td>
  19856. <td>
  19857. <em>(Optional)</em>
  19858. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  19859. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  19860. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  19861. No periodic updates occur if refreshInterval is 0.
  19862. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  19863. </td>
  19864. </tr>
  19865. <tr>
  19866. <td>
  19867. <code>refreshInterval</code></br>
  19868. <em>
  19869. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  19870. Kubernetes meta/v1.Duration
  19871. </a>
  19872. </em>
  19873. </td>
  19874. <td>
  19875. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  19876. specified as Golang Duration strings.
  19877. 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;
  19878. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  19879. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  19880. </td>
  19881. </tr>
  19882. <tr>
  19883. <td>
  19884. <code>data</code></br>
  19885. <em>
  19886. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  19887. []ExternalSecretData
  19888. </a>
  19889. </em>
  19890. </td>
  19891. <td>
  19892. <em>(Optional)</em>
  19893. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  19894. </td>
  19895. </tr>
  19896. <tr>
  19897. <td>
  19898. <code>dataFrom</code></br>
  19899. <em>
  19900. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  19901. []ExternalSecretDataFromRemoteRef
  19902. </a>
  19903. </em>
  19904. </td>
  19905. <td>
  19906. <em>(Optional)</em>
  19907. <p>DataFrom is used to fetch all properties from a specific Provider data
  19908. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  19909. </td>
  19910. </tr>
  19911. </tbody>
  19912. </table>
  19913. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus
  19914. </h3>
  19915. <p>
  19916. (<em>Appears on:</em>
  19917. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  19918. </p>
  19919. <p>
  19920. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  19921. </p>
  19922. <table>
  19923. <thead>
  19924. <tr>
  19925. <th>Field</th>
  19926. <th>Description</th>
  19927. </tr>
  19928. </thead>
  19929. <tbody>
  19930. <tr>
  19931. <td>
  19932. <code>refreshTime</code></br>
  19933. <em>
  19934. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  19935. Kubernetes meta/v1.Time
  19936. </a>
  19937. </em>
  19938. </td>
  19939. <td>
  19940. <p>refreshTime is the time and date the external secret was fetched and
  19941. the target secret updated</p>
  19942. </td>
  19943. </tr>
  19944. <tr>
  19945. <td>
  19946. <code>syncedResourceVersion</code></br>
  19947. <em>
  19948. string
  19949. </em>
  19950. </td>
  19951. <td>
  19952. <p>SyncedResourceVersion keeps track of the last synced version</p>
  19953. </td>
  19954. </tr>
  19955. <tr>
  19956. <td>
  19957. <code>conditions</code></br>
  19958. <em>
  19959. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">
  19960. []ExternalSecretStatusCondition
  19961. </a>
  19962. </em>
  19963. </td>
  19964. <td>
  19965. <em>(Optional)</em>
  19966. </td>
  19967. </tr>
  19968. <tr>
  19969. <td>
  19970. <code>binding</code></br>
  19971. <em>
  19972. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  19973. Kubernetes core/v1.LocalObjectReference
  19974. </a>
  19975. </em>
  19976. </td>
  19977. <td>
  19978. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  19979. </td>
  19980. </tr>
  19981. </tbody>
  19982. </table>
  19983. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  19984. </h3>
  19985. <p>
  19986. (<em>Appears on:</em>
  19987. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus</a>)
  19988. </p>
  19989. <p>
  19990. <p>ExternalSecretStatusCondition contains condition information for an ExternalSecret.</p>
  19991. </p>
  19992. <table>
  19993. <thead>
  19994. <tr>
  19995. <th>Field</th>
  19996. <th>Description</th>
  19997. </tr>
  19998. </thead>
  19999. <tbody>
  20000. <tr>
  20001. <td>
  20002. <code>type</code></br>
  20003. <em>
  20004. <a href="#external-secrets.io/v1beta1.ExternalSecretConditionType">
  20005. ExternalSecretConditionType
  20006. </a>
  20007. </em>
  20008. </td>
  20009. <td>
  20010. </td>
  20011. </tr>
  20012. <tr>
  20013. <td>
  20014. <code>status</code></br>
  20015. <em>
  20016. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  20017. Kubernetes core/v1.ConditionStatus
  20018. </a>
  20019. </em>
  20020. </td>
  20021. <td>
  20022. </td>
  20023. </tr>
  20024. <tr>
  20025. <td>
  20026. <code>reason</code></br>
  20027. <em>
  20028. string
  20029. </em>
  20030. </td>
  20031. <td>
  20032. <em>(Optional)</em>
  20033. </td>
  20034. </tr>
  20035. <tr>
  20036. <td>
  20037. <code>message</code></br>
  20038. <em>
  20039. string
  20040. </em>
  20041. </td>
  20042. <td>
  20043. <em>(Optional)</em>
  20044. </td>
  20045. </tr>
  20046. <tr>
  20047. <td>
  20048. <code>lastTransitionTime</code></br>
  20049. <em>
  20050. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  20051. Kubernetes meta/v1.Time
  20052. </a>
  20053. </em>
  20054. </td>
  20055. <td>
  20056. <em>(Optional)</em>
  20057. </td>
  20058. </tr>
  20059. </tbody>
  20060. </table>
  20061. <h3 id="external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget
  20062. </h3>
  20063. <p>
  20064. (<em>Appears on:</em>
  20065. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  20066. </p>
  20067. <p>
  20068. <p>ExternalSecretTarget defines the Kubernetes Secret to be created
  20069. There can be only one target per ExternalSecret.</p>
  20070. </p>
  20071. <table>
  20072. <thead>
  20073. <tr>
  20074. <th>Field</th>
  20075. <th>Description</th>
  20076. </tr>
  20077. </thead>
  20078. <tbody>
  20079. <tr>
  20080. <td>
  20081. <code>name</code></br>
  20082. <em>
  20083. string
  20084. </em>
  20085. </td>
  20086. <td>
  20087. <em>(Optional)</em>
  20088. <p>The name of the Secret resource to be managed.
  20089. Defaults to the .metadata.name of the ExternalSecret resource</p>
  20090. </td>
  20091. </tr>
  20092. <tr>
  20093. <td>
  20094. <code>creationPolicy</code></br>
  20095. <em>
  20096. <a href="#external-secrets.io/v1beta1.ExternalSecretCreationPolicy">
  20097. ExternalSecretCreationPolicy
  20098. </a>
  20099. </em>
  20100. </td>
  20101. <td>
  20102. <em>(Optional)</em>
  20103. <p>CreationPolicy defines rules on how to create the resulting Secret.
  20104. Defaults to &ldquo;Owner&rdquo;</p>
  20105. </td>
  20106. </tr>
  20107. <tr>
  20108. <td>
  20109. <code>deletionPolicy</code></br>
  20110. <em>
  20111. <a href="#external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">
  20112. ExternalSecretDeletionPolicy
  20113. </a>
  20114. </em>
  20115. </td>
  20116. <td>
  20117. <em>(Optional)</em>
  20118. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  20119. Defaults to &ldquo;Retain&rdquo;</p>
  20120. </td>
  20121. </tr>
  20122. <tr>
  20123. <td>
  20124. <code>template</code></br>
  20125. <em>
  20126. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">
  20127. ExternalSecretTemplate
  20128. </a>
  20129. </em>
  20130. </td>
  20131. <td>
  20132. <em>(Optional)</em>
  20133. <p>Template defines a blueprint for the created Secret resource.</p>
  20134. </td>
  20135. </tr>
  20136. <tr>
  20137. <td>
  20138. <code>immutable</code></br>
  20139. <em>
  20140. bool
  20141. </em>
  20142. </td>
  20143. <td>
  20144. <em>(Optional)</em>
  20145. <p>Immutable defines if the final secret will be immutable</p>
  20146. </td>
  20147. </tr>
  20148. </tbody>
  20149. </table>
  20150. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate
  20151. </h3>
  20152. <p>
  20153. (<em>Appears on:</em>
  20154. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  20155. </p>
  20156. <p>
  20157. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  20158. 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>
  20159. </p>
  20160. <table>
  20161. <thead>
  20162. <tr>
  20163. <th>Field</th>
  20164. <th>Description</th>
  20165. </tr>
  20166. </thead>
  20167. <tbody>
  20168. <tr>
  20169. <td>
  20170. <code>type</code></br>
  20171. <em>
  20172. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  20173. Kubernetes core/v1.SecretType
  20174. </a>
  20175. </em>
  20176. </td>
  20177. <td>
  20178. <em>(Optional)</em>
  20179. </td>
  20180. </tr>
  20181. <tr>
  20182. <td>
  20183. <code>engineVersion</code></br>
  20184. <em>
  20185. <a href="#external-secrets.io/v1beta1.TemplateEngineVersion">
  20186. TemplateEngineVersion
  20187. </a>
  20188. </em>
  20189. </td>
  20190. <td>
  20191. <p>EngineVersion specifies the template engine version
  20192. that should be used to compile/execute the
  20193. template specified in .data and .templateFrom[].</p>
  20194. </td>
  20195. </tr>
  20196. <tr>
  20197. <td>
  20198. <code>metadata</code></br>
  20199. <em>
  20200. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">
  20201. ExternalSecretTemplateMetadata
  20202. </a>
  20203. </em>
  20204. </td>
  20205. <td>
  20206. <em>(Optional)</em>
  20207. </td>
  20208. </tr>
  20209. <tr>
  20210. <td>
  20211. <code>mergePolicy</code></br>
  20212. <em>
  20213. <a href="#external-secrets.io/v1beta1.TemplateMergePolicy">
  20214. TemplateMergePolicy
  20215. </a>
  20216. </em>
  20217. </td>
  20218. <td>
  20219. </td>
  20220. </tr>
  20221. <tr>
  20222. <td>
  20223. <code>data</code></br>
  20224. <em>
  20225. map[string]string
  20226. </em>
  20227. </td>
  20228. <td>
  20229. <em>(Optional)</em>
  20230. </td>
  20231. </tr>
  20232. <tr>
  20233. <td>
  20234. <code>templateFrom</code></br>
  20235. <em>
  20236. <a href="#external-secrets.io/v1beta1.TemplateFrom">
  20237. []TemplateFrom
  20238. </a>
  20239. </em>
  20240. </td>
  20241. <td>
  20242. <em>(Optional)</em>
  20243. </td>
  20244. </tr>
  20245. </tbody>
  20246. </table>
  20247. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  20248. </h3>
  20249. <p>
  20250. (<em>Appears on:</em>
  20251. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  20252. </p>
  20253. <p>
  20254. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  20255. </p>
  20256. <table>
  20257. <thead>
  20258. <tr>
  20259. <th>Field</th>
  20260. <th>Description</th>
  20261. </tr>
  20262. </thead>
  20263. <tbody>
  20264. <tr>
  20265. <td>
  20266. <code>annotations</code></br>
  20267. <em>
  20268. map[string]string
  20269. </em>
  20270. </td>
  20271. <td>
  20272. <em>(Optional)</em>
  20273. </td>
  20274. </tr>
  20275. <tr>
  20276. <td>
  20277. <code>labels</code></br>
  20278. <em>
  20279. map[string]string
  20280. </em>
  20281. </td>
  20282. <td>
  20283. <em>(Optional)</em>
  20284. </td>
  20285. </tr>
  20286. </tbody>
  20287. </table>
  20288. <h3 id="external-secrets.io/v1beta1.ExternalSecretValidator">ExternalSecretValidator
  20289. </h3>
  20290. <p>
  20291. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  20292. </p>
  20293. <h3 id="external-secrets.io/v1beta1.FakeProvider">FakeProvider
  20294. </h3>
  20295. <p>
  20296. (<em>Appears on:</em>
  20297. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20298. </p>
  20299. <p>
  20300. <p>FakeProvider configures a fake provider that returns static values.</p>
  20301. </p>
  20302. <table>
  20303. <thead>
  20304. <tr>
  20305. <th>Field</th>
  20306. <th>Description</th>
  20307. </tr>
  20308. </thead>
  20309. <tbody>
  20310. <tr>
  20311. <td>
  20312. <code>data</code></br>
  20313. <em>
  20314. <a href="#external-secrets.io/v1beta1.FakeProviderData">
  20315. []FakeProviderData
  20316. </a>
  20317. </em>
  20318. </td>
  20319. <td>
  20320. </td>
  20321. </tr>
  20322. </tbody>
  20323. </table>
  20324. <h3 id="external-secrets.io/v1beta1.FakeProviderData">FakeProviderData
  20325. </h3>
  20326. <p>
  20327. (<em>Appears on:</em>
  20328. <a href="#external-secrets.io/v1beta1.FakeProvider">FakeProvider</a>)
  20329. </p>
  20330. <p>
  20331. <p>FakeProviderData defines a key-value pair for the fake provider used in testing.</p>
  20332. </p>
  20333. <table>
  20334. <thead>
  20335. <tr>
  20336. <th>Field</th>
  20337. <th>Description</th>
  20338. </tr>
  20339. </thead>
  20340. <tbody>
  20341. <tr>
  20342. <td>
  20343. <code>key</code></br>
  20344. <em>
  20345. string
  20346. </em>
  20347. </td>
  20348. <td>
  20349. </td>
  20350. </tr>
  20351. <tr>
  20352. <td>
  20353. <code>value</code></br>
  20354. <em>
  20355. string
  20356. </em>
  20357. </td>
  20358. <td>
  20359. </td>
  20360. </tr>
  20361. <tr>
  20362. <td>
  20363. <code>version</code></br>
  20364. <em>
  20365. string
  20366. </em>
  20367. </td>
  20368. <td>
  20369. </td>
  20370. </tr>
  20371. </tbody>
  20372. </table>
  20373. <h3 id="external-secrets.io/v1beta1.FindName">FindName
  20374. </h3>
  20375. <p>
  20376. (<em>Appears on:</em>
  20377. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  20378. </p>
  20379. <p>
  20380. <p>FindName defines name matching criteria for finding secrets.</p>
  20381. </p>
  20382. <table>
  20383. <thead>
  20384. <tr>
  20385. <th>Field</th>
  20386. <th>Description</th>
  20387. </tr>
  20388. </thead>
  20389. <tbody>
  20390. <tr>
  20391. <td>
  20392. <code>regexp</code></br>
  20393. <em>
  20394. string
  20395. </em>
  20396. </td>
  20397. <td>
  20398. <em>(Optional)</em>
  20399. <p>Finds secrets base</p>
  20400. </td>
  20401. </tr>
  20402. </tbody>
  20403. </table>
  20404. <h3 id="external-secrets.io/v1beta1.FortanixProvider">FortanixProvider
  20405. </h3>
  20406. <p>
  20407. (<em>Appears on:</em>
  20408. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20409. </p>
  20410. <p>
  20411. <p>FortanixProvider configures a store to sync secrets using the Fortanix SDKMS provider.</p>
  20412. </p>
  20413. <table>
  20414. <thead>
  20415. <tr>
  20416. <th>Field</th>
  20417. <th>Description</th>
  20418. </tr>
  20419. </thead>
  20420. <tbody>
  20421. <tr>
  20422. <td>
  20423. <code>apiUrl</code></br>
  20424. <em>
  20425. string
  20426. </em>
  20427. </td>
  20428. <td>
  20429. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  20430. </td>
  20431. </tr>
  20432. <tr>
  20433. <td>
  20434. <code>apiKey</code></br>
  20435. <em>
  20436. <a href="#external-secrets.io/v1beta1.FortanixProviderSecretRef">
  20437. FortanixProviderSecretRef
  20438. </a>
  20439. </em>
  20440. </td>
  20441. <td>
  20442. <p>APIKey is the API token to access SDKMS Applications.</p>
  20443. </td>
  20444. </tr>
  20445. </tbody>
  20446. </table>
  20447. <h3 id="external-secrets.io/v1beta1.FortanixProviderSecretRef">FortanixProviderSecretRef
  20448. </h3>
  20449. <p>
  20450. (<em>Appears on:</em>
  20451. <a href="#external-secrets.io/v1beta1.FortanixProvider">FortanixProvider</a>)
  20452. </p>
  20453. <p>
  20454. <p>FortanixProviderSecretRef defines a reference to a secret containing credentials for the Fortanix provider.</p>
  20455. </p>
  20456. <table>
  20457. <thead>
  20458. <tr>
  20459. <th>Field</th>
  20460. <th>Description</th>
  20461. </tr>
  20462. </thead>
  20463. <tbody>
  20464. <tr>
  20465. <td>
  20466. <code>secretRef</code></br>
  20467. <em>
  20468. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20469. External Secrets meta/v1.SecretKeySelector
  20470. </a>
  20471. </em>
  20472. </td>
  20473. <td>
  20474. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  20475. </td>
  20476. </tr>
  20477. </tbody>
  20478. </table>
  20479. <h3 id="external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth
  20480. </h3>
  20481. <p>
  20482. (<em>Appears on:</em>
  20483. <a href="#external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider</a>)
  20484. </p>
  20485. <p>
  20486. <p>GCPSMAuth defines the authentication methods for the GCP Secret Manager provider.</p>
  20487. </p>
  20488. <table>
  20489. <thead>
  20490. <tr>
  20491. <th>Field</th>
  20492. <th>Description</th>
  20493. </tr>
  20494. </thead>
  20495. <tbody>
  20496. <tr>
  20497. <td>
  20498. <code>secretRef</code></br>
  20499. <em>
  20500. <a href="#external-secrets.io/v1beta1.GCPSMAuthSecretRef">
  20501. GCPSMAuthSecretRef
  20502. </a>
  20503. </em>
  20504. </td>
  20505. <td>
  20506. <em>(Optional)</em>
  20507. </td>
  20508. </tr>
  20509. <tr>
  20510. <td>
  20511. <code>workloadIdentity</code></br>
  20512. <em>
  20513. <a href="#external-secrets.io/v1beta1.GCPWorkloadIdentity">
  20514. GCPWorkloadIdentity
  20515. </a>
  20516. </em>
  20517. </td>
  20518. <td>
  20519. <em>(Optional)</em>
  20520. </td>
  20521. </tr>
  20522. </tbody>
  20523. </table>
  20524. <h3 id="external-secrets.io/v1beta1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  20525. </h3>
  20526. <p>
  20527. (<em>Appears on:</em>
  20528. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  20529. </p>
  20530. <p>
  20531. <p>GCPSMAuthSecretRef defines a reference to a secret containing credentials for the GCP Secret Manager provider.</p>
  20532. </p>
  20533. <table>
  20534. <thead>
  20535. <tr>
  20536. <th>Field</th>
  20537. <th>Description</th>
  20538. </tr>
  20539. </thead>
  20540. <tbody>
  20541. <tr>
  20542. <td>
  20543. <code>secretAccessKeySecretRef</code></br>
  20544. <em>
  20545. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20546. External Secrets meta/v1.SecretKeySelector
  20547. </a>
  20548. </em>
  20549. </td>
  20550. <td>
  20551. <em>(Optional)</em>
  20552. <p>The SecretAccessKey is used for authentication</p>
  20553. </td>
  20554. </tr>
  20555. </tbody>
  20556. </table>
  20557. <h3 id="external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider
  20558. </h3>
  20559. <p>
  20560. (<em>Appears on:</em>
  20561. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20562. </p>
  20563. <p>
  20564. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  20565. </p>
  20566. <table>
  20567. <thead>
  20568. <tr>
  20569. <th>Field</th>
  20570. <th>Description</th>
  20571. </tr>
  20572. </thead>
  20573. <tbody>
  20574. <tr>
  20575. <td>
  20576. <code>auth</code></br>
  20577. <em>
  20578. <a href="#external-secrets.io/v1beta1.GCPSMAuth">
  20579. GCPSMAuth
  20580. </a>
  20581. </em>
  20582. </td>
  20583. <td>
  20584. <em>(Optional)</em>
  20585. <p>Auth defines the information necessary to authenticate against GCP</p>
  20586. </td>
  20587. </tr>
  20588. <tr>
  20589. <td>
  20590. <code>projectID</code></br>
  20591. <em>
  20592. string
  20593. </em>
  20594. </td>
  20595. <td>
  20596. <p>ProjectID project where secret is located</p>
  20597. </td>
  20598. </tr>
  20599. <tr>
  20600. <td>
  20601. <code>location</code></br>
  20602. <em>
  20603. string
  20604. </em>
  20605. </td>
  20606. <td>
  20607. <p>Location optionally defines a location for a secret</p>
  20608. </td>
  20609. </tr>
  20610. </tbody>
  20611. </table>
  20612. <h3 id="external-secrets.io/v1beta1.GCPWorkloadIdentity">GCPWorkloadIdentity
  20613. </h3>
  20614. <p>
  20615. (<em>Appears on:</em>
  20616. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  20617. </p>
  20618. <p>
  20619. <p>GCPWorkloadIdentity defines configuration for using GCP Workload Identity authentication.</p>
  20620. </p>
  20621. <table>
  20622. <thead>
  20623. <tr>
  20624. <th>Field</th>
  20625. <th>Description</th>
  20626. </tr>
  20627. </thead>
  20628. <tbody>
  20629. <tr>
  20630. <td>
  20631. <code>serviceAccountRef</code></br>
  20632. <em>
  20633. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  20634. External Secrets meta/v1.ServiceAccountSelector
  20635. </a>
  20636. </em>
  20637. </td>
  20638. <td>
  20639. </td>
  20640. </tr>
  20641. <tr>
  20642. <td>
  20643. <code>clusterLocation</code></br>
  20644. <em>
  20645. string
  20646. </em>
  20647. </td>
  20648. <td>
  20649. <em>(Optional)</em>
  20650. <p>ClusterLocation is the location of the cluster
  20651. If not specified, it fetches information from the metadata server</p>
  20652. </td>
  20653. </tr>
  20654. <tr>
  20655. <td>
  20656. <code>clusterName</code></br>
  20657. <em>
  20658. string
  20659. </em>
  20660. </td>
  20661. <td>
  20662. <em>(Optional)</em>
  20663. <p>ClusterName is the name of the cluster
  20664. If not specified, it fetches information from the metadata server</p>
  20665. </td>
  20666. </tr>
  20667. <tr>
  20668. <td>
  20669. <code>clusterProjectID</code></br>
  20670. <em>
  20671. string
  20672. </em>
  20673. </td>
  20674. <td>
  20675. <em>(Optional)</em>
  20676. <p>ClusterProjectID is the project ID of the cluster
  20677. If not specified, it fetches information from the metadata server</p>
  20678. </td>
  20679. </tr>
  20680. </tbody>
  20681. </table>
  20682. <h3 id="external-secrets.io/v1beta1.GeneratorRef">GeneratorRef
  20683. </h3>
  20684. <p>
  20685. (<em>Appears on:</em>
  20686. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  20687. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  20688. </p>
  20689. <p>
  20690. <p>GeneratorRef points to a generator custom resource.</p>
  20691. </p>
  20692. <table>
  20693. <thead>
  20694. <tr>
  20695. <th>Field</th>
  20696. <th>Description</th>
  20697. </tr>
  20698. </thead>
  20699. <tbody>
  20700. <tr>
  20701. <td>
  20702. <code>apiVersion</code></br>
  20703. <em>
  20704. string
  20705. </em>
  20706. </td>
  20707. <td>
  20708. <p>Specify the apiVersion of the generator resource</p>
  20709. </td>
  20710. </tr>
  20711. <tr>
  20712. <td>
  20713. <code>kind</code></br>
  20714. <em>
  20715. string
  20716. </em>
  20717. </td>
  20718. <td>
  20719. <p>Specify the Kind of the generator resource</p>
  20720. </td>
  20721. </tr>
  20722. <tr>
  20723. <td>
  20724. <code>name</code></br>
  20725. <em>
  20726. string
  20727. </em>
  20728. </td>
  20729. <td>
  20730. <p>Specify the name of the generator resource</p>
  20731. </td>
  20732. </tr>
  20733. </tbody>
  20734. </table>
  20735. <h3 id="external-secrets.io/v1beta1.GenericClusterStoreValidator">GenericClusterStoreValidator
  20736. </h3>
  20737. <p>
  20738. <p>GenericClusterStoreValidator provides validation for ClusterSecretStore resources.</p>
  20739. </p>
  20740. <h3 id="external-secrets.io/v1beta1.GenericStore">GenericStore
  20741. </h3>
  20742. <p>
  20743. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  20744. or a namespaced SecretStore.</p>
  20745. </p>
  20746. <h3 id="external-secrets.io/v1beta1.GenericStoreValidator">GenericStoreValidator
  20747. </h3>
  20748. <p>
  20749. <p>GenericStoreValidator provides validation for SecretStore resources.</p>
  20750. </p>
  20751. <h3 id="external-secrets.io/v1beta1.GithubAppAuth">GithubAppAuth
  20752. </h3>
  20753. <p>
  20754. (<em>Appears on:</em>
  20755. <a href="#external-secrets.io/v1beta1.GithubProvider">GithubProvider</a>)
  20756. </p>
  20757. <p>
  20758. <p>GithubAppAuth defines the GitHub App authentication mechanism for the GitHub provider.</p>
  20759. </p>
  20760. <table>
  20761. <thead>
  20762. <tr>
  20763. <th>Field</th>
  20764. <th>Description</th>
  20765. </tr>
  20766. </thead>
  20767. <tbody>
  20768. <tr>
  20769. <td>
  20770. <code>privateKey</code></br>
  20771. <em>
  20772. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20773. External Secrets meta/v1.SecretKeySelector
  20774. </a>
  20775. </em>
  20776. </td>
  20777. <td>
  20778. </td>
  20779. </tr>
  20780. </tbody>
  20781. </table>
  20782. <h3 id="external-secrets.io/v1beta1.GithubProvider">GithubProvider
  20783. </h3>
  20784. <p>
  20785. (<em>Appears on:</em>
  20786. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20787. </p>
  20788. <p>
  20789. <p>GithubProvider configures a store to push secrets to Github Actions.</p>
  20790. </p>
  20791. <table>
  20792. <thead>
  20793. <tr>
  20794. <th>Field</th>
  20795. <th>Description</th>
  20796. </tr>
  20797. </thead>
  20798. <tbody>
  20799. <tr>
  20800. <td>
  20801. <code>url</code></br>
  20802. <em>
  20803. string
  20804. </em>
  20805. </td>
  20806. <td>
  20807. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  20808. </td>
  20809. </tr>
  20810. <tr>
  20811. <td>
  20812. <code>uploadURL</code></br>
  20813. <em>
  20814. string
  20815. </em>
  20816. </td>
  20817. <td>
  20818. <em>(Optional)</em>
  20819. <p>Upload URL for enterprise instances. Default to URL.</p>
  20820. </td>
  20821. </tr>
  20822. <tr>
  20823. <td>
  20824. <code>auth</code></br>
  20825. <em>
  20826. <a href="#external-secrets.io/v1beta1.GithubAppAuth">
  20827. GithubAppAuth
  20828. </a>
  20829. </em>
  20830. </td>
  20831. <td>
  20832. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  20833. </td>
  20834. </tr>
  20835. <tr>
  20836. <td>
  20837. <code>appID</code></br>
  20838. <em>
  20839. int64
  20840. </em>
  20841. </td>
  20842. <td>
  20843. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  20844. </td>
  20845. </tr>
  20846. <tr>
  20847. <td>
  20848. <code>installationID</code></br>
  20849. <em>
  20850. int64
  20851. </em>
  20852. </td>
  20853. <td>
  20854. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  20855. </td>
  20856. </tr>
  20857. <tr>
  20858. <td>
  20859. <code>organization</code></br>
  20860. <em>
  20861. string
  20862. </em>
  20863. </td>
  20864. <td>
  20865. <p>organization will be used to fetch secrets from the Github organization</p>
  20866. </td>
  20867. </tr>
  20868. <tr>
  20869. <td>
  20870. <code>repository</code></br>
  20871. <em>
  20872. string
  20873. </em>
  20874. </td>
  20875. <td>
  20876. <em>(Optional)</em>
  20877. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  20878. </td>
  20879. </tr>
  20880. <tr>
  20881. <td>
  20882. <code>environment</code></br>
  20883. <em>
  20884. string
  20885. </em>
  20886. </td>
  20887. <td>
  20888. <em>(Optional)</em>
  20889. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  20890. </td>
  20891. </tr>
  20892. </tbody>
  20893. </table>
  20894. <h3 id="external-secrets.io/v1beta1.GitlabAuth">GitlabAuth
  20895. </h3>
  20896. <p>
  20897. (<em>Appears on:</em>
  20898. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>)
  20899. </p>
  20900. <p>
  20901. <p>GitlabAuth defines the authentication method for the GitLab provider.</p>
  20902. </p>
  20903. <table>
  20904. <thead>
  20905. <tr>
  20906. <th>Field</th>
  20907. <th>Description</th>
  20908. </tr>
  20909. </thead>
  20910. <tbody>
  20911. <tr>
  20912. <td>
  20913. <code>SecretRef</code></br>
  20914. <em>
  20915. <a href="#external-secrets.io/v1beta1.GitlabSecretRef">
  20916. GitlabSecretRef
  20917. </a>
  20918. </em>
  20919. </td>
  20920. <td>
  20921. </td>
  20922. </tr>
  20923. </tbody>
  20924. </table>
  20925. <h3 id="external-secrets.io/v1beta1.GitlabProvider">GitlabProvider
  20926. </h3>
  20927. <p>
  20928. (<em>Appears on:</em>
  20929. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20930. </p>
  20931. <p>
  20932. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  20933. </p>
  20934. <table>
  20935. <thead>
  20936. <tr>
  20937. <th>Field</th>
  20938. <th>Description</th>
  20939. </tr>
  20940. </thead>
  20941. <tbody>
  20942. <tr>
  20943. <td>
  20944. <code>url</code></br>
  20945. <em>
  20946. string
  20947. </em>
  20948. </td>
  20949. <td>
  20950. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  20951. </td>
  20952. </tr>
  20953. <tr>
  20954. <td>
  20955. <code>auth</code></br>
  20956. <em>
  20957. <a href="#external-secrets.io/v1beta1.GitlabAuth">
  20958. GitlabAuth
  20959. </a>
  20960. </em>
  20961. </td>
  20962. <td>
  20963. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  20964. </td>
  20965. </tr>
  20966. <tr>
  20967. <td>
  20968. <code>projectID</code></br>
  20969. <em>
  20970. string
  20971. </em>
  20972. </td>
  20973. <td>
  20974. <p>ProjectID specifies a project where secrets are located.</p>
  20975. </td>
  20976. </tr>
  20977. <tr>
  20978. <td>
  20979. <code>inheritFromGroups</code></br>
  20980. <em>
  20981. bool
  20982. </em>
  20983. </td>
  20984. <td>
  20985. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  20986. </td>
  20987. </tr>
  20988. <tr>
  20989. <td>
  20990. <code>groupIDs</code></br>
  20991. <em>
  20992. []string
  20993. </em>
  20994. </td>
  20995. <td>
  20996. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  20997. </td>
  20998. </tr>
  20999. <tr>
  21000. <td>
  21001. <code>environment</code></br>
  21002. <em>
  21003. string
  21004. </em>
  21005. </td>
  21006. <td>
  21007. <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>
  21008. </td>
  21009. </tr>
  21010. <tr>
  21011. <td>
  21012. <code>caBundle</code></br>
  21013. <em>
  21014. []byte
  21015. </em>
  21016. </td>
  21017. <td>
  21018. <em>(Optional)</em>
  21019. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  21020. can be performed.</p>
  21021. </td>
  21022. </tr>
  21023. <tr>
  21024. <td>
  21025. <code>caProvider</code></br>
  21026. <em>
  21027. <a href="#external-secrets.io/v1beta1.CAProvider">
  21028. CAProvider
  21029. </a>
  21030. </em>
  21031. </td>
  21032. <td>
  21033. <em>(Optional)</em>
  21034. <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>
  21035. </td>
  21036. </tr>
  21037. </tbody>
  21038. </table>
  21039. <h3 id="external-secrets.io/v1beta1.GitlabSecretRef">GitlabSecretRef
  21040. </h3>
  21041. <p>
  21042. (<em>Appears on:</em>
  21043. <a href="#external-secrets.io/v1beta1.GitlabAuth">GitlabAuth</a>)
  21044. </p>
  21045. <p>
  21046. <p>GitlabSecretRef defines a reference to a secret containing credentials for the GitLab provider.</p>
  21047. </p>
  21048. <table>
  21049. <thead>
  21050. <tr>
  21051. <th>Field</th>
  21052. <th>Description</th>
  21053. </tr>
  21054. </thead>
  21055. <tbody>
  21056. <tr>
  21057. <td>
  21058. <code>accessToken</code></br>
  21059. <em>
  21060. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21061. External Secrets meta/v1.SecretKeySelector
  21062. </a>
  21063. </em>
  21064. </td>
  21065. <td>
  21066. <p>AccessToken is used for authentication.</p>
  21067. </td>
  21068. </tr>
  21069. </tbody>
  21070. </table>
  21071. <h3 id="external-secrets.io/v1beta1.IBMAuth">IBMAuth
  21072. </h3>
  21073. <p>
  21074. (<em>Appears on:</em>
  21075. <a href="#external-secrets.io/v1beta1.IBMProvider">IBMProvider</a>)
  21076. </p>
  21077. <p>
  21078. <p>IBMAuth defines the authentication methods for the IBM Cloud Secrets Manager provider.</p>
  21079. </p>
  21080. <table>
  21081. <thead>
  21082. <tr>
  21083. <th>Field</th>
  21084. <th>Description</th>
  21085. </tr>
  21086. </thead>
  21087. <tbody>
  21088. <tr>
  21089. <td>
  21090. <code>secretRef</code></br>
  21091. <em>
  21092. <a href="#external-secrets.io/v1beta1.IBMAuthSecretRef">
  21093. IBMAuthSecretRef
  21094. </a>
  21095. </em>
  21096. </td>
  21097. <td>
  21098. </td>
  21099. </tr>
  21100. <tr>
  21101. <td>
  21102. <code>containerAuth</code></br>
  21103. <em>
  21104. <a href="#external-secrets.io/v1beta1.IBMAuthContainerAuth">
  21105. IBMAuthContainerAuth
  21106. </a>
  21107. </em>
  21108. </td>
  21109. <td>
  21110. </td>
  21111. </tr>
  21112. </tbody>
  21113. </table>
  21114. <h3 id="external-secrets.io/v1beta1.IBMAuthContainerAuth">IBMAuthContainerAuth
  21115. </h3>
  21116. <p>
  21117. (<em>Appears on:</em>
  21118. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  21119. </p>
  21120. <p>
  21121. <p>IBMAuthContainerAuth defines authentication using IBM Container-based auth with IAM Trusted Profile.</p>
  21122. </p>
  21123. <table>
  21124. <thead>
  21125. <tr>
  21126. <th>Field</th>
  21127. <th>Description</th>
  21128. </tr>
  21129. </thead>
  21130. <tbody>
  21131. <tr>
  21132. <td>
  21133. <code>profile</code></br>
  21134. <em>
  21135. string
  21136. </em>
  21137. </td>
  21138. <td>
  21139. <p>the IBM Trusted Profile</p>
  21140. </td>
  21141. </tr>
  21142. <tr>
  21143. <td>
  21144. <code>tokenLocation</code></br>
  21145. <em>
  21146. string
  21147. </em>
  21148. </td>
  21149. <td>
  21150. <p>Location the token is mounted on the pod</p>
  21151. </td>
  21152. </tr>
  21153. <tr>
  21154. <td>
  21155. <code>iamEndpoint</code></br>
  21156. <em>
  21157. string
  21158. </em>
  21159. </td>
  21160. <td>
  21161. </td>
  21162. </tr>
  21163. </tbody>
  21164. </table>
  21165. <h3 id="external-secrets.io/v1beta1.IBMAuthSecretRef">IBMAuthSecretRef
  21166. </h3>
  21167. <p>
  21168. (<em>Appears on:</em>
  21169. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  21170. </p>
  21171. <p>
  21172. <p>IBMAuthSecretRef defines a reference to a secret containing credentials for the IBM provider.</p>
  21173. </p>
  21174. <table>
  21175. <thead>
  21176. <tr>
  21177. <th>Field</th>
  21178. <th>Description</th>
  21179. </tr>
  21180. </thead>
  21181. <tbody>
  21182. <tr>
  21183. <td>
  21184. <code>secretApiKeySecretRef</code></br>
  21185. <em>
  21186. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21187. External Secrets meta/v1.SecretKeySelector
  21188. </a>
  21189. </em>
  21190. </td>
  21191. <td>
  21192. <p>The SecretAccessKey is used for authentication</p>
  21193. </td>
  21194. </tr>
  21195. </tbody>
  21196. </table>
  21197. <h3 id="external-secrets.io/v1beta1.IBMProvider">IBMProvider
  21198. </h3>
  21199. <p>
  21200. (<em>Appears on:</em>
  21201. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21202. </p>
  21203. <p>
  21204. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager backend.</p>
  21205. </p>
  21206. <table>
  21207. <thead>
  21208. <tr>
  21209. <th>Field</th>
  21210. <th>Description</th>
  21211. </tr>
  21212. </thead>
  21213. <tbody>
  21214. <tr>
  21215. <td>
  21216. <code>auth</code></br>
  21217. <em>
  21218. <a href="#external-secrets.io/v1beta1.IBMAuth">
  21219. IBMAuth
  21220. </a>
  21221. </em>
  21222. </td>
  21223. <td>
  21224. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  21225. </td>
  21226. </tr>
  21227. <tr>
  21228. <td>
  21229. <code>serviceUrl</code></br>
  21230. <em>
  21231. string
  21232. </em>
  21233. </td>
  21234. <td>
  21235. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  21236. </td>
  21237. </tr>
  21238. </tbody>
  21239. </table>
  21240. <h3 id="external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth
  21241. </h3>
  21242. <p>
  21243. (<em>Appears on:</em>
  21244. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  21245. </p>
  21246. <p>
  21247. <p>InfisicalAuth defines the authentication methods for the Infisical provider.</p>
  21248. </p>
  21249. <table>
  21250. <thead>
  21251. <tr>
  21252. <th>Field</th>
  21253. <th>Description</th>
  21254. </tr>
  21255. </thead>
  21256. <tbody>
  21257. <tr>
  21258. <td>
  21259. <code>universalAuthCredentials</code></br>
  21260. <em>
  21261. <a href="#external-secrets.io/v1beta1.UniversalAuthCredentials">
  21262. UniversalAuthCredentials
  21263. </a>
  21264. </em>
  21265. </td>
  21266. <td>
  21267. <em>(Optional)</em>
  21268. </td>
  21269. </tr>
  21270. </tbody>
  21271. </table>
  21272. <h3 id="external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider
  21273. </h3>
  21274. <p>
  21275. (<em>Appears on:</em>
  21276. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21277. </p>
  21278. <p>
  21279. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  21280. </p>
  21281. <table>
  21282. <thead>
  21283. <tr>
  21284. <th>Field</th>
  21285. <th>Description</th>
  21286. </tr>
  21287. </thead>
  21288. <tbody>
  21289. <tr>
  21290. <td>
  21291. <code>auth</code></br>
  21292. <em>
  21293. <a href="#external-secrets.io/v1beta1.InfisicalAuth">
  21294. InfisicalAuth
  21295. </a>
  21296. </em>
  21297. </td>
  21298. <td>
  21299. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  21300. </td>
  21301. </tr>
  21302. <tr>
  21303. <td>
  21304. <code>secretsScope</code></br>
  21305. <em>
  21306. <a href="#external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">
  21307. MachineIdentityScopeInWorkspace
  21308. </a>
  21309. </em>
  21310. </td>
  21311. <td>
  21312. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  21313. </td>
  21314. </tr>
  21315. <tr>
  21316. <td>
  21317. <code>hostAPI</code></br>
  21318. <em>
  21319. string
  21320. </em>
  21321. </td>
  21322. <td>
  21323. <em>(Optional)</em>
  21324. <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>
  21325. </td>
  21326. </tr>
  21327. </tbody>
  21328. </table>
  21329. <h3 id="external-secrets.io/v1beta1.KeeperSecurityProvider">KeeperSecurityProvider
  21330. </h3>
  21331. <p>
  21332. (<em>Appears on:</em>
  21333. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21334. </p>
  21335. <p>
  21336. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  21337. </p>
  21338. <table>
  21339. <thead>
  21340. <tr>
  21341. <th>Field</th>
  21342. <th>Description</th>
  21343. </tr>
  21344. </thead>
  21345. <tbody>
  21346. <tr>
  21347. <td>
  21348. <code>authRef</code></br>
  21349. <em>
  21350. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21351. External Secrets meta/v1.SecretKeySelector
  21352. </a>
  21353. </em>
  21354. </td>
  21355. <td>
  21356. </td>
  21357. </tr>
  21358. <tr>
  21359. <td>
  21360. <code>folderID</code></br>
  21361. <em>
  21362. string
  21363. </em>
  21364. </td>
  21365. <td>
  21366. </td>
  21367. </tr>
  21368. </tbody>
  21369. </table>
  21370. <h3 id="external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth
  21371. </h3>
  21372. <p>
  21373. (<em>Appears on:</em>
  21374. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  21375. </p>
  21376. <p>
  21377. <p>KubernetesAuth defines authentication methods for the Kubernetes provider.</p>
  21378. </p>
  21379. <table>
  21380. <thead>
  21381. <tr>
  21382. <th>Field</th>
  21383. <th>Description</th>
  21384. </tr>
  21385. </thead>
  21386. <tbody>
  21387. <tr>
  21388. <td>
  21389. <code>cert</code></br>
  21390. <em>
  21391. <a href="#external-secrets.io/v1beta1.CertAuth">
  21392. CertAuth
  21393. </a>
  21394. </em>
  21395. </td>
  21396. <td>
  21397. <em>(Optional)</em>
  21398. <p>has both clientCert and clientKey as secretKeySelector</p>
  21399. </td>
  21400. </tr>
  21401. <tr>
  21402. <td>
  21403. <code>token</code></br>
  21404. <em>
  21405. <a href="#external-secrets.io/v1beta1.TokenAuth">
  21406. TokenAuth
  21407. </a>
  21408. </em>
  21409. </td>
  21410. <td>
  21411. <em>(Optional)</em>
  21412. <p>use static token to authenticate with</p>
  21413. </td>
  21414. </tr>
  21415. <tr>
  21416. <td>
  21417. <code>serviceAccount</code></br>
  21418. <em>
  21419. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  21420. External Secrets meta/v1.ServiceAccountSelector
  21421. </a>
  21422. </em>
  21423. </td>
  21424. <td>
  21425. <em>(Optional)</em>
  21426. <p>points to a service account that should be used for authentication</p>
  21427. </td>
  21428. </tr>
  21429. </tbody>
  21430. </table>
  21431. <h3 id="external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider
  21432. </h3>
  21433. <p>
  21434. (<em>Appears on:</em>
  21435. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21436. </p>
  21437. <p>
  21438. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  21439. </p>
  21440. <table>
  21441. <thead>
  21442. <tr>
  21443. <th>Field</th>
  21444. <th>Description</th>
  21445. </tr>
  21446. </thead>
  21447. <tbody>
  21448. <tr>
  21449. <td>
  21450. <code>server</code></br>
  21451. <em>
  21452. <a href="#external-secrets.io/v1beta1.KubernetesServer">
  21453. KubernetesServer
  21454. </a>
  21455. </em>
  21456. </td>
  21457. <td>
  21458. <em>(Optional)</em>
  21459. <p>configures the Kubernetes server Address.</p>
  21460. </td>
  21461. </tr>
  21462. <tr>
  21463. <td>
  21464. <code>auth</code></br>
  21465. <em>
  21466. <a href="#external-secrets.io/v1beta1.KubernetesAuth">
  21467. KubernetesAuth
  21468. </a>
  21469. </em>
  21470. </td>
  21471. <td>
  21472. <em>(Optional)</em>
  21473. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  21474. </td>
  21475. </tr>
  21476. <tr>
  21477. <td>
  21478. <code>authRef</code></br>
  21479. <em>
  21480. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21481. External Secrets meta/v1.SecretKeySelector
  21482. </a>
  21483. </em>
  21484. </td>
  21485. <td>
  21486. <em>(Optional)</em>
  21487. <p>A reference to a secret that contains the auth information.</p>
  21488. </td>
  21489. </tr>
  21490. <tr>
  21491. <td>
  21492. <code>remoteNamespace</code></br>
  21493. <em>
  21494. string
  21495. </em>
  21496. </td>
  21497. <td>
  21498. <em>(Optional)</em>
  21499. <p>Remote namespace to fetch the secrets from</p>
  21500. </td>
  21501. </tr>
  21502. </tbody>
  21503. </table>
  21504. <h3 id="external-secrets.io/v1beta1.KubernetesServer">KubernetesServer
  21505. </h3>
  21506. <p>
  21507. (<em>Appears on:</em>
  21508. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  21509. </p>
  21510. <p>
  21511. <p>KubernetesServer defines the Kubernetes server connection configuration.</p>
  21512. </p>
  21513. <table>
  21514. <thead>
  21515. <tr>
  21516. <th>Field</th>
  21517. <th>Description</th>
  21518. </tr>
  21519. </thead>
  21520. <tbody>
  21521. <tr>
  21522. <td>
  21523. <code>url</code></br>
  21524. <em>
  21525. string
  21526. </em>
  21527. </td>
  21528. <td>
  21529. <em>(Optional)</em>
  21530. <p>configures the Kubernetes server Address.</p>
  21531. </td>
  21532. </tr>
  21533. <tr>
  21534. <td>
  21535. <code>caBundle</code></br>
  21536. <em>
  21537. []byte
  21538. </em>
  21539. </td>
  21540. <td>
  21541. <em>(Optional)</em>
  21542. <p>CABundle is a base64-encoded CA certificate</p>
  21543. </td>
  21544. </tr>
  21545. <tr>
  21546. <td>
  21547. <code>caProvider</code></br>
  21548. <em>
  21549. <a href="#external-secrets.io/v1beta1.CAProvider">
  21550. CAProvider
  21551. </a>
  21552. </em>
  21553. </td>
  21554. <td>
  21555. <em>(Optional)</em>
  21556. <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>
  21557. </td>
  21558. </tr>
  21559. </tbody>
  21560. </table>
  21561. <h3 id="external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  21562. </h3>
  21563. <p>
  21564. (<em>Appears on:</em>
  21565. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  21566. </p>
  21567. <p>
  21568. <p>MachineIdentityScopeInWorkspace defines the scope of a machine identity in an Infisical workspace.</p>
  21569. </p>
  21570. <table>
  21571. <thead>
  21572. <tr>
  21573. <th>Field</th>
  21574. <th>Description</th>
  21575. </tr>
  21576. </thead>
  21577. <tbody>
  21578. <tr>
  21579. <td>
  21580. <code>secretsPath</code></br>
  21581. <em>
  21582. string
  21583. </em>
  21584. </td>
  21585. <td>
  21586. <em>(Optional)</em>
  21587. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  21588. </td>
  21589. </tr>
  21590. <tr>
  21591. <td>
  21592. <code>recursive</code></br>
  21593. <em>
  21594. bool
  21595. </em>
  21596. </td>
  21597. <td>
  21598. <em>(Optional)</em>
  21599. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  21600. </td>
  21601. </tr>
  21602. <tr>
  21603. <td>
  21604. <code>environmentSlug</code></br>
  21605. <em>
  21606. string
  21607. </em>
  21608. </td>
  21609. <td>
  21610. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  21611. </td>
  21612. </tr>
  21613. <tr>
  21614. <td>
  21615. <code>projectSlug</code></br>
  21616. <em>
  21617. string
  21618. </em>
  21619. </td>
  21620. <td>
  21621. <p>ProjectSlug is the required slug identifier for the project.</p>
  21622. </td>
  21623. </tr>
  21624. <tr>
  21625. <td>
  21626. <code>expandSecretReferences</code></br>
  21627. <em>
  21628. bool
  21629. </em>
  21630. </td>
  21631. <td>
  21632. <em>(Optional)</em>
  21633. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  21634. </td>
  21635. </tr>
  21636. </tbody>
  21637. </table>
  21638. <h3 id="external-secrets.io/v1beta1.NTLMProtocol">NTLMProtocol
  21639. </h3>
  21640. <p>
  21641. (<em>Appears on:</em>
  21642. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol</a>)
  21643. </p>
  21644. <p>
  21645. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  21646. </p>
  21647. <table>
  21648. <thead>
  21649. <tr>
  21650. <th>Field</th>
  21651. <th>Description</th>
  21652. </tr>
  21653. </thead>
  21654. <tbody>
  21655. <tr>
  21656. <td>
  21657. <code>usernameSecret</code></br>
  21658. <em>
  21659. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21660. External Secrets meta/v1.SecretKeySelector
  21661. </a>
  21662. </em>
  21663. </td>
  21664. <td>
  21665. </td>
  21666. </tr>
  21667. <tr>
  21668. <td>
  21669. <code>passwordSecret</code></br>
  21670. <em>
  21671. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21672. External Secrets meta/v1.SecretKeySelector
  21673. </a>
  21674. </em>
  21675. </td>
  21676. <td>
  21677. </td>
  21678. </tr>
  21679. </tbody>
  21680. </table>
  21681. <h3 id="external-secrets.io/v1beta1.NoSecretError">NoSecretError
  21682. </h3>
  21683. <p>
  21684. <p>NoSecretError shall be returned when a GetSecret can not find the
  21685. desired secret. This is used for deletionPolicy.</p>
  21686. </p>
  21687. <h3 id="external-secrets.io/v1beta1.NotModifiedError">NotModifiedError
  21688. </h3>
  21689. <p>
  21690. <p>NotModifiedError to signal that the webhook received no changes,
  21691. and it should just return without doing anything.</p>
  21692. </p>
  21693. <h3 id="external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  21694. </h3>
  21695. <p>
  21696. (<em>Appears on:</em>
  21697. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider</a>)
  21698. </p>
  21699. <p>
  21700. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  21701. </p>
  21702. <table>
  21703. <thead>
  21704. <tr>
  21705. <th>Field</th>
  21706. <th>Description</th>
  21707. </tr>
  21708. </thead>
  21709. <tbody>
  21710. <tr>
  21711. <td>
  21712. <code>apiKeyRef</code></br>
  21713. <em>
  21714. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21715. External Secrets meta/v1.SecretKeySelector
  21716. </a>
  21717. </em>
  21718. </td>
  21719. <td>
  21720. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  21721. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  21722. </td>
  21723. </tr>
  21724. <tr>
  21725. <td>
  21726. <code>passcodeRef</code></br>
  21727. <em>
  21728. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21729. External Secrets meta/v1.SecretKeySelector
  21730. </a>
  21731. </em>
  21732. </td>
  21733. <td>
  21734. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  21735. </td>
  21736. </tr>
  21737. </tbody>
  21738. </table>
  21739. <h3 id="external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider
  21740. </h3>
  21741. <p>
  21742. (<em>Appears on:</em>
  21743. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21744. </p>
  21745. <p>
  21746. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  21747. Project and Config are required if not using a Service Token.</p>
  21748. </p>
  21749. <table>
  21750. <thead>
  21751. <tr>
  21752. <th>Field</th>
  21753. <th>Description</th>
  21754. </tr>
  21755. </thead>
  21756. <tbody>
  21757. <tr>
  21758. <td>
  21759. <code>auth</code></br>
  21760. <em>
  21761. <a href="#external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">
  21762. OnboardbaseAuthSecretRef
  21763. </a>
  21764. </em>
  21765. </td>
  21766. <td>
  21767. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  21768. </td>
  21769. </tr>
  21770. <tr>
  21771. <td>
  21772. <code>apiHost</code></br>
  21773. <em>
  21774. string
  21775. </em>
  21776. </td>
  21777. <td>
  21778. <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>
  21779. </td>
  21780. </tr>
  21781. <tr>
  21782. <td>
  21783. <code>project</code></br>
  21784. <em>
  21785. string
  21786. </em>
  21787. </td>
  21788. <td>
  21789. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  21790. </td>
  21791. </tr>
  21792. <tr>
  21793. <td>
  21794. <code>environment</code></br>
  21795. <em>
  21796. string
  21797. </em>
  21798. </td>
  21799. <td>
  21800. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  21801. </td>
  21802. </tr>
  21803. </tbody>
  21804. </table>
  21805. <h3 id="external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth
  21806. </h3>
  21807. <p>
  21808. (<em>Appears on:</em>
  21809. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider</a>)
  21810. </p>
  21811. <p>
  21812. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  21813. </p>
  21814. <table>
  21815. <thead>
  21816. <tr>
  21817. <th>Field</th>
  21818. <th>Description</th>
  21819. </tr>
  21820. </thead>
  21821. <tbody>
  21822. <tr>
  21823. <td>
  21824. <code>secretRef</code></br>
  21825. <em>
  21826. <a href="#external-secrets.io/v1beta1.OnePasswordAuthSecretRef">
  21827. OnePasswordAuthSecretRef
  21828. </a>
  21829. </em>
  21830. </td>
  21831. <td>
  21832. </td>
  21833. </tr>
  21834. </tbody>
  21835. </table>
  21836. <h3 id="external-secrets.io/v1beta1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  21837. </h3>
  21838. <p>
  21839. (<em>Appears on:</em>
  21840. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth</a>)
  21841. </p>
  21842. <p>
  21843. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  21844. </p>
  21845. <table>
  21846. <thead>
  21847. <tr>
  21848. <th>Field</th>
  21849. <th>Description</th>
  21850. </tr>
  21851. </thead>
  21852. <tbody>
  21853. <tr>
  21854. <td>
  21855. <code>connectTokenSecretRef</code></br>
  21856. <em>
  21857. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21858. External Secrets meta/v1.SecretKeySelector
  21859. </a>
  21860. </em>
  21861. </td>
  21862. <td>
  21863. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  21864. </td>
  21865. </tr>
  21866. </tbody>
  21867. </table>
  21868. <h3 id="external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider
  21869. </h3>
  21870. <p>
  21871. (<em>Appears on:</em>
  21872. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21873. </p>
  21874. <p>
  21875. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  21876. </p>
  21877. <table>
  21878. <thead>
  21879. <tr>
  21880. <th>Field</th>
  21881. <th>Description</th>
  21882. </tr>
  21883. </thead>
  21884. <tbody>
  21885. <tr>
  21886. <td>
  21887. <code>auth</code></br>
  21888. <em>
  21889. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">
  21890. OnePasswordAuth
  21891. </a>
  21892. </em>
  21893. </td>
  21894. <td>
  21895. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  21896. </td>
  21897. </tr>
  21898. <tr>
  21899. <td>
  21900. <code>connectHost</code></br>
  21901. <em>
  21902. string
  21903. </em>
  21904. </td>
  21905. <td>
  21906. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  21907. </td>
  21908. </tr>
  21909. <tr>
  21910. <td>
  21911. <code>vaults</code></br>
  21912. <em>
  21913. map[string]int
  21914. </em>
  21915. </td>
  21916. <td>
  21917. <p>Vaults defines which OnePassword vaults to search in which order</p>
  21918. </td>
  21919. </tr>
  21920. </tbody>
  21921. </table>
  21922. <h3 id="external-secrets.io/v1beta1.OracleAuth">OracleAuth
  21923. </h3>
  21924. <p>
  21925. (<em>Appears on:</em>
  21926. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  21927. </p>
  21928. <p>
  21929. <p>OracleAuth defines authentication configuration for the Oracle Vault provider.</p>
  21930. </p>
  21931. <table>
  21932. <thead>
  21933. <tr>
  21934. <th>Field</th>
  21935. <th>Description</th>
  21936. </tr>
  21937. </thead>
  21938. <tbody>
  21939. <tr>
  21940. <td>
  21941. <code>tenancy</code></br>
  21942. <em>
  21943. string
  21944. </em>
  21945. </td>
  21946. <td>
  21947. <p>Tenancy is the tenancy OCID where user is located.</p>
  21948. </td>
  21949. </tr>
  21950. <tr>
  21951. <td>
  21952. <code>user</code></br>
  21953. <em>
  21954. string
  21955. </em>
  21956. </td>
  21957. <td>
  21958. <p>User is an access OCID specific to the account.</p>
  21959. </td>
  21960. </tr>
  21961. <tr>
  21962. <td>
  21963. <code>secretRef</code></br>
  21964. <em>
  21965. <a href="#external-secrets.io/v1beta1.OracleSecretRef">
  21966. OracleSecretRef
  21967. </a>
  21968. </em>
  21969. </td>
  21970. <td>
  21971. <p>SecretRef to pass through sensitive information.</p>
  21972. </td>
  21973. </tr>
  21974. </tbody>
  21975. </table>
  21976. <h3 id="external-secrets.io/v1beta1.OraclePrincipalType">OraclePrincipalType
  21977. (<code>string</code> alias)</p></h3>
  21978. <p>
  21979. (<em>Appears on:</em>
  21980. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  21981. </p>
  21982. <p>
  21983. <p>OraclePrincipalType defines the type of principal used for authentication to Oracle Vault.</p>
  21984. </p>
  21985. <table>
  21986. <thead>
  21987. <tr>
  21988. <th>Value</th>
  21989. <th>Description</th>
  21990. </tr>
  21991. </thead>
  21992. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  21993. <td><p>InstancePrincipal represents a instance principal.</p>
  21994. </td>
  21995. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  21996. <td><p>UserPrincipal represents a user principal.</p>
  21997. </td>
  21998. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  21999. <td><p>WorkloadPrincipal represents a workload principal.</p>
  22000. </td>
  22001. </tr></tbody>
  22002. </table>
  22003. <h3 id="external-secrets.io/v1beta1.OracleProvider">OracleProvider
  22004. </h3>
  22005. <p>
  22006. (<em>Appears on:</em>
  22007. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22008. </p>
  22009. <p>
  22010. <p>OracleProvider configures a store to sync secrets using an Oracle Vault backend.</p>
  22011. </p>
  22012. <table>
  22013. <thead>
  22014. <tr>
  22015. <th>Field</th>
  22016. <th>Description</th>
  22017. </tr>
  22018. </thead>
  22019. <tbody>
  22020. <tr>
  22021. <td>
  22022. <code>region</code></br>
  22023. <em>
  22024. string
  22025. </em>
  22026. </td>
  22027. <td>
  22028. <p>Region is the region where vault is located.</p>
  22029. </td>
  22030. </tr>
  22031. <tr>
  22032. <td>
  22033. <code>vault</code></br>
  22034. <em>
  22035. string
  22036. </em>
  22037. </td>
  22038. <td>
  22039. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  22040. </td>
  22041. </tr>
  22042. <tr>
  22043. <td>
  22044. <code>compartment</code></br>
  22045. <em>
  22046. string
  22047. </em>
  22048. </td>
  22049. <td>
  22050. <em>(Optional)</em>
  22051. <p>Compartment is the vault compartment OCID.
  22052. Required for PushSecret</p>
  22053. </td>
  22054. </tr>
  22055. <tr>
  22056. <td>
  22057. <code>encryptionKey</code></br>
  22058. <em>
  22059. string
  22060. </em>
  22061. </td>
  22062. <td>
  22063. <em>(Optional)</em>
  22064. <p>EncryptionKey is the OCID of the encryption key within the vault.
  22065. Required for PushSecret</p>
  22066. </td>
  22067. </tr>
  22068. <tr>
  22069. <td>
  22070. <code>principalType</code></br>
  22071. <em>
  22072. <a href="#external-secrets.io/v1beta1.OraclePrincipalType">
  22073. OraclePrincipalType
  22074. </a>
  22075. </em>
  22076. </td>
  22077. <td>
  22078. <em>(Optional)</em>
  22079. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  22080. determine the principal type. This optional field must be specified if using
  22081. workload identity.</p>
  22082. </td>
  22083. </tr>
  22084. <tr>
  22085. <td>
  22086. <code>auth</code></br>
  22087. <em>
  22088. <a href="#external-secrets.io/v1beta1.OracleAuth">
  22089. OracleAuth
  22090. </a>
  22091. </em>
  22092. </td>
  22093. <td>
  22094. <em>(Optional)</em>
  22095. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  22096. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  22097. </td>
  22098. </tr>
  22099. <tr>
  22100. <td>
  22101. <code>serviceAccountRef</code></br>
  22102. <em>
  22103. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  22104. External Secrets meta/v1.ServiceAccountSelector
  22105. </a>
  22106. </em>
  22107. </td>
  22108. <td>
  22109. <em>(Optional)</em>
  22110. <p>ServiceAccountRef specified the service account
  22111. that should be used when authenticating with WorkloadIdentity.</p>
  22112. </td>
  22113. </tr>
  22114. </tbody>
  22115. </table>
  22116. <h3 id="external-secrets.io/v1beta1.OracleSecretRef">OracleSecretRef
  22117. </h3>
  22118. <p>
  22119. (<em>Appears on:</em>
  22120. <a href="#external-secrets.io/v1beta1.OracleAuth">OracleAuth</a>)
  22121. </p>
  22122. <p>
  22123. <p>OracleSecretRef defines references to secrets containing Oracle credentials.</p>
  22124. </p>
  22125. <table>
  22126. <thead>
  22127. <tr>
  22128. <th>Field</th>
  22129. <th>Description</th>
  22130. </tr>
  22131. </thead>
  22132. <tbody>
  22133. <tr>
  22134. <td>
  22135. <code>privatekey</code></br>
  22136. <em>
  22137. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22138. External Secrets meta/v1.SecretKeySelector
  22139. </a>
  22140. </em>
  22141. </td>
  22142. <td>
  22143. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  22144. </td>
  22145. </tr>
  22146. <tr>
  22147. <td>
  22148. <code>fingerprint</code></br>
  22149. <em>
  22150. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22151. External Secrets meta/v1.SecretKeySelector
  22152. </a>
  22153. </em>
  22154. </td>
  22155. <td>
  22156. <p>Fingerprint is the fingerprint of the API private key.</p>
  22157. </td>
  22158. </tr>
  22159. </tbody>
  22160. </table>
  22161. <h3 id="external-secrets.io/v1beta1.PassboltAuth">PassboltAuth
  22162. </h3>
  22163. <p>
  22164. (<em>Appears on:</em>
  22165. <a href="#external-secrets.io/v1beta1.PassboltProvider">PassboltProvider</a>)
  22166. </p>
  22167. <p>
  22168. <p>PassboltAuth contains credentials and configuration for authenticating with the Passbolt server.</p>
  22169. </p>
  22170. <table>
  22171. <thead>
  22172. <tr>
  22173. <th>Field</th>
  22174. <th>Description</th>
  22175. </tr>
  22176. </thead>
  22177. <tbody>
  22178. <tr>
  22179. <td>
  22180. <code>passwordSecretRef</code></br>
  22181. <em>
  22182. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22183. External Secrets meta/v1.SecretKeySelector
  22184. </a>
  22185. </em>
  22186. </td>
  22187. <td>
  22188. <p>PasswordSecretRef is a reference to the secret containing the Passbolt password</p>
  22189. </td>
  22190. </tr>
  22191. <tr>
  22192. <td>
  22193. <code>privateKeySecretRef</code></br>
  22194. <em>
  22195. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22196. External Secrets meta/v1.SecretKeySelector
  22197. </a>
  22198. </em>
  22199. </td>
  22200. <td>
  22201. <p>PrivateKeySecretRef is a reference to the secret containing the Passbolt private key</p>
  22202. </td>
  22203. </tr>
  22204. </tbody>
  22205. </table>
  22206. <h3 id="external-secrets.io/v1beta1.PassboltProvider">PassboltProvider
  22207. </h3>
  22208. <p>
  22209. (<em>Appears on:</em>
  22210. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22211. </p>
  22212. <p>
  22213. <p>PassboltProvider defines configuration for the Passbolt provider.</p>
  22214. </p>
  22215. <table>
  22216. <thead>
  22217. <tr>
  22218. <th>Field</th>
  22219. <th>Description</th>
  22220. </tr>
  22221. </thead>
  22222. <tbody>
  22223. <tr>
  22224. <td>
  22225. <code>auth</code></br>
  22226. <em>
  22227. <a href="#external-secrets.io/v1beta1.PassboltAuth">
  22228. PassboltAuth
  22229. </a>
  22230. </em>
  22231. </td>
  22232. <td>
  22233. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  22234. </td>
  22235. </tr>
  22236. <tr>
  22237. <td>
  22238. <code>host</code></br>
  22239. <em>
  22240. string
  22241. </em>
  22242. </td>
  22243. <td>
  22244. <p>Host defines the Passbolt Server to connect to</p>
  22245. </td>
  22246. </tr>
  22247. </tbody>
  22248. </table>
  22249. <h3 id="external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth
  22250. </h3>
  22251. <p>
  22252. (<em>Appears on:</em>
  22253. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider</a>)
  22254. </p>
  22255. <p>
  22256. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  22257. </p>
  22258. <table>
  22259. <thead>
  22260. <tr>
  22261. <th>Field</th>
  22262. <th>Description</th>
  22263. </tr>
  22264. </thead>
  22265. <tbody>
  22266. <tr>
  22267. <td>
  22268. <code>secretRef</code></br>
  22269. <em>
  22270. <a href="#external-secrets.io/v1beta1.PasswordDepotSecretRef">
  22271. PasswordDepotSecretRef
  22272. </a>
  22273. </em>
  22274. </td>
  22275. <td>
  22276. </td>
  22277. </tr>
  22278. </tbody>
  22279. </table>
  22280. <h3 id="external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider
  22281. </h3>
  22282. <p>
  22283. (<em>Appears on:</em>
  22284. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22285. </p>
  22286. <p>
  22287. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  22288. </p>
  22289. <table>
  22290. <thead>
  22291. <tr>
  22292. <th>Field</th>
  22293. <th>Description</th>
  22294. </tr>
  22295. </thead>
  22296. <tbody>
  22297. <tr>
  22298. <td>
  22299. <code>host</code></br>
  22300. <em>
  22301. string
  22302. </em>
  22303. </td>
  22304. <td>
  22305. <p>URL configures the Password Depot instance URL.</p>
  22306. </td>
  22307. </tr>
  22308. <tr>
  22309. <td>
  22310. <code>database</code></br>
  22311. <em>
  22312. string
  22313. </em>
  22314. </td>
  22315. <td>
  22316. <p>Database to use as source</p>
  22317. </td>
  22318. </tr>
  22319. <tr>
  22320. <td>
  22321. <code>auth</code></br>
  22322. <em>
  22323. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">
  22324. PasswordDepotAuth
  22325. </a>
  22326. </em>
  22327. </td>
  22328. <td>
  22329. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  22330. </td>
  22331. </tr>
  22332. </tbody>
  22333. </table>
  22334. <h3 id="external-secrets.io/v1beta1.PasswordDepotSecretRef">PasswordDepotSecretRef
  22335. </h3>
  22336. <p>
  22337. (<em>Appears on:</em>
  22338. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth</a>)
  22339. </p>
  22340. <p>
  22341. <p>PasswordDepotSecretRef defines a reference to a secret containing credentials for the Password Depot provider.</p>
  22342. </p>
  22343. <table>
  22344. <thead>
  22345. <tr>
  22346. <th>Field</th>
  22347. <th>Description</th>
  22348. </tr>
  22349. </thead>
  22350. <tbody>
  22351. <tr>
  22352. <td>
  22353. <code>credentials</code></br>
  22354. <em>
  22355. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22356. External Secrets meta/v1.SecretKeySelector
  22357. </a>
  22358. </em>
  22359. </td>
  22360. <td>
  22361. <em>(Optional)</em>
  22362. <p>Username / Password is used for authentication.</p>
  22363. </td>
  22364. </tr>
  22365. </tbody>
  22366. </table>
  22367. <h3 id="external-secrets.io/v1beta1.PreviderAuth">PreviderAuth
  22368. </h3>
  22369. <p>
  22370. (<em>Appears on:</em>
  22371. <a href="#external-secrets.io/v1beta1.PreviderProvider">PreviderProvider</a>)
  22372. </p>
  22373. <p>
  22374. <p>PreviderAuth contains a secretRef for credentials.</p>
  22375. </p>
  22376. <table>
  22377. <thead>
  22378. <tr>
  22379. <th>Field</th>
  22380. <th>Description</th>
  22381. </tr>
  22382. </thead>
  22383. <tbody>
  22384. <tr>
  22385. <td>
  22386. <code>secretRef</code></br>
  22387. <em>
  22388. <a href="#external-secrets.io/v1beta1.PreviderAuthSecretRef">
  22389. PreviderAuthSecretRef
  22390. </a>
  22391. </em>
  22392. </td>
  22393. <td>
  22394. <em>(Optional)</em>
  22395. </td>
  22396. </tr>
  22397. </tbody>
  22398. </table>
  22399. <h3 id="external-secrets.io/v1beta1.PreviderAuthSecretRef">PreviderAuthSecretRef
  22400. </h3>
  22401. <p>
  22402. (<em>Appears on:</em>
  22403. <a href="#external-secrets.io/v1beta1.PreviderAuth">PreviderAuth</a>)
  22404. </p>
  22405. <p>
  22406. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  22407. </p>
  22408. <table>
  22409. <thead>
  22410. <tr>
  22411. <th>Field</th>
  22412. <th>Description</th>
  22413. </tr>
  22414. </thead>
  22415. <tbody>
  22416. <tr>
  22417. <td>
  22418. <code>accessToken</code></br>
  22419. <em>
  22420. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22421. External Secrets meta/v1.SecretKeySelector
  22422. </a>
  22423. </em>
  22424. </td>
  22425. <td>
  22426. <p>The AccessToken is used for authentication</p>
  22427. </td>
  22428. </tr>
  22429. </tbody>
  22430. </table>
  22431. <h3 id="external-secrets.io/v1beta1.PreviderProvider">PreviderProvider
  22432. </h3>
  22433. <p>
  22434. (<em>Appears on:</em>
  22435. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22436. </p>
  22437. <p>
  22438. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  22439. </p>
  22440. <table>
  22441. <thead>
  22442. <tr>
  22443. <th>Field</th>
  22444. <th>Description</th>
  22445. </tr>
  22446. </thead>
  22447. <tbody>
  22448. <tr>
  22449. <td>
  22450. <code>auth</code></br>
  22451. <em>
  22452. <a href="#external-secrets.io/v1beta1.PreviderAuth">
  22453. PreviderAuth
  22454. </a>
  22455. </em>
  22456. </td>
  22457. <td>
  22458. </td>
  22459. </tr>
  22460. <tr>
  22461. <td>
  22462. <code>baseUri</code></br>
  22463. <em>
  22464. string
  22465. </em>
  22466. </td>
  22467. <td>
  22468. <em>(Optional)</em>
  22469. </td>
  22470. </tr>
  22471. </tbody>
  22472. </table>
  22473. <h3 id="external-secrets.io/v1beta1.Provider">Provider
  22474. </h3>
  22475. <p>
  22476. <p>Provider is a common interface for interacting with secret backends.</p>
  22477. </p>
  22478. <h3 id="external-secrets.io/v1beta1.PulumiProvider">PulumiProvider
  22479. </h3>
  22480. <p>
  22481. (<em>Appears on:</em>
  22482. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22483. </p>
  22484. <p>
  22485. <p>PulumiProvider defines configuration for the Pulumi provider.</p>
  22486. </p>
  22487. <table>
  22488. <thead>
  22489. <tr>
  22490. <th>Field</th>
  22491. <th>Description</th>
  22492. </tr>
  22493. </thead>
  22494. <tbody>
  22495. <tr>
  22496. <td>
  22497. <code>apiUrl</code></br>
  22498. <em>
  22499. string
  22500. </em>
  22501. </td>
  22502. <td>
  22503. <p>APIURL is the URL of the Pulumi API.</p>
  22504. </td>
  22505. </tr>
  22506. <tr>
  22507. <td>
  22508. <code>accessToken</code></br>
  22509. <em>
  22510. <a href="#external-secrets.io/v1beta1.PulumiProviderSecretRef">
  22511. PulumiProviderSecretRef
  22512. </a>
  22513. </em>
  22514. </td>
  22515. <td>
  22516. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  22517. </td>
  22518. </tr>
  22519. <tr>
  22520. <td>
  22521. <code>organization</code></br>
  22522. <em>
  22523. string
  22524. </em>
  22525. </td>
  22526. <td>
  22527. <p>Organization are a space to collaborate on shared projects and stacks.
  22528. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  22529. </td>
  22530. </tr>
  22531. <tr>
  22532. <td>
  22533. <code>project</code></br>
  22534. <em>
  22535. string
  22536. </em>
  22537. </td>
  22538. <td>
  22539. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  22540. </td>
  22541. </tr>
  22542. <tr>
  22543. <td>
  22544. <code>environment</code></br>
  22545. <em>
  22546. string
  22547. </em>
  22548. </td>
  22549. <td>
  22550. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  22551. dynamically retrieved values from supported providers including all major clouds,
  22552. and other Pulumi ESC environments.
  22553. 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>
  22554. </td>
  22555. </tr>
  22556. </tbody>
  22557. </table>
  22558. <h3 id="external-secrets.io/v1beta1.PulumiProviderSecretRef">PulumiProviderSecretRef
  22559. </h3>
  22560. <p>
  22561. (<em>Appears on:</em>
  22562. <a href="#external-secrets.io/v1beta1.PulumiProvider">PulumiProvider</a>)
  22563. </p>
  22564. <p>
  22565. <p>PulumiProviderSecretRef defines a reference to a secret containing credentials for the Pulumi provider.</p>
  22566. </p>
  22567. <table>
  22568. <thead>
  22569. <tr>
  22570. <th>Field</th>
  22571. <th>Description</th>
  22572. </tr>
  22573. </thead>
  22574. <tbody>
  22575. <tr>
  22576. <td>
  22577. <code>secretRef</code></br>
  22578. <em>
  22579. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22580. External Secrets meta/v1.SecretKeySelector
  22581. </a>
  22582. </em>
  22583. </td>
  22584. <td>
  22585. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  22586. </td>
  22587. </tr>
  22588. </tbody>
  22589. </table>
  22590. <h3 id="external-secrets.io/v1beta1.PushSecretData">PushSecretData
  22591. </h3>
  22592. <p>
  22593. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1beta1.</p>
  22594. </p>
  22595. <h3 id="external-secrets.io/v1beta1.PushSecretRemoteRef">PushSecretRemoteRef
  22596. </h3>
  22597. <p>
  22598. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1beta1.</p>
  22599. </p>
  22600. <h3 id="external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider
  22601. </h3>
  22602. <p>
  22603. (<em>Appears on:</em>
  22604. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22605. </p>
  22606. <p>
  22607. <p>ScalewayProvider defines configuration for the Scaleway provider.</p>
  22608. </p>
  22609. <table>
  22610. <thead>
  22611. <tr>
  22612. <th>Field</th>
  22613. <th>Description</th>
  22614. </tr>
  22615. </thead>
  22616. <tbody>
  22617. <tr>
  22618. <td>
  22619. <code>apiUrl</code></br>
  22620. <em>
  22621. string
  22622. </em>
  22623. </td>
  22624. <td>
  22625. <em>(Optional)</em>
  22626. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  22627. </td>
  22628. </tr>
  22629. <tr>
  22630. <td>
  22631. <code>region</code></br>
  22632. <em>
  22633. string
  22634. </em>
  22635. </td>
  22636. <td>
  22637. <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>
  22638. </td>
  22639. </tr>
  22640. <tr>
  22641. <td>
  22642. <code>projectId</code></br>
  22643. <em>
  22644. string
  22645. </em>
  22646. </td>
  22647. <td>
  22648. <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>
  22649. </td>
  22650. </tr>
  22651. <tr>
  22652. <td>
  22653. <code>accessKey</code></br>
  22654. <em>
  22655. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  22656. ScalewayProviderSecretRef
  22657. </a>
  22658. </em>
  22659. </td>
  22660. <td>
  22661. <p>AccessKey is the non-secret part of the api key.</p>
  22662. </td>
  22663. </tr>
  22664. <tr>
  22665. <td>
  22666. <code>secretKey</code></br>
  22667. <em>
  22668. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  22669. ScalewayProviderSecretRef
  22670. </a>
  22671. </em>
  22672. </td>
  22673. <td>
  22674. <p>SecretKey is the non-secret part of the api key.</p>
  22675. </td>
  22676. </tr>
  22677. </tbody>
  22678. </table>
  22679. <h3 id="external-secrets.io/v1beta1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  22680. </h3>
  22681. <p>
  22682. (<em>Appears on:</em>
  22683. <a href="#external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider</a>)
  22684. </p>
  22685. <p>
  22686. <p>ScalewayProviderSecretRef defines a reference to a secret containing credentials for the Scaleway provider.</p>
  22687. </p>
  22688. <table>
  22689. <thead>
  22690. <tr>
  22691. <th>Field</th>
  22692. <th>Description</th>
  22693. </tr>
  22694. </thead>
  22695. <tbody>
  22696. <tr>
  22697. <td>
  22698. <code>value</code></br>
  22699. <em>
  22700. string
  22701. </em>
  22702. </td>
  22703. <td>
  22704. <em>(Optional)</em>
  22705. <p>Value can be specified directly to set a value without using a secret.</p>
  22706. </td>
  22707. </tr>
  22708. <tr>
  22709. <td>
  22710. <code>secretRef</code></br>
  22711. <em>
  22712. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22713. External Secrets meta/v1.SecretKeySelector
  22714. </a>
  22715. </em>
  22716. </td>
  22717. <td>
  22718. <em>(Optional)</em>
  22719. <p>SecretRef references a key in a secret that will be used as value.</p>
  22720. </td>
  22721. </tr>
  22722. </tbody>
  22723. </table>
  22724. <h3 id="external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider
  22725. </h3>
  22726. <p>
  22727. (<em>Appears on:</em>
  22728. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  22729. </p>
  22730. <p>
  22731. <p>SecretServerProvider defines configuration for the Delinea Secret Server provider.
  22732. 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>
  22733. </p>
  22734. <table>
  22735. <thead>
  22736. <tr>
  22737. <th>Field</th>
  22738. <th>Description</th>
  22739. </tr>
  22740. </thead>
  22741. <tbody>
  22742. <tr>
  22743. <td>
  22744. <code>username</code></br>
  22745. <em>
  22746. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  22747. SecretServerProviderRef
  22748. </a>
  22749. </em>
  22750. </td>
  22751. <td>
  22752. <p>Username is the secret server account username.</p>
  22753. </td>
  22754. </tr>
  22755. <tr>
  22756. <td>
  22757. <code>password</code></br>
  22758. <em>
  22759. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  22760. SecretServerProviderRef
  22761. </a>
  22762. </em>
  22763. </td>
  22764. <td>
  22765. <p>Password is the secret server account password.</p>
  22766. </td>
  22767. </tr>
  22768. <tr>
  22769. <td>
  22770. <code>serverURL</code></br>
  22771. <em>
  22772. string
  22773. </em>
  22774. </td>
  22775. <td>
  22776. <p>ServerURL
  22777. URL to your secret server installation</p>
  22778. </td>
  22779. </tr>
  22780. </tbody>
  22781. </table>
  22782. <h3 id="external-secrets.io/v1beta1.SecretServerProviderRef">SecretServerProviderRef
  22783. </h3>
  22784. <p>
  22785. (<em>Appears on:</em>
  22786. <a href="#external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider</a>)
  22787. </p>
  22788. <p>
  22789. <p>SecretServerProviderRef defines a reference to a secret containing credentials for the Secret Server provider.</p>
  22790. </p>
  22791. <table>
  22792. <thead>
  22793. <tr>
  22794. <th>Field</th>
  22795. <th>Description</th>
  22796. </tr>
  22797. </thead>
  22798. <tbody>
  22799. <tr>
  22800. <td>
  22801. <code>value</code></br>
  22802. <em>
  22803. string
  22804. </em>
  22805. </td>
  22806. <td>
  22807. <em>(Optional)</em>
  22808. <p>Value can be specified directly to set a value without using a secret.</p>
  22809. </td>
  22810. </tr>
  22811. <tr>
  22812. <td>
  22813. <code>secretRef</code></br>
  22814. <em>
  22815. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22816. External Secrets meta/v1.SecretKeySelector
  22817. </a>
  22818. </em>
  22819. </td>
  22820. <td>
  22821. <em>(Optional)</em>
  22822. <p>SecretRef references a key in a secret that will be used as value.</p>
  22823. </td>
  22824. </tr>
  22825. </tbody>
  22826. </table>
  22827. <h3 id="external-secrets.io/v1beta1.SecretStore">SecretStore
  22828. </h3>
  22829. <p>
  22830. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  22831. </p>
  22832. <table>
  22833. <thead>
  22834. <tr>
  22835. <th>Field</th>
  22836. <th>Description</th>
  22837. </tr>
  22838. </thead>
  22839. <tbody>
  22840. <tr>
  22841. <td>
  22842. <code>metadata</code></br>
  22843. <em>
  22844. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  22845. Kubernetes meta/v1.ObjectMeta
  22846. </a>
  22847. </em>
  22848. </td>
  22849. <td>
  22850. Refer to the Kubernetes API documentation for the fields of the
  22851. <code>metadata</code> field.
  22852. </td>
  22853. </tr>
  22854. <tr>
  22855. <td>
  22856. <code>spec</code></br>
  22857. <em>
  22858. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  22859. SecretStoreSpec
  22860. </a>
  22861. </em>
  22862. </td>
  22863. <td>
  22864. <br/>
  22865. <br/>
  22866. <table>
  22867. <tr>
  22868. <td>
  22869. <code>controller</code></br>
  22870. <em>
  22871. string
  22872. </em>
  22873. </td>
  22874. <td>
  22875. <em>(Optional)</em>
  22876. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  22877. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  22878. </td>
  22879. </tr>
  22880. <tr>
  22881. <td>
  22882. <code>provider</code></br>
  22883. <em>
  22884. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  22885. SecretStoreProvider
  22886. </a>
  22887. </em>
  22888. </td>
  22889. <td>
  22890. <p>Used to configure the provider. Only one provider may be set</p>
  22891. </td>
  22892. </tr>
  22893. <tr>
  22894. <td>
  22895. <code>retrySettings</code></br>
  22896. <em>
  22897. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  22898. SecretStoreRetrySettings
  22899. </a>
  22900. </em>
  22901. </td>
  22902. <td>
  22903. <em>(Optional)</em>
  22904. <p>Used to configure HTTP retries on failures.</p>
  22905. </td>
  22906. </tr>
  22907. <tr>
  22908. <td>
  22909. <code>refreshInterval</code></br>
  22910. <em>
  22911. int
  22912. </em>
  22913. </td>
  22914. <td>
  22915. <em>(Optional)</em>
  22916. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  22917. </td>
  22918. </tr>
  22919. <tr>
  22920. <td>
  22921. <code>conditions</code></br>
  22922. <em>
  22923. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  22924. []ClusterSecretStoreCondition
  22925. </a>
  22926. </em>
  22927. </td>
  22928. <td>
  22929. <em>(Optional)</em>
  22930. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  22931. </td>
  22932. </tr>
  22933. </table>
  22934. </td>
  22935. </tr>
  22936. <tr>
  22937. <td>
  22938. <code>status</code></br>
  22939. <em>
  22940. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  22941. SecretStoreStatus
  22942. </a>
  22943. </em>
  22944. </td>
  22945. <td>
  22946. </td>
  22947. </tr>
  22948. </tbody>
  22949. </table>
  22950. <h3 id="external-secrets.io/v1beta1.SecretStoreCapabilities">SecretStoreCapabilities
  22951. (<code>string</code> alias)</p></h3>
  22952. <p>
  22953. (<em>Appears on:</em>
  22954. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  22955. </p>
  22956. <p>
  22957. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  22958. </p>
  22959. <table>
  22960. <thead>
  22961. <tr>
  22962. <th>Value</th>
  22963. <th>Description</th>
  22964. </tr>
  22965. </thead>
  22966. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  22967. <td><p>SecretStoreReadOnly indicates that the SecretStore only supports reading secrets.</p>
  22968. </td>
  22969. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  22970. <td><p>SecretStoreReadWrite indicates that the SecretStore supports both reading and writing secrets.</p>
  22971. </td>
  22972. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  22973. <td><p>SecretStoreWriteOnly indicates that the SecretStore only supports writing secrets.</p>
  22974. </td>
  22975. </tr></tbody>
  22976. </table>
  22977. <h3 id="external-secrets.io/v1beta1.SecretStoreConditionType">SecretStoreConditionType
  22978. (<code>string</code> alias)</p></h3>
  22979. <p>
  22980. (<em>Appears on:</em>
  22981. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  22982. </p>
  22983. <p>
  22984. <p>SecretStoreConditionType represents the condition type of the SecretStore.</p>
  22985. </p>
  22986. <table>
  22987. <thead>
  22988. <tr>
  22989. <th>Value</th>
  22990. <th>Description</th>
  22991. </tr>
  22992. </thead>
  22993. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  22994. <td><p>SecretStoreReady indicates that the SecretStore has been successfully configured.</p>
  22995. </td>
  22996. </tr></tbody>
  22997. </table>
  22998. <h3 id="external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider
  22999. </h3>
  23000. <p>
  23001. (<em>Appears on:</em>
  23002. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  23003. </p>
  23004. <p>
  23005. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  23006. </p>
  23007. <table>
  23008. <thead>
  23009. <tr>
  23010. <th>Field</th>
  23011. <th>Description</th>
  23012. </tr>
  23013. </thead>
  23014. <tbody>
  23015. <tr>
  23016. <td>
  23017. <code>aws</code></br>
  23018. <em>
  23019. <a href="#external-secrets.io/v1beta1.AWSProvider">
  23020. AWSProvider
  23021. </a>
  23022. </em>
  23023. </td>
  23024. <td>
  23025. <em>(Optional)</em>
  23026. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  23027. </td>
  23028. </tr>
  23029. <tr>
  23030. <td>
  23031. <code>azurekv</code></br>
  23032. <em>
  23033. <a href="#external-secrets.io/v1beta1.AzureKVProvider">
  23034. AzureKVProvider
  23035. </a>
  23036. </em>
  23037. </td>
  23038. <td>
  23039. <em>(Optional)</em>
  23040. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  23041. </td>
  23042. </tr>
  23043. <tr>
  23044. <td>
  23045. <code>akeyless</code></br>
  23046. <em>
  23047. <a href="#external-secrets.io/v1beta1.AkeylessProvider">
  23048. AkeylessProvider
  23049. </a>
  23050. </em>
  23051. </td>
  23052. <td>
  23053. <em>(Optional)</em>
  23054. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  23055. </td>
  23056. </tr>
  23057. <tr>
  23058. <td>
  23059. <code>bitwardensecretsmanager</code></br>
  23060. <em>
  23061. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">
  23062. BitwardenSecretsManagerProvider
  23063. </a>
  23064. </em>
  23065. </td>
  23066. <td>
  23067. <em>(Optional)</em>
  23068. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  23069. </td>
  23070. </tr>
  23071. <tr>
  23072. <td>
  23073. <code>vault</code></br>
  23074. <em>
  23075. <a href="#external-secrets.io/v1beta1.VaultProvider">
  23076. VaultProvider
  23077. </a>
  23078. </em>
  23079. </td>
  23080. <td>
  23081. <em>(Optional)</em>
  23082. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  23083. </td>
  23084. </tr>
  23085. <tr>
  23086. <td>
  23087. <code>gcpsm</code></br>
  23088. <em>
  23089. <a href="#external-secrets.io/v1beta1.GCPSMProvider">
  23090. GCPSMProvider
  23091. </a>
  23092. </em>
  23093. </td>
  23094. <td>
  23095. <em>(Optional)</em>
  23096. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  23097. </td>
  23098. </tr>
  23099. <tr>
  23100. <td>
  23101. <code>oracle</code></br>
  23102. <em>
  23103. <a href="#external-secrets.io/v1beta1.OracleProvider">
  23104. OracleProvider
  23105. </a>
  23106. </em>
  23107. </td>
  23108. <td>
  23109. <em>(Optional)</em>
  23110. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  23111. </td>
  23112. </tr>
  23113. <tr>
  23114. <td>
  23115. <code>ibm</code></br>
  23116. <em>
  23117. <a href="#external-secrets.io/v1beta1.IBMProvider">
  23118. IBMProvider
  23119. </a>
  23120. </em>
  23121. </td>
  23122. <td>
  23123. <em>(Optional)</em>
  23124. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  23125. </td>
  23126. </tr>
  23127. <tr>
  23128. <td>
  23129. <code>yandexcertificatemanager</code></br>
  23130. <em>
  23131. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">
  23132. YandexCertificateManagerProvider
  23133. </a>
  23134. </em>
  23135. </td>
  23136. <td>
  23137. <em>(Optional)</em>
  23138. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  23139. </td>
  23140. </tr>
  23141. <tr>
  23142. <td>
  23143. <code>yandexlockbox</code></br>
  23144. <em>
  23145. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">
  23146. YandexLockboxProvider
  23147. </a>
  23148. </em>
  23149. </td>
  23150. <td>
  23151. <em>(Optional)</em>
  23152. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  23153. </td>
  23154. </tr>
  23155. <tr>
  23156. <td>
  23157. <code>github</code></br>
  23158. <em>
  23159. <a href="#external-secrets.io/v1beta1.GithubProvider">
  23160. GithubProvider
  23161. </a>
  23162. </em>
  23163. </td>
  23164. <td>
  23165. <em>(Optional)</em>
  23166. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.</p>
  23167. </td>
  23168. </tr>
  23169. <tr>
  23170. <td>
  23171. <code>gitlab</code></br>
  23172. <em>
  23173. <a href="#external-secrets.io/v1beta1.GitlabProvider">
  23174. GitlabProvider
  23175. </a>
  23176. </em>
  23177. </td>
  23178. <td>
  23179. <em>(Optional)</em>
  23180. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  23181. </td>
  23182. </tr>
  23183. <tr>
  23184. <td>
  23185. <code>alibaba</code></br>
  23186. <em>
  23187. <a href="#external-secrets.io/v1beta1.AlibabaProvider">
  23188. AlibabaProvider
  23189. </a>
  23190. </em>
  23191. </td>
  23192. <td>
  23193. <em>(Optional)</em>
  23194. <p>Alibaba configures this store to sync secrets using Alibaba Cloud provider</p>
  23195. </td>
  23196. </tr>
  23197. <tr>
  23198. <td>
  23199. <code>onepassword</code></br>
  23200. <em>
  23201. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">
  23202. OnePasswordProvider
  23203. </a>
  23204. </em>
  23205. </td>
  23206. <td>
  23207. <em>(Optional)</em>
  23208. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  23209. </td>
  23210. </tr>
  23211. <tr>
  23212. <td>
  23213. <code>webhook</code></br>
  23214. <em>
  23215. <a href="#external-secrets.io/v1beta1.WebhookProvider">
  23216. WebhookProvider
  23217. </a>
  23218. </em>
  23219. </td>
  23220. <td>
  23221. <em>(Optional)</em>
  23222. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  23223. </td>
  23224. </tr>
  23225. <tr>
  23226. <td>
  23227. <code>kubernetes</code></br>
  23228. <em>
  23229. <a href="#external-secrets.io/v1beta1.KubernetesProvider">
  23230. KubernetesProvider
  23231. </a>
  23232. </em>
  23233. </td>
  23234. <td>
  23235. <em>(Optional)</em>
  23236. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  23237. </td>
  23238. </tr>
  23239. <tr>
  23240. <td>
  23241. <code>fake</code></br>
  23242. <em>
  23243. <a href="#external-secrets.io/v1beta1.FakeProvider">
  23244. FakeProvider
  23245. </a>
  23246. </em>
  23247. </td>
  23248. <td>
  23249. <em>(Optional)</em>
  23250. <p>Fake configures a store with static key/value pairs</p>
  23251. </td>
  23252. </tr>
  23253. <tr>
  23254. <td>
  23255. <code>senhasegura</code></br>
  23256. <em>
  23257. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">
  23258. SenhaseguraProvider
  23259. </a>
  23260. </em>
  23261. </td>
  23262. <td>
  23263. <em>(Optional)</em>
  23264. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  23265. </td>
  23266. </tr>
  23267. <tr>
  23268. <td>
  23269. <code>scaleway</code></br>
  23270. <em>
  23271. <a href="#external-secrets.io/v1beta1.ScalewayProvider">
  23272. ScalewayProvider
  23273. </a>
  23274. </em>
  23275. </td>
  23276. <td>
  23277. <em>(Optional)</em>
  23278. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  23279. </td>
  23280. </tr>
  23281. <tr>
  23282. <td>
  23283. <code>doppler</code></br>
  23284. <em>
  23285. <a href="#external-secrets.io/v1beta1.DopplerProvider">
  23286. DopplerProvider
  23287. </a>
  23288. </em>
  23289. </td>
  23290. <td>
  23291. <em>(Optional)</em>
  23292. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  23293. </td>
  23294. </tr>
  23295. <tr>
  23296. <td>
  23297. <code>previder</code></br>
  23298. <em>
  23299. <a href="#external-secrets.io/v1beta1.PreviderProvider">
  23300. PreviderProvider
  23301. </a>
  23302. </em>
  23303. </td>
  23304. <td>
  23305. <em>(Optional)</em>
  23306. <p>Previder configures this store to sync secrets using the Previder provider</p>
  23307. </td>
  23308. </tr>
  23309. <tr>
  23310. <td>
  23311. <code>onboardbase</code></br>
  23312. <em>
  23313. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">
  23314. OnboardbaseProvider
  23315. </a>
  23316. </em>
  23317. </td>
  23318. <td>
  23319. <em>(Optional)</em>
  23320. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  23321. </td>
  23322. </tr>
  23323. <tr>
  23324. <td>
  23325. <code>keepersecurity</code></br>
  23326. <em>
  23327. <a href="#external-secrets.io/v1beta1.KeeperSecurityProvider">
  23328. KeeperSecurityProvider
  23329. </a>
  23330. </em>
  23331. </td>
  23332. <td>
  23333. <em>(Optional)</em>
  23334. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  23335. </td>
  23336. </tr>
  23337. <tr>
  23338. <td>
  23339. <code>conjur</code></br>
  23340. <em>
  23341. <a href="#external-secrets.io/v1beta1.ConjurProvider">
  23342. ConjurProvider
  23343. </a>
  23344. </em>
  23345. </td>
  23346. <td>
  23347. <em>(Optional)</em>
  23348. <p>Conjur configures this store to sync secrets using conjur provider</p>
  23349. </td>
  23350. </tr>
  23351. <tr>
  23352. <td>
  23353. <code>delinea</code></br>
  23354. <em>
  23355. <a href="#external-secrets.io/v1beta1.DelineaProvider">
  23356. DelineaProvider
  23357. </a>
  23358. </em>
  23359. </td>
  23360. <td>
  23361. <em>(Optional)</em>
  23362. <p>Delinea DevOps Secrets Vault
  23363. <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>
  23364. </td>
  23365. </tr>
  23366. <tr>
  23367. <td>
  23368. <code>secretserver</code></br>
  23369. <em>
  23370. <a href="#external-secrets.io/v1beta1.SecretServerProvider">
  23371. SecretServerProvider
  23372. </a>
  23373. </em>
  23374. </td>
  23375. <td>
  23376. <em>(Optional)</em>
  23377. <p>SecretServer configures this store to sync secrets using SecretServer provider
  23378. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  23379. </td>
  23380. </tr>
  23381. <tr>
  23382. <td>
  23383. <code>chef</code></br>
  23384. <em>
  23385. <a href="#external-secrets.io/v1beta1.ChefProvider">
  23386. ChefProvider
  23387. </a>
  23388. </em>
  23389. </td>
  23390. <td>
  23391. <em>(Optional)</em>
  23392. <p>Chef configures this store to sync secrets with chef server</p>
  23393. </td>
  23394. </tr>
  23395. <tr>
  23396. <td>
  23397. <code>pulumi</code></br>
  23398. <em>
  23399. <a href="#external-secrets.io/v1beta1.PulumiProvider">
  23400. PulumiProvider
  23401. </a>
  23402. </em>
  23403. </td>
  23404. <td>
  23405. <em>(Optional)</em>
  23406. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  23407. </td>
  23408. </tr>
  23409. <tr>
  23410. <td>
  23411. <code>fortanix</code></br>
  23412. <em>
  23413. <a href="#external-secrets.io/v1beta1.FortanixProvider">
  23414. FortanixProvider
  23415. </a>
  23416. </em>
  23417. </td>
  23418. <td>
  23419. <em>(Optional)</em>
  23420. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  23421. </td>
  23422. </tr>
  23423. <tr>
  23424. <td>
  23425. <code>passworddepot</code></br>
  23426. <em>
  23427. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">
  23428. PasswordDepotProvider
  23429. </a>
  23430. </em>
  23431. </td>
  23432. <td>
  23433. <em>(Optional)</em>
  23434. </td>
  23435. </tr>
  23436. <tr>
  23437. <td>
  23438. <code>passbolt</code></br>
  23439. <em>
  23440. <a href="#external-secrets.io/v1beta1.PassboltProvider">
  23441. PassboltProvider
  23442. </a>
  23443. </em>
  23444. </td>
  23445. <td>
  23446. <em>(Optional)</em>
  23447. </td>
  23448. </tr>
  23449. <tr>
  23450. <td>
  23451. <code>device42</code></br>
  23452. <em>
  23453. <a href="#external-secrets.io/v1beta1.Device42Provider">
  23454. Device42Provider
  23455. </a>
  23456. </em>
  23457. </td>
  23458. <td>
  23459. <em>(Optional)</em>
  23460. <p>Device42 configures this store to sync secrets using the Device42 provider</p>
  23461. </td>
  23462. </tr>
  23463. <tr>
  23464. <td>
  23465. <code>infisical</code></br>
  23466. <em>
  23467. <a href="#external-secrets.io/v1beta1.InfisicalProvider">
  23468. InfisicalProvider
  23469. </a>
  23470. </em>
  23471. </td>
  23472. <td>
  23473. <em>(Optional)</em>
  23474. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  23475. </td>
  23476. </tr>
  23477. <tr>
  23478. <td>
  23479. <code>beyondtrust</code></br>
  23480. <em>
  23481. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">
  23482. BeyondtrustProvider
  23483. </a>
  23484. </em>
  23485. </td>
  23486. <td>
  23487. <em>(Optional)</em>
  23488. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  23489. </td>
  23490. </tr>
  23491. <tr>
  23492. <td>
  23493. <code>cloudrusm</code></br>
  23494. <em>
  23495. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">
  23496. CloudruSMProvider
  23497. </a>
  23498. </em>
  23499. </td>
  23500. <td>
  23501. <em>(Optional)</em>
  23502. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  23503. </td>
  23504. </tr>
  23505. </tbody>
  23506. </table>
  23507. <h3 id="external-secrets.io/v1beta1.SecretStoreRef">SecretStoreRef
  23508. </h3>
  23509. <p>
  23510. (<em>Appears on:</em>
  23511. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>,
  23512. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  23513. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  23514. </p>
  23515. <p>
  23516. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  23517. </p>
  23518. <table>
  23519. <thead>
  23520. <tr>
  23521. <th>Field</th>
  23522. <th>Description</th>
  23523. </tr>
  23524. </thead>
  23525. <tbody>
  23526. <tr>
  23527. <td>
  23528. <code>name</code></br>
  23529. <em>
  23530. string
  23531. </em>
  23532. </td>
  23533. <td>
  23534. <p>Name of the SecretStore resource</p>
  23535. </td>
  23536. </tr>
  23537. <tr>
  23538. <td>
  23539. <code>kind</code></br>
  23540. <em>
  23541. string
  23542. </em>
  23543. </td>
  23544. <td>
  23545. <em>(Optional)</em>
  23546. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  23547. Defaults to <code>SecretStore</code></p>
  23548. </td>
  23549. </tr>
  23550. </tbody>
  23551. </table>
  23552. <h3 id="external-secrets.io/v1beta1.SecretStoreRetrySettings">SecretStoreRetrySettings
  23553. </h3>
  23554. <p>
  23555. (<em>Appears on:</em>
  23556. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  23557. </p>
  23558. <p>
  23559. <p>SecretStoreRetrySettings defines configuration for retrying failed requests to the provider.</p>
  23560. </p>
  23561. <table>
  23562. <thead>
  23563. <tr>
  23564. <th>Field</th>
  23565. <th>Description</th>
  23566. </tr>
  23567. </thead>
  23568. <tbody>
  23569. <tr>
  23570. <td>
  23571. <code>maxRetries</code></br>
  23572. <em>
  23573. int32
  23574. </em>
  23575. </td>
  23576. <td>
  23577. <p>MaxRetries is the maximum number of retry attempts.</p>
  23578. </td>
  23579. </tr>
  23580. <tr>
  23581. <td>
  23582. <code>retryInterval</code></br>
  23583. <em>
  23584. string
  23585. </em>
  23586. </td>
  23587. <td>
  23588. <p>RetryInterval is the interval between retry attempts.</p>
  23589. </td>
  23590. </tr>
  23591. </tbody>
  23592. </table>
  23593. <h3 id="external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec
  23594. </h3>
  23595. <p>
  23596. (<em>Appears on:</em>
  23597. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  23598. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  23599. </p>
  23600. <p>
  23601. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  23602. </p>
  23603. <table>
  23604. <thead>
  23605. <tr>
  23606. <th>Field</th>
  23607. <th>Description</th>
  23608. </tr>
  23609. </thead>
  23610. <tbody>
  23611. <tr>
  23612. <td>
  23613. <code>controller</code></br>
  23614. <em>
  23615. string
  23616. </em>
  23617. </td>
  23618. <td>
  23619. <em>(Optional)</em>
  23620. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  23621. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  23622. </td>
  23623. </tr>
  23624. <tr>
  23625. <td>
  23626. <code>provider</code></br>
  23627. <em>
  23628. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  23629. SecretStoreProvider
  23630. </a>
  23631. </em>
  23632. </td>
  23633. <td>
  23634. <p>Used to configure the provider. Only one provider may be set</p>
  23635. </td>
  23636. </tr>
  23637. <tr>
  23638. <td>
  23639. <code>retrySettings</code></br>
  23640. <em>
  23641. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  23642. SecretStoreRetrySettings
  23643. </a>
  23644. </em>
  23645. </td>
  23646. <td>
  23647. <em>(Optional)</em>
  23648. <p>Used to configure HTTP retries on failures.</p>
  23649. </td>
  23650. </tr>
  23651. <tr>
  23652. <td>
  23653. <code>refreshInterval</code></br>
  23654. <em>
  23655. int
  23656. </em>
  23657. </td>
  23658. <td>
  23659. <em>(Optional)</em>
  23660. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  23661. </td>
  23662. </tr>
  23663. <tr>
  23664. <td>
  23665. <code>conditions</code></br>
  23666. <em>
  23667. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  23668. []ClusterSecretStoreCondition
  23669. </a>
  23670. </em>
  23671. </td>
  23672. <td>
  23673. <em>(Optional)</em>
  23674. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  23675. </td>
  23676. </tr>
  23677. </tbody>
  23678. </table>
  23679. <h3 id="external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus
  23680. </h3>
  23681. <p>
  23682. (<em>Appears on:</em>
  23683. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  23684. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  23685. </p>
  23686. <p>
  23687. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  23688. </p>
  23689. <table>
  23690. <thead>
  23691. <tr>
  23692. <th>Field</th>
  23693. <th>Description</th>
  23694. </tr>
  23695. </thead>
  23696. <tbody>
  23697. <tr>
  23698. <td>
  23699. <code>conditions</code></br>
  23700. <em>
  23701. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">
  23702. []SecretStoreStatusCondition
  23703. </a>
  23704. </em>
  23705. </td>
  23706. <td>
  23707. <em>(Optional)</em>
  23708. </td>
  23709. </tr>
  23710. <tr>
  23711. <td>
  23712. <code>capabilities</code></br>
  23713. <em>
  23714. <a href="#external-secrets.io/v1beta1.SecretStoreCapabilities">
  23715. SecretStoreCapabilities
  23716. </a>
  23717. </em>
  23718. </td>
  23719. <td>
  23720. <em>(Optional)</em>
  23721. </td>
  23722. </tr>
  23723. </tbody>
  23724. </table>
  23725. <h3 id="external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition
  23726. </h3>
  23727. <p>
  23728. (<em>Appears on:</em>
  23729. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  23730. </p>
  23731. <p>
  23732. <p>SecretStoreStatusCondition defines the observed condition of the SecretStore.</p>
  23733. </p>
  23734. <table>
  23735. <thead>
  23736. <tr>
  23737. <th>Field</th>
  23738. <th>Description</th>
  23739. </tr>
  23740. </thead>
  23741. <tbody>
  23742. <tr>
  23743. <td>
  23744. <code>type</code></br>
  23745. <em>
  23746. <a href="#external-secrets.io/v1beta1.SecretStoreConditionType">
  23747. SecretStoreConditionType
  23748. </a>
  23749. </em>
  23750. </td>
  23751. <td>
  23752. </td>
  23753. </tr>
  23754. <tr>
  23755. <td>
  23756. <code>status</code></br>
  23757. <em>
  23758. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  23759. Kubernetes core/v1.ConditionStatus
  23760. </a>
  23761. </em>
  23762. </td>
  23763. <td>
  23764. </td>
  23765. </tr>
  23766. <tr>
  23767. <td>
  23768. <code>reason</code></br>
  23769. <em>
  23770. string
  23771. </em>
  23772. </td>
  23773. <td>
  23774. <em>(Optional)</em>
  23775. </td>
  23776. </tr>
  23777. <tr>
  23778. <td>
  23779. <code>message</code></br>
  23780. <em>
  23781. string
  23782. </em>
  23783. </td>
  23784. <td>
  23785. <em>(Optional)</em>
  23786. </td>
  23787. </tr>
  23788. <tr>
  23789. <td>
  23790. <code>lastTransitionTime</code></br>
  23791. <em>
  23792. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  23793. Kubernetes meta/v1.Time
  23794. </a>
  23795. </em>
  23796. </td>
  23797. <td>
  23798. <em>(Optional)</em>
  23799. </td>
  23800. </tr>
  23801. </tbody>
  23802. </table>
  23803. <h3 id="external-secrets.io/v1beta1.SecretsClient">SecretsClient
  23804. </h3>
  23805. <p>
  23806. <p>SecretsClient provides access to secrets.</p>
  23807. </p>
  23808. <h3 id="external-secrets.io/v1beta1.SecretsManager">SecretsManager
  23809. </h3>
  23810. <p>
  23811. (<em>Appears on:</em>
  23812. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  23813. </p>
  23814. <p>
  23815. <p>SecretsManager defines how the provider behaves when interacting with AWS
  23816. SecretsManager. Some of these settings are only applicable to controlling how
  23817. secrets are deleted, and hence only apply to PushSecret (and only when
  23818. deletionPolicy is set to Delete).</p>
  23819. </p>
  23820. <table>
  23821. <thead>
  23822. <tr>
  23823. <th>Field</th>
  23824. <th>Description</th>
  23825. </tr>
  23826. </thead>
  23827. <tbody>
  23828. <tr>
  23829. <td>
  23830. <code>forceDeleteWithoutRecovery</code></br>
  23831. <em>
  23832. bool
  23833. </em>
  23834. </td>
  23835. <td>
  23836. <em>(Optional)</em>
  23837. <p>Specifies whether to delete the secret without any recovery window. You
  23838. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  23839. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  23840. recovery window.
  23841. 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>
  23842. </td>
  23843. </tr>
  23844. <tr>
  23845. <td>
  23846. <code>recoveryWindowInDays</code></br>
  23847. <em>
  23848. int64
  23849. </em>
  23850. </td>
  23851. <td>
  23852. <em>(Optional)</em>
  23853. <p>The number of days from 7 to 30 that Secrets Manager waits before
  23854. permanently deleting the secret. You can&rsquo;t use both this parameter and
  23855. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  23856. then by default Secrets Manager uses a 30 day recovery window.
  23857. 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>
  23858. </td>
  23859. </tr>
  23860. </tbody>
  23861. </table>
  23862. <h3 id="external-secrets.io/v1beta1.SenhaseguraAuth">SenhaseguraAuth
  23863. </h3>
  23864. <p>
  23865. (<em>Appears on:</em>
  23866. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  23867. </p>
  23868. <p>
  23869. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  23870. </p>
  23871. <table>
  23872. <thead>
  23873. <tr>
  23874. <th>Field</th>
  23875. <th>Description</th>
  23876. </tr>
  23877. </thead>
  23878. <tbody>
  23879. <tr>
  23880. <td>
  23881. <code>clientId</code></br>
  23882. <em>
  23883. string
  23884. </em>
  23885. </td>
  23886. <td>
  23887. </td>
  23888. </tr>
  23889. <tr>
  23890. <td>
  23891. <code>clientSecretSecretRef</code></br>
  23892. <em>
  23893. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23894. External Secrets meta/v1.SecretKeySelector
  23895. </a>
  23896. </em>
  23897. </td>
  23898. <td>
  23899. </td>
  23900. </tr>
  23901. </tbody>
  23902. </table>
  23903. <h3 id="external-secrets.io/v1beta1.SenhaseguraModuleType">SenhaseguraModuleType
  23904. (<code>string</code> alias)</p></h3>
  23905. <p>
  23906. (<em>Appears on:</em>
  23907. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  23908. </p>
  23909. <p>
  23910. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  23911. </p>
  23912. <table>
  23913. <thead>
  23914. <tr>
  23915. <th>Value</th>
  23916. <th>Description</th>
  23917. </tr>
  23918. </thead>
  23919. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  23920. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  23921. see: https://senhasegura.com/devops
  23922. </code></pre>
  23923. </td>
  23924. </tr></tbody>
  23925. </table>
  23926. <h3 id="external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider
  23927. </h3>
  23928. <p>
  23929. (<em>Appears on:</em>
  23930. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23931. </p>
  23932. <p>
  23933. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  23934. </p>
  23935. <table>
  23936. <thead>
  23937. <tr>
  23938. <th>Field</th>
  23939. <th>Description</th>
  23940. </tr>
  23941. </thead>
  23942. <tbody>
  23943. <tr>
  23944. <td>
  23945. <code>url</code></br>
  23946. <em>
  23947. string
  23948. </em>
  23949. </td>
  23950. <td>
  23951. <p>URL of senhasegura</p>
  23952. </td>
  23953. </tr>
  23954. <tr>
  23955. <td>
  23956. <code>module</code></br>
  23957. <em>
  23958. <a href="#external-secrets.io/v1beta1.SenhaseguraModuleType">
  23959. SenhaseguraModuleType
  23960. </a>
  23961. </em>
  23962. </td>
  23963. <td>
  23964. <p>Module defines which senhasegura module should be used to get secrets</p>
  23965. </td>
  23966. </tr>
  23967. <tr>
  23968. <td>
  23969. <code>auth</code></br>
  23970. <em>
  23971. <a href="#external-secrets.io/v1beta1.SenhaseguraAuth">
  23972. SenhaseguraAuth
  23973. </a>
  23974. </em>
  23975. </td>
  23976. <td>
  23977. <p>Auth defines parameters to authenticate in senhasegura</p>
  23978. </td>
  23979. </tr>
  23980. <tr>
  23981. <td>
  23982. <code>ignoreSslCertificate</code></br>
  23983. <em>
  23984. bool
  23985. </em>
  23986. </td>
  23987. <td>
  23988. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  23989. </td>
  23990. </tr>
  23991. </tbody>
  23992. </table>
  23993. <h3 id="external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  23994. </h3>
  23995. <p>
  23996. (<em>Appears on:</em>
  23997. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  23998. </p>
  23999. <p>
  24000. <p>StoreGeneratorSourceRef allows you to override the source
  24001. from which the secret will be pulled from.
  24002. You can define at maximum one property.</p>
  24003. </p>
  24004. <table>
  24005. <thead>
  24006. <tr>
  24007. <th>Field</th>
  24008. <th>Description</th>
  24009. </tr>
  24010. </thead>
  24011. <tbody>
  24012. <tr>
  24013. <td>
  24014. <code>storeRef</code></br>
  24015. <em>
  24016. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  24017. SecretStoreRef
  24018. </a>
  24019. </em>
  24020. </td>
  24021. <td>
  24022. <em>(Optional)</em>
  24023. </td>
  24024. </tr>
  24025. <tr>
  24026. <td>
  24027. <code>generatorRef</code></br>
  24028. <em>
  24029. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  24030. GeneratorRef
  24031. </a>
  24032. </em>
  24033. </td>
  24034. <td>
  24035. <em>(Optional)</em>
  24036. <p>GeneratorRef points to a generator custom resource.</p>
  24037. </td>
  24038. </tr>
  24039. </tbody>
  24040. </table>
  24041. <h3 id="external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef
  24042. </h3>
  24043. <p>
  24044. (<em>Appears on:</em>
  24045. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>)
  24046. </p>
  24047. <p>
  24048. <p>StoreSourceRef allows you to override the SecretStore source
  24049. from which the secret will be pulled from.
  24050. You can define at maximum one property.</p>
  24051. </p>
  24052. <table>
  24053. <thead>
  24054. <tr>
  24055. <th>Field</th>
  24056. <th>Description</th>
  24057. </tr>
  24058. </thead>
  24059. <tbody>
  24060. <tr>
  24061. <td>
  24062. <code>storeRef</code></br>
  24063. <em>
  24064. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  24065. SecretStoreRef
  24066. </a>
  24067. </em>
  24068. </td>
  24069. <td>
  24070. <em>(Optional)</em>
  24071. </td>
  24072. </tr>
  24073. <tr>
  24074. <td>
  24075. <code>generatorRef</code></br>
  24076. <em>
  24077. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  24078. GeneratorRef
  24079. </a>
  24080. </em>
  24081. </td>
  24082. <td>
  24083. <p>GeneratorRef points to a generator custom resource.</p>
  24084. <p>Deprecated: The generatorRef is not implemented in .data[].
  24085. this will be removed with v1.</p>
  24086. </td>
  24087. </tr>
  24088. </tbody>
  24089. </table>
  24090. <h3 id="external-secrets.io/v1beta1.Tag">Tag
  24091. </h3>
  24092. <p>
  24093. <p>Tag defines a tag key and value for AWS resources.</p>
  24094. </p>
  24095. <table>
  24096. <thead>
  24097. <tr>
  24098. <th>Field</th>
  24099. <th>Description</th>
  24100. </tr>
  24101. </thead>
  24102. <tbody>
  24103. <tr>
  24104. <td>
  24105. <code>key</code></br>
  24106. <em>
  24107. string
  24108. </em>
  24109. </td>
  24110. <td>
  24111. </td>
  24112. </tr>
  24113. <tr>
  24114. <td>
  24115. <code>value</code></br>
  24116. <em>
  24117. string
  24118. </em>
  24119. </td>
  24120. <td>
  24121. </td>
  24122. </tr>
  24123. </tbody>
  24124. </table>
  24125. <h3 id="external-secrets.io/v1beta1.TemplateEngineVersion">TemplateEngineVersion
  24126. (<code>string</code> alias)</p></h3>
  24127. <p>
  24128. (<em>Appears on:</em>
  24129. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  24130. </p>
  24131. <p>
  24132. <p>TemplateEngineVersion defines the version of the template engine to use.</p>
  24133. </p>
  24134. <table>
  24135. <thead>
  24136. <tr>
  24137. <th>Value</th>
  24138. <th>Description</th>
  24139. </tr>
  24140. </thead>
  24141. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  24142. <td><p>TemplateEngineV2 specifies the v2 template engine version.</p>
  24143. </td>
  24144. </tr></tbody>
  24145. </table>
  24146. <h3 id="external-secrets.io/v1beta1.TemplateFrom">TemplateFrom
  24147. </h3>
  24148. <p>
  24149. (<em>Appears on:</em>
  24150. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  24151. </p>
  24152. <p>
  24153. <p>TemplateFrom defines a source for template data.</p>
  24154. </p>
  24155. <table>
  24156. <thead>
  24157. <tr>
  24158. <th>Field</th>
  24159. <th>Description</th>
  24160. </tr>
  24161. </thead>
  24162. <tbody>
  24163. <tr>
  24164. <td>
  24165. <code>configMap</code></br>
  24166. <em>
  24167. <a href="#external-secrets.io/v1beta1.TemplateRef">
  24168. TemplateRef
  24169. </a>
  24170. </em>
  24171. </td>
  24172. <td>
  24173. </td>
  24174. </tr>
  24175. <tr>
  24176. <td>
  24177. <code>secret</code></br>
  24178. <em>
  24179. <a href="#external-secrets.io/v1beta1.TemplateRef">
  24180. TemplateRef
  24181. </a>
  24182. </em>
  24183. </td>
  24184. <td>
  24185. </td>
  24186. </tr>
  24187. <tr>
  24188. <td>
  24189. <code>target</code></br>
  24190. <em>
  24191. <a href="#external-secrets.io/v1beta1.TemplateTarget">
  24192. TemplateTarget
  24193. </a>
  24194. </em>
  24195. </td>
  24196. <td>
  24197. <em>(Optional)</em>
  24198. </td>
  24199. </tr>
  24200. <tr>
  24201. <td>
  24202. <code>literal</code></br>
  24203. <em>
  24204. string
  24205. </em>
  24206. </td>
  24207. <td>
  24208. <em>(Optional)</em>
  24209. </td>
  24210. </tr>
  24211. </tbody>
  24212. </table>
  24213. <h3 id="external-secrets.io/v1beta1.TemplateMergePolicy">TemplateMergePolicy
  24214. (<code>string</code> alias)</p></h3>
  24215. <p>
  24216. (<em>Appears on:</em>
  24217. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  24218. </p>
  24219. <p>
  24220. <p>TemplateMergePolicy defines how template values should be merged when generating a secret.</p>
  24221. </p>
  24222. <table>
  24223. <thead>
  24224. <tr>
  24225. <th>Value</th>
  24226. <th>Description</th>
  24227. </tr>
  24228. </thead>
  24229. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  24230. <td><p>MergePolicyMerge merges the template content with existing values.</p>
  24231. </td>
  24232. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  24233. <td><p>MergePolicyReplace replaces the entire template content during merge operations.</p>
  24234. </td>
  24235. </tr></tbody>
  24236. </table>
  24237. <h3 id="external-secrets.io/v1beta1.TemplateRef">TemplateRef
  24238. </h3>
  24239. <p>
  24240. (<em>Appears on:</em>
  24241. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  24242. </p>
  24243. <p>
  24244. <p>TemplateRef defines a reference to a template source in a ConfigMap or Secret.</p>
  24245. </p>
  24246. <table>
  24247. <thead>
  24248. <tr>
  24249. <th>Field</th>
  24250. <th>Description</th>
  24251. </tr>
  24252. </thead>
  24253. <tbody>
  24254. <tr>
  24255. <td>
  24256. <code>name</code></br>
  24257. <em>
  24258. string
  24259. </em>
  24260. </td>
  24261. <td>
  24262. <p>The name of the ConfigMap/Secret resource</p>
  24263. </td>
  24264. </tr>
  24265. <tr>
  24266. <td>
  24267. <code>items</code></br>
  24268. <em>
  24269. <a href="#external-secrets.io/v1beta1.TemplateRefItem">
  24270. []TemplateRefItem
  24271. </a>
  24272. </em>
  24273. </td>
  24274. <td>
  24275. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  24276. </td>
  24277. </tr>
  24278. </tbody>
  24279. </table>
  24280. <h3 id="external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem
  24281. </h3>
  24282. <p>
  24283. (<em>Appears on:</em>
  24284. <a href="#external-secrets.io/v1beta1.TemplateRef">TemplateRef</a>)
  24285. </p>
  24286. <p>
  24287. <p>TemplateRefItem defines which key in the referenced ConfigMap or Secret to use as a template.</p>
  24288. </p>
  24289. <table>
  24290. <thead>
  24291. <tr>
  24292. <th>Field</th>
  24293. <th>Description</th>
  24294. </tr>
  24295. </thead>
  24296. <tbody>
  24297. <tr>
  24298. <td>
  24299. <code>key</code></br>
  24300. <em>
  24301. string
  24302. </em>
  24303. </td>
  24304. <td>
  24305. <p>A key in the ConfigMap/Secret</p>
  24306. </td>
  24307. </tr>
  24308. <tr>
  24309. <td>
  24310. <code>templateAs</code></br>
  24311. <em>
  24312. <a href="#external-secrets.io/v1beta1.TemplateScope">
  24313. TemplateScope
  24314. </a>
  24315. </em>
  24316. </td>
  24317. <td>
  24318. </td>
  24319. </tr>
  24320. </tbody>
  24321. </table>
  24322. <h3 id="external-secrets.io/v1beta1.TemplateScope">TemplateScope
  24323. (<code>string</code> alias)</p></h3>
  24324. <p>
  24325. (<em>Appears on:</em>
  24326. <a href="#external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem</a>)
  24327. </p>
  24328. <p>
  24329. <p>TemplateScope defines the scope of the template when processing template data.</p>
  24330. </p>
  24331. <table>
  24332. <thead>
  24333. <tr>
  24334. <th>Value</th>
  24335. <th>Description</th>
  24336. </tr>
  24337. </thead>
  24338. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  24339. <td><p>TemplateScopeKeysAndValues processes both keys and values of the data.</p>
  24340. </td>
  24341. </tr><tr><td><p>&#34;Values&#34;</p></td>
  24342. <td><p>TemplateScopeValues processes only the values of the data.</p>
  24343. </td>
  24344. </tr></tbody>
  24345. </table>
  24346. <h3 id="external-secrets.io/v1beta1.TemplateTarget">TemplateTarget
  24347. (<code>string</code> alias)</p></h3>
  24348. <p>
  24349. (<em>Appears on:</em>
  24350. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  24351. </p>
  24352. <p>
  24353. <p>TemplateTarget defines the target field where the template result will be stored.</p>
  24354. </p>
  24355. <table>
  24356. <thead>
  24357. <tr>
  24358. <th>Value</th>
  24359. <th>Description</th>
  24360. </tr>
  24361. </thead>
  24362. <tbody><tr><td><p>&#34;Annotations&#34;</p></td>
  24363. <td><p>TemplateTargetAnnotations stores template results in the annotations field of the secret.</p>
  24364. </td>
  24365. </tr><tr><td><p>&#34;Data&#34;</p></td>
  24366. <td><p>TemplateTargetData stores template results in the data field of the secret.</p>
  24367. </td>
  24368. </tr><tr><td><p>&#34;Labels&#34;</p></td>
  24369. <td><p>TemplateTargetLabels stores template results in the labels field of the secret.</p>
  24370. </td>
  24371. </tr></tbody>
  24372. </table>
  24373. <h3 id="external-secrets.io/v1beta1.TokenAuth">TokenAuth
  24374. </h3>
  24375. <p>
  24376. (<em>Appears on:</em>
  24377. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  24378. </p>
  24379. <p>
  24380. <p>TokenAuth defines token-based authentication for the Kubernetes provider.</p>
  24381. </p>
  24382. <table>
  24383. <thead>
  24384. <tr>
  24385. <th>Field</th>
  24386. <th>Description</th>
  24387. </tr>
  24388. </thead>
  24389. <tbody>
  24390. <tr>
  24391. <td>
  24392. <code>bearerToken</code></br>
  24393. <em>
  24394. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24395. External Secrets meta/v1.SecretKeySelector
  24396. </a>
  24397. </em>
  24398. </td>
  24399. <td>
  24400. </td>
  24401. </tr>
  24402. </tbody>
  24403. </table>
  24404. <h3 id="external-secrets.io/v1beta1.UniversalAuthCredentials">UniversalAuthCredentials
  24405. </h3>
  24406. <p>
  24407. (<em>Appears on:</em>
  24408. <a href="#external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth</a>)
  24409. </p>
  24410. <p>
  24411. <p>UniversalAuthCredentials defines the credentials for Infisical Universal Auth.</p>
  24412. </p>
  24413. <table>
  24414. <thead>
  24415. <tr>
  24416. <th>Field</th>
  24417. <th>Description</th>
  24418. </tr>
  24419. </thead>
  24420. <tbody>
  24421. <tr>
  24422. <td>
  24423. <code>clientId</code></br>
  24424. <em>
  24425. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24426. External Secrets meta/v1.SecretKeySelector
  24427. </a>
  24428. </em>
  24429. </td>
  24430. <td>
  24431. </td>
  24432. </tr>
  24433. <tr>
  24434. <td>
  24435. <code>clientSecret</code></br>
  24436. <em>
  24437. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24438. External Secrets meta/v1.SecretKeySelector
  24439. </a>
  24440. </em>
  24441. </td>
  24442. <td>
  24443. </td>
  24444. </tr>
  24445. </tbody>
  24446. </table>
  24447. <h3 id="external-secrets.io/v1beta1.ValidationResult">ValidationResult
  24448. (<code>byte</code> alias)</p></h3>
  24449. <p>
  24450. <p>ValidationResult represents the result of validating a provider client configuration.</p>
  24451. </p>
  24452. <table>
  24453. <thead>
  24454. <tr>
  24455. <th>Value</th>
  24456. <th>Description</th>
  24457. </tr>
  24458. </thead>
  24459. <tbody><tr><td><p>2</p></td>
  24460. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  24461. </td>
  24462. </tr><tr><td><p>0</p></td>
  24463. <td><p>ValidationResultReady indicates that the client is configured correctly and can be used.</p>
  24464. </td>
  24465. </tr><tr><td><p>1</p></td>
  24466. <td><p>ValidationResultUnknown indicates that the client can be used but information is missing and it can not be validated.</p>
  24467. </td>
  24468. </tr></tbody>
  24469. </table>
  24470. <h3 id="external-secrets.io/v1beta1.VaultAppRole">VaultAppRole
  24471. </h3>
  24472. <p>
  24473. (<em>Appears on:</em>
  24474. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24475. </p>
  24476. <p>
  24477. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  24478. with the role and secret stored in a Kubernetes Secret resource.</p>
  24479. </p>
  24480. <table>
  24481. <thead>
  24482. <tr>
  24483. <th>Field</th>
  24484. <th>Description</th>
  24485. </tr>
  24486. </thead>
  24487. <tbody>
  24488. <tr>
  24489. <td>
  24490. <code>path</code></br>
  24491. <em>
  24492. string
  24493. </em>
  24494. </td>
  24495. <td>
  24496. <p>Path where the App Role authentication backend is mounted
  24497. in Vault, e.g: &ldquo;approle&rdquo;</p>
  24498. </td>
  24499. </tr>
  24500. <tr>
  24501. <td>
  24502. <code>roleId</code></br>
  24503. <em>
  24504. string
  24505. </em>
  24506. </td>
  24507. <td>
  24508. <em>(Optional)</em>
  24509. <p>RoleID configured in the App Role authentication backend when setting
  24510. up the authentication backend in Vault.</p>
  24511. </td>
  24512. </tr>
  24513. <tr>
  24514. <td>
  24515. <code>roleRef</code></br>
  24516. <em>
  24517. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24518. External Secrets meta/v1.SecretKeySelector
  24519. </a>
  24520. </em>
  24521. </td>
  24522. <td>
  24523. <em>(Optional)</em>
  24524. <p>Reference to a key in a Secret that contains the App Role ID used
  24525. to authenticate with Vault.
  24526. The <code>key</code> field must be specified and denotes which entry within the Secret
  24527. resource is used as the app role id.</p>
  24528. </td>
  24529. </tr>
  24530. <tr>
  24531. <td>
  24532. <code>secretRef</code></br>
  24533. <em>
  24534. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24535. External Secrets meta/v1.SecretKeySelector
  24536. </a>
  24537. </em>
  24538. </td>
  24539. <td>
  24540. <p>Reference to a key in a Secret that contains the App Role secret used
  24541. to authenticate with Vault.
  24542. The <code>key</code> field must be specified and denotes which entry within the Secret
  24543. resource is used as the app role secret.</p>
  24544. </td>
  24545. </tr>
  24546. </tbody>
  24547. </table>
  24548. <h3 id="external-secrets.io/v1beta1.VaultAuth">VaultAuth
  24549. </h3>
  24550. <p>
  24551. (<em>Appears on:</em>
  24552. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  24553. </p>
  24554. <p>
  24555. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  24556. 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>
  24557. can be specified. A namespace to authenticate against can optionally be specified.</p>
  24558. </p>
  24559. <table>
  24560. <thead>
  24561. <tr>
  24562. <th>Field</th>
  24563. <th>Description</th>
  24564. </tr>
  24565. </thead>
  24566. <tbody>
  24567. <tr>
  24568. <td>
  24569. <code>namespace</code></br>
  24570. <em>
  24571. string
  24572. </em>
  24573. </td>
  24574. <td>
  24575. <em>(Optional)</em>
  24576. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  24577. Namespaces is a set of features within Vault Enterprise that allows
  24578. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  24579. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  24580. This will default to Vault.Namespace field if set, or empty otherwise</p>
  24581. </td>
  24582. </tr>
  24583. <tr>
  24584. <td>
  24585. <code>tokenSecretRef</code></br>
  24586. <em>
  24587. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24588. External Secrets meta/v1.SecretKeySelector
  24589. </a>
  24590. </em>
  24591. </td>
  24592. <td>
  24593. <em>(Optional)</em>
  24594. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  24595. </td>
  24596. </tr>
  24597. <tr>
  24598. <td>
  24599. <code>appRole</code></br>
  24600. <em>
  24601. <a href="#external-secrets.io/v1beta1.VaultAppRole">
  24602. VaultAppRole
  24603. </a>
  24604. </em>
  24605. </td>
  24606. <td>
  24607. <em>(Optional)</em>
  24608. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  24609. with the role and secret stored in a Kubernetes Secret resource.</p>
  24610. </td>
  24611. </tr>
  24612. <tr>
  24613. <td>
  24614. <code>kubernetes</code></br>
  24615. <em>
  24616. <a href="#external-secrets.io/v1beta1.VaultKubernetesAuth">
  24617. VaultKubernetesAuth
  24618. </a>
  24619. </em>
  24620. </td>
  24621. <td>
  24622. <em>(Optional)</em>
  24623. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  24624. token stored in the named Secret resource to the Vault server.</p>
  24625. </td>
  24626. </tr>
  24627. <tr>
  24628. <td>
  24629. <code>ldap</code></br>
  24630. <em>
  24631. <a href="#external-secrets.io/v1beta1.VaultLdapAuth">
  24632. VaultLdapAuth
  24633. </a>
  24634. </em>
  24635. </td>
  24636. <td>
  24637. <em>(Optional)</em>
  24638. <p>Ldap authenticates with Vault by passing username/password pair using
  24639. the LDAP authentication method</p>
  24640. </td>
  24641. </tr>
  24642. <tr>
  24643. <td>
  24644. <code>jwt</code></br>
  24645. <em>
  24646. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">
  24647. VaultJwtAuth
  24648. </a>
  24649. </em>
  24650. </td>
  24651. <td>
  24652. <em>(Optional)</em>
  24653. <p>Jwt authenticates with Vault by passing role and JWT token using the
  24654. JWT/OIDC authentication method</p>
  24655. </td>
  24656. </tr>
  24657. <tr>
  24658. <td>
  24659. <code>cert</code></br>
  24660. <em>
  24661. <a href="#external-secrets.io/v1beta1.VaultCertAuth">
  24662. VaultCertAuth
  24663. </a>
  24664. </em>
  24665. </td>
  24666. <td>
  24667. <em>(Optional)</em>
  24668. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  24669. Cert authentication method</p>
  24670. </td>
  24671. </tr>
  24672. <tr>
  24673. <td>
  24674. <code>iam</code></br>
  24675. <em>
  24676. <a href="#external-secrets.io/v1beta1.VaultIamAuth">
  24677. VaultIamAuth
  24678. </a>
  24679. </em>
  24680. </td>
  24681. <td>
  24682. <em>(Optional)</em>
  24683. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  24684. AWS IAM authentication method</p>
  24685. </td>
  24686. </tr>
  24687. <tr>
  24688. <td>
  24689. <code>userPass</code></br>
  24690. <em>
  24691. <a href="#external-secrets.io/v1beta1.VaultUserPassAuth">
  24692. VaultUserPassAuth
  24693. </a>
  24694. </em>
  24695. </td>
  24696. <td>
  24697. <em>(Optional)</em>
  24698. <p>UserPass authenticates with Vault by passing username/password pair</p>
  24699. </td>
  24700. </tr>
  24701. </tbody>
  24702. </table>
  24703. <h3 id="external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth
  24704. </h3>
  24705. <p>
  24706. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  24707. Only one of secretRef or jwt can be specified.
  24708. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  24709. </p>
  24710. <table>
  24711. <thead>
  24712. <tr>
  24713. <th>Field</th>
  24714. <th>Description</th>
  24715. </tr>
  24716. </thead>
  24717. <tbody>
  24718. <tr>
  24719. <td>
  24720. <code>secretRef</code></br>
  24721. <em>
  24722. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  24723. VaultAwsAuthSecretRef
  24724. </a>
  24725. </em>
  24726. </td>
  24727. <td>
  24728. <em>(Optional)</em>
  24729. </td>
  24730. </tr>
  24731. <tr>
  24732. <td>
  24733. <code>jwt</code></br>
  24734. <em>
  24735. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  24736. VaultAwsJWTAuth
  24737. </a>
  24738. </em>
  24739. </td>
  24740. <td>
  24741. <em>(Optional)</em>
  24742. </td>
  24743. </tr>
  24744. </tbody>
  24745. </table>
  24746. <h3 id="external-secrets.io/v1beta1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  24747. </h3>
  24748. <p>
  24749. (<em>Appears on:</em>
  24750. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  24751. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  24752. </p>
  24753. <p>
  24754. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  24755. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  24756. </p>
  24757. <table>
  24758. <thead>
  24759. <tr>
  24760. <th>Field</th>
  24761. <th>Description</th>
  24762. </tr>
  24763. </thead>
  24764. <tbody>
  24765. <tr>
  24766. <td>
  24767. <code>accessKeyIDSecretRef</code></br>
  24768. <em>
  24769. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24770. External Secrets meta/v1.SecretKeySelector
  24771. </a>
  24772. </em>
  24773. </td>
  24774. <td>
  24775. <em>(Optional)</em>
  24776. <p>The AccessKeyID is used for authentication</p>
  24777. </td>
  24778. </tr>
  24779. <tr>
  24780. <td>
  24781. <code>secretAccessKeySecretRef</code></br>
  24782. <em>
  24783. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24784. External Secrets meta/v1.SecretKeySelector
  24785. </a>
  24786. </em>
  24787. </td>
  24788. <td>
  24789. <em>(Optional)</em>
  24790. <p>The SecretAccessKey is used for authentication</p>
  24791. </td>
  24792. </tr>
  24793. <tr>
  24794. <td>
  24795. <code>sessionTokenSecretRef</code></br>
  24796. <em>
  24797. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24798. External Secrets meta/v1.SecretKeySelector
  24799. </a>
  24800. </em>
  24801. </td>
  24802. <td>
  24803. <em>(Optional)</em>
  24804. <p>The SessionToken used for authentication
  24805. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  24806. 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>
  24807. </td>
  24808. </tr>
  24809. </tbody>
  24810. </table>
  24811. <h3 id="external-secrets.io/v1beta1.VaultAwsJWTAuth">VaultAwsJWTAuth
  24812. </h3>
  24813. <p>
  24814. (<em>Appears on:</em>
  24815. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  24816. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  24817. </p>
  24818. <p>
  24819. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  24820. </p>
  24821. <table>
  24822. <thead>
  24823. <tr>
  24824. <th>Field</th>
  24825. <th>Description</th>
  24826. </tr>
  24827. </thead>
  24828. <tbody>
  24829. <tr>
  24830. <td>
  24831. <code>serviceAccountRef</code></br>
  24832. <em>
  24833. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  24834. External Secrets meta/v1.ServiceAccountSelector
  24835. </a>
  24836. </em>
  24837. </td>
  24838. <td>
  24839. <em>(Optional)</em>
  24840. </td>
  24841. </tr>
  24842. </tbody>
  24843. </table>
  24844. <h3 id="external-secrets.io/v1beta1.VaultCertAuth">VaultCertAuth
  24845. </h3>
  24846. <p>
  24847. (<em>Appears on:</em>
  24848. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24849. </p>
  24850. <p>
  24851. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  24852. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  24853. </p>
  24854. <table>
  24855. <thead>
  24856. <tr>
  24857. <th>Field</th>
  24858. <th>Description</th>
  24859. </tr>
  24860. </thead>
  24861. <tbody>
  24862. <tr>
  24863. <td>
  24864. <code>clientCert</code></br>
  24865. <em>
  24866. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24867. External Secrets meta/v1.SecretKeySelector
  24868. </a>
  24869. </em>
  24870. </td>
  24871. <td>
  24872. <em>(Optional)</em>
  24873. <p>ClientCert is a certificate to authenticate using the Cert Vault
  24874. authentication method</p>
  24875. </td>
  24876. </tr>
  24877. <tr>
  24878. <td>
  24879. <code>secretRef</code></br>
  24880. <em>
  24881. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24882. External Secrets meta/v1.SecretKeySelector
  24883. </a>
  24884. </em>
  24885. </td>
  24886. <td>
  24887. <em>(Optional)</em>
  24888. <p>SecretRef to a key in a Secret resource containing client private key to
  24889. authenticate with Vault using the Cert authentication method</p>
  24890. </td>
  24891. </tr>
  24892. </tbody>
  24893. </table>
  24894. <h3 id="external-secrets.io/v1beta1.VaultClientTLS">VaultClientTLS
  24895. </h3>
  24896. <p>
  24897. (<em>Appears on:</em>
  24898. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  24899. </p>
  24900. <p>
  24901. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  24902. when the Vault server requires mutual authentication.</p>
  24903. </p>
  24904. <table>
  24905. <thead>
  24906. <tr>
  24907. <th>Field</th>
  24908. <th>Description</th>
  24909. </tr>
  24910. </thead>
  24911. <tbody>
  24912. <tr>
  24913. <td>
  24914. <code>certSecretRef</code></br>
  24915. <em>
  24916. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24917. External Secrets meta/v1.SecretKeySelector
  24918. </a>
  24919. </em>
  24920. </td>
  24921. <td>
  24922. <em>(Optional)</em>
  24923. <p>CertSecretRef is a certificate added to the transport layer
  24924. when communicating with the Vault server.
  24925. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  24926. </td>
  24927. </tr>
  24928. <tr>
  24929. <td>
  24930. <code>keySecretRef</code></br>
  24931. <em>
  24932. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24933. External Secrets meta/v1.SecretKeySelector
  24934. </a>
  24935. </em>
  24936. </td>
  24937. <td>
  24938. <em>(Optional)</em>
  24939. <p>KeySecretRef to a key in a Secret resource containing client private key
  24940. added to the transport layer when communicating with the Vault server.
  24941. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  24942. </td>
  24943. </tr>
  24944. </tbody>
  24945. </table>
  24946. <h3 id="external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth
  24947. </h3>
  24948. <p>
  24949. (<em>Appears on:</em>
  24950. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24951. </p>
  24952. <p>
  24953. <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>
  24954. </p>
  24955. <table>
  24956. <thead>
  24957. <tr>
  24958. <th>Field</th>
  24959. <th>Description</th>
  24960. </tr>
  24961. </thead>
  24962. <tbody>
  24963. <tr>
  24964. <td>
  24965. <code>path</code></br>
  24966. <em>
  24967. string
  24968. </em>
  24969. </td>
  24970. <td>
  24971. <em>(Optional)</em>
  24972. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  24973. </td>
  24974. </tr>
  24975. <tr>
  24976. <td>
  24977. <code>region</code></br>
  24978. <em>
  24979. string
  24980. </em>
  24981. </td>
  24982. <td>
  24983. <em>(Optional)</em>
  24984. <p>AWS region</p>
  24985. </td>
  24986. </tr>
  24987. <tr>
  24988. <td>
  24989. <code>role</code></br>
  24990. <em>
  24991. string
  24992. </em>
  24993. </td>
  24994. <td>
  24995. <em>(Optional)</em>
  24996. <p>This is the AWS role to be assumed before talking to vault</p>
  24997. </td>
  24998. </tr>
  24999. <tr>
  25000. <td>
  25001. <code>vaultRole</code></br>
  25002. <em>
  25003. string
  25004. </em>
  25005. </td>
  25006. <td>
  25007. <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>
  25008. </td>
  25009. </tr>
  25010. <tr>
  25011. <td>
  25012. <code>externalID</code></br>
  25013. <em>
  25014. string
  25015. </em>
  25016. </td>
  25017. <td>
  25018. <p>AWS External ID set on assumed IAM roles</p>
  25019. </td>
  25020. </tr>
  25021. <tr>
  25022. <td>
  25023. <code>vaultAwsIamServerID</code></br>
  25024. <em>
  25025. string
  25026. </em>
  25027. </td>
  25028. <td>
  25029. <em>(Optional)</em>
  25030. <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>
  25031. </td>
  25032. </tr>
  25033. <tr>
  25034. <td>
  25035. <code>secretRef</code></br>
  25036. <em>
  25037. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  25038. VaultAwsAuthSecretRef
  25039. </a>
  25040. </em>
  25041. </td>
  25042. <td>
  25043. <em>(Optional)</em>
  25044. <p>Specify credentials in a Secret object</p>
  25045. </td>
  25046. </tr>
  25047. <tr>
  25048. <td>
  25049. <code>jwt</code></br>
  25050. <em>
  25051. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  25052. VaultAwsJWTAuth
  25053. </a>
  25054. </em>
  25055. </td>
  25056. <td>
  25057. <em>(Optional)</em>
  25058. <p>Specify a service account with IRSA enabled</p>
  25059. </td>
  25060. </tr>
  25061. </tbody>
  25062. </table>
  25063. <h3 id="external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth
  25064. </h3>
  25065. <p>
  25066. (<em>Appears on:</em>
  25067. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25068. </p>
  25069. <p>
  25070. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  25071. method, with the role name and a token stored in a Kubernetes Secret resource or
  25072. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  25073. </p>
  25074. <table>
  25075. <thead>
  25076. <tr>
  25077. <th>Field</th>
  25078. <th>Description</th>
  25079. </tr>
  25080. </thead>
  25081. <tbody>
  25082. <tr>
  25083. <td>
  25084. <code>path</code></br>
  25085. <em>
  25086. string
  25087. </em>
  25088. </td>
  25089. <td>
  25090. <p>Path where the JWT authentication backend is mounted
  25091. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  25092. </td>
  25093. </tr>
  25094. <tr>
  25095. <td>
  25096. <code>role</code></br>
  25097. <em>
  25098. string
  25099. </em>
  25100. </td>
  25101. <td>
  25102. <em>(Optional)</em>
  25103. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  25104. authentication method</p>
  25105. </td>
  25106. </tr>
  25107. <tr>
  25108. <td>
  25109. <code>secretRef</code></br>
  25110. <em>
  25111. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25112. External Secrets meta/v1.SecretKeySelector
  25113. </a>
  25114. </em>
  25115. </td>
  25116. <td>
  25117. <em>(Optional)</em>
  25118. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  25119. authenticate with Vault using the JWT/OIDC authentication method.</p>
  25120. </td>
  25121. </tr>
  25122. <tr>
  25123. <td>
  25124. <code>kubernetesServiceAccountToken</code></br>
  25125. <em>
  25126. <a href="#external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">
  25127. VaultKubernetesServiceAccountTokenAuth
  25128. </a>
  25129. </em>
  25130. </td>
  25131. <td>
  25132. <em>(Optional)</em>
  25133. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  25134. a token for with the <code>TokenRequest</code> API.</p>
  25135. </td>
  25136. </tr>
  25137. </tbody>
  25138. </table>
  25139. <h3 id="external-secrets.io/v1beta1.VaultKVStoreVersion">VaultKVStoreVersion
  25140. (<code>string</code> alias)</p></h3>
  25141. <p>
  25142. (<em>Appears on:</em>
  25143. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  25144. </p>
  25145. <p>
  25146. <p>VaultKVStoreVersion defines the version of the KV store in Vault.</p>
  25147. </p>
  25148. <table>
  25149. <thead>
  25150. <tr>
  25151. <th>Value</th>
  25152. <th>Description</th>
  25153. </tr>
  25154. </thead>
  25155. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  25156. <td><p>VaultKVStoreV1 represents version 1 of the Vault KV store.</p>
  25157. </td>
  25158. </tr><tr><td><p>&#34;v2&#34;</p></td>
  25159. <td><p>VaultKVStoreV2 represents version 2 of the Vault KV store.</p>
  25160. </td>
  25161. </tr></tbody>
  25162. </table>
  25163. <h3 id="external-secrets.io/v1beta1.VaultKubernetesAuth">VaultKubernetesAuth
  25164. </h3>
  25165. <p>
  25166. (<em>Appears on:</em>
  25167. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25168. </p>
  25169. <p>
  25170. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in a Secret.</p>
  25171. </p>
  25172. <table>
  25173. <thead>
  25174. <tr>
  25175. <th>Field</th>
  25176. <th>Description</th>
  25177. </tr>
  25178. </thead>
  25179. <tbody>
  25180. <tr>
  25181. <td>
  25182. <code>mountPath</code></br>
  25183. <em>
  25184. string
  25185. </em>
  25186. </td>
  25187. <td>
  25188. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  25189. &ldquo;kubernetes&rdquo;</p>
  25190. </td>
  25191. </tr>
  25192. <tr>
  25193. <td>
  25194. <code>serviceAccountRef</code></br>
  25195. <em>
  25196. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  25197. External Secrets meta/v1.ServiceAccountSelector
  25198. </a>
  25199. </em>
  25200. </td>
  25201. <td>
  25202. <em>(Optional)</em>
  25203. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  25204. If the service account is specified, the service account secret token JWT will be used
  25205. for authenticating with Vault. If the service account selector is not supplied,
  25206. the secretRef will be used instead.</p>
  25207. </td>
  25208. </tr>
  25209. <tr>
  25210. <td>
  25211. <code>secretRef</code></br>
  25212. <em>
  25213. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25214. External Secrets meta/v1.SecretKeySelector
  25215. </a>
  25216. </em>
  25217. </td>
  25218. <td>
  25219. <em>(Optional)</em>
  25220. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  25221. for authenticating with Vault. If a name is specified without a key,
  25222. <code>token</code> is the default. If one is not specified, the one bound to
  25223. the controller will be used.</p>
  25224. </td>
  25225. </tr>
  25226. <tr>
  25227. <td>
  25228. <code>role</code></br>
  25229. <em>
  25230. string
  25231. </em>
  25232. </td>
  25233. <td>
  25234. <p>A required field containing the Vault Role to assume. A Role binds a
  25235. Kubernetes ServiceAccount with a set of Vault policies.</p>
  25236. </td>
  25237. </tr>
  25238. </tbody>
  25239. </table>
  25240. <h3 id="external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  25241. </h3>
  25242. <p>
  25243. (<em>Appears on:</em>
  25244. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth</a>)
  25245. </p>
  25246. <p>
  25247. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  25248. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  25249. </p>
  25250. <table>
  25251. <thead>
  25252. <tr>
  25253. <th>Field</th>
  25254. <th>Description</th>
  25255. </tr>
  25256. </thead>
  25257. <tbody>
  25258. <tr>
  25259. <td>
  25260. <code>serviceAccountRef</code></br>
  25261. <em>
  25262. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  25263. External Secrets meta/v1.ServiceAccountSelector
  25264. </a>
  25265. </em>
  25266. </td>
  25267. <td>
  25268. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  25269. </td>
  25270. </tr>
  25271. <tr>
  25272. <td>
  25273. <code>audiences</code></br>
  25274. <em>
  25275. []string
  25276. </em>
  25277. </td>
  25278. <td>
  25279. <em>(Optional)</em>
  25280. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  25281. account token for the service account referenced by <code>serviceAccountRef</code>.
  25282. Defaults to a single audience <code>vault</code> it not specified.</p>
  25283. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  25284. </td>
  25285. </tr>
  25286. <tr>
  25287. <td>
  25288. <code>expirationSeconds</code></br>
  25289. <em>
  25290. int64
  25291. </em>
  25292. </td>
  25293. <td>
  25294. <em>(Optional)</em>
  25295. <p>Optional expiration time in seconds that will be used to request a temporary
  25296. Kubernetes service account token for the service account referenced by
  25297. <code>serviceAccountRef</code>.</p>
  25298. <p>Deprecated: this will be removed in the future.
  25299. Defaults to 10 minutes.</p>
  25300. </td>
  25301. </tr>
  25302. </tbody>
  25303. </table>
  25304. <h3 id="external-secrets.io/v1beta1.VaultLdapAuth">VaultLdapAuth
  25305. </h3>
  25306. <p>
  25307. (<em>Appears on:</em>
  25308. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25309. </p>
  25310. <p>
  25311. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  25312. with the username and password stored in a Kubernetes Secret resource.</p>
  25313. </p>
  25314. <table>
  25315. <thead>
  25316. <tr>
  25317. <th>Field</th>
  25318. <th>Description</th>
  25319. </tr>
  25320. </thead>
  25321. <tbody>
  25322. <tr>
  25323. <td>
  25324. <code>path</code></br>
  25325. <em>
  25326. string
  25327. </em>
  25328. </td>
  25329. <td>
  25330. <p>Path where the LDAP authentication backend is mounted
  25331. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  25332. </td>
  25333. </tr>
  25334. <tr>
  25335. <td>
  25336. <code>username</code></br>
  25337. <em>
  25338. string
  25339. </em>
  25340. </td>
  25341. <td>
  25342. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  25343. authentication method</p>
  25344. </td>
  25345. </tr>
  25346. <tr>
  25347. <td>
  25348. <code>secretRef</code></br>
  25349. <em>
  25350. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25351. External Secrets meta/v1.SecretKeySelector
  25352. </a>
  25353. </em>
  25354. </td>
  25355. <td>
  25356. <em>(Optional)</em>
  25357. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  25358. user used to authenticate with Vault using the LDAP authentication
  25359. method</p>
  25360. </td>
  25361. </tr>
  25362. </tbody>
  25363. </table>
  25364. <h3 id="external-secrets.io/v1beta1.VaultProvider">VaultProvider
  25365. </h3>
  25366. <p>
  25367. (<em>Appears on:</em>
  25368. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  25369. </p>
  25370. <p>
  25371. <p>VaultProvider configures a store to sync secrets using a HashiCorp Vault KV backend.</p>
  25372. </p>
  25373. <table>
  25374. <thead>
  25375. <tr>
  25376. <th>Field</th>
  25377. <th>Description</th>
  25378. </tr>
  25379. </thead>
  25380. <tbody>
  25381. <tr>
  25382. <td>
  25383. <code>auth</code></br>
  25384. <em>
  25385. <a href="#external-secrets.io/v1beta1.VaultAuth">
  25386. VaultAuth
  25387. </a>
  25388. </em>
  25389. </td>
  25390. <td>
  25391. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  25392. </td>
  25393. </tr>
  25394. <tr>
  25395. <td>
  25396. <code>server</code></br>
  25397. <em>
  25398. string
  25399. </em>
  25400. </td>
  25401. <td>
  25402. <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>
  25403. </td>
  25404. </tr>
  25405. <tr>
  25406. <td>
  25407. <code>path</code></br>
  25408. <em>
  25409. string
  25410. </em>
  25411. </td>
  25412. <td>
  25413. <em>(Optional)</em>
  25414. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  25415. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  25416. for fetching secrets from Vault is optional and will be appended
  25417. if not present in specified path.</p>
  25418. </td>
  25419. </tr>
  25420. <tr>
  25421. <td>
  25422. <code>version</code></br>
  25423. <em>
  25424. <a href="#external-secrets.io/v1beta1.VaultKVStoreVersion">
  25425. VaultKVStoreVersion
  25426. </a>
  25427. </em>
  25428. </td>
  25429. <td>
  25430. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  25431. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  25432. </td>
  25433. </tr>
  25434. <tr>
  25435. <td>
  25436. <code>namespace</code></br>
  25437. <em>
  25438. string
  25439. </em>
  25440. </td>
  25441. <td>
  25442. <em>(Optional)</em>
  25443. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  25444. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  25445. 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>
  25446. </td>
  25447. </tr>
  25448. <tr>
  25449. <td>
  25450. <code>caBundle</code></br>
  25451. <em>
  25452. []byte
  25453. </em>
  25454. </td>
  25455. <td>
  25456. <em>(Optional)</em>
  25457. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  25458. if the Server URL is using HTTPS protocol. This parameter is ignored for
  25459. plain HTTP protocol connection. If not set the system root certificates
  25460. are used to validate the TLS connection.</p>
  25461. </td>
  25462. </tr>
  25463. <tr>
  25464. <td>
  25465. <code>tls</code></br>
  25466. <em>
  25467. <a href="#external-secrets.io/v1beta1.VaultClientTLS">
  25468. VaultClientTLS
  25469. </a>
  25470. </em>
  25471. </td>
  25472. <td>
  25473. <em>(Optional)</em>
  25474. <p>The configuration used for client side related TLS communication, when the Vault server
  25475. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  25476. This parameter is ignored for plain HTTP protocol connection.
  25477. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  25478. which is available under the <code>auth.cert</code> section.</p>
  25479. </td>
  25480. </tr>
  25481. <tr>
  25482. <td>
  25483. <code>caProvider</code></br>
  25484. <em>
  25485. <a href="#external-secrets.io/v1beta1.CAProvider">
  25486. CAProvider
  25487. </a>
  25488. </em>
  25489. </td>
  25490. <td>
  25491. <em>(Optional)</em>
  25492. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  25493. </td>
  25494. </tr>
  25495. <tr>
  25496. <td>
  25497. <code>readYourWrites</code></br>
  25498. <em>
  25499. bool
  25500. </em>
  25501. </td>
  25502. <td>
  25503. <em>(Optional)</em>
  25504. <p>ReadYourWrites ensures isolated read-after-write semantics by
  25505. providing discovered cluster replication states in each request.
  25506. More information about eventual consistency in Vault can be found here
  25507. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  25508. </td>
  25509. </tr>
  25510. <tr>
  25511. <td>
  25512. <code>forwardInconsistent</code></br>
  25513. <em>
  25514. bool
  25515. </em>
  25516. </td>
  25517. <td>
  25518. <em>(Optional)</em>
  25519. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  25520. leader instead of simply retrying within a loop. This can increase performance if
  25521. the option is enabled serverside.
  25522. <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>
  25523. </td>
  25524. </tr>
  25525. <tr>
  25526. <td>
  25527. <code>headers</code></br>
  25528. <em>
  25529. map[string]string
  25530. </em>
  25531. </td>
  25532. <td>
  25533. <em>(Optional)</em>
  25534. <p>Headers to be added in Vault request</p>
  25535. </td>
  25536. </tr>
  25537. </tbody>
  25538. </table>
  25539. <h3 id="external-secrets.io/v1beta1.VaultUserPassAuth">VaultUserPassAuth
  25540. </h3>
  25541. <p>
  25542. (<em>Appears on:</em>
  25543. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  25544. </p>
  25545. <p>
  25546. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  25547. with the username and password stored in a Kubernetes Secret resource.</p>
  25548. </p>
  25549. <table>
  25550. <thead>
  25551. <tr>
  25552. <th>Field</th>
  25553. <th>Description</th>
  25554. </tr>
  25555. </thead>
  25556. <tbody>
  25557. <tr>
  25558. <td>
  25559. <code>path</code></br>
  25560. <em>
  25561. string
  25562. </em>
  25563. </td>
  25564. <td>
  25565. <p>Path where the UserPassword authentication backend is mounted
  25566. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  25567. </td>
  25568. </tr>
  25569. <tr>
  25570. <td>
  25571. <code>username</code></br>
  25572. <em>
  25573. string
  25574. </em>
  25575. </td>
  25576. <td>
  25577. <p>Username is a username used to authenticate using the UserPass Vault
  25578. authentication method</p>
  25579. </td>
  25580. </tr>
  25581. <tr>
  25582. <td>
  25583. <code>secretRef</code></br>
  25584. <em>
  25585. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25586. External Secrets meta/v1.SecretKeySelector
  25587. </a>
  25588. </em>
  25589. </td>
  25590. <td>
  25591. <em>(Optional)</em>
  25592. <p>SecretRef to a key in a Secret resource containing password for the
  25593. user used to authenticate with Vault using the UserPass authentication
  25594. method</p>
  25595. </td>
  25596. </tr>
  25597. </tbody>
  25598. </table>
  25599. <h3 id="external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider
  25600. </h3>
  25601. <p>
  25602. (<em>Appears on:</em>
  25603. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  25604. </p>
  25605. <p>
  25606. <p>WebhookCAProvider defines a location to fetch the certificate for the webhook provider.</p>
  25607. </p>
  25608. <table>
  25609. <thead>
  25610. <tr>
  25611. <th>Field</th>
  25612. <th>Description</th>
  25613. </tr>
  25614. </thead>
  25615. <tbody>
  25616. <tr>
  25617. <td>
  25618. <code>type</code></br>
  25619. <em>
  25620. <a href="#external-secrets.io/v1beta1.WebhookCAProviderType">
  25621. WebhookCAProviderType
  25622. </a>
  25623. </em>
  25624. </td>
  25625. <td>
  25626. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  25627. </td>
  25628. </tr>
  25629. <tr>
  25630. <td>
  25631. <code>name</code></br>
  25632. <em>
  25633. string
  25634. </em>
  25635. </td>
  25636. <td>
  25637. <p>The name of the object located at the provider type.</p>
  25638. </td>
  25639. </tr>
  25640. <tr>
  25641. <td>
  25642. <code>key</code></br>
  25643. <em>
  25644. string
  25645. </em>
  25646. </td>
  25647. <td>
  25648. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  25649. </td>
  25650. </tr>
  25651. <tr>
  25652. <td>
  25653. <code>namespace</code></br>
  25654. <em>
  25655. string
  25656. </em>
  25657. </td>
  25658. <td>
  25659. <em>(Optional)</em>
  25660. <p>The namespace the Provider type is in.</p>
  25661. </td>
  25662. </tr>
  25663. </tbody>
  25664. </table>
  25665. <h3 id="external-secrets.io/v1beta1.WebhookCAProviderType">WebhookCAProviderType
  25666. (<code>string</code> alias)</p></h3>
  25667. <p>
  25668. (<em>Appears on:</em>
  25669. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider</a>)
  25670. </p>
  25671. <p>
  25672. <p>WebhookCAProviderType defines the type of provider to use for CA certificates with Webhook providers.</p>
  25673. </p>
  25674. <table>
  25675. <thead>
  25676. <tr>
  25677. <th>Value</th>
  25678. <th>Description</th>
  25679. </tr>
  25680. </thead>
  25681. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  25682. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  25683. </td>
  25684. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  25685. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  25686. </td>
  25687. </tr></tbody>
  25688. </table>
  25689. <h3 id="external-secrets.io/v1beta1.WebhookProvider">WebhookProvider
  25690. </h3>
  25691. <p>
  25692. (<em>Appears on:</em>
  25693. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  25694. </p>
  25695. <p>
  25696. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  25697. </p>
  25698. <table>
  25699. <thead>
  25700. <tr>
  25701. <th>Field</th>
  25702. <th>Description</th>
  25703. </tr>
  25704. </thead>
  25705. <tbody>
  25706. <tr>
  25707. <td>
  25708. <code>method</code></br>
  25709. <em>
  25710. string
  25711. </em>
  25712. </td>
  25713. <td>
  25714. <p>Webhook Method</p>
  25715. </td>
  25716. </tr>
  25717. <tr>
  25718. <td>
  25719. <code>url</code></br>
  25720. <em>
  25721. string
  25722. </em>
  25723. </td>
  25724. <td>
  25725. <p>Webhook url to call</p>
  25726. </td>
  25727. </tr>
  25728. <tr>
  25729. <td>
  25730. <code>headers</code></br>
  25731. <em>
  25732. map[string]string
  25733. </em>
  25734. </td>
  25735. <td>
  25736. <em>(Optional)</em>
  25737. <p>Headers</p>
  25738. </td>
  25739. </tr>
  25740. <tr>
  25741. <td>
  25742. <code>auth</code></br>
  25743. <em>
  25744. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">
  25745. AuthorizationProtocol
  25746. </a>
  25747. </em>
  25748. </td>
  25749. <td>
  25750. <em>(Optional)</em>
  25751. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  25752. </td>
  25753. </tr>
  25754. <tr>
  25755. <td>
  25756. <code>body</code></br>
  25757. <em>
  25758. string
  25759. </em>
  25760. </td>
  25761. <td>
  25762. <em>(Optional)</em>
  25763. <p>Body</p>
  25764. </td>
  25765. </tr>
  25766. <tr>
  25767. <td>
  25768. <code>timeout</code></br>
  25769. <em>
  25770. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  25771. Kubernetes meta/v1.Duration
  25772. </a>
  25773. </em>
  25774. </td>
  25775. <td>
  25776. <em>(Optional)</em>
  25777. <p>Timeout</p>
  25778. </td>
  25779. </tr>
  25780. <tr>
  25781. <td>
  25782. <code>result</code></br>
  25783. <em>
  25784. <a href="#external-secrets.io/v1beta1.WebhookResult">
  25785. WebhookResult
  25786. </a>
  25787. </em>
  25788. </td>
  25789. <td>
  25790. <p>Result formatting</p>
  25791. </td>
  25792. </tr>
  25793. <tr>
  25794. <td>
  25795. <code>secrets</code></br>
  25796. <em>
  25797. <a href="#external-secrets.io/v1beta1.WebhookSecret">
  25798. []WebhookSecret
  25799. </a>
  25800. </em>
  25801. </td>
  25802. <td>
  25803. <em>(Optional)</em>
  25804. <p>Secrets to fill in templates
  25805. These secrets will be passed to the templating function as key value pairs under the given name</p>
  25806. </td>
  25807. </tr>
  25808. <tr>
  25809. <td>
  25810. <code>caBundle</code></br>
  25811. <em>
  25812. []byte
  25813. </em>
  25814. </td>
  25815. <td>
  25816. <em>(Optional)</em>
  25817. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  25818. if the Server URL is using HTTPS protocol. This parameter is ignored for
  25819. plain HTTP protocol connection. If not set the system root certificates
  25820. are used to validate the TLS connection.</p>
  25821. </td>
  25822. </tr>
  25823. <tr>
  25824. <td>
  25825. <code>caProvider</code></br>
  25826. <em>
  25827. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">
  25828. WebhookCAProvider
  25829. </a>
  25830. </em>
  25831. </td>
  25832. <td>
  25833. <em>(Optional)</em>
  25834. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  25835. </td>
  25836. </tr>
  25837. </tbody>
  25838. </table>
  25839. <h3 id="external-secrets.io/v1beta1.WebhookResult">WebhookResult
  25840. </h3>
  25841. <p>
  25842. (<em>Appears on:</em>
  25843. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  25844. </p>
  25845. <p>
  25846. <p>WebhookResult defines how to extract and format the result from the webhook response.</p>
  25847. </p>
  25848. <table>
  25849. <thead>
  25850. <tr>
  25851. <th>Field</th>
  25852. <th>Description</th>
  25853. </tr>
  25854. </thead>
  25855. <tbody>
  25856. <tr>
  25857. <td>
  25858. <code>jsonPath</code></br>
  25859. <em>
  25860. string
  25861. </em>
  25862. </td>
  25863. <td>
  25864. <em>(Optional)</em>
  25865. <p>Json path of return value</p>
  25866. </td>
  25867. </tr>
  25868. </tbody>
  25869. </table>
  25870. <h3 id="external-secrets.io/v1beta1.WebhookSecret">WebhookSecret
  25871. </h3>
  25872. <p>
  25873. (<em>Appears on:</em>
  25874. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  25875. </p>
  25876. <p>
  25877. <p>WebhookSecret defines a secret to be used in webhook templates.</p>
  25878. </p>
  25879. <table>
  25880. <thead>
  25881. <tr>
  25882. <th>Field</th>
  25883. <th>Description</th>
  25884. </tr>
  25885. </thead>
  25886. <tbody>
  25887. <tr>
  25888. <td>
  25889. <code>name</code></br>
  25890. <em>
  25891. string
  25892. </em>
  25893. </td>
  25894. <td>
  25895. <p>Name of this secret in templates</p>
  25896. </td>
  25897. </tr>
  25898. <tr>
  25899. <td>
  25900. <code>secretRef</code></br>
  25901. <em>
  25902. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25903. External Secrets meta/v1.SecretKeySelector
  25904. </a>
  25905. </em>
  25906. </td>
  25907. <td>
  25908. <p>Secret ref to fill in credentials</p>
  25909. </td>
  25910. </tr>
  25911. </tbody>
  25912. </table>
  25913. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerAuth">YandexCertificateManagerAuth
  25914. </h3>
  25915. <p>
  25916. (<em>Appears on:</em>
  25917. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  25918. </p>
  25919. <p>
  25920. <p>YandexCertificateManagerAuth defines authentication configuration for the Yandex Certificate Manager provider.</p>
  25921. </p>
  25922. <table>
  25923. <thead>
  25924. <tr>
  25925. <th>Field</th>
  25926. <th>Description</th>
  25927. </tr>
  25928. </thead>
  25929. <tbody>
  25930. <tr>
  25931. <td>
  25932. <code>authorizedKeySecretRef</code></br>
  25933. <em>
  25934. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25935. External Secrets meta/v1.SecretKeySelector
  25936. </a>
  25937. </em>
  25938. </td>
  25939. <td>
  25940. <em>(Optional)</em>
  25941. <p>The authorized key used for authentication</p>
  25942. </td>
  25943. </tr>
  25944. </tbody>
  25945. </table>
  25946. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">YandexCertificateManagerCAProvider
  25947. </h3>
  25948. <p>
  25949. (<em>Appears on:</em>
  25950. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  25951. </p>
  25952. <p>
  25953. <p>YandexCertificateManagerCAProvider defines CA certificate configuration for Yandex Certificate Manager.</p>
  25954. </p>
  25955. <table>
  25956. <thead>
  25957. <tr>
  25958. <th>Field</th>
  25959. <th>Description</th>
  25960. </tr>
  25961. </thead>
  25962. <tbody>
  25963. <tr>
  25964. <td>
  25965. <code>certSecretRef</code></br>
  25966. <em>
  25967. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25968. External Secrets meta/v1.SecretKeySelector
  25969. </a>
  25970. </em>
  25971. </td>
  25972. <td>
  25973. </td>
  25974. </tr>
  25975. </tbody>
  25976. </table>
  25977. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  25978. </h3>
  25979. <p>
  25980. (<em>Appears on:</em>
  25981. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  25982. </p>
  25983. <p>
  25984. <p>YandexCertificateManagerProvider configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  25985. </p>
  25986. <table>
  25987. <thead>
  25988. <tr>
  25989. <th>Field</th>
  25990. <th>Description</th>
  25991. </tr>
  25992. </thead>
  25993. <tbody>
  25994. <tr>
  25995. <td>
  25996. <code>apiEndpoint</code></br>
  25997. <em>
  25998. string
  25999. </em>
  26000. </td>
  26001. <td>
  26002. <em>(Optional)</em>
  26003. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  26004. </td>
  26005. </tr>
  26006. <tr>
  26007. <td>
  26008. <code>auth</code></br>
  26009. <em>
  26010. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerAuth">
  26011. YandexCertificateManagerAuth
  26012. </a>
  26013. </em>
  26014. </td>
  26015. <td>
  26016. <p>Auth defines the information necessary to authenticate against Yandex Certificate Manager</p>
  26017. </td>
  26018. </tr>
  26019. <tr>
  26020. <td>
  26021. <code>caProvider</code></br>
  26022. <em>
  26023. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">
  26024. YandexCertificateManagerCAProvider
  26025. </a>
  26026. </em>
  26027. </td>
  26028. <td>
  26029. <em>(Optional)</em>
  26030. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  26031. </td>
  26032. </tr>
  26033. </tbody>
  26034. </table>
  26035. <h3 id="external-secrets.io/v1beta1.YandexLockboxAuth">YandexLockboxAuth
  26036. </h3>
  26037. <p>
  26038. (<em>Appears on:</em>
  26039. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  26040. </p>
  26041. <p>
  26042. <p>YandexLockboxAuth defines authentication configuration for the Yandex Lockbox provider.</p>
  26043. </p>
  26044. <table>
  26045. <thead>
  26046. <tr>
  26047. <th>Field</th>
  26048. <th>Description</th>
  26049. </tr>
  26050. </thead>
  26051. <tbody>
  26052. <tr>
  26053. <td>
  26054. <code>authorizedKeySecretRef</code></br>
  26055. <em>
  26056. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26057. External Secrets meta/v1.SecretKeySelector
  26058. </a>
  26059. </em>
  26060. </td>
  26061. <td>
  26062. <em>(Optional)</em>
  26063. <p>The authorized key used for authentication</p>
  26064. </td>
  26065. </tr>
  26066. </tbody>
  26067. </table>
  26068. <h3 id="external-secrets.io/v1beta1.YandexLockboxCAProvider">YandexLockboxCAProvider
  26069. </h3>
  26070. <p>
  26071. (<em>Appears on:</em>
  26072. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  26073. </p>
  26074. <p>
  26075. <p>YandexLockboxCAProvider defines CA certificate configuration for Yandex Lockbox.</p>
  26076. </p>
  26077. <table>
  26078. <thead>
  26079. <tr>
  26080. <th>Field</th>
  26081. <th>Description</th>
  26082. </tr>
  26083. </thead>
  26084. <tbody>
  26085. <tr>
  26086. <td>
  26087. <code>certSecretRef</code></br>
  26088. <em>
  26089. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26090. External Secrets meta/v1.SecretKeySelector
  26091. </a>
  26092. </em>
  26093. </td>
  26094. <td>
  26095. </td>
  26096. </tr>
  26097. </tbody>
  26098. </table>
  26099. <h3 id="external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider
  26100. </h3>
  26101. <p>
  26102. (<em>Appears on:</em>
  26103. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  26104. </p>
  26105. <p>
  26106. <p>YandexLockboxProvider configures a store to sync secrets using the Yandex Lockbox provider.</p>
  26107. </p>
  26108. <table>
  26109. <thead>
  26110. <tr>
  26111. <th>Field</th>
  26112. <th>Description</th>
  26113. </tr>
  26114. </thead>
  26115. <tbody>
  26116. <tr>
  26117. <td>
  26118. <code>apiEndpoint</code></br>
  26119. <em>
  26120. string
  26121. </em>
  26122. </td>
  26123. <td>
  26124. <em>(Optional)</em>
  26125. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  26126. </td>
  26127. </tr>
  26128. <tr>
  26129. <td>
  26130. <code>auth</code></br>
  26131. <em>
  26132. <a href="#external-secrets.io/v1beta1.YandexLockboxAuth">
  26133. YandexLockboxAuth
  26134. </a>
  26135. </em>
  26136. </td>
  26137. <td>
  26138. <p>Auth defines the information necessary to authenticate against Yandex Lockbox</p>
  26139. </td>
  26140. </tr>
  26141. <tr>
  26142. <td>
  26143. <code>caProvider</code></br>
  26144. <em>
  26145. <a href="#external-secrets.io/v1beta1.YandexLockboxCAProvider">
  26146. YandexLockboxCAProvider
  26147. </a>
  26148. </em>
  26149. </td>
  26150. <td>
  26151. <em>(Optional)</em>
  26152. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  26153. </td>
  26154. </tr>
  26155. </tbody>
  26156. </table>
  26157. <hr/>
  26158. <h2 id="generators.external-secrets.io/v1alpha1">generators.external-secrets.io/v1alpha1</h2>
  26159. <p>
  26160. <p>Package v1alpha1 contains resources for generators</p>
  26161. </p>
  26162. <p>Resource Types:</p>
  26163. <ul></ul>
  26164. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken
  26165. </h3>
  26166. <p>
  26167. <p>ACRAccessToken returns an Azure Container Registry token
  26168. that can be used for pushing/pulling images.
  26169. Note: by default it will return an ACR Refresh Token with full access
  26170. (depending on the identity).
  26171. This can be scoped down to the repository level using .spec.scope.
  26172. In case scope is defined it will return an ACR Access Token.</p>
  26173. <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>
  26174. </p>
  26175. <table>
  26176. <thead>
  26177. <tr>
  26178. <th>Field</th>
  26179. <th>Description</th>
  26180. </tr>
  26181. </thead>
  26182. <tbody>
  26183. <tr>
  26184. <td>
  26185. <code>metadata</code></br>
  26186. <em>
  26187. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  26188. Kubernetes meta/v1.ObjectMeta
  26189. </a>
  26190. </em>
  26191. </td>
  26192. <td>
  26193. Refer to the Kubernetes API documentation for the fields of the
  26194. <code>metadata</code> field.
  26195. </td>
  26196. </tr>
  26197. <tr>
  26198. <td>
  26199. <code>spec</code></br>
  26200. <em>
  26201. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  26202. ACRAccessTokenSpec
  26203. </a>
  26204. </em>
  26205. </td>
  26206. <td>
  26207. <br/>
  26208. <br/>
  26209. <table>
  26210. <tr>
  26211. <td>
  26212. <code>auth</code></br>
  26213. <em>
  26214. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  26215. ACRAuth
  26216. </a>
  26217. </em>
  26218. </td>
  26219. <td>
  26220. </td>
  26221. </tr>
  26222. <tr>
  26223. <td>
  26224. <code>tenantId</code></br>
  26225. <em>
  26226. string
  26227. </em>
  26228. </td>
  26229. <td>
  26230. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  26231. </td>
  26232. </tr>
  26233. <tr>
  26234. <td>
  26235. <code>registry</code></br>
  26236. <em>
  26237. string
  26238. </em>
  26239. </td>
  26240. <td>
  26241. <p>the domain name of the ACR registry
  26242. e.g. foobarexample.azurecr.io</p>
  26243. </td>
  26244. </tr>
  26245. <tr>
  26246. <td>
  26247. <code>scope</code></br>
  26248. <em>
  26249. string
  26250. </em>
  26251. </td>
  26252. <td>
  26253. <em>(Optional)</em>
  26254. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  26255. if not provided it will return a refresh token that has full scope.
  26256. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  26257. <p>examples:
  26258. repository:my-repository:pull,push
  26259. repository:my-repository:pull</p>
  26260. <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>
  26261. </td>
  26262. </tr>
  26263. <tr>
  26264. <td>
  26265. <code>environmentType</code></br>
  26266. <em>
  26267. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  26268. AzureEnvironmentType
  26269. </a>
  26270. </em>
  26271. </td>
  26272. <td>
  26273. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  26274. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  26275. 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>
  26276. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  26277. </td>
  26278. </tr>
  26279. </table>
  26280. </td>
  26281. </tr>
  26282. </tbody>
  26283. </table>
  26284. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec
  26285. </h3>
  26286. <p>
  26287. (<em>Appears on:</em>
  26288. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken</a>,
  26289. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  26290. </p>
  26291. <p>
  26292. <p>ACRAccessTokenSpec defines how to generate the access token
  26293. e.g. how to authenticate and which registry to use.
  26294. 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>
  26295. </p>
  26296. <table>
  26297. <thead>
  26298. <tr>
  26299. <th>Field</th>
  26300. <th>Description</th>
  26301. </tr>
  26302. </thead>
  26303. <tbody>
  26304. <tr>
  26305. <td>
  26306. <code>auth</code></br>
  26307. <em>
  26308. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  26309. ACRAuth
  26310. </a>
  26311. </em>
  26312. </td>
  26313. <td>
  26314. </td>
  26315. </tr>
  26316. <tr>
  26317. <td>
  26318. <code>tenantId</code></br>
  26319. <em>
  26320. string
  26321. </em>
  26322. </td>
  26323. <td>
  26324. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  26325. </td>
  26326. </tr>
  26327. <tr>
  26328. <td>
  26329. <code>registry</code></br>
  26330. <em>
  26331. string
  26332. </em>
  26333. </td>
  26334. <td>
  26335. <p>the domain name of the ACR registry
  26336. e.g. foobarexample.azurecr.io</p>
  26337. </td>
  26338. </tr>
  26339. <tr>
  26340. <td>
  26341. <code>scope</code></br>
  26342. <em>
  26343. string
  26344. </em>
  26345. </td>
  26346. <td>
  26347. <em>(Optional)</em>
  26348. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  26349. if not provided it will return a refresh token that has full scope.
  26350. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  26351. <p>examples:
  26352. repository:my-repository:pull,push
  26353. repository:my-repository:pull</p>
  26354. <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>
  26355. </td>
  26356. </tr>
  26357. <tr>
  26358. <td>
  26359. <code>environmentType</code></br>
  26360. <em>
  26361. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  26362. AzureEnvironmentType
  26363. </a>
  26364. </em>
  26365. </td>
  26366. <td>
  26367. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  26368. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  26369. 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>
  26370. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  26371. </td>
  26372. </tr>
  26373. </tbody>
  26374. </table>
  26375. <h3 id="generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth
  26376. </h3>
  26377. <p>
  26378. (<em>Appears on:</em>
  26379. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  26380. </p>
  26381. <p>
  26382. <p>ACRAuth defines the authentication methods for Azure Container Registry.</p>
  26383. </p>
  26384. <table>
  26385. <thead>
  26386. <tr>
  26387. <th>Field</th>
  26388. <th>Description</th>
  26389. </tr>
  26390. </thead>
  26391. <tbody>
  26392. <tr>
  26393. <td>
  26394. <code>servicePrincipal</code></br>
  26395. <em>
  26396. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">
  26397. AzureACRServicePrincipalAuth
  26398. </a>
  26399. </em>
  26400. </td>
  26401. <td>
  26402. <em>(Optional)</em>
  26403. <p>ServicePrincipal uses Azure Service Principal credentials to authenticate with Azure.</p>
  26404. </td>
  26405. </tr>
  26406. <tr>
  26407. <td>
  26408. <code>managedIdentity</code></br>
  26409. <em>
  26410. <a href="#generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">
  26411. AzureACRManagedIdentityAuth
  26412. </a>
  26413. </em>
  26414. </td>
  26415. <td>
  26416. <em>(Optional)</em>
  26417. <p>ManagedIdentity uses Azure Managed Identity to authenticate with Azure.</p>
  26418. </td>
  26419. </tr>
  26420. <tr>
  26421. <td>
  26422. <code>workloadIdentity</code></br>
  26423. <em>
  26424. <a href="#generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">
  26425. AzureACRWorkloadIdentityAuth
  26426. </a>
  26427. </em>
  26428. </td>
  26429. <td>
  26430. <em>(Optional)</em>
  26431. <p>WorkloadIdentity uses Azure Workload Identity to authenticate with Azure.</p>
  26432. </td>
  26433. </tr>
  26434. </tbody>
  26435. </table>
  26436. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth
  26437. </h3>
  26438. <p>
  26439. (<em>Appears on:</em>
  26440. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec</a>,
  26441. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  26442. </p>
  26443. <p>
  26444. <p>AWSAuth tells the controller how to do authentication with aws.
  26445. Only one of secretRef or jwt can be specified.
  26446. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  26447. </p>
  26448. <table>
  26449. <thead>
  26450. <tr>
  26451. <th>Field</th>
  26452. <th>Description</th>
  26453. </tr>
  26454. </thead>
  26455. <tbody>
  26456. <tr>
  26457. <td>
  26458. <code>secretRef</code></br>
  26459. <em>
  26460. <a href="#generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">
  26461. AWSAuthSecretRef
  26462. </a>
  26463. </em>
  26464. </td>
  26465. <td>
  26466. <em>(Optional)</em>
  26467. </td>
  26468. </tr>
  26469. <tr>
  26470. <td>
  26471. <code>jwt</code></br>
  26472. <em>
  26473. <a href="#generators.external-secrets.io/v1alpha1.AWSJWTAuth">
  26474. AWSJWTAuth
  26475. </a>
  26476. </em>
  26477. </td>
  26478. <td>
  26479. <em>(Optional)</em>
  26480. </td>
  26481. </tr>
  26482. </tbody>
  26483. </table>
  26484. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">AWSAuthSecretRef
  26485. </h3>
  26486. <p>
  26487. (<em>Appears on:</em>
  26488. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  26489. </p>
  26490. <p>
  26491. <p>AWSAuthSecretRef holds secret references for AWS credentials
  26492. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  26493. </p>
  26494. <table>
  26495. <thead>
  26496. <tr>
  26497. <th>Field</th>
  26498. <th>Description</th>
  26499. </tr>
  26500. </thead>
  26501. <tbody>
  26502. <tr>
  26503. <td>
  26504. <code>accessKeyIDSecretRef</code></br>
  26505. <em>
  26506. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26507. External Secrets meta/v1.SecretKeySelector
  26508. </a>
  26509. </em>
  26510. </td>
  26511. <td>
  26512. <p>The AccessKeyID is used for authentication</p>
  26513. </td>
  26514. </tr>
  26515. <tr>
  26516. <td>
  26517. <code>secretAccessKeySecretRef</code></br>
  26518. <em>
  26519. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26520. External Secrets meta/v1.SecretKeySelector
  26521. </a>
  26522. </em>
  26523. </td>
  26524. <td>
  26525. <p>The SecretAccessKey is used for authentication</p>
  26526. </td>
  26527. </tr>
  26528. <tr>
  26529. <td>
  26530. <code>sessionTokenSecretRef</code></br>
  26531. <em>
  26532. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26533. External Secrets meta/v1.SecretKeySelector
  26534. </a>
  26535. </em>
  26536. </td>
  26537. <td>
  26538. <p>The SessionToken used for authentication
  26539. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  26540. 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>
  26541. </td>
  26542. </tr>
  26543. </tbody>
  26544. </table>
  26545. <h3 id="generators.external-secrets.io/v1alpha1.AWSJWTAuth">AWSJWTAuth
  26546. </h3>
  26547. <p>
  26548. (<em>Appears on:</em>
  26549. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  26550. </p>
  26551. <p>
  26552. <p>AWSJWTAuth provides configuration to authenticate against AWS using service account tokens.</p>
  26553. </p>
  26554. <table>
  26555. <thead>
  26556. <tr>
  26557. <th>Field</th>
  26558. <th>Description</th>
  26559. </tr>
  26560. </thead>
  26561. <tbody>
  26562. <tr>
  26563. <td>
  26564. <code>serviceAccountRef</code></br>
  26565. <em>
  26566. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26567. External Secrets meta/v1.ServiceAccountSelector
  26568. </a>
  26569. </em>
  26570. </td>
  26571. <td>
  26572. </td>
  26573. </tr>
  26574. </tbody>
  26575. </table>
  26576. <h3 id="generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol
  26577. </h3>
  26578. <p>
  26579. (<em>Appears on:</em>
  26580. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  26581. </p>
  26582. <p>
  26583. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  26584. </p>
  26585. <table>
  26586. <thead>
  26587. <tr>
  26588. <th>Field</th>
  26589. <th>Description</th>
  26590. </tr>
  26591. </thead>
  26592. <tbody>
  26593. <tr>
  26594. <td>
  26595. <code>ntlm</code></br>
  26596. <em>
  26597. <a href="#generators.external-secrets.io/v1alpha1.NTLMProtocol">
  26598. NTLMProtocol
  26599. </a>
  26600. </em>
  26601. </td>
  26602. <td>
  26603. <em>(Optional)</em>
  26604. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  26605. </td>
  26606. </tr>
  26607. </tbody>
  26608. </table>
  26609. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">AzureACRManagedIdentityAuth
  26610. </h3>
  26611. <p>
  26612. (<em>Appears on:</em>
  26613. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  26614. </p>
  26615. <p>
  26616. <p>AzureACRManagedIdentityAuth defines the configuration for using Azure Managed Identity authentication.</p>
  26617. </p>
  26618. <table>
  26619. <thead>
  26620. <tr>
  26621. <th>Field</th>
  26622. <th>Description</th>
  26623. </tr>
  26624. </thead>
  26625. <tbody>
  26626. <tr>
  26627. <td>
  26628. <code>identityId</code></br>
  26629. <em>
  26630. string
  26631. </em>
  26632. </td>
  26633. <td>
  26634. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  26635. </td>
  26636. </tr>
  26637. </tbody>
  26638. </table>
  26639. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth
  26640. </h3>
  26641. <p>
  26642. (<em>Appears on:</em>
  26643. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  26644. </p>
  26645. <p>
  26646. <p>AzureACRServicePrincipalAuth defines the configuration for using Azure Service Principal authentication.</p>
  26647. </p>
  26648. <table>
  26649. <thead>
  26650. <tr>
  26651. <th>Field</th>
  26652. <th>Description</th>
  26653. </tr>
  26654. </thead>
  26655. <tbody>
  26656. <tr>
  26657. <td>
  26658. <code>secretRef</code></br>
  26659. <em>
  26660. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">
  26661. AzureACRServicePrincipalAuthSecretRef
  26662. </a>
  26663. </em>
  26664. </td>
  26665. <td>
  26666. </td>
  26667. </tr>
  26668. </tbody>
  26669. </table>
  26670. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">AzureACRServicePrincipalAuthSecretRef
  26671. </h3>
  26672. <p>
  26673. (<em>Appears on:</em>
  26674. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth</a>)
  26675. </p>
  26676. <p>
  26677. <p>AzureACRServicePrincipalAuthSecretRef defines the secret references for Azure Service Principal authentication.
  26678. It uses static credentials stored in a Kind=Secret.</p>
  26679. </p>
  26680. <table>
  26681. <thead>
  26682. <tr>
  26683. <th>Field</th>
  26684. <th>Description</th>
  26685. </tr>
  26686. </thead>
  26687. <tbody>
  26688. <tr>
  26689. <td>
  26690. <code>clientId</code></br>
  26691. <em>
  26692. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26693. External Secrets meta/v1.SecretKeySelector
  26694. </a>
  26695. </em>
  26696. </td>
  26697. <td>
  26698. <p>The Azure clientId of the service principle used for authentication.</p>
  26699. </td>
  26700. </tr>
  26701. <tr>
  26702. <td>
  26703. <code>clientSecret</code></br>
  26704. <em>
  26705. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26706. External Secrets meta/v1.SecretKeySelector
  26707. </a>
  26708. </em>
  26709. </td>
  26710. <td>
  26711. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  26712. </td>
  26713. </tr>
  26714. </tbody>
  26715. </table>
  26716. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">AzureACRWorkloadIdentityAuth
  26717. </h3>
  26718. <p>
  26719. (<em>Appears on:</em>
  26720. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  26721. </p>
  26722. <p>
  26723. <p>AzureACRWorkloadIdentityAuth defines the configuration for using Azure Workload Identity authentication.</p>
  26724. </p>
  26725. <table>
  26726. <thead>
  26727. <tr>
  26728. <th>Field</th>
  26729. <th>Description</th>
  26730. </tr>
  26731. </thead>
  26732. <tbody>
  26733. <tr>
  26734. <td>
  26735. <code>serviceAccountRef</code></br>
  26736. <em>
  26737. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26738. External Secrets meta/v1.ServiceAccountSelector
  26739. </a>
  26740. </em>
  26741. </td>
  26742. <td>
  26743. <em>(Optional)</em>
  26744. <p>ServiceAccountRef specified the service account
  26745. that should be used when authenticating with WorkloadIdentity.</p>
  26746. </td>
  26747. </tr>
  26748. </tbody>
  26749. </table>
  26750. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken
  26751. </h3>
  26752. <p>
  26753. <p>CloudsmithAccessToken generates Cloudsmith access token using OIDC authentication</p>
  26754. </p>
  26755. <table>
  26756. <thead>
  26757. <tr>
  26758. <th>Field</th>
  26759. <th>Description</th>
  26760. </tr>
  26761. </thead>
  26762. <tbody>
  26763. <tr>
  26764. <td>
  26765. <code>metadata</code></br>
  26766. <em>
  26767. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  26768. Kubernetes meta/v1.ObjectMeta
  26769. </a>
  26770. </em>
  26771. </td>
  26772. <td>
  26773. Refer to the Kubernetes API documentation for the fields of the
  26774. <code>metadata</code> field.
  26775. </td>
  26776. </tr>
  26777. <tr>
  26778. <td>
  26779. <code>spec</code></br>
  26780. <em>
  26781. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  26782. CloudsmithAccessTokenSpec
  26783. </a>
  26784. </em>
  26785. </td>
  26786. <td>
  26787. <br/>
  26788. <br/>
  26789. <table>
  26790. <tr>
  26791. <td>
  26792. <code>apiUrl</code></br>
  26793. <em>
  26794. string
  26795. </em>
  26796. </td>
  26797. <td>
  26798. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  26799. </td>
  26800. </tr>
  26801. <tr>
  26802. <td>
  26803. <code>orgSlug</code></br>
  26804. <em>
  26805. string
  26806. </em>
  26807. </td>
  26808. <td>
  26809. <p>OrgSlug is the organization slug in Cloudsmith</p>
  26810. </td>
  26811. </tr>
  26812. <tr>
  26813. <td>
  26814. <code>serviceSlug</code></br>
  26815. <em>
  26816. string
  26817. </em>
  26818. </td>
  26819. <td>
  26820. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  26821. </td>
  26822. </tr>
  26823. <tr>
  26824. <td>
  26825. <code>serviceAccountRef</code></br>
  26826. <em>
  26827. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26828. External Secrets meta/v1.ServiceAccountSelector
  26829. </a>
  26830. </em>
  26831. </td>
  26832. <td>
  26833. <p>Name of the service account you are federating with</p>
  26834. </td>
  26835. </tr>
  26836. </table>
  26837. </td>
  26838. </tr>
  26839. </tbody>
  26840. </table>
  26841. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">CloudsmithAccessTokenSpec
  26842. </h3>
  26843. <p>
  26844. (<em>Appears on:</em>
  26845. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken</a>,
  26846. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  26847. </p>
  26848. <p>
  26849. <p>CloudsmithAccessTokenSpec defines the configuration for generating a Cloudsmith access token using OIDC authentication.</p>
  26850. </p>
  26851. <table>
  26852. <thead>
  26853. <tr>
  26854. <th>Field</th>
  26855. <th>Description</th>
  26856. </tr>
  26857. </thead>
  26858. <tbody>
  26859. <tr>
  26860. <td>
  26861. <code>apiUrl</code></br>
  26862. <em>
  26863. string
  26864. </em>
  26865. </td>
  26866. <td>
  26867. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  26868. </td>
  26869. </tr>
  26870. <tr>
  26871. <td>
  26872. <code>orgSlug</code></br>
  26873. <em>
  26874. string
  26875. </em>
  26876. </td>
  26877. <td>
  26878. <p>OrgSlug is the organization slug in Cloudsmith</p>
  26879. </td>
  26880. </tr>
  26881. <tr>
  26882. <td>
  26883. <code>serviceSlug</code></br>
  26884. <em>
  26885. string
  26886. </em>
  26887. </td>
  26888. <td>
  26889. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  26890. </td>
  26891. </tr>
  26892. <tr>
  26893. <td>
  26894. <code>serviceAccountRef</code></br>
  26895. <em>
  26896. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26897. External Secrets meta/v1.ServiceAccountSelector
  26898. </a>
  26899. </em>
  26900. </td>
  26901. <td>
  26902. <p>Name of the service account you are federating with</p>
  26903. </td>
  26904. </tr>
  26905. </tbody>
  26906. </table>
  26907. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator
  26908. </h3>
  26909. <p>
  26910. <p>ClusterGenerator represents a cluster-wide generator which can be referenced as part of <code>generatorRef</code> fields.</p>
  26911. </p>
  26912. <table>
  26913. <thead>
  26914. <tr>
  26915. <th>Field</th>
  26916. <th>Description</th>
  26917. </tr>
  26918. </thead>
  26919. <tbody>
  26920. <tr>
  26921. <td>
  26922. <code>metadata</code></br>
  26923. <em>
  26924. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  26925. Kubernetes meta/v1.ObjectMeta
  26926. </a>
  26927. </em>
  26928. </td>
  26929. <td>
  26930. Refer to the Kubernetes API documentation for the fields of the
  26931. <code>metadata</code> field.
  26932. </td>
  26933. </tr>
  26934. <tr>
  26935. <td>
  26936. <code>spec</code></br>
  26937. <em>
  26938. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">
  26939. ClusterGeneratorSpec
  26940. </a>
  26941. </em>
  26942. </td>
  26943. <td>
  26944. <br/>
  26945. <br/>
  26946. <table>
  26947. <tr>
  26948. <td>
  26949. <code>kind</code></br>
  26950. <em>
  26951. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  26952. GeneratorKind
  26953. </a>
  26954. </em>
  26955. </td>
  26956. <td>
  26957. <p>Kind the kind of this generator.</p>
  26958. </td>
  26959. </tr>
  26960. <tr>
  26961. <td>
  26962. <code>generator</code></br>
  26963. <em>
  26964. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  26965. GeneratorSpec
  26966. </a>
  26967. </em>
  26968. </td>
  26969. <td>
  26970. <p>Generator the spec for this generator, must match the kind.</p>
  26971. </td>
  26972. </tr>
  26973. </table>
  26974. </td>
  26975. </tr>
  26976. </tbody>
  26977. </table>
  26978. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec
  26979. </h3>
  26980. <p>
  26981. (<em>Appears on:</em>
  26982. <a href="#generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator</a>)
  26983. </p>
  26984. <p>
  26985. <p>ClusterGeneratorSpec defines the desired state of a ClusterGenerator.</p>
  26986. </p>
  26987. <table>
  26988. <thead>
  26989. <tr>
  26990. <th>Field</th>
  26991. <th>Description</th>
  26992. </tr>
  26993. </thead>
  26994. <tbody>
  26995. <tr>
  26996. <td>
  26997. <code>kind</code></br>
  26998. <em>
  26999. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  27000. GeneratorKind
  27001. </a>
  27002. </em>
  27003. </td>
  27004. <td>
  27005. <p>Kind the kind of this generator.</p>
  27006. </td>
  27007. </tr>
  27008. <tr>
  27009. <td>
  27010. <code>generator</code></br>
  27011. <em>
  27012. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  27013. GeneratorSpec
  27014. </a>
  27015. </em>
  27016. </td>
  27017. <td>
  27018. <p>Generator the spec for this generator, must match the kind.</p>
  27019. </td>
  27020. </tr>
  27021. </tbody>
  27022. </table>
  27023. <h3 id="generators.external-secrets.io/v1alpha1.ControllerClassResource">ControllerClassResource
  27024. </h3>
  27025. <p>
  27026. <p>ControllerClassResource defines a resource that can be assigned to a specific controller class.</p>
  27027. </p>
  27028. <table>
  27029. <thead>
  27030. <tr>
  27031. <th>Field</th>
  27032. <th>Description</th>
  27033. </tr>
  27034. </thead>
  27035. <tbody>
  27036. <tr>
  27037. <td>
  27038. <code>spec</code></br>
  27039. <em>
  27040. struct{ControllerClass string &#34;json:\&#34;controller\&#34;&#34;}
  27041. </em>
  27042. </td>
  27043. <td>
  27044. <br/>
  27045. <br/>
  27046. <table>
  27047. <tr>
  27048. <td>
  27049. <code>controller</code></br>
  27050. <em>
  27051. string
  27052. </em>
  27053. </td>
  27054. <td>
  27055. </td>
  27056. </tr>
  27057. </table>
  27058. </td>
  27059. </tr>
  27060. </tbody>
  27061. </table>
  27062. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken
  27063. </h3>
  27064. <p>
  27065. <p>ECRAuthorizationToken uses the GetAuthorizationToken API to retrieve an authorization token.
  27066. The authorization token is valid for 12 hours.
  27067. The authorizationToken returned is a base64 encoded string that can be decoded
  27068. and used in a docker login command to authenticate to a registry.
  27069. 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>
  27070. </p>
  27071. <table>
  27072. <thead>
  27073. <tr>
  27074. <th>Field</th>
  27075. <th>Description</th>
  27076. </tr>
  27077. </thead>
  27078. <tbody>
  27079. <tr>
  27080. <td>
  27081. <code>metadata</code></br>
  27082. <em>
  27083. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27084. Kubernetes meta/v1.ObjectMeta
  27085. </a>
  27086. </em>
  27087. </td>
  27088. <td>
  27089. Refer to the Kubernetes API documentation for the fields of the
  27090. <code>metadata</code> field.
  27091. </td>
  27092. </tr>
  27093. <tr>
  27094. <td>
  27095. <code>spec</code></br>
  27096. <em>
  27097. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  27098. ECRAuthorizationTokenSpec
  27099. </a>
  27100. </em>
  27101. </td>
  27102. <td>
  27103. <br/>
  27104. <br/>
  27105. <table>
  27106. <tr>
  27107. <td>
  27108. <code>region</code></br>
  27109. <em>
  27110. string
  27111. </em>
  27112. </td>
  27113. <td>
  27114. <p>Region specifies the region to operate in.</p>
  27115. </td>
  27116. </tr>
  27117. <tr>
  27118. <td>
  27119. <code>auth</code></br>
  27120. <em>
  27121. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  27122. AWSAuth
  27123. </a>
  27124. </em>
  27125. </td>
  27126. <td>
  27127. <em>(Optional)</em>
  27128. <p>Auth defines how to authenticate with AWS</p>
  27129. </td>
  27130. </tr>
  27131. <tr>
  27132. <td>
  27133. <code>role</code></br>
  27134. <em>
  27135. string
  27136. </em>
  27137. </td>
  27138. <td>
  27139. <em>(Optional)</em>
  27140. <p>You can assume a role before making calls to the
  27141. desired AWS service.</p>
  27142. </td>
  27143. </tr>
  27144. <tr>
  27145. <td>
  27146. <code>scope</code></br>
  27147. <em>
  27148. string
  27149. </em>
  27150. </td>
  27151. <td>
  27152. <em>(Optional)</em>
  27153. <p>Scope specifies the ECR service scope.
  27154. Valid options are private and public.</p>
  27155. </td>
  27156. </tr>
  27157. </table>
  27158. </td>
  27159. </tr>
  27160. </tbody>
  27161. </table>
  27162. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec
  27163. </h3>
  27164. <p>
  27165. (<em>Appears on:</em>
  27166. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken</a>,
  27167. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27168. </p>
  27169. <p>
  27170. <p>ECRAuthorizationTokenSpec defines the desired state to generate an AWS ECR authorization token.</p>
  27171. </p>
  27172. <table>
  27173. <thead>
  27174. <tr>
  27175. <th>Field</th>
  27176. <th>Description</th>
  27177. </tr>
  27178. </thead>
  27179. <tbody>
  27180. <tr>
  27181. <td>
  27182. <code>region</code></br>
  27183. <em>
  27184. string
  27185. </em>
  27186. </td>
  27187. <td>
  27188. <p>Region specifies the region to operate in.</p>
  27189. </td>
  27190. </tr>
  27191. <tr>
  27192. <td>
  27193. <code>auth</code></br>
  27194. <em>
  27195. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  27196. AWSAuth
  27197. </a>
  27198. </em>
  27199. </td>
  27200. <td>
  27201. <em>(Optional)</em>
  27202. <p>Auth defines how to authenticate with AWS</p>
  27203. </td>
  27204. </tr>
  27205. <tr>
  27206. <td>
  27207. <code>role</code></br>
  27208. <em>
  27209. string
  27210. </em>
  27211. </td>
  27212. <td>
  27213. <em>(Optional)</em>
  27214. <p>You can assume a role before making calls to the
  27215. desired AWS service.</p>
  27216. </td>
  27217. </tr>
  27218. <tr>
  27219. <td>
  27220. <code>scope</code></br>
  27221. <em>
  27222. string
  27223. </em>
  27224. </td>
  27225. <td>
  27226. <em>(Optional)</em>
  27227. <p>Scope specifies the ECR service scope.
  27228. Valid options are private and public.</p>
  27229. </td>
  27230. </tr>
  27231. </tbody>
  27232. </table>
  27233. <h3 id="generators.external-secrets.io/v1alpha1.Fake">Fake
  27234. </h3>
  27235. <p>
  27236. <p>Fake generator is used for testing. It lets you define
  27237. a static set of credentials that is always returned.</p>
  27238. </p>
  27239. <table>
  27240. <thead>
  27241. <tr>
  27242. <th>Field</th>
  27243. <th>Description</th>
  27244. </tr>
  27245. </thead>
  27246. <tbody>
  27247. <tr>
  27248. <td>
  27249. <code>metadata</code></br>
  27250. <em>
  27251. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27252. Kubernetes meta/v1.ObjectMeta
  27253. </a>
  27254. </em>
  27255. </td>
  27256. <td>
  27257. Refer to the Kubernetes API documentation for the fields of the
  27258. <code>metadata</code> field.
  27259. </td>
  27260. </tr>
  27261. <tr>
  27262. <td>
  27263. <code>spec</code></br>
  27264. <em>
  27265. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  27266. FakeSpec
  27267. </a>
  27268. </em>
  27269. </td>
  27270. <td>
  27271. <br/>
  27272. <br/>
  27273. <table>
  27274. <tr>
  27275. <td>
  27276. <code>controller</code></br>
  27277. <em>
  27278. string
  27279. </em>
  27280. </td>
  27281. <td>
  27282. <em>(Optional)</em>
  27283. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  27284. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  27285. </td>
  27286. </tr>
  27287. <tr>
  27288. <td>
  27289. <code>data</code></br>
  27290. <em>
  27291. map[string]string
  27292. </em>
  27293. </td>
  27294. <td>
  27295. <p>Data defines the static data returned
  27296. by this generator.</p>
  27297. </td>
  27298. </tr>
  27299. </table>
  27300. </td>
  27301. </tr>
  27302. </tbody>
  27303. </table>
  27304. <h3 id="generators.external-secrets.io/v1alpha1.FakeSpec">FakeSpec
  27305. </h3>
  27306. <p>
  27307. (<em>Appears on:</em>
  27308. <a href="#generators.external-secrets.io/v1alpha1.Fake">Fake</a>,
  27309. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27310. </p>
  27311. <p>
  27312. <p>FakeSpec contains the static data.</p>
  27313. </p>
  27314. <table>
  27315. <thead>
  27316. <tr>
  27317. <th>Field</th>
  27318. <th>Description</th>
  27319. </tr>
  27320. </thead>
  27321. <tbody>
  27322. <tr>
  27323. <td>
  27324. <code>controller</code></br>
  27325. <em>
  27326. string
  27327. </em>
  27328. </td>
  27329. <td>
  27330. <em>(Optional)</em>
  27331. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  27332. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  27333. </td>
  27334. </tr>
  27335. <tr>
  27336. <td>
  27337. <code>data</code></br>
  27338. <em>
  27339. map[string]string
  27340. </em>
  27341. </td>
  27342. <td>
  27343. <p>Data defines the static data returned
  27344. by this generator.</p>
  27345. </td>
  27346. </tr>
  27347. </tbody>
  27348. </table>
  27349. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth
  27350. </h3>
  27351. <p>
  27352. (<em>Appears on:</em>
  27353. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec</a>)
  27354. </p>
  27355. <p>
  27356. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform.</p>
  27357. </p>
  27358. <table>
  27359. <thead>
  27360. <tr>
  27361. <th>Field</th>
  27362. <th>Description</th>
  27363. </tr>
  27364. </thead>
  27365. <tbody>
  27366. <tr>
  27367. <td>
  27368. <code>secretRef</code></br>
  27369. <em>
  27370. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">
  27371. GCPSMAuthSecretRef
  27372. </a>
  27373. </em>
  27374. </td>
  27375. <td>
  27376. <em>(Optional)</em>
  27377. </td>
  27378. </tr>
  27379. <tr>
  27380. <td>
  27381. <code>workloadIdentity</code></br>
  27382. <em>
  27383. <a href="#generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">
  27384. GCPWorkloadIdentity
  27385. </a>
  27386. </em>
  27387. </td>
  27388. <td>
  27389. <em>(Optional)</em>
  27390. </td>
  27391. </tr>
  27392. <tr>
  27393. <td>
  27394. <code>workloadIdentityFederation</code></br>
  27395. <em>
  27396. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  27397. GCPWorkloadIdentityFederation
  27398. </a>
  27399. </em>
  27400. </td>
  27401. <td>
  27402. <em>(Optional)</em>
  27403. </td>
  27404. </tr>
  27405. </tbody>
  27406. </table>
  27407. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  27408. </h3>
  27409. <p>
  27410. (<em>Appears on:</em>
  27411. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  27412. </p>
  27413. <p>
  27414. <p>GCPSMAuthSecretRef defines the reference to a secret containing Google Cloud Platform credentials.</p>
  27415. </p>
  27416. <table>
  27417. <thead>
  27418. <tr>
  27419. <th>Field</th>
  27420. <th>Description</th>
  27421. </tr>
  27422. </thead>
  27423. <tbody>
  27424. <tr>
  27425. <td>
  27426. <code>secretAccessKeySecretRef</code></br>
  27427. <em>
  27428. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27429. External Secrets meta/v1.SecretKeySelector
  27430. </a>
  27431. </em>
  27432. </td>
  27433. <td>
  27434. <em>(Optional)</em>
  27435. <p>The SecretAccessKey is used for authentication</p>
  27436. </td>
  27437. </tr>
  27438. </tbody>
  27439. </table>
  27440. <h3 id="generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">GCPWorkloadIdentity
  27441. </h3>
  27442. <p>
  27443. (<em>Appears on:</em>
  27444. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  27445. </p>
  27446. <p>
  27447. <p>GCPWorkloadIdentity defines the configuration for using GCP Workload Identity authentication.</p>
  27448. </p>
  27449. <table>
  27450. <thead>
  27451. <tr>
  27452. <th>Field</th>
  27453. <th>Description</th>
  27454. </tr>
  27455. </thead>
  27456. <tbody>
  27457. <tr>
  27458. <td>
  27459. <code>serviceAccountRef</code></br>
  27460. <em>
  27461. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  27462. External Secrets meta/v1.ServiceAccountSelector
  27463. </a>
  27464. </em>
  27465. </td>
  27466. <td>
  27467. </td>
  27468. </tr>
  27469. <tr>
  27470. <td>
  27471. <code>clusterLocation</code></br>
  27472. <em>
  27473. string
  27474. </em>
  27475. </td>
  27476. <td>
  27477. </td>
  27478. </tr>
  27479. <tr>
  27480. <td>
  27481. <code>clusterName</code></br>
  27482. <em>
  27483. string
  27484. </em>
  27485. </td>
  27486. <td>
  27487. </td>
  27488. </tr>
  27489. <tr>
  27490. <td>
  27491. <code>clusterProjectID</code></br>
  27492. <em>
  27493. string
  27494. </em>
  27495. </td>
  27496. <td>
  27497. </td>
  27498. </tr>
  27499. </tbody>
  27500. </table>
  27501. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken
  27502. </h3>
  27503. <p>
  27504. <p>GCRAccessToken generates an GCP access token
  27505. that can be used to authenticate with GCR.</p>
  27506. </p>
  27507. <table>
  27508. <thead>
  27509. <tr>
  27510. <th>Field</th>
  27511. <th>Description</th>
  27512. </tr>
  27513. </thead>
  27514. <tbody>
  27515. <tr>
  27516. <td>
  27517. <code>metadata</code></br>
  27518. <em>
  27519. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27520. Kubernetes meta/v1.ObjectMeta
  27521. </a>
  27522. </em>
  27523. </td>
  27524. <td>
  27525. Refer to the Kubernetes API documentation for the fields of the
  27526. <code>metadata</code> field.
  27527. </td>
  27528. </tr>
  27529. <tr>
  27530. <td>
  27531. <code>spec</code></br>
  27532. <em>
  27533. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  27534. GCRAccessTokenSpec
  27535. </a>
  27536. </em>
  27537. </td>
  27538. <td>
  27539. <br/>
  27540. <br/>
  27541. <table>
  27542. <tr>
  27543. <td>
  27544. <code>auth</code></br>
  27545. <em>
  27546. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  27547. GCPSMAuth
  27548. </a>
  27549. </em>
  27550. </td>
  27551. <td>
  27552. <p>Auth defines the means for authenticating with GCP</p>
  27553. </td>
  27554. </tr>
  27555. <tr>
  27556. <td>
  27557. <code>projectID</code></br>
  27558. <em>
  27559. string
  27560. </em>
  27561. </td>
  27562. <td>
  27563. <p>ProjectID defines which project to use to authenticate with</p>
  27564. </td>
  27565. </tr>
  27566. </table>
  27567. </td>
  27568. </tr>
  27569. </tbody>
  27570. </table>
  27571. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec
  27572. </h3>
  27573. <p>
  27574. (<em>Appears on:</em>
  27575. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken</a>,
  27576. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  27577. </p>
  27578. <p>
  27579. <p>GCRAccessTokenSpec defines the desired state to generate a Google Container Registry access token.</p>
  27580. </p>
  27581. <table>
  27582. <thead>
  27583. <tr>
  27584. <th>Field</th>
  27585. <th>Description</th>
  27586. </tr>
  27587. </thead>
  27588. <tbody>
  27589. <tr>
  27590. <td>
  27591. <code>auth</code></br>
  27592. <em>
  27593. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  27594. GCPSMAuth
  27595. </a>
  27596. </em>
  27597. </td>
  27598. <td>
  27599. <p>Auth defines the means for authenticating with GCP</p>
  27600. </td>
  27601. </tr>
  27602. <tr>
  27603. <td>
  27604. <code>projectID</code></br>
  27605. <em>
  27606. string
  27607. </em>
  27608. </td>
  27609. <td>
  27610. <p>ProjectID defines which project to use to authenticate with</p>
  27611. </td>
  27612. </tr>
  27613. </tbody>
  27614. </table>
  27615. <h3 id="generators.external-secrets.io/v1alpha1.Generator">Generator
  27616. </h3>
  27617. <p>
  27618. <p>Generator is the common interface for all generators that is actually used to generate whatever is needed.</p>
  27619. </p>
  27620. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorKind">GeneratorKind
  27621. (<code>string</code> alias)</p></h3>
  27622. <p>
  27623. (<em>Appears on:</em>
  27624. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  27625. </p>
  27626. <p>
  27627. <p>GeneratorKind represents a kind of generator.</p>
  27628. </p>
  27629. <table>
  27630. <thead>
  27631. <tr>
  27632. <th>Value</th>
  27633. <th>Description</th>
  27634. </tr>
  27635. </thead>
  27636. <tbody><tr><td><p>&#34;ACRAccessToken&#34;</p></td>
  27637. <td><p>GeneratorKindACRAccessToken represents an Azure Container Registry access token generator.</p>
  27638. </td>
  27639. </tr><tr><td><p>&#34;CloudsmithAccessToken&#34;</p></td>
  27640. <td><p>GeneratorKindCloudsmithAccessToken represents a Cloudsmith access token generator.</p>
  27641. </td>
  27642. </tr><tr><td><p>&#34;ECRAuthorizationToken&#34;</p></td>
  27643. <td><p>GeneratorKindECRAuthorizationToken represents an AWS ECR authorization token generator.</p>
  27644. </td>
  27645. </tr><tr><td><p>&#34;Fake&#34;</p></td>
  27646. <td><p>GeneratorKindFake represents a fake generator for testing purposes.</p>
  27647. </td>
  27648. </tr><tr><td><p>&#34;GCRAccessToken&#34;</p></td>
  27649. <td><p>GeneratorKindGCRAccessToken represents a Google Container Registry access token generator.</p>
  27650. </td>
  27651. </tr><tr><td><p>&#34;GithubAccessToken&#34;</p></td>
  27652. <td><p>GeneratorKindGithubAccessToken represents a GitHub access token generator.</p>
  27653. </td>
  27654. </tr><tr><td><p>&#34;Grafana&#34;</p></td>
  27655. <td><p>GeneratorKindGrafana represents a Grafana token generator.</p>
  27656. </td>
  27657. </tr><tr><td><p>&#34;MFA&#34;</p></td>
  27658. <td><p>GeneratorKindMFA represents a Multi-Factor Authentication generator.</p>
  27659. </td>
  27660. </tr><tr><td><p>&#34;Password&#34;</p></td>
  27661. <td><p>GeneratorKindPassword represents a password generator.</p>
  27662. </td>
  27663. </tr><tr><td><p>&#34;QuayAccessToken&#34;</p></td>
  27664. <td><p>GeneratorKindQuayAccessToken represents a Quay access token generator.</p>
  27665. </td>
  27666. </tr><tr><td><p>&#34;SSHKey&#34;</p></td>
  27667. <td><p>GeneratorKindSSHKey represents an SSH key generator.</p>
  27668. </td>
  27669. </tr><tr><td><p>&#34;STSSessionToken&#34;</p></td>
  27670. <td><p>GeneratorKindSTSSessionToken represents an AWS STS session token generator.</p>
  27671. </td>
  27672. </tr><tr><td><p>&#34;UUID&#34;</p></td>
  27673. <td><p>GeneratorKindUUID represents a UUID generator.</p>
  27674. </td>
  27675. </tr><tr><td><p>&#34;VaultDynamicSecret&#34;</p></td>
  27676. <td><p>GeneratorKindVaultDynamicSecret represents a HashiCorp Vault dynamic secret generator.</p>
  27677. </td>
  27678. </tr><tr><td><p>&#34;Webhook&#34;</p></td>
  27679. <td><p>GeneratorKindWebhook represents a webhook-based generator.</p>
  27680. </td>
  27681. </tr></tbody>
  27682. </table>
  27683. <h3 id="&lt;UNKNOWN_API_GROUP&gt;.GeneratorProviderState">GeneratorProviderState
  27684. </h3>
  27685. <p>
  27686. <p>GeneratorProviderState represents the state of a generator provider that can be stored and retrieved.</p>
  27687. </p>
  27688. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec
  27689. </h3>
  27690. <p>
  27691. (<em>Appears on:</em>
  27692. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  27693. </p>
  27694. <p>
  27695. <p>GeneratorSpec defines the configuration for various supported generator types.</p>
  27696. </p>
  27697. <table>
  27698. <thead>
  27699. <tr>
  27700. <th>Field</th>
  27701. <th>Description</th>
  27702. </tr>
  27703. </thead>
  27704. <tbody>
  27705. <tr>
  27706. <td>
  27707. <code>acrAccessTokenSpec</code></br>
  27708. <em>
  27709. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  27710. ACRAccessTokenSpec
  27711. </a>
  27712. </em>
  27713. </td>
  27714. <td>
  27715. </td>
  27716. </tr>
  27717. <tr>
  27718. <td>
  27719. <code>cloudsmithAccessTokenSpec</code></br>
  27720. <em>
  27721. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  27722. CloudsmithAccessTokenSpec
  27723. </a>
  27724. </em>
  27725. </td>
  27726. <td>
  27727. </td>
  27728. </tr>
  27729. <tr>
  27730. <td>
  27731. <code>ecrAuthorizationTokenSpec</code></br>
  27732. <em>
  27733. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  27734. ECRAuthorizationTokenSpec
  27735. </a>
  27736. </em>
  27737. </td>
  27738. <td>
  27739. </td>
  27740. </tr>
  27741. <tr>
  27742. <td>
  27743. <code>fakeSpec</code></br>
  27744. <em>
  27745. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  27746. FakeSpec
  27747. </a>
  27748. </em>
  27749. </td>
  27750. <td>
  27751. </td>
  27752. </tr>
  27753. <tr>
  27754. <td>
  27755. <code>gcrAccessTokenSpec</code></br>
  27756. <em>
  27757. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  27758. GCRAccessTokenSpec
  27759. </a>
  27760. </em>
  27761. </td>
  27762. <td>
  27763. </td>
  27764. </tr>
  27765. <tr>
  27766. <td>
  27767. <code>githubAccessTokenSpec</code></br>
  27768. <em>
  27769. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  27770. GithubAccessTokenSpec
  27771. </a>
  27772. </em>
  27773. </td>
  27774. <td>
  27775. </td>
  27776. </tr>
  27777. <tr>
  27778. <td>
  27779. <code>quayAccessTokenSpec</code></br>
  27780. <em>
  27781. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  27782. QuayAccessTokenSpec
  27783. </a>
  27784. </em>
  27785. </td>
  27786. <td>
  27787. </td>
  27788. </tr>
  27789. <tr>
  27790. <td>
  27791. <code>passwordSpec</code></br>
  27792. <em>
  27793. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  27794. PasswordSpec
  27795. </a>
  27796. </em>
  27797. </td>
  27798. <td>
  27799. </td>
  27800. </tr>
  27801. <tr>
  27802. <td>
  27803. <code>sshKeySpec</code></br>
  27804. <em>
  27805. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  27806. SSHKeySpec
  27807. </a>
  27808. </em>
  27809. </td>
  27810. <td>
  27811. </td>
  27812. </tr>
  27813. <tr>
  27814. <td>
  27815. <code>stsSessionTokenSpec</code></br>
  27816. <em>
  27817. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  27818. STSSessionTokenSpec
  27819. </a>
  27820. </em>
  27821. </td>
  27822. <td>
  27823. </td>
  27824. </tr>
  27825. <tr>
  27826. <td>
  27827. <code>uuidSpec</code></br>
  27828. <em>
  27829. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  27830. UUIDSpec
  27831. </a>
  27832. </em>
  27833. </td>
  27834. <td>
  27835. </td>
  27836. </tr>
  27837. <tr>
  27838. <td>
  27839. <code>vaultDynamicSecretSpec</code></br>
  27840. <em>
  27841. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  27842. VaultDynamicSecretSpec
  27843. </a>
  27844. </em>
  27845. </td>
  27846. <td>
  27847. </td>
  27848. </tr>
  27849. <tr>
  27850. <td>
  27851. <code>webhookSpec</code></br>
  27852. <em>
  27853. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  27854. WebhookSpec
  27855. </a>
  27856. </em>
  27857. </td>
  27858. <td>
  27859. </td>
  27860. </tr>
  27861. <tr>
  27862. <td>
  27863. <code>grafanaSpec</code></br>
  27864. <em>
  27865. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  27866. GrafanaSpec
  27867. </a>
  27868. </em>
  27869. </td>
  27870. <td>
  27871. </td>
  27872. </tr>
  27873. <tr>
  27874. <td>
  27875. <code>mfaSpec</code></br>
  27876. <em>
  27877. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  27878. MFASpec
  27879. </a>
  27880. </em>
  27881. </td>
  27882. <td>
  27883. </td>
  27884. </tr>
  27885. </tbody>
  27886. </table>
  27887. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState
  27888. </h3>
  27889. <p>
  27890. <p>GeneratorState represents the state created and managed by a generator resource.</p>
  27891. </p>
  27892. <table>
  27893. <thead>
  27894. <tr>
  27895. <th>Field</th>
  27896. <th>Description</th>
  27897. </tr>
  27898. </thead>
  27899. <tbody>
  27900. <tr>
  27901. <td>
  27902. <code>metadata</code></br>
  27903. <em>
  27904. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27905. Kubernetes meta/v1.ObjectMeta
  27906. </a>
  27907. </em>
  27908. </td>
  27909. <td>
  27910. Refer to the Kubernetes API documentation for the fields of the
  27911. <code>metadata</code> field.
  27912. </td>
  27913. </tr>
  27914. <tr>
  27915. <td>
  27916. <code>spec</code></br>
  27917. <em>
  27918. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateSpec">
  27919. GeneratorStateSpec
  27920. </a>
  27921. </em>
  27922. </td>
  27923. <td>
  27924. <br/>
  27925. <br/>
  27926. <table>
  27927. <tr>
  27928. <td>
  27929. <code>garbageCollectionDeadline</code></br>
  27930. <em>
  27931. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  27932. Kubernetes meta/v1.Time
  27933. </a>
  27934. </em>
  27935. </td>
  27936. <td>
  27937. <p>GarbageCollectionDeadline is the time after which the generator state
  27938. will be deleted.
  27939. It is set by the controller which creates the generator state and
  27940. can be set configured by the user.
  27941. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  27942. </td>
  27943. </tr>
  27944. <tr>
  27945. <td>
  27946. <code>resource</code></br>
  27947. <em>
  27948. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  27949. </em>
  27950. </td>
  27951. <td>
  27952. <p>Resource is the generator manifest that produced the state.
  27953. It is a snapshot of the generator manifest at the time the state was produced.
  27954. This manifest will be used to delete the resource. Any configuration that is referenced
  27955. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  27956. be blocked by a finalizer.</p>
  27957. </td>
  27958. </tr>
  27959. <tr>
  27960. <td>
  27961. <code>state</code></br>
  27962. <em>
  27963. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  27964. </em>
  27965. </td>
  27966. <td>
  27967. <p>State is the state that was produced by the generator implementation.</p>
  27968. </td>
  27969. </tr>
  27970. </table>
  27971. </td>
  27972. </tr>
  27973. <tr>
  27974. <td>
  27975. <code>status</code></br>
  27976. <em>
  27977. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">
  27978. GeneratorStateStatus
  27979. </a>
  27980. </em>
  27981. </td>
  27982. <td>
  27983. </td>
  27984. </tr>
  27985. </tbody>
  27986. </table>
  27987. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">GeneratorStateConditionType
  27988. (<code>string</code> alias)</p></h3>
  27989. <p>
  27990. (<em>Appears on:</em>
  27991. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition</a>)
  27992. </p>
  27993. <p>
  27994. <p>GeneratorStateConditionType represents the type of condition for a generator state.</p>
  27995. </p>
  27996. <table>
  27997. <thead>
  27998. <tr>
  27999. <th>Value</th>
  28000. <th>Description</th>
  28001. </tr>
  28002. </thead>
  28003. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  28004. <td><p>GeneratorStateReady indicates the generator state is ready and available.</p>
  28005. </td>
  28006. </tr></tbody>
  28007. </table>
  28008. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateSpec">GeneratorStateSpec
  28009. </h3>
  28010. <p>
  28011. (<em>Appears on:</em>
  28012. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  28013. </p>
  28014. <p>
  28015. <p>GeneratorStateSpec defines the desired state of a generator state resource.</p>
  28016. </p>
  28017. <table>
  28018. <thead>
  28019. <tr>
  28020. <th>Field</th>
  28021. <th>Description</th>
  28022. </tr>
  28023. </thead>
  28024. <tbody>
  28025. <tr>
  28026. <td>
  28027. <code>garbageCollectionDeadline</code></br>
  28028. <em>
  28029. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  28030. Kubernetes meta/v1.Time
  28031. </a>
  28032. </em>
  28033. </td>
  28034. <td>
  28035. <p>GarbageCollectionDeadline is the time after which the generator state
  28036. will be deleted.
  28037. It is set by the controller which creates the generator state and
  28038. can be set configured by the user.
  28039. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  28040. </td>
  28041. </tr>
  28042. <tr>
  28043. <td>
  28044. <code>resource</code></br>
  28045. <em>
  28046. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  28047. </em>
  28048. </td>
  28049. <td>
  28050. <p>Resource is the generator manifest that produced the state.
  28051. It is a snapshot of the generator manifest at the time the state was produced.
  28052. This manifest will be used to delete the resource. Any configuration that is referenced
  28053. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  28054. be blocked by a finalizer.</p>
  28055. </td>
  28056. </tr>
  28057. <tr>
  28058. <td>
  28059. <code>state</code></br>
  28060. <em>
  28061. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  28062. </em>
  28063. </td>
  28064. <td>
  28065. <p>State is the state that was produced by the generator implementation.</p>
  28066. </td>
  28067. </tr>
  28068. </tbody>
  28069. </table>
  28070. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus
  28071. </h3>
  28072. <p>
  28073. (<em>Appears on:</em>
  28074. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  28075. </p>
  28076. <p>
  28077. <p>GeneratorStateStatus defines the observed state of a generator state resource.</p>
  28078. </p>
  28079. <table>
  28080. <thead>
  28081. <tr>
  28082. <th>Field</th>
  28083. <th>Description</th>
  28084. </tr>
  28085. </thead>
  28086. <tbody>
  28087. <tr>
  28088. <td>
  28089. <code>conditions</code></br>
  28090. <em>
  28091. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">
  28092. []GeneratorStateStatusCondition
  28093. </a>
  28094. </em>
  28095. </td>
  28096. <td>
  28097. </td>
  28098. </tr>
  28099. </tbody>
  28100. </table>
  28101. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition
  28102. </h3>
  28103. <p>
  28104. (<em>Appears on:</em>
  28105. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus</a>)
  28106. </p>
  28107. <p>
  28108. <p>GeneratorStateStatusCondition represents the observed condition of a generator state.</p>
  28109. </p>
  28110. <table>
  28111. <thead>
  28112. <tr>
  28113. <th>Field</th>
  28114. <th>Description</th>
  28115. </tr>
  28116. </thead>
  28117. <tbody>
  28118. <tr>
  28119. <td>
  28120. <code>type</code></br>
  28121. <em>
  28122. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">
  28123. GeneratorStateConditionType
  28124. </a>
  28125. </em>
  28126. </td>
  28127. <td>
  28128. </td>
  28129. </tr>
  28130. <tr>
  28131. <td>
  28132. <code>status</code></br>
  28133. <em>
  28134. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  28135. Kubernetes core/v1.ConditionStatus
  28136. </a>
  28137. </em>
  28138. </td>
  28139. <td>
  28140. </td>
  28141. </tr>
  28142. <tr>
  28143. <td>
  28144. <code>reason</code></br>
  28145. <em>
  28146. string
  28147. </em>
  28148. </td>
  28149. <td>
  28150. <em>(Optional)</em>
  28151. </td>
  28152. </tr>
  28153. <tr>
  28154. <td>
  28155. <code>message</code></br>
  28156. <em>
  28157. string
  28158. </em>
  28159. </td>
  28160. <td>
  28161. <em>(Optional)</em>
  28162. </td>
  28163. </tr>
  28164. <tr>
  28165. <td>
  28166. <code>lastTransitionTime</code></br>
  28167. <em>
  28168. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  28169. Kubernetes meta/v1.Time
  28170. </a>
  28171. </em>
  28172. </td>
  28173. <td>
  28174. <em>(Optional)</em>
  28175. </td>
  28176. </tr>
  28177. </tbody>
  28178. </table>
  28179. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken
  28180. </h3>
  28181. <p>
  28182. <p>GithubAccessToken generates ghs_ accessToken</p>
  28183. </p>
  28184. <table>
  28185. <thead>
  28186. <tr>
  28187. <th>Field</th>
  28188. <th>Description</th>
  28189. </tr>
  28190. </thead>
  28191. <tbody>
  28192. <tr>
  28193. <td>
  28194. <code>metadata</code></br>
  28195. <em>
  28196. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28197. Kubernetes meta/v1.ObjectMeta
  28198. </a>
  28199. </em>
  28200. </td>
  28201. <td>
  28202. Refer to the Kubernetes API documentation for the fields of the
  28203. <code>metadata</code> field.
  28204. </td>
  28205. </tr>
  28206. <tr>
  28207. <td>
  28208. <code>spec</code></br>
  28209. <em>
  28210. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  28211. GithubAccessTokenSpec
  28212. </a>
  28213. </em>
  28214. </td>
  28215. <td>
  28216. <br/>
  28217. <br/>
  28218. <table>
  28219. <tr>
  28220. <td>
  28221. <code>url</code></br>
  28222. <em>
  28223. string
  28224. </em>
  28225. </td>
  28226. <td>
  28227. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  28228. </td>
  28229. </tr>
  28230. <tr>
  28231. <td>
  28232. <code>appID</code></br>
  28233. <em>
  28234. string
  28235. </em>
  28236. </td>
  28237. <td>
  28238. </td>
  28239. </tr>
  28240. <tr>
  28241. <td>
  28242. <code>installID</code></br>
  28243. <em>
  28244. string
  28245. </em>
  28246. </td>
  28247. <td>
  28248. </td>
  28249. </tr>
  28250. <tr>
  28251. <td>
  28252. <code>repositories</code></br>
  28253. <em>
  28254. []string
  28255. </em>
  28256. </td>
  28257. <td>
  28258. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  28259. is installed to.</p>
  28260. </td>
  28261. </tr>
  28262. <tr>
  28263. <td>
  28264. <code>permissions</code></br>
  28265. <em>
  28266. map[string]string
  28267. </em>
  28268. </td>
  28269. <td>
  28270. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  28271. </td>
  28272. </tr>
  28273. <tr>
  28274. <td>
  28275. <code>auth</code></br>
  28276. <em>
  28277. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  28278. GithubAuth
  28279. </a>
  28280. </em>
  28281. </td>
  28282. <td>
  28283. <p>Auth configures how ESO authenticates with a Github instance.</p>
  28284. </td>
  28285. </tr>
  28286. </table>
  28287. </td>
  28288. </tr>
  28289. </tbody>
  28290. </table>
  28291. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec
  28292. </h3>
  28293. <p>
  28294. (<em>Appears on:</em>
  28295. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  28296. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken</a>)
  28297. </p>
  28298. <p>
  28299. <p>GithubAccessTokenSpec defines the desired state to generate a GitHub access token.</p>
  28300. </p>
  28301. <table>
  28302. <thead>
  28303. <tr>
  28304. <th>Field</th>
  28305. <th>Description</th>
  28306. </tr>
  28307. </thead>
  28308. <tbody>
  28309. <tr>
  28310. <td>
  28311. <code>url</code></br>
  28312. <em>
  28313. string
  28314. </em>
  28315. </td>
  28316. <td>
  28317. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  28318. </td>
  28319. </tr>
  28320. <tr>
  28321. <td>
  28322. <code>appID</code></br>
  28323. <em>
  28324. string
  28325. </em>
  28326. </td>
  28327. <td>
  28328. </td>
  28329. </tr>
  28330. <tr>
  28331. <td>
  28332. <code>installID</code></br>
  28333. <em>
  28334. string
  28335. </em>
  28336. </td>
  28337. <td>
  28338. </td>
  28339. </tr>
  28340. <tr>
  28341. <td>
  28342. <code>repositories</code></br>
  28343. <em>
  28344. []string
  28345. </em>
  28346. </td>
  28347. <td>
  28348. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  28349. is installed to.</p>
  28350. </td>
  28351. </tr>
  28352. <tr>
  28353. <td>
  28354. <code>permissions</code></br>
  28355. <em>
  28356. map[string]string
  28357. </em>
  28358. </td>
  28359. <td>
  28360. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  28361. </td>
  28362. </tr>
  28363. <tr>
  28364. <td>
  28365. <code>auth</code></br>
  28366. <em>
  28367. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  28368. GithubAuth
  28369. </a>
  28370. </em>
  28371. </td>
  28372. <td>
  28373. <p>Auth configures how ESO authenticates with a Github instance.</p>
  28374. </td>
  28375. </tr>
  28376. </tbody>
  28377. </table>
  28378. <h3 id="generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth
  28379. </h3>
  28380. <p>
  28381. (<em>Appears on:</em>
  28382. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec</a>)
  28383. </p>
  28384. <p>
  28385. <p>GithubAuth defines the authentication configuration for GitHub access.</p>
  28386. </p>
  28387. <table>
  28388. <thead>
  28389. <tr>
  28390. <th>Field</th>
  28391. <th>Description</th>
  28392. </tr>
  28393. </thead>
  28394. <tbody>
  28395. <tr>
  28396. <td>
  28397. <code>privateKey</code></br>
  28398. <em>
  28399. <a href="#generators.external-secrets.io/v1alpha1.GithubSecretRef">
  28400. GithubSecretRef
  28401. </a>
  28402. </em>
  28403. </td>
  28404. <td>
  28405. </td>
  28406. </tr>
  28407. </tbody>
  28408. </table>
  28409. <h3 id="generators.external-secrets.io/v1alpha1.GithubSecretRef">GithubSecretRef
  28410. </h3>
  28411. <p>
  28412. (<em>Appears on:</em>
  28413. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth</a>)
  28414. </p>
  28415. <p>
  28416. <p>GithubSecretRef references a secret containing GitHub credentials.</p>
  28417. </p>
  28418. <table>
  28419. <thead>
  28420. <tr>
  28421. <th>Field</th>
  28422. <th>Description</th>
  28423. </tr>
  28424. </thead>
  28425. <tbody>
  28426. <tr>
  28427. <td>
  28428. <code>secretRef</code></br>
  28429. <em>
  28430. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28431. External Secrets meta/v1.SecretKeySelector
  28432. </a>
  28433. </em>
  28434. </td>
  28435. <td>
  28436. </td>
  28437. </tr>
  28438. </tbody>
  28439. </table>
  28440. <h3 id="generators.external-secrets.io/v1alpha1.Grafana">Grafana
  28441. </h3>
  28442. <p>
  28443. <p>Grafana represents a generator for Grafana service account tokens.</p>
  28444. </p>
  28445. <table>
  28446. <thead>
  28447. <tr>
  28448. <th>Field</th>
  28449. <th>Description</th>
  28450. </tr>
  28451. </thead>
  28452. <tbody>
  28453. <tr>
  28454. <td>
  28455. <code>metadata</code></br>
  28456. <em>
  28457. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28458. Kubernetes meta/v1.ObjectMeta
  28459. </a>
  28460. </em>
  28461. </td>
  28462. <td>
  28463. Refer to the Kubernetes API documentation for the fields of the
  28464. <code>metadata</code> field.
  28465. </td>
  28466. </tr>
  28467. <tr>
  28468. <td>
  28469. <code>spec</code></br>
  28470. <em>
  28471. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  28472. GrafanaSpec
  28473. </a>
  28474. </em>
  28475. </td>
  28476. <td>
  28477. <br/>
  28478. <br/>
  28479. <table>
  28480. <tr>
  28481. <td>
  28482. <code>url</code></br>
  28483. <em>
  28484. string
  28485. </em>
  28486. </td>
  28487. <td>
  28488. <p>URL is the URL of the Grafana instance.</p>
  28489. </td>
  28490. </tr>
  28491. <tr>
  28492. <td>
  28493. <code>auth</code></br>
  28494. <em>
  28495. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  28496. GrafanaAuth
  28497. </a>
  28498. </em>
  28499. </td>
  28500. <td>
  28501. <p>Auth is the authentication configuration to authenticate
  28502. against the Grafana instance.</p>
  28503. </td>
  28504. </tr>
  28505. <tr>
  28506. <td>
  28507. <code>serviceAccount</code></br>
  28508. <em>
  28509. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  28510. GrafanaServiceAccount
  28511. </a>
  28512. </em>
  28513. </td>
  28514. <td>
  28515. <p>ServiceAccount is the configuration for the service account that
  28516. is supposed to be generated by the generator.</p>
  28517. </td>
  28518. </tr>
  28519. </table>
  28520. </td>
  28521. </tr>
  28522. </tbody>
  28523. </table>
  28524. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth
  28525. </h3>
  28526. <p>
  28527. (<em>Appears on:</em>
  28528. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  28529. </p>
  28530. <p>
  28531. <p>GrafanaAuth defines the authentication methods for connecting to a Grafana instance.</p>
  28532. </p>
  28533. <table>
  28534. <thead>
  28535. <tr>
  28536. <th>Field</th>
  28537. <th>Description</th>
  28538. </tr>
  28539. </thead>
  28540. <tbody>
  28541. <tr>
  28542. <td>
  28543. <code>token</code></br>
  28544. <em>
  28545. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  28546. SecretKeySelector
  28547. </a>
  28548. </em>
  28549. </td>
  28550. <td>
  28551. <em>(Optional)</em>
  28552. <p>A service account token used to authenticate against the Grafana instance.
  28553. Note: you need a token which has elevated permissions to create service accounts.
  28554. See here for the documentation on basic roles offered by Grafana:
  28555. <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>
  28556. </td>
  28557. </tr>
  28558. <tr>
  28559. <td>
  28560. <code>basic</code></br>
  28561. <em>
  28562. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">
  28563. GrafanaBasicAuth
  28564. </a>
  28565. </em>
  28566. </td>
  28567. <td>
  28568. <em>(Optional)</em>
  28569. <p>Basic auth credentials used to authenticate against the Grafana instance.
  28570. Note: you need a token which has elevated permissions to create service accounts.
  28571. See here for the documentation on basic roles offered by Grafana:
  28572. <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>
  28573. </td>
  28574. </tr>
  28575. </tbody>
  28576. </table>
  28577. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth
  28578. </h3>
  28579. <p>
  28580. (<em>Appears on:</em>
  28581. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>)
  28582. </p>
  28583. <p>
  28584. <p>GrafanaBasicAuth defines the credentials for basic authentication with Grafana.</p>
  28585. </p>
  28586. <table>
  28587. <thead>
  28588. <tr>
  28589. <th>Field</th>
  28590. <th>Description</th>
  28591. </tr>
  28592. </thead>
  28593. <tbody>
  28594. <tr>
  28595. <td>
  28596. <code>username</code></br>
  28597. <em>
  28598. string
  28599. </em>
  28600. </td>
  28601. <td>
  28602. <p>A basic auth username used to authenticate against the Grafana instance.</p>
  28603. </td>
  28604. </tr>
  28605. <tr>
  28606. <td>
  28607. <code>password</code></br>
  28608. <em>
  28609. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  28610. SecretKeySelector
  28611. </a>
  28612. </em>
  28613. </td>
  28614. <td>
  28615. <p>A basic auth password used to authenticate against the Grafana instance.</p>
  28616. </td>
  28617. </tr>
  28618. </tbody>
  28619. </table>
  28620. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">GrafanaServiceAccount
  28621. </h3>
  28622. <p>
  28623. (<em>Appears on:</em>
  28624. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  28625. </p>
  28626. <p>
  28627. <p>GrafanaServiceAccount defines the configuration for a Grafana service account to be created.</p>
  28628. </p>
  28629. <table>
  28630. <thead>
  28631. <tr>
  28632. <th>Field</th>
  28633. <th>Description</th>
  28634. </tr>
  28635. </thead>
  28636. <tbody>
  28637. <tr>
  28638. <td>
  28639. <code>name</code></br>
  28640. <em>
  28641. string
  28642. </em>
  28643. </td>
  28644. <td>
  28645. <p>Name is the name of the service account that will be created by ESO.</p>
  28646. </td>
  28647. </tr>
  28648. <tr>
  28649. <td>
  28650. <code>role</code></br>
  28651. <em>
  28652. string
  28653. </em>
  28654. </td>
  28655. <td>
  28656. <p>Role is the role of the service account.
  28657. See here for the documentation on basic roles offered by Grafana:
  28658. <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>
  28659. </td>
  28660. </tr>
  28661. </tbody>
  28662. </table>
  28663. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState
  28664. </h3>
  28665. <p>
  28666. <p>GrafanaServiceAccountTokenState is the state type produced by the Grafana generator.
  28667. It contains the service account ID, login and token ID which is enough to
  28668. identify the service account.</p>
  28669. </p>
  28670. <table>
  28671. <thead>
  28672. <tr>
  28673. <th>Field</th>
  28674. <th>Description</th>
  28675. </tr>
  28676. </thead>
  28677. <tbody>
  28678. <tr>
  28679. <td>
  28680. <code>serviceAccount</code></br>
  28681. <em>
  28682. <a href="#generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">
  28683. GrafanaStateServiceAccount
  28684. </a>
  28685. </em>
  28686. </td>
  28687. <td>
  28688. </td>
  28689. </tr>
  28690. </tbody>
  28691. </table>
  28692. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec
  28693. </h3>
  28694. <p>
  28695. (<em>Appears on:</em>
  28696. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  28697. <a href="#generators.external-secrets.io/v1alpha1.Grafana">Grafana</a>)
  28698. </p>
  28699. <p>
  28700. <p>GrafanaSpec controls the behavior of the grafana generator.</p>
  28701. </p>
  28702. <table>
  28703. <thead>
  28704. <tr>
  28705. <th>Field</th>
  28706. <th>Description</th>
  28707. </tr>
  28708. </thead>
  28709. <tbody>
  28710. <tr>
  28711. <td>
  28712. <code>url</code></br>
  28713. <em>
  28714. string
  28715. </em>
  28716. </td>
  28717. <td>
  28718. <p>URL is the URL of the Grafana instance.</p>
  28719. </td>
  28720. </tr>
  28721. <tr>
  28722. <td>
  28723. <code>auth</code></br>
  28724. <em>
  28725. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  28726. GrafanaAuth
  28727. </a>
  28728. </em>
  28729. </td>
  28730. <td>
  28731. <p>Auth is the authentication configuration to authenticate
  28732. against the Grafana instance.</p>
  28733. </td>
  28734. </tr>
  28735. <tr>
  28736. <td>
  28737. <code>serviceAccount</code></br>
  28738. <em>
  28739. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  28740. GrafanaServiceAccount
  28741. </a>
  28742. </em>
  28743. </td>
  28744. <td>
  28745. <p>ServiceAccount is the configuration for the service account that
  28746. is supposed to be generated by the generator.</p>
  28747. </td>
  28748. </tr>
  28749. </tbody>
  28750. </table>
  28751. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">GrafanaStateServiceAccount
  28752. </h3>
  28753. <p>
  28754. (<em>Appears on:</em>
  28755. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState</a>)
  28756. </p>
  28757. <p>
  28758. <p>GrafanaStateServiceAccount contains the service account ID, login and token ID.</p>
  28759. </p>
  28760. <table>
  28761. <thead>
  28762. <tr>
  28763. <th>Field</th>
  28764. <th>Description</th>
  28765. </tr>
  28766. </thead>
  28767. <tbody>
  28768. <tr>
  28769. <td>
  28770. <code>id</code></br>
  28771. <em>
  28772. int64
  28773. </em>
  28774. </td>
  28775. <td>
  28776. </td>
  28777. </tr>
  28778. <tr>
  28779. <td>
  28780. <code>login</code></br>
  28781. <em>
  28782. string
  28783. </em>
  28784. </td>
  28785. <td>
  28786. </td>
  28787. </tr>
  28788. <tr>
  28789. <td>
  28790. <code>tokenID</code></br>
  28791. <em>
  28792. int64
  28793. </em>
  28794. </td>
  28795. <td>
  28796. </td>
  28797. </tr>
  28798. </tbody>
  28799. </table>
  28800. <h3 id="generators.external-secrets.io/v1alpha1.MFA">MFA
  28801. </h3>
  28802. <p>
  28803. <p>MFA generates a new TOTP token that is compliant with RFC 6238.</p>
  28804. </p>
  28805. <table>
  28806. <thead>
  28807. <tr>
  28808. <th>Field</th>
  28809. <th>Description</th>
  28810. </tr>
  28811. </thead>
  28812. <tbody>
  28813. <tr>
  28814. <td>
  28815. <code>metadata</code></br>
  28816. <em>
  28817. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28818. Kubernetes meta/v1.ObjectMeta
  28819. </a>
  28820. </em>
  28821. </td>
  28822. <td>
  28823. Refer to the Kubernetes API documentation for the fields of the
  28824. <code>metadata</code> field.
  28825. </td>
  28826. </tr>
  28827. <tr>
  28828. <td>
  28829. <code>spec</code></br>
  28830. <em>
  28831. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  28832. MFASpec
  28833. </a>
  28834. </em>
  28835. </td>
  28836. <td>
  28837. <br/>
  28838. <br/>
  28839. <table>
  28840. <tr>
  28841. <td>
  28842. <code>secret</code></br>
  28843. <em>
  28844. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28845. External Secrets meta/v1.SecretKeySelector
  28846. </a>
  28847. </em>
  28848. </td>
  28849. <td>
  28850. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  28851. </td>
  28852. </tr>
  28853. <tr>
  28854. <td>
  28855. <code>length</code></br>
  28856. <em>
  28857. int
  28858. </em>
  28859. </td>
  28860. <td>
  28861. <p>Length defines the token length. Defaults to 6 characters.</p>
  28862. </td>
  28863. </tr>
  28864. <tr>
  28865. <td>
  28866. <code>timePeriod</code></br>
  28867. <em>
  28868. int
  28869. </em>
  28870. </td>
  28871. <td>
  28872. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  28873. </td>
  28874. </tr>
  28875. <tr>
  28876. <td>
  28877. <code>algorithm</code></br>
  28878. <em>
  28879. string
  28880. </em>
  28881. </td>
  28882. <td>
  28883. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  28884. </td>
  28885. </tr>
  28886. <tr>
  28887. <td>
  28888. <code>when</code></br>
  28889. <em>
  28890. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  28891. Kubernetes meta/v1.Time
  28892. </a>
  28893. </em>
  28894. </td>
  28895. <td>
  28896. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  28897. </td>
  28898. </tr>
  28899. </table>
  28900. </td>
  28901. </tr>
  28902. </tbody>
  28903. </table>
  28904. <h3 id="generators.external-secrets.io/v1alpha1.MFASpec">MFASpec
  28905. </h3>
  28906. <p>
  28907. (<em>Appears on:</em>
  28908. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  28909. <a href="#generators.external-secrets.io/v1alpha1.MFA">MFA</a>)
  28910. </p>
  28911. <p>
  28912. <p>MFASpec controls the behavior of the mfa generator.</p>
  28913. </p>
  28914. <table>
  28915. <thead>
  28916. <tr>
  28917. <th>Field</th>
  28918. <th>Description</th>
  28919. </tr>
  28920. </thead>
  28921. <tbody>
  28922. <tr>
  28923. <td>
  28924. <code>secret</code></br>
  28925. <em>
  28926. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28927. External Secrets meta/v1.SecretKeySelector
  28928. </a>
  28929. </em>
  28930. </td>
  28931. <td>
  28932. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  28933. </td>
  28934. </tr>
  28935. <tr>
  28936. <td>
  28937. <code>length</code></br>
  28938. <em>
  28939. int
  28940. </em>
  28941. </td>
  28942. <td>
  28943. <p>Length defines the token length. Defaults to 6 characters.</p>
  28944. </td>
  28945. </tr>
  28946. <tr>
  28947. <td>
  28948. <code>timePeriod</code></br>
  28949. <em>
  28950. int
  28951. </em>
  28952. </td>
  28953. <td>
  28954. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  28955. </td>
  28956. </tr>
  28957. <tr>
  28958. <td>
  28959. <code>algorithm</code></br>
  28960. <em>
  28961. string
  28962. </em>
  28963. </td>
  28964. <td>
  28965. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  28966. </td>
  28967. </tr>
  28968. <tr>
  28969. <td>
  28970. <code>when</code></br>
  28971. <em>
  28972. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  28973. Kubernetes meta/v1.Time
  28974. </a>
  28975. </em>
  28976. </td>
  28977. <td>
  28978. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  28979. </td>
  28980. </tr>
  28981. </tbody>
  28982. </table>
  28983. <h3 id="generators.external-secrets.io/v1alpha1.NTLMProtocol">NTLMProtocol
  28984. </h3>
  28985. <p>
  28986. (<em>Appears on:</em>
  28987. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol</a>)
  28988. </p>
  28989. <p>
  28990. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  28991. </p>
  28992. <table>
  28993. <thead>
  28994. <tr>
  28995. <th>Field</th>
  28996. <th>Description</th>
  28997. </tr>
  28998. </thead>
  28999. <tbody>
  29000. <tr>
  29001. <td>
  29002. <code>usernameSecret</code></br>
  29003. <em>
  29004. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29005. External Secrets meta/v1.SecretKeySelector
  29006. </a>
  29007. </em>
  29008. </td>
  29009. <td>
  29010. </td>
  29011. </tr>
  29012. <tr>
  29013. <td>
  29014. <code>passwordSecret</code></br>
  29015. <em>
  29016. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  29017. External Secrets meta/v1.SecretKeySelector
  29018. </a>
  29019. </em>
  29020. </td>
  29021. <td>
  29022. </td>
  29023. </tr>
  29024. </tbody>
  29025. </table>
  29026. <h3 id="generators.external-secrets.io/v1alpha1.Password">Password
  29027. </h3>
  29028. <p>
  29029. <p>Password generates a random password based on the
  29030. configuration parameters in spec.
  29031. You can specify the length, characterset and other attributes.</p>
  29032. </p>
  29033. <table>
  29034. <thead>
  29035. <tr>
  29036. <th>Field</th>
  29037. <th>Description</th>
  29038. </tr>
  29039. </thead>
  29040. <tbody>
  29041. <tr>
  29042. <td>
  29043. <code>metadata</code></br>
  29044. <em>
  29045. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29046. Kubernetes meta/v1.ObjectMeta
  29047. </a>
  29048. </em>
  29049. </td>
  29050. <td>
  29051. Refer to the Kubernetes API documentation for the fields of the
  29052. <code>metadata</code> field.
  29053. </td>
  29054. </tr>
  29055. <tr>
  29056. <td>
  29057. <code>spec</code></br>
  29058. <em>
  29059. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  29060. PasswordSpec
  29061. </a>
  29062. </em>
  29063. </td>
  29064. <td>
  29065. <br/>
  29066. <br/>
  29067. <table>
  29068. <tr>
  29069. <td>
  29070. <code>length</code></br>
  29071. <em>
  29072. int
  29073. </em>
  29074. </td>
  29075. <td>
  29076. <p>Length of the password to be generated.
  29077. Defaults to 24</p>
  29078. </td>
  29079. </tr>
  29080. <tr>
  29081. <td>
  29082. <code>digits</code></br>
  29083. <em>
  29084. int
  29085. </em>
  29086. </td>
  29087. <td>
  29088. <p>Digits specifies the number of digits in the generated
  29089. password. If omitted it defaults to 25% of the length of the password</p>
  29090. </td>
  29091. </tr>
  29092. <tr>
  29093. <td>
  29094. <code>symbols</code></br>
  29095. <em>
  29096. int
  29097. </em>
  29098. </td>
  29099. <td>
  29100. <p>Symbols specifies the number of symbol characters in the generated
  29101. password. If omitted it defaults to 25% of the length of the password</p>
  29102. </td>
  29103. </tr>
  29104. <tr>
  29105. <td>
  29106. <code>symbolCharacters</code></br>
  29107. <em>
  29108. string
  29109. </em>
  29110. </td>
  29111. <td>
  29112. <p>SymbolCharacters specifies the special characters that should be used
  29113. in the generated password.</p>
  29114. </td>
  29115. </tr>
  29116. <tr>
  29117. <td>
  29118. <code>noUpper</code></br>
  29119. <em>
  29120. bool
  29121. </em>
  29122. </td>
  29123. <td>
  29124. <p>Set NoUpper to disable uppercase characters</p>
  29125. </td>
  29126. </tr>
  29127. <tr>
  29128. <td>
  29129. <code>allowRepeat</code></br>
  29130. <em>
  29131. bool
  29132. </em>
  29133. </td>
  29134. <td>
  29135. <p>set AllowRepeat to true to allow repeating characters.</p>
  29136. </td>
  29137. </tr>
  29138. <tr>
  29139. <td>
  29140. <code>secretKeys</code></br>
  29141. <em>
  29142. []string
  29143. </em>
  29144. </td>
  29145. <td>
  29146. <em>(Optional)</em>
  29147. <p>SecretKeys defines the keys that will be populated with generated passwords.
  29148. Defaults to &ldquo;password&rdquo; when not set.</p>
  29149. </td>
  29150. </tr>
  29151. <tr>
  29152. <td>
  29153. <code>encoding</code></br>
  29154. <em>
  29155. string
  29156. </em>
  29157. </td>
  29158. <td>
  29159. <p>Encoding specifies the encoding of the generated password.
  29160. Valid values are:
  29161. - &ldquo;raw&rdquo; (default): no encoding
  29162. - &ldquo;base64&rdquo;: standard base64 encoding
  29163. - &ldquo;base64url&rdquo;: base64url encoding
  29164. - &ldquo;base32&rdquo;: base32 encoding
  29165. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  29166. </td>
  29167. </tr>
  29168. </table>
  29169. </td>
  29170. </tr>
  29171. </tbody>
  29172. </table>
  29173. <h3 id="generators.external-secrets.io/v1alpha1.PasswordSpec">PasswordSpec
  29174. </h3>
  29175. <p>
  29176. (<em>Appears on:</em>
  29177. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29178. <a href="#generators.external-secrets.io/v1alpha1.Password">Password</a>)
  29179. </p>
  29180. <p>
  29181. <p>PasswordSpec controls the behavior of the password generator.</p>
  29182. </p>
  29183. <table>
  29184. <thead>
  29185. <tr>
  29186. <th>Field</th>
  29187. <th>Description</th>
  29188. </tr>
  29189. </thead>
  29190. <tbody>
  29191. <tr>
  29192. <td>
  29193. <code>length</code></br>
  29194. <em>
  29195. int
  29196. </em>
  29197. </td>
  29198. <td>
  29199. <p>Length of the password to be generated.
  29200. Defaults to 24</p>
  29201. </td>
  29202. </tr>
  29203. <tr>
  29204. <td>
  29205. <code>digits</code></br>
  29206. <em>
  29207. int
  29208. </em>
  29209. </td>
  29210. <td>
  29211. <p>Digits specifies the number of digits in the generated
  29212. password. If omitted it defaults to 25% of the length of the password</p>
  29213. </td>
  29214. </tr>
  29215. <tr>
  29216. <td>
  29217. <code>symbols</code></br>
  29218. <em>
  29219. int
  29220. </em>
  29221. </td>
  29222. <td>
  29223. <p>Symbols specifies the number of symbol characters in the generated
  29224. password. If omitted it defaults to 25% of the length of the password</p>
  29225. </td>
  29226. </tr>
  29227. <tr>
  29228. <td>
  29229. <code>symbolCharacters</code></br>
  29230. <em>
  29231. string
  29232. </em>
  29233. </td>
  29234. <td>
  29235. <p>SymbolCharacters specifies the special characters that should be used
  29236. in the generated password.</p>
  29237. </td>
  29238. </tr>
  29239. <tr>
  29240. <td>
  29241. <code>noUpper</code></br>
  29242. <em>
  29243. bool
  29244. </em>
  29245. </td>
  29246. <td>
  29247. <p>Set NoUpper to disable uppercase characters</p>
  29248. </td>
  29249. </tr>
  29250. <tr>
  29251. <td>
  29252. <code>allowRepeat</code></br>
  29253. <em>
  29254. bool
  29255. </em>
  29256. </td>
  29257. <td>
  29258. <p>set AllowRepeat to true to allow repeating characters.</p>
  29259. </td>
  29260. </tr>
  29261. <tr>
  29262. <td>
  29263. <code>secretKeys</code></br>
  29264. <em>
  29265. []string
  29266. </em>
  29267. </td>
  29268. <td>
  29269. <em>(Optional)</em>
  29270. <p>SecretKeys defines the keys that will be populated with generated passwords.
  29271. Defaults to &ldquo;password&rdquo; when not set.</p>
  29272. </td>
  29273. </tr>
  29274. <tr>
  29275. <td>
  29276. <code>encoding</code></br>
  29277. <em>
  29278. string
  29279. </em>
  29280. </td>
  29281. <td>
  29282. <p>Encoding specifies the encoding of the generated password.
  29283. Valid values are:
  29284. - &ldquo;raw&rdquo; (default): no encoding
  29285. - &ldquo;base64&rdquo;: standard base64 encoding
  29286. - &ldquo;base64url&rdquo;: base64url encoding
  29287. - &ldquo;base32&rdquo;: base32 encoding
  29288. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  29289. </td>
  29290. </tr>
  29291. </tbody>
  29292. </table>
  29293. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken
  29294. </h3>
  29295. <p>
  29296. <p>QuayAccessToken generates Quay oauth token for pulling/pushing images</p>
  29297. </p>
  29298. <table>
  29299. <thead>
  29300. <tr>
  29301. <th>Field</th>
  29302. <th>Description</th>
  29303. </tr>
  29304. </thead>
  29305. <tbody>
  29306. <tr>
  29307. <td>
  29308. <code>metadata</code></br>
  29309. <em>
  29310. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29311. Kubernetes meta/v1.ObjectMeta
  29312. </a>
  29313. </em>
  29314. </td>
  29315. <td>
  29316. Refer to the Kubernetes API documentation for the fields of the
  29317. <code>metadata</code> field.
  29318. </td>
  29319. </tr>
  29320. <tr>
  29321. <td>
  29322. <code>spec</code></br>
  29323. <em>
  29324. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  29325. QuayAccessTokenSpec
  29326. </a>
  29327. </em>
  29328. </td>
  29329. <td>
  29330. <br/>
  29331. <br/>
  29332. <table>
  29333. <tr>
  29334. <td>
  29335. <code>url</code></br>
  29336. <em>
  29337. string
  29338. </em>
  29339. </td>
  29340. <td>
  29341. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  29342. </td>
  29343. </tr>
  29344. <tr>
  29345. <td>
  29346. <code>robotAccount</code></br>
  29347. <em>
  29348. string
  29349. </em>
  29350. </td>
  29351. <td>
  29352. <p>Name of the robot account you are federating with</p>
  29353. </td>
  29354. </tr>
  29355. <tr>
  29356. <td>
  29357. <code>serviceAccountRef</code></br>
  29358. <em>
  29359. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  29360. External Secrets meta/v1.ServiceAccountSelector
  29361. </a>
  29362. </em>
  29363. </td>
  29364. <td>
  29365. <p>Name of the service account you are federating with</p>
  29366. </td>
  29367. </tr>
  29368. </table>
  29369. </td>
  29370. </tr>
  29371. </tbody>
  29372. </table>
  29373. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">QuayAccessTokenSpec
  29374. </h3>
  29375. <p>
  29376. (<em>Appears on:</em>
  29377. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29378. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken</a>)
  29379. </p>
  29380. <p>
  29381. <p>QuayAccessTokenSpec defines the desired state to generate a Quay access token.</p>
  29382. </p>
  29383. <table>
  29384. <thead>
  29385. <tr>
  29386. <th>Field</th>
  29387. <th>Description</th>
  29388. </tr>
  29389. </thead>
  29390. <tbody>
  29391. <tr>
  29392. <td>
  29393. <code>url</code></br>
  29394. <em>
  29395. string
  29396. </em>
  29397. </td>
  29398. <td>
  29399. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  29400. </td>
  29401. </tr>
  29402. <tr>
  29403. <td>
  29404. <code>robotAccount</code></br>
  29405. <em>
  29406. string
  29407. </em>
  29408. </td>
  29409. <td>
  29410. <p>Name of the robot account you are federating with</p>
  29411. </td>
  29412. </tr>
  29413. <tr>
  29414. <td>
  29415. <code>serviceAccountRef</code></br>
  29416. <em>
  29417. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  29418. External Secrets meta/v1.ServiceAccountSelector
  29419. </a>
  29420. </em>
  29421. </td>
  29422. <td>
  29423. <p>Name of the service account you are federating with</p>
  29424. </td>
  29425. </tr>
  29426. </tbody>
  29427. </table>
  29428. <h3 id="generators.external-secrets.io/v1alpha1.RequestParameters">RequestParameters
  29429. </h3>
  29430. <p>
  29431. (<em>Appears on:</em>
  29432. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  29433. </p>
  29434. <p>
  29435. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  29436. </p>
  29437. <table>
  29438. <thead>
  29439. <tr>
  29440. <th>Field</th>
  29441. <th>Description</th>
  29442. </tr>
  29443. </thead>
  29444. <tbody>
  29445. <tr>
  29446. <td>
  29447. <code>sessionDuration</code></br>
  29448. <em>
  29449. int32
  29450. </em>
  29451. </td>
  29452. <td>
  29453. <em>(Optional)</em>
  29454. </td>
  29455. </tr>
  29456. <tr>
  29457. <td>
  29458. <code>serialNumber</code></br>
  29459. <em>
  29460. string
  29461. </em>
  29462. </td>
  29463. <td>
  29464. <em>(Optional)</em>
  29465. <p>SerialNumber is the identification number of the MFA device that is associated with the IAM user who is making
  29466. the GetSessionToken call.
  29467. Possible values: hardware device (such as GAHT12345678) or an Amazon Resource Name (ARN) for a virtual device
  29468. (such as arn:aws:iam::123456789012:mfa/user)</p>
  29469. </td>
  29470. </tr>
  29471. <tr>
  29472. <td>
  29473. <code>tokenCode</code></br>
  29474. <em>
  29475. string
  29476. </em>
  29477. </td>
  29478. <td>
  29479. <em>(Optional)</em>
  29480. <p>TokenCode is the value provided by the MFA device, if MFA is required.</p>
  29481. </td>
  29482. </tr>
  29483. </tbody>
  29484. </table>
  29485. <h3 id="generators.external-secrets.io/v1alpha1.SSHKey">SSHKey
  29486. </h3>
  29487. <p>
  29488. <p>SSHKey generates SSH key pairs.</p>
  29489. </p>
  29490. <table>
  29491. <thead>
  29492. <tr>
  29493. <th>Field</th>
  29494. <th>Description</th>
  29495. </tr>
  29496. </thead>
  29497. <tbody>
  29498. <tr>
  29499. <td>
  29500. <code>metadata</code></br>
  29501. <em>
  29502. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29503. Kubernetes meta/v1.ObjectMeta
  29504. </a>
  29505. </em>
  29506. </td>
  29507. <td>
  29508. Refer to the Kubernetes API documentation for the fields of the
  29509. <code>metadata</code> field.
  29510. </td>
  29511. </tr>
  29512. <tr>
  29513. <td>
  29514. <code>spec</code></br>
  29515. <em>
  29516. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  29517. SSHKeySpec
  29518. </a>
  29519. </em>
  29520. </td>
  29521. <td>
  29522. <br/>
  29523. <br/>
  29524. <table>
  29525. <tr>
  29526. <td>
  29527. <code>keyType</code></br>
  29528. <em>
  29529. string
  29530. </em>
  29531. </td>
  29532. <td>
  29533. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  29534. </td>
  29535. </tr>
  29536. <tr>
  29537. <td>
  29538. <code>keySize</code></br>
  29539. <em>
  29540. int
  29541. </em>
  29542. </td>
  29543. <td>
  29544. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  29545. For RSA keys: 2048, 3072, 4096
  29546. For ECDSA keys: 256, 384, 521
  29547. Ignored for ed25519 keys</p>
  29548. </td>
  29549. </tr>
  29550. <tr>
  29551. <td>
  29552. <code>comment</code></br>
  29553. <em>
  29554. string
  29555. </em>
  29556. </td>
  29557. <td>
  29558. <p>Comment specifies an optional comment for the SSH key</p>
  29559. </td>
  29560. </tr>
  29561. </table>
  29562. </td>
  29563. </tr>
  29564. </tbody>
  29565. </table>
  29566. <h3 id="generators.external-secrets.io/v1alpha1.SSHKeySpec">SSHKeySpec
  29567. </h3>
  29568. <p>
  29569. (<em>Appears on:</em>
  29570. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29571. <a href="#generators.external-secrets.io/v1alpha1.SSHKey">SSHKey</a>)
  29572. </p>
  29573. <p>
  29574. <p>SSHKeySpec controls the behavior of the ssh key generator.</p>
  29575. </p>
  29576. <table>
  29577. <thead>
  29578. <tr>
  29579. <th>Field</th>
  29580. <th>Description</th>
  29581. </tr>
  29582. </thead>
  29583. <tbody>
  29584. <tr>
  29585. <td>
  29586. <code>keyType</code></br>
  29587. <em>
  29588. string
  29589. </em>
  29590. </td>
  29591. <td>
  29592. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  29593. </td>
  29594. </tr>
  29595. <tr>
  29596. <td>
  29597. <code>keySize</code></br>
  29598. <em>
  29599. int
  29600. </em>
  29601. </td>
  29602. <td>
  29603. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  29604. For RSA keys: 2048, 3072, 4096
  29605. For ECDSA keys: 256, 384, 521
  29606. Ignored for ed25519 keys</p>
  29607. </td>
  29608. </tr>
  29609. <tr>
  29610. <td>
  29611. <code>comment</code></br>
  29612. <em>
  29613. string
  29614. </em>
  29615. </td>
  29616. <td>
  29617. <p>Comment specifies an optional comment for the SSH key</p>
  29618. </td>
  29619. </tr>
  29620. </tbody>
  29621. </table>
  29622. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken
  29623. </h3>
  29624. <p>
  29625. <p>STSSessionToken uses the GetSessionToken API to retrieve an authorization token.
  29626. The authorization token is valid for 12 hours.
  29627. The authorizationToken returned is a base64 encoded string that can be decoded.
  29628. 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>
  29629. </p>
  29630. <table>
  29631. <thead>
  29632. <tr>
  29633. <th>Field</th>
  29634. <th>Description</th>
  29635. </tr>
  29636. </thead>
  29637. <tbody>
  29638. <tr>
  29639. <td>
  29640. <code>metadata</code></br>
  29641. <em>
  29642. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29643. Kubernetes meta/v1.ObjectMeta
  29644. </a>
  29645. </em>
  29646. </td>
  29647. <td>
  29648. Refer to the Kubernetes API documentation for the fields of the
  29649. <code>metadata</code> field.
  29650. </td>
  29651. </tr>
  29652. <tr>
  29653. <td>
  29654. <code>spec</code></br>
  29655. <em>
  29656. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  29657. STSSessionTokenSpec
  29658. </a>
  29659. </em>
  29660. </td>
  29661. <td>
  29662. <br/>
  29663. <br/>
  29664. <table>
  29665. <tr>
  29666. <td>
  29667. <code>region</code></br>
  29668. <em>
  29669. string
  29670. </em>
  29671. </td>
  29672. <td>
  29673. <p>Region specifies the region to operate in.</p>
  29674. </td>
  29675. </tr>
  29676. <tr>
  29677. <td>
  29678. <code>auth</code></br>
  29679. <em>
  29680. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  29681. AWSAuth
  29682. </a>
  29683. </em>
  29684. </td>
  29685. <td>
  29686. <em>(Optional)</em>
  29687. <p>Auth defines how to authenticate with AWS</p>
  29688. </td>
  29689. </tr>
  29690. <tr>
  29691. <td>
  29692. <code>role</code></br>
  29693. <em>
  29694. string
  29695. </em>
  29696. </td>
  29697. <td>
  29698. <em>(Optional)</em>
  29699. <p>You can assume a role before making calls to the
  29700. desired AWS service.</p>
  29701. </td>
  29702. </tr>
  29703. <tr>
  29704. <td>
  29705. <code>requestParameters</code></br>
  29706. <em>
  29707. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  29708. RequestParameters
  29709. </a>
  29710. </em>
  29711. </td>
  29712. <td>
  29713. <em>(Optional)</em>
  29714. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  29715. </td>
  29716. </tr>
  29717. </table>
  29718. </td>
  29719. </tr>
  29720. </tbody>
  29721. </table>
  29722. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec
  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.STSSessionToken">STSSessionToken</a>)
  29728. </p>
  29729. <p>
  29730. <p>STSSessionTokenSpec defines the desired state to generate an AWS STS session token.</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>region</code></br>
  29743. <em>
  29744. string
  29745. </em>
  29746. </td>
  29747. <td>
  29748. <p>Region specifies the region to operate in.</p>
  29749. </td>
  29750. </tr>
  29751. <tr>
  29752. <td>
  29753. <code>auth</code></br>
  29754. <em>
  29755. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  29756. AWSAuth
  29757. </a>
  29758. </em>
  29759. </td>
  29760. <td>
  29761. <em>(Optional)</em>
  29762. <p>Auth defines how to authenticate with AWS</p>
  29763. </td>
  29764. </tr>
  29765. <tr>
  29766. <td>
  29767. <code>role</code></br>
  29768. <em>
  29769. string
  29770. </em>
  29771. </td>
  29772. <td>
  29773. <em>(Optional)</em>
  29774. <p>You can assume a role before making calls to the
  29775. desired AWS service.</p>
  29776. </td>
  29777. </tr>
  29778. <tr>
  29779. <td>
  29780. <code>requestParameters</code></br>
  29781. <em>
  29782. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  29783. RequestParameters
  29784. </a>
  29785. </em>
  29786. </td>
  29787. <td>
  29788. <em>(Optional)</em>
  29789. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  29790. </td>
  29791. </tr>
  29792. </tbody>
  29793. </table>
  29794. <h3 id="generators.external-secrets.io/v1alpha1.SecretKeySelector">SecretKeySelector
  29795. </h3>
  29796. <p>
  29797. (<em>Appears on:</em>
  29798. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>,
  29799. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth</a>,
  29800. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret</a>)
  29801. </p>
  29802. <p>
  29803. <p>SecretKeySelector defines a reference to a specific key within a Kubernetes Secret.</p>
  29804. </p>
  29805. <table>
  29806. <thead>
  29807. <tr>
  29808. <th>Field</th>
  29809. <th>Description</th>
  29810. </tr>
  29811. </thead>
  29812. <tbody>
  29813. <tr>
  29814. <td>
  29815. <code>name</code></br>
  29816. <em>
  29817. string
  29818. </em>
  29819. </td>
  29820. <td>
  29821. <p>The name of the Secret resource being referred to.</p>
  29822. </td>
  29823. </tr>
  29824. <tr>
  29825. <td>
  29826. <code>key</code></br>
  29827. <em>
  29828. string
  29829. </em>
  29830. </td>
  29831. <td>
  29832. <p>The key where the token is found.</p>
  29833. </td>
  29834. </tr>
  29835. </tbody>
  29836. </table>
  29837. <h3 id="generators.external-secrets.io/v1alpha1.StatefulResource">StatefulResource
  29838. </h3>
  29839. <p>
  29840. <p>StatefulResource represents a Kubernetes resource that has state which can be tracked.</p>
  29841. </p>
  29842. <h3 id="generators.external-secrets.io/v1alpha1.UUID">UUID
  29843. </h3>
  29844. <p>
  29845. <p>UUID generates a version 1 UUID (e56657e3-764f-11ef-a397-65231a88c216).</p>
  29846. </p>
  29847. <table>
  29848. <thead>
  29849. <tr>
  29850. <th>Field</th>
  29851. <th>Description</th>
  29852. </tr>
  29853. </thead>
  29854. <tbody>
  29855. <tr>
  29856. <td>
  29857. <code>metadata</code></br>
  29858. <em>
  29859. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29860. Kubernetes meta/v1.ObjectMeta
  29861. </a>
  29862. </em>
  29863. </td>
  29864. <td>
  29865. Refer to the Kubernetes API documentation for the fields of the
  29866. <code>metadata</code> field.
  29867. </td>
  29868. </tr>
  29869. <tr>
  29870. <td>
  29871. <code>spec</code></br>
  29872. <em>
  29873. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  29874. UUIDSpec
  29875. </a>
  29876. </em>
  29877. </td>
  29878. <td>
  29879. <br/>
  29880. <br/>
  29881. <table>
  29882. </table>
  29883. </td>
  29884. </tr>
  29885. </tbody>
  29886. </table>
  29887. <h3 id="generators.external-secrets.io/v1alpha1.UUIDSpec">UUIDSpec
  29888. </h3>
  29889. <p>
  29890. (<em>Appears on:</em>
  29891. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29892. <a href="#generators.external-secrets.io/v1alpha1.UUID">UUID</a>)
  29893. </p>
  29894. <p>
  29895. <p>UUIDSpec controls the behavior of the uuid generator.</p>
  29896. </p>
  29897. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret
  29898. </h3>
  29899. <p>
  29900. <p>VaultDynamicSecret represents a generator that can create dynamic secrets from HashiCorp Vault.</p>
  29901. </p>
  29902. <table>
  29903. <thead>
  29904. <tr>
  29905. <th>Field</th>
  29906. <th>Description</th>
  29907. </tr>
  29908. </thead>
  29909. <tbody>
  29910. <tr>
  29911. <td>
  29912. <code>metadata</code></br>
  29913. <em>
  29914. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29915. Kubernetes meta/v1.ObjectMeta
  29916. </a>
  29917. </em>
  29918. </td>
  29919. <td>
  29920. Refer to the Kubernetes API documentation for the fields of the
  29921. <code>metadata</code> field.
  29922. </td>
  29923. </tr>
  29924. <tr>
  29925. <td>
  29926. <code>spec</code></br>
  29927. <em>
  29928. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  29929. VaultDynamicSecretSpec
  29930. </a>
  29931. </em>
  29932. </td>
  29933. <td>
  29934. <br/>
  29935. <br/>
  29936. <table>
  29937. <tr>
  29938. <td>
  29939. <code>controller</code></br>
  29940. <em>
  29941. string
  29942. </em>
  29943. </td>
  29944. <td>
  29945. <em>(Optional)</em>
  29946. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  29947. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  29948. </td>
  29949. </tr>
  29950. <tr>
  29951. <td>
  29952. <code>method</code></br>
  29953. <em>
  29954. string
  29955. </em>
  29956. </td>
  29957. <td>
  29958. <p>Vault API method to use (GET/POST/other)</p>
  29959. </td>
  29960. </tr>
  29961. <tr>
  29962. <td>
  29963. <code>parameters</code></br>
  29964. <em>
  29965. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29966. </em>
  29967. </td>
  29968. <td>
  29969. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  29970. </td>
  29971. </tr>
  29972. <tr>
  29973. <td>
  29974. <code>getParameters</code></br>
  29975. <em>
  29976. map[string][]string
  29977. </em>
  29978. </td>
  29979. <td>
  29980. <em>(Optional)</em>
  29981. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  29982. Each key may map to multiple values, matching HTTP query-string semantics.
  29983. Ignored for non-GET methods; use Parameters for write bodies.</p>
  29984. </td>
  29985. </tr>
  29986. <tr>
  29987. <td>
  29988. <code>resultType</code></br>
  29989. <em>
  29990. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  29991. VaultDynamicSecretResultType
  29992. </a>
  29993. </em>
  29994. </td>
  29995. <td>
  29996. <p>Result type defines which data is returned from the generator.
  29997. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  29998. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  29999. the &ldquo;auth&rdquo; section contains the generated token.
  30000. Please refer to the vault docs regarding the result data structure.
  30001. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  30002. </td>
  30003. </tr>
  30004. <tr>
  30005. <td>
  30006. <code>retrySettings</code></br>
  30007. <em>
  30008. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  30009. SecretStoreRetrySettings
  30010. </a>
  30011. </em>
  30012. </td>
  30013. <td>
  30014. <em>(Optional)</em>
  30015. <p>Used to configure http retries if failed</p>
  30016. </td>
  30017. </tr>
  30018. <tr>
  30019. <td>
  30020. <code>provider</code></br>
  30021. <em>
  30022. <a href="#external-secrets.io/v1.VaultProvider">
  30023. VaultProvider
  30024. </a>
  30025. </em>
  30026. </td>
  30027. <td>
  30028. <p>Vault provider common spec</p>
  30029. </td>
  30030. </tr>
  30031. <tr>
  30032. <td>
  30033. <code>path</code></br>
  30034. <em>
  30035. string
  30036. </em>
  30037. </td>
  30038. <td>
  30039. <p>Vault path to obtain the dynamic secret from</p>
  30040. </td>
  30041. </tr>
  30042. <tr>
  30043. <td>
  30044. <code>allowEmptyResponse</code></br>
  30045. <em>
  30046. bool
  30047. </em>
  30048. </td>
  30049. <td>
  30050. <em>(Optional)</em>
  30051. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  30052. </td>
  30053. </tr>
  30054. </table>
  30055. </td>
  30056. </tr>
  30057. </tbody>
  30058. </table>
  30059. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">VaultDynamicSecretResultType
  30060. (<code>string</code> alias)</p></h3>
  30061. <p>
  30062. (<em>Appears on:</em>
  30063. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  30064. </p>
  30065. <p>
  30066. <p>VaultDynamicSecretResultType defines which part of the Vault API response should be returned.</p>
  30067. </p>
  30068. <table>
  30069. <thead>
  30070. <tr>
  30071. <th>Value</th>
  30072. <th>Description</th>
  30073. </tr>
  30074. </thead>
  30075. <tbody><tr><td><p>&#34;Auth&#34;</p></td>
  30076. <td><p>VaultDynamicSecretResultTypeAuth specifies to return the &ldquo;auth&rdquo; section of the Vault API response.</p>
  30077. </td>
  30078. </tr><tr><td><p>&#34;Data&#34;</p></td>
  30079. <td><p>VaultDynamicSecretResultTypeData specifies to return the &ldquo;data&rdquo; section of the Vault API response.</p>
  30080. </td>
  30081. </tr><tr><td><p>&#34;Raw&#34;</p></td>
  30082. <td><p>VaultDynamicSecretResultTypeRaw specifies to return the raw response from the Vault API.</p>
  30083. </td>
  30084. </tr></tbody>
  30085. </table>
  30086. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec
  30087. </h3>
  30088. <p>
  30089. (<em>Appears on:</em>
  30090. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30091. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret</a>)
  30092. </p>
  30093. <p>
  30094. <p>VaultDynamicSecretSpec defines the desired spec of VaultDynamicSecret.</p>
  30095. </p>
  30096. <table>
  30097. <thead>
  30098. <tr>
  30099. <th>Field</th>
  30100. <th>Description</th>
  30101. </tr>
  30102. </thead>
  30103. <tbody>
  30104. <tr>
  30105. <td>
  30106. <code>controller</code></br>
  30107. <em>
  30108. string
  30109. </em>
  30110. </td>
  30111. <td>
  30112. <em>(Optional)</em>
  30113. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  30114. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  30115. </td>
  30116. </tr>
  30117. <tr>
  30118. <td>
  30119. <code>method</code></br>
  30120. <em>
  30121. string
  30122. </em>
  30123. </td>
  30124. <td>
  30125. <p>Vault API method to use (GET/POST/other)</p>
  30126. </td>
  30127. </tr>
  30128. <tr>
  30129. <td>
  30130. <code>parameters</code></br>
  30131. <em>
  30132. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  30133. </em>
  30134. </td>
  30135. <td>
  30136. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  30137. </td>
  30138. </tr>
  30139. <tr>
  30140. <td>
  30141. <code>getParameters</code></br>
  30142. <em>
  30143. map[string][]string
  30144. </em>
  30145. </td>
  30146. <td>
  30147. <em>(Optional)</em>
  30148. <p>GetParameters are query-string parameters passed to Vault on GET calls.
  30149. Each key may map to multiple values, matching HTTP query-string semantics.
  30150. Ignored for non-GET methods; use Parameters for write bodies.</p>
  30151. </td>
  30152. </tr>
  30153. <tr>
  30154. <td>
  30155. <code>resultType</code></br>
  30156. <em>
  30157. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  30158. VaultDynamicSecretResultType
  30159. </a>
  30160. </em>
  30161. </td>
  30162. <td>
  30163. <p>Result type defines which data is returned from the generator.
  30164. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  30165. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  30166. the &ldquo;auth&rdquo; section contains the generated token.
  30167. Please refer to the vault docs regarding the result data structure.
  30168. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  30169. </td>
  30170. </tr>
  30171. <tr>
  30172. <td>
  30173. <code>retrySettings</code></br>
  30174. <em>
  30175. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  30176. SecretStoreRetrySettings
  30177. </a>
  30178. </em>
  30179. </td>
  30180. <td>
  30181. <em>(Optional)</em>
  30182. <p>Used to configure http retries if failed</p>
  30183. </td>
  30184. </tr>
  30185. <tr>
  30186. <td>
  30187. <code>provider</code></br>
  30188. <em>
  30189. <a href="#external-secrets.io/v1.VaultProvider">
  30190. VaultProvider
  30191. </a>
  30192. </em>
  30193. </td>
  30194. <td>
  30195. <p>Vault provider common spec</p>
  30196. </td>
  30197. </tr>
  30198. <tr>
  30199. <td>
  30200. <code>path</code></br>
  30201. <em>
  30202. string
  30203. </em>
  30204. </td>
  30205. <td>
  30206. <p>Vault path to obtain the dynamic secret from</p>
  30207. </td>
  30208. </tr>
  30209. <tr>
  30210. <td>
  30211. <code>allowEmptyResponse</code></br>
  30212. <em>
  30213. bool
  30214. </em>
  30215. </td>
  30216. <td>
  30217. <em>(Optional)</em>
  30218. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  30219. </td>
  30220. </tr>
  30221. </tbody>
  30222. </table>
  30223. <h3 id="generators.external-secrets.io/v1alpha1.Webhook">Webhook
  30224. </h3>
  30225. <p>
  30226. <p>Webhook connects to a third party API server to handle the secrets generation
  30227. configuration parameters in spec.
  30228. You can specify the server, the token, and additional body parameters.
  30229. See documentation for the full API specification for requests and responses.</p>
  30230. </p>
  30231. <table>
  30232. <thead>
  30233. <tr>
  30234. <th>Field</th>
  30235. <th>Description</th>
  30236. </tr>
  30237. </thead>
  30238. <tbody>
  30239. <tr>
  30240. <td>
  30241. <code>metadata</code></br>
  30242. <em>
  30243. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  30244. Kubernetes meta/v1.ObjectMeta
  30245. </a>
  30246. </em>
  30247. </td>
  30248. <td>
  30249. Refer to the Kubernetes API documentation for the fields of the
  30250. <code>metadata</code> field.
  30251. </td>
  30252. </tr>
  30253. <tr>
  30254. <td>
  30255. <code>spec</code></br>
  30256. <em>
  30257. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  30258. WebhookSpec
  30259. </a>
  30260. </em>
  30261. </td>
  30262. <td>
  30263. <br/>
  30264. <br/>
  30265. <table>
  30266. <tr>
  30267. <td>
  30268. <code>method</code></br>
  30269. <em>
  30270. string
  30271. </em>
  30272. </td>
  30273. <td>
  30274. <p>Webhook Method</p>
  30275. </td>
  30276. </tr>
  30277. <tr>
  30278. <td>
  30279. <code>url</code></br>
  30280. <em>
  30281. string
  30282. </em>
  30283. </td>
  30284. <td>
  30285. <p>Webhook url to call</p>
  30286. </td>
  30287. </tr>
  30288. <tr>
  30289. <td>
  30290. <code>headers</code></br>
  30291. <em>
  30292. map[string]string
  30293. </em>
  30294. </td>
  30295. <td>
  30296. <em>(Optional)</em>
  30297. <p>Headers</p>
  30298. </td>
  30299. </tr>
  30300. <tr>
  30301. <td>
  30302. <code>auth</code></br>
  30303. <em>
  30304. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  30305. AuthorizationProtocol
  30306. </a>
  30307. </em>
  30308. </td>
  30309. <td>
  30310. <em>(Optional)</em>
  30311. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  30312. </td>
  30313. </tr>
  30314. <tr>
  30315. <td>
  30316. <code>body</code></br>
  30317. <em>
  30318. string
  30319. </em>
  30320. </td>
  30321. <td>
  30322. <em>(Optional)</em>
  30323. <p>Body</p>
  30324. </td>
  30325. </tr>
  30326. <tr>
  30327. <td>
  30328. <code>timeout</code></br>
  30329. <em>
  30330. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  30331. Kubernetes meta/v1.Duration
  30332. </a>
  30333. </em>
  30334. </td>
  30335. <td>
  30336. <em>(Optional)</em>
  30337. <p>Timeout</p>
  30338. </td>
  30339. </tr>
  30340. <tr>
  30341. <td>
  30342. <code>result</code></br>
  30343. <em>
  30344. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  30345. WebhookResult
  30346. </a>
  30347. </em>
  30348. </td>
  30349. <td>
  30350. <p>Result formatting</p>
  30351. </td>
  30352. </tr>
  30353. <tr>
  30354. <td>
  30355. <code>secrets</code></br>
  30356. <em>
  30357. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  30358. []WebhookSecret
  30359. </a>
  30360. </em>
  30361. </td>
  30362. <td>
  30363. <em>(Optional)</em>
  30364. <p>Secrets to fill in templates
  30365. These secrets will be passed to the templating function as key value pairs under the given name</p>
  30366. </td>
  30367. </tr>
  30368. <tr>
  30369. <td>
  30370. <code>caBundle</code></br>
  30371. <em>
  30372. []byte
  30373. </em>
  30374. </td>
  30375. <td>
  30376. <em>(Optional)</em>
  30377. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  30378. if the Server URL is using HTTPS protocol. This parameter is ignored for
  30379. plain HTTP protocol connection. If not set the system root certificates
  30380. are used to validate the TLS connection.</p>
  30381. </td>
  30382. </tr>
  30383. <tr>
  30384. <td>
  30385. <code>caProvider</code></br>
  30386. <em>
  30387. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  30388. WebhookCAProvider
  30389. </a>
  30390. </em>
  30391. </td>
  30392. <td>
  30393. <em>(Optional)</em>
  30394. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  30395. </td>
  30396. </tr>
  30397. </table>
  30398. </td>
  30399. </tr>
  30400. </tbody>
  30401. </table>
  30402. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider
  30403. </h3>
  30404. <p>
  30405. (<em>Appears on:</em>
  30406. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  30407. </p>
  30408. <p>
  30409. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  30410. </p>
  30411. <table>
  30412. <thead>
  30413. <tr>
  30414. <th>Field</th>
  30415. <th>Description</th>
  30416. </tr>
  30417. </thead>
  30418. <tbody>
  30419. <tr>
  30420. <td>
  30421. <code>type</code></br>
  30422. <em>
  30423. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProviderType">
  30424. WebhookCAProviderType
  30425. </a>
  30426. </em>
  30427. </td>
  30428. <td>
  30429. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  30430. </td>
  30431. </tr>
  30432. <tr>
  30433. <td>
  30434. <code>name</code></br>
  30435. <em>
  30436. string
  30437. </em>
  30438. </td>
  30439. <td>
  30440. <p>The name of the object located at the provider type.</p>
  30441. </td>
  30442. </tr>
  30443. <tr>
  30444. <td>
  30445. <code>key</code></br>
  30446. <em>
  30447. string
  30448. </em>
  30449. </td>
  30450. <td>
  30451. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  30452. </td>
  30453. </tr>
  30454. <tr>
  30455. <td>
  30456. <code>namespace</code></br>
  30457. <em>
  30458. string
  30459. </em>
  30460. </td>
  30461. <td>
  30462. <em>(Optional)</em>
  30463. <p>The namespace the Provider type is in.</p>
  30464. </td>
  30465. </tr>
  30466. </tbody>
  30467. </table>
  30468. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProviderType">WebhookCAProviderType
  30469. (<code>string</code> alias)</p></h3>
  30470. <p>
  30471. (<em>Appears on:</em>
  30472. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider</a>)
  30473. </p>
  30474. <p>
  30475. <p>WebhookCAProviderType defines the type of provider for webhook CA certificates.</p>
  30476. </p>
  30477. <table>
  30478. <thead>
  30479. <tr>
  30480. <th>Value</th>
  30481. <th>Description</th>
  30482. </tr>
  30483. </thead>
  30484. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  30485. <td><p>WebhookCAProviderTypeConfigMap indicates the CA provider is a ConfigMap resource.</p>
  30486. </td>
  30487. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  30488. <td><p>WebhookCAProviderTypeSecret indicates the CA provider is a Secret resource.</p>
  30489. </td>
  30490. </tr></tbody>
  30491. </table>
  30492. <h3 id="generators.external-secrets.io/v1alpha1.WebhookResult">WebhookResult
  30493. </h3>
  30494. <p>
  30495. (<em>Appears on:</em>
  30496. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  30497. </p>
  30498. <p>
  30499. <p>WebhookResult defines how to format and extract results from the webhook response.</p>
  30500. </p>
  30501. <table>
  30502. <thead>
  30503. <tr>
  30504. <th>Field</th>
  30505. <th>Description</th>
  30506. </tr>
  30507. </thead>
  30508. <tbody>
  30509. <tr>
  30510. <td>
  30511. <code>jsonPath</code></br>
  30512. <em>
  30513. string
  30514. </em>
  30515. </td>
  30516. <td>
  30517. <em>(Optional)</em>
  30518. <p>Json path of return value</p>
  30519. </td>
  30520. </tr>
  30521. </tbody>
  30522. </table>
  30523. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret
  30524. </h3>
  30525. <p>
  30526. (<em>Appears on:</em>
  30527. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  30528. </p>
  30529. <p>
  30530. <p>WebhookSecret defines a secret reference that will be used in webhook templates.</p>
  30531. </p>
  30532. <table>
  30533. <thead>
  30534. <tr>
  30535. <th>Field</th>
  30536. <th>Description</th>
  30537. </tr>
  30538. </thead>
  30539. <tbody>
  30540. <tr>
  30541. <td>
  30542. <code>name</code></br>
  30543. <em>
  30544. string
  30545. </em>
  30546. </td>
  30547. <td>
  30548. <p>Name of this secret in templates</p>
  30549. </td>
  30550. </tr>
  30551. <tr>
  30552. <td>
  30553. <code>secretRef</code></br>
  30554. <em>
  30555. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  30556. SecretKeySelector
  30557. </a>
  30558. </em>
  30559. </td>
  30560. <td>
  30561. <p>Secret ref to fill in credentials</p>
  30562. </td>
  30563. </tr>
  30564. </tbody>
  30565. </table>
  30566. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec
  30567. </h3>
  30568. <p>
  30569. (<em>Appears on:</em>
  30570. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  30571. <a href="#generators.external-secrets.io/v1alpha1.Webhook">Webhook</a>)
  30572. </p>
  30573. <p>
  30574. <p>WebhookSpec controls the behavior of the external generator. Any body parameters should be passed to the server through the parameters field.</p>
  30575. </p>
  30576. <table>
  30577. <thead>
  30578. <tr>
  30579. <th>Field</th>
  30580. <th>Description</th>
  30581. </tr>
  30582. </thead>
  30583. <tbody>
  30584. <tr>
  30585. <td>
  30586. <code>method</code></br>
  30587. <em>
  30588. string
  30589. </em>
  30590. </td>
  30591. <td>
  30592. <p>Webhook Method</p>
  30593. </td>
  30594. </tr>
  30595. <tr>
  30596. <td>
  30597. <code>url</code></br>
  30598. <em>
  30599. string
  30600. </em>
  30601. </td>
  30602. <td>
  30603. <p>Webhook url to call</p>
  30604. </td>
  30605. </tr>
  30606. <tr>
  30607. <td>
  30608. <code>headers</code></br>
  30609. <em>
  30610. map[string]string
  30611. </em>
  30612. </td>
  30613. <td>
  30614. <em>(Optional)</em>
  30615. <p>Headers</p>
  30616. </td>
  30617. </tr>
  30618. <tr>
  30619. <td>
  30620. <code>auth</code></br>
  30621. <em>
  30622. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  30623. AuthorizationProtocol
  30624. </a>
  30625. </em>
  30626. </td>
  30627. <td>
  30628. <em>(Optional)</em>
  30629. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  30630. </td>
  30631. </tr>
  30632. <tr>
  30633. <td>
  30634. <code>body</code></br>
  30635. <em>
  30636. string
  30637. </em>
  30638. </td>
  30639. <td>
  30640. <em>(Optional)</em>
  30641. <p>Body</p>
  30642. </td>
  30643. </tr>
  30644. <tr>
  30645. <td>
  30646. <code>timeout</code></br>
  30647. <em>
  30648. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  30649. Kubernetes meta/v1.Duration
  30650. </a>
  30651. </em>
  30652. </td>
  30653. <td>
  30654. <em>(Optional)</em>
  30655. <p>Timeout</p>
  30656. </td>
  30657. </tr>
  30658. <tr>
  30659. <td>
  30660. <code>result</code></br>
  30661. <em>
  30662. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  30663. WebhookResult
  30664. </a>
  30665. </em>
  30666. </td>
  30667. <td>
  30668. <p>Result formatting</p>
  30669. </td>
  30670. </tr>
  30671. <tr>
  30672. <td>
  30673. <code>secrets</code></br>
  30674. <em>
  30675. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  30676. []WebhookSecret
  30677. </a>
  30678. </em>
  30679. </td>
  30680. <td>
  30681. <em>(Optional)</em>
  30682. <p>Secrets to fill in templates
  30683. These secrets will be passed to the templating function as key value pairs under the given name</p>
  30684. </td>
  30685. </tr>
  30686. <tr>
  30687. <td>
  30688. <code>caBundle</code></br>
  30689. <em>
  30690. []byte
  30691. </em>
  30692. </td>
  30693. <td>
  30694. <em>(Optional)</em>
  30695. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  30696. if the Server URL is using HTTPS protocol. This parameter is ignored for
  30697. plain HTTP protocol connection. If not set the system root certificates
  30698. are used to validate the TLS connection.</p>
  30699. </td>
  30700. </tr>
  30701. <tr>
  30702. <td>
  30703. <code>caProvider</code></br>
  30704. <em>
  30705. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  30706. WebhookCAProvider
  30707. </a>
  30708. </em>
  30709. </td>
  30710. <td>
  30711. <em>(Optional)</em>
  30712. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  30713. </td>
  30714. </tr>
  30715. </tbody>
  30716. </table>
  30717. <hr/>
  30718. <p><em>
  30719. Generated with <code>gen-crd-api-reference-docs</code>.
  30720. </em></p>
  30721. </article>
  30722. </div>
  30723. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  30724. </div>
  30725. </main>
  30726. <img referrerpolicy="no-referrer-when-downgrade"
  30727. src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""
  30728. hidden />
  30729. <footer class="md-footer">
  30730. <div class="md-footer-meta md-typeset">
  30731. <div class="md-footer-meta__inner md-grid">
  30732. <div class="md-copyright">
  30733. <div class="md-copyright__highlight">
  30734. &copy; 2025 The external-secrets Authors.<br/>
  30735. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  30736. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  30737. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  30738. </div>
  30739. Made with
  30740. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  30741. Material for MkDocs
  30742. </a>
  30743. </div>
  30744. </div>
  30745. </div>
  30746. </footer>
  30747. </div>
  30748. <div class="md-dialog" data-md-component="dialog">
  30749. <div class="md-dialog__inner md-typeset"></div>
  30750. </div>
  30751. <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>
  30752. <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
  30753. </body>
  30754. </html>