Autoryzacja test agenta

Pobranie id nowego test agenta

W pierwszej kolejności należy sprawdzić, czy dane podłączonego test agenta dodały się do bazy danych systemu.

W tym celu należy wykonać żądanie GET do api na adres /api/user/test_agents/. W odpowiedzi powinniśmy otrzymać wiadomość:

{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 1,
            "uuid": "bb70540b-d2b0-4867-b10f-3b2e5b20c50f",
            "name": "worker@bb70540b-d2b0-4867-b10f-3b2e5b20c50f",
            "ip_local": "172.30.10.1",
            "ip_external": "172.30.10.1",
            "status": 3,
            "last_status_change": "2021-04-28T12:11:22.356223+02:00",
            "authorized": false,
            "timestamp_created": "2021-04-28T12:11:22.356223+02:00",
            "version": "2020.12",
            "geo_location_lon": null,
            "geo_location_lat": null,
            "running_monitoring_count": 0,
            "additional_data": {
                "interfaces": {
                    "lo": {
                        "ip": [
                            "127.0.0.1",
                            "::1"
                        ],
                        "mac": "00:00:00:00:00:00",
                        "name": "lo"
                    },
                    "ens3": {
                        "ip": [
                            "172.30.10.1",
                            "fe80::f816:3eff:fe39:8fcb%ens3"
                        ],
                        "mac": "fa:16:3e:39:8f:cb",
                        "name": "ens3"
                    }
                },
                "network_config": "network:\n    ethernets:\n        ens3:\n            dhcp4: true\n            match:\n                macaddress: fa:16:3e:39:8f:cb\n            set-name: ens3\n    version: 2\n    renderer: networkd"
            },
            "release": "0.2.0.dev146"
        }
    ]
}

Jak widać nasz nowy test agent został zapisany w bazie danych z id 1. Jeśli test agenta na nie ma tej liście należy upewnić się, czy test agent jest uruchomiony w tej samej sieci co serwer vUTP.

Zmiana autoryzacji test agenta

Aby mieć możliwość wykonywania dowolnych testów na nowym test agencie należy go autoryzować. Można to zrobić przez wysłanie wiadomości PATCH na adres /api/user/test_agents/<id>/, gdzie jest id test agenta, którego chcemy autoryzować, czyli w naszym przypadku będzie to adres /api/user/test_agents/1/.

W treści wiadomości należy podać informację:

{
    "authorized": true
}

Zmiana pozostałych danych test agenta

Jeśli chcemy zmienić nazwę test agenta lub przypisać mu współrzędne geograficzne należy w treści wiadomości podać:

{
    "name": "new-test-agent",
    "geo_location_lon": 19.8972702026367,
    "geo_location_lat": 50.0760912565959
}

W odpowiedzi na tę wiadomość powinniśmy otrzymać odpowiedź z informacją o aktualnych danych test agenta:

{
    "id": 1,
    "uuid": "bb70540b-d2b0-4867-b10f-3b2e5b20c50f",
    "name": "new-test-agent",
    "ip_local": "172.30.10.1",
    "ip_external": "172.30.10.1",
    "status": 3,
    "last_status_change": "2021-04-28T12:15:31.578153+02:00",
    "authorized": true,
    "timestamp_created": "2021-04-28T12:11:22.356223+02:00",
    "version": "2020.12",
    "geo_location_lon": 19.8972702026367,
    "geo_location_lat": 50.0760912565959,
    "running_monitoring_count": 0,
    "additional_data": {
        "interfaces": {
            "lo": {
                "ip": [
                    "127.0.0.1",
                    "::1"
                ],
                "mac": "00:00:00:00:00:00",
                "name": "lo"
            },
            "ens3": {
                "ip": [
                    "172.30.10.1",
                    "fe80::f816:3eff:fe39:8fcb%ens3"
                ],
                "mac": "fa:16:3e:39:8f:cb",
                "name": "ens3"
            }
        },
        "network_config": "network:\n    ethernets:\n        ens3:\n            dhcp4: true\n            match:\n                macaddress: fa:16:3e:39:8f:cb\n            set-name: ens3\n    version: 2\n    renderer: networkd"
    },
    "release": "0.2.0.dev146"
}

Możliwe statusy test agenta:

• 2 – offline,

• 3 – online.