【Angular】Routerで認証ガードを実装する方法

当ページのリンクには広告が含まれています。
いずみ

こんな悩みを解決できる記事を書きました!

僕は現役フリーランスエンジニア(歴年)で、資格は個保有しています。

AngularのRouterで認証ガードを実装する方法を知りたい」とお考えではありませんか?

ログインしていないユーザーが特定のページにアクセスできてしまい、困っている方へ。

Angular Routerの関数型ガードを使えば、コンポーネント側にロジックを書かずにアクセス制御を一元化することが可能です。

いずみ

認証まわりの実装は複雑になりがちですが、Angular Routerの機能を使えばシンプルにまとめられます。

ということで、本記事ではAngularのRouterで認証ガードを実装する方法を解説します。

いずみ

すぐ読み終わるので、ぜひ最後まで読んでくださいませ。

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式
執筆者/監修者
  • フリーランスエンジニア(保有資格個、企業と直接契約
  • ブログ・アフィリエイト歴7年(2018年〜)
  • ブランドせどりで月利50万円⇨脱サラ
  • 投資(仮想通貨・FX)歴7年(2018年〜)
  • X(旧Twitter)フォロワー約1,900人
  • 運営者情報はこちら
いずみです
目次

【Angular】Routerで認証ガードを実装する方法

早速ですが、AngularのRouterで認証ガードを実装する方法を解説します。

Angular Routerのガードとは

Angular Routerのガードは、特定のルートへの遷移を許可するかどうかを判定する仕組みです。

従来はクラスベースの実装が使われていましたが、現在はinject関数を使った関数型ガード(CanActivateFn)が推奨されています。

関数型ガードはクラスや専用モジュールを用意する必要がなく、シンプルな関数として定義できます。

いずみ

クラスベースのガードも引き続き動作しますが、新規プロジェクトでは関数型ガードを使うのがおすすめです。

認証ガードを実装する

ログイン状態を管理するサービスと、認証ガードを順番に実装します。

STEP
認証状態を管理するサービスを作成する

ログイン状態を保持するAuthServiceを作成します。

import { Injectable, signal } from '@angular/core';

@Injectable({ providedIn: 'root' })
export class AuthService {
  private loggedIn = signal(false);

  isLoggedIn(): boolean {
    return this.loggedIn();
  }

  login(): void {
    this.loggedIn.set(true);
  }

  logout(): void {
    this.loggedIn.set(false);
  }
}
STEP
関数型ガードを作成する

CanActivateFnを使って認証ガードを実装します。

import { inject } from '@angular/core';
import { CanActivateFn, Router } from '@angular/router';
import { AuthService } from './auth.service';

export const authGuard: CanActivateFn = () => {
  const authService = inject(AuthService);
  const router = inject(Router);

  if (authService.isLoggedIn()) {
    return true;
  }

  return router.parseUrl('/login');
};
いずみ

inject関数を使うことで、クラスを作らずにDIコンテナからサービスを取得できます。

STEP
ルート定義にガードを設定する

作成したauthGuardをcanActivateプロパティに設定します。

import { Routes } from '@angular/router';
import { authGuard } from './auth.guard';

export const routes: Routes = [
  {
    path: 'dashboard',
    loadComponent: () =>
      import('./dashboard/dashboard.component').then((m) => m.DashboardComponent),
    canActivate: [authGuard],
  },
  {
    path: 'login',
    loadComponent: () =>
      import('./login/login.component').then((m) => m.LoginComponent),
  },
];

遅延ロードと組み合わせて保護する

loadComponentによる遅延ロードと組み合わせると、未認証ユーザーに対してコンポーネントのダウンロード自体を防ぐことができます。

canActivateはコンポーネントの読み込み後に判定するのに対し、canMatchはルートの一致判定の段階で実行されます。

STEP
CanMatchFnでガードを作成する
import { inject } from '@angular/core';
import { CanMatchFn, Router } from '@angular/router';
import { AuthService } from './auth.service';

export const authMatchGuard: CanMatchFn = () => {
  const authService = inject(AuthService);
  const router = inject(Router);

  if (authService.isLoggedIn()) {
    return true;
  }

  return router.parseUrl('/login');
};
STEP
canMatchプロパティに設定する
{
  path: 'admin',
  loadComponent: () =>
    import('./admin/admin.component').then((m) => m.AdminComponent),
  canMatch: [authMatchGuard],
},

管理者専用ページのように、権限がないユーザーには存在自体を隠したいルートに向いています。

いずみ

canMatchを使うと、権限のないユーザーに管理画面用のJavaScriptチャンクをそもそも配信しないため、セキュリティ面でも有利です。

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式

【厳選】フリーランスエンジニアにおすすめなエージェント3選

フリーランスエンジニアになるにはエージェントから案件をもらう必要があります。

僕が実際に利用しているおすすめエージェントを紹介しますね。

いずみ

エージェントは必ず複数登録してください。

担当者によっては「全然案件紹介してくれない…」みたいなこともあるので…

僕は実際に5つのエージェントを使い回していますよ。

フリーランスを始めるなら「

案件数マージン率単価
約88,000件非公開
初心者福利厚生申し込み
無料
Good Point
  • 業界最大級の案件数。
  • 業界トップクラスの高単価報酬、低マージン(平均年収862万円)。
  • 案件参画中のフォローの充実。

※詳細は「【業界最大手】レバテックフリーランスとは?メリットや利用手順を解説!」を参照。

は業界最大手のフリーランスエージェントです。

とにかく案件数が多いので、とりあえず登録しておけば間違いないエージェントです!

いずみ

僕もはじめてフリーランスの案件を貰ったのはです。

保有している案件数が多いので、業務経験がなくても何かしらの案件は紹介してもらえますよ(僕はJavaの経験3年でも案件を貰えました)。

手厚い保障を重視したいなら「

案件数マージン率単価
約10,000件非公開
初心者福利厚生申し込み
無料
Good Point
  • 手厚い保障で正社員並みの安心感。
  • 還元率60%超え&単価公開でクリアな契約。
  • 給与保障制度(審査あり)。

は手厚い保障が特徴のフリーランスエージェントです。

フリーランスを目指しているけど不安な方や保障を重視したい方におすすめです。

いずみ

僕も何度か案件を紹介してもらいました。

自分のスキルに合った案件を紹介してもらえましたし、電話のやり取りも非常に丁寧でした。

週2〜3日の案件探しなら「

案件数マージン率単価
約5,000件非公開
初心者福利厚生申し込み
経験者向け無料
Good Point
  • IT案件に特化したフリーランスエージェント。
  • 週2〜3日の案件が豊富。
  • リモート案件が多く、直エンドなので単価も高い。

※詳細は「【週2・3案件】ITプロパートナーズとは?メリットや利用手順を解説!」を参照。

はIT案件に特化したフリーランスエージェントです。

週2〜3日から参画できる案件が豊富なので、起業したい人にもおすすめです。

いずみ

週2〜3日の案件はある程度スキルがないと紹介してもらえない印象です。

とはいえ、週5の案件ももちろんありますし、僕が利用した時は迅速・丁寧に対応していただきました!

よくある質問

CanActivateとCanMatchの違いは何ですか?

CanActivateは、ルートが一致したコンポーネントを読み込んだ後にアクセス可否を判定します。

CanMatchは、ルートの一致判定自体に介入するため、権限がない場合はコンポーネント本体を読み込みません。

古いクラスベースのガード(CanActivateインターフェース)は使えなくなりますか?

クラスベースの実装も引き続きサポートされているため、既存コードをすぐに書き換える必要はありません。

ただし新規実装では、記述量が少なく済む関数型ガードを使うのがおすすめです。

複数のガードを組み合わせることはできますか?

canActivateやcanMatchのプロパティには配列で複数の関数を渡せます。

  • 配列内の関数は順番に評価される
  • いずれかの関数がfalseやUrlTreeを返した時点で遷移がブロックされる
  • 認証チェックと権限チェックを別々の関数として分割できる

まとめ

今回は、AngularのRouterで認証ガードを実装する方法について解説しました。

以下が本記事のまとめになります。

まとめ
  • Angular RouterのCanActivateFnを使うと、関数型で認証ガードを実装できる。
  • loadComponentcanMatchを組み合わせると、未認証ユーザーへのコンポーネント配信自体を防げる。
まとめ
  • おすすめ本
¥4,070 (2023/07/23 15:56時点 | Amazon調べ)
\楽天ポイント4倍セール!/
楽天市場

Angularの勉強なら「」が分かりやすくておすすめですよ♪

いずみ

最後までお読みいただき、ありがとうございました!

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式
  • クソおすすめ本
¥4,480 (2024/06/01 23:28時点 | Amazon調べ)
\楽天ポイント4倍セール!/
楽天市場
いずみ

海外のエンジニアがどういった思考で働いているかが理解できます。

海外に行く気はないけど海外エンジニアの動向が気になる雑魚エンジニアにおすすめです(本当におすすめな本しか紹介しないのでご安心を)。

この記事が気に入ったら
フォローしてね!

シェアしてね!
  • URLをコピーしました!
目次