[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F84RQZNXVSRRH1SPFHF0KY":3,"skill-same:01M6F84RQZNXVSRRH1SPFHF0KY":79},{"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":23,"publishedAt":47,"linkOnly":48,"markdownContent":49,"markdownBody":50,"frontMatter":51,"refName":56,"commitSha":57,"skillDirectory":58,"forksCount":59,"repositoryHtmlUrl":60,"repositoryHomepageUrl":6,"ownerHtmlUrl":61,"ownerBlogUrl":62,"ownerDescription":63,"updatedAt":64,"install":65,"resources":78},"01M6F84RQZNXVSRRH1SPFHF0KY","maintainx-security-basics",null,"Configure MaintainX API security, credential management, and access control.\nUse when securing API keys, implementing access controls,\nor hardening your MaintainX integration.\nTrigger with phrases like \"maintainx security\", \"maintainx api key security\",\n\"secure maintainx\", \"maintainx credentials\", \"maintainx access control\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-security-basics\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"security","maintainx security basics","basics","when","api keys","implementing","with","controls","trigger","io","control","Access Control","api security","use","edit","write","read","configure","access","Bash","api","credentials","secure","2026-11-10 10:12:30",false,"---\nname: maintainx-security-basics\ndescription: |\n  Configure MaintainX API security, credential management, and access control.\n  Use when securing API keys, implementing access controls,\n  or hardening your MaintainX integration.\n  Trigger with phrases like \"maintainx security\", \"maintainx api key security\",\n  \"secure maintainx\", \"maintainx credentials\", \"maintainx access control\".\nallowed-tools: Read, Write, Edit, Bash(npm:*)\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# MaintainX Security Basics\n\n## Overview\n\nSecure your MaintainX integration with proper credential management, access controls, and security best practices.\n\n## Prerequisites\n\n- MaintainX account with admin access\n- Understanding of environment variables\n- Familiarity with secret management concepts\n\n## Security Checklist\n\n- [ ] API keys stored in environment variables or secret manager\n- [ ] No credentials in version control\n- [ ] HTTPS enforced for all API calls\n- [ ] API key rotation schedule established\n- [ ] Least privilege principle applied\n- [ ] Audit logging enabled\n- [ ] Input validation implemented\n\n## Instructions\n\n### Step 1: Secure Credential Storage\n\n```typescript\n\u002F\u002F NEVER do this:\n\u002F\u002F const API_KEY = 'mx_live_abc123...';  \u002F\u002F Hardcoded - BAD!\n\n\u002F\u002F ALWAYS do this:\n\u002F\u002F src\u002Fconfig\u002Fsecure-config.ts\n\nimport { SecretManagerServiceClient } from '@google-cloud\u002Fsecret-manager';\n\ninterface SecureConfig {\n  maintainxApiKey: string;\n  maintainxOrgId?: string;\n}\n\n\u002F\u002F Option 1: Environment variables (development)\nfunction loadFromEnv(): SecureConfig {\n  const apiKey = process.env.MAINTAINX_API_KEY;\n\n  if (!apiKey) {\n    throw new Error(\n      'MAINTAINX_API_KEY not set. ' +\n      'Set it as an environment variable or use a secret manager.'\n    );\n  }\n\n  return {\n    maintainxApiKey: apiKey,\n    maintainxOrgId: process.env.MAINTAINX_ORG_ID,\n  };\n}\n\n\u002F\u002F Option 2: Google Cloud Secret Manager (production)\nasync function loadFromSecretManager(): Promise\u003CSecureConfig> {\n  const client = new SecretManagerServiceClient();\n  const projectId = process.env.GCP_PROJECT_ID;\n\n  const [apiKeyVersion] = await client.accessSecretVersion({\n    name: `projects\u002F${projectId}\u002Fsecrets\u002Fmaintainx-api-key\u002Fversions\u002Flatest`,\n  });\n\n  const apiKey = apiKeyVersion.payload?.data?.toString();\n  if (!apiKey) {\n    throw new Error('Failed to load API key from Secret Manager');\n  }\n\n  return { maintainxApiKey: apiKey };\n}\n\n\u002F\u002F Option 3: HashiCorp Vault\nasync function loadFromVault(): Promise\u003CSecureConfig> {\n  const vault = require('node-vault')({\n    apiVersion: 'v1',\n    endpoint: process.env.VAULT_ADDR,\n    token: process.env.VAULT_TOKEN,\n  });\n\n  const secret = await vault.read('secret\u002Fdata\u002Fmaintainx');\n  return {\n    maintainxApiKey: secret.data.data.api_key,\n  };\n}\n\n\u002F\u002F Load config based on environment\nexport async function loadSecureConfig(): Promise\u003CSecureConfig> {\n  const env = process.env.NODE_ENV || 'development';\n\n  switch (env) {\n    case 'production':\n      return loadFromSecretManager();\n    case 'staging':\n      return loadFromVault();\n    default:\n      return loadFromEnv();\n  }\n}\n```\n\n### Step 2: Git Security Configuration\n\n```gitignore\n# .gitignore - ALWAYS include these\n\n# Environment files\n.env\n.env.*\n!.env.example\n\n# API keys and secrets\n*.key\n*.pem\nsecrets\u002F\ncredentials\u002F\n\n# IDE and local config\n.idea\u002F\n.vscode\u002Fsettings.json\n\n# Log files that might contain sensitive data\n*.log\nlogs\u002F\n```\n\n```bash\n# .env.example - Safe to commit as template\n# Copy to .env and fill in values\n\n# MaintainX API Configuration\nMAINTAINX_API_KEY=your-api-key-here\nMAINTAINX_ORG_ID=optional-org-id\n\n# For secret managers (production)\nGCP_PROJECT_ID=your-gcp-project\nVAULT_ADDR=https:\u002F\u002Fvault.example.com\n```\n\n### Step 3: Pre-commit Hook for Secrets Detection\n\n```bash\n#!\u002Fbin\u002Fbash\n# .git\u002Fhooks\u002Fpre-commit\n\n# Check for potential secrets\nPATTERNS=(\n  'MAINTAINX_API_KEY\\s*=\\s*[\"\\x27][a-zA-Z0-9_-]{20,}'\n  'mx_live_[a-zA-Z0-9]+'\n  'mx_test_[a-zA-Z0-9]+'\n  'Bearer\\s+[a-zA-Z0-9_-]{20,}'\n)\n\nfor pattern in \"${PATTERNS[@]}\"; do\n  if git diff --cached | grep -qE \"$pattern\"; then\n    echo \"ERROR: Potential secret detected in commit!\"\n    echo \"Pattern: $pattern\"\n    echo \"\"\n    echo \"Remove the secret and use environment variables instead.\"\n    exit 1\n  fi\ndone\n\necho \"Pre-commit security check passed.\"\n```\n\n```bash\n# Install the hook\nchmod +x .git\u002Fhooks\u002Fpre-commit\n```\n\n### Step 4: Input Validation\n\n```typescript\n\u002F\u002F src\u002Fsecurity\u002Fvalidation.ts\nimport { z } from 'zod';\n\n\u002F\u002F Define schemas for MaintainX data\nconst WorkOrderInputSchema = z.object({\n  title: z.string()\n    .min(1, 'Title is required')\n    .max(200, 'Title too long')\n    .regex(\u002F^[^\u003C>]*$\u002F, 'Invalid characters in title'),  \u002F\u002F Prevent XSS\n  description: z.string()\n    .max(10000, 'Description too long')\n    .optional(),\n  priority: z.enum(['NONE', 'LOW', 'MEDIUM', 'HIGH']).optional(),\n  assetId: z.string()\n    .regex(\u002F^[a-zA-Z0-9_-]+$\u002F, 'Invalid asset ID format')\n    .optional(),\n  locationId: z.string()\n    .regex(\u002F^[a-zA-Z0-9_-]+$\u002F, 'Invalid location ID format')\n    .optional(),\n  dueDate: z.string()\n    .datetime()\n    .optional(),\n});\n\ntype WorkOrderInput = z.infer\u003Ctypeof WorkOrderInputSchema>;\n\n\u002F\u002F Validate before API calls\nfunction validateWorkOrderInput(input: unknown): WorkOrderInput {\n  return WorkOrderInputSchema.parse(input);\n}\n\n\u002F\u002F Sanitize output for logging (remove sensitive data)\nfunction sanitizeForLogging(data: any): any {\n  const sensitiveFields = ['apiKey', 'token', 'password', 'secret'];\n  const sanitized = { ...data };\n\n  for (const field of sensitiveFields) {\n    if (sanitized[field]) {\n      sanitized[field] = '[REDACTED]';\n    }\n  }\n\n  return sanitized;\n}\n\n\u002F\u002F Usage in client\nclass SecureMaintainXClient {\n  async createWorkOrder(input: unknown) {\n    \u002F\u002F Validate input\n    const validatedInput = validateWorkOrderInput(input);\n\n    \u002F\u002F Log sanitized data\n    console.log('Creating work order:', sanitizeForLogging(validatedInput));\n\n    \u002F\u002F Make API call with validated data\n    return this.client.createWorkOrder(validatedInput);\n  }\n}\n```\n\n### Step 5: Audit Logging\n\n```typescript\n\u002F\u002F src\u002Fsecurity\u002Faudit.ts\n\ninterface AuditEntry {\n  timestamp: string;\n  action: string;\n  resource: string;\n  resourceId?: string;\n  userId?: string;\n  ipAddress?: string;\n  success: boolean;\n  errorMessage?: string;\n  requestData?: any;\n}\n\nclass AuditLogger {\n  private logs: AuditEntry[] = [];\n\n  log(entry: Omit\u003CAuditEntry, 'timestamp'>) {\n    const fullEntry: AuditEntry = {\n      ...entry,\n      timestamp: new Date().toISOString(),\n      requestData: entry.requestData\n        ? sanitizeForLogging(entry.requestData)\n        : undefined,\n    };\n\n    this.logs.push(fullEntry);\n\n    \u002F\u002F In production, send to logging service\n    console.log(`[AUDIT] ${fullEntry.action} on ${fullEntry.resource}: ${fullEntry.success ? 'SUCCESS' : 'FAILED'}`);\n  }\n\n  \u002F\u002F Get audit trail for a resource\n  getAuditTrail(resourceId: string): AuditEntry[] {\n    return this.logs.filter(l => l.resourceId === resourceId);\n  }\n}\n\nconst auditLogger = new AuditLogger();\n\n\u002F\u002F Audit-enabled client wrapper\nclass AuditedMaintainXClient {\n  private client: MaintainXClient;\n  private audit: AuditLogger;\n  private userId?: string;\n\n  constructor(client: MaintainXClient, userId?: string) {\n    this.client = client;\n    this.audit = auditLogger;\n    this.userId = userId;\n  }\n\n  async createWorkOrder(data: any) {\n    try {\n      const result = await this.client.createWorkOrder(data);\n\n      this.audit.log({\n        action: 'CREATE',\n        resource: 'WorkOrder',\n        resourceId: result.id,\n        userId: this.userId,\n        success: true,\n        requestData: data,\n      });\n\n      return result;\n    } catch (error: any) {\n      this.audit.log({\n        action: 'CREATE',\n        resource: 'WorkOrder',\n        userId: this.userId,\n        success: false,\n        errorMessage: error.message,\n        requestData: data,\n      });\n\n      throw error;\n    }\n  }\n}\n```\n\n### Step 6: API Key Rotation\n\n```typescript\n\u002F\u002F scripts\u002Frotate-api-key.ts\n\nasync function rotateApiKey() {\n  console.log('=== MaintainX API Key Rotation ===\\n');\n\n  \u002F\u002F Step 1: Generate new key in MaintainX dashboard\n  console.log('1. Generate new API key:');\n  console.log('   - Go to Settings > Integrations');\n  console.log('   - Click \"New Key\" > \"Generate Key\"');\n  console.log('   - Copy the new key\\n');\n\n  \u002F\u002F Step 2: Update secret manager\n  console.log('2. Update secret manager:');\n  console.log('   - GCP: gcloud secrets versions add maintainx-api-key --data-file=newkey.txt');\n  console.log('   - Vault: vault kv put secret\u002Fmaintainx api_key=NEW_KEY\\n');\n\n  \u002F\u002F Step 3: Deploy with new key\n  console.log('3. Deploy application with new key');\n  console.log('   - kubectl rollout restart deployment\u002Fyour-app');\n  console.log('   - Or trigger CI\u002FCD pipeline\\n');\n\n  \u002F\u002F Step 4: Verify new key works\n  console.log('4. Verify new key:');\n  console.log('   - Run health check script');\n  console.log('   - Monitor for authentication errors\\n');\n\n  \u002F\u002F Step 5: Revoke old key\n  console.log('5. Revoke old key (after verification):');\n  console.log('   - Go to Settings > Integrations');\n  console.log('   - Find old key and click \"Revoke\"\\n');\n\n  \u002F\u002F Schedule reminder\n  console.log('6. Schedule next rotation (recommended: every 90 days)');\n}\n\nrotateApiKey();\n```\n\n### Step 7: Network Security\n\n```typescript\n\u002F\u002F Enforce HTTPS and configure timeouts\nimport https from 'https';\n\nconst secureAxiosConfig = {\n  baseURL: 'https:\u002F\u002Fapi.getmaintainx.com\u002Fv1',  \u002F\u002F Always HTTPS\n  timeout: 30000,  \u002F\u002F 30 second timeout\n  httpsAgent: new https.Agent({\n    rejectUnauthorized: true,  \u002F\u002F Verify SSL certificates\n    minVersion: 'TLSv1.2',     \u002F\u002F Minimum TLS version\n  }),\n  headers: {\n    'Content-Type': 'application\u002Fjson',\n    'User-Agent': 'YourApp\u002F1.0.0',  \u002F\u002F Identify your application\n  },\n};\n```\n\n## Output\n\n- Secure credential storage configured\n- Git hooks preventing secret commits\n- Input validation implemented\n- Audit logging enabled\n- Key rotation procedure documented\n\n## Security Checklist Verification\n\n```bash\n# Run security checks\nnpm audit                          # Check for vulnerable dependencies\ngit secrets --scan                 # Scan for secrets (if git-secrets installed)\nnpx eslint --rule 'no-hardcoded-credentials: error' src\u002F\n```\n\n## Resources\n\n- [MaintainX Security](https:\u002F\u002Fwww.getmaintainx.com\u002Fsecurity)\n- [OWASP API Security](https:\u002F\u002Fowasp.org\u002FAPI-Security\u002F)\n- [Google Cloud Secret Manager](https:\u002F\u002Fcloud.google.com\u002Fsecret-manager)\n\n## Next Steps\n\nFor production deployment, see `maintainx-prod-checklist`.\n","# MaintainX Security Basics\n\n## Overview\n\nSecure your MaintainX integration with proper credential management, access controls, and security best practices.\n\n## Prerequisites\n\n- MaintainX account with admin access\n- Understanding of environment variables\n- Familiarity with secret management concepts\n\n## Security Checklist\n\n- [ ] API keys stored in environment variables or secret manager\n- [ ] No credentials in version control\n- [ ] HTTPS enforced for all API calls\n- [ ] API key rotation schedule established\n- [ ] Least privilege principle applied\n- [ ] Audit logging enabled\n- [ ] Input validation implemented\n\n## Instructions\n\n### Step 1: Secure Credential Storage\n\n```typescript\n\u002F\u002F NEVER do this:\n\u002F\u002F const API_KEY = 'mx_live_abc123...';  \u002F\u002F Hardcoded - BAD!\n\n\u002F\u002F ALWAYS do this:\n\u002F\u002F src\u002Fconfig\u002Fsecure-config.ts\n\nimport { SecretManagerServiceClient } from '@google-cloud\u002Fsecret-manager';\n\ninterface SecureConfig {\n  maintainxApiKey: string;\n  maintainxOrgId?: string;\n}\n\n\u002F\u002F Option 1: Environment variables (development)\nfunction loadFromEnv(): SecureConfig {\n  const apiKey = process.env.MAINTAINX_API_KEY;\n\n  if (!apiKey) {\n    throw new Error(\n      'MAINTAINX_API_KEY not set. ' +\n      'Set it as an environment variable or use a secret manager.'\n    );\n  }\n\n  return {\n    maintainxApiKey: apiKey,\n    maintainxOrgId: process.env.MAINTAINX_ORG_ID,\n  };\n}\n\n\u002F\u002F Option 2: Google Cloud Secret Manager (production)\nasync function loadFromSecretManager(): Promise\u003CSecureConfig> {\n  const client = new SecretManagerServiceClient();\n  const projectId = process.env.GCP_PROJECT_ID;\n\n  const [apiKeyVersion] = await client.accessSecretVersion({\n    name: `projects\u002F${projectId}\u002Fsecrets\u002Fmaintainx-api-key\u002Fversions\u002Flatest`,\n  });\n\n  const apiKey = apiKeyVersion.payload?.data?.toString();\n  if (!apiKey) {\n    throw new Error('Failed to load API key from Secret Manager');\n  }\n\n  return { maintainxApiKey: apiKey };\n}\n\n\u002F\u002F Option 3: HashiCorp Vault\nasync function loadFromVault(): Promise\u003CSecureConfig> {\n  const vault = require('node-vault')({\n    apiVersion: 'v1',\n    endpoint: process.env.VAULT_ADDR,\n    token: process.env.VAULT_TOKEN,\n  });\n\n  const secret = await vault.read('secret\u002Fdata\u002Fmaintainx');\n  return {\n    maintainxApiKey: secret.data.data.api_key,\n  };\n}\n\n\u002F\u002F Load config based on environment\nexport async function loadSecureConfig(): Promise\u003CSecureConfig> {\n  const env = process.env.NODE_ENV || 'development';\n\n  switch (env) {\n    case 'production':\n      return loadFromSecretManager();\n    case 'staging':\n      return loadFromVault();\n    default:\n      return loadFromEnv();\n  }\n}\n```\n\n### Step 2: Git Security Configuration\n\n```gitignore\n# .gitignore - ALWAYS include these\n\n# Environment files\n.env\n.env.*\n!.env.example\n\n# API keys and secrets\n*.key\n*.pem\nsecrets\u002F\ncredentials\u002F\n\n# IDE and local config\n.idea\u002F\n.vscode\u002Fsettings.json\n\n# Log files that might contain sensitive data\n*.log\nlogs\u002F\n```\n\n```bash\n# .env.example - Safe to commit as template\n# Copy to .env and fill in values\n\n# MaintainX API Configuration\nMAINTAINX_API_KEY=your-api-key-here\nMAINTAINX_ORG_ID=optional-org-id\n\n# For secret managers (production)\nGCP_PROJECT_ID=your-gcp-project\nVAULT_ADDR=https:\u002F\u002Fvault.example.com\n```\n\n### Step 3: Pre-commit Hook for Secrets Detection\n\n```bash\n#!\u002Fbin\u002Fbash\n# .git\u002Fhooks\u002Fpre-commit\n\n# Check for potential secrets\nPATTERNS=(\n  'MAINTAINX_API_KEY\\s*=\\s*[\"\\x27][a-zA-Z0-9_-]{20,}'\n  'mx_live_[a-zA-Z0-9]+'\n  'mx_test_[a-zA-Z0-9]+'\n  'Bearer\\s+[a-zA-Z0-9_-]{20,}'\n)\n\nfor pattern in \"${PATTERNS[@]}\"; do\n  if git diff --cached | grep -qE \"$pattern\"; then\n    echo \"ERROR: Potential secret detected in commit!\"\n    echo \"Pattern: $pattern\"\n    echo \"\"\n    echo \"Remove the secret and use environment variables instead.\"\n    exit 1\n  fi\ndone\n\necho \"Pre-commit security check passed.\"\n```\n\n```bash\n# Install the hook\nchmod +x .git\u002Fhooks\u002Fpre-commit\n```\n\n### Step 4: Input Validation\n\n```typescript\n\u002F\u002F src\u002Fsecurity\u002Fvalidation.ts\nimport { z } from 'zod';\n\n\u002F\u002F Define schemas for MaintainX data\nconst WorkOrderInputSchema = z.object({\n  title: z.string()\n    .min(1, 'Title is required')\n    .max(200, 'Title too long')\n    .regex(\u002F^[^\u003C>]*$\u002F, 'Invalid characters in title'),  \u002F\u002F Prevent XSS\n  description: z.string()\n    .max(10000, 'Description too long')\n    .optional(),\n  priority: z.enum(['NONE', 'LOW', 'MEDIUM', 'HIGH']).optional(),\n  assetId: z.string()\n    .regex(\u002F^[a-zA-Z0-9_-]+$\u002F, 'Invalid asset ID format')\n    .optional(),\n  locationId: z.string()\n    .regex(\u002F^[a-zA-Z0-9_-]+$\u002F, 'Invalid location ID format')\n    .optional(),\n  dueDate: z.string()\n    .datetime()\n    .optional(),\n});\n\ntype WorkOrderInput = z.infer\u003Ctypeof WorkOrderInputSchema>;\n\n\u002F\u002F Validate before API calls\nfunction validateWorkOrderInput(input: unknown): WorkOrderInput {\n  return WorkOrderInputSchema.parse(input);\n}\n\n\u002F\u002F Sanitize output for logging (remove sensitive data)\nfunction sanitizeForLogging(data: any): any {\n  const sensitiveFields = ['apiKey', 'token', 'password', 'secret'];\n  const sanitized = { ...data };\n\n  for (const field of sensitiveFields) {\n    if (sanitized[field]) {\n      sanitized[field] = '[REDACTED]';\n    }\n  }\n\n  return sanitized;\n}\n\n\u002F\u002F Usage in client\nclass SecureMaintainXClient {\n  async createWorkOrder(input: unknown) {\n    \u002F\u002F Validate input\n    const validatedInput = validateWorkOrderInput(input);\n\n    \u002F\u002F Log sanitized data\n    console.log('Creating work order:', sanitizeForLogging(validatedInput));\n\n    \u002F\u002F Make API call with validated data\n    return this.client.createWorkOrder(validatedInput);\n  }\n}\n```\n\n### Step 5: Audit Logging\n\n```typescript\n\u002F\u002F src\u002Fsecurity\u002Faudit.ts\n\ninterface AuditEntry {\n  timestamp: string;\n  action: string;\n  resource: string;\n  resourceId?: string;\n  userId?: string;\n  ipAddress?: string;\n  success: boolean;\n  errorMessage?: string;\n  requestData?: any;\n}\n\nclass AuditLogger {\n  private logs: AuditEntry[] = [];\n\n  log(entry: Omit\u003CAuditEntry, 'timestamp'>) {\n    const fullEntry: AuditEntry = {\n      ...entry,\n      timestamp: new Date().toISOString(),\n      requestData: entry.requestData\n        ? sanitizeForLogging(entry.requestData)\n        : undefined,\n    };\n\n    this.logs.push(fullEntry);\n\n    \u002F\u002F In production, send to logging service\n    console.log(`[AUDIT] ${fullEntry.action} on ${fullEntry.resource}: ${fullEntry.success ? 'SUCCESS' : 'FAILED'}`);\n  }\n\n  \u002F\u002F Get audit trail for a resource\n  getAuditTrail(resourceId: string): AuditEntry[] {\n    return this.logs.filter(l => l.resourceId === resourceId);\n  }\n}\n\nconst auditLogger = new AuditLogger();\n\n\u002F\u002F Audit-enabled client wrapper\nclass AuditedMaintainXClient {\n  private client: MaintainXClient;\n  private audit: AuditLogger;\n  private userId?: string;\n\n  constructor(client: MaintainXClient, userId?: string) {\n    this.client = client;\n    this.audit = auditLogger;\n    this.userId = userId;\n  }\n\n  async createWorkOrder(data: any) {\n    try {\n      const result = await this.client.createWorkOrder(data);\n\n      this.audit.log({\n        action: 'CREATE',\n        resource: 'WorkOrder',\n        resourceId: result.id,\n        userId: this.userId,\n        success: true,\n        requestData: data,\n      });\n\n      return result;\n    } catch (error: any) {\n      this.audit.log({\n        action: 'CREATE',\n        resource: 'WorkOrder',\n        userId: this.userId,\n        success: false,\n        errorMessage: error.message,\n        requestData: data,\n      });\n\n      throw error;\n    }\n  }\n}\n```\n\n### Step 6: API Key Rotation\n\n```typescript\n\u002F\u002F scripts\u002Frotate-api-key.ts\n\nasync function rotateApiKey() {\n  console.log('=== MaintainX API Key Rotation ===\\n');\n\n  \u002F\u002F Step 1: Generate new key in MaintainX dashboard\n  console.log('1. Generate new API key:');\n  console.log('   - Go to Settings > Integrations');\n  console.log('   - Click \"New Key\" > \"Generate Key\"');\n  console.log('   - Copy the new key\\n');\n\n  \u002F\u002F Step 2: Update secret manager\n  console.log('2. Update secret manager:');\n  console.log('   - GCP: gcloud secrets versions add maintainx-api-key --data-file=newkey.txt');\n  console.log('   - Vault: vault kv put secret\u002Fmaintainx api_key=NEW_KEY\\n');\n\n  \u002F\u002F Step 3: Deploy with new key\n  console.log('3. Deploy application with new key');\n  console.log('   - kubectl rollout restart deployment\u002Fyour-app');\n  console.log('   - Or trigger CI\u002FCD pipeline\\n');\n\n  \u002F\u002F Step 4: Verify new key works\n  console.log('4. Verify new key:');\n  console.log('   - Run health check script');\n  console.log('   - Monitor for authentication errors\\n');\n\n  \u002F\u002F Step 5: Revoke old key\n  console.log('5. Revoke old key (after verification):');\n  console.log('   - Go to Settings > Integrations');\n  console.log('   - Find old key and click \"Revoke\"\\n');\n\n  \u002F\u002F Schedule reminder\n  console.log('6. Schedule next rotation (recommended: every 90 days)');\n}\n\nrotateApiKey();\n```\n\n### Step 7: Network Security\n\n```typescript\n\u002F\u002F Enforce HTTPS and configure timeouts\nimport https from 'https';\n\nconst secureAxiosConfig = {\n  baseURL: 'https:\u002F\u002Fapi.getmaintainx.com\u002Fv1',  \u002F\u002F Always HTTPS\n  timeout: 30000,  \u002F\u002F 30 second timeout\n  httpsAgent: new https.Agent({\n    rejectUnauthorized: true,  \u002F\u002F Verify SSL certificates\n    minVersion: 'TLSv1.2',     \u002F\u002F Minimum TLS version\n  }),\n  headers: {\n    'Content-Type': 'application\u002Fjson',\n    'User-Agent': 'YourApp\u002F1.0.0',  \u002F\u002F Identify your application\n  },\n};\n```\n\n## Output\n\n- Secure credential storage configured\n- Git hooks preventing secret commits\n- Input validation implemented\n- Audit logging enabled\n- Key rotation procedure documented\n\n## Security Checklist Verification\n\n```bash\n# Run security checks\nnpm audit                          # Check for vulnerable dependencies\ngit secrets --scan                 # Scan for secrets (if git-secrets installed)\nnpx eslint --rule 'no-hardcoded-credentials: error' src\u002F\n```\n\n## Resources\n\n- [MaintainX Security](https:\u002F\u002Fwww.getmaintainx.com\u002Fsecurity)\n- [OWASP API Security](https:\u002F\u002Fowasp.org\u002FAPI-Security\u002F)\n- [Google Cloud Secret Manager](https:\u002F\u002Fcloud.google.com\u002Fsecret-manager)\n\n## Next Steps\n\nFor production deployment, see `maintainx-prod-checklist`.\n",{"name":5,"author":52,"license":15,"version":53,"description":54,"allowed-tools":55},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Configure MaintainX API security, credential management, and access control.\nUse when securing API keys, implementing access controls,\nor hardening your MaintainX integration.\nTrigger with phrases like \"maintainx security\", \"maintainx api key security\",\n\"secure maintainx\", \"maintainx credentials\", \"maintainx access control\".\n","Read, Write, Edit, Bash(npm:*)","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-security-basics",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":77},[67,70,73],{"tool":68,"command":69},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-security-basics",{"tool":71,"command":72},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-security-basics",{"tool":74,"command":75},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-security-basics","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-security-basics\u002FSKILL.md",true,[],[80,113,148,171,197,224],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":85,"sourceHtmlUrl":86,"categories":87,"keywords":93,"publishedAt":112},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[88],{"categoryNo":89,"categoryName":90,"taxonomyType":91,"taxonomyTypeDesc":92},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,30,110,111],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","you","fonts","2026-11-11 15:11:14",{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":117,"sourceHtmlUrl":118,"categories":119,"keywords":123,"publishedAt":47},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[120],{"categoryNo":121,"categoryName":122,"taxonomyType":91,"taxonomyTypeDesc":92},"01JBSEEDCAT000000000000009","前端开发",[124,125,100,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,37,105,141,142,143,144,145,146,147],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","single-file","simple","ui components","multi","for","jsx","suite",{"skillNo":149,"name":150,"nameZh":6,"description":151,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":152,"sourceHtmlUrl":153,"categories":154,"keywords":159,"publishedAt":47},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[155,158],{"categoryNo":156,"categoryName":157,"taxonomyType":91,"taxonomyTypeDesc":92},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":121,"categoryName":122,"taxonomyType":91,"taxonomyTypeDesc":92},[160,161,162,128,163,164,125,165,98,166,138,167,168,169,170,30,145],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":175,"sourceHtmlUrl":176,"categories":177,"keywords":178,"publishedAt":47},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[179,180,181,182,183,184,185,186,37,187,188,189,190,191,192,193,30,194,195,196,145,27],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":198,"name":199,"nameZh":6,"description":200,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":201,"sourceHtmlUrl":202,"categories":203,"keywords":207,"publishedAt":47},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[204],{"categoryNo":205,"categoryName":206,"taxonomyType":91,"taxonomyTypeDesc":92},"01JBSEEDCAT000000000000023","Skill与智能体开发",[208,209,210,211,212,213,214,215,216,217,218,219,220,221,30,145,222,27,223],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","integrations","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":225,"name":226,"nameZh":6,"description":227,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":228,"sourceHtmlUrl":229,"categories":230,"keywords":232,"publishedAt":47},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[231],{"categoryNo":205,"categoryName":206,"taxonomyType":91,"taxonomyTypeDesc":92},[226,233,234,235,236,237,238,166,239,240,37,241,242,243,244,145,245],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source"]