All files / src/synapse authProvider.ts

95% Statements 38/40
86.36% Branches 19/22
100% Functions 10/10
97.29% Lines 36/37

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137                            6x     1x 2x   1x 1x   1x             1x           9x                                               1x           6x 6x   6x 6x               6x 3x 3x         3x 3x           3x           4x 4x 4x 4x       1x 1x   1x 1x 1x   1x   1x             3x   2x   1x     2x 2x     2x        
import { AuthProvider, Options } from "react-admin";
 
import storage from "../storage";
import { buildUrl, clearStoredAuth, fetchJson, fetchJsonWithAuth, normalizeBaseUrl, splitMxid } from "./synapse";
 
/** Credentials accepted by the react-admin login form and SSO callback flow. */
interface LoginParams {
  base_url: string;
  loginToken?: string | null;
  password?: string | null;
  username?: string | null;
}
 
/** Use token presence as the single source of truth for auth state inside the admin shell. */
const hasAccessToken = (): boolean => typeof storage.getItem("access_token") === "string";
 
/** Build the lightweight identity object react-admin expects from locally cached login data. */
const getStoredIdentity = () => {
  if (!hasAccessToken()) return null;
 
  const userId = storage.getItem("user_id");
  Iif (!userId) return null;
 
  return {
    id: userId,
    fullName: splitMxid(userId)?.name ?? userId,
  };
};
 
/** Build the login request body for a given device_id and credential set. */
const buildLoginBody = (
  deviceId: string | null,
  loginToken: string | null | undefined,
  username: string | null | undefined,
  password: string | null | undefined
): string =>
  JSON.stringify(
    Object.assign(
      {
        device_id: deviceId,
        initial_device_display_name: "Synapse Admin",
      },
      loginToken
        ? {
            type: "m.login.token",
            token: loginToken,
          }
        : {
            type: "m.login.password",
            user: username,
            password: password,
            identifier: {
              type: "m.id.user",
              user: username,
            },
          }
    )
  );
 
/** React-admin auth provider backed by Synapse password login and token-based SSO callbacks. */
const authProvider: AuthProvider = {
  /** Exchange credentials for an access token and persist the resulting session locally. */
  login: async ({ base_url, username, password, loginToken }: LoginParams) => {
    // use the base_url from login instead of the well_known entry from the
    // server, since the admin might want to access the admin API via some
    // private address
    const normalizedBaseUrl = normalizeBaseUrl(base_url);
    storage.setItem("base_url", normalizedBaseUrl);
 
    const loginUrl = buildUrl(normalizedBaseUrl, "/_matrix/client/r0/login");
    const storedDeviceId = storage.getItem("device_id");
 
    let json: Record<string, string>;
 
    // When a stored device_id exists, the server may reject the login if the
    // device was externally revoked (e.g. via Element "Remove Device").  In
    // that case, retry without the stale device_id so the server assigns a
    // fresh one.  See https://github.com/Awesome-Technologies/synapse-admin/issues/757
    if (storedDeviceId) {
      try {
        ({ json } = await fetchJson(loginUrl, {
          method: "POST",
          body: buildLoginBody(storedDeviceId, loginToken, username, password),
        }));
      } catch {
        storage.removeItem("device_id");
        ({ json } = await fetchJson(loginUrl, {
          method: "POST",
          body: buildLoginBody(null, loginToken, username, password),
        }));
      }
    } else {
      ({ json } = await fetchJson(loginUrl, {
        method: "POST",
        body: buildLoginBody(null, loginToken, username, password),
      }));
    }
 
    storage.setItem("home_server", json.home_server);
    storage.setItem("user_id", json.user_id);
    storage.setItem("access_token", json.access_token);
    storage.setItem("device_id", json.device_id);
  },
  /** Revoke the server session when possible and always clear local auth state afterwards. */
  logout: async () => {
    const access_token = storage.getItem("access_token");
    const baseUrl = storage.getItem("base_url");
 
    Eif (typeof access_token === "string" && baseUrl) {
      try {
        await fetchJsonWithAuth(buildUrl(baseUrl, "/_matrix/client/r0/logout"), { method: "POST" });
      } finally {
        clearStoredAuth();
      }
      return;
    }
 
    clearStoredAuth();
  },
  /** Treat 401/403 responses as an expired or invalid session. */
  checkError: ({ status }: { status: number }) =>
    status === 401 || status === 403 ? Promise.reject() : Promise.resolve(),
  /** Guard protected routes by checking whether a session token is cached locally. */
  checkAuth: async () => (hasAccessToken() ? Promise.resolve() : Promise.reject()),
  /** Synapse Admin currently does not model separate permission payloads. */
  getPermissions: () => Promise.resolve(),
  /** Expose the cached user ID so react-admin can render identity-aware UI. */
  getIdentity: () => {
    const identity = getStoredIdentity();
    return identity ? Promise.resolve(identity) : Promise.reject();
  },
  /** Keep access checks aligned with the current all-or-nothing authenticated admin model. */
  canAccess: async () => hasAccessToken(),
};
 
export default authProvider;