{"id":899186,"date":"2026-10-14T16:03:52","date_gmt":"2026-10-14T16:03:52","guid":{"rendered":"https:\/\/www.ninjaone.com\/blog\/servidor-api-ninjaone\/"},"modified":"2026-10-14T16:03:53","modified_gmt":"2026-10-14T16:03:53","slug":"servidor-api-ninjaone","status":"publish","type":"post","link":"https:\/\/www.ninjaone.com\/es\/blog\/servidor-api-ninjaone\/","title":{"rendered":"C\u00f3mo configurar un servidor API en NinjaOne"},"content":{"rendered":"<p><iframe title=\"How to Set Up an API Server\" width=\"800\" height=\"450\" src=\"https:\/\/www.youtube.com\/embed\/nuXa-bn32Iw?start=4&amp;feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe><\/p>\n<p>Si est\u00e1s creando automatizaciones que llaman a la API de NinjaOne o extrayendo datos de herramientas como Microsoft Defender o Tenable, necesitas un sitio donde ejecutar esos scripts y otro donde guardar las credenciales que utilizan. Hacerlo desde cualquier estaci\u00f3n de trabajo o desde tu propia cuenta de t\u00e9cnico es la v\u00eda m\u00e1s r\u00e1pida para que las credenciales acaben filtradas o se usen de formas que no puedes rastrear con facilidad.<\/p>\n<p>Un servidor API resuelve este problema. Es un dispositivo Windows dedicado, aislado en su propia organizaci\u00f3n y rol, que guarda tus credenciales de API en campos personalizados seguros que solo pueden ver los administradores del sistema. Esta gu\u00eda te explica c\u00f3mo configurarlo desde cero.<\/p>\n<h2>Requisitos del servidor API de NinjaOne<\/h2>\n<p>Necesitar\u00e1s:<\/p>\n<ul>\n<li>Un dispositivo o m\u00e1quina virtual con Windows. Puede ser f\u00edsico, una VM de HyperV o una VM en el cloud; lo que importa es el sistema operativo.<\/li>\n<li>Acceso como administrador del sistema en NinjaOne.<\/li>\n<li>Una lista clara de los servicios con los que quieres que interact\u00fae este servidor (como m\u00ednimo, la API de NinjaOne, m\u00e1s cualquier otro como Defender o Tenable).<\/li>\n<\/ul>\n<p>El \u00fanico requisito imprescindible: nadie salvo los administradores del sistema de NinjaOne deber\u00eda tener acceso a este dispositivo. Va a guardar credenciales con permisos de nivel administrador del sistema.<\/p>\n<h2>Paso a paso: c\u00f3mo configurar tu servidor API<\/h2>\n<h3>Paso 1: crea una organizaci\u00f3n dedicada<\/h3>\n<p>Crea una organizaci\u00f3n nueva para alojar tu servidor API. As\u00ed queda totalmente separado del resto de tus organizaciones y no aparece mezclado con datos reales de clientes o endpoints.<\/p>\n<p>Para crear una organizaci\u00f3n nueva:<\/p>\n<p>Haz clic en el \u00ab+\u00bb de la esquina superior derecha &gt; selecciona <strong>Organizaci\u00f3n<\/strong> &gt; ponle un nombre como <strong>\u00abAPI Server\u00bb<\/strong> &gt; haz clic en <strong>Guardar<\/strong> en la esquina superior derecha.<\/p>\n<h3>Paso 2: crea un rol de dispositivo personalizado<\/h3>\n<p>Ve a <strong>Administraci\u00f3n &gt; Dispositivos &gt; Roles<\/strong>.<\/p>\n<p>Haz clic en <strong>Sistemas Windows<\/strong> para desplegarlo &gt; pasa el cursor sobre Windows Server (o <strong>Equipos de escritorio y port\u00e1tiles Windows<\/strong>, si tu servidor API funciona con Windows 11) y haz clic en los tres puntos &gt; haz clic en <strong>A\u00f1adir rol secundario<\/strong>.<\/p>\n<p>Ponle al rol el nombre <strong>\u00abAPI Server\u00bb<\/strong> y cr\u00e9alo bajo el rol principal que corresponda a tu sistema operativo.<\/p>\n<h3>Paso 3: crea campos personalizados seguros<\/h3>\n<p>Sin salir de la p\u00e1gina Roles, en la parte izquierda ve a <strong>Campos personalizados de dispositivo<\/strong> y crea tres campos nuevos, todos con el tipo de campo <strong>Seguro<\/strong>.<\/p>\n<p>Haz clic en <strong>A\u00f1adir campo personalizado<\/strong> &gt; selecciona <strong>Seguro<\/strong> &gt; en la etiqueta introduce <strong>\u00abNinjaOne Instance\u00bb<\/strong>.<\/p>\n<p>En la parte izquierda ve a <strong>Permisos<\/strong> &gt; establece <strong>Automatizaciones en Solo lectura<\/strong> &gt; establece <strong>API<\/strong> en <strong>Ninguno<\/strong> &gt; establece el <strong>acceso de todos los t\u00e9cnicos<\/strong> en <strong>Editable<\/strong> &gt; haz clic en <strong>Enviar<\/strong>.<\/p>\n<p>Repite exactamente el mismo proceso para los dos campos siguientes, cambiando solo las etiquetas:<\/p>\n<ul>\n<li><strong>NinjaOne Client ID<\/strong><\/li>\n<li><strong>NinjaOne Client Secret<\/strong><\/li>\n<\/ul>\n<p>Pon las etiquetas exactamente como aparecen arriba. NinjaOne convierte la etiqueta en un nombre de campo en camelCase de forma autom\u00e1tica, y ese nombre distingue entre may\u00fasculas y min\u00fasculas cuando lo referencias despu\u00e9s en un script.<\/p>\n<p>Establece el permiso de <strong>API<\/strong> en <strong>Ninguno<\/strong> en los tres campos. No hay ning\u00fan motivo para dar acceso a nivel de API a un campo que almacena justamente las credenciales que autentican tus llamadas a la API.<\/p>\n<p><strong>Consejo:<\/strong> si tienes previsto extraer datos de otros servicios como Defender o Tenable, repite este proceso y crea campos personalizados seguros dedicados para las credenciales de cada uno.<\/p>\n<h3>Paso 4: asigna los campos a tu rol<\/h3>\n<p>Vuelve a <strong>Roles<\/strong> en la parte izquierda &gt; despliega <strong>Sistemas Windows<\/strong> &gt; despliega tu rol principal &gt; busca <strong>API Server<\/strong> y haz clic en los tres puntos de la derecha &gt; haz clic en <strong>Editar<\/strong>.<\/p>\n<p>Haz clic en <strong>Gestionar pesta\u00f1as<\/strong> en la esquina superior derecha &gt; haz clic en <strong>A\u00f1adir pesta\u00f1a<\/strong> y crea una pesta\u00f1a nueva (por ejemplo, <strong>\u00abAPI Credentials\u00bb<\/strong>) &gt; una vez creada, haz clic en el desplegable de la esquina superior derecha y cambia a la pesta\u00f1a nueva &gt; en la barra de b\u00fasqueda de la izquierda escribe <strong>\u00abNinjaOne\u00bb<\/strong> &gt; a\u00f1ade los tres campos personalizados seguros creados en el paso 3 &gt; haz clic en <strong>Guardar cambios<\/strong> en la esquina superior derecha.<\/p>\n<h3>Paso 5: crea y aplica tu pol\u00edtica<\/h3>\n<p>Ve a <strong>Pol\u00edticas<\/strong> &gt; haz clic en <strong>A\u00f1adir pol\u00edtica de agente<\/strong> &gt; ponle el nombre <strong>\u00abAPI Server\u00bb<\/strong> &gt; en Rol selecciona el rol de Windows Server (o Windows Desktop) bajo el que creaste el rol personalizado &gt; haz clic en <strong>Crear<\/strong> &gt; cuando se abra, haz clic en <strong>Cerrar<\/strong> en la esquina superior derecha.<\/p>\n<p>A continuaci\u00f3n, ve a <strong>Organizaciones<\/strong> &gt; selecciona tu organizaci\u00f3n <strong>API Server<\/strong> &gt; haz clic en <strong>Pol\u00edticas<\/strong> en la parte izquierda &gt; busca la fila de <strong>API Server<\/strong> y abre el desplegable &gt; asigna la pol\u00edtica que acabas de crear &gt; haz clic en <strong>Guardar<\/strong> en la esquina superior derecha &gt; una vez guardado, haz clic en <strong>Cerrar<\/strong>.<\/p>\n<h3>Paso 6: crea una categor\u00eda de automatizaci\u00f3n<\/h3>\n<p>En <strong>Administraci\u00f3n<\/strong>, ve a <strong>Biblioteca<\/strong> &gt; haz clic en <strong>Automatizaci\u00f3n<\/strong> en la parte izquierda &gt; selecciona la pesta\u00f1a <strong>Categor\u00edas<\/strong> &gt; haz clic en <strong>Crear categor\u00eda<\/strong> en el extremo derecho &gt; ponle un nombre como <strong>\u00abAPI Scripts\u00bb<\/strong> &gt; haz clic en <strong>Crear<\/strong>.<\/p>\n<p>As\u00ed mantienes organizados tus scripts relacionados con la API y tienes una categor\u00eda que despu\u00e9s puedes restringir solo a los administradores del sistema.<\/p>\n<h3>Paso 7: instala el agente<\/h3>\n<p>Descarga el instalador del agente de NinjaOne para tu organizaci\u00f3n API Server y ejec\u00fatalo en tu dispositivo o VM dedicados. Si vas a reutilizar un dispositivo existente, mu\u00e9velo a la organizaci\u00f3n API Server, actualiza su rol y confirma que la pol\u00edtica <strong>API Server<\/strong> se aplica mediante la nueva asignaci\u00f3n.<\/p>\n<p>En NinjaOne, haz clic en el signo <strong>\u00ab+\u00bb<\/strong> de la esquina superior derecha &gt; haz clic en <strong>Dispositivo<\/strong> &gt; haz clic en <strong>Ordenador<\/strong> &gt; selecciona tu organizaci\u00f3n <strong>API Server<\/strong> y el rol de servidor API &gt; haz clic en <strong>Generar instalador<\/strong> &gt; despu\u00e9s descarga el instalador o copia el enlace y ejec\u00fatalo en tu dispositivo.<\/p>\n<p>Espera a que el dispositivo se registre por completo antes de continuar.<\/p>\n<p>Si vas a reutilizar un dispositivo existente, puedes hacerlo desde la cuadr\u00edcula de b\u00fasqueda de dispositivos:<\/p>\n<p>En el panel de navegaci\u00f3n azul de la izquierda, selecciona la <strong>pesta\u00f1a Dispositivos<\/strong> &gt; en la lista de dispositivos, busca el dispositivo existente &gt; marca la casilla junto al nombre del dispositivo &gt; haz clic en <strong>Editar<\/strong> &gt; haz clic en <strong>Organizaci\u00f3n\/Ubicaci\u00f3n<\/strong> y cambia a la organizaci\u00f3n <strong>API Server<\/strong> &gt; haz clic en <strong>Actualizar<\/strong><\/p>\n<p>Con el dispositivo a\u00fan seleccionado, haz clic en <strong>Editar<\/strong> &gt; haz clic en <strong>Rol de dispositivo<\/strong> y elige el rol personalizado <strong>API<\/strong> &gt; haz clic en <strong>Actualizar<\/strong>.<\/p>\n<p>Con el dispositivo a\u00fan seleccionado, haz clic en <strong>Editar<\/strong> &gt; haz clic en <strong>Pol\u00edtica<\/strong> y elige la pol\u00edtica <strong>API<\/strong> Server &gt; haz clic en <strong>Actualizar<\/strong>.<\/p>\n<h3>Paso 8: crea las credenciales de API<\/h3>\n<p>Una vez conectado tu dispositivo, ve a <strong>Administraci\u00f3n &gt; Aplicaciones &gt; API<\/strong> y haz clic en <strong>A\u00f1adir aplicaci\u00f3n cliente<\/strong> en la esquina superior derecha.<\/p>\n<p>Selecciona <strong>API Services (machine-to-machine)<\/strong> y crea una aplicaci\u00f3n cliente con:<\/p>\n<ul>\n<li>Scopes: Monitoring and Management<\/li>\n<li>Tipo de concesi\u00f3n: Client credentials<\/li>\n<li>URL de redirecci\u00f3n: d\u00e9jala vac\u00eda<\/li>\n<\/ul>\n<p>Haz clic en <strong>A\u00f1adir<\/strong>. NinjaOne generar\u00e1 un client ID y un client secret.<\/p>\n<h3>Paso 9: rellena tus campos personalizados<\/h3>\n<p>Copia el client ID y el client secret de la aplicaci\u00f3n que acabas de crear &gt; ve a tu dispositivo API Server &gt; pasa el cursor sobre la pesta\u00f1a personalizada y selecciona la pesta\u00f1a <strong>API Credentials<\/strong> &gt; haz clic en el icono de edici\u00f3n del extremo derecho &gt; pega el client ID y el client secret en los campos correspondientes.<\/p>\n<p>En el campo de instancia, introduce tu regi\u00f3n de NinjaOne (la encontrar\u00e1s en la URL de inicio de sesi\u00f3n):<\/p>\n<ul>\n<li>app.ninjarmm.com o us2 para instancias de EE. UU.<\/li>\n<li>ca.ninjarmm.com para instancias de Canad\u00e1<\/li>\n<li>eu.ninjarmm.com para instancias de Europa<\/li>\n<li>oc.ninjarmm.com para instancias del sudeste de Asia-Pac\u00edfico<\/li>\n<li>jp.ninjarmm.com para instancias de Jap\u00f3n<\/li>\n<li>fed.ninjarmm.com para instancias FedRAMP Moderate<\/li>\n<\/ul>\n<p><strong>Consejo:<\/strong> estos nombres de campo distinguen entre may\u00fasculas y min\u00fasculas una vez convertidos a camelCase (<strong>ninjaoneClientId<\/strong>, <strong>ninjaoneClientSecret<\/strong>, <strong>ninjaoneInstance<\/strong>). Si tus scripts referencian los campos y no devuelven nada al ejecutarse, comprueba que las etiquetas coinciden exactamente.<\/p>\n<p>Cuando hayas rellenado y probado tus credenciales, vuelve a <strong>Administraci\u00f3n &gt; Dispositivos &gt; Campos personalizados de dispositivo &gt; busca \u00abninjaone\u00bb<\/strong> y haz clic en el nombre de los campos para cambiar el permiso de <strong>acceso de todos los t\u00e9cnicos<\/strong> en los tres campos de <strong>Editable<\/strong> a <strong>Solo lectura<\/strong>, de modo que los valores no puedan modificarse despu\u00e9s de la configuraci\u00f3n.<\/p>\n<h3>Paso 10: restringe el acceso de los t\u00e9cnicos<\/h3>\n<p>Este es el paso que hace que la configuraci\u00f3n sea segura. Sin \u00e9l, cualquier t\u00e9cnico puede ver credenciales con acceso de nivel administrador del sistema.<\/p>\n<p>Ve a <strong>Administraci\u00f3n &gt; Cuentas &gt; Roles de t\u00e9cnico<\/strong>.<\/p>\n<p>Para cada rol de t\u00e9cnico que no deba tener acceso (en la mayor\u00eda de los casos, todos excepto los administradores del sistema):<\/p>\n<p>Haz clic en el rol que quieras para abrir el editor &gt; ve a <strong>Organizaciones<\/strong> en la parte izquierda.<\/p>\n<ul>\n<li>En Organizaciones, establece la organizaci\u00f3n API Server en Sin acceso.<\/li>\n<li>En Dispositivos, establece el rol API Server en Sin acceso.<\/li>\n<li>En Pol\u00edticas, establece la pol\u00edtica API Server en Sin acceso.<\/li>\n<li>En la biblioteca de automatizaci\u00f3n, establece tu categor\u00eda API Scripts en Sin acceso<\/li>\n<\/ul>\n<p>C\u00f3mo verificar la configuraci\u00f3n de tu servidor API Cuando hayas terminado, deber\u00edas tener:<\/p>\n<ul>\n<li>Una organizaci\u00f3n dedicada que contiene un solo dispositivo: tu servidor API.<\/li>\n<li>Un rol personalizado con campos seguros que almacenan tu client ID, tu client secret y tu instancia.<\/li>\n<li>Una pol\u00edtica aplicada \u00fanicamente a esa organizaci\u00f3n.<\/li>\n<li>Una categor\u00eda de automatizaci\u00f3n restringida para tus scripts de API.<\/li>\n<li>Todos los roles de t\u00e9cnico sin privilegios de administrador bloqueados para ver la organizaci\u00f3n, el rol de dispositivo, la pol\u00edtica y la categor\u00eda de automatizaci\u00f3n.<\/li>\n<\/ul>\n<p>Si un t\u00e9cnico de nivel 1 puede entrar en la organizaci\u00f3n API Server y ver algo, vuelve al paso 10.<\/p>\n<h2>Por qu\u00e9 esto importa<\/h2>\n<p>Las credenciales de API con el tipo de concesi\u00f3n client credentials tienen mucho peso. Seg\u00fan los scopes que selecciones, quien las tenga puede leer y escribir datos en todo tu entorno de NinjaOne. Guardar esas credenciales en un campo personalizado sin protecci\u00f3n, en un dispositivo compartido, o dejarlas visibles para todos los t\u00e9cnicos convierte una configuraci\u00f3n de automatizaci\u00f3n \u00fatil en un riesgo.<\/p>\n<p>Crear un servidor API dedicado te llevar\u00e1 unos veinte minutos la primera vez. A cambio obtienes una estructura limpia y auditable: un \u00fanico sitio para las credenciales, una pol\u00edtica que las gobierna y un modelo de permisos de t\u00e9cnico que mantiene todo el conjunto bien restringido. Una vez creado, a\u00f1adir una integraci\u00f3n nueva es tan sencillo como crear unos cuantos campos personalizados m\u00e1s y dejar el script en tu categor\u00eda API Scripts.<\/p>\n<p>Algunos ejemplos de para qu\u00e9 se utiliza esta configuraci\u00f3n:<\/p>\n<p>Importar datos de vulnerabilidades desde Microsoft Defender, para que los resultados de los an\u00e1lisis lleguen directamente a NinjaOne en lugar de quedarse en una consola aparte.<br \/>\n<a href=\"https:\/\/github.com\/jeffhunterninja\/NinjaOne-Scripts\/tree\/main\/Vulnerability%20Import\/Microsoft%20Defender\" target=\"_blank\" rel=\"noopener\">Importaci\u00f3n de vulnerabilidades de Microsoft Defender<\/a><\/p>\n<p>Informes sobre parches del SO Windows, con el estado de los parches de todo tu entorno reunido en una vista consolidada.<br \/>\n<a href=\"https:\/\/www.ninjaone.com\/Windows%20OS%20patch%20reporting\">Informes sobre parches del SO Windows<\/a><\/p>\n<p>Sincronizaci\u00f3n del estado de los parches, para mantener los datos de parches actualizados entre NinjaOne y otra fuente de verdad en lugar de depender de comprobaciones manuales.<br \/>\n<a href=\"https:\/\/github.com\/jeffhunterninja\/NinjaOne-Scripts\/tree\/main\/Patch%20Status%20Sync\" target=\"_blank\" rel=\"noopener\">Sincronizaci\u00f3n del estado de los parches<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Si est\u00e1s creando automatizaciones que llaman a la API de NinjaOne o extrayendo datos de herramientas como Microsoft Defender o Tenable, necesitas un sitio donde ejecutar esos scripts y otro donde guardar las credenciales que utilizan. Hacerlo desde cualquier estaci\u00f3n de trabajo o desde tu propia cuenta de t\u00e9cnico es la v\u00eda m\u00e1s r\u00e1pida para [&hellip;]<\/p>\n","protected":false},"author":35,"featured_media":857219,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[3023],"tags":[],"class_list":["post-899186","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-it-documentation"],"acf":[],"modified_by":null,"_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/posts\/899186","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/users\/35"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/comments?post=899186"}],"version-history":[{"count":1,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/posts\/899186\/revisions"}],"predecessor-version":[{"id":899187,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/posts\/899186\/revisions\/899187"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/media\/857219"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/media?parent=899186"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/categories?post=899186"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/tags?post=899186"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}