Basic Authentication | Effect Http Client

HTTP Basic Authentication is one of the simplest authentication schemes defined in the HTTP specification. The client sends a username and password, combined and Base64-encoded, in the Authorization header. The header format is Authorization: Basic <base64(username:password)>. Because the credentials are only encoded (not encrypted), Basic Auth should only be used over HTTPS.

HttpClientRequest.basicAuth() handles the encoding for you:

1
import {
2
  FetchHttpClient,
3
  HttpClient,
4
  HttpClientRequest,
5
} from "effect/unstable/http";
6
import { Effect } from "effect";
7

8
function fetchWithBasicAuth() {
9
  return Effect.gen(function* () {
10
    const client = yield* HttpClient.HttpClient;
11

12
    const request = HttpClientRequest.get(
13
      "https://httpbin.org/basic-auth/admin/secret123",
14
    ).pipe(HttpClientRequest.basicAuth("admin", "secret123"));
15

16
    const response = yield* client.execute(request);
17
    const data = yield* response.json;
18

19
    return data;
20
  }).pipe(Effect.provide(FetchHttpClient.layer));
21
}
22

23
// Test it
24
Effect.runPromise(fetchWithBasicAuth()).then((data) => {
25
  console.log("Auth result:", data);
26
});

Output:

1
Auth result: { authenticated: true, user: 'admin' }

basicAuth(username, password) Base64-encodes the credentials and sets the Authorization header to Basic <encoded>. You never need to handle the encoding yourself.

Stay in the loop