/ /

Proyectos y usuarios

Usuarios

Docs Home

MongoDB Ops Manager

Crear el primer usuario

Esta versión de la documentación está archivada y ya no se admite. Ver la Documentación actual para aprender cómo actualizar su versión de MongoDB Ops Manager.

Cree el primer usuario de Ops Manager.Puede llamar a este punto final sin tener un Clave API.

Importante

Excepciones

Este punto final no se puede utilizar si Ops Manager utiliza LDAP para autenticación.
Este punto final puede crear el primer usuario solo si Ops Manager se ejecuta en Invitation Only Mode.

Ops Manager otorga el rol GLOBAL_OWNER a la primera clave de API programática de Ops Manager creada a través de este punto de conexión. El documento JSON devuelto incluye la primera clave de API programática, que puede usar para realizar futuras llamadas a la API.

Este punto de conexión no crea proyectos ni organizaciones. Con la nueva clave de API programática que creó, puede llamar al punto de conexión "Crear un proyecto". Este punto de conexión puede crear un proyecto y una organización con una sola llamada a la API. No puede iniciar sesión en Ops Manager hasta que haya creado un proyecto.

Puede utilizar este punto final para crear usuarios adicionales con las siguientes advertencias:

Ops Manager no otorga el rol GLOBAL_OWNER para los usuarios posteriores a menos que agregue el rol a la solicitud de API.
Ops Manager no crea una clave API programática para los usuarios posteriores.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

POST /unauth/users

Parámetros de la ruta de solicitud

Este punto final no utiliza parámetros de ruta de solicitud HTTP.

Parámetros de consulta de solicitud

Nombre	Tipo	Descripción
lista de acceso	string	Dirección IP que desea agregar a la lista de acceso para el primer usuario de Ops Manager. Puede agregar más de un parámetro `accessList` y valor.

Parámetros del cuerpo de la solicitud

Nombre

Tipo

Necesidad

Descripción

username

string

Requerido

Nombre de usuario del primer usuario de Ops Manager. Validado según el valor de la mms.email.validation propiedad:

Valor	Descripción
`false`	(Predeterminado) No es necesario que el nombre de usuario sea una dirección de correoelectrónico.
`loose`	El nombre de usuario debe contener un símbolo `@` seguido de un punto.
`strict`	El nombre de usuario debe cumplir con una estricta expresión regular de validación de dirección de correo electrónico.

Consulta mms.email.validation para obtener más detalles.

El username suele ser una dirección de correo electrónico. Si establece este valor como una dirección de correo electrónico, no necesita establecer el valor emailAddress explícitamente.

password

string

Requerido

Contraseña del primer usuario de Ops Manager. Este campo no se incluye en el cuerpo de la respuesta HTTP. Ops Manager lo envía en la solicitud HTTP solo al crear el primer usuario de Ops Manager.

emailAddress

string

Opcional

Dirección de correo electrónico del primer usuario de Ops Manager.

firstName

string

Requerido

Nombre del primer usuario de Ops Manager.

lastName

string

Requerido

Apellido del primer usuario de Ops Manager.

Respuesta

Nombre	Tipo	Descripción
`programmaticApiKey`	Objeto	Detalles de la primera clave API programática creada en Ops Manager.
`programmaticApiKey` `.desc`	string	Descripción de la primera clave API programática.
`programmaticApiKey` `.id`	string	Identificador único de la primera clave API programática.
`programmaticApiKey` `.links`	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
`programmaticApiKey` `.privateKey`	string	Treinta y un caracteres alfanuméricos y guiones que sirven como contraseña de la primera clave API programática.
`programmaticApiKey` `.publicKey`	string	Seis caracteres alfanuméricos que sirven como nombre de usuario de la primera clave API programática.
`programmaticApiKey` `.roles`	matriz de objetos	Roles asignados a la primera clave API programática.
`programmaticApiKey` `.roles.roleName`	string	Nombre del rol asignado. Ops Manager otorga a la primera clave de API programática el `Global Owner` rol`GLOBAL_OWNER` ().
`user`	Objeto	Detalles del primer usuario de Ops Manager.
`user` `.emailAddress`	string	Dirección de correo electrónico del primer usuario de Ops Manager.
`user` `.firstName`	string	Nombre del primer usuario de Ops Manager.
`user` `.id`	string	Identificador único del primer usuario de Ops Manager.
`user` `.lastName`	string	Apellido del primer usuario de Ops Manager.
`user` `.links`	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
`user` `.mobileNumber`	string	Número de móvil del primer usuario de Ops Manager.
`user` `.roles`	matriz de objetos	Roles asignados al primer usuario de Ops Manager.
`user` `.roles.roleName`	string	Nombre del rol asignado. Ops Manager otorga al primer usuario de Ops Manager el `Global Owner` rol`GLOBAL_OWNER` ().
`user` `.teamIds`	matriz de cadenas	Lista de identificadores únicos para los equipos a los que pertenece el primer usuario de Ops Manager.
`user` `.username`	string	Nombre de usuario del primer usuario de Ops Manager.

Ejemplo de solicitud

curl --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/unauth/users?pretty=true&accessList=1.2.3.4&accessList=2.3.4.5" \
     --data '
       {
         "username": "jane.doe@example.com",
         "password": "Passw0rd.",
         "firstName": "Jane",
         "lastName": "Doe"
       }'

Ejemplo de respuesta

Encabezado de respuesta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 201 Created
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Cuerpo de respuesta

{
  "programmaticApiKey": {
    "desc": "Automatically generated Global API key",
    "id": "{API-KEY}",
    "links": [{
      "href": "http://<OpsManagerHost>:<Port>/api/public/v1.0/orgs/null/apiKeys/{API-KEY}",
      "rel": "self"
    }],
    "privateKey": "private key string",
    "publicKey": "public key string",
    "roles": [{
      "roleName": "GLOBAL_OWNER"
    }]
  },
  "user": {
    "emailAddress": "jane.doe@example.com",
    "firstName": "Jane",
    "id": "{USER-ID}",
    "lastName": "Doe",
    "links": [
      {
       "href" : "https://<OpsManagerHost>:<Port>/api/public/v1.0/users/{USER-ID}",
       "rel" : "self"
      }
    ],
    "roles": [
      {
        "roleName": "GLOBAL_OWNER"
      }
    ],
    "username": "jane.doe@example.com"
  }
}

Volver

Actualizar roles

Borrar