> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Registres d'auditoria: seguiment de l'activitat de l'API > Didit registra tota l'activitat de l'API en registres d'auditoria cercables. Filtra per usuari, mètode, estat i dates per a auditories de compliment. Els registres d'auditoria ofereixen un registre complet i cercable de tota l'activitat de l'API dins de la teva organització. Cada sol·licitud feta a la plataforma de Didit, ja sigui des de la consola, des de la teva integració o per part dels membres de l'equip, es registra automàticament per a la seguretat, el compliment normatiu i la resolució d'incidències. ![Registres d'auditoria a la consola de Didit](https://mintcdn.com/didit-0f962782/ibesJiSLVa9jZb5z/images/console-audit-logs.jpg?fit=max\&auto=format\&n=ibesJiSLVa9jZb5z\&q=85\&s=bcd436f764486143268f5c5ca67d9d14) *** ## Per què els registres d'auditoria? | Repte | Solució | | - | - | | Requisits de compliment normatiu | Traça d'auditoria completa de tota l'activitat, durant tot el període que conserva el teu pla | | Investigació d'incidents de seguretat | Identifica amb precisió qui ha fet què i quan | | Depuració de problemes d'integració | Consulta el camí, l'estat i el cos amb les dades ocultes de cada sol·licitud | | Responsabilitat dins de l'equip | Fes el seguiment de quins membres de l'equip han accedit a quines dades | | Monitoratge de l'ús | Entén els patrons de consum de l'API | *** ## Accés als registres d'auditoria Obre **Settings > Organization > Audit log** a la consola de Didit. La interfície mostra una llista cronològica de totes les sol·licituds de l'API fetes dins de la teva organització. Cada entrada del registre inclou: | Camp | Descripció | | - | - | | **Marca de temps** | Quan es va fer la sol·licitud | | **Usuari** | Qui l'ha feta: el correu electrònic del membre de l'equip autenticat; el nom de la clau d'API que ha fet la sol·licitud, marcat com a **clau d'API**; o **L’investigador**, per a una decisió que ha pres per si mateix | | **Mètode** | Mètode HTTP (GET, POST, PUT, DELETE) | | **Camí** | L'endpoint de l'API que s'ha cridat | | **Estat** | Codi d'estat de la resposta HTTP | | **Adreça IP** | IP d'origen de la sol·licitud | | **Aplicació** | Aplicació a la qual estava associada la sol·licitud | ### Decisions preses per l'investigador Cada decisió que l'[investigador](https://docs.didit.me/ca/console/investigator.md) pren per si mateix es registra sota **L’investigador**, i no sota un membre ni una clau d'API: aprovar o rebutjar una sessió o sol·licitar que es torni a enviar, establir l'estat d'una transacció, i resoldre un cas, escalar-lo o sol·licitar informació sobre el cas. L'entrada enllaça amb l'informe de l'investigador que hi ha darrere de la decisió. Quan una persona accepta o anul·la una recomanació de l'investigador, l'entrada es registra a nom d'aquesta persona. *** ## Filtratge i cerca La interfície de registres d'auditoria ofereix potents opcions de filtratge per ajudar-te a trobar exactament el que busques. ### Cerca intel·ligent La barra de cerca detecta automàticament què busques: | Tipus de cerca | Exemple | Comportament | | - | - | - | | **Camí exacte** | `/v1/organization/.../sessions/` | Troba els registres amb aquest camí exacte de sol·licitud | | **Correu electrònic exacte** | `admin@company.com` | Troba els registres d'aquest usuari concret | | **IP exacta** | `192.168.1.100` | Troba els registres d'aquesta adreça IP | | **Comodí** | `/v1/*/analytics/*` | Troba els patrons que coincideixen amb comodins | | **Text general** | `sessions` | Cerca aproximada en tots els camps | ### Filtres disponibles | Filtre | Descripció | Exemple | | - | - | - | | **Aplicació** | Filtra per una aplicació concreta | Selecciona de la llista desplegable | | **Membres i claus d'API** | Filtra per la clau d'API que ha fet les sol·licituds | Selecciona una clau de l'aplicació escollida | | **Actor** | Mostra només el que han fet els membres, les claus d'API o l'investigador | **L’investigador** | | **Mètode** | Filtra per mètode HTTP | `GET`, `POST`, `PUT`, `DELETE` | | **Codi d'estat** | Filtra per estat de la resposta | `200`, `401`, `500` | | **Interval de dates** | Filtra per període de temps | Últims 7 dies, interval personalitzat | *** ## Conservació de dades El teu pla determina fins a quin punt pots llegir el registre d'auditoria i si pots exportar-lo: | Pla | Fins a quant temps enrere | Exportació | | - | - | - | | Free | 30 dies | No | | Growth | 1 any | No | | Scale | 3 anys | Sí | | Enterprise | Definit pel teu contracte | Sí | Una exportació en un pla que no la inclou respon amb `403` i `"code": "plan_limit_exceeded"`. *** ## Seguretat i privacitat ### Què es registra Els registres d'auditoria capturen metadades de les sol·licituds de l'API: * Marca de temps i durada de la sol·licitud * Identitat de l'usuari (correu electrònic, ID d'usuari), o la clau d'API que ha fet la sol·licitud (el seu nom i els primers caràcters del seu secret, mai el secret complet) * Camí de la sol·licitud i paràmetres de consulta * Codis d'estat de la resposta * Adreça IP del client i agent d'usuari ### Cossos de sol·licitud i de resposta de les crides amb clau d'API Per a una crida feta amb una clau d'API, el registre d'auditoria també guarda una còpia redactada del cos JSON de la sol·licitud d'una escriptura, i de la resposta a una escriptura o a un error, perquè puguis veure per què ha fallat una crida. La resposta a una lectura satisfactòria no es guarda. L'ocultació rebutja tots els valors per defecte: * L'estructura es manté: noms de camp, nidificació, tipus de valor, longituds d'array i longituds de cadena. * Un valor només es manté si és un dels identificadors, estats, codis, comptadors o marques de temps propis de Didit, en un camp que Didit defineix, amb la forma que aquest camp espera. * Un booleà només es manté en un camp que Didit defineix. * Qualsevol altre valor se substitueix per un marcador que indica el seu tipus i la seva longitud, com ara `[redacted:string:12]`, `[redacted:number:5]` o `[redacted:boolean]`, i `null` es manté com a `null`. * Un nom de camp que no és un identificador simple, com ara una adreça de correu electrònic o un número de telèfon utilitzat com a clau, se substitueix per `[redacted:key:23]`. * Un cos que no és JSON, com ara un formulari o una pujada de fitxer, se substitueix per una nota que indica què era. * El que queda es talla a 4.096 caràcters. Els paràmetres de consulta passen pel mateix procés d'ocultació. Només es mantenen les capçaleres estàndard, com ara `content-type`, `user-agent` i les capçaleres de límit de freqüència; qualsevol altra capçalera s'elimina juntament amb el seu valor. Un valor que envia el teu propi sistema, per exemple a `metadata` o a `vendor_data`, mai es manté, encara que el seu camp tingui el nom d'un dels de Didit. ### Què no es registra Per protegir les dades sensibles, s'exclouen automàticament: * Tokens d'autenticació i credencials * Contrasenyes i secrets * Dades personals de les sessions de verificació ### Control d'accés Per veure el registre d'auditoria cal tenir els permisos de lectura i de llistat de `audit-logs`. Els rols Reader, Compliance Officer, Developer, Admin i Owner els tenen tots, i un [rol personalitzat](https://docs.didit.me/ca/console/roles-permissions.md) els obté seleccionant Audit logs a l'editor de rols. *** ## Casos d'ús habituals > [accordion] Auditoria de compliment > > Demostra als auditors que tens visibilitat completa de qui ha accedit a les dades de verificació: > > 1. Filtra per un rang de dates que coincideixi amb el període d'auditoria > 2. Filtra per aplicacions o usuaris concrets, si cal > 3. Exporta els resultats o fes-ne una captura de pantalla per a la documentació > [accordion] Investigació de seguretat > > Si sospites que hi ha hagut accés no autoritzat: > > 1. Cerca el correu electrònic de l'usuari afectat o les adreces IP sospitoses > 2. Filtra per un rang de dates al voltant de l'incident sospitat > 3. Busca patrons inusuals: intents d'autenticació fallits, endpoints inesperats, hores estranyes > [accordion] Depuració d'integracions > > Quan resolguis problemes d'integració de l'API: > > 1. Cerca la ruta concreta de l'endpoint > 2. Filtra per codis d'estat `4xx` o `5xx` per trobar errors > 3. Anota les marques de temps per correlacionar-les amb els registres de la teva aplicació > [accordion] Revisió de l'activitat de l'equip > > Monitoritza com fa servir l'equip la plataforma: > > 1. Filtra pels correus electrònics de membres concrets de l'equip > 2. Revisa a quines sessions i funcionalitats han accedit > 3. Assegura't que els membres de l'equip segueixen els procediments adequats *** ## Bones pràctiques 1. **Revisions periòdiques**: revisa periòdicament els registres d'auditoria per detectar anomalies aviat. 2. **Cerca acotada**: fes servir filtres concrets per reduir el soroll i trobar les entrades rellevants més ràpidament. 3. **Rangs de dates**: especifica sempre un rang de dates per obtenir un millor rendiment amb conjunts de dades grans. 4. **Desa les cerques**: desa les combinacions de filtres habituals com a marcadors del navegador per accedir-hi ràpidament. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.