Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Esta sección contiene información técnica sobre los complementos Dev Proxy y las opciones de configuración.
¿Qué complemento debo usar para los informes y el análisis?
Utilice la tabla siguiente para elegir el complemento que coincida con lo que quiere saber sobre el tráfico de API de la aplicación. Los complementos que generan un informe necesitan un generador de informes, como JsonReporter, MarkdownReporter o PlainTextReporter, para guardar el informe en un archivo. Los complementos de generador escriben directamente su archivo de salida. Proxy de desarrollo crea los archivos de salida en el directorio de trabajo actual después de que se detenga la grabación.
| Objetivo | Complemento + generador de informes | Archivo de salida |
|---|---|---|
| Haz un inventario de las direcciones URL a las que llama mi aplicación | UrlDiscoveryPlugin + JsonReporter | UrlDiscoveryPlugin_JsonReporter.json |
| Recuento de solicitudes y sus resultados | ExecutionSummaryPlugin + MarkdownReporter o JsonReporter |
ExecutionSummaryPlugin_MarkdownReporter.md o ExecutionSummaryPlugin_JsonReporter.json |
| Capturar solicitudes y respuestas completas | HarGeneratorPlugin | devproxy-yyyyMMddHHmmss.har |
| Crear solicitudes reproducibles | HttpFileGeneratorPlugin | requests_yyyyMMddHHmmss.http |
| Creación de una especificación de API a partir del tráfico | OpenApiSpecGeneratorPlugin o TypeSpecGeneratorPlugin |
host-port-yyyyMMddHHmmss.json (o .yaml) por host de API o name-yyyyMMddHHmmss.tsp por host de API |
| Crear mocks a partir del tráfico | MockGeneratorPlugin | mocks-yyyyMMddHHmmss.json |
| Busca los permisos mínimos que necesita mi aplicación | MinimalPermissionsPlugin + MarkdownReporter o JsonReporter |
MinimalPermissionsPlugin_MarkdownReporter.md o MinimalPermissionsPlugin_JsonReporter.json |
Note
Si ya existe un archivo de informe con el mismo nombre, la aplicación anexa una marca de tiempo al nombre de archivo, por ejemplo UrlDiscoveryPlugin_JsonReporter_yyyyMMddHHmmss.json. Para Microsoft Graph API, usa GraphMinimalPermissionsPlugin para buscar los permisos mínimos.
Complementos
Lista de complementos que funcionan con cualquier API.
| Nombre | Descripción |
|---|---|
| AuthPlugin | Simula la autenticación y autorización mediante claves API u OAuth2. |
| DevToolsPlugin | Expone mensajes Dev Proxy e información sobre solicitudes y respuestas interceptadas en Chrome DevTools. Admite HTTP y STDIO. |
| CachingGuidancePlugin | Muestra una advertencia cuando Dev Proxy intercepta la misma solicitud en el periodo de tiempo especificado. |
| CrudApiPlugin | Simula una API de CRUD con un almacén de datos en memoria. |
| ExecutionSummaryPlugin | Genera un informe resumido de las solicitudes que pasan por el proxy. |
| GenericRandomErrorPlugin | Se produce un error seleccionado aleatoriamente del archivo que contiene errores ficticios. |
| HarGeneratorPlugin | Genera archivos de archivo HTTP (HAR) a partir de las solicitudes y respuestas interceptadas. |
| HttpFileGeneratorPlugin | Genera un archivo HTTP a partir de las solicitudes y respuestas interceptadas. |
| LanguageModelFailurePlugin | Simula varios escenarios de error del modelo de lenguaje para probar la resistencia de las aplicaciones dependientes del modelo de lenguaje. |
| LanguageModelRateLimitingPlugin | Simula la limitación de frecuencia basada en tokens para las API de modelos de lenguaje mediante el seguimiento del consumo de tokens de solicitud y finalización dentro de ventanas de tiempo configurables. |
| LatencyPlugin | Retrasa las respuestas en un número aleatorio de milisegundos del intervalo configurado. Admite HTTP y STDIO. |
| MinimalCsomPermissionsPlugin | Detecta los permisos mínimos necesarios para llamar a las solicitudes API del modelo de objetos del lado del cliente (CSOM) de SharePoint registradas. |
| MinimalPermissionsPlugin | Devuelve los permisos mínimos necesarios para llamar a las solicitudes de API grabadas. Usa la información de la API de la carpeta local especificada. |
| MinimalPermissionsGuidancePlugin | Compara los permisos usados en el token JWT enviado a las API con los ámbitos mínimos necesarios para las solicitudes que el proxy ha registrado y muestra la diferencia. |
| MockGeneratorPlugin | Genera simulaciones de Dev Proxy basadas en las solicitudes interceptadas. |
| MockRequestPlugin | Permite emitir solicitudes web usando Dev Proxy. |
| MockResponsePlugin | Simula respuestas. |
| MockStdioResponsePlugin | Simula respuestas para aplicaciones basadas en STDIO, como servidores MCP. |
| ODataPagingGuidancePlugin | Muestra una advertencia cuando el proxy intercepta una solicitud de paginación de OData mediante una dirección URL que no se ha devuelto previamente en una de las respuestas interceptadas. |
| OpenAIMockResponsePlugin | Simula las respuestas de Azure OpenAI y OpenAI usando un modelo de lenguaje local. |
| OpenAITelemetryPlugin | Genera datos de telemetría para solicitudes de API compatibles con OpenAI. |
| OpenAIUsageDebuggingPlugin | Registra las métricas de uso de la API de OpenAI en un archivo CSV con fines de depuración y análisis. |
| OpenApiSpecGeneratorPlugin | Genera especificaciones de OpenAPI a partir de las solicitudes y respuestas interceptadas. |
| RateLimitingPlugin | Simula comportamientos de límite de velocidad. |
| RetryAfterPlugin | Simula el encabezado Retry-After enviado por una API después de limitar una solicitud. |
| RewritePlugin | Reescribe las solicitudes. |
| TypeSpecGeneratorPlugin | Genera archivos TypeSpec a partir de las solicitudes y respuestas interceptadas. |
| UrlDiscoveryPlugin | Crea una lista de direcciones URL que el proxy ha interceptado. |
Complementos de Azure API Center
Lista de complementos que funcionan con Azure API Center.
| Nombre | Descripción |
|---|---|
| ApiCenterMinimalPermissionsPlugin | Comprueba si la aplicación usa permisos mínimos para llamar a las API. Usa la información de API de la instancia de Azure API Center especificada. |
| ApiCenterOnboardingPlugin | Comprueba si las API usadas en una aplicación están registradas en la instancia de Azure API Center especificada. |
| ApiCenterProductionVersionPlugin | Comprueba si las API usadas en una aplicación son versiones de producción de las API registradas en la instancia de Azure API Center especificada. |
Complementos de Microsoft Entra
Lista de complementos que funcionan con la API de Microsoft Entra.
| Nombre | Descripción |
|---|---|
| EntraMockResponsePlugin | Simula respuestas a Microsoft Entra. |
Complementos de Microsoft Graph
Lista de complementos que funcionan con la API de Microsoft Graph.
| Nombre | Descripción |
|---|---|
| GraphBetaSupportGuidancePlugin | Muestra una advertencia cuando el proxy detecta una solicitud al punto de conexión beta de Microsoft Graph. |
| GraphClientRequestIdGuidancePlugin | Muestra un consejo cuando una solicitud a la API de Microsoft Graph no incluye el encabezado client-request-id. |
| GraphConnectorGuidancePlugin | Muestra orientación contextual para trabajar con conectores de Microsoft Graph. |
| GraphMinimalPermissionsPlugin | Devuelve una lista de los permisos mínimos necesarios para las solicitudes de Microsoft Graph que el proxy ha registrado. |
| GraphMinimalPermissionsGuidancePlugin | Compara los permisos usados en el token JWT enviado a Microsoft Graph con los ámbitos mínimos necesarios para las solicitudes que el proxy ha registrado y muestra la diferencia. |
| GraphMockResponsePlugin | Simula respuestas a las API de Microsoft Graph. |
| GraphRandomErrorPlugin | Se produce un error en las solicitudes realizadas a Microsoft Graph con errores aleatorios. |
| GraphSdkGuidancePlugin | Muestra una sugerencia cuando el proxy intercepta una solicitud a Microsoft Graph que no ha sido emitida por un SDK de Microsoft Graph. |
| GraphSelectGuidancePlugin | Muestra una advertencia cuando el proxy intercepta una solicitud a las API de Microsoft Graph que no incluye el parámetro de cadena de consulta $select. |
| ODSPSearchGuidancePlugin | Muestra una advertencia cuando Dev Proxy detecta una solicitud a las API de búsqueda de OneDrive y SharePoint. |
Informadores
Lista de informadores que generan informes en diferentes formatos.
| Nombre | Descripción |
|---|---|
| JsonReporter | Genera informes en formato JSON. |
| MarkdownReporter | Genera informes en formato Markdown. |
| PlainTextReporter | Genera informes en formato de texto sin formato. |
Configuración
Referencia de las opciones de configuración del proxy de desarrollo.
| Nombre | Descripción |
|---|---|
| devproxyrc | Archivo de configuración para Dev Proxy. |
| Proxy API | API para interactuar con Dev Proxy mediante programación. |
| Configuración de proxy | Opciones de configuración del proxy. |