[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78WVQPTPCC8S7FYNC2JNFGP":3,"skill-same:01M78WVQPTPCC8S7FYNC2JNFGP":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":40,"updatedAt":41,"install":42,"resources":55},"01M78WVQPTPCC8S7FYNC2JNFGP","algolia-security-basics",null,"Apply Algolia security best practices: API key scoping, secured API keys,\nfrontend vs backend key separation, and key rotation.\nTrigger: \"algolia security\", \"algolia API key security\", \"secure algolia\",\n\"algolia secrets\", \"algolia key rotation\", \"algolia secured key\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--algolia-pack--algolia-security-basics\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: algolia-security-basics\ndescription: |\n  Apply Algolia security best practices: API key scoping, secured API keys,\n  frontend vs backend key separation, and key rotation.\n  Trigger: \"algolia security\", \"algolia API key security\", \"secure algolia\",\n  \"algolia secrets\", \"algolia key rotation\", \"algolia secured key\".\nallowed-tools: Read, Write, Edit, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, search, algolia]\ncompatible-with: claude-code\n---\n\n# Algolia Security Basics\n\n## Overview\n\nAlgolia's security model is built around **scoped API keys**. Every Algolia app has three default keys (Admin, Search-Only, Monitoring). For production, create custom keys with minimal permissions and use Secured API Keys for per-user\u002Fper-tenant restrictions.\n\n## Key Types and Where to Use Them\n\n| Key Type | ACL | Expose to Frontend? | Use Case |\n|----------|-----|---------------------|----------|\n| Admin | All operations | **NEVER** | Backend indexing, settings, key management |\n| Search-Only | `search` only | Yes (safe) | Frontend search widgets |\n| Monitoring | Read monitoring data | No | Health checks, dashboards |\n| Custom | You define ACL | Depends on ACL | Scoped backend services |\n| Secured | Derived from parent key | Yes | Per-user filtered search |\n\n## Instructions\n\n### Step 1: Environment Variable Setup\n\n```bash\n# .env (NEVER commit — add to .gitignore)\nALGOLIA_APP_ID=YourApplicationID\nALGOLIA_ADMIN_KEY=admin_api_key_here        # Backend only\nALGOLIA_SEARCH_KEY=search_only_key_here     # OK for frontend\n\n# .gitignore — MUST include:\n.env\n.env.local\n.env.*.local\n```\n\n### Step 2: Create Scoped API Keys\n\n```typescript\nimport { algoliasearch } from 'algoliasearch';\n\nconst client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!);\n\n\u002F\u002F Create a write-only key for a specific microservice\nconst { key: indexingKey } = await client.addApiKey({\n  apiKey: {\n    acl: ['addObject', 'deleteObject', 'editSettings'],\n    description: 'Product sync service — write only',\n    indexes: ['products', 'products_staging'],  \u002F\u002F Restrict to specific indices\n    maxQueriesPerIPPerHour: 5000,\n    referers: [],  \u002F\u002F Empty = no referer restriction (backend use)\n  },\n});\n\n\u002F\u002F Create a search key restricted to specific referers (frontend)\nconst { key: frontendKey } = await client.addApiKey({\n  apiKey: {\n    acl: ['search'],\n    description: 'Frontend search — domain-restricted',\n    indexes: ['products'],\n    referers: ['https:\u002F\u002Fmystore.com\u002F*', 'https:\u002F\u002F*.mystore.com\u002F*'],\n    maxQueriesPerIPPerHour: 1000,\n    maxHitsPerQuery: 50,\n  },\n});\n```\n\n### Step 3: Generate Secured API Keys (Per-User Filtering)\n\n```typescript\n\u002F\u002F Secured API keys are generated on YOUR server, not via Algolia API.\n\u002F\u002F They embed restrictions that the client can't bypass.\n\nfunction generateUserSearchKey(userId: string, tenantId: string): string {\n  const client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!);\n\n  return client.generateSecuredApiKey({\n    parentApiKey: process.env.ALGOLIA_SEARCH_KEY!,\n    restrictions: {\n      \u002F\u002F User can only see their tenant's data\n      filters: `tenant_id:${tenantId}`,\n      \u002F\u002F Key expires in 1 hour\n      validUntil: Math.floor(Date.now() \u002F 1000) + 3600,\n      \u002F\u002F Restrict to specific indices\n      restrictIndices: ['products'],\n      \u002F\u002F Optional: restrict sources (IPs)\n      restrictSources: '',\n    },\n  });\n}\n\n\u002F\u002F Usage in your API endpoint:\n\u002F\u002F const userKey = generateUserSearchKey(req.user.id, req.user.tenantId);\n\u002F\u002F return { appId: process.env.ALGOLIA_APP_ID, searchKey: userKey };\n```\n\n### Step 4: Key Rotation Procedure\n\n```typescript\nasync function rotateApiKey(oldKeyDescription: string) {\n  const client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!);\n\n  \u002F\u002F 1. List keys to find the old one\n  const { keys } = await client.listApiKeys();\n  const oldKey = keys.find(k => k.description === oldKeyDescription);\n  if (!oldKey) throw new Error(`Key not found: ${oldKeyDescription}`);\n\n  \u002F\u002F 2. Create new key with same ACL\n  const { key: newKey } = await client.addApiKey({\n    apiKey: {\n      acl: oldKey.acl,\n      description: `${oldKeyDescription} (rotated ${new Date().toISOString().split('T')[0]})`,\n      indexes: oldKey.indexes || [],\n      maxQueriesPerIPPerHour: oldKey.maxQueriesPerIPPerHour || 0,\n      referers: oldKey.referers || [],\n    },\n  });\n\n  console.log(`New key created: ...${newKey.slice(-8)}`);\n  console.log('Update your env vars, then delete the old key:');\n  console.log(`  client.deleteApiKey({ key: '${oldKey.value}' })`);\n\n  return newKey;\n}\n```\n\n## Security Checklist\n\n- [ ] Admin key in env vars, never in frontend code or git\n- [ ] `.env` files in `.gitignore`\n- [ ] Frontend uses Search-Only or Secured API key\n- [ ] Custom keys have minimal ACL (least privilege)\n- [ ] `referers` set on frontend keys to prevent abuse\n- [ ] `maxQueriesPerIPPerHour` set on all public keys\n- [ ] Secured API keys have `validUntil` (expiration)\n- [ ] Key rotation scheduled quarterly\n- [ ] Git history scanned for accidentally committed keys\n\n## Error Handling\n\n| Security Issue | Detection | Mitigation |\n|----------------|-----------|------------|\n| Admin key exposed in frontend | Code review, git scanning | Rotate immediately, restrict referers |\n| Key in git history | `git log -S 'ALGOLIA'` | Rotate key, use git-secrets or gitleaks |\n| Excessive ACL on key | Audit key permissions | Create scoped replacement key |\n| Expired secured key | `validUntil` in the past | Generate fresh secured key |\n\n## Resources\n\n- [API Keys Guide](https:\u002F\u002Fwww.algolia.com\u002Fdoc\u002Fguides\u002Fsecurity\u002Fapi-keys\u002F)\n- [Secured API Keys](https:\u002F\u002Fwww.algolia.com\u002Fdoc\u002Fguides\u002Fsecurity\u002Fapi-keys\u002Fin-depth\u002Fsecured-api-keys\u002F)\n- [API Key Restrictions](https:\u002F\u002Fwww.algolia.com\u002Fdoc\u002Fguides\u002Fsecurity\u002Fapi-keys\u002Fin-depth\u002Fapi-key-restrictions\u002F)\n\n## Next Steps\n\nFor production deployment, see `algolia-prod-checklist`.\n","# Algolia Security Basics\n\n## Overview\n\nAlgolia's security model is built around **scoped API keys**. Every Algolia app has three default keys (Admin, Search-Only, Monitoring). For production, create custom keys with minimal permissions and use Secured API Keys for per-user\u002Fper-tenant restrictions.\n\n## Key Types and Where to Use Them\n\n| Key Type | ACL | Expose to Frontend? | Use Case |\n|----------|-----|---------------------|----------|\n| Admin | All operations | **NEVER** | Backend indexing, settings, key management |\n| Search-Only | `search` only | Yes (safe) | Frontend search widgets |\n| Monitoring | Read monitoring data | No | Health checks, dashboards |\n| Custom | You define ACL | Depends on ACL | Scoped backend services |\n| Secured | Derived from parent key | Yes | Per-user filtered search |\n\n## Instructions\n\n### Step 1: Environment Variable Setup\n\n```bash\n# .env (NEVER commit — add to .gitignore)\nALGOLIA_APP_ID=YourApplicationID\nALGOLIA_ADMIN_KEY=admin_api_key_here        # Backend only\nALGOLIA_SEARCH_KEY=search_only_key_here     # OK for frontend\n\n# .gitignore — MUST include:\n.env\n.env.local\n.env.*.local\n```\n\n### Step 2: Create Scoped API Keys\n\n```typescript\nimport { algoliasearch } from 'algoliasearch';\n\nconst client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!);\n\n\u002F\u002F Create a write-only key for a specific microservice\nconst { key: indexingKey } = await client.addApiKey({\n  apiKey: {\n    acl: ['addObject', 'deleteObject', 'editSettings'],\n    description: 'Product sync service — write only',\n    indexes: ['products', 'products_staging'],  \u002F\u002F Restrict to specific indices\n    maxQueriesPerIPPerHour: 5000,\n    referers: [],  \u002F\u002F Empty = no referer restriction (backend use)\n  },\n});\n\n\u002F\u002F Create a search key restricted to specific referers (frontend)\nconst { key: frontendKey } = await client.addApiKey({\n  apiKey: {\n    acl: ['search'],\n    description: 'Frontend search — domain-restricted',\n    indexes: ['products'],\n    referers: ['https:\u002F\u002Fmystore.com\u002F*', 'https:\u002F\u002F*.mystore.com\u002F*'],\n    maxQueriesPerIPPerHour: 1000,\n    maxHitsPerQuery: 50,\n  },\n});\n```\n\n### Step 3: Generate Secured API Keys (Per-User Filtering)\n\n```typescript\n\u002F\u002F Secured API keys are generated on YOUR server, not via Algolia API.\n\u002F\u002F They embed restrictions that the client can't bypass.\n\nfunction generateUserSearchKey(userId: string, tenantId: string): string {\n  const client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!);\n\n  return client.generateSecuredApiKey({\n    parentApiKey: process.env.ALGOLIA_SEARCH_KEY!,\n    restrictions: {\n      \u002F\u002F User can only see their tenant's data\n      filters: `tenant_id:${tenantId}`,\n      \u002F\u002F Key expires in 1 hour\n      validUntil: Math.floor(Date.now() \u002F 1000) + 3600,\n      \u002F\u002F Restrict to specific indices\n      restrictIndices: ['products'],\n      \u002F\u002F Optional: restrict sources (IPs)\n      restrictSources: '',\n    },\n  });\n}\n\n\u002F\u002F Usage in your API endpoint:\n\u002F\u002F const userKey = generateUserSearchKey(req.user.id, req.user.tenantId);\n\u002F\u002F return { appId: process.env.ALGOLIA_APP_ID, searchKey: userKey };\n```\n\n### Step 4: Key Rotation Procedure\n\n```typescript\nasync function rotateApiKey(oldKeyDescription: string) {\n  const client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!);\n\n  \u002F\u002F 1. List keys to find the old one\n  const { keys } = await client.listApiKeys();\n  const oldKey = keys.find(k => k.description === oldKeyDescription);\n  if (!oldKey) throw new Error(`Key not found: ${oldKeyDescription}`);\n\n  \u002F\u002F 2. Create new key with same ACL\n  const { key: newKey } = await client.addApiKey({\n    apiKey: {\n      acl: oldKey.acl,\n      description: `${oldKeyDescription} (rotated ${new Date().toISOString().split('T')[0]})`,\n      indexes: oldKey.indexes || [],\n      maxQueriesPerIPPerHour: oldKey.maxQueriesPerIPPerHour || 0,\n      referers: oldKey.referers || [],\n    },\n  });\n\n  console.log(`New key created: ...${newKey.slice(-8)}`);\n  console.log('Update your env vars, then delete the old key:');\n  console.log(`  client.deleteApiKey({ key: '${oldKey.value}' })`);\n\n  return newKey;\n}\n```\n\n## Security Checklist\n\n- [ ] Admin key in env vars, never in frontend code or git\n- [ ] `.env` files in `.gitignore`\n- [ ] Frontend uses Search-Only or Secured API key\n- [ ] Custom keys have minimal ACL (least privilege)\n- [ ] `referers` set on frontend keys to prevent abuse\n- [ ] `maxQueriesPerIPPerHour` set on all public keys\n- [ ] Secured API keys have `validUntil` (expiration)\n- [ ] Key rotation scheduled quarterly\n- [ ] Git history scanned for accidentally committed keys\n\n## Error Handling\n\n| Security Issue | Detection | Mitigation |\n|----------------|-----------|------------|\n| Admin key exposed in frontend | Code review, git scanning | Rotate immediately, restrict referers |\n| Key in git history | `git log -S 'ALGOLIA'` | Rotate key, use git-secrets or gitleaks |\n| Excessive ACL on key | Audit key permissions | Create scoped replacement key |\n| Expired secured key | `validUntil` in the past | Generate fresh secured key |\n\n## Resources\n\n- [API Keys Guide](https:\u002F\u002Fwww.algolia.com\u002Fdoc\u002Fguides\u002Fsecurity\u002Fapi-keys\u002F)\n- [Secured API Keys](https:\u002F\u002Fwww.algolia.com\u002Fdoc\u002Fguides\u002Fsecurity\u002Fapi-keys\u002Fin-depth\u002Fsecured-api-keys\u002F)\n- [API Key Restrictions](https:\u002F\u002Fwww.algolia.com\u002Fdoc\u002Fguides\u002Fsecurity\u002Fapi-keys\u002Fin-depth\u002Fapi-key-restrictions\u002F)\n\n## Next Steps\n\nFor production deployment, see `algolia-prod-checklist`.\n",{"name":5,"tags":24,"author":28,"license":15,"version":29,"description":30,"allowed-tools":31,"compatible-with":32},[25,26,27],"saas","search","algolia","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Apply Algolia security best practices: API key scoping, secured API keys,\nfrontend vs backend key separation, and key rotation.\nTrigger: \"algolia security\", \"algolia API key security\", \"secure algolia\",\n\"algolia secrets\", \"algolia key rotation\", \"algolia secured key\".\n","Read, Write, Edit, Grep","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--algolia-pack--algolia-security-basics",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill algolia-security-basics",{"tool":48,"command":49},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill algolia-security-basics",{"tool":51,"command":52},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill algolia-security-basics","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--algolia-pack--algolia-security-basics\u002FSKILL.md",true,[],[57,64,71,78,85,93],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]