index.html 621 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208102091021010211102121021310214102151021610217102181021910220102211022210223102241022510226102271022810229102301023110232102331023410235102361023710238102391024010241102421024310244102451024610247102481024910250102511025210253102541025510256102571025810259102601026110262102631026410265102661026710268102691027010271102721027310274102751027610277102781027910280102811028210283102841028510286102871028810289102901029110292102931029410295102961029710298102991030010301103021030310304103051030610307103081030910310103111031210313103141031510316103171031810319103201032110322103231032410325103261032710328103291033010331103321033310334103351033610337103381033910340103411034210343103441034510346103471034810349103501035110352103531035410355103561035710358103591036010361103621036310364103651036610367103681036910370103711037210373103741037510376103771037810379103801038110382103831038410385103861038710388103891039010391103921039310394103951039610397103981039910400104011040210403104041040510406104071040810409104101041110412104131041410415104161041710418104191042010421104221042310424104251042610427104281042910430104311043210433104341043510436104371043810439104401044110442104431044410445104461044710448104491045010451104521045310454104551045610457104581045910460104611046210463104641046510466104671046810469104701047110472104731047410475104761047710478104791048010481104821048310484104851048610487104881048910490104911049210493104941049510496104971049810499105001050110502105031050410505105061050710508105091051010511105121051310514105151051610517105181051910520105211052210523105241052510526105271052810529105301053110532105331053410535105361053710538105391054010541105421054310544105451054610547105481054910550105511055210553105541055510556105571055810559105601056110562105631056410565105661056710568105691057010571105721057310574105751057610577105781057910580105811058210583105841058510586105871058810589105901059110592105931059410595105961059710598105991060010601106021060310604106051060610607106081060910610106111061210613106141061510616106171061810619106201062110622106231062410625106261062710628106291063010631106321063310634106351063610637106381063910640106411064210643106441064510646106471064810649106501065110652106531065410655106561065710658106591066010661106621066310664106651066610667106681066910670106711067210673106741067510676106771067810679106801068110682106831068410685106861068710688106891069010691106921069310694106951069610697106981069910700107011070210703107041070510706107071070810709107101071110712107131071410715107161071710718107191072010721107221072310724107251072610727107281072910730107311073210733107341073510736107371073810739107401074110742107431074410745107461074710748107491075010751107521075310754107551075610757107581075910760107611076210763107641076510766107671076810769107701077110772107731077410775107761077710778107791078010781107821078310784107851078610787107881078910790107911079210793107941079510796107971079810799108001080110802108031080410805108061080710808108091081010811108121081310814108151081610817108181081910820108211082210823108241082510826108271082810829108301083110832108331083410835108361083710838108391084010841108421084310844108451084610847108481084910850108511085210853108541085510856108571085810859108601086110862108631086410865108661086710868108691087010871108721087310874108751087610877108781087910880108811088210883108841088510886108871088810889108901089110892108931089410895108961089710898108991090010901109021090310904109051090610907109081090910910109111091210913109141091510916109171091810919109201092110922109231092410925109261092710928109291093010931109321093310934109351093610937109381093910940109411094210943109441094510946109471094810949109501095110952109531095410955109561095710958109591096010961109621096310964109651096610967109681096910970109711097210973109741097510976109771097810979109801098110982109831098410985109861098710988109891099010991109921099310994109951099610997109981099911000110011100211003110041100511006110071100811009110101101111012110131101411015110161101711018110191102011021110221102311024110251102611027110281102911030110311103211033110341103511036110371103811039110401104111042110431104411045110461104711048110491105011051110521105311054110551105611057110581105911060110611106211063110641106511066110671106811069110701107111072110731107411075110761107711078110791108011081110821108311084110851108611087110881108911090110911109211093110941109511096110971109811099111001110111102111031110411105111061110711108111091111011111111121111311114111151111611117111181111911120111211112211123111241112511126111271112811129111301113111132111331113411135111361113711138111391114011141111421114311144111451114611147111481114911150111511115211153111541115511156111571115811159111601116111162111631116411165111661116711168111691117011171111721117311174111751117611177111781117911180111811118211183111841118511186111871118811189111901119111192111931119411195111961119711198111991120011201112021120311204112051120611207112081120911210112111121211213112141121511216112171121811219112201122111222112231122411225112261122711228112291123011231112321123311234112351123611237112381123911240112411124211243112441124511246112471124811249112501125111252112531125411255112561125711258112591126011261112621126311264112651126611267112681126911270112711127211273112741127511276112771127811279112801128111282112831128411285112861128711288112891129011291112921129311294112951129611297112981129911300113011130211303113041130511306113071130811309113101131111312113131131411315113161131711318113191132011321113221132311324113251132611327113281132911330113311133211333113341133511336113371133811339113401134111342113431134411345113461134711348113491135011351113521135311354113551135611357113581135911360113611136211363113641136511366113671136811369113701137111372113731137411375113761137711378113791138011381113821138311384113851138611387113881138911390113911139211393113941139511396113971139811399114001140111402114031140411405114061140711408114091141011411114121141311414114151141611417114181141911420114211142211423114241142511426114271142811429114301143111432114331143411435114361143711438114391144011441114421144311444114451144611447114481144911450114511145211453114541145511456114571145811459114601146111462114631146411465114661146711468114691147011471114721147311474114751147611477114781147911480114811148211483114841148511486114871148811489114901149111492114931149411495114961149711498114991150011501115021150311504115051150611507115081150911510115111151211513115141151511516115171151811519115201152111522115231152411525115261152711528115291153011531115321153311534115351153611537115381153911540115411154211543115441154511546115471154811549115501155111552115531155411555115561155711558115591156011561115621156311564115651156611567115681156911570115711157211573115741157511576115771157811579115801158111582115831158411585115861158711588115891159011591115921159311594115951159611597115981159911600116011160211603116041160511606116071160811609116101161111612116131161411615116161161711618116191162011621116221162311624116251162611627116281162911630116311163211633116341163511636116371163811639116401164111642116431164411645116461164711648116491165011651116521165311654116551165611657116581165911660116611166211663116641166511666116671166811669116701167111672116731167411675116761167711678116791168011681116821168311684116851168611687116881168911690116911169211693116941169511696116971169811699117001170111702117031170411705117061170711708117091171011711117121171311714117151171611717117181171911720117211172211723117241172511726117271172811729117301173111732117331173411735117361173711738117391174011741117421174311744117451174611747117481174911750117511175211753117541175511756117571175811759117601176111762117631176411765117661176711768117691177011771117721177311774117751177611777117781177911780117811178211783117841178511786117871178811789117901179111792117931179411795117961179711798117991180011801118021180311804118051180611807118081180911810118111181211813118141181511816118171181811819118201182111822118231182411825118261182711828118291183011831118321183311834118351183611837118381183911840118411184211843118441184511846118471184811849118501185111852118531185411855118561185711858118591186011861118621186311864118651186611867118681186911870118711187211873118741187511876118771187811879118801188111882118831188411885118861188711888118891189011891118921189311894118951189611897118981189911900119011190211903119041190511906119071190811909119101191111912119131191411915119161191711918119191192011921119221192311924119251192611927119281192911930119311193211933119341193511936119371193811939119401194111942119431194411945119461194711948119491195011951119521195311954119551195611957119581195911960119611196211963119641196511966119671196811969119701197111972119731197411975119761197711978119791198011981119821198311984119851198611987119881198911990119911199211993119941199511996119971199811999120001200112002120031200412005120061200712008120091201012011120121201312014120151201612017120181201912020120211202212023120241202512026120271202812029120301203112032120331203412035120361203712038120391204012041120421204312044120451204612047120481204912050120511205212053120541205512056120571205812059120601206112062120631206412065120661206712068120691207012071120721207312074120751207612077120781207912080120811208212083120841208512086120871208812089120901209112092120931209412095120961209712098120991210012101121021210312104121051210612107121081210912110121111211212113121141211512116121171211812119121201212112122121231212412125121261212712128121291213012131121321213312134121351213612137121381213912140121411214212143121441214512146121471214812149121501215112152121531215412155121561215712158121591216012161121621216312164121651216612167121681216912170121711217212173121741217512176121771217812179121801218112182121831218412185121861218712188121891219012191121921219312194121951219612197121981219912200122011220212203122041220512206122071220812209122101221112212122131221412215122161221712218122191222012221122221222312224122251222612227122281222912230122311223212233122341223512236122371223812239122401224112242122431224412245122461224712248122491225012251122521225312254122551225612257122581225912260122611226212263122641226512266122671226812269122701227112272122731227412275122761227712278122791228012281122821228312284122851228612287122881228912290122911229212293122941229512296122971229812299123001230112302123031230412305123061230712308123091231012311123121231312314123151231612317123181231912320123211232212323123241232512326123271232812329123301233112332123331233412335123361233712338123391234012341123421234312344123451234612347123481234912350123511235212353123541235512356123571235812359123601236112362123631236412365123661236712368123691237012371123721237312374123751237612377123781237912380123811238212383123841238512386123871238812389123901239112392123931239412395123961239712398123991240012401124021240312404124051240612407124081240912410124111241212413124141241512416124171241812419124201242112422124231242412425124261242712428124291243012431124321243312434124351243612437124381243912440124411244212443124441244512446124471244812449124501245112452124531245412455124561245712458124591246012461124621246312464124651246612467124681246912470124711247212473124741247512476124771247812479124801248112482124831248412485124861248712488124891249012491124921249312494124951249612497124981249912500125011250212503125041250512506125071250812509125101251112512125131251412515125161251712518125191252012521125221252312524125251252612527125281252912530125311253212533125341253512536125371253812539125401254112542125431254412545125461254712548125491255012551125521255312554125551255612557125581255912560125611256212563125641256512566125671256812569125701257112572125731257412575125761257712578125791258012581125821258312584125851258612587125881258912590125911259212593125941259512596125971259812599126001260112602126031260412605126061260712608126091261012611126121261312614126151261612617126181261912620126211262212623126241262512626126271262812629126301263112632126331263412635126361263712638126391264012641126421264312644126451264612647126481264912650126511265212653126541265512656126571265812659126601266112662126631266412665126661266712668126691267012671126721267312674126751267612677126781267912680126811268212683126841268512686126871268812689126901269112692126931269412695126961269712698126991270012701127021270312704127051270612707127081270912710127111271212713127141271512716127171271812719127201272112722127231272412725127261272712728127291273012731127321273312734127351273612737127381273912740127411274212743127441274512746127471274812749127501275112752127531275412755127561275712758127591276012761127621276312764127651276612767127681276912770127711277212773127741277512776127771277812779127801278112782127831278412785127861278712788127891279012791127921279312794127951279612797127981279912800128011280212803128041280512806128071280812809128101281112812128131281412815128161281712818128191282012821128221282312824128251282612827128281282912830128311283212833128341283512836128371283812839128401284112842128431284412845128461284712848128491285012851128521285312854128551285612857128581285912860128611286212863128641286512866128671286812869128701287112872128731287412875128761287712878128791288012881128821288312884128851288612887128881288912890128911289212893128941289512896128971289812899129001290112902129031290412905129061290712908129091291012911129121291312914129151291612917129181291912920129211292212923129241292512926129271292812929129301293112932129331293412935129361293712938129391294012941129421294312944129451294612947129481294912950129511295212953129541295512956129571295812959129601296112962129631296412965129661296712968129691297012971129721297312974129751297612977129781297912980129811298212983129841298512986129871298812989129901299112992129931299412995129961299712998129991300013001130021300313004130051300613007130081300913010130111301213013130141301513016130171301813019130201302113022130231302413025130261302713028130291303013031130321303313034130351303613037130381303913040130411304213043130441304513046130471304813049130501305113052130531305413055130561305713058130591306013061130621306313064130651306613067130681306913070130711307213073130741307513076130771307813079130801308113082130831308413085130861308713088130891309013091130921309313094130951309613097130981309913100131011310213103131041310513106131071310813109131101311113112131131311413115131161311713118131191312013121131221312313124131251312613127131281312913130131311313213133131341313513136131371313813139131401314113142131431314413145131461314713148131491315013151131521315313154131551315613157131581315913160131611316213163131641316513166131671316813169131701317113172131731317413175131761317713178131791318013181131821318313184131851318613187131881318913190131911319213193131941319513196131971319813199132001320113202132031320413205132061320713208132091321013211132121321313214132151321613217132181321913220132211322213223132241322513226132271322813229132301323113232132331323413235132361323713238132391324013241132421324313244132451324613247132481324913250132511325213253132541325513256132571325813259132601326113262132631326413265132661326713268132691327013271132721327313274132751327613277132781327913280132811328213283132841328513286132871328813289132901329113292132931329413295132961329713298132991330013301133021330313304133051330613307133081330913310133111331213313133141331513316133171331813319133201332113322133231332413325133261332713328133291333013331133321333313334133351333613337133381333913340133411334213343133441334513346133471334813349133501335113352133531335413355133561335713358133591336013361133621336313364133651336613367133681336913370133711337213373133741337513376133771337813379133801338113382133831338413385133861338713388133891339013391133921339313394133951339613397133981339913400134011340213403134041340513406134071340813409134101341113412134131341413415134161341713418134191342013421134221342313424134251342613427134281342913430134311343213433134341343513436134371343813439134401344113442134431344413445134461344713448134491345013451134521345313454134551345613457134581345913460134611346213463134641346513466134671346813469134701347113472134731347413475134761347713478134791348013481134821348313484134851348613487134881348913490134911349213493134941349513496134971349813499135001350113502135031350413505135061350713508135091351013511135121351313514135151351613517135181351913520135211352213523135241352513526135271352813529135301353113532135331353413535135361353713538135391354013541135421354313544135451354613547135481354913550135511355213553135541355513556135571355813559135601356113562135631356413565135661356713568135691357013571135721357313574135751357613577135781357913580135811358213583135841358513586135871358813589135901359113592135931359413595135961359713598135991360013601136021360313604136051360613607136081360913610136111361213613136141361513616136171361813619136201362113622136231362413625136261362713628136291363013631136321363313634136351363613637136381363913640136411364213643136441364513646136471364813649136501365113652136531365413655136561365713658136591366013661136621366313664136651366613667136681366913670136711367213673136741367513676136771367813679136801368113682136831368413685136861368713688136891369013691136921369313694136951369613697136981369913700137011370213703137041370513706137071370813709137101371113712137131371413715137161371713718137191372013721137221372313724137251372613727137281372913730137311373213733137341373513736137371373813739137401374113742137431374413745137461374713748137491375013751137521375313754137551375613757137581375913760137611376213763137641376513766137671376813769137701377113772137731377413775137761377713778137791378013781137821378313784137851378613787137881378913790137911379213793137941379513796137971379813799138001380113802138031380413805138061380713808138091381013811138121381313814138151381613817138181381913820138211382213823138241382513826138271382813829138301383113832138331383413835138361383713838138391384013841138421384313844138451384613847138481384913850138511385213853138541385513856138571385813859138601386113862138631386413865138661386713868138691387013871138721387313874138751387613877138781387913880138811388213883138841388513886138871388813889138901389113892138931389413895138961389713898138991390013901139021390313904139051390613907139081390913910139111391213913139141391513916139171391813919139201392113922139231392413925139261392713928139291393013931139321393313934139351393613937139381393913940139411394213943139441394513946139471394813949139501395113952139531395413955139561395713958139591396013961139621396313964139651396613967139681396913970139711397213973139741397513976139771397813979139801398113982139831398413985139861398713988139891399013991139921399313994139951399613997139981399914000140011400214003140041400514006140071400814009140101401114012140131401414015140161401714018140191402014021140221402314024140251402614027140281402914030140311403214033140341403514036140371403814039140401404114042140431404414045140461404714048140491405014051140521405314054140551405614057140581405914060140611406214063140641406514066140671406814069140701407114072140731407414075140761407714078140791408014081140821408314084140851408614087140881408914090140911409214093140941409514096140971409814099141001410114102141031410414105141061410714108141091411014111141121411314114141151411614117141181411914120141211412214123141241412514126141271412814129141301413114132141331413414135141361413714138141391414014141141421414314144141451414614147141481414914150141511415214153141541415514156141571415814159141601416114162141631416414165141661416714168141691417014171141721417314174141751417614177141781417914180141811418214183141841418514186141871418814189141901419114192141931419414195141961419714198141991420014201142021420314204142051420614207142081420914210142111421214213142141421514216142171421814219142201422114222142231422414225142261422714228142291423014231142321423314234142351423614237142381423914240142411424214243142441424514246142471424814249142501425114252142531425414255142561425714258142591426014261142621426314264142651426614267142681426914270142711427214273142741427514276142771427814279142801428114282142831428414285142861428714288142891429014291142921429314294142951429614297142981429914300143011430214303143041430514306143071430814309143101431114312143131431414315143161431714318143191432014321143221432314324143251432614327143281432914330143311433214333143341433514336143371433814339143401434114342143431434414345143461434714348143491435014351143521435314354143551435614357143581435914360143611436214363143641436514366143671436814369143701437114372143731437414375143761437714378143791438014381143821438314384143851438614387143881438914390143911439214393143941439514396143971439814399144001440114402144031440414405144061440714408144091441014411144121441314414144151441614417144181441914420144211442214423144241442514426144271442814429144301443114432144331443414435144361443714438144391444014441144421444314444144451444614447144481444914450144511445214453144541445514456144571445814459144601446114462144631446414465144661446714468144691447014471144721447314474144751447614477144781447914480144811448214483144841448514486144871448814489144901449114492144931449414495144961449714498144991450014501145021450314504145051450614507145081450914510145111451214513145141451514516145171451814519145201452114522145231452414525145261452714528145291453014531145321453314534145351453614537145381453914540145411454214543145441454514546145471454814549145501455114552145531455414555145561455714558145591456014561145621456314564145651456614567145681456914570145711457214573145741457514576145771457814579145801458114582145831458414585145861458714588145891459014591145921459314594145951459614597145981459914600146011460214603146041460514606146071460814609146101461114612146131461414615146161461714618146191462014621146221462314624146251462614627146281462914630146311463214633146341463514636146371463814639146401464114642146431464414645146461464714648146491465014651146521465314654146551465614657146581465914660146611466214663146641466514666146671466814669146701467114672146731467414675146761467714678146791468014681146821468314684146851468614687146881468914690146911469214693146941469514696146971469814699147001470114702147031470414705147061470714708147091471014711147121471314714147151471614717147181471914720147211472214723147241472514726147271472814729147301473114732147331473414735147361473714738147391474014741147421474314744147451474614747147481474914750147511475214753147541475514756147571475814759147601476114762147631476414765147661476714768147691477014771147721477314774147751477614777147781477914780147811478214783147841478514786147871478814789147901479114792147931479414795147961479714798147991480014801148021480314804148051480614807148081480914810148111481214813148141481514816148171481814819148201482114822148231482414825148261482714828148291483014831148321483314834148351483614837148381483914840148411484214843148441484514846148471484814849148501485114852148531485414855148561485714858148591486014861148621486314864148651486614867148681486914870148711487214873148741487514876148771487814879148801488114882148831488414885148861488714888148891489014891148921489314894148951489614897148981489914900149011490214903149041490514906149071490814909149101491114912149131491414915149161491714918149191492014921149221492314924149251492614927149281492914930149311493214933149341493514936149371493814939149401494114942149431494414945149461494714948149491495014951149521495314954149551495614957149581495914960149611496214963149641496514966149671496814969149701497114972149731497414975149761497714978149791498014981149821498314984149851498614987149881498914990149911499214993149941499514996149971499814999150001500115002150031500415005150061500715008150091501015011150121501315014150151501615017150181501915020150211502215023150241502515026150271502815029150301503115032150331503415035150361503715038150391504015041150421504315044150451504615047150481504915050150511505215053150541505515056150571505815059150601506115062150631506415065150661506715068150691507015071150721507315074150751507615077150781507915080150811508215083150841508515086150871508815089150901509115092150931509415095150961509715098150991510015101151021510315104151051510615107151081510915110151111511215113151141511515116151171511815119151201512115122151231512415125151261512715128151291513015131151321513315134151351513615137151381513915140151411514215143151441514515146151471514815149151501515115152151531515415155151561515715158151591516015161151621516315164151651516615167151681516915170151711517215173151741517515176151771517815179151801518115182151831518415185151861518715188151891519015191151921519315194151951519615197151981519915200152011520215203152041520515206152071520815209152101521115212152131521415215152161521715218152191522015221152221522315224152251522615227152281522915230152311523215233152341523515236152371523815239152401524115242152431524415245152461524715248152491525015251152521525315254152551525615257152581525915260152611526215263152641526515266152671526815269152701527115272152731527415275152761527715278152791528015281152821528315284152851528615287152881528915290152911529215293152941529515296152971529815299153001530115302153031530415305153061530715308153091531015311153121531315314153151531615317153181531915320153211532215323153241532515326153271532815329153301533115332153331533415335153361533715338153391534015341153421534315344153451534615347153481534915350153511535215353153541535515356153571535815359153601536115362153631536415365153661536715368153691537015371153721537315374153751537615377153781537915380153811538215383153841538515386153871538815389153901539115392153931539415395153961539715398153991540015401154021540315404154051540615407154081540915410154111541215413154141541515416154171541815419154201542115422154231542415425154261542715428154291543015431154321543315434154351543615437154381543915440154411544215443154441544515446154471544815449154501545115452154531545415455154561545715458154591546015461154621546315464154651546615467154681546915470154711547215473154741547515476154771547815479154801548115482154831548415485154861548715488154891549015491154921549315494154951549615497154981549915500155011550215503155041550515506155071550815509155101551115512155131551415515155161551715518155191552015521155221552315524155251552615527155281552915530155311553215533155341553515536155371553815539155401554115542155431554415545155461554715548155491555015551155521555315554155551555615557155581555915560155611556215563155641556515566155671556815569155701557115572155731557415575155761557715578155791558015581155821558315584155851558615587155881558915590155911559215593155941559515596155971559815599156001560115602156031560415605156061560715608156091561015611156121561315614156151561615617156181561915620156211562215623156241562515626156271562815629156301563115632156331563415635156361563715638156391564015641156421564315644156451564615647156481564915650156511565215653156541565515656156571565815659156601566115662156631566415665156661566715668156691567015671156721567315674156751567615677156781567915680156811568215683156841568515686156871568815689156901569115692156931569415695156961569715698156991570015701157021570315704157051570615707157081570915710157111571215713157141571515716157171571815719157201572115722157231572415725157261572715728157291573015731157321573315734157351573615737157381573915740157411574215743157441574515746157471574815749157501575115752157531575415755157561575715758157591576015761157621576315764157651576615767157681576915770157711577215773157741577515776157771577815779157801578115782157831578415785157861578715788157891579015791157921579315794157951579615797157981579915800158011580215803158041580515806158071580815809158101581115812158131581415815158161581715818158191582015821158221582315824158251582615827158281582915830158311583215833158341583515836158371583815839158401584115842158431584415845158461584715848158491585015851158521585315854158551585615857158581585915860158611586215863158641586515866158671586815869158701587115872158731587415875158761587715878158791588015881158821588315884158851588615887158881588915890158911589215893158941589515896158971589815899159001590115902159031590415905159061590715908159091591015911159121591315914159151591615917159181591915920159211592215923159241592515926159271592815929159301593115932159331593415935159361593715938159391594015941159421594315944159451594615947159481594915950159511595215953159541595515956159571595815959159601596115962159631596415965159661596715968159691597015971159721597315974159751597615977159781597915980159811598215983159841598515986159871598815989159901599115992159931599415995159961599715998159991600016001160021600316004160051600616007160081600916010160111601216013160141601516016160171601816019160201602116022160231602416025160261602716028160291603016031160321603316034160351603616037160381603916040160411604216043160441604516046160471604816049160501605116052160531605416055160561605716058160591606016061160621606316064160651606616067160681606916070160711607216073160741607516076160771607816079160801608116082160831608416085160861608716088160891609016091160921609316094160951609616097160981609916100161011610216103161041610516106161071610816109161101611116112161131611416115161161611716118161191612016121161221612316124161251612616127161281612916130161311613216133161341613516136161371613816139161401614116142161431614416145161461614716148161491615016151161521615316154161551615616157161581615916160161611616216163161641616516166161671616816169161701617116172161731617416175161761617716178161791618016181161821618316184161851618616187161881618916190161911619216193161941619516196161971619816199162001620116202162031620416205162061620716208162091621016211162121621316214162151621616217162181621916220162211622216223162241622516226162271622816229162301623116232162331623416235162361623716238162391624016241162421624316244162451624616247162481624916250162511625216253162541625516256162571625816259162601626116262162631626416265162661626716268162691627016271162721627316274162751627616277162781627916280162811628216283162841628516286162871628816289162901629116292162931629416295162961629716298162991630016301163021630316304163051630616307163081630916310163111631216313163141631516316163171631816319163201632116322163231632416325163261632716328163291633016331163321633316334163351633616337163381633916340163411634216343163441634516346163471634816349163501635116352163531635416355163561635716358163591636016361163621636316364163651636616367163681636916370163711637216373163741637516376163771637816379163801638116382163831638416385163861638716388163891639016391163921639316394163951639616397163981639916400164011640216403164041640516406164071640816409164101641116412164131641416415164161641716418164191642016421164221642316424164251642616427164281642916430164311643216433164341643516436164371643816439164401644116442164431644416445164461644716448164491645016451164521645316454164551645616457164581645916460164611646216463164641646516466164671646816469164701647116472164731647416475164761647716478164791648016481164821648316484164851648616487164881648916490164911649216493164941649516496164971649816499165001650116502165031650416505165061650716508165091651016511165121651316514165151651616517165181651916520165211652216523165241652516526165271652816529165301653116532165331653416535165361653716538165391654016541165421654316544165451654616547165481654916550165511655216553165541655516556165571655816559165601656116562165631656416565165661656716568165691657016571165721657316574165751657616577165781657916580165811658216583165841658516586165871658816589165901659116592165931659416595165961659716598165991660016601166021660316604166051660616607166081660916610166111661216613166141661516616166171661816619166201662116622166231662416625166261662716628166291663016631166321663316634166351663616637166381663916640166411664216643166441664516646166471664816649166501665116652166531665416655166561665716658166591666016661166621666316664166651666616667166681666916670166711667216673166741667516676166771667816679166801668116682166831668416685166861668716688166891669016691166921669316694166951669616697166981669916700167011670216703167041670516706167071670816709167101671116712167131671416715167161671716718167191672016721167221672316724167251672616727167281672916730167311673216733167341673516736167371673816739167401674116742167431674416745167461674716748167491675016751167521675316754167551675616757167581675916760167611676216763167641676516766167671676816769167701677116772167731677416775167761677716778167791678016781167821678316784167851678616787167881678916790167911679216793167941679516796167971679816799168001680116802168031680416805168061680716808168091681016811168121681316814168151681616817168181681916820168211682216823168241682516826168271682816829168301683116832168331683416835168361683716838168391684016841168421684316844168451684616847168481684916850168511685216853168541685516856168571685816859168601686116862168631686416865168661686716868168691687016871168721687316874168751687616877168781687916880168811688216883168841688516886168871688816889168901689116892168931689416895168961689716898168991690016901169021690316904169051690616907169081690916910169111691216913169141691516916169171691816919169201692116922169231692416925169261692716928169291693016931169321693316934169351693616937169381693916940169411694216943169441694516946169471694816949169501695116952169531695416955169561695716958169591696016961169621696316964169651696616967169681696916970169711697216973169741697516976169771697816979169801698116982169831698416985169861698716988169891699016991169921699316994169951699616997169981699917000170011700217003170041700517006170071700817009170101701117012170131701417015170161701717018170191702017021170221702317024170251702617027170281702917030170311703217033170341703517036170371703817039170401704117042170431704417045170461704717048170491705017051170521705317054170551705617057170581705917060170611706217063170641706517066170671706817069170701707117072170731707417075170761707717078170791708017081170821708317084170851708617087170881708917090170911709217093170941709517096170971709817099171001710117102171031710417105171061710717108171091711017111171121711317114171151711617117171181711917120171211712217123171241712517126171271712817129171301713117132171331713417135171361713717138171391714017141171421714317144171451714617147171481714917150171511715217153171541715517156171571715817159171601716117162171631716417165171661716717168171691717017171171721717317174171751717617177171781717917180171811718217183171841718517186171871718817189171901719117192171931719417195171961719717198171991720017201172021720317204172051720617207172081720917210172111721217213172141721517216172171721817219172201722117222172231722417225172261722717228172291723017231172321723317234172351723617237172381723917240172411724217243172441724517246172471724817249172501725117252172531725417255172561725717258172591726017261172621726317264172651726617267172681726917270172711727217273172741727517276172771727817279172801728117282172831728417285172861728717288172891729017291172921729317294172951729617297172981729917300173011730217303173041730517306173071730817309173101731117312173131731417315173161731717318173191732017321173221732317324173251732617327173281732917330173311733217333173341733517336173371733817339173401734117342173431734417345173461734717348173491735017351173521735317354173551735617357173581735917360173611736217363173641736517366173671736817369173701737117372173731737417375173761737717378173791738017381173821738317384173851738617387173881738917390173911739217393173941739517396173971739817399174001740117402174031740417405174061740717408174091741017411174121741317414174151741617417174181741917420174211742217423174241742517426174271742817429174301743117432174331743417435174361743717438174391744017441174421744317444174451744617447174481744917450174511745217453174541745517456174571745817459174601746117462174631746417465174661746717468174691747017471174721747317474174751747617477174781747917480174811748217483174841748517486174871748817489174901749117492174931749417495174961749717498174991750017501175021750317504175051750617507175081750917510175111751217513175141751517516175171751817519175201752117522175231752417525175261752717528175291753017531175321753317534175351753617537175381753917540175411754217543175441754517546175471754817549175501755117552175531755417555175561755717558175591756017561175621756317564175651756617567175681756917570175711757217573175741757517576175771757817579175801758117582175831758417585175861758717588175891759017591175921759317594175951759617597175981759917600176011760217603176041760517606176071760817609176101761117612176131761417615176161761717618176191762017621176221762317624176251762617627176281762917630176311763217633176341763517636176371763817639176401764117642176431764417645176461764717648176491765017651176521765317654176551765617657176581765917660176611766217663176641766517666176671766817669176701767117672176731767417675176761767717678176791768017681176821768317684176851768617687176881768917690176911769217693176941769517696176971769817699177001770117702177031770417705177061770717708177091771017711177121771317714177151771617717177181771917720177211772217723177241772517726177271772817729177301773117732177331773417735177361773717738177391774017741177421774317744177451774617747177481774917750177511775217753177541775517756177571775817759177601776117762177631776417765177661776717768177691777017771177721777317774177751777617777177781777917780177811778217783177841778517786177871778817789177901779117792177931779417795177961779717798177991780017801178021780317804178051780617807178081780917810178111781217813178141781517816178171781817819178201782117822178231782417825178261782717828178291783017831178321783317834178351783617837178381783917840178411784217843178441784517846178471784817849178501785117852178531785417855178561785717858178591786017861178621786317864178651786617867178681786917870178711787217873178741787517876178771787817879178801788117882178831788417885178861788717888178891789017891178921789317894178951789617897178981789917900179011790217903179041790517906179071790817909179101791117912179131791417915179161791717918179191792017921179221792317924179251792617927179281792917930179311793217933179341793517936179371793817939179401794117942179431794417945179461794717948179491795017951179521795317954179551795617957179581795917960179611796217963179641796517966179671796817969179701797117972179731797417975179761797717978179791798017981179821798317984179851798617987179881798917990179911799217993179941799517996179971799817999180001800118002180031800418005180061800718008180091801018011180121801318014180151801618017180181801918020180211802218023180241802518026180271802818029180301803118032180331803418035180361803718038180391804018041180421804318044180451804618047180481804918050180511805218053180541805518056180571805818059180601806118062180631806418065180661806718068180691807018071180721807318074180751807618077180781807918080180811808218083180841808518086180871808818089180901809118092180931809418095180961809718098180991810018101181021810318104181051810618107181081810918110181111811218113181141811518116181171811818119181201812118122181231812418125181261812718128181291813018131181321813318134181351813618137181381813918140181411814218143181441814518146181471814818149181501815118152181531815418155181561815718158181591816018161181621816318164181651816618167181681816918170181711817218173181741817518176181771817818179181801818118182181831818418185181861818718188181891819018191181921819318194181951819618197181981819918200182011820218203182041820518206182071820818209182101821118212182131821418215182161821718218182191822018221182221822318224182251822618227182281822918230182311823218233182341823518236182371823818239182401824118242182431824418245182461824718248182491825018251182521825318254182551825618257182581825918260182611826218263182641826518266182671826818269182701827118272182731827418275182761827718278182791828018281182821828318284182851828618287182881828918290182911829218293182941829518296182971829818299183001830118302183031830418305183061830718308183091831018311183121831318314183151831618317183181831918320183211832218323183241832518326183271832818329183301833118332183331833418335183361833718338183391834018341183421834318344183451834618347183481834918350183511835218353183541835518356183571835818359183601836118362183631836418365183661836718368183691837018371183721837318374183751837618377183781837918380183811838218383183841838518386183871838818389183901839118392183931839418395183961839718398183991840018401184021840318404184051840618407184081840918410184111841218413184141841518416184171841818419184201842118422184231842418425184261842718428184291843018431184321843318434184351843618437184381843918440184411844218443184441844518446184471844818449184501845118452184531845418455184561845718458184591846018461184621846318464184651846618467184681846918470184711847218473184741847518476184771847818479184801848118482184831848418485184861848718488184891849018491184921849318494184951849618497184981849918500185011850218503185041850518506185071850818509185101851118512185131851418515185161851718518185191852018521185221852318524185251852618527185281852918530185311853218533185341853518536185371853818539185401854118542185431854418545185461854718548185491855018551185521855318554185551855618557185581855918560185611856218563185641856518566185671856818569185701857118572185731857418575185761857718578185791858018581185821858318584185851858618587185881858918590185911859218593185941859518596185971859818599186001860118602186031860418605186061860718608186091861018611186121861318614186151861618617186181861918620186211862218623186241862518626186271862818629186301863118632186331863418635186361863718638186391864018641186421864318644186451864618647186481864918650186511865218653186541865518656186571865818659186601866118662186631866418665186661866718668186691867018671186721867318674186751867618677186781867918680186811868218683186841868518686186871868818689186901869118692186931869418695186961869718698186991870018701187021870318704187051870618707187081870918710187111871218713187141871518716187171871818719187201872118722187231872418725187261872718728187291873018731187321873318734187351873618737187381873918740187411874218743187441874518746187471874818749187501875118752187531875418755187561875718758187591876018761187621876318764187651876618767187681876918770187711877218773187741877518776187771877818779187801878118782187831878418785187861878718788187891879018791187921879318794187951879618797187981879918800188011880218803188041880518806188071880818809188101881118812188131881418815188161881718818188191882018821188221882318824188251882618827188281882918830188311883218833188341883518836188371883818839188401884118842188431884418845188461884718848188491885018851188521885318854188551885618857188581885918860188611886218863188641886518866188671886818869188701887118872188731887418875188761887718878188791888018881188821888318884188851888618887188881888918890188911889218893188941889518896188971889818899189001890118902189031890418905189061890718908189091891018911189121891318914189151891618917189181891918920189211892218923189241892518926189271892818929189301893118932189331893418935189361893718938189391894018941189421894318944189451894618947189481894918950189511895218953189541895518956189571895818959189601896118962189631896418965189661896718968189691897018971189721897318974189751897618977189781897918980189811898218983189841898518986189871898818989189901899118992189931899418995189961899718998189991900019001190021900319004190051900619007190081900919010190111901219013190141901519016190171901819019190201902119022190231902419025190261902719028190291903019031190321903319034190351903619037190381903919040190411904219043190441904519046190471904819049190501905119052190531905419055190561905719058190591906019061190621906319064190651906619067190681906919070190711907219073190741907519076190771907819079190801908119082190831908419085190861908719088190891909019091190921909319094190951909619097190981909919100191011910219103191041910519106191071910819109191101911119112191131911419115191161911719118191191912019121191221912319124191251912619127191281912919130191311913219133191341913519136191371913819139191401914119142191431914419145191461914719148191491915019151191521915319154191551915619157191581915919160191611916219163191641916519166191671916819169191701917119172191731917419175191761917719178191791918019181191821918319184191851918619187191881918919190191911919219193191941919519196191971919819199192001920119202192031920419205192061920719208192091921019211192121921319214192151921619217192181921919220192211922219223192241922519226192271922819229192301923119232192331923419235192361923719238192391924019241192421924319244192451924619247192481924919250192511925219253192541925519256192571925819259192601926119262192631926419265192661926719268192691927019271192721927319274192751927619277192781927919280192811928219283192841928519286192871928819289192901929119292192931929419295192961929719298192991930019301193021930319304193051930619307193081930919310193111931219313193141931519316193171931819319193201932119322193231932419325193261932719328193291933019331193321933319334193351933619337193381933919340193411934219343193441934519346193471934819349193501935119352193531935419355193561935719358193591936019361193621936319364193651936619367193681936919370193711937219373193741937519376193771937819379193801938119382193831938419385193861938719388193891939019391193921939319394193951939619397193981939919400194011940219403194041940519406194071940819409194101941119412194131941419415194161941719418194191942019421194221942319424194251942619427194281942919430194311943219433194341943519436194371943819439194401944119442194431944419445194461944719448194491945019451194521945319454194551945619457194581945919460194611946219463194641946519466194671946819469194701947119472194731947419475194761947719478194791948019481194821948319484194851948619487194881948919490194911949219493194941949519496194971949819499195001950119502195031950419505195061950719508195091951019511195121951319514195151951619517195181951919520195211952219523195241952519526195271952819529195301953119532195331953419535195361953719538195391954019541195421954319544195451954619547195481954919550195511955219553195541955519556195571955819559195601956119562195631956419565195661956719568195691957019571195721957319574195751957619577195781957919580195811958219583195841958519586195871958819589195901959119592195931959419595195961959719598195991960019601196021960319604196051960619607196081960919610196111961219613196141961519616196171961819619196201962119622196231962419625196261962719628196291963019631196321963319634196351963619637196381963919640196411964219643196441964519646196471964819649196501965119652196531965419655196561965719658196591966019661196621966319664196651966619667196681966919670196711967219673196741967519676196771967819679196801968119682196831968419685196861968719688196891969019691196921969319694196951969619697196981969919700197011970219703197041970519706197071970819709197101971119712197131971419715197161971719718197191972019721197221972319724197251972619727197281972919730197311973219733197341973519736197371973819739197401974119742197431974419745197461974719748197491975019751197521975319754197551975619757197581975919760197611976219763197641976519766197671976819769197701977119772197731977419775197761977719778197791978019781197821978319784197851978619787197881978919790197911979219793197941979519796197971979819799198001980119802198031980419805198061980719808198091981019811198121981319814198151981619817198181981919820198211982219823198241982519826198271982819829198301983119832198331983419835198361983719838198391984019841198421984319844198451984619847198481984919850198511985219853198541985519856198571985819859198601986119862198631986419865198661986719868198691987019871198721987319874198751987619877198781987919880198811988219883198841988519886198871988819889198901989119892198931989419895198961989719898198991990019901199021990319904199051990619907199081990919910199111991219913199141991519916199171991819919199201992119922199231992419925199261992719928199291993019931199321993319934199351993619937199381993919940199411994219943199441994519946199471994819949199501995119952199531995419955199561995719958199591996019961199621996319964199651996619967199681996919970199711997219973199741997519976199771997819979199801998119982199831998419985199861998719988199891999019991199921999319994199951999619997199981999920000200012000220003200042000520006200072000820009200102001120012200132001420015200162001720018200192002020021200222002320024200252002620027200282002920030200312003220033200342003520036200372003820039200402004120042200432004420045200462004720048200492005020051200522005320054200552005620057200582005920060200612006220063200642006520066200672006820069200702007120072200732007420075200762007720078200792008020081200822008320084200852008620087200882008920090200912009220093200942009520096200972009820099201002010120102201032010420105201062010720108201092011020111201122011320114201152011620117201182011920120201212012220123201242012520126201272012820129201302013120132201332013420135201362013720138201392014020141201422014320144201452014620147201482014920150201512015220153201542015520156201572015820159201602016120162201632016420165201662016720168201692017020171201722017320174201752017620177201782017920180201812018220183201842018520186201872018820189201902019120192201932019420195201962019720198201992020020201202022020320204202052020620207202082020920210202112021220213202142021520216202172021820219202202022120222202232022420225202262022720228202292023020231202322023320234202352023620237202382023920240202412024220243202442024520246202472024820249202502025120252202532025420255202562025720258202592026020261202622026320264202652026620267202682026920270202712027220273202742027520276202772027820279202802028120282202832028420285202862028720288202892029020291202922029320294202952029620297202982029920300203012030220303203042030520306203072030820309203102031120312203132031420315203162031720318203192032020321203222032320324203252032620327203282032920330203312033220333203342033520336203372033820339203402034120342203432034420345203462034720348203492035020351203522035320354203552035620357203582035920360203612036220363203642036520366203672036820369203702037120372203732037420375203762037720378203792038020381203822038320384203852038620387203882038920390203912039220393203942039520396203972039820399204002040120402204032040420405204062040720408204092041020411204122041320414204152041620417204182041920420204212042220423204242042520426204272042820429204302043120432204332043420435204362043720438204392044020441204422044320444204452044620447204482044920450204512045220453204542045520456204572045820459204602046120462204632046420465204662046720468204692047020471204722047320474204752047620477204782047920480204812048220483204842048520486204872048820489204902049120492204932049420495204962049720498204992050020501205022050320504205052050620507205082050920510205112051220513205142051520516205172051820519205202052120522205232052420525205262052720528205292053020531205322053320534205352053620537205382053920540205412054220543205442054520546205472054820549205502055120552205532055420555205562055720558205592056020561205622056320564205652056620567205682056920570205712057220573205742057520576205772057820579205802058120582205832058420585205862058720588205892059020591205922059320594205952059620597205982059920600206012060220603206042060520606206072060820609206102061120612206132061420615206162061720618206192062020621206222062320624206252062620627206282062920630206312063220633206342063520636206372063820639206402064120642206432064420645206462064720648206492065020651206522065320654206552065620657206582065920660206612066220663206642066520666206672066820669206702067120672206732067420675206762067720678206792068020681206822068320684206852068620687206882068920690206912069220693206942069520696206972069820699207002070120702207032070420705207062070720708207092071020711207122071320714207152071620717207182071920720207212072220723207242072520726207272072820729207302073120732207332073420735207362073720738207392074020741207422074320744207452074620747207482074920750207512075220753207542075520756207572075820759207602076120762207632076420765207662076720768207692077020771207722077320774207752077620777207782077920780207812078220783207842078520786207872078820789207902079120792207932079420795207962079720798207992080020801208022080320804208052080620807208082080920810208112081220813208142081520816208172081820819208202082120822208232082420825208262082720828208292083020831208322083320834208352083620837208382083920840208412084220843208442084520846208472084820849208502085120852208532085420855208562085720858208592086020861208622086320864208652086620867208682086920870208712087220873208742087520876208772087820879208802088120882208832088420885208862088720888208892089020891208922089320894208952089620897208982089920900209012090220903209042090520906209072090820909209102091120912209132091420915209162091720918209192092020921209222092320924209252092620927209282092920930209312093220933209342093520936209372093820939209402094120942209432094420945209462094720948209492095020951209522095320954209552095620957209582095920960209612096220963209642096520966209672096820969209702097120972209732097420975209762097720978209792098020981209822098320984209852098620987209882098920990209912099220993209942099520996209972099820999210002100121002210032100421005210062100721008210092101021011210122101321014210152101621017210182101921020210212102221023210242102521026210272102821029210302103121032210332103421035210362103721038210392104021041210422104321044210452104621047210482104921050210512105221053210542105521056210572105821059210602106121062210632106421065210662106721068210692107021071210722107321074210752107621077210782107921080210812108221083210842108521086210872108821089210902109121092210932109421095210962109721098210992110021101211022110321104211052110621107211082110921110211112111221113211142111521116211172111821119211202112121122211232112421125211262112721128211292113021131211322113321134211352113621137211382113921140211412114221143211442114521146211472114821149211502115121152211532115421155211562115721158211592116021161211622116321164211652116621167211682116921170211712117221173211742117521176211772117821179211802118121182211832118421185211862118721188211892119021191211922119321194211952119621197211982119921200212012120221203212042120521206212072120821209212102121121212212132121421215212162121721218212192122021221212222122321224212252122621227212282122921230212312123221233212342123521236212372123821239212402124121242212432124421245212462124721248212492125021251212522125321254212552125621257212582125921260212612126221263212642126521266212672126821269212702127121272212732127421275212762127721278212792128021281212822128321284212852128621287212882128921290212912129221293212942129521296212972129821299213002130121302213032130421305213062130721308213092131021311213122131321314213152131621317213182131921320213212132221323213242132521326213272132821329213302133121332213332133421335213362133721338213392134021341213422134321344213452134621347213482134921350213512135221353213542135521356213572135821359213602136121362213632136421365213662136721368213692137021371213722137321374213752137621377213782137921380213812138221383213842138521386213872138821389213902139121392213932139421395213962139721398213992140021401214022140321404214052140621407214082140921410214112141221413214142141521416214172141821419214202142121422214232142421425214262142721428214292143021431214322143321434214352143621437214382143921440214412144221443214442144521446214472144821449214502145121452214532145421455214562145721458214592146021461214622146321464214652146621467214682146921470214712147221473214742147521476214772147821479214802148121482214832148421485214862148721488214892149021491214922149321494214952149621497214982149921500215012150221503215042150521506215072150821509215102151121512215132151421515215162151721518215192152021521215222152321524215252152621527215282152921530215312153221533215342153521536215372153821539215402154121542215432154421545215462154721548215492155021551215522155321554215552155621557215582155921560215612156221563215642156521566215672156821569215702157121572215732157421575215762157721578215792158021581215822158321584215852158621587215882158921590215912159221593215942159521596215972159821599216002160121602216032160421605216062160721608216092161021611216122161321614216152161621617216182161921620216212162221623216242162521626216272162821629216302163121632216332163421635216362163721638216392164021641216422164321644216452164621647216482164921650216512165221653216542165521656216572165821659216602166121662216632166421665216662166721668216692167021671216722167321674216752167621677216782167921680216812168221683216842168521686216872168821689216902169121692216932169421695216962169721698216992170021701217022170321704217052170621707217082170921710217112171221713217142171521716217172171821719217202172121722217232172421725217262172721728217292173021731217322173321734217352173621737217382173921740217412174221743217442174521746217472174821749217502175121752217532175421755217562175721758217592176021761217622176321764217652176621767217682176921770217712177221773217742177521776217772177821779217802178121782217832178421785217862178721788217892179021791217922179321794217952179621797217982179921800218012180221803218042180521806218072180821809218102181121812218132181421815218162181721818218192182021821218222182321824218252182621827218282182921830218312183221833218342183521836218372183821839218402184121842218432184421845218462184721848218492185021851218522185321854218552185621857218582185921860218612186221863218642186521866218672186821869218702187121872218732187421875218762187721878218792188021881218822188321884218852188621887218882188921890218912189221893218942189521896218972189821899219002190121902219032190421905219062190721908219092191021911219122191321914219152191621917219182191921920219212192221923219242192521926219272192821929219302193121932219332193421935219362193721938219392194021941219422194321944219452194621947219482194921950219512195221953219542195521956219572195821959219602196121962219632196421965219662196721968219692197021971219722197321974219752197621977219782197921980219812198221983219842198521986219872198821989219902199121992219932199421995219962199721998219992200022001220022200322004220052200622007220082200922010220112201222013220142201522016220172201822019220202202122022220232202422025220262202722028220292203022031220322203322034220352203622037220382203922040220412204222043220442204522046220472204822049220502205122052220532205422055220562205722058220592206022061220622206322064220652206622067220682206922070220712207222073220742207522076220772207822079220802208122082220832208422085220862208722088220892209022091220922209322094220952209622097220982209922100221012210222103221042210522106221072210822109221102211122112221132211422115221162211722118221192212022121221222212322124221252212622127221282212922130221312213222133221342213522136221372213822139221402214122142221432214422145221462214722148221492215022151221522215322154221552215622157221582215922160221612216222163221642216522166221672216822169221702217122172221732217422175221762217722178221792218022181221822218322184221852218622187221882218922190221912219222193221942219522196221972219822199222002220122202222032220422205222062220722208222092221022211222122221322214222152221622217222182221922220222212222222223222242222522226222272222822229222302223122232222332223422235222362223722238222392224022241222422224322244222452224622247222482224922250222512225222253222542225522256222572225822259222602226122262222632226422265222662226722268222692227022271222722227322274222752227622277222782227922280222812228222283222842228522286222872228822289222902229122292222932229422295222962229722298222992230022301223022230322304223052230622307223082230922310223112231222313223142231522316223172231822319223202232122322223232232422325223262232722328223292233022331223322233322334223352233622337223382233922340223412234222343223442234522346223472234822349223502235122352223532235422355223562235722358223592236022361223622236322364223652236622367223682236922370223712237222373223742237522376223772237822379223802238122382223832238422385223862238722388223892239022391223922239322394223952239622397223982239922400224012240222403224042240522406224072240822409224102241122412224132241422415224162241722418224192242022421224222242322424224252242622427224282242922430224312243222433224342243522436224372243822439224402244122442224432244422445224462244722448224492245022451224522245322454224552245622457224582245922460224612246222463224642246522466224672246822469224702247122472224732247422475224762247722478224792248022481224822248322484224852248622487224882248922490224912249222493224942249522496224972249822499225002250122502225032250422505225062250722508225092251022511225122251322514225152251622517225182251922520225212252222523225242252522526225272252822529225302253122532225332253422535225362253722538225392254022541225422254322544225452254622547225482254922550225512255222553225542255522556225572255822559225602256122562225632256422565225662256722568225692257022571225722257322574225752257622577225782257922580225812258222583225842258522586225872258822589225902259122592225932259422595225962259722598225992260022601226022260322604226052260622607226082260922610226112261222613226142261522616226172261822619226202262122622226232262422625226262262722628226292263022631226322263322634226352263622637226382263922640226412264222643226442264522646226472264822649226502265122652226532265422655226562265722658226592266022661226622266322664226652266622667226682266922670226712267222673226742267522676226772267822679226802268122682226832268422685226862268722688226892269022691226922269322694226952269622697226982269922700227012270222703227042270522706227072270822709227102271122712227132271422715227162271722718227192272022721227222272322724227252272622727227282272922730227312273222733227342273522736227372273822739227402274122742227432274422745227462274722748227492275022751227522275322754227552275622757227582275922760227612276222763227642276522766227672276822769227702277122772227732277422775227762277722778227792278022781227822278322784227852278622787227882278922790227912279222793227942279522796227972279822799228002280122802228032280422805228062280722808228092281022811228122281322814228152281622817228182281922820228212282222823228242282522826228272282822829228302283122832228332283422835228362283722838228392284022841228422284322844228452284622847228482284922850228512285222853228542285522856228572285822859228602286122862228632286422865228662286722868228692287022871228722287322874228752287622877228782287922880228812288222883228842288522886228872288822889228902289122892228932289422895228962289722898228992290022901229022290322904229052290622907229082290922910229112291222913229142291522916229172291822919229202292122922229232292422925229262292722928229292293022931229322293322934229352293622937229382293922940229412294222943229442294522946229472294822949229502295122952229532295422955229562295722958229592296022961229622296322964229652296622967229682296922970229712297222973229742297522976229772297822979229802298122982229832298422985229862298722988229892299022991229922299322994229952299622997229982299923000230012300223003230042300523006230072300823009230102301123012230132301423015230162301723018230192302023021230222302323024230252302623027230282302923030230312303223033230342303523036230372303823039230402304123042230432304423045230462304723048230492305023051230522305323054230552305623057230582305923060230612306223063230642306523066230672306823069230702307123072230732307423075230762307723078230792308023081230822308323084230852308623087230882308923090230912309223093230942309523096230972309823099231002310123102231032310423105231062310723108231092311023111231122311323114231152311623117231182311923120231212312223123231242312523126231272312823129231302313123132231332313423135231362313723138231392314023141231422314323144231452314623147231482314923150231512315223153231542315523156231572315823159231602316123162231632316423165231662316723168231692317023171231722317323174231752317623177231782317923180231812318223183231842318523186231872318823189231902319123192231932319423195231962319723198231992320023201232022320323204232052320623207232082320923210232112321223213232142321523216232172321823219232202322123222232232322423225232262322723228232292323023231232322323323234232352323623237232382323923240232412324223243232442324523246232472324823249232502325123252232532325423255232562325723258232592326023261232622326323264232652326623267232682326923270232712327223273232742327523276232772327823279232802328123282232832328423285232862328723288232892329023291232922329323294232952329623297232982329923300233012330223303233042330523306233072330823309233102331123312233132331423315233162331723318233192332023321233222332323324233252332623327233282332923330233312333223333233342333523336233372333823339233402334123342233432334423345233462334723348233492335023351233522335323354233552335623357233582335923360233612336223363233642336523366233672336823369233702337123372233732337423375233762337723378233792338023381233822338323384233852338623387233882338923390233912339223393233942339523396233972339823399234002340123402234032340423405234062340723408234092341023411234122341323414234152341623417234182341923420234212342223423234242342523426234272342823429234302343123432234332343423435234362343723438234392344023441234422344323444234452344623447234482344923450234512345223453234542345523456234572345823459234602346123462234632346423465234662346723468234692347023471234722347323474234752347623477234782347923480234812348223483234842348523486234872348823489234902349123492234932349423495234962349723498234992350023501235022350323504235052350623507235082350923510235112351223513235142351523516235172351823519235202352123522235232352423525235262352723528235292353023531235322353323534235352353623537235382353923540235412354223543235442354523546235472354823549235502355123552235532355423555235562355723558235592356023561235622356323564235652356623567235682356923570235712357223573235742357523576235772357823579235802358123582235832358423585235862358723588235892359023591235922359323594235952359623597235982359923600236012360223603236042360523606236072360823609236102361123612236132361423615236162361723618236192362023621236222362323624236252362623627236282362923630236312363223633236342363523636236372363823639236402364123642236432364423645236462364723648236492365023651236522365323654236552365623657236582365923660236612366223663236642366523666236672366823669236702367123672236732367423675236762367723678236792368023681236822368323684236852368623687236882368923690236912369223693236942369523696236972369823699237002370123702237032370423705237062370723708237092371023711237122371323714237152371623717237182371923720237212372223723237242372523726237272372823729237302373123732237332373423735237362373723738237392374023741237422374323744237452374623747237482374923750237512375223753237542375523756237572375823759237602376123762237632376423765237662376723768237692377023771237722377323774237752377623777237782377923780237812378223783237842378523786237872378823789237902379123792237932379423795237962379723798237992380023801238022380323804238052380623807238082380923810238112381223813238142381523816238172381823819238202382123822238232382423825238262382723828238292383023831238322383323834238352383623837238382383923840238412384223843238442384523846238472384823849238502385123852238532385423855238562385723858238592386023861238622386323864238652386623867238682386923870238712387223873238742387523876238772387823879238802388123882238832388423885238862388723888238892389023891238922389323894238952389623897238982389923900239012390223903239042390523906239072390823909239102391123912239132391423915239162391723918239192392023921239222392323924239252392623927239282392923930239312393223933239342393523936239372393823939239402394123942239432394423945239462394723948239492395023951239522395323954239552395623957239582395923960239612396223963239642396523966239672396823969239702397123972239732397423975239762397723978239792398023981239822398323984239852398623987239882398923990239912399223993239942399523996239972399823999240002400124002240032400424005240062400724008240092401024011240122401324014240152401624017240182401924020240212402224023240242402524026240272402824029240302403124032240332403424035240362403724038240392404024041240422404324044240452404624047240482404924050240512405224053240542405524056240572405824059240602406124062240632406424065240662406724068240692407024071240722407324074240752407624077240782407924080240812408224083240842408524086240872408824089240902409124092240932409424095240962409724098240992410024101241022410324104241052410624107241082410924110241112411224113241142411524116241172411824119241202412124122241232412424125241262412724128241292413024131241322413324134241352413624137241382413924140241412414224143241442414524146241472414824149241502415124152241532415424155241562415724158241592416024161241622416324164241652416624167241682416924170241712417224173241742417524176241772417824179241802418124182241832418424185241862418724188241892419024191241922419324194241952419624197241982419924200242012420224203242042420524206242072420824209242102421124212242132421424215242162421724218242192422024221242222422324224242252422624227242282422924230242312423224233242342423524236242372423824239242402424124242242432424424245242462424724248242492425024251242522425324254242552425624257242582425924260242612426224263242642426524266242672426824269242702427124272242732427424275242762427724278242792428024281242822428324284242852428624287242882428924290242912429224293242942429524296242972429824299243002430124302243032430424305243062430724308243092431024311243122431324314243152431624317243182431924320243212432224323243242432524326243272432824329243302433124332243332433424335243362433724338243392434024341243422434324344243452434624347243482434924350243512435224353243542435524356243572435824359243602436124362243632436424365243662436724368243692437024371243722437324374243752437624377243782437924380243812438224383243842438524386243872438824389243902439124392243932439424395243962439724398243992440024401244022440324404244052440624407244082440924410244112441224413244142441524416244172441824419244202442124422244232442424425244262442724428244292443024431244322443324434244352443624437244382443924440244412444224443244442444524446244472444824449244502445124452244532445424455244562445724458244592446024461244622446324464244652446624467244682446924470244712447224473244742447524476244772447824479244802448124482244832448424485244862448724488244892449024491244922449324494244952449624497244982449924500245012450224503245042450524506245072450824509245102451124512245132451424515245162451724518245192452024521245222452324524245252452624527245282452924530245312453224533245342453524536245372453824539245402454124542245432454424545245462454724548245492455024551245522455324554245552455624557245582455924560245612456224563245642456524566245672456824569245702457124572245732457424575245762457724578245792458024581245822458324584245852458624587245882458924590245912459224593245942459524596245972459824599246002460124602246032460424605246062460724608246092461024611246122461324614246152461624617246182461924620246212462224623246242462524626246272462824629246302463124632246332463424635246362463724638246392464024641246422464324644246452464624647246482464924650246512465224653246542465524656246572465824659246602466124662246632466424665246662466724668246692467024671246722467324674246752467624677246782467924680246812468224683246842468524686246872468824689246902469124692246932469424695246962469724698246992470024701247022470324704247052470624707247082470924710247112471224713247142471524716247172471824719247202472124722247232472424725247262472724728247292473024731247322473324734247352473624737247382473924740247412474224743247442474524746247472474824749247502475124752247532475424755247562475724758247592476024761247622476324764247652476624767247682476924770247712477224773247742477524776247772477824779247802478124782247832478424785247862478724788247892479024791247922479324794247952479624797247982479924800248012480224803248042480524806248072480824809248102481124812248132481424815248162481724818248192482024821248222482324824248252482624827248282482924830248312483224833248342483524836248372483824839248402484124842248432484424845248462484724848248492485024851248522485324854248552485624857248582485924860248612486224863248642486524866248672486824869248702487124872248732487424875248762487724878248792488024881248822488324884248852488624887248882488924890248912489224893248942489524896248972489824899249002490124902249032490424905249062490724908249092491024911249122491324914249152491624917249182491924920249212492224923249242492524926249272492824929249302493124932249332493424935249362493724938249392494024941249422494324944249452494624947249482494924950249512495224953249542495524956249572495824959249602496124962249632496424965249662496724968249692497024971249722497324974249752497624977249782497924980249812498224983249842498524986249872498824989249902499124992249932499424995249962499724998249992500025001250022500325004250052500625007250082500925010250112501225013250142501525016250172501825019250202502125022250232502425025250262502725028250292503025031250322503325034250352503625037250382503925040250412504225043250442504525046250472504825049250502505125052250532505425055250562505725058250592506025061250622506325064250652506625067250682506925070250712507225073250742507525076250772507825079250802508125082250832508425085250862508725088250892509025091250922509325094250952509625097250982509925100251012510225103251042510525106251072510825109251102511125112251132511425115251162511725118251192512025121251222512325124251252512625127251282512925130251312513225133251342513525136251372513825139251402514125142251432514425145251462514725148251492515025151251522515325154251552515625157251582515925160251612516225163251642516525166251672516825169251702517125172251732517425175251762517725178251792518025181251822518325184251852518625187251882518925190251912519225193251942519525196251972519825199252002520125202252032520425205252062520725208252092521025211252122521325214252152521625217252182521925220252212522225223252242522525226252272522825229252302523125232252332523425235252362523725238252392524025241252422524325244252452524625247252482524925250252512525225253252542525525256252572525825259252602526125262252632526425265252662526725268252692527025271252722527325274252752527625277252782527925280252812528225283252842528525286252872528825289252902529125292252932529425295252962529725298252992530025301253022530325304253052530625307253082530925310253112531225313253142531525316253172531825319253202532125322253232532425325253262532725328253292533025331253322533325334253352533625337253382533925340253412534225343253442534525346253472534825349253502535125352253532535425355253562535725358253592536025361253622536325364253652536625367253682536925370253712537225373253742537525376253772537825379253802538125382253832538425385253862538725388253892539025391253922539325394253952539625397253982539925400254012540225403254042540525406254072540825409254102541125412254132541425415254162541725418254192542025421254222542325424254252542625427254282542925430254312543225433254342543525436254372543825439254402544125442254432544425445254462544725448254492545025451254522545325454254552545625457254582545925460254612546225463254642546525466254672546825469254702547125472254732547425475254762547725478254792548025481254822548325484254852548625487254882548925490254912549225493254942549525496254972549825499255002550125502255032550425505255062550725508255092551025511255122551325514255152551625517255182551925520255212552225523255242552525526255272552825529255302553125532255332553425535255362553725538255392554025541255422554325544255452554625547255482554925550255512555225553255542555525556255572555825559255602556125562255632556425565255662556725568255692557025571255722557325574255752557625577255782557925580255812558225583255842558525586255872558825589255902559125592255932559425595255962559725598255992560025601256022560325604256052560625607256082560925610256112561225613256142561525616256172561825619256202562125622256232562425625256262562725628256292563025631256322563325634256352563625637256382563925640256412564225643256442564525646256472564825649256502565125652256532565425655256562565725658256592566025661256622566325664256652566625667256682566925670256712567225673256742567525676256772567825679256802568125682256832568425685256862568725688256892569025691256922569325694256952569625697256982569925700257012570225703257042570525706257072570825709257102571125712257132571425715257162571725718257192572025721257222572325724257252572625727257282572925730257312573225733257342573525736257372573825739257402574125742257432574425745257462574725748257492575025751257522575325754257552575625757257582575925760257612576225763257642576525766257672576825769257702577125772257732577425775257762577725778257792578025781257822578325784257852578625787257882578925790257912579225793257942579525796257972579825799258002580125802258032580425805258062580725808258092581025811258122581325814258152581625817258182581925820258212582225823258242582525826258272582825829258302583125832258332583425835258362583725838258392584025841258422584325844258452584625847258482584925850258512585225853258542585525856258572585825859258602586125862258632586425865258662586725868258692587025871258722587325874258752587625877258782587925880258812588225883258842588525886258872588825889258902589125892258932589425895258962589725898258992590025901259022590325904259052590625907259082590925910259112591225913259142591525916259172591825919259202592125922259232592425925259262592725928259292593025931259322593325934259352593625937259382593925940259412594225943259442594525946259472594825949259502595125952259532595425955259562595725958259592596025961259622596325964259652596625967259682596925970259712597225973259742597525976259772597825979259802598125982259832598425985259862598725988259892599025991259922599325994259952599625997259982599926000260012600226003260042600526006260072600826009260102601126012260132601426015260162601726018260192602026021260222602326024260252602626027260282602926030260312603226033260342603526036260372603826039260402604126042260432604426045260462604726048260492605026051260522605326054260552605626057260582605926060260612606226063260642606526066260672606826069260702607126072260732607426075260762607726078260792608026081260822608326084260852608626087260882608926090260912609226093260942609526096260972609826099261002610126102261032610426105261062610726108261092611026111261122611326114261152611626117261182611926120261212612226123261242612526126261272612826129261302613126132261332613426135261362613726138261392614026141261422614326144261452614626147261482614926150261512615226153261542615526156261572615826159261602616126162261632616426165261662616726168261692617026171261722617326174261752617626177261782617926180261812618226183261842618526186261872618826189261902619126192261932619426195261962619726198261992620026201262022620326204262052620626207262082620926210262112621226213262142621526216262172621826219262202622126222262232622426225262262622726228262292623026231262322623326234262352623626237262382623926240262412624226243262442624526246262472624826249262502625126252262532625426255262562625726258262592626026261262622626326264262652626626267262682626926270262712627226273262742627526276262772627826279262802628126282262832628426285262862628726288262892629026291262922629326294262952629626297262982629926300263012630226303263042630526306263072630826309263102631126312263132631426315263162631726318263192632026321263222632326324263252632626327263282632926330263312633226333263342633526336263372633826339263402634126342263432634426345263462634726348263492635026351263522635326354263552635626357263582635926360263612636226363263642636526366263672636826369263702637126372263732637426375263762637726378263792638026381263822638326384263852638626387263882638926390263912639226393263942639526396263972639826399264002640126402264032640426405264062640726408264092641026411264122641326414264152641626417264182641926420264212642226423264242642526426264272642826429264302643126432264332643426435264362643726438264392644026441264422644326444264452644626447264482644926450264512645226453264542645526456264572645826459264602646126462264632646426465264662646726468264692647026471264722647326474264752647626477264782647926480264812648226483264842648526486264872648826489264902649126492264932649426495264962649726498264992650026501265022650326504265052650626507265082650926510265112651226513265142651526516265172651826519265202652126522265232652426525265262652726528265292653026531265322653326534265352653626537265382653926540265412654226543265442654526546265472654826549265502655126552265532655426555265562655726558265592656026561265622656326564265652656626567265682656926570265712657226573265742657526576265772657826579265802658126582265832658426585265862658726588265892659026591265922659326594265952659626597265982659926600266012660226603266042660526606266072660826609266102661126612266132661426615266162661726618266192662026621266222662326624266252662626627266282662926630266312663226633266342663526636266372663826639266402664126642266432664426645266462664726648266492665026651266522665326654266552665626657266582665926660266612666226663266642666526666266672666826669266702667126672266732667426675266762667726678266792668026681266822668326684266852668626687266882668926690266912669226693266942669526696266972669826699267002670126702267032670426705267062670726708267092671026711267122671326714267152671626717267182671926720267212672226723267242672526726267272672826729267302673126732267332673426735267362673726738267392674026741267422674326744267452674626747267482674926750267512675226753267542675526756267572675826759267602676126762267632676426765267662676726768267692677026771267722677326774267752677626777267782677926780267812678226783267842678526786267872678826789267902679126792267932679426795267962679726798267992680026801268022680326804268052680626807268082680926810268112681226813268142681526816268172681826819268202682126822268232682426825268262682726828268292683026831268322683326834268352683626837268382683926840268412684226843268442684526846268472684826849268502685126852268532685426855268562685726858268592686026861268622686326864268652686626867268682686926870268712687226873268742687526876268772687826879268802688126882268832688426885268862688726888268892689026891268922689326894268952689626897268982689926900269012690226903269042690526906269072690826909269102691126912269132691426915269162691726918269192692026921269222692326924269252692626927269282692926930269312693226933269342693526936269372693826939269402694126942269432694426945269462694726948269492695026951269522695326954269552695626957269582695926960269612696226963269642696526966269672696826969269702697126972269732697426975269762697726978269792698026981269822698326984269852698626987269882698926990269912699226993269942699526996269972699826999270002700127002270032700427005270062700727008270092701027011270122701327014270152701627017270182701927020270212702227023270242702527026270272702827029270302703127032270332703427035270362703727038270392704027041270422704327044270452704627047270482704927050270512705227053270542705527056270572705827059270602706127062270632706427065270662706727068270692707027071270722707327074270752707627077270782707927080270812708227083270842708527086270872708827089270902709127092270932709427095270962709727098270992710027101271022710327104271052710627107271082710927110271112711227113271142711527116271172711827119271202712127122271232712427125271262712727128271292713027131271322713327134271352713627137271382713927140271412714227143271442714527146271472714827149271502715127152271532715427155271562715727158271592716027161271622716327164271652716627167271682716927170271712717227173271742717527176271772717827179271802718127182271832718427185271862718727188271892719027191271922719327194271952719627197271982719927200272012720227203272042720527206272072720827209272102721127212272132721427215272162721727218272192722027221272222722327224272252722627227272282722927230272312723227233272342723527236272372723827239272402724127242272432724427245272462724727248272492725027251272522725327254272552725627257272582725927260272612726227263272642726527266272672726827269272702727127272272732727427275272762727727278272792728027281272822728327284272852728627287272882728927290272912729227293272942729527296272972729827299273002730127302273032730427305273062730727308273092731027311273122731327314273152731627317273182731927320273212732227323273242732527326273272732827329273302733127332273332733427335273362733727338273392734027341273422734327344273452734627347273482734927350273512735227353273542735527356273572735827359273602736127362273632736427365273662736727368273692737027371273722737327374273752737627377273782737927380273812738227383273842738527386273872738827389273902739127392273932739427395273962739727398273992740027401274022740327404274052740627407274082740927410274112741227413274142741527416274172741827419274202742127422274232742427425274262742727428274292743027431274322743327434274352743627437274382743927440274412744227443274442744527446274472744827449274502745127452274532745427455274562745727458274592746027461274622746327464274652746627467274682746927470274712747227473274742747527476274772747827479274802748127482274832748427485274862748727488274892749027491274922749327494274952749627497274982749927500275012750227503275042750527506275072750827509275102751127512275132751427515275162751727518275192752027521275222752327524275252752627527275282752927530275312753227533275342753527536275372753827539275402754127542275432754427545275462754727548275492755027551275522755327554275552755627557275582755927560275612756227563275642756527566275672756827569275702757127572275732757427575275762757727578275792758027581275822758327584275852758627587275882758927590275912759227593275942759527596275972759827599276002760127602276032760427605276062760727608276092761027611276122761327614276152761627617276182761927620276212762227623276242762527626276272762827629276302763127632276332763427635276362763727638276392764027641276422764327644276452764627647276482764927650276512765227653276542765527656276572765827659276602766127662276632766427665276662766727668276692767027671276722767327674276752767627677276782767927680276812768227683276842768527686276872768827689276902769127692276932769427695276962769727698276992770027701277022770327704277052770627707277082770927710277112771227713277142771527716277172771827719277202772127722277232772427725277262772727728277292773027731277322773327734277352773627737277382773927740277412774227743277442774527746277472774827749277502775127752277532775427755277562775727758277592776027761277622776327764277652776627767277682776927770277712777227773277742777527776277772777827779277802778127782277832778427785277862778727788277892779027791277922779327794277952779627797277982779927800278012780227803278042780527806278072780827809278102781127812278132781427815278162781727818278192782027821278222782327824278252782627827278282782927830278312783227833278342783527836278372783827839278402784127842278432784427845278462784727848278492785027851278522785327854278552785627857278582785927860278612786227863278642786527866278672786827869278702787127872278732787427875278762787727878278792788027881278822788327884278852788627887278882788927890278912789227893278942789527896278972789827899279002790127902279032790427905279062790727908279092791027911279122791327914279152791627917279182791927920279212792227923279242792527926279272792827929279302793127932279332793427935279362793727938279392794027941279422794327944279452794627947279482794927950279512795227953279542795527956279572795827959279602796127962279632796427965279662796727968279692797027971279722797327974279752797627977279782797927980279812798227983279842798527986279872798827989279902799127992279932799427995279962799727998279992800028001280022800328004280052800628007280082800928010280112801228013280142801528016280172801828019280202802128022280232802428025280262802728028280292803028031280322803328034280352803628037280382803928040280412804228043280442804528046280472804828049280502805128052280532805428055280562805728058280592806028061280622806328064280652806628067280682806928070280712807228073280742807528076280772807828079280802808128082280832808428085280862808728088280892809028091280922809328094280952809628097280982809928100281012810228103281042810528106281072810828109281102811128112281132811428115281162811728118281192812028121281222812328124281252812628127281282812928130281312813228133281342813528136281372813828139281402814128142281432814428145281462814728148281492815028151281522815328154281552815628157281582815928160281612816228163281642816528166281672816828169281702817128172281732817428175281762817728178281792818028181281822818328184281852818628187281882818928190281912819228193281942819528196281972819828199282002820128202282032820428205282062820728208282092821028211282122821328214282152821628217282182821928220282212822228223282242822528226282272822828229282302823128232282332823428235282362823728238282392824028241282422824328244282452824628247282482824928250282512825228253282542825528256282572825828259282602826128262282632826428265282662826728268282692827028271282722827328274282752827628277282782827928280282812828228283282842828528286282872828828289282902829128292282932829428295282962829728298282992830028301283022830328304283052830628307283082830928310283112831228313283142831528316283172831828319283202832128322283232832428325283262832728328283292833028331283322833328334283352833628337283382833928340283412834228343283442834528346283472834828349283502835128352283532835428355283562835728358283592836028361283622836328364283652836628367283682836928370283712837228373283742837528376283772837828379283802838128382283832838428385283862838728388283892839028391283922839328394283952839628397283982839928400284012840228403284042840528406284072840828409284102841128412284132841428415284162841728418284192842028421284222842328424284252842628427284282842928430284312843228433284342843528436284372843828439284402844128442284432844428445284462844728448284492845028451284522845328454284552845628457284582845928460284612846228463284642846528466284672846828469284702847128472284732847428475284762847728478284792848028481284822848328484284852848628487284882848928490284912849228493284942849528496284972849828499285002850128502285032850428505285062850728508285092851028511285122851328514285152851628517285182851928520285212852228523285242852528526285272852828529285302853128532285332853428535285362853728538285392854028541285422854328544285452854628547285482854928550285512855228553285542855528556285572855828559285602856128562285632856428565285662856728568285692857028571285722857328574285752857628577285782857928580285812858228583285842858528586285872858828589285902859128592285932859428595285962859728598285992860028601286022860328604286052860628607286082860928610286112861228613286142861528616286172861828619286202862128622286232862428625286262862728628286292863028631286322863328634286352863628637286382863928640286412864228643286442864528646286472864828649286502865128652286532865428655286562865728658286592866028661286622866328664286652866628667286682866928670286712867228673286742867528676286772867828679286802868128682286832868428685286862868728688286892869028691286922869328694286952869628697286982869928700287012870228703287042870528706287072870828709287102871128712287132871428715287162871728718287192872028721287222872328724287252872628727287282872928730287312873228733287342873528736287372873828739287402874128742287432874428745287462874728748287492875028751287522875328754287552875628757287582875928760287612876228763287642876528766287672876828769287702877128772287732877428775287762877728778287792878028781287822878328784287852878628787287882878928790287912879228793287942879528796287972879828799288002880128802288032880428805288062880728808288092881028811288122881328814288152881628817288182881928820288212882228823288242882528826288272882828829288302883128832288332883428835288362883728838288392884028841288422884328844288452884628847288482884928850288512885228853288542885528856288572885828859288602886128862288632886428865288662886728868288692887028871288722887328874288752887628877288782887928880288812888228883288842888528886288872888828889288902889128892288932889428895288962889728898288992890028901289022890328904289052890628907289082890928910289112891228913289142891528916289172891828919289202892128922289232892428925289262892728928289292893028931289322893328934289352893628937289382893928940289412894228943289442894528946289472894828949289502895128952289532895428955289562895728958289592896028961289622896328964289652896628967289682896928970289712897228973289742897528976289772897828979289802898128982289832898428985289862898728988289892899028991289922899328994289952899628997289982899929000290012900229003290042900529006290072900829009290102901129012290132901429015290162901729018290192902029021290222902329024290252902629027290282902929030290312903229033290342903529036290372903829039290402904129042290432904429045290462904729048290492905029051290522905329054290552905629057290582905929060290612906229063290642906529066290672906829069290702907129072290732907429075290762907729078290792908029081290822908329084290852908629087290882908929090290912909229093290942909529096290972909829099291002910129102291032910429105291062910729108291092911029111291122911329114291152911629117291182911929120291212912229123291242912529126291272912829129291302913129132291332913429135291362913729138291392914029141291422914329144291452914629147291482914929150291512915229153291542915529156291572915829159291602916129162291632916429165291662916729168291692917029171291722917329174291752917629177291782917929180291812918229183291842918529186291872918829189291902919129192291932919429195291962919729198291992920029201292022920329204292052920629207292082920929210292112921229213292142921529216292172921829219292202922129222292232922429225292262922729228292292923029231292322923329234292352923629237292382923929240292412924229243292442924529246292472924829249292502925129252292532925429255292562925729258292592926029261292622926329264292652926629267292682926929270292712927229273292742927529276292772927829279292802928129282292832928429285292862928729288292892929029291292922929329294292952929629297292982929929300293012930229303293042930529306293072930829309293102931129312293132931429315293162931729318293192932029321293222932329324293252932629327293282932929330293312933229333293342933529336293372933829339293402934129342293432934429345293462934729348293492935029351293522935329354293552935629357293582935929360293612936229363293642936529366293672936829369293702937129372293732937429375293762937729378293792938029381293822938329384293852938629387293882938929390293912939229393293942939529396293972939829399294002940129402294032940429405294062940729408294092941029411294122941329414294152941629417294182941929420294212942229423294242942529426294272942829429294302943129432294332943429435294362943729438294392944029441294422944329444294452944629447294482944929450294512945229453294542945529456294572945829459294602946129462294632946429465294662946729468294692947029471294722947329474294752947629477294782947929480294812948229483294842948529486294872948829489294902949129492294932949429495294962949729498294992950029501295022950329504295052950629507295082950929510295112951229513295142951529516295172951829519295202952129522295232952429525295262952729528295292953029531295322953329534295352953629537295382953929540295412954229543295442954529546295472954829549295502955129552295532955429555295562955729558295592956029561295622956329564295652956629567295682956929570295712957229573295742957529576295772957829579295802958129582295832958429585295862958729588295892959029591295922959329594295952959629597295982959929600296012960229603296042960529606296072960829609296102961129612296132961429615296162961729618296192962029621296222962329624296252962629627296282962929630296312963229633296342963529636296372963829639296402964129642296432964429645296462964729648296492965029651296522965329654296552965629657296582965929660296612966229663296642966529666296672966829669296702967129672296732967429675296762967729678296792968029681296822968329684296852968629687296882968929690296912969229693296942969529696296972969829699297002970129702297032970429705297062970729708297092971029711297122971329714297152971629717297182971929720297212972229723297242972529726297272972829729297302973129732297332973429735297362973729738297392974029741297422974329744297452974629747297482974929750297512975229753297542975529756297572975829759297602976129762297632976429765297662976729768297692977029771297722977329774297752977629777297782977929780297812978229783297842978529786297872978829789297902979129792297932979429795297962979729798297992980029801298022980329804298052980629807298082980929810298112981229813298142981529816298172981829819298202982129822298232982429825298262982729828298292983029831298322983329834298352983629837298382983929840298412984229843298442984529846298472984829849298502985129852298532985429855298562985729858298592986029861298622986329864298652986629867298682986929870298712987229873298742987529876298772987829879298802988129882298832988429885298862988729888298892989029891298922989329894298952989629897298982989929900299012990229903299042990529906299072990829909299102991129912299132991429915299162991729918299192992029921299222992329924299252992629927299282992929930299312993229933299342993529936299372993829939299402994129942299432994429945299462994729948299492995029951299522995329954299552995629957299582995929960299612996229963299642996529966299672996829969299702997129972299732997429975299762997729978299792998029981299822998329984299852998629987299882998929990299912999229993299942999529996299972999829999300003000130002300033000430005300063000730008300093001030011300123001330014300153001630017300183001930020300213002230023300243002530026300273002830029300303003130032300333003430035300363003730038300393004030041300423004330044300453004630047300483004930050300513005230053300543005530056300573005830059300603006130062300633006430065300663006730068300693007030071300723007330074300753007630077300783007930080300813008230083300843008530086300873008830089300903009130092300933009430095300963009730098300993010030101301023010330104301053010630107301083010930110301113011230113301143011530116301173011830119301203012130122301233012430125301263012730128301293013030131301323013330134301353013630137301383013930140301413014230143301443014530146301473014830149301503015130152301533015430155301563015730158301593016030161301623016330164301653016630167301683016930170301713017230173301743017530176301773017830179301803018130182301833018430185301863018730188301893019030191301923019330194301953019630197301983019930200302013020230203302043020530206302073020830209302103021130212302133021430215302163021730218302193022030221302223022330224302253022630227302283022930230302313023230233302343023530236302373023830239302403024130242302433024430245302463024730248302493025030251302523025330254302553025630257302583025930260302613026230263302643026530266302673026830269302703027130272302733027430275302763027730278302793028030281302823028330284302853028630287302883028930290302913029230293302943029530296302973029830299303003030130302303033030430305303063030730308303093031030311303123031330314303153031630317303183031930320303213032230323303243032530326303273032830329303303033130332303333033430335303363033730338303393034030341303423034330344303453034630347303483034930350303513035230353303543035530356303573035830359303603036130362303633036430365303663036730368303693037030371303723037330374303753037630377303783037930380303813038230383303843038530386303873038830389303903039130392303933039430395303963039730398303993040030401304023040330404304053040630407304083040930410304113041230413304143041530416304173041830419304203042130422304233042430425304263042730428304293043030431304323043330434304353043630437304383043930440304413044230443304443044530446304473044830449304503045130452304533045430455304563045730458304593046030461304623046330464304653046630467304683046930470304713047230473304743047530476304773047830479304803048130482304833048430485304863048730488304893049030491304923049330494304953049630497304983049930500305013050230503305043050530506305073050830509305103051130512305133051430515305163051730518305193052030521305223052330524305253052630527305283052930530305313053230533305343053530536305373053830539305403054130542305433054430545305463054730548305493055030551305523055330554305553055630557305583055930560305613056230563305643056530566305673056830569305703057130572305733057430575305763057730578305793058030581305823058330584305853058630587305883058930590305913059230593305943059530596305973059830599306003060130602306033060430605306063060730608306093061030611306123061330614306153061630617306183061930620306213062230623306243062530626306273062830629306303063130632306333063430635306363063730638306393064030641306423064330644306453064630647306483064930650306513065230653306543065530656306573065830659306603066130662306633066430665306663066730668306693067030671306723067330674306753067630677306783067930680306813068230683306843068530686306873068830689306903069130692306933069430695306963069730698306993070030701307023070330704307053070630707307083070930710307113071230713307143071530716307173071830719307203072130722307233072430725307263072730728307293073030731307323073330734307353073630737307383073930740307413074230743307443074530746307473074830749307503075130752307533075430755307563075730758307593076030761307623076330764307653076630767307683076930770307713077230773307743077530776307773077830779307803078130782307833078430785307863078730788307893079030791307923079330794307953079630797307983079930800308013080230803308043080530806308073080830809308103081130812308133081430815308163081730818308193082030821308223082330824308253082630827308283082930830308313083230833308343083530836308373083830839308403084130842308433084430845308463084730848308493085030851308523085330854308553085630857308583085930860308613086230863308643086530866308673086830869308703087130872308733087430875308763087730878308793088030881308823088330884308853088630887308883088930890308913089230893308943089530896308973089830899309003090130902309033090430905309063090730908309093091030911309123091330914309153091630917309183091930920309213092230923309243092530926309273092830929309303093130932309333093430935309363093730938309393094030941309423094330944309453094630947309483094930950309513095230953309543095530956309573095830959309603096130962309633096430965309663096730968309693097030971309723097330974309753097630977309783097930980309813098230983309843098530986309873098830989309903099130992309933099430995309963099730998309993100031001310023100331004310053100631007310083100931010310113101231013310143101531016310173101831019310203102131022310233102431025310263102731028310293103031031310323103331034310353103631037310383103931040310413104231043310443104531046310473104831049310503105131052310533105431055310563105731058310593106031061310623106331064310653106631067310683106931070310713107231073310743107531076310773107831079310803108131082310833108431085310863108731088310893109031091310923109331094310953109631097310983109931100311013110231103311043110531106311073110831109311103111131112311133111431115311163111731118311193112031121311223112331124311253112631127311283112931130311313113231133311343113531136311373113831139311403114131142311433114431145311463114731148311493115031151311523115331154311553115631157311583115931160311613116231163311643116531166311673116831169311703117131172311733117431175311763117731178311793118031181311823118331184311853118631187311883118931190311913119231193311943119531196311973119831199312003120131202312033120431205312063120731208312093121031211312123121331214312153121631217312183121931220312213122231223312243122531226312273122831229312303123131232312333123431235312363123731238312393124031241312423124331244312453124631247312483124931250312513125231253312543125531256312573125831259312603126131262312633126431265312663126731268312693127031271312723127331274312753127631277312783127931280312813128231283312843128531286312873128831289312903129131292312933129431295312963129731298312993130031301313023130331304313053130631307313083130931310313113131231313313143131531316313173131831319313203132131322313233132431325313263132731328313293133031331313323133331334313353133631337313383133931340313413134231343313443134531346313473134831349313503135131352313533135431355313563135731358313593136031361313623136331364313653136631367313683136931370313713137231373313743137531376313773137831379313803138131382313833138431385313863138731388313893139031391313923139331394313953139631397313983139931400314013140231403314043140531406314073140831409314103141131412314133141431415314163141731418314193142031421314223142331424314253142631427314283142931430314313143231433314343143531436314373143831439314403144131442314433144431445314463144731448314493145031451314523145331454314553145631457314583145931460314613146231463314643146531466314673146831469314703147131472314733147431475314763147731478314793148031481314823148331484314853148631487314883148931490314913149231493314943149531496314973149831499315003150131502315033150431505315063150731508315093151031511315123151331514315153151631517315183151931520315213152231523315243152531526315273152831529315303153131532315333153431535315363153731538315393154031541315423154331544315453154631547315483154931550315513155231553315543155531556315573155831559315603156131562315633156431565315663156731568315693157031571315723157331574315753157631577315783157931580315813158231583315843158531586315873158831589315903159131592315933159431595315963159731598315993160031601316023160331604316053160631607316083160931610316113161231613316143161531616316173161831619316203162131622316233162431625316263162731628316293163031631316323163331634316353163631637316383163931640316413164231643316443164531646316473164831649316503165131652316533165431655316563165731658316593166031661316623166331664316653166631667316683166931670316713167231673316743167531676316773167831679316803168131682316833168431685316863168731688316893169031691316923169331694316953169631697316983169931700317013170231703317043170531706317073170831709317103171131712317133171431715317163171731718317193172031721317223172331724317253172631727317283172931730317313173231733317343173531736317373173831739317403174131742317433174431745317463174731748317493175031751317523175331754317553175631757317583175931760317613176231763317643176531766317673176831769317703177131772317733177431775317763177731778317793178031781317823178331784317853178631787317883178931790317913179231793317943179531796317973179831799318003180131802318033180431805318063180731808318093181031811318123181331814318153181631817318183181931820318213182231823318243182531826318273182831829318303183131832318333183431835318363183731838318393184031841318423184331844318453184631847318483184931850318513185231853318543185531856318573185831859318603186131862318633186431865318663186731868318693187031871318723187331874318753187631877318783187931880318813188231883318843188531886318873188831889318903189131892318933189431895318963189731898318993190031901319023190331904319053190631907319083190931910319113191231913319143191531916319173191831919319203192131922319233192431925319263192731928319293193031931319323193331934319353193631937319383193931940319413194231943319443194531946319473194831949319503195131952319533195431955319563195731958319593196031961319623196331964319653196631967319683196931970319713197231973319743197531976319773197831979319803198131982319833198431985319863198731988319893199031991319923199331994319953199631997319983199932000320013200232003320043200532006320073200832009320103201132012320133201432015320163201732018320193202032021320223202332024320253202632027320283202932030320313203232033320343203532036320373203832039320403204132042320433204432045320463204732048320493205032051320523205332054320553205632057320583205932060320613206232063320643206532066320673206832069320703207132072320733207432075320763207732078320793208032081320823208332084320853208632087320883208932090320913209232093320943209532096320973209832099321003210132102321033210432105321063210732108321093211032111321123211332114321153211632117321183211932120321213212232123321243212532126321273212832129321303213132132321333213432135321363213732138321393214032141321423214332144321453214632147321483214932150321513215232153321543215532156321573215832159321603216132162321633216432165321663216732168321693217032171321723217332174321753217632177321783217932180321813218232183321843218532186321873218832189321903219132192321933219432195321963219732198321993220032201322023220332204322053220632207322083220932210322113221232213322143221532216322173221832219322203222132222322233222432225322263222732228322293223032231322323223332234322353223632237322383223932240322413224232243322443224532246322473224832249322503225132252322533225432255322563225732258322593226032261322623226332264322653226632267322683226932270322713227232273322743227532276322773227832279322803228132282322833228432285322863228732288322893229032291322923229332294322953229632297322983229932300323013230232303323043230532306323073230832309323103231132312323133231432315323163231732318323193232032321323223232332324323253232632327323283232932330323313233232333323343233532336323373233832339323403234132342323433234432345323463234732348323493235032351323523235332354323553235632357323583235932360323613236232363323643236532366323673236832369323703237132372323733237432375323763237732378323793238032381323823238332384323853238632387323883238932390323913239232393323943239532396323973239832399324003240132402324033240432405324063240732408324093241032411324123241332414324153241632417324183241932420324213242232423324243242532426324273242832429324303243132432324333243432435324363243732438324393244032441324423244332444324453244632447324483244932450324513245232453324543245532456324573245832459324603246132462324633246432465324663246732468324693247032471324723247332474324753247632477324783247932480324813248232483324843248532486324873248832489324903249132492324933249432495324963249732498324993250032501325023250332504325053250632507325083250932510325113251232513325143251532516325173251832519325203252132522325233252432525325263252732528325293253032531325323253332534325353253632537325383253932540325413254232543325443254532546325473254832549325503255132552325533255432555325563255732558325593256032561325623256332564325653256632567325683256932570325713257232573325743257532576325773257832579325803258132582325833258432585325863258732588325893259032591325923259332594325953259632597325983259932600326013260232603326043260532606326073260832609326103261132612326133261432615326163261732618326193262032621326223262332624326253262632627326283262932630326313263232633326343263532636326373263832639326403264132642326433264432645326463264732648326493265032651326523265332654326553265632657326583265932660326613266232663326643266532666326673266832669326703267132672326733267432675326763267732678326793268032681326823268332684326853268632687326883268932690326913269232693326943269532696326973269832699327003270132702327033270432705327063270732708327093271032711327123271332714327153271632717327183271932720327213272232723327243272532726327273272832729327303273132732327333273432735327363273732738327393274032741327423274332744327453274632747327483274932750327513275232753327543275532756327573275832759327603276132762327633276432765327663276732768327693277032771327723277332774327753277632777327783277932780327813278232783327843278532786327873278832789327903279132792327933279432795327963279732798327993280032801328023280332804328053280632807328083280932810328113281232813328143281532816328173281832819328203282132822328233282432825328263282732828328293283032831328323283332834328353283632837328383283932840328413284232843328443284532846328473284832849328503285132852328533285432855328563285732858328593286032861328623286332864328653286632867328683286932870328713287232873328743287532876328773287832879328803288132882328833288432885328863288732888328893289032891328923289332894328953289632897328983289932900329013290232903329043290532906329073290832909329103291132912329133291432915329163291732918329193292032921329223292332924329253292632927329283292932930329313293232933329343293532936329373293832939329403294132942329433294432945329463294732948329493295032951329523295332954329553295632957329583295932960329613296232963329643296532966329673296832969329703297132972329733297432975329763297732978329793298032981329823298332984329853298632987329883298932990329913299232993329943299532996329973299832999330003300133002330033300433005330063300733008330093301033011330123301333014330153301633017330183301933020330213302233023330243302533026330273302833029330303303133032330333303433035330363303733038330393304033041330423304333044330453304633047330483304933050330513305233053330543305533056330573305833059330603306133062330633306433065330663306733068330693307033071330723307333074330753307633077330783307933080330813308233083330843308533086330873308833089330903309133092330933309433095330963309733098330993310033101331023310333104331053310633107331083310933110331113311233113331143311533116331173311833119331203312133122331233312433125331263312733128331293313033131331323313333134331353313633137331383313933140331413314233143331443314533146331473314833149331503315133152331533315433155331563315733158331593316033161331623316333164331653316633167331683316933170331713317233173331743317533176331773317833179331803318133182331833318433185331863318733188331893319033191331923319333194331953319633197331983319933200332013320233203332043320533206332073320833209332103321133212332133321433215332163321733218332193322033221332223322333224332253322633227332283322933230332313323233233332343323533236332373323833239332403324133242332433324433245332463324733248332493325033251332523325333254332553325633257332583325933260332613326233263332643326533266332673326833269332703327133272332733327433275332763327733278332793328033281332823328333284332853328633287332883328933290332913329233293332943329533296332973329833299333003330133302333033330433305333063330733308333093331033311333123331333314333153331633317333183331933320333213332233323333243332533326333273332833329333303333133332333333333433335333363333733338333393334033341333423334333344333453334633347333483334933350333513335233353333543335533356333573335833359333603336133362333633336433365333663336733368333693337033371333723337333374333753337633377333783337933380333813338233383333843338533386333873338833389333903339133392333933339433395333963339733398333993340033401334023340333404334053340633407334083340933410334113341233413334143341533416334173341833419334203342133422334233342433425334263342733428334293343033431334323343333434334353343633437334383343933440334413344233443334443344533446334473344833449334503345133452334533345433455334563345733458334593346033461334623346333464334653346633467334683346933470334713347233473334743347533476334773347833479334803348133482334833348433485334863348733488334893349033491334923349333494334953349633497334983349933500335013350233503335043350533506335073350833509335103351133512335133351433515335163351733518335193352033521335223352333524335253352633527335283352933530335313353233533335343353533536335373353833539335403354133542335433354433545335463354733548335493355033551335523355333554335553355633557335583355933560335613356233563335643356533566335673356833569335703357133572335733357433575335763357733578335793358033581335823358333584335853358633587
  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.5">
  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/quay/" class="md-nav__link">
  386. <span class="md-ellipsis">
  387. Quay
  388. </span>
  389. </a>
  390. </li>
  391. <li class="md-nav__item">
  392. <a href="../generator/vault/" class="md-nav__link">
  393. <span class="md-ellipsis">
  394. Vault Dynamic Secret
  395. </span>
  396. </a>
  397. </li>
  398. <li class="md-nav__item">
  399. <a href="../generator/password/" class="md-nav__link">
  400. <span class="md-ellipsis">
  401. Password
  402. </span>
  403. </a>
  404. </li>
  405. <li class="md-nav__item">
  406. <a href="../generator/fake/" class="md-nav__link">
  407. <span class="md-ellipsis">
  408. Fake
  409. </span>
  410. </a>
  411. </li>
  412. <li class="md-nav__item">
  413. <a href="../generator/webhook/" class="md-nav__link">
  414. <span class="md-ellipsis">
  415. Webhook
  416. </span>
  417. </a>
  418. </li>
  419. <li class="md-nav__item">
  420. <a href="../generator/github/" class="md-nav__link">
  421. <span class="md-ellipsis">
  422. Github
  423. </span>
  424. </a>
  425. </li>
  426. <li class="md-nav__item">
  427. <a href="../generator/uuid/" class="md-nav__link">
  428. <span class="md-ellipsis">
  429. UUID
  430. </span>
  431. </a>
  432. </li>
  433. <li class="md-nav__item">
  434. <a href="../generator/mfa/" class="md-nav__link">
  435. <span class="md-ellipsis">
  436. MFA
  437. </span>
  438. </a>
  439. </li>
  440. <li class="md-nav__item">
  441. <a href="../generator/sshkey/" class="md-nav__link">
  442. <span class="md-ellipsis">
  443. SSHKey
  444. </span>
  445. </a>
  446. </li>
  447. </ul>
  448. </nav>
  449. </li>
  450. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  451. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4" checked>
  452. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  453. <span class="md-ellipsis">
  454. Reference Docs
  455. </span>
  456. <span class="md-nav__icon md-icon"></span>
  457. </label>
  458. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="true">
  459. <label class="md-nav__title" for="__nav_2_4">
  460. <span class="md-nav__icon md-icon"></span>
  461. Reference Docs
  462. </label>
  463. <ul class="md-nav__list" data-md-scrollfix>
  464. <li class="md-nav__item md-nav__item--active">
  465. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  466. <a href="./" class="md-nav__link md-nav__link--active">
  467. <span class="md-ellipsis">
  468. API specification
  469. </span>
  470. </a>
  471. </li>
  472. <li class="md-nav__item">
  473. <a href="../controller-options/" class="md-nav__link">
  474. <span class="md-ellipsis">
  475. Controller Options
  476. </span>
  477. </a>
  478. </li>
  479. <li class="md-nav__item">
  480. <a href="../metrics/" class="md-nav__link">
  481. <span class="md-ellipsis">
  482. Metrics
  483. </span>
  484. </a>
  485. </li>
  486. <li class="md-nav__item">
  487. <a href="../selectable-fields/" class="md-nav__link">
  488. <span class="md-ellipsis">
  489. Selectable Fields
  490. </span>
  491. </a>
  492. </li>
  493. </ul>
  494. </nav>
  495. </li>
  496. </ul>
  497. </nav>
  498. </li>
  499. <li class="md-nav__item md-nav__item--nested">
  500. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  501. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  502. <span class="md-ellipsis">
  503. Guides
  504. </span>
  505. <span class="md-nav__icon md-icon"></span>
  506. </label>
  507. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  508. <label class="md-nav__title" for="__nav_3">
  509. <span class="md-nav__icon md-icon"></span>
  510. Guides
  511. </label>
  512. <ul class="md-nav__list" data-md-scrollfix>
  513. <li class="md-nav__item">
  514. <a href="../../guides/introduction/" class="md-nav__link">
  515. <span class="md-ellipsis">
  516. Introduction
  517. </span>
  518. </a>
  519. </li>
  520. <li class="md-nav__item md-nav__item--nested">
  521. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  522. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  523. <span class="md-ellipsis">
  524. External Secrets
  525. </span>
  526. <span class="md-nav__icon md-icon"></span>
  527. </label>
  528. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  529. <label class="md-nav__title" for="__nav_3_2">
  530. <span class="md-nav__icon md-icon"></span>
  531. External Secrets
  532. </label>
  533. <ul class="md-nav__list" data-md-scrollfix>
  534. <li class="md-nav__item">
  535. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  536. <span class="md-ellipsis">
  537. Extract structured data
  538. </span>
  539. </a>
  540. </li>
  541. <li class="md-nav__item">
  542. <a href="../../guides/getallsecrets/" class="md-nav__link">
  543. <span class="md-ellipsis">
  544. Find Secrets by Name or Metadata
  545. </span>
  546. </a>
  547. </li>
  548. <li class="md-nav__item">
  549. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  550. <span class="md-ellipsis">
  551. Rewriting Keys
  552. </span>
  553. </a>
  554. </li>
  555. <li class="md-nav__item md-nav__item--nested">
  556. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  557. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  558. <span class="md-ellipsis">
  559. Advanced Templating
  560. </span>
  561. <span class="md-nav__icon md-icon"></span>
  562. </label>
  563. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  564. <label class="md-nav__title" for="__nav_3_2_4">
  565. <span class="md-nav__icon md-icon"></span>
  566. Advanced Templating
  567. </label>
  568. <ul class="md-nav__list" data-md-scrollfix>
  569. <li class="md-nav__item">
  570. <a href="../../guides/templating/" class="md-nav__link">
  571. <span class="md-ellipsis">
  572. v2
  573. </span>
  574. </a>
  575. </li>
  576. <li class="md-nav__item">
  577. <a href="../../guides/templating-v1/" class="md-nav__link">
  578. <span class="md-ellipsis">
  579. v1
  580. </span>
  581. </a>
  582. </li>
  583. </ul>
  584. </nav>
  585. </li>
  586. <li class="md-nav__item">
  587. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  588. <span class="md-ellipsis">
  589. Kubernetes Secret Types
  590. </span>
  591. </a>
  592. </li>
  593. <li class="md-nav__item">
  594. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  595. <span class="md-ellipsis">
  596. Lifecycle: ownership & deletion
  597. </span>
  598. </a>
  599. </li>
  600. <li class="md-nav__item">
  601. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  602. <span class="md-ellipsis">
  603. Decoding Strategies
  604. </span>
  605. </a>
  606. </li>
  607. <li class="md-nav__item">
  608. <a href="../../guides/controller-class/" class="md-nav__link">
  609. <span class="md-ellipsis">
  610. Controller Classes
  611. </span>
  612. </a>
  613. </li>
  614. </ul>
  615. </nav>
  616. </li>
  617. <li class="md-nav__item">
  618. <a href="../../guides/targeting-custom-resources/" class="md-nav__link">
  619. <span class="md-ellipsis">
  620. Targeting Custom Resources
  621. </span>
  622. </a>
  623. </li>
  624. <li class="md-nav__item">
  625. <a href="../../guides/generator/" class="md-nav__link">
  626. <span class="md-ellipsis">
  627. Generators
  628. </span>
  629. </a>
  630. </li>
  631. <li class="md-nav__item">
  632. <a href="../../guides/pushsecrets/" class="md-nav__link">
  633. <span class="md-ellipsis">
  634. Push Secrets
  635. </span>
  636. </a>
  637. </li>
  638. <li class="md-nav__item md-nav__item--nested">
  639. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_6" >
  640. <label class="md-nav__link" for="__nav_3_6" id="__nav_3_6_label" tabindex="0">
  641. <span class="md-ellipsis">
  642. Operations
  643. </span>
  644. <span class="md-nav__icon md-icon"></span>
  645. </label>
  646. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_6_label" aria-expanded="false">
  647. <label class="md-nav__title" for="__nav_3_6">
  648. <span class="md-nav__icon md-icon"></span>
  649. Operations
  650. </label>
  651. <ul class="md-nav__list" data-md-scrollfix>
  652. <li class="md-nav__item">
  653. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  654. <span class="md-ellipsis">
  655. Multi Tenancy
  656. </span>
  657. </a>
  658. </li>
  659. <li class="md-nav__item">
  660. <a href="../../guides/security-best-practices/" class="md-nav__link">
  661. <span class="md-ellipsis">
  662. Security Best Practices
  663. </span>
  664. </a>
  665. </li>
  666. <li class="md-nav__item">
  667. <a href="../../guides/threat-model/" class="md-nav__link">
  668. <span class="md-ellipsis">
  669. Threat Model
  670. </span>
  671. </a>
  672. </li>
  673. <li class="md-nav__item">
  674. <a href="../../guides/v1beta1/" class="md-nav__link">
  675. <span class="md-ellipsis">
  676. Upgrading to v1beta1
  677. </span>
  678. </a>
  679. </li>
  680. <li class="md-nav__item">
  681. <a href="../../guides/using-latest-image/" class="md-nav__link">
  682. <span class="md-ellipsis">
  683. Using Latest Image
  684. </span>
  685. </a>
  686. </li>
  687. <li class="md-nav__item">
  688. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  689. <span class="md-ellipsis">
  690. Disable Cluster Features
  691. </span>
  692. </a>
  693. </li>
  694. </ul>
  695. </nav>
  696. </li>
  697. <li class="md-nav__item md-nav__item--nested">
  698. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_7" >
  699. <label class="md-nav__link" for="__nav_3_7" id="__nav_3_7_label" tabindex="0">
  700. <span class="md-ellipsis">
  701. Tooling
  702. </span>
  703. <span class="md-nav__icon md-icon"></span>
  704. </label>
  705. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_7_label" aria-expanded="false">
  706. <label class="md-nav__title" for="__nav_3_7">
  707. <span class="md-nav__icon md-icon"></span>
  708. Tooling
  709. </label>
  710. <ul class="md-nav__list" data-md-scrollfix>
  711. <li class="md-nav__item">
  712. <a href="../../guides/using-esoctl-tool/" class="md-nav__link">
  713. <span class="md-ellipsis">
  714. Using the esoctl tool
  715. </span>
  716. </a>
  717. </li>
  718. </ul>
  719. </nav>
  720. </li>
  721. </ul>
  722. </nav>
  723. </li>
  724. <li class="md-nav__item md-nav__item--nested">
  725. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
  726. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  727. <span class="md-ellipsis">
  728. Provider
  729. </span>
  730. <span class="md-nav__icon md-icon"></span>
  731. </label>
  732. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  733. <label class="md-nav__title" for="__nav_4">
  734. <span class="md-nav__icon md-icon"></span>
  735. Provider
  736. </label>
  737. <ul class="md-nav__list" data-md-scrollfix>
  738. <li class="md-nav__item">
  739. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  740. <span class="md-ellipsis">
  741. AWS Secrets Manager
  742. </span>
  743. </a>
  744. </li>
  745. <li class="md-nav__item">
  746. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  747. <span class="md-ellipsis">
  748. AWS Parameter Store
  749. </span>
  750. </a>
  751. </li>
  752. <li class="md-nav__item">
  753. <a href="../../provider/aws-access/" class="md-nav__link">
  754. <span class="md-ellipsis">
  755. AWS Access
  756. </span>
  757. </a>
  758. </li>
  759. <li class="md-nav__item">
  760. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  761. <span class="md-ellipsis">
  762. Azure Key Vault
  763. </span>
  764. </a>
  765. </li>
  766. <li class="md-nav__item">
  767. <a href="../../provider/barbican/" class="md-nav__link">
  768. <span class="md-ellipsis">
  769. Barbican
  770. </span>
  771. </a>
  772. </li>
  773. <li class="md-nav__item">
  774. <a href="../../provider/beyondtrust/" class="md-nav__link">
  775. <span class="md-ellipsis">
  776. BeyondTrust
  777. </span>
  778. </a>
  779. </li>
  780. <li class="md-nav__item">
  781. <a href="../../provider/bitwarden-secrets-manager/" class="md-nav__link">
  782. <span class="md-ellipsis">
  783. Bitwarden Secrets Manager
  784. </span>
  785. </a>
  786. </li>
  787. <li class="md-nav__item">
  788. <a href="../../provider/chef/" class="md-nav__link">
  789. <span class="md-ellipsis">
  790. Chef
  791. </span>
  792. </a>
  793. </li>
  794. <li class="md-nav__item">
  795. <a href="../../provider/cloudru/" class="md-nav__link">
  796. <span class="md-ellipsis">
  797. Cloud.ru Secret Manager
  798. </span>
  799. </a>
  800. </li>
  801. <li class="md-nav__item">
  802. <a href="../../provider/conjur/" class="md-nav__link">
  803. <span class="md-ellipsis">
  804. CyberArk Conjur
  805. </span>
  806. </a>
  807. </li>
  808. <li class="md-nav__item">
  809. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  810. <span class="md-ellipsis">
  811. Google Cloud Secret Manager
  812. </span>
  813. </a>
  814. </li>
  815. <li class="md-nav__item">
  816. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  817. <span class="md-ellipsis">
  818. HashiCorp Vault
  819. </span>
  820. </a>
  821. </li>
  822. <li class="md-nav__item">
  823. <a href="../../provider/kubernetes/" class="md-nav__link">
  824. <span class="md-ellipsis">
  825. Kubernetes
  826. </span>
  827. </a>
  828. </li>
  829. <li class="md-nav__item">
  830. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  831. <span class="md-ellipsis">
  832. IBM Secrets Manager
  833. </span>
  834. </a>
  835. </li>
  836. <li class="md-nav__item">
  837. <a href="../../provider/akeyless/" class="md-nav__link">
  838. <span class="md-ellipsis">
  839. Akeyless
  840. </span>
  841. </a>
  842. </li>
  843. <li class="md-nav__item">
  844. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  845. <span class="md-ellipsis">
  846. Yandex Certificate Manager
  847. </span>
  848. </a>
  849. </li>
  850. <li class="md-nav__item">
  851. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  852. <span class="md-ellipsis">
  853. Yandex Lockbox
  854. </span>
  855. </a>
  856. </li>
  857. <li class="md-nav__item">
  858. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  859. <span class="md-ellipsis">
  860. GitLab Variables
  861. </span>
  862. </a>
  863. </li>
  864. <li class="md-nav__item">
  865. <a href="../../provider/github/" class="md-nav__link">
  866. <span class="md-ellipsis">
  867. Github Actions Secrets
  868. </span>
  869. </a>
  870. </li>
  871. <li class="md-nav__item">
  872. <a href="../../provider/oracle-vault/" class="md-nav__link">
  873. <span class="md-ellipsis">
  874. Oracle Vault
  875. </span>
  876. </a>
  877. </li>
  878. <li class="md-nav__item">
  879. <a href="../../provider/1password-automation/" class="md-nav__link">
  880. <span class="md-ellipsis">
  881. 1Password Connect Server
  882. </span>
  883. </a>
  884. </li>
  885. <li class="md-nav__item">
  886. <a href="../../provider/1password-sdk/" class="md-nav__link">
  887. <span class="md-ellipsis">
  888. 1Password SDK
  889. </span>
  890. </a>
  891. </li>
  892. <li class="md-nav__item">
  893. <a href="../../provider/webhook/" class="md-nav__link">
  894. <span class="md-ellipsis">
  895. Webhook
  896. </span>
  897. </a>
  898. </li>
  899. <li class="md-nav__item">
  900. <a href="../../provider/fake/" class="md-nav__link">
  901. <span class="md-ellipsis">
  902. Fake
  903. </span>
  904. </a>
  905. </li>
  906. <li class="md-nav__item">
  907. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  908. <span class="md-ellipsis">
  909. senhasegura DevOps Secrets Management (DSM)
  910. </span>
  911. </a>
  912. </li>
  913. <li class="md-nav__item">
  914. <a href="../../provider/doppler/" class="md-nav__link">
  915. <span class="md-ellipsis">
  916. Doppler
  917. </span>
  918. </a>
  919. </li>
  920. <li class="md-nav__item">
  921. <a href="../../provider/keeper-security/" class="md-nav__link">
  922. <span class="md-ellipsis">
  923. Keeper Security
  924. </span>
  925. </a>
  926. </li>
  927. <li class="md-nav__item">
  928. <a href="../../provider/cloak/" class="md-nav__link">
  929. <span class="md-ellipsis">
  930. Cloak End 2 End Encrypted Secrets
  931. </span>
  932. </a>
  933. </li>
  934. <li class="md-nav__item">
  935. <a href="../../provider/scaleway/" class="md-nav__link">
  936. <span class="md-ellipsis">
  937. Scaleway
  938. </span>
  939. </a>
  940. </li>
  941. <li class="md-nav__item">
  942. <a href="../../provider/delinea/" class="md-nav__link">
  943. <span class="md-ellipsis">
  944. Delinea
  945. </span>
  946. </a>
  947. </li>
  948. <li class="md-nav__item">
  949. <a href="../../provider/secretserver/" class="md-nav__link">
  950. <span class="md-ellipsis">
  951. Secret Server
  952. </span>
  953. </a>
  954. </li>
  955. <li class="md-nav__item">
  956. <a href="../../provider/passbolt/" class="md-nav__link">
  957. <span class="md-ellipsis">
  958. Passbolt
  959. </span>
  960. </a>
  961. </li>
  962. <li class="md-nav__item">
  963. <a href="../../provider/pulumi/" class="md-nav__link">
  964. <span class="md-ellipsis">
  965. Pulumi ESC
  966. </span>
  967. </a>
  968. </li>
  969. <li class="md-nav__item">
  970. <a href="../../provider/onboardbase/" class="md-nav__link">
  971. <span class="md-ellipsis">
  972. Onboardbase
  973. </span>
  974. </a>
  975. </li>
  976. <li class="md-nav__item">
  977. <a href="../../provider-passworddepot/" class="md-nav__link">
  978. <span class="md-ellipsis">
  979. Password Depot
  980. </span>
  981. </a>
  982. </li>
  983. <li class="md-nav__item">
  984. <a href="../../provider/fortanix/" class="md-nav__link">
  985. <span class="md-ellipsis">
  986. Fortanix
  987. </span>
  988. </a>
  989. </li>
  990. <li class="md-nav__item">
  991. <a href="../../provider/infisical/" class="md-nav__link">
  992. <span class="md-ellipsis">
  993. Infisical
  994. </span>
  995. </a>
  996. </li>
  997. <li class="md-nav__item">
  998. <a href="../../provider/previder/" class="md-nav__link">
  999. <span class="md-ellipsis">
  1000. Previder
  1001. </span>
  1002. </a>
  1003. </li>
  1004. <li class="md-nav__item">
  1005. <a href="../../provider/openbao/" class="md-nav__link">
  1006. <span class="md-ellipsis">
  1007. OpenBao
  1008. </span>
  1009. </a>
  1010. </li>
  1011. <li class="md-nav__item">
  1012. <a href="../../provider/volcengine/" class="md-nav__link">
  1013. <span class="md-ellipsis">
  1014. Volcengine
  1015. </span>
  1016. </a>
  1017. </li>
  1018. <li class="md-nav__item">
  1019. <a href="../../provider/ngrok/" class="md-nav__link">
  1020. <span class="md-ellipsis">
  1021. ngrok
  1022. </span>
  1023. </a>
  1024. </li>
  1025. <li class="md-nav__item">
  1026. <a href="../../provider/devolutions-server/" class="md-nav__link">
  1027. <span class="md-ellipsis">
  1028. Devolutions Server
  1029. </span>
  1030. </a>
  1031. </li>
  1032. <li class="md-nav__item">
  1033. <a href="../../provider/nebius-mysterybox/" class="md-nav__link">
  1034. <span class="md-ellipsis">
  1035. Nebius MysteryBox
  1036. </span>
  1037. </a>
  1038. </li>
  1039. </ul>
  1040. </nav>
  1041. </li>
  1042. <li class="md-nav__item md-nav__item--nested">
  1043. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  1044. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  1045. <span class="md-ellipsis">
  1046. Examples
  1047. </span>
  1048. <span class="md-nav__icon md-icon"></span>
  1049. </label>
  1050. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  1051. <label class="md-nav__title" for="__nav_5">
  1052. <span class="md-nav__icon md-icon"></span>
  1053. Examples
  1054. </label>
  1055. <ul class="md-nav__list" data-md-scrollfix>
  1056. <li class="md-nav__item">
  1057. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  1058. <span class="md-ellipsis">
  1059. FluxCD
  1060. </span>
  1061. </a>
  1062. </li>
  1063. <li class="md-nav__item">
  1064. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  1065. <span class="md-ellipsis">
  1066. Anchore Engine
  1067. </span>
  1068. </a>
  1069. </li>
  1070. <li class="md-nav__item">
  1071. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  1072. <span class="md-ellipsis">
  1073. Jenkins
  1074. </span>
  1075. </a>
  1076. </li>
  1077. <li class="md-nav__item">
  1078. <a href="../../examples/bitwarden/" class="md-nav__link">
  1079. <span class="md-ellipsis">
  1080. Bitwarden
  1081. </span>
  1082. </a>
  1083. </li>
  1084. </ul>
  1085. </nav>
  1086. </li>
  1087. <li class="md-nav__item md-nav__item--nested">
  1088. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  1089. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  1090. <span class="md-ellipsis">
  1091. Community
  1092. </span>
  1093. <span class="md-nav__icon md-icon"></span>
  1094. </label>
  1095. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  1096. <label class="md-nav__title" for="__nav_6">
  1097. <span class="md-nav__icon md-icon"></span>
  1098. Community
  1099. </label>
  1100. <ul class="md-nav__list" data-md-scrollfix>
  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_1" >
  1103. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  1104. <span class="md-ellipsis">
  1105. Contributing
  1106. </span>
  1107. <span class="md-nav__icon md-icon"></span>
  1108. </label>
  1109. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  1110. <label class="md-nav__title" for="__nav_6_1">
  1111. <span class="md-nav__icon md-icon"></span>
  1112. Contributing
  1113. </label>
  1114. <ul class="md-nav__list" data-md-scrollfix>
  1115. <li class="md-nav__item">
  1116. <a href="../../contributing/devguide/" class="md-nav__link">
  1117. <span class="md-ellipsis">
  1118. Developer guide
  1119. </span>
  1120. </a>
  1121. </li>
  1122. <li class="md-nav__item">
  1123. <a href="../../contributing/process/" class="md-nav__link">
  1124. <span class="md-ellipsis">
  1125. Contributing Process
  1126. </span>
  1127. </a>
  1128. </li>
  1129. <li class="md-nav__item">
  1130. <a href="../../contributing/release/" class="md-nav__link">
  1131. <span class="md-ellipsis">
  1132. Release Process
  1133. </span>
  1134. </a>
  1135. </li>
  1136. <li class="md-nav__item">
  1137. <a href="../../contributing/coc/" class="md-nav__link">
  1138. <span class="md-ellipsis">
  1139. Code of Conduct
  1140. </span>
  1141. </a>
  1142. </li>
  1143. <li class="md-nav__item">
  1144. <a href="../../contributing/calendar/" class="md-nav__link">
  1145. <span class="md-ellipsis">
  1146. Community meetings calendar
  1147. </span>
  1148. </a>
  1149. </li>
  1150. <li class="md-nav__item">
  1151. <a href="../../contributing/roadmap/" class="md-nav__link">
  1152. <span class="md-ellipsis">
  1153. Roadmap
  1154. </span>
  1155. </a>
  1156. </li>
  1157. <li class="md-nav__item">
  1158. <a href="../../contributing/burnout-mitigation/" class="md-nav__link">
  1159. <span class="md-ellipsis">
  1160. Burnout Prevention
  1161. </span>
  1162. </a>
  1163. </li>
  1164. <li class="md-nav__item">
  1165. <a href="../../contributing/llm-policy/" class="md-nav__link">
  1166. <span class="md-ellipsis">
  1167. LLM Policy
  1168. </span>
  1169. </a>
  1170. </li>
  1171. </ul>
  1172. </nav>
  1173. </li>
  1174. <li class="md-nav__item md-nav__item--nested">
  1175. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1176. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1177. <span class="md-ellipsis">
  1178. External Resources
  1179. </span>
  1180. <span class="md-nav__icon md-icon"></span>
  1181. </label>
  1182. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1183. <label class="md-nav__title" for="__nav_6_2">
  1184. <span class="md-nav__icon md-icon"></span>
  1185. External Resources
  1186. </label>
  1187. <ul class="md-nav__list" data-md-scrollfix>
  1188. <li class="md-nav__item">
  1189. <a href="../../eso-talks/" class="md-nav__link">
  1190. <span class="md-ellipsis">
  1191. Talks
  1192. </span>
  1193. </a>
  1194. </li>
  1195. <li class="md-nav__item">
  1196. <a href="../../eso-demos/" class="md-nav__link">
  1197. <span class="md-ellipsis">
  1198. Demos
  1199. </span>
  1200. </a>
  1201. </li>
  1202. <li class="md-nav__item">
  1203. <a href="../../eso-blogs/" class="md-nav__link">
  1204. <span class="md-ellipsis">
  1205. Blogs
  1206. </span>
  1207. </a>
  1208. </li>
  1209. <li class="md-nav__item">
  1210. <a href="../../eso-tools/" class="md-nav__link">
  1211. <span class="md-ellipsis">
  1212. Tools
  1213. </span>
  1214. </a>
  1215. </li>
  1216. </ul>
  1217. </nav>
  1218. </li>
  1219. </ul>
  1220. </nav>
  1221. </li>
  1222. </ul>
  1223. </nav>
  1224. </div>
  1225. </div>
  1226. </div>
  1227. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1228. <div class="md-sidebar__scrollwrap">
  1229. <div class="md-sidebar__inner">
  1230. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1231. </nav>
  1232. </div>
  1233. </div>
  1234. </div>
  1235. <div class="md-content" data-md-component="content">
  1236. <article class="md-content__inner md-typeset">
  1237. <h1>API specification</h1>
  1238. <p>Packages:</p>
  1239. <ul>
  1240. <li>
  1241. <a href="#external-secrets.io%2fv1">external-secrets.io/v1</a>
  1242. </li>
  1243. <li>
  1244. <a href="#external-secrets.io%2fv1alpha1">external-secrets.io/v1alpha1</a>
  1245. </li>
  1246. <li>
  1247. <a href="#external-secrets.io%2fv1beta1">external-secrets.io/v1beta1</a>
  1248. </li>
  1249. <li>
  1250. <a href="#generators.external-secrets.io%2fv1alpha1">generators.external-secrets.io/v1alpha1</a>
  1251. </li>
  1252. </ul>
  1253. <h2 id="external-secrets.io/v1">external-secrets.io/v1</h2>
  1254. <p>
  1255. <p>Package v1 contains resources for external-secrets</p>
  1256. </p>
  1257. <p>Resource Types:</p>
  1258. <ul></ul>
  1259. <h3 id="external-secrets.io/v1.AWSAuth">AWSAuth
  1260. </h3>
  1261. <p>
  1262. (<em>Appears on:</em>
  1263. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1264. </p>
  1265. <p>
  1266. <p>AWSAuth tells the controller how to do authentication with aws.
  1267. Only one of secretRef or jwt can be specified.
  1268. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  1269. </p>
  1270. <table>
  1271. <thead>
  1272. <tr>
  1273. <th>Field</th>
  1274. <th>Description</th>
  1275. </tr>
  1276. </thead>
  1277. <tbody>
  1278. <tr>
  1279. <td>
  1280. <code>secretRef</code></br>
  1281. <em>
  1282. <a href="#external-secrets.io/v1.AWSAuthSecretRef">
  1283. AWSAuthSecretRef
  1284. </a>
  1285. </em>
  1286. </td>
  1287. <td>
  1288. <em>(Optional)</em>
  1289. </td>
  1290. </tr>
  1291. <tr>
  1292. <td>
  1293. <code>jwt</code></br>
  1294. <em>
  1295. <a href="#external-secrets.io/v1.AWSJWTAuth">
  1296. AWSJWTAuth
  1297. </a>
  1298. </em>
  1299. </td>
  1300. <td>
  1301. <em>(Optional)</em>
  1302. </td>
  1303. </tr>
  1304. </tbody>
  1305. </table>
  1306. <h3 id="external-secrets.io/v1.AWSAuthSecretRef">AWSAuthSecretRef
  1307. </h3>
  1308. <p>
  1309. (<em>Appears on:</em>
  1310. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1311. </p>
  1312. <p>
  1313. <p>AWSAuthSecretRef holds secret references for AWS credentials
  1314. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  1315. </p>
  1316. <table>
  1317. <thead>
  1318. <tr>
  1319. <th>Field</th>
  1320. <th>Description</th>
  1321. </tr>
  1322. </thead>
  1323. <tbody>
  1324. <tr>
  1325. <td>
  1326. <code>accessKeyIDSecretRef</code></br>
  1327. <em>
  1328. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1329. External Secrets meta/v1.SecretKeySelector
  1330. </a>
  1331. </em>
  1332. </td>
  1333. <td>
  1334. <p>The AccessKeyID is used for authentication</p>
  1335. </td>
  1336. </tr>
  1337. <tr>
  1338. <td>
  1339. <code>secretAccessKeySecretRef</code></br>
  1340. <em>
  1341. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1342. External Secrets meta/v1.SecretKeySelector
  1343. </a>
  1344. </em>
  1345. </td>
  1346. <td>
  1347. <p>The SecretAccessKey is used for authentication</p>
  1348. </td>
  1349. </tr>
  1350. <tr>
  1351. <td>
  1352. <code>sessionTokenSecretRef</code></br>
  1353. <em>
  1354. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1355. External Secrets meta/v1.SecretKeySelector
  1356. </a>
  1357. </em>
  1358. </td>
  1359. <td>
  1360. <p>The SessionToken used for authentication
  1361. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  1362. 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>
  1363. </td>
  1364. </tr>
  1365. </tbody>
  1366. </table>
  1367. <h3 id="external-secrets.io/v1.AWSJWTAuth">AWSJWTAuth
  1368. </h3>
  1369. <p>
  1370. (<em>Appears on:</em>
  1371. <a href="#external-secrets.io/v1.AWSAuth">AWSAuth</a>)
  1372. </p>
  1373. <p>
  1374. <p>AWSJWTAuth stores reference to Authenticate against AWS using service account tokens.</p>
  1375. </p>
  1376. <table>
  1377. <thead>
  1378. <tr>
  1379. <th>Field</th>
  1380. <th>Description</th>
  1381. </tr>
  1382. </thead>
  1383. <tbody>
  1384. <tr>
  1385. <td>
  1386. <code>serviceAccountRef</code></br>
  1387. <em>
  1388. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1389. External Secrets meta/v1.ServiceAccountSelector
  1390. </a>
  1391. </em>
  1392. </td>
  1393. <td>
  1394. </td>
  1395. </tr>
  1396. </tbody>
  1397. </table>
  1398. <h3 id="external-secrets.io/v1.AWSProvider">AWSProvider
  1399. </h3>
  1400. <p>
  1401. (<em>Appears on:</em>
  1402. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1403. </p>
  1404. <p>
  1405. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  1406. </p>
  1407. <table>
  1408. <thead>
  1409. <tr>
  1410. <th>Field</th>
  1411. <th>Description</th>
  1412. </tr>
  1413. </thead>
  1414. <tbody>
  1415. <tr>
  1416. <td>
  1417. <code>service</code></br>
  1418. <em>
  1419. <a href="#external-secrets.io/v1.AWSServiceType">
  1420. AWSServiceType
  1421. </a>
  1422. </em>
  1423. </td>
  1424. <td>
  1425. <p>Service defines which service should be used to fetch the secrets</p>
  1426. </td>
  1427. </tr>
  1428. <tr>
  1429. <td>
  1430. <code>auth</code></br>
  1431. <em>
  1432. <a href="#external-secrets.io/v1.AWSAuth">
  1433. AWSAuth
  1434. </a>
  1435. </em>
  1436. </td>
  1437. <td>
  1438. <em>(Optional)</em>
  1439. <p>Auth defines the information necessary to authenticate against AWS
  1440. if not set aws sdk will infer credentials from your environment
  1441. 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>
  1442. </td>
  1443. </tr>
  1444. <tr>
  1445. <td>
  1446. <code>role</code></br>
  1447. <em>
  1448. string
  1449. </em>
  1450. </td>
  1451. <td>
  1452. <em>(Optional)</em>
  1453. <p>Role is a Role ARN which the provider will assume</p>
  1454. </td>
  1455. </tr>
  1456. <tr>
  1457. <td>
  1458. <code>region</code></br>
  1459. <em>
  1460. string
  1461. </em>
  1462. </td>
  1463. <td>
  1464. <p>AWS Region to be used for the provider</p>
  1465. </td>
  1466. </tr>
  1467. <tr>
  1468. <td>
  1469. <code>additionalRoles</code></br>
  1470. <em>
  1471. []string
  1472. </em>
  1473. </td>
  1474. <td>
  1475. <em>(Optional)</em>
  1476. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  1477. </td>
  1478. </tr>
  1479. <tr>
  1480. <td>
  1481. <code>externalID</code></br>
  1482. <em>
  1483. string
  1484. </em>
  1485. </td>
  1486. <td>
  1487. <p>AWS External ID set on assumed IAM roles</p>
  1488. </td>
  1489. </tr>
  1490. <tr>
  1491. <td>
  1492. <code>sessionTags</code></br>
  1493. <em>
  1494. <a href="#external-secrets.io/v1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag">
  1495. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1.Tag
  1496. </a>
  1497. </em>
  1498. </td>
  1499. <td>
  1500. <em>(Optional)</em>
  1501. <p>AWS STS assume role session tags</p>
  1502. </td>
  1503. </tr>
  1504. <tr>
  1505. <td>
  1506. <code>secretsManager</code></br>
  1507. <em>
  1508. <a href="#external-secrets.io/v1.SecretsManager">
  1509. SecretsManager
  1510. </a>
  1511. </em>
  1512. </td>
  1513. <td>
  1514. <em>(Optional)</em>
  1515. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  1516. </td>
  1517. </tr>
  1518. <tr>
  1519. <td>
  1520. <code>transitiveTagKeys</code></br>
  1521. <em>
  1522. []string
  1523. </em>
  1524. </td>
  1525. <td>
  1526. <em>(Optional)</em>
  1527. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  1528. </td>
  1529. </tr>
  1530. <tr>
  1531. <td>
  1532. <code>prefix</code></br>
  1533. <em>
  1534. string
  1535. </em>
  1536. </td>
  1537. <td>
  1538. <em>(Optional)</em>
  1539. <p>Prefix adds a prefix to all retrieved values.</p>
  1540. </td>
  1541. </tr>
  1542. </tbody>
  1543. </table>
  1544. <h3 id="external-secrets.io/v1.AWSServiceType">AWSServiceType
  1545. (<code>string</code> alias)</p></h3>
  1546. <p>
  1547. (<em>Appears on:</em>
  1548. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  1549. </p>
  1550. <p>
  1551. <p>AWSServiceType is a enum that defines the service/API that is used to fetch the secrets.</p>
  1552. </p>
  1553. <table>
  1554. <thead>
  1555. <tr>
  1556. <th>Value</th>
  1557. <th>Description</th>
  1558. </tr>
  1559. </thead>
  1560. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  1561. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  1562. 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>
  1563. </td>
  1564. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  1565. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  1566. 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>
  1567. </td>
  1568. </tr></tbody>
  1569. </table>
  1570. <h3 id="external-secrets.io/v1.AkeylessAuth">AkeylessAuth
  1571. </h3>
  1572. <p>
  1573. (<em>Appears on:</em>
  1574. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>)
  1575. </p>
  1576. <p>
  1577. <p>AkeylessAuth configures how the operator authenticates with Akeyless.</p>
  1578. </p>
  1579. <table>
  1580. <thead>
  1581. <tr>
  1582. <th>Field</th>
  1583. <th>Description</th>
  1584. </tr>
  1585. </thead>
  1586. <tbody>
  1587. <tr>
  1588. <td>
  1589. <code>secretRef</code></br>
  1590. <em>
  1591. <a href="#external-secrets.io/v1.AkeylessAuthSecretRef">
  1592. AkeylessAuthSecretRef
  1593. </a>
  1594. </em>
  1595. </td>
  1596. <td>
  1597. <em>(Optional)</em>
  1598. <p>Reference to a Secret that contains the details
  1599. to authenticate with Akeyless.</p>
  1600. </td>
  1601. </tr>
  1602. <tr>
  1603. <td>
  1604. <code>kubernetesAuth</code></br>
  1605. <em>
  1606. <a href="#external-secrets.io/v1.AkeylessKubernetesAuth">
  1607. AkeylessKubernetesAuth
  1608. </a>
  1609. </em>
  1610. </td>
  1611. <td>
  1612. <em>(Optional)</em>
  1613. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  1614. token stored in the named Secret resource.</p>
  1615. </td>
  1616. </tr>
  1617. </tbody>
  1618. </table>
  1619. <h3 id="external-secrets.io/v1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  1620. </h3>
  1621. <p>
  1622. (<em>Appears on:</em>
  1623. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1624. </p>
  1625. <p>
  1626. <p>AkeylessAuthSecretRef references a Secret that contains the details
  1627. to authenticate with Akeyless.
  1628. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</p>
  1629. </p>
  1630. <table>
  1631. <thead>
  1632. <tr>
  1633. <th>Field</th>
  1634. <th>Description</th>
  1635. </tr>
  1636. </thead>
  1637. <tbody>
  1638. <tr>
  1639. <td>
  1640. <code>accessID</code></br>
  1641. <em>
  1642. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1643. External Secrets meta/v1.SecretKeySelector
  1644. </a>
  1645. </em>
  1646. </td>
  1647. <td>
  1648. <p>The SecretAccessID is used for authentication</p>
  1649. </td>
  1650. </tr>
  1651. <tr>
  1652. <td>
  1653. <code>accessType</code></br>
  1654. <em>
  1655. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1656. External Secrets meta/v1.SecretKeySelector
  1657. </a>
  1658. </em>
  1659. </td>
  1660. <td>
  1661. </td>
  1662. </tr>
  1663. <tr>
  1664. <td>
  1665. <code>accessTypeParam</code></br>
  1666. <em>
  1667. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1668. External Secrets meta/v1.SecretKeySelector
  1669. </a>
  1670. </em>
  1671. </td>
  1672. <td>
  1673. </td>
  1674. </tr>
  1675. </tbody>
  1676. </table>
  1677. <h3 id="external-secrets.io/v1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  1678. </h3>
  1679. <p>
  1680. (<em>Appears on:</em>
  1681. <a href="#external-secrets.io/v1.AkeylessAuth">AkeylessAuth</a>)
  1682. </p>
  1683. <p>
  1684. <p>AkeylessKubernetesAuth configures Kubernetes authentication with Akeyless.
  1685. It authenticates with Kubernetes ServiceAccount token stored.</p>
  1686. </p>
  1687. <table>
  1688. <thead>
  1689. <tr>
  1690. <th>Field</th>
  1691. <th>Description</th>
  1692. </tr>
  1693. </thead>
  1694. <tbody>
  1695. <tr>
  1696. <td>
  1697. <code>accessID</code></br>
  1698. <em>
  1699. string
  1700. </em>
  1701. </td>
  1702. <td>
  1703. <p>the Akeyless Kubernetes auth-method access-id</p>
  1704. </td>
  1705. </tr>
  1706. <tr>
  1707. <td>
  1708. <code>k8sConfName</code></br>
  1709. <em>
  1710. string
  1711. </em>
  1712. </td>
  1713. <td>
  1714. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  1715. </td>
  1716. </tr>
  1717. <tr>
  1718. <td>
  1719. <code>serviceAccountRef</code></br>
  1720. <em>
  1721. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  1722. External Secrets meta/v1.ServiceAccountSelector
  1723. </a>
  1724. </em>
  1725. </td>
  1726. <td>
  1727. <em>(Optional)</em>
  1728. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  1729. If the service account is specified, the service account secret token JWT will be used
  1730. for authenticating with Akeyless. If the service account selector is not supplied,
  1731. the secretRef will be used instead.</p>
  1732. </td>
  1733. </tr>
  1734. <tr>
  1735. <td>
  1736. <code>secretRef</code></br>
  1737. <em>
  1738. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1739. External Secrets meta/v1.SecretKeySelector
  1740. </a>
  1741. </em>
  1742. </td>
  1743. <td>
  1744. <em>(Optional)</em>
  1745. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  1746. for authenticating with Akeyless. If a name is specified without a key,
  1747. <code>token</code> is the default. If one is not specified, the one bound to
  1748. the controller will be used.</p>
  1749. </td>
  1750. </tr>
  1751. </tbody>
  1752. </table>
  1753. <h3 id="external-secrets.io/v1.AkeylessProvider">AkeylessProvider
  1754. </h3>
  1755. <p>
  1756. (<em>Appears on:</em>
  1757. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  1758. </p>
  1759. <p>
  1760. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  1761. </p>
  1762. <table>
  1763. <thead>
  1764. <tr>
  1765. <th>Field</th>
  1766. <th>Description</th>
  1767. </tr>
  1768. </thead>
  1769. <tbody>
  1770. <tr>
  1771. <td>
  1772. <code>akeylessGWApiURL</code></br>
  1773. <em>
  1774. string
  1775. </em>
  1776. </td>
  1777. <td>
  1778. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  1779. </td>
  1780. </tr>
  1781. <tr>
  1782. <td>
  1783. <code>authSecretRef</code></br>
  1784. <em>
  1785. <a href="#external-secrets.io/v1.AkeylessAuth">
  1786. AkeylessAuth
  1787. </a>
  1788. </em>
  1789. </td>
  1790. <td>
  1791. <p>Auth configures how the operator authenticates with Akeyless.</p>
  1792. </td>
  1793. </tr>
  1794. <tr>
  1795. <td>
  1796. <code>caBundle</code></br>
  1797. <em>
  1798. []byte
  1799. </em>
  1800. </td>
  1801. <td>
  1802. <em>(Optional)</em>
  1803. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  1804. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  1805. are used to validate the TLS connection.</p>
  1806. </td>
  1807. </tr>
  1808. <tr>
  1809. <td>
  1810. <code>caProvider</code></br>
  1811. <em>
  1812. <a href="#external-secrets.io/v1.CAProvider">
  1813. CAProvider
  1814. </a>
  1815. </em>
  1816. </td>
  1817. <td>
  1818. <em>(Optional)</em>
  1819. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  1820. </td>
  1821. </tr>
  1822. </tbody>
  1823. </table>
  1824. <h3 id="external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol
  1825. </h3>
  1826. <p>
  1827. (<em>Appears on:</em>
  1828. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  1829. </p>
  1830. <p>
  1831. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  1832. </p>
  1833. <table>
  1834. <thead>
  1835. <tr>
  1836. <th>Field</th>
  1837. <th>Description</th>
  1838. </tr>
  1839. </thead>
  1840. <tbody>
  1841. <tr>
  1842. <td>
  1843. <code>ntlm</code></br>
  1844. <em>
  1845. <a href="#external-secrets.io/v1.NTLMProtocol">
  1846. NTLMProtocol
  1847. </a>
  1848. </em>
  1849. </td>
  1850. <td>
  1851. <em>(Optional)</em>
  1852. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  1853. </td>
  1854. </tr>
  1855. </tbody>
  1856. </table>
  1857. <h3 id="external-secrets.io/v1.AwsAuthCredentials">AwsAuthCredentials
  1858. </h3>
  1859. <p>
  1860. (<em>Appears on:</em>
  1861. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1862. </p>
  1863. <p>
  1864. <p>AwsAuthCredentials represents the credentials for AWS authentication.</p>
  1865. </p>
  1866. <table>
  1867. <thead>
  1868. <tr>
  1869. <th>Field</th>
  1870. <th>Description</th>
  1871. </tr>
  1872. </thead>
  1873. <tbody>
  1874. <tr>
  1875. <td>
  1876. <code>identityId</code></br>
  1877. <em>
  1878. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1879. External Secrets meta/v1.SecretKeySelector
  1880. </a>
  1881. </em>
  1882. </td>
  1883. <td>
  1884. </td>
  1885. </tr>
  1886. </tbody>
  1887. </table>
  1888. <h3 id="external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig
  1889. </h3>
  1890. <p>
  1891. (<em>Appears on:</em>
  1892. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  1893. </p>
  1894. <p>
  1895. <p>AwsCredentialsConfig holds the region and the Secret reference which contains the AWS credentials.</p>
  1896. </p>
  1897. <table>
  1898. <thead>
  1899. <tr>
  1900. <th>Field</th>
  1901. <th>Description</th>
  1902. </tr>
  1903. </thead>
  1904. <tbody>
  1905. <tr>
  1906. <td>
  1907. <code>region</code></br>
  1908. <em>
  1909. string
  1910. </em>
  1911. </td>
  1912. <td>
  1913. <p>region is for configuring the AWS region to be used.</p>
  1914. </td>
  1915. </tr>
  1916. <tr>
  1917. <td>
  1918. <code>awsCredentialsSecretRef</code></br>
  1919. <em>
  1920. <a href="#external-secrets.io/v1.SecretReference">
  1921. SecretReference
  1922. </a>
  1923. </em>
  1924. </td>
  1925. <td>
  1926. <p>awsCredentialsSecretRef is the reference to the secret which holds the AWS credentials.
  1927. Secret should be created with below names for keys
  1928. - aws_access_key_id: Access Key ID, which is the unique identifier for the AWS account or the IAM user.
  1929. - aws_secret_access_key: Secret Access Key, which is used to authenticate requests made to AWS services.
  1930. - aws_session_token: Session Token, is the short-lived token to authenticate requests made to AWS services.</p>
  1931. </td>
  1932. </tr>
  1933. </tbody>
  1934. </table>
  1935. <h3 id="external-secrets.io/v1.AzureAuthCredentials">AzureAuthCredentials
  1936. </h3>
  1937. <p>
  1938. (<em>Appears on:</em>
  1939. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  1940. </p>
  1941. <p>
  1942. <p>AzureAuthCredentials represents the credentials for Azure authentication.</p>
  1943. </p>
  1944. <table>
  1945. <thead>
  1946. <tr>
  1947. <th>Field</th>
  1948. <th>Description</th>
  1949. </tr>
  1950. </thead>
  1951. <tbody>
  1952. <tr>
  1953. <td>
  1954. <code>identityId</code></br>
  1955. <em>
  1956. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1957. External Secrets meta/v1.SecretKeySelector
  1958. </a>
  1959. </em>
  1960. </td>
  1961. <td>
  1962. </td>
  1963. </tr>
  1964. <tr>
  1965. <td>
  1966. <code>resource</code></br>
  1967. <em>
  1968. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  1969. External Secrets meta/v1.SecretKeySelector
  1970. </a>
  1971. </em>
  1972. </td>
  1973. <td>
  1974. <em>(Optional)</em>
  1975. </td>
  1976. </tr>
  1977. </tbody>
  1978. </table>
  1979. <h3 id="external-secrets.io/v1.AzureAuthType">AzureAuthType
  1980. (<code>string</code> alias)</p></h3>
  1981. <p>
  1982. (<em>Appears on:</em>
  1983. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  1984. </p>
  1985. <p>
  1986. <p>AzureAuthType describes how to authenticate to the Azure Keyvault
  1987. Only one of the following auth types may be specified.
  1988. If none of the following auth type is specified, the default one
  1989. is ServicePrincipal.</p>
  1990. </p>
  1991. <table>
  1992. <thead>
  1993. <tr>
  1994. <th>Value</th>
  1995. <th>Description</th>
  1996. </tr>
  1997. </thead>
  1998. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  1999. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  2000. </td>
  2001. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  2002. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  2003. </td>
  2004. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  2005. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  2006. </td>
  2007. </tr></tbody>
  2008. </table>
  2009. <h3 id="external-secrets.io/v1.AzureCustomCloudConfig">AzureCustomCloudConfig
  2010. </h3>
  2011. <p>
  2012. (<em>Appears on:</em>
  2013. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2014. </p>
  2015. <p>
  2016. <p>AzureCustomCloudConfig specifies custom cloud configuration for private Azure environments
  2017. IMPORTANT: Custom cloud configuration is ONLY supported when UseAzureSDK is true.
  2018. The legacy go-autorest SDK does not support custom cloud endpoints.</p>
  2019. </p>
  2020. <table>
  2021. <thead>
  2022. <tr>
  2023. <th>Field</th>
  2024. <th>Description</th>
  2025. </tr>
  2026. </thead>
  2027. <tbody>
  2028. <tr>
  2029. <td>
  2030. <code>activeDirectoryEndpoint</code></br>
  2031. <em>
  2032. string
  2033. </em>
  2034. </td>
  2035. <td>
  2036. <p>ActiveDirectoryEndpoint is the AAD endpoint for authentication
  2037. Required when using custom cloud configuration</p>
  2038. </td>
  2039. </tr>
  2040. <tr>
  2041. <td>
  2042. <code>keyVaultEndpoint</code></br>
  2043. <em>
  2044. string
  2045. </em>
  2046. </td>
  2047. <td>
  2048. <em>(Optional)</em>
  2049. <p>KeyVaultEndpoint is the Key Vault service endpoint</p>
  2050. </td>
  2051. </tr>
  2052. <tr>
  2053. <td>
  2054. <code>keyVaultDNSSuffix</code></br>
  2055. <em>
  2056. string
  2057. </em>
  2058. </td>
  2059. <td>
  2060. <em>(Optional)</em>
  2061. <p>KeyVaultDNSSuffix is the DNS suffix for Key Vault URLs</p>
  2062. </td>
  2063. </tr>
  2064. <tr>
  2065. <td>
  2066. <code>resourceManagerEndpoint</code></br>
  2067. <em>
  2068. string
  2069. </em>
  2070. </td>
  2071. <td>
  2072. <em>(Optional)</em>
  2073. <p>ResourceManagerEndpoint is the Azure Resource Manager endpoint</p>
  2074. </td>
  2075. </tr>
  2076. </tbody>
  2077. </table>
  2078. <h3 id="external-secrets.io/v1.AzureEnvironmentType">AzureEnvironmentType
  2079. (<code>string</code> alias)</p></h3>
  2080. <p>
  2081. (<em>Appears on:</em>
  2082. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>,
  2083. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  2084. </p>
  2085. <p>
  2086. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  2087. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  2088. 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>
  2089. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud</p>
  2090. </p>
  2091. <table>
  2092. <thead>
  2093. <tr>
  2094. <th>Value</th>
  2095. <th>Description</th>
  2096. </tr>
  2097. </thead>
  2098. <tbody><tr><td><p>&#34;AzureStackCloud&#34;</p></td>
  2099. <td></td>
  2100. </tr><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  2101. <td></td>
  2102. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  2103. <td></td>
  2104. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  2105. <td></td>
  2106. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  2107. <td></td>
  2108. </tr></tbody>
  2109. </table>
  2110. <h3 id="external-secrets.io/v1.AzureKVAuth">AzureKVAuth
  2111. </h3>
  2112. <p>
  2113. (<em>Appears on:</em>
  2114. <a href="#external-secrets.io/v1.AzureKVProvider">AzureKVProvider</a>)
  2115. </p>
  2116. <p>
  2117. <p>AzureKVAuth is the configuration used to authenticate with Azure.</p>
  2118. </p>
  2119. <table>
  2120. <thead>
  2121. <tr>
  2122. <th>Field</th>
  2123. <th>Description</th>
  2124. </tr>
  2125. </thead>
  2126. <tbody>
  2127. <tr>
  2128. <td>
  2129. <code>clientId</code></br>
  2130. <em>
  2131. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2132. External Secrets meta/v1.SecretKeySelector
  2133. </a>
  2134. </em>
  2135. </td>
  2136. <td>
  2137. <em>(Optional)</em>
  2138. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  2139. </td>
  2140. </tr>
  2141. <tr>
  2142. <td>
  2143. <code>tenantId</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 tenantId of the managed identity used for authentication.</p>
  2153. </td>
  2154. </tr>
  2155. <tr>
  2156. <td>
  2157. <code>clientSecret</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 ClientSecret of the service principle used for authentication.</p>
  2167. </td>
  2168. </tr>
  2169. <tr>
  2170. <td>
  2171. <code>clientCertificate</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 ClientCertificate of the service principle used for authentication.</p>
  2181. </td>
  2182. </tr>
  2183. </tbody>
  2184. </table>
  2185. <h3 id="external-secrets.io/v1.AzureKVProvider">AzureKVProvider
  2186. </h3>
  2187. <p>
  2188. (<em>Appears on:</em>
  2189. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2190. </p>
  2191. <p>
  2192. <p>AzureKVProvider configures a store to sync secrets using Azure KV.</p>
  2193. </p>
  2194. <table>
  2195. <thead>
  2196. <tr>
  2197. <th>Field</th>
  2198. <th>Description</th>
  2199. </tr>
  2200. </thead>
  2201. <tbody>
  2202. <tr>
  2203. <td>
  2204. <code>authType</code></br>
  2205. <em>
  2206. <a href="#external-secrets.io/v1.AzureAuthType">
  2207. AzureAuthType
  2208. </a>
  2209. </em>
  2210. </td>
  2211. <td>
  2212. <em>(Optional)</em>
  2213. <p>Auth type defines how to authenticate to the keyvault service.
  2214. Valid values are:
  2215. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  2216. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)</p>
  2217. </td>
  2218. </tr>
  2219. <tr>
  2220. <td>
  2221. <code>vaultUrl</code></br>
  2222. <em>
  2223. string
  2224. </em>
  2225. </td>
  2226. <td>
  2227. <p>Vault Url from which the secrets to be fetched from.</p>
  2228. </td>
  2229. </tr>
  2230. <tr>
  2231. <td>
  2232. <code>tenantId</code></br>
  2233. <em>
  2234. string
  2235. </em>
  2236. </td>
  2237. <td>
  2238. <em>(Optional)</em>
  2239. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2240. </td>
  2241. </tr>
  2242. <tr>
  2243. <td>
  2244. <code>environmentType</code></br>
  2245. <em>
  2246. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  2247. AzureEnvironmentType
  2248. </a>
  2249. </em>
  2250. </td>
  2251. <td>
  2252. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  2253. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  2254. 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>
  2255. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud, AzureStackCloud
  2256. Use AzureStackCloud when you need to configure custom Azure Stack Hub or Azure Stack Edge endpoints.</p>
  2257. </td>
  2258. </tr>
  2259. <tr>
  2260. <td>
  2261. <code>authSecretRef</code></br>
  2262. <em>
  2263. <a href="#external-secrets.io/v1.AzureKVAuth">
  2264. AzureKVAuth
  2265. </a>
  2266. </em>
  2267. </td>
  2268. <td>
  2269. <em>(Optional)</em>
  2270. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  2271. </td>
  2272. </tr>
  2273. <tr>
  2274. <td>
  2275. <code>serviceAccountRef</code></br>
  2276. <em>
  2277. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  2278. External Secrets meta/v1.ServiceAccountSelector
  2279. </a>
  2280. </em>
  2281. </td>
  2282. <td>
  2283. <em>(Optional)</em>
  2284. <p>ServiceAccountRef specified the service account
  2285. that should be used when authenticating with WorkloadIdentity.</p>
  2286. </td>
  2287. </tr>
  2288. <tr>
  2289. <td>
  2290. <code>identityId</code></br>
  2291. <em>
  2292. string
  2293. </em>
  2294. </td>
  2295. <td>
  2296. <em>(Optional)</em>
  2297. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  2298. </td>
  2299. </tr>
  2300. <tr>
  2301. <td>
  2302. <code>useAzureSDK</code></br>
  2303. <em>
  2304. bool
  2305. </em>
  2306. </td>
  2307. <td>
  2308. <em>(Optional)</em>
  2309. <p>UseAzureSDK enables the use of the new Azure SDK for Go (azcore-based) instead of the legacy go-autorest SDK.
  2310. This is experimental and may have behavioral differences. Defaults to false (legacy SDK).</p>
  2311. </td>
  2312. </tr>
  2313. <tr>
  2314. <td>
  2315. <code>customCloudConfig</code></br>
  2316. <em>
  2317. <a href="#external-secrets.io/v1.AzureCustomCloudConfig">
  2318. AzureCustomCloudConfig
  2319. </a>
  2320. </em>
  2321. </td>
  2322. <td>
  2323. <em>(Optional)</em>
  2324. <p>CustomCloudConfig defines custom Azure endpoints for non-standard clouds.
  2325. Required when EnvironmentType is AzureStackCloud.
  2326. Optional for other environment types - useful for Azure China when using Workload Identity
  2327. with AKS, where the OIDC issuer (login.partner.microsoftonline.cn) differs from the
  2328. standard China Cloud endpoint (login.chinacloudapi.cn).
  2329. IMPORTANT: This feature REQUIRES UseAzureSDK to be set to true. Custom cloud
  2330. configuration is not supported with the legacy go-autorest SDK.</p>
  2331. </td>
  2332. </tr>
  2333. </tbody>
  2334. </table>
  2335. <h3 id="external-secrets.io/v1.BarbicanAuth">BarbicanAuth
  2336. </h3>
  2337. <p>
  2338. (<em>Appears on:</em>
  2339. <a href="#external-secrets.io/v1.BarbicanProvider">BarbicanProvider</a>)
  2340. </p>
  2341. <p>
  2342. <p>BarbicanAuth contains the authentication information for Barbican.</p>
  2343. </p>
  2344. <table>
  2345. <thead>
  2346. <tr>
  2347. <th>Field</th>
  2348. <th>Description</th>
  2349. </tr>
  2350. </thead>
  2351. <tbody>
  2352. <tr>
  2353. <td>
  2354. <code>username</code></br>
  2355. <em>
  2356. <a href="#external-secrets.io/v1.BarbicanProviderUsernameRef">
  2357. BarbicanProviderUsernameRef
  2358. </a>
  2359. </em>
  2360. </td>
  2361. <td>
  2362. </td>
  2363. </tr>
  2364. <tr>
  2365. <td>
  2366. <code>password</code></br>
  2367. <em>
  2368. <a href="#external-secrets.io/v1.BarbicanProviderPasswordRef">
  2369. BarbicanProviderPasswordRef
  2370. </a>
  2371. </em>
  2372. </td>
  2373. <td>
  2374. </td>
  2375. </tr>
  2376. </tbody>
  2377. </table>
  2378. <h3 id="external-secrets.io/v1.BarbicanProvider">BarbicanProvider
  2379. </h3>
  2380. <p>
  2381. (<em>Appears on:</em>
  2382. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2383. </p>
  2384. <p>
  2385. <p>BarbicanProvider setup a store to sync secrets with barbican.</p>
  2386. </p>
  2387. <table>
  2388. <thead>
  2389. <tr>
  2390. <th>Field</th>
  2391. <th>Description</th>
  2392. </tr>
  2393. </thead>
  2394. <tbody>
  2395. <tr>
  2396. <td>
  2397. <code>authURL</code></br>
  2398. <em>
  2399. string
  2400. </em>
  2401. </td>
  2402. <td>
  2403. </td>
  2404. </tr>
  2405. <tr>
  2406. <td>
  2407. <code>tenantName</code></br>
  2408. <em>
  2409. string
  2410. </em>
  2411. </td>
  2412. <td>
  2413. </td>
  2414. </tr>
  2415. <tr>
  2416. <td>
  2417. <code>domainName</code></br>
  2418. <em>
  2419. string
  2420. </em>
  2421. </td>
  2422. <td>
  2423. </td>
  2424. </tr>
  2425. <tr>
  2426. <td>
  2427. <code>region</code></br>
  2428. <em>
  2429. string
  2430. </em>
  2431. </td>
  2432. <td>
  2433. </td>
  2434. </tr>
  2435. <tr>
  2436. <td>
  2437. <code>auth</code></br>
  2438. <em>
  2439. <a href="#external-secrets.io/v1.BarbicanAuth">
  2440. BarbicanAuth
  2441. </a>
  2442. </em>
  2443. </td>
  2444. <td>
  2445. </td>
  2446. </tr>
  2447. </tbody>
  2448. </table>
  2449. <h3 id="external-secrets.io/v1.BarbicanProviderPasswordRef">BarbicanProviderPasswordRef
  2450. </h3>
  2451. <p>
  2452. (<em>Appears on:</em>
  2453. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2454. </p>
  2455. <p>
  2456. <p>BarbicanProviderPasswordRef defines a reference to a secret containing password for the Barbican provider.</p>
  2457. </p>
  2458. <table>
  2459. <thead>
  2460. <tr>
  2461. <th>Field</th>
  2462. <th>Description</th>
  2463. </tr>
  2464. </thead>
  2465. <tbody>
  2466. <tr>
  2467. <td>
  2468. <code>secretRef</code></br>
  2469. <em>
  2470. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2471. External Secrets meta/v1.SecretKeySelector
  2472. </a>
  2473. </em>
  2474. </td>
  2475. <td>
  2476. </td>
  2477. </tr>
  2478. </tbody>
  2479. </table>
  2480. <h3 id="external-secrets.io/v1.BarbicanProviderUsernameRef">BarbicanProviderUsernameRef
  2481. </h3>
  2482. <p>
  2483. (<em>Appears on:</em>
  2484. <a href="#external-secrets.io/v1.BarbicanAuth">BarbicanAuth</a>)
  2485. </p>
  2486. <p>
  2487. <p>BarbicanProviderUsernameRef defines a reference to a secret containing username for the Barbican provider.</p>
  2488. </p>
  2489. <table>
  2490. <thead>
  2491. <tr>
  2492. <th>Field</th>
  2493. <th>Description</th>
  2494. </tr>
  2495. </thead>
  2496. <tbody>
  2497. <tr>
  2498. <td>
  2499. <code>value</code></br>
  2500. <em>
  2501. string
  2502. </em>
  2503. </td>
  2504. <td>
  2505. </td>
  2506. </tr>
  2507. <tr>
  2508. <td>
  2509. <code>secretRef</code></br>
  2510. <em>
  2511. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2512. External Secrets meta/v1.SecretKeySelector
  2513. </a>
  2514. </em>
  2515. </td>
  2516. <td>
  2517. </td>
  2518. </tr>
  2519. </tbody>
  2520. </table>
  2521. <h3 id="external-secrets.io/v1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  2522. </h3>
  2523. <p>
  2524. (<em>Appears on:</em>
  2525. <a href="#external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth</a>)
  2526. </p>
  2527. <p>
  2528. <p>BeyondTrustProviderSecretRef references a value that can be specified directly or via a secret
  2529. for a BeyondTrustProvider.</p>
  2530. </p>
  2531. <table>
  2532. <thead>
  2533. <tr>
  2534. <th>Field</th>
  2535. <th>Description</th>
  2536. </tr>
  2537. </thead>
  2538. <tbody>
  2539. <tr>
  2540. <td>
  2541. <code>value</code></br>
  2542. <em>
  2543. string
  2544. </em>
  2545. </td>
  2546. <td>
  2547. <em>(Optional)</em>
  2548. <p>Value can be specified directly to set a value without using a secret.</p>
  2549. </td>
  2550. </tr>
  2551. <tr>
  2552. <td>
  2553. <code>secretRef</code></br>
  2554. <em>
  2555. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2556. External Secrets meta/v1.SecretKeySelector
  2557. </a>
  2558. </em>
  2559. </td>
  2560. <td>
  2561. <em>(Optional)</em>
  2562. <p>SecretRef references a key in a secret that will be used as value.</p>
  2563. </td>
  2564. </tr>
  2565. </tbody>
  2566. </table>
  2567. <h3 id="external-secrets.io/v1.BeyondtrustAuth">BeyondtrustAuth
  2568. </h3>
  2569. <p>
  2570. (<em>Appears on:</em>
  2571. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2572. </p>
  2573. <p>
  2574. <p>BeyondtrustAuth provides different ways to authenticate to a BeyondtrustProvider server.</p>
  2575. </p>
  2576. <table>
  2577. <thead>
  2578. <tr>
  2579. <th>Field</th>
  2580. <th>Description</th>
  2581. </tr>
  2582. </thead>
  2583. <tbody>
  2584. <tr>
  2585. <td>
  2586. <code>apiKey</code></br>
  2587. <em>
  2588. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2589. BeyondTrustProviderSecretRef
  2590. </a>
  2591. </em>
  2592. </td>
  2593. <td>
  2594. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  2595. </td>
  2596. </tr>
  2597. <tr>
  2598. <td>
  2599. <code>clientId</code></br>
  2600. <em>
  2601. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2602. BeyondTrustProviderSecretRef
  2603. </a>
  2604. </em>
  2605. </td>
  2606. <td>
  2607. <p>ClientID is the API OAuth Client ID.</p>
  2608. </td>
  2609. </tr>
  2610. <tr>
  2611. <td>
  2612. <code>clientSecret</code></br>
  2613. <em>
  2614. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2615. BeyondTrustProviderSecretRef
  2616. </a>
  2617. </em>
  2618. </td>
  2619. <td>
  2620. <p>ClientSecret is the API OAuth Client Secret.</p>
  2621. </td>
  2622. </tr>
  2623. <tr>
  2624. <td>
  2625. <code>certificate</code></br>
  2626. <em>
  2627. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2628. BeyondTrustProviderSecretRef
  2629. </a>
  2630. </em>
  2631. </td>
  2632. <td>
  2633. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  2634. </td>
  2635. </tr>
  2636. <tr>
  2637. <td>
  2638. <code>certificateKey</code></br>
  2639. <em>
  2640. <a href="#external-secrets.io/v1.BeyondTrustProviderSecretRef">
  2641. BeyondTrustProviderSecretRef
  2642. </a>
  2643. </em>
  2644. </td>
  2645. <td>
  2646. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  2647. </td>
  2648. </tr>
  2649. </tbody>
  2650. </table>
  2651. <h3 id="external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider
  2652. </h3>
  2653. <p>
  2654. (<em>Appears on:</em>
  2655. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2656. </p>
  2657. <p>
  2658. <p>BeyondtrustProvider provides access to a BeyondTrust secrets provider.</p>
  2659. </p>
  2660. <table>
  2661. <thead>
  2662. <tr>
  2663. <th>Field</th>
  2664. <th>Description</th>
  2665. </tr>
  2666. </thead>
  2667. <tbody>
  2668. <tr>
  2669. <td>
  2670. <code>auth</code></br>
  2671. <em>
  2672. <a href="#external-secrets.io/v1.BeyondtrustAuth">
  2673. BeyondtrustAuth
  2674. </a>
  2675. </em>
  2676. </td>
  2677. <td>
  2678. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  2679. </td>
  2680. </tr>
  2681. <tr>
  2682. <td>
  2683. <code>server</code></br>
  2684. <em>
  2685. <a href="#external-secrets.io/v1.BeyondtrustServer">
  2686. BeyondtrustServer
  2687. </a>
  2688. </em>
  2689. </td>
  2690. <td>
  2691. <p>Auth configures how API server works.</p>
  2692. </td>
  2693. </tr>
  2694. </tbody>
  2695. </table>
  2696. <h3 id="external-secrets.io/v1.BeyondtrustServer">BeyondtrustServer
  2697. </h3>
  2698. <p>
  2699. (<em>Appears on:</em>
  2700. <a href="#external-secrets.io/v1.BeyondtrustProvider">BeyondtrustProvider</a>)
  2701. </p>
  2702. <p>
  2703. <p>BeyondtrustServer configures a store to sync secrets using BeyondTrust Password Safe.</p>
  2704. </p>
  2705. <table>
  2706. <thead>
  2707. <tr>
  2708. <th>Field</th>
  2709. <th>Description</th>
  2710. </tr>
  2711. </thead>
  2712. <tbody>
  2713. <tr>
  2714. <td>
  2715. <code>apiUrl</code></br>
  2716. <em>
  2717. string
  2718. </em>
  2719. </td>
  2720. <td>
  2721. </td>
  2722. </tr>
  2723. <tr>
  2724. <td>
  2725. <code>apiVersion</code></br>
  2726. <em>
  2727. string
  2728. </em>
  2729. </td>
  2730. <td>
  2731. </td>
  2732. </tr>
  2733. <tr>
  2734. <td>
  2735. <code>retrievalType</code></br>
  2736. <em>
  2737. string
  2738. </em>
  2739. </td>
  2740. <td>
  2741. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  2742. </td>
  2743. </tr>
  2744. <tr>
  2745. <td>
  2746. <code>separator</code></br>
  2747. <em>
  2748. string
  2749. </em>
  2750. </td>
  2751. <td>
  2752. <p>A character that separates the folder names.</p>
  2753. </td>
  2754. </tr>
  2755. <tr>
  2756. <td>
  2757. <code>decrypt</code></br>
  2758. <em>
  2759. bool
  2760. </em>
  2761. </td>
  2762. <td>
  2763. <em>(Optional)</em>
  2764. <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>
  2765. </td>
  2766. </tr>
  2767. <tr>
  2768. <td>
  2769. <code>verifyCA</code></br>
  2770. <em>
  2771. bool
  2772. </em>
  2773. </td>
  2774. <td>
  2775. </td>
  2776. </tr>
  2777. <tr>
  2778. <td>
  2779. <code>clientTimeOutSeconds</code></br>
  2780. <em>
  2781. int
  2782. </em>
  2783. </td>
  2784. <td>
  2785. <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>
  2786. </td>
  2787. </tr>
  2788. </tbody>
  2789. </table>
  2790. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  2791. </h3>
  2792. <p>
  2793. (<em>Appears on:</em>
  2794. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  2795. </p>
  2796. <p>
  2797. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  2798. </p>
  2799. <table>
  2800. <thead>
  2801. <tr>
  2802. <th>Field</th>
  2803. <th>Description</th>
  2804. </tr>
  2805. </thead>
  2806. <tbody>
  2807. <tr>
  2808. <td>
  2809. <code>secretRef</code></br>
  2810. <em>
  2811. <a href="#external-secrets.io/v1.BitwardenSecretsManagerSecretRef">
  2812. BitwardenSecretsManagerSecretRef
  2813. </a>
  2814. </em>
  2815. </td>
  2816. <td>
  2817. </td>
  2818. </tr>
  2819. </tbody>
  2820. </table>
  2821. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  2822. </h3>
  2823. <p>
  2824. (<em>Appears on:</em>
  2825. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  2826. </p>
  2827. <p>
  2828. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  2829. </p>
  2830. <table>
  2831. <thead>
  2832. <tr>
  2833. <th>Field</th>
  2834. <th>Description</th>
  2835. </tr>
  2836. </thead>
  2837. <tbody>
  2838. <tr>
  2839. <td>
  2840. <code>apiURL</code></br>
  2841. <em>
  2842. string
  2843. </em>
  2844. </td>
  2845. <td>
  2846. </td>
  2847. </tr>
  2848. <tr>
  2849. <td>
  2850. <code>identityURL</code></br>
  2851. <em>
  2852. string
  2853. </em>
  2854. </td>
  2855. <td>
  2856. </td>
  2857. </tr>
  2858. <tr>
  2859. <td>
  2860. <code>bitwardenServerSDKURL</code></br>
  2861. <em>
  2862. string
  2863. </em>
  2864. </td>
  2865. <td>
  2866. </td>
  2867. </tr>
  2868. <tr>
  2869. <td>
  2870. <code>caBundle</code></br>
  2871. <em>
  2872. string
  2873. </em>
  2874. </td>
  2875. <td>
  2876. <em>(Optional)</em>
  2877. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  2878. can be performed.</p>
  2879. </td>
  2880. </tr>
  2881. <tr>
  2882. <td>
  2883. <code>caProvider</code></br>
  2884. <em>
  2885. <a href="#external-secrets.io/v1.CAProvider">
  2886. CAProvider
  2887. </a>
  2888. </em>
  2889. </td>
  2890. <td>
  2891. <em>(Optional)</em>
  2892. <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>
  2893. </td>
  2894. </tr>
  2895. <tr>
  2896. <td>
  2897. <code>organizationID</code></br>
  2898. <em>
  2899. string
  2900. </em>
  2901. </td>
  2902. <td>
  2903. <p>OrganizationID determines which organization this secret store manages.</p>
  2904. </td>
  2905. </tr>
  2906. <tr>
  2907. <td>
  2908. <code>projectID</code></br>
  2909. <em>
  2910. string
  2911. </em>
  2912. </td>
  2913. <td>
  2914. <p>ProjectID determines which project this secret store manages.</p>
  2915. </td>
  2916. </tr>
  2917. <tr>
  2918. <td>
  2919. <code>auth</code></br>
  2920. <em>
  2921. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">
  2922. BitwardenSecretsManagerAuth
  2923. </a>
  2924. </em>
  2925. </td>
  2926. <td>
  2927. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  2928. Make sure that the token being used has permissions on the given secret.</p>
  2929. </td>
  2930. </tr>
  2931. </tbody>
  2932. </table>
  2933. <h3 id="external-secrets.io/v1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  2934. </h3>
  2935. <p>
  2936. (<em>Appears on:</em>
  2937. <a href="#external-secrets.io/v1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  2938. </p>
  2939. <p>
  2940. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  2941. </p>
  2942. <table>
  2943. <thead>
  2944. <tr>
  2945. <th>Field</th>
  2946. <th>Description</th>
  2947. </tr>
  2948. </thead>
  2949. <tbody>
  2950. <tr>
  2951. <td>
  2952. <code>credentials</code></br>
  2953. <em>
  2954. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  2955. External Secrets meta/v1.SecretKeySelector
  2956. </a>
  2957. </em>
  2958. </td>
  2959. <td>
  2960. <p>AccessToken used for the bitwarden instance.</p>
  2961. </td>
  2962. </tr>
  2963. </tbody>
  2964. </table>
  2965. <h3 id="external-secrets.io/v1.ByID">ByID
  2966. </h3>
  2967. <p>
  2968. (<em>Appears on:</em>
  2969. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  2970. </p>
  2971. <p>
  2972. <p>ByID configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID.</p>
  2973. </p>
  2974. <h3 id="external-secrets.io/v1.ByName">ByName
  2975. </h3>
  2976. <p>
  2977. (<em>Appears on:</em>
  2978. <a href="#external-secrets.io/v1.FetchingPolicy">FetchingPolicy</a>)
  2979. </p>
  2980. <p>
  2981. <p>ByName configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret name.</p>
  2982. </p>
  2983. <table>
  2984. <thead>
  2985. <tr>
  2986. <th>Field</th>
  2987. <th>Description</th>
  2988. </tr>
  2989. </thead>
  2990. <tbody>
  2991. <tr>
  2992. <td>
  2993. <code>folderID</code></br>
  2994. <em>
  2995. string
  2996. </em>
  2997. </td>
  2998. <td>
  2999. <p>The folder to fetch secrets from</p>
  3000. </td>
  3001. </tr>
  3002. </tbody>
  3003. </table>
  3004. <h3 id="external-secrets.io/v1.CAProvider">CAProvider
  3005. </h3>
  3006. <p>
  3007. (<em>Appears on:</em>
  3008. <a href="#external-secrets.io/v1.AkeylessProvider">AkeylessProvider</a>,
  3009. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  3010. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>,
  3011. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>,
  3012. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>,
  3013. <a href="#external-secrets.io/v1.KubernetesServer">KubernetesServer</a>,
  3014. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>,
  3015. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  3016. </p>
  3017. <p>
  3018. <p>CAProvider provides a custom certificate authority for accessing the provider&rsquo;s store.
  3019. The CAProvider points to a Secret or ConfigMap resource that contains a PEM-encoded certificate.</p>
  3020. </p>
  3021. <table>
  3022. <thead>
  3023. <tr>
  3024. <th>Field</th>
  3025. <th>Description</th>
  3026. </tr>
  3027. </thead>
  3028. <tbody>
  3029. <tr>
  3030. <td>
  3031. <code>type</code></br>
  3032. <em>
  3033. <a href="#external-secrets.io/v1.CAProviderType">
  3034. CAProviderType
  3035. </a>
  3036. </em>
  3037. </td>
  3038. <td>
  3039. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  3040. </td>
  3041. </tr>
  3042. <tr>
  3043. <td>
  3044. <code>name</code></br>
  3045. <em>
  3046. string
  3047. </em>
  3048. </td>
  3049. <td>
  3050. <p>The name of the object located at the provider type.</p>
  3051. </td>
  3052. </tr>
  3053. <tr>
  3054. <td>
  3055. <code>key</code></br>
  3056. <em>
  3057. string
  3058. </em>
  3059. </td>
  3060. <td>
  3061. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  3062. </td>
  3063. </tr>
  3064. <tr>
  3065. <td>
  3066. <code>namespace</code></br>
  3067. <em>
  3068. string
  3069. </em>
  3070. </td>
  3071. <td>
  3072. <em>(Optional)</em>
  3073. <p>The namespace the Provider type is in.
  3074. Can only be defined when used in a ClusterSecretStore.</p>
  3075. </td>
  3076. </tr>
  3077. </tbody>
  3078. </table>
  3079. <h3 id="external-secrets.io/v1.CAProviderType">CAProviderType
  3080. (<code>string</code> alias)</p></h3>
  3081. <p>
  3082. (<em>Appears on:</em>
  3083. <a href="#external-secrets.io/v1.CAProvider">CAProvider</a>)
  3084. </p>
  3085. <p>
  3086. <p>CAProviderType defines the type of provider for certificate authority.</p>
  3087. </p>
  3088. <table>
  3089. <thead>
  3090. <tr>
  3091. <th>Value</th>
  3092. <th>Description</th>
  3093. </tr>
  3094. </thead>
  3095. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  3096. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  3097. </td>
  3098. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  3099. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  3100. </td>
  3101. </tr></tbody>
  3102. </table>
  3103. <h3 id="external-secrets.io/v1.CSMAuth">CSMAuth
  3104. </h3>
  3105. <p>
  3106. (<em>Appears on:</em>
  3107. <a href="#external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider</a>)
  3108. </p>
  3109. <p>
  3110. <p>CSMAuth contains a secretRef for credentials.</p>
  3111. </p>
  3112. <table>
  3113. <thead>
  3114. <tr>
  3115. <th>Field</th>
  3116. <th>Description</th>
  3117. </tr>
  3118. </thead>
  3119. <tbody>
  3120. <tr>
  3121. <td>
  3122. <code>secretRef</code></br>
  3123. <em>
  3124. <a href="#external-secrets.io/v1.CSMAuthSecretRef">
  3125. CSMAuthSecretRef
  3126. </a>
  3127. </em>
  3128. </td>
  3129. <td>
  3130. <em>(Optional)</em>
  3131. </td>
  3132. </tr>
  3133. </tbody>
  3134. </table>
  3135. <h3 id="external-secrets.io/v1.CSMAuthSecretRef">CSMAuthSecretRef
  3136. </h3>
  3137. <p>
  3138. (<em>Appears on:</em>
  3139. <a href="#external-secrets.io/v1.CSMAuth">CSMAuth</a>)
  3140. </p>
  3141. <p>
  3142. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  3143. </p>
  3144. <table>
  3145. <thead>
  3146. <tr>
  3147. <th>Field</th>
  3148. <th>Description</th>
  3149. </tr>
  3150. </thead>
  3151. <tbody>
  3152. <tr>
  3153. <td>
  3154. <code>accessKeyIDSecretRef</code></br>
  3155. <em>
  3156. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3157. External Secrets meta/v1.SecretKeySelector
  3158. </a>
  3159. </em>
  3160. </td>
  3161. <td>
  3162. <p>The AccessKeyID is used for authentication</p>
  3163. </td>
  3164. </tr>
  3165. <tr>
  3166. <td>
  3167. <code>accessKeySecretSecretRef</code></br>
  3168. <em>
  3169. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3170. External Secrets meta/v1.SecretKeySelector
  3171. </a>
  3172. </em>
  3173. </td>
  3174. <td>
  3175. <p>The AccessKeySecret is used for authentication</p>
  3176. </td>
  3177. </tr>
  3178. </tbody>
  3179. </table>
  3180. <h3 id="external-secrets.io/v1.CacheConfig">CacheConfig
  3181. </h3>
  3182. <p>
  3183. (<em>Appears on:</em>
  3184. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  3185. </p>
  3186. <p>
  3187. <p>CacheConfig configures client-side caching for read operations.</p>
  3188. </p>
  3189. <table>
  3190. <thead>
  3191. <tr>
  3192. <th>Field</th>
  3193. <th>Description</th>
  3194. </tr>
  3195. </thead>
  3196. <tbody>
  3197. <tr>
  3198. <td>
  3199. <code>ttl</code></br>
  3200. <em>
  3201. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3202. Kubernetes meta/v1.Duration
  3203. </a>
  3204. </em>
  3205. </td>
  3206. <td>
  3207. <em>(Optional)</em>
  3208. <p>TTL is the time-to-live for cached secrets.
  3209. Format: duration string (e.g., &ldquo;5m&rdquo;, &ldquo;1h&rdquo;, &ldquo;30s&rdquo;)</p>
  3210. </td>
  3211. </tr>
  3212. <tr>
  3213. <td>
  3214. <code>maxSize</code></br>
  3215. <em>
  3216. int
  3217. </em>
  3218. </td>
  3219. <td>
  3220. <em>(Optional)</em>
  3221. <p>MaxSize is the maximum number of secrets to cache.
  3222. When the cache is full, least-recently-used entries are evicted.</p>
  3223. </td>
  3224. </tr>
  3225. </tbody>
  3226. </table>
  3227. <h3 id="external-secrets.io/v1.CertAuth">CertAuth
  3228. </h3>
  3229. <p>
  3230. (<em>Appears on:</em>
  3231. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  3232. </p>
  3233. <p>
  3234. <p>CertAuth defines certificate-based authentication configuration for Kubernetes.</p>
  3235. </p>
  3236. <table>
  3237. <thead>
  3238. <tr>
  3239. <th>Field</th>
  3240. <th>Description</th>
  3241. </tr>
  3242. </thead>
  3243. <tbody>
  3244. <tr>
  3245. <td>
  3246. <code>clientCert</code></br>
  3247. <em>
  3248. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3249. External Secrets meta/v1.SecretKeySelector
  3250. </a>
  3251. </em>
  3252. </td>
  3253. <td>
  3254. </td>
  3255. </tr>
  3256. <tr>
  3257. <td>
  3258. <code>clientKey</code></br>
  3259. <em>
  3260. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3261. External Secrets meta/v1.SecretKeySelector
  3262. </a>
  3263. </em>
  3264. </td>
  3265. <td>
  3266. </td>
  3267. </tr>
  3268. </tbody>
  3269. </table>
  3270. <h3 id="external-secrets.io/v1.ChefAuth">ChefAuth
  3271. </h3>
  3272. <p>
  3273. (<em>Appears on:</em>
  3274. <a href="#external-secrets.io/v1.ChefProvider">ChefProvider</a>)
  3275. </p>
  3276. <p>
  3277. <p>ChefAuth contains a secretRef for credentials.</p>
  3278. </p>
  3279. <table>
  3280. <thead>
  3281. <tr>
  3282. <th>Field</th>
  3283. <th>Description</th>
  3284. </tr>
  3285. </thead>
  3286. <tbody>
  3287. <tr>
  3288. <td>
  3289. <code>secretRef</code></br>
  3290. <em>
  3291. <a href="#external-secrets.io/v1.ChefAuthSecretRef">
  3292. ChefAuthSecretRef
  3293. </a>
  3294. </em>
  3295. </td>
  3296. <td>
  3297. </td>
  3298. </tr>
  3299. </tbody>
  3300. </table>
  3301. <h3 id="external-secrets.io/v1.ChefAuthSecretRef">ChefAuthSecretRef
  3302. </h3>
  3303. <p>
  3304. (<em>Appears on:</em>
  3305. <a href="#external-secrets.io/v1.ChefAuth">ChefAuth</a>)
  3306. </p>
  3307. <p>
  3308. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  3309. </p>
  3310. <table>
  3311. <thead>
  3312. <tr>
  3313. <th>Field</th>
  3314. <th>Description</th>
  3315. </tr>
  3316. </thead>
  3317. <tbody>
  3318. <tr>
  3319. <td>
  3320. <code>privateKeySecretRef</code></br>
  3321. <em>
  3322. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  3323. External Secrets meta/v1.SecretKeySelector
  3324. </a>
  3325. </em>
  3326. </td>
  3327. <td>
  3328. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  3329. </td>
  3330. </tr>
  3331. </tbody>
  3332. </table>
  3333. <h3 id="external-secrets.io/v1.ChefProvider">ChefProvider
  3334. </h3>
  3335. <p>
  3336. (<em>Appears on:</em>
  3337. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3338. </p>
  3339. <p>
  3340. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  3341. </p>
  3342. <table>
  3343. <thead>
  3344. <tr>
  3345. <th>Field</th>
  3346. <th>Description</th>
  3347. </tr>
  3348. </thead>
  3349. <tbody>
  3350. <tr>
  3351. <td>
  3352. <code>auth</code></br>
  3353. <em>
  3354. <a href="#external-secrets.io/v1.ChefAuth">
  3355. ChefAuth
  3356. </a>
  3357. </em>
  3358. </td>
  3359. <td>
  3360. <p>Auth defines the information necessary to authenticate against chef Server</p>
  3361. </td>
  3362. </tr>
  3363. <tr>
  3364. <td>
  3365. <code>username</code></br>
  3366. <em>
  3367. string
  3368. </em>
  3369. </td>
  3370. <td>
  3371. <p>UserName should be the user ID on the chef server</p>
  3372. </td>
  3373. </tr>
  3374. <tr>
  3375. <td>
  3376. <code>serverUrl</code></br>
  3377. <em>
  3378. string
  3379. </em>
  3380. </td>
  3381. <td>
  3382. <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>
  3383. </td>
  3384. </tr>
  3385. </tbody>
  3386. </table>
  3387. <h3 id="external-secrets.io/v1.CloudruSMProvider">CloudruSMProvider
  3388. </h3>
  3389. <p>
  3390. (<em>Appears on:</em>
  3391. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  3392. </p>
  3393. <p>
  3394. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  3395. </p>
  3396. <table>
  3397. <thead>
  3398. <tr>
  3399. <th>Field</th>
  3400. <th>Description</th>
  3401. </tr>
  3402. </thead>
  3403. <tbody>
  3404. <tr>
  3405. <td>
  3406. <code>auth</code></br>
  3407. <em>
  3408. <a href="#external-secrets.io/v1.CSMAuth">
  3409. CSMAuth
  3410. </a>
  3411. </em>
  3412. </td>
  3413. <td>
  3414. </td>
  3415. </tr>
  3416. <tr>
  3417. <td>
  3418. <code>projectID</code></br>
  3419. <em>
  3420. string
  3421. </em>
  3422. </td>
  3423. <td>
  3424. <p>ProjectID is the project, which the secrets are stored in.</p>
  3425. </td>
  3426. </tr>
  3427. </tbody>
  3428. </table>
  3429. <h3 id="external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret
  3430. </h3>
  3431. <p>
  3432. <p>ClusterExternalSecret is the Schema for the clusterexternalsecrets API.</p>
  3433. </p>
  3434. <table>
  3435. <thead>
  3436. <tr>
  3437. <th>Field</th>
  3438. <th>Description</th>
  3439. </tr>
  3440. </thead>
  3441. <tbody>
  3442. <tr>
  3443. <td>
  3444. <code>metadata</code></br>
  3445. <em>
  3446. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  3447. Kubernetes meta/v1.ObjectMeta
  3448. </a>
  3449. </em>
  3450. </td>
  3451. <td>
  3452. Refer to the Kubernetes API documentation for the fields of the
  3453. <code>metadata</code> field.
  3454. </td>
  3455. </tr>
  3456. <tr>
  3457. <td>
  3458. <code>spec</code></br>
  3459. <em>
  3460. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">
  3461. ClusterExternalSecretSpec
  3462. </a>
  3463. </em>
  3464. </td>
  3465. <td>
  3466. <br/>
  3467. <br/>
  3468. <table>
  3469. <tr>
  3470. <td>
  3471. <code>externalSecretSpec</code></br>
  3472. <em>
  3473. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3474. ExternalSecretSpec
  3475. </a>
  3476. </em>
  3477. </td>
  3478. <td>
  3479. <p>The spec for the ExternalSecrets to be created</p>
  3480. </td>
  3481. </tr>
  3482. <tr>
  3483. <td>
  3484. <code>externalSecretName</code></br>
  3485. <em>
  3486. string
  3487. </em>
  3488. </td>
  3489. <td>
  3490. <em>(Optional)</em>
  3491. <p>The name of the external secrets to be created.
  3492. Defaults to the name of the ClusterExternalSecret</p>
  3493. </td>
  3494. </tr>
  3495. <tr>
  3496. <td>
  3497. <code>externalSecretMetadata</code></br>
  3498. <em>
  3499. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3500. ExternalSecretMetadata
  3501. </a>
  3502. </em>
  3503. </td>
  3504. <td>
  3505. <em>(Optional)</em>
  3506. <p>The metadata of the external secrets to be created</p>
  3507. </td>
  3508. </tr>
  3509. <tr>
  3510. <td>
  3511. <code>namespaceSelector</code></br>
  3512. <em>
  3513. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3514. Kubernetes meta/v1.LabelSelector
  3515. </a>
  3516. </em>
  3517. </td>
  3518. <td>
  3519. <em>(Optional)</em>
  3520. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3521. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3522. </td>
  3523. </tr>
  3524. <tr>
  3525. <td>
  3526. <code>namespaceSelectors</code></br>
  3527. <em>
  3528. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3529. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3530. </a>
  3531. </em>
  3532. </td>
  3533. <td>
  3534. <em>(Optional)</em>
  3535. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  3536. </td>
  3537. </tr>
  3538. <tr>
  3539. <td>
  3540. <code>namespaces</code></br>
  3541. <em>
  3542. []string
  3543. </em>
  3544. </td>
  3545. <td>
  3546. <em>(Optional)</em>
  3547. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  3548. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3549. </td>
  3550. </tr>
  3551. <tr>
  3552. <td>
  3553. <code>refreshTime</code></br>
  3554. <em>
  3555. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3556. Kubernetes meta/v1.Duration
  3557. </a>
  3558. </em>
  3559. </td>
  3560. <td>
  3561. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  3562. </td>
  3563. </tr>
  3564. </table>
  3565. </td>
  3566. </tr>
  3567. <tr>
  3568. <td>
  3569. <code>status</code></br>
  3570. <em>
  3571. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">
  3572. ClusterExternalSecretStatus
  3573. </a>
  3574. </em>
  3575. </td>
  3576. <td>
  3577. </td>
  3578. </tr>
  3579. </tbody>
  3580. </table>
  3581. <h3 id="external-secrets.io/v1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  3582. (<code>string</code> alias)</p></h3>
  3583. <p>
  3584. (<em>Appears on:</em>
  3585. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  3586. </p>
  3587. <p>
  3588. <p>ClusterExternalSecretConditionType defines a value type for ClusterExternalSecret conditions.</p>
  3589. </p>
  3590. <table>
  3591. <thead>
  3592. <tr>
  3593. <th>Value</th>
  3594. <th>Description</th>
  3595. </tr>
  3596. </thead>
  3597. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  3598. <td><p>ClusterExternalSecretReady is a ClusterExternalSecretConditionType set when the ClusterExternalSecret is ready.</p>
  3599. </td>
  3600. </tr></tbody>
  3601. </table>
  3602. <h3 id="external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  3603. </h3>
  3604. <p>
  3605. (<em>Appears on:</em>
  3606. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  3607. </p>
  3608. <p>
  3609. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  3610. </p>
  3611. <table>
  3612. <thead>
  3613. <tr>
  3614. <th>Field</th>
  3615. <th>Description</th>
  3616. </tr>
  3617. </thead>
  3618. <tbody>
  3619. <tr>
  3620. <td>
  3621. <code>namespace</code></br>
  3622. <em>
  3623. string
  3624. </em>
  3625. </td>
  3626. <td>
  3627. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  3628. </td>
  3629. </tr>
  3630. <tr>
  3631. <td>
  3632. <code>reason</code></br>
  3633. <em>
  3634. string
  3635. </em>
  3636. </td>
  3637. <td>
  3638. <em>(Optional)</em>
  3639. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  3640. </td>
  3641. </tr>
  3642. </tbody>
  3643. </table>
  3644. <h3 id="external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  3645. </h3>
  3646. <p>
  3647. (<em>Appears on:</em>
  3648. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  3649. </p>
  3650. <p>
  3651. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  3652. </p>
  3653. <table>
  3654. <thead>
  3655. <tr>
  3656. <th>Field</th>
  3657. <th>Description</th>
  3658. </tr>
  3659. </thead>
  3660. <tbody>
  3661. <tr>
  3662. <td>
  3663. <code>externalSecretSpec</code></br>
  3664. <em>
  3665. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  3666. ExternalSecretSpec
  3667. </a>
  3668. </em>
  3669. </td>
  3670. <td>
  3671. <p>The spec for the ExternalSecrets to be created</p>
  3672. </td>
  3673. </tr>
  3674. <tr>
  3675. <td>
  3676. <code>externalSecretName</code></br>
  3677. <em>
  3678. string
  3679. </em>
  3680. </td>
  3681. <td>
  3682. <em>(Optional)</em>
  3683. <p>The name of the external secrets to be created.
  3684. Defaults to the name of the ClusterExternalSecret</p>
  3685. </td>
  3686. </tr>
  3687. <tr>
  3688. <td>
  3689. <code>externalSecretMetadata</code></br>
  3690. <em>
  3691. <a href="#external-secrets.io/v1.ExternalSecretMetadata">
  3692. ExternalSecretMetadata
  3693. </a>
  3694. </em>
  3695. </td>
  3696. <td>
  3697. <em>(Optional)</em>
  3698. <p>The metadata of the external secrets to be created</p>
  3699. </td>
  3700. </tr>
  3701. <tr>
  3702. <td>
  3703. <code>namespaceSelector</code></br>
  3704. <em>
  3705. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  3706. Kubernetes meta/v1.LabelSelector
  3707. </a>
  3708. </em>
  3709. </td>
  3710. <td>
  3711. <em>(Optional)</em>
  3712. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in.</p>
  3713. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3714. </td>
  3715. </tr>
  3716. <tr>
  3717. <td>
  3718. <code>namespaceSelectors</code></br>
  3719. <em>
  3720. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  3721. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  3722. </a>
  3723. </em>
  3724. </td>
  3725. <td>
  3726. <em>(Optional)</em>
  3727. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  3728. </td>
  3729. </tr>
  3730. <tr>
  3731. <td>
  3732. <code>namespaces</code></br>
  3733. <em>
  3734. []string
  3735. </em>
  3736. </td>
  3737. <td>
  3738. <em>(Optional)</em>
  3739. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  3740. <p>Deprecated: Use NamespaceSelectors instead.</p>
  3741. </td>
  3742. </tr>
  3743. <tr>
  3744. <td>
  3745. <code>refreshTime</code></br>
  3746. <em>
  3747. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  3748. Kubernetes meta/v1.Duration
  3749. </a>
  3750. </em>
  3751. </td>
  3752. <td>
  3753. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  3754. </td>
  3755. </tr>
  3756. </tbody>
  3757. </table>
  3758. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  3759. </h3>
  3760. <p>
  3761. (<em>Appears on:</em>
  3762. <a href="#external-secrets.io/v1.ClusterExternalSecret">ClusterExternalSecret</a>)
  3763. </p>
  3764. <p>
  3765. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  3766. </p>
  3767. <table>
  3768. <thead>
  3769. <tr>
  3770. <th>Field</th>
  3771. <th>Description</th>
  3772. </tr>
  3773. </thead>
  3774. <tbody>
  3775. <tr>
  3776. <td>
  3777. <code>externalSecretName</code></br>
  3778. <em>
  3779. string
  3780. </em>
  3781. </td>
  3782. <td>
  3783. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  3784. </td>
  3785. </tr>
  3786. <tr>
  3787. <td>
  3788. <code>failedNamespaces</code></br>
  3789. <em>
  3790. <a href="#external-secrets.io/v1.ClusterExternalSecretNamespaceFailure">
  3791. []ClusterExternalSecretNamespaceFailure
  3792. </a>
  3793. </em>
  3794. </td>
  3795. <td>
  3796. <em>(Optional)</em>
  3797. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  3798. </td>
  3799. </tr>
  3800. <tr>
  3801. <td>
  3802. <code>provisionedNamespaces</code></br>
  3803. <em>
  3804. []string
  3805. </em>
  3806. </td>
  3807. <td>
  3808. <em>(Optional)</em>
  3809. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  3810. </td>
  3811. </tr>
  3812. <tr>
  3813. <td>
  3814. <code>conditions</code></br>
  3815. <em>
  3816. <a href="#external-secrets.io/v1.ClusterExternalSecretStatusCondition">
  3817. []ClusterExternalSecretStatusCondition
  3818. </a>
  3819. </em>
  3820. </td>
  3821. <td>
  3822. <em>(Optional)</em>
  3823. </td>
  3824. </tr>
  3825. </tbody>
  3826. </table>
  3827. <h3 id="external-secrets.io/v1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  3828. </h3>
  3829. <p>
  3830. (<em>Appears on:</em>
  3831. <a href="#external-secrets.io/v1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  3832. </p>
  3833. <p>
  3834. <p>ClusterExternalSecretStatusCondition defines the observed state of a ClusterExternalSecret resource.</p>
  3835. </p>
  3836. <table>
  3837. <thead>
  3838. <tr>
  3839. <th>Field</th>
  3840. <th>Description</th>
  3841. </tr>
  3842. </thead>
  3843. <tbody>
  3844. <tr>
  3845. <td>
  3846. <code>type</code></br>
  3847. <em>
  3848. <a href="#external-secrets.io/v1.ClusterExternalSecretConditionType">
  3849. ClusterExternalSecretConditionType
  3850. </a>
  3851. </em>
  3852. </td>
  3853. <td>
  3854. </td>
  3855. </tr>
  3856. <tr>
  3857. <td>
  3858. <code>status</code></br>
  3859. <em>
  3860. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  3861. Kubernetes core/v1.ConditionStatus
  3862. </a>
  3863. </em>
  3864. </td>
  3865. <td>
  3866. </td>
  3867. </tr>
  3868. <tr>
  3869. <td>
  3870. <code>message</code></br>
  3871. <em>
  3872. string
  3873. </em>
  3874. </td>
  3875. <td>
  3876. <em>(Optional)</em>
  3877. </td>
  3878. </tr>
  3879. </tbody>
  3880. </table>
  3881. <h3 id="external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore
  3882. </h3>
  3883. <p>
  3884. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  3885. </p>
  3886. <table>
  3887. <thead>
  3888. <tr>
  3889. <th>Field</th>
  3890. <th>Description</th>
  3891. </tr>
  3892. </thead>
  3893. <tbody>
  3894. <tr>
  3895. <td>
  3896. <code>metadata</code></br>
  3897. <em>
  3898. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  3899. Kubernetes meta/v1.ObjectMeta
  3900. </a>
  3901. </em>
  3902. </td>
  3903. <td>
  3904. Refer to the Kubernetes API documentation for the fields of the
  3905. <code>metadata</code> field.
  3906. </td>
  3907. </tr>
  3908. <tr>
  3909. <td>
  3910. <code>spec</code></br>
  3911. <em>
  3912. <a href="#external-secrets.io/v1.SecretStoreSpec">
  3913. SecretStoreSpec
  3914. </a>
  3915. </em>
  3916. </td>
  3917. <td>
  3918. <br/>
  3919. <br/>
  3920. <table>
  3921. <tr>
  3922. <td>
  3923. <code>controller</code></br>
  3924. <em>
  3925. string
  3926. </em>
  3927. </td>
  3928. <td>
  3929. <em>(Optional)</em>
  3930. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  3931. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  3932. </td>
  3933. </tr>
  3934. <tr>
  3935. <td>
  3936. <code>provider</code></br>
  3937. <em>
  3938. <a href="#external-secrets.io/v1.SecretStoreProvider">
  3939. SecretStoreProvider
  3940. </a>
  3941. </em>
  3942. </td>
  3943. <td>
  3944. <p>Used to configure the provider. Only one provider may be set</p>
  3945. </td>
  3946. </tr>
  3947. <tr>
  3948. <td>
  3949. <code>retrySettings</code></br>
  3950. <em>
  3951. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  3952. SecretStoreRetrySettings
  3953. </a>
  3954. </em>
  3955. </td>
  3956. <td>
  3957. <em>(Optional)</em>
  3958. <p>Used to configure HTTP retries on failures.</p>
  3959. </td>
  3960. </tr>
  3961. <tr>
  3962. <td>
  3963. <code>refreshInterval</code></br>
  3964. <em>
  3965. int
  3966. </em>
  3967. </td>
  3968. <td>
  3969. <em>(Optional)</em>
  3970. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  3971. </td>
  3972. </tr>
  3973. <tr>
  3974. <td>
  3975. <code>conditions</code></br>
  3976. <em>
  3977. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  3978. []ClusterSecretStoreCondition
  3979. </a>
  3980. </em>
  3981. </td>
  3982. <td>
  3983. <em>(Optional)</em>
  3984. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  3985. </td>
  3986. </tr>
  3987. </table>
  3988. </td>
  3989. </tr>
  3990. <tr>
  3991. <td>
  3992. <code>status</code></br>
  3993. <em>
  3994. <a href="#external-secrets.io/v1.SecretStoreStatus">
  3995. SecretStoreStatus
  3996. </a>
  3997. </em>
  3998. </td>
  3999. <td>
  4000. </td>
  4001. </tr>
  4002. </tbody>
  4003. </table>
  4004. <h3 id="external-secrets.io/v1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  4005. </h3>
  4006. <p>
  4007. (<em>Appears on:</em>
  4008. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  4009. </p>
  4010. <p>
  4011. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  4012. for a ClusterSecretStore instance.</p>
  4013. </p>
  4014. <table>
  4015. <thead>
  4016. <tr>
  4017. <th>Field</th>
  4018. <th>Description</th>
  4019. </tr>
  4020. </thead>
  4021. <tbody>
  4022. <tr>
  4023. <td>
  4024. <code>namespaceSelector</code></br>
  4025. <em>
  4026. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  4027. Kubernetes meta/v1.LabelSelector
  4028. </a>
  4029. </em>
  4030. </td>
  4031. <td>
  4032. <em>(Optional)</em>
  4033. <p>Choose namespace using a labelSelector</p>
  4034. </td>
  4035. </tr>
  4036. <tr>
  4037. <td>
  4038. <code>namespaces</code></br>
  4039. <em>
  4040. []string
  4041. </em>
  4042. </td>
  4043. <td>
  4044. <em>(Optional)</em>
  4045. <p>Choose namespaces by name</p>
  4046. </td>
  4047. </tr>
  4048. <tr>
  4049. <td>
  4050. <code>namespaceRegexes</code></br>
  4051. <em>
  4052. []string
  4053. </em>
  4054. </td>
  4055. <td>
  4056. <em>(Optional)</em>
  4057. <p>Choose namespaces by using regex matching</p>
  4058. </td>
  4059. </tr>
  4060. </tbody>
  4061. </table>
  4062. <h3 id="external-secrets.io/v1.ConfigMapReference">ConfigMapReference
  4063. </h3>
  4064. <p>
  4065. (<em>Appears on:</em>
  4066. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation</a>)
  4067. </p>
  4068. <p>
  4069. <p>ConfigMapReference holds the details of a configmap.</p>
  4070. </p>
  4071. <table>
  4072. <thead>
  4073. <tr>
  4074. <th>Field</th>
  4075. <th>Description</th>
  4076. </tr>
  4077. </thead>
  4078. <tbody>
  4079. <tr>
  4080. <td>
  4081. <code>name</code></br>
  4082. <em>
  4083. string
  4084. </em>
  4085. </td>
  4086. <td>
  4087. <p>name of the configmap.</p>
  4088. </td>
  4089. </tr>
  4090. <tr>
  4091. <td>
  4092. <code>namespace</code></br>
  4093. <em>
  4094. string
  4095. </em>
  4096. </td>
  4097. <td>
  4098. <p>namespace in which the configmap exists. If empty, configmap will looked up in local namespace.</p>
  4099. </td>
  4100. </tr>
  4101. <tr>
  4102. <td>
  4103. <code>key</code></br>
  4104. <em>
  4105. string
  4106. </em>
  4107. </td>
  4108. <td>
  4109. <p>key name holding the external account credential config.</p>
  4110. </td>
  4111. </tr>
  4112. </tbody>
  4113. </table>
  4114. <h3 id="external-secrets.io/v1.ConjurAPIKey">ConjurAPIKey
  4115. </h3>
  4116. <p>
  4117. (<em>Appears on:</em>
  4118. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4119. </p>
  4120. <p>
  4121. <p>ConjurAPIKey contains references to a Secret resource that holds
  4122. the Conjur username and API key.</p>
  4123. </p>
  4124. <table>
  4125. <thead>
  4126. <tr>
  4127. <th>Field</th>
  4128. <th>Description</th>
  4129. </tr>
  4130. </thead>
  4131. <tbody>
  4132. <tr>
  4133. <td>
  4134. <code>account</code></br>
  4135. <em>
  4136. string
  4137. </em>
  4138. </td>
  4139. <td>
  4140. <p>Account is the Conjur organization account name.</p>
  4141. </td>
  4142. </tr>
  4143. <tr>
  4144. <td>
  4145. <code>userRef</code></br>
  4146. <em>
  4147. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4148. External Secrets meta/v1.SecretKeySelector
  4149. </a>
  4150. </em>
  4151. </td>
  4152. <td>
  4153. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  4154. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4155. </td>
  4156. </tr>
  4157. <tr>
  4158. <td>
  4159. <code>apiKeyRef</code></br>
  4160. <em>
  4161. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4162. External Secrets meta/v1.SecretKeySelector
  4163. </a>
  4164. </em>
  4165. </td>
  4166. <td>
  4167. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  4168. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  4169. </td>
  4170. </tr>
  4171. </tbody>
  4172. </table>
  4173. <h3 id="external-secrets.io/v1.ConjurAuth">ConjurAuth
  4174. </h3>
  4175. <p>
  4176. (<em>Appears on:</em>
  4177. <a href="#external-secrets.io/v1.ConjurProvider">ConjurProvider</a>)
  4178. </p>
  4179. <p>
  4180. <p>ConjurAuth is the way to provide authentication credentials to the ConjurProvider.</p>
  4181. </p>
  4182. <table>
  4183. <thead>
  4184. <tr>
  4185. <th>Field</th>
  4186. <th>Description</th>
  4187. </tr>
  4188. </thead>
  4189. <tbody>
  4190. <tr>
  4191. <td>
  4192. <code>apikey</code></br>
  4193. <em>
  4194. <a href="#external-secrets.io/v1.ConjurAPIKey">
  4195. ConjurAPIKey
  4196. </a>
  4197. </em>
  4198. </td>
  4199. <td>
  4200. <em>(Optional)</em>
  4201. <p>Authenticates with Conjur using an API key.</p>
  4202. </td>
  4203. </tr>
  4204. <tr>
  4205. <td>
  4206. <code>jwt</code></br>
  4207. <em>
  4208. <a href="#external-secrets.io/v1.ConjurJWT">
  4209. ConjurJWT
  4210. </a>
  4211. </em>
  4212. </td>
  4213. <td>
  4214. <em>(Optional)</em>
  4215. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  4216. </td>
  4217. </tr>
  4218. </tbody>
  4219. </table>
  4220. <h3 id="external-secrets.io/v1.ConjurJWT">ConjurJWT
  4221. </h3>
  4222. <p>
  4223. (<em>Appears on:</em>
  4224. <a href="#external-secrets.io/v1.ConjurAuth">ConjurAuth</a>)
  4225. </p>
  4226. <p>
  4227. <p>ConjurJWT defines the JWT authentication configuration for Conjur provider.</p>
  4228. </p>
  4229. <table>
  4230. <thead>
  4231. <tr>
  4232. <th>Field</th>
  4233. <th>Description</th>
  4234. </tr>
  4235. </thead>
  4236. <tbody>
  4237. <tr>
  4238. <td>
  4239. <code>account</code></br>
  4240. <em>
  4241. string
  4242. </em>
  4243. </td>
  4244. <td>
  4245. <p>Account is the Conjur organization account name.</p>
  4246. </td>
  4247. </tr>
  4248. <tr>
  4249. <td>
  4250. <code>serviceID</code></br>
  4251. <em>
  4252. string
  4253. </em>
  4254. </td>
  4255. <td>
  4256. <p>The conjur authn jwt webservice id</p>
  4257. </td>
  4258. </tr>
  4259. <tr>
  4260. <td>
  4261. <code>hostId</code></br>
  4262. <em>
  4263. string
  4264. </em>
  4265. </td>
  4266. <td>
  4267. <em>(Optional)</em>
  4268. <p>Optional HostID for JWT authentication. This may be used depending
  4269. on how the Conjur JWT authenticator policy is configured.</p>
  4270. </td>
  4271. </tr>
  4272. <tr>
  4273. <td>
  4274. <code>secretRef</code></br>
  4275. <em>
  4276. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4277. External Secrets meta/v1.SecretKeySelector
  4278. </a>
  4279. </em>
  4280. </td>
  4281. <td>
  4282. <em>(Optional)</em>
  4283. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  4284. authenticate with Conjur using the JWT authentication method.</p>
  4285. </td>
  4286. </tr>
  4287. <tr>
  4288. <td>
  4289. <code>serviceAccountRef</code></br>
  4290. <em>
  4291. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  4292. External Secrets meta/v1.ServiceAccountSelector
  4293. </a>
  4294. </em>
  4295. </td>
  4296. <td>
  4297. <em>(Optional)</em>
  4298. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  4299. a token for with the <code>TokenRequest</code> API.</p>
  4300. </td>
  4301. </tr>
  4302. </tbody>
  4303. </table>
  4304. <h3 id="external-secrets.io/v1.ConjurProvider">ConjurProvider
  4305. </h3>
  4306. <p>
  4307. (<em>Appears on:</em>
  4308. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4309. </p>
  4310. <p>
  4311. <p>ConjurProvider provides access to a Conjur provider.</p>
  4312. </p>
  4313. <table>
  4314. <thead>
  4315. <tr>
  4316. <th>Field</th>
  4317. <th>Description</th>
  4318. </tr>
  4319. </thead>
  4320. <tbody>
  4321. <tr>
  4322. <td>
  4323. <code>url</code></br>
  4324. <em>
  4325. string
  4326. </em>
  4327. </td>
  4328. <td>
  4329. <p>URL is the endpoint of the Conjur instance.</p>
  4330. </td>
  4331. </tr>
  4332. <tr>
  4333. <td>
  4334. <code>caBundle</code></br>
  4335. <em>
  4336. string
  4337. </em>
  4338. </td>
  4339. <td>
  4340. <em>(Optional)</em>
  4341. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  4342. </td>
  4343. </tr>
  4344. <tr>
  4345. <td>
  4346. <code>caProvider</code></br>
  4347. <em>
  4348. <a href="#external-secrets.io/v1.CAProvider">
  4349. CAProvider
  4350. </a>
  4351. </em>
  4352. </td>
  4353. <td>
  4354. <em>(Optional)</em>
  4355. <p>Used to provide custom certificate authority (CA) certificates
  4356. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  4357. that contains a PEM-encoded certificate.</p>
  4358. </td>
  4359. </tr>
  4360. <tr>
  4361. <td>
  4362. <code>auth</code></br>
  4363. <em>
  4364. <a href="#external-secrets.io/v1.ConjurAuth">
  4365. ConjurAuth
  4366. </a>
  4367. </em>
  4368. </td>
  4369. <td>
  4370. <p>Defines authentication settings for connecting to Conjur.</p>
  4371. </td>
  4372. </tr>
  4373. </tbody>
  4374. </table>
  4375. <h3 id="external-secrets.io/v1.DVLSAuth">DVLSAuth
  4376. </h3>
  4377. <p>
  4378. (<em>Appears on:</em>
  4379. <a href="#external-secrets.io/v1.DVLSProvider">DVLSProvider</a>)
  4380. </p>
  4381. <p>
  4382. <p>DVLSAuth defines the authentication method for the DVLS provider.</p>
  4383. </p>
  4384. <table>
  4385. <thead>
  4386. <tr>
  4387. <th>Field</th>
  4388. <th>Description</th>
  4389. </tr>
  4390. </thead>
  4391. <tbody>
  4392. <tr>
  4393. <td>
  4394. <code>secretRef</code></br>
  4395. <em>
  4396. <a href="#external-secrets.io/v1.DVLSAuthSecretRef">
  4397. DVLSAuthSecretRef
  4398. </a>
  4399. </em>
  4400. </td>
  4401. <td>
  4402. <p>SecretRef contains the Application ID and Application Secret for authentication.</p>
  4403. </td>
  4404. </tr>
  4405. </tbody>
  4406. </table>
  4407. <h3 id="external-secrets.io/v1.DVLSAuthSecretRef">DVLSAuthSecretRef
  4408. </h3>
  4409. <p>
  4410. (<em>Appears on:</em>
  4411. <a href="#external-secrets.io/v1.DVLSAuth">DVLSAuth</a>)
  4412. </p>
  4413. <p>
  4414. <p>DVLSAuthSecretRef defines the secret references for DVLS authentication credentials.</p>
  4415. </p>
  4416. <table>
  4417. <thead>
  4418. <tr>
  4419. <th>Field</th>
  4420. <th>Description</th>
  4421. </tr>
  4422. </thead>
  4423. <tbody>
  4424. <tr>
  4425. <td>
  4426. <code>appId</code></br>
  4427. <em>
  4428. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4429. External Secrets meta/v1.SecretKeySelector
  4430. </a>
  4431. </em>
  4432. </td>
  4433. <td>
  4434. <p>AppID is the reference to the secret containing the Application ID.</p>
  4435. </td>
  4436. </tr>
  4437. <tr>
  4438. <td>
  4439. <code>appSecret</code></br>
  4440. <em>
  4441. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4442. External Secrets meta/v1.SecretKeySelector
  4443. </a>
  4444. </em>
  4445. </td>
  4446. <td>
  4447. <p>AppSecret is the reference to the secret containing the Application Secret.</p>
  4448. </td>
  4449. </tr>
  4450. </tbody>
  4451. </table>
  4452. <h3 id="external-secrets.io/v1.DVLSProvider">DVLSProvider
  4453. </h3>
  4454. <p>
  4455. (<em>Appears on:</em>
  4456. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4457. </p>
  4458. <p>
  4459. <p>DVLSProvider configures a store to sync secrets using Devolutions Server.</p>
  4460. </p>
  4461. <table>
  4462. <thead>
  4463. <tr>
  4464. <th>Field</th>
  4465. <th>Description</th>
  4466. </tr>
  4467. </thead>
  4468. <tbody>
  4469. <tr>
  4470. <td>
  4471. <code>serverUrl</code></br>
  4472. <em>
  4473. string
  4474. </em>
  4475. </td>
  4476. <td>
  4477. <p>ServerURL is the DVLS instance URL (e.g., <a href="https://dvls.example.com">https://dvls.example.com</a>).</p>
  4478. </td>
  4479. </tr>
  4480. <tr>
  4481. <td>
  4482. <code>insecure</code></br>
  4483. <em>
  4484. bool
  4485. </em>
  4486. </td>
  4487. <td>
  4488. <em>(Optional)</em>
  4489. <p>Insecure allows connecting to DVLS over plain HTTP.
  4490. This is NOT RECOMMENDED for production use.
  4491. Set to true only if you understand the security implications.</p>
  4492. </td>
  4493. </tr>
  4494. <tr>
  4495. <td>
  4496. <code>auth</code></br>
  4497. <em>
  4498. <a href="#external-secrets.io/v1.DVLSAuth">
  4499. DVLSAuth
  4500. </a>
  4501. </em>
  4502. </td>
  4503. <td>
  4504. <p>Auth defines the authentication method to use.</p>
  4505. </td>
  4506. </tr>
  4507. </tbody>
  4508. </table>
  4509. <h3 id="external-secrets.io/v1.DelineaProvider">DelineaProvider
  4510. </h3>
  4511. <p>
  4512. (<em>Appears on:</em>
  4513. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4514. </p>
  4515. <p>
  4516. <p>DelineaProvider provides access to Delinea secrets vault Server.
  4517. 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>
  4518. </p>
  4519. <table>
  4520. <thead>
  4521. <tr>
  4522. <th>Field</th>
  4523. <th>Description</th>
  4524. </tr>
  4525. </thead>
  4526. <tbody>
  4527. <tr>
  4528. <td>
  4529. <code>clientId</code></br>
  4530. <em>
  4531. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4532. DelineaProviderSecretRef
  4533. </a>
  4534. </em>
  4535. </td>
  4536. <td>
  4537. <p>ClientID is the non-secret part of the credential.</p>
  4538. </td>
  4539. </tr>
  4540. <tr>
  4541. <td>
  4542. <code>clientSecret</code></br>
  4543. <em>
  4544. <a href="#external-secrets.io/v1.DelineaProviderSecretRef">
  4545. DelineaProviderSecretRef
  4546. </a>
  4547. </em>
  4548. </td>
  4549. <td>
  4550. <p>ClientSecret is the secret part of the credential.</p>
  4551. </td>
  4552. </tr>
  4553. <tr>
  4554. <td>
  4555. <code>tenant</code></br>
  4556. <em>
  4557. string
  4558. </em>
  4559. </td>
  4560. <td>
  4561. <p>Tenant is the chosen hostname / site name.</p>
  4562. </td>
  4563. </tr>
  4564. <tr>
  4565. <td>
  4566. <code>urlTemplate</code></br>
  4567. <em>
  4568. string
  4569. </em>
  4570. </td>
  4571. <td>
  4572. <em>(Optional)</em>
  4573. <p>URLTemplate
  4574. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  4575. </td>
  4576. </tr>
  4577. <tr>
  4578. <td>
  4579. <code>tld</code></br>
  4580. <em>
  4581. string
  4582. </em>
  4583. </td>
  4584. <td>
  4585. <em>(Optional)</em>
  4586. <p>TLD is based on the server location that was chosen during provisioning.
  4587. If unset, defaults to &ldquo;com&rdquo;.</p>
  4588. </td>
  4589. </tr>
  4590. </tbody>
  4591. </table>
  4592. <h3 id="external-secrets.io/v1.DelineaProviderSecretRef">DelineaProviderSecretRef
  4593. </h3>
  4594. <p>
  4595. (<em>Appears on:</em>
  4596. <a href="#external-secrets.io/v1.DelineaProvider">DelineaProvider</a>)
  4597. </p>
  4598. <p>
  4599. <p>DelineaProviderSecretRef is a secret reference containing either a direct value or a reference to a secret key.</p>
  4600. </p>
  4601. <table>
  4602. <thead>
  4603. <tr>
  4604. <th>Field</th>
  4605. <th>Description</th>
  4606. </tr>
  4607. </thead>
  4608. <tbody>
  4609. <tr>
  4610. <td>
  4611. <code>value</code></br>
  4612. <em>
  4613. string
  4614. </em>
  4615. </td>
  4616. <td>
  4617. <em>(Optional)</em>
  4618. <p>Value can be specified directly to set a value without using a secret.</p>
  4619. </td>
  4620. </tr>
  4621. <tr>
  4622. <td>
  4623. <code>secretRef</code></br>
  4624. <em>
  4625. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4626. External Secrets meta/v1.SecretKeySelector
  4627. </a>
  4628. </em>
  4629. </td>
  4630. <td>
  4631. <em>(Optional)</em>
  4632. <p>SecretRef references a key in a secret that will be used as value.</p>
  4633. </td>
  4634. </tr>
  4635. </tbody>
  4636. </table>
  4637. <h3 id="external-secrets.io/v1.DopplerAuth">DopplerAuth
  4638. </h3>
  4639. <p>
  4640. (<em>Appears on:</em>
  4641. <a href="#external-secrets.io/v1.DopplerProvider">DopplerProvider</a>)
  4642. </p>
  4643. <p>
  4644. <p>DopplerAuth configures authentication with the Doppler API.
  4645. Exactly one of secretRef or oidcConfig must be specified.</p>
  4646. </p>
  4647. <table>
  4648. <thead>
  4649. <tr>
  4650. <th>Field</th>
  4651. <th>Description</th>
  4652. </tr>
  4653. </thead>
  4654. <tbody>
  4655. <tr>
  4656. <td>
  4657. <code>secretRef</code></br>
  4658. <em>
  4659. <a href="#external-secrets.io/v1.DopplerAuthSecretRef">
  4660. DopplerAuthSecretRef
  4661. </a>
  4662. </em>
  4663. </td>
  4664. <td>
  4665. <em>(Optional)</em>
  4666. <p>SecretRef authenticates using a Doppler service token stored in a Kubernetes Secret.</p>
  4667. </td>
  4668. </tr>
  4669. <tr>
  4670. <td>
  4671. <code>oidcConfig</code></br>
  4672. <em>
  4673. <a href="#external-secrets.io/v1.DopplerOIDCAuth">
  4674. DopplerOIDCAuth
  4675. </a>
  4676. </em>
  4677. </td>
  4678. <td>
  4679. <em>(Optional)</em>
  4680. <p>OIDCConfig authenticates using Kubernetes ServiceAccount tokens via OIDC.</p>
  4681. </td>
  4682. </tr>
  4683. </tbody>
  4684. </table>
  4685. <h3 id="external-secrets.io/v1.DopplerAuthSecretRef">DopplerAuthSecretRef
  4686. </h3>
  4687. <p>
  4688. (<em>Appears on:</em>
  4689. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  4690. </p>
  4691. <p>
  4692. <p>DopplerAuthSecretRef contains the secret reference for accessing the Doppler API.</p>
  4693. </p>
  4694. <table>
  4695. <thead>
  4696. <tr>
  4697. <th>Field</th>
  4698. <th>Description</th>
  4699. </tr>
  4700. </thead>
  4701. <tbody>
  4702. <tr>
  4703. <td>
  4704. <code>dopplerToken</code></br>
  4705. <em>
  4706. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  4707. External Secrets meta/v1.SecretKeySelector
  4708. </a>
  4709. </em>
  4710. </td>
  4711. <td>
  4712. <p>The DopplerToken is used for authentication.
  4713. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  4714. The Key attribute defaults to dopplerToken if not specified.</p>
  4715. </td>
  4716. </tr>
  4717. </tbody>
  4718. </table>
  4719. <h3 id="external-secrets.io/v1.DopplerOIDCAuth">DopplerOIDCAuth
  4720. </h3>
  4721. <p>
  4722. (<em>Appears on:</em>
  4723. <a href="#external-secrets.io/v1.DopplerAuth">DopplerAuth</a>)
  4724. </p>
  4725. <p>
  4726. <p>DopplerOIDCAuth configures OIDC authentication with Doppler using Kubernetes ServiceAccount tokens.</p>
  4727. </p>
  4728. <table>
  4729. <thead>
  4730. <tr>
  4731. <th>Field</th>
  4732. <th>Description</th>
  4733. </tr>
  4734. </thead>
  4735. <tbody>
  4736. <tr>
  4737. <td>
  4738. <code>identity</code></br>
  4739. <em>
  4740. string
  4741. </em>
  4742. </td>
  4743. <td>
  4744. <p>Identity is the Doppler Service Account Identity ID configured for OIDC authentication.</p>
  4745. </td>
  4746. </tr>
  4747. <tr>
  4748. <td>
  4749. <code>serviceAccountRef</code></br>
  4750. <em>
  4751. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  4752. External Secrets meta/v1.ServiceAccountSelector
  4753. </a>
  4754. </em>
  4755. </td>
  4756. <td>
  4757. <p>ServiceAccountRef specifies the Kubernetes ServiceAccount to use for authentication.</p>
  4758. </td>
  4759. </tr>
  4760. <tr>
  4761. <td>
  4762. <code>expirationSeconds</code></br>
  4763. <em>
  4764. int64
  4765. </em>
  4766. </td>
  4767. <td>
  4768. <em>(Optional)</em>
  4769. <p>ExpirationSeconds sets the ServiceAccount token validity duration.
  4770. Defaults to 10 minutes.</p>
  4771. </td>
  4772. </tr>
  4773. </tbody>
  4774. </table>
  4775. <h3 id="external-secrets.io/v1.DopplerProvider">DopplerProvider
  4776. </h3>
  4777. <p>
  4778. (<em>Appears on:</em>
  4779. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  4780. </p>
  4781. <p>
  4782. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  4783. Project and Config are required if not using a Service Token.</p>
  4784. </p>
  4785. <table>
  4786. <thead>
  4787. <tr>
  4788. <th>Field</th>
  4789. <th>Description</th>
  4790. </tr>
  4791. </thead>
  4792. <tbody>
  4793. <tr>
  4794. <td>
  4795. <code>auth</code></br>
  4796. <em>
  4797. <a href="#external-secrets.io/v1.DopplerAuth">
  4798. DopplerAuth
  4799. </a>
  4800. </em>
  4801. </td>
  4802. <td>
  4803. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  4804. </td>
  4805. </tr>
  4806. <tr>
  4807. <td>
  4808. <code>project</code></br>
  4809. <em>
  4810. string
  4811. </em>
  4812. </td>
  4813. <td>
  4814. <em>(Optional)</em>
  4815. <p>Doppler project (required if not using a Service Token)</p>
  4816. </td>
  4817. </tr>
  4818. <tr>
  4819. <td>
  4820. <code>config</code></br>
  4821. <em>
  4822. string
  4823. </em>
  4824. </td>
  4825. <td>
  4826. <em>(Optional)</em>
  4827. <p>Doppler config (required if not using a Service Token)</p>
  4828. </td>
  4829. </tr>
  4830. <tr>
  4831. <td>
  4832. <code>nameTransformer</code></br>
  4833. <em>
  4834. string
  4835. </em>
  4836. </td>
  4837. <td>
  4838. <em>(Optional)</em>
  4839. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  4840. </td>
  4841. </tr>
  4842. <tr>
  4843. <td>
  4844. <code>format</code></br>
  4845. <em>
  4846. string
  4847. </em>
  4848. </td>
  4849. <td>
  4850. <em>(Optional)</em>
  4851. <p>Format enables the downloading of secrets as a file (string)</p>
  4852. </td>
  4853. </tr>
  4854. </tbody>
  4855. </table>
  4856. <h3 id="external-secrets.io/v1.ExternalSecret">ExternalSecret
  4857. </h3>
  4858. <p>
  4859. <p>ExternalSecret is the Schema for the external-secrets API.
  4860. It defines how to fetch data from external APIs and make it available as Kubernetes Secrets.</p>
  4861. </p>
  4862. <table>
  4863. <thead>
  4864. <tr>
  4865. <th>Field</th>
  4866. <th>Description</th>
  4867. </tr>
  4868. </thead>
  4869. <tbody>
  4870. <tr>
  4871. <td>
  4872. <code>metadata</code></br>
  4873. <em>
  4874. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  4875. Kubernetes meta/v1.ObjectMeta
  4876. </a>
  4877. </em>
  4878. </td>
  4879. <td>
  4880. Refer to the Kubernetes API documentation for the fields of the
  4881. <code>metadata</code> field.
  4882. </td>
  4883. </tr>
  4884. <tr>
  4885. <td>
  4886. <code>spec</code></br>
  4887. <em>
  4888. <a href="#external-secrets.io/v1.ExternalSecretSpec">
  4889. ExternalSecretSpec
  4890. </a>
  4891. </em>
  4892. </td>
  4893. <td>
  4894. <br/>
  4895. <br/>
  4896. <table>
  4897. <tr>
  4898. <td>
  4899. <code>secretStoreRef</code></br>
  4900. <em>
  4901. <a href="#external-secrets.io/v1.SecretStoreRef">
  4902. SecretStoreRef
  4903. </a>
  4904. </em>
  4905. </td>
  4906. <td>
  4907. <em>(Optional)</em>
  4908. </td>
  4909. </tr>
  4910. <tr>
  4911. <td>
  4912. <code>target</code></br>
  4913. <em>
  4914. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  4915. ExternalSecretTarget
  4916. </a>
  4917. </em>
  4918. </td>
  4919. <td>
  4920. <em>(Optional)</em>
  4921. </td>
  4922. </tr>
  4923. <tr>
  4924. <td>
  4925. <code>refreshPolicy</code></br>
  4926. <em>
  4927. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  4928. ExternalSecretRefreshPolicy
  4929. </a>
  4930. </em>
  4931. </td>
  4932. <td>
  4933. <em>(Optional)</em>
  4934. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  4935. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  4936. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  4937. No periodic updates occur if refreshInterval is 0.
  4938. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  4939. </td>
  4940. </tr>
  4941. <tr>
  4942. <td>
  4943. <code>refreshInterval</code></br>
  4944. <em>
  4945. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  4946. Kubernetes meta/v1.Duration
  4947. </a>
  4948. </em>
  4949. </td>
  4950. <td>
  4951. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  4952. specified as Golang Duration strings.
  4953. 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;
  4954. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  4955. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  4956. </td>
  4957. </tr>
  4958. <tr>
  4959. <td>
  4960. <code>data</code></br>
  4961. <em>
  4962. <a href="#external-secrets.io/v1.ExternalSecretData">
  4963. []ExternalSecretData
  4964. </a>
  4965. </em>
  4966. </td>
  4967. <td>
  4968. <em>(Optional)</em>
  4969. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  4970. </td>
  4971. </tr>
  4972. <tr>
  4973. <td>
  4974. <code>dataFrom</code></br>
  4975. <em>
  4976. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  4977. []ExternalSecretDataFromRemoteRef
  4978. </a>
  4979. </em>
  4980. </td>
  4981. <td>
  4982. <em>(Optional)</em>
  4983. <p>DataFrom is used to fetch all properties from a specific Provider data
  4984. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  4985. </td>
  4986. </tr>
  4987. </table>
  4988. </td>
  4989. </tr>
  4990. <tr>
  4991. <td>
  4992. <code>status</code></br>
  4993. <em>
  4994. <a href="#external-secrets.io/v1.ExternalSecretStatus">
  4995. ExternalSecretStatus
  4996. </a>
  4997. </em>
  4998. </td>
  4999. <td>
  5000. </td>
  5001. </tr>
  5002. </tbody>
  5003. </table>
  5004. <h3 id="external-secrets.io/v1.ExternalSecretConditionType">ExternalSecretConditionType
  5005. (<code>string</code> alias)</p></h3>
  5006. <p>
  5007. (<em>Appears on:</em>
  5008. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  5009. </p>
  5010. <p>
  5011. <p>ExternalSecretConditionType defines a value type for ExternalSecret conditions.</p>
  5012. </p>
  5013. <table>
  5014. <thead>
  5015. <tr>
  5016. <th>Value</th>
  5017. <th>Description</th>
  5018. </tr>
  5019. </thead>
  5020. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  5021. <td><p>ExternalSecretDeleted indicates that the external secret has been deleted.</p>
  5022. </td>
  5023. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  5024. <td><p>ExternalSecretReady indicates that the external secret is ready and synced.</p>
  5025. </td>
  5026. </tr></tbody>
  5027. </table>
  5028. <h3 id="external-secrets.io/v1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  5029. (<code>string</code> alias)</p></h3>
  5030. <p>
  5031. (<em>Appears on:</em>
  5032. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5033. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5034. </p>
  5035. <p>
  5036. <p>ExternalSecretConversionStrategy defines strategies for converting secret values.</p>
  5037. </p>
  5038. <table>
  5039. <thead>
  5040. <tr>
  5041. <th>Value</th>
  5042. <th>Description</th>
  5043. </tr>
  5044. </thead>
  5045. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  5046. <td><p>ExternalSecretConversionDefault specifies the default conversion strategy.</p>
  5047. </td>
  5048. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  5049. <td><p>ExternalSecretConversionUnicode specifies that values should be treated as Unicode.</p>
  5050. </td>
  5051. </tr></tbody>
  5052. </table>
  5053. <h3 id="external-secrets.io/v1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  5054. (<code>string</code> alias)</p></h3>
  5055. <p>
  5056. (<em>Appears on:</em>
  5057. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5058. </p>
  5059. <p>
  5060. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  5061. </p>
  5062. <table>
  5063. <thead>
  5064. <tr>
  5065. <th>Value</th>
  5066. <th>Description</th>
  5067. </tr>
  5068. </thead>
  5069. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  5070. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  5071. </td>
  5072. </tr><tr><td><p>&#34;None&#34;</p></td>
  5073. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  5074. </td>
  5075. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  5076. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  5077. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  5078. </td>
  5079. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  5080. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  5081. </td>
  5082. </tr></tbody>
  5083. </table>
  5084. <h3 id="external-secrets.io/v1.ExternalSecretData">ExternalSecretData
  5085. </h3>
  5086. <p>
  5087. (<em>Appears on:</em>
  5088. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5089. </p>
  5090. <p>
  5091. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  5092. </p>
  5093. <table>
  5094. <thead>
  5095. <tr>
  5096. <th>Field</th>
  5097. <th>Description</th>
  5098. </tr>
  5099. </thead>
  5100. <tbody>
  5101. <tr>
  5102. <td>
  5103. <code>secretKey</code></br>
  5104. <em>
  5105. string
  5106. </em>
  5107. </td>
  5108. <td>
  5109. <p>The key in the Kubernetes Secret to store the value.</p>
  5110. </td>
  5111. </tr>
  5112. <tr>
  5113. <td>
  5114. <code>remoteRef</code></br>
  5115. <em>
  5116. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5117. ExternalSecretDataRemoteRef
  5118. </a>
  5119. </em>
  5120. </td>
  5121. <td>
  5122. <p>RemoteRef points to the remote secret and defines
  5123. which secret (version/property/..) to fetch.</p>
  5124. </td>
  5125. </tr>
  5126. <tr>
  5127. <td>
  5128. <code>sourceRef</code></br>
  5129. <em>
  5130. <a href="#external-secrets.io/v1.StoreSourceRef">
  5131. StoreSourceRef
  5132. </a>
  5133. </em>
  5134. </td>
  5135. <td>
  5136. <p>SourceRef allows you to override the source
  5137. from which the value will be pulled.</p>
  5138. </td>
  5139. </tr>
  5140. </tbody>
  5141. </table>
  5142. <h3 id="external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  5143. </h3>
  5144. <p>
  5145. (<em>Appears on:</em>
  5146. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5147. </p>
  5148. <p>
  5149. <p>ExternalSecretDataFromRemoteRef defines the connection between the Kubernetes Secret keys and the Provider data
  5150. when using DataFrom to fetch multiple values from a Provider.</p>
  5151. </p>
  5152. <table>
  5153. <thead>
  5154. <tr>
  5155. <th>Field</th>
  5156. <th>Description</th>
  5157. </tr>
  5158. </thead>
  5159. <tbody>
  5160. <tr>
  5161. <td>
  5162. <code>extract</code></br>
  5163. <em>
  5164. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">
  5165. ExternalSecretDataRemoteRef
  5166. </a>
  5167. </em>
  5168. </td>
  5169. <td>
  5170. <em>(Optional)</em>
  5171. <p>Used to extract multiple key/value pairs from one secret
  5172. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5173. </td>
  5174. </tr>
  5175. <tr>
  5176. <td>
  5177. <code>find</code></br>
  5178. <em>
  5179. <a href="#external-secrets.io/v1.ExternalSecretFind">
  5180. ExternalSecretFind
  5181. </a>
  5182. </em>
  5183. </td>
  5184. <td>
  5185. <em>(Optional)</em>
  5186. <p>Used to find secrets based on tags or regular expressions
  5187. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  5188. </td>
  5189. </tr>
  5190. <tr>
  5191. <td>
  5192. <code>rewrite</code></br>
  5193. <em>
  5194. <a href="#external-secrets.io/v1.ExternalSecretRewrite">
  5195. []ExternalSecretRewrite
  5196. </a>
  5197. </em>
  5198. </td>
  5199. <td>
  5200. <em>(Optional)</em>
  5201. <p>Used to rewrite secret Keys after getting them from the secret Provider
  5202. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  5203. </td>
  5204. </tr>
  5205. <tr>
  5206. <td>
  5207. <code>sourceRef</code></br>
  5208. <em>
  5209. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">
  5210. StoreGeneratorSourceRef
  5211. </a>
  5212. </em>
  5213. </td>
  5214. <td>
  5215. <p>SourceRef points to a store or generator
  5216. which contains secret values ready to use.
  5217. Use this in combination with Extract or Find pull values out of
  5218. a specific SecretStore.
  5219. When sourceRef points to a generator Extract or Find is not supported.
  5220. The generator returns a static map of values</p>
  5221. </td>
  5222. </tr>
  5223. </tbody>
  5224. </table>
  5225. <h3 id="external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  5226. </h3>
  5227. <p>
  5228. (<em>Appears on:</em>
  5229. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>,
  5230. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5231. </p>
  5232. <p>
  5233. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  5234. </p>
  5235. <table>
  5236. <thead>
  5237. <tr>
  5238. <th>Field</th>
  5239. <th>Description</th>
  5240. </tr>
  5241. </thead>
  5242. <tbody>
  5243. <tr>
  5244. <td>
  5245. <code>key</code></br>
  5246. <em>
  5247. string
  5248. </em>
  5249. </td>
  5250. <td>
  5251. <p>Key is the key used in the Provider, mandatory</p>
  5252. </td>
  5253. </tr>
  5254. <tr>
  5255. <td>
  5256. <code>metadataPolicy</code></br>
  5257. <em>
  5258. <a href="#external-secrets.io/v1.ExternalSecretMetadataPolicy">
  5259. ExternalSecretMetadataPolicy
  5260. </a>
  5261. </em>
  5262. </td>
  5263. <td>
  5264. <em>(Optional)</em>
  5265. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  5266. </td>
  5267. </tr>
  5268. <tr>
  5269. <td>
  5270. <code>property</code></br>
  5271. <em>
  5272. string
  5273. </em>
  5274. </td>
  5275. <td>
  5276. <em>(Optional)</em>
  5277. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  5278. </td>
  5279. </tr>
  5280. <tr>
  5281. <td>
  5282. <code>version</code></br>
  5283. <em>
  5284. string
  5285. </em>
  5286. </td>
  5287. <td>
  5288. <em>(Optional)</em>
  5289. <p>Used to select a specific version of the Provider value, if supported</p>
  5290. </td>
  5291. </tr>
  5292. <tr>
  5293. <td>
  5294. <code>conversionStrategy</code></br>
  5295. <em>
  5296. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5297. ExternalSecretConversionStrategy
  5298. </a>
  5299. </em>
  5300. </td>
  5301. <td>
  5302. <em>(Optional)</em>
  5303. <p>Used to define a conversion Strategy</p>
  5304. </td>
  5305. </tr>
  5306. <tr>
  5307. <td>
  5308. <code>decodingStrategy</code></br>
  5309. <em>
  5310. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5311. ExternalSecretDecodingStrategy
  5312. </a>
  5313. </em>
  5314. </td>
  5315. <td>
  5316. <em>(Optional)</em>
  5317. <p>Used to define a decoding Strategy</p>
  5318. </td>
  5319. </tr>
  5320. </tbody>
  5321. </table>
  5322. <h3 id="external-secrets.io/v1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  5323. (<code>string</code> alias)</p></h3>
  5324. <p>
  5325. (<em>Appears on:</em>
  5326. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  5327. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  5328. </p>
  5329. <p>
  5330. <p>ExternalSecretDecodingStrategy defines strategies for decoding secret values.</p>
  5331. </p>
  5332. <table>
  5333. <thead>
  5334. <tr>
  5335. <th>Value</th>
  5336. <th>Description</th>
  5337. </tr>
  5338. </thead>
  5339. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  5340. <td><p>ExternalSecretDecodeAuto specifies automatic detection of the decoding method.</p>
  5341. </td>
  5342. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  5343. <td><p>ExternalSecretDecodeBase64 specifies that values should be decoded using Base64.</p>
  5344. </td>
  5345. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  5346. <td><p>ExternalSecretDecodeBase64URL specifies that values should be decoded using Base64URL.</p>
  5347. </td>
  5348. </tr><tr><td><p>&#34;None&#34;</p></td>
  5349. <td><p>ExternalSecretDecodeNone specifies that no decoding should be performed.</p>
  5350. </td>
  5351. </tr></tbody>
  5352. </table>
  5353. <h3 id="external-secrets.io/v1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  5354. (<code>string</code> alias)</p></h3>
  5355. <p>
  5356. (<em>Appears on:</em>
  5357. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  5358. </p>
  5359. <p>
  5360. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  5361. </p>
  5362. <table>
  5363. <thead>
  5364. <tr>
  5365. <th>Value</th>
  5366. <th>Description</th>
  5367. </tr>
  5368. </thead>
  5369. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  5370. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  5371. If a secret gets deleted on the provider side and is not accessible
  5372. anymore this is not considered an error and the ExternalSecret
  5373. does not go into SecretSyncedError status.</p>
  5374. </td>
  5375. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  5376. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  5377. If a secret gets deleted on the provider side and is not accessible
  5378. anymore this is not considered an error and the ExternalSecret
  5379. does not go into SecretSyncedError status.</p>
  5380. </td>
  5381. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  5382. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  5383. If a provider secret does not exist the ExternalSecret gets into the
  5384. SecretSyncedError status.</p>
  5385. </td>
  5386. </tr></tbody>
  5387. </table>
  5388. <h3 id="external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind
  5389. </h3>
  5390. <p>
  5391. (<em>Appears on:</em>
  5392. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5393. </p>
  5394. <p>
  5395. <p>ExternalSecretFind defines configuration for finding secrets in the provider.</p>
  5396. </p>
  5397. <table>
  5398. <thead>
  5399. <tr>
  5400. <th>Field</th>
  5401. <th>Description</th>
  5402. </tr>
  5403. </thead>
  5404. <tbody>
  5405. <tr>
  5406. <td>
  5407. <code>path</code></br>
  5408. <em>
  5409. string
  5410. </em>
  5411. </td>
  5412. <td>
  5413. <em>(Optional)</em>
  5414. <p>A root path to start the find operations.</p>
  5415. </td>
  5416. </tr>
  5417. <tr>
  5418. <td>
  5419. <code>name</code></br>
  5420. <em>
  5421. <a href="#external-secrets.io/v1.FindName">
  5422. FindName
  5423. </a>
  5424. </em>
  5425. </td>
  5426. <td>
  5427. <em>(Optional)</em>
  5428. <p>Finds secrets based on the name.</p>
  5429. </td>
  5430. </tr>
  5431. <tr>
  5432. <td>
  5433. <code>tags</code></br>
  5434. <em>
  5435. map[string]string
  5436. </em>
  5437. </td>
  5438. <td>
  5439. <em>(Optional)</em>
  5440. <p>Find secrets based on tags.</p>
  5441. </td>
  5442. </tr>
  5443. <tr>
  5444. <td>
  5445. <code>conversionStrategy</code></br>
  5446. <em>
  5447. <a href="#external-secrets.io/v1.ExternalSecretConversionStrategy">
  5448. ExternalSecretConversionStrategy
  5449. </a>
  5450. </em>
  5451. </td>
  5452. <td>
  5453. <em>(Optional)</em>
  5454. <p>Used to define a conversion Strategy</p>
  5455. </td>
  5456. </tr>
  5457. <tr>
  5458. <td>
  5459. <code>decodingStrategy</code></br>
  5460. <em>
  5461. <a href="#external-secrets.io/v1.ExternalSecretDecodingStrategy">
  5462. ExternalSecretDecodingStrategy
  5463. </a>
  5464. </em>
  5465. </td>
  5466. <td>
  5467. <em>(Optional)</em>
  5468. <p>Used to define a decoding Strategy</p>
  5469. </td>
  5470. </tr>
  5471. </tbody>
  5472. </table>
  5473. <h3 id="external-secrets.io/v1.ExternalSecretMetadata">ExternalSecretMetadata
  5474. </h3>
  5475. <p>
  5476. (<em>Appears on:</em>
  5477. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  5478. </p>
  5479. <p>
  5480. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  5481. </p>
  5482. <table>
  5483. <thead>
  5484. <tr>
  5485. <th>Field</th>
  5486. <th>Description</th>
  5487. </tr>
  5488. </thead>
  5489. <tbody>
  5490. <tr>
  5491. <td>
  5492. <code>annotations</code></br>
  5493. <em>
  5494. map[string]string
  5495. </em>
  5496. </td>
  5497. <td>
  5498. <em>(Optional)</em>
  5499. </td>
  5500. </tr>
  5501. <tr>
  5502. <td>
  5503. <code>labels</code></br>
  5504. <em>
  5505. map[string]string
  5506. </em>
  5507. </td>
  5508. <td>
  5509. <em>(Optional)</em>
  5510. </td>
  5511. </tr>
  5512. </tbody>
  5513. </table>
  5514. <h3 id="external-secrets.io/v1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  5515. (<code>string</code> alias)</p></h3>
  5516. <p>
  5517. (<em>Appears on:</em>
  5518. <a href="#external-secrets.io/v1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  5519. </p>
  5520. <p>
  5521. <p>ExternalSecretMetadataPolicy defines policies for fetching metadata from provider secrets.</p>
  5522. </p>
  5523. <table>
  5524. <thead>
  5525. <tr>
  5526. <th>Value</th>
  5527. <th>Description</th>
  5528. </tr>
  5529. </thead>
  5530. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  5531. <td><p>ExternalSecretMetadataPolicyFetch specifies that metadata should be fetched from the provider.</p>
  5532. </td>
  5533. </tr><tr><td><p>&#34;None&#34;</p></td>
  5534. <td><p>ExternalSecretMetadataPolicyNone specifies that no metadata should be fetched from the provider.</p>
  5535. </td>
  5536. </tr></tbody>
  5537. </table>
  5538. <h3 id="external-secrets.io/v1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  5539. (<code>string</code> alias)</p></h3>
  5540. <p>
  5541. (<em>Appears on:</em>
  5542. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  5543. </p>
  5544. <p>
  5545. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  5546. </p>
  5547. <table>
  5548. <thead>
  5549. <tr>
  5550. <th>Value</th>
  5551. <th>Description</th>
  5552. </tr>
  5553. </thead>
  5554. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  5555. <td><p>RefreshPolicyCreatedOnce creates the Secret once and does not update it thereafter.</p>
  5556. </td>
  5557. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  5558. <td><p>RefreshPolicyOnChange only synchronizes when the ExternalSecret&rsquo;s metadata or spec changes.</p>
  5559. </td>
  5560. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  5561. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the provider at regular intervals.</p>
  5562. </td>
  5563. </tr></tbody>
  5564. </table>
  5565. <h3 id="external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite
  5566. </h3>
  5567. <p>
  5568. (<em>Appears on:</em>
  5569. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  5570. </p>
  5571. <p>
  5572. <p>ExternalSecretRewrite defines how to rewrite secret data values before they are written to the Secret.</p>
  5573. </p>
  5574. <table>
  5575. <thead>
  5576. <tr>
  5577. <th>Field</th>
  5578. <th>Description</th>
  5579. </tr>
  5580. </thead>
  5581. <tbody>
  5582. <tr>
  5583. <td>
  5584. <code>merge</code></br>
  5585. <em>
  5586. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">
  5587. ExternalSecretRewriteMerge
  5588. </a>
  5589. </em>
  5590. </td>
  5591. <td>
  5592. <em>(Optional)</em>
  5593. <p>Used to merge key/values in one single Secret
  5594. The resulting key will contain all values from the specified secrets</p>
  5595. </td>
  5596. </tr>
  5597. <tr>
  5598. <td>
  5599. <code>regexp</code></br>
  5600. <em>
  5601. <a href="#external-secrets.io/v1.ExternalSecretRewriteRegexp">
  5602. ExternalSecretRewriteRegexp
  5603. </a>
  5604. </em>
  5605. </td>
  5606. <td>
  5607. <em>(Optional)</em>
  5608. <p>Used to rewrite with regular expressions.
  5609. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  5610. </td>
  5611. </tr>
  5612. <tr>
  5613. <td>
  5614. <code>transform</code></br>
  5615. <em>
  5616. <a href="#external-secrets.io/v1.ExternalSecretRewriteTransform">
  5617. ExternalSecretRewriteTransform
  5618. </a>
  5619. </em>
  5620. </td>
  5621. <td>
  5622. <em>(Optional)</em>
  5623. <p>Used to apply string transformation on the secrets.
  5624. The resulting key will be the output of the template applied by the operation.</p>
  5625. </td>
  5626. </tr>
  5627. </tbody>
  5628. </table>
  5629. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge
  5630. </h3>
  5631. <p>
  5632. (<em>Appears on:</em>
  5633. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  5634. </p>
  5635. <p>
  5636. <p>ExternalSecretRewriteMerge defines configuration for merging secret values.</p>
  5637. </p>
  5638. <table>
  5639. <thead>
  5640. <tr>
  5641. <th>Field</th>
  5642. <th>Description</th>
  5643. </tr>
  5644. </thead>
  5645. <tbody>
  5646. <tr>
  5647. <td>
  5648. <code>into</code></br>
  5649. <em>
  5650. string
  5651. </em>
  5652. </td>
  5653. <td>
  5654. <em>(Optional)</em>
  5655. <p>Used to define the target key of the merge operation.
  5656. Required if strategy is JSON. Ignored otherwise.</p>
  5657. </td>
  5658. </tr>
  5659. <tr>
  5660. <td>
  5661. <code>priority</code></br>
  5662. <em>
  5663. []string
  5664. </em>
  5665. </td>
  5666. <td>
  5667. <em>(Optional)</em>
  5668. <p>Used to define key priority in conflict resolution.</p>
  5669. </td>
  5670. </tr>
  5671. <tr>
  5672. <td>
  5673. <code>priorityPolicy</code></br>
  5674. <em>
  5675. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">
  5676. ExternalSecretRewriteMergePriorityPolicy
  5677. </a>
  5678. </em>
  5679. </td>
  5680. <td>
  5681. <em>(Optional)</em>
  5682. <p>Used to define the policy when a key in the priority list does not exist in the input.</p>
  5683. </td>
  5684. </tr>
  5685. <tr>
  5686. <td>
  5687. <code>conflictPolicy</code></br>
  5688. <em>
  5689. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">
  5690. ExternalSecretRewriteMergeConflictPolicy
  5691. </a>
  5692. </em>
  5693. </td>
  5694. <td>
  5695. <em>(Optional)</em>
  5696. <p>Used to define the policy to use in conflict resolution.</p>
  5697. </td>
  5698. </tr>
  5699. <tr>
  5700. <td>
  5701. <code>strategy</code></br>
  5702. <em>
  5703. <a href="#external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">
  5704. ExternalSecretRewriteMergeStrategy
  5705. </a>
  5706. </em>
  5707. </td>
  5708. <td>
  5709. <em>(Optional)</em>
  5710. <p>Used to define the strategy to use in the merge operation.</p>
  5711. </td>
  5712. </tr>
  5713. </tbody>
  5714. </table>
  5715. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeConflictPolicy">ExternalSecretRewriteMergeConflictPolicy
  5716. (<code>string</code> alias)</p></h3>
  5717. <p>
  5718. (<em>Appears on:</em>
  5719. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  5720. </p>
  5721. <p>
  5722. <p>ExternalSecretRewriteMergeConflictPolicy defines the policy for resolving conflicts when merging secrets.</p>
  5723. </p>
  5724. <table>
  5725. <thead>
  5726. <tr>
  5727. <th>Value</th>
  5728. <th>Description</th>
  5729. </tr>
  5730. </thead>
  5731. <tbody><tr><td><p>&#34;Error&#34;</p></td>
  5732. <td><p>ExternalSecretRewriteMergeConflictPolicyError returns an error when conflicts occur during merge.</p>
  5733. </td>
  5734. </tr><tr><td><p>&#34;Ignore&#34;</p></td>
  5735. <td><p>ExternalSecretRewriteMergeConflictPolicyIgnore ignores conflicts when merging secret values.</p>
  5736. </td>
  5737. </tr></tbody>
  5738. </table>
  5739. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergePriorityPolicy">ExternalSecretRewriteMergePriorityPolicy
  5740. (<code>string</code> alias)</p></h3>
  5741. <p>
  5742. (<em>Appears on:</em>
  5743. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  5744. </p>
  5745. <p>
  5746. <p>ExternalSecretRewriteMergePriorityPolicy defines the policy for handling missing keys in the priority
  5747. list during merge operations.</p>
  5748. </p>
  5749. <table>
  5750. <thead>
  5751. <tr>
  5752. <th>Value</th>
  5753. <th>Description</th>
  5754. </tr>
  5755. </thead>
  5756. <tbody><tr><td><p>&#34;IgnoreNotFound&#34;</p></td>
  5757. <td></td>
  5758. </tr><tr><td><p>&#34;Strict&#34;</p></td>
  5759. <td></td>
  5760. </tr></tbody>
  5761. </table>
  5762. <h3 id="external-secrets.io/v1.ExternalSecretRewriteMergeStrategy">ExternalSecretRewriteMergeStrategy
  5763. (<code>string</code> alias)</p></h3>
  5764. <p>
  5765. (<em>Appears on:</em>
  5766. <a href="#external-secrets.io/v1.ExternalSecretRewriteMerge">ExternalSecretRewriteMerge</a>)
  5767. </p>
  5768. <p>
  5769. <p>ExternalSecretRewriteMergeStrategy defines the strategy for merging secrets.</p>
  5770. </p>
  5771. <table>
  5772. <thead>
  5773. <tr>
  5774. <th>Value</th>
  5775. <th>Description</th>
  5776. </tr>
  5777. </thead>
  5778. <tbody><tr><td><p>&#34;Extract&#34;</p></td>
  5779. <td><p>ExternalSecretRewriteMergeStrategyExtract merges secrets by extracting values.</p>
  5780. </td>
  5781. </tr><tr><td><p>&#34;JSON&#34;</p></td>
  5782. <td><p>ExternalSecretRewriteMergeStrategyJSON merges secrets using JSON merge strategy.</p>
  5783. </td>
  5784. </tr></tbody>
  5785. </table>
  5786. <h3 id="external-secrets.io/v1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  5787. </h3>
  5788. <p>
  5789. (<em>Appears on:</em>
  5790. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  5791. </p>
  5792. <p>
  5793. <p>ExternalSecretRewriteRegexp defines configuration for rewriting secrets using regular expressions.</p>
  5794. </p>
  5795. <table>
  5796. <thead>
  5797. <tr>
  5798. <th>Field</th>
  5799. <th>Description</th>
  5800. </tr>
  5801. </thead>
  5802. <tbody>
  5803. <tr>
  5804. <td>
  5805. <code>source</code></br>
  5806. <em>
  5807. string
  5808. </em>
  5809. </td>
  5810. <td>
  5811. <p>Used to define the regular expression of a re.Compiler.</p>
  5812. </td>
  5813. </tr>
  5814. <tr>
  5815. <td>
  5816. <code>target</code></br>
  5817. <em>
  5818. string
  5819. </em>
  5820. </td>
  5821. <td>
  5822. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  5823. </td>
  5824. </tr>
  5825. </tbody>
  5826. </table>
  5827. <h3 id="external-secrets.io/v1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  5828. </h3>
  5829. <p>
  5830. (<em>Appears on:</em>
  5831. <a href="#external-secrets.io/v1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  5832. </p>
  5833. <p>
  5834. <p>ExternalSecretRewriteTransform defines configuration for transforming secrets using templates.</p>
  5835. </p>
  5836. <table>
  5837. <thead>
  5838. <tr>
  5839. <th>Field</th>
  5840. <th>Description</th>
  5841. </tr>
  5842. </thead>
  5843. <tbody>
  5844. <tr>
  5845. <td>
  5846. <code>template</code></br>
  5847. <em>
  5848. string
  5849. </em>
  5850. </td>
  5851. <td>
  5852. <p>Used to define the template to apply on the secret name.
  5853. <code>.value</code> will specify the secret name in the template.</p>
  5854. </td>
  5855. </tr>
  5856. </tbody>
  5857. </table>
  5858. <h3 id="external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec
  5859. </h3>
  5860. <p>
  5861. (<em>Appears on:</em>
  5862. <a href="#external-secrets.io/v1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  5863. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  5864. </p>
  5865. <p>
  5866. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  5867. </p>
  5868. <table>
  5869. <thead>
  5870. <tr>
  5871. <th>Field</th>
  5872. <th>Description</th>
  5873. </tr>
  5874. </thead>
  5875. <tbody>
  5876. <tr>
  5877. <td>
  5878. <code>secretStoreRef</code></br>
  5879. <em>
  5880. <a href="#external-secrets.io/v1.SecretStoreRef">
  5881. SecretStoreRef
  5882. </a>
  5883. </em>
  5884. </td>
  5885. <td>
  5886. <em>(Optional)</em>
  5887. </td>
  5888. </tr>
  5889. <tr>
  5890. <td>
  5891. <code>target</code></br>
  5892. <em>
  5893. <a href="#external-secrets.io/v1.ExternalSecretTarget">
  5894. ExternalSecretTarget
  5895. </a>
  5896. </em>
  5897. </td>
  5898. <td>
  5899. <em>(Optional)</em>
  5900. </td>
  5901. </tr>
  5902. <tr>
  5903. <td>
  5904. <code>refreshPolicy</code></br>
  5905. <em>
  5906. <a href="#external-secrets.io/v1.ExternalSecretRefreshPolicy">
  5907. ExternalSecretRefreshPolicy
  5908. </a>
  5909. </em>
  5910. </td>
  5911. <td>
  5912. <em>(Optional)</em>
  5913. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  5914. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  5915. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  5916. No periodic updates occur if refreshInterval is 0.
  5917. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  5918. </td>
  5919. </tr>
  5920. <tr>
  5921. <td>
  5922. <code>refreshInterval</code></br>
  5923. <em>
  5924. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  5925. Kubernetes meta/v1.Duration
  5926. </a>
  5927. </em>
  5928. </td>
  5929. <td>
  5930. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  5931. specified as Golang Duration strings.
  5932. 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;
  5933. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  5934. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  5935. </td>
  5936. </tr>
  5937. <tr>
  5938. <td>
  5939. <code>data</code></br>
  5940. <em>
  5941. <a href="#external-secrets.io/v1.ExternalSecretData">
  5942. []ExternalSecretData
  5943. </a>
  5944. </em>
  5945. </td>
  5946. <td>
  5947. <em>(Optional)</em>
  5948. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  5949. </td>
  5950. </tr>
  5951. <tr>
  5952. <td>
  5953. <code>dataFrom</code></br>
  5954. <em>
  5955. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">
  5956. []ExternalSecretDataFromRemoteRef
  5957. </a>
  5958. </em>
  5959. </td>
  5960. <td>
  5961. <em>(Optional)</em>
  5962. <p>DataFrom is used to fetch all properties from a specific Provider data
  5963. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  5964. </td>
  5965. </tr>
  5966. </tbody>
  5967. </table>
  5968. <h3 id="external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus
  5969. </h3>
  5970. <p>
  5971. (<em>Appears on:</em>
  5972. <a href="#external-secrets.io/v1.ExternalSecret">ExternalSecret</a>)
  5973. </p>
  5974. <p>
  5975. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  5976. </p>
  5977. <table>
  5978. <thead>
  5979. <tr>
  5980. <th>Field</th>
  5981. <th>Description</th>
  5982. </tr>
  5983. </thead>
  5984. <tbody>
  5985. <tr>
  5986. <td>
  5987. <code>refreshTime</code></br>
  5988. <em>
  5989. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  5990. Kubernetes meta/v1.Time
  5991. </a>
  5992. </em>
  5993. </td>
  5994. <td>
  5995. <p>refreshTime is the time and date the external secret was fetched and
  5996. the target secret updated</p>
  5997. </td>
  5998. </tr>
  5999. <tr>
  6000. <td>
  6001. <code>syncedResourceVersion</code></br>
  6002. <em>
  6003. string
  6004. </em>
  6005. </td>
  6006. <td>
  6007. <p>SyncedResourceVersion keeps track of the last synced version</p>
  6008. </td>
  6009. </tr>
  6010. <tr>
  6011. <td>
  6012. <code>conditions</code></br>
  6013. <em>
  6014. <a href="#external-secrets.io/v1.ExternalSecretStatusCondition">
  6015. []ExternalSecretStatusCondition
  6016. </a>
  6017. </em>
  6018. </td>
  6019. <td>
  6020. <em>(Optional)</em>
  6021. </td>
  6022. </tr>
  6023. <tr>
  6024. <td>
  6025. <code>binding</code></br>
  6026. <em>
  6027. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  6028. Kubernetes core/v1.LocalObjectReference
  6029. </a>
  6030. </em>
  6031. </td>
  6032. <td>
  6033. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  6034. </td>
  6035. </tr>
  6036. </tbody>
  6037. </table>
  6038. <h3 id="external-secrets.io/v1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  6039. </h3>
  6040. <p>
  6041. (<em>Appears on:</em>
  6042. <a href="#external-secrets.io/v1.ExternalSecretStatus">ExternalSecretStatus</a>)
  6043. </p>
  6044. <p>
  6045. <p>ExternalSecretStatusCondition defines a status condition of an ExternalSecret resource.</p>
  6046. </p>
  6047. <table>
  6048. <thead>
  6049. <tr>
  6050. <th>Field</th>
  6051. <th>Description</th>
  6052. </tr>
  6053. </thead>
  6054. <tbody>
  6055. <tr>
  6056. <td>
  6057. <code>type</code></br>
  6058. <em>
  6059. <a href="#external-secrets.io/v1.ExternalSecretConditionType">
  6060. ExternalSecretConditionType
  6061. </a>
  6062. </em>
  6063. </td>
  6064. <td>
  6065. </td>
  6066. </tr>
  6067. <tr>
  6068. <td>
  6069. <code>status</code></br>
  6070. <em>
  6071. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  6072. Kubernetes core/v1.ConditionStatus
  6073. </a>
  6074. </em>
  6075. </td>
  6076. <td>
  6077. </td>
  6078. </tr>
  6079. <tr>
  6080. <td>
  6081. <code>reason</code></br>
  6082. <em>
  6083. string
  6084. </em>
  6085. </td>
  6086. <td>
  6087. <em>(Optional)</em>
  6088. </td>
  6089. </tr>
  6090. <tr>
  6091. <td>
  6092. <code>message</code></br>
  6093. <em>
  6094. string
  6095. </em>
  6096. </td>
  6097. <td>
  6098. <em>(Optional)</em>
  6099. </td>
  6100. </tr>
  6101. <tr>
  6102. <td>
  6103. <code>lastTransitionTime</code></br>
  6104. <em>
  6105. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  6106. Kubernetes meta/v1.Time
  6107. </a>
  6108. </em>
  6109. </td>
  6110. <td>
  6111. <em>(Optional)</em>
  6112. </td>
  6113. </tr>
  6114. </tbody>
  6115. </table>
  6116. <h3 id="external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget
  6117. </h3>
  6118. <p>
  6119. (<em>Appears on:</em>
  6120. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>)
  6121. </p>
  6122. <p>
  6123. <p>ExternalSecretTarget defines the Kubernetes Secret to be created,
  6124. there can be only one target per ExternalSecret.</p>
  6125. </p>
  6126. <table>
  6127. <thead>
  6128. <tr>
  6129. <th>Field</th>
  6130. <th>Description</th>
  6131. </tr>
  6132. </thead>
  6133. <tbody>
  6134. <tr>
  6135. <td>
  6136. <code>name</code></br>
  6137. <em>
  6138. string
  6139. </em>
  6140. </td>
  6141. <td>
  6142. <em>(Optional)</em>
  6143. <p>The name of the Secret resource to be managed.
  6144. Defaults to the .metadata.name of the ExternalSecret resource</p>
  6145. </td>
  6146. </tr>
  6147. <tr>
  6148. <td>
  6149. <code>creationPolicy</code></br>
  6150. <em>
  6151. <a href="#external-secrets.io/v1.ExternalSecretCreationPolicy">
  6152. ExternalSecretCreationPolicy
  6153. </a>
  6154. </em>
  6155. </td>
  6156. <td>
  6157. <em>(Optional)</em>
  6158. <p>CreationPolicy defines rules on how to create the resulting Secret.
  6159. Defaults to &ldquo;Owner&rdquo;</p>
  6160. </td>
  6161. </tr>
  6162. <tr>
  6163. <td>
  6164. <code>deletionPolicy</code></br>
  6165. <em>
  6166. <a href="#external-secrets.io/v1.ExternalSecretDeletionPolicy">
  6167. ExternalSecretDeletionPolicy
  6168. </a>
  6169. </em>
  6170. </td>
  6171. <td>
  6172. <em>(Optional)</em>
  6173. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  6174. Defaults to &ldquo;Retain&rdquo;</p>
  6175. </td>
  6176. </tr>
  6177. <tr>
  6178. <td>
  6179. <code>template</code></br>
  6180. <em>
  6181. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  6182. ExternalSecretTemplate
  6183. </a>
  6184. </em>
  6185. </td>
  6186. <td>
  6187. <em>(Optional)</em>
  6188. <p>Template defines a blueprint for the created Secret resource.</p>
  6189. </td>
  6190. </tr>
  6191. <tr>
  6192. <td>
  6193. <code>manifest</code></br>
  6194. <em>
  6195. <a href="#external-secrets.io/v1.ManifestReference">
  6196. ManifestReference
  6197. </a>
  6198. </em>
  6199. </td>
  6200. <td>
  6201. <em>(Optional)</em>
  6202. <p>Manifest defines a custom Kubernetes resource to create instead of a Secret.
  6203. When specified, ExternalSecret will create the resource type defined here
  6204. (e.g., ConfigMap, Custom Resource) instead of a Secret.
  6205. Warning: Using Generic target. Make sure access policies and encryption are properly configured.</p>
  6206. </td>
  6207. </tr>
  6208. <tr>
  6209. <td>
  6210. <code>immutable</code></br>
  6211. <em>
  6212. bool
  6213. </em>
  6214. </td>
  6215. <td>
  6216. <em>(Optional)</em>
  6217. <p>Immutable defines if the final secret will be immutable</p>
  6218. </td>
  6219. </tr>
  6220. </tbody>
  6221. </table>
  6222. <h3 id="external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate
  6223. </h3>
  6224. <p>
  6225. (<em>Appears on:</em>
  6226. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>,
  6227. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  6228. </p>
  6229. <p>
  6230. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  6231. 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>
  6232. </p>
  6233. <table>
  6234. <thead>
  6235. <tr>
  6236. <th>Field</th>
  6237. <th>Description</th>
  6238. </tr>
  6239. </thead>
  6240. <tbody>
  6241. <tr>
  6242. <td>
  6243. <code>type</code></br>
  6244. <em>
  6245. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  6246. Kubernetes core/v1.SecretType
  6247. </a>
  6248. </em>
  6249. </td>
  6250. <td>
  6251. <em>(Optional)</em>
  6252. </td>
  6253. </tr>
  6254. <tr>
  6255. <td>
  6256. <code>engineVersion</code></br>
  6257. <em>
  6258. <a href="#external-secrets.io/v1.TemplateEngineVersion">
  6259. TemplateEngineVersion
  6260. </a>
  6261. </em>
  6262. </td>
  6263. <td>
  6264. <p>EngineVersion specifies the template engine version
  6265. that should be used to compile/execute the
  6266. template specified in .data and .templateFrom[].</p>
  6267. </td>
  6268. </tr>
  6269. <tr>
  6270. <td>
  6271. <code>metadata</code></br>
  6272. <em>
  6273. <a href="#external-secrets.io/v1.ExternalSecretTemplateMetadata">
  6274. ExternalSecretTemplateMetadata
  6275. </a>
  6276. </em>
  6277. </td>
  6278. <td>
  6279. <em>(Optional)</em>
  6280. </td>
  6281. </tr>
  6282. <tr>
  6283. <td>
  6284. <code>mergePolicy</code></br>
  6285. <em>
  6286. <a href="#external-secrets.io/v1.TemplateMergePolicy">
  6287. TemplateMergePolicy
  6288. </a>
  6289. </em>
  6290. </td>
  6291. <td>
  6292. </td>
  6293. </tr>
  6294. <tr>
  6295. <td>
  6296. <code>data</code></br>
  6297. <em>
  6298. map[string]string
  6299. </em>
  6300. </td>
  6301. <td>
  6302. <em>(Optional)</em>
  6303. </td>
  6304. </tr>
  6305. <tr>
  6306. <td>
  6307. <code>templateFrom</code></br>
  6308. <em>
  6309. <a href="#external-secrets.io/v1.TemplateFrom">
  6310. []TemplateFrom
  6311. </a>
  6312. </em>
  6313. </td>
  6314. <td>
  6315. <em>(Optional)</em>
  6316. </td>
  6317. </tr>
  6318. </tbody>
  6319. </table>
  6320. <h3 id="external-secrets.io/v1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  6321. </h3>
  6322. <p>
  6323. (<em>Appears on:</em>
  6324. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  6325. </p>
  6326. <p>
  6327. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  6328. </p>
  6329. <table>
  6330. <thead>
  6331. <tr>
  6332. <th>Field</th>
  6333. <th>Description</th>
  6334. </tr>
  6335. </thead>
  6336. <tbody>
  6337. <tr>
  6338. <td>
  6339. <code>annotations</code></br>
  6340. <em>
  6341. map[string]string
  6342. </em>
  6343. </td>
  6344. <td>
  6345. <em>(Optional)</em>
  6346. </td>
  6347. </tr>
  6348. <tr>
  6349. <td>
  6350. <code>labels</code></br>
  6351. <em>
  6352. map[string]string
  6353. </em>
  6354. </td>
  6355. <td>
  6356. <em>(Optional)</em>
  6357. </td>
  6358. </tr>
  6359. <tr>
  6360. <td>
  6361. <code>finalizers</code></br>
  6362. <em>
  6363. []string
  6364. </em>
  6365. </td>
  6366. <td>
  6367. <em>(Optional)</em>
  6368. </td>
  6369. </tr>
  6370. </tbody>
  6371. </table>
  6372. <h3 id="external-secrets.io/v1.ExternalSecretValidator">ExternalSecretValidator
  6373. </h3>
  6374. <p>
  6375. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  6376. </p>
  6377. <h3 id="external-secrets.io/v1.FakeProvider">FakeProvider
  6378. </h3>
  6379. <p>
  6380. (<em>Appears on:</em>
  6381. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  6382. </p>
  6383. <p>
  6384. <p>FakeProvider configures a fake provider that returns static values.</p>
  6385. </p>
  6386. <table>
  6387. <thead>
  6388. <tr>
  6389. <th>Field</th>
  6390. <th>Description</th>
  6391. </tr>
  6392. </thead>
  6393. <tbody>
  6394. <tr>
  6395. <td>
  6396. <code>data</code></br>
  6397. <em>
  6398. <a href="#external-secrets.io/v1.FakeProviderData">
  6399. []FakeProviderData
  6400. </a>
  6401. </em>
  6402. </td>
  6403. <td>
  6404. </td>
  6405. </tr>
  6406. <tr>
  6407. <td>
  6408. <code>validationResult</code></br>
  6409. <em>
  6410. <a href="#external-secrets.io/v1.ValidationResult">
  6411. ValidationResult
  6412. </a>
  6413. </em>
  6414. </td>
  6415. <td>
  6416. </td>
  6417. </tr>
  6418. </tbody>
  6419. </table>
  6420. <h3 id="external-secrets.io/v1.FakeProviderData">FakeProviderData
  6421. </h3>
  6422. <p>
  6423. (<em>Appears on:</em>
  6424. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  6425. </p>
  6426. <p>
  6427. <p>FakeProviderData defines a key-value pair with optional version for the fake provider.</p>
  6428. </p>
  6429. <table>
  6430. <thead>
  6431. <tr>
  6432. <th>Field</th>
  6433. <th>Description</th>
  6434. </tr>
  6435. </thead>
  6436. <tbody>
  6437. <tr>
  6438. <td>
  6439. <code>key</code></br>
  6440. <em>
  6441. string
  6442. </em>
  6443. </td>
  6444. <td>
  6445. </td>
  6446. </tr>
  6447. <tr>
  6448. <td>
  6449. <code>value</code></br>
  6450. <em>
  6451. string
  6452. </em>
  6453. </td>
  6454. <td>
  6455. </td>
  6456. </tr>
  6457. <tr>
  6458. <td>
  6459. <code>version</code></br>
  6460. <em>
  6461. string
  6462. </em>
  6463. </td>
  6464. <td>
  6465. </td>
  6466. </tr>
  6467. </tbody>
  6468. </table>
  6469. <h3 id="external-secrets.io/v1.FetchingPolicy">FetchingPolicy
  6470. </h3>
  6471. <p>
  6472. (<em>Appears on:</em>
  6473. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  6474. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  6475. </p>
  6476. <p>
  6477. <p>FetchingPolicy configures how the provider interprets the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret.</p>
  6478. </p>
  6479. <table>
  6480. <thead>
  6481. <tr>
  6482. <th>Field</th>
  6483. <th>Description</th>
  6484. </tr>
  6485. </thead>
  6486. <tbody>
  6487. <tr>
  6488. <td>
  6489. <code>byID</code></br>
  6490. <em>
  6491. <a href="#external-secrets.io/v1.ByID">
  6492. ByID
  6493. </a>
  6494. </em>
  6495. </td>
  6496. <td>
  6497. </td>
  6498. </tr>
  6499. <tr>
  6500. <td>
  6501. <code>byName</code></br>
  6502. <em>
  6503. <a href="#external-secrets.io/v1.ByName">
  6504. ByName
  6505. </a>
  6506. </em>
  6507. </td>
  6508. <td>
  6509. </td>
  6510. </tr>
  6511. </tbody>
  6512. </table>
  6513. <h3 id="external-secrets.io/v1.FindName">FindName
  6514. </h3>
  6515. <p>
  6516. (<em>Appears on:</em>
  6517. <a href="#external-secrets.io/v1.ExternalSecretFind">ExternalSecretFind</a>)
  6518. </p>
  6519. <p>
  6520. <p>FindName defines criteria for finding secrets by name patterns.</p>
  6521. </p>
  6522. <table>
  6523. <thead>
  6524. <tr>
  6525. <th>Field</th>
  6526. <th>Description</th>
  6527. </tr>
  6528. </thead>
  6529. <tbody>
  6530. <tr>
  6531. <td>
  6532. <code>regexp</code></br>
  6533. <em>
  6534. string
  6535. </em>
  6536. </td>
  6537. <td>
  6538. <em>(Optional)</em>
  6539. <p>Finds secrets base</p>
  6540. </td>
  6541. </tr>
  6542. </tbody>
  6543. </table>
  6544. <h3 id="external-secrets.io/v1.FortanixProvider">FortanixProvider
  6545. </h3>
  6546. <p>
  6547. (<em>Appears on:</em>
  6548. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  6549. </p>
  6550. <p>
  6551. <p>FortanixProvider provides access to Fortanix SDKMS API using the provided credentials.</p>
  6552. </p>
  6553. <table>
  6554. <thead>
  6555. <tr>
  6556. <th>Field</th>
  6557. <th>Description</th>
  6558. </tr>
  6559. </thead>
  6560. <tbody>
  6561. <tr>
  6562. <td>
  6563. <code>apiUrl</code></br>
  6564. <em>
  6565. string
  6566. </em>
  6567. </td>
  6568. <td>
  6569. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  6570. </td>
  6571. </tr>
  6572. <tr>
  6573. <td>
  6574. <code>apiKey</code></br>
  6575. <em>
  6576. <a href="#external-secrets.io/v1.FortanixProviderSecretRef">
  6577. FortanixProviderSecretRef
  6578. </a>
  6579. </em>
  6580. </td>
  6581. <td>
  6582. <p>APIKey is the API token to access SDKMS Applications.</p>
  6583. </td>
  6584. </tr>
  6585. </tbody>
  6586. </table>
  6587. <h3 id="external-secrets.io/v1.FortanixProviderSecretRef">FortanixProviderSecretRef
  6588. </h3>
  6589. <p>
  6590. (<em>Appears on:</em>
  6591. <a href="#external-secrets.io/v1.FortanixProvider">FortanixProvider</a>)
  6592. </p>
  6593. <p>
  6594. <p>FortanixProviderSecretRef is a secret reference containing the SDKMS API Key.</p>
  6595. </p>
  6596. <table>
  6597. <thead>
  6598. <tr>
  6599. <th>Field</th>
  6600. <th>Description</th>
  6601. </tr>
  6602. </thead>
  6603. <tbody>
  6604. <tr>
  6605. <td>
  6606. <code>secretRef</code></br>
  6607. <em>
  6608. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  6609. External Secrets meta/v1.SecretKeySelector
  6610. </a>
  6611. </em>
  6612. </td>
  6613. <td>
  6614. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  6615. </td>
  6616. </tr>
  6617. </tbody>
  6618. </table>
  6619. <h3 id="external-secrets.io/v1.GCPSMAuth">GCPSMAuth
  6620. </h3>
  6621. <p>
  6622. (<em>Appears on:</em>
  6623. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  6624. </p>
  6625. <p>
  6626. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform Secret Manager.</p>
  6627. </p>
  6628. <table>
  6629. <thead>
  6630. <tr>
  6631. <th>Field</th>
  6632. <th>Description</th>
  6633. </tr>
  6634. </thead>
  6635. <tbody>
  6636. <tr>
  6637. <td>
  6638. <code>secretRef</code></br>
  6639. <em>
  6640. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  6641. GCPSMAuthSecretRef
  6642. </a>
  6643. </em>
  6644. </td>
  6645. <td>
  6646. <em>(Optional)</em>
  6647. </td>
  6648. </tr>
  6649. <tr>
  6650. <td>
  6651. <code>workloadIdentity</code></br>
  6652. <em>
  6653. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  6654. GCPWorkloadIdentity
  6655. </a>
  6656. </em>
  6657. </td>
  6658. <td>
  6659. <em>(Optional)</em>
  6660. </td>
  6661. </tr>
  6662. <tr>
  6663. <td>
  6664. <code>workloadIdentityFederation</code></br>
  6665. <em>
  6666. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  6667. GCPWorkloadIdentityFederation
  6668. </a>
  6669. </em>
  6670. </td>
  6671. <td>
  6672. <em>(Optional)</em>
  6673. </td>
  6674. </tr>
  6675. </tbody>
  6676. </table>
  6677. <h3 id="external-secrets.io/v1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  6678. </h3>
  6679. <p>
  6680. (<em>Appears on:</em>
  6681. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  6682. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  6683. </p>
  6684. <p>
  6685. <p>GCPSMAuthSecretRef contains the secret references for GCP Secret Manager authentication.</p>
  6686. </p>
  6687. <table>
  6688. <thead>
  6689. <tr>
  6690. <th>Field</th>
  6691. <th>Description</th>
  6692. </tr>
  6693. </thead>
  6694. <tbody>
  6695. <tr>
  6696. <td>
  6697. <code>secretAccessKeySecretRef</code></br>
  6698. <em>
  6699. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  6700. External Secrets meta/v1.SecretKeySelector
  6701. </a>
  6702. </em>
  6703. </td>
  6704. <td>
  6705. <em>(Optional)</em>
  6706. <p>The SecretAccessKey is used for authentication</p>
  6707. </td>
  6708. </tr>
  6709. </tbody>
  6710. </table>
  6711. <h3 id="external-secrets.io/v1.GCPSMProvider">GCPSMProvider
  6712. </h3>
  6713. <p>
  6714. (<em>Appears on:</em>
  6715. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  6716. </p>
  6717. <p>
  6718. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  6719. </p>
  6720. <table>
  6721. <thead>
  6722. <tr>
  6723. <th>Field</th>
  6724. <th>Description</th>
  6725. </tr>
  6726. </thead>
  6727. <tbody>
  6728. <tr>
  6729. <td>
  6730. <code>auth</code></br>
  6731. <em>
  6732. <a href="#external-secrets.io/v1.GCPSMAuth">
  6733. GCPSMAuth
  6734. </a>
  6735. </em>
  6736. </td>
  6737. <td>
  6738. <em>(Optional)</em>
  6739. <p>Auth defines the information necessary to authenticate against GCP</p>
  6740. </td>
  6741. </tr>
  6742. <tr>
  6743. <td>
  6744. <code>projectID</code></br>
  6745. <em>
  6746. string
  6747. </em>
  6748. </td>
  6749. <td>
  6750. <p>ProjectID project where secret is located</p>
  6751. </td>
  6752. </tr>
  6753. <tr>
  6754. <td>
  6755. <code>location</code></br>
  6756. <em>
  6757. string
  6758. </em>
  6759. </td>
  6760. <td>
  6761. <p>Location optionally defines a location for a secret</p>
  6762. </td>
  6763. </tr>
  6764. <tr>
  6765. <td>
  6766. <code>secretVersionSelectionPolicy</code></br>
  6767. <em>
  6768. <a href="#external-secrets.io/v1.SecretVersionSelectionPolicy">
  6769. SecretVersionSelectionPolicy
  6770. </a>
  6771. </em>
  6772. </td>
  6773. <td>
  6774. <em>(Optional)</em>
  6775. <p>SecretVersionSelectionPolicy specifies how the provider selects a secret version
  6776. when &ldquo;latest&rdquo; is disabled or destroyed.
  6777. Possible values are:
  6778. - LatestOrFail: the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.
  6779. - LatestOrFetch: the provider falls back to fetching the latest version if the version is DESTROYED or DISABLED</p>
  6780. </td>
  6781. </tr>
  6782. </tbody>
  6783. </table>
  6784. <h3 id="external-secrets.io/v1.GCPWorkloadIdentity">GCPWorkloadIdentity
  6785. </h3>
  6786. <p>
  6787. (<em>Appears on:</em>
  6788. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  6789. <a href="#external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth</a>)
  6790. </p>
  6791. <p>
  6792. <p>GCPWorkloadIdentity defines configuration for workload identity authentication to GCP.</p>
  6793. </p>
  6794. <table>
  6795. <thead>
  6796. <tr>
  6797. <th>Field</th>
  6798. <th>Description</th>
  6799. </tr>
  6800. </thead>
  6801. <tbody>
  6802. <tr>
  6803. <td>
  6804. <code>serviceAccountRef</code></br>
  6805. <em>
  6806. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  6807. External Secrets meta/v1.ServiceAccountSelector
  6808. </a>
  6809. </em>
  6810. </td>
  6811. <td>
  6812. </td>
  6813. </tr>
  6814. <tr>
  6815. <td>
  6816. <code>clusterLocation</code></br>
  6817. <em>
  6818. string
  6819. </em>
  6820. </td>
  6821. <td>
  6822. <em>(Optional)</em>
  6823. <p>ClusterLocation is the location of the cluster
  6824. If not specified, it fetches information from the metadata server</p>
  6825. </td>
  6826. </tr>
  6827. <tr>
  6828. <td>
  6829. <code>clusterName</code></br>
  6830. <em>
  6831. string
  6832. </em>
  6833. </td>
  6834. <td>
  6835. <em>(Optional)</em>
  6836. <p>ClusterName is the name of the cluster
  6837. If not specified, it fetches information from the metadata server</p>
  6838. </td>
  6839. </tr>
  6840. <tr>
  6841. <td>
  6842. <code>clusterProjectID</code></br>
  6843. <em>
  6844. string
  6845. </em>
  6846. </td>
  6847. <td>
  6848. <em>(Optional)</em>
  6849. <p>ClusterProjectID is the project ID of the cluster
  6850. If not specified, it fetches information from the metadata server</p>
  6851. </td>
  6852. </tr>
  6853. </tbody>
  6854. </table>
  6855. <h3 id="external-secrets.io/v1.GCPWorkloadIdentityFederation">GCPWorkloadIdentityFederation
  6856. </h3>
  6857. <p>
  6858. (<em>Appears on:</em>
  6859. <a href="#external-secrets.io/v1.GCPSMAuth">GCPSMAuth</a>,
  6860. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  6861. </p>
  6862. <p>
  6863. <p>GCPWorkloadIdentityFederation holds the configurations required for generating federated access tokens.</p>
  6864. </p>
  6865. <table>
  6866. <thead>
  6867. <tr>
  6868. <th>Field</th>
  6869. <th>Description</th>
  6870. </tr>
  6871. </thead>
  6872. <tbody>
  6873. <tr>
  6874. <td>
  6875. <code>credConfig</code></br>
  6876. <em>
  6877. <a href="#external-secrets.io/v1.ConfigMapReference">
  6878. ConfigMapReference
  6879. </a>
  6880. </em>
  6881. </td>
  6882. <td>
  6883. <p>credConfig holds the configmap reference containing the GCP external account credential configuration in JSON format and the key name containing the json data.
  6884. For using Kubernetes cluster as the identity provider, use serviceAccountRef instead. Operators mounted serviceaccount token cannot be used as the token source, instead
  6885. serviceAccountRef must be used by providing operators service account details.</p>
  6886. </td>
  6887. </tr>
  6888. <tr>
  6889. <td>
  6890. <code>serviceAccountRef</code></br>
  6891. <em>
  6892. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  6893. External Secrets meta/v1.ServiceAccountSelector
  6894. </a>
  6895. </em>
  6896. </td>
  6897. <td>
  6898. <p>serviceAccountRef is the reference to the kubernetes ServiceAccount to be used for obtaining the tokens,
  6899. when Kubernetes is configured as provider in workload identity pool.</p>
  6900. </td>
  6901. </tr>
  6902. <tr>
  6903. <td>
  6904. <code>awsSecurityCredentials</code></br>
  6905. <em>
  6906. <a href="#external-secrets.io/v1.AwsCredentialsConfig">
  6907. AwsCredentialsConfig
  6908. </a>
  6909. </em>
  6910. </td>
  6911. <td>
  6912. <p>awsSecurityCredentials is for configuring AWS region and credentials to use for obtaining the access token,
  6913. when using the AWS metadata server is not an option.</p>
  6914. </td>
  6915. </tr>
  6916. <tr>
  6917. <td>
  6918. <code>audience</code></br>
  6919. <em>
  6920. string
  6921. </em>
  6922. </td>
  6923. <td>
  6924. <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.
  6925. If specified, Audience found in the external account credential config will be overridden with the configured value.
  6926. audience must be provided when serviceAccountRef or awsSecurityCredentials is configured.</p>
  6927. </td>
  6928. </tr>
  6929. <tr>
  6930. <td>
  6931. <code>externalTokenEndpoint</code></br>
  6932. <em>
  6933. string
  6934. </em>
  6935. </td>
  6936. <td>
  6937. <p>externalTokenEndpoint is the endpoint explicitly set up to provide tokens, which will be matched against the
  6938. credential_source.url in the provided credConfig. This field is merely to double-check the external token source
  6939. URL is having the expected value.</p>
  6940. </td>
  6941. </tr>
  6942. </tbody>
  6943. </table>
  6944. <h3 id="external-secrets.io/v1.GcpIDTokenAuthCredentials">GcpIDTokenAuthCredentials
  6945. </h3>
  6946. <p>
  6947. (<em>Appears on:</em>
  6948. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  6949. </p>
  6950. <p>
  6951. <p>GcpIDTokenAuthCredentials represents the credentials for GCP ID token authentication.</p>
  6952. </p>
  6953. <table>
  6954. <thead>
  6955. <tr>
  6956. <th>Field</th>
  6957. <th>Description</th>
  6958. </tr>
  6959. </thead>
  6960. <tbody>
  6961. <tr>
  6962. <td>
  6963. <code>identityId</code></br>
  6964. <em>
  6965. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  6966. External Secrets meta/v1.SecretKeySelector
  6967. </a>
  6968. </em>
  6969. </td>
  6970. <td>
  6971. </td>
  6972. </tr>
  6973. </tbody>
  6974. </table>
  6975. <h3 id="external-secrets.io/v1.GcpIamAuthCredentials">GcpIamAuthCredentials
  6976. </h3>
  6977. <p>
  6978. (<em>Appears on:</em>
  6979. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  6980. </p>
  6981. <p>
  6982. <p>GcpIamAuthCredentials represents the credentials for GCP IAM authentication.</p>
  6983. </p>
  6984. <table>
  6985. <thead>
  6986. <tr>
  6987. <th>Field</th>
  6988. <th>Description</th>
  6989. </tr>
  6990. </thead>
  6991. <tbody>
  6992. <tr>
  6993. <td>
  6994. <code>identityId</code></br>
  6995. <em>
  6996. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  6997. External Secrets meta/v1.SecretKeySelector
  6998. </a>
  6999. </em>
  7000. </td>
  7001. <td>
  7002. </td>
  7003. </tr>
  7004. <tr>
  7005. <td>
  7006. <code>serviceAccountKeyFilePath</code></br>
  7007. <em>
  7008. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7009. External Secrets meta/v1.SecretKeySelector
  7010. </a>
  7011. </em>
  7012. </td>
  7013. <td>
  7014. </td>
  7015. </tr>
  7016. </tbody>
  7017. </table>
  7018. <h3 id="external-secrets.io/v1.GeneratorRef">GeneratorRef
  7019. </h3>
  7020. <p>
  7021. (<em>Appears on:</em>
  7022. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  7023. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>,
  7024. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  7025. </p>
  7026. <p>
  7027. <p>GeneratorRef points to a generator custom resource.</p>
  7028. </p>
  7029. <table>
  7030. <thead>
  7031. <tr>
  7032. <th>Field</th>
  7033. <th>Description</th>
  7034. </tr>
  7035. </thead>
  7036. <tbody>
  7037. <tr>
  7038. <td>
  7039. <code>apiVersion</code></br>
  7040. <em>
  7041. string
  7042. </em>
  7043. </td>
  7044. <td>
  7045. <p>Specify the apiVersion of the generator resource</p>
  7046. </td>
  7047. </tr>
  7048. <tr>
  7049. <td>
  7050. <code>kind</code></br>
  7051. <em>
  7052. string
  7053. </em>
  7054. </td>
  7055. <td>
  7056. <p>Specify the Kind of the generator resource</p>
  7057. </td>
  7058. </tr>
  7059. <tr>
  7060. <td>
  7061. <code>name</code></br>
  7062. <em>
  7063. string
  7064. </em>
  7065. </td>
  7066. <td>
  7067. <p>Specify the name of the generator resource</p>
  7068. </td>
  7069. </tr>
  7070. </tbody>
  7071. </table>
  7072. <h3 id="external-secrets.io/v1.GenericClusterStoreValidator">GenericClusterStoreValidator
  7073. </h3>
  7074. <p>
  7075. <p>GenericClusterStoreValidator implements webhook validation for ClusterSecretStore resources.</p>
  7076. </p>
  7077. <h3 id="external-secrets.io/v1.GenericStore">GenericStore
  7078. </h3>
  7079. <p>
  7080. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  7081. or a namespaced SecretStore.</p>
  7082. </p>
  7083. <h3 id="external-secrets.io/v1.GenericStoreValidator">GenericStoreValidator
  7084. </h3>
  7085. <p>
  7086. <p>GenericStoreValidator implements webhook validation for SecretStore resources.</p>
  7087. </p>
  7088. <h3 id="external-secrets.io/v1.GithubAppAuth">GithubAppAuth
  7089. </h3>
  7090. <p>
  7091. (<em>Appears on:</em>
  7092. <a href="#external-secrets.io/v1.GithubProvider">GithubProvider</a>)
  7093. </p>
  7094. <p>
  7095. <p>GithubAppAuth defines authentication configuration using a GitHub App for accessing GitHub API.</p>
  7096. </p>
  7097. <table>
  7098. <thead>
  7099. <tr>
  7100. <th>Field</th>
  7101. <th>Description</th>
  7102. </tr>
  7103. </thead>
  7104. <tbody>
  7105. <tr>
  7106. <td>
  7107. <code>privateKey</code></br>
  7108. <em>
  7109. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7110. External Secrets meta/v1.SecretKeySelector
  7111. </a>
  7112. </em>
  7113. </td>
  7114. <td>
  7115. </td>
  7116. </tr>
  7117. </tbody>
  7118. </table>
  7119. <h3 id="external-secrets.io/v1.GithubProvider">GithubProvider
  7120. </h3>
  7121. <p>
  7122. (<em>Appears on:</em>
  7123. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7124. </p>
  7125. <p>
  7126. <p>GithubProvider provides access and authentication to a GitHub instance .</p>
  7127. </p>
  7128. <table>
  7129. <thead>
  7130. <tr>
  7131. <th>Field</th>
  7132. <th>Description</th>
  7133. </tr>
  7134. </thead>
  7135. <tbody>
  7136. <tr>
  7137. <td>
  7138. <code>url</code></br>
  7139. <em>
  7140. string
  7141. </em>
  7142. </td>
  7143. <td>
  7144. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  7145. </td>
  7146. </tr>
  7147. <tr>
  7148. <td>
  7149. <code>uploadURL</code></br>
  7150. <em>
  7151. string
  7152. </em>
  7153. </td>
  7154. <td>
  7155. <em>(Optional)</em>
  7156. <p>Upload URL for enterprise instances. Default to URL.</p>
  7157. </td>
  7158. </tr>
  7159. <tr>
  7160. <td>
  7161. <code>auth</code></br>
  7162. <em>
  7163. <a href="#external-secrets.io/v1.GithubAppAuth">
  7164. GithubAppAuth
  7165. </a>
  7166. </em>
  7167. </td>
  7168. <td>
  7169. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  7170. </td>
  7171. </tr>
  7172. <tr>
  7173. <td>
  7174. <code>appID</code></br>
  7175. <em>
  7176. int64
  7177. </em>
  7178. </td>
  7179. <td>
  7180. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  7181. </td>
  7182. </tr>
  7183. <tr>
  7184. <td>
  7185. <code>installationID</code></br>
  7186. <em>
  7187. int64
  7188. </em>
  7189. </td>
  7190. <td>
  7191. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  7192. </td>
  7193. </tr>
  7194. <tr>
  7195. <td>
  7196. <code>organization</code></br>
  7197. <em>
  7198. string
  7199. </em>
  7200. </td>
  7201. <td>
  7202. <p>organization will be used to fetch secrets from the Github organization</p>
  7203. </td>
  7204. </tr>
  7205. <tr>
  7206. <td>
  7207. <code>repository</code></br>
  7208. <em>
  7209. string
  7210. </em>
  7211. </td>
  7212. <td>
  7213. <em>(Optional)</em>
  7214. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  7215. </td>
  7216. </tr>
  7217. <tr>
  7218. <td>
  7219. <code>environment</code></br>
  7220. <em>
  7221. string
  7222. </em>
  7223. </td>
  7224. <td>
  7225. <em>(Optional)</em>
  7226. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  7227. </td>
  7228. </tr>
  7229. </tbody>
  7230. </table>
  7231. <h3 id="external-secrets.io/v1.GitlabAuth">GitlabAuth
  7232. </h3>
  7233. <p>
  7234. (<em>Appears on:</em>
  7235. <a href="#external-secrets.io/v1.GitlabProvider">GitlabProvider</a>)
  7236. </p>
  7237. <p>
  7238. <p>GitlabAuth defines the authentication method for accessing GitLab API.</p>
  7239. </p>
  7240. <table>
  7241. <thead>
  7242. <tr>
  7243. <th>Field</th>
  7244. <th>Description</th>
  7245. </tr>
  7246. </thead>
  7247. <tbody>
  7248. <tr>
  7249. <td>
  7250. <code>SecretRef</code></br>
  7251. <em>
  7252. <a href="#external-secrets.io/v1.GitlabSecretRef">
  7253. GitlabSecretRef
  7254. </a>
  7255. </em>
  7256. </td>
  7257. <td>
  7258. </td>
  7259. </tr>
  7260. </tbody>
  7261. </table>
  7262. <h3 id="external-secrets.io/v1.GitlabProvider">GitlabProvider
  7263. </h3>
  7264. <p>
  7265. (<em>Appears on:</em>
  7266. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7267. </p>
  7268. <p>
  7269. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  7270. </p>
  7271. <table>
  7272. <thead>
  7273. <tr>
  7274. <th>Field</th>
  7275. <th>Description</th>
  7276. </tr>
  7277. </thead>
  7278. <tbody>
  7279. <tr>
  7280. <td>
  7281. <code>url</code></br>
  7282. <em>
  7283. string
  7284. </em>
  7285. </td>
  7286. <td>
  7287. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  7288. </td>
  7289. </tr>
  7290. <tr>
  7291. <td>
  7292. <code>auth</code></br>
  7293. <em>
  7294. <a href="#external-secrets.io/v1.GitlabAuth">
  7295. GitlabAuth
  7296. </a>
  7297. </em>
  7298. </td>
  7299. <td>
  7300. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  7301. </td>
  7302. </tr>
  7303. <tr>
  7304. <td>
  7305. <code>projectID</code></br>
  7306. <em>
  7307. string
  7308. </em>
  7309. </td>
  7310. <td>
  7311. <p>ProjectID specifies a project where secrets are located.</p>
  7312. </td>
  7313. </tr>
  7314. <tr>
  7315. <td>
  7316. <code>inheritFromGroups</code></br>
  7317. <em>
  7318. bool
  7319. </em>
  7320. </td>
  7321. <td>
  7322. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  7323. </td>
  7324. </tr>
  7325. <tr>
  7326. <td>
  7327. <code>groupIDs</code></br>
  7328. <em>
  7329. []string
  7330. </em>
  7331. </td>
  7332. <td>
  7333. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  7334. </td>
  7335. </tr>
  7336. <tr>
  7337. <td>
  7338. <code>environment</code></br>
  7339. <em>
  7340. string
  7341. </em>
  7342. </td>
  7343. <td>
  7344. <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>
  7345. </td>
  7346. </tr>
  7347. <tr>
  7348. <td>
  7349. <code>caBundle</code></br>
  7350. <em>
  7351. []byte
  7352. </em>
  7353. </td>
  7354. <td>
  7355. <em>(Optional)</em>
  7356. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  7357. can be performed.</p>
  7358. </td>
  7359. </tr>
  7360. <tr>
  7361. <td>
  7362. <code>caProvider</code></br>
  7363. <em>
  7364. <a href="#external-secrets.io/v1.CAProvider">
  7365. CAProvider
  7366. </a>
  7367. </em>
  7368. </td>
  7369. <td>
  7370. <em>(Optional)</em>
  7371. <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>
  7372. </td>
  7373. </tr>
  7374. </tbody>
  7375. </table>
  7376. <h3 id="external-secrets.io/v1.GitlabSecretRef">GitlabSecretRef
  7377. </h3>
  7378. <p>
  7379. (<em>Appears on:</em>
  7380. <a href="#external-secrets.io/v1.GitlabAuth">GitlabAuth</a>)
  7381. </p>
  7382. <p>
  7383. <p>GitlabSecretRef contains the secret reference for GitLab authentication credentials.</p>
  7384. </p>
  7385. <table>
  7386. <thead>
  7387. <tr>
  7388. <th>Field</th>
  7389. <th>Description</th>
  7390. </tr>
  7391. </thead>
  7392. <tbody>
  7393. <tr>
  7394. <td>
  7395. <code>accessToken</code></br>
  7396. <em>
  7397. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7398. External Secrets meta/v1.SecretKeySelector
  7399. </a>
  7400. </em>
  7401. </td>
  7402. <td>
  7403. <p>AccessToken is used for authentication.</p>
  7404. </td>
  7405. </tr>
  7406. </tbody>
  7407. </table>
  7408. <h3 id="external-secrets.io/v1.IBMAuth">IBMAuth
  7409. </h3>
  7410. <p>
  7411. (<em>Appears on:</em>
  7412. <a href="#external-secrets.io/v1.IBMProvider">IBMProvider</a>)
  7413. </p>
  7414. <p>
  7415. <p>IBMAuth defines authentication options for connecting to IBM Cloud Secrets Manager.</p>
  7416. </p>
  7417. <table>
  7418. <thead>
  7419. <tr>
  7420. <th>Field</th>
  7421. <th>Description</th>
  7422. </tr>
  7423. </thead>
  7424. <tbody>
  7425. <tr>
  7426. <td>
  7427. <code>secretRef</code></br>
  7428. <em>
  7429. <a href="#external-secrets.io/v1.IBMAuthSecretRef">
  7430. IBMAuthSecretRef
  7431. </a>
  7432. </em>
  7433. </td>
  7434. <td>
  7435. </td>
  7436. </tr>
  7437. <tr>
  7438. <td>
  7439. <code>containerAuth</code></br>
  7440. <em>
  7441. <a href="#external-secrets.io/v1.IBMAuthContainerAuth">
  7442. IBMAuthContainerAuth
  7443. </a>
  7444. </em>
  7445. </td>
  7446. <td>
  7447. </td>
  7448. </tr>
  7449. </tbody>
  7450. </table>
  7451. <h3 id="external-secrets.io/v1.IBMAuthContainerAuth">IBMAuthContainerAuth
  7452. </h3>
  7453. <p>
  7454. (<em>Appears on:</em>
  7455. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  7456. </p>
  7457. <p>
  7458. <p>IBMAuthContainerAuth defines container-based authentication with IAM Trusted Profile.</p>
  7459. </p>
  7460. <table>
  7461. <thead>
  7462. <tr>
  7463. <th>Field</th>
  7464. <th>Description</th>
  7465. </tr>
  7466. </thead>
  7467. <tbody>
  7468. <tr>
  7469. <td>
  7470. <code>profile</code></br>
  7471. <em>
  7472. string
  7473. </em>
  7474. </td>
  7475. <td>
  7476. <p>the IBM Trusted Profile</p>
  7477. </td>
  7478. </tr>
  7479. <tr>
  7480. <td>
  7481. <code>tokenLocation</code></br>
  7482. <em>
  7483. string
  7484. </em>
  7485. </td>
  7486. <td>
  7487. <p>Location the token is mounted on the pod</p>
  7488. </td>
  7489. </tr>
  7490. <tr>
  7491. <td>
  7492. <code>iamEndpoint</code></br>
  7493. <em>
  7494. string
  7495. </em>
  7496. </td>
  7497. <td>
  7498. </td>
  7499. </tr>
  7500. </tbody>
  7501. </table>
  7502. <h3 id="external-secrets.io/v1.IBMAuthSecretRef">IBMAuthSecretRef
  7503. </h3>
  7504. <p>
  7505. (<em>Appears on:</em>
  7506. <a href="#external-secrets.io/v1.IBMAuth">IBMAuth</a>)
  7507. </p>
  7508. <p>
  7509. <p>IBMAuthSecretRef contains the secret reference for IBM Cloud API key authentication.</p>
  7510. </p>
  7511. <table>
  7512. <thead>
  7513. <tr>
  7514. <th>Field</th>
  7515. <th>Description</th>
  7516. </tr>
  7517. </thead>
  7518. <tbody>
  7519. <tr>
  7520. <td>
  7521. <code>secretApiKeySecretRef</code></br>
  7522. <em>
  7523. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7524. External Secrets meta/v1.SecretKeySelector
  7525. </a>
  7526. </em>
  7527. </td>
  7528. <td>
  7529. <p>The SecretAccessKey is used for authentication</p>
  7530. </td>
  7531. </tr>
  7532. <tr>
  7533. <td>
  7534. <code>iamEndpoint</code></br>
  7535. <em>
  7536. string
  7537. </em>
  7538. </td>
  7539. <td>
  7540. <p>The IAM endpoint used to obain a token</p>
  7541. </td>
  7542. </tr>
  7543. </tbody>
  7544. </table>
  7545. <h3 id="external-secrets.io/v1.IBMProvider">IBMProvider
  7546. </h3>
  7547. <p>
  7548. (<em>Appears on:</em>
  7549. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7550. </p>
  7551. <p>
  7552. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager
  7553. backend.</p>
  7554. </p>
  7555. <table>
  7556. <thead>
  7557. <tr>
  7558. <th>Field</th>
  7559. <th>Description</th>
  7560. </tr>
  7561. </thead>
  7562. <tbody>
  7563. <tr>
  7564. <td>
  7565. <code>auth</code></br>
  7566. <em>
  7567. <a href="#external-secrets.io/v1.IBMAuth">
  7568. IBMAuth
  7569. </a>
  7570. </em>
  7571. </td>
  7572. <td>
  7573. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  7574. </td>
  7575. </tr>
  7576. <tr>
  7577. <td>
  7578. <code>serviceUrl</code></br>
  7579. <em>
  7580. string
  7581. </em>
  7582. </td>
  7583. <td>
  7584. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  7585. </td>
  7586. </tr>
  7587. </tbody>
  7588. </table>
  7589. <h3 id="external-secrets.io/v1.InfisicalAuth">InfisicalAuth
  7590. </h3>
  7591. <p>
  7592. (<em>Appears on:</em>
  7593. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  7594. </p>
  7595. <p>
  7596. <p>InfisicalAuth specifies the authentication configuration for Infisical.</p>
  7597. </p>
  7598. <table>
  7599. <thead>
  7600. <tr>
  7601. <th>Field</th>
  7602. <th>Description</th>
  7603. </tr>
  7604. </thead>
  7605. <tbody>
  7606. <tr>
  7607. <td>
  7608. <code>universalAuthCredentials</code></br>
  7609. <em>
  7610. <a href="#external-secrets.io/v1.UniversalAuthCredentials">
  7611. UniversalAuthCredentials
  7612. </a>
  7613. </em>
  7614. </td>
  7615. <td>
  7616. <em>(Optional)</em>
  7617. </td>
  7618. </tr>
  7619. <tr>
  7620. <td>
  7621. <code>azureAuthCredentials</code></br>
  7622. <em>
  7623. <a href="#external-secrets.io/v1.AzureAuthCredentials">
  7624. AzureAuthCredentials
  7625. </a>
  7626. </em>
  7627. </td>
  7628. <td>
  7629. <em>(Optional)</em>
  7630. </td>
  7631. </tr>
  7632. <tr>
  7633. <td>
  7634. <code>gcpIdTokenAuthCredentials</code></br>
  7635. <em>
  7636. <a href="#external-secrets.io/v1.GcpIDTokenAuthCredentials">
  7637. GcpIDTokenAuthCredentials
  7638. </a>
  7639. </em>
  7640. </td>
  7641. <td>
  7642. <em>(Optional)</em>
  7643. </td>
  7644. </tr>
  7645. <tr>
  7646. <td>
  7647. <code>gcpIamAuthCredentials</code></br>
  7648. <em>
  7649. <a href="#external-secrets.io/v1.GcpIamAuthCredentials">
  7650. GcpIamAuthCredentials
  7651. </a>
  7652. </em>
  7653. </td>
  7654. <td>
  7655. <em>(Optional)</em>
  7656. </td>
  7657. </tr>
  7658. <tr>
  7659. <td>
  7660. <code>jwtAuthCredentials</code></br>
  7661. <em>
  7662. <a href="#external-secrets.io/v1.JwtAuthCredentials">
  7663. JwtAuthCredentials
  7664. </a>
  7665. </em>
  7666. </td>
  7667. <td>
  7668. <em>(Optional)</em>
  7669. </td>
  7670. </tr>
  7671. <tr>
  7672. <td>
  7673. <code>ldapAuthCredentials</code></br>
  7674. <em>
  7675. <a href="#external-secrets.io/v1.LdapAuthCredentials">
  7676. LdapAuthCredentials
  7677. </a>
  7678. </em>
  7679. </td>
  7680. <td>
  7681. <em>(Optional)</em>
  7682. </td>
  7683. </tr>
  7684. <tr>
  7685. <td>
  7686. <code>ociAuthCredentials</code></br>
  7687. <em>
  7688. <a href="#external-secrets.io/v1.OciAuthCredentials">
  7689. OciAuthCredentials
  7690. </a>
  7691. </em>
  7692. </td>
  7693. <td>
  7694. <em>(Optional)</em>
  7695. </td>
  7696. </tr>
  7697. <tr>
  7698. <td>
  7699. <code>kubernetesAuthCredentials</code></br>
  7700. <em>
  7701. <a href="#external-secrets.io/v1.KubernetesAuthCredentials">
  7702. KubernetesAuthCredentials
  7703. </a>
  7704. </em>
  7705. </td>
  7706. <td>
  7707. <em>(Optional)</em>
  7708. </td>
  7709. </tr>
  7710. <tr>
  7711. <td>
  7712. <code>awsAuthCredentials</code></br>
  7713. <em>
  7714. <a href="#external-secrets.io/v1.AwsAuthCredentials">
  7715. AwsAuthCredentials
  7716. </a>
  7717. </em>
  7718. </td>
  7719. <td>
  7720. <em>(Optional)</em>
  7721. </td>
  7722. </tr>
  7723. <tr>
  7724. <td>
  7725. <code>tokenAuthCredentials</code></br>
  7726. <em>
  7727. <a href="#external-secrets.io/v1.TokenAuthCredentials">
  7728. TokenAuthCredentials
  7729. </a>
  7730. </em>
  7731. </td>
  7732. <td>
  7733. <em>(Optional)</em>
  7734. </td>
  7735. </tr>
  7736. </tbody>
  7737. </table>
  7738. <h3 id="external-secrets.io/v1.InfisicalProvider">InfisicalProvider
  7739. </h3>
  7740. <p>
  7741. (<em>Appears on:</em>
  7742. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7743. </p>
  7744. <p>
  7745. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  7746. </p>
  7747. <table>
  7748. <thead>
  7749. <tr>
  7750. <th>Field</th>
  7751. <th>Description</th>
  7752. </tr>
  7753. </thead>
  7754. <tbody>
  7755. <tr>
  7756. <td>
  7757. <code>auth</code></br>
  7758. <em>
  7759. <a href="#external-secrets.io/v1.InfisicalAuth">
  7760. InfisicalAuth
  7761. </a>
  7762. </em>
  7763. </td>
  7764. <td>
  7765. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  7766. </td>
  7767. </tr>
  7768. <tr>
  7769. <td>
  7770. <code>secretsScope</code></br>
  7771. <em>
  7772. <a href="#external-secrets.io/v1.MachineIdentityScopeInWorkspace">
  7773. MachineIdentityScopeInWorkspace
  7774. </a>
  7775. </em>
  7776. </td>
  7777. <td>
  7778. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  7779. </td>
  7780. </tr>
  7781. <tr>
  7782. <td>
  7783. <code>hostAPI</code></br>
  7784. <em>
  7785. string
  7786. </em>
  7787. </td>
  7788. <td>
  7789. <em>(Optional)</em>
  7790. <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>
  7791. </td>
  7792. </tr>
  7793. <tr>
  7794. <td>
  7795. <code>caBundle</code></br>
  7796. <em>
  7797. []byte
  7798. </em>
  7799. </td>
  7800. <td>
  7801. <em>(Optional)</em>
  7802. <p>CABundle is a PEM-encoded CA certificate bundle used to validate
  7803. the Infisical server&rsquo;s TLS certificate. Mutually exclusive with CAProvider.</p>
  7804. </td>
  7805. </tr>
  7806. <tr>
  7807. <td>
  7808. <code>caProvider</code></br>
  7809. <em>
  7810. <a href="#external-secrets.io/v1.CAProvider">
  7811. CAProvider
  7812. </a>
  7813. </em>
  7814. </td>
  7815. <td>
  7816. <em>(Optional)</em>
  7817. <p>CAProvider is a reference to a Secret or ConfigMap that contains a CA certificate.
  7818. The certificate is used to validate the Infisical server&rsquo;s TLS certificate.
  7819. Mutually exclusive with CABundle.</p>
  7820. </td>
  7821. </tr>
  7822. </tbody>
  7823. </table>
  7824. <h3 id="external-secrets.io/v1.IntegrationInfo">IntegrationInfo
  7825. </h3>
  7826. <p>
  7827. (<em>Appears on:</em>
  7828. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  7829. </p>
  7830. <p>
  7831. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.</p>
  7832. </p>
  7833. <table>
  7834. <thead>
  7835. <tr>
  7836. <th>Field</th>
  7837. <th>Description</th>
  7838. </tr>
  7839. </thead>
  7840. <tbody>
  7841. <tr>
  7842. <td>
  7843. <code>name</code></br>
  7844. <em>
  7845. string
  7846. </em>
  7847. </td>
  7848. <td>
  7849. <p>Name defaults to &ldquo;1Password SDK&rdquo;.</p>
  7850. </td>
  7851. </tr>
  7852. <tr>
  7853. <td>
  7854. <code>version</code></br>
  7855. <em>
  7856. string
  7857. </em>
  7858. </td>
  7859. <td>
  7860. <p>Version defaults to &ldquo;v1.0.0&rdquo;.</p>
  7861. </td>
  7862. </tr>
  7863. </tbody>
  7864. </table>
  7865. <h3 id="external-secrets.io/v1.JwtAuthCredentials">JwtAuthCredentials
  7866. </h3>
  7867. <p>
  7868. (<em>Appears on:</em>
  7869. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  7870. </p>
  7871. <p>
  7872. <p>JwtAuthCredentials represents the credentials for JWT authentication.</p>
  7873. </p>
  7874. <table>
  7875. <thead>
  7876. <tr>
  7877. <th>Field</th>
  7878. <th>Description</th>
  7879. </tr>
  7880. </thead>
  7881. <tbody>
  7882. <tr>
  7883. <td>
  7884. <code>identityId</code></br>
  7885. <em>
  7886. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7887. External Secrets meta/v1.SecretKeySelector
  7888. </a>
  7889. </em>
  7890. </td>
  7891. <td>
  7892. </td>
  7893. </tr>
  7894. <tr>
  7895. <td>
  7896. <code>jwt</code></br>
  7897. <em>
  7898. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7899. External Secrets meta/v1.SecretKeySelector
  7900. </a>
  7901. </em>
  7902. </td>
  7903. <td>
  7904. </td>
  7905. </tr>
  7906. </tbody>
  7907. </table>
  7908. <h3 id="external-secrets.io/v1.KeeperSecurityProvider">KeeperSecurityProvider
  7909. </h3>
  7910. <p>
  7911. (<em>Appears on:</em>
  7912. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  7913. </p>
  7914. <p>
  7915. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  7916. </p>
  7917. <table>
  7918. <thead>
  7919. <tr>
  7920. <th>Field</th>
  7921. <th>Description</th>
  7922. </tr>
  7923. </thead>
  7924. <tbody>
  7925. <tr>
  7926. <td>
  7927. <code>authRef</code></br>
  7928. <em>
  7929. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  7930. External Secrets meta/v1.SecretKeySelector
  7931. </a>
  7932. </em>
  7933. </td>
  7934. <td>
  7935. </td>
  7936. </tr>
  7937. <tr>
  7938. <td>
  7939. <code>folderID</code></br>
  7940. <em>
  7941. string
  7942. </em>
  7943. </td>
  7944. <td>
  7945. </td>
  7946. </tr>
  7947. </tbody>
  7948. </table>
  7949. <h3 id="external-secrets.io/v1.KubernetesAuth">KubernetesAuth
  7950. </h3>
  7951. <p>
  7952. (<em>Appears on:</em>
  7953. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  7954. </p>
  7955. <p>
  7956. <p>KubernetesAuth defines authentication options for connecting to a Kubernetes cluster.</p>
  7957. </p>
  7958. <table>
  7959. <thead>
  7960. <tr>
  7961. <th>Field</th>
  7962. <th>Description</th>
  7963. </tr>
  7964. </thead>
  7965. <tbody>
  7966. <tr>
  7967. <td>
  7968. <code>cert</code></br>
  7969. <em>
  7970. <a href="#external-secrets.io/v1.CertAuth">
  7971. CertAuth
  7972. </a>
  7973. </em>
  7974. </td>
  7975. <td>
  7976. <em>(Optional)</em>
  7977. <p>has both clientCert and clientKey as secretKeySelector</p>
  7978. </td>
  7979. </tr>
  7980. <tr>
  7981. <td>
  7982. <code>token</code></br>
  7983. <em>
  7984. <a href="#external-secrets.io/v1.TokenAuth">
  7985. TokenAuth
  7986. </a>
  7987. </em>
  7988. </td>
  7989. <td>
  7990. <em>(Optional)</em>
  7991. <p>use static token to authenticate with</p>
  7992. </td>
  7993. </tr>
  7994. <tr>
  7995. <td>
  7996. <code>serviceAccount</code></br>
  7997. <em>
  7998. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  7999. External Secrets meta/v1.ServiceAccountSelector
  8000. </a>
  8001. </em>
  8002. </td>
  8003. <td>
  8004. <em>(Optional)</em>
  8005. <p>points to a service account that should be used for authentication</p>
  8006. </td>
  8007. </tr>
  8008. </tbody>
  8009. </table>
  8010. <h3 id="external-secrets.io/v1.KubernetesAuthCredentials">KubernetesAuthCredentials
  8011. </h3>
  8012. <p>
  8013. (<em>Appears on:</em>
  8014. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8015. </p>
  8016. <p>
  8017. <p>KubernetesAuthCredentials represents the credentials for Kubernetes authentication.</p>
  8018. </p>
  8019. <table>
  8020. <thead>
  8021. <tr>
  8022. <th>Field</th>
  8023. <th>Description</th>
  8024. </tr>
  8025. </thead>
  8026. <tbody>
  8027. <tr>
  8028. <td>
  8029. <code>identityId</code></br>
  8030. <em>
  8031. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8032. External Secrets meta/v1.SecretKeySelector
  8033. </a>
  8034. </em>
  8035. </td>
  8036. <td>
  8037. </td>
  8038. </tr>
  8039. <tr>
  8040. <td>
  8041. <code>serviceAccountTokenPath</code></br>
  8042. <em>
  8043. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8044. External Secrets meta/v1.SecretKeySelector
  8045. </a>
  8046. </em>
  8047. </td>
  8048. <td>
  8049. <em>(Optional)</em>
  8050. </td>
  8051. </tr>
  8052. </tbody>
  8053. </table>
  8054. <h3 id="external-secrets.io/v1.KubernetesProvider">KubernetesProvider
  8055. </h3>
  8056. <p>
  8057. (<em>Appears on:</em>
  8058. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8059. </p>
  8060. <p>
  8061. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  8062. </p>
  8063. <table>
  8064. <thead>
  8065. <tr>
  8066. <th>Field</th>
  8067. <th>Description</th>
  8068. </tr>
  8069. </thead>
  8070. <tbody>
  8071. <tr>
  8072. <td>
  8073. <code>server</code></br>
  8074. <em>
  8075. <a href="#external-secrets.io/v1.KubernetesServer">
  8076. KubernetesServer
  8077. </a>
  8078. </em>
  8079. </td>
  8080. <td>
  8081. <em>(Optional)</em>
  8082. <p>configures the Kubernetes server Address.</p>
  8083. </td>
  8084. </tr>
  8085. <tr>
  8086. <td>
  8087. <code>auth</code></br>
  8088. <em>
  8089. <a href="#external-secrets.io/v1.KubernetesAuth">
  8090. KubernetesAuth
  8091. </a>
  8092. </em>
  8093. </td>
  8094. <td>
  8095. <em>(Optional)</em>
  8096. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  8097. </td>
  8098. </tr>
  8099. <tr>
  8100. <td>
  8101. <code>authRef</code></br>
  8102. <em>
  8103. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8104. External Secrets meta/v1.SecretKeySelector
  8105. </a>
  8106. </em>
  8107. </td>
  8108. <td>
  8109. <em>(Optional)</em>
  8110. <p>A reference to a secret that contains the auth information.</p>
  8111. </td>
  8112. </tr>
  8113. <tr>
  8114. <td>
  8115. <code>remoteNamespace</code></br>
  8116. <em>
  8117. string
  8118. </em>
  8119. </td>
  8120. <td>
  8121. <em>(Optional)</em>
  8122. <p>Remote namespace to fetch the secrets from</p>
  8123. </td>
  8124. </tr>
  8125. </tbody>
  8126. </table>
  8127. <h3 id="external-secrets.io/v1.KubernetesServer">KubernetesServer
  8128. </h3>
  8129. <p>
  8130. (<em>Appears on:</em>
  8131. <a href="#external-secrets.io/v1.KubernetesProvider">KubernetesProvider</a>)
  8132. </p>
  8133. <p>
  8134. <p>KubernetesServer defines configuration for connecting to a Kubernetes API server.</p>
  8135. </p>
  8136. <table>
  8137. <thead>
  8138. <tr>
  8139. <th>Field</th>
  8140. <th>Description</th>
  8141. </tr>
  8142. </thead>
  8143. <tbody>
  8144. <tr>
  8145. <td>
  8146. <code>url</code></br>
  8147. <em>
  8148. string
  8149. </em>
  8150. </td>
  8151. <td>
  8152. <em>(Optional)</em>
  8153. <p>configures the Kubernetes server Address.</p>
  8154. </td>
  8155. </tr>
  8156. <tr>
  8157. <td>
  8158. <code>caBundle</code></br>
  8159. <em>
  8160. []byte
  8161. </em>
  8162. </td>
  8163. <td>
  8164. <em>(Optional)</em>
  8165. <p>CABundle is a base64-encoded CA certificate</p>
  8166. </td>
  8167. </tr>
  8168. <tr>
  8169. <td>
  8170. <code>caProvider</code></br>
  8171. <em>
  8172. <a href="#external-secrets.io/v1.CAProvider">
  8173. CAProvider
  8174. </a>
  8175. </em>
  8176. </td>
  8177. <td>
  8178. <em>(Optional)</em>
  8179. <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>
  8180. </td>
  8181. </tr>
  8182. </tbody>
  8183. </table>
  8184. <h3 id="external-secrets.io/v1.LdapAuthCredentials">LdapAuthCredentials
  8185. </h3>
  8186. <p>
  8187. (<em>Appears on:</em>
  8188. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8189. </p>
  8190. <p>
  8191. <p>LdapAuthCredentials represents the credentials for LDAP authentication.</p>
  8192. </p>
  8193. <table>
  8194. <thead>
  8195. <tr>
  8196. <th>Field</th>
  8197. <th>Description</th>
  8198. </tr>
  8199. </thead>
  8200. <tbody>
  8201. <tr>
  8202. <td>
  8203. <code>identityId</code></br>
  8204. <em>
  8205. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8206. External Secrets meta/v1.SecretKeySelector
  8207. </a>
  8208. </em>
  8209. </td>
  8210. <td>
  8211. </td>
  8212. </tr>
  8213. <tr>
  8214. <td>
  8215. <code>ldapPassword</code></br>
  8216. <em>
  8217. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8218. External Secrets meta/v1.SecretKeySelector
  8219. </a>
  8220. </em>
  8221. </td>
  8222. <td>
  8223. </td>
  8224. </tr>
  8225. <tr>
  8226. <td>
  8227. <code>ldapUsername</code></br>
  8228. <em>
  8229. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8230. External Secrets meta/v1.SecretKeySelector
  8231. </a>
  8232. </em>
  8233. </td>
  8234. <td>
  8235. </td>
  8236. </tr>
  8237. </tbody>
  8238. </table>
  8239. <h3 id="external-secrets.io/v1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  8240. </h3>
  8241. <p>
  8242. (<em>Appears on:</em>
  8243. <a href="#external-secrets.io/v1.InfisicalProvider">InfisicalProvider</a>)
  8244. </p>
  8245. <p>
  8246. <p>MachineIdentityScopeInWorkspace defines the scope for machine identity within a workspace.</p>
  8247. </p>
  8248. <table>
  8249. <thead>
  8250. <tr>
  8251. <th>Field</th>
  8252. <th>Description</th>
  8253. </tr>
  8254. </thead>
  8255. <tbody>
  8256. <tr>
  8257. <td>
  8258. <code>secretsPath</code></br>
  8259. <em>
  8260. string
  8261. </em>
  8262. </td>
  8263. <td>
  8264. <em>(Optional)</em>
  8265. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  8266. </td>
  8267. </tr>
  8268. <tr>
  8269. <td>
  8270. <code>recursive</code></br>
  8271. <em>
  8272. bool
  8273. </em>
  8274. </td>
  8275. <td>
  8276. <em>(Optional)</em>
  8277. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  8278. </td>
  8279. </tr>
  8280. <tr>
  8281. <td>
  8282. <code>environmentSlug</code></br>
  8283. <em>
  8284. string
  8285. </em>
  8286. </td>
  8287. <td>
  8288. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  8289. </td>
  8290. </tr>
  8291. <tr>
  8292. <td>
  8293. <code>projectSlug</code></br>
  8294. <em>
  8295. string
  8296. </em>
  8297. </td>
  8298. <td>
  8299. <p>ProjectSlug is the required slug identifier for the project.</p>
  8300. </td>
  8301. </tr>
  8302. <tr>
  8303. <td>
  8304. <code>expandSecretReferences</code></br>
  8305. <em>
  8306. bool
  8307. </em>
  8308. </td>
  8309. <td>
  8310. <em>(Optional)</em>
  8311. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  8312. </td>
  8313. </tr>
  8314. </tbody>
  8315. </table>
  8316. <h3 id="external-secrets.io/v1.MaintenanceStatus">MaintenanceStatus
  8317. (<code>string</code> alias)</p></h3>
  8318. <p>
  8319. <p>MaintenanceStatus defines a type for different maintenance states of a provider schema.</p>
  8320. </p>
  8321. <table>
  8322. <thead>
  8323. <tr>
  8324. <th>Value</th>
  8325. <th>Description</th>
  8326. </tr>
  8327. </thead>
  8328. <tbody><tr><td><p>&#34;Deprecated&#34;</p></td>
  8329. <td></td>
  8330. </tr><tr><td><p>&#34;Maintained&#34;</p></td>
  8331. <td></td>
  8332. </tr><tr><td><p>&#34;NotMaintained&#34;</p></td>
  8333. <td></td>
  8334. </tr></tbody>
  8335. </table>
  8336. <h3 id="external-secrets.io/v1.ManifestReference">ManifestReference
  8337. </h3>
  8338. <p>
  8339. (<em>Appears on:</em>
  8340. <a href="#external-secrets.io/v1.ExternalSecretTarget">ExternalSecretTarget</a>)
  8341. </p>
  8342. <p>
  8343. <p>ManifestReference defines a custom Kubernetes resource type to be created
  8344. instead of a Secret. This allows ExternalSecret to create ConfigMaps,
  8345. Custom Resources, or any other Kubernetes resource type.</p>
  8346. </p>
  8347. <table>
  8348. <thead>
  8349. <tr>
  8350. <th>Field</th>
  8351. <th>Description</th>
  8352. </tr>
  8353. </thead>
  8354. <tbody>
  8355. <tr>
  8356. <td>
  8357. <code>apiVersion</code></br>
  8358. <em>
  8359. string
  8360. </em>
  8361. </td>
  8362. <td>
  8363. <p>APIVersion of the target resource (e.g., &ldquo;v1&rdquo; for ConfigMap, &ldquo;argoproj.io/v1alpha1&rdquo; for ArgoCD Application)</p>
  8364. </td>
  8365. </tr>
  8366. <tr>
  8367. <td>
  8368. <code>kind</code></br>
  8369. <em>
  8370. string
  8371. </em>
  8372. </td>
  8373. <td>
  8374. <p>Kind of the target resource (e.g., &ldquo;ConfigMap&rdquo;, &ldquo;Application&rdquo;)</p>
  8375. </td>
  8376. </tr>
  8377. </tbody>
  8378. </table>
  8379. <h3 id="external-secrets.io/v1.NTLMProtocol">NTLMProtocol
  8380. </h3>
  8381. <p>
  8382. (<em>Appears on:</em>
  8383. <a href="#external-secrets.io/v1.AuthorizationProtocol">AuthorizationProtocol</a>)
  8384. </p>
  8385. <p>
  8386. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  8387. </p>
  8388. <table>
  8389. <thead>
  8390. <tr>
  8391. <th>Field</th>
  8392. <th>Description</th>
  8393. </tr>
  8394. </thead>
  8395. <tbody>
  8396. <tr>
  8397. <td>
  8398. <code>usernameSecret</code></br>
  8399. <em>
  8400. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8401. External Secrets meta/v1.SecretKeySelector
  8402. </a>
  8403. </em>
  8404. </td>
  8405. <td>
  8406. </td>
  8407. </tr>
  8408. <tr>
  8409. <td>
  8410. <code>passwordSecret</code></br>
  8411. <em>
  8412. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8413. External Secrets meta/v1.SecretKeySelector
  8414. </a>
  8415. </em>
  8416. </td>
  8417. <td>
  8418. </td>
  8419. </tr>
  8420. </tbody>
  8421. </table>
  8422. <h3 id="external-secrets.io/v1.NebiusAuth">NebiusAuth
  8423. </h3>
  8424. <p>
  8425. (<em>Appears on:</em>
  8426. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  8427. </p>
  8428. <p>
  8429. <p>NebiusAuth defines the authentication method for the Nebius provider.</p>
  8430. </p>
  8431. <table>
  8432. <thead>
  8433. <tr>
  8434. <th>Field</th>
  8435. <th>Description</th>
  8436. </tr>
  8437. </thead>
  8438. <tbody>
  8439. <tr>
  8440. <td>
  8441. <code>serviceAccountCredsSecretRef</code></br>
  8442. <em>
  8443. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8444. External Secrets meta/v1.SecretKeySelector
  8445. </a>
  8446. </em>
  8447. </td>
  8448. <td>
  8449. <em>(Optional)</em>
  8450. <p>ServiceAccountCreds references a Kubernetes Secret key that contains a JSON
  8451. document with service account credentials used to get an IAM token.</p>
  8452. <p>Expected JSON structure:
  8453. {
  8454. &ldquo;subject-credentials&rdquo;: {
  8455. &ldquo;alg&rdquo;: &ldquo;RS256&rdquo;,
  8456. &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;,
  8457. &ldquo;kid&rdquo;: &ldquo;<public-key-id>&rdquo;,
  8458. &ldquo;iss&rdquo;: &ldquo;<issuer-service-account-id>&rdquo;,
  8459. &ldquo;sub&rdquo;: &ldquo;<subject-service-account-id>&rdquo;
  8460. }
  8461. }</p>
  8462. </td>
  8463. </tr>
  8464. <tr>
  8465. <td>
  8466. <code>tokenSecretRef</code></br>
  8467. <em>
  8468. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8469. External Secrets meta/v1.SecretKeySelector
  8470. </a>
  8471. </em>
  8472. </td>
  8473. <td>
  8474. <em>(Optional)</em>
  8475. <p>Token authenticates with Nebius Mysterybox by presenting a token.</p>
  8476. </td>
  8477. </tr>
  8478. </tbody>
  8479. </table>
  8480. <h3 id="external-secrets.io/v1.NebiusCAProvider">NebiusCAProvider
  8481. </h3>
  8482. <p>
  8483. (<em>Appears on:</em>
  8484. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider</a>)
  8485. </p>
  8486. <p>
  8487. <p>NebiusCAProvider The provider for the CA bundle to use to validate Nebius server certificate.</p>
  8488. </p>
  8489. <table>
  8490. <thead>
  8491. <tr>
  8492. <th>Field</th>
  8493. <th>Description</th>
  8494. </tr>
  8495. </thead>
  8496. <tbody>
  8497. <tr>
  8498. <td>
  8499. <code>certSecretRef</code></br>
  8500. <em>
  8501. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8502. External Secrets meta/v1.SecretKeySelector
  8503. </a>
  8504. </em>
  8505. </td>
  8506. <td>
  8507. <em>(Optional)</em>
  8508. </td>
  8509. </tr>
  8510. </tbody>
  8511. </table>
  8512. <h3 id="external-secrets.io/v1.NebiusMysteryboxProvider">NebiusMysteryboxProvider
  8513. </h3>
  8514. <p>
  8515. (<em>Appears on:</em>
  8516. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8517. </p>
  8518. <p>
  8519. <p>NebiusMysteryboxProvider Configures a store to sync secrets using the Nebius Mysterybox provider.</p>
  8520. </p>
  8521. <table>
  8522. <thead>
  8523. <tr>
  8524. <th>Field</th>
  8525. <th>Description</th>
  8526. </tr>
  8527. </thead>
  8528. <tbody>
  8529. <tr>
  8530. <td>
  8531. <code>apiDomain</code></br>
  8532. <em>
  8533. string
  8534. </em>
  8535. </td>
  8536. <td>
  8537. <p>NebiusMysterybox API endpoint</p>
  8538. </td>
  8539. </tr>
  8540. <tr>
  8541. <td>
  8542. <code>auth</code></br>
  8543. <em>
  8544. <a href="#external-secrets.io/v1.NebiusAuth">
  8545. NebiusAuth
  8546. </a>
  8547. </em>
  8548. </td>
  8549. <td>
  8550. <p>Auth defines parameters to authenticate in MysteryBox</p>
  8551. </td>
  8552. </tr>
  8553. <tr>
  8554. <td>
  8555. <code>caProvider</code></br>
  8556. <em>
  8557. <a href="#external-secrets.io/v1.NebiusCAProvider">
  8558. NebiusCAProvider
  8559. </a>
  8560. </em>
  8561. </td>
  8562. <td>
  8563. <em>(Optional)</em>
  8564. <p>The provider for the CA bundle to use to validate NebiusMysterybox server certificate.</p>
  8565. </td>
  8566. </tr>
  8567. </tbody>
  8568. </table>
  8569. <h3 id="external-secrets.io/v1.NgrokAuth">NgrokAuth
  8570. </h3>
  8571. <p>
  8572. (<em>Appears on:</em>
  8573. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  8574. </p>
  8575. <p>
  8576. <p>NgrokAuth configures the authentication method for the ngrok provider.</p>
  8577. </p>
  8578. <table>
  8579. <thead>
  8580. <tr>
  8581. <th>Field</th>
  8582. <th>Description</th>
  8583. </tr>
  8584. </thead>
  8585. <tbody>
  8586. <tr>
  8587. <td>
  8588. <code>apiKey</code></br>
  8589. <em>
  8590. <a href="#external-secrets.io/v1.NgrokProviderSecretRef">
  8591. NgrokProviderSecretRef
  8592. </a>
  8593. </em>
  8594. </td>
  8595. <td>
  8596. <em>(Optional)</em>
  8597. <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>
  8598. </td>
  8599. </tr>
  8600. </tbody>
  8601. </table>
  8602. <h3 id="external-secrets.io/v1.NgrokProvider">NgrokProvider
  8603. </h3>
  8604. <p>
  8605. (<em>Appears on:</em>
  8606. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8607. </p>
  8608. <p>
  8609. <p>NgrokProvider configures a store to sync secrets with a ngrok vault to use in traffic policies.
  8610. See: <a href="https://ngrok.com/blog-post/secrets-for-traffic-policy">https://ngrok.com/blog-post/secrets-for-traffic-policy</a></p>
  8611. </p>
  8612. <table>
  8613. <thead>
  8614. <tr>
  8615. <th>Field</th>
  8616. <th>Description</th>
  8617. </tr>
  8618. </thead>
  8619. <tbody>
  8620. <tr>
  8621. <td>
  8622. <code>apiUrl</code></br>
  8623. <em>
  8624. string
  8625. </em>
  8626. </td>
  8627. <td>
  8628. <p>APIURL is the URL of the ngrok API.</p>
  8629. </td>
  8630. </tr>
  8631. <tr>
  8632. <td>
  8633. <code>auth</code></br>
  8634. <em>
  8635. <a href="#external-secrets.io/v1.NgrokAuth">
  8636. NgrokAuth
  8637. </a>
  8638. </em>
  8639. </td>
  8640. <td>
  8641. <p>Auth configures how the ngrok provider authenticates with the ngrok API.</p>
  8642. </td>
  8643. </tr>
  8644. <tr>
  8645. <td>
  8646. <code>vault</code></br>
  8647. <em>
  8648. <a href="#external-secrets.io/v1.NgrokVault">
  8649. NgrokVault
  8650. </a>
  8651. </em>
  8652. </td>
  8653. <td>
  8654. <p>Vault configures the ngrok vault to sync secrets with.</p>
  8655. </td>
  8656. </tr>
  8657. </tbody>
  8658. </table>
  8659. <h3 id="external-secrets.io/v1.NgrokProviderSecretRef">NgrokProviderSecretRef
  8660. </h3>
  8661. <p>
  8662. (<em>Appears on:</em>
  8663. <a href="#external-secrets.io/v1.NgrokAuth">NgrokAuth</a>)
  8664. </p>
  8665. <p>
  8666. <p>NgrokProviderSecretRef contains the secret reference for the ngrok provider.</p>
  8667. </p>
  8668. <table>
  8669. <thead>
  8670. <tr>
  8671. <th>Field</th>
  8672. <th>Description</th>
  8673. </tr>
  8674. </thead>
  8675. <tbody>
  8676. <tr>
  8677. <td>
  8678. <code>secretRef</code></br>
  8679. <em>
  8680. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8681. External Secrets meta/v1.SecretKeySelector
  8682. </a>
  8683. </em>
  8684. </td>
  8685. <td>
  8686. <em>(Optional)</em>
  8687. <p>SecretRef is a reference to a secret containing the ngrok API key.</p>
  8688. </td>
  8689. </tr>
  8690. </tbody>
  8691. </table>
  8692. <h3 id="external-secrets.io/v1.NgrokVault">NgrokVault
  8693. </h3>
  8694. <p>
  8695. (<em>Appears on:</em>
  8696. <a href="#external-secrets.io/v1.NgrokProvider">NgrokProvider</a>)
  8697. </p>
  8698. <p>
  8699. <p>NgrokVault configures the ngrok vault to sync secrets with.</p>
  8700. </p>
  8701. <table>
  8702. <thead>
  8703. <tr>
  8704. <th>Field</th>
  8705. <th>Description</th>
  8706. </tr>
  8707. </thead>
  8708. <tbody>
  8709. <tr>
  8710. <td>
  8711. <code>name</code></br>
  8712. <em>
  8713. string
  8714. </em>
  8715. </td>
  8716. <td>
  8717. <p>Name is the name of the ngrok vault to sync secrets with.</p>
  8718. </td>
  8719. </tr>
  8720. </tbody>
  8721. </table>
  8722. <h3 id="external-secrets.io/v1.NoSecretError">NoSecretError
  8723. </h3>
  8724. <p>
  8725. <p>NoSecretError shall be returned when a GetSecret can not find the
  8726. desired secret. This is used for deletionPolicy.</p>
  8727. </p>
  8728. <h3 id="external-secrets.io/v1.NotModifiedError">NotModifiedError
  8729. </h3>
  8730. <p>
  8731. <p>NotModifiedError to signal that the webhook received no changes,
  8732. and it should just return without doing anything.</p>
  8733. </p>
  8734. <h3 id="external-secrets.io/v1.OciAuthCredentials">OciAuthCredentials
  8735. </h3>
  8736. <p>
  8737. (<em>Appears on:</em>
  8738. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  8739. </p>
  8740. <p>
  8741. <p>OciAuthCredentials represents the credentials for OCI authentication.</p>
  8742. </p>
  8743. <table>
  8744. <thead>
  8745. <tr>
  8746. <th>Field</th>
  8747. <th>Description</th>
  8748. </tr>
  8749. </thead>
  8750. <tbody>
  8751. <tr>
  8752. <td>
  8753. <code>identityId</code></br>
  8754. <em>
  8755. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8756. External Secrets meta/v1.SecretKeySelector
  8757. </a>
  8758. </em>
  8759. </td>
  8760. <td>
  8761. </td>
  8762. </tr>
  8763. <tr>
  8764. <td>
  8765. <code>privateKey</code></br>
  8766. <em>
  8767. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8768. External Secrets meta/v1.SecretKeySelector
  8769. </a>
  8770. </em>
  8771. </td>
  8772. <td>
  8773. </td>
  8774. </tr>
  8775. <tr>
  8776. <td>
  8777. <code>privateKeyPassphrase</code></br>
  8778. <em>
  8779. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8780. External Secrets meta/v1.SecretKeySelector
  8781. </a>
  8782. </em>
  8783. </td>
  8784. <td>
  8785. <em>(Optional)</em>
  8786. </td>
  8787. </tr>
  8788. <tr>
  8789. <td>
  8790. <code>fingerprint</code></br>
  8791. <em>
  8792. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8793. External Secrets meta/v1.SecretKeySelector
  8794. </a>
  8795. </em>
  8796. </td>
  8797. <td>
  8798. </td>
  8799. </tr>
  8800. <tr>
  8801. <td>
  8802. <code>userId</code></br>
  8803. <em>
  8804. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8805. External Secrets meta/v1.SecretKeySelector
  8806. </a>
  8807. </em>
  8808. </td>
  8809. <td>
  8810. </td>
  8811. </tr>
  8812. <tr>
  8813. <td>
  8814. <code>tenancyId</code></br>
  8815. <em>
  8816. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8817. External Secrets meta/v1.SecretKeySelector
  8818. </a>
  8819. </em>
  8820. </td>
  8821. <td>
  8822. </td>
  8823. </tr>
  8824. <tr>
  8825. <td>
  8826. <code>region</code></br>
  8827. <em>
  8828. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8829. External Secrets meta/v1.SecretKeySelector
  8830. </a>
  8831. </em>
  8832. </td>
  8833. <td>
  8834. </td>
  8835. </tr>
  8836. </tbody>
  8837. </table>
  8838. <h3 id="external-secrets.io/v1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  8839. </h3>
  8840. <p>
  8841. (<em>Appears on:</em>
  8842. <a href="#external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider</a>)
  8843. </p>
  8844. <p>
  8845. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  8846. </p>
  8847. <table>
  8848. <thead>
  8849. <tr>
  8850. <th>Field</th>
  8851. <th>Description</th>
  8852. </tr>
  8853. </thead>
  8854. <tbody>
  8855. <tr>
  8856. <td>
  8857. <code>apiKeyRef</code></br>
  8858. <em>
  8859. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8860. External Secrets meta/v1.SecretKeySelector
  8861. </a>
  8862. </em>
  8863. </td>
  8864. <td>
  8865. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  8866. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  8867. </td>
  8868. </tr>
  8869. <tr>
  8870. <td>
  8871. <code>passcodeRef</code></br>
  8872. <em>
  8873. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  8874. External Secrets meta/v1.SecretKeySelector
  8875. </a>
  8876. </em>
  8877. </td>
  8878. <td>
  8879. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  8880. </td>
  8881. </tr>
  8882. </tbody>
  8883. </table>
  8884. <h3 id="external-secrets.io/v1.OnboardbaseProvider">OnboardbaseProvider
  8885. </h3>
  8886. <p>
  8887. (<em>Appears on:</em>
  8888. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  8889. </p>
  8890. <p>
  8891. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  8892. Project and Config are required if not using a Service Token.</p>
  8893. </p>
  8894. <table>
  8895. <thead>
  8896. <tr>
  8897. <th>Field</th>
  8898. <th>Description</th>
  8899. </tr>
  8900. </thead>
  8901. <tbody>
  8902. <tr>
  8903. <td>
  8904. <code>auth</code></br>
  8905. <em>
  8906. <a href="#external-secrets.io/v1.OnboardbaseAuthSecretRef">
  8907. OnboardbaseAuthSecretRef
  8908. </a>
  8909. </em>
  8910. </td>
  8911. <td>
  8912. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  8913. </td>
  8914. </tr>
  8915. <tr>
  8916. <td>
  8917. <code>apiHost</code></br>
  8918. <em>
  8919. string
  8920. </em>
  8921. </td>
  8922. <td>
  8923. <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>
  8924. </td>
  8925. </tr>
  8926. <tr>
  8927. <td>
  8928. <code>project</code></br>
  8929. <em>
  8930. string
  8931. </em>
  8932. </td>
  8933. <td>
  8934. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  8935. </td>
  8936. </tr>
  8937. <tr>
  8938. <td>
  8939. <code>environment</code></br>
  8940. <em>
  8941. string
  8942. </em>
  8943. </td>
  8944. <td>
  8945. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  8946. </td>
  8947. </tr>
  8948. </tbody>
  8949. </table>
  8950. <h3 id="external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth
  8951. </h3>
  8952. <p>
  8953. (<em>Appears on:</em>
  8954. <a href="#external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider</a>)
  8955. </p>
  8956. <p>
  8957. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  8958. </p>
  8959. <table>
  8960. <thead>
  8961. <tr>
  8962. <th>Field</th>
  8963. <th>Description</th>
  8964. </tr>
  8965. </thead>
  8966. <tbody>
  8967. <tr>
  8968. <td>
  8969. <code>secretRef</code></br>
  8970. <em>
  8971. <a href="#external-secrets.io/v1.OnePasswordAuthSecretRef">
  8972. OnePasswordAuthSecretRef
  8973. </a>
  8974. </em>
  8975. </td>
  8976. <td>
  8977. </td>
  8978. </tr>
  8979. </tbody>
  8980. </table>
  8981. <h3 id="external-secrets.io/v1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  8982. </h3>
  8983. <p>
  8984. (<em>Appears on:</em>
  8985. <a href="#external-secrets.io/v1.OnePasswordAuth">OnePasswordAuth</a>)
  8986. </p>
  8987. <p>
  8988. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  8989. </p>
  8990. <table>
  8991. <thead>
  8992. <tr>
  8993. <th>Field</th>
  8994. <th>Description</th>
  8995. </tr>
  8996. </thead>
  8997. <tbody>
  8998. <tr>
  8999. <td>
  9000. <code>connectTokenSecretRef</code></br>
  9001. <em>
  9002. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9003. External Secrets meta/v1.SecretKeySelector
  9004. </a>
  9005. </em>
  9006. </td>
  9007. <td>
  9008. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  9009. </td>
  9010. </tr>
  9011. </tbody>
  9012. </table>
  9013. <h3 id="external-secrets.io/v1.OnePasswordProvider">OnePasswordProvider
  9014. </h3>
  9015. <p>
  9016. (<em>Appears on:</em>
  9017. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9018. </p>
  9019. <p>
  9020. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  9021. </p>
  9022. <table>
  9023. <thead>
  9024. <tr>
  9025. <th>Field</th>
  9026. <th>Description</th>
  9027. </tr>
  9028. </thead>
  9029. <tbody>
  9030. <tr>
  9031. <td>
  9032. <code>auth</code></br>
  9033. <em>
  9034. <a href="#external-secrets.io/v1.OnePasswordAuth">
  9035. OnePasswordAuth
  9036. </a>
  9037. </em>
  9038. </td>
  9039. <td>
  9040. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  9041. </td>
  9042. </tr>
  9043. <tr>
  9044. <td>
  9045. <code>connectHost</code></br>
  9046. <em>
  9047. string
  9048. </em>
  9049. </td>
  9050. <td>
  9051. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  9052. </td>
  9053. </tr>
  9054. <tr>
  9055. <td>
  9056. <code>vaults</code></br>
  9057. <em>
  9058. map[string]int
  9059. </em>
  9060. </td>
  9061. <td>
  9062. <p>Vaults defines which OnePassword vaults to search in which order</p>
  9063. </td>
  9064. </tr>
  9065. </tbody>
  9066. </table>
  9067. <h3 id="external-secrets.io/v1.OnePasswordSDKAuth">OnePasswordSDKAuth
  9068. </h3>
  9069. <p>
  9070. (<em>Appears on:</em>
  9071. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider</a>)
  9072. </p>
  9073. <p>
  9074. <p>OnePasswordSDKAuth contains a secretRef for the service account token.</p>
  9075. </p>
  9076. <table>
  9077. <thead>
  9078. <tr>
  9079. <th>Field</th>
  9080. <th>Description</th>
  9081. </tr>
  9082. </thead>
  9083. <tbody>
  9084. <tr>
  9085. <td>
  9086. <code>serviceAccountSecretRef</code></br>
  9087. <em>
  9088. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9089. External Secrets meta/v1.SecretKeySelector
  9090. </a>
  9091. </em>
  9092. </td>
  9093. <td>
  9094. <p>ServiceAccountSecretRef points to the secret containing the token to access 1Password vault.</p>
  9095. </td>
  9096. </tr>
  9097. </tbody>
  9098. </table>
  9099. <h3 id="external-secrets.io/v1.OnePasswordSDKProvider">OnePasswordSDKProvider
  9100. </h3>
  9101. <p>
  9102. (<em>Appears on:</em>
  9103. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9104. </p>
  9105. <p>
  9106. <p>OnePasswordSDKProvider configures a store to sync secrets using the 1Password sdk.</p>
  9107. </p>
  9108. <table>
  9109. <thead>
  9110. <tr>
  9111. <th>Field</th>
  9112. <th>Description</th>
  9113. </tr>
  9114. </thead>
  9115. <tbody>
  9116. <tr>
  9117. <td>
  9118. <code>vault</code></br>
  9119. <em>
  9120. string
  9121. </em>
  9122. </td>
  9123. <td>
  9124. <p>Vault defines the vault&rsquo;s name or uuid to access. Do NOT add op:// prefix. This will be done automatically.</p>
  9125. </td>
  9126. </tr>
  9127. <tr>
  9128. <td>
  9129. <code>integrationInfo</code></br>
  9130. <em>
  9131. <a href="#external-secrets.io/v1.IntegrationInfo">
  9132. IntegrationInfo
  9133. </a>
  9134. </em>
  9135. </td>
  9136. <td>
  9137. <em>(Optional)</em>
  9138. <p>IntegrationInfo specifies the name and version of the integration built using the 1Password Go SDK.
  9139. If you don&rsquo;t know which name and version to use, use <code>DefaultIntegrationName</code> and <code>DefaultIntegrationVersion</code>, respectively.</p>
  9140. </td>
  9141. </tr>
  9142. <tr>
  9143. <td>
  9144. <code>auth</code></br>
  9145. <em>
  9146. <a href="#external-secrets.io/v1.OnePasswordSDKAuth">
  9147. OnePasswordSDKAuth
  9148. </a>
  9149. </em>
  9150. </td>
  9151. <td>
  9152. <p>Auth defines the information necessary to authenticate against OnePassword API.</p>
  9153. </td>
  9154. </tr>
  9155. <tr>
  9156. <td>
  9157. <code>cache</code></br>
  9158. <em>
  9159. <a href="#external-secrets.io/v1.CacheConfig">
  9160. CacheConfig
  9161. </a>
  9162. </em>
  9163. </td>
  9164. <td>
  9165. <em>(Optional)</em>
  9166. <p>Cache configures client-side caching for read operations (GetSecret, GetSecretMap).
  9167. When enabled, secrets are cached with the specified TTL.
  9168. Write operations (PushSecret, DeleteSecret) automatically invalidate relevant cache entries.
  9169. If omitted, caching is disabled (default).
  9170. cache: {} is a valid option to set.</p>
  9171. </td>
  9172. </tr>
  9173. </tbody>
  9174. </table>
  9175. <h3 id="external-secrets.io/v1.OracleAuth">OracleAuth
  9176. </h3>
  9177. <p>
  9178. (<em>Appears on:</em>
  9179. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  9180. </p>
  9181. <p>
  9182. <p>OracleAuth defines the authentication method for the Oracle Vault provider.</p>
  9183. </p>
  9184. <table>
  9185. <thead>
  9186. <tr>
  9187. <th>Field</th>
  9188. <th>Description</th>
  9189. </tr>
  9190. </thead>
  9191. <tbody>
  9192. <tr>
  9193. <td>
  9194. <code>tenancy</code></br>
  9195. <em>
  9196. string
  9197. </em>
  9198. </td>
  9199. <td>
  9200. <p>Tenancy is the tenancy OCID where user is located.</p>
  9201. </td>
  9202. </tr>
  9203. <tr>
  9204. <td>
  9205. <code>user</code></br>
  9206. <em>
  9207. string
  9208. </em>
  9209. </td>
  9210. <td>
  9211. <p>User is an access OCID specific to the account.</p>
  9212. </td>
  9213. </tr>
  9214. <tr>
  9215. <td>
  9216. <code>secretRef</code></br>
  9217. <em>
  9218. <a href="#external-secrets.io/v1.OracleSecretRef">
  9219. OracleSecretRef
  9220. </a>
  9221. </em>
  9222. </td>
  9223. <td>
  9224. <p>SecretRef to pass through sensitive information.</p>
  9225. </td>
  9226. </tr>
  9227. </tbody>
  9228. </table>
  9229. <h3 id="external-secrets.io/v1.OraclePrincipalType">OraclePrincipalType
  9230. (<code>string</code> alias)</p></h3>
  9231. <p>
  9232. (<em>Appears on:</em>
  9233. <a href="#external-secrets.io/v1.OracleProvider">OracleProvider</a>)
  9234. </p>
  9235. <p>
  9236. <p>OraclePrincipalType defines the type of principal used for authentication with Oracle Vault.</p>
  9237. </p>
  9238. <table>
  9239. <thead>
  9240. <tr>
  9241. <th>Value</th>
  9242. <th>Description</th>
  9243. </tr>
  9244. </thead>
  9245. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  9246. <td><p>InstancePrincipal represents a instance principal.</p>
  9247. </td>
  9248. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  9249. <td><p>UserPrincipal represents a user principal.</p>
  9250. </td>
  9251. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  9252. <td><p>WorkloadPrincipal represents a workload principal.</p>
  9253. </td>
  9254. </tr></tbody>
  9255. </table>
  9256. <h3 id="external-secrets.io/v1.OracleProvider">OracleProvider
  9257. </h3>
  9258. <p>
  9259. (<em>Appears on:</em>
  9260. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9261. </p>
  9262. <p>
  9263. <p>OracleProvider configures a store to sync secrets using an Oracle Vault
  9264. backend.</p>
  9265. </p>
  9266. <table>
  9267. <thead>
  9268. <tr>
  9269. <th>Field</th>
  9270. <th>Description</th>
  9271. </tr>
  9272. </thead>
  9273. <tbody>
  9274. <tr>
  9275. <td>
  9276. <code>region</code></br>
  9277. <em>
  9278. string
  9279. </em>
  9280. </td>
  9281. <td>
  9282. <p>Region is the region where vault is located.</p>
  9283. </td>
  9284. </tr>
  9285. <tr>
  9286. <td>
  9287. <code>vault</code></br>
  9288. <em>
  9289. string
  9290. </em>
  9291. </td>
  9292. <td>
  9293. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  9294. </td>
  9295. </tr>
  9296. <tr>
  9297. <td>
  9298. <code>compartment</code></br>
  9299. <em>
  9300. string
  9301. </em>
  9302. </td>
  9303. <td>
  9304. <em>(Optional)</em>
  9305. <p>Compartment is the vault compartment OCID.
  9306. Required for PushSecret</p>
  9307. </td>
  9308. </tr>
  9309. <tr>
  9310. <td>
  9311. <code>encryptionKey</code></br>
  9312. <em>
  9313. string
  9314. </em>
  9315. </td>
  9316. <td>
  9317. <em>(Optional)</em>
  9318. <p>EncryptionKey is the OCID of the encryption key within the vault.
  9319. Required for PushSecret</p>
  9320. </td>
  9321. </tr>
  9322. <tr>
  9323. <td>
  9324. <code>principalType</code></br>
  9325. <em>
  9326. <a href="#external-secrets.io/v1.OraclePrincipalType">
  9327. OraclePrincipalType
  9328. </a>
  9329. </em>
  9330. </td>
  9331. <td>
  9332. <em>(Optional)</em>
  9333. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  9334. determine the principal type. This optional field must be specified if using
  9335. workload identity.</p>
  9336. </td>
  9337. </tr>
  9338. <tr>
  9339. <td>
  9340. <code>auth</code></br>
  9341. <em>
  9342. <a href="#external-secrets.io/v1.OracleAuth">
  9343. OracleAuth
  9344. </a>
  9345. </em>
  9346. </td>
  9347. <td>
  9348. <em>(Optional)</em>
  9349. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  9350. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  9351. </td>
  9352. </tr>
  9353. <tr>
  9354. <td>
  9355. <code>serviceAccountRef</code></br>
  9356. <em>
  9357. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  9358. External Secrets meta/v1.ServiceAccountSelector
  9359. </a>
  9360. </em>
  9361. </td>
  9362. <td>
  9363. <em>(Optional)</em>
  9364. <p>ServiceAccountRef specified the service account
  9365. that should be used when authenticating with WorkloadIdentity.</p>
  9366. </td>
  9367. </tr>
  9368. </tbody>
  9369. </table>
  9370. <h3 id="external-secrets.io/v1.OracleSecretRef">OracleSecretRef
  9371. </h3>
  9372. <p>
  9373. (<em>Appears on:</em>
  9374. <a href="#external-secrets.io/v1.OracleAuth">OracleAuth</a>)
  9375. </p>
  9376. <p>
  9377. <p>OracleSecretRef contains the secret reference for Oracle Vault authentication credentials.</p>
  9378. </p>
  9379. <table>
  9380. <thead>
  9381. <tr>
  9382. <th>Field</th>
  9383. <th>Description</th>
  9384. </tr>
  9385. </thead>
  9386. <tbody>
  9387. <tr>
  9388. <td>
  9389. <code>privatekey</code></br>
  9390. <em>
  9391. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9392. External Secrets meta/v1.SecretKeySelector
  9393. </a>
  9394. </em>
  9395. </td>
  9396. <td>
  9397. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  9398. </td>
  9399. </tr>
  9400. <tr>
  9401. <td>
  9402. <code>fingerprint</code></br>
  9403. <em>
  9404. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9405. External Secrets meta/v1.SecretKeySelector
  9406. </a>
  9407. </em>
  9408. </td>
  9409. <td>
  9410. <p>Fingerprint is the fingerprint of the API private key.</p>
  9411. </td>
  9412. </tr>
  9413. </tbody>
  9414. </table>
  9415. <h3 id="external-secrets.io/v1.PassboltAuth">PassboltAuth
  9416. </h3>
  9417. <p>
  9418. (<em>Appears on:</em>
  9419. <a href="#external-secrets.io/v1.PassboltProvider">PassboltProvider</a>)
  9420. </p>
  9421. <p>
  9422. <p>PassboltAuth contains a secretRef for the passbolt credentials.</p>
  9423. </p>
  9424. <table>
  9425. <thead>
  9426. <tr>
  9427. <th>Field</th>
  9428. <th>Description</th>
  9429. </tr>
  9430. </thead>
  9431. <tbody>
  9432. <tr>
  9433. <td>
  9434. <code>passwordSecretRef</code></br>
  9435. <em>
  9436. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9437. External Secrets meta/v1.SecretKeySelector
  9438. </a>
  9439. </em>
  9440. </td>
  9441. <td>
  9442. </td>
  9443. </tr>
  9444. <tr>
  9445. <td>
  9446. <code>privateKeySecretRef</code></br>
  9447. <em>
  9448. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9449. External Secrets meta/v1.SecretKeySelector
  9450. </a>
  9451. </em>
  9452. </td>
  9453. <td>
  9454. </td>
  9455. </tr>
  9456. </tbody>
  9457. </table>
  9458. <h3 id="external-secrets.io/v1.PassboltProvider">PassboltProvider
  9459. </h3>
  9460. <p>
  9461. (<em>Appears on:</em>
  9462. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9463. </p>
  9464. <p>
  9465. <p>PassboltProvider provides access to Passbolt secrets manager.
  9466. See: <a href="https://www.passbolt.com">https://www.passbolt.com</a>.</p>
  9467. </p>
  9468. <table>
  9469. <thead>
  9470. <tr>
  9471. <th>Field</th>
  9472. <th>Description</th>
  9473. </tr>
  9474. </thead>
  9475. <tbody>
  9476. <tr>
  9477. <td>
  9478. <code>auth</code></br>
  9479. <em>
  9480. <a href="#external-secrets.io/v1.PassboltAuth">
  9481. PassboltAuth
  9482. </a>
  9483. </em>
  9484. </td>
  9485. <td>
  9486. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  9487. </td>
  9488. </tr>
  9489. <tr>
  9490. <td>
  9491. <code>host</code></br>
  9492. <em>
  9493. string
  9494. </em>
  9495. </td>
  9496. <td>
  9497. <p>Host defines the Passbolt Server to connect to</p>
  9498. </td>
  9499. </tr>
  9500. </tbody>
  9501. </table>
  9502. <h3 id="external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth
  9503. </h3>
  9504. <p>
  9505. (<em>Appears on:</em>
  9506. <a href="#external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider</a>)
  9507. </p>
  9508. <p>
  9509. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  9510. </p>
  9511. <table>
  9512. <thead>
  9513. <tr>
  9514. <th>Field</th>
  9515. <th>Description</th>
  9516. </tr>
  9517. </thead>
  9518. <tbody>
  9519. <tr>
  9520. <td>
  9521. <code>secretRef</code></br>
  9522. <em>
  9523. <a href="#external-secrets.io/v1.PasswordDepotSecretRef">
  9524. PasswordDepotSecretRef
  9525. </a>
  9526. </em>
  9527. </td>
  9528. <td>
  9529. </td>
  9530. </tr>
  9531. </tbody>
  9532. </table>
  9533. <h3 id="external-secrets.io/v1.PasswordDepotProvider">PasswordDepotProvider
  9534. </h3>
  9535. <p>
  9536. (<em>Appears on:</em>
  9537. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9538. </p>
  9539. <p>
  9540. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  9541. </p>
  9542. <table>
  9543. <thead>
  9544. <tr>
  9545. <th>Field</th>
  9546. <th>Description</th>
  9547. </tr>
  9548. </thead>
  9549. <tbody>
  9550. <tr>
  9551. <td>
  9552. <code>host</code></br>
  9553. <em>
  9554. string
  9555. </em>
  9556. </td>
  9557. <td>
  9558. <p>URL configures the Password Depot instance URL.</p>
  9559. </td>
  9560. </tr>
  9561. <tr>
  9562. <td>
  9563. <code>database</code></br>
  9564. <em>
  9565. string
  9566. </em>
  9567. </td>
  9568. <td>
  9569. <p>Database to use as source</p>
  9570. </td>
  9571. </tr>
  9572. <tr>
  9573. <td>
  9574. <code>auth</code></br>
  9575. <em>
  9576. <a href="#external-secrets.io/v1.PasswordDepotAuth">
  9577. PasswordDepotAuth
  9578. </a>
  9579. </em>
  9580. </td>
  9581. <td>
  9582. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  9583. </td>
  9584. </tr>
  9585. </tbody>
  9586. </table>
  9587. <h3 id="external-secrets.io/v1.PasswordDepotSecretRef">PasswordDepotSecretRef
  9588. </h3>
  9589. <p>
  9590. (<em>Appears on:</em>
  9591. <a href="#external-secrets.io/v1.PasswordDepotAuth">PasswordDepotAuth</a>)
  9592. </p>
  9593. <p>
  9594. <p>PasswordDepotSecretRef contains the secret reference for Password Depot authentication.</p>
  9595. </p>
  9596. <table>
  9597. <thead>
  9598. <tr>
  9599. <th>Field</th>
  9600. <th>Description</th>
  9601. </tr>
  9602. </thead>
  9603. <tbody>
  9604. <tr>
  9605. <td>
  9606. <code>credentials</code></br>
  9607. <em>
  9608. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9609. External Secrets meta/v1.SecretKeySelector
  9610. </a>
  9611. </em>
  9612. </td>
  9613. <td>
  9614. <em>(Optional)</em>
  9615. <p>Username / Password is used for authentication.</p>
  9616. </td>
  9617. </tr>
  9618. </tbody>
  9619. </table>
  9620. <h3 id="external-secrets.io/v1.PreviderAuth">PreviderAuth
  9621. </h3>
  9622. <p>
  9623. (<em>Appears on:</em>
  9624. <a href="#external-secrets.io/v1.PreviderProvider">PreviderProvider</a>)
  9625. </p>
  9626. <p>
  9627. <p>PreviderAuth contains a secretRef for credentials.</p>
  9628. </p>
  9629. <table>
  9630. <thead>
  9631. <tr>
  9632. <th>Field</th>
  9633. <th>Description</th>
  9634. </tr>
  9635. </thead>
  9636. <tbody>
  9637. <tr>
  9638. <td>
  9639. <code>secretRef</code></br>
  9640. <em>
  9641. <a href="#external-secrets.io/v1.PreviderAuthSecretRef">
  9642. PreviderAuthSecretRef
  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.PreviderAuthSecretRef">PreviderAuthSecretRef
  9653. </h3>
  9654. <p>
  9655. (<em>Appears on:</em>
  9656. <a href="#external-secrets.io/v1.PreviderAuth">PreviderAuth</a>)
  9657. </p>
  9658. <p>
  9659. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</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>accessToken</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. <p>The AccessToken is used for authentication</p>
  9680. </td>
  9681. </tr>
  9682. </tbody>
  9683. </table>
  9684. <h3 id="external-secrets.io/v1.PreviderProvider">PreviderProvider
  9685. </h3>
  9686. <p>
  9687. (<em>Appears on:</em>
  9688. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9689. </p>
  9690. <p>
  9691. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</p>
  9692. </p>
  9693. <table>
  9694. <thead>
  9695. <tr>
  9696. <th>Field</th>
  9697. <th>Description</th>
  9698. </tr>
  9699. </thead>
  9700. <tbody>
  9701. <tr>
  9702. <td>
  9703. <code>auth</code></br>
  9704. <em>
  9705. <a href="#external-secrets.io/v1.PreviderAuth">
  9706. PreviderAuth
  9707. </a>
  9708. </em>
  9709. </td>
  9710. <td>
  9711. </td>
  9712. </tr>
  9713. <tr>
  9714. <td>
  9715. <code>baseUri</code></br>
  9716. <em>
  9717. string
  9718. </em>
  9719. </td>
  9720. <td>
  9721. <em>(Optional)</em>
  9722. </td>
  9723. </tr>
  9724. </tbody>
  9725. </table>
  9726. <h3 id="external-secrets.io/v1.Provider">Provider
  9727. </h3>
  9728. <p>
  9729. <p>Provider is a common interface for interacting with secret backends.</p>
  9730. </p>
  9731. <h3 id="external-secrets.io/v1.PulumiProvider">PulumiProvider
  9732. </h3>
  9733. <p>
  9734. (<em>Appears on:</em>
  9735. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9736. </p>
  9737. <p>
  9738. <p>PulumiProvider defines configuration for accessing secrets from Pulumi ESC.</p>
  9739. </p>
  9740. <table>
  9741. <thead>
  9742. <tr>
  9743. <th>Field</th>
  9744. <th>Description</th>
  9745. </tr>
  9746. </thead>
  9747. <tbody>
  9748. <tr>
  9749. <td>
  9750. <code>apiUrl</code></br>
  9751. <em>
  9752. string
  9753. </em>
  9754. </td>
  9755. <td>
  9756. <p>APIURL is the URL of the Pulumi API.</p>
  9757. </td>
  9758. </tr>
  9759. <tr>
  9760. <td>
  9761. <code>accessToken</code></br>
  9762. <em>
  9763. <a href="#external-secrets.io/v1.PulumiProviderSecretRef">
  9764. PulumiProviderSecretRef
  9765. </a>
  9766. </em>
  9767. </td>
  9768. <td>
  9769. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  9770. </td>
  9771. </tr>
  9772. <tr>
  9773. <td>
  9774. <code>organization</code></br>
  9775. <em>
  9776. string
  9777. </em>
  9778. </td>
  9779. <td>
  9780. <p>Organization are a space to collaborate on shared projects and stacks.
  9781. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  9782. </td>
  9783. </tr>
  9784. <tr>
  9785. <td>
  9786. <code>project</code></br>
  9787. <em>
  9788. string
  9789. </em>
  9790. </td>
  9791. <td>
  9792. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  9793. </td>
  9794. </tr>
  9795. <tr>
  9796. <td>
  9797. <code>environment</code></br>
  9798. <em>
  9799. string
  9800. </em>
  9801. </td>
  9802. <td>
  9803. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  9804. dynamically retrieved values from supported providers including all major clouds,
  9805. and other Pulumi ESC environments.
  9806. 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>
  9807. </td>
  9808. </tr>
  9809. </tbody>
  9810. </table>
  9811. <h3 id="external-secrets.io/v1.PulumiProviderSecretRef">PulumiProviderSecretRef
  9812. </h3>
  9813. <p>
  9814. (<em>Appears on:</em>
  9815. <a href="#external-secrets.io/v1.PulumiProvider">PulumiProvider</a>)
  9816. </p>
  9817. <p>
  9818. <p>PulumiProviderSecretRef contains the secret reference for Pulumi authentication.</p>
  9819. </p>
  9820. <table>
  9821. <thead>
  9822. <tr>
  9823. <th>Field</th>
  9824. <th>Description</th>
  9825. </tr>
  9826. </thead>
  9827. <tbody>
  9828. <tr>
  9829. <td>
  9830. <code>secretRef</code></br>
  9831. <em>
  9832. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9833. External Secrets meta/v1.SecretKeySelector
  9834. </a>
  9835. </em>
  9836. </td>
  9837. <td>
  9838. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  9839. </td>
  9840. </tr>
  9841. </tbody>
  9842. </table>
  9843. <h3 id="external-secrets.io/v1.PushSecretData">PushSecretData
  9844. </h3>
  9845. <p>
  9846. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1.</p>
  9847. </p>
  9848. <h3 id="external-secrets.io/v1.PushSecretRemoteRef">PushSecretRemoteRef
  9849. </h3>
  9850. <p>
  9851. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1.</p>
  9852. </p>
  9853. <h3 id="external-secrets.io/v1.ScalewayProvider">ScalewayProvider
  9854. </h3>
  9855. <p>
  9856. (<em>Appears on:</em>
  9857. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  9858. </p>
  9859. <p>
  9860. <p>ScalewayProvider defines the configuration for the Scaleway Secret Manager provider.</p>
  9861. </p>
  9862. <table>
  9863. <thead>
  9864. <tr>
  9865. <th>Field</th>
  9866. <th>Description</th>
  9867. </tr>
  9868. </thead>
  9869. <tbody>
  9870. <tr>
  9871. <td>
  9872. <code>apiUrl</code></br>
  9873. <em>
  9874. string
  9875. </em>
  9876. </td>
  9877. <td>
  9878. <em>(Optional)</em>
  9879. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  9880. </td>
  9881. </tr>
  9882. <tr>
  9883. <td>
  9884. <code>region</code></br>
  9885. <em>
  9886. string
  9887. </em>
  9888. </td>
  9889. <td>
  9890. <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>
  9891. </td>
  9892. </tr>
  9893. <tr>
  9894. <td>
  9895. <code>projectId</code></br>
  9896. <em>
  9897. string
  9898. </em>
  9899. </td>
  9900. <td>
  9901. <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>
  9902. </td>
  9903. </tr>
  9904. <tr>
  9905. <td>
  9906. <code>accessKey</code></br>
  9907. <em>
  9908. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  9909. ScalewayProviderSecretRef
  9910. </a>
  9911. </em>
  9912. </td>
  9913. <td>
  9914. <p>AccessKey is the non-secret part of the api key.</p>
  9915. </td>
  9916. </tr>
  9917. <tr>
  9918. <td>
  9919. <code>secretKey</code></br>
  9920. <em>
  9921. <a href="#external-secrets.io/v1.ScalewayProviderSecretRef">
  9922. ScalewayProviderSecretRef
  9923. </a>
  9924. </em>
  9925. </td>
  9926. <td>
  9927. <p>SecretKey is the non-secret part of the api key.</p>
  9928. </td>
  9929. </tr>
  9930. </tbody>
  9931. </table>
  9932. <h3 id="external-secrets.io/v1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  9933. </h3>
  9934. <p>
  9935. (<em>Appears on:</em>
  9936. <a href="#external-secrets.io/v1.ScalewayProvider">ScalewayProvider</a>)
  9937. </p>
  9938. <p>
  9939. <p>ScalewayProviderSecretRef defines the configuration for Scaleway secret references.</p>
  9940. </p>
  9941. <table>
  9942. <thead>
  9943. <tr>
  9944. <th>Field</th>
  9945. <th>Description</th>
  9946. </tr>
  9947. </thead>
  9948. <tbody>
  9949. <tr>
  9950. <td>
  9951. <code>value</code></br>
  9952. <em>
  9953. string
  9954. </em>
  9955. </td>
  9956. <td>
  9957. <em>(Optional)</em>
  9958. <p>Value can be specified directly to set a value without using a secret.</p>
  9959. </td>
  9960. </tr>
  9961. <tr>
  9962. <td>
  9963. <code>secretRef</code></br>
  9964. <em>
  9965. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  9966. External Secrets meta/v1.SecretKeySelector
  9967. </a>
  9968. </em>
  9969. </td>
  9970. <td>
  9971. <em>(Optional)</em>
  9972. <p>SecretRef references a key in a secret that will be used as value.</p>
  9973. </td>
  9974. </tr>
  9975. </tbody>
  9976. </table>
  9977. <h3 id="external-secrets.io/v1.SecretReference">SecretReference
  9978. </h3>
  9979. <p>
  9980. (<em>Appears on:</em>
  9981. <a href="#external-secrets.io/v1.AwsCredentialsConfig">AwsCredentialsConfig</a>)
  9982. </p>
  9983. <p>
  9984. <p>SecretReference holds the details of a secret.</p>
  9985. </p>
  9986. <table>
  9987. <thead>
  9988. <tr>
  9989. <th>Field</th>
  9990. <th>Description</th>
  9991. </tr>
  9992. </thead>
  9993. <tbody>
  9994. <tr>
  9995. <td>
  9996. <code>name</code></br>
  9997. <em>
  9998. string
  9999. </em>
  10000. </td>
  10001. <td>
  10002. <p>name of the secret.</p>
  10003. </td>
  10004. </tr>
  10005. <tr>
  10006. <td>
  10007. <code>namespace</code></br>
  10008. <em>
  10009. string
  10010. </em>
  10011. </td>
  10012. <td>
  10013. <p>namespace in which the secret exists. If empty, secret will looked up in local namespace.</p>
  10014. </td>
  10015. </tr>
  10016. </tbody>
  10017. </table>
  10018. <h3 id="external-secrets.io/v1.SecretServerProvider">SecretServerProvider
  10019. </h3>
  10020. <p>
  10021. (<em>Appears on:</em>
  10022. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  10023. </p>
  10024. <p>
  10025. <p>SecretServerProvider provides access to authenticate to a secrets provider server.
  10026. 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>
  10027. </p>
  10028. <table>
  10029. <thead>
  10030. <tr>
  10031. <th>Field</th>
  10032. <th>Description</th>
  10033. </tr>
  10034. </thead>
  10035. <tbody>
  10036. <tr>
  10037. <td>
  10038. <code>username</code></br>
  10039. <em>
  10040. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  10041. SecretServerProviderRef
  10042. </a>
  10043. </em>
  10044. </td>
  10045. <td>
  10046. <p>Username is the secret server account username.</p>
  10047. </td>
  10048. </tr>
  10049. <tr>
  10050. <td>
  10051. <code>password</code></br>
  10052. <em>
  10053. <a href="#external-secrets.io/v1.SecretServerProviderRef">
  10054. SecretServerProviderRef
  10055. </a>
  10056. </em>
  10057. </td>
  10058. <td>
  10059. <p>Password is the secret server account password.</p>
  10060. </td>
  10061. </tr>
  10062. <tr>
  10063. <td>
  10064. <code>domain</code></br>
  10065. <em>
  10066. string
  10067. </em>
  10068. </td>
  10069. <td>
  10070. <em>(Optional)</em>
  10071. <p>Domain is the secret server domain.</p>
  10072. </td>
  10073. </tr>
  10074. <tr>
  10075. <td>
  10076. <code>serverURL</code></br>
  10077. <em>
  10078. string
  10079. </em>
  10080. </td>
  10081. <td>
  10082. <p>ServerURL
  10083. URL to your secret server installation</p>
  10084. </td>
  10085. </tr>
  10086. <tr>
  10087. <td>
  10088. <code>caBundle</code></br>
  10089. <em>
  10090. []byte
  10091. </em>
  10092. </td>
  10093. <td>
  10094. <em>(Optional)</em>
  10095. <p>PEM/base64 encoded CA bundle used to validate Secret ServerURL. Only used
  10096. if the ServerURL URL is using HTTPS protocol. If not set the system root certificates
  10097. are used to validate the TLS connection.</p>
  10098. </td>
  10099. </tr>
  10100. <tr>
  10101. <td>
  10102. <code>caProvider</code></br>
  10103. <em>
  10104. <a href="#external-secrets.io/v1.CAProvider">
  10105. CAProvider
  10106. </a>
  10107. </em>
  10108. </td>
  10109. <td>
  10110. <em>(Optional)</em>
  10111. <p>The provider for the CA bundle to use to validate Secret ServerURL certificate.</p>
  10112. </td>
  10113. </tr>
  10114. </tbody>
  10115. </table>
  10116. <h3 id="external-secrets.io/v1.SecretServerProviderRef">SecretServerProviderRef
  10117. </h3>
  10118. <p>
  10119. (<em>Appears on:</em>
  10120. <a href="#external-secrets.io/v1.SecretServerProvider">SecretServerProvider</a>)
  10121. </p>
  10122. <p>
  10123. <p>SecretServerProviderRef references a value that can be specified directly or via a secret
  10124. for a SecretServerProvider.</p>
  10125. </p>
  10126. <table>
  10127. <thead>
  10128. <tr>
  10129. <th>Field</th>
  10130. <th>Description</th>
  10131. </tr>
  10132. </thead>
  10133. <tbody>
  10134. <tr>
  10135. <td>
  10136. <code>value</code></br>
  10137. <em>
  10138. string
  10139. </em>
  10140. </td>
  10141. <td>
  10142. <em>(Optional)</em>
  10143. <p>Value can be specified directly to set a value without using a secret.</p>
  10144. </td>
  10145. </tr>
  10146. <tr>
  10147. <td>
  10148. <code>secretRef</code></br>
  10149. <em>
  10150. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  10151. External Secrets meta/v1.SecretKeySelector
  10152. </a>
  10153. </em>
  10154. </td>
  10155. <td>
  10156. <em>(Optional)</em>
  10157. <p>SecretRef references a key in a secret that will be used as value.</p>
  10158. </td>
  10159. </tr>
  10160. </tbody>
  10161. </table>
  10162. <h3 id="external-secrets.io/v1.SecretStore">SecretStore
  10163. </h3>
  10164. <p>
  10165. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  10166. </p>
  10167. <table>
  10168. <thead>
  10169. <tr>
  10170. <th>Field</th>
  10171. <th>Description</th>
  10172. </tr>
  10173. </thead>
  10174. <tbody>
  10175. <tr>
  10176. <td>
  10177. <code>metadata</code></br>
  10178. <em>
  10179. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  10180. Kubernetes meta/v1.ObjectMeta
  10181. </a>
  10182. </em>
  10183. </td>
  10184. <td>
  10185. Refer to the Kubernetes API documentation for the fields of the
  10186. <code>metadata</code> field.
  10187. </td>
  10188. </tr>
  10189. <tr>
  10190. <td>
  10191. <code>spec</code></br>
  10192. <em>
  10193. <a href="#external-secrets.io/v1.SecretStoreSpec">
  10194. SecretStoreSpec
  10195. </a>
  10196. </em>
  10197. </td>
  10198. <td>
  10199. <br/>
  10200. <br/>
  10201. <table>
  10202. <tr>
  10203. <td>
  10204. <code>controller</code></br>
  10205. <em>
  10206. string
  10207. </em>
  10208. </td>
  10209. <td>
  10210. <em>(Optional)</em>
  10211. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  10212. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  10213. </td>
  10214. </tr>
  10215. <tr>
  10216. <td>
  10217. <code>provider</code></br>
  10218. <em>
  10219. <a href="#external-secrets.io/v1.SecretStoreProvider">
  10220. SecretStoreProvider
  10221. </a>
  10222. </em>
  10223. </td>
  10224. <td>
  10225. <p>Used to configure the provider. Only one provider may be set</p>
  10226. </td>
  10227. </tr>
  10228. <tr>
  10229. <td>
  10230. <code>retrySettings</code></br>
  10231. <em>
  10232. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  10233. SecretStoreRetrySettings
  10234. </a>
  10235. </em>
  10236. </td>
  10237. <td>
  10238. <em>(Optional)</em>
  10239. <p>Used to configure HTTP retries on failures.</p>
  10240. </td>
  10241. </tr>
  10242. <tr>
  10243. <td>
  10244. <code>refreshInterval</code></br>
  10245. <em>
  10246. int
  10247. </em>
  10248. </td>
  10249. <td>
  10250. <em>(Optional)</em>
  10251. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  10252. </td>
  10253. </tr>
  10254. <tr>
  10255. <td>
  10256. <code>conditions</code></br>
  10257. <em>
  10258. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  10259. []ClusterSecretStoreCondition
  10260. </a>
  10261. </em>
  10262. </td>
  10263. <td>
  10264. <em>(Optional)</em>
  10265. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  10266. </td>
  10267. </tr>
  10268. </table>
  10269. </td>
  10270. </tr>
  10271. <tr>
  10272. <td>
  10273. <code>status</code></br>
  10274. <em>
  10275. <a href="#external-secrets.io/v1.SecretStoreStatus">
  10276. SecretStoreStatus
  10277. </a>
  10278. </em>
  10279. </td>
  10280. <td>
  10281. </td>
  10282. </tr>
  10283. </tbody>
  10284. </table>
  10285. <h3 id="external-secrets.io/v1.SecretStoreCapabilities">SecretStoreCapabilities
  10286. (<code>string</code> alias)</p></h3>
  10287. <p>
  10288. (<em>Appears on:</em>
  10289. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  10290. </p>
  10291. <p>
  10292. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  10293. </p>
  10294. <table>
  10295. <thead>
  10296. <tr>
  10297. <th>Value</th>
  10298. <th>Description</th>
  10299. </tr>
  10300. </thead>
  10301. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  10302. <td><p>SecretStoreReadOnly indicates that the store can only read secrets.</p>
  10303. </td>
  10304. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  10305. <td><p>SecretStoreReadWrite indicates that the store can both read and write secrets.</p>
  10306. </td>
  10307. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  10308. <td><p>SecretStoreWriteOnly indicates that the store can only write secrets.</p>
  10309. </td>
  10310. </tr></tbody>
  10311. </table>
  10312. <h3 id="external-secrets.io/v1.SecretStoreConditionType">SecretStoreConditionType
  10313. (<code>string</code> alias)</p></h3>
  10314. <p>
  10315. (<em>Appears on:</em>
  10316. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  10317. </p>
  10318. <p>
  10319. <p>SecretStoreConditionType represents the condition of the SecretStore.</p>
  10320. </p>
  10321. <table>
  10322. <thead>
  10323. <tr>
  10324. <th>Value</th>
  10325. <th>Description</th>
  10326. </tr>
  10327. </thead>
  10328. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  10329. <td><p>SecretStoreReady indicates that the store is ready and able to serve requests.</p>
  10330. </td>
  10331. </tr></tbody>
  10332. </table>
  10333. <h3 id="external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider
  10334. </h3>
  10335. <p>
  10336. (<em>Appears on:</em>
  10337. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>)
  10338. </p>
  10339. <p>
  10340. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  10341. </p>
  10342. <table>
  10343. <thead>
  10344. <tr>
  10345. <th>Field</th>
  10346. <th>Description</th>
  10347. </tr>
  10348. </thead>
  10349. <tbody>
  10350. <tr>
  10351. <td>
  10352. <code>aws</code></br>
  10353. <em>
  10354. <a href="#external-secrets.io/v1.AWSProvider">
  10355. AWSProvider
  10356. </a>
  10357. </em>
  10358. </td>
  10359. <td>
  10360. <em>(Optional)</em>
  10361. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  10362. </td>
  10363. </tr>
  10364. <tr>
  10365. <td>
  10366. <code>azurekv</code></br>
  10367. <em>
  10368. <a href="#external-secrets.io/v1.AzureKVProvider">
  10369. AzureKVProvider
  10370. </a>
  10371. </em>
  10372. </td>
  10373. <td>
  10374. <em>(Optional)</em>
  10375. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  10376. </td>
  10377. </tr>
  10378. <tr>
  10379. <td>
  10380. <code>akeyless</code></br>
  10381. <em>
  10382. <a href="#external-secrets.io/v1.AkeylessProvider">
  10383. AkeylessProvider
  10384. </a>
  10385. </em>
  10386. </td>
  10387. <td>
  10388. <em>(Optional)</em>
  10389. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  10390. </td>
  10391. </tr>
  10392. <tr>
  10393. <td>
  10394. <code>bitwardensecretsmanager</code></br>
  10395. <em>
  10396. <a href="#external-secrets.io/v1.BitwardenSecretsManagerProvider">
  10397. BitwardenSecretsManagerProvider
  10398. </a>
  10399. </em>
  10400. </td>
  10401. <td>
  10402. <em>(Optional)</em>
  10403. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  10404. </td>
  10405. </tr>
  10406. <tr>
  10407. <td>
  10408. <code>vault</code></br>
  10409. <em>
  10410. <a href="#external-secrets.io/v1.VaultProvider">
  10411. VaultProvider
  10412. </a>
  10413. </em>
  10414. </td>
  10415. <td>
  10416. <em>(Optional)</em>
  10417. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  10418. </td>
  10419. </tr>
  10420. <tr>
  10421. <td>
  10422. <code>gcpsm</code></br>
  10423. <em>
  10424. <a href="#external-secrets.io/v1.GCPSMProvider">
  10425. GCPSMProvider
  10426. </a>
  10427. </em>
  10428. </td>
  10429. <td>
  10430. <em>(Optional)</em>
  10431. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  10432. </td>
  10433. </tr>
  10434. <tr>
  10435. <td>
  10436. <code>oracle</code></br>
  10437. <em>
  10438. <a href="#external-secrets.io/v1.OracleProvider">
  10439. OracleProvider
  10440. </a>
  10441. </em>
  10442. </td>
  10443. <td>
  10444. <em>(Optional)</em>
  10445. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  10446. </td>
  10447. </tr>
  10448. <tr>
  10449. <td>
  10450. <code>ibm</code></br>
  10451. <em>
  10452. <a href="#external-secrets.io/v1.IBMProvider">
  10453. IBMProvider
  10454. </a>
  10455. </em>
  10456. </td>
  10457. <td>
  10458. <em>(Optional)</em>
  10459. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  10460. </td>
  10461. </tr>
  10462. <tr>
  10463. <td>
  10464. <code>yandexcertificatemanager</code></br>
  10465. <em>
  10466. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">
  10467. YandexCertificateManagerProvider
  10468. </a>
  10469. </em>
  10470. </td>
  10471. <td>
  10472. <em>(Optional)</em>
  10473. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  10474. </td>
  10475. </tr>
  10476. <tr>
  10477. <td>
  10478. <code>yandexlockbox</code></br>
  10479. <em>
  10480. <a href="#external-secrets.io/v1.YandexLockboxProvider">
  10481. YandexLockboxProvider
  10482. </a>
  10483. </em>
  10484. </td>
  10485. <td>
  10486. <em>(Optional)</em>
  10487. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  10488. </td>
  10489. </tr>
  10490. <tr>
  10491. <td>
  10492. <code>github</code></br>
  10493. <em>
  10494. <a href="#external-secrets.io/v1.GithubProvider">
  10495. GithubProvider
  10496. </a>
  10497. </em>
  10498. </td>
  10499. <td>
  10500. <em>(Optional)</em>
  10501. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.
  10502. Note: This provider only supports write operations (PushSecret) and cannot fetch secrets from GitHub</p>
  10503. </td>
  10504. </tr>
  10505. <tr>
  10506. <td>
  10507. <code>gitlab</code></br>
  10508. <em>
  10509. <a href="#external-secrets.io/v1.GitlabProvider">
  10510. GitlabProvider
  10511. </a>
  10512. </em>
  10513. </td>
  10514. <td>
  10515. <em>(Optional)</em>
  10516. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  10517. </td>
  10518. </tr>
  10519. <tr>
  10520. <td>
  10521. <code>onepassword</code></br>
  10522. <em>
  10523. <a href="#external-secrets.io/v1.OnePasswordProvider">
  10524. OnePasswordProvider
  10525. </a>
  10526. </em>
  10527. </td>
  10528. <td>
  10529. <em>(Optional)</em>
  10530. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  10531. </td>
  10532. </tr>
  10533. <tr>
  10534. <td>
  10535. <code>onepasswordSDK</code></br>
  10536. <em>
  10537. <a href="#external-secrets.io/v1.OnePasswordSDKProvider">
  10538. OnePasswordSDKProvider
  10539. </a>
  10540. </em>
  10541. </td>
  10542. <td>
  10543. <em>(Optional)</em>
  10544. <p>OnePasswordSDK configures this store to use 1Password&rsquo;s new Go SDK to sync secrets.</p>
  10545. </td>
  10546. </tr>
  10547. <tr>
  10548. <td>
  10549. <code>webhook</code></br>
  10550. <em>
  10551. <a href="#external-secrets.io/v1.WebhookProvider">
  10552. WebhookProvider
  10553. </a>
  10554. </em>
  10555. </td>
  10556. <td>
  10557. <em>(Optional)</em>
  10558. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  10559. </td>
  10560. </tr>
  10561. <tr>
  10562. <td>
  10563. <code>kubernetes</code></br>
  10564. <em>
  10565. <a href="#external-secrets.io/v1.KubernetesProvider">
  10566. KubernetesProvider
  10567. </a>
  10568. </em>
  10569. </td>
  10570. <td>
  10571. <em>(Optional)</em>
  10572. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  10573. </td>
  10574. </tr>
  10575. <tr>
  10576. <td>
  10577. <code>fake</code></br>
  10578. <em>
  10579. <a href="#external-secrets.io/v1.FakeProvider">
  10580. FakeProvider
  10581. </a>
  10582. </em>
  10583. </td>
  10584. <td>
  10585. <em>(Optional)</em>
  10586. <p>Fake configures a store with static key/value pairs</p>
  10587. </td>
  10588. </tr>
  10589. <tr>
  10590. <td>
  10591. <code>senhasegura</code></br>
  10592. <em>
  10593. <a href="#external-secrets.io/v1.SenhaseguraProvider">
  10594. SenhaseguraProvider
  10595. </a>
  10596. </em>
  10597. </td>
  10598. <td>
  10599. <em>(Optional)</em>
  10600. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  10601. </td>
  10602. </tr>
  10603. <tr>
  10604. <td>
  10605. <code>scaleway</code></br>
  10606. <em>
  10607. <a href="#external-secrets.io/v1.ScalewayProvider">
  10608. ScalewayProvider
  10609. </a>
  10610. </em>
  10611. </td>
  10612. <td>
  10613. <em>(Optional)</em>
  10614. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  10615. </td>
  10616. </tr>
  10617. <tr>
  10618. <td>
  10619. <code>doppler</code></br>
  10620. <em>
  10621. <a href="#external-secrets.io/v1.DopplerProvider">
  10622. DopplerProvider
  10623. </a>
  10624. </em>
  10625. </td>
  10626. <td>
  10627. <em>(Optional)</em>
  10628. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  10629. </td>
  10630. </tr>
  10631. <tr>
  10632. <td>
  10633. <code>previder</code></br>
  10634. <em>
  10635. <a href="#external-secrets.io/v1.PreviderProvider">
  10636. PreviderProvider
  10637. </a>
  10638. </em>
  10639. </td>
  10640. <td>
  10641. <em>(Optional)</em>
  10642. <p>Previder configures this store to sync secrets using the Previder provider</p>
  10643. </td>
  10644. </tr>
  10645. <tr>
  10646. <td>
  10647. <code>onboardbase</code></br>
  10648. <em>
  10649. <a href="#external-secrets.io/v1.OnboardbaseProvider">
  10650. OnboardbaseProvider
  10651. </a>
  10652. </em>
  10653. </td>
  10654. <td>
  10655. <em>(Optional)</em>
  10656. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  10657. </td>
  10658. </tr>
  10659. <tr>
  10660. <td>
  10661. <code>keepersecurity</code></br>
  10662. <em>
  10663. <a href="#external-secrets.io/v1.KeeperSecurityProvider">
  10664. KeeperSecurityProvider
  10665. </a>
  10666. </em>
  10667. </td>
  10668. <td>
  10669. <em>(Optional)</em>
  10670. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  10671. </td>
  10672. </tr>
  10673. <tr>
  10674. <td>
  10675. <code>conjur</code></br>
  10676. <em>
  10677. <a href="#external-secrets.io/v1.ConjurProvider">
  10678. ConjurProvider
  10679. </a>
  10680. </em>
  10681. </td>
  10682. <td>
  10683. <em>(Optional)</em>
  10684. <p>Conjur configures this store to sync secrets using conjur provider</p>
  10685. </td>
  10686. </tr>
  10687. <tr>
  10688. <td>
  10689. <code>delinea</code></br>
  10690. <em>
  10691. <a href="#external-secrets.io/v1.DelineaProvider">
  10692. DelineaProvider
  10693. </a>
  10694. </em>
  10695. </td>
  10696. <td>
  10697. <em>(Optional)</em>
  10698. <p>Delinea DevOps Secrets Vault
  10699. <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>
  10700. </td>
  10701. </tr>
  10702. <tr>
  10703. <td>
  10704. <code>secretserver</code></br>
  10705. <em>
  10706. <a href="#external-secrets.io/v1.SecretServerProvider">
  10707. SecretServerProvider
  10708. </a>
  10709. </em>
  10710. </td>
  10711. <td>
  10712. <em>(Optional)</em>
  10713. <p>SecretServer configures this store to sync secrets using SecretServer provider
  10714. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  10715. </td>
  10716. </tr>
  10717. <tr>
  10718. <td>
  10719. <code>chef</code></br>
  10720. <em>
  10721. <a href="#external-secrets.io/v1.ChefProvider">
  10722. ChefProvider
  10723. </a>
  10724. </em>
  10725. </td>
  10726. <td>
  10727. <em>(Optional)</em>
  10728. <p>Chef configures this store to sync secrets with chef server</p>
  10729. </td>
  10730. </tr>
  10731. <tr>
  10732. <td>
  10733. <code>pulumi</code></br>
  10734. <em>
  10735. <a href="#external-secrets.io/v1.PulumiProvider">
  10736. PulumiProvider
  10737. </a>
  10738. </em>
  10739. </td>
  10740. <td>
  10741. <em>(Optional)</em>
  10742. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  10743. </td>
  10744. </tr>
  10745. <tr>
  10746. <td>
  10747. <code>fortanix</code></br>
  10748. <em>
  10749. <a href="#external-secrets.io/v1.FortanixProvider">
  10750. FortanixProvider
  10751. </a>
  10752. </em>
  10753. </td>
  10754. <td>
  10755. <em>(Optional)</em>
  10756. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  10757. </td>
  10758. </tr>
  10759. <tr>
  10760. <td>
  10761. <code>passworddepot</code></br>
  10762. <em>
  10763. <a href="#external-secrets.io/v1.PasswordDepotProvider">
  10764. PasswordDepotProvider
  10765. </a>
  10766. </em>
  10767. </td>
  10768. <td>
  10769. <em>(Optional)</em>
  10770. </td>
  10771. </tr>
  10772. <tr>
  10773. <td>
  10774. <code>passbolt</code></br>
  10775. <em>
  10776. <a href="#external-secrets.io/v1.PassboltProvider">
  10777. PassboltProvider
  10778. </a>
  10779. </em>
  10780. </td>
  10781. <td>
  10782. <em>(Optional)</em>
  10783. </td>
  10784. </tr>
  10785. <tr>
  10786. <td>
  10787. <code>dvls</code></br>
  10788. <em>
  10789. <a href="#external-secrets.io/v1.DVLSProvider">
  10790. DVLSProvider
  10791. </a>
  10792. </em>
  10793. </td>
  10794. <td>
  10795. <em>(Optional)</em>
  10796. <p>DVLS configures this store to sync secrets using Devolutions Server provider</p>
  10797. </td>
  10798. </tr>
  10799. <tr>
  10800. <td>
  10801. <code>infisical</code></br>
  10802. <em>
  10803. <a href="#external-secrets.io/v1.InfisicalProvider">
  10804. InfisicalProvider
  10805. </a>
  10806. </em>
  10807. </td>
  10808. <td>
  10809. <em>(Optional)</em>
  10810. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  10811. </td>
  10812. </tr>
  10813. <tr>
  10814. <td>
  10815. <code>beyondtrust</code></br>
  10816. <em>
  10817. <a href="#external-secrets.io/v1.BeyondtrustProvider">
  10818. BeyondtrustProvider
  10819. </a>
  10820. </em>
  10821. </td>
  10822. <td>
  10823. <em>(Optional)</em>
  10824. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  10825. </td>
  10826. </tr>
  10827. <tr>
  10828. <td>
  10829. <code>cloudrusm</code></br>
  10830. <em>
  10831. <a href="#external-secrets.io/v1.CloudruSMProvider">
  10832. CloudruSMProvider
  10833. </a>
  10834. </em>
  10835. </td>
  10836. <td>
  10837. <em>(Optional)</em>
  10838. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  10839. </td>
  10840. </tr>
  10841. <tr>
  10842. <td>
  10843. <code>volcengine</code></br>
  10844. <em>
  10845. <a href="#external-secrets.io/v1.VolcengineProvider">
  10846. VolcengineProvider
  10847. </a>
  10848. </em>
  10849. </td>
  10850. <td>
  10851. <em>(Optional)</em>
  10852. <p>Volcengine configures this store to sync secrets using the Volcengine provider</p>
  10853. </td>
  10854. </tr>
  10855. <tr>
  10856. <td>
  10857. <code>ngrok</code></br>
  10858. <em>
  10859. <a href="#external-secrets.io/v1.NgrokProvider">
  10860. NgrokProvider
  10861. </a>
  10862. </em>
  10863. </td>
  10864. <td>
  10865. <em>(Optional)</em>
  10866. <p>Ngrok configures this store to sync secrets using the ngrok provider.</p>
  10867. </td>
  10868. </tr>
  10869. <tr>
  10870. <td>
  10871. <code>barbican</code></br>
  10872. <em>
  10873. <a href="#external-secrets.io/v1.BarbicanProvider">
  10874. BarbicanProvider
  10875. </a>
  10876. </em>
  10877. </td>
  10878. <td>
  10879. <em>(Optional)</em>
  10880. <p>Barbican configures this store to sync secrets using the OpenStack Barbican provider</p>
  10881. </td>
  10882. </tr>
  10883. <tr>
  10884. <td>
  10885. <code>nebiusmysterybox</code></br>
  10886. <em>
  10887. <a href="#external-secrets.io/v1.NebiusMysteryboxProvider">
  10888. NebiusMysteryboxProvider
  10889. </a>
  10890. </em>
  10891. </td>
  10892. <td>
  10893. <em>(Optional)</em>
  10894. <p>NebiusMysterybox configures this store to sync secrets using NebiusMysterybox provider</p>
  10895. </td>
  10896. </tr>
  10897. </tbody>
  10898. </table>
  10899. <h3 id="external-secrets.io/v1.SecretStoreRef">SecretStoreRef
  10900. </h3>
  10901. <p>
  10902. (<em>Appears on:</em>
  10903. <a href="#external-secrets.io/v1.ExternalSecretSpec">ExternalSecretSpec</a>,
  10904. <a href="#external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  10905. <a href="#external-secrets.io/v1.StoreSourceRef">StoreSourceRef</a>)
  10906. </p>
  10907. <p>
  10908. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  10909. </p>
  10910. <table>
  10911. <thead>
  10912. <tr>
  10913. <th>Field</th>
  10914. <th>Description</th>
  10915. </tr>
  10916. </thead>
  10917. <tbody>
  10918. <tr>
  10919. <td>
  10920. <code>name</code></br>
  10921. <em>
  10922. string
  10923. </em>
  10924. </td>
  10925. <td>
  10926. <p>Name of the SecretStore resource</p>
  10927. </td>
  10928. </tr>
  10929. <tr>
  10930. <td>
  10931. <code>kind</code></br>
  10932. <em>
  10933. string
  10934. </em>
  10935. </td>
  10936. <td>
  10937. <em>(Optional)</em>
  10938. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  10939. Defaults to <code>SecretStore</code></p>
  10940. </td>
  10941. </tr>
  10942. </tbody>
  10943. </table>
  10944. <h3 id="external-secrets.io/v1.SecretStoreRetrySettings">SecretStoreRetrySettings
  10945. </h3>
  10946. <p>
  10947. (<em>Appears on:</em>
  10948. <a href="#external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec</a>,
  10949. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  10950. </p>
  10951. <p>
  10952. <p>SecretStoreRetrySettings defines the retry settings for accessing external secrets manager stores.</p>
  10953. </p>
  10954. <table>
  10955. <thead>
  10956. <tr>
  10957. <th>Field</th>
  10958. <th>Description</th>
  10959. </tr>
  10960. </thead>
  10961. <tbody>
  10962. <tr>
  10963. <td>
  10964. <code>maxRetries</code></br>
  10965. <em>
  10966. int32
  10967. </em>
  10968. </td>
  10969. <td>
  10970. </td>
  10971. </tr>
  10972. <tr>
  10973. <td>
  10974. <code>retryInterval</code></br>
  10975. <em>
  10976. string
  10977. </em>
  10978. </td>
  10979. <td>
  10980. </td>
  10981. </tr>
  10982. </tbody>
  10983. </table>
  10984. <h3 id="external-secrets.io/v1.SecretStoreSpec">SecretStoreSpec
  10985. </h3>
  10986. <p>
  10987. (<em>Appears on:</em>
  10988. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  10989. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  10990. </p>
  10991. <p>
  10992. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  10993. </p>
  10994. <table>
  10995. <thead>
  10996. <tr>
  10997. <th>Field</th>
  10998. <th>Description</th>
  10999. </tr>
  11000. </thead>
  11001. <tbody>
  11002. <tr>
  11003. <td>
  11004. <code>controller</code></br>
  11005. <em>
  11006. string
  11007. </em>
  11008. </td>
  11009. <td>
  11010. <em>(Optional)</em>
  11011. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  11012. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  11013. </td>
  11014. </tr>
  11015. <tr>
  11016. <td>
  11017. <code>provider</code></br>
  11018. <em>
  11019. <a href="#external-secrets.io/v1.SecretStoreProvider">
  11020. SecretStoreProvider
  11021. </a>
  11022. </em>
  11023. </td>
  11024. <td>
  11025. <p>Used to configure the provider. Only one provider may be set</p>
  11026. </td>
  11027. </tr>
  11028. <tr>
  11029. <td>
  11030. <code>retrySettings</code></br>
  11031. <em>
  11032. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  11033. SecretStoreRetrySettings
  11034. </a>
  11035. </em>
  11036. </td>
  11037. <td>
  11038. <em>(Optional)</em>
  11039. <p>Used to configure HTTP retries on failures.</p>
  11040. </td>
  11041. </tr>
  11042. <tr>
  11043. <td>
  11044. <code>refreshInterval</code></br>
  11045. <em>
  11046. int
  11047. </em>
  11048. </td>
  11049. <td>
  11050. <em>(Optional)</em>
  11051. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  11052. </td>
  11053. </tr>
  11054. <tr>
  11055. <td>
  11056. <code>conditions</code></br>
  11057. <em>
  11058. <a href="#external-secrets.io/v1.ClusterSecretStoreCondition">
  11059. []ClusterSecretStoreCondition
  11060. </a>
  11061. </em>
  11062. </td>
  11063. <td>
  11064. <em>(Optional)</em>
  11065. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  11066. </td>
  11067. </tr>
  11068. </tbody>
  11069. </table>
  11070. <h3 id="external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus
  11071. </h3>
  11072. <p>
  11073. (<em>Appears on:</em>
  11074. <a href="#external-secrets.io/v1.ClusterSecretStore">ClusterSecretStore</a>,
  11075. <a href="#external-secrets.io/v1.SecretStore">SecretStore</a>)
  11076. </p>
  11077. <p>
  11078. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  11079. </p>
  11080. <table>
  11081. <thead>
  11082. <tr>
  11083. <th>Field</th>
  11084. <th>Description</th>
  11085. </tr>
  11086. </thead>
  11087. <tbody>
  11088. <tr>
  11089. <td>
  11090. <code>conditions</code></br>
  11091. <em>
  11092. <a href="#external-secrets.io/v1.SecretStoreStatusCondition">
  11093. []SecretStoreStatusCondition
  11094. </a>
  11095. </em>
  11096. </td>
  11097. <td>
  11098. <em>(Optional)</em>
  11099. </td>
  11100. </tr>
  11101. <tr>
  11102. <td>
  11103. <code>capabilities</code></br>
  11104. <em>
  11105. <a href="#external-secrets.io/v1.SecretStoreCapabilities">
  11106. SecretStoreCapabilities
  11107. </a>
  11108. </em>
  11109. </td>
  11110. <td>
  11111. <em>(Optional)</em>
  11112. </td>
  11113. </tr>
  11114. </tbody>
  11115. </table>
  11116. <h3 id="external-secrets.io/v1.SecretStoreStatusCondition">SecretStoreStatusCondition
  11117. </h3>
  11118. <p>
  11119. (<em>Appears on:</em>
  11120. <a href="#external-secrets.io/v1.SecretStoreStatus">SecretStoreStatus</a>)
  11121. </p>
  11122. <p>
  11123. <p>SecretStoreStatusCondition contains condition information for a SecretStore.</p>
  11124. </p>
  11125. <table>
  11126. <thead>
  11127. <tr>
  11128. <th>Field</th>
  11129. <th>Description</th>
  11130. </tr>
  11131. </thead>
  11132. <tbody>
  11133. <tr>
  11134. <td>
  11135. <code>type</code></br>
  11136. <em>
  11137. <a href="#external-secrets.io/v1.SecretStoreConditionType">
  11138. SecretStoreConditionType
  11139. </a>
  11140. </em>
  11141. </td>
  11142. <td>
  11143. </td>
  11144. </tr>
  11145. <tr>
  11146. <td>
  11147. <code>status</code></br>
  11148. <em>
  11149. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  11150. Kubernetes core/v1.ConditionStatus
  11151. </a>
  11152. </em>
  11153. </td>
  11154. <td>
  11155. </td>
  11156. </tr>
  11157. <tr>
  11158. <td>
  11159. <code>reason</code></br>
  11160. <em>
  11161. string
  11162. </em>
  11163. </td>
  11164. <td>
  11165. <em>(Optional)</em>
  11166. </td>
  11167. </tr>
  11168. <tr>
  11169. <td>
  11170. <code>message</code></br>
  11171. <em>
  11172. string
  11173. </em>
  11174. </td>
  11175. <td>
  11176. <em>(Optional)</em>
  11177. </td>
  11178. </tr>
  11179. <tr>
  11180. <td>
  11181. <code>lastTransitionTime</code></br>
  11182. <em>
  11183. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  11184. Kubernetes meta/v1.Time
  11185. </a>
  11186. </em>
  11187. </td>
  11188. <td>
  11189. <em>(Optional)</em>
  11190. </td>
  11191. </tr>
  11192. </tbody>
  11193. </table>
  11194. <h3 id="external-secrets.io/v1.SecretVersionSelectionPolicy">SecretVersionSelectionPolicy
  11195. (<code>string</code> alias)</p></h3>
  11196. <p>
  11197. (<em>Appears on:</em>
  11198. <a href="#external-secrets.io/v1.GCPSMProvider">GCPSMProvider</a>)
  11199. </p>
  11200. <p>
  11201. <p>SecretVersionSelectionPolicy defines the policy for selecting secret versions in GCP Secret Manager.</p>
  11202. </p>
  11203. <table>
  11204. <thead>
  11205. <tr>
  11206. <th>Value</th>
  11207. <th>Description</th>
  11208. </tr>
  11209. </thead>
  11210. <tbody><tr><td><p>&#34;LatestOrFail&#34;</p></td>
  11211. <td><p>SecretVersionSelectionPolicyLatestOrFail means the provider always uses &ldquo;latest&rdquo;, or fails if that version is disabled/destroyed.</p>
  11212. </td>
  11213. </tr><tr><td><p>&#34;LatestOrFetch&#34;</p></td>
  11214. <td><p>SecretVersionSelectionPolicyLatestOrFetch behaves like SecretVersionSelectionPolicyLatestOrFail but falls back to fetching the latest version if the version is DESTROYED or DISABLED.</p>
  11215. </td>
  11216. </tr></tbody>
  11217. </table>
  11218. <h3 id="external-secrets.io/v1.SecretsClient">SecretsClient
  11219. </h3>
  11220. <p>
  11221. <p>SecretsClient provides access to secrets.</p>
  11222. </p>
  11223. <h3 id="external-secrets.io/v1.SecretsManager">SecretsManager
  11224. </h3>
  11225. <p>
  11226. (<em>Appears on:</em>
  11227. <a href="#external-secrets.io/v1.AWSProvider">AWSProvider</a>)
  11228. </p>
  11229. <p>
  11230. <p>SecretsManager defines how the provider behaves when interacting with AWS
  11231. SecretsManager. Some of these settings are only applicable to controlling how
  11232. secrets are deleted, and hence only apply to PushSecret (and only when
  11233. deletionPolicy is set to Delete).</p>
  11234. </p>
  11235. <table>
  11236. <thead>
  11237. <tr>
  11238. <th>Field</th>
  11239. <th>Description</th>
  11240. </tr>
  11241. </thead>
  11242. <tbody>
  11243. <tr>
  11244. <td>
  11245. <code>forceDeleteWithoutRecovery</code></br>
  11246. <em>
  11247. bool
  11248. </em>
  11249. </td>
  11250. <td>
  11251. <em>(Optional)</em>
  11252. <p>Specifies whether to delete the secret without any recovery window. You
  11253. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  11254. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  11255. recovery window.
  11256. 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>
  11257. </td>
  11258. </tr>
  11259. <tr>
  11260. <td>
  11261. <code>recoveryWindowInDays</code></br>
  11262. <em>
  11263. int64
  11264. </em>
  11265. </td>
  11266. <td>
  11267. <em>(Optional)</em>
  11268. <p>The number of days from 7 to 30 that Secrets Manager waits before
  11269. permanently deleting the secret. You can&rsquo;t use both this parameter and
  11270. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  11271. then by default Secrets Manager uses a 30-day recovery window.
  11272. 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>
  11273. </td>
  11274. </tr>
  11275. </tbody>
  11276. </table>
  11277. <h3 id="external-secrets.io/v1.SenhaseguraAuth">SenhaseguraAuth
  11278. </h3>
  11279. <p>
  11280. (<em>Appears on:</em>
  11281. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  11282. </p>
  11283. <p>
  11284. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  11285. </p>
  11286. <table>
  11287. <thead>
  11288. <tr>
  11289. <th>Field</th>
  11290. <th>Description</th>
  11291. </tr>
  11292. </thead>
  11293. <tbody>
  11294. <tr>
  11295. <td>
  11296. <code>clientId</code></br>
  11297. <em>
  11298. string
  11299. </em>
  11300. </td>
  11301. <td>
  11302. </td>
  11303. </tr>
  11304. <tr>
  11305. <td>
  11306. <code>clientSecretSecretRef</code></br>
  11307. <em>
  11308. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11309. External Secrets meta/v1.SecretKeySelector
  11310. </a>
  11311. </em>
  11312. </td>
  11313. <td>
  11314. </td>
  11315. </tr>
  11316. </tbody>
  11317. </table>
  11318. <h3 id="external-secrets.io/v1.SenhaseguraModuleType">SenhaseguraModuleType
  11319. (<code>string</code> alias)</p></h3>
  11320. <p>
  11321. (<em>Appears on:</em>
  11322. <a href="#external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider</a>)
  11323. </p>
  11324. <p>
  11325. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  11326. </p>
  11327. <table>
  11328. <thead>
  11329. <tr>
  11330. <th>Value</th>
  11331. <th>Description</th>
  11332. </tr>
  11333. </thead>
  11334. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  11335. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  11336. see: https://senhasegura.com/devops
  11337. </code></pre>
  11338. </td>
  11339. </tr></tbody>
  11340. </table>
  11341. <h3 id="external-secrets.io/v1.SenhaseguraProvider">SenhaseguraProvider
  11342. </h3>
  11343. <p>
  11344. (<em>Appears on:</em>
  11345. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  11346. </p>
  11347. <p>
  11348. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  11349. </p>
  11350. <table>
  11351. <thead>
  11352. <tr>
  11353. <th>Field</th>
  11354. <th>Description</th>
  11355. </tr>
  11356. </thead>
  11357. <tbody>
  11358. <tr>
  11359. <td>
  11360. <code>url</code></br>
  11361. <em>
  11362. string
  11363. </em>
  11364. </td>
  11365. <td>
  11366. <p>URL of senhasegura</p>
  11367. </td>
  11368. </tr>
  11369. <tr>
  11370. <td>
  11371. <code>module</code></br>
  11372. <em>
  11373. <a href="#external-secrets.io/v1.SenhaseguraModuleType">
  11374. SenhaseguraModuleType
  11375. </a>
  11376. </em>
  11377. </td>
  11378. <td>
  11379. <p>Module defines which senhasegura module should be used to get secrets</p>
  11380. </td>
  11381. </tr>
  11382. <tr>
  11383. <td>
  11384. <code>auth</code></br>
  11385. <em>
  11386. <a href="#external-secrets.io/v1.SenhaseguraAuth">
  11387. SenhaseguraAuth
  11388. </a>
  11389. </em>
  11390. </td>
  11391. <td>
  11392. <p>Auth defines parameters to authenticate in senhasegura</p>
  11393. </td>
  11394. </tr>
  11395. <tr>
  11396. <td>
  11397. <code>ignoreSslCertificate</code></br>
  11398. <em>
  11399. bool
  11400. </em>
  11401. </td>
  11402. <td>
  11403. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  11404. </td>
  11405. </tr>
  11406. </tbody>
  11407. </table>
  11408. <h3 id="external-secrets.io/v1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  11409. </h3>
  11410. <p>
  11411. (<em>Appears on:</em>
  11412. <a href="#external-secrets.io/v1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  11413. </p>
  11414. <p>
  11415. <p>StoreGeneratorSourceRef allows you to override the source
  11416. from which the secret will be pulled from.
  11417. You can define at maximum one property.</p>
  11418. </p>
  11419. <table>
  11420. <thead>
  11421. <tr>
  11422. <th>Field</th>
  11423. <th>Description</th>
  11424. </tr>
  11425. </thead>
  11426. <tbody>
  11427. <tr>
  11428. <td>
  11429. <code>storeRef</code></br>
  11430. <em>
  11431. <a href="#external-secrets.io/v1.SecretStoreRef">
  11432. SecretStoreRef
  11433. </a>
  11434. </em>
  11435. </td>
  11436. <td>
  11437. <em>(Optional)</em>
  11438. </td>
  11439. </tr>
  11440. <tr>
  11441. <td>
  11442. <code>generatorRef</code></br>
  11443. <em>
  11444. <a href="#external-secrets.io/v1.GeneratorRef">
  11445. GeneratorRef
  11446. </a>
  11447. </em>
  11448. </td>
  11449. <td>
  11450. <em>(Optional)</em>
  11451. <p>GeneratorRef points to a generator custom resource.</p>
  11452. </td>
  11453. </tr>
  11454. </tbody>
  11455. </table>
  11456. <h3 id="external-secrets.io/v1.StoreSourceRef">StoreSourceRef
  11457. </h3>
  11458. <p>
  11459. (<em>Appears on:</em>
  11460. <a href="#external-secrets.io/v1.ExternalSecretData">ExternalSecretData</a>)
  11461. </p>
  11462. <p>
  11463. <p>StoreSourceRef allows you to override the SecretStore source
  11464. from which the secret will be pulled from.
  11465. You can define at maximum one property.</p>
  11466. </p>
  11467. <table>
  11468. <thead>
  11469. <tr>
  11470. <th>Field</th>
  11471. <th>Description</th>
  11472. </tr>
  11473. </thead>
  11474. <tbody>
  11475. <tr>
  11476. <td>
  11477. <code>storeRef</code></br>
  11478. <em>
  11479. <a href="#external-secrets.io/v1.SecretStoreRef">
  11480. SecretStoreRef
  11481. </a>
  11482. </em>
  11483. </td>
  11484. <td>
  11485. <em>(Optional)</em>
  11486. </td>
  11487. </tr>
  11488. <tr>
  11489. <td>
  11490. <code>generatorRef</code></br>
  11491. <em>
  11492. <a href="#external-secrets.io/v1.GeneratorRef">
  11493. GeneratorRef
  11494. </a>
  11495. </em>
  11496. </td>
  11497. <td>
  11498. <p>GeneratorRef points to a generator custom resource.</p>
  11499. <p>Deprecated: The generatorRef is not implemented in .data[].
  11500. this will be removed with v1.</p>
  11501. </td>
  11502. </tr>
  11503. </tbody>
  11504. </table>
  11505. <h3 id="external-secrets.io/v1.Tag">Tag
  11506. </h3>
  11507. <p>
  11508. <p>Tag is a key-value pair that can be attached to an AWS resource.
  11509. 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>
  11510. </p>
  11511. <table>
  11512. <thead>
  11513. <tr>
  11514. <th>Field</th>
  11515. <th>Description</th>
  11516. </tr>
  11517. </thead>
  11518. <tbody>
  11519. <tr>
  11520. <td>
  11521. <code>key</code></br>
  11522. <em>
  11523. string
  11524. </em>
  11525. </td>
  11526. <td>
  11527. </td>
  11528. </tr>
  11529. <tr>
  11530. <td>
  11531. <code>value</code></br>
  11532. <em>
  11533. string
  11534. </em>
  11535. </td>
  11536. <td>
  11537. </td>
  11538. </tr>
  11539. </tbody>
  11540. </table>
  11541. <h3 id="external-secrets.io/v1.TemplateEngineVersion">TemplateEngineVersion
  11542. (<code>string</code> alias)</p></h3>
  11543. <p>
  11544. (<em>Appears on:</em>
  11545. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  11546. </p>
  11547. <p>
  11548. <p>TemplateEngineVersion specifies the template engine version that should be used to
  11549. compile/execute the template.</p>
  11550. </p>
  11551. <table>
  11552. <thead>
  11553. <tr>
  11554. <th>Value</th>
  11555. <th>Description</th>
  11556. </tr>
  11557. </thead>
  11558. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  11559. <td><p>TemplateEngineV2 is the currently supported template engine version.</p>
  11560. </td>
  11561. </tr></tbody>
  11562. </table>
  11563. <h3 id="external-secrets.io/v1.TemplateFrom">TemplateFrom
  11564. </h3>
  11565. <p>
  11566. (<em>Appears on:</em>
  11567. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  11568. </p>
  11569. <p>
  11570. <p>TemplateFrom specifies a source for templates.
  11571. Each item in the list can either reference a ConfigMap or a Secret resource.</p>
  11572. </p>
  11573. <table>
  11574. <thead>
  11575. <tr>
  11576. <th>Field</th>
  11577. <th>Description</th>
  11578. </tr>
  11579. </thead>
  11580. <tbody>
  11581. <tr>
  11582. <td>
  11583. <code>configMap</code></br>
  11584. <em>
  11585. <a href="#external-secrets.io/v1.TemplateRef">
  11586. TemplateRef
  11587. </a>
  11588. </em>
  11589. </td>
  11590. <td>
  11591. </td>
  11592. </tr>
  11593. <tr>
  11594. <td>
  11595. <code>secret</code></br>
  11596. <em>
  11597. <a href="#external-secrets.io/v1.TemplateRef">
  11598. TemplateRef
  11599. </a>
  11600. </em>
  11601. </td>
  11602. <td>
  11603. </td>
  11604. </tr>
  11605. <tr>
  11606. <td>
  11607. <code>target</code></br>
  11608. <em>
  11609. string
  11610. </em>
  11611. </td>
  11612. <td>
  11613. <em>(Optional)</em>
  11614. <p>Target specifies where to place the template result.
  11615. For Secret resources, common values are: &ldquo;Data&rdquo;, &ldquo;Annotations&rdquo;, &ldquo;Labels&rdquo;.
  11616. For custom resources (when spec.target.manifest is set), this supports
  11617. nested paths like &ldquo;spec.database.config&rdquo; or &ldquo;data&rdquo;.</p>
  11618. </td>
  11619. </tr>
  11620. <tr>
  11621. <td>
  11622. <code>literal</code></br>
  11623. <em>
  11624. string
  11625. </em>
  11626. </td>
  11627. <td>
  11628. <em>(Optional)</em>
  11629. </td>
  11630. </tr>
  11631. </tbody>
  11632. </table>
  11633. <h3 id="external-secrets.io/v1.TemplateMergePolicy">TemplateMergePolicy
  11634. (<code>string</code> alias)</p></h3>
  11635. <p>
  11636. (<em>Appears on:</em>
  11637. <a href="#external-secrets.io/v1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  11638. </p>
  11639. <p>
  11640. <p>TemplateMergePolicy defines how the rendered template should be merged with the existing Secret data.</p>
  11641. </p>
  11642. <table>
  11643. <thead>
  11644. <tr>
  11645. <th>Value</th>
  11646. <th>Description</th>
  11647. </tr>
  11648. </thead>
  11649. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  11650. <td></td>
  11651. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  11652. <td></td>
  11653. </tr></tbody>
  11654. </table>
  11655. <h3 id="external-secrets.io/v1.TemplateRef">TemplateRef
  11656. </h3>
  11657. <p>
  11658. (<em>Appears on:</em>
  11659. <a href="#external-secrets.io/v1.TemplateFrom">TemplateFrom</a>)
  11660. </p>
  11661. <p>
  11662. <p>TemplateRef specifies a reference to either a ConfigMap or a Secret resource.</p>
  11663. </p>
  11664. <table>
  11665. <thead>
  11666. <tr>
  11667. <th>Field</th>
  11668. <th>Description</th>
  11669. </tr>
  11670. </thead>
  11671. <tbody>
  11672. <tr>
  11673. <td>
  11674. <code>name</code></br>
  11675. <em>
  11676. string
  11677. </em>
  11678. </td>
  11679. <td>
  11680. <p>The name of the ConfigMap/Secret resource</p>
  11681. </td>
  11682. </tr>
  11683. <tr>
  11684. <td>
  11685. <code>items</code></br>
  11686. <em>
  11687. <a href="#external-secrets.io/v1.TemplateRefItem">
  11688. []TemplateRefItem
  11689. </a>
  11690. </em>
  11691. </td>
  11692. <td>
  11693. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  11694. </td>
  11695. </tr>
  11696. </tbody>
  11697. </table>
  11698. <h3 id="external-secrets.io/v1.TemplateRefItem">TemplateRefItem
  11699. </h3>
  11700. <p>
  11701. (<em>Appears on:</em>
  11702. <a href="#external-secrets.io/v1.TemplateRef">TemplateRef</a>)
  11703. </p>
  11704. <p>
  11705. <p>TemplateRefItem specifies a key in the ConfigMap/Secret to use as a template for Secret data.</p>
  11706. </p>
  11707. <table>
  11708. <thead>
  11709. <tr>
  11710. <th>Field</th>
  11711. <th>Description</th>
  11712. </tr>
  11713. </thead>
  11714. <tbody>
  11715. <tr>
  11716. <td>
  11717. <code>key</code></br>
  11718. <em>
  11719. string
  11720. </em>
  11721. </td>
  11722. <td>
  11723. <p>A key in the ConfigMap/Secret</p>
  11724. </td>
  11725. </tr>
  11726. <tr>
  11727. <td>
  11728. <code>templateAs</code></br>
  11729. <em>
  11730. <a href="#external-secrets.io/v1.TemplateScope">
  11731. TemplateScope
  11732. </a>
  11733. </em>
  11734. </td>
  11735. <td>
  11736. </td>
  11737. </tr>
  11738. </tbody>
  11739. </table>
  11740. <h3 id="external-secrets.io/v1.TemplateScope">TemplateScope
  11741. (<code>string</code> alias)</p></h3>
  11742. <p>
  11743. (<em>Appears on:</em>
  11744. <a href="#external-secrets.io/v1.TemplateRefItem">TemplateRefItem</a>)
  11745. </p>
  11746. <p>
  11747. <p>TemplateScope specifies how the template keys should be interpreted.</p>
  11748. </p>
  11749. <table>
  11750. <thead>
  11751. <tr>
  11752. <th>Value</th>
  11753. <th>Description</th>
  11754. </tr>
  11755. </thead>
  11756. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  11757. <td></td>
  11758. </tr><tr><td><p>&#34;Values&#34;</p></td>
  11759. <td></td>
  11760. </tr></tbody>
  11761. </table>
  11762. <h3 id="external-secrets.io/v1.TokenAuth">TokenAuth
  11763. </h3>
  11764. <p>
  11765. (<em>Appears on:</em>
  11766. <a href="#external-secrets.io/v1.KubernetesAuth">KubernetesAuth</a>)
  11767. </p>
  11768. <p>
  11769. <p>TokenAuth defines token-based authentication configuration for Kubernetes.</p>
  11770. </p>
  11771. <table>
  11772. <thead>
  11773. <tr>
  11774. <th>Field</th>
  11775. <th>Description</th>
  11776. </tr>
  11777. </thead>
  11778. <tbody>
  11779. <tr>
  11780. <td>
  11781. <code>bearerToken</code></br>
  11782. <em>
  11783. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11784. External Secrets meta/v1.SecretKeySelector
  11785. </a>
  11786. </em>
  11787. </td>
  11788. <td>
  11789. </td>
  11790. </tr>
  11791. </tbody>
  11792. </table>
  11793. <h3 id="external-secrets.io/v1.TokenAuthCredentials">TokenAuthCredentials
  11794. </h3>
  11795. <p>
  11796. (<em>Appears on:</em>
  11797. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  11798. </p>
  11799. <p>
  11800. <p>TokenAuthCredentials represents the credentials for access token-based authentication.</p>
  11801. </p>
  11802. <table>
  11803. <thead>
  11804. <tr>
  11805. <th>Field</th>
  11806. <th>Description</th>
  11807. </tr>
  11808. </thead>
  11809. <tbody>
  11810. <tr>
  11811. <td>
  11812. <code>accessToken</code></br>
  11813. <em>
  11814. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11815. External Secrets meta/v1.SecretKeySelector
  11816. </a>
  11817. </em>
  11818. </td>
  11819. <td>
  11820. </td>
  11821. </tr>
  11822. </tbody>
  11823. </table>
  11824. <h3 id="external-secrets.io/v1.UniversalAuthCredentials">UniversalAuthCredentials
  11825. </h3>
  11826. <p>
  11827. (<em>Appears on:</em>
  11828. <a href="#external-secrets.io/v1.InfisicalAuth">InfisicalAuth</a>)
  11829. </p>
  11830. <p>
  11831. <p>UniversalAuthCredentials represents the client credentials for universal authentication.</p>
  11832. </p>
  11833. <table>
  11834. <thead>
  11835. <tr>
  11836. <th>Field</th>
  11837. <th>Description</th>
  11838. </tr>
  11839. </thead>
  11840. <tbody>
  11841. <tr>
  11842. <td>
  11843. <code>clientId</code></br>
  11844. <em>
  11845. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11846. External Secrets meta/v1.SecretKeySelector
  11847. </a>
  11848. </em>
  11849. </td>
  11850. <td>
  11851. </td>
  11852. </tr>
  11853. <tr>
  11854. <td>
  11855. <code>clientSecret</code></br>
  11856. <em>
  11857. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11858. External Secrets meta/v1.SecretKeySelector
  11859. </a>
  11860. </em>
  11861. </td>
  11862. <td>
  11863. </td>
  11864. </tr>
  11865. </tbody>
  11866. </table>
  11867. <h3 id="external-secrets.io/v1.ValidationResult">ValidationResult
  11868. (<code>byte</code> alias)</p></h3>
  11869. <p>
  11870. (<em>Appears on:</em>
  11871. <a href="#external-secrets.io/v1.FakeProvider">FakeProvider</a>)
  11872. </p>
  11873. <p>
  11874. <p>ValidationResult is defined type for the number of validation results.</p>
  11875. </p>
  11876. <table>
  11877. <thead>
  11878. <tr>
  11879. <th>Value</th>
  11880. <th>Description</th>
  11881. </tr>
  11882. </thead>
  11883. <tbody><tr><td><p>2</p></td>
  11884. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  11885. </td>
  11886. </tr><tr><td><p>0</p></td>
  11887. <td><p>ValidationResultReady indicates that the client is configured correctly
  11888. and can be used.</p>
  11889. </td>
  11890. </tr><tr><td><p>1</p></td>
  11891. <td><p>ValidationResultUnknown indicates that the client can be used
  11892. but information is missing, and it can not be validated.</p>
  11893. </td>
  11894. </tr></tbody>
  11895. </table>
  11896. <h3 id="external-secrets.io/v1.VaultAppRole">VaultAppRole
  11897. </h3>
  11898. <p>
  11899. (<em>Appears on:</em>
  11900. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  11901. </p>
  11902. <p>
  11903. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  11904. with the role and secret stored in a Kubernetes Secret resource.</p>
  11905. </p>
  11906. <table>
  11907. <thead>
  11908. <tr>
  11909. <th>Field</th>
  11910. <th>Description</th>
  11911. </tr>
  11912. </thead>
  11913. <tbody>
  11914. <tr>
  11915. <td>
  11916. <code>path</code></br>
  11917. <em>
  11918. string
  11919. </em>
  11920. </td>
  11921. <td>
  11922. <p>Path where the App Role authentication backend is mounted
  11923. in Vault, e.g: &ldquo;approle&rdquo;</p>
  11924. </td>
  11925. </tr>
  11926. <tr>
  11927. <td>
  11928. <code>roleId</code></br>
  11929. <em>
  11930. string
  11931. </em>
  11932. </td>
  11933. <td>
  11934. <em>(Optional)</em>
  11935. <p>RoleID configured in the App Role authentication backend when setting
  11936. up the authentication backend in Vault.</p>
  11937. </td>
  11938. </tr>
  11939. <tr>
  11940. <td>
  11941. <code>roleRef</code></br>
  11942. <em>
  11943. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11944. External Secrets meta/v1.SecretKeySelector
  11945. </a>
  11946. </em>
  11947. </td>
  11948. <td>
  11949. <em>(Optional)</em>
  11950. <p>Reference to a key in a Secret that contains the App Role ID used
  11951. to authenticate with Vault.
  11952. The <code>key</code> field must be specified and denotes which entry within the Secret
  11953. resource is used as the app role id.</p>
  11954. </td>
  11955. </tr>
  11956. <tr>
  11957. <td>
  11958. <code>secretRef</code></br>
  11959. <em>
  11960. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  11961. External Secrets meta/v1.SecretKeySelector
  11962. </a>
  11963. </em>
  11964. </td>
  11965. <td>
  11966. <p>Reference to a key in a Secret that contains the App Role secret used
  11967. to authenticate with Vault.
  11968. The <code>key</code> field must be specified and denotes which entry within the Secret
  11969. resource is used as the app role secret.</p>
  11970. </td>
  11971. </tr>
  11972. </tbody>
  11973. </table>
  11974. <h3 id="external-secrets.io/v1.VaultAuth">VaultAuth
  11975. </h3>
  11976. <p>
  11977. (<em>Appears on:</em>
  11978. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  11979. </p>
  11980. <p>
  11981. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  11982. 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>
  11983. can be specified. A namespace to authenticate against can optionally be specified.</p>
  11984. </p>
  11985. <table>
  11986. <thead>
  11987. <tr>
  11988. <th>Field</th>
  11989. <th>Description</th>
  11990. </tr>
  11991. </thead>
  11992. <tbody>
  11993. <tr>
  11994. <td>
  11995. <code>namespace</code></br>
  11996. <em>
  11997. string
  11998. </em>
  11999. </td>
  12000. <td>
  12001. <em>(Optional)</em>
  12002. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  12003. Namespaces is a set of features within Vault Enterprise that allows
  12004. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  12005. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  12006. This will default to Vault.Namespace field if set, or empty otherwise</p>
  12007. </td>
  12008. </tr>
  12009. <tr>
  12010. <td>
  12011. <code>tokenSecretRef</code></br>
  12012. <em>
  12013. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12014. External Secrets meta/v1.SecretKeySelector
  12015. </a>
  12016. </em>
  12017. </td>
  12018. <td>
  12019. <em>(Optional)</em>
  12020. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  12021. </td>
  12022. </tr>
  12023. <tr>
  12024. <td>
  12025. <code>appRole</code></br>
  12026. <em>
  12027. <a href="#external-secrets.io/v1.VaultAppRole">
  12028. VaultAppRole
  12029. </a>
  12030. </em>
  12031. </td>
  12032. <td>
  12033. <em>(Optional)</em>
  12034. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  12035. with the role and secret stored in a Kubernetes Secret resource.</p>
  12036. </td>
  12037. </tr>
  12038. <tr>
  12039. <td>
  12040. <code>kubernetes</code></br>
  12041. <em>
  12042. <a href="#external-secrets.io/v1.VaultKubernetesAuth">
  12043. VaultKubernetesAuth
  12044. </a>
  12045. </em>
  12046. </td>
  12047. <td>
  12048. <em>(Optional)</em>
  12049. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  12050. token stored in the named Secret resource to the Vault server.</p>
  12051. </td>
  12052. </tr>
  12053. <tr>
  12054. <td>
  12055. <code>ldap</code></br>
  12056. <em>
  12057. <a href="#external-secrets.io/v1.VaultLdapAuth">
  12058. VaultLdapAuth
  12059. </a>
  12060. </em>
  12061. </td>
  12062. <td>
  12063. <em>(Optional)</em>
  12064. <p>Ldap authenticates with Vault by passing username/password pair using
  12065. the LDAP authentication method</p>
  12066. </td>
  12067. </tr>
  12068. <tr>
  12069. <td>
  12070. <code>jwt</code></br>
  12071. <em>
  12072. <a href="#external-secrets.io/v1.VaultJwtAuth">
  12073. VaultJwtAuth
  12074. </a>
  12075. </em>
  12076. </td>
  12077. <td>
  12078. <em>(Optional)</em>
  12079. <p>Jwt authenticates with Vault by passing role and JWT token using the
  12080. JWT/OIDC authentication method</p>
  12081. </td>
  12082. </tr>
  12083. <tr>
  12084. <td>
  12085. <code>cert</code></br>
  12086. <em>
  12087. <a href="#external-secrets.io/v1.VaultCertAuth">
  12088. VaultCertAuth
  12089. </a>
  12090. </em>
  12091. </td>
  12092. <td>
  12093. <em>(Optional)</em>
  12094. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  12095. Cert authentication method</p>
  12096. </td>
  12097. </tr>
  12098. <tr>
  12099. <td>
  12100. <code>iam</code></br>
  12101. <em>
  12102. <a href="#external-secrets.io/v1.VaultIamAuth">
  12103. VaultIamAuth
  12104. </a>
  12105. </em>
  12106. </td>
  12107. <td>
  12108. <em>(Optional)</em>
  12109. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  12110. AWS IAM authentication method</p>
  12111. </td>
  12112. </tr>
  12113. <tr>
  12114. <td>
  12115. <code>userPass</code></br>
  12116. <em>
  12117. <a href="#external-secrets.io/v1.VaultUserPassAuth">
  12118. VaultUserPassAuth
  12119. </a>
  12120. </em>
  12121. </td>
  12122. <td>
  12123. <em>(Optional)</em>
  12124. <p>UserPass authenticates with Vault by passing username/password pair</p>
  12125. </td>
  12126. </tr>
  12127. <tr>
  12128. <td>
  12129. <code>gcp</code></br>
  12130. <em>
  12131. <a href="#external-secrets.io/v1.VaultGCPAuth">
  12132. VaultGCPAuth
  12133. </a>
  12134. </em>
  12135. </td>
  12136. <td>
  12137. <em>(Optional)</em>
  12138. <p>Gcp authenticates with Vault using Google Cloud Platform authentication method
  12139. GCP authentication method</p>
  12140. </td>
  12141. </tr>
  12142. </tbody>
  12143. </table>
  12144. <h3 id="external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth
  12145. </h3>
  12146. <p>
  12147. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  12148. Only one of secretRef or jwt can be specified.
  12149. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  12150. </p>
  12151. <table>
  12152. <thead>
  12153. <tr>
  12154. <th>Field</th>
  12155. <th>Description</th>
  12156. </tr>
  12157. </thead>
  12158. <tbody>
  12159. <tr>
  12160. <td>
  12161. <code>secretRef</code></br>
  12162. <em>
  12163. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  12164. VaultAwsAuthSecretRef
  12165. </a>
  12166. </em>
  12167. </td>
  12168. <td>
  12169. <em>(Optional)</em>
  12170. </td>
  12171. </tr>
  12172. <tr>
  12173. <td>
  12174. <code>jwt</code></br>
  12175. <em>
  12176. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  12177. VaultAwsJWTAuth
  12178. </a>
  12179. </em>
  12180. </td>
  12181. <td>
  12182. <em>(Optional)</em>
  12183. </td>
  12184. </tr>
  12185. </tbody>
  12186. </table>
  12187. <h3 id="external-secrets.io/v1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  12188. </h3>
  12189. <p>
  12190. (<em>Appears on:</em>
  12191. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  12192. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  12193. </p>
  12194. <p>
  12195. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  12196. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  12197. </p>
  12198. <table>
  12199. <thead>
  12200. <tr>
  12201. <th>Field</th>
  12202. <th>Description</th>
  12203. </tr>
  12204. </thead>
  12205. <tbody>
  12206. <tr>
  12207. <td>
  12208. <code>accessKeyIDSecretRef</code></br>
  12209. <em>
  12210. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12211. External Secrets meta/v1.SecretKeySelector
  12212. </a>
  12213. </em>
  12214. </td>
  12215. <td>
  12216. <em>(Optional)</em>
  12217. <p>The AccessKeyID is used for authentication</p>
  12218. </td>
  12219. </tr>
  12220. <tr>
  12221. <td>
  12222. <code>secretAccessKeySecretRef</code></br>
  12223. <em>
  12224. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12225. External Secrets meta/v1.SecretKeySelector
  12226. </a>
  12227. </em>
  12228. </td>
  12229. <td>
  12230. <em>(Optional)</em>
  12231. <p>The SecretAccessKey is used for authentication</p>
  12232. </td>
  12233. </tr>
  12234. <tr>
  12235. <td>
  12236. <code>sessionTokenSecretRef</code></br>
  12237. <em>
  12238. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12239. External Secrets meta/v1.SecretKeySelector
  12240. </a>
  12241. </em>
  12242. </td>
  12243. <td>
  12244. <em>(Optional)</em>
  12245. <p>The SessionToken used for authentication
  12246. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  12247. 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>
  12248. </td>
  12249. </tr>
  12250. </tbody>
  12251. </table>
  12252. <h3 id="external-secrets.io/v1.VaultAwsJWTAuth">VaultAwsJWTAuth
  12253. </h3>
  12254. <p>
  12255. (<em>Appears on:</em>
  12256. <a href="#external-secrets.io/v1.VaultAwsAuth">VaultAwsAuth</a>,
  12257. <a href="#external-secrets.io/v1.VaultIamAuth">VaultIamAuth</a>)
  12258. </p>
  12259. <p>
  12260. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  12261. </p>
  12262. <table>
  12263. <thead>
  12264. <tr>
  12265. <th>Field</th>
  12266. <th>Description</th>
  12267. </tr>
  12268. </thead>
  12269. <tbody>
  12270. <tr>
  12271. <td>
  12272. <code>serviceAccountRef</code></br>
  12273. <em>
  12274. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  12275. External Secrets meta/v1.ServiceAccountSelector
  12276. </a>
  12277. </em>
  12278. </td>
  12279. <td>
  12280. <em>(Optional)</em>
  12281. </td>
  12282. </tr>
  12283. </tbody>
  12284. </table>
  12285. <h3 id="external-secrets.io/v1.VaultCertAuth">VaultCertAuth
  12286. </h3>
  12287. <p>
  12288. (<em>Appears on:</em>
  12289. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12290. </p>
  12291. <p>
  12292. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  12293. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  12294. </p>
  12295. <table>
  12296. <thead>
  12297. <tr>
  12298. <th>Field</th>
  12299. <th>Description</th>
  12300. </tr>
  12301. </thead>
  12302. <tbody>
  12303. <tr>
  12304. <td>
  12305. <code>path</code></br>
  12306. <em>
  12307. string
  12308. </em>
  12309. </td>
  12310. <td>
  12311. <em>(Optional)</em>
  12312. <p>Path where the Certificate authentication backend is mounted
  12313. in Vault, e.g: &ldquo;cert&rdquo;</p>
  12314. </td>
  12315. </tr>
  12316. <tr>
  12317. <td>
  12318. <code>clientCert</code></br>
  12319. <em>
  12320. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12321. External Secrets meta/v1.SecretKeySelector
  12322. </a>
  12323. </em>
  12324. </td>
  12325. <td>
  12326. <em>(Optional)</em>
  12327. <p>ClientCert is a certificate to authenticate using the Cert Vault
  12328. authentication method</p>
  12329. </td>
  12330. </tr>
  12331. <tr>
  12332. <td>
  12333. <code>secretRef</code></br>
  12334. <em>
  12335. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12336. External Secrets meta/v1.SecretKeySelector
  12337. </a>
  12338. </em>
  12339. </td>
  12340. <td>
  12341. <em>(Optional)</em>
  12342. <p>SecretRef to a key in a Secret resource containing client private key to
  12343. authenticate with Vault using the Cert authentication method</p>
  12344. </td>
  12345. </tr>
  12346. </tbody>
  12347. </table>
  12348. <h3 id="external-secrets.io/v1.VaultCheckAndSet">VaultCheckAndSet
  12349. </h3>
  12350. <p>
  12351. (<em>Appears on:</em>
  12352. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  12353. </p>
  12354. <p>
  12355. <p>VaultCheckAndSet defines the Check-And-Set (CAS) settings for Vault KV v2 PushSecret operations.</p>
  12356. </p>
  12357. <table>
  12358. <thead>
  12359. <tr>
  12360. <th>Field</th>
  12361. <th>Description</th>
  12362. </tr>
  12363. </thead>
  12364. <tbody>
  12365. <tr>
  12366. <td>
  12367. <code>required</code></br>
  12368. <em>
  12369. bool
  12370. </em>
  12371. </td>
  12372. <td>
  12373. <em>(Optional)</em>
  12374. <p>Required when true, all write operations must include a check-and-set parameter.
  12375. This helps prevent unintentional overwrites of secrets.</p>
  12376. </td>
  12377. </tr>
  12378. </tbody>
  12379. </table>
  12380. <h3 id="external-secrets.io/v1.VaultClientTLS">VaultClientTLS
  12381. </h3>
  12382. <p>
  12383. (<em>Appears on:</em>
  12384. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  12385. </p>
  12386. <p>
  12387. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  12388. when the Vault server requires mutual authentication.</p>
  12389. </p>
  12390. <table>
  12391. <thead>
  12392. <tr>
  12393. <th>Field</th>
  12394. <th>Description</th>
  12395. </tr>
  12396. </thead>
  12397. <tbody>
  12398. <tr>
  12399. <td>
  12400. <code>certSecretRef</code></br>
  12401. <em>
  12402. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12403. External Secrets meta/v1.SecretKeySelector
  12404. </a>
  12405. </em>
  12406. </td>
  12407. <td>
  12408. <em>(Optional)</em>
  12409. <p>CertSecretRef is a certificate added to the transport layer
  12410. when communicating with the Vault server.
  12411. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  12412. </td>
  12413. </tr>
  12414. <tr>
  12415. <td>
  12416. <code>keySecretRef</code></br>
  12417. <em>
  12418. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12419. External Secrets meta/v1.SecretKeySelector
  12420. </a>
  12421. </em>
  12422. </td>
  12423. <td>
  12424. <em>(Optional)</em>
  12425. <p>KeySecretRef to a key in a Secret resource containing client private key
  12426. added to the transport layer when communicating with the Vault server.
  12427. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  12428. </td>
  12429. </tr>
  12430. </tbody>
  12431. </table>
  12432. <h3 id="external-secrets.io/v1.VaultGCPAuth">VaultGCPAuth
  12433. </h3>
  12434. <p>
  12435. (<em>Appears on:</em>
  12436. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12437. </p>
  12438. <p>
  12439. <p>VaultGCPAuth authenticates with Vault using Google Cloud Platform authentication method.
  12440. Refer: <a href="https://developer.hashicorp.com/vault/docs/auth/gcp">https://developer.hashicorp.com/vault/docs/auth/gcp</a></p>
  12441. <p>When ServiceAccountRef, SecretRef and WorkloadIdentity are not specified, the provider will use the controller pod&rsquo;s
  12442. identity to authenticate with GCP. This supports both GKE Workload Identity and service account keys.</p>
  12443. </p>
  12444. <table>
  12445. <thead>
  12446. <tr>
  12447. <th>Field</th>
  12448. <th>Description</th>
  12449. </tr>
  12450. </thead>
  12451. <tbody>
  12452. <tr>
  12453. <td>
  12454. <code>path</code></br>
  12455. <em>
  12456. string
  12457. </em>
  12458. </td>
  12459. <td>
  12460. <em>(Optional)</em>
  12461. <p>Path where the GCP auth method is enabled in Vault, e.g: &ldquo;gcp&rdquo;</p>
  12462. </td>
  12463. </tr>
  12464. <tr>
  12465. <td>
  12466. <code>role</code></br>
  12467. <em>
  12468. string
  12469. </em>
  12470. </td>
  12471. <td>
  12472. <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>
  12473. </td>
  12474. </tr>
  12475. <tr>
  12476. <td>
  12477. <code>projectID</code></br>
  12478. <em>
  12479. string
  12480. </em>
  12481. </td>
  12482. <td>
  12483. <em>(Optional)</em>
  12484. <p>Project ID of the Google Cloud Platform project</p>
  12485. </td>
  12486. </tr>
  12487. <tr>
  12488. <td>
  12489. <code>location</code></br>
  12490. <em>
  12491. string
  12492. </em>
  12493. </td>
  12494. <td>
  12495. <em>(Optional)</em>
  12496. <p>Location optionally defines a location/region for the secret</p>
  12497. </td>
  12498. </tr>
  12499. <tr>
  12500. <td>
  12501. <code>secretRef</code></br>
  12502. <em>
  12503. <a href="#external-secrets.io/v1.GCPSMAuthSecretRef">
  12504. GCPSMAuthSecretRef
  12505. </a>
  12506. </em>
  12507. </td>
  12508. <td>
  12509. <em>(Optional)</em>
  12510. <p>Specify credentials in a Secret object</p>
  12511. </td>
  12512. </tr>
  12513. <tr>
  12514. <td>
  12515. <code>workloadIdentity</code></br>
  12516. <em>
  12517. <a href="#external-secrets.io/v1.GCPWorkloadIdentity">
  12518. GCPWorkloadIdentity
  12519. </a>
  12520. </em>
  12521. </td>
  12522. <td>
  12523. <em>(Optional)</em>
  12524. <p>Specify a service account with Workload Identity</p>
  12525. </td>
  12526. </tr>
  12527. <tr>
  12528. <td>
  12529. <code>serviceAccountRef</code></br>
  12530. <em>
  12531. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  12532. External Secrets meta/v1.ServiceAccountSelector
  12533. </a>
  12534. </em>
  12535. </td>
  12536. <td>
  12537. <em>(Optional)</em>
  12538. <p>ServiceAccountRef to a service account for impersonation</p>
  12539. </td>
  12540. </tr>
  12541. </tbody>
  12542. </table>
  12543. <h3 id="external-secrets.io/v1.VaultIamAuth">VaultIamAuth
  12544. </h3>
  12545. <p>
  12546. (<em>Appears on:</em>
  12547. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12548. </p>
  12549. <p>
  12550. <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>
  12551. <p>When JWTAuth and SecretRef are not specified, the provider will use the controller pod&rsquo;s
  12552. identity to authenticate with AWS. This supports both IRSA and EKS Pod Identity.</p>
  12553. </p>
  12554. <table>
  12555. <thead>
  12556. <tr>
  12557. <th>Field</th>
  12558. <th>Description</th>
  12559. </tr>
  12560. </thead>
  12561. <tbody>
  12562. <tr>
  12563. <td>
  12564. <code>path</code></br>
  12565. <em>
  12566. string
  12567. </em>
  12568. </td>
  12569. <td>
  12570. <em>(Optional)</em>
  12571. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  12572. </td>
  12573. </tr>
  12574. <tr>
  12575. <td>
  12576. <code>region</code></br>
  12577. <em>
  12578. string
  12579. </em>
  12580. </td>
  12581. <td>
  12582. <em>(Optional)</em>
  12583. <p>AWS region</p>
  12584. </td>
  12585. </tr>
  12586. <tr>
  12587. <td>
  12588. <code>role</code></br>
  12589. <em>
  12590. string
  12591. </em>
  12592. </td>
  12593. <td>
  12594. <em>(Optional)</em>
  12595. <p>This is the AWS role to be assumed before talking to vault</p>
  12596. </td>
  12597. </tr>
  12598. <tr>
  12599. <td>
  12600. <code>vaultRole</code></br>
  12601. <em>
  12602. string
  12603. </em>
  12604. </td>
  12605. <td>
  12606. <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>
  12607. </td>
  12608. </tr>
  12609. <tr>
  12610. <td>
  12611. <code>externalID</code></br>
  12612. <em>
  12613. string
  12614. </em>
  12615. </td>
  12616. <td>
  12617. <p>AWS External ID set on assumed IAM roles</p>
  12618. </td>
  12619. </tr>
  12620. <tr>
  12621. <td>
  12622. <code>vaultAwsIamServerID</code></br>
  12623. <em>
  12624. string
  12625. </em>
  12626. </td>
  12627. <td>
  12628. <em>(Optional)</em>
  12629. <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>
  12630. </td>
  12631. </tr>
  12632. <tr>
  12633. <td>
  12634. <code>secretRef</code></br>
  12635. <em>
  12636. <a href="#external-secrets.io/v1.VaultAwsAuthSecretRef">
  12637. VaultAwsAuthSecretRef
  12638. </a>
  12639. </em>
  12640. </td>
  12641. <td>
  12642. <em>(Optional)</em>
  12643. <p>Specify credentials in a Secret object</p>
  12644. </td>
  12645. </tr>
  12646. <tr>
  12647. <td>
  12648. <code>jwt</code></br>
  12649. <em>
  12650. <a href="#external-secrets.io/v1.VaultAwsJWTAuth">
  12651. VaultAwsJWTAuth
  12652. </a>
  12653. </em>
  12654. </td>
  12655. <td>
  12656. <em>(Optional)</em>
  12657. <p>Specify a service account with IRSA enabled</p>
  12658. </td>
  12659. </tr>
  12660. </tbody>
  12661. </table>
  12662. <h3 id="external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth
  12663. </h3>
  12664. <p>
  12665. (<em>Appears on:</em>
  12666. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12667. </p>
  12668. <p>
  12669. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  12670. method, with the role name and a token stored in a Kubernetes Secret resource or
  12671. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  12672. </p>
  12673. <table>
  12674. <thead>
  12675. <tr>
  12676. <th>Field</th>
  12677. <th>Description</th>
  12678. </tr>
  12679. </thead>
  12680. <tbody>
  12681. <tr>
  12682. <td>
  12683. <code>path</code></br>
  12684. <em>
  12685. string
  12686. </em>
  12687. </td>
  12688. <td>
  12689. <p>Path where the JWT authentication backend is mounted
  12690. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  12691. </td>
  12692. </tr>
  12693. <tr>
  12694. <td>
  12695. <code>role</code></br>
  12696. <em>
  12697. string
  12698. </em>
  12699. </td>
  12700. <td>
  12701. <em>(Optional)</em>
  12702. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  12703. authentication method</p>
  12704. </td>
  12705. </tr>
  12706. <tr>
  12707. <td>
  12708. <code>secretRef</code></br>
  12709. <em>
  12710. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12711. External Secrets meta/v1.SecretKeySelector
  12712. </a>
  12713. </em>
  12714. </td>
  12715. <td>
  12716. <em>(Optional)</em>
  12717. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  12718. authenticate with Vault using the JWT/OIDC authentication method.</p>
  12719. </td>
  12720. </tr>
  12721. <tr>
  12722. <td>
  12723. <code>kubernetesServiceAccountToken</code></br>
  12724. <em>
  12725. <a href="#external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">
  12726. VaultKubernetesServiceAccountTokenAuth
  12727. </a>
  12728. </em>
  12729. </td>
  12730. <td>
  12731. <em>(Optional)</em>
  12732. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  12733. a token for with the <code>TokenRequest</code> API.</p>
  12734. </td>
  12735. </tr>
  12736. </tbody>
  12737. </table>
  12738. <h3 id="external-secrets.io/v1.VaultKVStoreVersion">VaultKVStoreVersion
  12739. (<code>string</code> alias)</p></h3>
  12740. <p>
  12741. (<em>Appears on:</em>
  12742. <a href="#external-secrets.io/v1.VaultProvider">VaultProvider</a>)
  12743. </p>
  12744. <p>
  12745. <p>VaultKVStoreVersion represents the version of the Vault KV secret engine.</p>
  12746. </p>
  12747. <table>
  12748. <thead>
  12749. <tr>
  12750. <th>Value</th>
  12751. <th>Description</th>
  12752. </tr>
  12753. </thead>
  12754. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  12755. <td></td>
  12756. </tr><tr><td><p>&#34;v2&#34;</p></td>
  12757. <td></td>
  12758. </tr></tbody>
  12759. </table>
  12760. <h3 id="external-secrets.io/v1.VaultKubernetesAuth">VaultKubernetesAuth
  12761. </h3>
  12762. <p>
  12763. (<em>Appears on:</em>
  12764. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12765. </p>
  12766. <p>
  12767. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in
  12768. a Secret.</p>
  12769. </p>
  12770. <table>
  12771. <thead>
  12772. <tr>
  12773. <th>Field</th>
  12774. <th>Description</th>
  12775. </tr>
  12776. </thead>
  12777. <tbody>
  12778. <tr>
  12779. <td>
  12780. <code>mountPath</code></br>
  12781. <em>
  12782. string
  12783. </em>
  12784. </td>
  12785. <td>
  12786. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  12787. &ldquo;kubernetes&rdquo;</p>
  12788. </td>
  12789. </tr>
  12790. <tr>
  12791. <td>
  12792. <code>serviceAccountRef</code></br>
  12793. <em>
  12794. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  12795. External Secrets meta/v1.ServiceAccountSelector
  12796. </a>
  12797. </em>
  12798. </td>
  12799. <td>
  12800. <em>(Optional)</em>
  12801. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  12802. If the service account is specified, the service account secret token JWT will be used
  12803. for authenticating with Vault. If the service account selector is not supplied,
  12804. the secretRef will be used instead.</p>
  12805. </td>
  12806. </tr>
  12807. <tr>
  12808. <td>
  12809. <code>secretRef</code></br>
  12810. <em>
  12811. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12812. External Secrets meta/v1.SecretKeySelector
  12813. </a>
  12814. </em>
  12815. </td>
  12816. <td>
  12817. <em>(Optional)</em>
  12818. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  12819. for authenticating with Vault. If a name is specified without a key,
  12820. <code>token</code> is the default. If one is not specified, the one bound to
  12821. the controller will be used.</p>
  12822. </td>
  12823. </tr>
  12824. <tr>
  12825. <td>
  12826. <code>role</code></br>
  12827. <em>
  12828. string
  12829. </em>
  12830. </td>
  12831. <td>
  12832. <p>A required field containing the Vault Role to assume. A Role binds a
  12833. Kubernetes ServiceAccount with a set of Vault policies.</p>
  12834. </td>
  12835. </tr>
  12836. </tbody>
  12837. </table>
  12838. <h3 id="external-secrets.io/v1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  12839. </h3>
  12840. <p>
  12841. (<em>Appears on:</em>
  12842. <a href="#external-secrets.io/v1.VaultJwtAuth">VaultJwtAuth</a>)
  12843. </p>
  12844. <p>
  12845. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  12846. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  12847. </p>
  12848. <table>
  12849. <thead>
  12850. <tr>
  12851. <th>Field</th>
  12852. <th>Description</th>
  12853. </tr>
  12854. </thead>
  12855. <tbody>
  12856. <tr>
  12857. <td>
  12858. <code>serviceAccountRef</code></br>
  12859. <em>
  12860. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  12861. External Secrets meta/v1.ServiceAccountSelector
  12862. </a>
  12863. </em>
  12864. </td>
  12865. <td>
  12866. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  12867. </td>
  12868. </tr>
  12869. <tr>
  12870. <td>
  12871. <code>audiences</code></br>
  12872. <em>
  12873. []string
  12874. </em>
  12875. </td>
  12876. <td>
  12877. <em>(Optional)</em>
  12878. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  12879. account token for the service account referenced by <code>serviceAccountRef</code>.
  12880. Defaults to a single audience <code>vault</code> it not specified.</p>
  12881. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  12882. </td>
  12883. </tr>
  12884. <tr>
  12885. <td>
  12886. <code>expirationSeconds</code></br>
  12887. <em>
  12888. int64
  12889. </em>
  12890. </td>
  12891. <td>
  12892. <em>(Optional)</em>
  12893. <p>Optional expiration time in seconds that will be used to request a temporary
  12894. Kubernetes service account token for the service account referenced by
  12895. <code>serviceAccountRef</code>.</p>
  12896. <p>Deprecated: this will be removed in the future.
  12897. Defaults to 10 minutes.</p>
  12898. </td>
  12899. </tr>
  12900. </tbody>
  12901. </table>
  12902. <h3 id="external-secrets.io/v1.VaultLdapAuth">VaultLdapAuth
  12903. </h3>
  12904. <p>
  12905. (<em>Appears on:</em>
  12906. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  12907. </p>
  12908. <p>
  12909. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  12910. with the username and password stored in a Kubernetes Secret resource.</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>path</code></br>
  12923. <em>
  12924. string
  12925. </em>
  12926. </td>
  12927. <td>
  12928. <p>Path where the LDAP authentication backend is mounted
  12929. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  12930. </td>
  12931. </tr>
  12932. <tr>
  12933. <td>
  12934. <code>username</code></br>
  12935. <em>
  12936. string
  12937. </em>
  12938. </td>
  12939. <td>
  12940. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  12941. authentication method</p>
  12942. </td>
  12943. </tr>
  12944. <tr>
  12945. <td>
  12946. <code>secretRef</code></br>
  12947. <em>
  12948. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  12949. External Secrets meta/v1.SecretKeySelector
  12950. </a>
  12951. </em>
  12952. </td>
  12953. <td>
  12954. <em>(Optional)</em>
  12955. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  12956. user used to authenticate with Vault using the LDAP authentication
  12957. method</p>
  12958. </td>
  12959. </tr>
  12960. </tbody>
  12961. </table>
  12962. <h3 id="external-secrets.io/v1.VaultProvider">VaultProvider
  12963. </h3>
  12964. <p>
  12965. (<em>Appears on:</em>
  12966. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>,
  12967. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  12968. </p>
  12969. <p>
  12970. <p>VaultProvider configures a store to sync secrets using a Hashicorp Vault KV backend.</p>
  12971. </p>
  12972. <table>
  12973. <thead>
  12974. <tr>
  12975. <th>Field</th>
  12976. <th>Description</th>
  12977. </tr>
  12978. </thead>
  12979. <tbody>
  12980. <tr>
  12981. <td>
  12982. <code>auth</code></br>
  12983. <em>
  12984. <a href="#external-secrets.io/v1.VaultAuth">
  12985. VaultAuth
  12986. </a>
  12987. </em>
  12988. </td>
  12989. <td>
  12990. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  12991. </td>
  12992. </tr>
  12993. <tr>
  12994. <td>
  12995. <code>server</code></br>
  12996. <em>
  12997. string
  12998. </em>
  12999. </td>
  13000. <td>
  13001. <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>
  13002. </td>
  13003. </tr>
  13004. <tr>
  13005. <td>
  13006. <code>path</code></br>
  13007. <em>
  13008. string
  13009. </em>
  13010. </td>
  13011. <td>
  13012. <em>(Optional)</em>
  13013. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  13014. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  13015. for fetching secrets from Vault is optional and will be appended
  13016. if not present in specified path.</p>
  13017. </td>
  13018. </tr>
  13019. <tr>
  13020. <td>
  13021. <code>version</code></br>
  13022. <em>
  13023. <a href="#external-secrets.io/v1.VaultKVStoreVersion">
  13024. VaultKVStoreVersion
  13025. </a>
  13026. </em>
  13027. </td>
  13028. <td>
  13029. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  13030. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  13031. </td>
  13032. </tr>
  13033. <tr>
  13034. <td>
  13035. <code>namespace</code></br>
  13036. <em>
  13037. string
  13038. </em>
  13039. </td>
  13040. <td>
  13041. <em>(Optional)</em>
  13042. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  13043. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  13044. 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>
  13045. </td>
  13046. </tr>
  13047. <tr>
  13048. <td>
  13049. <code>caBundle</code></br>
  13050. <em>
  13051. []byte
  13052. </em>
  13053. </td>
  13054. <td>
  13055. <em>(Optional)</em>
  13056. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  13057. if the Server URL is using HTTPS protocol. This parameter is ignored for
  13058. plain HTTP protocol connection. If not set the system root certificates
  13059. are used to validate the TLS connection.</p>
  13060. </td>
  13061. </tr>
  13062. <tr>
  13063. <td>
  13064. <code>tls</code></br>
  13065. <em>
  13066. <a href="#external-secrets.io/v1.VaultClientTLS">
  13067. VaultClientTLS
  13068. </a>
  13069. </em>
  13070. </td>
  13071. <td>
  13072. <em>(Optional)</em>
  13073. <p>The configuration used for client side related TLS communication, when the Vault server
  13074. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  13075. This parameter is ignored for plain HTTP protocol connection.
  13076. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  13077. which is available under the <code>auth.cert</code> section.</p>
  13078. </td>
  13079. </tr>
  13080. <tr>
  13081. <td>
  13082. <code>caProvider</code></br>
  13083. <em>
  13084. <a href="#external-secrets.io/v1.CAProvider">
  13085. CAProvider
  13086. </a>
  13087. </em>
  13088. </td>
  13089. <td>
  13090. <em>(Optional)</em>
  13091. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  13092. </td>
  13093. </tr>
  13094. <tr>
  13095. <td>
  13096. <code>readYourWrites</code></br>
  13097. <em>
  13098. bool
  13099. </em>
  13100. </td>
  13101. <td>
  13102. <em>(Optional)</em>
  13103. <p>ReadYourWrites ensures isolated read-after-write semantics by
  13104. providing discovered cluster replication states in each request.
  13105. More information about eventual consistency in Vault can be found here
  13106. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  13107. </td>
  13108. </tr>
  13109. <tr>
  13110. <td>
  13111. <code>forwardInconsistent</code></br>
  13112. <em>
  13113. bool
  13114. </em>
  13115. </td>
  13116. <td>
  13117. <em>(Optional)</em>
  13118. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  13119. leader instead of simply retrying within a loop. This can increase performance if
  13120. the option is enabled serverside.
  13121. <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>
  13122. </td>
  13123. </tr>
  13124. <tr>
  13125. <td>
  13126. <code>headers</code></br>
  13127. <em>
  13128. map[string]string
  13129. </em>
  13130. </td>
  13131. <td>
  13132. <em>(Optional)</em>
  13133. <p>Headers to be added in Vault request</p>
  13134. </td>
  13135. </tr>
  13136. <tr>
  13137. <td>
  13138. <code>checkAndSet</code></br>
  13139. <em>
  13140. <a href="#external-secrets.io/v1.VaultCheckAndSet">
  13141. VaultCheckAndSet
  13142. </a>
  13143. </em>
  13144. </td>
  13145. <td>
  13146. <em>(Optional)</em>
  13147. <p>CheckAndSet defines the Check-And-Set (CAS) settings for PushSecret operations.
  13148. Only applies to Vault KV v2 stores. When enabled, write operations must include
  13149. the current version of the secret to prevent unintentional overwrites.</p>
  13150. </td>
  13151. </tr>
  13152. </tbody>
  13153. </table>
  13154. <h3 id="external-secrets.io/v1.VaultUserPassAuth">VaultUserPassAuth
  13155. </h3>
  13156. <p>
  13157. (<em>Appears on:</em>
  13158. <a href="#external-secrets.io/v1.VaultAuth">VaultAuth</a>)
  13159. </p>
  13160. <p>
  13161. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  13162. with the username and password stored in a Kubernetes Secret resource.</p>
  13163. </p>
  13164. <table>
  13165. <thead>
  13166. <tr>
  13167. <th>Field</th>
  13168. <th>Description</th>
  13169. </tr>
  13170. </thead>
  13171. <tbody>
  13172. <tr>
  13173. <td>
  13174. <code>path</code></br>
  13175. <em>
  13176. string
  13177. </em>
  13178. </td>
  13179. <td>
  13180. <p>Path where the UserPassword authentication backend is mounted
  13181. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  13182. </td>
  13183. </tr>
  13184. <tr>
  13185. <td>
  13186. <code>username</code></br>
  13187. <em>
  13188. string
  13189. </em>
  13190. </td>
  13191. <td>
  13192. <p>Username is a username used to authenticate using the UserPass Vault
  13193. authentication method</p>
  13194. </td>
  13195. </tr>
  13196. <tr>
  13197. <td>
  13198. <code>secretRef</code></br>
  13199. <em>
  13200. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13201. External Secrets meta/v1.SecretKeySelector
  13202. </a>
  13203. </em>
  13204. </td>
  13205. <td>
  13206. <em>(Optional)</em>
  13207. <p>SecretRef to a key in a Secret resource containing password for the
  13208. user used to authenticate with Vault using the UserPass authentication
  13209. method</p>
  13210. </td>
  13211. </tr>
  13212. </tbody>
  13213. </table>
  13214. <h3 id="external-secrets.io/v1.VolcengineAuth">VolcengineAuth
  13215. </h3>
  13216. <p>
  13217. (<em>Appears on:</em>
  13218. <a href="#external-secrets.io/v1.VolcengineProvider">VolcengineProvider</a>)
  13219. </p>
  13220. <p>
  13221. <p>VolcengineAuth defines the authentication method for the Volcengine provider.
  13222. Only one of the fields should be set.</p>
  13223. </p>
  13224. <table>
  13225. <thead>
  13226. <tr>
  13227. <th>Field</th>
  13228. <th>Description</th>
  13229. </tr>
  13230. </thead>
  13231. <tbody>
  13232. <tr>
  13233. <td>
  13234. <code>secretRef</code></br>
  13235. <em>
  13236. <a href="#external-secrets.io/v1.VolcengineAuthSecretRef">
  13237. VolcengineAuthSecretRef
  13238. </a>
  13239. </em>
  13240. </td>
  13241. <td>
  13242. <em>(Optional)</em>
  13243. <p>SecretRef defines the static credentials to use for authentication.
  13244. If not set, IRSA is used.</p>
  13245. </td>
  13246. </tr>
  13247. </tbody>
  13248. </table>
  13249. <h3 id="external-secrets.io/v1.VolcengineAuthSecretRef">VolcengineAuthSecretRef
  13250. </h3>
  13251. <p>
  13252. (<em>Appears on:</em>
  13253. <a href="#external-secrets.io/v1.VolcengineAuth">VolcengineAuth</a>)
  13254. </p>
  13255. <p>
  13256. <p>VolcengineAuthSecretRef defines the secret reference for static credentials.</p>
  13257. </p>
  13258. <table>
  13259. <thead>
  13260. <tr>
  13261. <th>Field</th>
  13262. <th>Description</th>
  13263. </tr>
  13264. </thead>
  13265. <tbody>
  13266. <tr>
  13267. <td>
  13268. <code>accessKeyID</code></br>
  13269. <em>
  13270. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13271. External Secrets meta/v1.SecretKeySelector
  13272. </a>
  13273. </em>
  13274. </td>
  13275. <td>
  13276. <p>AccessKeyID is the reference to the secret containing the Access Key ID.</p>
  13277. </td>
  13278. </tr>
  13279. <tr>
  13280. <td>
  13281. <code>secretAccessKey</code></br>
  13282. <em>
  13283. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13284. External Secrets meta/v1.SecretKeySelector
  13285. </a>
  13286. </em>
  13287. </td>
  13288. <td>
  13289. <p>SecretAccessKey is the reference to the secret containing the Secret Access Key.</p>
  13290. </td>
  13291. </tr>
  13292. <tr>
  13293. <td>
  13294. <code>token</code></br>
  13295. <em>
  13296. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13297. External Secrets meta/v1.SecretKeySelector
  13298. </a>
  13299. </em>
  13300. </td>
  13301. <td>
  13302. <em>(Optional)</em>
  13303. <p>Token is the reference to the secret containing the STS(Security Token Service) Token.</p>
  13304. </td>
  13305. </tr>
  13306. </tbody>
  13307. </table>
  13308. <h3 id="external-secrets.io/v1.VolcengineProvider">VolcengineProvider
  13309. </h3>
  13310. <p>
  13311. (<em>Appears on:</em>
  13312. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  13313. </p>
  13314. <p>
  13315. <p>VolcengineProvider defines the configuration for the Volcengine provider.</p>
  13316. </p>
  13317. <table>
  13318. <thead>
  13319. <tr>
  13320. <th>Field</th>
  13321. <th>Description</th>
  13322. </tr>
  13323. </thead>
  13324. <tbody>
  13325. <tr>
  13326. <td>
  13327. <code>region</code></br>
  13328. <em>
  13329. string
  13330. </em>
  13331. </td>
  13332. <td>
  13333. <p>Region specifies the Volcengine region to connect to.</p>
  13334. </td>
  13335. </tr>
  13336. <tr>
  13337. <td>
  13338. <code>auth</code></br>
  13339. <em>
  13340. <a href="#external-secrets.io/v1.VolcengineAuth">
  13341. VolcengineAuth
  13342. </a>
  13343. </em>
  13344. </td>
  13345. <td>
  13346. <em>(Optional)</em>
  13347. <p>Auth defines the authentication method to use.
  13348. If not specified, the provider will try to use IRSA (IAM Role for Service Account).</p>
  13349. </td>
  13350. </tr>
  13351. </tbody>
  13352. </table>
  13353. <h3 id="external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider
  13354. </h3>
  13355. <p>
  13356. (<em>Appears on:</em>
  13357. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  13358. </p>
  13359. <p>
  13360. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  13361. </p>
  13362. <table>
  13363. <thead>
  13364. <tr>
  13365. <th>Field</th>
  13366. <th>Description</th>
  13367. </tr>
  13368. </thead>
  13369. <tbody>
  13370. <tr>
  13371. <td>
  13372. <code>type</code></br>
  13373. <em>
  13374. <a href="#external-secrets.io/v1.WebhookCAProviderType">
  13375. WebhookCAProviderType
  13376. </a>
  13377. </em>
  13378. </td>
  13379. <td>
  13380. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  13381. </td>
  13382. </tr>
  13383. <tr>
  13384. <td>
  13385. <code>name</code></br>
  13386. <em>
  13387. string
  13388. </em>
  13389. </td>
  13390. <td>
  13391. <p>The name of the object located at the provider type.</p>
  13392. </td>
  13393. </tr>
  13394. <tr>
  13395. <td>
  13396. <code>key</code></br>
  13397. <em>
  13398. string
  13399. </em>
  13400. </td>
  13401. <td>
  13402. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  13403. </td>
  13404. </tr>
  13405. <tr>
  13406. <td>
  13407. <code>namespace</code></br>
  13408. <em>
  13409. string
  13410. </em>
  13411. </td>
  13412. <td>
  13413. <em>(Optional)</em>
  13414. <p>The namespace the Provider type is in.</p>
  13415. </td>
  13416. </tr>
  13417. </tbody>
  13418. </table>
  13419. <h3 id="external-secrets.io/v1.WebhookCAProviderType">WebhookCAProviderType
  13420. (<code>string</code> alias)</p></h3>
  13421. <p>
  13422. (<em>Appears on:</em>
  13423. <a href="#external-secrets.io/v1.WebhookCAProvider">WebhookCAProvider</a>)
  13424. </p>
  13425. <p>
  13426. <p>WebhookCAProviderType defines the type of provider for certificate authority in webhook connections.</p>
  13427. </p>
  13428. <table>
  13429. <thead>
  13430. <tr>
  13431. <th>Value</th>
  13432. <th>Description</th>
  13433. </tr>
  13434. </thead>
  13435. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  13436. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap resource.</p>
  13437. </td>
  13438. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  13439. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret resource.</p>
  13440. </td>
  13441. </tr></tbody>
  13442. </table>
  13443. <h3 id="external-secrets.io/v1.WebhookProvider">WebhookProvider
  13444. </h3>
  13445. <p>
  13446. (<em>Appears on:</em>
  13447. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  13448. </p>
  13449. <p>
  13450. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  13451. </p>
  13452. <table>
  13453. <thead>
  13454. <tr>
  13455. <th>Field</th>
  13456. <th>Description</th>
  13457. </tr>
  13458. </thead>
  13459. <tbody>
  13460. <tr>
  13461. <td>
  13462. <code>method</code></br>
  13463. <em>
  13464. string
  13465. </em>
  13466. </td>
  13467. <td>
  13468. <p>Webhook Method</p>
  13469. </td>
  13470. </tr>
  13471. <tr>
  13472. <td>
  13473. <code>url</code></br>
  13474. <em>
  13475. string
  13476. </em>
  13477. </td>
  13478. <td>
  13479. <p>Webhook url to call</p>
  13480. </td>
  13481. </tr>
  13482. <tr>
  13483. <td>
  13484. <code>headers</code></br>
  13485. <em>
  13486. map[string]string
  13487. </em>
  13488. </td>
  13489. <td>
  13490. <em>(Optional)</em>
  13491. <p>Headers</p>
  13492. </td>
  13493. </tr>
  13494. <tr>
  13495. <td>
  13496. <code>auth</code></br>
  13497. <em>
  13498. <a href="#external-secrets.io/v1.AuthorizationProtocol">
  13499. AuthorizationProtocol
  13500. </a>
  13501. </em>
  13502. </td>
  13503. <td>
  13504. <em>(Optional)</em>
  13505. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  13506. </td>
  13507. </tr>
  13508. <tr>
  13509. <td>
  13510. <code>body</code></br>
  13511. <em>
  13512. string
  13513. </em>
  13514. </td>
  13515. <td>
  13516. <em>(Optional)</em>
  13517. <p>Body</p>
  13518. </td>
  13519. </tr>
  13520. <tr>
  13521. <td>
  13522. <code>timeout</code></br>
  13523. <em>
  13524. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  13525. Kubernetes meta/v1.Duration
  13526. </a>
  13527. </em>
  13528. </td>
  13529. <td>
  13530. <em>(Optional)</em>
  13531. <p>Timeout</p>
  13532. </td>
  13533. </tr>
  13534. <tr>
  13535. <td>
  13536. <code>result</code></br>
  13537. <em>
  13538. <a href="#external-secrets.io/v1.WebhookResult">
  13539. WebhookResult
  13540. </a>
  13541. </em>
  13542. </td>
  13543. <td>
  13544. <em>(Optional)</em>
  13545. <p>Result formatting</p>
  13546. </td>
  13547. </tr>
  13548. <tr>
  13549. <td>
  13550. <code>secrets</code></br>
  13551. <em>
  13552. <a href="#external-secrets.io/v1.WebhookSecret">
  13553. []WebhookSecret
  13554. </a>
  13555. </em>
  13556. </td>
  13557. <td>
  13558. <em>(Optional)</em>
  13559. <p>Secrets to fill in templates
  13560. These secrets will be passed to the templating function as key value pairs under the given name</p>
  13561. </td>
  13562. </tr>
  13563. <tr>
  13564. <td>
  13565. <code>caBundle</code></br>
  13566. <em>
  13567. []byte
  13568. </em>
  13569. </td>
  13570. <td>
  13571. <em>(Optional)</em>
  13572. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  13573. if the Server URL is using HTTPS protocol. This parameter is ignored for
  13574. plain HTTP protocol connection. If not set the system root certificates
  13575. are used to validate the TLS connection.</p>
  13576. </td>
  13577. </tr>
  13578. <tr>
  13579. <td>
  13580. <code>caProvider</code></br>
  13581. <em>
  13582. <a href="#external-secrets.io/v1.WebhookCAProvider">
  13583. WebhookCAProvider
  13584. </a>
  13585. </em>
  13586. </td>
  13587. <td>
  13588. <em>(Optional)</em>
  13589. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  13590. </td>
  13591. </tr>
  13592. </tbody>
  13593. </table>
  13594. <h3 id="external-secrets.io/v1.WebhookResult">WebhookResult
  13595. </h3>
  13596. <p>
  13597. (<em>Appears on:</em>
  13598. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  13599. </p>
  13600. <p>
  13601. <p>WebhookResult defines how to process and extract secrets from the webhook response.</p>
  13602. </p>
  13603. <table>
  13604. <thead>
  13605. <tr>
  13606. <th>Field</th>
  13607. <th>Description</th>
  13608. </tr>
  13609. </thead>
  13610. <tbody>
  13611. <tr>
  13612. <td>
  13613. <code>jsonPath</code></br>
  13614. <em>
  13615. string
  13616. </em>
  13617. </td>
  13618. <td>
  13619. <em>(Optional)</em>
  13620. <p>Json path of return value</p>
  13621. </td>
  13622. </tr>
  13623. </tbody>
  13624. </table>
  13625. <h3 id="external-secrets.io/v1.WebhookSecret">WebhookSecret
  13626. </h3>
  13627. <p>
  13628. (<em>Appears on:</em>
  13629. <a href="#external-secrets.io/v1.WebhookProvider">WebhookProvider</a>)
  13630. </p>
  13631. <p>
  13632. <p>WebhookSecret defines a secret that will be passed to the webhook request.</p>
  13633. </p>
  13634. <table>
  13635. <thead>
  13636. <tr>
  13637. <th>Field</th>
  13638. <th>Description</th>
  13639. </tr>
  13640. </thead>
  13641. <tbody>
  13642. <tr>
  13643. <td>
  13644. <code>name</code></br>
  13645. <em>
  13646. string
  13647. </em>
  13648. </td>
  13649. <td>
  13650. <p>Name of this secret in templates</p>
  13651. </td>
  13652. </tr>
  13653. <tr>
  13654. <td>
  13655. <code>secretRef</code></br>
  13656. <em>
  13657. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13658. External Secrets meta/v1.SecretKeySelector
  13659. </a>
  13660. </em>
  13661. </td>
  13662. <td>
  13663. <p>Secret ref to fill in credentials</p>
  13664. </td>
  13665. </tr>
  13666. </tbody>
  13667. </table>
  13668. <h3 id="external-secrets.io/v1.YandexAuth">YandexAuth
  13669. </h3>
  13670. <p>
  13671. (<em>Appears on:</em>
  13672. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  13673. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  13674. </p>
  13675. <p>
  13676. <p>YandexAuth defines the authentication method for the Yandex provider.</p>
  13677. </p>
  13678. <table>
  13679. <thead>
  13680. <tr>
  13681. <th>Field</th>
  13682. <th>Description</th>
  13683. </tr>
  13684. </thead>
  13685. <tbody>
  13686. <tr>
  13687. <td>
  13688. <code>authorizedKeySecretRef</code></br>
  13689. <em>
  13690. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13691. External Secrets meta/v1.SecretKeySelector
  13692. </a>
  13693. </em>
  13694. </td>
  13695. <td>
  13696. <em>(Optional)</em>
  13697. <p>The authorized key used for authentication</p>
  13698. </td>
  13699. </tr>
  13700. </tbody>
  13701. </table>
  13702. <h3 id="external-secrets.io/v1.YandexCAProvider">YandexCAProvider
  13703. </h3>
  13704. <p>
  13705. (<em>Appears on:</em>
  13706. <a href="#external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>,
  13707. <a href="#external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider</a>)
  13708. </p>
  13709. <p>
  13710. <p>YandexCAProvider defines the configuration for Yandex custom certificate authority.</p>
  13711. </p>
  13712. <table>
  13713. <thead>
  13714. <tr>
  13715. <th>Field</th>
  13716. <th>Description</th>
  13717. </tr>
  13718. </thead>
  13719. <tbody>
  13720. <tr>
  13721. <td>
  13722. <code>certSecretRef</code></br>
  13723. <em>
  13724. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  13725. External Secrets meta/v1.SecretKeySelector
  13726. </a>
  13727. </em>
  13728. </td>
  13729. <td>
  13730. </td>
  13731. </tr>
  13732. </tbody>
  13733. </table>
  13734. <h3 id="external-secrets.io/v1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  13735. </h3>
  13736. <p>
  13737. (<em>Appears on:</em>
  13738. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  13739. </p>
  13740. <p>
  13741. <p>YandexCertificateManagerProvider Configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  13742. </p>
  13743. <table>
  13744. <thead>
  13745. <tr>
  13746. <th>Field</th>
  13747. <th>Description</th>
  13748. </tr>
  13749. </thead>
  13750. <tbody>
  13751. <tr>
  13752. <td>
  13753. <code>apiEndpoint</code></br>
  13754. <em>
  13755. string
  13756. </em>
  13757. </td>
  13758. <td>
  13759. <em>(Optional)</em>
  13760. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  13761. </td>
  13762. </tr>
  13763. <tr>
  13764. <td>
  13765. <code>auth</code></br>
  13766. <em>
  13767. <a href="#external-secrets.io/v1.YandexAuth">
  13768. YandexAuth
  13769. </a>
  13770. </em>
  13771. </td>
  13772. <td>
  13773. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  13774. </td>
  13775. </tr>
  13776. <tr>
  13777. <td>
  13778. <code>caProvider</code></br>
  13779. <em>
  13780. <a href="#external-secrets.io/v1.YandexCAProvider">
  13781. YandexCAProvider
  13782. </a>
  13783. </em>
  13784. </td>
  13785. <td>
  13786. <em>(Optional)</em>
  13787. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  13788. </td>
  13789. </tr>
  13790. <tr>
  13791. <td>
  13792. <code>fetching</code></br>
  13793. <em>
  13794. <a href="#external-secrets.io/v1.FetchingPolicy">
  13795. FetchingPolicy
  13796. </a>
  13797. </em>
  13798. </td>
  13799. <td>
  13800. <em>(Optional)</em>
  13801. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as certificate ID or certificate name</p>
  13802. </td>
  13803. </tr>
  13804. </tbody>
  13805. </table>
  13806. <h3 id="external-secrets.io/v1.YandexLockboxProvider">YandexLockboxProvider
  13807. </h3>
  13808. <p>
  13809. (<em>Appears on:</em>
  13810. <a href="#external-secrets.io/v1.SecretStoreProvider">SecretStoreProvider</a>)
  13811. </p>
  13812. <p>
  13813. <p>YandexLockboxProvider Configures a store to sync secrets using the Yandex Lockbox provider.</p>
  13814. </p>
  13815. <table>
  13816. <thead>
  13817. <tr>
  13818. <th>Field</th>
  13819. <th>Description</th>
  13820. </tr>
  13821. </thead>
  13822. <tbody>
  13823. <tr>
  13824. <td>
  13825. <code>apiEndpoint</code></br>
  13826. <em>
  13827. string
  13828. </em>
  13829. </td>
  13830. <td>
  13831. <em>(Optional)</em>
  13832. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  13833. </td>
  13834. </tr>
  13835. <tr>
  13836. <td>
  13837. <code>auth</code></br>
  13838. <em>
  13839. <a href="#external-secrets.io/v1.YandexAuth">
  13840. YandexAuth
  13841. </a>
  13842. </em>
  13843. </td>
  13844. <td>
  13845. <p>Auth defines the information necessary to authenticate against Yandex.Cloud</p>
  13846. </td>
  13847. </tr>
  13848. <tr>
  13849. <td>
  13850. <code>caProvider</code></br>
  13851. <em>
  13852. <a href="#external-secrets.io/v1.YandexCAProvider">
  13853. YandexCAProvider
  13854. </a>
  13855. </em>
  13856. </td>
  13857. <td>
  13858. <em>(Optional)</em>
  13859. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  13860. </td>
  13861. </tr>
  13862. <tr>
  13863. <td>
  13864. <code>fetching</code></br>
  13865. <em>
  13866. <a href="#external-secrets.io/v1.FetchingPolicy">
  13867. FetchingPolicy
  13868. </a>
  13869. </em>
  13870. </td>
  13871. <td>
  13872. <em>(Optional)</em>
  13873. <p>FetchingPolicy configures the provider to interpret the <code>data.secretKey.remoteRef.key</code> field in ExternalSecret as secret ID or secret name</p>
  13874. </td>
  13875. </tr>
  13876. </tbody>
  13877. </table>
  13878. <hr/>
  13879. <h2 id="external-secrets.io/v1alpha1">external-secrets.io/v1alpha1</h2>
  13880. <p>
  13881. <p>Package v1alpha1 contains resources for external-secrets</p>
  13882. </p>
  13883. <p>Resource Types:</p>
  13884. <ul></ul>
  13885. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret
  13886. </h3>
  13887. <p>
  13888. <p>ClusterPushSecret is the Schema for the ClusterPushSecrets API that enables cluster-wide management of pushing Kubernetes secrets to external providers.</p>
  13889. </p>
  13890. <table>
  13891. <thead>
  13892. <tr>
  13893. <th>Field</th>
  13894. <th>Description</th>
  13895. </tr>
  13896. </thead>
  13897. <tbody>
  13898. <tr>
  13899. <td>
  13900. <code>metadata</code></br>
  13901. <em>
  13902. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  13903. Kubernetes meta/v1.ObjectMeta
  13904. </a>
  13905. </em>
  13906. </td>
  13907. <td>
  13908. Refer to the Kubernetes API documentation for the fields of the
  13909. <code>metadata</code> field.
  13910. </td>
  13911. </tr>
  13912. <tr>
  13913. <td>
  13914. <code>spec</code></br>
  13915. <em>
  13916. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">
  13917. ClusterPushSecretSpec
  13918. </a>
  13919. </em>
  13920. </td>
  13921. <td>
  13922. <br/>
  13923. <br/>
  13924. <table>
  13925. <tr>
  13926. <td>
  13927. <code>pushSecretSpec</code></br>
  13928. <em>
  13929. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  13930. PushSecretSpec
  13931. </a>
  13932. </em>
  13933. </td>
  13934. <td>
  13935. <p>PushSecretSpec defines what to do with the secrets.</p>
  13936. </td>
  13937. </tr>
  13938. <tr>
  13939. <td>
  13940. <code>refreshTime</code></br>
  13941. <em>
  13942. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  13943. Kubernetes meta/v1.Duration
  13944. </a>
  13945. </em>
  13946. </td>
  13947. <td>
  13948. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  13949. </td>
  13950. </tr>
  13951. <tr>
  13952. <td>
  13953. <code>pushSecretName</code></br>
  13954. <em>
  13955. string
  13956. </em>
  13957. </td>
  13958. <td>
  13959. <em>(Optional)</em>
  13960. <p>The name of the push secrets to be created.
  13961. Defaults to the name of the ClusterPushSecret</p>
  13962. </td>
  13963. </tr>
  13964. <tr>
  13965. <td>
  13966. <code>pushSecretMetadata</code></br>
  13967. <em>
  13968. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  13969. PushSecretMetadata
  13970. </a>
  13971. </em>
  13972. </td>
  13973. <td>
  13974. <em>(Optional)</em>
  13975. <p>The metadata of the external secrets to be created</p>
  13976. </td>
  13977. </tr>
  13978. <tr>
  13979. <td>
  13980. <code>namespaceSelectors</code></br>
  13981. <em>
  13982. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  13983. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  13984. </a>
  13985. </em>
  13986. </td>
  13987. <td>
  13988. <em>(Optional)</em>
  13989. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  13990. </td>
  13991. </tr>
  13992. </table>
  13993. </td>
  13994. </tr>
  13995. <tr>
  13996. <td>
  13997. <code>status</code></br>
  13998. <em>
  13999. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">
  14000. ClusterPushSecretStatus
  14001. </a>
  14002. </em>
  14003. </td>
  14004. <td>
  14005. </td>
  14006. </tr>
  14007. </tbody>
  14008. </table>
  14009. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretCondition">ClusterPushSecretCondition
  14010. </h3>
  14011. <p>
  14012. <p>ClusterPushSecretCondition used to refine PushSecrets to specific namespaces and names.</p>
  14013. </p>
  14014. <table>
  14015. <thead>
  14016. <tr>
  14017. <th>Field</th>
  14018. <th>Description</th>
  14019. </tr>
  14020. </thead>
  14021. <tbody>
  14022. <tr>
  14023. <td>
  14024. <code>namespaceSelector</code></br>
  14025. <em>
  14026. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  14027. Kubernetes meta/v1.LabelSelector
  14028. </a>
  14029. </em>
  14030. </td>
  14031. <td>
  14032. <em>(Optional)</em>
  14033. <p>Choose namespace using a labelSelector</p>
  14034. </td>
  14035. </tr>
  14036. <tr>
  14037. <td>
  14038. <code>namespaces</code></br>
  14039. <em>
  14040. []string
  14041. </em>
  14042. </td>
  14043. <td>
  14044. <em>(Optional)</em>
  14045. <p>Choose namespaces by name</p>
  14046. </td>
  14047. </tr>
  14048. </tbody>
  14049. </table>
  14050. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">ClusterPushSecretNamespaceFailure
  14051. </h3>
  14052. <p>
  14053. (<em>Appears on:</em>
  14054. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>)
  14055. </p>
  14056. <p>
  14057. <p>ClusterPushSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  14058. </p>
  14059. <table>
  14060. <thead>
  14061. <tr>
  14062. <th>Field</th>
  14063. <th>Description</th>
  14064. </tr>
  14065. </thead>
  14066. <tbody>
  14067. <tr>
  14068. <td>
  14069. <code>namespace</code></br>
  14070. <em>
  14071. string
  14072. </em>
  14073. </td>
  14074. <td>
  14075. <p>Namespace is the namespace that failed when trying to apply an PushSecret</p>
  14076. </td>
  14077. </tr>
  14078. <tr>
  14079. <td>
  14080. <code>reason</code></br>
  14081. <em>
  14082. string
  14083. </em>
  14084. </td>
  14085. <td>
  14086. <em>(Optional)</em>
  14087. <p>Reason is why the PushSecret failed to apply to the namespace</p>
  14088. </td>
  14089. </tr>
  14090. </tbody>
  14091. </table>
  14092. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec
  14093. </h3>
  14094. <p>
  14095. (<em>Appears on:</em>
  14096. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  14097. </p>
  14098. <p>
  14099. <p>ClusterPushSecretSpec defines the configuration for a ClusterPushSecret resource.</p>
  14100. </p>
  14101. <table>
  14102. <thead>
  14103. <tr>
  14104. <th>Field</th>
  14105. <th>Description</th>
  14106. </tr>
  14107. </thead>
  14108. <tbody>
  14109. <tr>
  14110. <td>
  14111. <code>pushSecretSpec</code></br>
  14112. <em>
  14113. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  14114. PushSecretSpec
  14115. </a>
  14116. </em>
  14117. </td>
  14118. <td>
  14119. <p>PushSecretSpec defines what to do with the secrets.</p>
  14120. </td>
  14121. </tr>
  14122. <tr>
  14123. <td>
  14124. <code>refreshTime</code></br>
  14125. <em>
  14126. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14127. Kubernetes meta/v1.Duration
  14128. </a>
  14129. </em>
  14130. </td>
  14131. <td>
  14132. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  14133. </td>
  14134. </tr>
  14135. <tr>
  14136. <td>
  14137. <code>pushSecretName</code></br>
  14138. <em>
  14139. string
  14140. </em>
  14141. </td>
  14142. <td>
  14143. <em>(Optional)</em>
  14144. <p>The name of the push secrets to be created.
  14145. Defaults to the name of the ClusterPushSecret</p>
  14146. </td>
  14147. </tr>
  14148. <tr>
  14149. <td>
  14150. <code>pushSecretMetadata</code></br>
  14151. <em>
  14152. <a href="#external-secrets.io/v1alpha1.PushSecretMetadata">
  14153. PushSecretMetadata
  14154. </a>
  14155. </em>
  14156. </td>
  14157. <td>
  14158. <em>(Optional)</em>
  14159. <p>The metadata of the external secrets to be created</p>
  14160. </td>
  14161. </tr>
  14162. <tr>
  14163. <td>
  14164. <code>namespaceSelectors</code></br>
  14165. <em>
  14166. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  14167. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  14168. </a>
  14169. </em>
  14170. </td>
  14171. <td>
  14172. <em>(Optional)</em>
  14173. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  14174. </td>
  14175. </tr>
  14176. </tbody>
  14177. </table>
  14178. <h3 id="external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus
  14179. </h3>
  14180. <p>
  14181. (<em>Appears on:</em>
  14182. <a href="#external-secrets.io/v1alpha1.ClusterPushSecret">ClusterPushSecret</a>)
  14183. </p>
  14184. <p>
  14185. <p>ClusterPushSecretStatus contains the status information for the ClusterPushSecret resource.</p>
  14186. </p>
  14187. <table>
  14188. <thead>
  14189. <tr>
  14190. <th>Field</th>
  14191. <th>Description</th>
  14192. </tr>
  14193. </thead>
  14194. <tbody>
  14195. <tr>
  14196. <td>
  14197. <code>failedNamespaces</code></br>
  14198. <em>
  14199. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretNamespaceFailure">
  14200. []ClusterPushSecretNamespaceFailure
  14201. </a>
  14202. </em>
  14203. </td>
  14204. <td>
  14205. <em>(Optional)</em>
  14206. <p>Failed namespaces are the namespaces that failed to apply an PushSecret</p>
  14207. </td>
  14208. </tr>
  14209. <tr>
  14210. <td>
  14211. <code>provisionedNamespaces</code></br>
  14212. <em>
  14213. []string
  14214. </em>
  14215. </td>
  14216. <td>
  14217. <em>(Optional)</em>
  14218. <p>ProvisionedNamespaces are the namespaces where the ClusterPushSecret has secrets</p>
  14219. </td>
  14220. </tr>
  14221. <tr>
  14222. <td>
  14223. <code>pushSecretName</code></br>
  14224. <em>
  14225. string
  14226. </em>
  14227. </td>
  14228. <td>
  14229. </td>
  14230. </tr>
  14231. <tr>
  14232. <td>
  14233. <code>conditions</code></br>
  14234. <em>
  14235. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  14236. []PushSecretStatusCondition
  14237. </a>
  14238. </em>
  14239. </td>
  14240. <td>
  14241. <em>(Optional)</em>
  14242. </td>
  14243. </tr>
  14244. </tbody>
  14245. </table>
  14246. <h3 id="external-secrets.io/v1alpha1.PushSecret">PushSecret
  14247. </h3>
  14248. <p>
  14249. <p>PushSecret is the Schema for the PushSecrets API that enables pushing Kubernetes secrets to external secret providers.</p>
  14250. </p>
  14251. <table>
  14252. <thead>
  14253. <tr>
  14254. <th>Field</th>
  14255. <th>Description</th>
  14256. </tr>
  14257. </thead>
  14258. <tbody>
  14259. <tr>
  14260. <td>
  14261. <code>metadata</code></br>
  14262. <em>
  14263. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  14264. Kubernetes meta/v1.ObjectMeta
  14265. </a>
  14266. </em>
  14267. </td>
  14268. <td>
  14269. Refer to the Kubernetes API documentation for the fields of the
  14270. <code>metadata</code> field.
  14271. </td>
  14272. </tr>
  14273. <tr>
  14274. <td>
  14275. <code>spec</code></br>
  14276. <em>
  14277. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">
  14278. PushSecretSpec
  14279. </a>
  14280. </em>
  14281. </td>
  14282. <td>
  14283. <br/>
  14284. <br/>
  14285. <table>
  14286. <tr>
  14287. <td>
  14288. <code>refreshInterval</code></br>
  14289. <em>
  14290. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14291. Kubernetes meta/v1.Duration
  14292. </a>
  14293. </em>
  14294. </td>
  14295. <td>
  14296. <p>The Interval to which External Secrets will try to push a secret definition</p>
  14297. </td>
  14298. </tr>
  14299. <tr>
  14300. <td>
  14301. <code>secretStoreRefs</code></br>
  14302. <em>
  14303. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  14304. []PushSecretStoreRef
  14305. </a>
  14306. </em>
  14307. </td>
  14308. <td>
  14309. </td>
  14310. </tr>
  14311. <tr>
  14312. <td>
  14313. <code>updatePolicy</code></br>
  14314. <em>
  14315. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  14316. PushSecretUpdatePolicy
  14317. </a>
  14318. </em>
  14319. </td>
  14320. <td>
  14321. <em>(Optional)</em>
  14322. <p>UpdatePolicy to handle Secrets in the provider.</p>
  14323. </td>
  14324. </tr>
  14325. <tr>
  14326. <td>
  14327. <code>deletionPolicy</code></br>
  14328. <em>
  14329. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  14330. PushSecretDeletionPolicy
  14331. </a>
  14332. </em>
  14333. </td>
  14334. <td>
  14335. <em>(Optional)</em>
  14336. <p>Deletion Policy to handle Secrets in the provider.</p>
  14337. </td>
  14338. </tr>
  14339. <tr>
  14340. <td>
  14341. <code>selector</code></br>
  14342. <em>
  14343. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  14344. PushSecretSelector
  14345. </a>
  14346. </em>
  14347. </td>
  14348. <td>
  14349. <p>The Secret Selector (k8s source) for the Push Secret</p>
  14350. </td>
  14351. </tr>
  14352. <tr>
  14353. <td>
  14354. <code>data</code></br>
  14355. <em>
  14356. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  14357. []PushSecretData
  14358. </a>
  14359. </em>
  14360. </td>
  14361. <td>
  14362. <p>Secret Data that should be pushed to providers</p>
  14363. </td>
  14364. </tr>
  14365. <tr>
  14366. <td>
  14367. <code>template</code></br>
  14368. <em>
  14369. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  14370. ExternalSecretTemplate
  14371. </a>
  14372. </em>
  14373. </td>
  14374. <td>
  14375. <em>(Optional)</em>
  14376. <p>Template defines a blueprint for the created Secret resource.</p>
  14377. </td>
  14378. </tr>
  14379. </table>
  14380. </td>
  14381. </tr>
  14382. <tr>
  14383. <td>
  14384. <code>status</code></br>
  14385. <em>
  14386. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">
  14387. PushSecretStatus
  14388. </a>
  14389. </em>
  14390. </td>
  14391. <td>
  14392. </td>
  14393. </tr>
  14394. </tbody>
  14395. </table>
  14396. <h3 id="external-secrets.io/v1alpha1.PushSecretConditionType">PushSecretConditionType
  14397. (<code>string</code> alias)</p></h3>
  14398. <p>
  14399. (<em>Appears on:</em>
  14400. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition</a>)
  14401. </p>
  14402. <p>
  14403. <p>PushSecretConditionType indicates the condition of the PushSecret.</p>
  14404. </p>
  14405. <table>
  14406. <thead>
  14407. <tr>
  14408. <th>Value</th>
  14409. <th>Description</th>
  14410. </tr>
  14411. </thead>
  14412. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  14413. <td><p>PushSecretReady indicates the PushSecret resource is ready.</p>
  14414. </td>
  14415. </tr></tbody>
  14416. </table>
  14417. <h3 id="external-secrets.io/v1alpha1.PushSecretConversionStrategy">PushSecretConversionStrategy
  14418. (<code>string</code> alias)</p></h3>
  14419. <p>
  14420. (<em>Appears on:</em>
  14421. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>)
  14422. </p>
  14423. <p>
  14424. <p>PushSecretConversionStrategy defines how secret values are converted when pushed to providers.</p>
  14425. </p>
  14426. <table>
  14427. <thead>
  14428. <tr>
  14429. <th>Value</th>
  14430. <th>Description</th>
  14431. </tr>
  14432. </thead>
  14433. <tbody><tr><td><p>&#34;None&#34;</p></td>
  14434. <td><p>PushSecretConversionNone indicates no conversion will be performed on the secret value.</p>
  14435. </td>
  14436. </tr><tr><td><p>&#34;ReverseUnicode&#34;</p></td>
  14437. <td><p>PushSecretConversionReverseUnicode indicates that unicode escape sequences will be reversed.</p>
  14438. </td>
  14439. </tr></tbody>
  14440. </table>
  14441. <h3 id="external-secrets.io/v1alpha1.PushSecretData">PushSecretData
  14442. </h3>
  14443. <p>
  14444. (<em>Appears on:</em>
  14445. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  14446. </p>
  14447. <p>
  14448. <p>PushSecretData defines data to be pushed to the provider and associated metadata.</p>
  14449. </p>
  14450. <table>
  14451. <thead>
  14452. <tr>
  14453. <th>Field</th>
  14454. <th>Description</th>
  14455. </tr>
  14456. </thead>
  14457. <tbody>
  14458. <tr>
  14459. <td>
  14460. <code>match</code></br>
  14461. <em>
  14462. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">
  14463. PushSecretMatch
  14464. </a>
  14465. </em>
  14466. </td>
  14467. <td>
  14468. <p>Match a given Secret Key to be pushed to the provider.</p>
  14469. </td>
  14470. </tr>
  14471. <tr>
  14472. <td>
  14473. <code>metadata</code></br>
  14474. <em>
  14475. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  14476. </em>
  14477. </td>
  14478. <td>
  14479. <em>(Optional)</em>
  14480. <p>Metadata is metadata attached to the secret.
  14481. The structure of metadata is provider specific, please look it up in the provider documentation.</p>
  14482. </td>
  14483. </tr>
  14484. <tr>
  14485. <td>
  14486. <code>conversionStrategy</code></br>
  14487. <em>
  14488. <a href="#external-secrets.io/v1alpha1.PushSecretConversionStrategy">
  14489. PushSecretConversionStrategy
  14490. </a>
  14491. </em>
  14492. </td>
  14493. <td>
  14494. <em>(Optional)</em>
  14495. <p>Used to define a conversion Strategy for the secret keys</p>
  14496. </td>
  14497. </tr>
  14498. </tbody>
  14499. </table>
  14500. <h3 id="external-secrets.io/v1alpha1.PushSecretDeletionPolicy">PushSecretDeletionPolicy
  14501. (<code>string</code> alias)</p></h3>
  14502. <p>
  14503. (<em>Appears on:</em>
  14504. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  14505. </p>
  14506. <p>
  14507. <p>PushSecretDeletionPolicy defines how push secrets are deleted in the provider.</p>
  14508. </p>
  14509. <table>
  14510. <thead>
  14511. <tr>
  14512. <th>Value</th>
  14513. <th>Description</th>
  14514. </tr>
  14515. </thead>
  14516. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  14517. <td><p>PushSecretDeletionPolicyDelete deletes secrets from the provider when the PushSecret is deleted.</p>
  14518. </td>
  14519. </tr><tr><td><p>&#34;None&#34;</p></td>
  14520. <td><p>PushSecretDeletionPolicyNone keeps secrets in the provider when the PushSecret is deleted.</p>
  14521. </td>
  14522. </tr></tbody>
  14523. </table>
  14524. <h3 id="external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch
  14525. </h3>
  14526. <p>
  14527. (<em>Appears on:</em>
  14528. <a href="#external-secrets.io/v1alpha1.PushSecretData">PushSecretData</a>)
  14529. </p>
  14530. <p>
  14531. <p>PushSecretMatch defines how a source Secret key maps to a destination in the provider.</p>
  14532. </p>
  14533. <table>
  14534. <thead>
  14535. <tr>
  14536. <th>Field</th>
  14537. <th>Description</th>
  14538. </tr>
  14539. </thead>
  14540. <tbody>
  14541. <tr>
  14542. <td>
  14543. <code>secretKey</code></br>
  14544. <em>
  14545. string
  14546. </em>
  14547. </td>
  14548. <td>
  14549. <em>(Optional)</em>
  14550. <p>Secret Key to be pushed</p>
  14551. </td>
  14552. </tr>
  14553. <tr>
  14554. <td>
  14555. <code>remoteRef</code></br>
  14556. <em>
  14557. <a href="#external-secrets.io/v1alpha1.PushSecretRemoteRef">
  14558. PushSecretRemoteRef
  14559. </a>
  14560. </em>
  14561. </td>
  14562. <td>
  14563. <p>Remote Refs to push to providers.</p>
  14564. </td>
  14565. </tr>
  14566. </tbody>
  14567. </table>
  14568. <h3 id="external-secrets.io/v1alpha1.PushSecretMetadata">PushSecretMetadata
  14569. </h3>
  14570. <p>
  14571. (<em>Appears on:</em>
  14572. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>)
  14573. </p>
  14574. <p>
  14575. <p>PushSecretMetadata defines metadata fields for the PushSecret generated by the ClusterPushSecret.</p>
  14576. </p>
  14577. <table>
  14578. <thead>
  14579. <tr>
  14580. <th>Field</th>
  14581. <th>Description</th>
  14582. </tr>
  14583. </thead>
  14584. <tbody>
  14585. <tr>
  14586. <td>
  14587. <code>annotations</code></br>
  14588. <em>
  14589. map[string]string
  14590. </em>
  14591. </td>
  14592. <td>
  14593. <em>(Optional)</em>
  14594. </td>
  14595. </tr>
  14596. <tr>
  14597. <td>
  14598. <code>labels</code></br>
  14599. <em>
  14600. map[string]string
  14601. </em>
  14602. </td>
  14603. <td>
  14604. <em>(Optional)</em>
  14605. </td>
  14606. </tr>
  14607. </tbody>
  14608. </table>
  14609. <h3 id="external-secrets.io/v1alpha1.PushSecretRemoteRef">PushSecretRemoteRef
  14610. </h3>
  14611. <p>
  14612. (<em>Appears on:</em>
  14613. <a href="#external-secrets.io/v1alpha1.PushSecretMatch">PushSecretMatch</a>)
  14614. </p>
  14615. <p>
  14616. <p>PushSecretRemoteRef defines the location of the secret in the provider.</p>
  14617. </p>
  14618. <table>
  14619. <thead>
  14620. <tr>
  14621. <th>Field</th>
  14622. <th>Description</th>
  14623. </tr>
  14624. </thead>
  14625. <tbody>
  14626. <tr>
  14627. <td>
  14628. <code>remoteKey</code></br>
  14629. <em>
  14630. string
  14631. </em>
  14632. </td>
  14633. <td>
  14634. <p>Name of the resulting provider secret.</p>
  14635. </td>
  14636. </tr>
  14637. <tr>
  14638. <td>
  14639. <code>property</code></br>
  14640. <em>
  14641. string
  14642. </em>
  14643. </td>
  14644. <td>
  14645. <em>(Optional)</em>
  14646. <p>Name of the property in the resulting secret</p>
  14647. </td>
  14648. </tr>
  14649. </tbody>
  14650. </table>
  14651. <h3 id="external-secrets.io/v1alpha1.PushSecretSecret">PushSecretSecret
  14652. </h3>
  14653. <p>
  14654. (<em>Appears on:</em>
  14655. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector</a>)
  14656. </p>
  14657. <p>
  14658. <p>PushSecretSecret defines a Secret that will be used as a source for pushing to providers.</p>
  14659. </p>
  14660. <table>
  14661. <thead>
  14662. <tr>
  14663. <th>Field</th>
  14664. <th>Description</th>
  14665. </tr>
  14666. </thead>
  14667. <tbody>
  14668. <tr>
  14669. <td>
  14670. <code>name</code></br>
  14671. <em>
  14672. string
  14673. </em>
  14674. </td>
  14675. <td>
  14676. <em>(Optional)</em>
  14677. <p>Name of the Secret.
  14678. The Secret must exist in the same namespace as the PushSecret manifest.</p>
  14679. </td>
  14680. </tr>
  14681. <tr>
  14682. <td>
  14683. <code>selector</code></br>
  14684. <em>
  14685. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  14686. Kubernetes meta/v1.LabelSelector
  14687. </a>
  14688. </em>
  14689. </td>
  14690. <td>
  14691. <em>(Optional)</em>
  14692. <p>Selector chooses secrets using a labelSelector.</p>
  14693. </td>
  14694. </tr>
  14695. </tbody>
  14696. </table>
  14697. <h3 id="external-secrets.io/v1alpha1.PushSecretSelector">PushSecretSelector
  14698. </h3>
  14699. <p>
  14700. (<em>Appears on:</em>
  14701. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  14702. </p>
  14703. <p>
  14704. <p>PushSecretSelector defines criteria for selecting the source Secret for pushing to providers.</p>
  14705. </p>
  14706. <table>
  14707. <thead>
  14708. <tr>
  14709. <th>Field</th>
  14710. <th>Description</th>
  14711. </tr>
  14712. </thead>
  14713. <tbody>
  14714. <tr>
  14715. <td>
  14716. <code>secret</code></br>
  14717. <em>
  14718. <a href="#external-secrets.io/v1alpha1.PushSecretSecret">
  14719. PushSecretSecret
  14720. </a>
  14721. </em>
  14722. </td>
  14723. <td>
  14724. <em>(Optional)</em>
  14725. <p>Select a Secret to Push.</p>
  14726. </td>
  14727. </tr>
  14728. <tr>
  14729. <td>
  14730. <code>generatorRef</code></br>
  14731. <em>
  14732. <a href="#external-secrets.io/v1.GeneratorRef">
  14733. GeneratorRef
  14734. </a>
  14735. </em>
  14736. </td>
  14737. <td>
  14738. <em>(Optional)</em>
  14739. <p>Point to a generator to create a Secret.</p>
  14740. </td>
  14741. </tr>
  14742. </tbody>
  14743. </table>
  14744. <h3 id="external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec
  14745. </h3>
  14746. <p>
  14747. (<em>Appears on:</em>
  14748. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretSpec">ClusterPushSecretSpec</a>,
  14749. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  14750. </p>
  14751. <p>
  14752. <p>PushSecretSpec configures the behavior of the PushSecret.</p>
  14753. </p>
  14754. <table>
  14755. <thead>
  14756. <tr>
  14757. <th>Field</th>
  14758. <th>Description</th>
  14759. </tr>
  14760. </thead>
  14761. <tbody>
  14762. <tr>
  14763. <td>
  14764. <code>refreshInterval</code></br>
  14765. <em>
  14766. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  14767. Kubernetes meta/v1.Duration
  14768. </a>
  14769. </em>
  14770. </td>
  14771. <td>
  14772. <p>The Interval to which External Secrets will try to push a secret definition</p>
  14773. </td>
  14774. </tr>
  14775. <tr>
  14776. <td>
  14777. <code>secretStoreRefs</code></br>
  14778. <em>
  14779. <a href="#external-secrets.io/v1alpha1.PushSecretStoreRef">
  14780. []PushSecretStoreRef
  14781. </a>
  14782. </em>
  14783. </td>
  14784. <td>
  14785. </td>
  14786. </tr>
  14787. <tr>
  14788. <td>
  14789. <code>updatePolicy</code></br>
  14790. <em>
  14791. <a href="#external-secrets.io/v1alpha1.PushSecretUpdatePolicy">
  14792. PushSecretUpdatePolicy
  14793. </a>
  14794. </em>
  14795. </td>
  14796. <td>
  14797. <em>(Optional)</em>
  14798. <p>UpdatePolicy to handle Secrets in the provider.</p>
  14799. </td>
  14800. </tr>
  14801. <tr>
  14802. <td>
  14803. <code>deletionPolicy</code></br>
  14804. <em>
  14805. <a href="#external-secrets.io/v1alpha1.PushSecretDeletionPolicy">
  14806. PushSecretDeletionPolicy
  14807. </a>
  14808. </em>
  14809. </td>
  14810. <td>
  14811. <em>(Optional)</em>
  14812. <p>Deletion Policy to handle Secrets in the provider.</p>
  14813. </td>
  14814. </tr>
  14815. <tr>
  14816. <td>
  14817. <code>selector</code></br>
  14818. <em>
  14819. <a href="#external-secrets.io/v1alpha1.PushSecretSelector">
  14820. PushSecretSelector
  14821. </a>
  14822. </em>
  14823. </td>
  14824. <td>
  14825. <p>The Secret Selector (k8s source) for the Push Secret</p>
  14826. </td>
  14827. </tr>
  14828. <tr>
  14829. <td>
  14830. <code>data</code></br>
  14831. <em>
  14832. <a href="#external-secrets.io/v1alpha1.PushSecretData">
  14833. []PushSecretData
  14834. </a>
  14835. </em>
  14836. </td>
  14837. <td>
  14838. <p>Secret Data that should be pushed to providers</p>
  14839. </td>
  14840. </tr>
  14841. <tr>
  14842. <td>
  14843. <code>template</code></br>
  14844. <em>
  14845. <a href="#external-secrets.io/v1.ExternalSecretTemplate">
  14846. ExternalSecretTemplate
  14847. </a>
  14848. </em>
  14849. </td>
  14850. <td>
  14851. <em>(Optional)</em>
  14852. <p>Template defines a blueprint for the created Secret resource.</p>
  14853. </td>
  14854. </tr>
  14855. </tbody>
  14856. </table>
  14857. <h3 id="external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus
  14858. </h3>
  14859. <p>
  14860. (<em>Appears on:</em>
  14861. <a href="#external-secrets.io/v1alpha1.PushSecret">PushSecret</a>)
  14862. </p>
  14863. <p>
  14864. <p>PushSecretStatus indicates the history of the status of PushSecret.</p>
  14865. </p>
  14866. <table>
  14867. <thead>
  14868. <tr>
  14869. <th>Field</th>
  14870. <th>Description</th>
  14871. </tr>
  14872. </thead>
  14873. <tbody>
  14874. <tr>
  14875. <td>
  14876. <code>refreshTime</code></br>
  14877. <em>
  14878. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  14879. Kubernetes meta/v1.Time
  14880. </a>
  14881. </em>
  14882. </td>
  14883. <td>
  14884. <p>refreshTime is the time and date the external secret was fetched and
  14885. the target secret updated</p>
  14886. </td>
  14887. </tr>
  14888. <tr>
  14889. <td>
  14890. <code>syncedResourceVersion</code></br>
  14891. <em>
  14892. string
  14893. </em>
  14894. </td>
  14895. <td>
  14896. <p>SyncedResourceVersion keeps track of the last synced version.</p>
  14897. </td>
  14898. </tr>
  14899. <tr>
  14900. <td>
  14901. <code>syncedPushSecrets</code></br>
  14902. <em>
  14903. <a href="#external-secrets.io/v1alpha1.SyncedPushSecretsMap">
  14904. SyncedPushSecretsMap
  14905. </a>
  14906. </em>
  14907. </td>
  14908. <td>
  14909. <em>(Optional)</em>
  14910. <p>Synced PushSecrets, including secrets that already exist in provider.
  14911. Matches secret stores to PushSecretData that was stored to that secret store.</p>
  14912. </td>
  14913. </tr>
  14914. <tr>
  14915. <td>
  14916. <code>conditions</code></br>
  14917. <em>
  14918. <a href="#external-secrets.io/v1alpha1.PushSecretStatusCondition">
  14919. []PushSecretStatusCondition
  14920. </a>
  14921. </em>
  14922. </td>
  14923. <td>
  14924. <em>(Optional)</em>
  14925. </td>
  14926. </tr>
  14927. </tbody>
  14928. </table>
  14929. <h3 id="external-secrets.io/v1alpha1.PushSecretStatusCondition">PushSecretStatusCondition
  14930. </h3>
  14931. <p>
  14932. (<em>Appears on:</em>
  14933. <a href="#external-secrets.io/v1alpha1.ClusterPushSecretStatus">ClusterPushSecretStatus</a>,
  14934. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  14935. </p>
  14936. <p>
  14937. <p>PushSecretStatusCondition indicates the status of the PushSecret.</p>
  14938. </p>
  14939. <table>
  14940. <thead>
  14941. <tr>
  14942. <th>Field</th>
  14943. <th>Description</th>
  14944. </tr>
  14945. </thead>
  14946. <tbody>
  14947. <tr>
  14948. <td>
  14949. <code>type</code></br>
  14950. <em>
  14951. <a href="#external-secrets.io/v1alpha1.PushSecretConditionType">
  14952. PushSecretConditionType
  14953. </a>
  14954. </em>
  14955. </td>
  14956. <td>
  14957. </td>
  14958. </tr>
  14959. <tr>
  14960. <td>
  14961. <code>status</code></br>
  14962. <em>
  14963. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  14964. Kubernetes core/v1.ConditionStatus
  14965. </a>
  14966. </em>
  14967. </td>
  14968. <td>
  14969. </td>
  14970. </tr>
  14971. <tr>
  14972. <td>
  14973. <code>reason</code></br>
  14974. <em>
  14975. string
  14976. </em>
  14977. </td>
  14978. <td>
  14979. <em>(Optional)</em>
  14980. </td>
  14981. </tr>
  14982. <tr>
  14983. <td>
  14984. <code>message</code></br>
  14985. <em>
  14986. string
  14987. </em>
  14988. </td>
  14989. <td>
  14990. <em>(Optional)</em>
  14991. </td>
  14992. </tr>
  14993. <tr>
  14994. <td>
  14995. <code>lastTransitionTime</code></br>
  14996. <em>
  14997. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  14998. Kubernetes meta/v1.Time
  14999. </a>
  15000. </em>
  15001. </td>
  15002. <td>
  15003. <em>(Optional)</em>
  15004. </td>
  15005. </tr>
  15006. </tbody>
  15007. </table>
  15008. <h3 id="external-secrets.io/v1alpha1.PushSecretStoreRef">PushSecretStoreRef
  15009. </h3>
  15010. <p>
  15011. (<em>Appears on:</em>
  15012. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15013. </p>
  15014. <p>
  15015. <p>PushSecretStoreRef contains a reference on how to sync to a SecretStore.</p>
  15016. </p>
  15017. <table>
  15018. <thead>
  15019. <tr>
  15020. <th>Field</th>
  15021. <th>Description</th>
  15022. </tr>
  15023. </thead>
  15024. <tbody>
  15025. <tr>
  15026. <td>
  15027. <code>name</code></br>
  15028. <em>
  15029. string
  15030. </em>
  15031. </td>
  15032. <td>
  15033. <em>(Optional)</em>
  15034. <p>Optionally, sync to the SecretStore of the given name</p>
  15035. </td>
  15036. </tr>
  15037. <tr>
  15038. <td>
  15039. <code>labelSelector</code></br>
  15040. <em>
  15041. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  15042. Kubernetes meta/v1.LabelSelector
  15043. </a>
  15044. </em>
  15045. </td>
  15046. <td>
  15047. <em>(Optional)</em>
  15048. <p>Optionally, sync to secret stores with label selector</p>
  15049. </td>
  15050. </tr>
  15051. <tr>
  15052. <td>
  15053. <code>kind</code></br>
  15054. <em>
  15055. string
  15056. </em>
  15057. </td>
  15058. <td>
  15059. <em>(Optional)</em>
  15060. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)</p>
  15061. </td>
  15062. </tr>
  15063. </tbody>
  15064. </table>
  15065. <h3 id="external-secrets.io/v1alpha1.PushSecretUpdatePolicy">PushSecretUpdatePolicy
  15066. (<code>string</code> alias)</p></h3>
  15067. <p>
  15068. (<em>Appears on:</em>
  15069. <a href="#external-secrets.io/v1alpha1.PushSecretSpec">PushSecretSpec</a>)
  15070. </p>
  15071. <p>
  15072. <p>PushSecretUpdatePolicy defines how push secrets are updated in the provider.</p>
  15073. </p>
  15074. <table>
  15075. <thead>
  15076. <tr>
  15077. <th>Value</th>
  15078. <th>Description</th>
  15079. </tr>
  15080. </thead>
  15081. <tbody><tr><td><p>&#34;IfNotExists&#34;</p></td>
  15082. <td><p>PushSecretUpdatePolicyIfNotExists only creates secrets that don&rsquo;t exist in the provider.</p>
  15083. </td>
  15084. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  15085. <td><p>PushSecretUpdatePolicyReplace replaces existing secrets in the provider.</p>
  15086. </td>
  15087. </tr></tbody>
  15088. </table>
  15089. <h3 id="external-secrets.io/v1alpha1.SyncedPushSecretsMap">SyncedPushSecretsMap
  15090. (<code>map[string]map[string]github.com/external-secrets/external-secrets/apis/externalsecrets/v1alpha1.PushSecretData</code> alias)</p></h3>
  15091. <p>
  15092. (<em>Appears on:</em>
  15093. <a href="#external-secrets.io/v1alpha1.PushSecretStatus">PushSecretStatus</a>)
  15094. </p>
  15095. <p>
  15096. <p>SyncedPushSecretsMap is a map that tracks which PushSecretData was stored to which secret store.
  15097. The outer map&rsquo;s key is the secret store name, and the inner map&rsquo;s key is the remote key name.</p>
  15098. </p>
  15099. <hr/>
  15100. <h2 id="external-secrets.io/v1beta1">external-secrets.io/v1beta1</h2>
  15101. <p>
  15102. <p>Package v1beta1 contains resources for external-secrets</p>
  15103. </p>
  15104. <p>Resource Types:</p>
  15105. <ul></ul>
  15106. <h3 id="external-secrets.io/v1beta1.AWSAuth">AWSAuth
  15107. </h3>
  15108. <p>
  15109. (<em>Appears on:</em>
  15110. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  15111. </p>
  15112. <p>
  15113. <p>AWSAuth tells the controller how to do authentication with aws.
  15114. Only one of secretRef or jwt can be specified.
  15115. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  15116. </p>
  15117. <table>
  15118. <thead>
  15119. <tr>
  15120. <th>Field</th>
  15121. <th>Description</th>
  15122. </tr>
  15123. </thead>
  15124. <tbody>
  15125. <tr>
  15126. <td>
  15127. <code>secretRef</code></br>
  15128. <em>
  15129. <a href="#external-secrets.io/v1beta1.AWSAuthSecretRef">
  15130. AWSAuthSecretRef
  15131. </a>
  15132. </em>
  15133. </td>
  15134. <td>
  15135. <em>(Optional)</em>
  15136. </td>
  15137. </tr>
  15138. <tr>
  15139. <td>
  15140. <code>jwt</code></br>
  15141. <em>
  15142. <a href="#external-secrets.io/v1beta1.AWSJWTAuth">
  15143. AWSJWTAuth
  15144. </a>
  15145. </em>
  15146. </td>
  15147. <td>
  15148. <em>(Optional)</em>
  15149. </td>
  15150. </tr>
  15151. </tbody>
  15152. </table>
  15153. <h3 id="external-secrets.io/v1beta1.AWSAuthSecretRef">AWSAuthSecretRef
  15154. </h3>
  15155. <p>
  15156. (<em>Appears on:</em>
  15157. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  15158. </p>
  15159. <p>
  15160. <p>AWSAuthSecretRef holds secret references for AWS credentials
  15161. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  15162. </p>
  15163. <table>
  15164. <thead>
  15165. <tr>
  15166. <th>Field</th>
  15167. <th>Description</th>
  15168. </tr>
  15169. </thead>
  15170. <tbody>
  15171. <tr>
  15172. <td>
  15173. <code>accessKeyIDSecretRef</code></br>
  15174. <em>
  15175. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15176. External Secrets meta/v1.SecretKeySelector
  15177. </a>
  15178. </em>
  15179. </td>
  15180. <td>
  15181. <p>The AccessKeyID is used for authentication</p>
  15182. </td>
  15183. </tr>
  15184. <tr>
  15185. <td>
  15186. <code>secretAccessKeySecretRef</code></br>
  15187. <em>
  15188. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15189. External Secrets meta/v1.SecretKeySelector
  15190. </a>
  15191. </em>
  15192. </td>
  15193. <td>
  15194. <p>The SecretAccessKey is used for authentication</p>
  15195. </td>
  15196. </tr>
  15197. <tr>
  15198. <td>
  15199. <code>sessionTokenSecretRef</code></br>
  15200. <em>
  15201. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15202. External Secrets meta/v1.SecretKeySelector
  15203. </a>
  15204. </em>
  15205. </td>
  15206. <td>
  15207. <p>The SessionToken used for authentication
  15208. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  15209. 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>
  15210. </td>
  15211. </tr>
  15212. </tbody>
  15213. </table>
  15214. <h3 id="external-secrets.io/v1beta1.AWSJWTAuth">AWSJWTAuth
  15215. </h3>
  15216. <p>
  15217. (<em>Appears on:</em>
  15218. <a href="#external-secrets.io/v1beta1.AWSAuth">AWSAuth</a>)
  15219. </p>
  15220. <p>
  15221. <p>AWSJWTAuth authenticates against AWS using service account tokens from the Kubernetes cluster.</p>
  15222. </p>
  15223. <table>
  15224. <thead>
  15225. <tr>
  15226. <th>Field</th>
  15227. <th>Description</th>
  15228. </tr>
  15229. </thead>
  15230. <tbody>
  15231. <tr>
  15232. <td>
  15233. <code>serviceAccountRef</code></br>
  15234. <em>
  15235. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  15236. External Secrets meta/v1.ServiceAccountSelector
  15237. </a>
  15238. </em>
  15239. </td>
  15240. <td>
  15241. </td>
  15242. </tr>
  15243. </tbody>
  15244. </table>
  15245. <h3 id="external-secrets.io/v1beta1.AWSProvider">AWSProvider
  15246. </h3>
  15247. <p>
  15248. (<em>Appears on:</em>
  15249. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  15250. </p>
  15251. <p>
  15252. <p>AWSProvider configures a store to sync secrets with AWS.</p>
  15253. </p>
  15254. <table>
  15255. <thead>
  15256. <tr>
  15257. <th>Field</th>
  15258. <th>Description</th>
  15259. </tr>
  15260. </thead>
  15261. <tbody>
  15262. <tr>
  15263. <td>
  15264. <code>service</code></br>
  15265. <em>
  15266. <a href="#external-secrets.io/v1beta1.AWSServiceType">
  15267. AWSServiceType
  15268. </a>
  15269. </em>
  15270. </td>
  15271. <td>
  15272. <p>Service defines which service should be used to fetch the secrets</p>
  15273. </td>
  15274. </tr>
  15275. <tr>
  15276. <td>
  15277. <code>auth</code></br>
  15278. <em>
  15279. <a href="#external-secrets.io/v1beta1.AWSAuth">
  15280. AWSAuth
  15281. </a>
  15282. </em>
  15283. </td>
  15284. <td>
  15285. <em>(Optional)</em>
  15286. <p>Auth defines the information necessary to authenticate against AWS
  15287. if not set aws sdk will infer credentials from your environment
  15288. 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>
  15289. </td>
  15290. </tr>
  15291. <tr>
  15292. <td>
  15293. <code>role</code></br>
  15294. <em>
  15295. string
  15296. </em>
  15297. </td>
  15298. <td>
  15299. <em>(Optional)</em>
  15300. <p>Role is a Role ARN which the provider will assume</p>
  15301. </td>
  15302. </tr>
  15303. <tr>
  15304. <td>
  15305. <code>region</code></br>
  15306. <em>
  15307. string
  15308. </em>
  15309. </td>
  15310. <td>
  15311. <p>AWS Region to be used for the provider</p>
  15312. </td>
  15313. </tr>
  15314. <tr>
  15315. <td>
  15316. <code>additionalRoles</code></br>
  15317. <em>
  15318. []string
  15319. </em>
  15320. </td>
  15321. <td>
  15322. <em>(Optional)</em>
  15323. <p>AdditionalRoles is a chained list of Role ARNs which the provider will sequentially assume before assuming the Role</p>
  15324. </td>
  15325. </tr>
  15326. <tr>
  15327. <td>
  15328. <code>externalID</code></br>
  15329. <em>
  15330. string
  15331. </em>
  15332. </td>
  15333. <td>
  15334. <p>AWS External ID set on assumed IAM roles</p>
  15335. </td>
  15336. </tr>
  15337. <tr>
  15338. <td>
  15339. <code>sessionTags</code></br>
  15340. <em>
  15341. <a href="#external-secrets.io/v1beta1.*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag">
  15342. []*github.com/external-secrets/external-secrets/apis/externalsecrets/v1beta1.Tag
  15343. </a>
  15344. </em>
  15345. </td>
  15346. <td>
  15347. <em>(Optional)</em>
  15348. <p>AWS STS assume role session tags</p>
  15349. </td>
  15350. </tr>
  15351. <tr>
  15352. <td>
  15353. <code>secretsManager</code></br>
  15354. <em>
  15355. <a href="#external-secrets.io/v1beta1.SecretsManager">
  15356. SecretsManager
  15357. </a>
  15358. </em>
  15359. </td>
  15360. <td>
  15361. <em>(Optional)</em>
  15362. <p>SecretsManager defines how the provider behaves when interacting with AWS SecretsManager</p>
  15363. </td>
  15364. </tr>
  15365. <tr>
  15366. <td>
  15367. <code>transitiveTagKeys</code></br>
  15368. <em>
  15369. []*string
  15370. </em>
  15371. </td>
  15372. <td>
  15373. <em>(Optional)</em>
  15374. <p>AWS STS assume role transitive session tags. Required when multiple rules are used with the provider</p>
  15375. </td>
  15376. </tr>
  15377. <tr>
  15378. <td>
  15379. <code>prefix</code></br>
  15380. <em>
  15381. string
  15382. </em>
  15383. </td>
  15384. <td>
  15385. <em>(Optional)</em>
  15386. <p>Prefix adds a prefix to all retrieved values.</p>
  15387. </td>
  15388. </tr>
  15389. </tbody>
  15390. </table>
  15391. <h3 id="external-secrets.io/v1beta1.AWSServiceType">AWSServiceType
  15392. (<code>string</code> alias)</p></h3>
  15393. <p>
  15394. (<em>Appears on:</em>
  15395. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  15396. </p>
  15397. <p>
  15398. <p>AWSServiceType is an enum that defines the service/API that is used to fetch the secrets.</p>
  15399. </p>
  15400. <table>
  15401. <thead>
  15402. <tr>
  15403. <th>Value</th>
  15404. <th>Description</th>
  15405. </tr>
  15406. </thead>
  15407. <tbody><tr><td><p>&#34;ParameterStore&#34;</p></td>
  15408. <td><p>AWSServiceParameterStore is the AWS SystemsManager ParameterStore service.
  15409. 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>
  15410. </td>
  15411. </tr><tr><td><p>&#34;SecretsManager&#34;</p></td>
  15412. <td><p>AWSServiceSecretsManager is the AWS SecretsManager service.
  15413. 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>
  15414. </td>
  15415. </tr></tbody>
  15416. </table>
  15417. <h3 id="external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth
  15418. </h3>
  15419. <p>
  15420. (<em>Appears on:</em>
  15421. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>)
  15422. </p>
  15423. <p>
  15424. <p>AkeylessAuth defines methods of authentication with Akeyless Vault.</p>
  15425. </p>
  15426. <table>
  15427. <thead>
  15428. <tr>
  15429. <th>Field</th>
  15430. <th>Description</th>
  15431. </tr>
  15432. </thead>
  15433. <tbody>
  15434. <tr>
  15435. <td>
  15436. <code>secretRef</code></br>
  15437. <em>
  15438. <a href="#external-secrets.io/v1beta1.AkeylessAuthSecretRef">
  15439. AkeylessAuthSecretRef
  15440. </a>
  15441. </em>
  15442. </td>
  15443. <td>
  15444. <em>(Optional)</em>
  15445. <p>Reference to a Secret that contains the details
  15446. to authenticate with Akeyless.</p>
  15447. </td>
  15448. </tr>
  15449. <tr>
  15450. <td>
  15451. <code>kubernetesAuth</code></br>
  15452. <em>
  15453. <a href="#external-secrets.io/v1beta1.AkeylessKubernetesAuth">
  15454. AkeylessKubernetesAuth
  15455. </a>
  15456. </em>
  15457. </td>
  15458. <td>
  15459. <em>(Optional)</em>
  15460. <p>Kubernetes authenticates with Akeyless by passing the ServiceAccount
  15461. token stored in the named Secret resource.</p>
  15462. </td>
  15463. </tr>
  15464. </tbody>
  15465. </table>
  15466. <h3 id="external-secrets.io/v1beta1.AkeylessAuthSecretRef">AkeylessAuthSecretRef
  15467. </h3>
  15468. <p>
  15469. (<em>Appears on:</em>
  15470. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  15471. </p>
  15472. <p>
  15473. <p>AkeylessAuthSecretRef defines how to authenticate using a secret reference.
  15474. AKEYLESS_ACCESS_TYPE_PARAM: AZURE_OBJ_ID OR GCP_AUDIENCE OR ACCESS_KEY OR KUB_CONFIG_NAME.</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>accessID</code></br>
  15487. <em>
  15488. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15489. External Secrets meta/v1.SecretKeySelector
  15490. </a>
  15491. </em>
  15492. </td>
  15493. <td>
  15494. <p>The SecretAccessID is used for authentication</p>
  15495. </td>
  15496. </tr>
  15497. <tr>
  15498. <td>
  15499. <code>accessType</code></br>
  15500. <em>
  15501. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15502. External Secrets meta/v1.SecretKeySelector
  15503. </a>
  15504. </em>
  15505. </td>
  15506. <td>
  15507. </td>
  15508. </tr>
  15509. <tr>
  15510. <td>
  15511. <code>accessTypeParam</code></br>
  15512. <em>
  15513. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15514. External Secrets meta/v1.SecretKeySelector
  15515. </a>
  15516. </em>
  15517. </td>
  15518. <td>
  15519. </td>
  15520. </tr>
  15521. </tbody>
  15522. </table>
  15523. <h3 id="external-secrets.io/v1beta1.AkeylessKubernetesAuth">AkeylessKubernetesAuth
  15524. </h3>
  15525. <p>
  15526. (<em>Appears on:</em>
  15527. <a href="#external-secrets.io/v1beta1.AkeylessAuth">AkeylessAuth</a>)
  15528. </p>
  15529. <p>
  15530. <p>AkeylessKubernetesAuth authenticates with Akeyless using a Kubernetes ServiceAccount token.</p>
  15531. </p>
  15532. <table>
  15533. <thead>
  15534. <tr>
  15535. <th>Field</th>
  15536. <th>Description</th>
  15537. </tr>
  15538. </thead>
  15539. <tbody>
  15540. <tr>
  15541. <td>
  15542. <code>accessID</code></br>
  15543. <em>
  15544. string
  15545. </em>
  15546. </td>
  15547. <td>
  15548. <p>the Akeyless Kubernetes auth-method access-id</p>
  15549. </td>
  15550. </tr>
  15551. <tr>
  15552. <td>
  15553. <code>k8sConfName</code></br>
  15554. <em>
  15555. string
  15556. </em>
  15557. </td>
  15558. <td>
  15559. <p>Kubernetes-auth configuration name in Akeyless-Gateway</p>
  15560. </td>
  15561. </tr>
  15562. <tr>
  15563. <td>
  15564. <code>serviceAccountRef</code></br>
  15565. <em>
  15566. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  15567. External Secrets meta/v1.ServiceAccountSelector
  15568. </a>
  15569. </em>
  15570. </td>
  15571. <td>
  15572. <em>(Optional)</em>
  15573. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  15574. If the service account is specified, the service account secret token JWT will be used
  15575. for authenticating with Akeyless. If the service account selector is not supplied,
  15576. the secretRef will be used instead.</p>
  15577. </td>
  15578. </tr>
  15579. <tr>
  15580. <td>
  15581. <code>secretRef</code></br>
  15582. <em>
  15583. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15584. External Secrets meta/v1.SecretKeySelector
  15585. </a>
  15586. </em>
  15587. </td>
  15588. <td>
  15589. <em>(Optional)</em>
  15590. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  15591. for authenticating with Akeyless. If a name is specified without a key,
  15592. <code>token</code> is the default. If one is not specified, the one bound to
  15593. the controller will be used.</p>
  15594. </td>
  15595. </tr>
  15596. </tbody>
  15597. </table>
  15598. <h3 id="external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider
  15599. </h3>
  15600. <p>
  15601. (<em>Appears on:</em>
  15602. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  15603. </p>
  15604. <p>
  15605. <p>AkeylessProvider Configures an store to sync secrets using Akeyless KV.</p>
  15606. </p>
  15607. <table>
  15608. <thead>
  15609. <tr>
  15610. <th>Field</th>
  15611. <th>Description</th>
  15612. </tr>
  15613. </thead>
  15614. <tbody>
  15615. <tr>
  15616. <td>
  15617. <code>akeylessGWApiURL</code></br>
  15618. <em>
  15619. string
  15620. </em>
  15621. </td>
  15622. <td>
  15623. <p>Akeyless GW API Url from which the secrets to be fetched from.</p>
  15624. </td>
  15625. </tr>
  15626. <tr>
  15627. <td>
  15628. <code>authSecretRef</code></br>
  15629. <em>
  15630. <a href="#external-secrets.io/v1beta1.AkeylessAuth">
  15631. AkeylessAuth
  15632. </a>
  15633. </em>
  15634. </td>
  15635. <td>
  15636. <p>Auth configures how the operator authenticates with Akeyless.</p>
  15637. </td>
  15638. </tr>
  15639. <tr>
  15640. <td>
  15641. <code>caBundle</code></br>
  15642. <em>
  15643. []byte
  15644. </em>
  15645. </td>
  15646. <td>
  15647. <em>(Optional)</em>
  15648. <p>PEM/base64 encoded CA bundle used to validate Akeyless Gateway certificate. Only used
  15649. if the AkeylessGWApiURL URL is using HTTPS protocol. If not set the system root certificates
  15650. are used to validate the TLS connection.</p>
  15651. </td>
  15652. </tr>
  15653. <tr>
  15654. <td>
  15655. <code>caProvider</code></br>
  15656. <em>
  15657. <a href="#external-secrets.io/v1beta1.CAProvider">
  15658. CAProvider
  15659. </a>
  15660. </em>
  15661. </td>
  15662. <td>
  15663. <em>(Optional)</em>
  15664. <p>The provider for the CA bundle to use to validate Akeyless Gateway certificate.</p>
  15665. </td>
  15666. </tr>
  15667. </tbody>
  15668. </table>
  15669. <h3 id="external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth
  15670. </h3>
  15671. <p>
  15672. (<em>Appears on:</em>
  15673. <a href="#external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider</a>)
  15674. </p>
  15675. <p>
  15676. <p>AlibabaAuth contains a secretRef for credentials.</p>
  15677. </p>
  15678. <table>
  15679. <thead>
  15680. <tr>
  15681. <th>Field</th>
  15682. <th>Description</th>
  15683. </tr>
  15684. </thead>
  15685. <tbody>
  15686. <tr>
  15687. <td>
  15688. <code>secretRef</code></br>
  15689. <em>
  15690. <a href="#external-secrets.io/v1beta1.AlibabaAuthSecretRef">
  15691. AlibabaAuthSecretRef
  15692. </a>
  15693. </em>
  15694. </td>
  15695. <td>
  15696. <em>(Optional)</em>
  15697. </td>
  15698. </tr>
  15699. <tr>
  15700. <td>
  15701. <code>rrsa</code></br>
  15702. <em>
  15703. <a href="#external-secrets.io/v1beta1.AlibabaRRSAAuth">
  15704. AlibabaRRSAAuth
  15705. </a>
  15706. </em>
  15707. </td>
  15708. <td>
  15709. <em>(Optional)</em>
  15710. </td>
  15711. </tr>
  15712. </tbody>
  15713. </table>
  15714. <h3 id="external-secrets.io/v1beta1.AlibabaAuthSecretRef">AlibabaAuthSecretRef
  15715. </h3>
  15716. <p>
  15717. (<em>Appears on:</em>
  15718. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  15719. </p>
  15720. <p>
  15721. <p>AlibabaAuthSecretRef holds secret references for Alibaba credentials.</p>
  15722. </p>
  15723. <table>
  15724. <thead>
  15725. <tr>
  15726. <th>Field</th>
  15727. <th>Description</th>
  15728. </tr>
  15729. </thead>
  15730. <tbody>
  15731. <tr>
  15732. <td>
  15733. <code>accessKeyIDSecretRef</code></br>
  15734. <em>
  15735. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15736. External Secrets meta/v1.SecretKeySelector
  15737. </a>
  15738. </em>
  15739. </td>
  15740. <td>
  15741. <p>The AccessKeyID is used for authentication</p>
  15742. </td>
  15743. </tr>
  15744. <tr>
  15745. <td>
  15746. <code>accessKeySecretSecretRef</code></br>
  15747. <em>
  15748. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15749. External Secrets meta/v1.SecretKeySelector
  15750. </a>
  15751. </em>
  15752. </td>
  15753. <td>
  15754. <p>The AccessKeySecret is used for authentication</p>
  15755. </td>
  15756. </tr>
  15757. </tbody>
  15758. </table>
  15759. <h3 id="external-secrets.io/v1beta1.AlibabaProvider">AlibabaProvider
  15760. </h3>
  15761. <p>
  15762. (<em>Appears on:</em>
  15763. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  15764. </p>
  15765. <p>
  15766. <p>AlibabaProvider configures a store to sync secrets using the Alibaba Secret Manager provider.</p>
  15767. </p>
  15768. <table>
  15769. <thead>
  15770. <tr>
  15771. <th>Field</th>
  15772. <th>Description</th>
  15773. </tr>
  15774. </thead>
  15775. <tbody>
  15776. <tr>
  15777. <td>
  15778. <code>auth</code></br>
  15779. <em>
  15780. <a href="#external-secrets.io/v1beta1.AlibabaAuth">
  15781. AlibabaAuth
  15782. </a>
  15783. </em>
  15784. </td>
  15785. <td>
  15786. </td>
  15787. </tr>
  15788. <tr>
  15789. <td>
  15790. <code>regionID</code></br>
  15791. <em>
  15792. string
  15793. </em>
  15794. </td>
  15795. <td>
  15796. <p>Alibaba Region to be used for the provider</p>
  15797. </td>
  15798. </tr>
  15799. </tbody>
  15800. </table>
  15801. <h3 id="external-secrets.io/v1beta1.AlibabaRRSAAuth">AlibabaRRSAAuth
  15802. </h3>
  15803. <p>
  15804. (<em>Appears on:</em>
  15805. <a href="#external-secrets.io/v1beta1.AlibabaAuth">AlibabaAuth</a>)
  15806. </p>
  15807. <p>
  15808. <p>AlibabaRRSAAuth authenticates against Alibaba using RRSA (Resource-oriented RAM-based Service Authentication).</p>
  15809. </p>
  15810. <table>
  15811. <thead>
  15812. <tr>
  15813. <th>Field</th>
  15814. <th>Description</th>
  15815. </tr>
  15816. </thead>
  15817. <tbody>
  15818. <tr>
  15819. <td>
  15820. <code>oidcProviderArn</code></br>
  15821. <em>
  15822. string
  15823. </em>
  15824. </td>
  15825. <td>
  15826. </td>
  15827. </tr>
  15828. <tr>
  15829. <td>
  15830. <code>oidcTokenFilePath</code></br>
  15831. <em>
  15832. string
  15833. </em>
  15834. </td>
  15835. <td>
  15836. </td>
  15837. </tr>
  15838. <tr>
  15839. <td>
  15840. <code>roleArn</code></br>
  15841. <em>
  15842. string
  15843. </em>
  15844. </td>
  15845. <td>
  15846. </td>
  15847. </tr>
  15848. <tr>
  15849. <td>
  15850. <code>sessionName</code></br>
  15851. <em>
  15852. string
  15853. </em>
  15854. </td>
  15855. <td>
  15856. </td>
  15857. </tr>
  15858. </tbody>
  15859. </table>
  15860. <h3 id="external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol
  15861. </h3>
  15862. <p>
  15863. (<em>Appears on:</em>
  15864. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  15865. </p>
  15866. <p>
  15867. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  15868. </p>
  15869. <table>
  15870. <thead>
  15871. <tr>
  15872. <th>Field</th>
  15873. <th>Description</th>
  15874. </tr>
  15875. </thead>
  15876. <tbody>
  15877. <tr>
  15878. <td>
  15879. <code>ntlm</code></br>
  15880. <em>
  15881. <a href="#external-secrets.io/v1beta1.NTLMProtocol">
  15882. NTLMProtocol
  15883. </a>
  15884. </em>
  15885. </td>
  15886. <td>
  15887. <em>(Optional)</em>
  15888. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  15889. </td>
  15890. </tr>
  15891. </tbody>
  15892. </table>
  15893. <h3 id="external-secrets.io/v1beta1.AzureAuthType">AzureAuthType
  15894. (<code>string</code> alias)</p></h3>
  15895. <p>
  15896. (<em>Appears on:</em>
  15897. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  15898. </p>
  15899. <p>
  15900. <p>AzureAuthType describes how to authenticate to the Azure Keyvault.
  15901. Only one of the following auth types may be specified.
  15902. If none of the following auth type is specified, the default one
  15903. is ServicePrincipal.</p>
  15904. </p>
  15905. <table>
  15906. <thead>
  15907. <tr>
  15908. <th>Value</th>
  15909. <th>Description</th>
  15910. </tr>
  15911. </thead>
  15912. <tbody><tr><td><p>&#34;ManagedIdentity&#34;</p></td>
  15913. <td><p>AzureManagedIdentity uses Managed Identity to authenticate. Used with aad-pod-identity installed in the cluster.</p>
  15914. </td>
  15915. </tr><tr><td><p>&#34;ServicePrincipal&#34;</p></td>
  15916. <td><p>AzureServicePrincipal uses service principal to authenticate, which needs a tenantId, a clientId and a clientSecret.</p>
  15917. </td>
  15918. </tr><tr><td><p>&#34;WorkloadIdentity&#34;</p></td>
  15919. <td><p>AzureWorkloadIdentity uses Workload Identity service accounts to authenticate.</p>
  15920. </td>
  15921. </tr></tbody>
  15922. </table>
  15923. <h3 id="external-secrets.io/v1beta1.AzureEnvironmentType">AzureEnvironmentType
  15924. (<code>string</code> alias)</p></h3>
  15925. <p>
  15926. (<em>Appears on:</em>
  15927. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  15928. </p>
  15929. <p>
  15930. <p>AzureEnvironmentType specifies the Azure cloud environment endpoints to use for
  15931. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  15932. 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>
  15933. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  15934. </p>
  15935. <table>
  15936. <thead>
  15937. <tr>
  15938. <th>Value</th>
  15939. <th>Description</th>
  15940. </tr>
  15941. </thead>
  15942. <tbody><tr><td><p>&#34;ChinaCloud&#34;</p></td>
  15943. <td><p>AzureEnvironmentChinaCloud represents the Azure China cloud environment.</p>
  15944. </td>
  15945. </tr><tr><td><p>&#34;GermanCloud&#34;</p></td>
  15946. <td><p>AzureEnvironmentGermanCloud represents the Azure German cloud environment.</p>
  15947. </td>
  15948. </tr><tr><td><p>&#34;PublicCloud&#34;</p></td>
  15949. <td><p>AzureEnvironmentPublicCloud represents the Azure public cloud environment.</p>
  15950. </td>
  15951. </tr><tr><td><p>&#34;USGovernmentCloud&#34;</p></td>
  15952. <td><p>AzureEnvironmentUSGovernmentCloud represents the Azure US government cloud environment.</p>
  15953. </td>
  15954. </tr></tbody>
  15955. </table>
  15956. <h3 id="external-secrets.io/v1beta1.AzureKVAuth">AzureKVAuth
  15957. </h3>
  15958. <p>
  15959. (<em>Appears on:</em>
  15960. <a href="#external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider</a>)
  15961. </p>
  15962. <p>
  15963. <p>AzureKVAuth defines configuration for authentication with Azure Key Vault.</p>
  15964. </p>
  15965. <table>
  15966. <thead>
  15967. <tr>
  15968. <th>Field</th>
  15969. <th>Description</th>
  15970. </tr>
  15971. </thead>
  15972. <tbody>
  15973. <tr>
  15974. <td>
  15975. <code>clientId</code></br>
  15976. <em>
  15977. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15978. External Secrets meta/v1.SecretKeySelector
  15979. </a>
  15980. </em>
  15981. </td>
  15982. <td>
  15983. <em>(Optional)</em>
  15984. <p>The Azure clientId of the service principle or managed identity used for authentication.</p>
  15985. </td>
  15986. </tr>
  15987. <tr>
  15988. <td>
  15989. <code>tenantId</code></br>
  15990. <em>
  15991. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  15992. External Secrets meta/v1.SecretKeySelector
  15993. </a>
  15994. </em>
  15995. </td>
  15996. <td>
  15997. <em>(Optional)</em>
  15998. <p>The Azure tenantId of the managed identity used for authentication.</p>
  15999. </td>
  16000. </tr>
  16001. <tr>
  16002. <td>
  16003. <code>clientSecret</code></br>
  16004. <em>
  16005. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16006. External Secrets meta/v1.SecretKeySelector
  16007. </a>
  16008. </em>
  16009. </td>
  16010. <td>
  16011. <em>(Optional)</em>
  16012. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  16013. </td>
  16014. </tr>
  16015. <tr>
  16016. <td>
  16017. <code>clientCertificate</code></br>
  16018. <em>
  16019. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16020. External Secrets meta/v1.SecretKeySelector
  16021. </a>
  16022. </em>
  16023. </td>
  16024. <td>
  16025. <em>(Optional)</em>
  16026. <p>The Azure ClientCertificate of the service principle used for authentication.</p>
  16027. </td>
  16028. </tr>
  16029. </tbody>
  16030. </table>
  16031. <h3 id="external-secrets.io/v1beta1.AzureKVProvider">AzureKVProvider
  16032. </h3>
  16033. <p>
  16034. (<em>Appears on:</em>
  16035. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16036. </p>
  16037. <p>
  16038. <p>AzureKVProvider configures a store to sync secrets using Azure Key Vault.</p>
  16039. </p>
  16040. <table>
  16041. <thead>
  16042. <tr>
  16043. <th>Field</th>
  16044. <th>Description</th>
  16045. </tr>
  16046. </thead>
  16047. <tbody>
  16048. <tr>
  16049. <td>
  16050. <code>authType</code></br>
  16051. <em>
  16052. <a href="#external-secrets.io/v1beta1.AzureAuthType">
  16053. AzureAuthType
  16054. </a>
  16055. </em>
  16056. </td>
  16057. <td>
  16058. <em>(Optional)</em>
  16059. <p>Auth type defines how to authenticate to the keyvault service.
  16060. Valid values are:
  16061. - &ldquo;ServicePrincipal&rdquo; (default): Using a service principal (tenantId, clientId, clientSecret)
  16062. - &ldquo;ManagedIdentity&rdquo;: Using Managed Identity assigned to the pod (see aad-pod-identity)</p>
  16063. </td>
  16064. </tr>
  16065. <tr>
  16066. <td>
  16067. <code>vaultUrl</code></br>
  16068. <em>
  16069. string
  16070. </em>
  16071. </td>
  16072. <td>
  16073. <p>Vault Url from which the secrets to be fetched from.</p>
  16074. </td>
  16075. </tr>
  16076. <tr>
  16077. <td>
  16078. <code>tenantId</code></br>
  16079. <em>
  16080. string
  16081. </em>
  16082. </td>
  16083. <td>
  16084. <em>(Optional)</em>
  16085. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  16086. </td>
  16087. </tr>
  16088. <tr>
  16089. <td>
  16090. <code>environmentType</code></br>
  16091. <em>
  16092. <a href="#external-secrets.io/v1beta1.AzureEnvironmentType">
  16093. AzureEnvironmentType
  16094. </a>
  16095. </em>
  16096. </td>
  16097. <td>
  16098. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  16099. connecting and authenticating with Azure. By default it points to the public cloud AAD endpoint.
  16100. 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>
  16101. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  16102. </td>
  16103. </tr>
  16104. <tr>
  16105. <td>
  16106. <code>authSecretRef</code></br>
  16107. <em>
  16108. <a href="#external-secrets.io/v1beta1.AzureKVAuth">
  16109. AzureKVAuth
  16110. </a>
  16111. </em>
  16112. </td>
  16113. <td>
  16114. <em>(Optional)</em>
  16115. <p>Auth configures how the operator authenticates with Azure. Required for ServicePrincipal auth type. Optional for WorkloadIdentity.</p>
  16116. </td>
  16117. </tr>
  16118. <tr>
  16119. <td>
  16120. <code>serviceAccountRef</code></br>
  16121. <em>
  16122. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  16123. External Secrets meta/v1.ServiceAccountSelector
  16124. </a>
  16125. </em>
  16126. </td>
  16127. <td>
  16128. <em>(Optional)</em>
  16129. <p>ServiceAccountRef specified the service account
  16130. that should be used when authenticating with WorkloadIdentity.</p>
  16131. </td>
  16132. </tr>
  16133. <tr>
  16134. <td>
  16135. <code>identityId</code></br>
  16136. <em>
  16137. string
  16138. </em>
  16139. </td>
  16140. <td>
  16141. <em>(Optional)</em>
  16142. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  16143. </td>
  16144. </tr>
  16145. </tbody>
  16146. </table>
  16147. <h3 id="external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">BeyondTrustProviderSecretRef
  16148. </h3>
  16149. <p>
  16150. (<em>Appears on:</em>
  16151. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth</a>)
  16152. </p>
  16153. <p>
  16154. <p>BeyondTrustProviderSecretRef defines a reference to a secret containing credentials for the BeyondTrust provider.</p>
  16155. </p>
  16156. <table>
  16157. <thead>
  16158. <tr>
  16159. <th>Field</th>
  16160. <th>Description</th>
  16161. </tr>
  16162. </thead>
  16163. <tbody>
  16164. <tr>
  16165. <td>
  16166. <code>value</code></br>
  16167. <em>
  16168. string
  16169. </em>
  16170. </td>
  16171. <td>
  16172. <em>(Optional)</em>
  16173. <p>Value can be specified directly to set a value without using a secret.</p>
  16174. </td>
  16175. </tr>
  16176. <tr>
  16177. <td>
  16178. <code>secretRef</code></br>
  16179. <em>
  16180. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16181. External Secrets meta/v1.SecretKeySelector
  16182. </a>
  16183. </em>
  16184. </td>
  16185. <td>
  16186. <em>(Optional)</em>
  16187. <p>SecretRef references a key in a secret that will be used as value.</p>
  16188. </td>
  16189. </tr>
  16190. </tbody>
  16191. </table>
  16192. <h3 id="external-secrets.io/v1beta1.BeyondtrustAuth">BeyondtrustAuth
  16193. </h3>
  16194. <p>
  16195. (<em>Appears on:</em>
  16196. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  16197. </p>
  16198. <p>
  16199. <p>BeyondtrustAuth configures authentication for BeyondTrust Password Safe.</p>
  16200. </p>
  16201. <table>
  16202. <thead>
  16203. <tr>
  16204. <th>Field</th>
  16205. <th>Description</th>
  16206. </tr>
  16207. </thead>
  16208. <tbody>
  16209. <tr>
  16210. <td>
  16211. <code>apiKey</code></br>
  16212. <em>
  16213. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16214. BeyondTrustProviderSecretRef
  16215. </a>
  16216. </em>
  16217. </td>
  16218. <td>
  16219. <p>APIKey If not provided then ClientID/ClientSecret become required.</p>
  16220. </td>
  16221. </tr>
  16222. <tr>
  16223. <td>
  16224. <code>clientId</code></br>
  16225. <em>
  16226. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16227. BeyondTrustProviderSecretRef
  16228. </a>
  16229. </em>
  16230. </td>
  16231. <td>
  16232. <p>ClientID is the API OAuth Client ID.</p>
  16233. </td>
  16234. </tr>
  16235. <tr>
  16236. <td>
  16237. <code>clientSecret</code></br>
  16238. <em>
  16239. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16240. BeyondTrustProviderSecretRef
  16241. </a>
  16242. </em>
  16243. </td>
  16244. <td>
  16245. <p>ClientSecret is the API OAuth Client Secret.</p>
  16246. </td>
  16247. </tr>
  16248. <tr>
  16249. <td>
  16250. <code>certificate</code></br>
  16251. <em>
  16252. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16253. BeyondTrustProviderSecretRef
  16254. </a>
  16255. </em>
  16256. </td>
  16257. <td>
  16258. <p>Certificate (cert.pem) for use when authenticating with an OAuth client Id using a Client Certificate.</p>
  16259. </td>
  16260. </tr>
  16261. <tr>
  16262. <td>
  16263. <code>certificateKey</code></br>
  16264. <em>
  16265. <a href="#external-secrets.io/v1beta1.BeyondTrustProviderSecretRef">
  16266. BeyondTrustProviderSecretRef
  16267. </a>
  16268. </em>
  16269. </td>
  16270. <td>
  16271. <p>Certificate private key (key.pem). For use when authenticating with an OAuth client Id</p>
  16272. </td>
  16273. </tr>
  16274. </tbody>
  16275. </table>
  16276. <h3 id="external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider
  16277. </h3>
  16278. <p>
  16279. (<em>Appears on:</em>
  16280. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16281. </p>
  16282. <p>
  16283. <p>BeyondtrustProvider defines configuration for the BeyondTrust Password Safe provider.</p>
  16284. </p>
  16285. <table>
  16286. <thead>
  16287. <tr>
  16288. <th>Field</th>
  16289. <th>Description</th>
  16290. </tr>
  16291. </thead>
  16292. <tbody>
  16293. <tr>
  16294. <td>
  16295. <code>auth</code></br>
  16296. <em>
  16297. <a href="#external-secrets.io/v1beta1.BeyondtrustAuth">
  16298. BeyondtrustAuth
  16299. </a>
  16300. </em>
  16301. </td>
  16302. <td>
  16303. <p>Auth configures how the operator authenticates with Beyondtrust.</p>
  16304. </td>
  16305. </tr>
  16306. <tr>
  16307. <td>
  16308. <code>server</code></br>
  16309. <em>
  16310. <a href="#external-secrets.io/v1beta1.BeyondtrustServer">
  16311. BeyondtrustServer
  16312. </a>
  16313. </em>
  16314. </td>
  16315. <td>
  16316. <p>Auth configures how API server works.</p>
  16317. </td>
  16318. </tr>
  16319. </tbody>
  16320. </table>
  16321. <h3 id="external-secrets.io/v1beta1.BeyondtrustServer">BeyondtrustServer
  16322. </h3>
  16323. <p>
  16324. (<em>Appears on:</em>
  16325. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">BeyondtrustProvider</a>)
  16326. </p>
  16327. <p>
  16328. <p>BeyondtrustServer defines configuration for connecting to BeyondTrust Password Safe server.</p>
  16329. </p>
  16330. <table>
  16331. <thead>
  16332. <tr>
  16333. <th>Field</th>
  16334. <th>Description</th>
  16335. </tr>
  16336. </thead>
  16337. <tbody>
  16338. <tr>
  16339. <td>
  16340. <code>apiUrl</code></br>
  16341. <em>
  16342. string
  16343. </em>
  16344. </td>
  16345. <td>
  16346. </td>
  16347. </tr>
  16348. <tr>
  16349. <td>
  16350. <code>apiVersion</code></br>
  16351. <em>
  16352. string
  16353. </em>
  16354. </td>
  16355. <td>
  16356. </td>
  16357. </tr>
  16358. <tr>
  16359. <td>
  16360. <code>retrievalType</code></br>
  16361. <em>
  16362. string
  16363. </em>
  16364. </td>
  16365. <td>
  16366. <p>The secret retrieval type. SECRET = Secrets Safe (credential, text, file). MANAGED_ACCOUNT = Password Safe account associated with a system.</p>
  16367. </td>
  16368. </tr>
  16369. <tr>
  16370. <td>
  16371. <code>separator</code></br>
  16372. <em>
  16373. string
  16374. </em>
  16375. </td>
  16376. <td>
  16377. <p>A character that separates the folder names.</p>
  16378. </td>
  16379. </tr>
  16380. <tr>
  16381. <td>
  16382. <code>decrypt</code></br>
  16383. <em>
  16384. bool
  16385. </em>
  16386. </td>
  16387. <td>
  16388. <em>(Optional)</em>
  16389. <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>
  16390. </td>
  16391. </tr>
  16392. <tr>
  16393. <td>
  16394. <code>verifyCA</code></br>
  16395. <em>
  16396. bool
  16397. </em>
  16398. </td>
  16399. <td>
  16400. </td>
  16401. </tr>
  16402. <tr>
  16403. <td>
  16404. <code>clientTimeOutSeconds</code></br>
  16405. <em>
  16406. int
  16407. </em>
  16408. </td>
  16409. <td>
  16410. <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>
  16411. </td>
  16412. </tr>
  16413. </tbody>
  16414. </table>
  16415. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth
  16416. </h3>
  16417. <p>
  16418. (<em>Appears on:</em>
  16419. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>)
  16420. </p>
  16421. <p>
  16422. <p>BitwardenSecretsManagerAuth contains the ref to the secret that contains the machine account token.</p>
  16423. </p>
  16424. <table>
  16425. <thead>
  16426. <tr>
  16427. <th>Field</th>
  16428. <th>Description</th>
  16429. </tr>
  16430. </thead>
  16431. <tbody>
  16432. <tr>
  16433. <td>
  16434. <code>secretRef</code></br>
  16435. <em>
  16436. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">
  16437. BitwardenSecretsManagerSecretRef
  16438. </a>
  16439. </em>
  16440. </td>
  16441. <td>
  16442. </td>
  16443. </tr>
  16444. </tbody>
  16445. </table>
  16446. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider
  16447. </h3>
  16448. <p>
  16449. (<em>Appears on:</em>
  16450. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16451. </p>
  16452. <p>
  16453. <p>BitwardenSecretsManagerProvider configures a store to sync secrets with a Bitwarden Secrets Manager instance.</p>
  16454. </p>
  16455. <table>
  16456. <thead>
  16457. <tr>
  16458. <th>Field</th>
  16459. <th>Description</th>
  16460. </tr>
  16461. </thead>
  16462. <tbody>
  16463. <tr>
  16464. <td>
  16465. <code>apiURL</code></br>
  16466. <em>
  16467. string
  16468. </em>
  16469. </td>
  16470. <td>
  16471. </td>
  16472. </tr>
  16473. <tr>
  16474. <td>
  16475. <code>identityURL</code></br>
  16476. <em>
  16477. string
  16478. </em>
  16479. </td>
  16480. <td>
  16481. </td>
  16482. </tr>
  16483. <tr>
  16484. <td>
  16485. <code>bitwardenServerSDKURL</code></br>
  16486. <em>
  16487. string
  16488. </em>
  16489. </td>
  16490. <td>
  16491. </td>
  16492. </tr>
  16493. <tr>
  16494. <td>
  16495. <code>caBundle</code></br>
  16496. <em>
  16497. string
  16498. </em>
  16499. </td>
  16500. <td>
  16501. <em>(Optional)</em>
  16502. <p>Base64 encoded certificate for the bitwarden server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  16503. can be performed.</p>
  16504. </td>
  16505. </tr>
  16506. <tr>
  16507. <td>
  16508. <code>caProvider</code></br>
  16509. <em>
  16510. <a href="#external-secrets.io/v1beta1.CAProvider">
  16511. CAProvider
  16512. </a>
  16513. </em>
  16514. </td>
  16515. <td>
  16516. <em>(Optional)</em>
  16517. <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>
  16518. </td>
  16519. </tr>
  16520. <tr>
  16521. <td>
  16522. <code>organizationID</code></br>
  16523. <em>
  16524. string
  16525. </em>
  16526. </td>
  16527. <td>
  16528. <p>OrganizationID determines which organization this secret store manages.</p>
  16529. </td>
  16530. </tr>
  16531. <tr>
  16532. <td>
  16533. <code>projectID</code></br>
  16534. <em>
  16535. string
  16536. </em>
  16537. </td>
  16538. <td>
  16539. <p>ProjectID determines which project this secret store manages.</p>
  16540. </td>
  16541. </tr>
  16542. <tr>
  16543. <td>
  16544. <code>auth</code></br>
  16545. <em>
  16546. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">
  16547. BitwardenSecretsManagerAuth
  16548. </a>
  16549. </em>
  16550. </td>
  16551. <td>
  16552. <p>Auth configures how secret-manager authenticates with a bitwarden machine account instance.
  16553. Make sure that the token being used has permissions on the given secret.</p>
  16554. </td>
  16555. </tr>
  16556. </tbody>
  16557. </table>
  16558. <h3 id="external-secrets.io/v1beta1.BitwardenSecretsManagerSecretRef">BitwardenSecretsManagerSecretRef
  16559. </h3>
  16560. <p>
  16561. (<em>Appears on:</em>
  16562. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerAuth">BitwardenSecretsManagerAuth</a>)
  16563. </p>
  16564. <p>
  16565. <p>BitwardenSecretsManagerSecretRef contains the credential ref to the bitwarden instance.</p>
  16566. </p>
  16567. <table>
  16568. <thead>
  16569. <tr>
  16570. <th>Field</th>
  16571. <th>Description</th>
  16572. </tr>
  16573. </thead>
  16574. <tbody>
  16575. <tr>
  16576. <td>
  16577. <code>credentials</code></br>
  16578. <em>
  16579. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16580. External Secrets meta/v1.SecretKeySelector
  16581. </a>
  16582. </em>
  16583. </td>
  16584. <td>
  16585. <p>AccessToken used for the bitwarden instance.</p>
  16586. </td>
  16587. </tr>
  16588. </tbody>
  16589. </table>
  16590. <h3 id="external-secrets.io/v1beta1.CAProvider">CAProvider
  16591. </h3>
  16592. <p>
  16593. (<em>Appears on:</em>
  16594. <a href="#external-secrets.io/v1beta1.AkeylessProvider">AkeylessProvider</a>,
  16595. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">BitwardenSecretsManagerProvider</a>,
  16596. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>,
  16597. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>,
  16598. <a href="#external-secrets.io/v1beta1.KubernetesServer">KubernetesServer</a>,
  16599. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  16600. </p>
  16601. <p>
  16602. <p>CAProvider provides custom certificate authority (CA) certificates
  16603. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  16604. that contains a PEM-encoded certificate.</p>
  16605. </p>
  16606. <table>
  16607. <thead>
  16608. <tr>
  16609. <th>Field</th>
  16610. <th>Description</th>
  16611. </tr>
  16612. </thead>
  16613. <tbody>
  16614. <tr>
  16615. <td>
  16616. <code>type</code></br>
  16617. <em>
  16618. <a href="#external-secrets.io/v1beta1.CAProviderType">
  16619. CAProviderType
  16620. </a>
  16621. </em>
  16622. </td>
  16623. <td>
  16624. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  16625. </td>
  16626. </tr>
  16627. <tr>
  16628. <td>
  16629. <code>name</code></br>
  16630. <em>
  16631. string
  16632. </em>
  16633. </td>
  16634. <td>
  16635. <p>The name of the object located at the provider type.</p>
  16636. </td>
  16637. </tr>
  16638. <tr>
  16639. <td>
  16640. <code>key</code></br>
  16641. <em>
  16642. string
  16643. </em>
  16644. </td>
  16645. <td>
  16646. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  16647. </td>
  16648. </tr>
  16649. <tr>
  16650. <td>
  16651. <code>namespace</code></br>
  16652. <em>
  16653. string
  16654. </em>
  16655. </td>
  16656. <td>
  16657. <em>(Optional)</em>
  16658. <p>The namespace the Provider type is in.
  16659. Can only be defined when used in a ClusterSecretStore.</p>
  16660. </td>
  16661. </tr>
  16662. </tbody>
  16663. </table>
  16664. <h3 id="external-secrets.io/v1beta1.CAProviderType">CAProviderType
  16665. (<code>string</code> alias)</p></h3>
  16666. <p>
  16667. (<em>Appears on:</em>
  16668. <a href="#external-secrets.io/v1beta1.CAProvider">CAProvider</a>)
  16669. </p>
  16670. <p>
  16671. <p>CAProviderType defines the type of provider to use for CA certificates.</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;ConfigMap&#34;</p></td>
  16681. <td><p>CAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  16682. </td>
  16683. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  16684. <td><p>CAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  16685. </td>
  16686. </tr></tbody>
  16687. </table>
  16688. <h3 id="external-secrets.io/v1beta1.CSMAuth">CSMAuth
  16689. </h3>
  16690. <p>
  16691. (<em>Appears on:</em>
  16692. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider</a>)
  16693. </p>
  16694. <p>
  16695. <p>CSMAuth contains a secretRef for credentials.</p>
  16696. </p>
  16697. <table>
  16698. <thead>
  16699. <tr>
  16700. <th>Field</th>
  16701. <th>Description</th>
  16702. </tr>
  16703. </thead>
  16704. <tbody>
  16705. <tr>
  16706. <td>
  16707. <code>secretRef</code></br>
  16708. <em>
  16709. <a href="#external-secrets.io/v1beta1.CSMAuthSecretRef">
  16710. CSMAuthSecretRef
  16711. </a>
  16712. </em>
  16713. </td>
  16714. <td>
  16715. <em>(Optional)</em>
  16716. </td>
  16717. </tr>
  16718. </tbody>
  16719. </table>
  16720. <h3 id="external-secrets.io/v1beta1.CSMAuthSecretRef">CSMAuthSecretRef
  16721. </h3>
  16722. <p>
  16723. (<em>Appears on:</em>
  16724. <a href="#external-secrets.io/v1beta1.CSMAuth">CSMAuth</a>)
  16725. </p>
  16726. <p>
  16727. <p>CSMAuthSecretRef holds secret references for Cloud.ru credentials.</p>
  16728. </p>
  16729. <table>
  16730. <thead>
  16731. <tr>
  16732. <th>Field</th>
  16733. <th>Description</th>
  16734. </tr>
  16735. </thead>
  16736. <tbody>
  16737. <tr>
  16738. <td>
  16739. <code>accessKeyIDSecretRef</code></br>
  16740. <em>
  16741. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16742. External Secrets meta/v1.SecretKeySelector
  16743. </a>
  16744. </em>
  16745. </td>
  16746. <td>
  16747. <p>The AccessKeyID is used for authentication</p>
  16748. </td>
  16749. </tr>
  16750. <tr>
  16751. <td>
  16752. <code>accessKeySecretSecretRef</code></br>
  16753. <em>
  16754. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16755. External Secrets meta/v1.SecretKeySelector
  16756. </a>
  16757. </em>
  16758. </td>
  16759. <td>
  16760. <p>The AccessKeySecret is used for authentication</p>
  16761. </td>
  16762. </tr>
  16763. </tbody>
  16764. </table>
  16765. <h3 id="external-secrets.io/v1beta1.CertAuth">CertAuth
  16766. </h3>
  16767. <p>
  16768. (<em>Appears on:</em>
  16769. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  16770. </p>
  16771. <p>
  16772. <p>CertAuth defines certificate-based authentication for the Kubernetes provider.</p>
  16773. </p>
  16774. <table>
  16775. <thead>
  16776. <tr>
  16777. <th>Field</th>
  16778. <th>Description</th>
  16779. </tr>
  16780. </thead>
  16781. <tbody>
  16782. <tr>
  16783. <td>
  16784. <code>clientCert</code></br>
  16785. <em>
  16786. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16787. External Secrets meta/v1.SecretKeySelector
  16788. </a>
  16789. </em>
  16790. </td>
  16791. <td>
  16792. </td>
  16793. </tr>
  16794. <tr>
  16795. <td>
  16796. <code>clientKey</code></br>
  16797. <em>
  16798. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16799. External Secrets meta/v1.SecretKeySelector
  16800. </a>
  16801. </em>
  16802. </td>
  16803. <td>
  16804. </td>
  16805. </tr>
  16806. </tbody>
  16807. </table>
  16808. <h3 id="external-secrets.io/v1beta1.ChefAuth">ChefAuth
  16809. </h3>
  16810. <p>
  16811. (<em>Appears on:</em>
  16812. <a href="#external-secrets.io/v1beta1.ChefProvider">ChefProvider</a>)
  16813. </p>
  16814. <p>
  16815. <p>ChefAuth contains a secretRef for credentials.</p>
  16816. </p>
  16817. <table>
  16818. <thead>
  16819. <tr>
  16820. <th>Field</th>
  16821. <th>Description</th>
  16822. </tr>
  16823. </thead>
  16824. <tbody>
  16825. <tr>
  16826. <td>
  16827. <code>secretRef</code></br>
  16828. <em>
  16829. <a href="#external-secrets.io/v1beta1.ChefAuthSecretRef">
  16830. ChefAuthSecretRef
  16831. </a>
  16832. </em>
  16833. </td>
  16834. <td>
  16835. </td>
  16836. </tr>
  16837. </tbody>
  16838. </table>
  16839. <h3 id="external-secrets.io/v1beta1.ChefAuthSecretRef">ChefAuthSecretRef
  16840. </h3>
  16841. <p>
  16842. (<em>Appears on:</em>
  16843. <a href="#external-secrets.io/v1beta1.ChefAuth">ChefAuth</a>)
  16844. </p>
  16845. <p>
  16846. <p>ChefAuthSecretRef holds secret references for chef server login credentials.</p>
  16847. </p>
  16848. <table>
  16849. <thead>
  16850. <tr>
  16851. <th>Field</th>
  16852. <th>Description</th>
  16853. </tr>
  16854. </thead>
  16855. <tbody>
  16856. <tr>
  16857. <td>
  16858. <code>privateKeySecretRef</code></br>
  16859. <em>
  16860. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  16861. External Secrets meta/v1.SecretKeySelector
  16862. </a>
  16863. </em>
  16864. </td>
  16865. <td>
  16866. <p>SecretKey is the Signing Key in PEM format, used for authentication.</p>
  16867. </td>
  16868. </tr>
  16869. </tbody>
  16870. </table>
  16871. <h3 id="external-secrets.io/v1beta1.ChefProvider">ChefProvider
  16872. </h3>
  16873. <p>
  16874. (<em>Appears on:</em>
  16875. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16876. </p>
  16877. <p>
  16878. <p>ChefProvider configures a store to sync secrets using basic chef server connection credentials.</p>
  16879. </p>
  16880. <table>
  16881. <thead>
  16882. <tr>
  16883. <th>Field</th>
  16884. <th>Description</th>
  16885. </tr>
  16886. </thead>
  16887. <tbody>
  16888. <tr>
  16889. <td>
  16890. <code>auth</code></br>
  16891. <em>
  16892. <a href="#external-secrets.io/v1beta1.ChefAuth">
  16893. ChefAuth
  16894. </a>
  16895. </em>
  16896. </td>
  16897. <td>
  16898. <p>Auth defines the information necessary to authenticate against chef Server</p>
  16899. </td>
  16900. </tr>
  16901. <tr>
  16902. <td>
  16903. <code>username</code></br>
  16904. <em>
  16905. string
  16906. </em>
  16907. </td>
  16908. <td>
  16909. <p>UserName should be the user ID on the chef server</p>
  16910. </td>
  16911. </tr>
  16912. <tr>
  16913. <td>
  16914. <code>serverUrl</code></br>
  16915. <em>
  16916. string
  16917. </em>
  16918. </td>
  16919. <td>
  16920. <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>
  16921. </td>
  16922. </tr>
  16923. </tbody>
  16924. </table>
  16925. <h3 id="external-secrets.io/v1beta1.CloudruSMProvider">CloudruSMProvider
  16926. </h3>
  16927. <p>
  16928. (<em>Appears on:</em>
  16929. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  16930. </p>
  16931. <p>
  16932. <p>CloudruSMProvider configures a store to sync secrets using the Cloud.ru Secret Manager provider.</p>
  16933. </p>
  16934. <table>
  16935. <thead>
  16936. <tr>
  16937. <th>Field</th>
  16938. <th>Description</th>
  16939. </tr>
  16940. </thead>
  16941. <tbody>
  16942. <tr>
  16943. <td>
  16944. <code>auth</code></br>
  16945. <em>
  16946. <a href="#external-secrets.io/v1beta1.CSMAuth">
  16947. CSMAuth
  16948. </a>
  16949. </em>
  16950. </td>
  16951. <td>
  16952. </td>
  16953. </tr>
  16954. <tr>
  16955. <td>
  16956. <code>projectID</code></br>
  16957. <em>
  16958. string
  16959. </em>
  16960. </td>
  16961. <td>
  16962. <p>ProjectID is the project, which the secrets are stored in.</p>
  16963. </td>
  16964. </tr>
  16965. </tbody>
  16966. </table>
  16967. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret
  16968. </h3>
  16969. <p>
  16970. <p>ClusterExternalSecret is the schema for the clusterexternalsecrets API.</p>
  16971. </p>
  16972. <table>
  16973. <thead>
  16974. <tr>
  16975. <th>Field</th>
  16976. <th>Description</th>
  16977. </tr>
  16978. </thead>
  16979. <tbody>
  16980. <tr>
  16981. <td>
  16982. <code>metadata</code></br>
  16983. <em>
  16984. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  16985. Kubernetes meta/v1.ObjectMeta
  16986. </a>
  16987. </em>
  16988. </td>
  16989. <td>
  16990. Refer to the Kubernetes API documentation for the fields of the
  16991. <code>metadata</code> field.
  16992. </td>
  16993. </tr>
  16994. <tr>
  16995. <td>
  16996. <code>spec</code></br>
  16997. <em>
  16998. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">
  16999. ClusterExternalSecretSpec
  17000. </a>
  17001. </em>
  17002. </td>
  17003. <td>
  17004. <br/>
  17005. <br/>
  17006. <table>
  17007. <tr>
  17008. <td>
  17009. <code>externalSecretSpec</code></br>
  17010. <em>
  17011. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  17012. ExternalSecretSpec
  17013. </a>
  17014. </em>
  17015. </td>
  17016. <td>
  17017. <p>The spec for the ExternalSecrets to be created</p>
  17018. </td>
  17019. </tr>
  17020. <tr>
  17021. <td>
  17022. <code>externalSecretName</code></br>
  17023. <em>
  17024. string
  17025. </em>
  17026. </td>
  17027. <td>
  17028. <em>(Optional)</em>
  17029. <p>The name of the external secrets to be created.
  17030. Defaults to the name of the ClusterExternalSecret</p>
  17031. </td>
  17032. </tr>
  17033. <tr>
  17034. <td>
  17035. <code>externalSecretMetadata</code></br>
  17036. <em>
  17037. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  17038. ExternalSecretMetadata
  17039. </a>
  17040. </em>
  17041. </td>
  17042. <td>
  17043. <em>(Optional)</em>
  17044. <p>The metadata of the external secrets to be created</p>
  17045. </td>
  17046. </tr>
  17047. <tr>
  17048. <td>
  17049. <code>namespaceSelector</code></br>
  17050. <em>
  17051. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  17052. Kubernetes meta/v1.LabelSelector
  17053. </a>
  17054. </em>
  17055. </td>
  17056. <td>
  17057. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  17058. </td>
  17059. </tr>
  17060. <tr>
  17061. <td>
  17062. <code>namespaceSelectors</code></br>
  17063. <em>
  17064. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  17065. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  17066. </a>
  17067. </em>
  17068. </td>
  17069. <td>
  17070. <em>(Optional)</em>
  17071. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  17072. </td>
  17073. </tr>
  17074. <tr>
  17075. <td>
  17076. <code>namespaces</code></br>
  17077. <em>
  17078. []string
  17079. </em>
  17080. </td>
  17081. <td>
  17082. <em>(Optional)</em>
  17083. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  17084. <p>Deprecated: Use NamespaceSelectors instead.</p>
  17085. </td>
  17086. </tr>
  17087. <tr>
  17088. <td>
  17089. <code>refreshTime</code></br>
  17090. <em>
  17091. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  17092. Kubernetes meta/v1.Duration
  17093. </a>
  17094. </em>
  17095. </td>
  17096. <td>
  17097. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  17098. </td>
  17099. </tr>
  17100. </table>
  17101. </td>
  17102. </tr>
  17103. <tr>
  17104. <td>
  17105. <code>status</code></br>
  17106. <em>
  17107. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">
  17108. ClusterExternalSecretStatus
  17109. </a>
  17110. </em>
  17111. </td>
  17112. <td>
  17113. </td>
  17114. </tr>
  17115. </tbody>
  17116. </table>
  17117. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretConditionType">ClusterExternalSecretConditionType
  17118. (<code>string</code> alias)</p></h3>
  17119. <p>
  17120. (<em>Appears on:</em>
  17121. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition</a>)
  17122. </p>
  17123. <p>
  17124. <p>ClusterExternalSecretConditionType indicates the condition of the ClusterExternalSecret.</p>
  17125. </p>
  17126. <table>
  17127. <thead>
  17128. <tr>
  17129. <th>Value</th>
  17130. <th>Description</th>
  17131. </tr>
  17132. </thead>
  17133. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  17134. <td><p>ClusterExternalSecretReady indicates the ClusterExternalSecret resource is ready.</p>
  17135. </td>
  17136. </tr></tbody>
  17137. </table>
  17138. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">ClusterExternalSecretNamespaceFailure
  17139. </h3>
  17140. <p>
  17141. (<em>Appears on:</em>
  17142. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  17143. </p>
  17144. <p>
  17145. <p>ClusterExternalSecretNamespaceFailure represents a failed namespace deployment and it&rsquo;s reason.</p>
  17146. </p>
  17147. <table>
  17148. <thead>
  17149. <tr>
  17150. <th>Field</th>
  17151. <th>Description</th>
  17152. </tr>
  17153. </thead>
  17154. <tbody>
  17155. <tr>
  17156. <td>
  17157. <code>namespace</code></br>
  17158. <em>
  17159. string
  17160. </em>
  17161. </td>
  17162. <td>
  17163. <p>Namespace is the namespace that failed when trying to apply an ExternalSecret</p>
  17164. </td>
  17165. </tr>
  17166. <tr>
  17167. <td>
  17168. <code>reason</code></br>
  17169. <em>
  17170. string
  17171. </em>
  17172. </td>
  17173. <td>
  17174. <em>(Optional)</em>
  17175. <p>Reason is why the ExternalSecret failed to apply to the namespace</p>
  17176. </td>
  17177. </tr>
  17178. </tbody>
  17179. </table>
  17180. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec
  17181. </h3>
  17182. <p>
  17183. (<em>Appears on:</em>
  17184. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  17185. </p>
  17186. <p>
  17187. <p>ClusterExternalSecretSpec defines the desired state of ClusterExternalSecret.</p>
  17188. </p>
  17189. <table>
  17190. <thead>
  17191. <tr>
  17192. <th>Field</th>
  17193. <th>Description</th>
  17194. </tr>
  17195. </thead>
  17196. <tbody>
  17197. <tr>
  17198. <td>
  17199. <code>externalSecretSpec</code></br>
  17200. <em>
  17201. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  17202. ExternalSecretSpec
  17203. </a>
  17204. </em>
  17205. </td>
  17206. <td>
  17207. <p>The spec for the ExternalSecrets to be created</p>
  17208. </td>
  17209. </tr>
  17210. <tr>
  17211. <td>
  17212. <code>externalSecretName</code></br>
  17213. <em>
  17214. string
  17215. </em>
  17216. </td>
  17217. <td>
  17218. <em>(Optional)</em>
  17219. <p>The name of the external secrets to be created.
  17220. Defaults to the name of the ClusterExternalSecret</p>
  17221. </td>
  17222. </tr>
  17223. <tr>
  17224. <td>
  17225. <code>externalSecretMetadata</code></br>
  17226. <em>
  17227. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadata">
  17228. ExternalSecretMetadata
  17229. </a>
  17230. </em>
  17231. </td>
  17232. <td>
  17233. <em>(Optional)</em>
  17234. <p>The metadata of the external secrets to be created</p>
  17235. </td>
  17236. </tr>
  17237. <tr>
  17238. <td>
  17239. <code>namespaceSelector</code></br>
  17240. <em>
  17241. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  17242. Kubernetes meta/v1.LabelSelector
  17243. </a>
  17244. </em>
  17245. </td>
  17246. <td>
  17247. <p>The labels to select by to find the Namespaces to create the ExternalSecrets in</p>
  17248. </td>
  17249. </tr>
  17250. <tr>
  17251. <td>
  17252. <code>namespaceSelectors</code></br>
  17253. <em>
  17254. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#*k8s.io/apimachinery/pkg/apis/meta/v1.labelselector--">
  17255. []*k8s.io/apimachinery/pkg/apis/meta/v1.LabelSelector
  17256. </a>
  17257. </em>
  17258. </td>
  17259. <td>
  17260. <em>(Optional)</em>
  17261. <p>A list of labels to select by to find the Namespaces to create the ExternalSecrets in. The selectors are ORed.</p>
  17262. </td>
  17263. </tr>
  17264. <tr>
  17265. <td>
  17266. <code>namespaces</code></br>
  17267. <em>
  17268. []string
  17269. </em>
  17270. </td>
  17271. <td>
  17272. <em>(Optional)</em>
  17273. <p>Choose namespaces by name. This field is ORed with anything that NamespaceSelectors ends up choosing.</p>
  17274. <p>Deprecated: Use NamespaceSelectors instead.</p>
  17275. </td>
  17276. </tr>
  17277. <tr>
  17278. <td>
  17279. <code>refreshTime</code></br>
  17280. <em>
  17281. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  17282. Kubernetes meta/v1.Duration
  17283. </a>
  17284. </em>
  17285. </td>
  17286. <td>
  17287. <p>The time in which the controller should reconcile its objects and recheck namespaces for labels.</p>
  17288. </td>
  17289. </tr>
  17290. </tbody>
  17291. </table>
  17292. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus
  17293. </h3>
  17294. <p>
  17295. (<em>Appears on:</em>
  17296. <a href="#external-secrets.io/v1beta1.ClusterExternalSecret">ClusterExternalSecret</a>)
  17297. </p>
  17298. <p>
  17299. <p>ClusterExternalSecretStatus defines the observed state of ClusterExternalSecret.</p>
  17300. </p>
  17301. <table>
  17302. <thead>
  17303. <tr>
  17304. <th>Field</th>
  17305. <th>Description</th>
  17306. </tr>
  17307. </thead>
  17308. <tbody>
  17309. <tr>
  17310. <td>
  17311. <code>externalSecretName</code></br>
  17312. <em>
  17313. string
  17314. </em>
  17315. </td>
  17316. <td>
  17317. <p>ExternalSecretName is the name of the ExternalSecrets created by the ClusterExternalSecret</p>
  17318. </td>
  17319. </tr>
  17320. <tr>
  17321. <td>
  17322. <code>failedNamespaces</code></br>
  17323. <em>
  17324. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretNamespaceFailure">
  17325. []ClusterExternalSecretNamespaceFailure
  17326. </a>
  17327. </em>
  17328. </td>
  17329. <td>
  17330. <em>(Optional)</em>
  17331. <p>Failed namespaces are the namespaces that failed to apply an ExternalSecret</p>
  17332. </td>
  17333. </tr>
  17334. <tr>
  17335. <td>
  17336. <code>provisionedNamespaces</code></br>
  17337. <em>
  17338. []string
  17339. </em>
  17340. </td>
  17341. <td>
  17342. <em>(Optional)</em>
  17343. <p>ProvisionedNamespaces are the namespaces where the ClusterExternalSecret has secrets</p>
  17344. </td>
  17345. </tr>
  17346. <tr>
  17347. <td>
  17348. <code>conditions</code></br>
  17349. <em>
  17350. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">
  17351. []ClusterExternalSecretStatusCondition
  17352. </a>
  17353. </em>
  17354. </td>
  17355. <td>
  17356. <em>(Optional)</em>
  17357. </td>
  17358. </tr>
  17359. </tbody>
  17360. </table>
  17361. <h3 id="external-secrets.io/v1beta1.ClusterExternalSecretStatusCondition">ClusterExternalSecretStatusCondition
  17362. </h3>
  17363. <p>
  17364. (<em>Appears on:</em>
  17365. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretStatus">ClusterExternalSecretStatus</a>)
  17366. </p>
  17367. <p>
  17368. <p>ClusterExternalSecretStatusCondition indicates the status of the ClusterExternalSecret.</p>
  17369. </p>
  17370. <table>
  17371. <thead>
  17372. <tr>
  17373. <th>Field</th>
  17374. <th>Description</th>
  17375. </tr>
  17376. </thead>
  17377. <tbody>
  17378. <tr>
  17379. <td>
  17380. <code>type</code></br>
  17381. <em>
  17382. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretConditionType">
  17383. ClusterExternalSecretConditionType
  17384. </a>
  17385. </em>
  17386. </td>
  17387. <td>
  17388. </td>
  17389. </tr>
  17390. <tr>
  17391. <td>
  17392. <code>status</code></br>
  17393. <em>
  17394. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  17395. Kubernetes core/v1.ConditionStatus
  17396. </a>
  17397. </em>
  17398. </td>
  17399. <td>
  17400. </td>
  17401. </tr>
  17402. <tr>
  17403. <td>
  17404. <code>message</code></br>
  17405. <em>
  17406. string
  17407. </em>
  17408. </td>
  17409. <td>
  17410. <em>(Optional)</em>
  17411. </td>
  17412. </tr>
  17413. </tbody>
  17414. </table>
  17415. <h3 id="external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore
  17416. </h3>
  17417. <p>
  17418. <p>ClusterSecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  17419. </p>
  17420. <table>
  17421. <thead>
  17422. <tr>
  17423. <th>Field</th>
  17424. <th>Description</th>
  17425. </tr>
  17426. </thead>
  17427. <tbody>
  17428. <tr>
  17429. <td>
  17430. <code>metadata</code></br>
  17431. <em>
  17432. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  17433. Kubernetes meta/v1.ObjectMeta
  17434. </a>
  17435. </em>
  17436. </td>
  17437. <td>
  17438. Refer to the Kubernetes API documentation for the fields of the
  17439. <code>metadata</code> field.
  17440. </td>
  17441. </tr>
  17442. <tr>
  17443. <td>
  17444. <code>spec</code></br>
  17445. <em>
  17446. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  17447. SecretStoreSpec
  17448. </a>
  17449. </em>
  17450. </td>
  17451. <td>
  17452. <br/>
  17453. <br/>
  17454. <table>
  17455. <tr>
  17456. <td>
  17457. <code>controller</code></br>
  17458. <em>
  17459. string
  17460. </em>
  17461. </td>
  17462. <td>
  17463. <em>(Optional)</em>
  17464. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  17465. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  17466. </td>
  17467. </tr>
  17468. <tr>
  17469. <td>
  17470. <code>provider</code></br>
  17471. <em>
  17472. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  17473. SecretStoreProvider
  17474. </a>
  17475. </em>
  17476. </td>
  17477. <td>
  17478. <p>Used to configure the provider. Only one provider may be set</p>
  17479. </td>
  17480. </tr>
  17481. <tr>
  17482. <td>
  17483. <code>retrySettings</code></br>
  17484. <em>
  17485. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  17486. SecretStoreRetrySettings
  17487. </a>
  17488. </em>
  17489. </td>
  17490. <td>
  17491. <em>(Optional)</em>
  17492. <p>Used to configure HTTP retries on failures.</p>
  17493. </td>
  17494. </tr>
  17495. <tr>
  17496. <td>
  17497. <code>refreshInterval</code></br>
  17498. <em>
  17499. int
  17500. </em>
  17501. </td>
  17502. <td>
  17503. <em>(Optional)</em>
  17504. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  17505. </td>
  17506. </tr>
  17507. <tr>
  17508. <td>
  17509. <code>conditions</code></br>
  17510. <em>
  17511. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  17512. []ClusterSecretStoreCondition
  17513. </a>
  17514. </em>
  17515. </td>
  17516. <td>
  17517. <em>(Optional)</em>
  17518. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  17519. </td>
  17520. </tr>
  17521. </table>
  17522. </td>
  17523. </tr>
  17524. <tr>
  17525. <td>
  17526. <code>status</code></br>
  17527. <em>
  17528. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  17529. SecretStoreStatus
  17530. </a>
  17531. </em>
  17532. </td>
  17533. <td>
  17534. </td>
  17535. </tr>
  17536. </tbody>
  17537. </table>
  17538. <h3 id="external-secrets.io/v1beta1.ClusterSecretStoreCondition">ClusterSecretStoreCondition
  17539. </h3>
  17540. <p>
  17541. (<em>Appears on:</em>
  17542. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  17543. </p>
  17544. <p>
  17545. <p>ClusterSecretStoreCondition describes a condition by which to choose namespaces to process ExternalSecrets in
  17546. for a ClusterSecretStore instance.</p>
  17547. </p>
  17548. <table>
  17549. <thead>
  17550. <tr>
  17551. <th>Field</th>
  17552. <th>Description</th>
  17553. </tr>
  17554. </thead>
  17555. <tbody>
  17556. <tr>
  17557. <td>
  17558. <code>namespaceSelector</code></br>
  17559. <em>
  17560. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
  17561. Kubernetes meta/v1.LabelSelector
  17562. </a>
  17563. </em>
  17564. </td>
  17565. <td>
  17566. <em>(Optional)</em>
  17567. <p>Choose namespace using a labelSelector</p>
  17568. </td>
  17569. </tr>
  17570. <tr>
  17571. <td>
  17572. <code>namespaces</code></br>
  17573. <em>
  17574. []string
  17575. </em>
  17576. </td>
  17577. <td>
  17578. <em>(Optional)</em>
  17579. <p>Choose namespaces by name</p>
  17580. </td>
  17581. </tr>
  17582. <tr>
  17583. <td>
  17584. <code>namespaceRegexes</code></br>
  17585. <em>
  17586. []string
  17587. </em>
  17588. </td>
  17589. <td>
  17590. <em>(Optional)</em>
  17591. <p>Choose namespaces by using regex matching</p>
  17592. </td>
  17593. </tr>
  17594. </tbody>
  17595. </table>
  17596. <h3 id="external-secrets.io/v1beta1.ConjurAPIKey">ConjurAPIKey
  17597. </h3>
  17598. <p>
  17599. (<em>Appears on:</em>
  17600. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  17601. </p>
  17602. <p>
  17603. <p>ConjurAPIKey defines authentication using a Conjur API key.</p>
  17604. </p>
  17605. <table>
  17606. <thead>
  17607. <tr>
  17608. <th>Field</th>
  17609. <th>Description</th>
  17610. </tr>
  17611. </thead>
  17612. <tbody>
  17613. <tr>
  17614. <td>
  17615. <code>account</code></br>
  17616. <em>
  17617. string
  17618. </em>
  17619. </td>
  17620. <td>
  17621. <p>Account is the Conjur organization account name.</p>
  17622. </td>
  17623. </tr>
  17624. <tr>
  17625. <td>
  17626. <code>userRef</code></br>
  17627. <em>
  17628. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17629. External Secrets meta/v1.SecretKeySelector
  17630. </a>
  17631. </em>
  17632. </td>
  17633. <td>
  17634. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur username
  17635. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  17636. </td>
  17637. </tr>
  17638. <tr>
  17639. <td>
  17640. <code>apiKeyRef</code></br>
  17641. <em>
  17642. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17643. External Secrets meta/v1.SecretKeySelector
  17644. </a>
  17645. </em>
  17646. </td>
  17647. <td>
  17648. <p>A reference to a specific &lsquo;key&rsquo; containing the Conjur API key
  17649. within a Secret resource. In some instances, <code>key</code> is a required field.</p>
  17650. </td>
  17651. </tr>
  17652. </tbody>
  17653. </table>
  17654. <h3 id="external-secrets.io/v1beta1.ConjurAuth">ConjurAuth
  17655. </h3>
  17656. <p>
  17657. (<em>Appears on:</em>
  17658. <a href="#external-secrets.io/v1beta1.ConjurProvider">ConjurProvider</a>)
  17659. </p>
  17660. <p>
  17661. <p>ConjurAuth defines the methods of authentication with Conjur.</p>
  17662. </p>
  17663. <table>
  17664. <thead>
  17665. <tr>
  17666. <th>Field</th>
  17667. <th>Description</th>
  17668. </tr>
  17669. </thead>
  17670. <tbody>
  17671. <tr>
  17672. <td>
  17673. <code>apikey</code></br>
  17674. <em>
  17675. <a href="#external-secrets.io/v1beta1.ConjurAPIKey">
  17676. ConjurAPIKey
  17677. </a>
  17678. </em>
  17679. </td>
  17680. <td>
  17681. <em>(Optional)</em>
  17682. <p>Authenticates with Conjur using an API key.</p>
  17683. </td>
  17684. </tr>
  17685. <tr>
  17686. <td>
  17687. <code>jwt</code></br>
  17688. <em>
  17689. <a href="#external-secrets.io/v1beta1.ConjurJWT">
  17690. ConjurJWT
  17691. </a>
  17692. </em>
  17693. </td>
  17694. <td>
  17695. <em>(Optional)</em>
  17696. <p>Jwt enables JWT authentication using Kubernetes service account tokens.</p>
  17697. </td>
  17698. </tr>
  17699. </tbody>
  17700. </table>
  17701. <h3 id="external-secrets.io/v1beta1.ConjurJWT">ConjurJWT
  17702. </h3>
  17703. <p>
  17704. (<em>Appears on:</em>
  17705. <a href="#external-secrets.io/v1beta1.ConjurAuth">ConjurAuth</a>)
  17706. </p>
  17707. <p>
  17708. <p>ConjurJWT defines authentication using a JWT service account token.</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>account</code></br>
  17721. <em>
  17722. string
  17723. </em>
  17724. </td>
  17725. <td>
  17726. <p>Account is the Conjur organization account name.</p>
  17727. </td>
  17728. </tr>
  17729. <tr>
  17730. <td>
  17731. <code>serviceID</code></br>
  17732. <em>
  17733. string
  17734. </em>
  17735. </td>
  17736. <td>
  17737. <p>The conjur authn jwt webservice id</p>
  17738. </td>
  17739. </tr>
  17740. <tr>
  17741. <td>
  17742. <code>hostId</code></br>
  17743. <em>
  17744. string
  17745. </em>
  17746. </td>
  17747. <td>
  17748. <em>(Optional)</em>
  17749. <p>Optional HostID for JWT authentication. This may be used depending
  17750. on how the Conjur JWT authenticator policy is configured.</p>
  17751. </td>
  17752. </tr>
  17753. <tr>
  17754. <td>
  17755. <code>secretRef</code></br>
  17756. <em>
  17757. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17758. External Secrets meta/v1.SecretKeySelector
  17759. </a>
  17760. </em>
  17761. </td>
  17762. <td>
  17763. <em>(Optional)</em>
  17764. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  17765. authenticate with Conjur using the JWT authentication method.</p>
  17766. </td>
  17767. </tr>
  17768. <tr>
  17769. <td>
  17770. <code>serviceAccountRef</code></br>
  17771. <em>
  17772. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  17773. External Secrets meta/v1.ServiceAccountSelector
  17774. </a>
  17775. </em>
  17776. </td>
  17777. <td>
  17778. <em>(Optional)</em>
  17779. <p>Optional ServiceAccountRef specifies the Kubernetes service account for which to request
  17780. a token for with the <code>TokenRequest</code> API.</p>
  17781. </td>
  17782. </tr>
  17783. </tbody>
  17784. </table>
  17785. <h3 id="external-secrets.io/v1beta1.ConjurProvider">ConjurProvider
  17786. </h3>
  17787. <p>
  17788. (<em>Appears on:</em>
  17789. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17790. </p>
  17791. <p>
  17792. <p>ConjurProvider defines configuration for the CyberArk Conjur provider.</p>
  17793. </p>
  17794. <table>
  17795. <thead>
  17796. <tr>
  17797. <th>Field</th>
  17798. <th>Description</th>
  17799. </tr>
  17800. </thead>
  17801. <tbody>
  17802. <tr>
  17803. <td>
  17804. <code>url</code></br>
  17805. <em>
  17806. string
  17807. </em>
  17808. </td>
  17809. <td>
  17810. <p>URL is the endpoint of the Conjur instance.</p>
  17811. </td>
  17812. </tr>
  17813. <tr>
  17814. <td>
  17815. <code>caBundle</code></br>
  17816. <em>
  17817. string
  17818. </em>
  17819. </td>
  17820. <td>
  17821. <em>(Optional)</em>
  17822. <p>CABundle is a PEM encoded CA bundle that will be used to validate the Conjur server certificate.</p>
  17823. </td>
  17824. </tr>
  17825. <tr>
  17826. <td>
  17827. <code>caProvider</code></br>
  17828. <em>
  17829. <a href="#external-secrets.io/v1beta1.CAProvider">
  17830. CAProvider
  17831. </a>
  17832. </em>
  17833. </td>
  17834. <td>
  17835. <em>(Optional)</em>
  17836. <p>Used to provide custom certificate authority (CA) certificates
  17837. for a secret store. The CAProvider points to a Secret or ConfigMap resource
  17838. that contains a PEM-encoded certificate.</p>
  17839. </td>
  17840. </tr>
  17841. <tr>
  17842. <td>
  17843. <code>auth</code></br>
  17844. <em>
  17845. <a href="#external-secrets.io/v1beta1.ConjurAuth">
  17846. ConjurAuth
  17847. </a>
  17848. </em>
  17849. </td>
  17850. <td>
  17851. <p>Defines authentication settings for connecting to Conjur.</p>
  17852. </td>
  17853. </tr>
  17854. </tbody>
  17855. </table>
  17856. <h3 id="external-secrets.io/v1beta1.DelineaProvider">DelineaProvider
  17857. </h3>
  17858. <p>
  17859. (<em>Appears on:</em>
  17860. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  17861. </p>
  17862. <p>
  17863. <p>DelineaProvider defines configuration for the Delinea DevOps Secrets Vault provider.
  17864. 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>
  17865. </p>
  17866. <table>
  17867. <thead>
  17868. <tr>
  17869. <th>Field</th>
  17870. <th>Description</th>
  17871. </tr>
  17872. </thead>
  17873. <tbody>
  17874. <tr>
  17875. <td>
  17876. <code>clientId</code></br>
  17877. <em>
  17878. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  17879. DelineaProviderSecretRef
  17880. </a>
  17881. </em>
  17882. </td>
  17883. <td>
  17884. <p>ClientID is the non-secret part of the credential.</p>
  17885. </td>
  17886. </tr>
  17887. <tr>
  17888. <td>
  17889. <code>clientSecret</code></br>
  17890. <em>
  17891. <a href="#external-secrets.io/v1beta1.DelineaProviderSecretRef">
  17892. DelineaProviderSecretRef
  17893. </a>
  17894. </em>
  17895. </td>
  17896. <td>
  17897. <p>ClientSecret is the secret part of the credential.</p>
  17898. </td>
  17899. </tr>
  17900. <tr>
  17901. <td>
  17902. <code>tenant</code></br>
  17903. <em>
  17904. string
  17905. </em>
  17906. </td>
  17907. <td>
  17908. <p>Tenant is the chosen hostname / site name.</p>
  17909. </td>
  17910. </tr>
  17911. <tr>
  17912. <td>
  17913. <code>urlTemplate</code></br>
  17914. <em>
  17915. string
  17916. </em>
  17917. </td>
  17918. <td>
  17919. <em>(Optional)</em>
  17920. <p>URLTemplate
  17921. If unset, defaults to &ldquo;https://%s.secretsvaultcloud.%s/v1/%s%s&rdquo;.</p>
  17922. </td>
  17923. </tr>
  17924. <tr>
  17925. <td>
  17926. <code>tld</code></br>
  17927. <em>
  17928. string
  17929. </em>
  17930. </td>
  17931. <td>
  17932. <em>(Optional)</em>
  17933. <p>TLD is based on the server location that was chosen during provisioning.
  17934. If unset, defaults to &ldquo;com&rdquo;.</p>
  17935. </td>
  17936. </tr>
  17937. </tbody>
  17938. </table>
  17939. <h3 id="external-secrets.io/v1beta1.DelineaProviderSecretRef">DelineaProviderSecretRef
  17940. </h3>
  17941. <p>
  17942. (<em>Appears on:</em>
  17943. <a href="#external-secrets.io/v1beta1.DelineaProvider">DelineaProvider</a>)
  17944. </p>
  17945. <p>
  17946. <p>DelineaProviderSecretRef defines a reference to a secret containing credentials for the Delinea provider.</p>
  17947. </p>
  17948. <table>
  17949. <thead>
  17950. <tr>
  17951. <th>Field</th>
  17952. <th>Description</th>
  17953. </tr>
  17954. </thead>
  17955. <tbody>
  17956. <tr>
  17957. <td>
  17958. <code>value</code></br>
  17959. <em>
  17960. string
  17961. </em>
  17962. </td>
  17963. <td>
  17964. <em>(Optional)</em>
  17965. <p>Value can be specified directly to set a value without using a secret.</p>
  17966. </td>
  17967. </tr>
  17968. <tr>
  17969. <td>
  17970. <code>secretRef</code></br>
  17971. <em>
  17972. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  17973. External Secrets meta/v1.SecretKeySelector
  17974. </a>
  17975. </em>
  17976. </td>
  17977. <td>
  17978. <em>(Optional)</em>
  17979. <p>SecretRef references a key in a secret that will be used as value.</p>
  17980. </td>
  17981. </tr>
  17982. </tbody>
  17983. </table>
  17984. <h3 id="external-secrets.io/v1beta1.Device42Auth">Device42Auth
  17985. </h3>
  17986. <p>
  17987. (<em>Appears on:</em>
  17988. <a href="#external-secrets.io/v1beta1.Device42Provider">Device42Provider</a>)
  17989. </p>
  17990. <p>
  17991. <p>Device42Auth defines the authentication method for the Device42 provider.</p>
  17992. </p>
  17993. <table>
  17994. <thead>
  17995. <tr>
  17996. <th>Field</th>
  17997. <th>Description</th>
  17998. </tr>
  17999. </thead>
  18000. <tbody>
  18001. <tr>
  18002. <td>
  18003. <code>secretRef</code></br>
  18004. <em>
  18005. <a href="#external-secrets.io/v1beta1.Device42SecretRef">
  18006. Device42SecretRef
  18007. </a>
  18008. </em>
  18009. </td>
  18010. <td>
  18011. </td>
  18012. </tr>
  18013. </tbody>
  18014. </table>
  18015. <h3 id="external-secrets.io/v1beta1.Device42Provider">Device42Provider
  18016. </h3>
  18017. <p>
  18018. (<em>Appears on:</em>
  18019. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18020. </p>
  18021. <p>
  18022. <p>Device42Provider configures a store to sync secrets with a Device42 instance.</p>
  18023. </p>
  18024. <table>
  18025. <thead>
  18026. <tr>
  18027. <th>Field</th>
  18028. <th>Description</th>
  18029. </tr>
  18030. </thead>
  18031. <tbody>
  18032. <tr>
  18033. <td>
  18034. <code>host</code></br>
  18035. <em>
  18036. string
  18037. </em>
  18038. </td>
  18039. <td>
  18040. <p>URL configures the Device42 instance URL.</p>
  18041. </td>
  18042. </tr>
  18043. <tr>
  18044. <td>
  18045. <code>auth</code></br>
  18046. <em>
  18047. <a href="#external-secrets.io/v1beta1.Device42Auth">
  18048. Device42Auth
  18049. </a>
  18050. </em>
  18051. </td>
  18052. <td>
  18053. <p>Auth configures how secret-manager authenticates with a Device42 instance.</p>
  18054. </td>
  18055. </tr>
  18056. </tbody>
  18057. </table>
  18058. <h3 id="external-secrets.io/v1beta1.Device42SecretRef">Device42SecretRef
  18059. </h3>
  18060. <p>
  18061. (<em>Appears on:</em>
  18062. <a href="#external-secrets.io/v1beta1.Device42Auth">Device42Auth</a>)
  18063. </p>
  18064. <p>
  18065. <p>Device42SecretRef defines a reference to a secret containing credentials for the Device42 provider.</p>
  18066. </p>
  18067. <table>
  18068. <thead>
  18069. <tr>
  18070. <th>Field</th>
  18071. <th>Description</th>
  18072. </tr>
  18073. </thead>
  18074. <tbody>
  18075. <tr>
  18076. <td>
  18077. <code>credentials</code></br>
  18078. <em>
  18079. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18080. External Secrets meta/v1.SecretKeySelector
  18081. </a>
  18082. </em>
  18083. </td>
  18084. <td>
  18085. <em>(Optional)</em>
  18086. <p>Username / Password is used for authentication.</p>
  18087. </td>
  18088. </tr>
  18089. </tbody>
  18090. </table>
  18091. <h3 id="external-secrets.io/v1beta1.DopplerAuth">DopplerAuth
  18092. </h3>
  18093. <p>
  18094. (<em>Appears on:</em>
  18095. <a href="#external-secrets.io/v1beta1.DopplerProvider">DopplerProvider</a>)
  18096. </p>
  18097. <p>
  18098. <p>DopplerAuth defines the authentication method for the Doppler provider.</p>
  18099. </p>
  18100. <table>
  18101. <thead>
  18102. <tr>
  18103. <th>Field</th>
  18104. <th>Description</th>
  18105. </tr>
  18106. </thead>
  18107. <tbody>
  18108. <tr>
  18109. <td>
  18110. <code>secretRef</code></br>
  18111. <em>
  18112. <a href="#external-secrets.io/v1beta1.DopplerAuthSecretRef">
  18113. DopplerAuthSecretRef
  18114. </a>
  18115. </em>
  18116. </td>
  18117. <td>
  18118. </td>
  18119. </tr>
  18120. </tbody>
  18121. </table>
  18122. <h3 id="external-secrets.io/v1beta1.DopplerAuthSecretRef">DopplerAuthSecretRef
  18123. </h3>
  18124. <p>
  18125. (<em>Appears on:</em>
  18126. <a href="#external-secrets.io/v1beta1.DopplerAuth">DopplerAuth</a>)
  18127. </p>
  18128. <p>
  18129. <p>DopplerAuthSecretRef defines a reference to a secret containing credentials for the Doppler provider.</p>
  18130. </p>
  18131. <table>
  18132. <thead>
  18133. <tr>
  18134. <th>Field</th>
  18135. <th>Description</th>
  18136. </tr>
  18137. </thead>
  18138. <tbody>
  18139. <tr>
  18140. <td>
  18141. <code>dopplerToken</code></br>
  18142. <em>
  18143. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  18144. External Secrets meta/v1.SecretKeySelector
  18145. </a>
  18146. </em>
  18147. </td>
  18148. <td>
  18149. <p>The DopplerToken is used for authentication.
  18150. See <a href="https://docs.doppler.com/reference/api#authentication">https://docs.doppler.com/reference/api#authentication</a> for auth token types.
  18151. The Key attribute defaults to dopplerToken if not specified.</p>
  18152. </td>
  18153. </tr>
  18154. </tbody>
  18155. </table>
  18156. <h3 id="external-secrets.io/v1beta1.DopplerProvider">DopplerProvider
  18157. </h3>
  18158. <p>
  18159. (<em>Appears on:</em>
  18160. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  18161. </p>
  18162. <p>
  18163. <p>DopplerProvider configures a store to sync secrets using the Doppler provider.
  18164. Project and Config are required if not using a Service Token.</p>
  18165. </p>
  18166. <table>
  18167. <thead>
  18168. <tr>
  18169. <th>Field</th>
  18170. <th>Description</th>
  18171. </tr>
  18172. </thead>
  18173. <tbody>
  18174. <tr>
  18175. <td>
  18176. <code>auth</code></br>
  18177. <em>
  18178. <a href="#external-secrets.io/v1beta1.DopplerAuth">
  18179. DopplerAuth
  18180. </a>
  18181. </em>
  18182. </td>
  18183. <td>
  18184. <p>Auth configures how the Operator authenticates with the Doppler API</p>
  18185. </td>
  18186. </tr>
  18187. <tr>
  18188. <td>
  18189. <code>project</code></br>
  18190. <em>
  18191. string
  18192. </em>
  18193. </td>
  18194. <td>
  18195. <em>(Optional)</em>
  18196. <p>Doppler project (required if not using a Service Token)</p>
  18197. </td>
  18198. </tr>
  18199. <tr>
  18200. <td>
  18201. <code>config</code></br>
  18202. <em>
  18203. string
  18204. </em>
  18205. </td>
  18206. <td>
  18207. <em>(Optional)</em>
  18208. <p>Doppler config (required if not using a Service Token)</p>
  18209. </td>
  18210. </tr>
  18211. <tr>
  18212. <td>
  18213. <code>nameTransformer</code></br>
  18214. <em>
  18215. string
  18216. </em>
  18217. </td>
  18218. <td>
  18219. <em>(Optional)</em>
  18220. <p>Environment variable compatible name transforms that change secret names to a different format</p>
  18221. </td>
  18222. </tr>
  18223. <tr>
  18224. <td>
  18225. <code>format</code></br>
  18226. <em>
  18227. string
  18228. </em>
  18229. </td>
  18230. <td>
  18231. <em>(Optional)</em>
  18232. <p>Format enables the downloading of secrets as a file (string)</p>
  18233. </td>
  18234. </tr>
  18235. </tbody>
  18236. </table>
  18237. <h3 id="external-secrets.io/v1beta1.ExternalSecret">ExternalSecret
  18238. </h3>
  18239. <p>
  18240. <p>ExternalSecret is the schema for the external-secrets API.</p>
  18241. </p>
  18242. <table>
  18243. <thead>
  18244. <tr>
  18245. <th>Field</th>
  18246. <th>Description</th>
  18247. </tr>
  18248. </thead>
  18249. <tbody>
  18250. <tr>
  18251. <td>
  18252. <code>metadata</code></br>
  18253. <em>
  18254. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  18255. Kubernetes meta/v1.ObjectMeta
  18256. </a>
  18257. </em>
  18258. </td>
  18259. <td>
  18260. Refer to the Kubernetes API documentation for the fields of the
  18261. <code>metadata</code> field.
  18262. </td>
  18263. </tr>
  18264. <tr>
  18265. <td>
  18266. <code>spec</code></br>
  18267. <em>
  18268. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">
  18269. ExternalSecretSpec
  18270. </a>
  18271. </em>
  18272. </td>
  18273. <td>
  18274. <br/>
  18275. <br/>
  18276. <table>
  18277. <tr>
  18278. <td>
  18279. <code>secretStoreRef</code></br>
  18280. <em>
  18281. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  18282. SecretStoreRef
  18283. </a>
  18284. </em>
  18285. </td>
  18286. <td>
  18287. <em>(Optional)</em>
  18288. </td>
  18289. </tr>
  18290. <tr>
  18291. <td>
  18292. <code>target</code></br>
  18293. <em>
  18294. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  18295. ExternalSecretTarget
  18296. </a>
  18297. </em>
  18298. </td>
  18299. <td>
  18300. <em>(Optional)</em>
  18301. </td>
  18302. </tr>
  18303. <tr>
  18304. <td>
  18305. <code>refreshPolicy</code></br>
  18306. <em>
  18307. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  18308. ExternalSecretRefreshPolicy
  18309. </a>
  18310. </em>
  18311. </td>
  18312. <td>
  18313. <em>(Optional)</em>
  18314. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  18315. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  18316. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  18317. No periodic updates occur if refreshInterval is 0.
  18318. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  18319. </td>
  18320. </tr>
  18321. <tr>
  18322. <td>
  18323. <code>refreshInterval</code></br>
  18324. <em>
  18325. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  18326. Kubernetes meta/v1.Duration
  18327. </a>
  18328. </em>
  18329. </td>
  18330. <td>
  18331. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  18332. specified as Golang Duration strings.
  18333. 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;
  18334. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  18335. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  18336. </td>
  18337. </tr>
  18338. <tr>
  18339. <td>
  18340. <code>data</code></br>
  18341. <em>
  18342. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  18343. []ExternalSecretData
  18344. </a>
  18345. </em>
  18346. </td>
  18347. <td>
  18348. <em>(Optional)</em>
  18349. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  18350. </td>
  18351. </tr>
  18352. <tr>
  18353. <td>
  18354. <code>dataFrom</code></br>
  18355. <em>
  18356. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  18357. []ExternalSecretDataFromRemoteRef
  18358. </a>
  18359. </em>
  18360. </td>
  18361. <td>
  18362. <em>(Optional)</em>
  18363. <p>DataFrom is used to fetch all properties from a specific Provider data
  18364. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  18365. </td>
  18366. </tr>
  18367. </table>
  18368. </td>
  18369. </tr>
  18370. <tr>
  18371. <td>
  18372. <code>status</code></br>
  18373. <em>
  18374. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">
  18375. ExternalSecretStatus
  18376. </a>
  18377. </em>
  18378. </td>
  18379. <td>
  18380. </td>
  18381. </tr>
  18382. </tbody>
  18383. </table>
  18384. <h3 id="external-secrets.io/v1beta1.ExternalSecretConditionType">ExternalSecretConditionType
  18385. (<code>string</code> alias)</p></h3>
  18386. <p>
  18387. (<em>Appears on:</em>
  18388. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition</a>)
  18389. </p>
  18390. <p>
  18391. <p>ExternalSecretConditionType defines the condition type for an ExternalSecret.</p>
  18392. </p>
  18393. <table>
  18394. <thead>
  18395. <tr>
  18396. <th>Value</th>
  18397. <th>Description</th>
  18398. </tr>
  18399. </thead>
  18400. <tbody><tr><td><p>&#34;Deleted&#34;</p></td>
  18401. <td><p>ExternalSecretDeleted indicates the ExternalSecret has been deleted.</p>
  18402. </td>
  18403. </tr><tr><td><p>&#34;Ready&#34;</p></td>
  18404. <td><p>ExternalSecretReady indicates the ExternalSecret has been successfully reconciled.</p>
  18405. </td>
  18406. </tr></tbody>
  18407. </table>
  18408. <h3 id="external-secrets.io/v1beta1.ExternalSecretConversionStrategy">ExternalSecretConversionStrategy
  18409. (<code>string</code> alias)</p></h3>
  18410. <p>
  18411. (<em>Appears on:</em>
  18412. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  18413. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  18414. </p>
  18415. <p>
  18416. <p>ExternalSecretConversionStrategy defines how secret values are converted.</p>
  18417. </p>
  18418. <table>
  18419. <thead>
  18420. <tr>
  18421. <th>Value</th>
  18422. <th>Description</th>
  18423. </tr>
  18424. </thead>
  18425. <tbody><tr><td><p>&#34;Default&#34;</p></td>
  18426. <td><p>ExternalSecretConversionDefault indicates the default conversion strategy.</p>
  18427. </td>
  18428. </tr><tr><td><p>&#34;Unicode&#34;</p></td>
  18429. <td><p>ExternalSecretConversionUnicode indicates that unicode conversion will be performed.</p>
  18430. </td>
  18431. </tr></tbody>
  18432. </table>
  18433. <h3 id="external-secrets.io/v1beta1.ExternalSecretCreationPolicy">ExternalSecretCreationPolicy
  18434. (<code>string</code> alias)</p></h3>
  18435. <p>
  18436. (<em>Appears on:</em>
  18437. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  18438. </p>
  18439. <p>
  18440. <p>ExternalSecretCreationPolicy defines rules on how to create the resulting Secret.</p>
  18441. </p>
  18442. <table>
  18443. <thead>
  18444. <tr>
  18445. <th>Value</th>
  18446. <th>Description</th>
  18447. </tr>
  18448. </thead>
  18449. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  18450. <td><p>CreatePolicyMerge does not create the Secret, but merges the data fields to the Secret.</p>
  18451. </td>
  18452. </tr><tr><td><p>&#34;None&#34;</p></td>
  18453. <td><p>CreatePolicyNone does not create a Secret (future use with injector).</p>
  18454. </td>
  18455. </tr><tr><td><p>&#34;Orphan&#34;</p></td>
  18456. <td><p>CreatePolicyOrphan creates the Secret and does not set the ownerReference.
  18457. I.e. it will be orphaned after the deletion of the ExternalSecret.</p>
  18458. </td>
  18459. </tr><tr><td><p>&#34;Owner&#34;</p></td>
  18460. <td><p>CreatePolicyOwner creates the Secret and sets .metadata.ownerReferences to the ExternalSecret resource.</p>
  18461. </td>
  18462. </tr></tbody>
  18463. </table>
  18464. <h3 id="external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData
  18465. </h3>
  18466. <p>
  18467. (<em>Appears on:</em>
  18468. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  18469. </p>
  18470. <p>
  18471. <p>ExternalSecretData defines the connection between the Kubernetes Secret key (spec.data.<key>) and the Provider data.</p>
  18472. </p>
  18473. <table>
  18474. <thead>
  18475. <tr>
  18476. <th>Field</th>
  18477. <th>Description</th>
  18478. </tr>
  18479. </thead>
  18480. <tbody>
  18481. <tr>
  18482. <td>
  18483. <code>secretKey</code></br>
  18484. <em>
  18485. string
  18486. </em>
  18487. </td>
  18488. <td>
  18489. <p>The key in the Kubernetes Secret to store the value.</p>
  18490. </td>
  18491. </tr>
  18492. <tr>
  18493. <td>
  18494. <code>remoteRef</code></br>
  18495. <em>
  18496. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  18497. ExternalSecretDataRemoteRef
  18498. </a>
  18499. </em>
  18500. </td>
  18501. <td>
  18502. <p>RemoteRef points to the remote secret and defines
  18503. which secret (version/property/..) to fetch.</p>
  18504. </td>
  18505. </tr>
  18506. <tr>
  18507. <td>
  18508. <code>sourceRef</code></br>
  18509. <em>
  18510. <a href="#external-secrets.io/v1beta1.StoreSourceRef">
  18511. StoreSourceRef
  18512. </a>
  18513. </em>
  18514. </td>
  18515. <td>
  18516. <p>SourceRef allows you to override the source
  18517. from which the value will be pulled.</p>
  18518. </td>
  18519. </tr>
  18520. </tbody>
  18521. </table>
  18522. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef
  18523. </h3>
  18524. <p>
  18525. (<em>Appears on:</em>
  18526. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  18527. </p>
  18528. <p>
  18529. <p>ExternalSecretDataFromRemoteRef defines a reference to multiple secrets in the provider to be fetched using options.</p>
  18530. </p>
  18531. <table>
  18532. <thead>
  18533. <tr>
  18534. <th>Field</th>
  18535. <th>Description</th>
  18536. </tr>
  18537. </thead>
  18538. <tbody>
  18539. <tr>
  18540. <td>
  18541. <code>extract</code></br>
  18542. <em>
  18543. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">
  18544. ExternalSecretDataRemoteRef
  18545. </a>
  18546. </em>
  18547. </td>
  18548. <td>
  18549. <em>(Optional)</em>
  18550. <p>Used to extract multiple key/value pairs from one secret
  18551. Note: Extract does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  18552. </td>
  18553. </tr>
  18554. <tr>
  18555. <td>
  18556. <code>find</code></br>
  18557. <em>
  18558. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">
  18559. ExternalSecretFind
  18560. </a>
  18561. </em>
  18562. </td>
  18563. <td>
  18564. <em>(Optional)</em>
  18565. <p>Used to find secrets based on tags or regular expressions
  18566. Note: Find does not support sourceRef.Generator or sourceRef.GeneratorRef.</p>
  18567. </td>
  18568. </tr>
  18569. <tr>
  18570. <td>
  18571. <code>rewrite</code></br>
  18572. <em>
  18573. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">
  18574. []ExternalSecretRewrite
  18575. </a>
  18576. </em>
  18577. </td>
  18578. <td>
  18579. <em>(Optional)</em>
  18580. <p>Used to rewrite secret Keys after getting them from the secret Provider
  18581. Multiple Rewrite operations can be provided. They are applied in a layered order (first to last)</p>
  18582. </td>
  18583. </tr>
  18584. <tr>
  18585. <td>
  18586. <code>sourceRef</code></br>
  18587. <em>
  18588. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">
  18589. StoreGeneratorSourceRef
  18590. </a>
  18591. </em>
  18592. </td>
  18593. <td>
  18594. <p>SourceRef points to a store or generator
  18595. which contains secret values ready to use.
  18596. Use this in combination with Extract or Find pull values out of
  18597. a specific SecretStore.
  18598. When sourceRef points to a generator Extract or Find is not supported.
  18599. The generator returns a static map of values</p>
  18600. </td>
  18601. </tr>
  18602. </tbody>
  18603. </table>
  18604. <h3 id="external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef
  18605. </h3>
  18606. <p>
  18607. (<em>Appears on:</em>
  18608. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>,
  18609. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  18610. </p>
  18611. <p>
  18612. <p>ExternalSecretDataRemoteRef defines Provider data location.</p>
  18613. </p>
  18614. <table>
  18615. <thead>
  18616. <tr>
  18617. <th>Field</th>
  18618. <th>Description</th>
  18619. </tr>
  18620. </thead>
  18621. <tbody>
  18622. <tr>
  18623. <td>
  18624. <code>key</code></br>
  18625. <em>
  18626. string
  18627. </em>
  18628. </td>
  18629. <td>
  18630. <p>Key is the key used in the Provider, mandatory</p>
  18631. </td>
  18632. </tr>
  18633. <tr>
  18634. <td>
  18635. <code>metadataPolicy</code></br>
  18636. <em>
  18637. <a href="#external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">
  18638. ExternalSecretMetadataPolicy
  18639. </a>
  18640. </em>
  18641. </td>
  18642. <td>
  18643. <em>(Optional)</em>
  18644. <p>Policy for fetching tags/labels from provider secrets, possible options are Fetch, None. Defaults to None</p>
  18645. </td>
  18646. </tr>
  18647. <tr>
  18648. <td>
  18649. <code>property</code></br>
  18650. <em>
  18651. string
  18652. </em>
  18653. </td>
  18654. <td>
  18655. <em>(Optional)</em>
  18656. <p>Used to select a specific property of the Provider value (if a map), if supported</p>
  18657. </td>
  18658. </tr>
  18659. <tr>
  18660. <td>
  18661. <code>version</code></br>
  18662. <em>
  18663. string
  18664. </em>
  18665. </td>
  18666. <td>
  18667. <em>(Optional)</em>
  18668. <p>Used to select a specific version of the Provider value, if supported</p>
  18669. </td>
  18670. </tr>
  18671. <tr>
  18672. <td>
  18673. <code>conversionStrategy</code></br>
  18674. <em>
  18675. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  18676. ExternalSecretConversionStrategy
  18677. </a>
  18678. </em>
  18679. </td>
  18680. <td>
  18681. <em>(Optional)</em>
  18682. <p>Used to define a conversion Strategy</p>
  18683. </td>
  18684. </tr>
  18685. <tr>
  18686. <td>
  18687. <code>decodingStrategy</code></br>
  18688. <em>
  18689. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  18690. ExternalSecretDecodingStrategy
  18691. </a>
  18692. </em>
  18693. </td>
  18694. <td>
  18695. <em>(Optional)</em>
  18696. <p>Used to define a decoding Strategy</p>
  18697. </td>
  18698. </tr>
  18699. </tbody>
  18700. </table>
  18701. <h3 id="external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">ExternalSecretDecodingStrategy
  18702. (<code>string</code> alias)</p></h3>
  18703. <p>
  18704. (<em>Appears on:</em>
  18705. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>,
  18706. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  18707. </p>
  18708. <p>
  18709. <p>ExternalSecretDecodingStrategy defines how secret values are decoded.</p>
  18710. </p>
  18711. <table>
  18712. <thead>
  18713. <tr>
  18714. <th>Value</th>
  18715. <th>Description</th>
  18716. </tr>
  18717. </thead>
  18718. <tbody><tr><td><p>&#34;Auto&#34;</p></td>
  18719. <td><p>ExternalSecretDecodeAuto indicates that the decoding strategy will be automatically determined.</p>
  18720. </td>
  18721. </tr><tr><td><p>&#34;Base64&#34;</p></td>
  18722. <td><p>ExternalSecretDecodeBase64 indicates that base64 decoding will be used.</p>
  18723. </td>
  18724. </tr><tr><td><p>&#34;Base64URL&#34;</p></td>
  18725. <td><p>ExternalSecretDecodeBase64URL indicates that base64url decoding will be used.</p>
  18726. </td>
  18727. </tr><tr><td><p>&#34;None&#34;</p></td>
  18728. <td><p>ExternalSecretDecodeNone indicates that no decoding will be performed.</p>
  18729. </td>
  18730. </tr></tbody>
  18731. </table>
  18732. <h3 id="external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">ExternalSecretDeletionPolicy
  18733. (<code>string</code> alias)</p></h3>
  18734. <p>
  18735. (<em>Appears on:</em>
  18736. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  18737. </p>
  18738. <p>
  18739. <p>ExternalSecretDeletionPolicy defines rules on how to delete the resulting Secret.</p>
  18740. </p>
  18741. <table>
  18742. <thead>
  18743. <tr>
  18744. <th>Value</th>
  18745. <th>Description</th>
  18746. </tr>
  18747. </thead>
  18748. <tbody><tr><td><p>&#34;Delete&#34;</p></td>
  18749. <td><p>DeletionPolicyDelete deletes the secret if all provider secrets are deleted.
  18750. If a secret gets deleted on the provider side and is not accessible
  18751. anymore this is not considered an error and the ExternalSecret
  18752. does not go into SecretSyncedError status.</p>
  18753. </td>
  18754. </tr><tr><td><p>&#34;Merge&#34;</p></td>
  18755. <td><p>DeletionPolicyMerge removes keys in the secret, but not the secret itself.
  18756. If a secret gets deleted on the provider side and is not accessible
  18757. anymore this is not considered an error and the ExternalSecret
  18758. does not go into SecretSyncedError status.</p>
  18759. </td>
  18760. </tr><tr><td><p>&#34;Retain&#34;</p></td>
  18761. <td><p>DeletionPolicyRetain will retain the secret if all provider secrets have been deleted.
  18762. If a provider secret does not exist the ExternalSecret gets into the
  18763. SecretSyncedError status.</p>
  18764. </td>
  18765. </tr></tbody>
  18766. </table>
  18767. <h3 id="external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind
  18768. </h3>
  18769. <p>
  18770. (<em>Appears on:</em>
  18771. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  18772. </p>
  18773. <p>
  18774. <p>ExternalSecretFind defines criteria for finding secrets in the provider.</p>
  18775. </p>
  18776. <table>
  18777. <thead>
  18778. <tr>
  18779. <th>Field</th>
  18780. <th>Description</th>
  18781. </tr>
  18782. </thead>
  18783. <tbody>
  18784. <tr>
  18785. <td>
  18786. <code>path</code></br>
  18787. <em>
  18788. string
  18789. </em>
  18790. </td>
  18791. <td>
  18792. <em>(Optional)</em>
  18793. <p>A root path to start the find operations.</p>
  18794. </td>
  18795. </tr>
  18796. <tr>
  18797. <td>
  18798. <code>name</code></br>
  18799. <em>
  18800. <a href="#external-secrets.io/v1beta1.FindName">
  18801. FindName
  18802. </a>
  18803. </em>
  18804. </td>
  18805. <td>
  18806. <em>(Optional)</em>
  18807. <p>Finds secrets based on the name.</p>
  18808. </td>
  18809. </tr>
  18810. <tr>
  18811. <td>
  18812. <code>tags</code></br>
  18813. <em>
  18814. map[string]string
  18815. </em>
  18816. </td>
  18817. <td>
  18818. <em>(Optional)</em>
  18819. <p>Find secrets based on tags.</p>
  18820. </td>
  18821. </tr>
  18822. <tr>
  18823. <td>
  18824. <code>conversionStrategy</code></br>
  18825. <em>
  18826. <a href="#external-secrets.io/v1beta1.ExternalSecretConversionStrategy">
  18827. ExternalSecretConversionStrategy
  18828. </a>
  18829. </em>
  18830. </td>
  18831. <td>
  18832. <em>(Optional)</em>
  18833. <p>Used to define a conversion Strategy</p>
  18834. </td>
  18835. </tr>
  18836. <tr>
  18837. <td>
  18838. <code>decodingStrategy</code></br>
  18839. <em>
  18840. <a href="#external-secrets.io/v1beta1.ExternalSecretDecodingStrategy">
  18841. ExternalSecretDecodingStrategy
  18842. </a>
  18843. </em>
  18844. </td>
  18845. <td>
  18846. <em>(Optional)</em>
  18847. <p>Used to define a decoding Strategy</p>
  18848. </td>
  18849. </tr>
  18850. </tbody>
  18851. </table>
  18852. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadata">ExternalSecretMetadata
  18853. </h3>
  18854. <p>
  18855. (<em>Appears on:</em>
  18856. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>)
  18857. </p>
  18858. <p>
  18859. <p>ExternalSecretMetadata defines metadata fields for the ExternalSecret generated by the ClusterExternalSecret.</p>
  18860. </p>
  18861. <table>
  18862. <thead>
  18863. <tr>
  18864. <th>Field</th>
  18865. <th>Description</th>
  18866. </tr>
  18867. </thead>
  18868. <tbody>
  18869. <tr>
  18870. <td>
  18871. <code>annotations</code></br>
  18872. <em>
  18873. map[string]string
  18874. </em>
  18875. </td>
  18876. <td>
  18877. <em>(Optional)</em>
  18878. </td>
  18879. </tr>
  18880. <tr>
  18881. <td>
  18882. <code>labels</code></br>
  18883. <em>
  18884. map[string]string
  18885. </em>
  18886. </td>
  18887. <td>
  18888. <em>(Optional)</em>
  18889. </td>
  18890. </tr>
  18891. </tbody>
  18892. </table>
  18893. <h3 id="external-secrets.io/v1beta1.ExternalSecretMetadataPolicy">ExternalSecretMetadataPolicy
  18894. (<code>string</code> alias)</p></h3>
  18895. <p>
  18896. (<em>Appears on:</em>
  18897. <a href="#external-secrets.io/v1beta1.ExternalSecretDataRemoteRef">ExternalSecretDataRemoteRef</a>)
  18898. </p>
  18899. <p>
  18900. <p>ExternalSecretMetadataPolicy defines the policy for fetching tags/labels from provider secrets.</p>
  18901. </p>
  18902. <table>
  18903. <thead>
  18904. <tr>
  18905. <th>Value</th>
  18906. <th>Description</th>
  18907. </tr>
  18908. </thead>
  18909. <tbody><tr><td><p>&#34;Fetch&#34;</p></td>
  18910. <td><p>ExternalSecretMetadataPolicyFetch indicates that metadata will be fetched from the provider.</p>
  18911. </td>
  18912. </tr><tr><td><p>&#34;None&#34;</p></td>
  18913. <td><p>ExternalSecretMetadataPolicyNone indicates that no metadata will be fetched.</p>
  18914. </td>
  18915. </tr></tbody>
  18916. </table>
  18917. <h3 id="external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">ExternalSecretRefreshPolicy
  18918. (<code>string</code> alias)</p></h3>
  18919. <p>
  18920. (<em>Appears on:</em>
  18921. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  18922. </p>
  18923. <p>
  18924. <p>ExternalSecretRefreshPolicy defines how and when the ExternalSecret should be refreshed.</p>
  18925. </p>
  18926. <table>
  18927. <thead>
  18928. <tr>
  18929. <th>Value</th>
  18930. <th>Description</th>
  18931. </tr>
  18932. </thead>
  18933. <tbody><tr><td><p>&#34;CreatedOnce&#34;</p></td>
  18934. <td><p>RefreshPolicyCreatedOnce creates the Secret only if it does not exist and does not update it thereafter.</p>
  18935. </td>
  18936. </tr><tr><td><p>&#34;OnChange&#34;</p></td>
  18937. <td><p>RefreshPolicyOnChange only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes.</p>
  18938. </td>
  18939. </tr><tr><td><p>&#34;Periodic&#34;</p></td>
  18940. <td><p>RefreshPolicyPeriodic synchronizes the Secret from the external source at regular intervals.</p>
  18941. </td>
  18942. </tr></tbody>
  18943. </table>
  18944. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite
  18945. </h3>
  18946. <p>
  18947. (<em>Appears on:</em>
  18948. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  18949. </p>
  18950. <p>
  18951. <p>ExternalSecretRewrite defines rules on how to rewrite secret keys.</p>
  18952. </p>
  18953. <table>
  18954. <thead>
  18955. <tr>
  18956. <th>Field</th>
  18957. <th>Description</th>
  18958. </tr>
  18959. </thead>
  18960. <tbody>
  18961. <tr>
  18962. <td>
  18963. <code>regexp</code></br>
  18964. <em>
  18965. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">
  18966. ExternalSecretRewriteRegexp
  18967. </a>
  18968. </em>
  18969. </td>
  18970. <td>
  18971. <em>(Optional)</em>
  18972. <p>Used to rewrite with regular expressions.
  18973. The resulting key will be the output of a regexp.ReplaceAll operation.</p>
  18974. </td>
  18975. </tr>
  18976. <tr>
  18977. <td>
  18978. <code>transform</code></br>
  18979. <em>
  18980. <a href="#external-secrets.io/v1beta1.ExternalSecretRewriteTransform">
  18981. ExternalSecretRewriteTransform
  18982. </a>
  18983. </em>
  18984. </td>
  18985. <td>
  18986. <em>(Optional)</em>
  18987. <p>Used to apply string transformation on the secrets.
  18988. The resulting key will be the output of the template applied by the operation.</p>
  18989. </td>
  18990. </tr>
  18991. </tbody>
  18992. </table>
  18993. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteRegexp">ExternalSecretRewriteRegexp
  18994. </h3>
  18995. <p>
  18996. (<em>Appears on:</em>
  18997. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  18998. </p>
  18999. <p>
  19000. <p>ExternalSecretRewriteRegexp defines how to use regular expressions for rewriting secret keys.</p>
  19001. </p>
  19002. <table>
  19003. <thead>
  19004. <tr>
  19005. <th>Field</th>
  19006. <th>Description</th>
  19007. </tr>
  19008. </thead>
  19009. <tbody>
  19010. <tr>
  19011. <td>
  19012. <code>source</code></br>
  19013. <em>
  19014. string
  19015. </em>
  19016. </td>
  19017. <td>
  19018. <p>Used to define the regular expression of a re.Compiler.</p>
  19019. </td>
  19020. </tr>
  19021. <tr>
  19022. <td>
  19023. <code>target</code></br>
  19024. <em>
  19025. string
  19026. </em>
  19027. </td>
  19028. <td>
  19029. <p>Used to define the target pattern of a ReplaceAll operation.</p>
  19030. </td>
  19031. </tr>
  19032. </tbody>
  19033. </table>
  19034. <h3 id="external-secrets.io/v1beta1.ExternalSecretRewriteTransform">ExternalSecretRewriteTransform
  19035. </h3>
  19036. <p>
  19037. (<em>Appears on:</em>
  19038. <a href="#external-secrets.io/v1beta1.ExternalSecretRewrite">ExternalSecretRewrite</a>)
  19039. </p>
  19040. <p>
  19041. <p>ExternalSecretRewriteTransform defines how to use string templates for transforming secret keys.</p>
  19042. </p>
  19043. <table>
  19044. <thead>
  19045. <tr>
  19046. <th>Field</th>
  19047. <th>Description</th>
  19048. </tr>
  19049. </thead>
  19050. <tbody>
  19051. <tr>
  19052. <td>
  19053. <code>template</code></br>
  19054. <em>
  19055. string
  19056. </em>
  19057. </td>
  19058. <td>
  19059. <p>Used to define the template to apply on the secret name.
  19060. <code>.value</code> will specify the secret name in the template.</p>
  19061. </td>
  19062. </tr>
  19063. </tbody>
  19064. </table>
  19065. <h3 id="external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec
  19066. </h3>
  19067. <p>
  19068. (<em>Appears on:</em>
  19069. <a href="#external-secrets.io/v1beta1.ClusterExternalSecretSpec">ClusterExternalSecretSpec</a>,
  19070. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  19071. </p>
  19072. <p>
  19073. <p>ExternalSecretSpec defines the desired state of ExternalSecret.</p>
  19074. </p>
  19075. <table>
  19076. <thead>
  19077. <tr>
  19078. <th>Field</th>
  19079. <th>Description</th>
  19080. </tr>
  19081. </thead>
  19082. <tbody>
  19083. <tr>
  19084. <td>
  19085. <code>secretStoreRef</code></br>
  19086. <em>
  19087. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  19088. SecretStoreRef
  19089. </a>
  19090. </em>
  19091. </td>
  19092. <td>
  19093. <em>(Optional)</em>
  19094. </td>
  19095. </tr>
  19096. <tr>
  19097. <td>
  19098. <code>target</code></br>
  19099. <em>
  19100. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">
  19101. ExternalSecretTarget
  19102. </a>
  19103. </em>
  19104. </td>
  19105. <td>
  19106. <em>(Optional)</em>
  19107. </td>
  19108. </tr>
  19109. <tr>
  19110. <td>
  19111. <code>refreshPolicy</code></br>
  19112. <em>
  19113. <a href="#external-secrets.io/v1beta1.ExternalSecretRefreshPolicy">
  19114. ExternalSecretRefreshPolicy
  19115. </a>
  19116. </em>
  19117. </td>
  19118. <td>
  19119. <em>(Optional)</em>
  19120. <p>RefreshPolicy determines how the ExternalSecret should be refreshed:
  19121. - CreatedOnce: Creates the Secret only if it does not exist and does not update it thereafter
  19122. - Periodic: Synchronizes the Secret from the external source at regular intervals specified by refreshInterval.
  19123. No periodic updates occur if refreshInterval is 0.
  19124. - OnChange: Only synchronizes the Secret when the ExternalSecret&rsquo;s metadata or specification changes</p>
  19125. </td>
  19126. </tr>
  19127. <tr>
  19128. <td>
  19129. <code>refreshInterval</code></br>
  19130. <em>
  19131. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  19132. Kubernetes meta/v1.Duration
  19133. </a>
  19134. </em>
  19135. </td>
  19136. <td>
  19137. <p>RefreshInterval is the amount of time before the values are read again from the SecretStore provider,
  19138. specified as Golang Duration strings.
  19139. 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;
  19140. Example values: &ldquo;1h0m0s&rdquo;, &ldquo;2h30m0s&rdquo;, &ldquo;10m0s&rdquo;
  19141. May be set to &ldquo;0s&rdquo; to fetch and create it once. Defaults to 1h0m0s.</p>
  19142. </td>
  19143. </tr>
  19144. <tr>
  19145. <td>
  19146. <code>data</code></br>
  19147. <em>
  19148. <a href="#external-secrets.io/v1beta1.ExternalSecretData">
  19149. []ExternalSecretData
  19150. </a>
  19151. </em>
  19152. </td>
  19153. <td>
  19154. <em>(Optional)</em>
  19155. <p>Data defines the connection between the Kubernetes Secret keys and the Provider data</p>
  19156. </td>
  19157. </tr>
  19158. <tr>
  19159. <td>
  19160. <code>dataFrom</code></br>
  19161. <em>
  19162. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">
  19163. []ExternalSecretDataFromRemoteRef
  19164. </a>
  19165. </em>
  19166. </td>
  19167. <td>
  19168. <em>(Optional)</em>
  19169. <p>DataFrom is used to fetch all properties from a specific Provider data
  19170. If multiple entries are specified, the Secret keys are merged in the specified order</p>
  19171. </td>
  19172. </tr>
  19173. </tbody>
  19174. </table>
  19175. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus
  19176. </h3>
  19177. <p>
  19178. (<em>Appears on:</em>
  19179. <a href="#external-secrets.io/v1beta1.ExternalSecret">ExternalSecret</a>)
  19180. </p>
  19181. <p>
  19182. <p>ExternalSecretStatus defines the observed state of ExternalSecret.</p>
  19183. </p>
  19184. <table>
  19185. <thead>
  19186. <tr>
  19187. <th>Field</th>
  19188. <th>Description</th>
  19189. </tr>
  19190. </thead>
  19191. <tbody>
  19192. <tr>
  19193. <td>
  19194. <code>refreshTime</code></br>
  19195. <em>
  19196. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  19197. Kubernetes meta/v1.Time
  19198. </a>
  19199. </em>
  19200. </td>
  19201. <td>
  19202. <p>refreshTime is the time and date the external secret was fetched and
  19203. the target secret updated</p>
  19204. </td>
  19205. </tr>
  19206. <tr>
  19207. <td>
  19208. <code>syncedResourceVersion</code></br>
  19209. <em>
  19210. string
  19211. </em>
  19212. </td>
  19213. <td>
  19214. <p>SyncedResourceVersion keeps track of the last synced version</p>
  19215. </td>
  19216. </tr>
  19217. <tr>
  19218. <td>
  19219. <code>conditions</code></br>
  19220. <em>
  19221. <a href="#external-secrets.io/v1beta1.ExternalSecretStatusCondition">
  19222. []ExternalSecretStatusCondition
  19223. </a>
  19224. </em>
  19225. </td>
  19226. <td>
  19227. <em>(Optional)</em>
  19228. </td>
  19229. </tr>
  19230. <tr>
  19231. <td>
  19232. <code>binding</code></br>
  19233. <em>
  19234. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core">
  19235. Kubernetes core/v1.LocalObjectReference
  19236. </a>
  19237. </em>
  19238. </td>
  19239. <td>
  19240. <p>Binding represents a servicebinding.io Provisioned Service reference to the secret</p>
  19241. </td>
  19242. </tr>
  19243. </tbody>
  19244. </table>
  19245. <h3 id="external-secrets.io/v1beta1.ExternalSecretStatusCondition">ExternalSecretStatusCondition
  19246. </h3>
  19247. <p>
  19248. (<em>Appears on:</em>
  19249. <a href="#external-secrets.io/v1beta1.ExternalSecretStatus">ExternalSecretStatus</a>)
  19250. </p>
  19251. <p>
  19252. <p>ExternalSecretStatusCondition contains condition information for an ExternalSecret.</p>
  19253. </p>
  19254. <table>
  19255. <thead>
  19256. <tr>
  19257. <th>Field</th>
  19258. <th>Description</th>
  19259. </tr>
  19260. </thead>
  19261. <tbody>
  19262. <tr>
  19263. <td>
  19264. <code>type</code></br>
  19265. <em>
  19266. <a href="#external-secrets.io/v1beta1.ExternalSecretConditionType">
  19267. ExternalSecretConditionType
  19268. </a>
  19269. </em>
  19270. </td>
  19271. <td>
  19272. </td>
  19273. </tr>
  19274. <tr>
  19275. <td>
  19276. <code>status</code></br>
  19277. <em>
  19278. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  19279. Kubernetes core/v1.ConditionStatus
  19280. </a>
  19281. </em>
  19282. </td>
  19283. <td>
  19284. </td>
  19285. </tr>
  19286. <tr>
  19287. <td>
  19288. <code>reason</code></br>
  19289. <em>
  19290. string
  19291. </em>
  19292. </td>
  19293. <td>
  19294. <em>(Optional)</em>
  19295. </td>
  19296. </tr>
  19297. <tr>
  19298. <td>
  19299. <code>message</code></br>
  19300. <em>
  19301. string
  19302. </em>
  19303. </td>
  19304. <td>
  19305. <em>(Optional)</em>
  19306. </td>
  19307. </tr>
  19308. <tr>
  19309. <td>
  19310. <code>lastTransitionTime</code></br>
  19311. <em>
  19312. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  19313. Kubernetes meta/v1.Time
  19314. </a>
  19315. </em>
  19316. </td>
  19317. <td>
  19318. <em>(Optional)</em>
  19319. </td>
  19320. </tr>
  19321. </tbody>
  19322. </table>
  19323. <h3 id="external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget
  19324. </h3>
  19325. <p>
  19326. (<em>Appears on:</em>
  19327. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>)
  19328. </p>
  19329. <p>
  19330. <p>ExternalSecretTarget defines the Kubernetes Secret to be created
  19331. There can be only one target per ExternalSecret.</p>
  19332. </p>
  19333. <table>
  19334. <thead>
  19335. <tr>
  19336. <th>Field</th>
  19337. <th>Description</th>
  19338. </tr>
  19339. </thead>
  19340. <tbody>
  19341. <tr>
  19342. <td>
  19343. <code>name</code></br>
  19344. <em>
  19345. string
  19346. </em>
  19347. </td>
  19348. <td>
  19349. <em>(Optional)</em>
  19350. <p>The name of the Secret resource to be managed.
  19351. Defaults to the .metadata.name of the ExternalSecret resource</p>
  19352. </td>
  19353. </tr>
  19354. <tr>
  19355. <td>
  19356. <code>creationPolicy</code></br>
  19357. <em>
  19358. <a href="#external-secrets.io/v1beta1.ExternalSecretCreationPolicy">
  19359. ExternalSecretCreationPolicy
  19360. </a>
  19361. </em>
  19362. </td>
  19363. <td>
  19364. <em>(Optional)</em>
  19365. <p>CreationPolicy defines rules on how to create the resulting Secret.
  19366. Defaults to &ldquo;Owner&rdquo;</p>
  19367. </td>
  19368. </tr>
  19369. <tr>
  19370. <td>
  19371. <code>deletionPolicy</code></br>
  19372. <em>
  19373. <a href="#external-secrets.io/v1beta1.ExternalSecretDeletionPolicy">
  19374. ExternalSecretDeletionPolicy
  19375. </a>
  19376. </em>
  19377. </td>
  19378. <td>
  19379. <em>(Optional)</em>
  19380. <p>DeletionPolicy defines rules on how to delete the resulting Secret.
  19381. Defaults to &ldquo;Retain&rdquo;</p>
  19382. </td>
  19383. </tr>
  19384. <tr>
  19385. <td>
  19386. <code>template</code></br>
  19387. <em>
  19388. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">
  19389. ExternalSecretTemplate
  19390. </a>
  19391. </em>
  19392. </td>
  19393. <td>
  19394. <em>(Optional)</em>
  19395. <p>Template defines a blueprint for the created Secret resource.</p>
  19396. </td>
  19397. </tr>
  19398. <tr>
  19399. <td>
  19400. <code>immutable</code></br>
  19401. <em>
  19402. bool
  19403. </em>
  19404. </td>
  19405. <td>
  19406. <em>(Optional)</em>
  19407. <p>Immutable defines if the final secret will be immutable</p>
  19408. </td>
  19409. </tr>
  19410. </tbody>
  19411. </table>
  19412. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate
  19413. </h3>
  19414. <p>
  19415. (<em>Appears on:</em>
  19416. <a href="#external-secrets.io/v1beta1.ExternalSecretTarget">ExternalSecretTarget</a>)
  19417. </p>
  19418. <p>
  19419. <p>ExternalSecretTemplate defines a blueprint for the created Secret resource.
  19420. 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>
  19421. </p>
  19422. <table>
  19423. <thead>
  19424. <tr>
  19425. <th>Field</th>
  19426. <th>Description</th>
  19427. </tr>
  19428. </thead>
  19429. <tbody>
  19430. <tr>
  19431. <td>
  19432. <code>type</code></br>
  19433. <em>
  19434. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#secrettype-v1-core">
  19435. Kubernetes core/v1.SecretType
  19436. </a>
  19437. </em>
  19438. </td>
  19439. <td>
  19440. <em>(Optional)</em>
  19441. </td>
  19442. </tr>
  19443. <tr>
  19444. <td>
  19445. <code>engineVersion</code></br>
  19446. <em>
  19447. <a href="#external-secrets.io/v1beta1.TemplateEngineVersion">
  19448. TemplateEngineVersion
  19449. </a>
  19450. </em>
  19451. </td>
  19452. <td>
  19453. <p>EngineVersion specifies the template engine version
  19454. that should be used to compile/execute the
  19455. template specified in .data and .templateFrom[].</p>
  19456. </td>
  19457. </tr>
  19458. <tr>
  19459. <td>
  19460. <code>metadata</code></br>
  19461. <em>
  19462. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">
  19463. ExternalSecretTemplateMetadata
  19464. </a>
  19465. </em>
  19466. </td>
  19467. <td>
  19468. <em>(Optional)</em>
  19469. </td>
  19470. </tr>
  19471. <tr>
  19472. <td>
  19473. <code>mergePolicy</code></br>
  19474. <em>
  19475. <a href="#external-secrets.io/v1beta1.TemplateMergePolicy">
  19476. TemplateMergePolicy
  19477. </a>
  19478. </em>
  19479. </td>
  19480. <td>
  19481. </td>
  19482. </tr>
  19483. <tr>
  19484. <td>
  19485. <code>data</code></br>
  19486. <em>
  19487. map[string]string
  19488. </em>
  19489. </td>
  19490. <td>
  19491. <em>(Optional)</em>
  19492. </td>
  19493. </tr>
  19494. <tr>
  19495. <td>
  19496. <code>templateFrom</code></br>
  19497. <em>
  19498. <a href="#external-secrets.io/v1beta1.TemplateFrom">
  19499. []TemplateFrom
  19500. </a>
  19501. </em>
  19502. </td>
  19503. <td>
  19504. <em>(Optional)</em>
  19505. </td>
  19506. </tr>
  19507. </tbody>
  19508. </table>
  19509. <h3 id="external-secrets.io/v1beta1.ExternalSecretTemplateMetadata">ExternalSecretTemplateMetadata
  19510. </h3>
  19511. <p>
  19512. (<em>Appears on:</em>
  19513. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  19514. </p>
  19515. <p>
  19516. <p>ExternalSecretTemplateMetadata defines metadata fields for the Secret blueprint.</p>
  19517. </p>
  19518. <table>
  19519. <thead>
  19520. <tr>
  19521. <th>Field</th>
  19522. <th>Description</th>
  19523. </tr>
  19524. </thead>
  19525. <tbody>
  19526. <tr>
  19527. <td>
  19528. <code>annotations</code></br>
  19529. <em>
  19530. map[string]string
  19531. </em>
  19532. </td>
  19533. <td>
  19534. <em>(Optional)</em>
  19535. </td>
  19536. </tr>
  19537. <tr>
  19538. <td>
  19539. <code>labels</code></br>
  19540. <em>
  19541. map[string]string
  19542. </em>
  19543. </td>
  19544. <td>
  19545. <em>(Optional)</em>
  19546. </td>
  19547. </tr>
  19548. </tbody>
  19549. </table>
  19550. <h3 id="external-secrets.io/v1beta1.ExternalSecretValidator">ExternalSecretValidator
  19551. </h3>
  19552. <p>
  19553. <p>ExternalSecretValidator implements a validating webhook for ExternalSecrets.</p>
  19554. </p>
  19555. <h3 id="external-secrets.io/v1beta1.FakeProvider">FakeProvider
  19556. </h3>
  19557. <p>
  19558. (<em>Appears on:</em>
  19559. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19560. </p>
  19561. <p>
  19562. <p>FakeProvider configures a fake provider that returns static values.</p>
  19563. </p>
  19564. <table>
  19565. <thead>
  19566. <tr>
  19567. <th>Field</th>
  19568. <th>Description</th>
  19569. </tr>
  19570. </thead>
  19571. <tbody>
  19572. <tr>
  19573. <td>
  19574. <code>data</code></br>
  19575. <em>
  19576. <a href="#external-secrets.io/v1beta1.FakeProviderData">
  19577. []FakeProviderData
  19578. </a>
  19579. </em>
  19580. </td>
  19581. <td>
  19582. </td>
  19583. </tr>
  19584. </tbody>
  19585. </table>
  19586. <h3 id="external-secrets.io/v1beta1.FakeProviderData">FakeProviderData
  19587. </h3>
  19588. <p>
  19589. (<em>Appears on:</em>
  19590. <a href="#external-secrets.io/v1beta1.FakeProvider">FakeProvider</a>)
  19591. </p>
  19592. <p>
  19593. <p>FakeProviderData defines a key-value pair for the fake provider used in testing.</p>
  19594. </p>
  19595. <table>
  19596. <thead>
  19597. <tr>
  19598. <th>Field</th>
  19599. <th>Description</th>
  19600. </tr>
  19601. </thead>
  19602. <tbody>
  19603. <tr>
  19604. <td>
  19605. <code>key</code></br>
  19606. <em>
  19607. string
  19608. </em>
  19609. </td>
  19610. <td>
  19611. </td>
  19612. </tr>
  19613. <tr>
  19614. <td>
  19615. <code>value</code></br>
  19616. <em>
  19617. string
  19618. </em>
  19619. </td>
  19620. <td>
  19621. </td>
  19622. </tr>
  19623. <tr>
  19624. <td>
  19625. <code>version</code></br>
  19626. <em>
  19627. string
  19628. </em>
  19629. </td>
  19630. <td>
  19631. </td>
  19632. </tr>
  19633. </tbody>
  19634. </table>
  19635. <h3 id="external-secrets.io/v1beta1.FindName">FindName
  19636. </h3>
  19637. <p>
  19638. (<em>Appears on:</em>
  19639. <a href="#external-secrets.io/v1beta1.ExternalSecretFind">ExternalSecretFind</a>)
  19640. </p>
  19641. <p>
  19642. <p>FindName defines name matching criteria for finding secrets.</p>
  19643. </p>
  19644. <table>
  19645. <thead>
  19646. <tr>
  19647. <th>Field</th>
  19648. <th>Description</th>
  19649. </tr>
  19650. </thead>
  19651. <tbody>
  19652. <tr>
  19653. <td>
  19654. <code>regexp</code></br>
  19655. <em>
  19656. string
  19657. </em>
  19658. </td>
  19659. <td>
  19660. <em>(Optional)</em>
  19661. <p>Finds secrets base</p>
  19662. </td>
  19663. </tr>
  19664. </tbody>
  19665. </table>
  19666. <h3 id="external-secrets.io/v1beta1.FortanixProvider">FortanixProvider
  19667. </h3>
  19668. <p>
  19669. (<em>Appears on:</em>
  19670. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19671. </p>
  19672. <p>
  19673. <p>FortanixProvider configures a store to sync secrets using the Fortanix SDKMS provider.</p>
  19674. </p>
  19675. <table>
  19676. <thead>
  19677. <tr>
  19678. <th>Field</th>
  19679. <th>Description</th>
  19680. </tr>
  19681. </thead>
  19682. <tbody>
  19683. <tr>
  19684. <td>
  19685. <code>apiUrl</code></br>
  19686. <em>
  19687. string
  19688. </em>
  19689. </td>
  19690. <td>
  19691. <p>APIURL is the URL of SDKMS API. Defaults to <code>sdkms.fortanix.com</code>.</p>
  19692. </td>
  19693. </tr>
  19694. <tr>
  19695. <td>
  19696. <code>apiKey</code></br>
  19697. <em>
  19698. <a href="#external-secrets.io/v1beta1.FortanixProviderSecretRef">
  19699. FortanixProviderSecretRef
  19700. </a>
  19701. </em>
  19702. </td>
  19703. <td>
  19704. <p>APIKey is the API token to access SDKMS Applications.</p>
  19705. </td>
  19706. </tr>
  19707. </tbody>
  19708. </table>
  19709. <h3 id="external-secrets.io/v1beta1.FortanixProviderSecretRef">FortanixProviderSecretRef
  19710. </h3>
  19711. <p>
  19712. (<em>Appears on:</em>
  19713. <a href="#external-secrets.io/v1beta1.FortanixProvider">FortanixProvider</a>)
  19714. </p>
  19715. <p>
  19716. <p>FortanixProviderSecretRef defines a reference to a secret containing credentials for the Fortanix provider.</p>
  19717. </p>
  19718. <table>
  19719. <thead>
  19720. <tr>
  19721. <th>Field</th>
  19722. <th>Description</th>
  19723. </tr>
  19724. </thead>
  19725. <tbody>
  19726. <tr>
  19727. <td>
  19728. <code>secretRef</code></br>
  19729. <em>
  19730. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19731. External Secrets meta/v1.SecretKeySelector
  19732. </a>
  19733. </em>
  19734. </td>
  19735. <td>
  19736. <p>SecretRef is a reference to a secret containing the SDKMS API Key.</p>
  19737. </td>
  19738. </tr>
  19739. </tbody>
  19740. </table>
  19741. <h3 id="external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth
  19742. </h3>
  19743. <p>
  19744. (<em>Appears on:</em>
  19745. <a href="#external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider</a>)
  19746. </p>
  19747. <p>
  19748. <p>GCPSMAuth defines the authentication methods for the GCP Secret Manager provider.</p>
  19749. </p>
  19750. <table>
  19751. <thead>
  19752. <tr>
  19753. <th>Field</th>
  19754. <th>Description</th>
  19755. </tr>
  19756. </thead>
  19757. <tbody>
  19758. <tr>
  19759. <td>
  19760. <code>secretRef</code></br>
  19761. <em>
  19762. <a href="#external-secrets.io/v1beta1.GCPSMAuthSecretRef">
  19763. GCPSMAuthSecretRef
  19764. </a>
  19765. </em>
  19766. </td>
  19767. <td>
  19768. <em>(Optional)</em>
  19769. </td>
  19770. </tr>
  19771. <tr>
  19772. <td>
  19773. <code>workloadIdentity</code></br>
  19774. <em>
  19775. <a href="#external-secrets.io/v1beta1.GCPWorkloadIdentity">
  19776. GCPWorkloadIdentity
  19777. </a>
  19778. </em>
  19779. </td>
  19780. <td>
  19781. <em>(Optional)</em>
  19782. </td>
  19783. </tr>
  19784. </tbody>
  19785. </table>
  19786. <h3 id="external-secrets.io/v1beta1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  19787. </h3>
  19788. <p>
  19789. (<em>Appears on:</em>
  19790. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  19791. </p>
  19792. <p>
  19793. <p>GCPSMAuthSecretRef defines a reference to a secret containing credentials for the GCP Secret Manager provider.</p>
  19794. </p>
  19795. <table>
  19796. <thead>
  19797. <tr>
  19798. <th>Field</th>
  19799. <th>Description</th>
  19800. </tr>
  19801. </thead>
  19802. <tbody>
  19803. <tr>
  19804. <td>
  19805. <code>secretAccessKeySecretRef</code></br>
  19806. <em>
  19807. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  19808. External Secrets meta/v1.SecretKeySelector
  19809. </a>
  19810. </em>
  19811. </td>
  19812. <td>
  19813. <em>(Optional)</em>
  19814. <p>The SecretAccessKey is used for authentication</p>
  19815. </td>
  19816. </tr>
  19817. </tbody>
  19818. </table>
  19819. <h3 id="external-secrets.io/v1beta1.GCPSMProvider">GCPSMProvider
  19820. </h3>
  19821. <p>
  19822. (<em>Appears on:</em>
  19823. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  19824. </p>
  19825. <p>
  19826. <p>GCPSMProvider Configures a store to sync secrets using the GCP Secret Manager provider.</p>
  19827. </p>
  19828. <table>
  19829. <thead>
  19830. <tr>
  19831. <th>Field</th>
  19832. <th>Description</th>
  19833. </tr>
  19834. </thead>
  19835. <tbody>
  19836. <tr>
  19837. <td>
  19838. <code>auth</code></br>
  19839. <em>
  19840. <a href="#external-secrets.io/v1beta1.GCPSMAuth">
  19841. GCPSMAuth
  19842. </a>
  19843. </em>
  19844. </td>
  19845. <td>
  19846. <em>(Optional)</em>
  19847. <p>Auth defines the information necessary to authenticate against GCP</p>
  19848. </td>
  19849. </tr>
  19850. <tr>
  19851. <td>
  19852. <code>projectID</code></br>
  19853. <em>
  19854. string
  19855. </em>
  19856. </td>
  19857. <td>
  19858. <p>ProjectID project where secret is located</p>
  19859. </td>
  19860. </tr>
  19861. <tr>
  19862. <td>
  19863. <code>location</code></br>
  19864. <em>
  19865. string
  19866. </em>
  19867. </td>
  19868. <td>
  19869. <p>Location optionally defines a location for a secret</p>
  19870. </td>
  19871. </tr>
  19872. </tbody>
  19873. </table>
  19874. <h3 id="external-secrets.io/v1beta1.GCPWorkloadIdentity">GCPWorkloadIdentity
  19875. </h3>
  19876. <p>
  19877. (<em>Appears on:</em>
  19878. <a href="#external-secrets.io/v1beta1.GCPSMAuth">GCPSMAuth</a>)
  19879. </p>
  19880. <p>
  19881. <p>GCPWorkloadIdentity defines configuration for using GCP Workload Identity authentication.</p>
  19882. </p>
  19883. <table>
  19884. <thead>
  19885. <tr>
  19886. <th>Field</th>
  19887. <th>Description</th>
  19888. </tr>
  19889. </thead>
  19890. <tbody>
  19891. <tr>
  19892. <td>
  19893. <code>serviceAccountRef</code></br>
  19894. <em>
  19895. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  19896. External Secrets meta/v1.ServiceAccountSelector
  19897. </a>
  19898. </em>
  19899. </td>
  19900. <td>
  19901. </td>
  19902. </tr>
  19903. <tr>
  19904. <td>
  19905. <code>clusterLocation</code></br>
  19906. <em>
  19907. string
  19908. </em>
  19909. </td>
  19910. <td>
  19911. <em>(Optional)</em>
  19912. <p>ClusterLocation is the location of the cluster
  19913. If not specified, it fetches information from the metadata server</p>
  19914. </td>
  19915. </tr>
  19916. <tr>
  19917. <td>
  19918. <code>clusterName</code></br>
  19919. <em>
  19920. string
  19921. </em>
  19922. </td>
  19923. <td>
  19924. <em>(Optional)</em>
  19925. <p>ClusterName is the name of the cluster
  19926. If not specified, it fetches information from the metadata server</p>
  19927. </td>
  19928. </tr>
  19929. <tr>
  19930. <td>
  19931. <code>clusterProjectID</code></br>
  19932. <em>
  19933. string
  19934. </em>
  19935. </td>
  19936. <td>
  19937. <em>(Optional)</em>
  19938. <p>ClusterProjectID is the project ID of the cluster
  19939. If not specified, it fetches information from the metadata server</p>
  19940. </td>
  19941. </tr>
  19942. </tbody>
  19943. </table>
  19944. <h3 id="external-secrets.io/v1beta1.GeneratorRef">GeneratorRef
  19945. </h3>
  19946. <p>
  19947. (<em>Appears on:</em>
  19948. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  19949. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  19950. </p>
  19951. <p>
  19952. <p>GeneratorRef points to a generator custom resource.</p>
  19953. </p>
  19954. <table>
  19955. <thead>
  19956. <tr>
  19957. <th>Field</th>
  19958. <th>Description</th>
  19959. </tr>
  19960. </thead>
  19961. <tbody>
  19962. <tr>
  19963. <td>
  19964. <code>apiVersion</code></br>
  19965. <em>
  19966. string
  19967. </em>
  19968. </td>
  19969. <td>
  19970. <p>Specify the apiVersion of the generator resource</p>
  19971. </td>
  19972. </tr>
  19973. <tr>
  19974. <td>
  19975. <code>kind</code></br>
  19976. <em>
  19977. string
  19978. </em>
  19979. </td>
  19980. <td>
  19981. <p>Specify the Kind of the generator resource</p>
  19982. </td>
  19983. </tr>
  19984. <tr>
  19985. <td>
  19986. <code>name</code></br>
  19987. <em>
  19988. string
  19989. </em>
  19990. </td>
  19991. <td>
  19992. <p>Specify the name of the generator resource</p>
  19993. </td>
  19994. </tr>
  19995. </tbody>
  19996. </table>
  19997. <h3 id="external-secrets.io/v1beta1.GenericClusterStoreValidator">GenericClusterStoreValidator
  19998. </h3>
  19999. <p>
  20000. <p>GenericClusterStoreValidator provides validation for ClusterSecretStore resources.</p>
  20001. </p>
  20002. <h3 id="external-secrets.io/v1beta1.GenericStore">GenericStore
  20003. </h3>
  20004. <p>
  20005. <p>GenericStore is a common interface for interacting with ClusterSecretStore
  20006. or a namespaced SecretStore.</p>
  20007. </p>
  20008. <h3 id="external-secrets.io/v1beta1.GenericStoreValidator">GenericStoreValidator
  20009. </h3>
  20010. <p>
  20011. <p>GenericStoreValidator provides validation for SecretStore resources.</p>
  20012. </p>
  20013. <h3 id="external-secrets.io/v1beta1.GithubAppAuth">GithubAppAuth
  20014. </h3>
  20015. <p>
  20016. (<em>Appears on:</em>
  20017. <a href="#external-secrets.io/v1beta1.GithubProvider">GithubProvider</a>)
  20018. </p>
  20019. <p>
  20020. <p>GithubAppAuth defines the GitHub App authentication mechanism for the GitHub provider.</p>
  20021. </p>
  20022. <table>
  20023. <thead>
  20024. <tr>
  20025. <th>Field</th>
  20026. <th>Description</th>
  20027. </tr>
  20028. </thead>
  20029. <tbody>
  20030. <tr>
  20031. <td>
  20032. <code>privateKey</code></br>
  20033. <em>
  20034. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20035. External Secrets meta/v1.SecretKeySelector
  20036. </a>
  20037. </em>
  20038. </td>
  20039. <td>
  20040. </td>
  20041. </tr>
  20042. </tbody>
  20043. </table>
  20044. <h3 id="external-secrets.io/v1beta1.GithubProvider">GithubProvider
  20045. </h3>
  20046. <p>
  20047. (<em>Appears on:</em>
  20048. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20049. </p>
  20050. <p>
  20051. <p>GithubProvider configures a store to push secrets to Github Actions.</p>
  20052. </p>
  20053. <table>
  20054. <thead>
  20055. <tr>
  20056. <th>Field</th>
  20057. <th>Description</th>
  20058. </tr>
  20059. </thead>
  20060. <tbody>
  20061. <tr>
  20062. <td>
  20063. <code>url</code></br>
  20064. <em>
  20065. string
  20066. </em>
  20067. </td>
  20068. <td>
  20069. <p>URL configures the Github instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  20070. </td>
  20071. </tr>
  20072. <tr>
  20073. <td>
  20074. <code>uploadURL</code></br>
  20075. <em>
  20076. string
  20077. </em>
  20078. </td>
  20079. <td>
  20080. <em>(Optional)</em>
  20081. <p>Upload URL for enterprise instances. Default to URL.</p>
  20082. </td>
  20083. </tr>
  20084. <tr>
  20085. <td>
  20086. <code>auth</code></br>
  20087. <em>
  20088. <a href="#external-secrets.io/v1beta1.GithubAppAuth">
  20089. GithubAppAuth
  20090. </a>
  20091. </em>
  20092. </td>
  20093. <td>
  20094. <p>auth configures how secret-manager authenticates with a Github instance.</p>
  20095. </td>
  20096. </tr>
  20097. <tr>
  20098. <td>
  20099. <code>appID</code></br>
  20100. <em>
  20101. int64
  20102. </em>
  20103. </td>
  20104. <td>
  20105. <p>appID specifies the Github APP that will be used to authenticate the client</p>
  20106. </td>
  20107. </tr>
  20108. <tr>
  20109. <td>
  20110. <code>installationID</code></br>
  20111. <em>
  20112. int64
  20113. </em>
  20114. </td>
  20115. <td>
  20116. <p>installationID specifies the Github APP installation that will be used to authenticate the client</p>
  20117. </td>
  20118. </tr>
  20119. <tr>
  20120. <td>
  20121. <code>organization</code></br>
  20122. <em>
  20123. string
  20124. </em>
  20125. </td>
  20126. <td>
  20127. <p>organization will be used to fetch secrets from the Github organization</p>
  20128. </td>
  20129. </tr>
  20130. <tr>
  20131. <td>
  20132. <code>repository</code></br>
  20133. <em>
  20134. string
  20135. </em>
  20136. </td>
  20137. <td>
  20138. <em>(Optional)</em>
  20139. <p>repository will be used to fetch secrets from the Github repository within an organization</p>
  20140. </td>
  20141. </tr>
  20142. <tr>
  20143. <td>
  20144. <code>environment</code></br>
  20145. <em>
  20146. string
  20147. </em>
  20148. </td>
  20149. <td>
  20150. <em>(Optional)</em>
  20151. <p>environment will be used to fetch secrets from a particular environment within a github repository</p>
  20152. </td>
  20153. </tr>
  20154. </tbody>
  20155. </table>
  20156. <h3 id="external-secrets.io/v1beta1.GitlabAuth">GitlabAuth
  20157. </h3>
  20158. <p>
  20159. (<em>Appears on:</em>
  20160. <a href="#external-secrets.io/v1beta1.GitlabProvider">GitlabProvider</a>)
  20161. </p>
  20162. <p>
  20163. <p>GitlabAuth defines the authentication method for the GitLab provider.</p>
  20164. </p>
  20165. <table>
  20166. <thead>
  20167. <tr>
  20168. <th>Field</th>
  20169. <th>Description</th>
  20170. </tr>
  20171. </thead>
  20172. <tbody>
  20173. <tr>
  20174. <td>
  20175. <code>SecretRef</code></br>
  20176. <em>
  20177. <a href="#external-secrets.io/v1beta1.GitlabSecretRef">
  20178. GitlabSecretRef
  20179. </a>
  20180. </em>
  20181. </td>
  20182. <td>
  20183. </td>
  20184. </tr>
  20185. </tbody>
  20186. </table>
  20187. <h3 id="external-secrets.io/v1beta1.GitlabProvider">GitlabProvider
  20188. </h3>
  20189. <p>
  20190. (<em>Appears on:</em>
  20191. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20192. </p>
  20193. <p>
  20194. <p>GitlabProvider configures a store to sync secrets with a GitLab instance.</p>
  20195. </p>
  20196. <table>
  20197. <thead>
  20198. <tr>
  20199. <th>Field</th>
  20200. <th>Description</th>
  20201. </tr>
  20202. </thead>
  20203. <tbody>
  20204. <tr>
  20205. <td>
  20206. <code>url</code></br>
  20207. <em>
  20208. string
  20209. </em>
  20210. </td>
  20211. <td>
  20212. <p>URL configures the GitLab instance URL. Defaults to <a href="https://gitlab.com/">https://gitlab.com/</a>.</p>
  20213. </td>
  20214. </tr>
  20215. <tr>
  20216. <td>
  20217. <code>auth</code></br>
  20218. <em>
  20219. <a href="#external-secrets.io/v1beta1.GitlabAuth">
  20220. GitlabAuth
  20221. </a>
  20222. </em>
  20223. </td>
  20224. <td>
  20225. <p>Auth configures how secret-manager authenticates with a GitLab instance.</p>
  20226. </td>
  20227. </tr>
  20228. <tr>
  20229. <td>
  20230. <code>projectID</code></br>
  20231. <em>
  20232. string
  20233. </em>
  20234. </td>
  20235. <td>
  20236. <p>ProjectID specifies a project where secrets are located.</p>
  20237. </td>
  20238. </tr>
  20239. <tr>
  20240. <td>
  20241. <code>inheritFromGroups</code></br>
  20242. <em>
  20243. bool
  20244. </em>
  20245. </td>
  20246. <td>
  20247. <p>InheritFromGroups specifies whether parent groups should be discovered and checked for secrets.</p>
  20248. </td>
  20249. </tr>
  20250. <tr>
  20251. <td>
  20252. <code>groupIDs</code></br>
  20253. <em>
  20254. []string
  20255. </em>
  20256. </td>
  20257. <td>
  20258. <p>GroupIDs specify, which gitlab groups to pull secrets from. Group secrets are read from left to right followed by the project variables.</p>
  20259. </td>
  20260. </tr>
  20261. <tr>
  20262. <td>
  20263. <code>environment</code></br>
  20264. <em>
  20265. string
  20266. </em>
  20267. </td>
  20268. <td>
  20269. <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>
  20270. </td>
  20271. </tr>
  20272. <tr>
  20273. <td>
  20274. <code>caBundle</code></br>
  20275. <em>
  20276. []byte
  20277. </em>
  20278. </td>
  20279. <td>
  20280. <em>(Optional)</em>
  20281. <p>Base64 encoded certificate for the GitLab server sdk. The sdk MUST run with HTTPS to make sure no MITM attack
  20282. can be performed.</p>
  20283. </td>
  20284. </tr>
  20285. <tr>
  20286. <td>
  20287. <code>caProvider</code></br>
  20288. <em>
  20289. <a href="#external-secrets.io/v1beta1.CAProvider">
  20290. CAProvider
  20291. </a>
  20292. </em>
  20293. </td>
  20294. <td>
  20295. <em>(Optional)</em>
  20296. <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>
  20297. </td>
  20298. </tr>
  20299. </tbody>
  20300. </table>
  20301. <h3 id="external-secrets.io/v1beta1.GitlabSecretRef">GitlabSecretRef
  20302. </h3>
  20303. <p>
  20304. (<em>Appears on:</em>
  20305. <a href="#external-secrets.io/v1beta1.GitlabAuth">GitlabAuth</a>)
  20306. </p>
  20307. <p>
  20308. <p>GitlabSecretRef defines a reference to a secret containing credentials for the GitLab provider.</p>
  20309. </p>
  20310. <table>
  20311. <thead>
  20312. <tr>
  20313. <th>Field</th>
  20314. <th>Description</th>
  20315. </tr>
  20316. </thead>
  20317. <tbody>
  20318. <tr>
  20319. <td>
  20320. <code>accessToken</code></br>
  20321. <em>
  20322. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20323. External Secrets meta/v1.SecretKeySelector
  20324. </a>
  20325. </em>
  20326. </td>
  20327. <td>
  20328. <p>AccessToken is used for authentication.</p>
  20329. </td>
  20330. </tr>
  20331. </tbody>
  20332. </table>
  20333. <h3 id="external-secrets.io/v1beta1.IBMAuth">IBMAuth
  20334. </h3>
  20335. <p>
  20336. (<em>Appears on:</em>
  20337. <a href="#external-secrets.io/v1beta1.IBMProvider">IBMProvider</a>)
  20338. </p>
  20339. <p>
  20340. <p>IBMAuth defines the authentication methods for the IBM Cloud Secrets Manager provider.</p>
  20341. </p>
  20342. <table>
  20343. <thead>
  20344. <tr>
  20345. <th>Field</th>
  20346. <th>Description</th>
  20347. </tr>
  20348. </thead>
  20349. <tbody>
  20350. <tr>
  20351. <td>
  20352. <code>secretRef</code></br>
  20353. <em>
  20354. <a href="#external-secrets.io/v1beta1.IBMAuthSecretRef">
  20355. IBMAuthSecretRef
  20356. </a>
  20357. </em>
  20358. </td>
  20359. <td>
  20360. </td>
  20361. </tr>
  20362. <tr>
  20363. <td>
  20364. <code>containerAuth</code></br>
  20365. <em>
  20366. <a href="#external-secrets.io/v1beta1.IBMAuthContainerAuth">
  20367. IBMAuthContainerAuth
  20368. </a>
  20369. </em>
  20370. </td>
  20371. <td>
  20372. </td>
  20373. </tr>
  20374. </tbody>
  20375. </table>
  20376. <h3 id="external-secrets.io/v1beta1.IBMAuthContainerAuth">IBMAuthContainerAuth
  20377. </h3>
  20378. <p>
  20379. (<em>Appears on:</em>
  20380. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  20381. </p>
  20382. <p>
  20383. <p>IBMAuthContainerAuth defines authentication using IBM Container-based auth with IAM Trusted Profile.</p>
  20384. </p>
  20385. <table>
  20386. <thead>
  20387. <tr>
  20388. <th>Field</th>
  20389. <th>Description</th>
  20390. </tr>
  20391. </thead>
  20392. <tbody>
  20393. <tr>
  20394. <td>
  20395. <code>profile</code></br>
  20396. <em>
  20397. string
  20398. </em>
  20399. </td>
  20400. <td>
  20401. <p>the IBM Trusted Profile</p>
  20402. </td>
  20403. </tr>
  20404. <tr>
  20405. <td>
  20406. <code>tokenLocation</code></br>
  20407. <em>
  20408. string
  20409. </em>
  20410. </td>
  20411. <td>
  20412. <p>Location the token is mounted on the pod</p>
  20413. </td>
  20414. </tr>
  20415. <tr>
  20416. <td>
  20417. <code>iamEndpoint</code></br>
  20418. <em>
  20419. string
  20420. </em>
  20421. </td>
  20422. <td>
  20423. </td>
  20424. </tr>
  20425. </tbody>
  20426. </table>
  20427. <h3 id="external-secrets.io/v1beta1.IBMAuthSecretRef">IBMAuthSecretRef
  20428. </h3>
  20429. <p>
  20430. (<em>Appears on:</em>
  20431. <a href="#external-secrets.io/v1beta1.IBMAuth">IBMAuth</a>)
  20432. </p>
  20433. <p>
  20434. <p>IBMAuthSecretRef defines a reference to a secret containing credentials for the IBM provider.</p>
  20435. </p>
  20436. <table>
  20437. <thead>
  20438. <tr>
  20439. <th>Field</th>
  20440. <th>Description</th>
  20441. </tr>
  20442. </thead>
  20443. <tbody>
  20444. <tr>
  20445. <td>
  20446. <code>secretApiKeySecretRef</code></br>
  20447. <em>
  20448. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20449. External Secrets meta/v1.SecretKeySelector
  20450. </a>
  20451. </em>
  20452. </td>
  20453. <td>
  20454. <p>The SecretAccessKey is used for authentication</p>
  20455. </td>
  20456. </tr>
  20457. </tbody>
  20458. </table>
  20459. <h3 id="external-secrets.io/v1beta1.IBMProvider">IBMProvider
  20460. </h3>
  20461. <p>
  20462. (<em>Appears on:</em>
  20463. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20464. </p>
  20465. <p>
  20466. <p>IBMProvider configures a store to sync secrets using a IBM Cloud Secrets Manager backend.</p>
  20467. </p>
  20468. <table>
  20469. <thead>
  20470. <tr>
  20471. <th>Field</th>
  20472. <th>Description</th>
  20473. </tr>
  20474. </thead>
  20475. <tbody>
  20476. <tr>
  20477. <td>
  20478. <code>auth</code></br>
  20479. <em>
  20480. <a href="#external-secrets.io/v1beta1.IBMAuth">
  20481. IBMAuth
  20482. </a>
  20483. </em>
  20484. </td>
  20485. <td>
  20486. <p>Auth configures how secret-manager authenticates with the IBM secrets manager.</p>
  20487. </td>
  20488. </tr>
  20489. <tr>
  20490. <td>
  20491. <code>serviceUrl</code></br>
  20492. <em>
  20493. string
  20494. </em>
  20495. </td>
  20496. <td>
  20497. <p>ServiceURL is the Endpoint URL that is specific to the Secrets Manager service instance</p>
  20498. </td>
  20499. </tr>
  20500. </tbody>
  20501. </table>
  20502. <h3 id="external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth
  20503. </h3>
  20504. <p>
  20505. (<em>Appears on:</em>
  20506. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  20507. </p>
  20508. <p>
  20509. <p>InfisicalAuth defines the authentication methods for the Infisical provider.</p>
  20510. </p>
  20511. <table>
  20512. <thead>
  20513. <tr>
  20514. <th>Field</th>
  20515. <th>Description</th>
  20516. </tr>
  20517. </thead>
  20518. <tbody>
  20519. <tr>
  20520. <td>
  20521. <code>universalAuthCredentials</code></br>
  20522. <em>
  20523. <a href="#external-secrets.io/v1beta1.UniversalAuthCredentials">
  20524. UniversalAuthCredentials
  20525. </a>
  20526. </em>
  20527. </td>
  20528. <td>
  20529. <em>(Optional)</em>
  20530. </td>
  20531. </tr>
  20532. </tbody>
  20533. </table>
  20534. <h3 id="external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider
  20535. </h3>
  20536. <p>
  20537. (<em>Appears on:</em>
  20538. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20539. </p>
  20540. <p>
  20541. <p>InfisicalProvider configures a store to sync secrets using the Infisical provider.</p>
  20542. </p>
  20543. <table>
  20544. <thead>
  20545. <tr>
  20546. <th>Field</th>
  20547. <th>Description</th>
  20548. </tr>
  20549. </thead>
  20550. <tbody>
  20551. <tr>
  20552. <td>
  20553. <code>auth</code></br>
  20554. <em>
  20555. <a href="#external-secrets.io/v1beta1.InfisicalAuth">
  20556. InfisicalAuth
  20557. </a>
  20558. </em>
  20559. </td>
  20560. <td>
  20561. <p>Auth configures how the Operator authenticates with the Infisical API</p>
  20562. </td>
  20563. </tr>
  20564. <tr>
  20565. <td>
  20566. <code>secretsScope</code></br>
  20567. <em>
  20568. <a href="#external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">
  20569. MachineIdentityScopeInWorkspace
  20570. </a>
  20571. </em>
  20572. </td>
  20573. <td>
  20574. <p>SecretsScope defines the scope of the secrets within the workspace</p>
  20575. </td>
  20576. </tr>
  20577. <tr>
  20578. <td>
  20579. <code>hostAPI</code></br>
  20580. <em>
  20581. string
  20582. </em>
  20583. </td>
  20584. <td>
  20585. <em>(Optional)</em>
  20586. <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>
  20587. </td>
  20588. </tr>
  20589. </tbody>
  20590. </table>
  20591. <h3 id="external-secrets.io/v1beta1.KeeperSecurityProvider">KeeperSecurityProvider
  20592. </h3>
  20593. <p>
  20594. (<em>Appears on:</em>
  20595. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20596. </p>
  20597. <p>
  20598. <p>KeeperSecurityProvider Configures a store to sync secrets using Keeper Security.</p>
  20599. </p>
  20600. <table>
  20601. <thead>
  20602. <tr>
  20603. <th>Field</th>
  20604. <th>Description</th>
  20605. </tr>
  20606. </thead>
  20607. <tbody>
  20608. <tr>
  20609. <td>
  20610. <code>authRef</code></br>
  20611. <em>
  20612. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20613. External Secrets meta/v1.SecretKeySelector
  20614. </a>
  20615. </em>
  20616. </td>
  20617. <td>
  20618. </td>
  20619. </tr>
  20620. <tr>
  20621. <td>
  20622. <code>folderID</code></br>
  20623. <em>
  20624. string
  20625. </em>
  20626. </td>
  20627. <td>
  20628. </td>
  20629. </tr>
  20630. </tbody>
  20631. </table>
  20632. <h3 id="external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth
  20633. </h3>
  20634. <p>
  20635. (<em>Appears on:</em>
  20636. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  20637. </p>
  20638. <p>
  20639. <p>KubernetesAuth defines authentication methods for the Kubernetes provider.</p>
  20640. </p>
  20641. <table>
  20642. <thead>
  20643. <tr>
  20644. <th>Field</th>
  20645. <th>Description</th>
  20646. </tr>
  20647. </thead>
  20648. <tbody>
  20649. <tr>
  20650. <td>
  20651. <code>cert</code></br>
  20652. <em>
  20653. <a href="#external-secrets.io/v1beta1.CertAuth">
  20654. CertAuth
  20655. </a>
  20656. </em>
  20657. </td>
  20658. <td>
  20659. <em>(Optional)</em>
  20660. <p>has both clientCert and clientKey as secretKeySelector</p>
  20661. </td>
  20662. </tr>
  20663. <tr>
  20664. <td>
  20665. <code>token</code></br>
  20666. <em>
  20667. <a href="#external-secrets.io/v1beta1.TokenAuth">
  20668. TokenAuth
  20669. </a>
  20670. </em>
  20671. </td>
  20672. <td>
  20673. <em>(Optional)</em>
  20674. <p>use static token to authenticate with</p>
  20675. </td>
  20676. </tr>
  20677. <tr>
  20678. <td>
  20679. <code>serviceAccount</code></br>
  20680. <em>
  20681. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  20682. External Secrets meta/v1.ServiceAccountSelector
  20683. </a>
  20684. </em>
  20685. </td>
  20686. <td>
  20687. <em>(Optional)</em>
  20688. <p>points to a service account that should be used for authentication</p>
  20689. </td>
  20690. </tr>
  20691. </tbody>
  20692. </table>
  20693. <h3 id="external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider
  20694. </h3>
  20695. <p>
  20696. (<em>Appears on:</em>
  20697. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  20698. </p>
  20699. <p>
  20700. <p>KubernetesProvider configures a store to sync secrets with a Kubernetes instance.</p>
  20701. </p>
  20702. <table>
  20703. <thead>
  20704. <tr>
  20705. <th>Field</th>
  20706. <th>Description</th>
  20707. </tr>
  20708. </thead>
  20709. <tbody>
  20710. <tr>
  20711. <td>
  20712. <code>server</code></br>
  20713. <em>
  20714. <a href="#external-secrets.io/v1beta1.KubernetesServer">
  20715. KubernetesServer
  20716. </a>
  20717. </em>
  20718. </td>
  20719. <td>
  20720. <em>(Optional)</em>
  20721. <p>configures the Kubernetes server Address.</p>
  20722. </td>
  20723. </tr>
  20724. <tr>
  20725. <td>
  20726. <code>auth</code></br>
  20727. <em>
  20728. <a href="#external-secrets.io/v1beta1.KubernetesAuth">
  20729. KubernetesAuth
  20730. </a>
  20731. </em>
  20732. </td>
  20733. <td>
  20734. <em>(Optional)</em>
  20735. <p>Auth configures how secret-manager authenticates with a Kubernetes instance.</p>
  20736. </td>
  20737. </tr>
  20738. <tr>
  20739. <td>
  20740. <code>authRef</code></br>
  20741. <em>
  20742. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20743. External Secrets meta/v1.SecretKeySelector
  20744. </a>
  20745. </em>
  20746. </td>
  20747. <td>
  20748. <em>(Optional)</em>
  20749. <p>A reference to a secret that contains the auth information.</p>
  20750. </td>
  20751. </tr>
  20752. <tr>
  20753. <td>
  20754. <code>remoteNamespace</code></br>
  20755. <em>
  20756. string
  20757. </em>
  20758. </td>
  20759. <td>
  20760. <em>(Optional)</em>
  20761. <p>Remote namespace to fetch the secrets from</p>
  20762. </td>
  20763. </tr>
  20764. </tbody>
  20765. </table>
  20766. <h3 id="external-secrets.io/v1beta1.KubernetesServer">KubernetesServer
  20767. </h3>
  20768. <p>
  20769. (<em>Appears on:</em>
  20770. <a href="#external-secrets.io/v1beta1.KubernetesProvider">KubernetesProvider</a>)
  20771. </p>
  20772. <p>
  20773. <p>KubernetesServer defines the Kubernetes server connection configuration.</p>
  20774. </p>
  20775. <table>
  20776. <thead>
  20777. <tr>
  20778. <th>Field</th>
  20779. <th>Description</th>
  20780. </tr>
  20781. </thead>
  20782. <tbody>
  20783. <tr>
  20784. <td>
  20785. <code>url</code></br>
  20786. <em>
  20787. string
  20788. </em>
  20789. </td>
  20790. <td>
  20791. <em>(Optional)</em>
  20792. <p>configures the Kubernetes server Address.</p>
  20793. </td>
  20794. </tr>
  20795. <tr>
  20796. <td>
  20797. <code>caBundle</code></br>
  20798. <em>
  20799. []byte
  20800. </em>
  20801. </td>
  20802. <td>
  20803. <em>(Optional)</em>
  20804. <p>CABundle is a base64-encoded CA certificate</p>
  20805. </td>
  20806. </tr>
  20807. <tr>
  20808. <td>
  20809. <code>caProvider</code></br>
  20810. <em>
  20811. <a href="#external-secrets.io/v1beta1.CAProvider">
  20812. CAProvider
  20813. </a>
  20814. </em>
  20815. </td>
  20816. <td>
  20817. <em>(Optional)</em>
  20818. <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>
  20819. </td>
  20820. </tr>
  20821. </tbody>
  20822. </table>
  20823. <h3 id="external-secrets.io/v1beta1.MachineIdentityScopeInWorkspace">MachineIdentityScopeInWorkspace
  20824. </h3>
  20825. <p>
  20826. (<em>Appears on:</em>
  20827. <a href="#external-secrets.io/v1beta1.InfisicalProvider">InfisicalProvider</a>)
  20828. </p>
  20829. <p>
  20830. <p>MachineIdentityScopeInWorkspace defines the scope of a machine identity in an Infisical workspace.</p>
  20831. </p>
  20832. <table>
  20833. <thead>
  20834. <tr>
  20835. <th>Field</th>
  20836. <th>Description</th>
  20837. </tr>
  20838. </thead>
  20839. <tbody>
  20840. <tr>
  20841. <td>
  20842. <code>secretsPath</code></br>
  20843. <em>
  20844. string
  20845. </em>
  20846. </td>
  20847. <td>
  20848. <em>(Optional)</em>
  20849. <p>SecretsPath specifies the path to the secrets within the workspace. Defaults to &ldquo;/&rdquo; if not provided.</p>
  20850. </td>
  20851. </tr>
  20852. <tr>
  20853. <td>
  20854. <code>recursive</code></br>
  20855. <em>
  20856. bool
  20857. </em>
  20858. </td>
  20859. <td>
  20860. <em>(Optional)</em>
  20861. <p>Recursive indicates whether the secrets should be fetched recursively. Defaults to false if not provided.</p>
  20862. </td>
  20863. </tr>
  20864. <tr>
  20865. <td>
  20866. <code>environmentSlug</code></br>
  20867. <em>
  20868. string
  20869. </em>
  20870. </td>
  20871. <td>
  20872. <p>EnvironmentSlug is the required slug identifier for the environment.</p>
  20873. </td>
  20874. </tr>
  20875. <tr>
  20876. <td>
  20877. <code>projectSlug</code></br>
  20878. <em>
  20879. string
  20880. </em>
  20881. </td>
  20882. <td>
  20883. <p>ProjectSlug is the required slug identifier for the project.</p>
  20884. </td>
  20885. </tr>
  20886. <tr>
  20887. <td>
  20888. <code>expandSecretReferences</code></br>
  20889. <em>
  20890. bool
  20891. </em>
  20892. </td>
  20893. <td>
  20894. <em>(Optional)</em>
  20895. <p>ExpandSecretReferences indicates whether secret references should be expanded. Defaults to true if not provided.</p>
  20896. </td>
  20897. </tr>
  20898. </tbody>
  20899. </table>
  20900. <h3 id="external-secrets.io/v1beta1.NTLMProtocol">NTLMProtocol
  20901. </h3>
  20902. <p>
  20903. (<em>Appears on:</em>
  20904. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">AuthorizationProtocol</a>)
  20905. </p>
  20906. <p>
  20907. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  20908. </p>
  20909. <table>
  20910. <thead>
  20911. <tr>
  20912. <th>Field</th>
  20913. <th>Description</th>
  20914. </tr>
  20915. </thead>
  20916. <tbody>
  20917. <tr>
  20918. <td>
  20919. <code>usernameSecret</code></br>
  20920. <em>
  20921. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20922. External Secrets meta/v1.SecretKeySelector
  20923. </a>
  20924. </em>
  20925. </td>
  20926. <td>
  20927. </td>
  20928. </tr>
  20929. <tr>
  20930. <td>
  20931. <code>passwordSecret</code></br>
  20932. <em>
  20933. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20934. External Secrets meta/v1.SecretKeySelector
  20935. </a>
  20936. </em>
  20937. </td>
  20938. <td>
  20939. </td>
  20940. </tr>
  20941. </tbody>
  20942. </table>
  20943. <h3 id="external-secrets.io/v1beta1.NoSecretError">NoSecretError
  20944. </h3>
  20945. <p>
  20946. <p>NoSecretError shall be returned when a GetSecret can not find the
  20947. desired secret. This is used for deletionPolicy.</p>
  20948. </p>
  20949. <h3 id="external-secrets.io/v1beta1.NotModifiedError">NotModifiedError
  20950. </h3>
  20951. <p>
  20952. <p>NotModifiedError to signal that the webhook received no changes,
  20953. and it should just return without doing anything.</p>
  20954. </p>
  20955. <h3 id="external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">OnboardbaseAuthSecretRef
  20956. </h3>
  20957. <p>
  20958. (<em>Appears on:</em>
  20959. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider</a>)
  20960. </p>
  20961. <p>
  20962. <p>OnboardbaseAuthSecretRef holds secret references for onboardbase API Key credentials.</p>
  20963. </p>
  20964. <table>
  20965. <thead>
  20966. <tr>
  20967. <th>Field</th>
  20968. <th>Description</th>
  20969. </tr>
  20970. </thead>
  20971. <tbody>
  20972. <tr>
  20973. <td>
  20974. <code>apiKeyRef</code></br>
  20975. <em>
  20976. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20977. External Secrets meta/v1.SecretKeySelector
  20978. </a>
  20979. </em>
  20980. </td>
  20981. <td>
  20982. <p>OnboardbaseAPIKey is the APIKey generated by an admin account.
  20983. It is used to recognize and authorize access to a project and environment within onboardbase</p>
  20984. </td>
  20985. </tr>
  20986. <tr>
  20987. <td>
  20988. <code>passcodeRef</code></br>
  20989. <em>
  20990. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  20991. External Secrets meta/v1.SecretKeySelector
  20992. </a>
  20993. </em>
  20994. </td>
  20995. <td>
  20996. <p>OnboardbasePasscode is the passcode attached to the API Key</p>
  20997. </td>
  20998. </tr>
  20999. </tbody>
  21000. </table>
  21001. <h3 id="external-secrets.io/v1beta1.OnboardbaseProvider">OnboardbaseProvider
  21002. </h3>
  21003. <p>
  21004. (<em>Appears on:</em>
  21005. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21006. </p>
  21007. <p>
  21008. <p>OnboardbaseProvider configures a store to sync secrets using the Onboardbase provider.
  21009. Project and Config are required if not using a Service Token.</p>
  21010. </p>
  21011. <table>
  21012. <thead>
  21013. <tr>
  21014. <th>Field</th>
  21015. <th>Description</th>
  21016. </tr>
  21017. </thead>
  21018. <tbody>
  21019. <tr>
  21020. <td>
  21021. <code>auth</code></br>
  21022. <em>
  21023. <a href="#external-secrets.io/v1beta1.OnboardbaseAuthSecretRef">
  21024. OnboardbaseAuthSecretRef
  21025. </a>
  21026. </em>
  21027. </td>
  21028. <td>
  21029. <p>Auth configures how the Operator authenticates with the Onboardbase API</p>
  21030. </td>
  21031. </tr>
  21032. <tr>
  21033. <td>
  21034. <code>apiHost</code></br>
  21035. <em>
  21036. string
  21037. </em>
  21038. </td>
  21039. <td>
  21040. <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>
  21041. </td>
  21042. </tr>
  21043. <tr>
  21044. <td>
  21045. <code>project</code></br>
  21046. <em>
  21047. string
  21048. </em>
  21049. </td>
  21050. <td>
  21051. <p>Project is an onboardbase project that the secrets should be pulled from</p>
  21052. </td>
  21053. </tr>
  21054. <tr>
  21055. <td>
  21056. <code>environment</code></br>
  21057. <em>
  21058. string
  21059. </em>
  21060. </td>
  21061. <td>
  21062. <p>Environment is the name of an environmnent within a project to pull the secrets from</p>
  21063. </td>
  21064. </tr>
  21065. </tbody>
  21066. </table>
  21067. <h3 id="external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth
  21068. </h3>
  21069. <p>
  21070. (<em>Appears on:</em>
  21071. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider</a>)
  21072. </p>
  21073. <p>
  21074. <p>OnePasswordAuth contains a secretRef for credentials.</p>
  21075. </p>
  21076. <table>
  21077. <thead>
  21078. <tr>
  21079. <th>Field</th>
  21080. <th>Description</th>
  21081. </tr>
  21082. </thead>
  21083. <tbody>
  21084. <tr>
  21085. <td>
  21086. <code>secretRef</code></br>
  21087. <em>
  21088. <a href="#external-secrets.io/v1beta1.OnePasswordAuthSecretRef">
  21089. OnePasswordAuthSecretRef
  21090. </a>
  21091. </em>
  21092. </td>
  21093. <td>
  21094. </td>
  21095. </tr>
  21096. </tbody>
  21097. </table>
  21098. <h3 id="external-secrets.io/v1beta1.OnePasswordAuthSecretRef">OnePasswordAuthSecretRef
  21099. </h3>
  21100. <p>
  21101. (<em>Appears on:</em>
  21102. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">OnePasswordAuth</a>)
  21103. </p>
  21104. <p>
  21105. <p>OnePasswordAuthSecretRef holds secret references for 1Password credentials.</p>
  21106. </p>
  21107. <table>
  21108. <thead>
  21109. <tr>
  21110. <th>Field</th>
  21111. <th>Description</th>
  21112. </tr>
  21113. </thead>
  21114. <tbody>
  21115. <tr>
  21116. <td>
  21117. <code>connectTokenSecretRef</code></br>
  21118. <em>
  21119. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21120. External Secrets meta/v1.SecretKeySelector
  21121. </a>
  21122. </em>
  21123. </td>
  21124. <td>
  21125. <p>The ConnectToken is used for authentication to a 1Password Connect Server.</p>
  21126. </td>
  21127. </tr>
  21128. </tbody>
  21129. </table>
  21130. <h3 id="external-secrets.io/v1beta1.OnePasswordProvider">OnePasswordProvider
  21131. </h3>
  21132. <p>
  21133. (<em>Appears on:</em>
  21134. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21135. </p>
  21136. <p>
  21137. <p>OnePasswordProvider configures a store to sync secrets using the 1Password Secret Manager provider.</p>
  21138. </p>
  21139. <table>
  21140. <thead>
  21141. <tr>
  21142. <th>Field</th>
  21143. <th>Description</th>
  21144. </tr>
  21145. </thead>
  21146. <tbody>
  21147. <tr>
  21148. <td>
  21149. <code>auth</code></br>
  21150. <em>
  21151. <a href="#external-secrets.io/v1beta1.OnePasswordAuth">
  21152. OnePasswordAuth
  21153. </a>
  21154. </em>
  21155. </td>
  21156. <td>
  21157. <p>Auth defines the information necessary to authenticate against OnePassword Connect Server</p>
  21158. </td>
  21159. </tr>
  21160. <tr>
  21161. <td>
  21162. <code>connectHost</code></br>
  21163. <em>
  21164. string
  21165. </em>
  21166. </td>
  21167. <td>
  21168. <p>ConnectHost defines the OnePassword Connect Server to connect to</p>
  21169. </td>
  21170. </tr>
  21171. <tr>
  21172. <td>
  21173. <code>vaults</code></br>
  21174. <em>
  21175. map[string]int
  21176. </em>
  21177. </td>
  21178. <td>
  21179. <p>Vaults defines which OnePassword vaults to search in which order</p>
  21180. </td>
  21181. </tr>
  21182. </tbody>
  21183. </table>
  21184. <h3 id="external-secrets.io/v1beta1.OracleAuth">OracleAuth
  21185. </h3>
  21186. <p>
  21187. (<em>Appears on:</em>
  21188. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  21189. </p>
  21190. <p>
  21191. <p>OracleAuth defines authentication configuration for the Oracle Vault provider.</p>
  21192. </p>
  21193. <table>
  21194. <thead>
  21195. <tr>
  21196. <th>Field</th>
  21197. <th>Description</th>
  21198. </tr>
  21199. </thead>
  21200. <tbody>
  21201. <tr>
  21202. <td>
  21203. <code>tenancy</code></br>
  21204. <em>
  21205. string
  21206. </em>
  21207. </td>
  21208. <td>
  21209. <p>Tenancy is the tenancy OCID where user is located.</p>
  21210. </td>
  21211. </tr>
  21212. <tr>
  21213. <td>
  21214. <code>user</code></br>
  21215. <em>
  21216. string
  21217. </em>
  21218. </td>
  21219. <td>
  21220. <p>User is an access OCID specific to the account.</p>
  21221. </td>
  21222. </tr>
  21223. <tr>
  21224. <td>
  21225. <code>secretRef</code></br>
  21226. <em>
  21227. <a href="#external-secrets.io/v1beta1.OracleSecretRef">
  21228. OracleSecretRef
  21229. </a>
  21230. </em>
  21231. </td>
  21232. <td>
  21233. <p>SecretRef to pass through sensitive information.</p>
  21234. </td>
  21235. </tr>
  21236. </tbody>
  21237. </table>
  21238. <h3 id="external-secrets.io/v1beta1.OraclePrincipalType">OraclePrincipalType
  21239. (<code>string</code> alias)</p></h3>
  21240. <p>
  21241. (<em>Appears on:</em>
  21242. <a href="#external-secrets.io/v1beta1.OracleProvider">OracleProvider</a>)
  21243. </p>
  21244. <p>
  21245. <p>OraclePrincipalType defines the type of principal used for authentication to Oracle Vault.</p>
  21246. </p>
  21247. <table>
  21248. <thead>
  21249. <tr>
  21250. <th>Value</th>
  21251. <th>Description</th>
  21252. </tr>
  21253. </thead>
  21254. <tbody><tr><td><p>&#34;InstancePrincipal&#34;</p></td>
  21255. <td><p>InstancePrincipal represents a instance principal.</p>
  21256. </td>
  21257. </tr><tr><td><p>&#34;UserPrincipal&#34;</p></td>
  21258. <td><p>UserPrincipal represents a user principal.</p>
  21259. </td>
  21260. </tr><tr><td><p>&#34;Workload&#34;</p></td>
  21261. <td><p>WorkloadPrincipal represents a workload principal.</p>
  21262. </td>
  21263. </tr></tbody>
  21264. </table>
  21265. <h3 id="external-secrets.io/v1beta1.OracleProvider">OracleProvider
  21266. </h3>
  21267. <p>
  21268. (<em>Appears on:</em>
  21269. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21270. </p>
  21271. <p>
  21272. <p>OracleProvider configures a store to sync secrets using an Oracle Vault backend.</p>
  21273. </p>
  21274. <table>
  21275. <thead>
  21276. <tr>
  21277. <th>Field</th>
  21278. <th>Description</th>
  21279. </tr>
  21280. </thead>
  21281. <tbody>
  21282. <tr>
  21283. <td>
  21284. <code>region</code></br>
  21285. <em>
  21286. string
  21287. </em>
  21288. </td>
  21289. <td>
  21290. <p>Region is the region where vault is located.</p>
  21291. </td>
  21292. </tr>
  21293. <tr>
  21294. <td>
  21295. <code>vault</code></br>
  21296. <em>
  21297. string
  21298. </em>
  21299. </td>
  21300. <td>
  21301. <p>Vault is the vault&rsquo;s OCID of the specific vault where secret is located.</p>
  21302. </td>
  21303. </tr>
  21304. <tr>
  21305. <td>
  21306. <code>compartment</code></br>
  21307. <em>
  21308. string
  21309. </em>
  21310. </td>
  21311. <td>
  21312. <em>(Optional)</em>
  21313. <p>Compartment is the vault compartment OCID.
  21314. Required for PushSecret</p>
  21315. </td>
  21316. </tr>
  21317. <tr>
  21318. <td>
  21319. <code>encryptionKey</code></br>
  21320. <em>
  21321. string
  21322. </em>
  21323. </td>
  21324. <td>
  21325. <em>(Optional)</em>
  21326. <p>EncryptionKey is the OCID of the encryption key within the vault.
  21327. Required for PushSecret</p>
  21328. </td>
  21329. </tr>
  21330. <tr>
  21331. <td>
  21332. <code>principalType</code></br>
  21333. <em>
  21334. <a href="#external-secrets.io/v1beta1.OraclePrincipalType">
  21335. OraclePrincipalType
  21336. </a>
  21337. </em>
  21338. </td>
  21339. <td>
  21340. <em>(Optional)</em>
  21341. <p>The type of principal to use for authentication. If left blank, the Auth struct will
  21342. determine the principal type. This optional field must be specified if using
  21343. workload identity.</p>
  21344. </td>
  21345. </tr>
  21346. <tr>
  21347. <td>
  21348. <code>auth</code></br>
  21349. <em>
  21350. <a href="#external-secrets.io/v1beta1.OracleAuth">
  21351. OracleAuth
  21352. </a>
  21353. </em>
  21354. </td>
  21355. <td>
  21356. <em>(Optional)</em>
  21357. <p>Auth configures how secret-manager authenticates with the Oracle Vault.
  21358. If empty, use the instance principal, otherwise the user credentials specified in Auth.</p>
  21359. </td>
  21360. </tr>
  21361. <tr>
  21362. <td>
  21363. <code>serviceAccountRef</code></br>
  21364. <em>
  21365. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  21366. External Secrets meta/v1.ServiceAccountSelector
  21367. </a>
  21368. </em>
  21369. </td>
  21370. <td>
  21371. <em>(Optional)</em>
  21372. <p>ServiceAccountRef specified the service account
  21373. that should be used when authenticating with WorkloadIdentity.</p>
  21374. </td>
  21375. </tr>
  21376. </tbody>
  21377. </table>
  21378. <h3 id="external-secrets.io/v1beta1.OracleSecretRef">OracleSecretRef
  21379. </h3>
  21380. <p>
  21381. (<em>Appears on:</em>
  21382. <a href="#external-secrets.io/v1beta1.OracleAuth">OracleAuth</a>)
  21383. </p>
  21384. <p>
  21385. <p>OracleSecretRef defines references to secrets containing Oracle credentials.</p>
  21386. </p>
  21387. <table>
  21388. <thead>
  21389. <tr>
  21390. <th>Field</th>
  21391. <th>Description</th>
  21392. </tr>
  21393. </thead>
  21394. <tbody>
  21395. <tr>
  21396. <td>
  21397. <code>privatekey</code></br>
  21398. <em>
  21399. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21400. External Secrets meta/v1.SecretKeySelector
  21401. </a>
  21402. </em>
  21403. </td>
  21404. <td>
  21405. <p>PrivateKey is the user&rsquo;s API Signing Key in PEM format, used for authentication.</p>
  21406. </td>
  21407. </tr>
  21408. <tr>
  21409. <td>
  21410. <code>fingerprint</code></br>
  21411. <em>
  21412. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21413. External Secrets meta/v1.SecretKeySelector
  21414. </a>
  21415. </em>
  21416. </td>
  21417. <td>
  21418. <p>Fingerprint is the fingerprint of the API private key.</p>
  21419. </td>
  21420. </tr>
  21421. </tbody>
  21422. </table>
  21423. <h3 id="external-secrets.io/v1beta1.PassboltAuth">PassboltAuth
  21424. </h3>
  21425. <p>
  21426. (<em>Appears on:</em>
  21427. <a href="#external-secrets.io/v1beta1.PassboltProvider">PassboltProvider</a>)
  21428. </p>
  21429. <p>
  21430. <p>PassboltAuth contains credentials and configuration for authenticating with the Passbolt server.</p>
  21431. </p>
  21432. <table>
  21433. <thead>
  21434. <tr>
  21435. <th>Field</th>
  21436. <th>Description</th>
  21437. </tr>
  21438. </thead>
  21439. <tbody>
  21440. <tr>
  21441. <td>
  21442. <code>passwordSecretRef</code></br>
  21443. <em>
  21444. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21445. External Secrets meta/v1.SecretKeySelector
  21446. </a>
  21447. </em>
  21448. </td>
  21449. <td>
  21450. <p>PasswordSecretRef is a reference to the secret containing the Passbolt password</p>
  21451. </td>
  21452. </tr>
  21453. <tr>
  21454. <td>
  21455. <code>privateKeySecretRef</code></br>
  21456. <em>
  21457. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21458. External Secrets meta/v1.SecretKeySelector
  21459. </a>
  21460. </em>
  21461. </td>
  21462. <td>
  21463. <p>PrivateKeySecretRef is a reference to the secret containing the Passbolt private key</p>
  21464. </td>
  21465. </tr>
  21466. </tbody>
  21467. </table>
  21468. <h3 id="external-secrets.io/v1beta1.PassboltProvider">PassboltProvider
  21469. </h3>
  21470. <p>
  21471. (<em>Appears on:</em>
  21472. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21473. </p>
  21474. <p>
  21475. <p>PassboltProvider defines configuration for the Passbolt provider.</p>
  21476. </p>
  21477. <table>
  21478. <thead>
  21479. <tr>
  21480. <th>Field</th>
  21481. <th>Description</th>
  21482. </tr>
  21483. </thead>
  21484. <tbody>
  21485. <tr>
  21486. <td>
  21487. <code>auth</code></br>
  21488. <em>
  21489. <a href="#external-secrets.io/v1beta1.PassboltAuth">
  21490. PassboltAuth
  21491. </a>
  21492. </em>
  21493. </td>
  21494. <td>
  21495. <p>Auth defines the information necessary to authenticate against Passbolt Server</p>
  21496. </td>
  21497. </tr>
  21498. <tr>
  21499. <td>
  21500. <code>host</code></br>
  21501. <em>
  21502. string
  21503. </em>
  21504. </td>
  21505. <td>
  21506. <p>Host defines the Passbolt Server to connect to</p>
  21507. </td>
  21508. </tr>
  21509. </tbody>
  21510. </table>
  21511. <h3 id="external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth
  21512. </h3>
  21513. <p>
  21514. (<em>Appears on:</em>
  21515. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider</a>)
  21516. </p>
  21517. <p>
  21518. <p>PasswordDepotAuth defines the authentication method for the Password Depot provider.</p>
  21519. </p>
  21520. <table>
  21521. <thead>
  21522. <tr>
  21523. <th>Field</th>
  21524. <th>Description</th>
  21525. </tr>
  21526. </thead>
  21527. <tbody>
  21528. <tr>
  21529. <td>
  21530. <code>secretRef</code></br>
  21531. <em>
  21532. <a href="#external-secrets.io/v1beta1.PasswordDepotSecretRef">
  21533. PasswordDepotSecretRef
  21534. </a>
  21535. </em>
  21536. </td>
  21537. <td>
  21538. </td>
  21539. </tr>
  21540. </tbody>
  21541. </table>
  21542. <h3 id="external-secrets.io/v1beta1.PasswordDepotProvider">PasswordDepotProvider
  21543. </h3>
  21544. <p>
  21545. (<em>Appears on:</em>
  21546. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21547. </p>
  21548. <p>
  21549. <p>PasswordDepotProvider configures a store to sync secrets with a Password Depot instance.</p>
  21550. </p>
  21551. <table>
  21552. <thead>
  21553. <tr>
  21554. <th>Field</th>
  21555. <th>Description</th>
  21556. </tr>
  21557. </thead>
  21558. <tbody>
  21559. <tr>
  21560. <td>
  21561. <code>host</code></br>
  21562. <em>
  21563. string
  21564. </em>
  21565. </td>
  21566. <td>
  21567. <p>URL configures the Password Depot instance URL.</p>
  21568. </td>
  21569. </tr>
  21570. <tr>
  21571. <td>
  21572. <code>database</code></br>
  21573. <em>
  21574. string
  21575. </em>
  21576. </td>
  21577. <td>
  21578. <p>Database to use as source</p>
  21579. </td>
  21580. </tr>
  21581. <tr>
  21582. <td>
  21583. <code>auth</code></br>
  21584. <em>
  21585. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">
  21586. PasswordDepotAuth
  21587. </a>
  21588. </em>
  21589. </td>
  21590. <td>
  21591. <p>Auth configures how secret-manager authenticates with a Password Depot instance.</p>
  21592. </td>
  21593. </tr>
  21594. </tbody>
  21595. </table>
  21596. <h3 id="external-secrets.io/v1beta1.PasswordDepotSecretRef">PasswordDepotSecretRef
  21597. </h3>
  21598. <p>
  21599. (<em>Appears on:</em>
  21600. <a href="#external-secrets.io/v1beta1.PasswordDepotAuth">PasswordDepotAuth</a>)
  21601. </p>
  21602. <p>
  21603. <p>PasswordDepotSecretRef defines a reference to a secret containing credentials for the Password Depot provider.</p>
  21604. </p>
  21605. <table>
  21606. <thead>
  21607. <tr>
  21608. <th>Field</th>
  21609. <th>Description</th>
  21610. </tr>
  21611. </thead>
  21612. <tbody>
  21613. <tr>
  21614. <td>
  21615. <code>credentials</code></br>
  21616. <em>
  21617. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21618. External Secrets meta/v1.SecretKeySelector
  21619. </a>
  21620. </em>
  21621. </td>
  21622. <td>
  21623. <em>(Optional)</em>
  21624. <p>Username / Password is used for authentication.</p>
  21625. </td>
  21626. </tr>
  21627. </tbody>
  21628. </table>
  21629. <h3 id="external-secrets.io/v1beta1.PreviderAuth">PreviderAuth
  21630. </h3>
  21631. <p>
  21632. (<em>Appears on:</em>
  21633. <a href="#external-secrets.io/v1beta1.PreviderProvider">PreviderProvider</a>)
  21634. </p>
  21635. <p>
  21636. <p>PreviderAuth contains a secretRef for credentials.</p>
  21637. </p>
  21638. <table>
  21639. <thead>
  21640. <tr>
  21641. <th>Field</th>
  21642. <th>Description</th>
  21643. </tr>
  21644. </thead>
  21645. <tbody>
  21646. <tr>
  21647. <td>
  21648. <code>secretRef</code></br>
  21649. <em>
  21650. <a href="#external-secrets.io/v1beta1.PreviderAuthSecretRef">
  21651. PreviderAuthSecretRef
  21652. </a>
  21653. </em>
  21654. </td>
  21655. <td>
  21656. <em>(Optional)</em>
  21657. </td>
  21658. </tr>
  21659. </tbody>
  21660. </table>
  21661. <h3 id="external-secrets.io/v1beta1.PreviderAuthSecretRef">PreviderAuthSecretRef
  21662. </h3>
  21663. <p>
  21664. (<em>Appears on:</em>
  21665. <a href="#external-secrets.io/v1beta1.PreviderAuth">PreviderAuth</a>)
  21666. </p>
  21667. <p>
  21668. <p>PreviderAuthSecretRef holds secret references for Previder Vault credentials.</p>
  21669. </p>
  21670. <table>
  21671. <thead>
  21672. <tr>
  21673. <th>Field</th>
  21674. <th>Description</th>
  21675. </tr>
  21676. </thead>
  21677. <tbody>
  21678. <tr>
  21679. <td>
  21680. <code>accessToken</code></br>
  21681. <em>
  21682. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21683. External Secrets meta/v1.SecretKeySelector
  21684. </a>
  21685. </em>
  21686. </td>
  21687. <td>
  21688. <p>The AccessToken is used for authentication</p>
  21689. </td>
  21690. </tr>
  21691. </tbody>
  21692. </table>
  21693. <h3 id="external-secrets.io/v1beta1.PreviderProvider">PreviderProvider
  21694. </h3>
  21695. <p>
  21696. (<em>Appears on:</em>
  21697. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21698. </p>
  21699. <p>
  21700. <p>PreviderProvider configures a store to sync secrets using the Previder Secret Manager provider.</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>auth</code></br>
  21713. <em>
  21714. <a href="#external-secrets.io/v1beta1.PreviderAuth">
  21715. PreviderAuth
  21716. </a>
  21717. </em>
  21718. </td>
  21719. <td>
  21720. </td>
  21721. </tr>
  21722. <tr>
  21723. <td>
  21724. <code>baseUri</code></br>
  21725. <em>
  21726. string
  21727. </em>
  21728. </td>
  21729. <td>
  21730. <em>(Optional)</em>
  21731. </td>
  21732. </tr>
  21733. </tbody>
  21734. </table>
  21735. <h3 id="external-secrets.io/v1beta1.Provider">Provider
  21736. </h3>
  21737. <p>
  21738. <p>Provider is a common interface for interacting with secret backends.</p>
  21739. </p>
  21740. <h3 id="external-secrets.io/v1beta1.PulumiProvider">PulumiProvider
  21741. </h3>
  21742. <p>
  21743. (<em>Appears on:</em>
  21744. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21745. </p>
  21746. <p>
  21747. <p>PulumiProvider defines configuration for the Pulumi provider.</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>apiUrl</code></br>
  21760. <em>
  21761. string
  21762. </em>
  21763. </td>
  21764. <td>
  21765. <p>APIURL is the URL of the Pulumi API.</p>
  21766. </td>
  21767. </tr>
  21768. <tr>
  21769. <td>
  21770. <code>accessToken</code></br>
  21771. <em>
  21772. <a href="#external-secrets.io/v1beta1.PulumiProviderSecretRef">
  21773. PulumiProviderSecretRef
  21774. </a>
  21775. </em>
  21776. </td>
  21777. <td>
  21778. <p>AccessToken is the access tokens to sign in to the Pulumi Cloud Console.</p>
  21779. </td>
  21780. </tr>
  21781. <tr>
  21782. <td>
  21783. <code>organization</code></br>
  21784. <em>
  21785. string
  21786. </em>
  21787. </td>
  21788. <td>
  21789. <p>Organization are a space to collaborate on shared projects and stacks.
  21790. To create a new organization, visit <a href="https://app.pulumi.com/">https://app.pulumi.com/</a> and click &ldquo;New Organization&rdquo;.</p>
  21791. </td>
  21792. </tr>
  21793. <tr>
  21794. <td>
  21795. <code>project</code></br>
  21796. <em>
  21797. string
  21798. </em>
  21799. </td>
  21800. <td>
  21801. <p>Project is the name of the Pulumi ESC project the environment belongs to.</p>
  21802. </td>
  21803. </tr>
  21804. <tr>
  21805. <td>
  21806. <code>environment</code></br>
  21807. <em>
  21808. string
  21809. </em>
  21810. </td>
  21811. <td>
  21812. <p>Environment are YAML documents composed of static key-value pairs, programmatic expressions,
  21813. dynamically retrieved values from supported providers including all major clouds,
  21814. and other Pulumi ESC environments.
  21815. 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>
  21816. </td>
  21817. </tr>
  21818. </tbody>
  21819. </table>
  21820. <h3 id="external-secrets.io/v1beta1.PulumiProviderSecretRef">PulumiProviderSecretRef
  21821. </h3>
  21822. <p>
  21823. (<em>Appears on:</em>
  21824. <a href="#external-secrets.io/v1beta1.PulumiProvider">PulumiProvider</a>)
  21825. </p>
  21826. <p>
  21827. <p>PulumiProviderSecretRef defines a reference to a secret containing credentials for the Pulumi provider.</p>
  21828. </p>
  21829. <table>
  21830. <thead>
  21831. <tr>
  21832. <th>Field</th>
  21833. <th>Description</th>
  21834. </tr>
  21835. </thead>
  21836. <tbody>
  21837. <tr>
  21838. <td>
  21839. <code>secretRef</code></br>
  21840. <em>
  21841. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21842. External Secrets meta/v1.SecretKeySelector
  21843. </a>
  21844. </em>
  21845. </td>
  21846. <td>
  21847. <p>SecretRef is a reference to a secret containing the Pulumi API token.</p>
  21848. </td>
  21849. </tr>
  21850. </tbody>
  21851. </table>
  21852. <h3 id="external-secrets.io/v1beta1.PushSecretData">PushSecretData
  21853. </h3>
  21854. <p>
  21855. <p>PushSecretData is an interface to allow using v1alpha1.PushSecretData content in Provider registered in v1beta1.</p>
  21856. </p>
  21857. <h3 id="external-secrets.io/v1beta1.PushSecretRemoteRef">PushSecretRemoteRef
  21858. </h3>
  21859. <p>
  21860. <p>PushSecretRemoteRef is an interface to allow using v1alpha1.PushSecretRemoteRef in Provider registered in v1beta1.</p>
  21861. </p>
  21862. <h3 id="external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider
  21863. </h3>
  21864. <p>
  21865. (<em>Appears on:</em>
  21866. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21867. </p>
  21868. <p>
  21869. <p>ScalewayProvider defines configuration for the Scaleway provider.</p>
  21870. </p>
  21871. <table>
  21872. <thead>
  21873. <tr>
  21874. <th>Field</th>
  21875. <th>Description</th>
  21876. </tr>
  21877. </thead>
  21878. <tbody>
  21879. <tr>
  21880. <td>
  21881. <code>apiUrl</code></br>
  21882. <em>
  21883. string
  21884. </em>
  21885. </td>
  21886. <td>
  21887. <em>(Optional)</em>
  21888. <p>APIURL is the url of the api to use. Defaults to <a href="https://api.scaleway.com">https://api.scaleway.com</a></p>
  21889. </td>
  21890. </tr>
  21891. <tr>
  21892. <td>
  21893. <code>region</code></br>
  21894. <em>
  21895. string
  21896. </em>
  21897. </td>
  21898. <td>
  21899. <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>
  21900. </td>
  21901. </tr>
  21902. <tr>
  21903. <td>
  21904. <code>projectId</code></br>
  21905. <em>
  21906. string
  21907. </em>
  21908. </td>
  21909. <td>
  21910. <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>
  21911. </td>
  21912. </tr>
  21913. <tr>
  21914. <td>
  21915. <code>accessKey</code></br>
  21916. <em>
  21917. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  21918. ScalewayProviderSecretRef
  21919. </a>
  21920. </em>
  21921. </td>
  21922. <td>
  21923. <p>AccessKey is the non-secret part of the api key.</p>
  21924. </td>
  21925. </tr>
  21926. <tr>
  21927. <td>
  21928. <code>secretKey</code></br>
  21929. <em>
  21930. <a href="#external-secrets.io/v1beta1.ScalewayProviderSecretRef">
  21931. ScalewayProviderSecretRef
  21932. </a>
  21933. </em>
  21934. </td>
  21935. <td>
  21936. <p>SecretKey is the non-secret part of the api key.</p>
  21937. </td>
  21938. </tr>
  21939. </tbody>
  21940. </table>
  21941. <h3 id="external-secrets.io/v1beta1.ScalewayProviderSecretRef">ScalewayProviderSecretRef
  21942. </h3>
  21943. <p>
  21944. (<em>Appears on:</em>
  21945. <a href="#external-secrets.io/v1beta1.ScalewayProvider">ScalewayProvider</a>)
  21946. </p>
  21947. <p>
  21948. <p>ScalewayProviderSecretRef defines a reference to a secret containing credentials for the Scaleway provider.</p>
  21949. </p>
  21950. <table>
  21951. <thead>
  21952. <tr>
  21953. <th>Field</th>
  21954. <th>Description</th>
  21955. </tr>
  21956. </thead>
  21957. <tbody>
  21958. <tr>
  21959. <td>
  21960. <code>value</code></br>
  21961. <em>
  21962. string
  21963. </em>
  21964. </td>
  21965. <td>
  21966. <em>(Optional)</em>
  21967. <p>Value can be specified directly to set a value without using a secret.</p>
  21968. </td>
  21969. </tr>
  21970. <tr>
  21971. <td>
  21972. <code>secretRef</code></br>
  21973. <em>
  21974. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  21975. External Secrets meta/v1.SecretKeySelector
  21976. </a>
  21977. </em>
  21978. </td>
  21979. <td>
  21980. <em>(Optional)</em>
  21981. <p>SecretRef references a key in a secret that will be used as value.</p>
  21982. </td>
  21983. </tr>
  21984. </tbody>
  21985. </table>
  21986. <h3 id="external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider
  21987. </h3>
  21988. <p>
  21989. (<em>Appears on:</em>
  21990. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  21991. </p>
  21992. <p>
  21993. <p>SecretServerProvider defines configuration for the Delinea Secret Server provider.
  21994. 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>
  21995. </p>
  21996. <table>
  21997. <thead>
  21998. <tr>
  21999. <th>Field</th>
  22000. <th>Description</th>
  22001. </tr>
  22002. </thead>
  22003. <tbody>
  22004. <tr>
  22005. <td>
  22006. <code>username</code></br>
  22007. <em>
  22008. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  22009. SecretServerProviderRef
  22010. </a>
  22011. </em>
  22012. </td>
  22013. <td>
  22014. <p>Username is the secret server account username.</p>
  22015. </td>
  22016. </tr>
  22017. <tr>
  22018. <td>
  22019. <code>password</code></br>
  22020. <em>
  22021. <a href="#external-secrets.io/v1beta1.SecretServerProviderRef">
  22022. SecretServerProviderRef
  22023. </a>
  22024. </em>
  22025. </td>
  22026. <td>
  22027. <p>Password is the secret server account password.</p>
  22028. </td>
  22029. </tr>
  22030. <tr>
  22031. <td>
  22032. <code>serverURL</code></br>
  22033. <em>
  22034. string
  22035. </em>
  22036. </td>
  22037. <td>
  22038. <p>ServerURL
  22039. URL to your secret server installation</p>
  22040. </td>
  22041. </tr>
  22042. </tbody>
  22043. </table>
  22044. <h3 id="external-secrets.io/v1beta1.SecretServerProviderRef">SecretServerProviderRef
  22045. </h3>
  22046. <p>
  22047. (<em>Appears on:</em>
  22048. <a href="#external-secrets.io/v1beta1.SecretServerProvider">SecretServerProvider</a>)
  22049. </p>
  22050. <p>
  22051. <p>SecretServerProviderRef defines a reference to a secret containing credentials for the Secret Server provider.</p>
  22052. </p>
  22053. <table>
  22054. <thead>
  22055. <tr>
  22056. <th>Field</th>
  22057. <th>Description</th>
  22058. </tr>
  22059. </thead>
  22060. <tbody>
  22061. <tr>
  22062. <td>
  22063. <code>value</code></br>
  22064. <em>
  22065. string
  22066. </em>
  22067. </td>
  22068. <td>
  22069. <em>(Optional)</em>
  22070. <p>Value can be specified directly to set a value without using a secret.</p>
  22071. </td>
  22072. </tr>
  22073. <tr>
  22074. <td>
  22075. <code>secretRef</code></br>
  22076. <em>
  22077. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  22078. External Secrets meta/v1.SecretKeySelector
  22079. </a>
  22080. </em>
  22081. </td>
  22082. <td>
  22083. <em>(Optional)</em>
  22084. <p>SecretRef references a key in a secret that will be used as value.</p>
  22085. </td>
  22086. </tr>
  22087. </tbody>
  22088. </table>
  22089. <h3 id="external-secrets.io/v1beta1.SecretStore">SecretStore
  22090. </h3>
  22091. <p>
  22092. <p>SecretStore represents a secure external location for storing secrets, which can be referenced as part of <code>storeRef</code> fields.</p>
  22093. </p>
  22094. <table>
  22095. <thead>
  22096. <tr>
  22097. <th>Field</th>
  22098. <th>Description</th>
  22099. </tr>
  22100. </thead>
  22101. <tbody>
  22102. <tr>
  22103. <td>
  22104. <code>metadata</code></br>
  22105. <em>
  22106. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  22107. Kubernetes meta/v1.ObjectMeta
  22108. </a>
  22109. </em>
  22110. </td>
  22111. <td>
  22112. Refer to the Kubernetes API documentation for the fields of the
  22113. <code>metadata</code> field.
  22114. </td>
  22115. </tr>
  22116. <tr>
  22117. <td>
  22118. <code>spec</code></br>
  22119. <em>
  22120. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">
  22121. SecretStoreSpec
  22122. </a>
  22123. </em>
  22124. </td>
  22125. <td>
  22126. <br/>
  22127. <br/>
  22128. <table>
  22129. <tr>
  22130. <td>
  22131. <code>controller</code></br>
  22132. <em>
  22133. string
  22134. </em>
  22135. </td>
  22136. <td>
  22137. <em>(Optional)</em>
  22138. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  22139. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  22140. </td>
  22141. </tr>
  22142. <tr>
  22143. <td>
  22144. <code>provider</code></br>
  22145. <em>
  22146. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  22147. SecretStoreProvider
  22148. </a>
  22149. </em>
  22150. </td>
  22151. <td>
  22152. <p>Used to configure the provider. Only one provider may be set</p>
  22153. </td>
  22154. </tr>
  22155. <tr>
  22156. <td>
  22157. <code>retrySettings</code></br>
  22158. <em>
  22159. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  22160. SecretStoreRetrySettings
  22161. </a>
  22162. </em>
  22163. </td>
  22164. <td>
  22165. <em>(Optional)</em>
  22166. <p>Used to configure HTTP retries on failures.</p>
  22167. </td>
  22168. </tr>
  22169. <tr>
  22170. <td>
  22171. <code>refreshInterval</code></br>
  22172. <em>
  22173. int
  22174. </em>
  22175. </td>
  22176. <td>
  22177. <em>(Optional)</em>
  22178. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  22179. </td>
  22180. </tr>
  22181. <tr>
  22182. <td>
  22183. <code>conditions</code></br>
  22184. <em>
  22185. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  22186. []ClusterSecretStoreCondition
  22187. </a>
  22188. </em>
  22189. </td>
  22190. <td>
  22191. <em>(Optional)</em>
  22192. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  22193. </td>
  22194. </tr>
  22195. </table>
  22196. </td>
  22197. </tr>
  22198. <tr>
  22199. <td>
  22200. <code>status</code></br>
  22201. <em>
  22202. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">
  22203. SecretStoreStatus
  22204. </a>
  22205. </em>
  22206. </td>
  22207. <td>
  22208. </td>
  22209. </tr>
  22210. </tbody>
  22211. </table>
  22212. <h3 id="external-secrets.io/v1beta1.SecretStoreCapabilities">SecretStoreCapabilities
  22213. (<code>string</code> alias)</p></h3>
  22214. <p>
  22215. (<em>Appears on:</em>
  22216. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  22217. </p>
  22218. <p>
  22219. <p>SecretStoreCapabilities defines the possible operations a SecretStore can do.</p>
  22220. </p>
  22221. <table>
  22222. <thead>
  22223. <tr>
  22224. <th>Value</th>
  22225. <th>Description</th>
  22226. </tr>
  22227. </thead>
  22228. <tbody><tr><td><p>&#34;ReadOnly&#34;</p></td>
  22229. <td><p>SecretStoreReadOnly indicates that the SecretStore only supports reading secrets.</p>
  22230. </td>
  22231. </tr><tr><td><p>&#34;ReadWrite&#34;</p></td>
  22232. <td><p>SecretStoreReadWrite indicates that the SecretStore supports both reading and writing secrets.</p>
  22233. </td>
  22234. </tr><tr><td><p>&#34;WriteOnly&#34;</p></td>
  22235. <td><p>SecretStoreWriteOnly indicates that the SecretStore only supports writing secrets.</p>
  22236. </td>
  22237. </tr></tbody>
  22238. </table>
  22239. <h3 id="external-secrets.io/v1beta1.SecretStoreConditionType">SecretStoreConditionType
  22240. (<code>string</code> alias)</p></h3>
  22241. <p>
  22242. (<em>Appears on:</em>
  22243. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition</a>)
  22244. </p>
  22245. <p>
  22246. <p>SecretStoreConditionType represents the condition type of the SecretStore.</p>
  22247. </p>
  22248. <table>
  22249. <thead>
  22250. <tr>
  22251. <th>Value</th>
  22252. <th>Description</th>
  22253. </tr>
  22254. </thead>
  22255. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  22256. <td><p>SecretStoreReady indicates that the SecretStore has been successfully configured.</p>
  22257. </td>
  22258. </tr></tbody>
  22259. </table>
  22260. <h3 id="external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider
  22261. </h3>
  22262. <p>
  22263. (<em>Appears on:</em>
  22264. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  22265. </p>
  22266. <p>
  22267. <p>SecretStoreProvider contains the provider-specific configuration.</p>
  22268. </p>
  22269. <table>
  22270. <thead>
  22271. <tr>
  22272. <th>Field</th>
  22273. <th>Description</th>
  22274. </tr>
  22275. </thead>
  22276. <tbody>
  22277. <tr>
  22278. <td>
  22279. <code>aws</code></br>
  22280. <em>
  22281. <a href="#external-secrets.io/v1beta1.AWSProvider">
  22282. AWSProvider
  22283. </a>
  22284. </em>
  22285. </td>
  22286. <td>
  22287. <em>(Optional)</em>
  22288. <p>AWS configures this store to sync secrets using AWS Secret Manager provider</p>
  22289. </td>
  22290. </tr>
  22291. <tr>
  22292. <td>
  22293. <code>azurekv</code></br>
  22294. <em>
  22295. <a href="#external-secrets.io/v1beta1.AzureKVProvider">
  22296. AzureKVProvider
  22297. </a>
  22298. </em>
  22299. </td>
  22300. <td>
  22301. <em>(Optional)</em>
  22302. <p>AzureKV configures this store to sync secrets using Azure Key Vault provider</p>
  22303. </td>
  22304. </tr>
  22305. <tr>
  22306. <td>
  22307. <code>akeyless</code></br>
  22308. <em>
  22309. <a href="#external-secrets.io/v1beta1.AkeylessProvider">
  22310. AkeylessProvider
  22311. </a>
  22312. </em>
  22313. </td>
  22314. <td>
  22315. <em>(Optional)</em>
  22316. <p>Akeyless configures this store to sync secrets using Akeyless Vault provider</p>
  22317. </td>
  22318. </tr>
  22319. <tr>
  22320. <td>
  22321. <code>bitwardensecretsmanager</code></br>
  22322. <em>
  22323. <a href="#external-secrets.io/v1beta1.BitwardenSecretsManagerProvider">
  22324. BitwardenSecretsManagerProvider
  22325. </a>
  22326. </em>
  22327. </td>
  22328. <td>
  22329. <em>(Optional)</em>
  22330. <p>BitwardenSecretsManager configures this store to sync secrets using BitwardenSecretsManager provider</p>
  22331. </td>
  22332. </tr>
  22333. <tr>
  22334. <td>
  22335. <code>vault</code></br>
  22336. <em>
  22337. <a href="#external-secrets.io/v1beta1.VaultProvider">
  22338. VaultProvider
  22339. </a>
  22340. </em>
  22341. </td>
  22342. <td>
  22343. <em>(Optional)</em>
  22344. <p>Vault configures this store to sync secrets using the HashiCorp Vault provider.</p>
  22345. </td>
  22346. </tr>
  22347. <tr>
  22348. <td>
  22349. <code>gcpsm</code></br>
  22350. <em>
  22351. <a href="#external-secrets.io/v1beta1.GCPSMProvider">
  22352. GCPSMProvider
  22353. </a>
  22354. </em>
  22355. </td>
  22356. <td>
  22357. <em>(Optional)</em>
  22358. <p>GCPSM configures this store to sync secrets using Google Cloud Platform Secret Manager provider</p>
  22359. </td>
  22360. </tr>
  22361. <tr>
  22362. <td>
  22363. <code>oracle</code></br>
  22364. <em>
  22365. <a href="#external-secrets.io/v1beta1.OracleProvider">
  22366. OracleProvider
  22367. </a>
  22368. </em>
  22369. </td>
  22370. <td>
  22371. <em>(Optional)</em>
  22372. <p>Oracle configures this store to sync secrets using Oracle Vault provider</p>
  22373. </td>
  22374. </tr>
  22375. <tr>
  22376. <td>
  22377. <code>ibm</code></br>
  22378. <em>
  22379. <a href="#external-secrets.io/v1beta1.IBMProvider">
  22380. IBMProvider
  22381. </a>
  22382. </em>
  22383. </td>
  22384. <td>
  22385. <em>(Optional)</em>
  22386. <p>IBM configures this store to sync secrets using IBM Cloud provider</p>
  22387. </td>
  22388. </tr>
  22389. <tr>
  22390. <td>
  22391. <code>yandexcertificatemanager</code></br>
  22392. <em>
  22393. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">
  22394. YandexCertificateManagerProvider
  22395. </a>
  22396. </em>
  22397. </td>
  22398. <td>
  22399. <em>(Optional)</em>
  22400. <p>YandexCertificateManager configures this store to sync secrets using Yandex Certificate Manager provider</p>
  22401. </td>
  22402. </tr>
  22403. <tr>
  22404. <td>
  22405. <code>yandexlockbox</code></br>
  22406. <em>
  22407. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">
  22408. YandexLockboxProvider
  22409. </a>
  22410. </em>
  22411. </td>
  22412. <td>
  22413. <em>(Optional)</em>
  22414. <p>YandexLockbox configures this store to sync secrets using Yandex Lockbox provider</p>
  22415. </td>
  22416. </tr>
  22417. <tr>
  22418. <td>
  22419. <code>github</code></br>
  22420. <em>
  22421. <a href="#external-secrets.io/v1beta1.GithubProvider">
  22422. GithubProvider
  22423. </a>
  22424. </em>
  22425. </td>
  22426. <td>
  22427. <em>(Optional)</em>
  22428. <p>Github configures this store to push GitHub Actions secrets using the GitHub API provider.</p>
  22429. </td>
  22430. </tr>
  22431. <tr>
  22432. <td>
  22433. <code>gitlab</code></br>
  22434. <em>
  22435. <a href="#external-secrets.io/v1beta1.GitlabProvider">
  22436. GitlabProvider
  22437. </a>
  22438. </em>
  22439. </td>
  22440. <td>
  22441. <em>(Optional)</em>
  22442. <p>GitLab configures this store to sync secrets using GitLab Variables provider</p>
  22443. </td>
  22444. </tr>
  22445. <tr>
  22446. <td>
  22447. <code>alibaba</code></br>
  22448. <em>
  22449. <a href="#external-secrets.io/v1beta1.AlibabaProvider">
  22450. AlibabaProvider
  22451. </a>
  22452. </em>
  22453. </td>
  22454. <td>
  22455. <em>(Optional)</em>
  22456. <p>Alibaba configures this store to sync secrets using Alibaba Cloud provider</p>
  22457. </td>
  22458. </tr>
  22459. <tr>
  22460. <td>
  22461. <code>onepassword</code></br>
  22462. <em>
  22463. <a href="#external-secrets.io/v1beta1.OnePasswordProvider">
  22464. OnePasswordProvider
  22465. </a>
  22466. </em>
  22467. </td>
  22468. <td>
  22469. <em>(Optional)</em>
  22470. <p>OnePassword configures this store to sync secrets using the 1Password Cloud provider</p>
  22471. </td>
  22472. </tr>
  22473. <tr>
  22474. <td>
  22475. <code>webhook</code></br>
  22476. <em>
  22477. <a href="#external-secrets.io/v1beta1.WebhookProvider">
  22478. WebhookProvider
  22479. </a>
  22480. </em>
  22481. </td>
  22482. <td>
  22483. <em>(Optional)</em>
  22484. <p>Webhook configures this store to sync secrets using a generic templated webhook</p>
  22485. </td>
  22486. </tr>
  22487. <tr>
  22488. <td>
  22489. <code>kubernetes</code></br>
  22490. <em>
  22491. <a href="#external-secrets.io/v1beta1.KubernetesProvider">
  22492. KubernetesProvider
  22493. </a>
  22494. </em>
  22495. </td>
  22496. <td>
  22497. <em>(Optional)</em>
  22498. <p>Kubernetes configures this store to sync secrets using a Kubernetes cluster provider</p>
  22499. </td>
  22500. </tr>
  22501. <tr>
  22502. <td>
  22503. <code>fake</code></br>
  22504. <em>
  22505. <a href="#external-secrets.io/v1beta1.FakeProvider">
  22506. FakeProvider
  22507. </a>
  22508. </em>
  22509. </td>
  22510. <td>
  22511. <em>(Optional)</em>
  22512. <p>Fake configures a store with static key/value pairs</p>
  22513. </td>
  22514. </tr>
  22515. <tr>
  22516. <td>
  22517. <code>senhasegura</code></br>
  22518. <em>
  22519. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">
  22520. SenhaseguraProvider
  22521. </a>
  22522. </em>
  22523. </td>
  22524. <td>
  22525. <em>(Optional)</em>
  22526. <p>Senhasegura configures this store to sync secrets using senhasegura provider</p>
  22527. </td>
  22528. </tr>
  22529. <tr>
  22530. <td>
  22531. <code>scaleway</code></br>
  22532. <em>
  22533. <a href="#external-secrets.io/v1beta1.ScalewayProvider">
  22534. ScalewayProvider
  22535. </a>
  22536. </em>
  22537. </td>
  22538. <td>
  22539. <em>(Optional)</em>
  22540. <p>Scaleway configures this store to sync secrets using the Scaleway provider.</p>
  22541. </td>
  22542. </tr>
  22543. <tr>
  22544. <td>
  22545. <code>doppler</code></br>
  22546. <em>
  22547. <a href="#external-secrets.io/v1beta1.DopplerProvider">
  22548. DopplerProvider
  22549. </a>
  22550. </em>
  22551. </td>
  22552. <td>
  22553. <em>(Optional)</em>
  22554. <p>Doppler configures this store to sync secrets using the Doppler provider</p>
  22555. </td>
  22556. </tr>
  22557. <tr>
  22558. <td>
  22559. <code>previder</code></br>
  22560. <em>
  22561. <a href="#external-secrets.io/v1beta1.PreviderProvider">
  22562. PreviderProvider
  22563. </a>
  22564. </em>
  22565. </td>
  22566. <td>
  22567. <em>(Optional)</em>
  22568. <p>Previder configures this store to sync secrets using the Previder provider</p>
  22569. </td>
  22570. </tr>
  22571. <tr>
  22572. <td>
  22573. <code>onboardbase</code></br>
  22574. <em>
  22575. <a href="#external-secrets.io/v1beta1.OnboardbaseProvider">
  22576. OnboardbaseProvider
  22577. </a>
  22578. </em>
  22579. </td>
  22580. <td>
  22581. <em>(Optional)</em>
  22582. <p>Onboardbase configures this store to sync secrets using the Onboardbase provider</p>
  22583. </td>
  22584. </tr>
  22585. <tr>
  22586. <td>
  22587. <code>keepersecurity</code></br>
  22588. <em>
  22589. <a href="#external-secrets.io/v1beta1.KeeperSecurityProvider">
  22590. KeeperSecurityProvider
  22591. </a>
  22592. </em>
  22593. </td>
  22594. <td>
  22595. <em>(Optional)</em>
  22596. <p>KeeperSecurity configures this store to sync secrets using the KeeperSecurity provider</p>
  22597. </td>
  22598. </tr>
  22599. <tr>
  22600. <td>
  22601. <code>conjur</code></br>
  22602. <em>
  22603. <a href="#external-secrets.io/v1beta1.ConjurProvider">
  22604. ConjurProvider
  22605. </a>
  22606. </em>
  22607. </td>
  22608. <td>
  22609. <em>(Optional)</em>
  22610. <p>Conjur configures this store to sync secrets using conjur provider</p>
  22611. </td>
  22612. </tr>
  22613. <tr>
  22614. <td>
  22615. <code>delinea</code></br>
  22616. <em>
  22617. <a href="#external-secrets.io/v1beta1.DelineaProvider">
  22618. DelineaProvider
  22619. </a>
  22620. </em>
  22621. </td>
  22622. <td>
  22623. <em>(Optional)</em>
  22624. <p>Delinea DevOps Secrets Vault
  22625. <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>
  22626. </td>
  22627. </tr>
  22628. <tr>
  22629. <td>
  22630. <code>secretserver</code></br>
  22631. <em>
  22632. <a href="#external-secrets.io/v1beta1.SecretServerProvider">
  22633. SecretServerProvider
  22634. </a>
  22635. </em>
  22636. </td>
  22637. <td>
  22638. <em>(Optional)</em>
  22639. <p>SecretServer configures this store to sync secrets using SecretServer provider
  22640. <a href="https://docs.delinea.com/online-help/secret-server/start.htm">https://docs.delinea.com/online-help/secret-server/start.htm</a></p>
  22641. </td>
  22642. </tr>
  22643. <tr>
  22644. <td>
  22645. <code>chef</code></br>
  22646. <em>
  22647. <a href="#external-secrets.io/v1beta1.ChefProvider">
  22648. ChefProvider
  22649. </a>
  22650. </em>
  22651. </td>
  22652. <td>
  22653. <em>(Optional)</em>
  22654. <p>Chef configures this store to sync secrets with chef server</p>
  22655. </td>
  22656. </tr>
  22657. <tr>
  22658. <td>
  22659. <code>pulumi</code></br>
  22660. <em>
  22661. <a href="#external-secrets.io/v1beta1.PulumiProvider">
  22662. PulumiProvider
  22663. </a>
  22664. </em>
  22665. </td>
  22666. <td>
  22667. <em>(Optional)</em>
  22668. <p>Pulumi configures this store to sync secrets using the Pulumi provider</p>
  22669. </td>
  22670. </tr>
  22671. <tr>
  22672. <td>
  22673. <code>fortanix</code></br>
  22674. <em>
  22675. <a href="#external-secrets.io/v1beta1.FortanixProvider">
  22676. FortanixProvider
  22677. </a>
  22678. </em>
  22679. </td>
  22680. <td>
  22681. <em>(Optional)</em>
  22682. <p>Fortanix configures this store to sync secrets using the Fortanix provider</p>
  22683. </td>
  22684. </tr>
  22685. <tr>
  22686. <td>
  22687. <code>passworddepot</code></br>
  22688. <em>
  22689. <a href="#external-secrets.io/v1beta1.PasswordDepotProvider">
  22690. PasswordDepotProvider
  22691. </a>
  22692. </em>
  22693. </td>
  22694. <td>
  22695. <em>(Optional)</em>
  22696. </td>
  22697. </tr>
  22698. <tr>
  22699. <td>
  22700. <code>passbolt</code></br>
  22701. <em>
  22702. <a href="#external-secrets.io/v1beta1.PassboltProvider">
  22703. PassboltProvider
  22704. </a>
  22705. </em>
  22706. </td>
  22707. <td>
  22708. <em>(Optional)</em>
  22709. </td>
  22710. </tr>
  22711. <tr>
  22712. <td>
  22713. <code>device42</code></br>
  22714. <em>
  22715. <a href="#external-secrets.io/v1beta1.Device42Provider">
  22716. Device42Provider
  22717. </a>
  22718. </em>
  22719. </td>
  22720. <td>
  22721. <em>(Optional)</em>
  22722. <p>Device42 configures this store to sync secrets using the Device42 provider</p>
  22723. </td>
  22724. </tr>
  22725. <tr>
  22726. <td>
  22727. <code>infisical</code></br>
  22728. <em>
  22729. <a href="#external-secrets.io/v1beta1.InfisicalProvider">
  22730. InfisicalProvider
  22731. </a>
  22732. </em>
  22733. </td>
  22734. <td>
  22735. <em>(Optional)</em>
  22736. <p>Infisical configures this store to sync secrets using the Infisical provider</p>
  22737. </td>
  22738. </tr>
  22739. <tr>
  22740. <td>
  22741. <code>beyondtrust</code></br>
  22742. <em>
  22743. <a href="#external-secrets.io/v1beta1.BeyondtrustProvider">
  22744. BeyondtrustProvider
  22745. </a>
  22746. </em>
  22747. </td>
  22748. <td>
  22749. <em>(Optional)</em>
  22750. <p>Beyondtrust configures this store to sync secrets using Password Safe provider.</p>
  22751. </td>
  22752. </tr>
  22753. <tr>
  22754. <td>
  22755. <code>cloudrusm</code></br>
  22756. <em>
  22757. <a href="#external-secrets.io/v1beta1.CloudruSMProvider">
  22758. CloudruSMProvider
  22759. </a>
  22760. </em>
  22761. </td>
  22762. <td>
  22763. <em>(Optional)</em>
  22764. <p>CloudruSM configures this store to sync secrets using the Cloud.ru Secret Manager provider</p>
  22765. </td>
  22766. </tr>
  22767. </tbody>
  22768. </table>
  22769. <h3 id="external-secrets.io/v1beta1.SecretStoreRef">SecretStoreRef
  22770. </h3>
  22771. <p>
  22772. (<em>Appears on:</em>
  22773. <a href="#external-secrets.io/v1beta1.ExternalSecretSpec">ExternalSecretSpec</a>,
  22774. <a href="#external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef</a>,
  22775. <a href="#external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef</a>)
  22776. </p>
  22777. <p>
  22778. <p>SecretStoreRef defines which SecretStore to fetch the ExternalSecret data.</p>
  22779. </p>
  22780. <table>
  22781. <thead>
  22782. <tr>
  22783. <th>Field</th>
  22784. <th>Description</th>
  22785. </tr>
  22786. </thead>
  22787. <tbody>
  22788. <tr>
  22789. <td>
  22790. <code>name</code></br>
  22791. <em>
  22792. string
  22793. </em>
  22794. </td>
  22795. <td>
  22796. <p>Name of the SecretStore resource</p>
  22797. </td>
  22798. </tr>
  22799. <tr>
  22800. <td>
  22801. <code>kind</code></br>
  22802. <em>
  22803. string
  22804. </em>
  22805. </td>
  22806. <td>
  22807. <em>(Optional)</em>
  22808. <p>Kind of the SecretStore resource (SecretStore or ClusterSecretStore)
  22809. Defaults to <code>SecretStore</code></p>
  22810. </td>
  22811. </tr>
  22812. </tbody>
  22813. </table>
  22814. <h3 id="external-secrets.io/v1beta1.SecretStoreRetrySettings">SecretStoreRetrySettings
  22815. </h3>
  22816. <p>
  22817. (<em>Appears on:</em>
  22818. <a href="#external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec</a>)
  22819. </p>
  22820. <p>
  22821. <p>SecretStoreRetrySettings defines configuration for retrying failed requests to the provider.</p>
  22822. </p>
  22823. <table>
  22824. <thead>
  22825. <tr>
  22826. <th>Field</th>
  22827. <th>Description</th>
  22828. </tr>
  22829. </thead>
  22830. <tbody>
  22831. <tr>
  22832. <td>
  22833. <code>maxRetries</code></br>
  22834. <em>
  22835. int32
  22836. </em>
  22837. </td>
  22838. <td>
  22839. <p>MaxRetries is the maximum number of retry attempts.</p>
  22840. </td>
  22841. </tr>
  22842. <tr>
  22843. <td>
  22844. <code>retryInterval</code></br>
  22845. <em>
  22846. string
  22847. </em>
  22848. </td>
  22849. <td>
  22850. <p>RetryInterval is the interval between retry attempts.</p>
  22851. </td>
  22852. </tr>
  22853. </tbody>
  22854. </table>
  22855. <h3 id="external-secrets.io/v1beta1.SecretStoreSpec">SecretStoreSpec
  22856. </h3>
  22857. <p>
  22858. (<em>Appears on:</em>
  22859. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  22860. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  22861. </p>
  22862. <p>
  22863. <p>SecretStoreSpec defines the desired state of SecretStore.</p>
  22864. </p>
  22865. <table>
  22866. <thead>
  22867. <tr>
  22868. <th>Field</th>
  22869. <th>Description</th>
  22870. </tr>
  22871. </thead>
  22872. <tbody>
  22873. <tr>
  22874. <td>
  22875. <code>controller</code></br>
  22876. <em>
  22877. string
  22878. </em>
  22879. </td>
  22880. <td>
  22881. <em>(Optional)</em>
  22882. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  22883. The ESO controller is instantiated with a specific controller name and filters ES based on this property</p>
  22884. </td>
  22885. </tr>
  22886. <tr>
  22887. <td>
  22888. <code>provider</code></br>
  22889. <em>
  22890. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">
  22891. SecretStoreProvider
  22892. </a>
  22893. </em>
  22894. </td>
  22895. <td>
  22896. <p>Used to configure the provider. Only one provider may be set</p>
  22897. </td>
  22898. </tr>
  22899. <tr>
  22900. <td>
  22901. <code>retrySettings</code></br>
  22902. <em>
  22903. <a href="#external-secrets.io/v1beta1.SecretStoreRetrySettings">
  22904. SecretStoreRetrySettings
  22905. </a>
  22906. </em>
  22907. </td>
  22908. <td>
  22909. <em>(Optional)</em>
  22910. <p>Used to configure HTTP retries on failures.</p>
  22911. </td>
  22912. </tr>
  22913. <tr>
  22914. <td>
  22915. <code>refreshInterval</code></br>
  22916. <em>
  22917. int
  22918. </em>
  22919. </td>
  22920. <td>
  22921. <em>(Optional)</em>
  22922. <p>Used to configure store refresh interval in seconds. Empty or 0 will default to the controller config.</p>
  22923. </td>
  22924. </tr>
  22925. <tr>
  22926. <td>
  22927. <code>conditions</code></br>
  22928. <em>
  22929. <a href="#external-secrets.io/v1beta1.ClusterSecretStoreCondition">
  22930. []ClusterSecretStoreCondition
  22931. </a>
  22932. </em>
  22933. </td>
  22934. <td>
  22935. <em>(Optional)</em>
  22936. <p>Used to constrain a ClusterSecretStore to specific namespaces. Relevant only to ClusterSecretStore.</p>
  22937. </td>
  22938. </tr>
  22939. </tbody>
  22940. </table>
  22941. <h3 id="external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus
  22942. </h3>
  22943. <p>
  22944. (<em>Appears on:</em>
  22945. <a href="#external-secrets.io/v1beta1.ClusterSecretStore">ClusterSecretStore</a>,
  22946. <a href="#external-secrets.io/v1beta1.SecretStore">SecretStore</a>)
  22947. </p>
  22948. <p>
  22949. <p>SecretStoreStatus defines the observed state of the SecretStore.</p>
  22950. </p>
  22951. <table>
  22952. <thead>
  22953. <tr>
  22954. <th>Field</th>
  22955. <th>Description</th>
  22956. </tr>
  22957. </thead>
  22958. <tbody>
  22959. <tr>
  22960. <td>
  22961. <code>conditions</code></br>
  22962. <em>
  22963. <a href="#external-secrets.io/v1beta1.SecretStoreStatusCondition">
  22964. []SecretStoreStatusCondition
  22965. </a>
  22966. </em>
  22967. </td>
  22968. <td>
  22969. <em>(Optional)</em>
  22970. </td>
  22971. </tr>
  22972. <tr>
  22973. <td>
  22974. <code>capabilities</code></br>
  22975. <em>
  22976. <a href="#external-secrets.io/v1beta1.SecretStoreCapabilities">
  22977. SecretStoreCapabilities
  22978. </a>
  22979. </em>
  22980. </td>
  22981. <td>
  22982. <em>(Optional)</em>
  22983. </td>
  22984. </tr>
  22985. </tbody>
  22986. </table>
  22987. <h3 id="external-secrets.io/v1beta1.SecretStoreStatusCondition">SecretStoreStatusCondition
  22988. </h3>
  22989. <p>
  22990. (<em>Appears on:</em>
  22991. <a href="#external-secrets.io/v1beta1.SecretStoreStatus">SecretStoreStatus</a>)
  22992. </p>
  22993. <p>
  22994. <p>SecretStoreStatusCondition defines the observed condition of the SecretStore.</p>
  22995. </p>
  22996. <table>
  22997. <thead>
  22998. <tr>
  22999. <th>Field</th>
  23000. <th>Description</th>
  23001. </tr>
  23002. </thead>
  23003. <tbody>
  23004. <tr>
  23005. <td>
  23006. <code>type</code></br>
  23007. <em>
  23008. <a href="#external-secrets.io/v1beta1.SecretStoreConditionType">
  23009. SecretStoreConditionType
  23010. </a>
  23011. </em>
  23012. </td>
  23013. <td>
  23014. </td>
  23015. </tr>
  23016. <tr>
  23017. <td>
  23018. <code>status</code></br>
  23019. <em>
  23020. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  23021. Kubernetes core/v1.ConditionStatus
  23022. </a>
  23023. </em>
  23024. </td>
  23025. <td>
  23026. </td>
  23027. </tr>
  23028. <tr>
  23029. <td>
  23030. <code>reason</code></br>
  23031. <em>
  23032. string
  23033. </em>
  23034. </td>
  23035. <td>
  23036. <em>(Optional)</em>
  23037. </td>
  23038. </tr>
  23039. <tr>
  23040. <td>
  23041. <code>message</code></br>
  23042. <em>
  23043. string
  23044. </em>
  23045. </td>
  23046. <td>
  23047. <em>(Optional)</em>
  23048. </td>
  23049. </tr>
  23050. <tr>
  23051. <td>
  23052. <code>lastTransitionTime</code></br>
  23053. <em>
  23054. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  23055. Kubernetes meta/v1.Time
  23056. </a>
  23057. </em>
  23058. </td>
  23059. <td>
  23060. <em>(Optional)</em>
  23061. </td>
  23062. </tr>
  23063. </tbody>
  23064. </table>
  23065. <h3 id="external-secrets.io/v1beta1.SecretsClient">SecretsClient
  23066. </h3>
  23067. <p>
  23068. <p>SecretsClient provides access to secrets.</p>
  23069. </p>
  23070. <h3 id="external-secrets.io/v1beta1.SecretsManager">SecretsManager
  23071. </h3>
  23072. <p>
  23073. (<em>Appears on:</em>
  23074. <a href="#external-secrets.io/v1beta1.AWSProvider">AWSProvider</a>)
  23075. </p>
  23076. <p>
  23077. <p>SecretsManager defines how the provider behaves when interacting with AWS
  23078. SecretsManager. Some of these settings are only applicable to controlling how
  23079. secrets are deleted, and hence only apply to PushSecret (and only when
  23080. deletionPolicy is set to Delete).</p>
  23081. </p>
  23082. <table>
  23083. <thead>
  23084. <tr>
  23085. <th>Field</th>
  23086. <th>Description</th>
  23087. </tr>
  23088. </thead>
  23089. <tbody>
  23090. <tr>
  23091. <td>
  23092. <code>forceDeleteWithoutRecovery</code></br>
  23093. <em>
  23094. bool
  23095. </em>
  23096. </td>
  23097. <td>
  23098. <em>(Optional)</em>
  23099. <p>Specifies whether to delete the secret without any recovery window. You
  23100. can&rsquo;t use both this parameter and RecoveryWindowInDays in the same call.
  23101. If you don&rsquo;t use either, then by default Secrets Manager uses a 30 day
  23102. recovery window.
  23103. 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>
  23104. </td>
  23105. </tr>
  23106. <tr>
  23107. <td>
  23108. <code>recoveryWindowInDays</code></br>
  23109. <em>
  23110. int64
  23111. </em>
  23112. </td>
  23113. <td>
  23114. <em>(Optional)</em>
  23115. <p>The number of days from 7 to 30 that Secrets Manager waits before
  23116. permanently deleting the secret. You can&rsquo;t use both this parameter and
  23117. ForceDeleteWithoutRecovery in the same call. If you don&rsquo;t use either,
  23118. then by default Secrets Manager uses a 30 day recovery window.
  23119. 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>
  23120. </td>
  23121. </tr>
  23122. </tbody>
  23123. </table>
  23124. <h3 id="external-secrets.io/v1beta1.SenhaseguraAuth">SenhaseguraAuth
  23125. </h3>
  23126. <p>
  23127. (<em>Appears on:</em>
  23128. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  23129. </p>
  23130. <p>
  23131. <p>SenhaseguraAuth tells the controller how to do auth in senhasegura.</p>
  23132. </p>
  23133. <table>
  23134. <thead>
  23135. <tr>
  23136. <th>Field</th>
  23137. <th>Description</th>
  23138. </tr>
  23139. </thead>
  23140. <tbody>
  23141. <tr>
  23142. <td>
  23143. <code>clientId</code></br>
  23144. <em>
  23145. string
  23146. </em>
  23147. </td>
  23148. <td>
  23149. </td>
  23150. </tr>
  23151. <tr>
  23152. <td>
  23153. <code>clientSecretSecretRef</code></br>
  23154. <em>
  23155. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23156. External Secrets meta/v1.SecretKeySelector
  23157. </a>
  23158. </em>
  23159. </td>
  23160. <td>
  23161. </td>
  23162. </tr>
  23163. </tbody>
  23164. </table>
  23165. <h3 id="external-secrets.io/v1beta1.SenhaseguraModuleType">SenhaseguraModuleType
  23166. (<code>string</code> alias)</p></h3>
  23167. <p>
  23168. (<em>Appears on:</em>
  23169. <a href="#external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider</a>)
  23170. </p>
  23171. <p>
  23172. <p>SenhaseguraModuleType enum defines senhasegura target module to fetch secrets</p>
  23173. </p>
  23174. <table>
  23175. <thead>
  23176. <tr>
  23177. <th>Value</th>
  23178. <th>Description</th>
  23179. </tr>
  23180. </thead>
  23181. <tbody><tr><td><p>&#34;DSM&#34;</p></td>
  23182. <td><pre><code> SenhaseguraModuleDSM is the senhasegura DevOps Secrets Management module
  23183. see: https://senhasegura.com/devops
  23184. </code></pre>
  23185. </td>
  23186. </tr></tbody>
  23187. </table>
  23188. <h3 id="external-secrets.io/v1beta1.SenhaseguraProvider">SenhaseguraProvider
  23189. </h3>
  23190. <p>
  23191. (<em>Appears on:</em>
  23192. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  23193. </p>
  23194. <p>
  23195. <p>SenhaseguraProvider setup a store to sync secrets with senhasegura.</p>
  23196. </p>
  23197. <table>
  23198. <thead>
  23199. <tr>
  23200. <th>Field</th>
  23201. <th>Description</th>
  23202. </tr>
  23203. </thead>
  23204. <tbody>
  23205. <tr>
  23206. <td>
  23207. <code>url</code></br>
  23208. <em>
  23209. string
  23210. </em>
  23211. </td>
  23212. <td>
  23213. <p>URL of senhasegura</p>
  23214. </td>
  23215. </tr>
  23216. <tr>
  23217. <td>
  23218. <code>module</code></br>
  23219. <em>
  23220. <a href="#external-secrets.io/v1beta1.SenhaseguraModuleType">
  23221. SenhaseguraModuleType
  23222. </a>
  23223. </em>
  23224. </td>
  23225. <td>
  23226. <p>Module defines which senhasegura module should be used to get secrets</p>
  23227. </td>
  23228. </tr>
  23229. <tr>
  23230. <td>
  23231. <code>auth</code></br>
  23232. <em>
  23233. <a href="#external-secrets.io/v1beta1.SenhaseguraAuth">
  23234. SenhaseguraAuth
  23235. </a>
  23236. </em>
  23237. </td>
  23238. <td>
  23239. <p>Auth defines parameters to authenticate in senhasegura</p>
  23240. </td>
  23241. </tr>
  23242. <tr>
  23243. <td>
  23244. <code>ignoreSslCertificate</code></br>
  23245. <em>
  23246. bool
  23247. </em>
  23248. </td>
  23249. <td>
  23250. <p>IgnoreSslCertificate defines if SSL certificate must be ignored</p>
  23251. </td>
  23252. </tr>
  23253. </tbody>
  23254. </table>
  23255. <h3 id="external-secrets.io/v1beta1.StoreGeneratorSourceRef">StoreGeneratorSourceRef
  23256. </h3>
  23257. <p>
  23258. (<em>Appears on:</em>
  23259. <a href="#external-secrets.io/v1beta1.ExternalSecretDataFromRemoteRef">ExternalSecretDataFromRemoteRef</a>)
  23260. </p>
  23261. <p>
  23262. <p>StoreGeneratorSourceRef allows you to override the source
  23263. from which the secret will be pulled from.
  23264. You can define at maximum one property.</p>
  23265. </p>
  23266. <table>
  23267. <thead>
  23268. <tr>
  23269. <th>Field</th>
  23270. <th>Description</th>
  23271. </tr>
  23272. </thead>
  23273. <tbody>
  23274. <tr>
  23275. <td>
  23276. <code>storeRef</code></br>
  23277. <em>
  23278. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  23279. SecretStoreRef
  23280. </a>
  23281. </em>
  23282. </td>
  23283. <td>
  23284. <em>(Optional)</em>
  23285. </td>
  23286. </tr>
  23287. <tr>
  23288. <td>
  23289. <code>generatorRef</code></br>
  23290. <em>
  23291. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  23292. GeneratorRef
  23293. </a>
  23294. </em>
  23295. </td>
  23296. <td>
  23297. <em>(Optional)</em>
  23298. <p>GeneratorRef points to a generator custom resource.</p>
  23299. </td>
  23300. </tr>
  23301. </tbody>
  23302. </table>
  23303. <h3 id="external-secrets.io/v1beta1.StoreSourceRef">StoreSourceRef
  23304. </h3>
  23305. <p>
  23306. (<em>Appears on:</em>
  23307. <a href="#external-secrets.io/v1beta1.ExternalSecretData">ExternalSecretData</a>)
  23308. </p>
  23309. <p>
  23310. <p>StoreSourceRef allows you to override the SecretStore source
  23311. from which the secret will be pulled from.
  23312. You can define at maximum one property.</p>
  23313. </p>
  23314. <table>
  23315. <thead>
  23316. <tr>
  23317. <th>Field</th>
  23318. <th>Description</th>
  23319. </tr>
  23320. </thead>
  23321. <tbody>
  23322. <tr>
  23323. <td>
  23324. <code>storeRef</code></br>
  23325. <em>
  23326. <a href="#external-secrets.io/v1beta1.SecretStoreRef">
  23327. SecretStoreRef
  23328. </a>
  23329. </em>
  23330. </td>
  23331. <td>
  23332. <em>(Optional)</em>
  23333. </td>
  23334. </tr>
  23335. <tr>
  23336. <td>
  23337. <code>generatorRef</code></br>
  23338. <em>
  23339. <a href="#external-secrets.io/v1beta1.GeneratorRef">
  23340. GeneratorRef
  23341. </a>
  23342. </em>
  23343. </td>
  23344. <td>
  23345. <p>GeneratorRef points to a generator custom resource.</p>
  23346. <p>Deprecated: The generatorRef is not implemented in .data[].
  23347. this will be removed with v1.</p>
  23348. </td>
  23349. </tr>
  23350. </tbody>
  23351. </table>
  23352. <h3 id="external-secrets.io/v1beta1.Tag">Tag
  23353. </h3>
  23354. <p>
  23355. <p>Tag defines a tag key and value for AWS resources.</p>
  23356. </p>
  23357. <table>
  23358. <thead>
  23359. <tr>
  23360. <th>Field</th>
  23361. <th>Description</th>
  23362. </tr>
  23363. </thead>
  23364. <tbody>
  23365. <tr>
  23366. <td>
  23367. <code>key</code></br>
  23368. <em>
  23369. string
  23370. </em>
  23371. </td>
  23372. <td>
  23373. </td>
  23374. </tr>
  23375. <tr>
  23376. <td>
  23377. <code>value</code></br>
  23378. <em>
  23379. string
  23380. </em>
  23381. </td>
  23382. <td>
  23383. </td>
  23384. </tr>
  23385. </tbody>
  23386. </table>
  23387. <h3 id="external-secrets.io/v1beta1.TemplateEngineVersion">TemplateEngineVersion
  23388. (<code>string</code> alias)</p></h3>
  23389. <p>
  23390. (<em>Appears on:</em>
  23391. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  23392. </p>
  23393. <p>
  23394. <p>TemplateEngineVersion defines the version of the template engine to use.</p>
  23395. </p>
  23396. <table>
  23397. <thead>
  23398. <tr>
  23399. <th>Value</th>
  23400. <th>Description</th>
  23401. </tr>
  23402. </thead>
  23403. <tbody><tr><td><p>&#34;v2&#34;</p></td>
  23404. <td><p>TemplateEngineV2 specifies the v2 template engine version.</p>
  23405. </td>
  23406. </tr></tbody>
  23407. </table>
  23408. <h3 id="external-secrets.io/v1beta1.TemplateFrom">TemplateFrom
  23409. </h3>
  23410. <p>
  23411. (<em>Appears on:</em>
  23412. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  23413. </p>
  23414. <p>
  23415. <p>TemplateFrom defines a source for template data.</p>
  23416. </p>
  23417. <table>
  23418. <thead>
  23419. <tr>
  23420. <th>Field</th>
  23421. <th>Description</th>
  23422. </tr>
  23423. </thead>
  23424. <tbody>
  23425. <tr>
  23426. <td>
  23427. <code>configMap</code></br>
  23428. <em>
  23429. <a href="#external-secrets.io/v1beta1.TemplateRef">
  23430. TemplateRef
  23431. </a>
  23432. </em>
  23433. </td>
  23434. <td>
  23435. </td>
  23436. </tr>
  23437. <tr>
  23438. <td>
  23439. <code>secret</code></br>
  23440. <em>
  23441. <a href="#external-secrets.io/v1beta1.TemplateRef">
  23442. TemplateRef
  23443. </a>
  23444. </em>
  23445. </td>
  23446. <td>
  23447. </td>
  23448. </tr>
  23449. <tr>
  23450. <td>
  23451. <code>target</code></br>
  23452. <em>
  23453. <a href="#external-secrets.io/v1beta1.TemplateTarget">
  23454. TemplateTarget
  23455. </a>
  23456. </em>
  23457. </td>
  23458. <td>
  23459. <em>(Optional)</em>
  23460. </td>
  23461. </tr>
  23462. <tr>
  23463. <td>
  23464. <code>literal</code></br>
  23465. <em>
  23466. string
  23467. </em>
  23468. </td>
  23469. <td>
  23470. <em>(Optional)</em>
  23471. </td>
  23472. </tr>
  23473. </tbody>
  23474. </table>
  23475. <h3 id="external-secrets.io/v1beta1.TemplateMergePolicy">TemplateMergePolicy
  23476. (<code>string</code> alias)</p></h3>
  23477. <p>
  23478. (<em>Appears on:</em>
  23479. <a href="#external-secrets.io/v1beta1.ExternalSecretTemplate">ExternalSecretTemplate</a>)
  23480. </p>
  23481. <p>
  23482. <p>TemplateMergePolicy defines how template values should be merged when generating a secret.</p>
  23483. </p>
  23484. <table>
  23485. <thead>
  23486. <tr>
  23487. <th>Value</th>
  23488. <th>Description</th>
  23489. </tr>
  23490. </thead>
  23491. <tbody><tr><td><p>&#34;Merge&#34;</p></td>
  23492. <td><p>MergePolicyMerge merges the template content with existing values.</p>
  23493. </td>
  23494. </tr><tr><td><p>&#34;Replace&#34;</p></td>
  23495. <td><p>MergePolicyReplace replaces the entire template content during merge operations.</p>
  23496. </td>
  23497. </tr></tbody>
  23498. </table>
  23499. <h3 id="external-secrets.io/v1beta1.TemplateRef">TemplateRef
  23500. </h3>
  23501. <p>
  23502. (<em>Appears on:</em>
  23503. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  23504. </p>
  23505. <p>
  23506. <p>TemplateRef defines a reference to a template source in a ConfigMap or Secret.</p>
  23507. </p>
  23508. <table>
  23509. <thead>
  23510. <tr>
  23511. <th>Field</th>
  23512. <th>Description</th>
  23513. </tr>
  23514. </thead>
  23515. <tbody>
  23516. <tr>
  23517. <td>
  23518. <code>name</code></br>
  23519. <em>
  23520. string
  23521. </em>
  23522. </td>
  23523. <td>
  23524. <p>The name of the ConfigMap/Secret resource</p>
  23525. </td>
  23526. </tr>
  23527. <tr>
  23528. <td>
  23529. <code>items</code></br>
  23530. <em>
  23531. <a href="#external-secrets.io/v1beta1.TemplateRefItem">
  23532. []TemplateRefItem
  23533. </a>
  23534. </em>
  23535. </td>
  23536. <td>
  23537. <p>A list of keys in the ConfigMap/Secret to use as templates for Secret data</p>
  23538. </td>
  23539. </tr>
  23540. </tbody>
  23541. </table>
  23542. <h3 id="external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem
  23543. </h3>
  23544. <p>
  23545. (<em>Appears on:</em>
  23546. <a href="#external-secrets.io/v1beta1.TemplateRef">TemplateRef</a>)
  23547. </p>
  23548. <p>
  23549. <p>TemplateRefItem defines which key in the referenced ConfigMap or Secret to use as a template.</p>
  23550. </p>
  23551. <table>
  23552. <thead>
  23553. <tr>
  23554. <th>Field</th>
  23555. <th>Description</th>
  23556. </tr>
  23557. </thead>
  23558. <tbody>
  23559. <tr>
  23560. <td>
  23561. <code>key</code></br>
  23562. <em>
  23563. string
  23564. </em>
  23565. </td>
  23566. <td>
  23567. <p>A key in the ConfigMap/Secret</p>
  23568. </td>
  23569. </tr>
  23570. <tr>
  23571. <td>
  23572. <code>templateAs</code></br>
  23573. <em>
  23574. <a href="#external-secrets.io/v1beta1.TemplateScope">
  23575. TemplateScope
  23576. </a>
  23577. </em>
  23578. </td>
  23579. <td>
  23580. </td>
  23581. </tr>
  23582. </tbody>
  23583. </table>
  23584. <h3 id="external-secrets.io/v1beta1.TemplateScope">TemplateScope
  23585. (<code>string</code> alias)</p></h3>
  23586. <p>
  23587. (<em>Appears on:</em>
  23588. <a href="#external-secrets.io/v1beta1.TemplateRefItem">TemplateRefItem</a>)
  23589. </p>
  23590. <p>
  23591. <p>TemplateScope defines the scope of the template when processing template data.</p>
  23592. </p>
  23593. <table>
  23594. <thead>
  23595. <tr>
  23596. <th>Value</th>
  23597. <th>Description</th>
  23598. </tr>
  23599. </thead>
  23600. <tbody><tr><td><p>&#34;KeysAndValues&#34;</p></td>
  23601. <td><p>TemplateScopeKeysAndValues processes both keys and values of the data.</p>
  23602. </td>
  23603. </tr><tr><td><p>&#34;Values&#34;</p></td>
  23604. <td><p>TemplateScopeValues processes only the values of the data.</p>
  23605. </td>
  23606. </tr></tbody>
  23607. </table>
  23608. <h3 id="external-secrets.io/v1beta1.TemplateTarget">TemplateTarget
  23609. (<code>string</code> alias)</p></h3>
  23610. <p>
  23611. (<em>Appears on:</em>
  23612. <a href="#external-secrets.io/v1beta1.TemplateFrom">TemplateFrom</a>)
  23613. </p>
  23614. <p>
  23615. <p>TemplateTarget defines the target field where the template result will be stored.</p>
  23616. </p>
  23617. <table>
  23618. <thead>
  23619. <tr>
  23620. <th>Value</th>
  23621. <th>Description</th>
  23622. </tr>
  23623. </thead>
  23624. <tbody><tr><td><p>&#34;Annotations&#34;</p></td>
  23625. <td><p>TemplateTargetAnnotations stores template results in the annotations field of the secret.</p>
  23626. </td>
  23627. </tr><tr><td><p>&#34;Data&#34;</p></td>
  23628. <td><p>TemplateTargetData stores template results in the data field of the secret.</p>
  23629. </td>
  23630. </tr><tr><td><p>&#34;Labels&#34;</p></td>
  23631. <td><p>TemplateTargetLabels stores template results in the labels field of the secret.</p>
  23632. </td>
  23633. </tr></tbody>
  23634. </table>
  23635. <h3 id="external-secrets.io/v1beta1.TokenAuth">TokenAuth
  23636. </h3>
  23637. <p>
  23638. (<em>Appears on:</em>
  23639. <a href="#external-secrets.io/v1beta1.KubernetesAuth">KubernetesAuth</a>)
  23640. </p>
  23641. <p>
  23642. <p>TokenAuth defines token-based authentication for the Kubernetes provider.</p>
  23643. </p>
  23644. <table>
  23645. <thead>
  23646. <tr>
  23647. <th>Field</th>
  23648. <th>Description</th>
  23649. </tr>
  23650. </thead>
  23651. <tbody>
  23652. <tr>
  23653. <td>
  23654. <code>bearerToken</code></br>
  23655. <em>
  23656. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23657. External Secrets meta/v1.SecretKeySelector
  23658. </a>
  23659. </em>
  23660. </td>
  23661. <td>
  23662. </td>
  23663. </tr>
  23664. </tbody>
  23665. </table>
  23666. <h3 id="external-secrets.io/v1beta1.UniversalAuthCredentials">UniversalAuthCredentials
  23667. </h3>
  23668. <p>
  23669. (<em>Appears on:</em>
  23670. <a href="#external-secrets.io/v1beta1.InfisicalAuth">InfisicalAuth</a>)
  23671. </p>
  23672. <p>
  23673. <p>UniversalAuthCredentials defines the credentials for Infisical Universal Auth.</p>
  23674. </p>
  23675. <table>
  23676. <thead>
  23677. <tr>
  23678. <th>Field</th>
  23679. <th>Description</th>
  23680. </tr>
  23681. </thead>
  23682. <tbody>
  23683. <tr>
  23684. <td>
  23685. <code>clientId</code></br>
  23686. <em>
  23687. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23688. External Secrets meta/v1.SecretKeySelector
  23689. </a>
  23690. </em>
  23691. </td>
  23692. <td>
  23693. </td>
  23694. </tr>
  23695. <tr>
  23696. <td>
  23697. <code>clientSecret</code></br>
  23698. <em>
  23699. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23700. External Secrets meta/v1.SecretKeySelector
  23701. </a>
  23702. </em>
  23703. </td>
  23704. <td>
  23705. </td>
  23706. </tr>
  23707. </tbody>
  23708. </table>
  23709. <h3 id="external-secrets.io/v1beta1.ValidationResult">ValidationResult
  23710. (<code>byte</code> alias)</p></h3>
  23711. <p>
  23712. <p>ValidationResult represents the result of validating a provider client configuration.</p>
  23713. </p>
  23714. <table>
  23715. <thead>
  23716. <tr>
  23717. <th>Value</th>
  23718. <th>Description</th>
  23719. </tr>
  23720. </thead>
  23721. <tbody><tr><td><p>2</p></td>
  23722. <td><p>ValidationResultError indicates that there is a misconfiguration.</p>
  23723. </td>
  23724. </tr><tr><td><p>0</p></td>
  23725. <td><p>ValidationResultReady indicates that the client is configured correctly and can be used.</p>
  23726. </td>
  23727. </tr><tr><td><p>1</p></td>
  23728. <td><p>ValidationResultUnknown indicates that the client can be used but information is missing and it can not be validated.</p>
  23729. </td>
  23730. </tr></tbody>
  23731. </table>
  23732. <h3 id="external-secrets.io/v1beta1.VaultAppRole">VaultAppRole
  23733. </h3>
  23734. <p>
  23735. (<em>Appears on:</em>
  23736. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  23737. </p>
  23738. <p>
  23739. <p>VaultAppRole authenticates with Vault using the App Role auth mechanism,
  23740. with the role and secret stored in a Kubernetes Secret resource.</p>
  23741. </p>
  23742. <table>
  23743. <thead>
  23744. <tr>
  23745. <th>Field</th>
  23746. <th>Description</th>
  23747. </tr>
  23748. </thead>
  23749. <tbody>
  23750. <tr>
  23751. <td>
  23752. <code>path</code></br>
  23753. <em>
  23754. string
  23755. </em>
  23756. </td>
  23757. <td>
  23758. <p>Path where the App Role authentication backend is mounted
  23759. in Vault, e.g: &ldquo;approle&rdquo;</p>
  23760. </td>
  23761. </tr>
  23762. <tr>
  23763. <td>
  23764. <code>roleId</code></br>
  23765. <em>
  23766. string
  23767. </em>
  23768. </td>
  23769. <td>
  23770. <em>(Optional)</em>
  23771. <p>RoleID configured in the App Role authentication backend when setting
  23772. up the authentication backend in Vault.</p>
  23773. </td>
  23774. </tr>
  23775. <tr>
  23776. <td>
  23777. <code>roleRef</code></br>
  23778. <em>
  23779. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23780. External Secrets meta/v1.SecretKeySelector
  23781. </a>
  23782. </em>
  23783. </td>
  23784. <td>
  23785. <em>(Optional)</em>
  23786. <p>Reference to a key in a Secret that contains the App Role ID used
  23787. to authenticate with Vault.
  23788. The <code>key</code> field must be specified and denotes which entry within the Secret
  23789. resource is used as the app role id.</p>
  23790. </td>
  23791. </tr>
  23792. <tr>
  23793. <td>
  23794. <code>secretRef</code></br>
  23795. <em>
  23796. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23797. External Secrets meta/v1.SecretKeySelector
  23798. </a>
  23799. </em>
  23800. </td>
  23801. <td>
  23802. <p>Reference to a key in a Secret that contains the App Role secret used
  23803. to authenticate with Vault.
  23804. The <code>key</code> field must be specified and denotes which entry within the Secret
  23805. resource is used as the app role secret.</p>
  23806. </td>
  23807. </tr>
  23808. </tbody>
  23809. </table>
  23810. <h3 id="external-secrets.io/v1beta1.VaultAuth">VaultAuth
  23811. </h3>
  23812. <p>
  23813. (<em>Appears on:</em>
  23814. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  23815. </p>
  23816. <p>
  23817. <p>VaultAuth is the configuration used to authenticate with a Vault server.
  23818. 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>
  23819. can be specified. A namespace to authenticate against can optionally be specified.</p>
  23820. </p>
  23821. <table>
  23822. <thead>
  23823. <tr>
  23824. <th>Field</th>
  23825. <th>Description</th>
  23826. </tr>
  23827. </thead>
  23828. <tbody>
  23829. <tr>
  23830. <td>
  23831. <code>namespace</code></br>
  23832. <em>
  23833. string
  23834. </em>
  23835. </td>
  23836. <td>
  23837. <em>(Optional)</em>
  23838. <p>Name of the vault namespace to authenticate to. This can be different than the namespace your secret is in.
  23839. Namespaces is a set of features within Vault Enterprise that allows
  23840. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  23841. More about namespaces can be found here <a href="https://www.vaultproject.io/docs/enterprise/namespaces">https://www.vaultproject.io/docs/enterprise/namespaces</a>
  23842. This will default to Vault.Namespace field if set, or empty otherwise</p>
  23843. </td>
  23844. </tr>
  23845. <tr>
  23846. <td>
  23847. <code>tokenSecretRef</code></br>
  23848. <em>
  23849. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  23850. External Secrets meta/v1.SecretKeySelector
  23851. </a>
  23852. </em>
  23853. </td>
  23854. <td>
  23855. <em>(Optional)</em>
  23856. <p>TokenSecretRef authenticates with Vault by presenting a token.</p>
  23857. </td>
  23858. </tr>
  23859. <tr>
  23860. <td>
  23861. <code>appRole</code></br>
  23862. <em>
  23863. <a href="#external-secrets.io/v1beta1.VaultAppRole">
  23864. VaultAppRole
  23865. </a>
  23866. </em>
  23867. </td>
  23868. <td>
  23869. <em>(Optional)</em>
  23870. <p>AppRole authenticates with Vault using the App Role auth mechanism,
  23871. with the role and secret stored in a Kubernetes Secret resource.</p>
  23872. </td>
  23873. </tr>
  23874. <tr>
  23875. <td>
  23876. <code>kubernetes</code></br>
  23877. <em>
  23878. <a href="#external-secrets.io/v1beta1.VaultKubernetesAuth">
  23879. VaultKubernetesAuth
  23880. </a>
  23881. </em>
  23882. </td>
  23883. <td>
  23884. <em>(Optional)</em>
  23885. <p>Kubernetes authenticates with Vault by passing the ServiceAccount
  23886. token stored in the named Secret resource to the Vault server.</p>
  23887. </td>
  23888. </tr>
  23889. <tr>
  23890. <td>
  23891. <code>ldap</code></br>
  23892. <em>
  23893. <a href="#external-secrets.io/v1beta1.VaultLdapAuth">
  23894. VaultLdapAuth
  23895. </a>
  23896. </em>
  23897. </td>
  23898. <td>
  23899. <em>(Optional)</em>
  23900. <p>Ldap authenticates with Vault by passing username/password pair using
  23901. the LDAP authentication method</p>
  23902. </td>
  23903. </tr>
  23904. <tr>
  23905. <td>
  23906. <code>jwt</code></br>
  23907. <em>
  23908. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">
  23909. VaultJwtAuth
  23910. </a>
  23911. </em>
  23912. </td>
  23913. <td>
  23914. <em>(Optional)</em>
  23915. <p>Jwt authenticates with Vault by passing role and JWT token using the
  23916. JWT/OIDC authentication method</p>
  23917. </td>
  23918. </tr>
  23919. <tr>
  23920. <td>
  23921. <code>cert</code></br>
  23922. <em>
  23923. <a href="#external-secrets.io/v1beta1.VaultCertAuth">
  23924. VaultCertAuth
  23925. </a>
  23926. </em>
  23927. </td>
  23928. <td>
  23929. <em>(Optional)</em>
  23930. <p>Cert authenticates with TLS Certificates by passing client certificate, private key and ca certificate
  23931. Cert authentication method</p>
  23932. </td>
  23933. </tr>
  23934. <tr>
  23935. <td>
  23936. <code>iam</code></br>
  23937. <em>
  23938. <a href="#external-secrets.io/v1beta1.VaultIamAuth">
  23939. VaultIamAuth
  23940. </a>
  23941. </em>
  23942. </td>
  23943. <td>
  23944. <em>(Optional)</em>
  23945. <p>Iam authenticates with vault by passing a special AWS request signed with AWS IAM credentials
  23946. AWS IAM authentication method</p>
  23947. </td>
  23948. </tr>
  23949. <tr>
  23950. <td>
  23951. <code>userPass</code></br>
  23952. <em>
  23953. <a href="#external-secrets.io/v1beta1.VaultUserPassAuth">
  23954. VaultUserPassAuth
  23955. </a>
  23956. </em>
  23957. </td>
  23958. <td>
  23959. <em>(Optional)</em>
  23960. <p>UserPass authenticates with Vault by passing username/password pair</p>
  23961. </td>
  23962. </tr>
  23963. </tbody>
  23964. </table>
  23965. <h3 id="external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth
  23966. </h3>
  23967. <p>
  23968. <p>VaultAwsAuth tells the controller how to do authentication with aws.
  23969. Only one of secretRef or jwt can be specified.
  23970. if none is specified the controller will try to load credentials from its own service account assuming it is IRSA enabled.</p>
  23971. </p>
  23972. <table>
  23973. <thead>
  23974. <tr>
  23975. <th>Field</th>
  23976. <th>Description</th>
  23977. </tr>
  23978. </thead>
  23979. <tbody>
  23980. <tr>
  23981. <td>
  23982. <code>secretRef</code></br>
  23983. <em>
  23984. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  23985. VaultAwsAuthSecretRef
  23986. </a>
  23987. </em>
  23988. </td>
  23989. <td>
  23990. <em>(Optional)</em>
  23991. </td>
  23992. </tr>
  23993. <tr>
  23994. <td>
  23995. <code>jwt</code></br>
  23996. <em>
  23997. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  23998. VaultAwsJWTAuth
  23999. </a>
  24000. </em>
  24001. </td>
  24002. <td>
  24003. <em>(Optional)</em>
  24004. </td>
  24005. </tr>
  24006. </tbody>
  24007. </table>
  24008. <h3 id="external-secrets.io/v1beta1.VaultAwsAuthSecretRef">VaultAwsAuthSecretRef
  24009. </h3>
  24010. <p>
  24011. (<em>Appears on:</em>
  24012. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  24013. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  24014. </p>
  24015. <p>
  24016. <p>VaultAwsAuthSecretRef holds secret references for AWS credentials
  24017. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  24018. </p>
  24019. <table>
  24020. <thead>
  24021. <tr>
  24022. <th>Field</th>
  24023. <th>Description</th>
  24024. </tr>
  24025. </thead>
  24026. <tbody>
  24027. <tr>
  24028. <td>
  24029. <code>accessKeyIDSecretRef</code></br>
  24030. <em>
  24031. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24032. External Secrets meta/v1.SecretKeySelector
  24033. </a>
  24034. </em>
  24035. </td>
  24036. <td>
  24037. <em>(Optional)</em>
  24038. <p>The AccessKeyID is used for authentication</p>
  24039. </td>
  24040. </tr>
  24041. <tr>
  24042. <td>
  24043. <code>secretAccessKeySecretRef</code></br>
  24044. <em>
  24045. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24046. External Secrets meta/v1.SecretKeySelector
  24047. </a>
  24048. </em>
  24049. </td>
  24050. <td>
  24051. <em>(Optional)</em>
  24052. <p>The SecretAccessKey is used for authentication</p>
  24053. </td>
  24054. </tr>
  24055. <tr>
  24056. <td>
  24057. <code>sessionTokenSecretRef</code></br>
  24058. <em>
  24059. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24060. External Secrets meta/v1.SecretKeySelector
  24061. </a>
  24062. </em>
  24063. </td>
  24064. <td>
  24065. <em>(Optional)</em>
  24066. <p>The SessionToken used for authentication
  24067. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  24068. 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>
  24069. </td>
  24070. </tr>
  24071. </tbody>
  24072. </table>
  24073. <h3 id="external-secrets.io/v1beta1.VaultAwsJWTAuth">VaultAwsJWTAuth
  24074. </h3>
  24075. <p>
  24076. (<em>Appears on:</em>
  24077. <a href="#external-secrets.io/v1beta1.VaultAwsAuth">VaultAwsAuth</a>,
  24078. <a href="#external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth</a>)
  24079. </p>
  24080. <p>
  24081. <p>VaultAwsJWTAuth Authenticate against AWS using service account tokens.</p>
  24082. </p>
  24083. <table>
  24084. <thead>
  24085. <tr>
  24086. <th>Field</th>
  24087. <th>Description</th>
  24088. </tr>
  24089. </thead>
  24090. <tbody>
  24091. <tr>
  24092. <td>
  24093. <code>serviceAccountRef</code></br>
  24094. <em>
  24095. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  24096. External Secrets meta/v1.ServiceAccountSelector
  24097. </a>
  24098. </em>
  24099. </td>
  24100. <td>
  24101. <em>(Optional)</em>
  24102. </td>
  24103. </tr>
  24104. </tbody>
  24105. </table>
  24106. <h3 id="external-secrets.io/v1beta1.VaultCertAuth">VaultCertAuth
  24107. </h3>
  24108. <p>
  24109. (<em>Appears on:</em>
  24110. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24111. </p>
  24112. <p>
  24113. <p>VaultCertAuth authenticates with Vault using the JWT/OIDC authentication
  24114. method, with the role name and token stored in a Kubernetes Secret resource.</p>
  24115. </p>
  24116. <table>
  24117. <thead>
  24118. <tr>
  24119. <th>Field</th>
  24120. <th>Description</th>
  24121. </tr>
  24122. </thead>
  24123. <tbody>
  24124. <tr>
  24125. <td>
  24126. <code>clientCert</code></br>
  24127. <em>
  24128. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24129. External Secrets meta/v1.SecretKeySelector
  24130. </a>
  24131. </em>
  24132. </td>
  24133. <td>
  24134. <em>(Optional)</em>
  24135. <p>ClientCert is a certificate to authenticate using the Cert Vault
  24136. authentication method</p>
  24137. </td>
  24138. </tr>
  24139. <tr>
  24140. <td>
  24141. <code>secretRef</code></br>
  24142. <em>
  24143. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24144. External Secrets meta/v1.SecretKeySelector
  24145. </a>
  24146. </em>
  24147. </td>
  24148. <td>
  24149. <em>(Optional)</em>
  24150. <p>SecretRef to a key in a Secret resource containing client private key to
  24151. authenticate with Vault using the Cert authentication method</p>
  24152. </td>
  24153. </tr>
  24154. </tbody>
  24155. </table>
  24156. <h3 id="external-secrets.io/v1beta1.VaultClientTLS">VaultClientTLS
  24157. </h3>
  24158. <p>
  24159. (<em>Appears on:</em>
  24160. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  24161. </p>
  24162. <p>
  24163. <p>VaultClientTLS is the configuration used for client side related TLS communication,
  24164. when the Vault server requires mutual authentication.</p>
  24165. </p>
  24166. <table>
  24167. <thead>
  24168. <tr>
  24169. <th>Field</th>
  24170. <th>Description</th>
  24171. </tr>
  24172. </thead>
  24173. <tbody>
  24174. <tr>
  24175. <td>
  24176. <code>certSecretRef</code></br>
  24177. <em>
  24178. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24179. External Secrets meta/v1.SecretKeySelector
  24180. </a>
  24181. </em>
  24182. </td>
  24183. <td>
  24184. <em>(Optional)</em>
  24185. <p>CertSecretRef is a certificate added to the transport layer
  24186. when communicating with the Vault server.
  24187. If no key for the Secret is specified, external-secret will default to &lsquo;tls.crt&rsquo;.</p>
  24188. </td>
  24189. </tr>
  24190. <tr>
  24191. <td>
  24192. <code>keySecretRef</code></br>
  24193. <em>
  24194. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24195. External Secrets meta/v1.SecretKeySelector
  24196. </a>
  24197. </em>
  24198. </td>
  24199. <td>
  24200. <em>(Optional)</em>
  24201. <p>KeySecretRef to a key in a Secret resource containing client private key
  24202. added to the transport layer when communicating with the Vault server.
  24203. If no key for the Secret is specified, external-secret will default to &lsquo;tls.key&rsquo;.</p>
  24204. </td>
  24205. </tr>
  24206. </tbody>
  24207. </table>
  24208. <h3 id="external-secrets.io/v1beta1.VaultIamAuth">VaultIamAuth
  24209. </h3>
  24210. <p>
  24211. (<em>Appears on:</em>
  24212. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24213. </p>
  24214. <p>
  24215. <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>
  24216. </p>
  24217. <table>
  24218. <thead>
  24219. <tr>
  24220. <th>Field</th>
  24221. <th>Description</th>
  24222. </tr>
  24223. </thead>
  24224. <tbody>
  24225. <tr>
  24226. <td>
  24227. <code>path</code></br>
  24228. <em>
  24229. string
  24230. </em>
  24231. </td>
  24232. <td>
  24233. <em>(Optional)</em>
  24234. <p>Path where the AWS auth method is enabled in Vault, e.g: &ldquo;aws&rdquo;</p>
  24235. </td>
  24236. </tr>
  24237. <tr>
  24238. <td>
  24239. <code>region</code></br>
  24240. <em>
  24241. string
  24242. </em>
  24243. </td>
  24244. <td>
  24245. <em>(Optional)</em>
  24246. <p>AWS region</p>
  24247. </td>
  24248. </tr>
  24249. <tr>
  24250. <td>
  24251. <code>role</code></br>
  24252. <em>
  24253. string
  24254. </em>
  24255. </td>
  24256. <td>
  24257. <em>(Optional)</em>
  24258. <p>This is the AWS role to be assumed before talking to vault</p>
  24259. </td>
  24260. </tr>
  24261. <tr>
  24262. <td>
  24263. <code>vaultRole</code></br>
  24264. <em>
  24265. string
  24266. </em>
  24267. </td>
  24268. <td>
  24269. <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>
  24270. </td>
  24271. </tr>
  24272. <tr>
  24273. <td>
  24274. <code>externalID</code></br>
  24275. <em>
  24276. string
  24277. </em>
  24278. </td>
  24279. <td>
  24280. <p>AWS External ID set on assumed IAM roles</p>
  24281. </td>
  24282. </tr>
  24283. <tr>
  24284. <td>
  24285. <code>vaultAwsIamServerID</code></br>
  24286. <em>
  24287. string
  24288. </em>
  24289. </td>
  24290. <td>
  24291. <em>(Optional)</em>
  24292. <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>
  24293. </td>
  24294. </tr>
  24295. <tr>
  24296. <td>
  24297. <code>secretRef</code></br>
  24298. <em>
  24299. <a href="#external-secrets.io/v1beta1.VaultAwsAuthSecretRef">
  24300. VaultAwsAuthSecretRef
  24301. </a>
  24302. </em>
  24303. </td>
  24304. <td>
  24305. <em>(Optional)</em>
  24306. <p>Specify credentials in a Secret object</p>
  24307. </td>
  24308. </tr>
  24309. <tr>
  24310. <td>
  24311. <code>jwt</code></br>
  24312. <em>
  24313. <a href="#external-secrets.io/v1beta1.VaultAwsJWTAuth">
  24314. VaultAwsJWTAuth
  24315. </a>
  24316. </em>
  24317. </td>
  24318. <td>
  24319. <em>(Optional)</em>
  24320. <p>Specify a service account with IRSA enabled</p>
  24321. </td>
  24322. </tr>
  24323. </tbody>
  24324. </table>
  24325. <h3 id="external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth
  24326. </h3>
  24327. <p>
  24328. (<em>Appears on:</em>
  24329. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24330. </p>
  24331. <p>
  24332. <p>VaultJwtAuth authenticates with Vault using the JWT/OIDC authentication
  24333. method, with the role name and a token stored in a Kubernetes Secret resource or
  24334. a Kubernetes service account token retrieved via <code>TokenRequest</code>.</p>
  24335. </p>
  24336. <table>
  24337. <thead>
  24338. <tr>
  24339. <th>Field</th>
  24340. <th>Description</th>
  24341. </tr>
  24342. </thead>
  24343. <tbody>
  24344. <tr>
  24345. <td>
  24346. <code>path</code></br>
  24347. <em>
  24348. string
  24349. </em>
  24350. </td>
  24351. <td>
  24352. <p>Path where the JWT authentication backend is mounted
  24353. in Vault, e.g: &ldquo;jwt&rdquo;</p>
  24354. </td>
  24355. </tr>
  24356. <tr>
  24357. <td>
  24358. <code>role</code></br>
  24359. <em>
  24360. string
  24361. </em>
  24362. </td>
  24363. <td>
  24364. <em>(Optional)</em>
  24365. <p>Role is a JWT role to authenticate using the JWT/OIDC Vault
  24366. authentication method</p>
  24367. </td>
  24368. </tr>
  24369. <tr>
  24370. <td>
  24371. <code>secretRef</code></br>
  24372. <em>
  24373. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24374. External Secrets meta/v1.SecretKeySelector
  24375. </a>
  24376. </em>
  24377. </td>
  24378. <td>
  24379. <em>(Optional)</em>
  24380. <p>Optional SecretRef that refers to a key in a Secret resource containing JWT token to
  24381. authenticate with Vault using the JWT/OIDC authentication method.</p>
  24382. </td>
  24383. </tr>
  24384. <tr>
  24385. <td>
  24386. <code>kubernetesServiceAccountToken</code></br>
  24387. <em>
  24388. <a href="#external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">
  24389. VaultKubernetesServiceAccountTokenAuth
  24390. </a>
  24391. </em>
  24392. </td>
  24393. <td>
  24394. <em>(Optional)</em>
  24395. <p>Optional ServiceAccountToken specifies the Kubernetes service account for which to request
  24396. a token for with the <code>TokenRequest</code> API.</p>
  24397. </td>
  24398. </tr>
  24399. </tbody>
  24400. </table>
  24401. <h3 id="external-secrets.io/v1beta1.VaultKVStoreVersion">VaultKVStoreVersion
  24402. (<code>string</code> alias)</p></h3>
  24403. <p>
  24404. (<em>Appears on:</em>
  24405. <a href="#external-secrets.io/v1beta1.VaultProvider">VaultProvider</a>)
  24406. </p>
  24407. <p>
  24408. <p>VaultKVStoreVersion defines the version of the KV store in Vault.</p>
  24409. </p>
  24410. <table>
  24411. <thead>
  24412. <tr>
  24413. <th>Value</th>
  24414. <th>Description</th>
  24415. </tr>
  24416. </thead>
  24417. <tbody><tr><td><p>&#34;v1&#34;</p></td>
  24418. <td><p>VaultKVStoreV1 represents version 1 of the Vault KV store.</p>
  24419. </td>
  24420. </tr><tr><td><p>&#34;v2&#34;</p></td>
  24421. <td><p>VaultKVStoreV2 represents version 2 of the Vault KV store.</p>
  24422. </td>
  24423. </tr></tbody>
  24424. </table>
  24425. <h3 id="external-secrets.io/v1beta1.VaultKubernetesAuth">VaultKubernetesAuth
  24426. </h3>
  24427. <p>
  24428. (<em>Appears on:</em>
  24429. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24430. </p>
  24431. <p>
  24432. <p>VaultKubernetesAuth authenticates against Vault using a Kubernetes ServiceAccount token stored in a Secret.</p>
  24433. </p>
  24434. <table>
  24435. <thead>
  24436. <tr>
  24437. <th>Field</th>
  24438. <th>Description</th>
  24439. </tr>
  24440. </thead>
  24441. <tbody>
  24442. <tr>
  24443. <td>
  24444. <code>mountPath</code></br>
  24445. <em>
  24446. string
  24447. </em>
  24448. </td>
  24449. <td>
  24450. <p>Path where the Kubernetes authentication backend is mounted in Vault, e.g:
  24451. &ldquo;kubernetes&rdquo;</p>
  24452. </td>
  24453. </tr>
  24454. <tr>
  24455. <td>
  24456. <code>serviceAccountRef</code></br>
  24457. <em>
  24458. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  24459. External Secrets meta/v1.ServiceAccountSelector
  24460. </a>
  24461. </em>
  24462. </td>
  24463. <td>
  24464. <em>(Optional)</em>
  24465. <p>Optional service account field containing the name of a kubernetes ServiceAccount.
  24466. If the service account is specified, the service account secret token JWT will be used
  24467. for authenticating with Vault. If the service account selector is not supplied,
  24468. the secretRef will be used instead.</p>
  24469. </td>
  24470. </tr>
  24471. <tr>
  24472. <td>
  24473. <code>secretRef</code></br>
  24474. <em>
  24475. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24476. External Secrets meta/v1.SecretKeySelector
  24477. </a>
  24478. </em>
  24479. </td>
  24480. <td>
  24481. <em>(Optional)</em>
  24482. <p>Optional secret field containing a Kubernetes ServiceAccount JWT used
  24483. for authenticating with Vault. If a name is specified without a key,
  24484. <code>token</code> is the default. If one is not specified, the one bound to
  24485. the controller will be used.</p>
  24486. </td>
  24487. </tr>
  24488. <tr>
  24489. <td>
  24490. <code>role</code></br>
  24491. <em>
  24492. string
  24493. </em>
  24494. </td>
  24495. <td>
  24496. <p>A required field containing the Vault Role to assume. A Role binds a
  24497. Kubernetes ServiceAccount with a set of Vault policies.</p>
  24498. </td>
  24499. </tr>
  24500. </tbody>
  24501. </table>
  24502. <h3 id="external-secrets.io/v1beta1.VaultKubernetesServiceAccountTokenAuth">VaultKubernetesServiceAccountTokenAuth
  24503. </h3>
  24504. <p>
  24505. (<em>Appears on:</em>
  24506. <a href="#external-secrets.io/v1beta1.VaultJwtAuth">VaultJwtAuth</a>)
  24507. </p>
  24508. <p>
  24509. <p>VaultKubernetesServiceAccountTokenAuth authenticates with Vault using a temporary
  24510. Kubernetes service account token retrieved by the <code>TokenRequest</code> API.</p>
  24511. </p>
  24512. <table>
  24513. <thead>
  24514. <tr>
  24515. <th>Field</th>
  24516. <th>Description</th>
  24517. </tr>
  24518. </thead>
  24519. <tbody>
  24520. <tr>
  24521. <td>
  24522. <code>serviceAccountRef</code></br>
  24523. <em>
  24524. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  24525. External Secrets meta/v1.ServiceAccountSelector
  24526. </a>
  24527. </em>
  24528. </td>
  24529. <td>
  24530. <p>Service account field containing the name of a kubernetes ServiceAccount.</p>
  24531. </td>
  24532. </tr>
  24533. <tr>
  24534. <td>
  24535. <code>audiences</code></br>
  24536. <em>
  24537. []string
  24538. </em>
  24539. </td>
  24540. <td>
  24541. <em>(Optional)</em>
  24542. <p>Optional audiences field that will be used to request a temporary Kubernetes service
  24543. account token for the service account referenced by <code>serviceAccountRef</code>.
  24544. Defaults to a single audience <code>vault</code> it not specified.</p>
  24545. <p>Deprecated: use serviceAccountRef.Audiences instead</p>
  24546. </td>
  24547. </tr>
  24548. <tr>
  24549. <td>
  24550. <code>expirationSeconds</code></br>
  24551. <em>
  24552. int64
  24553. </em>
  24554. </td>
  24555. <td>
  24556. <em>(Optional)</em>
  24557. <p>Optional expiration time in seconds that will be used to request a temporary
  24558. Kubernetes service account token for the service account referenced by
  24559. <code>serviceAccountRef</code>.</p>
  24560. <p>Deprecated: this will be removed in the future.
  24561. Defaults to 10 minutes.</p>
  24562. </td>
  24563. </tr>
  24564. </tbody>
  24565. </table>
  24566. <h3 id="external-secrets.io/v1beta1.VaultLdapAuth">VaultLdapAuth
  24567. </h3>
  24568. <p>
  24569. (<em>Appears on:</em>
  24570. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24571. </p>
  24572. <p>
  24573. <p>VaultLdapAuth authenticates with Vault using the LDAP authentication method,
  24574. with the username and password stored in a Kubernetes Secret resource.</p>
  24575. </p>
  24576. <table>
  24577. <thead>
  24578. <tr>
  24579. <th>Field</th>
  24580. <th>Description</th>
  24581. </tr>
  24582. </thead>
  24583. <tbody>
  24584. <tr>
  24585. <td>
  24586. <code>path</code></br>
  24587. <em>
  24588. string
  24589. </em>
  24590. </td>
  24591. <td>
  24592. <p>Path where the LDAP authentication backend is mounted
  24593. in Vault, e.g: &ldquo;ldap&rdquo;</p>
  24594. </td>
  24595. </tr>
  24596. <tr>
  24597. <td>
  24598. <code>username</code></br>
  24599. <em>
  24600. string
  24601. </em>
  24602. </td>
  24603. <td>
  24604. <p>Username is an LDAP username used to authenticate using the LDAP Vault
  24605. authentication method</p>
  24606. </td>
  24607. </tr>
  24608. <tr>
  24609. <td>
  24610. <code>secretRef</code></br>
  24611. <em>
  24612. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24613. External Secrets meta/v1.SecretKeySelector
  24614. </a>
  24615. </em>
  24616. </td>
  24617. <td>
  24618. <em>(Optional)</em>
  24619. <p>SecretRef to a key in a Secret resource containing password for the LDAP
  24620. user used to authenticate with Vault using the LDAP authentication
  24621. method</p>
  24622. </td>
  24623. </tr>
  24624. </tbody>
  24625. </table>
  24626. <h3 id="external-secrets.io/v1beta1.VaultProvider">VaultProvider
  24627. </h3>
  24628. <p>
  24629. (<em>Appears on:</em>
  24630. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24631. </p>
  24632. <p>
  24633. <p>VaultProvider configures a store to sync secrets using a HashiCorp Vault KV backend.</p>
  24634. </p>
  24635. <table>
  24636. <thead>
  24637. <tr>
  24638. <th>Field</th>
  24639. <th>Description</th>
  24640. </tr>
  24641. </thead>
  24642. <tbody>
  24643. <tr>
  24644. <td>
  24645. <code>auth</code></br>
  24646. <em>
  24647. <a href="#external-secrets.io/v1beta1.VaultAuth">
  24648. VaultAuth
  24649. </a>
  24650. </em>
  24651. </td>
  24652. <td>
  24653. <p>Auth configures how secret-manager authenticates with the Vault server.</p>
  24654. </td>
  24655. </tr>
  24656. <tr>
  24657. <td>
  24658. <code>server</code></br>
  24659. <em>
  24660. string
  24661. </em>
  24662. </td>
  24663. <td>
  24664. <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>
  24665. </td>
  24666. </tr>
  24667. <tr>
  24668. <td>
  24669. <code>path</code></br>
  24670. <em>
  24671. string
  24672. </em>
  24673. </td>
  24674. <td>
  24675. <em>(Optional)</em>
  24676. <p>Path is the mount path of the Vault KV backend endpoint, e.g:
  24677. &ldquo;secret&rdquo;. The v2 KV secret engine version specific &ldquo;/data&rdquo; path suffix
  24678. for fetching secrets from Vault is optional and will be appended
  24679. if not present in specified path.</p>
  24680. </td>
  24681. </tr>
  24682. <tr>
  24683. <td>
  24684. <code>version</code></br>
  24685. <em>
  24686. <a href="#external-secrets.io/v1beta1.VaultKVStoreVersion">
  24687. VaultKVStoreVersion
  24688. </a>
  24689. </em>
  24690. </td>
  24691. <td>
  24692. <p>Version is the Vault KV secret engine version. This can be either &ldquo;v1&rdquo; or
  24693. &ldquo;v2&rdquo;. Version defaults to &ldquo;v2&rdquo;.</p>
  24694. </td>
  24695. </tr>
  24696. <tr>
  24697. <td>
  24698. <code>namespace</code></br>
  24699. <em>
  24700. string
  24701. </em>
  24702. </td>
  24703. <td>
  24704. <em>(Optional)</em>
  24705. <p>Name of the vault namespace. Namespaces is a set of features within Vault Enterprise that allows
  24706. Vault environments to support Secure Multi-tenancy. e.g: &ldquo;ns1&rdquo;.
  24707. 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>
  24708. </td>
  24709. </tr>
  24710. <tr>
  24711. <td>
  24712. <code>caBundle</code></br>
  24713. <em>
  24714. []byte
  24715. </em>
  24716. </td>
  24717. <td>
  24718. <em>(Optional)</em>
  24719. <p>PEM encoded CA bundle used to validate Vault server certificate. Only used
  24720. if the Server URL is using HTTPS protocol. This parameter is ignored for
  24721. plain HTTP protocol connection. If not set the system root certificates
  24722. are used to validate the TLS connection.</p>
  24723. </td>
  24724. </tr>
  24725. <tr>
  24726. <td>
  24727. <code>tls</code></br>
  24728. <em>
  24729. <a href="#external-secrets.io/v1beta1.VaultClientTLS">
  24730. VaultClientTLS
  24731. </a>
  24732. </em>
  24733. </td>
  24734. <td>
  24735. <em>(Optional)</em>
  24736. <p>The configuration used for client side related TLS communication, when the Vault server
  24737. requires mutual authentication. Only used if the Server URL is using HTTPS protocol.
  24738. This parameter is ignored for plain HTTP protocol connection.
  24739. It&rsquo;s worth noting this configuration is different from the &ldquo;TLS certificates auth method&rdquo;,
  24740. which is available under the <code>auth.cert</code> section.</p>
  24741. </td>
  24742. </tr>
  24743. <tr>
  24744. <td>
  24745. <code>caProvider</code></br>
  24746. <em>
  24747. <a href="#external-secrets.io/v1beta1.CAProvider">
  24748. CAProvider
  24749. </a>
  24750. </em>
  24751. </td>
  24752. <td>
  24753. <em>(Optional)</em>
  24754. <p>The provider for the CA bundle to use to validate Vault server certificate.</p>
  24755. </td>
  24756. </tr>
  24757. <tr>
  24758. <td>
  24759. <code>readYourWrites</code></br>
  24760. <em>
  24761. bool
  24762. </em>
  24763. </td>
  24764. <td>
  24765. <em>(Optional)</em>
  24766. <p>ReadYourWrites ensures isolated read-after-write semantics by
  24767. providing discovered cluster replication states in each request.
  24768. More information about eventual consistency in Vault can be found here
  24769. <a href="https://www.vaultproject.io/docs/enterprise/consistency">https://www.vaultproject.io/docs/enterprise/consistency</a></p>
  24770. </td>
  24771. </tr>
  24772. <tr>
  24773. <td>
  24774. <code>forwardInconsistent</code></br>
  24775. <em>
  24776. bool
  24777. </em>
  24778. </td>
  24779. <td>
  24780. <em>(Optional)</em>
  24781. <p>ForwardInconsistent tells Vault to forward read-after-write requests to the Vault
  24782. leader instead of simply retrying within a loop. This can increase performance if
  24783. the option is enabled serverside.
  24784. <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>
  24785. </td>
  24786. </tr>
  24787. <tr>
  24788. <td>
  24789. <code>headers</code></br>
  24790. <em>
  24791. map[string]string
  24792. </em>
  24793. </td>
  24794. <td>
  24795. <em>(Optional)</em>
  24796. <p>Headers to be added in Vault request</p>
  24797. </td>
  24798. </tr>
  24799. </tbody>
  24800. </table>
  24801. <h3 id="external-secrets.io/v1beta1.VaultUserPassAuth">VaultUserPassAuth
  24802. </h3>
  24803. <p>
  24804. (<em>Appears on:</em>
  24805. <a href="#external-secrets.io/v1beta1.VaultAuth">VaultAuth</a>)
  24806. </p>
  24807. <p>
  24808. <p>VaultUserPassAuth authenticates with Vault using UserPass authentication method,
  24809. with the username and password stored in a Kubernetes Secret resource.</p>
  24810. </p>
  24811. <table>
  24812. <thead>
  24813. <tr>
  24814. <th>Field</th>
  24815. <th>Description</th>
  24816. </tr>
  24817. </thead>
  24818. <tbody>
  24819. <tr>
  24820. <td>
  24821. <code>path</code></br>
  24822. <em>
  24823. string
  24824. </em>
  24825. </td>
  24826. <td>
  24827. <p>Path where the UserPassword authentication backend is mounted
  24828. in Vault, e.g: &ldquo;userpass&rdquo;</p>
  24829. </td>
  24830. </tr>
  24831. <tr>
  24832. <td>
  24833. <code>username</code></br>
  24834. <em>
  24835. string
  24836. </em>
  24837. </td>
  24838. <td>
  24839. <p>Username is a username used to authenticate using the UserPass Vault
  24840. authentication method</p>
  24841. </td>
  24842. </tr>
  24843. <tr>
  24844. <td>
  24845. <code>secretRef</code></br>
  24846. <em>
  24847. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  24848. External Secrets meta/v1.SecretKeySelector
  24849. </a>
  24850. </em>
  24851. </td>
  24852. <td>
  24853. <em>(Optional)</em>
  24854. <p>SecretRef to a key in a Secret resource containing password for the
  24855. user used to authenticate with Vault using the UserPass authentication
  24856. method</p>
  24857. </td>
  24858. </tr>
  24859. </tbody>
  24860. </table>
  24861. <h3 id="external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider
  24862. </h3>
  24863. <p>
  24864. (<em>Appears on:</em>
  24865. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  24866. </p>
  24867. <p>
  24868. <p>WebhookCAProvider defines a location to fetch the certificate for the webhook provider.</p>
  24869. </p>
  24870. <table>
  24871. <thead>
  24872. <tr>
  24873. <th>Field</th>
  24874. <th>Description</th>
  24875. </tr>
  24876. </thead>
  24877. <tbody>
  24878. <tr>
  24879. <td>
  24880. <code>type</code></br>
  24881. <em>
  24882. <a href="#external-secrets.io/v1beta1.WebhookCAProviderType">
  24883. WebhookCAProviderType
  24884. </a>
  24885. </em>
  24886. </td>
  24887. <td>
  24888. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  24889. </td>
  24890. </tr>
  24891. <tr>
  24892. <td>
  24893. <code>name</code></br>
  24894. <em>
  24895. string
  24896. </em>
  24897. </td>
  24898. <td>
  24899. <p>The name of the object located at the provider type.</p>
  24900. </td>
  24901. </tr>
  24902. <tr>
  24903. <td>
  24904. <code>key</code></br>
  24905. <em>
  24906. string
  24907. </em>
  24908. </td>
  24909. <td>
  24910. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  24911. </td>
  24912. </tr>
  24913. <tr>
  24914. <td>
  24915. <code>namespace</code></br>
  24916. <em>
  24917. string
  24918. </em>
  24919. </td>
  24920. <td>
  24921. <em>(Optional)</em>
  24922. <p>The namespace the Provider type is in.</p>
  24923. </td>
  24924. </tr>
  24925. </tbody>
  24926. </table>
  24927. <h3 id="external-secrets.io/v1beta1.WebhookCAProviderType">WebhookCAProviderType
  24928. (<code>string</code> alias)</p></h3>
  24929. <p>
  24930. (<em>Appears on:</em>
  24931. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">WebhookCAProvider</a>)
  24932. </p>
  24933. <p>
  24934. <p>WebhookCAProviderType defines the type of provider to use for CA certificates with Webhook providers.</p>
  24935. </p>
  24936. <table>
  24937. <thead>
  24938. <tr>
  24939. <th>Value</th>
  24940. <th>Description</th>
  24941. </tr>
  24942. </thead>
  24943. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  24944. <td><p>WebhookCAProviderTypeConfigMap indicates that the CA certificate is stored in a ConfigMap.</p>
  24945. </td>
  24946. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  24947. <td><p>WebhookCAProviderTypeSecret indicates that the CA certificate is stored in a Secret.</p>
  24948. </td>
  24949. </tr></tbody>
  24950. </table>
  24951. <h3 id="external-secrets.io/v1beta1.WebhookProvider">WebhookProvider
  24952. </h3>
  24953. <p>
  24954. (<em>Appears on:</em>
  24955. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  24956. </p>
  24957. <p>
  24958. <p>WebhookProvider configures a store to sync secrets from simple web APIs.</p>
  24959. </p>
  24960. <table>
  24961. <thead>
  24962. <tr>
  24963. <th>Field</th>
  24964. <th>Description</th>
  24965. </tr>
  24966. </thead>
  24967. <tbody>
  24968. <tr>
  24969. <td>
  24970. <code>method</code></br>
  24971. <em>
  24972. string
  24973. </em>
  24974. </td>
  24975. <td>
  24976. <p>Webhook Method</p>
  24977. </td>
  24978. </tr>
  24979. <tr>
  24980. <td>
  24981. <code>url</code></br>
  24982. <em>
  24983. string
  24984. </em>
  24985. </td>
  24986. <td>
  24987. <p>Webhook url to call</p>
  24988. </td>
  24989. </tr>
  24990. <tr>
  24991. <td>
  24992. <code>headers</code></br>
  24993. <em>
  24994. map[string]string
  24995. </em>
  24996. </td>
  24997. <td>
  24998. <em>(Optional)</em>
  24999. <p>Headers</p>
  25000. </td>
  25001. </tr>
  25002. <tr>
  25003. <td>
  25004. <code>auth</code></br>
  25005. <em>
  25006. <a href="#external-secrets.io/v1beta1.AuthorizationProtocol">
  25007. AuthorizationProtocol
  25008. </a>
  25009. </em>
  25010. </td>
  25011. <td>
  25012. <em>(Optional)</em>
  25013. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  25014. </td>
  25015. </tr>
  25016. <tr>
  25017. <td>
  25018. <code>body</code></br>
  25019. <em>
  25020. string
  25021. </em>
  25022. </td>
  25023. <td>
  25024. <em>(Optional)</em>
  25025. <p>Body</p>
  25026. </td>
  25027. </tr>
  25028. <tr>
  25029. <td>
  25030. <code>timeout</code></br>
  25031. <em>
  25032. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  25033. Kubernetes meta/v1.Duration
  25034. </a>
  25035. </em>
  25036. </td>
  25037. <td>
  25038. <em>(Optional)</em>
  25039. <p>Timeout</p>
  25040. </td>
  25041. </tr>
  25042. <tr>
  25043. <td>
  25044. <code>result</code></br>
  25045. <em>
  25046. <a href="#external-secrets.io/v1beta1.WebhookResult">
  25047. WebhookResult
  25048. </a>
  25049. </em>
  25050. </td>
  25051. <td>
  25052. <p>Result formatting</p>
  25053. </td>
  25054. </tr>
  25055. <tr>
  25056. <td>
  25057. <code>secrets</code></br>
  25058. <em>
  25059. <a href="#external-secrets.io/v1beta1.WebhookSecret">
  25060. []WebhookSecret
  25061. </a>
  25062. </em>
  25063. </td>
  25064. <td>
  25065. <em>(Optional)</em>
  25066. <p>Secrets to fill in templates
  25067. These secrets will be passed to the templating function as key value pairs under the given name</p>
  25068. </td>
  25069. </tr>
  25070. <tr>
  25071. <td>
  25072. <code>caBundle</code></br>
  25073. <em>
  25074. []byte
  25075. </em>
  25076. </td>
  25077. <td>
  25078. <em>(Optional)</em>
  25079. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  25080. if the Server URL is using HTTPS protocol. This parameter is ignored for
  25081. plain HTTP protocol connection. If not set the system root certificates
  25082. are used to validate the TLS connection.</p>
  25083. </td>
  25084. </tr>
  25085. <tr>
  25086. <td>
  25087. <code>caProvider</code></br>
  25088. <em>
  25089. <a href="#external-secrets.io/v1beta1.WebhookCAProvider">
  25090. WebhookCAProvider
  25091. </a>
  25092. </em>
  25093. </td>
  25094. <td>
  25095. <em>(Optional)</em>
  25096. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  25097. </td>
  25098. </tr>
  25099. </tbody>
  25100. </table>
  25101. <h3 id="external-secrets.io/v1beta1.WebhookResult">WebhookResult
  25102. </h3>
  25103. <p>
  25104. (<em>Appears on:</em>
  25105. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  25106. </p>
  25107. <p>
  25108. <p>WebhookResult defines how to extract and format the result from the webhook response.</p>
  25109. </p>
  25110. <table>
  25111. <thead>
  25112. <tr>
  25113. <th>Field</th>
  25114. <th>Description</th>
  25115. </tr>
  25116. </thead>
  25117. <tbody>
  25118. <tr>
  25119. <td>
  25120. <code>jsonPath</code></br>
  25121. <em>
  25122. string
  25123. </em>
  25124. </td>
  25125. <td>
  25126. <em>(Optional)</em>
  25127. <p>Json path of return value</p>
  25128. </td>
  25129. </tr>
  25130. </tbody>
  25131. </table>
  25132. <h3 id="external-secrets.io/v1beta1.WebhookSecret">WebhookSecret
  25133. </h3>
  25134. <p>
  25135. (<em>Appears on:</em>
  25136. <a href="#external-secrets.io/v1beta1.WebhookProvider">WebhookProvider</a>)
  25137. </p>
  25138. <p>
  25139. <p>WebhookSecret defines a secret to be used in webhook templates.</p>
  25140. </p>
  25141. <table>
  25142. <thead>
  25143. <tr>
  25144. <th>Field</th>
  25145. <th>Description</th>
  25146. </tr>
  25147. </thead>
  25148. <tbody>
  25149. <tr>
  25150. <td>
  25151. <code>name</code></br>
  25152. <em>
  25153. string
  25154. </em>
  25155. </td>
  25156. <td>
  25157. <p>Name of this secret in templates</p>
  25158. </td>
  25159. </tr>
  25160. <tr>
  25161. <td>
  25162. <code>secretRef</code></br>
  25163. <em>
  25164. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25165. External Secrets meta/v1.SecretKeySelector
  25166. </a>
  25167. </em>
  25168. </td>
  25169. <td>
  25170. <p>Secret ref to fill in credentials</p>
  25171. </td>
  25172. </tr>
  25173. </tbody>
  25174. </table>
  25175. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerAuth">YandexCertificateManagerAuth
  25176. </h3>
  25177. <p>
  25178. (<em>Appears on:</em>
  25179. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  25180. </p>
  25181. <p>
  25182. <p>YandexCertificateManagerAuth defines authentication configuration for the Yandex Certificate Manager provider.</p>
  25183. </p>
  25184. <table>
  25185. <thead>
  25186. <tr>
  25187. <th>Field</th>
  25188. <th>Description</th>
  25189. </tr>
  25190. </thead>
  25191. <tbody>
  25192. <tr>
  25193. <td>
  25194. <code>authorizedKeySecretRef</code></br>
  25195. <em>
  25196. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25197. External Secrets meta/v1.SecretKeySelector
  25198. </a>
  25199. </em>
  25200. </td>
  25201. <td>
  25202. <em>(Optional)</em>
  25203. <p>The authorized key used for authentication</p>
  25204. </td>
  25205. </tr>
  25206. </tbody>
  25207. </table>
  25208. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">YandexCertificateManagerCAProvider
  25209. </h3>
  25210. <p>
  25211. (<em>Appears on:</em>
  25212. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider</a>)
  25213. </p>
  25214. <p>
  25215. <p>YandexCertificateManagerCAProvider defines CA certificate configuration for Yandex Certificate Manager.</p>
  25216. </p>
  25217. <table>
  25218. <thead>
  25219. <tr>
  25220. <th>Field</th>
  25221. <th>Description</th>
  25222. </tr>
  25223. </thead>
  25224. <tbody>
  25225. <tr>
  25226. <td>
  25227. <code>certSecretRef</code></br>
  25228. <em>
  25229. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25230. External Secrets meta/v1.SecretKeySelector
  25231. </a>
  25232. </em>
  25233. </td>
  25234. <td>
  25235. </td>
  25236. </tr>
  25237. </tbody>
  25238. </table>
  25239. <h3 id="external-secrets.io/v1beta1.YandexCertificateManagerProvider">YandexCertificateManagerProvider
  25240. </h3>
  25241. <p>
  25242. (<em>Appears on:</em>
  25243. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  25244. </p>
  25245. <p>
  25246. <p>YandexCertificateManagerProvider configures a store to sync secrets using the Yandex Certificate Manager provider.</p>
  25247. </p>
  25248. <table>
  25249. <thead>
  25250. <tr>
  25251. <th>Field</th>
  25252. <th>Description</th>
  25253. </tr>
  25254. </thead>
  25255. <tbody>
  25256. <tr>
  25257. <td>
  25258. <code>apiEndpoint</code></br>
  25259. <em>
  25260. string
  25261. </em>
  25262. </td>
  25263. <td>
  25264. <em>(Optional)</em>
  25265. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  25266. </td>
  25267. </tr>
  25268. <tr>
  25269. <td>
  25270. <code>auth</code></br>
  25271. <em>
  25272. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerAuth">
  25273. YandexCertificateManagerAuth
  25274. </a>
  25275. </em>
  25276. </td>
  25277. <td>
  25278. <p>Auth defines the information necessary to authenticate against Yandex Certificate Manager</p>
  25279. </td>
  25280. </tr>
  25281. <tr>
  25282. <td>
  25283. <code>caProvider</code></br>
  25284. <em>
  25285. <a href="#external-secrets.io/v1beta1.YandexCertificateManagerCAProvider">
  25286. YandexCertificateManagerCAProvider
  25287. </a>
  25288. </em>
  25289. </td>
  25290. <td>
  25291. <em>(Optional)</em>
  25292. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  25293. </td>
  25294. </tr>
  25295. </tbody>
  25296. </table>
  25297. <h3 id="external-secrets.io/v1beta1.YandexLockboxAuth">YandexLockboxAuth
  25298. </h3>
  25299. <p>
  25300. (<em>Appears on:</em>
  25301. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  25302. </p>
  25303. <p>
  25304. <p>YandexLockboxAuth defines authentication configuration for the Yandex Lockbox provider.</p>
  25305. </p>
  25306. <table>
  25307. <thead>
  25308. <tr>
  25309. <th>Field</th>
  25310. <th>Description</th>
  25311. </tr>
  25312. </thead>
  25313. <tbody>
  25314. <tr>
  25315. <td>
  25316. <code>authorizedKeySecretRef</code></br>
  25317. <em>
  25318. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25319. External Secrets meta/v1.SecretKeySelector
  25320. </a>
  25321. </em>
  25322. </td>
  25323. <td>
  25324. <em>(Optional)</em>
  25325. <p>The authorized key used for authentication</p>
  25326. </td>
  25327. </tr>
  25328. </tbody>
  25329. </table>
  25330. <h3 id="external-secrets.io/v1beta1.YandexLockboxCAProvider">YandexLockboxCAProvider
  25331. </h3>
  25332. <p>
  25333. (<em>Appears on:</em>
  25334. <a href="#external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider</a>)
  25335. </p>
  25336. <p>
  25337. <p>YandexLockboxCAProvider defines CA certificate configuration for Yandex Lockbox.</p>
  25338. </p>
  25339. <table>
  25340. <thead>
  25341. <tr>
  25342. <th>Field</th>
  25343. <th>Description</th>
  25344. </tr>
  25345. </thead>
  25346. <tbody>
  25347. <tr>
  25348. <td>
  25349. <code>certSecretRef</code></br>
  25350. <em>
  25351. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25352. External Secrets meta/v1.SecretKeySelector
  25353. </a>
  25354. </em>
  25355. </td>
  25356. <td>
  25357. </td>
  25358. </tr>
  25359. </tbody>
  25360. </table>
  25361. <h3 id="external-secrets.io/v1beta1.YandexLockboxProvider">YandexLockboxProvider
  25362. </h3>
  25363. <p>
  25364. (<em>Appears on:</em>
  25365. <a href="#external-secrets.io/v1beta1.SecretStoreProvider">SecretStoreProvider</a>)
  25366. </p>
  25367. <p>
  25368. <p>YandexLockboxProvider configures a store to sync secrets using the Yandex Lockbox provider.</p>
  25369. </p>
  25370. <table>
  25371. <thead>
  25372. <tr>
  25373. <th>Field</th>
  25374. <th>Description</th>
  25375. </tr>
  25376. </thead>
  25377. <tbody>
  25378. <tr>
  25379. <td>
  25380. <code>apiEndpoint</code></br>
  25381. <em>
  25382. string
  25383. </em>
  25384. </td>
  25385. <td>
  25386. <em>(Optional)</em>
  25387. <p>Yandex.Cloud API endpoint (e.g. &lsquo;api.cloud.yandex.net:443&rsquo;)</p>
  25388. </td>
  25389. </tr>
  25390. <tr>
  25391. <td>
  25392. <code>auth</code></br>
  25393. <em>
  25394. <a href="#external-secrets.io/v1beta1.YandexLockboxAuth">
  25395. YandexLockboxAuth
  25396. </a>
  25397. </em>
  25398. </td>
  25399. <td>
  25400. <p>Auth defines the information necessary to authenticate against Yandex Lockbox</p>
  25401. </td>
  25402. </tr>
  25403. <tr>
  25404. <td>
  25405. <code>caProvider</code></br>
  25406. <em>
  25407. <a href="#external-secrets.io/v1beta1.YandexLockboxCAProvider">
  25408. YandexLockboxCAProvider
  25409. </a>
  25410. </em>
  25411. </td>
  25412. <td>
  25413. <em>(Optional)</em>
  25414. <p>The provider for the CA bundle to use to validate Yandex.Cloud server certificate.</p>
  25415. </td>
  25416. </tr>
  25417. </tbody>
  25418. </table>
  25419. <hr/>
  25420. <h2 id="generators.external-secrets.io/v1alpha1">generators.external-secrets.io/v1alpha1</h2>
  25421. <p>
  25422. <p>Package v1alpha1 contains resources for generators</p>
  25423. </p>
  25424. <p>Resource Types:</p>
  25425. <ul></ul>
  25426. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken
  25427. </h3>
  25428. <p>
  25429. <p>ACRAccessToken returns an Azure Container Registry token
  25430. that can be used for pushing/pulling images.
  25431. Note: by default it will return an ACR Refresh Token with full access
  25432. (depending on the identity).
  25433. This can be scoped down to the repository level using .spec.scope.
  25434. In case scope is defined it will return an ACR Access Token.</p>
  25435. <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>
  25436. </p>
  25437. <table>
  25438. <thead>
  25439. <tr>
  25440. <th>Field</th>
  25441. <th>Description</th>
  25442. </tr>
  25443. </thead>
  25444. <tbody>
  25445. <tr>
  25446. <td>
  25447. <code>metadata</code></br>
  25448. <em>
  25449. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  25450. Kubernetes meta/v1.ObjectMeta
  25451. </a>
  25452. </em>
  25453. </td>
  25454. <td>
  25455. Refer to the Kubernetes API documentation for the fields of the
  25456. <code>metadata</code> field.
  25457. </td>
  25458. </tr>
  25459. <tr>
  25460. <td>
  25461. <code>spec</code></br>
  25462. <em>
  25463. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  25464. ACRAccessTokenSpec
  25465. </a>
  25466. </em>
  25467. </td>
  25468. <td>
  25469. <br/>
  25470. <br/>
  25471. <table>
  25472. <tr>
  25473. <td>
  25474. <code>auth</code></br>
  25475. <em>
  25476. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  25477. ACRAuth
  25478. </a>
  25479. </em>
  25480. </td>
  25481. <td>
  25482. </td>
  25483. </tr>
  25484. <tr>
  25485. <td>
  25486. <code>tenantId</code></br>
  25487. <em>
  25488. string
  25489. </em>
  25490. </td>
  25491. <td>
  25492. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  25493. </td>
  25494. </tr>
  25495. <tr>
  25496. <td>
  25497. <code>registry</code></br>
  25498. <em>
  25499. string
  25500. </em>
  25501. </td>
  25502. <td>
  25503. <p>the domain name of the ACR registry
  25504. e.g. foobarexample.azurecr.io</p>
  25505. </td>
  25506. </tr>
  25507. <tr>
  25508. <td>
  25509. <code>scope</code></br>
  25510. <em>
  25511. string
  25512. </em>
  25513. </td>
  25514. <td>
  25515. <em>(Optional)</em>
  25516. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  25517. if not provided it will return a refresh token that has full scope.
  25518. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  25519. <p>examples:
  25520. repository:my-repository:pull,push
  25521. repository:my-repository:pull</p>
  25522. <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>
  25523. </td>
  25524. </tr>
  25525. <tr>
  25526. <td>
  25527. <code>environmentType</code></br>
  25528. <em>
  25529. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  25530. AzureEnvironmentType
  25531. </a>
  25532. </em>
  25533. </td>
  25534. <td>
  25535. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  25536. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  25537. 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>
  25538. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  25539. </td>
  25540. </tr>
  25541. </table>
  25542. </td>
  25543. </tr>
  25544. </tbody>
  25545. </table>
  25546. <h3 id="generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec
  25547. </h3>
  25548. <p>
  25549. (<em>Appears on:</em>
  25550. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessToken">ACRAccessToken</a>,
  25551. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  25552. </p>
  25553. <p>
  25554. <p>ACRAccessTokenSpec defines how to generate the access token
  25555. e.g. how to authenticate and which registry to use.
  25556. 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>
  25557. </p>
  25558. <table>
  25559. <thead>
  25560. <tr>
  25561. <th>Field</th>
  25562. <th>Description</th>
  25563. </tr>
  25564. </thead>
  25565. <tbody>
  25566. <tr>
  25567. <td>
  25568. <code>auth</code></br>
  25569. <em>
  25570. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">
  25571. ACRAuth
  25572. </a>
  25573. </em>
  25574. </td>
  25575. <td>
  25576. </td>
  25577. </tr>
  25578. <tr>
  25579. <td>
  25580. <code>tenantId</code></br>
  25581. <em>
  25582. string
  25583. </em>
  25584. </td>
  25585. <td>
  25586. <p>TenantID configures the Azure Tenant to send requests to. Required for ServicePrincipal auth type.</p>
  25587. </td>
  25588. </tr>
  25589. <tr>
  25590. <td>
  25591. <code>registry</code></br>
  25592. <em>
  25593. string
  25594. </em>
  25595. </td>
  25596. <td>
  25597. <p>the domain name of the ACR registry
  25598. e.g. foobarexample.azurecr.io</p>
  25599. </td>
  25600. </tr>
  25601. <tr>
  25602. <td>
  25603. <code>scope</code></br>
  25604. <em>
  25605. string
  25606. </em>
  25607. </td>
  25608. <td>
  25609. <em>(Optional)</em>
  25610. <p>Define the scope for the access token, e.g. pull/push access for a repository.
  25611. if not provided it will return a refresh token that has full scope.
  25612. Note: you need to pin it down to the repository level, there is no wildcard available.</p>
  25613. <p>examples:
  25614. repository:my-repository:pull,push
  25615. repository:my-repository:pull</p>
  25616. <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>
  25617. </td>
  25618. </tr>
  25619. <tr>
  25620. <td>
  25621. <code>environmentType</code></br>
  25622. <em>
  25623. <a href="#external-secrets.io/v1.AzureEnvironmentType">
  25624. AzureEnvironmentType
  25625. </a>
  25626. </em>
  25627. </td>
  25628. <td>
  25629. <p>EnvironmentType specifies the Azure cloud environment endpoints to use for
  25630. connecting and authenticating with Azure. By default, it points to the public cloud AAD endpoint.
  25631. 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>
  25632. PublicCloud, USGovernmentCloud, ChinaCloud, GermanCloud</p>
  25633. </td>
  25634. </tr>
  25635. </tbody>
  25636. </table>
  25637. <h3 id="generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth
  25638. </h3>
  25639. <p>
  25640. (<em>Appears on:</em>
  25641. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">ACRAccessTokenSpec</a>)
  25642. </p>
  25643. <p>
  25644. <p>ACRAuth defines the authentication methods for Azure Container Registry.</p>
  25645. </p>
  25646. <table>
  25647. <thead>
  25648. <tr>
  25649. <th>Field</th>
  25650. <th>Description</th>
  25651. </tr>
  25652. </thead>
  25653. <tbody>
  25654. <tr>
  25655. <td>
  25656. <code>servicePrincipal</code></br>
  25657. <em>
  25658. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">
  25659. AzureACRServicePrincipalAuth
  25660. </a>
  25661. </em>
  25662. </td>
  25663. <td>
  25664. <em>(Optional)</em>
  25665. <p>ServicePrincipal uses Azure Service Principal credentials to authenticate with Azure.</p>
  25666. </td>
  25667. </tr>
  25668. <tr>
  25669. <td>
  25670. <code>managedIdentity</code></br>
  25671. <em>
  25672. <a href="#generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">
  25673. AzureACRManagedIdentityAuth
  25674. </a>
  25675. </em>
  25676. </td>
  25677. <td>
  25678. <em>(Optional)</em>
  25679. <p>ManagedIdentity uses Azure Managed Identity to authenticate with Azure.</p>
  25680. </td>
  25681. </tr>
  25682. <tr>
  25683. <td>
  25684. <code>workloadIdentity</code></br>
  25685. <em>
  25686. <a href="#generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">
  25687. AzureACRWorkloadIdentityAuth
  25688. </a>
  25689. </em>
  25690. </td>
  25691. <td>
  25692. <em>(Optional)</em>
  25693. <p>WorkloadIdentity uses Azure Workload Identity to authenticate with Azure.</p>
  25694. </td>
  25695. </tr>
  25696. </tbody>
  25697. </table>
  25698. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth
  25699. </h3>
  25700. <p>
  25701. (<em>Appears on:</em>
  25702. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec</a>,
  25703. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  25704. </p>
  25705. <p>
  25706. <p>AWSAuth tells the controller how to do authentication with aws.
  25707. Only one of secretRef or jwt can be specified.
  25708. if none is specified the controller will load credentials using the aws sdk defaults.</p>
  25709. </p>
  25710. <table>
  25711. <thead>
  25712. <tr>
  25713. <th>Field</th>
  25714. <th>Description</th>
  25715. </tr>
  25716. </thead>
  25717. <tbody>
  25718. <tr>
  25719. <td>
  25720. <code>secretRef</code></br>
  25721. <em>
  25722. <a href="#generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">
  25723. AWSAuthSecretRef
  25724. </a>
  25725. </em>
  25726. </td>
  25727. <td>
  25728. <em>(Optional)</em>
  25729. </td>
  25730. </tr>
  25731. <tr>
  25732. <td>
  25733. <code>jwt</code></br>
  25734. <em>
  25735. <a href="#generators.external-secrets.io/v1alpha1.AWSJWTAuth">
  25736. AWSJWTAuth
  25737. </a>
  25738. </em>
  25739. </td>
  25740. <td>
  25741. <em>(Optional)</em>
  25742. </td>
  25743. </tr>
  25744. </tbody>
  25745. </table>
  25746. <h3 id="generators.external-secrets.io/v1alpha1.AWSAuthSecretRef">AWSAuthSecretRef
  25747. </h3>
  25748. <p>
  25749. (<em>Appears on:</em>
  25750. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  25751. </p>
  25752. <p>
  25753. <p>AWSAuthSecretRef holds secret references for AWS credentials
  25754. both AccessKeyID and SecretAccessKey must be defined in order to properly authenticate.</p>
  25755. </p>
  25756. <table>
  25757. <thead>
  25758. <tr>
  25759. <th>Field</th>
  25760. <th>Description</th>
  25761. </tr>
  25762. </thead>
  25763. <tbody>
  25764. <tr>
  25765. <td>
  25766. <code>accessKeyIDSecretRef</code></br>
  25767. <em>
  25768. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25769. External Secrets meta/v1.SecretKeySelector
  25770. </a>
  25771. </em>
  25772. </td>
  25773. <td>
  25774. <p>The AccessKeyID is used for authentication</p>
  25775. </td>
  25776. </tr>
  25777. <tr>
  25778. <td>
  25779. <code>secretAccessKeySecretRef</code></br>
  25780. <em>
  25781. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25782. External Secrets meta/v1.SecretKeySelector
  25783. </a>
  25784. </em>
  25785. </td>
  25786. <td>
  25787. <p>The SecretAccessKey is used for authentication</p>
  25788. </td>
  25789. </tr>
  25790. <tr>
  25791. <td>
  25792. <code>sessionTokenSecretRef</code></br>
  25793. <em>
  25794. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25795. External Secrets meta/v1.SecretKeySelector
  25796. </a>
  25797. </em>
  25798. </td>
  25799. <td>
  25800. <p>The SessionToken used for authentication
  25801. This must be defined if AccessKeyID and SecretAccessKey are temporary credentials
  25802. 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>
  25803. </td>
  25804. </tr>
  25805. </tbody>
  25806. </table>
  25807. <h3 id="generators.external-secrets.io/v1alpha1.AWSJWTAuth">AWSJWTAuth
  25808. </h3>
  25809. <p>
  25810. (<em>Appears on:</em>
  25811. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">AWSAuth</a>)
  25812. </p>
  25813. <p>
  25814. <p>AWSJWTAuth provides configuration to authenticate against AWS using service account tokens.</p>
  25815. </p>
  25816. <table>
  25817. <thead>
  25818. <tr>
  25819. <th>Field</th>
  25820. <th>Description</th>
  25821. </tr>
  25822. </thead>
  25823. <tbody>
  25824. <tr>
  25825. <td>
  25826. <code>serviceAccountRef</code></br>
  25827. <em>
  25828. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  25829. External Secrets meta/v1.ServiceAccountSelector
  25830. </a>
  25831. </em>
  25832. </td>
  25833. <td>
  25834. </td>
  25835. </tr>
  25836. </tbody>
  25837. </table>
  25838. <h3 id="generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol
  25839. </h3>
  25840. <p>
  25841. (<em>Appears on:</em>
  25842. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  25843. </p>
  25844. <p>
  25845. <p>AuthorizationProtocol contains the protocol-specific configuration</p>
  25846. </p>
  25847. <table>
  25848. <thead>
  25849. <tr>
  25850. <th>Field</th>
  25851. <th>Description</th>
  25852. </tr>
  25853. </thead>
  25854. <tbody>
  25855. <tr>
  25856. <td>
  25857. <code>ntlm</code></br>
  25858. <em>
  25859. <a href="#generators.external-secrets.io/v1alpha1.NTLMProtocol">
  25860. NTLMProtocol
  25861. </a>
  25862. </em>
  25863. </td>
  25864. <td>
  25865. <em>(Optional)</em>
  25866. <p>NTLMProtocol configures the store to use NTLM for auth</p>
  25867. </td>
  25868. </tr>
  25869. </tbody>
  25870. </table>
  25871. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRManagedIdentityAuth">AzureACRManagedIdentityAuth
  25872. </h3>
  25873. <p>
  25874. (<em>Appears on:</em>
  25875. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  25876. </p>
  25877. <p>
  25878. <p>AzureACRManagedIdentityAuth defines the configuration for using Azure Managed Identity authentication.</p>
  25879. </p>
  25880. <table>
  25881. <thead>
  25882. <tr>
  25883. <th>Field</th>
  25884. <th>Description</th>
  25885. </tr>
  25886. </thead>
  25887. <tbody>
  25888. <tr>
  25889. <td>
  25890. <code>identityId</code></br>
  25891. <em>
  25892. string
  25893. </em>
  25894. </td>
  25895. <td>
  25896. <p>If multiple Managed Identity is assigned to the pod, you can select the one to be used</p>
  25897. </td>
  25898. </tr>
  25899. </tbody>
  25900. </table>
  25901. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth
  25902. </h3>
  25903. <p>
  25904. (<em>Appears on:</em>
  25905. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  25906. </p>
  25907. <p>
  25908. <p>AzureACRServicePrincipalAuth defines the configuration for using Azure Service Principal authentication.</p>
  25909. </p>
  25910. <table>
  25911. <thead>
  25912. <tr>
  25913. <th>Field</th>
  25914. <th>Description</th>
  25915. </tr>
  25916. </thead>
  25917. <tbody>
  25918. <tr>
  25919. <td>
  25920. <code>secretRef</code></br>
  25921. <em>
  25922. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">
  25923. AzureACRServicePrincipalAuthSecretRef
  25924. </a>
  25925. </em>
  25926. </td>
  25927. <td>
  25928. </td>
  25929. </tr>
  25930. </tbody>
  25931. </table>
  25932. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuthSecretRef">AzureACRServicePrincipalAuthSecretRef
  25933. </h3>
  25934. <p>
  25935. (<em>Appears on:</em>
  25936. <a href="#generators.external-secrets.io/v1alpha1.AzureACRServicePrincipalAuth">AzureACRServicePrincipalAuth</a>)
  25937. </p>
  25938. <p>
  25939. <p>AzureACRServicePrincipalAuthSecretRef defines the secret references for Azure Service Principal authentication.
  25940. It uses static credentials stored in a Kind=Secret.</p>
  25941. </p>
  25942. <table>
  25943. <thead>
  25944. <tr>
  25945. <th>Field</th>
  25946. <th>Description</th>
  25947. </tr>
  25948. </thead>
  25949. <tbody>
  25950. <tr>
  25951. <td>
  25952. <code>clientId</code></br>
  25953. <em>
  25954. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  25955. External Secrets meta/v1.SecretKeySelector
  25956. </a>
  25957. </em>
  25958. </td>
  25959. <td>
  25960. <p>The Azure clientId of the service principle used for authentication.</p>
  25961. </td>
  25962. </tr>
  25963. <tr>
  25964. <td>
  25965. <code>clientSecret</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. <p>The Azure ClientSecret of the service principle used for authentication.</p>
  25974. </td>
  25975. </tr>
  25976. </tbody>
  25977. </table>
  25978. <h3 id="generators.external-secrets.io/v1alpha1.AzureACRWorkloadIdentityAuth">AzureACRWorkloadIdentityAuth
  25979. </h3>
  25980. <p>
  25981. (<em>Appears on:</em>
  25982. <a href="#generators.external-secrets.io/v1alpha1.ACRAuth">ACRAuth</a>)
  25983. </p>
  25984. <p>
  25985. <p>AzureACRWorkloadIdentityAuth defines the configuration for using Azure Workload Identity authentication.</p>
  25986. </p>
  25987. <table>
  25988. <thead>
  25989. <tr>
  25990. <th>Field</th>
  25991. <th>Description</th>
  25992. </tr>
  25993. </thead>
  25994. <tbody>
  25995. <tr>
  25996. <td>
  25997. <code>serviceAccountRef</code></br>
  25998. <em>
  25999. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26000. External Secrets meta/v1.ServiceAccountSelector
  26001. </a>
  26002. </em>
  26003. </td>
  26004. <td>
  26005. <em>(Optional)</em>
  26006. <p>ServiceAccountRef specified the service account
  26007. that should be used when authenticating with WorkloadIdentity.</p>
  26008. </td>
  26009. </tr>
  26010. </tbody>
  26011. </table>
  26012. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken
  26013. </h3>
  26014. <p>
  26015. <p>CloudsmithAccessToken generates Cloudsmith access token using OIDC authentication</p>
  26016. </p>
  26017. <table>
  26018. <thead>
  26019. <tr>
  26020. <th>Field</th>
  26021. <th>Description</th>
  26022. </tr>
  26023. </thead>
  26024. <tbody>
  26025. <tr>
  26026. <td>
  26027. <code>metadata</code></br>
  26028. <em>
  26029. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  26030. Kubernetes meta/v1.ObjectMeta
  26031. </a>
  26032. </em>
  26033. </td>
  26034. <td>
  26035. Refer to the Kubernetes API documentation for the fields of the
  26036. <code>metadata</code> field.
  26037. </td>
  26038. </tr>
  26039. <tr>
  26040. <td>
  26041. <code>spec</code></br>
  26042. <em>
  26043. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  26044. CloudsmithAccessTokenSpec
  26045. </a>
  26046. </em>
  26047. </td>
  26048. <td>
  26049. <br/>
  26050. <br/>
  26051. <table>
  26052. <tr>
  26053. <td>
  26054. <code>apiUrl</code></br>
  26055. <em>
  26056. string
  26057. </em>
  26058. </td>
  26059. <td>
  26060. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  26061. </td>
  26062. </tr>
  26063. <tr>
  26064. <td>
  26065. <code>orgSlug</code></br>
  26066. <em>
  26067. string
  26068. </em>
  26069. </td>
  26070. <td>
  26071. <p>OrgSlug is the organization slug in Cloudsmith</p>
  26072. </td>
  26073. </tr>
  26074. <tr>
  26075. <td>
  26076. <code>serviceSlug</code></br>
  26077. <em>
  26078. string
  26079. </em>
  26080. </td>
  26081. <td>
  26082. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  26083. </td>
  26084. </tr>
  26085. <tr>
  26086. <td>
  26087. <code>serviceAccountRef</code></br>
  26088. <em>
  26089. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26090. External Secrets meta/v1.ServiceAccountSelector
  26091. </a>
  26092. </em>
  26093. </td>
  26094. <td>
  26095. <p>Name of the service account you are federating with</p>
  26096. </td>
  26097. </tr>
  26098. </table>
  26099. </td>
  26100. </tr>
  26101. </tbody>
  26102. </table>
  26103. <h3 id="generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">CloudsmithAccessTokenSpec
  26104. </h3>
  26105. <p>
  26106. (<em>Appears on:</em>
  26107. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessToken">CloudsmithAccessToken</a>,
  26108. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  26109. </p>
  26110. <p>
  26111. <p>CloudsmithAccessTokenSpec defines the configuration for generating a Cloudsmith access token using OIDC authentication.</p>
  26112. </p>
  26113. <table>
  26114. <thead>
  26115. <tr>
  26116. <th>Field</th>
  26117. <th>Description</th>
  26118. </tr>
  26119. </thead>
  26120. <tbody>
  26121. <tr>
  26122. <td>
  26123. <code>apiUrl</code></br>
  26124. <em>
  26125. string
  26126. </em>
  26127. </td>
  26128. <td>
  26129. <p>APIURL configures the Cloudsmith API URL. Defaults to <a href="https://api.cloudsmith.io">https://api.cloudsmith.io</a>.</p>
  26130. </td>
  26131. </tr>
  26132. <tr>
  26133. <td>
  26134. <code>orgSlug</code></br>
  26135. <em>
  26136. string
  26137. </em>
  26138. </td>
  26139. <td>
  26140. <p>OrgSlug is the organization slug in Cloudsmith</p>
  26141. </td>
  26142. </tr>
  26143. <tr>
  26144. <td>
  26145. <code>serviceSlug</code></br>
  26146. <em>
  26147. string
  26148. </em>
  26149. </td>
  26150. <td>
  26151. <p>ServiceSlug is the service slug in Cloudsmith for OIDC authentication</p>
  26152. </td>
  26153. </tr>
  26154. <tr>
  26155. <td>
  26156. <code>serviceAccountRef</code></br>
  26157. <em>
  26158. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26159. External Secrets meta/v1.ServiceAccountSelector
  26160. </a>
  26161. </em>
  26162. </td>
  26163. <td>
  26164. <p>Name of the service account you are federating with</p>
  26165. </td>
  26166. </tr>
  26167. </tbody>
  26168. </table>
  26169. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator
  26170. </h3>
  26171. <p>
  26172. <p>ClusterGenerator represents a cluster-wide generator which can be referenced as part of <code>generatorRef</code> fields.</p>
  26173. </p>
  26174. <table>
  26175. <thead>
  26176. <tr>
  26177. <th>Field</th>
  26178. <th>Description</th>
  26179. </tr>
  26180. </thead>
  26181. <tbody>
  26182. <tr>
  26183. <td>
  26184. <code>metadata</code></br>
  26185. <em>
  26186. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  26187. Kubernetes meta/v1.ObjectMeta
  26188. </a>
  26189. </em>
  26190. </td>
  26191. <td>
  26192. Refer to the Kubernetes API documentation for the fields of the
  26193. <code>metadata</code> field.
  26194. </td>
  26195. </tr>
  26196. <tr>
  26197. <td>
  26198. <code>spec</code></br>
  26199. <em>
  26200. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">
  26201. ClusterGeneratorSpec
  26202. </a>
  26203. </em>
  26204. </td>
  26205. <td>
  26206. <br/>
  26207. <br/>
  26208. <table>
  26209. <tr>
  26210. <td>
  26211. <code>kind</code></br>
  26212. <em>
  26213. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  26214. GeneratorKind
  26215. </a>
  26216. </em>
  26217. </td>
  26218. <td>
  26219. <p>Kind the kind of this generator.</p>
  26220. </td>
  26221. </tr>
  26222. <tr>
  26223. <td>
  26224. <code>generator</code></br>
  26225. <em>
  26226. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  26227. GeneratorSpec
  26228. </a>
  26229. </em>
  26230. </td>
  26231. <td>
  26232. <p>Generator the spec for this generator, must match the kind.</p>
  26233. </td>
  26234. </tr>
  26235. </table>
  26236. </td>
  26237. </tr>
  26238. </tbody>
  26239. </table>
  26240. <h3 id="generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec
  26241. </h3>
  26242. <p>
  26243. (<em>Appears on:</em>
  26244. <a href="#generators.external-secrets.io/v1alpha1.ClusterGenerator">ClusterGenerator</a>)
  26245. </p>
  26246. <p>
  26247. <p>ClusterGeneratorSpec defines the desired state of a ClusterGenerator.</p>
  26248. </p>
  26249. <table>
  26250. <thead>
  26251. <tr>
  26252. <th>Field</th>
  26253. <th>Description</th>
  26254. </tr>
  26255. </thead>
  26256. <tbody>
  26257. <tr>
  26258. <td>
  26259. <code>kind</code></br>
  26260. <em>
  26261. <a href="#generators.external-secrets.io/v1alpha1.GeneratorKind">
  26262. GeneratorKind
  26263. </a>
  26264. </em>
  26265. </td>
  26266. <td>
  26267. <p>Kind the kind of this generator.</p>
  26268. </td>
  26269. </tr>
  26270. <tr>
  26271. <td>
  26272. <code>generator</code></br>
  26273. <em>
  26274. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">
  26275. GeneratorSpec
  26276. </a>
  26277. </em>
  26278. </td>
  26279. <td>
  26280. <p>Generator the spec for this generator, must match the kind.</p>
  26281. </td>
  26282. </tr>
  26283. </tbody>
  26284. </table>
  26285. <h3 id="generators.external-secrets.io/v1alpha1.ControllerClassResource">ControllerClassResource
  26286. </h3>
  26287. <p>
  26288. <p>ControllerClassResource defines a resource that can be assigned to a specific controller class.</p>
  26289. </p>
  26290. <table>
  26291. <thead>
  26292. <tr>
  26293. <th>Field</th>
  26294. <th>Description</th>
  26295. </tr>
  26296. </thead>
  26297. <tbody>
  26298. <tr>
  26299. <td>
  26300. <code>spec</code></br>
  26301. <em>
  26302. struct{ControllerClass string &#34;json:\&#34;controller\&#34;&#34;}
  26303. </em>
  26304. </td>
  26305. <td>
  26306. <br/>
  26307. <br/>
  26308. <table>
  26309. <tr>
  26310. <td>
  26311. <code>controller</code></br>
  26312. <em>
  26313. string
  26314. </em>
  26315. </td>
  26316. <td>
  26317. </td>
  26318. </tr>
  26319. </table>
  26320. </td>
  26321. </tr>
  26322. </tbody>
  26323. </table>
  26324. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken
  26325. </h3>
  26326. <p>
  26327. <p>ECRAuthorizationToken uses the GetAuthorizationToken API to retrieve an authorization token.
  26328. The authorization token is valid for 12 hours.
  26329. The authorizationToken returned is a base64 encoded string that can be decoded
  26330. and used in a docker login command to authenticate to a registry.
  26331. 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>
  26332. </p>
  26333. <table>
  26334. <thead>
  26335. <tr>
  26336. <th>Field</th>
  26337. <th>Description</th>
  26338. </tr>
  26339. </thead>
  26340. <tbody>
  26341. <tr>
  26342. <td>
  26343. <code>metadata</code></br>
  26344. <em>
  26345. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  26346. Kubernetes meta/v1.ObjectMeta
  26347. </a>
  26348. </em>
  26349. </td>
  26350. <td>
  26351. Refer to the Kubernetes API documentation for the fields of the
  26352. <code>metadata</code> field.
  26353. </td>
  26354. </tr>
  26355. <tr>
  26356. <td>
  26357. <code>spec</code></br>
  26358. <em>
  26359. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  26360. ECRAuthorizationTokenSpec
  26361. </a>
  26362. </em>
  26363. </td>
  26364. <td>
  26365. <br/>
  26366. <br/>
  26367. <table>
  26368. <tr>
  26369. <td>
  26370. <code>region</code></br>
  26371. <em>
  26372. string
  26373. </em>
  26374. </td>
  26375. <td>
  26376. <p>Region specifies the region to operate in.</p>
  26377. </td>
  26378. </tr>
  26379. <tr>
  26380. <td>
  26381. <code>auth</code></br>
  26382. <em>
  26383. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  26384. AWSAuth
  26385. </a>
  26386. </em>
  26387. </td>
  26388. <td>
  26389. <em>(Optional)</em>
  26390. <p>Auth defines how to authenticate with AWS</p>
  26391. </td>
  26392. </tr>
  26393. <tr>
  26394. <td>
  26395. <code>role</code></br>
  26396. <em>
  26397. string
  26398. </em>
  26399. </td>
  26400. <td>
  26401. <em>(Optional)</em>
  26402. <p>You can assume a role before making calls to the
  26403. desired AWS service.</p>
  26404. </td>
  26405. </tr>
  26406. <tr>
  26407. <td>
  26408. <code>scope</code></br>
  26409. <em>
  26410. string
  26411. </em>
  26412. </td>
  26413. <td>
  26414. <em>(Optional)</em>
  26415. <p>Scope specifies the ECR service scope.
  26416. Valid options are private and public.</p>
  26417. </td>
  26418. </tr>
  26419. </table>
  26420. </td>
  26421. </tr>
  26422. </tbody>
  26423. </table>
  26424. <h3 id="generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">ECRAuthorizationTokenSpec
  26425. </h3>
  26426. <p>
  26427. (<em>Appears on:</em>
  26428. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationToken">ECRAuthorizationToken</a>,
  26429. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  26430. </p>
  26431. <p>
  26432. <p>ECRAuthorizationTokenSpec defines the desired state to generate an AWS ECR authorization token.</p>
  26433. </p>
  26434. <table>
  26435. <thead>
  26436. <tr>
  26437. <th>Field</th>
  26438. <th>Description</th>
  26439. </tr>
  26440. </thead>
  26441. <tbody>
  26442. <tr>
  26443. <td>
  26444. <code>region</code></br>
  26445. <em>
  26446. string
  26447. </em>
  26448. </td>
  26449. <td>
  26450. <p>Region specifies the region to operate in.</p>
  26451. </td>
  26452. </tr>
  26453. <tr>
  26454. <td>
  26455. <code>auth</code></br>
  26456. <em>
  26457. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  26458. AWSAuth
  26459. </a>
  26460. </em>
  26461. </td>
  26462. <td>
  26463. <em>(Optional)</em>
  26464. <p>Auth defines how to authenticate with AWS</p>
  26465. </td>
  26466. </tr>
  26467. <tr>
  26468. <td>
  26469. <code>role</code></br>
  26470. <em>
  26471. string
  26472. </em>
  26473. </td>
  26474. <td>
  26475. <em>(Optional)</em>
  26476. <p>You can assume a role before making calls to the
  26477. desired AWS service.</p>
  26478. </td>
  26479. </tr>
  26480. <tr>
  26481. <td>
  26482. <code>scope</code></br>
  26483. <em>
  26484. string
  26485. </em>
  26486. </td>
  26487. <td>
  26488. <em>(Optional)</em>
  26489. <p>Scope specifies the ECR service scope.
  26490. Valid options are private and public.</p>
  26491. </td>
  26492. </tr>
  26493. </tbody>
  26494. </table>
  26495. <h3 id="generators.external-secrets.io/v1alpha1.Fake">Fake
  26496. </h3>
  26497. <p>
  26498. <p>Fake generator is used for testing. It lets you define
  26499. a static set of credentials that is always returned.</p>
  26500. </p>
  26501. <table>
  26502. <thead>
  26503. <tr>
  26504. <th>Field</th>
  26505. <th>Description</th>
  26506. </tr>
  26507. </thead>
  26508. <tbody>
  26509. <tr>
  26510. <td>
  26511. <code>metadata</code></br>
  26512. <em>
  26513. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  26514. Kubernetes meta/v1.ObjectMeta
  26515. </a>
  26516. </em>
  26517. </td>
  26518. <td>
  26519. Refer to the Kubernetes API documentation for the fields of the
  26520. <code>metadata</code> field.
  26521. </td>
  26522. </tr>
  26523. <tr>
  26524. <td>
  26525. <code>spec</code></br>
  26526. <em>
  26527. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  26528. FakeSpec
  26529. </a>
  26530. </em>
  26531. </td>
  26532. <td>
  26533. <br/>
  26534. <br/>
  26535. <table>
  26536. <tr>
  26537. <td>
  26538. <code>controller</code></br>
  26539. <em>
  26540. string
  26541. </em>
  26542. </td>
  26543. <td>
  26544. <em>(Optional)</em>
  26545. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  26546. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  26547. </td>
  26548. </tr>
  26549. <tr>
  26550. <td>
  26551. <code>data</code></br>
  26552. <em>
  26553. map[string]string
  26554. </em>
  26555. </td>
  26556. <td>
  26557. <p>Data defines the static data returned
  26558. by this generator.</p>
  26559. </td>
  26560. </tr>
  26561. </table>
  26562. </td>
  26563. </tr>
  26564. </tbody>
  26565. </table>
  26566. <h3 id="generators.external-secrets.io/v1alpha1.FakeSpec">FakeSpec
  26567. </h3>
  26568. <p>
  26569. (<em>Appears on:</em>
  26570. <a href="#generators.external-secrets.io/v1alpha1.Fake">Fake</a>,
  26571. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  26572. </p>
  26573. <p>
  26574. <p>FakeSpec contains the static data.</p>
  26575. </p>
  26576. <table>
  26577. <thead>
  26578. <tr>
  26579. <th>Field</th>
  26580. <th>Description</th>
  26581. </tr>
  26582. </thead>
  26583. <tbody>
  26584. <tr>
  26585. <td>
  26586. <code>controller</code></br>
  26587. <em>
  26588. string
  26589. </em>
  26590. </td>
  26591. <td>
  26592. <em>(Optional)</em>
  26593. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  26594. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  26595. </td>
  26596. </tr>
  26597. <tr>
  26598. <td>
  26599. <code>data</code></br>
  26600. <em>
  26601. map[string]string
  26602. </em>
  26603. </td>
  26604. <td>
  26605. <p>Data defines the static data returned
  26606. by this generator.</p>
  26607. </td>
  26608. </tr>
  26609. </tbody>
  26610. </table>
  26611. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth
  26612. </h3>
  26613. <p>
  26614. (<em>Appears on:</em>
  26615. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec</a>)
  26616. </p>
  26617. <p>
  26618. <p>GCPSMAuth defines the authentication methods for Google Cloud Platform.</p>
  26619. </p>
  26620. <table>
  26621. <thead>
  26622. <tr>
  26623. <th>Field</th>
  26624. <th>Description</th>
  26625. </tr>
  26626. </thead>
  26627. <tbody>
  26628. <tr>
  26629. <td>
  26630. <code>secretRef</code></br>
  26631. <em>
  26632. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">
  26633. GCPSMAuthSecretRef
  26634. </a>
  26635. </em>
  26636. </td>
  26637. <td>
  26638. <em>(Optional)</em>
  26639. </td>
  26640. </tr>
  26641. <tr>
  26642. <td>
  26643. <code>workloadIdentity</code></br>
  26644. <em>
  26645. <a href="#generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">
  26646. GCPWorkloadIdentity
  26647. </a>
  26648. </em>
  26649. </td>
  26650. <td>
  26651. <em>(Optional)</em>
  26652. </td>
  26653. </tr>
  26654. <tr>
  26655. <td>
  26656. <code>workloadIdentityFederation</code></br>
  26657. <em>
  26658. <a href="#external-secrets.io/v1.GCPWorkloadIdentityFederation">
  26659. GCPWorkloadIdentityFederation
  26660. </a>
  26661. </em>
  26662. </td>
  26663. <td>
  26664. <em>(Optional)</em>
  26665. </td>
  26666. </tr>
  26667. </tbody>
  26668. </table>
  26669. <h3 id="generators.external-secrets.io/v1alpha1.GCPSMAuthSecretRef">GCPSMAuthSecretRef
  26670. </h3>
  26671. <p>
  26672. (<em>Appears on:</em>
  26673. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  26674. </p>
  26675. <p>
  26676. <p>GCPSMAuthSecretRef defines the reference to a secret containing Google Cloud Platform credentials.</p>
  26677. </p>
  26678. <table>
  26679. <thead>
  26680. <tr>
  26681. <th>Field</th>
  26682. <th>Description</th>
  26683. </tr>
  26684. </thead>
  26685. <tbody>
  26686. <tr>
  26687. <td>
  26688. <code>secretAccessKeySecretRef</code></br>
  26689. <em>
  26690. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  26691. External Secrets meta/v1.SecretKeySelector
  26692. </a>
  26693. </em>
  26694. </td>
  26695. <td>
  26696. <em>(Optional)</em>
  26697. <p>The SecretAccessKey is used for authentication</p>
  26698. </td>
  26699. </tr>
  26700. </tbody>
  26701. </table>
  26702. <h3 id="generators.external-secrets.io/v1alpha1.GCPWorkloadIdentity">GCPWorkloadIdentity
  26703. </h3>
  26704. <p>
  26705. (<em>Appears on:</em>
  26706. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">GCPSMAuth</a>)
  26707. </p>
  26708. <p>
  26709. <p>GCPWorkloadIdentity defines the configuration for using GCP Workload Identity authentication.</p>
  26710. </p>
  26711. <table>
  26712. <thead>
  26713. <tr>
  26714. <th>Field</th>
  26715. <th>Description</th>
  26716. </tr>
  26717. </thead>
  26718. <tbody>
  26719. <tr>
  26720. <td>
  26721. <code>serviceAccountRef</code></br>
  26722. <em>
  26723. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  26724. External Secrets meta/v1.ServiceAccountSelector
  26725. </a>
  26726. </em>
  26727. </td>
  26728. <td>
  26729. </td>
  26730. </tr>
  26731. <tr>
  26732. <td>
  26733. <code>clusterLocation</code></br>
  26734. <em>
  26735. string
  26736. </em>
  26737. </td>
  26738. <td>
  26739. </td>
  26740. </tr>
  26741. <tr>
  26742. <td>
  26743. <code>clusterName</code></br>
  26744. <em>
  26745. string
  26746. </em>
  26747. </td>
  26748. <td>
  26749. </td>
  26750. </tr>
  26751. <tr>
  26752. <td>
  26753. <code>clusterProjectID</code></br>
  26754. <em>
  26755. string
  26756. </em>
  26757. </td>
  26758. <td>
  26759. </td>
  26760. </tr>
  26761. </tbody>
  26762. </table>
  26763. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken
  26764. </h3>
  26765. <p>
  26766. <p>GCRAccessToken generates an GCP access token
  26767. that can be used to authenticate with GCR.</p>
  26768. </p>
  26769. <table>
  26770. <thead>
  26771. <tr>
  26772. <th>Field</th>
  26773. <th>Description</th>
  26774. </tr>
  26775. </thead>
  26776. <tbody>
  26777. <tr>
  26778. <td>
  26779. <code>metadata</code></br>
  26780. <em>
  26781. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  26782. Kubernetes meta/v1.ObjectMeta
  26783. </a>
  26784. </em>
  26785. </td>
  26786. <td>
  26787. Refer to the Kubernetes API documentation for the fields of the
  26788. <code>metadata</code> field.
  26789. </td>
  26790. </tr>
  26791. <tr>
  26792. <td>
  26793. <code>spec</code></br>
  26794. <em>
  26795. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  26796. GCRAccessTokenSpec
  26797. </a>
  26798. </em>
  26799. </td>
  26800. <td>
  26801. <br/>
  26802. <br/>
  26803. <table>
  26804. <tr>
  26805. <td>
  26806. <code>auth</code></br>
  26807. <em>
  26808. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  26809. GCPSMAuth
  26810. </a>
  26811. </em>
  26812. </td>
  26813. <td>
  26814. <p>Auth defines the means for authenticating with GCP</p>
  26815. </td>
  26816. </tr>
  26817. <tr>
  26818. <td>
  26819. <code>projectID</code></br>
  26820. <em>
  26821. string
  26822. </em>
  26823. </td>
  26824. <td>
  26825. <p>ProjectID defines which project to use to authenticate with</p>
  26826. </td>
  26827. </tr>
  26828. </table>
  26829. </td>
  26830. </tr>
  26831. </tbody>
  26832. </table>
  26833. <h3 id="generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">GCRAccessTokenSpec
  26834. </h3>
  26835. <p>
  26836. (<em>Appears on:</em>
  26837. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessToken">GCRAccessToken</a>,
  26838. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>)
  26839. </p>
  26840. <p>
  26841. <p>GCRAccessTokenSpec defines the desired state to generate a Google Container Registry access token.</p>
  26842. </p>
  26843. <table>
  26844. <thead>
  26845. <tr>
  26846. <th>Field</th>
  26847. <th>Description</th>
  26848. </tr>
  26849. </thead>
  26850. <tbody>
  26851. <tr>
  26852. <td>
  26853. <code>auth</code></br>
  26854. <em>
  26855. <a href="#generators.external-secrets.io/v1alpha1.GCPSMAuth">
  26856. GCPSMAuth
  26857. </a>
  26858. </em>
  26859. </td>
  26860. <td>
  26861. <p>Auth defines the means for authenticating with GCP</p>
  26862. </td>
  26863. </tr>
  26864. <tr>
  26865. <td>
  26866. <code>projectID</code></br>
  26867. <em>
  26868. string
  26869. </em>
  26870. </td>
  26871. <td>
  26872. <p>ProjectID defines which project to use to authenticate with</p>
  26873. </td>
  26874. </tr>
  26875. </tbody>
  26876. </table>
  26877. <h3 id="generators.external-secrets.io/v1alpha1.Generator">Generator
  26878. </h3>
  26879. <p>
  26880. <p>Generator is the common interface for all generators that is actually used to generate whatever is needed.</p>
  26881. </p>
  26882. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorKind">GeneratorKind
  26883. (<code>string</code> alias)</p></h3>
  26884. <p>
  26885. (<em>Appears on:</em>
  26886. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  26887. </p>
  26888. <p>
  26889. <p>GeneratorKind represents a kind of generator.</p>
  26890. </p>
  26891. <table>
  26892. <thead>
  26893. <tr>
  26894. <th>Value</th>
  26895. <th>Description</th>
  26896. </tr>
  26897. </thead>
  26898. <tbody><tr><td><p>&#34;ACRAccessToken&#34;</p></td>
  26899. <td><p>GeneratorKindACRAccessToken represents an Azure Container Registry access token generator.</p>
  26900. </td>
  26901. </tr><tr><td><p>&#34;CloudsmithAccessToken&#34;</p></td>
  26902. <td><p>GeneratorKindCloudsmithAccessToken represents a Cloudsmith access token generator.</p>
  26903. </td>
  26904. </tr><tr><td><p>&#34;ECRAuthorizationToken&#34;</p></td>
  26905. <td><p>GeneratorKindECRAuthorizationToken represents an AWS ECR authorization token generator.</p>
  26906. </td>
  26907. </tr><tr><td><p>&#34;Fake&#34;</p></td>
  26908. <td><p>GeneratorKindFake represents a fake generator for testing purposes.</p>
  26909. </td>
  26910. </tr><tr><td><p>&#34;GCRAccessToken&#34;</p></td>
  26911. <td><p>GeneratorKindGCRAccessToken represents a Google Container Registry access token generator.</p>
  26912. </td>
  26913. </tr><tr><td><p>&#34;GithubAccessToken&#34;</p></td>
  26914. <td><p>GeneratorKindGithubAccessToken represents a GitHub access token generator.</p>
  26915. </td>
  26916. </tr><tr><td><p>&#34;Grafana&#34;</p></td>
  26917. <td><p>GeneratorKindGrafana represents a Grafana token generator.</p>
  26918. </td>
  26919. </tr><tr><td><p>&#34;MFA&#34;</p></td>
  26920. <td><p>GeneratorKindMFA represents a Multi-Factor Authentication generator.</p>
  26921. </td>
  26922. </tr><tr><td><p>&#34;Password&#34;</p></td>
  26923. <td><p>GeneratorKindPassword represents a password generator.</p>
  26924. </td>
  26925. </tr><tr><td><p>&#34;QuayAccessToken&#34;</p></td>
  26926. <td><p>GeneratorKindQuayAccessToken represents a Quay access token generator.</p>
  26927. </td>
  26928. </tr><tr><td><p>&#34;SSHKey&#34;</p></td>
  26929. <td><p>GeneratorKindSSHKey represents an SSH key generator.</p>
  26930. </td>
  26931. </tr><tr><td><p>&#34;STSSessionToken&#34;</p></td>
  26932. <td><p>GeneratorKindSTSSessionToken represents an AWS STS session token generator.</p>
  26933. </td>
  26934. </tr><tr><td><p>&#34;UUID&#34;</p></td>
  26935. <td><p>GeneratorKindUUID represents a UUID generator.</p>
  26936. </td>
  26937. </tr><tr><td><p>&#34;VaultDynamicSecret&#34;</p></td>
  26938. <td><p>GeneratorKindVaultDynamicSecret represents a HashiCorp Vault dynamic secret generator.</p>
  26939. </td>
  26940. </tr><tr><td><p>&#34;Webhook&#34;</p></td>
  26941. <td><p>GeneratorKindWebhook represents a webhook-based generator.</p>
  26942. </td>
  26943. </tr></tbody>
  26944. </table>
  26945. <h3 id="&lt;UNKNOWN_API_GROUP&gt;.GeneratorProviderState">GeneratorProviderState
  26946. </h3>
  26947. <p>
  26948. <p>GeneratorProviderState represents the state of a generator provider that can be stored and retrieved.</p>
  26949. </p>
  26950. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec
  26951. </h3>
  26952. <p>
  26953. (<em>Appears on:</em>
  26954. <a href="#generators.external-secrets.io/v1alpha1.ClusterGeneratorSpec">ClusterGeneratorSpec</a>)
  26955. </p>
  26956. <p>
  26957. <p>GeneratorSpec defines the configuration for various supported generator types.</p>
  26958. </p>
  26959. <table>
  26960. <thead>
  26961. <tr>
  26962. <th>Field</th>
  26963. <th>Description</th>
  26964. </tr>
  26965. </thead>
  26966. <tbody>
  26967. <tr>
  26968. <td>
  26969. <code>acrAccessTokenSpec</code></br>
  26970. <em>
  26971. <a href="#generators.external-secrets.io/v1alpha1.ACRAccessTokenSpec">
  26972. ACRAccessTokenSpec
  26973. </a>
  26974. </em>
  26975. </td>
  26976. <td>
  26977. </td>
  26978. </tr>
  26979. <tr>
  26980. <td>
  26981. <code>cloudsmithAccessTokenSpec</code></br>
  26982. <em>
  26983. <a href="#generators.external-secrets.io/v1alpha1.CloudsmithAccessTokenSpec">
  26984. CloudsmithAccessTokenSpec
  26985. </a>
  26986. </em>
  26987. </td>
  26988. <td>
  26989. </td>
  26990. </tr>
  26991. <tr>
  26992. <td>
  26993. <code>ecrAuthorizationTokenSpec</code></br>
  26994. <em>
  26995. <a href="#generators.external-secrets.io/v1alpha1.ECRAuthorizationTokenSpec">
  26996. ECRAuthorizationTokenSpec
  26997. </a>
  26998. </em>
  26999. </td>
  27000. <td>
  27001. </td>
  27002. </tr>
  27003. <tr>
  27004. <td>
  27005. <code>fakeSpec</code></br>
  27006. <em>
  27007. <a href="#generators.external-secrets.io/v1alpha1.FakeSpec">
  27008. FakeSpec
  27009. </a>
  27010. </em>
  27011. </td>
  27012. <td>
  27013. </td>
  27014. </tr>
  27015. <tr>
  27016. <td>
  27017. <code>gcrAccessTokenSpec</code></br>
  27018. <em>
  27019. <a href="#generators.external-secrets.io/v1alpha1.GCRAccessTokenSpec">
  27020. GCRAccessTokenSpec
  27021. </a>
  27022. </em>
  27023. </td>
  27024. <td>
  27025. </td>
  27026. </tr>
  27027. <tr>
  27028. <td>
  27029. <code>githubAccessTokenSpec</code></br>
  27030. <em>
  27031. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  27032. GithubAccessTokenSpec
  27033. </a>
  27034. </em>
  27035. </td>
  27036. <td>
  27037. </td>
  27038. </tr>
  27039. <tr>
  27040. <td>
  27041. <code>quayAccessTokenSpec</code></br>
  27042. <em>
  27043. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  27044. QuayAccessTokenSpec
  27045. </a>
  27046. </em>
  27047. </td>
  27048. <td>
  27049. </td>
  27050. </tr>
  27051. <tr>
  27052. <td>
  27053. <code>passwordSpec</code></br>
  27054. <em>
  27055. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  27056. PasswordSpec
  27057. </a>
  27058. </em>
  27059. </td>
  27060. <td>
  27061. </td>
  27062. </tr>
  27063. <tr>
  27064. <td>
  27065. <code>sshKeySpec</code></br>
  27066. <em>
  27067. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  27068. SSHKeySpec
  27069. </a>
  27070. </em>
  27071. </td>
  27072. <td>
  27073. </td>
  27074. </tr>
  27075. <tr>
  27076. <td>
  27077. <code>stsSessionTokenSpec</code></br>
  27078. <em>
  27079. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  27080. STSSessionTokenSpec
  27081. </a>
  27082. </em>
  27083. </td>
  27084. <td>
  27085. </td>
  27086. </tr>
  27087. <tr>
  27088. <td>
  27089. <code>uuidSpec</code></br>
  27090. <em>
  27091. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  27092. UUIDSpec
  27093. </a>
  27094. </em>
  27095. </td>
  27096. <td>
  27097. </td>
  27098. </tr>
  27099. <tr>
  27100. <td>
  27101. <code>vaultDynamicSecretSpec</code></br>
  27102. <em>
  27103. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  27104. VaultDynamicSecretSpec
  27105. </a>
  27106. </em>
  27107. </td>
  27108. <td>
  27109. </td>
  27110. </tr>
  27111. <tr>
  27112. <td>
  27113. <code>webhookSpec</code></br>
  27114. <em>
  27115. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  27116. WebhookSpec
  27117. </a>
  27118. </em>
  27119. </td>
  27120. <td>
  27121. </td>
  27122. </tr>
  27123. <tr>
  27124. <td>
  27125. <code>grafanaSpec</code></br>
  27126. <em>
  27127. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  27128. GrafanaSpec
  27129. </a>
  27130. </em>
  27131. </td>
  27132. <td>
  27133. </td>
  27134. </tr>
  27135. <tr>
  27136. <td>
  27137. <code>mfaSpec</code></br>
  27138. <em>
  27139. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  27140. MFASpec
  27141. </a>
  27142. </em>
  27143. </td>
  27144. <td>
  27145. </td>
  27146. </tr>
  27147. </tbody>
  27148. </table>
  27149. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState
  27150. </h3>
  27151. <p>
  27152. <p>GeneratorState represents the state created and managed by a generator resource.</p>
  27153. </p>
  27154. <table>
  27155. <thead>
  27156. <tr>
  27157. <th>Field</th>
  27158. <th>Description</th>
  27159. </tr>
  27160. </thead>
  27161. <tbody>
  27162. <tr>
  27163. <td>
  27164. <code>metadata</code></br>
  27165. <em>
  27166. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27167. Kubernetes meta/v1.ObjectMeta
  27168. </a>
  27169. </em>
  27170. </td>
  27171. <td>
  27172. Refer to the Kubernetes API documentation for the fields of the
  27173. <code>metadata</code> field.
  27174. </td>
  27175. </tr>
  27176. <tr>
  27177. <td>
  27178. <code>spec</code></br>
  27179. <em>
  27180. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateSpec">
  27181. GeneratorStateSpec
  27182. </a>
  27183. </em>
  27184. </td>
  27185. <td>
  27186. <br/>
  27187. <br/>
  27188. <table>
  27189. <tr>
  27190. <td>
  27191. <code>garbageCollectionDeadline</code></br>
  27192. <em>
  27193. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  27194. Kubernetes meta/v1.Time
  27195. </a>
  27196. </em>
  27197. </td>
  27198. <td>
  27199. <p>GarbageCollectionDeadline is the time after which the generator state
  27200. will be deleted.
  27201. It is set by the controller which creates the generator state and
  27202. can be set configured by the user.
  27203. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  27204. </td>
  27205. </tr>
  27206. <tr>
  27207. <td>
  27208. <code>resource</code></br>
  27209. <em>
  27210. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  27211. </em>
  27212. </td>
  27213. <td>
  27214. <p>Resource is the generator manifest that produced the state.
  27215. It is a snapshot of the generator manifest at the time the state was produced.
  27216. This manifest will be used to delete the resource. Any configuration that is referenced
  27217. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  27218. be blocked by a finalizer.</p>
  27219. </td>
  27220. </tr>
  27221. <tr>
  27222. <td>
  27223. <code>state</code></br>
  27224. <em>
  27225. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  27226. </em>
  27227. </td>
  27228. <td>
  27229. <p>State is the state that was produced by the generator implementation.</p>
  27230. </td>
  27231. </tr>
  27232. </table>
  27233. </td>
  27234. </tr>
  27235. <tr>
  27236. <td>
  27237. <code>status</code></br>
  27238. <em>
  27239. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">
  27240. GeneratorStateStatus
  27241. </a>
  27242. </em>
  27243. </td>
  27244. <td>
  27245. </td>
  27246. </tr>
  27247. </tbody>
  27248. </table>
  27249. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">GeneratorStateConditionType
  27250. (<code>string</code> alias)</p></h3>
  27251. <p>
  27252. (<em>Appears on:</em>
  27253. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition</a>)
  27254. </p>
  27255. <p>
  27256. <p>GeneratorStateConditionType represents the type of condition for a generator state.</p>
  27257. </p>
  27258. <table>
  27259. <thead>
  27260. <tr>
  27261. <th>Value</th>
  27262. <th>Description</th>
  27263. </tr>
  27264. </thead>
  27265. <tbody><tr><td><p>&#34;Ready&#34;</p></td>
  27266. <td><p>GeneratorStateReady indicates the generator state is ready and available.</p>
  27267. </td>
  27268. </tr></tbody>
  27269. </table>
  27270. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateSpec">GeneratorStateSpec
  27271. </h3>
  27272. <p>
  27273. (<em>Appears on:</em>
  27274. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  27275. </p>
  27276. <p>
  27277. <p>GeneratorStateSpec defines the desired state of a generator state resource.</p>
  27278. </p>
  27279. <table>
  27280. <thead>
  27281. <tr>
  27282. <th>Field</th>
  27283. <th>Description</th>
  27284. </tr>
  27285. </thead>
  27286. <tbody>
  27287. <tr>
  27288. <td>
  27289. <code>garbageCollectionDeadline</code></br>
  27290. <em>
  27291. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  27292. Kubernetes meta/v1.Time
  27293. </a>
  27294. </em>
  27295. </td>
  27296. <td>
  27297. <p>GarbageCollectionDeadline is the time after which the generator state
  27298. will be deleted.
  27299. It is set by the controller which creates the generator state and
  27300. can be set configured by the user.
  27301. If the garbage collection deadline is not set the generator state will not be deleted.</p>
  27302. </td>
  27303. </tr>
  27304. <tr>
  27305. <td>
  27306. <code>resource</code></br>
  27307. <em>
  27308. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  27309. </em>
  27310. </td>
  27311. <td>
  27312. <p>Resource is the generator manifest that produced the state.
  27313. It is a snapshot of the generator manifest at the time the state was produced.
  27314. This manifest will be used to delete the resource. Any configuration that is referenced
  27315. in the manifest should be available at the time of garbage collection. If that is not the case deletion will
  27316. be blocked by a finalizer.</p>
  27317. </td>
  27318. </tr>
  27319. <tr>
  27320. <td>
  27321. <code>state</code></br>
  27322. <em>
  27323. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  27324. </em>
  27325. </td>
  27326. <td>
  27327. <p>State is the state that was produced by the generator implementation.</p>
  27328. </td>
  27329. </tr>
  27330. </tbody>
  27331. </table>
  27332. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus
  27333. </h3>
  27334. <p>
  27335. (<em>Appears on:</em>
  27336. <a href="#generators.external-secrets.io/v1alpha1.GeneratorState">GeneratorState</a>)
  27337. </p>
  27338. <p>
  27339. <p>GeneratorStateStatus defines the observed state of a generator state resource.</p>
  27340. </p>
  27341. <table>
  27342. <thead>
  27343. <tr>
  27344. <th>Field</th>
  27345. <th>Description</th>
  27346. </tr>
  27347. </thead>
  27348. <tbody>
  27349. <tr>
  27350. <td>
  27351. <code>conditions</code></br>
  27352. <em>
  27353. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">
  27354. []GeneratorStateStatusCondition
  27355. </a>
  27356. </em>
  27357. </td>
  27358. <td>
  27359. </td>
  27360. </tr>
  27361. </tbody>
  27362. </table>
  27363. <h3 id="generators.external-secrets.io/v1alpha1.GeneratorStateStatusCondition">GeneratorStateStatusCondition
  27364. </h3>
  27365. <p>
  27366. (<em>Appears on:</em>
  27367. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateStatus">GeneratorStateStatus</a>)
  27368. </p>
  27369. <p>
  27370. <p>GeneratorStateStatusCondition represents the observed condition of a generator state.</p>
  27371. </p>
  27372. <table>
  27373. <thead>
  27374. <tr>
  27375. <th>Field</th>
  27376. <th>Description</th>
  27377. </tr>
  27378. </thead>
  27379. <tbody>
  27380. <tr>
  27381. <td>
  27382. <code>type</code></br>
  27383. <em>
  27384. <a href="#generators.external-secrets.io/v1alpha1.GeneratorStateConditionType">
  27385. GeneratorStateConditionType
  27386. </a>
  27387. </em>
  27388. </td>
  27389. <td>
  27390. </td>
  27391. </tr>
  27392. <tr>
  27393. <td>
  27394. <code>status</code></br>
  27395. <em>
  27396. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#conditionstatus-v1-core">
  27397. Kubernetes core/v1.ConditionStatus
  27398. </a>
  27399. </em>
  27400. </td>
  27401. <td>
  27402. </td>
  27403. </tr>
  27404. <tr>
  27405. <td>
  27406. <code>reason</code></br>
  27407. <em>
  27408. string
  27409. </em>
  27410. </td>
  27411. <td>
  27412. <em>(Optional)</em>
  27413. </td>
  27414. </tr>
  27415. <tr>
  27416. <td>
  27417. <code>message</code></br>
  27418. <em>
  27419. string
  27420. </em>
  27421. </td>
  27422. <td>
  27423. <em>(Optional)</em>
  27424. </td>
  27425. </tr>
  27426. <tr>
  27427. <td>
  27428. <code>lastTransitionTime</code></br>
  27429. <em>
  27430. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  27431. Kubernetes meta/v1.Time
  27432. </a>
  27433. </em>
  27434. </td>
  27435. <td>
  27436. <em>(Optional)</em>
  27437. </td>
  27438. </tr>
  27439. </tbody>
  27440. </table>
  27441. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken
  27442. </h3>
  27443. <p>
  27444. <p>GithubAccessToken generates ghs_ accessToken</p>
  27445. </p>
  27446. <table>
  27447. <thead>
  27448. <tr>
  27449. <th>Field</th>
  27450. <th>Description</th>
  27451. </tr>
  27452. </thead>
  27453. <tbody>
  27454. <tr>
  27455. <td>
  27456. <code>metadata</code></br>
  27457. <em>
  27458. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27459. Kubernetes meta/v1.ObjectMeta
  27460. </a>
  27461. </em>
  27462. </td>
  27463. <td>
  27464. Refer to the Kubernetes API documentation for the fields of the
  27465. <code>metadata</code> field.
  27466. </td>
  27467. </tr>
  27468. <tr>
  27469. <td>
  27470. <code>spec</code></br>
  27471. <em>
  27472. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">
  27473. GithubAccessTokenSpec
  27474. </a>
  27475. </em>
  27476. </td>
  27477. <td>
  27478. <br/>
  27479. <br/>
  27480. <table>
  27481. <tr>
  27482. <td>
  27483. <code>url</code></br>
  27484. <em>
  27485. string
  27486. </em>
  27487. </td>
  27488. <td>
  27489. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  27490. </td>
  27491. </tr>
  27492. <tr>
  27493. <td>
  27494. <code>appID</code></br>
  27495. <em>
  27496. string
  27497. </em>
  27498. </td>
  27499. <td>
  27500. </td>
  27501. </tr>
  27502. <tr>
  27503. <td>
  27504. <code>installID</code></br>
  27505. <em>
  27506. string
  27507. </em>
  27508. </td>
  27509. <td>
  27510. </td>
  27511. </tr>
  27512. <tr>
  27513. <td>
  27514. <code>repositories</code></br>
  27515. <em>
  27516. []string
  27517. </em>
  27518. </td>
  27519. <td>
  27520. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  27521. is installed to.</p>
  27522. </td>
  27523. </tr>
  27524. <tr>
  27525. <td>
  27526. <code>permissions</code></br>
  27527. <em>
  27528. map[string]string
  27529. </em>
  27530. </td>
  27531. <td>
  27532. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  27533. </td>
  27534. </tr>
  27535. <tr>
  27536. <td>
  27537. <code>auth</code></br>
  27538. <em>
  27539. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  27540. GithubAuth
  27541. </a>
  27542. </em>
  27543. </td>
  27544. <td>
  27545. <p>Auth configures how ESO authenticates with a Github instance.</p>
  27546. </td>
  27547. </tr>
  27548. </table>
  27549. </td>
  27550. </tr>
  27551. </tbody>
  27552. </table>
  27553. <h3 id="generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec
  27554. </h3>
  27555. <p>
  27556. (<em>Appears on:</em>
  27557. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  27558. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessToken">GithubAccessToken</a>)
  27559. </p>
  27560. <p>
  27561. <p>GithubAccessTokenSpec defines the desired state to generate a GitHub access token.</p>
  27562. </p>
  27563. <table>
  27564. <thead>
  27565. <tr>
  27566. <th>Field</th>
  27567. <th>Description</th>
  27568. </tr>
  27569. </thead>
  27570. <tbody>
  27571. <tr>
  27572. <td>
  27573. <code>url</code></br>
  27574. <em>
  27575. string
  27576. </em>
  27577. </td>
  27578. <td>
  27579. <p>URL configures the GitHub instance URL. Defaults to <a href="https://github.com/">https://github.com/</a>.</p>
  27580. </td>
  27581. </tr>
  27582. <tr>
  27583. <td>
  27584. <code>appID</code></br>
  27585. <em>
  27586. string
  27587. </em>
  27588. </td>
  27589. <td>
  27590. </td>
  27591. </tr>
  27592. <tr>
  27593. <td>
  27594. <code>installID</code></br>
  27595. <em>
  27596. string
  27597. </em>
  27598. </td>
  27599. <td>
  27600. </td>
  27601. </tr>
  27602. <tr>
  27603. <td>
  27604. <code>repositories</code></br>
  27605. <em>
  27606. []string
  27607. </em>
  27608. </td>
  27609. <td>
  27610. <p>List of repositories the token will have access to. If omitted, defaults to all repositories the GitHub App
  27611. is installed to.</p>
  27612. </td>
  27613. </tr>
  27614. <tr>
  27615. <td>
  27616. <code>permissions</code></br>
  27617. <em>
  27618. map[string]string
  27619. </em>
  27620. </td>
  27621. <td>
  27622. <p>Map of permissions the token will have. If omitted, defaults to all permissions the GitHub App has.</p>
  27623. </td>
  27624. </tr>
  27625. <tr>
  27626. <td>
  27627. <code>auth</code></br>
  27628. <em>
  27629. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">
  27630. GithubAuth
  27631. </a>
  27632. </em>
  27633. </td>
  27634. <td>
  27635. <p>Auth configures how ESO authenticates with a Github instance.</p>
  27636. </td>
  27637. </tr>
  27638. </tbody>
  27639. </table>
  27640. <h3 id="generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth
  27641. </h3>
  27642. <p>
  27643. (<em>Appears on:</em>
  27644. <a href="#generators.external-secrets.io/v1alpha1.GithubAccessTokenSpec">GithubAccessTokenSpec</a>)
  27645. </p>
  27646. <p>
  27647. <p>GithubAuth defines the authentication configuration for GitHub access.</p>
  27648. </p>
  27649. <table>
  27650. <thead>
  27651. <tr>
  27652. <th>Field</th>
  27653. <th>Description</th>
  27654. </tr>
  27655. </thead>
  27656. <tbody>
  27657. <tr>
  27658. <td>
  27659. <code>privateKey</code></br>
  27660. <em>
  27661. <a href="#generators.external-secrets.io/v1alpha1.GithubSecretRef">
  27662. GithubSecretRef
  27663. </a>
  27664. </em>
  27665. </td>
  27666. <td>
  27667. </td>
  27668. </tr>
  27669. </tbody>
  27670. </table>
  27671. <h3 id="generators.external-secrets.io/v1alpha1.GithubSecretRef">GithubSecretRef
  27672. </h3>
  27673. <p>
  27674. (<em>Appears on:</em>
  27675. <a href="#generators.external-secrets.io/v1alpha1.GithubAuth">GithubAuth</a>)
  27676. </p>
  27677. <p>
  27678. <p>GithubSecretRef references a secret containing GitHub credentials.</p>
  27679. </p>
  27680. <table>
  27681. <thead>
  27682. <tr>
  27683. <th>Field</th>
  27684. <th>Description</th>
  27685. </tr>
  27686. </thead>
  27687. <tbody>
  27688. <tr>
  27689. <td>
  27690. <code>secretRef</code></br>
  27691. <em>
  27692. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  27693. External Secrets meta/v1.SecretKeySelector
  27694. </a>
  27695. </em>
  27696. </td>
  27697. <td>
  27698. </td>
  27699. </tr>
  27700. </tbody>
  27701. </table>
  27702. <h3 id="generators.external-secrets.io/v1alpha1.Grafana">Grafana
  27703. </h3>
  27704. <p>
  27705. <p>Grafana represents a generator for Grafana service account tokens.</p>
  27706. </p>
  27707. <table>
  27708. <thead>
  27709. <tr>
  27710. <th>Field</th>
  27711. <th>Description</th>
  27712. </tr>
  27713. </thead>
  27714. <tbody>
  27715. <tr>
  27716. <td>
  27717. <code>metadata</code></br>
  27718. <em>
  27719. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  27720. Kubernetes meta/v1.ObjectMeta
  27721. </a>
  27722. </em>
  27723. </td>
  27724. <td>
  27725. Refer to the Kubernetes API documentation for the fields of the
  27726. <code>metadata</code> field.
  27727. </td>
  27728. </tr>
  27729. <tr>
  27730. <td>
  27731. <code>spec</code></br>
  27732. <em>
  27733. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">
  27734. GrafanaSpec
  27735. </a>
  27736. </em>
  27737. </td>
  27738. <td>
  27739. <br/>
  27740. <br/>
  27741. <table>
  27742. <tr>
  27743. <td>
  27744. <code>url</code></br>
  27745. <em>
  27746. string
  27747. </em>
  27748. </td>
  27749. <td>
  27750. <p>URL is the URL of the Grafana instance.</p>
  27751. </td>
  27752. </tr>
  27753. <tr>
  27754. <td>
  27755. <code>auth</code></br>
  27756. <em>
  27757. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  27758. GrafanaAuth
  27759. </a>
  27760. </em>
  27761. </td>
  27762. <td>
  27763. <p>Auth is the authentication configuration to authenticate
  27764. against the Grafana instance.</p>
  27765. </td>
  27766. </tr>
  27767. <tr>
  27768. <td>
  27769. <code>serviceAccount</code></br>
  27770. <em>
  27771. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  27772. GrafanaServiceAccount
  27773. </a>
  27774. </em>
  27775. </td>
  27776. <td>
  27777. <p>ServiceAccount is the configuration for the service account that
  27778. is supposed to be generated by the generator.</p>
  27779. </td>
  27780. </tr>
  27781. </table>
  27782. </td>
  27783. </tr>
  27784. </tbody>
  27785. </table>
  27786. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth
  27787. </h3>
  27788. <p>
  27789. (<em>Appears on:</em>
  27790. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  27791. </p>
  27792. <p>
  27793. <p>GrafanaAuth defines the authentication methods for connecting to a Grafana instance.</p>
  27794. </p>
  27795. <table>
  27796. <thead>
  27797. <tr>
  27798. <th>Field</th>
  27799. <th>Description</th>
  27800. </tr>
  27801. </thead>
  27802. <tbody>
  27803. <tr>
  27804. <td>
  27805. <code>token</code></br>
  27806. <em>
  27807. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  27808. SecretKeySelector
  27809. </a>
  27810. </em>
  27811. </td>
  27812. <td>
  27813. <em>(Optional)</em>
  27814. <p>A service account token used to authenticate against the Grafana instance.
  27815. Note: you need a token which has elevated permissions to create service accounts.
  27816. See here for the documentation on basic roles offered by Grafana:
  27817. <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>
  27818. </td>
  27819. </tr>
  27820. <tr>
  27821. <td>
  27822. <code>basic</code></br>
  27823. <em>
  27824. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">
  27825. GrafanaBasicAuth
  27826. </a>
  27827. </em>
  27828. </td>
  27829. <td>
  27830. <em>(Optional)</em>
  27831. <p>Basic auth credentials used to authenticate against the Grafana instance.
  27832. Note: you need a token which has elevated permissions to create service accounts.
  27833. See here for the documentation on basic roles offered by Grafana:
  27834. <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>
  27835. </td>
  27836. </tr>
  27837. </tbody>
  27838. </table>
  27839. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth
  27840. </h3>
  27841. <p>
  27842. (<em>Appears on:</em>
  27843. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>)
  27844. </p>
  27845. <p>
  27846. <p>GrafanaBasicAuth defines the credentials for basic authentication with Grafana.</p>
  27847. </p>
  27848. <table>
  27849. <thead>
  27850. <tr>
  27851. <th>Field</th>
  27852. <th>Description</th>
  27853. </tr>
  27854. </thead>
  27855. <tbody>
  27856. <tr>
  27857. <td>
  27858. <code>username</code></br>
  27859. <em>
  27860. string
  27861. </em>
  27862. </td>
  27863. <td>
  27864. <p>A basic auth username used to authenticate against the Grafana instance.</p>
  27865. </td>
  27866. </tr>
  27867. <tr>
  27868. <td>
  27869. <code>password</code></br>
  27870. <em>
  27871. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  27872. SecretKeySelector
  27873. </a>
  27874. </em>
  27875. </td>
  27876. <td>
  27877. <p>A basic auth password used to authenticate against the Grafana instance.</p>
  27878. </td>
  27879. </tr>
  27880. </tbody>
  27881. </table>
  27882. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">GrafanaServiceAccount
  27883. </h3>
  27884. <p>
  27885. (<em>Appears on:</em>
  27886. <a href="#generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec</a>)
  27887. </p>
  27888. <p>
  27889. <p>GrafanaServiceAccount defines the configuration for a Grafana service account to be created.</p>
  27890. </p>
  27891. <table>
  27892. <thead>
  27893. <tr>
  27894. <th>Field</th>
  27895. <th>Description</th>
  27896. </tr>
  27897. </thead>
  27898. <tbody>
  27899. <tr>
  27900. <td>
  27901. <code>name</code></br>
  27902. <em>
  27903. string
  27904. </em>
  27905. </td>
  27906. <td>
  27907. <p>Name is the name of the service account that will be created by ESO.</p>
  27908. </td>
  27909. </tr>
  27910. <tr>
  27911. <td>
  27912. <code>role</code></br>
  27913. <em>
  27914. string
  27915. </em>
  27916. </td>
  27917. <td>
  27918. <p>Role is the role of the service account.
  27919. See here for the documentation on basic roles offered by Grafana:
  27920. <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>
  27921. </td>
  27922. </tr>
  27923. </tbody>
  27924. </table>
  27925. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState
  27926. </h3>
  27927. <p>
  27928. <p>GrafanaServiceAccountTokenState is the state type produced by the Grafana generator.
  27929. It contains the service account ID, login and token ID which is enough to
  27930. identify the service account.</p>
  27931. </p>
  27932. <table>
  27933. <thead>
  27934. <tr>
  27935. <th>Field</th>
  27936. <th>Description</th>
  27937. </tr>
  27938. </thead>
  27939. <tbody>
  27940. <tr>
  27941. <td>
  27942. <code>serviceAccount</code></br>
  27943. <em>
  27944. <a href="#generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">
  27945. GrafanaStateServiceAccount
  27946. </a>
  27947. </em>
  27948. </td>
  27949. <td>
  27950. </td>
  27951. </tr>
  27952. </tbody>
  27953. </table>
  27954. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaSpec">GrafanaSpec
  27955. </h3>
  27956. <p>
  27957. (<em>Appears on:</em>
  27958. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  27959. <a href="#generators.external-secrets.io/v1alpha1.Grafana">Grafana</a>)
  27960. </p>
  27961. <p>
  27962. <p>GrafanaSpec controls the behavior of the grafana generator.</p>
  27963. </p>
  27964. <table>
  27965. <thead>
  27966. <tr>
  27967. <th>Field</th>
  27968. <th>Description</th>
  27969. </tr>
  27970. </thead>
  27971. <tbody>
  27972. <tr>
  27973. <td>
  27974. <code>url</code></br>
  27975. <em>
  27976. string
  27977. </em>
  27978. </td>
  27979. <td>
  27980. <p>URL is the URL of the Grafana instance.</p>
  27981. </td>
  27982. </tr>
  27983. <tr>
  27984. <td>
  27985. <code>auth</code></br>
  27986. <em>
  27987. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">
  27988. GrafanaAuth
  27989. </a>
  27990. </em>
  27991. </td>
  27992. <td>
  27993. <p>Auth is the authentication configuration to authenticate
  27994. against the Grafana instance.</p>
  27995. </td>
  27996. </tr>
  27997. <tr>
  27998. <td>
  27999. <code>serviceAccount</code></br>
  28000. <em>
  28001. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccount">
  28002. GrafanaServiceAccount
  28003. </a>
  28004. </em>
  28005. </td>
  28006. <td>
  28007. <p>ServiceAccount is the configuration for the service account that
  28008. is supposed to be generated by the generator.</p>
  28009. </td>
  28010. </tr>
  28011. </tbody>
  28012. </table>
  28013. <h3 id="generators.external-secrets.io/v1alpha1.GrafanaStateServiceAccount">GrafanaStateServiceAccount
  28014. </h3>
  28015. <p>
  28016. (<em>Appears on:</em>
  28017. <a href="#generators.external-secrets.io/v1alpha1.GrafanaServiceAccountTokenState">GrafanaServiceAccountTokenState</a>)
  28018. </p>
  28019. <p>
  28020. <p>GrafanaStateServiceAccount contains the service account ID, login and token ID.</p>
  28021. </p>
  28022. <table>
  28023. <thead>
  28024. <tr>
  28025. <th>Field</th>
  28026. <th>Description</th>
  28027. </tr>
  28028. </thead>
  28029. <tbody>
  28030. <tr>
  28031. <td>
  28032. <code>id</code></br>
  28033. <em>
  28034. int64
  28035. </em>
  28036. </td>
  28037. <td>
  28038. </td>
  28039. </tr>
  28040. <tr>
  28041. <td>
  28042. <code>login</code></br>
  28043. <em>
  28044. string
  28045. </em>
  28046. </td>
  28047. <td>
  28048. </td>
  28049. </tr>
  28050. <tr>
  28051. <td>
  28052. <code>tokenID</code></br>
  28053. <em>
  28054. int64
  28055. </em>
  28056. </td>
  28057. <td>
  28058. </td>
  28059. </tr>
  28060. </tbody>
  28061. </table>
  28062. <h3 id="generators.external-secrets.io/v1alpha1.MFA">MFA
  28063. </h3>
  28064. <p>
  28065. <p>MFA generates a new TOTP token that is compliant with RFC 6238.</p>
  28066. </p>
  28067. <table>
  28068. <thead>
  28069. <tr>
  28070. <th>Field</th>
  28071. <th>Description</th>
  28072. </tr>
  28073. </thead>
  28074. <tbody>
  28075. <tr>
  28076. <td>
  28077. <code>metadata</code></br>
  28078. <em>
  28079. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28080. Kubernetes meta/v1.ObjectMeta
  28081. </a>
  28082. </em>
  28083. </td>
  28084. <td>
  28085. Refer to the Kubernetes API documentation for the fields of the
  28086. <code>metadata</code> field.
  28087. </td>
  28088. </tr>
  28089. <tr>
  28090. <td>
  28091. <code>spec</code></br>
  28092. <em>
  28093. <a href="#generators.external-secrets.io/v1alpha1.MFASpec">
  28094. MFASpec
  28095. </a>
  28096. </em>
  28097. </td>
  28098. <td>
  28099. <br/>
  28100. <br/>
  28101. <table>
  28102. <tr>
  28103. <td>
  28104. <code>secret</code></br>
  28105. <em>
  28106. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28107. External Secrets meta/v1.SecretKeySelector
  28108. </a>
  28109. </em>
  28110. </td>
  28111. <td>
  28112. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  28113. </td>
  28114. </tr>
  28115. <tr>
  28116. <td>
  28117. <code>length</code></br>
  28118. <em>
  28119. int
  28120. </em>
  28121. </td>
  28122. <td>
  28123. <p>Length defines the token length. Defaults to 6 characters.</p>
  28124. </td>
  28125. </tr>
  28126. <tr>
  28127. <td>
  28128. <code>timePeriod</code></br>
  28129. <em>
  28130. int
  28131. </em>
  28132. </td>
  28133. <td>
  28134. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  28135. </td>
  28136. </tr>
  28137. <tr>
  28138. <td>
  28139. <code>algorithm</code></br>
  28140. <em>
  28141. string
  28142. </em>
  28143. </td>
  28144. <td>
  28145. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  28146. </td>
  28147. </tr>
  28148. <tr>
  28149. <td>
  28150. <code>when</code></br>
  28151. <em>
  28152. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  28153. Kubernetes meta/v1.Time
  28154. </a>
  28155. </em>
  28156. </td>
  28157. <td>
  28158. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  28159. </td>
  28160. </tr>
  28161. </table>
  28162. </td>
  28163. </tr>
  28164. </tbody>
  28165. </table>
  28166. <h3 id="generators.external-secrets.io/v1alpha1.MFASpec">MFASpec
  28167. </h3>
  28168. <p>
  28169. (<em>Appears on:</em>
  28170. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  28171. <a href="#generators.external-secrets.io/v1alpha1.MFA">MFA</a>)
  28172. </p>
  28173. <p>
  28174. <p>MFASpec controls the behavior of the mfa generator.</p>
  28175. </p>
  28176. <table>
  28177. <thead>
  28178. <tr>
  28179. <th>Field</th>
  28180. <th>Description</th>
  28181. </tr>
  28182. </thead>
  28183. <tbody>
  28184. <tr>
  28185. <td>
  28186. <code>secret</code></br>
  28187. <em>
  28188. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28189. External Secrets meta/v1.SecretKeySelector
  28190. </a>
  28191. </em>
  28192. </td>
  28193. <td>
  28194. <p>Secret is a secret selector to a secret containing the seed secret to generate the TOTP value from.</p>
  28195. </td>
  28196. </tr>
  28197. <tr>
  28198. <td>
  28199. <code>length</code></br>
  28200. <em>
  28201. int
  28202. </em>
  28203. </td>
  28204. <td>
  28205. <p>Length defines the token length. Defaults to 6 characters.</p>
  28206. </td>
  28207. </tr>
  28208. <tr>
  28209. <td>
  28210. <code>timePeriod</code></br>
  28211. <em>
  28212. int
  28213. </em>
  28214. </td>
  28215. <td>
  28216. <p>TimePeriod defines how long the token can be active. Defaults to 30 seconds.</p>
  28217. </td>
  28218. </tr>
  28219. <tr>
  28220. <td>
  28221. <code>algorithm</code></br>
  28222. <em>
  28223. string
  28224. </em>
  28225. </td>
  28226. <td>
  28227. <p>Algorithm to use for encoding. Defaults to SHA1 as per the RFC.</p>
  28228. </td>
  28229. </tr>
  28230. <tr>
  28231. <td>
  28232. <code>when</code></br>
  28233. <em>
  28234. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
  28235. Kubernetes meta/v1.Time
  28236. </a>
  28237. </em>
  28238. </td>
  28239. <td>
  28240. <p>When defines a time parameter that can be used to pin the origin time of the generated token.</p>
  28241. </td>
  28242. </tr>
  28243. </tbody>
  28244. </table>
  28245. <h3 id="generators.external-secrets.io/v1alpha1.NTLMProtocol">NTLMProtocol
  28246. </h3>
  28247. <p>
  28248. (<em>Appears on:</em>
  28249. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">AuthorizationProtocol</a>)
  28250. </p>
  28251. <p>
  28252. <p>NTLMProtocol contains the NTLM-specific configuration.</p>
  28253. </p>
  28254. <table>
  28255. <thead>
  28256. <tr>
  28257. <th>Field</th>
  28258. <th>Description</th>
  28259. </tr>
  28260. </thead>
  28261. <tbody>
  28262. <tr>
  28263. <td>
  28264. <code>usernameSecret</code></br>
  28265. <em>
  28266. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28267. External Secrets meta/v1.SecretKeySelector
  28268. </a>
  28269. </em>
  28270. </td>
  28271. <td>
  28272. </td>
  28273. </tr>
  28274. <tr>
  28275. <td>
  28276. <code>passwordSecret</code></br>
  28277. <em>
  28278. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#SecretKeySelector">
  28279. External Secrets meta/v1.SecretKeySelector
  28280. </a>
  28281. </em>
  28282. </td>
  28283. <td>
  28284. </td>
  28285. </tr>
  28286. </tbody>
  28287. </table>
  28288. <h3 id="generators.external-secrets.io/v1alpha1.Password">Password
  28289. </h3>
  28290. <p>
  28291. <p>Password generates a random password based on the
  28292. configuration parameters in spec.
  28293. You can specify the length, characterset and other attributes.</p>
  28294. </p>
  28295. <table>
  28296. <thead>
  28297. <tr>
  28298. <th>Field</th>
  28299. <th>Description</th>
  28300. </tr>
  28301. </thead>
  28302. <tbody>
  28303. <tr>
  28304. <td>
  28305. <code>metadata</code></br>
  28306. <em>
  28307. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28308. Kubernetes meta/v1.ObjectMeta
  28309. </a>
  28310. </em>
  28311. </td>
  28312. <td>
  28313. Refer to the Kubernetes API documentation for the fields of the
  28314. <code>metadata</code> field.
  28315. </td>
  28316. </tr>
  28317. <tr>
  28318. <td>
  28319. <code>spec</code></br>
  28320. <em>
  28321. <a href="#generators.external-secrets.io/v1alpha1.PasswordSpec">
  28322. PasswordSpec
  28323. </a>
  28324. </em>
  28325. </td>
  28326. <td>
  28327. <br/>
  28328. <br/>
  28329. <table>
  28330. <tr>
  28331. <td>
  28332. <code>length</code></br>
  28333. <em>
  28334. int
  28335. </em>
  28336. </td>
  28337. <td>
  28338. <p>Length of the password to be generated.
  28339. Defaults to 24</p>
  28340. </td>
  28341. </tr>
  28342. <tr>
  28343. <td>
  28344. <code>digits</code></br>
  28345. <em>
  28346. int
  28347. </em>
  28348. </td>
  28349. <td>
  28350. <p>Digits specifies the number of digits in the generated
  28351. password. If omitted it defaults to 25% of the length of the password</p>
  28352. </td>
  28353. </tr>
  28354. <tr>
  28355. <td>
  28356. <code>symbols</code></br>
  28357. <em>
  28358. int
  28359. </em>
  28360. </td>
  28361. <td>
  28362. <p>Symbols specifies the number of symbol characters in the generated
  28363. password. If omitted it defaults to 25% of the length of the password</p>
  28364. </td>
  28365. </tr>
  28366. <tr>
  28367. <td>
  28368. <code>symbolCharacters</code></br>
  28369. <em>
  28370. string
  28371. </em>
  28372. </td>
  28373. <td>
  28374. <p>SymbolCharacters specifies the special characters that should be used
  28375. in the generated password.</p>
  28376. </td>
  28377. </tr>
  28378. <tr>
  28379. <td>
  28380. <code>noUpper</code></br>
  28381. <em>
  28382. bool
  28383. </em>
  28384. </td>
  28385. <td>
  28386. <p>Set NoUpper to disable uppercase characters</p>
  28387. </td>
  28388. </tr>
  28389. <tr>
  28390. <td>
  28391. <code>allowRepeat</code></br>
  28392. <em>
  28393. bool
  28394. </em>
  28395. </td>
  28396. <td>
  28397. <p>set AllowRepeat to true to allow repeating characters.</p>
  28398. </td>
  28399. </tr>
  28400. <tr>
  28401. <td>
  28402. <code>secretKeys</code></br>
  28403. <em>
  28404. []string
  28405. </em>
  28406. </td>
  28407. <td>
  28408. <em>(Optional)</em>
  28409. <p>SecretKeys defines the keys that will be populated with generated passwords.
  28410. Defaults to &ldquo;password&rdquo; when not set.</p>
  28411. </td>
  28412. </tr>
  28413. <tr>
  28414. <td>
  28415. <code>encoding</code></br>
  28416. <em>
  28417. string
  28418. </em>
  28419. </td>
  28420. <td>
  28421. <p>Encoding specifies the encoding of the generated password.
  28422. Valid values are:
  28423. - &ldquo;raw&rdquo; (default): no encoding
  28424. - &ldquo;base64&rdquo;: standard base64 encoding
  28425. - &ldquo;base64url&rdquo;: base64url encoding
  28426. - &ldquo;base32&rdquo;: base32 encoding
  28427. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  28428. </td>
  28429. </tr>
  28430. </table>
  28431. </td>
  28432. </tr>
  28433. </tbody>
  28434. </table>
  28435. <h3 id="generators.external-secrets.io/v1alpha1.PasswordSpec">PasswordSpec
  28436. </h3>
  28437. <p>
  28438. (<em>Appears on:</em>
  28439. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  28440. <a href="#generators.external-secrets.io/v1alpha1.Password">Password</a>)
  28441. </p>
  28442. <p>
  28443. <p>PasswordSpec controls the behavior of the password generator.</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>length</code></br>
  28456. <em>
  28457. int
  28458. </em>
  28459. </td>
  28460. <td>
  28461. <p>Length of the password to be generated.
  28462. Defaults to 24</p>
  28463. </td>
  28464. </tr>
  28465. <tr>
  28466. <td>
  28467. <code>digits</code></br>
  28468. <em>
  28469. int
  28470. </em>
  28471. </td>
  28472. <td>
  28473. <p>Digits specifies the number of digits in the generated
  28474. password. If omitted it defaults to 25% of the length of the password</p>
  28475. </td>
  28476. </tr>
  28477. <tr>
  28478. <td>
  28479. <code>symbols</code></br>
  28480. <em>
  28481. int
  28482. </em>
  28483. </td>
  28484. <td>
  28485. <p>Symbols specifies the number of symbol characters in the generated
  28486. password. If omitted it defaults to 25% of the length of the password</p>
  28487. </td>
  28488. </tr>
  28489. <tr>
  28490. <td>
  28491. <code>symbolCharacters</code></br>
  28492. <em>
  28493. string
  28494. </em>
  28495. </td>
  28496. <td>
  28497. <p>SymbolCharacters specifies the special characters that should be used
  28498. in the generated password.</p>
  28499. </td>
  28500. </tr>
  28501. <tr>
  28502. <td>
  28503. <code>noUpper</code></br>
  28504. <em>
  28505. bool
  28506. </em>
  28507. </td>
  28508. <td>
  28509. <p>Set NoUpper to disable uppercase characters</p>
  28510. </td>
  28511. </tr>
  28512. <tr>
  28513. <td>
  28514. <code>allowRepeat</code></br>
  28515. <em>
  28516. bool
  28517. </em>
  28518. </td>
  28519. <td>
  28520. <p>set AllowRepeat to true to allow repeating characters.</p>
  28521. </td>
  28522. </tr>
  28523. <tr>
  28524. <td>
  28525. <code>secretKeys</code></br>
  28526. <em>
  28527. []string
  28528. </em>
  28529. </td>
  28530. <td>
  28531. <em>(Optional)</em>
  28532. <p>SecretKeys defines the keys that will be populated with generated passwords.
  28533. Defaults to &ldquo;password&rdquo; when not set.</p>
  28534. </td>
  28535. </tr>
  28536. <tr>
  28537. <td>
  28538. <code>encoding</code></br>
  28539. <em>
  28540. string
  28541. </em>
  28542. </td>
  28543. <td>
  28544. <p>Encoding specifies the encoding of the generated password.
  28545. Valid values are:
  28546. - &ldquo;raw&rdquo; (default): no encoding
  28547. - &ldquo;base64&rdquo;: standard base64 encoding
  28548. - &ldquo;base64url&rdquo;: base64url encoding
  28549. - &ldquo;base32&rdquo;: base32 encoding
  28550. - &ldquo;hex&rdquo;: hexadecimal encoding</p>
  28551. </td>
  28552. </tr>
  28553. </tbody>
  28554. </table>
  28555. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken
  28556. </h3>
  28557. <p>
  28558. <p>QuayAccessToken generates Quay oauth token for pulling/pushing images</p>
  28559. </p>
  28560. <table>
  28561. <thead>
  28562. <tr>
  28563. <th>Field</th>
  28564. <th>Description</th>
  28565. </tr>
  28566. </thead>
  28567. <tbody>
  28568. <tr>
  28569. <td>
  28570. <code>metadata</code></br>
  28571. <em>
  28572. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28573. Kubernetes meta/v1.ObjectMeta
  28574. </a>
  28575. </em>
  28576. </td>
  28577. <td>
  28578. Refer to the Kubernetes API documentation for the fields of the
  28579. <code>metadata</code> field.
  28580. </td>
  28581. </tr>
  28582. <tr>
  28583. <td>
  28584. <code>spec</code></br>
  28585. <em>
  28586. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">
  28587. QuayAccessTokenSpec
  28588. </a>
  28589. </em>
  28590. </td>
  28591. <td>
  28592. <br/>
  28593. <br/>
  28594. <table>
  28595. <tr>
  28596. <td>
  28597. <code>url</code></br>
  28598. <em>
  28599. string
  28600. </em>
  28601. </td>
  28602. <td>
  28603. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  28604. </td>
  28605. </tr>
  28606. <tr>
  28607. <td>
  28608. <code>robotAccount</code></br>
  28609. <em>
  28610. string
  28611. </em>
  28612. </td>
  28613. <td>
  28614. <p>Name of the robot account you are federating with</p>
  28615. </td>
  28616. </tr>
  28617. <tr>
  28618. <td>
  28619. <code>serviceAccountRef</code></br>
  28620. <em>
  28621. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28622. External Secrets meta/v1.ServiceAccountSelector
  28623. </a>
  28624. </em>
  28625. </td>
  28626. <td>
  28627. <p>Name of the service account you are federating with</p>
  28628. </td>
  28629. </tr>
  28630. </table>
  28631. </td>
  28632. </tr>
  28633. </tbody>
  28634. </table>
  28635. <h3 id="generators.external-secrets.io/v1alpha1.QuayAccessTokenSpec">QuayAccessTokenSpec
  28636. </h3>
  28637. <p>
  28638. (<em>Appears on:</em>
  28639. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  28640. <a href="#generators.external-secrets.io/v1alpha1.QuayAccessToken">QuayAccessToken</a>)
  28641. </p>
  28642. <p>
  28643. <p>QuayAccessTokenSpec defines the desired state to generate a Quay access token.</p>
  28644. </p>
  28645. <table>
  28646. <thead>
  28647. <tr>
  28648. <th>Field</th>
  28649. <th>Description</th>
  28650. </tr>
  28651. </thead>
  28652. <tbody>
  28653. <tr>
  28654. <td>
  28655. <code>url</code></br>
  28656. <em>
  28657. string
  28658. </em>
  28659. </td>
  28660. <td>
  28661. <p>URL configures the Quay instance URL. Defaults to quay.io.</p>
  28662. </td>
  28663. </tr>
  28664. <tr>
  28665. <td>
  28666. <code>robotAccount</code></br>
  28667. <em>
  28668. string
  28669. </em>
  28670. </td>
  28671. <td>
  28672. <p>Name of the robot account you are federating with</p>
  28673. </td>
  28674. </tr>
  28675. <tr>
  28676. <td>
  28677. <code>serviceAccountRef</code></br>
  28678. <em>
  28679. <a href="https://pkg.go.dev/github.com/external-secrets/external-secrets/apis/meta/v1#ServiceAccountSelector">
  28680. External Secrets meta/v1.ServiceAccountSelector
  28681. </a>
  28682. </em>
  28683. </td>
  28684. <td>
  28685. <p>Name of the service account you are federating with</p>
  28686. </td>
  28687. </tr>
  28688. </tbody>
  28689. </table>
  28690. <h3 id="generators.external-secrets.io/v1alpha1.RequestParameters">RequestParameters
  28691. </h3>
  28692. <p>
  28693. (<em>Appears on:</em>
  28694. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec</a>)
  28695. </p>
  28696. <p>
  28697. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  28698. </p>
  28699. <table>
  28700. <thead>
  28701. <tr>
  28702. <th>Field</th>
  28703. <th>Description</th>
  28704. </tr>
  28705. </thead>
  28706. <tbody>
  28707. <tr>
  28708. <td>
  28709. <code>sessionDuration</code></br>
  28710. <em>
  28711. int32
  28712. </em>
  28713. </td>
  28714. <td>
  28715. <em>(Optional)</em>
  28716. </td>
  28717. </tr>
  28718. <tr>
  28719. <td>
  28720. <code>serialNumber</code></br>
  28721. <em>
  28722. string
  28723. </em>
  28724. </td>
  28725. <td>
  28726. <em>(Optional)</em>
  28727. <p>SerialNumber is the identification number of the MFA device that is associated with the IAM user who is making
  28728. the GetSessionToken call.
  28729. Possible values: hardware device (such as GAHT12345678) or an Amazon Resource Name (ARN) for a virtual device
  28730. (such as arn:aws:iam::123456789012:mfa/user)</p>
  28731. </td>
  28732. </tr>
  28733. <tr>
  28734. <td>
  28735. <code>tokenCode</code></br>
  28736. <em>
  28737. string
  28738. </em>
  28739. </td>
  28740. <td>
  28741. <em>(Optional)</em>
  28742. <p>TokenCode is the value provided by the MFA device, if MFA is required.</p>
  28743. </td>
  28744. </tr>
  28745. </tbody>
  28746. </table>
  28747. <h3 id="generators.external-secrets.io/v1alpha1.SSHKey">SSHKey
  28748. </h3>
  28749. <p>
  28750. <p>SSHKey generates SSH key pairs.</p>
  28751. </p>
  28752. <table>
  28753. <thead>
  28754. <tr>
  28755. <th>Field</th>
  28756. <th>Description</th>
  28757. </tr>
  28758. </thead>
  28759. <tbody>
  28760. <tr>
  28761. <td>
  28762. <code>metadata</code></br>
  28763. <em>
  28764. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28765. Kubernetes meta/v1.ObjectMeta
  28766. </a>
  28767. </em>
  28768. </td>
  28769. <td>
  28770. Refer to the Kubernetes API documentation for the fields of the
  28771. <code>metadata</code> field.
  28772. </td>
  28773. </tr>
  28774. <tr>
  28775. <td>
  28776. <code>spec</code></br>
  28777. <em>
  28778. <a href="#generators.external-secrets.io/v1alpha1.SSHKeySpec">
  28779. SSHKeySpec
  28780. </a>
  28781. </em>
  28782. </td>
  28783. <td>
  28784. <br/>
  28785. <br/>
  28786. <table>
  28787. <tr>
  28788. <td>
  28789. <code>keyType</code></br>
  28790. <em>
  28791. string
  28792. </em>
  28793. </td>
  28794. <td>
  28795. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  28796. </td>
  28797. </tr>
  28798. <tr>
  28799. <td>
  28800. <code>keySize</code></br>
  28801. <em>
  28802. int
  28803. </em>
  28804. </td>
  28805. <td>
  28806. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  28807. For RSA keys: 2048, 3072, 4096
  28808. For ECDSA keys: 256, 384, 521
  28809. Ignored for ed25519 keys</p>
  28810. </td>
  28811. </tr>
  28812. <tr>
  28813. <td>
  28814. <code>comment</code></br>
  28815. <em>
  28816. string
  28817. </em>
  28818. </td>
  28819. <td>
  28820. <p>Comment specifies an optional comment for the SSH key</p>
  28821. </td>
  28822. </tr>
  28823. </table>
  28824. </td>
  28825. </tr>
  28826. </tbody>
  28827. </table>
  28828. <h3 id="generators.external-secrets.io/v1alpha1.SSHKeySpec">SSHKeySpec
  28829. </h3>
  28830. <p>
  28831. (<em>Appears on:</em>
  28832. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  28833. <a href="#generators.external-secrets.io/v1alpha1.SSHKey">SSHKey</a>)
  28834. </p>
  28835. <p>
  28836. <p>SSHKeySpec controls the behavior of the ssh key generator.</p>
  28837. </p>
  28838. <table>
  28839. <thead>
  28840. <tr>
  28841. <th>Field</th>
  28842. <th>Description</th>
  28843. </tr>
  28844. </thead>
  28845. <tbody>
  28846. <tr>
  28847. <td>
  28848. <code>keyType</code></br>
  28849. <em>
  28850. string
  28851. </em>
  28852. </td>
  28853. <td>
  28854. <p>KeyType specifies the SSH key type (rsa, ecdsa, ed25519)</p>
  28855. </td>
  28856. </tr>
  28857. <tr>
  28858. <td>
  28859. <code>keySize</code></br>
  28860. <em>
  28861. int
  28862. </em>
  28863. </td>
  28864. <td>
  28865. <p>KeySize specifies the key size for RSA keys (default: 2048) and ECDSA keys (default: 256).
  28866. For RSA keys: 2048, 3072, 4096
  28867. For ECDSA keys: 256, 384, 521
  28868. Ignored for ed25519 keys</p>
  28869. </td>
  28870. </tr>
  28871. <tr>
  28872. <td>
  28873. <code>comment</code></br>
  28874. <em>
  28875. string
  28876. </em>
  28877. </td>
  28878. <td>
  28879. <p>Comment specifies an optional comment for the SSH key</p>
  28880. </td>
  28881. </tr>
  28882. </tbody>
  28883. </table>
  28884. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken
  28885. </h3>
  28886. <p>
  28887. <p>STSSessionToken uses the GetSessionToken API to retrieve an authorization token.
  28888. The authorization token is valid for 12 hours.
  28889. The authorizationToken returned is a base64 encoded string that can be decoded.
  28890. 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>
  28891. </p>
  28892. <table>
  28893. <thead>
  28894. <tr>
  28895. <th>Field</th>
  28896. <th>Description</th>
  28897. </tr>
  28898. </thead>
  28899. <tbody>
  28900. <tr>
  28901. <td>
  28902. <code>metadata</code></br>
  28903. <em>
  28904. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  28905. Kubernetes meta/v1.ObjectMeta
  28906. </a>
  28907. </em>
  28908. </td>
  28909. <td>
  28910. Refer to the Kubernetes API documentation for the fields of the
  28911. <code>metadata</code> field.
  28912. </td>
  28913. </tr>
  28914. <tr>
  28915. <td>
  28916. <code>spec</code></br>
  28917. <em>
  28918. <a href="#generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">
  28919. STSSessionTokenSpec
  28920. </a>
  28921. </em>
  28922. </td>
  28923. <td>
  28924. <br/>
  28925. <br/>
  28926. <table>
  28927. <tr>
  28928. <td>
  28929. <code>region</code></br>
  28930. <em>
  28931. string
  28932. </em>
  28933. </td>
  28934. <td>
  28935. <p>Region specifies the region to operate in.</p>
  28936. </td>
  28937. </tr>
  28938. <tr>
  28939. <td>
  28940. <code>auth</code></br>
  28941. <em>
  28942. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  28943. AWSAuth
  28944. </a>
  28945. </em>
  28946. </td>
  28947. <td>
  28948. <em>(Optional)</em>
  28949. <p>Auth defines how to authenticate with AWS</p>
  28950. </td>
  28951. </tr>
  28952. <tr>
  28953. <td>
  28954. <code>role</code></br>
  28955. <em>
  28956. string
  28957. </em>
  28958. </td>
  28959. <td>
  28960. <em>(Optional)</em>
  28961. <p>You can assume a role before making calls to the
  28962. desired AWS service.</p>
  28963. </td>
  28964. </tr>
  28965. <tr>
  28966. <td>
  28967. <code>requestParameters</code></br>
  28968. <em>
  28969. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  28970. RequestParameters
  28971. </a>
  28972. </em>
  28973. </td>
  28974. <td>
  28975. <em>(Optional)</em>
  28976. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  28977. </td>
  28978. </tr>
  28979. </table>
  28980. </td>
  28981. </tr>
  28982. </tbody>
  28983. </table>
  28984. <h3 id="generators.external-secrets.io/v1alpha1.STSSessionTokenSpec">STSSessionTokenSpec
  28985. </h3>
  28986. <p>
  28987. (<em>Appears on:</em>
  28988. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  28989. <a href="#generators.external-secrets.io/v1alpha1.STSSessionToken">STSSessionToken</a>)
  28990. </p>
  28991. <p>
  28992. <p>STSSessionTokenSpec defines the desired state to generate an AWS STS session token.</p>
  28993. </p>
  28994. <table>
  28995. <thead>
  28996. <tr>
  28997. <th>Field</th>
  28998. <th>Description</th>
  28999. </tr>
  29000. </thead>
  29001. <tbody>
  29002. <tr>
  29003. <td>
  29004. <code>region</code></br>
  29005. <em>
  29006. string
  29007. </em>
  29008. </td>
  29009. <td>
  29010. <p>Region specifies the region to operate in.</p>
  29011. </td>
  29012. </tr>
  29013. <tr>
  29014. <td>
  29015. <code>auth</code></br>
  29016. <em>
  29017. <a href="#generators.external-secrets.io/v1alpha1.AWSAuth">
  29018. AWSAuth
  29019. </a>
  29020. </em>
  29021. </td>
  29022. <td>
  29023. <em>(Optional)</em>
  29024. <p>Auth defines how to authenticate with AWS</p>
  29025. </td>
  29026. </tr>
  29027. <tr>
  29028. <td>
  29029. <code>role</code></br>
  29030. <em>
  29031. string
  29032. </em>
  29033. </td>
  29034. <td>
  29035. <em>(Optional)</em>
  29036. <p>You can assume a role before making calls to the
  29037. desired AWS service.</p>
  29038. </td>
  29039. </tr>
  29040. <tr>
  29041. <td>
  29042. <code>requestParameters</code></br>
  29043. <em>
  29044. <a href="#generators.external-secrets.io/v1alpha1.RequestParameters">
  29045. RequestParameters
  29046. </a>
  29047. </em>
  29048. </td>
  29049. <td>
  29050. <em>(Optional)</em>
  29051. <p>RequestParameters contains parameters that can be passed to the STS service.</p>
  29052. </td>
  29053. </tr>
  29054. </tbody>
  29055. </table>
  29056. <h3 id="generators.external-secrets.io/v1alpha1.SecretKeySelector">SecretKeySelector
  29057. </h3>
  29058. <p>
  29059. (<em>Appears on:</em>
  29060. <a href="#generators.external-secrets.io/v1alpha1.GrafanaAuth">GrafanaAuth</a>,
  29061. <a href="#generators.external-secrets.io/v1alpha1.GrafanaBasicAuth">GrafanaBasicAuth</a>,
  29062. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret</a>)
  29063. </p>
  29064. <p>
  29065. <p>SecretKeySelector defines a reference to a specific key within a Kubernetes Secret.</p>
  29066. </p>
  29067. <table>
  29068. <thead>
  29069. <tr>
  29070. <th>Field</th>
  29071. <th>Description</th>
  29072. </tr>
  29073. </thead>
  29074. <tbody>
  29075. <tr>
  29076. <td>
  29077. <code>name</code></br>
  29078. <em>
  29079. string
  29080. </em>
  29081. </td>
  29082. <td>
  29083. <p>The name of the Secret resource being referred to.</p>
  29084. </td>
  29085. </tr>
  29086. <tr>
  29087. <td>
  29088. <code>key</code></br>
  29089. <em>
  29090. string
  29091. </em>
  29092. </td>
  29093. <td>
  29094. <p>The key where the token is found.</p>
  29095. </td>
  29096. </tr>
  29097. </tbody>
  29098. </table>
  29099. <h3 id="generators.external-secrets.io/v1alpha1.StatefulResource">StatefulResource
  29100. </h3>
  29101. <p>
  29102. <p>StatefulResource represents a Kubernetes resource that has state which can be tracked.</p>
  29103. </p>
  29104. <h3 id="generators.external-secrets.io/v1alpha1.UUID">UUID
  29105. </h3>
  29106. <p>
  29107. <p>UUID generates a version 1 UUID (e56657e3-764f-11ef-a397-65231a88c216).</p>
  29108. </p>
  29109. <table>
  29110. <thead>
  29111. <tr>
  29112. <th>Field</th>
  29113. <th>Description</th>
  29114. </tr>
  29115. </thead>
  29116. <tbody>
  29117. <tr>
  29118. <td>
  29119. <code>metadata</code></br>
  29120. <em>
  29121. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29122. Kubernetes meta/v1.ObjectMeta
  29123. </a>
  29124. </em>
  29125. </td>
  29126. <td>
  29127. Refer to the Kubernetes API documentation for the fields of the
  29128. <code>metadata</code> field.
  29129. </td>
  29130. </tr>
  29131. <tr>
  29132. <td>
  29133. <code>spec</code></br>
  29134. <em>
  29135. <a href="#generators.external-secrets.io/v1alpha1.UUIDSpec">
  29136. UUIDSpec
  29137. </a>
  29138. </em>
  29139. </td>
  29140. <td>
  29141. <br/>
  29142. <br/>
  29143. <table>
  29144. </table>
  29145. </td>
  29146. </tr>
  29147. </tbody>
  29148. </table>
  29149. <h3 id="generators.external-secrets.io/v1alpha1.UUIDSpec">UUIDSpec
  29150. </h3>
  29151. <p>
  29152. (<em>Appears on:</em>
  29153. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29154. <a href="#generators.external-secrets.io/v1alpha1.UUID">UUID</a>)
  29155. </p>
  29156. <p>
  29157. <p>UUIDSpec controls the behavior of the uuid generator.</p>
  29158. </p>
  29159. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret
  29160. </h3>
  29161. <p>
  29162. <p>VaultDynamicSecret represents a generator that can create dynamic secrets from HashiCorp Vault.</p>
  29163. </p>
  29164. <table>
  29165. <thead>
  29166. <tr>
  29167. <th>Field</th>
  29168. <th>Description</th>
  29169. </tr>
  29170. </thead>
  29171. <tbody>
  29172. <tr>
  29173. <td>
  29174. <code>metadata</code></br>
  29175. <em>
  29176. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29177. Kubernetes meta/v1.ObjectMeta
  29178. </a>
  29179. </em>
  29180. </td>
  29181. <td>
  29182. Refer to the Kubernetes API documentation for the fields of the
  29183. <code>metadata</code> field.
  29184. </td>
  29185. </tr>
  29186. <tr>
  29187. <td>
  29188. <code>spec</code></br>
  29189. <em>
  29190. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">
  29191. VaultDynamicSecretSpec
  29192. </a>
  29193. </em>
  29194. </td>
  29195. <td>
  29196. <br/>
  29197. <br/>
  29198. <table>
  29199. <tr>
  29200. <td>
  29201. <code>controller</code></br>
  29202. <em>
  29203. string
  29204. </em>
  29205. </td>
  29206. <td>
  29207. <em>(Optional)</em>
  29208. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  29209. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  29210. </td>
  29211. </tr>
  29212. <tr>
  29213. <td>
  29214. <code>method</code></br>
  29215. <em>
  29216. string
  29217. </em>
  29218. </td>
  29219. <td>
  29220. <p>Vault API method to use (GET/POST/other)</p>
  29221. </td>
  29222. </tr>
  29223. <tr>
  29224. <td>
  29225. <code>parameters</code></br>
  29226. <em>
  29227. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29228. </em>
  29229. </td>
  29230. <td>
  29231. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  29232. </td>
  29233. </tr>
  29234. <tr>
  29235. <td>
  29236. <code>resultType</code></br>
  29237. <em>
  29238. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  29239. VaultDynamicSecretResultType
  29240. </a>
  29241. </em>
  29242. </td>
  29243. <td>
  29244. <p>Result type defines which data is returned from the generator.
  29245. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  29246. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  29247. the &ldquo;auth&rdquo; section contains the generated token.
  29248. Please refer to the vault docs regarding the result data structure.
  29249. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  29250. </td>
  29251. </tr>
  29252. <tr>
  29253. <td>
  29254. <code>retrySettings</code></br>
  29255. <em>
  29256. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  29257. SecretStoreRetrySettings
  29258. </a>
  29259. </em>
  29260. </td>
  29261. <td>
  29262. <em>(Optional)</em>
  29263. <p>Used to configure http retries if failed</p>
  29264. </td>
  29265. </tr>
  29266. <tr>
  29267. <td>
  29268. <code>provider</code></br>
  29269. <em>
  29270. <a href="#external-secrets.io/v1.VaultProvider">
  29271. VaultProvider
  29272. </a>
  29273. </em>
  29274. </td>
  29275. <td>
  29276. <p>Vault provider common spec</p>
  29277. </td>
  29278. </tr>
  29279. <tr>
  29280. <td>
  29281. <code>path</code></br>
  29282. <em>
  29283. string
  29284. </em>
  29285. </td>
  29286. <td>
  29287. <p>Vault path to obtain the dynamic secret from</p>
  29288. </td>
  29289. </tr>
  29290. <tr>
  29291. <td>
  29292. <code>allowEmptyResponse</code></br>
  29293. <em>
  29294. bool
  29295. </em>
  29296. </td>
  29297. <td>
  29298. <em>(Optional)</em>
  29299. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  29300. </td>
  29301. </tr>
  29302. </table>
  29303. </td>
  29304. </tr>
  29305. </tbody>
  29306. </table>
  29307. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">VaultDynamicSecretResultType
  29308. (<code>string</code> alias)</p></h3>
  29309. <p>
  29310. (<em>Appears on:</em>
  29311. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec</a>)
  29312. </p>
  29313. <p>
  29314. <p>VaultDynamicSecretResultType defines which part of the Vault API response should be returned.</p>
  29315. </p>
  29316. <table>
  29317. <thead>
  29318. <tr>
  29319. <th>Value</th>
  29320. <th>Description</th>
  29321. </tr>
  29322. </thead>
  29323. <tbody><tr><td><p>&#34;Auth&#34;</p></td>
  29324. <td><p>VaultDynamicSecretResultTypeAuth specifies to return the &ldquo;auth&rdquo; section of the Vault API response.</p>
  29325. </td>
  29326. </tr><tr><td><p>&#34;Data&#34;</p></td>
  29327. <td><p>VaultDynamicSecretResultTypeData specifies to return the &ldquo;data&rdquo; section of the Vault API response.</p>
  29328. </td>
  29329. </tr><tr><td><p>&#34;Raw&#34;</p></td>
  29330. <td><p>VaultDynamicSecretResultTypeRaw specifies to return the raw response from the Vault API.</p>
  29331. </td>
  29332. </tr></tbody>
  29333. </table>
  29334. <h3 id="generators.external-secrets.io/v1alpha1.VaultDynamicSecretSpec">VaultDynamicSecretSpec
  29335. </h3>
  29336. <p>
  29337. (<em>Appears on:</em>
  29338. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29339. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecret">VaultDynamicSecret</a>)
  29340. </p>
  29341. <p>
  29342. <p>VaultDynamicSecretSpec defines the desired spec of VaultDynamicSecret.</p>
  29343. </p>
  29344. <table>
  29345. <thead>
  29346. <tr>
  29347. <th>Field</th>
  29348. <th>Description</th>
  29349. </tr>
  29350. </thead>
  29351. <tbody>
  29352. <tr>
  29353. <td>
  29354. <code>controller</code></br>
  29355. <em>
  29356. string
  29357. </em>
  29358. </td>
  29359. <td>
  29360. <em>(Optional)</em>
  29361. <p>Used to select the correct ESO controller (think: ingress.ingressClassName)
  29362. The ESO controller is instantiated with a specific controller name and filters VDS based on this property</p>
  29363. </td>
  29364. </tr>
  29365. <tr>
  29366. <td>
  29367. <code>method</code></br>
  29368. <em>
  29369. string
  29370. </em>
  29371. </td>
  29372. <td>
  29373. <p>Vault API method to use (GET/POST/other)</p>
  29374. </td>
  29375. </tr>
  29376. <tr>
  29377. <td>
  29378. <code>parameters</code></br>
  29379. <em>
  29380. k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1.JSON
  29381. </em>
  29382. </td>
  29383. <td>
  29384. <p>Parameters to pass to Vault write (for non-GET methods)</p>
  29385. </td>
  29386. </tr>
  29387. <tr>
  29388. <td>
  29389. <code>resultType</code></br>
  29390. <em>
  29391. <a href="#generators.external-secrets.io/v1alpha1.VaultDynamicSecretResultType">
  29392. VaultDynamicSecretResultType
  29393. </a>
  29394. </em>
  29395. </td>
  29396. <td>
  29397. <p>Result type defines which data is returned from the generator.
  29398. By default, it is the &ldquo;data&rdquo; section of the Vault API response.
  29399. When using e.g. /auth/token/create the &ldquo;data&rdquo; section is empty but
  29400. the &ldquo;auth&rdquo; section contains the generated token.
  29401. Please refer to the vault docs regarding the result data structure.
  29402. Additionally, accessing the raw response is possibly by using &ldquo;Raw&rdquo; result type.</p>
  29403. </td>
  29404. </tr>
  29405. <tr>
  29406. <td>
  29407. <code>retrySettings</code></br>
  29408. <em>
  29409. <a href="#external-secrets.io/v1.SecretStoreRetrySettings">
  29410. SecretStoreRetrySettings
  29411. </a>
  29412. </em>
  29413. </td>
  29414. <td>
  29415. <em>(Optional)</em>
  29416. <p>Used to configure http retries if failed</p>
  29417. </td>
  29418. </tr>
  29419. <tr>
  29420. <td>
  29421. <code>provider</code></br>
  29422. <em>
  29423. <a href="#external-secrets.io/v1.VaultProvider">
  29424. VaultProvider
  29425. </a>
  29426. </em>
  29427. </td>
  29428. <td>
  29429. <p>Vault provider common spec</p>
  29430. </td>
  29431. </tr>
  29432. <tr>
  29433. <td>
  29434. <code>path</code></br>
  29435. <em>
  29436. string
  29437. </em>
  29438. </td>
  29439. <td>
  29440. <p>Vault path to obtain the dynamic secret from</p>
  29441. </td>
  29442. </tr>
  29443. <tr>
  29444. <td>
  29445. <code>allowEmptyResponse</code></br>
  29446. <em>
  29447. bool
  29448. </em>
  29449. </td>
  29450. <td>
  29451. <em>(Optional)</em>
  29452. <p>Do not fail if no secrets are found. Useful for requests where no data is expected.</p>
  29453. </td>
  29454. </tr>
  29455. </tbody>
  29456. </table>
  29457. <h3 id="generators.external-secrets.io/v1alpha1.Webhook">Webhook
  29458. </h3>
  29459. <p>
  29460. <p>Webhook connects to a third party API server to handle the secrets generation
  29461. configuration parameters in spec.
  29462. You can specify the server, the token, and additional body parameters.
  29463. See documentation for the full API specification for requests and responses.</p>
  29464. </p>
  29465. <table>
  29466. <thead>
  29467. <tr>
  29468. <th>Field</th>
  29469. <th>Description</th>
  29470. </tr>
  29471. </thead>
  29472. <tbody>
  29473. <tr>
  29474. <td>
  29475. <code>metadata</code></br>
  29476. <em>
  29477. <a href="https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
  29478. Kubernetes meta/v1.ObjectMeta
  29479. </a>
  29480. </em>
  29481. </td>
  29482. <td>
  29483. Refer to the Kubernetes API documentation for the fields of the
  29484. <code>metadata</code> field.
  29485. </td>
  29486. </tr>
  29487. <tr>
  29488. <td>
  29489. <code>spec</code></br>
  29490. <em>
  29491. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">
  29492. WebhookSpec
  29493. </a>
  29494. </em>
  29495. </td>
  29496. <td>
  29497. <br/>
  29498. <br/>
  29499. <table>
  29500. <tr>
  29501. <td>
  29502. <code>method</code></br>
  29503. <em>
  29504. string
  29505. </em>
  29506. </td>
  29507. <td>
  29508. <p>Webhook Method</p>
  29509. </td>
  29510. </tr>
  29511. <tr>
  29512. <td>
  29513. <code>url</code></br>
  29514. <em>
  29515. string
  29516. </em>
  29517. </td>
  29518. <td>
  29519. <p>Webhook url to call</p>
  29520. </td>
  29521. </tr>
  29522. <tr>
  29523. <td>
  29524. <code>headers</code></br>
  29525. <em>
  29526. map[string]string
  29527. </em>
  29528. </td>
  29529. <td>
  29530. <em>(Optional)</em>
  29531. <p>Headers</p>
  29532. </td>
  29533. </tr>
  29534. <tr>
  29535. <td>
  29536. <code>auth</code></br>
  29537. <em>
  29538. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  29539. AuthorizationProtocol
  29540. </a>
  29541. </em>
  29542. </td>
  29543. <td>
  29544. <em>(Optional)</em>
  29545. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  29546. </td>
  29547. </tr>
  29548. <tr>
  29549. <td>
  29550. <code>body</code></br>
  29551. <em>
  29552. string
  29553. </em>
  29554. </td>
  29555. <td>
  29556. <em>(Optional)</em>
  29557. <p>Body</p>
  29558. </td>
  29559. </tr>
  29560. <tr>
  29561. <td>
  29562. <code>timeout</code></br>
  29563. <em>
  29564. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  29565. Kubernetes meta/v1.Duration
  29566. </a>
  29567. </em>
  29568. </td>
  29569. <td>
  29570. <em>(Optional)</em>
  29571. <p>Timeout</p>
  29572. </td>
  29573. </tr>
  29574. <tr>
  29575. <td>
  29576. <code>result</code></br>
  29577. <em>
  29578. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  29579. WebhookResult
  29580. </a>
  29581. </em>
  29582. </td>
  29583. <td>
  29584. <p>Result formatting</p>
  29585. </td>
  29586. </tr>
  29587. <tr>
  29588. <td>
  29589. <code>secrets</code></br>
  29590. <em>
  29591. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  29592. []WebhookSecret
  29593. </a>
  29594. </em>
  29595. </td>
  29596. <td>
  29597. <em>(Optional)</em>
  29598. <p>Secrets to fill in templates
  29599. These secrets will be passed to the templating function as key value pairs under the given name</p>
  29600. </td>
  29601. </tr>
  29602. <tr>
  29603. <td>
  29604. <code>caBundle</code></br>
  29605. <em>
  29606. []byte
  29607. </em>
  29608. </td>
  29609. <td>
  29610. <em>(Optional)</em>
  29611. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  29612. if the Server URL is using HTTPS protocol. This parameter is ignored for
  29613. plain HTTP protocol connection. If not set the system root certificates
  29614. are used to validate the TLS connection.</p>
  29615. </td>
  29616. </tr>
  29617. <tr>
  29618. <td>
  29619. <code>caProvider</code></br>
  29620. <em>
  29621. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  29622. WebhookCAProvider
  29623. </a>
  29624. </em>
  29625. </td>
  29626. <td>
  29627. <em>(Optional)</em>
  29628. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  29629. </td>
  29630. </tr>
  29631. </table>
  29632. </td>
  29633. </tr>
  29634. </tbody>
  29635. </table>
  29636. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider
  29637. </h3>
  29638. <p>
  29639. (<em>Appears on:</em>
  29640. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  29641. </p>
  29642. <p>
  29643. <p>WebhookCAProvider defines a location to fetch the cert for the webhook provider from.</p>
  29644. </p>
  29645. <table>
  29646. <thead>
  29647. <tr>
  29648. <th>Field</th>
  29649. <th>Description</th>
  29650. </tr>
  29651. </thead>
  29652. <tbody>
  29653. <tr>
  29654. <td>
  29655. <code>type</code></br>
  29656. <em>
  29657. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProviderType">
  29658. WebhookCAProviderType
  29659. </a>
  29660. </em>
  29661. </td>
  29662. <td>
  29663. <p>The type of provider to use such as &ldquo;Secret&rdquo;, or &ldquo;ConfigMap&rdquo;.</p>
  29664. </td>
  29665. </tr>
  29666. <tr>
  29667. <td>
  29668. <code>name</code></br>
  29669. <em>
  29670. string
  29671. </em>
  29672. </td>
  29673. <td>
  29674. <p>The name of the object located at the provider type.</p>
  29675. </td>
  29676. </tr>
  29677. <tr>
  29678. <td>
  29679. <code>key</code></br>
  29680. <em>
  29681. string
  29682. </em>
  29683. </td>
  29684. <td>
  29685. <p>The key where the CA certificate can be found in the Secret or ConfigMap.</p>
  29686. </td>
  29687. </tr>
  29688. <tr>
  29689. <td>
  29690. <code>namespace</code></br>
  29691. <em>
  29692. string
  29693. </em>
  29694. </td>
  29695. <td>
  29696. <em>(Optional)</em>
  29697. <p>The namespace the Provider type is in.</p>
  29698. </td>
  29699. </tr>
  29700. </tbody>
  29701. </table>
  29702. <h3 id="generators.external-secrets.io/v1alpha1.WebhookCAProviderType">WebhookCAProviderType
  29703. (<code>string</code> alias)</p></h3>
  29704. <p>
  29705. (<em>Appears on:</em>
  29706. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">WebhookCAProvider</a>)
  29707. </p>
  29708. <p>
  29709. <p>WebhookCAProviderType defines the type of provider for webhook CA certificates.</p>
  29710. </p>
  29711. <table>
  29712. <thead>
  29713. <tr>
  29714. <th>Value</th>
  29715. <th>Description</th>
  29716. </tr>
  29717. </thead>
  29718. <tbody><tr><td><p>&#34;ConfigMap&#34;</p></td>
  29719. <td><p>WebhookCAProviderTypeConfigMap indicates the CA provider is a ConfigMap resource.</p>
  29720. </td>
  29721. </tr><tr><td><p>&#34;Secret&#34;</p></td>
  29722. <td><p>WebhookCAProviderTypeSecret indicates the CA provider is a Secret resource.</p>
  29723. </td>
  29724. </tr></tbody>
  29725. </table>
  29726. <h3 id="generators.external-secrets.io/v1alpha1.WebhookResult">WebhookResult
  29727. </h3>
  29728. <p>
  29729. (<em>Appears on:</em>
  29730. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  29731. </p>
  29732. <p>
  29733. <p>WebhookResult defines how to format and extract results from the webhook response.</p>
  29734. </p>
  29735. <table>
  29736. <thead>
  29737. <tr>
  29738. <th>Field</th>
  29739. <th>Description</th>
  29740. </tr>
  29741. </thead>
  29742. <tbody>
  29743. <tr>
  29744. <td>
  29745. <code>jsonPath</code></br>
  29746. <em>
  29747. string
  29748. </em>
  29749. </td>
  29750. <td>
  29751. <em>(Optional)</em>
  29752. <p>Json path of return value</p>
  29753. </td>
  29754. </tr>
  29755. </tbody>
  29756. </table>
  29757. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSecret">WebhookSecret
  29758. </h3>
  29759. <p>
  29760. (<em>Appears on:</em>
  29761. <a href="#generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec</a>)
  29762. </p>
  29763. <p>
  29764. <p>WebhookSecret defines a secret reference that will be used in webhook templates.</p>
  29765. </p>
  29766. <table>
  29767. <thead>
  29768. <tr>
  29769. <th>Field</th>
  29770. <th>Description</th>
  29771. </tr>
  29772. </thead>
  29773. <tbody>
  29774. <tr>
  29775. <td>
  29776. <code>name</code></br>
  29777. <em>
  29778. string
  29779. </em>
  29780. </td>
  29781. <td>
  29782. <p>Name of this secret in templates</p>
  29783. </td>
  29784. </tr>
  29785. <tr>
  29786. <td>
  29787. <code>secretRef</code></br>
  29788. <em>
  29789. <a href="#generators.external-secrets.io/v1alpha1.SecretKeySelector">
  29790. SecretKeySelector
  29791. </a>
  29792. </em>
  29793. </td>
  29794. <td>
  29795. <p>Secret ref to fill in credentials</p>
  29796. </td>
  29797. </tr>
  29798. </tbody>
  29799. </table>
  29800. <h3 id="generators.external-secrets.io/v1alpha1.WebhookSpec">WebhookSpec
  29801. </h3>
  29802. <p>
  29803. (<em>Appears on:</em>
  29804. <a href="#generators.external-secrets.io/v1alpha1.GeneratorSpec">GeneratorSpec</a>,
  29805. <a href="#generators.external-secrets.io/v1alpha1.Webhook">Webhook</a>)
  29806. </p>
  29807. <p>
  29808. <p>WebhookSpec controls the behavior of the external generator. Any body parameters should be passed to the server through the parameters field.</p>
  29809. </p>
  29810. <table>
  29811. <thead>
  29812. <tr>
  29813. <th>Field</th>
  29814. <th>Description</th>
  29815. </tr>
  29816. </thead>
  29817. <tbody>
  29818. <tr>
  29819. <td>
  29820. <code>method</code></br>
  29821. <em>
  29822. string
  29823. </em>
  29824. </td>
  29825. <td>
  29826. <p>Webhook Method</p>
  29827. </td>
  29828. </tr>
  29829. <tr>
  29830. <td>
  29831. <code>url</code></br>
  29832. <em>
  29833. string
  29834. </em>
  29835. </td>
  29836. <td>
  29837. <p>Webhook url to call</p>
  29838. </td>
  29839. </tr>
  29840. <tr>
  29841. <td>
  29842. <code>headers</code></br>
  29843. <em>
  29844. map[string]string
  29845. </em>
  29846. </td>
  29847. <td>
  29848. <em>(Optional)</em>
  29849. <p>Headers</p>
  29850. </td>
  29851. </tr>
  29852. <tr>
  29853. <td>
  29854. <code>auth</code></br>
  29855. <em>
  29856. <a href="#generators.external-secrets.io/v1alpha1.AuthorizationProtocol">
  29857. AuthorizationProtocol
  29858. </a>
  29859. </em>
  29860. </td>
  29861. <td>
  29862. <em>(Optional)</em>
  29863. <p>Auth specifies a authorization protocol. Only one protocol may be set.</p>
  29864. </td>
  29865. </tr>
  29866. <tr>
  29867. <td>
  29868. <code>body</code></br>
  29869. <em>
  29870. string
  29871. </em>
  29872. </td>
  29873. <td>
  29874. <em>(Optional)</em>
  29875. <p>Body</p>
  29876. </td>
  29877. </tr>
  29878. <tr>
  29879. <td>
  29880. <code>timeout</code></br>
  29881. <em>
  29882. <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration">
  29883. Kubernetes meta/v1.Duration
  29884. </a>
  29885. </em>
  29886. </td>
  29887. <td>
  29888. <em>(Optional)</em>
  29889. <p>Timeout</p>
  29890. </td>
  29891. </tr>
  29892. <tr>
  29893. <td>
  29894. <code>result</code></br>
  29895. <em>
  29896. <a href="#generators.external-secrets.io/v1alpha1.WebhookResult">
  29897. WebhookResult
  29898. </a>
  29899. </em>
  29900. </td>
  29901. <td>
  29902. <p>Result formatting</p>
  29903. </td>
  29904. </tr>
  29905. <tr>
  29906. <td>
  29907. <code>secrets</code></br>
  29908. <em>
  29909. <a href="#generators.external-secrets.io/v1alpha1.WebhookSecret">
  29910. []WebhookSecret
  29911. </a>
  29912. </em>
  29913. </td>
  29914. <td>
  29915. <em>(Optional)</em>
  29916. <p>Secrets to fill in templates
  29917. These secrets will be passed to the templating function as key value pairs under the given name</p>
  29918. </td>
  29919. </tr>
  29920. <tr>
  29921. <td>
  29922. <code>caBundle</code></br>
  29923. <em>
  29924. []byte
  29925. </em>
  29926. </td>
  29927. <td>
  29928. <em>(Optional)</em>
  29929. <p>PEM encoded CA bundle used to validate webhook server certificate. Only used
  29930. if the Server URL is using HTTPS protocol. This parameter is ignored for
  29931. plain HTTP protocol connection. If not set the system root certificates
  29932. are used to validate the TLS connection.</p>
  29933. </td>
  29934. </tr>
  29935. <tr>
  29936. <td>
  29937. <code>caProvider</code></br>
  29938. <em>
  29939. <a href="#generators.external-secrets.io/v1alpha1.WebhookCAProvider">
  29940. WebhookCAProvider
  29941. </a>
  29942. </em>
  29943. </td>
  29944. <td>
  29945. <em>(Optional)</em>
  29946. <p>The provider for the CA bundle to use to validate webhook server certificate.</p>
  29947. </td>
  29948. </tr>
  29949. </tbody>
  29950. </table>
  29951. <hr/>
  29952. <p><em>
  29953. Generated with <code>gen-crd-api-reference-docs</code>.
  29954. </em></p>
  29955. </article>
  29956. </div>
  29957. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  29958. </div>
  29959. </main>
  29960. <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""/>
  29961. <footer class="md-footer">
  29962. <div class="md-footer-meta md-typeset">
  29963. <div class="md-footer-meta__inner md-grid">
  29964. <div class="md-copyright">
  29965. <div class="md-copyright__highlight">
  29966. &copy; 2025 The external-secrets Authors.<br/>
  29967. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  29968. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  29969. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  29970. </div>
  29971. Made with
  29972. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  29973. Material for MkDocs
  29974. </a>
  29975. </div>
  29976. </div>
  29977. </div>
  29978. </footer>
  29979. </div>
  29980. <div class="md-dialog" data-md-component="dialog">
  29981. <div class="md-dialog__inner md-typeset"></div>
  29982. </div>
  29983. <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>
  29984. <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
  29985. </body>
  29986. </html>