The Bureau of Adversarial Dossiers and Securely Encrypted Code (
has asked you to retrieve a list of VIP users.
Fortunately, BADSEC provides an API to the agency you've been working with. Unfortunately, it's not the best API in the world.
Your job is to write a program that securely and politely asks the BADSEC server for this list of users and prints it to stdout in JSON format.
As the server that your application will be hitting is not well written, you should seek to minimize the amount of communication it does. Furthermore, you should write a client that is resilient to errors in the server.
We will want to build and run your code from source, so please include the complete instructions for doing so in a COMMENTS file.
Your application should output a JSON-formatted list of user ids to stdout:
["9757263792576857988", "7789651288773276582", "16283886502782682407", "...etc"]
Your application should exit with a status code of zero on success, and nonzero on failure.
Log as much as you want to stderr, but make sure that stdout includes only the JSON output of your program if there is any; otherwise the results won't parse properly.
Ensure that you have docker installed on your system.
The BADSEC server will run on port 8888. You can start it with:
docker run --rm -p 8888:8888 adhocteam/noclist
You should see
Listening on http://0.0.0.0:8888.
If you have any trouble getting the server running, or any other questions about this homework, use the chat button in the lower right to contact us.
You may treat a dropped connection or any response code other than 200 as a failure.
Keep in mind that both the
/users endpoints may fail.
If a call to an endpoint fails, you should retry up to 2 times. If the call fails 3 times in a row, your application should exit with a non-zero status code to indicate failure.
Avoid off by one errors! The correct sequence is:
try -> fail -> retry -> fail -> retry -> exit if fail
The server you have been given is just a demonstration server; it should not throw any errors.
The production server your code will run against after you submit it will return non-200 responses and randomly drop connections; your code should be able to handle those errors.
BADSEC server requires you to authenticate yourself by signing all requests
with a provided auth token.
To get the token, the first thing your application should do is call
This endpoint will return a token you can use to generate the checksum for the
subsequent user list call.
If you have any questions about authenticating, use the chat button in the lower right to contact us.
To request the user list, you will need to provide a checksum in the
X-Request-Checksum header. To calculate this checksum, you should compute:
sha256(<auth_token> + <request path>)
For example, if you had auth token
12345 and were requesting
/users, the checksum would be:
sha256("12345/users") = c20acb14a3d3339b9e92daebb173e41379f9f2fad4aa6a6326a696bd90c67419
and you would include that value as the
X-Request-Checksum header in your request.
Before making further calls to the server, you must first call /auth to get an authentication token. The token will be valid until the server stops or issues another token.
The server will return the authentication token in the
Badsec-Authentication-Token HTTP header.
/auth will invalidate all previous auth tokens you have acquired, so
make sure you use the most recent one.
Note that, for unclear reasons, this API call returns a large amount of useless data in the response body. You should ignore this useless data; you only need the data in the header.
This endpoint will return a list of 64-bit newline-separated user IDs like this one:
9757263792576857988 7789651288773276582 1628388650278268240
Make sure you send the
X-Request-Checksum header to the