Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.
AuthForge supports per-app access control lists for HWIDs and IP addresses. Use them to block pirated copies, restrict beta access, or geo-limit your application.
How it works
The same access-list check runs on both public auth endpoints:
/auth/validate (login): the requesting HWID and source IP are checked before the license itself is looked up, so a blocked device never learns whether the key is valid.
/auth/heartbeat (online check-ins): every check-in re-checks the HWID and the current source IP against the lists as they are now. A device blacklisted after login, a whitelist tightened mid-session, or a session that moved to a different IP is rejected at its next check-in, not only at the next login.
List changes therefore take effect at the next online check-in for apps with check-ins enabled, and at session expiry (up to the configured TTL) otherwise, when the SDK has to call /auth/validate again.
Evaluation order
IP blacklist: If the IP is blacklisted, reject immediately.
IP whitelist: If the IP whitelist has any entries and the IP is NOT on it, reject.
HWID blacklist: If the HWID is blacklisted, reject.
HWID whitelist: If the HWID whitelist has any entries and the HWID is NOT on it, reject.
IP lists are evaluated before HWID lists; the first failing step decides the result.Blacklist takes precedence over whitelist. Within each type the blacklist is checked first, so an entry that appears on both lists is blocked. Whitelisting a value never overrides a blacklist entry.An empty whitelist means allowlist mode is off. With no entries, every value of that type is allowed (subject to the blacklist). Adding the first entry turns allowlist mode on for that type; removing the last entry turns it off again. The IP and HWID whitelists are independent: you can restrict IPs without restricting HWIDs, and vice versa.Matching is exact. Values are compared as exact strings: no CIDR ranges, wildcards, or case folding. The HWID must match the exact string your SDK sends, and the IP must match the exact address AuthForge sees as the source.When a request is rejected, the auth log records blocked with one of these detail values so you can see which list matched: ip blacklisted, ip not whitelisted, hwid blacklisted, hwid not whitelisted.
HWID blacklist
Block specific hardware IDs from authenticating. The HWID is the SHA-256 hash the SDK collects from the user’s machine.Use cases:
Block a known pirated/cracked machine fingerprint
Revoke access from a specific device without revoking the entire license
# Add an HWID to the blacklistcurl -X POST https://api.authforge.cc/v1/apps/YOUR_APP_ID/security/blacklist \ -H "Authorization: Bearer af_live_your_key" \ -H "Content-Type: application/json" \ -d '{ "type": "hwid", "value": "a1b2c3d4e5f6..." }'
HWID whitelist
When set, only listed HWIDs can authenticate. This is allowlist mode; any HWID not on the list is rejected.Use cases:
Restrict a beta to specific testers’ machines
Lock down access to known-good devices in an enterprise deployment
Enabling a HWID whitelist blocks ALL devices not explicitly listed. Make sure you’ve added all expected HWIDs before enabling.
IP blacklist
Block specific IP addresses from authenticating.Use cases:
Block IPs associated with abuse
Block known VPN/proxy exit IPs (each address is listed individually; ranges are not supported)
IP whitelist
When set, only listed IPs can authenticate. Useful for enterprise environments where users connect from known office IPs.
Configuration
Via the dashboard
Go to your app’s Settings → Security. You’ll see four sections for each list type. Add entries and click Save.
256 bytes (UTF-8); SDK-generated HWIDs are 64 characters
IP value max length
45 characters (supports IPv6)
Error response
When a request is blocked by a blacklist or whitelist, the SDK receives:
{ "status": "failed", "error": "blocked"}
On /auth/validate the SDK treats this as a login failure. On a check-in it is a definitive failure: the SDK clears the stored session, stops background checks, and calls your failure callback. See SDK Best Practices for guidance on user-facing error messages.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AuthForge","colors":{"primary":"#1f6b48","light":"#5cb88a","dark":"#134d34"},"logo":{"light":"https://mintcdn.com/authforgecc/KRDLNWRNnoEj8xz_/logo/light.svg?fit=max\u0026auto=format\u0026n=KRDLNWRNnoEj8xz_\u0026q=85\u0026s=e3d282ac0ceef243415c618c49967bf0","dark":"https://mintcdn.com/authforgecc/KRDLNWRNnoEj8xz_/logo/dark.svg?fit=max\u0026auto=format\u0026n=KRDLNWRNnoEj8xz_\u0026q=85\u0026s=f34361dd4c122caf69639ee63e12170b"},"favicon":"https://mintcdn.com/authforgecc/KRDLNWRNnoEj8xz_/favicon.svg?fit=max\u0026auto=format\u0026n=KRDLNWRNnoEj8xz_\u0026q=85\u0026s=b4ab07a93f36d82891c7174b025d3bd2","navbar":{"links":[{"href":"https://app.authforge.cc/dashboard","label":"Dashboard"},{"href":"https://status.authforge.cc","label":"Status"}],"primary":{"type":"button","label":"Get Started","href":"https://app.authforge.cc/auth"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"authforgecc","hasAudioNarration":false,"actualSubdomain":"authforgecc","customDomains":["docs.authforge.cc"],"gitSource":{"type":"github","owner":"authforgecc","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeb75eadfc350f7e13fcefb","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"Features","count":22},{"language":"default","tag":"SDKs","count":16},{"language":"default","tag":"Guides","count":13},{"language":"default","tag":"Integration Guides","count":13},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"API Reference","count":6},{"language":"default","tag":"Developer API","count":6},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Best Practices","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"features/security","slug":"/features/security","pageMetadata":{"title":"Blacklists \u0026 Whitelists","description":"Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.","href":"/features/security"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Mermaid,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`AuthForge supports per-app access control lists for HWIDs and IP addresses. Use them to block pirated copies, restrict beta access, or geo-limit your application.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How it works`}),`\n`,_jsx(_components.p,{children:`The same access-list check runs on both public auth endpoints:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`/auth/validate`}),` (login)`]}),`: the requesting HWID and source IP are checked `,_jsx(_components.strong,{children:`before`}),` the license itself is looked up, so a blocked device never learns whether the key is valid.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`/auth/heartbeat`}),` (online check-ins)`]}),`: every check-in re-checks the HWID and the `,_jsx(_components.strong,{children:`current`}),` source IP against the lists as they are now. A device blacklisted after login, a whitelist tightened mid-session, or a session that moved to a different IP is rejected at its next check-in, not only at the next login.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`List changes therefore take effect at the next online check-in for apps with check-ins enabled, and at session expiry (up to the configured TTL) otherwise, when the SDK has to call `,_jsx(_components.code,{children:`/auth/validate`}),` again.`]}),`\n`,_jsx(Mermaid,{chart:`flowchart TD\n A[\"SDK sends /auth/validate or /auth/heartbeat\"] --> B{\"IP blacklisted?\"}\n B -->|Yes| X[\"Reject: blocked\"]\n B -->|No| C{\"IP whitelist non-empty?\"}\n C -->|Yes, IP not listed| X\n C -->|No, or IP listed| D{\"HWID blacklisted?\"}\n D -->|Yes| X\n D -->|No| E{\"HWID whitelist non-empty?\"}\n E -->|Yes, HWID not listed| X\n E -->|No, or HWID listed| F[\"Continue to license checks\"]`}),`\n`,_jsx(Heading,{level:`3`,id:`evaluation-order`,children:`Evaluation order`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IP blacklist`}),`: If the IP is blacklisted, reject immediately.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IP whitelist`}),`: If the IP whitelist has any entries and the IP is NOT on it, reject.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`HWID blacklist`}),`: If the HWID is blacklisted, reject.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`HWID whitelist`}),`: If the HWID whitelist has any entries and the HWID is NOT on it, reject.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`IP lists are evaluated before HWID lists; the first failing step decides the result.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Blacklist takes precedence over whitelist.`}),` Within each type the blacklist is checked first, so an entry that appears on both lists is blocked. Whitelisting a value never overrides a blacklist entry.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`An empty whitelist means allowlist mode is off.`}),` With no entries, every value of that type is allowed (subject to the blacklist). Adding the first entry turns allowlist mode on for that type; removing the last entry turns it off again. The IP and HWID whitelists are independent: you can restrict IPs without restricting HWIDs, and vice versa.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Matching is exact.`}),` Values are compared as exact strings: no CIDR ranges, wildcards, or case folding. The HWID must match the exact string your SDK sends, and the IP must match the exact address AuthForge sees as the source.`]}),`\n`,_jsxs(_components.p,{children:[`When a request is rejected, the auth log records `,_jsx(_components.code,{children:`blocked`}),` with one of these `,_jsx(_components.code,{children:`detail`}),` values so you can see which list matched: `,_jsx(_components.code,{children:`ip blacklisted`}),`, `,_jsx(_components.code,{children:`ip not whitelisted`}),`, `,_jsx(_components.code,{children:`hwid blacklisted`}),`, `,_jsx(_components.code,{children:`hwid not whitelisted`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`hwid-blacklist`,children:`HWID blacklist`}),`\n`,_jsx(_components.p,{children:`Block specific hardware IDs from authenticating. The HWID is the SHA-256 hash the SDK collects from the user’s machine.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Use cases:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Block a known pirated/cracked machine fingerprint`}),`\n`,_jsx(_components.li,{children:`Revoke access from a specific device without revoking the entire license`}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Add an HWID to the blacklist`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.authforge.cc/v1/apps/YOUR_APP_ID/security/blacklist`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer af_live_your_key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"type\": \"hwid\", \"value\": \"a1b2c3d4e5f6...\" }'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`hwid-whitelist`,children:`HWID whitelist`}),`\n`,_jsxs(_components.p,{children:[`When set, `,_jsx(_components.strong,{children:`only`}),` listed HWIDs can authenticate. This is allowlist mode; any HWID not on the list is rejected.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Use cases:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Restrict a beta to specific testers’ machines`}),`\n`,_jsx(_components.li,{children:`Lock down access to known-good devices in an enterprise deployment`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Enabling a HWID whitelist blocks ALL devices not explicitly listed. Make sure you’ve added all expected HWIDs before enabling.`})}),`\n`,_jsx(Heading,{level:`2`,id:`ip-blacklist`,children:`IP blacklist`}),`\n`,_jsx(_components.p,{children:`Block specific IP addresses from authenticating.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Use cases:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Block IPs associated with abuse`}),`\n`,_jsx(_components.li,{children:`Block known VPN/proxy exit IPs (each address is listed individually; ranges are not supported)`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`ip-whitelist`,children:`IP whitelist`}),`\n`,_jsx(_components.p,{children:`When set, only listed IPs can authenticate. Useful for enterprise environments where users connect from known office IPs.`}),`\n`,_jsx(Heading,{level:`2`,id:`configuration`,children:`Configuration`}),`\n`,_jsx(Heading,{level:`3`,id:`via-the-dashboard`,children:`Via the dashboard`}),`\n`,_jsxs(_components.p,{children:[`Go to your app’s `,_jsx(_components.strong,{children:`Settings`}),` → `,_jsx(_components.strong,{children:`Security`}),`. You’ll see four sections for each list type. Add entries and click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`via-the-developer-api`,children:`Via the Developer API`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Get current security config:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.authforge.cc/v1/apps/YOUR_APP_ID/security`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer af_live_your_key\"`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"hwidBlacklist\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a1b2c3d4...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"hwidWhitelist\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ipBlacklist\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"203.0.113.50\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ipWhitelist\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: []`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Replace entire security config:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PUT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.authforge.cc/v1/apps/YOUR_APP_ID/security`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer af_live_your_key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"hwidBlacklist\": [\"a1b2c3d4...\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ipBlacklist\": [\"203.0.113.50\", \"198.51.100.0\"]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`You can include only the lists you want to update; omitted lists remain unchanged.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Add/remove individual entries:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`17`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Add to blacklist`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.authforge.cc/v1/apps/YOUR_APP_ID/security/blacklist`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer af_live_your_key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"type\": \"hwid\", \"value\": \"a1b2c3d4...\" }'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Remove from blacklist`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` DELETE`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.authforge.cc/v1/apps/YOUR_APP_ID/security/blacklist`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer af_live_your_key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"type\": \"hwid\", \"value\": \"a1b2c3d4...\" }'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Add to whitelist`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.authforge.cc/v1/apps/YOUR_APP_ID/security/whitelist`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer af_live_your_key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"type\": \"ip\", \"value\": \"203.0.113.50\" }'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`limits`,children:`Limits`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Limit`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Max entries per list`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`500`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`HWID value max length`}),_jsx(_components.td,{children:`256 bytes (UTF-8); SDK-generated HWIDs are 64 characters`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`IP value max length`}),_jsx(_components.td,{children:`45 characters (supports IPv6)`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`error-response`,children:`Error response`}),`\n`,_jsx(_components.p,{children:`When a request is blocked by a blacklist or whitelist, the SDK receives:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"blocked\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`On `,_jsx(_components.code,{children:`/auth/validate`}),` the SDK treats this as a login failure. On a check-in it is a definitive failure: the SDK clears the stored session, stops background checks, and calls your failure callback. See `,_jsx(_components.a,{href:`/sdk/best-practices#error-handling-on-login`,children:`SDK Best Practices`}),` for guidance on user-facing error messages.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api/security`,children:`Security API Reference`}),`; Full endpoint documentation`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/best-practices/security`,children:`Security Best Practices`}),`; Hardening your AuthForge integration`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Blacklists \u0026 Whitelists","description":"Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.","href":"/features/security"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How it works","slug":"how-it-works","depth":2,"children":[{"title":"Evaluation order","slug":"evaluation-order","depth":3,"children":[]}]},{"title":"HWID blacklist","slug":"hwid-blacklist","depth":2,"children":[]},{"title":"HWID whitelist","slug":"hwid-whitelist","depth":2,"children":[]},{"title":"IP blacklist","slug":"ip-blacklist","depth":2,"children":[]},{"title":"IP whitelist","slug":"ip-whitelist","depth":2,"children":[]},{"title":"Configuration","slug":"configuration","depth":2,"children":[{"title":"Via the dashboard","slug":"via-the-dashboard","depth":3,"children":[]},{"title":"Via the Developer API","slug":"via-the-developer-api","depth":3,"children":[]}]},{"title":"Limits","slug":"limits","depth":2,"children":[]},{"title":"Error response","slug":"error-response","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"authforgecc","siteName":"AuthForge","title":"Blacklists \u0026 Whitelists - AuthForge","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-25T17:55:26.472Z","originalFileLocation":"features/security.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AuthForge\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Blacklists \u0026amp; Whitelists - AuthForge\">\u003cmeta data-mint-head property=\"og:description\" content=\"Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AuthForge\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.authforge.cc/features/security\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://authforgecc.mintlify.site/_mintlify/api/og/v2?division=Features\u0026amp;title=Blacklists+%26+Whitelists\u0026amp;description=Control+which+devices+and+IPs+can+authenticate+with+your+AuthForge+app+using+blacklists+and+whitelists.\u0026amp;theme=c4b8c63f42d8cccd512734b4\u0026amp;signature=83c44956de94e53d7661a5b7049e5084dad0eae34ec09749c2882b0f142e74c8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Blacklists \u0026amp; Whitelists - AuthForge\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://authforgecc.mintlify.site/_mintlify/api/og/v2?division=Features\u0026amp;title=Blacklists+%26+Whitelists\u0026amp;description=Control+which+devices+and+IPs+can+authenticate+with+your+AuthForge+app+using+blacklists+and+whitelists.\u0026amp;theme=c4b8c63f42d8cccd512734b4\u0026amp;signature=83c44956de94e53d7661a5b7049e5084dad0eae34ec09749c2882b0f142e74c8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/authforgecc/hub06gHkeGgP0WJt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AuthForge\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1f6b48\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.authforge.cc/features/security\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/features/security.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.authforge.cc/#organization\",\"name\":\"AuthForge\",\"url\":\"https://docs.authforge.cc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/authforgecc/KRDLNWRNnoEj8xz_/logo/light.svg?fit=max\u0026auto=format\u0026n=KRDLNWRNnoEj8xz_\u0026q=85\u0026s=e3d282ac0ceef243415c618c49967bf0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.authforge.cc#website\",\"name\":\"AuthForge\",\"url\":\"https://docs.authforge.cc\",\"publisher\":{\"@id\":\"https://docs.authforge.cc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.authforge.cc/features/security#webpage\",\"url\":\"https://docs.authforge.cc/features/security\",\"name\":\"Blacklists \u0026 Whitelists\",\"description\":\"Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.\",\"dateModified\":\"2026-09-25T17:55:26.472Z\",\"isPartOf\":{\"@id\":\"https://docs.authforge.cc#website\"},\"breadcrumb\":{\"@id\":\"https://docs.authforge.cc/features/security#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.authforge.cc/features/security#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Features\",\"item\":\"https://docs.authforge.cc/features/commerce\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Blacklists \u0026 Whitelists\",\"item\":\"https://docs.authforge.cc/features/security\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.authforge.cc/features/security#article\",\"headline\":\"Blacklists \u0026 Whitelists\",\"name\":\"Blacklists \u0026 Whitelists\",\"description\":\"Control which devices and IPs can authenticate with your AuthForge app using blacklists and whitelists.\",\"url\":\"https://docs.authforge.cc/features/security\",\"mainEntityOfPage\":{\"@id\":\"https://docs.authforge.cc/features/security#webpage\"},\"dateModified\":\"2026-09-25T17:55:26.472Z\",\"publisher\":{\"@id\":\"https://docs.authforge.cc/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.authforge.cc#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AuthForge\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"AuthForge\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/features/security.md","siteName":"AuthForge","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdk/overview"}]},{"tab":"Features","groups":[{"group":"Features","pages":[{"title":"Commerce","href":"/features/commerce"},{"title":"Self-service portal","href":"/features/portal"},{"title":"App \u0026 License Variables","href":"/features/variables"},{"title":"Webhooks","description":"Receive real-time HTTP notifications when license events occur in your AuthForge app.","href":"/features/webhooks"},{"title":"Blacklists \u0026 Whitelists","href":"/features/security"},{"title":"Hardware locking (HWID)","description":"How AuthForge binds licenses to machines and how the SDK derives the HWID.","href":"/features/hwid-locking"},{"title":"Unlimited-seat licenses","href":"/features/unlimited-seats"},{"title":"HWID override","href":"/features/hwid-override"},{"title":"Offline license files (.authforge)","href":"/features/offline-license-files"},{"title":"Low-latency validation","href":"/features/low-latency-validation"},{"title":"Unlimited applications","href":"/features/unlimited-applications"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/ai-development"}]}]},"basePath":"","title":"Blacklists \u0026 Whitelists - AuthForge","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":[],"chunks":[]}