Создание клиента

Необходимые условия

Убедитесь, что у вас есть следующие данные:

  • Учетная запись со статусом «партнер».
  • UUID пользователя и секретный ключ.
  • UUID партнера.

Для создания клиента необходимо выполнить следующие действия:

  1. Создать клиента через Wallarm API.
  2. Привязать созданного клиента к учетной записи партнера.

1. Создайте клиента

  1. Выполните cURL-запрос следующего вида:

    curl -X POST --header "Content-Type: application/json" --header "Accept: application/json" --header "X-WallarmAPI-UUID: ваш UUID пользователя" --header "X-WallarmAPI-Secret: ваш секретный ключ" -d "{
    \"name\": \"название клиента\",
    \"vuln_prefix\": \"префикс уязвимости\",
    \"language\": \"en или ru\",
    \"enabled\": true,
    \"notifications\": {},
    \"mode\": \"monitoring\",
    \"blocking_type\": \"incidents\",
    \"qrator_blacklists\": false,
    \"scanner_mode\": \"off\",
    \"partner_uuid\": \"ваш UUID парнтера\",
    \"qrator_mode\": \"async\",
    \"scanner_state\": {}
    }" "https://api.wallarm.com/v1/objects/client/create"
    

    Где:

    • X-WallarmAPI-UUID: – ваш UUID пользователя.
    • X-WallarmAPI-Secret: – ваш секретный ключ.
    • "name": – название клиента.
    • "vuln_prefix": – префикс уязвимости, который будет использоваться в системе Wallarm для отслеживания и привязке к клиенту. Префикс может состоять из четырех букв или цифр. Создайте префикс по названию клиента. Например, если клиент называется «tenant», задайте «TNNT».
    • "language": – язык веб-интерфейса Wallarm: en или ru.
    • "partner_uuid": – ваш UUID партнера.

    Смотрите также POST /v1/objects/client/create в Wallarm API.

  2. Проверьте результат:

    • 200 – операция прошла успешно.
    • 403 – операция не прошла авторизацию. Убедитесь, что вы указали верные UUID пользователя, секретный ключ, UUID партнера.
    • 400 – операция не прошла. Наиболее вероятная причина в отсутствии необходимых параметров или неверном синтаксисе JSON. Убедитесь, что вы правильно скопировали cURL-запрос.
  3. Скопируйте следующие значения в выводе cURL-запроса:

    • "id":
    • "partnerid":

    Вам понадобятся данные значения для привязки клиента к вашей учетной записи партнера.

Вы создали клиента.

2. Привяжите клиента к вашей учетной записи партнера

  1. Выполните cURL-запрос следующего вида:

    curl -X POST --header "Content-Type: application/json" --header "Accept: application/json" --header "X-WallarmAPI-UUID: ваш UUID пользователя" --header "X-WallarmAPI-Secret: ваш секретный ключ" -d "{
    \"clientid\": ID клиента,
    \"id\": число,
    \"params\": {}
    }" "https://api.wallarm.com/v2/partner/{ID партнера}/partner_client"
    

    Где:

    • X-WallarmAPI-UUID: – ваш UUID пользователя.
    • X-WallarmAPI-Secret: – ваш секретный ключ.
    • "clientid": – значение "id":, которое вы скопировали в конце создания клиента (Шаг 3).
    • "id": – любое число, которые вы будете использовать в качестве идентификатора клиента и для конфигурации клиента. Скопируйте заданное число, поскольку оно вам понадобится позднее.
    • {ID партнера} – ID партнера, которое вы скопировали из "partnerid": на Шаге 3.

    Смотрите также POST/v2/partner/{partnerid}/partner_client в Wallarm API.

  2. Проверьте результат в полe Response Code:

    • 200 – операция прошла успешно.
    • 403 – операция не прошла авторизацию. Убедитесь, что вы указали верные UUID пользователя, секретный ключ, UUID партнера.
    • 400 – операция не прошла. Наиболее вероятная причина в отсутствии необходимых параметров или неверном синтаксисе JSON. Убедитесь, что вы правильно скопировали параметры cURL-запроса.

Вы привязали клиента к вашей учетной записи партнера.

results matching ""

    No results matching ""