Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor
newclient
newclient
Neuer Client

URL in Reference im Referenz AMS/new_client/{id}
HTTP MethodMethodePOST

Die BMC notifies AMS of all new clients and this interface is used for that purpose. The intention is that AMS in responds to the notification immediately and then queries what ever systems it needs to in order to decide what kind of job specification needs to be sent, if any. The intention is that this notification contains the minimum amount of information which enables AMS to query for more information, request an asset report or to reset or shutdown the client. An example of the message that is sentbenachrichtigt das AMS über alle neuen Clients, diese Schnittstelle wird für diesen Zweck verwendet. Die Absicht ist, dass das AMS sofort auf die Benachrichtigung reagiert und anschließen abfragt welche Informationen benötigt werden um zu entscheiden welche Art von Job Spezifikation gesendet werden muss, falls eine vorhanden ist. Die Absicht ist, dass diese Benachrichtigung die minimale Menge an Informationen enthält die es dem AMS ermöglichen nach weiteren Informationen zu fragen, einen Hardwarebericht (Asset Report) anzufordern, den Client zurückzusetzen oder herunterzufahren. Ein Beispiel der Nachricht:

Code Block
languagejs
firstline1
linenumberstrue
{
    "new_client": {
            "id": "123e4567-e89b-12d3-a456-426655440000",
            "product": "Blancco5",
            "version": "5.9.0",
            "mac_addresses": [
                "B3-3C-55-8E-7E-E6",
                "E3-3C-55-8E-7E-B6"
            ]
    }
}  

Job

...

Spezifikation Überprüfung

URL in Reference im Referenz AMS/client/{id}/jobspec
HTTP MethodMethodePOST

Once AMS has sent job specification for any given client, BMC passes it on to the Drive Eraser instance. Drive Eraser validates it and BMC informs AMS on it's validity. This interface receives that information. To the extent that it was invalid, both BMC and Drive Eraser will remove the session and start over. AMS will then be informed of the new session as described in the chapter New Client. An example of the messageSobald das AMS eine Job Spezifikation für einen bestimmten Client gesendet hat, gibt die BMC diese an den Drive Eraser weiter. Der Drive Eraser überprüft diese und die BMC informiert das AMS über die Gültigkeit. Diese Schnittstelle empfängt diese Information. Im Falle, dass die Job Spezifikation nicht gültig war, werden sowohl die BMC als auch der Drive Eraser die Sitzung trennen und von vorn beginnen. AMS wird dann über die neue Sitzung informiert, wie im Kapitel Neuer Client beschrieben. Ein Beispiel der Nachricht:

Code Block
languagejs
firstline1
linenumberstrue
 {
    "job_spec": {
        "id": "c44ed942-fab6-4dfe-8b5a-81265e68a8dd",
        "status": "NOT_VALID",
        "message": "I am a reason of failure"
    }
}

Hardwarebericht (Asset Report)

URL in Reference im Referenz AMS/client/{id}/asset_report
HTTP MethodMethodePOST

Once Sobald das AMS has requested BMC to fetch an asset report, it is delivered to this interface. An example messagedie BMC aufgefordert hat einen Hardwarebericht (Asset Report) abzurufen wird er an diese Schnittstelle geliefert. Ein Beispiel der Nachricht:

Code Block
languagejs
firstline1
linenumberstrue
 {
    "client_id": "0d1f2601-7098-4e85-a772-8b3f0fdff5c3",
    "asset_report": {
        "report": "PHJ...DF=="
    }
}

The XML report is encoded with BASE64.

Session Finished

Der XML-Bericht ist mit BASE64 codiert.

Sitzung beendet

URL im Referenz URL in Reference AMS/client/{id}/finished
HTTP MethodMethodePOST

Once session has finished, AMS is notified with this interface. Session is considered finished when

  • AMS instructed Drive Eraser to shutdown
  • AMS instructed Drive Eraser to reset
  • AMS sent an invalid job specification
  • Drive Eraser received a valid job specification, erased the computer, and sent the erasure report

Sobald die Sitzung beendet ist wird das AMS über diese Schnittstelle benachrichtigt. Die Sitzung gilt als beendet wenn

  • das AMS den Drive Eraser herunterfahren lässt
  • das AMS den Drive Eraser neustarten lässt
  • das AMS eine ungültige Job Spezifikation gesendet hat
  • der Drive Eraser eine gültige Job Spezifikation erhalten, den Computer gelöscht und den Löschbericht gesendet hat

Ein Beispiel der NachrichtAn example of the message sent:

Code Block
languagejs
firstline1
linenumberstrue
{
    "client_finished": {
        "id": "123e4567-e89b-12d3-a456-426655440000",
        "report_uuid": "e8b3f8ed-09f4-470b-9d84-6ff5ff6b54c3"
    }
}

...