[{"data":1,"prerenderedAt":404},["ShallowReactive",2],{"navigation_docs":3,"-compliance-network-access":160,"-compliance-network-access-surround":399},[4,21,62,82,103,149],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":20},"Get Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-play-circle",false,{"title":22,"icon":23,"path":24,"stem":25,"children":26,"page":20},"Gateway","i-lucide-network","\u002Fgateway","2.gateway",[27,32,37,42,47,52,57],{"title":28,"path":29,"stem":30,"icon":31},"Overview","\u002Fgateway\u002Foverview","2.gateway\u002F1.overview","i-lucide-waypoints",{"title":33,"path":34,"stem":35,"icon":36},"Models and Routing","\u002Fgateway\u002Fmodels-and-routing","2.gateway\u002F2.models-and-routing","i-lucide-brain",{"title":38,"path":39,"stem":40,"icon":41},"Smart Router","\u002Fgateway\u002Fsmart-routing","2.gateway\u002F3.smart-routing","i-lucide-route",{"title":43,"path":44,"stem":45,"icon":46},"Context Engine","\u002Fgateway\u002Fcontext-engine","2.gateway\u002F4.context-engine","i-product-context-engine",{"title":48,"path":49,"stem":50,"icon":51},"Data Integrations","\u002Fgateway\u002Fdata-integrations","2.gateway\u002F5.data-integrations","i-lucide-database",{"title":53,"path":54,"stem":55,"icon":56},"Tools","\u002Fgateway\u002Ftools","2.gateway\u002F6.tools","i-lucide-wrench",{"title":58,"path":59,"stem":60,"icon":61},"Guardrails","\u002Fgateway\u002Fguardrails","2.gateway\u002F7.guardrails","i-lucide-shield-alert",{"title":63,"icon":64,"path":65,"stem":66,"children":67,"page":20},"Compliance","i-lucide-shield-check","\u002Fcompliance","3.compliance",[68,72,77],{"title":69,"path":70,"stem":71,"icon":64},"Data Governance","\u002Fcompliance\u002Fdata-governance","3.compliance\u002F01.data-governance",{"title":73,"path":74,"stem":75,"icon":76},"Network Access","\u002Fcompliance\u002Fnetwork-access","3.compliance\u002F02.network-access","i-lucide-lock",{"title":78,"path":79,"stem":80,"icon":81},"Audit Logs","\u002Fcompliance\u002Faudit-logs","3.compliance\u002F03.audit-logs","i-lucide-scroll-text",{"title":83,"icon":84,"path":85,"stem":86,"children":87,"page":20},"Observability","i-lucide-eye","\u002Fobservability","4.observability",[88,93,98],{"title":89,"path":90,"stem":91,"icon":92},"Organization","\u002Fobservability\u002Forganization","4.observability\u002F1.organization","i-lucide-building-2",{"title":94,"path":95,"stem":96,"icon":97},"Application","\u002Fobservability\u002Fapplication","4.observability\u002F2.application","i-lucide-activity",{"title":99,"path":100,"stem":101,"icon":102},"Metrics","\u002Fobservability\u002Fmetrics","4.observability\u002F3.metrics","i-lucide-bar-chart-2",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":20},"Administration","i-lucide-settings","\u002Fadministration","5.administration",[109,114,119,129,144],{"title":110,"path":111,"stem":112,"icon":113},"Organization and Projects","\u002Fadministration\u002Forganizations-and-projects","5.administration\u002F1.organizations-and-projects","i-lucide-box",{"title":115,"path":116,"stem":117,"icon":118},"Members and Access","\u002Fadministration\u002Fmembers-and-access","5.administration\u002F2.members-and-access","i-lucide-shield-user",{"title":120,"path":121,"stem":122,"children":123,"icon":76},"Authentication","\u002Fadministration\u002Fauthentication","5.administration\u002F3.authentication",[124],{"title":125,"path":126,"stem":127,"icon":128},"Connect Model APIs","\u002Fadministration\u002Fauthentication\u002Fconnect-model-apis","5.administration\u002F3.authentication\u002F31.connect-model-apis","i-lucide-cpu",{"title":130,"path":131,"stem":132,"children":133,"icon":143},"Connections","\u002Fadministration\u002Fconnections","5.administration\u002F4.connections",[134,139],{"title":135,"path":136,"stem":137,"icon":138},"Connect MCP Servers","\u002Fadministration\u002Fconnections\u002Fmcp-connections","5.administration\u002F4.connections\u002F42.mcp-connections","i-lucide-plug",{"title":140,"path":141,"stem":142,"icon":51},"Connect Data Sources","\u002Fadministration\u002Fconnections\u002Fdata-sources-connections","5.administration\u002F4.connections\u002F43.data-sources-connections","i-lucide-link",{"title":145,"path":146,"stem":147,"icon":148},"Budgets","\u002Fadministration\u002Fbudgets","5.administration\u002F5.budgets","i-lucide-wallet",{"title":150,"icon":151,"path":152,"stem":153,"children":154,"page":20},"Reference","i-lucide-book-open","\u002Freference","6.reference",[155],{"title":156,"path":157,"stem":158,"icon":159},"Using the API","\u002Freference\u002Fapi-usage","6.reference\u002F1.api-usage","i-lucide-terminal-square",{"id":161,"title":73,"body":162,"description":392,"extension":393,"links":394,"meta":395,"navigation":396,"path":74,"seo":397,"stem":75,"__hash__":398},"docs\u002F3.compliance\u002F02.network-access.md",{"type":163,"value":164,"toc":378},"minimark",[165,169,175,180,183,206,210,217,229,234,237,241,244,258,261,265,268,272,294,300,303,307,352,356],[166,167,168],"p",{},"Network Access limits which IP addresses can call the Gateway. Requests from anywhere else are rejected before they reach a model or a tool, even when they carry a valid application API key.",[170,171,174],"who-panel",{":applies-to":172,":roles":173},"[\"LLM requests\", \"Tool calls\"]","[\"Organization Admin\"]","Organization Admins create IP allowlists and choose which projects and applications each one covers. Applications can't opt out of an allowlist that covers them.",[176,177,179],"h2",{"id":178},"why-use-it","Why use it",[166,181,182],{},"Use Network Access when applications should accept Gateway requests only from known networks, such as your corporate VPN or production servers.",[184,185,186,194,200],"ul",{},[187,188,189,193],"li",{},[190,191,192],"strong",{},"A second factor for every request."," A caller needs both a valid key and an allowed network.",[187,195,196,199],{},[190,197,198],{},"Enforced centrally."," The rule lives in Optiak, not in each application, and no application can bypass it.",[187,201,202,205],{},[190,203,204],{},"Scoped to what needs it."," Lock down production applications without blocking teams experimenting elsewhere.",[176,207,209],{"id":208},"how-it-works","How it works",[166,211,212,213,216],{},"After the ",[214,215,22],"a",{"href":29}," identifies the application from its API key, it checks the address the request comes from against every allowlist that covers that application. This happens before guardrails, model choice or any tool call, for every endpoint of the OpenAI-compatible API and for the MCP endpoint.",[166,218,219,220,224,225,228],{},"If at least one allowlist covers the application but the address matches none of them, the Gateway rejects the request with ",[221,222,223],"code",{},"403 Forbidden"," and the message ",[221,226,227],{},"Request originates from an IP address outside the organization's allowed range."," No model or tool is called.",[230,231,233],"h3",{"id":232},"ip-allowlists","IP allowlists",[166,235,236],{},"An allowlist is a named list of IPv4 or IPv6 addresses and CIDR ranges. Include the public IP addresses the Gateway sees when your applications connect, such as your office or VPN's outbound address, your NAT gateway's public address or your servers' public IPs. Give each allowlist a name your team recognizes, such as \"Corporate VPN\" or \"Production cluster\", and a description of where it applies.",[230,238,240],{"id":239},"scope","Scope",[166,242,243],{},"Each allowlist applies to one of these:",[184,245,246,252],{},[187,247,248,251],{},[190,249,250],{},"The whole organization:"," every application, including those created later.",[187,253,254,257],{},[190,255,256],{},"Selected projects and applications:"," choose projects, individual applications or both. The allowlist covers every selected application and every application in the selected projects, including applications created in those projects later.",[166,259,260],{},"An application that no allowlist covers accepts requests from any address.",[230,262,264],{"id":263},"several-allowlists","Several allowlists",[166,266,267],{},"When more than one allowlist covers an application, a request is allowed if its address matches any of them. Each allowlist adds trusted networks; none of them narrows another. For example, an organization-wide \"Corporate VPN\" allowlist and a \"CI runners\" allowlist on one project let that project's applications accept traffic from both.",[176,269,271],{"id":270},"set-it-up","Set it up",[166,273,274,275,278,279,282,283,286,287,290,291,293],{},"In the console, open ",[190,276,277],{},"Company setup",", then ",[190,280,281],{},"Security",", and select ",[190,284,285],{},"Create allowlist",". Give it a name, enter one address or range per line under ",[190,288,289],{},"Allowed IP ranges"," and choose its ",[190,292,240],{},".",[295,296,299],"callout",{"color":297,"icon":298},"warning","i-lucide-triangle-alert","An allowlist takes effect as soon as you save it. Before you scope one to the whole organization, list every place that calls the Gateway, such as servers, CI jobs, developer machines and MCP clients, and include their addresses. Consider starting with a single project to confirm your traffic still gets through.",[166,301,302],{},"The console itself isn't affected by allowlists, so you can always edit or delete one that blocks traffic it shouldn't.",[176,304,306],{"id":305},"limits-and-behavior","Limits and behavior",[184,308,309,327,337,343],{},[187,310,311,314,315,318,319,322,323,326],{},[190,312,313],{},"Ranges use the network address."," ",[221,316,317],{},"203.0.113.0\u002F24"," is valid; ",[221,320,321],{},"203.0.113.5\u002F24"," is rejected when you save. A range that covers every address, such as ",[221,324,325],{},"0.0.0.0\u002F0",", and duplicate entries are rejected too.",[187,328,329,332,333,336],{},[190,330,331],{},"Write IPv4 addresses in plain form"," (",[221,334,335],{},"10.0.0.0\u002F8","), not as IPv4-mapped IPv6 ranges.",[187,338,339,342],{},[190,340,341],{},"Deleting an allowlist"," stops enforcing it immediately. If it was the only one covering an application, that application accepts requests from any address again.",[187,344,345,348,349,351],{},[190,346,347],{},"Every change is recorded"," in ",[214,350,78],{"href":79},", with who made it and when.",[176,353,355],{"id":354},"related","Related",[184,357,358,363,368,373],{},[187,359,360,362],{},[214,361,69],{"href":70},": control where requests are processed.",[187,364,365,367],{},[214,366,120],{"href":121},": create and revoke application API keys.",[187,369,370,372],{},[214,371,110],{"href":111},": how projects group applications.",[187,374,375,377],{},[214,376,156],{"href":157},": endpoints and error responses.",{"title":379,"searchDepth":380,"depth":380,"links":381},"",2,[382,383,389,390,391],{"id":178,"depth":380,"text":179},{"id":208,"depth":380,"text":209,"children":384},[385,387,388],{"id":232,"depth":386,"text":233},3,{"id":239,"depth":386,"text":240},{"id":263,"depth":386,"text":264},{"id":270,"depth":380,"text":271},{"id":305,"depth":380,"text":306},{"id":354,"depth":380,"text":355},"Accept Gateway traffic only from the networks you trust.","md",null,{},{"icon":76},{"title":73,"description":392},"teoZ85AQtU321IOEQwTQ1ur60bT4obOEKCrqIz2LHRU",[400,402],{"title":69,"path":70,"stem":71,"description":401,"icon":64,"children":-1},"Define how your organization's data is handled across AI applications.",{"title":78,"path":79,"stem":80,"description":403,"icon":81,"children":-1},"See who changed what in your organization, and when.",1795006122389]