Saltar al contenido principal

proposals review

Registra la decisión de tu organización sobre una Proposal (propuesta para bloquear o permitir un asset) que está esperando tu respuesta: es la misma cola que muestra la página Review (revisión de propuestas pendientes de aprobación) y que devuelve reports list --needs-customer-review.
Una revisión no se puede deshacer a través de la API. approve bloquea el Asset (activo digital: URL, dirección, perfil, app, etc.) y, como los assets son únicos por tipo y contenido, ese estado es global y no se limita a tu organización. El comando pide confirmación a menos que pases --yes, y cada organización tiene un límite de 10 revisiones por día sumando todas sus credenciales de API.

Opciones

Las tres decisiones

watchlist es una variante del rechazo y no un resultado aparte: se guarda como una revisión REJECT con el asset en la Watchlist, que es exactamente lo que hace la página Review. Por eso un envío exitoso a la Watchlist devuelve review.decision: "REJECT" y watchlisted: true.

Etiquetas de bloqueo

--label es obligatorio al aprobar. Ponlo entre comillas, ya que todos los valores contienen un espacio: "General Phishing", "Brand Impersonation", "Employee Impersonation", "Fake Employee", "Targeting Org Users", "C2 Server", "False Positive". Las etiquetas que nombran un objetivo específico (Brand Impersonation y Employee Impersonation) también necesitan --brand-id.

Encontrar una Proposal para revisar

Ambos IDs provienen del listado de reportes. Pide las Proposals que esperan tu decisión y luego lee proposals[].id y proposals[].asset.id:

Ejemplos

Notas

  • Las revisiones deben atribuirse a un miembro de la organización con rol de cliente. Las credenciales de staff se rechazan con el código de salida 5.
  • Un 403 de una verificación de seguridad significa que la decisión necesita a una persona, no que tu integración esté rota. Registra el ID de la Proposal y continúa en lugar de reintentar.
  • Un 409 significa que el asset no coincide con la Proposal o que la Proposal ya está resuelta. Vuelve a leer la Proposal en lugar de reintentar con el mismo cuerpo.
  • No todos los tipos de asset se pueden enviar a la Watchlist. Los tipos que la Watchlist no puede volver a verificar se rechazan en lugar de omitirse en silencio.

Relacionado