5:[["$","div",null,{"className":"docs-layout-default docs-content","children":["$","$L1f",null,{"value":[{"value":"Language support","id":"language-support","depth":2},{"value":"Example: Bearer authentication","id":"example-bearer-authentication","depth":2}],"children":[["$","$L20",null,{}],["$","$L21",null,{"metadata":{"title":"Security callbacks","filePath":"src/content/docs/customize/authentication/security-callbacks.mdx","slug":"/security-callbacks","sidebar_label":"Customize Authentication","description":"Customize security and authentication SDK settings for OAuth.","timestamp":1746647952000},"bottomContent":"$undefined","children":[["$","div",null,{"id":"nextra-skip-nav"}],["$","main",null,{"data-pagefind-body":true,"children":[false,false,false,[["$","h1",null,{"id":"$undefined","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-bold x:mt-2 x:text-4xl","children":["Security callbacks","$undefined"]}],"\n",["$","$L22",null,{"as":"p","children":"Instead of providing credentials once during SDK instantiation, pass a custom authentication function that allows end users to manage secrets dynamically. Custom authentication functions can be used to automatically refresh tokens or retrieve secrets from a secret store."}],"\n",["$","h2",null,{"id":"language-support","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Language support",["$","$L23",null,{"id":"language-support"}]]}],"\n",["$","$L24",null,{"data":[{"language":"TypeScript","status":"✅"},{"language":"Python","status":"✅"},{"language":"Go","status":"✅"},{"language":"C#","status":"✅"},{"language":"Java","status":"✅"},{"language":"PHP","status":"✅"},{"language":"Swift","status":"🏗️"},{"language":"Ruby","status":"✅"}],"columns":[{"key":"language","header":"Language"},{"key":"status","header":"Status"}]}],"\n",["$","h2",null,{"id":"example-bearer-authentication","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Example: Bearer authentication",["$","$L23",null,{"id":"example-bearer-authentication"}]]}],"\n",["$","$L22",null,{"as":"p","children":"In this example, bearer authentication is used as the only security scheme:"}],"\n",["$","$L25",null,{"codeblock":{"value":"security:\n - bearerAuth: []\ncomponents:\n securitySchemes:\n bearerAuth:\n type: http\n scheme: bearer","lang":"yaml","meta":"","code":"security:\n - bearerAuth: []\ncomponents:\n securitySchemes:\n bearerAuth:\n type: http\n scheme: bearer","tokens":[["security","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["bearerAuth","#F92672"],[": []","#F8F8F2"],"\n",["components","#F92672"],[":","#F8F8F2"],"\n ",["securitySchemes","#F92672"],[":","#F8F8F2"],"\n ",["bearerAuth","#F92672"],[":","#F8F8F2"],"\n ",["type","#F92672"],[":","#F8F8F2"]," ",["http","#E6DB74"],"\n ",["scheme","#F92672"],[":","#F8F8F2"]," ",["bearer","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L22",null,{"as":"p","children":["The callback function passed when initializing the SDK acts as a ",["$","em",null,{"children":"security source"}]," and is called whenever a request is made, allowing tokens to be refreshed if needed."]}],"\n",["$","$L26",null,{"children":"$undefined","title":"","_data":{"header":""},"tabs":[{"value":"import { SDK } from \"\";\nimport { Security } from \"/models\";\n\nconst sdk = new SDK({\n security: async (): Promise => {\n // refresh token here\n const token = \"\";\n return { bearerAuth: token };\n },\n});","lang":"typescript","meta":"TypeScript","code":"import { SDK } from \"\";\nimport { Security } from \"/models\";\n\nconst sdk = new SDK({\n security: async (): Promise => {\n // refresh token here\n const token = \"\";\n return { bearerAuth: token };\n },\n});","tokens":[["import","#F92672"]," ",["{ SDK }","#F8F8F2"]," ",["from","#F92672"]," ",["\"\"","#E6DB74"],[";","#F8F8F2"],"\n",["import","#F92672"]," ",["{ Security }","#F8F8F2"]," ",["from","#F92672"]," ",["\"/models\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["sdk","#F8F8F2"]," ",["= new","#F92672"]," ",["SDK","#A6E22E"],["({","#F8F8F2"],"\n ",["security","#A6E22E"],[":","#F8F8F2"]," ",["async","#F92672"]," ",["()","#F8F8F2"],[":","#F92672"]," ",["Promise","#A6E22E",{"textDecoration":"underline"}],["<","#F8F8F2"],["Security","#A6E22E",{"textDecoration":"underline"}],[">","#F8F8F2"]," ",["=>","#66D9EF",{"fontStyle":"italic"}]," ",["{","#F8F8F2"],"\n ",["// refresh token here","#88846F"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["token","#F8F8F2"]," ",["=","#F92672"]," ",["\"\"","#E6DB74"],[";","#F8F8F2"],"\n ",["return","#F92672"]," ",["{ bearerAuth: token };","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n",["});","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}},{"value":"import requests\nimport sdk\nfrom sdk.components import Security\n\ndef callback() -> Security:\n # refresh token here\n token = \"\"\n return Security(bearer_auth=token)\n\ns = sdk.SDK(security=with_authorization(callback))","lang":"python","meta":"Python","code":"import requests\nimport sdk\nfrom sdk.components import Security\n\ndef callback() -> Security:\n # refresh token here\n token = \"\"\n return Security(bearer_auth=token)\n\ns = sdk.SDK(security=with_authorization(callback))","tokens":[["import","#F92672"]," ",["requests","#F8F8F2"],"\n",["import","#F92672"]," ",["sdk","#F8F8F2"],"\n",["from","#F92672"]," ",["sdk.components","#F8F8F2"]," ",["import","#F92672"]," ",["Security","#F8F8F2"],"\n\n",["def","#66D9EF",{"fontStyle":"italic"}]," ",["callback","#A6E22E"],["() -> Security:","#F8F8F2"],"\n ",["# refresh token here","#88846F"],"\n ",["token","#F8F8F2"]," ",["=","#F92672"]," ",["\"\"","#E6DB74"],"\n ",["return","#F92672"]," ",["Security(","#F8F8F2"],["bearer_auth","#FD971F",{"fontStyle":"italic"}],["=","#F92672"],["token)","#F8F8F2"],"\n\n",["s","#F8F8F2"]," ",["=","#F92672"]," ",["sdk.SDK(","#F8F8F2"],["security","#FD971F",{"fontStyle":"italic"}],["=","#F92672"],["with_authorization(callback))","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}},{"value":"import (\n\t\"context\"\n sdk \"speakeasy\"\n\t\"speakeasy/components\"\n)\n\ns := sdk.New(\n sdk.WithSecuritySource(func(ctx context.Context) (components.Security, error) {\n // refresh token here\n token := \"\"\n return components.Security{BearerAuth: token}, nil\n }),\n)","lang":"go","meta":"Go","code":"import (\n\t\"context\"\n sdk \"speakeasy\"\n\t\"speakeasy/components\"\n)\n\ns := sdk.New(\n sdk.WithSecuritySource(func(ctx context.Context) (components.Security, error) {\n // refresh token here\n token := \"\"\n return components.Security{BearerAuth: token}, nil\n }),\n)","tokens":[["import","#F92672"]," ",["(","#F8F8F2"],"\n\t",["\"context\"","#E6DB74"],"\n ",["sdk","#F8F8F2"]," ",["\"speakeasy\"","#E6DB74"],"\n\t",["\"speakeasy/components\"","#E6DB74"],"\n",[")","#F8F8F2"],"\n\n",["s","#F8F8F2"]," ",[":=","#F92672"]," ",["sdk.","#F8F8F2"],["New","#A6E22E"],["(","#F8F8F2"],"\n ",["sdk.","#F8F8F2"],["WithSecuritySource","#A6E22E"],["(","#F8F8F2"],["func","#F92672"],["(","#F8F8F2"],["ctx","#FD971F",{"fontStyle":"italic"}]," ",["context","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Context","#A6E22E",{"textDecoration":"underline"}],[") (","#F8F8F2"],["components","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Security","#A6E22E",{"textDecoration":"underline"}],[",","#F8F8F2"]," ",["error","#66D9EF",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["// refresh token here","#88846F"],"\n ",["token","#F8F8F2"]," ",[":=","#F92672"]," ",["\"\"","#E6DB74"],"\n ",["return","#F92672"]," ",["components","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Security","#A6E22E",{"textDecoration":"underline"}],["{BearerAuth: token},","#F8F8F2"]," ",["nil","#AE81FF"],"\n ",["}),","#F8F8F2"],"\n",[")","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}},{"value":"import dev.speakeasyapi.speakeasy.SDK;\nimport dev.speakeasyapi.speakeasy.SecuritySource;\nimport dev.speakeasyapi.speakeasy.models.components.Security;\n\n\nclass BearerSource implements SecuritySource {\n\n public Security getSecurity() {\n // refresh token here\n return Security.builder()\n .bearerAuth(\"\")\n .build();\n }\n}\n\n_____________________________________\n\n\nimport dev.speakeasyapi.speakeasy.SDK;\nimport dev.speakeasyapi.speakeasy.SecuritySource;\nimport dev.speakeasyapi.speakeasy.models.components.Security;\n\nSDK s = SDK.builder()\n .securitySource(new BearerSource())\n .build();","lang":"java","meta":"Java","code":"import dev.speakeasyapi.speakeasy.SDK;\nimport dev.speakeasyapi.speakeasy.SecuritySource;\nimport dev.speakeasyapi.speakeasy.models.components.Security;\n\n\nclass BearerSource implements SecuritySource {\n\n public Security getSecurity() {\n // refresh token here\n return Security.builder()\n .bearerAuth(\"\")\n .build();\n }\n}\n\n_____________________________________\n\n\nimport dev.speakeasyapi.speakeasy.SDK;\nimport dev.speakeasyapi.speakeasy.SecuritySource;\nimport dev.speakeasyapi.speakeasy.models.components.Security;\n\nSDK s = SDK.builder()\n .securitySource(new BearerSource())\n .build();","tokens":[["import dev.speakeasyapi.speakeasy.SDK","#F92672"],[";","#F8F8F2"],"\n",["import dev.speakeasyapi.speakeasy.SecuritySource","#F92672"],[";","#F8F8F2"],"\n",["import dev.speakeasyapi.speakeasy.models.components.Security","#F92672"],[";","#F8F8F2"],"\n\n\n",["class","#F92672"]," ",["BearerSource","#A6E22E",{"textDecoration":"underline"}]," ",["implements","#F92672"]," ",["SecuritySource","#A6E22E",{"fontStyle":"italic","textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n\n ",["public","#F92672"]," ",["Security","#66D9EF",{"fontStyle":"italic"}]," ",["getSecurity","#A6E22E"],["() {","#F8F8F2"],"\n ",["// refresh token here","#88846F"],"\n ",["return","#F92672"]," ",["Security.","#F8F8F2"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["bearerAuth","#A6E22E"],["(","#F8F8F2"],["\"\"","#E6DB74"],[")","#F8F8F2"],"\n ",[".","#F8F8F2"],["build","#A6E22E"],["();","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"],"\n\n",["_____________________________________","#66D9EF",{"fontStyle":"italic"}],"\n\n\n",["import dev.speakeasyapi.speakeasy.SDK","#F92672"],[";","#F8F8F2"],"\n",["import dev.speakeasyapi.speakeasy.SecuritySource","#F92672"],[";","#F8F8F2"],"\n",["import dev.speakeasyapi.speakeasy.models.components.Security","#F92672"],[";","#F8F8F2"],"\n\n",["SDK","#66D9EF",{"fontStyle":"italic"}]," ",["s","#F8F8F2"]," ",["=","#F92672"]," ",["SDK.","#F8F8F2"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",[".","#F8F8F2"],["securitySource","#A6E22E"],["(","#F8F8F2"],["new","#F92672"]," ",["BearerSource","#A6E22E"],["())","#F8F8F2"],"\n ",[".","#F8F8F2"],["build","#A6E22E"],["();","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}},{"value":"using Speakeasy;\nusing Speakeasy.Models.Components;\n\n\nFunc tokenSource = () =>\n{\n // refresh token here\n var token = \"\"\n\n return new Security { BearerAuth = token}\n}\n\nvar sdk = new SDK(securitySource: tokenSource);","lang":"csharp","meta":"C#","code":"using Speakeasy;\nusing Speakeasy.Models.Components;\n\n\nFunc tokenSource = () =>\n{\n // refresh token here\n var token = \"\"\n\n return new Security { BearerAuth = token}\n}\n\nvar sdk = new SDK(securitySource: tokenSource);","tokens":[["using","#F92672"]," ",["Speakeasy","#A6E22E",{"textDecoration":"underline"}],[";","#F8F8F2"],"\n",["using","#F92672"]," ",["Speakeasy","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Models","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Components","#A6E22E",{"textDecoration":"underline"}],[";","#F8F8F2"],"\n\n\n",["Func","#A6E22E",{"textDecoration":"underline"}],["<","#F8F8F2"],["Security","#A6E22E",{"textDecoration":"underline"}],["> tokenSource","#F8F8F2"]," ",["=","#F92672"]," ",["()","#F8F8F2"]," ",["=>","#F92672"],"\n",["{","#F8F8F2"],"\n ",["// refresh token here","#88846F"],"\n ",["var","#66D9EF",{"fontStyle":"italic"}]," ",["token","#F8F8F2"]," ",["=","#F92672"]," ",["\"\"","#E6DB74"],"\n\n ",["return","#F8F8F2"]," ",["new","#F92672"]," ",["Security","#A6E22E",{"textDecoration":"underline"}]," ",["{ BearerAuth","#F8F8F2"]," ",["=","#F92672"]," ",["token}","#F8F8F2"],"\n",["}","#F8F8F2"],"\n\n",["var sdk = new SDK(securitySource: tokenSource);","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}},{"value":"use Speakeasy\\Speakeasy;\n\n$sdk = Speakeasy\\SDK::builder()\n ->setSecuritySource(\n function (): Security {\n //refresh token here\n var token = \"\";\n\n return new Security(bearerAuth: $token);\n }\n )->build();\n\ntry {\n $res = $sdk->drinks->listDrinks();\n\n if ($res->Drinks != null) {\n // handle response\n }\n} catch (Errors\\ErrorThrowable $e) {\n // handle exception\n}","lang":"php","meta":"PHP","code":"use Speakeasy\\Speakeasy;\n\n$sdk = Speakeasy\\SDK::builder()\n ->setSecuritySource(\n function (): Security {\n //refresh token here\n var token = \"\";\n\n return new Security(bearerAuth: $token);\n }\n )->build();\n\ntry {\n $res = $sdk->drinks->listDrinks();\n\n if ($res->Drinks != null) {\n // handle response\n }\n} catch (Errors\\ErrorThrowable $e) {\n // handle exception\n}","tokens":[["use","#F92672"]," ",["Speakeasy\\","#F8F8F2"],["Speakeasy","#66D9EF",{"fontStyle":"italic"}],[";","#F8F8F2"],"\n\n",["$$sdk","#F8F8F2"]," ",["=","#F92672"]," ",["Speakeasy\\","#F8F8F2"],["SDK","#66D9EF",{"fontStyle":"italic"}],["::","#F92672"],["builder","#A6E22E"],["()","#F8F8F2"],"\n ",["->","#F92672"],["setSecuritySource","#A6E22E"],["(","#F8F8F2"],"\n ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["()","#F8F8F2"],[":","#F92672"]," ",["Security","#66D9EF",{"fontStyle":"italic"}]," ",["{","#F8F8F2"],"\n ",["//refresh token here","#88846F"],"\n ",["var","#66D9EF",{"fontStyle":"italic"}]," ",["token","#AE81FF"]," ",["=","#F92672"]," ",["\"\"","#E6DB74"],[";","#F8F8F2"],"\n\n ",["return new","#F92672"]," ",["Security","#66D9EF",{"fontStyle":"italic"}],["(","#F8F8F2"],["bearerAuth","#AE81FF"],[": $token);","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",[")","#F8F8F2"],["->","#F92672"],["build","#A6E22E"],["();","#F8F8F2"],"\n\n",["try","#F92672"]," ",["{","#F8F8F2"],"\n ",["$$res","#F8F8F2"]," ",["=","#F92672"]," ",["$$sdk","#F8F8F2"],["->","#F92672"],["drinks","#F8F8F2"],["->","#F92672"],["listDrinks","#A6E22E"],["();","#F8F8F2"],"\n\n ",["if","#F92672"]," ",["($res","#F8F8F2"],["->","#F92672"],["Drinks","#F8F8F2"]," ",["!=","#F92672"]," ",["null","#AE81FF"],[") {","#F8F8F2"],"\n ",["// handle response","#88846F"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"]," ",["catch","#F92672"]," ",["(Errors\\","#F8F8F2"],["ErrorThrowable","#66D9EF",{"fontStyle":"italic"}]," ",["$$e) {","#F8F8F2"],"\n ",["// handle exception","#88846F"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}},{"value":"require 'speakeasy'\n\nsdk = Speakeasy::SDK.new(\n security_source: -> {\n # Refresh token here\n token = ''\n\n Models::Components::Security.new(bearer_auth: token)\n }\n)\n\nres = sdk.drinks.list_drinks","lang":"ruby","meta":"Ruby","code":"require 'speakeasy'\n\nsdk = Speakeasy::SDK.new(\n security_source: -> {\n # Refresh token here\n token = ''\n\n Models::Components::Security.new(bearer_auth: token)\n }\n)\n\nres = sdk.drinks.list_drinks","tokens":[["require","#F92672"]," ",["'speakeasy'","#E6DB74"],"\n\n",["sdk","#F8F8F2"]," ",["=","#F92672"]," ",["Speakeasy","#66D9EF",{"fontStyle":"italic"}],["::","#F8F8F2"],["SDK","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["new","#F92672"],["(","#F8F8F2"],"\n ",["security_source:","#AE81FF"]," ",["->","#66D9EF"]," ",["{","#F8F8F2"],"\n ",["# Refresh token here","#88846F"],"\n ",["token","#F8F8F2"]," ",["=","#F92672"]," ",["''","#E6DB74"],"\n\n ",["Models","#66D9EF",{"fontStyle":"italic"}],["::","#F8F8F2"],["Components","#66D9EF",{"fontStyle":"italic"}],["::","#F8F8F2"],["Security","#66D9EF",{"fontStyle":"italic"}],[".","#F8F8F2"],["new","#F92672"],["(","#F8F8F2"],["bearer_auth:","#AE81FF"]," ",["token)","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",[")","#F8F8F2"],"\n\n",["res","#F8F8F2"]," ",["=","#F92672"]," ",["sdk.drinks.list_drinks","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}]}]]]}]]}]]}]}],false]