Programming

I'd recommend having a username/client id just because that way if/when you have multiple clients, they won't all be sharing a common secret key. Also, you can have different sets of permissions for different clients.

Also, it's important for APIs to take steps to mitigate replay attacks.

Basically, the idea is that you have a secret key that both the server and client know. The client includes a "token" with each request. The token is generated by appending a current timestamp to the secret key, hashing the result, and then appending the client id and the same timestamp to the secret key. The server checks that the timestamp is within a certain amount of time ago and if not rejects the request. (Say, 30 seconds. This does require that the client and server's clocks are synced, but that's usually not an issue in today's world.) The server then uses the client id to look up the secret key for that particular client, appends the timestamp provided, hashes the same way the client did, and checks that the hashes match. If they don't the server rejects the request.

Example:

• The folks on the server side provide to the client a client id and secret key and save a copy of it in the server's config. I'll use "client_1" and "53cr37" as examples, but for a real case, the secret key ought to have about 256 bits of entropy.
• The client gets a current timestamp. I'll use "1692640316"
• The client appends the timestamp to the secret key. "53cr37:1692640316"
• The client hashes the result. I'll use base16-encoded sha256 for this example, but in the real world, I'd probably go for base64-encoded sha512. "63e9a1e333282b89776962b3f17e20b7fce7a0d5735c013dffc85abd5e964850"
• The client then appends the client id and timestamp to the hash: "63e9a1e333282b89776962b3f17e20b7fce7a0d5735c013dffc85abd5e964850:client_1:1692640316"
• The client submits this string to the server in a header with their request. "Authorization: TOKEN 63e9a1e333282b89776962b3f17e20b7fce7a0d5735c013dffc85abd5e964850:client_1:1692640316"
• The server receives the request, gets a current timestamp, and compares it against the timestamp at the end of that string. If the timestamp in the request is more than 30 seconds different from the server's current time, the server rejects the request.
• The server looks up the secret key ("53cr37") for the client "client_1", appends the timestamp, hashes the result, and compares it to the hash in the request. The server then honors the request only if the hashes match.

The reason why this mitigates replay attacks is the 7th step there. If one hash gets intercepted, a bad actor can wreak havoc for 30 seconds (or, rather, however long you tune it to, balancing security concerns with any risks involved with things breaking because of clock drift or latency), but no more. With just a client id and secret key, the bad actor could wreak havoc until the dev team managed to notice something was up and change the secret key.

The reason the timestamp has to be included in the hashed value is because if only the secret key was included, the hash would never change. Then if the hash was intercepted once, you'd be back to the situation of a bad actor wreaking havoc until the dev team manually changed the secret key.

Also, given that you're hashing the secret key, the secret key isn't in the request and cannot be determined from intercepted requests.

(Of course, if a bad actor roots a box and is able to get the secret key value itself, they can then generate valid hashes/tokens to their heart's content until the dev team changes the secret key, but that's not the sort of thing this authentication scheme is meant to protect against.)

Edit: One more thing to mention here. Keep in mind that it's not going to be terribly easy to go changing your authentication method later. If you want to change how authentication works, you'll have to go to all clients and get them to change how they make requests. This is one of those cases where futureproofing is warranted. Better to do it "right" and with features that should mostly work for your purposes for the foreseeable future. Even if you don't know that you'll have multiple clients right now, it's good to plan as if you might some day.

Also, aside from the security implications related to having client ids in the requests, the client id can also be used to track things like resource usage or TPS on a per-client basis. Which is really handy when your app is overwhelmed at 3:00am and you need to tell the client to ease off. You'll only know which client to talk to if you can track that kind of information on a per-client basis.