Firebase Admin SDK

핵심 개념

Service Account

Firebase 프로젝트에 접근할 수 있는 서버 전용 인증 계정. JSON 키 파일 형태로 발급되며, 이 파일을 통해 Admin SDK가 Firebase 서비스에 인증됩니다.

Firebase Cloud Messaging (FCM)

모바일·웹 클라이언트에게 푸시 알림을 전송하는 Firebase 서비스. Admin SDK를 통해 서버에서 특정 기기나 토픽에 메시지를 발송할 수 있습니다.

Admin Privilege

Admin SDK는 Firestore나 Realtime Database의 보안 규칙을 무시하고 모든 데이터를 읽고 쓸 수 있는 특권을 가집니다. 신뢰할 수 있는 서버 환경에서만 사용해야 합니다.

Authentication Management

사용자 계정 생성·삭제·수정, 커스텀 토큰 발급, 이메일 인증 링크 생성 등 Firebase Authentication을 서버에서 프로그래밍 방식으로 관리하는 기능입니다.

FCM 푸시 알림 전송 (Node.js)

서비스 계정 키로 Admin SDK를 초기화한 뒤, FCM을 통해 특정 디바이스에 푸시 알림을 전송하는 기본 예시입니다.

const admin = require('firebase-admin');

// 서비스 계정 키로 초기화
admin.initializeApp({
  credential: admin.credential.cert('./serviceAccountKey.json')
});

// 특정 디바이스로 푸시 알림 전송
const message = {
  notification: {
    title: '화재 경보',
    body: '1층 복도에서 연기가 감지되었습니다.'
  },
  token: 'DEVICE_FCM_TOKEN'
};

admin.messaging().send(message)
  .then(response => console.log('전송 성공:', response))
  .catch(error => console.error('전송 실패:', error));