firebase-admin.app package

Firebase 앱 및 SDK 초기화

함수

함수 설명
applicationDefault(httpAgent) Google 애플리케이션 기본 사용자 인증 정보에서 생성된 사용자 인증 정보로 Firebase 서비스에 대한 관리 액세스 권한을 반환합니다. 이 사용자 인증 정보는 initialApp()을 호출할 때 사용할 수 있습니다.Google 애플리케이션 기본 사용자 인증 정보는 Google App Engine 및 Google Compute Engine과 같은 모든 Google 인프라에서 사용할 수 있습니다.자세한 내용은 SDK 초기화를 참조하세요.
cert(serviceAccountPathOrObject, httpAgent) Firebase 서비스에 대한 관리 액세스 권한을 부여하는, 제공된 서비스 계정에서 생성된 사용자 인증 정보를 반환합니다. 이 사용자 인증 정보는 initialApp() 호출에 사용할 수 있습니다.자세한 내용은 SDK 초기화를 참고하세요.
deleteApp(앱) 지정된 App를 사용할 수 없게 렌더링하고 연결된 모든 서비스의 리소스를 해제합니다 (백엔드 리소스는 정리되지는 *않음*). SDK를 로컬에서 실행하는 경우 프로세스를 정상적으로 종료하기 위해 이 메서드를 호출해야 합니다.
getApp(appName)
getApps()
initialApp(options, appName)
refreshToken(refreshTokenPathOrObject, httpAgent) Firebase 서비스에 대한 관리 액세스 권한을 부여하는, 제공된 갱신 토큰에서 생성된 사용자 인증 정보를 반환합니다. 이 사용자 인증 정보는 initialApp() 호출에 사용할 수 있습니다.자세한 내용은 SDK 초기화를 참고하세요.

클래스

클래스 설명
AppErrorCodes 앱 클라이언트 오류 코드 및 기본 메시지
FirebaseAppError Firebase 앱 오류 코드 구조 PrefixedFirebaseError를 확장합니다.

인터페이스

인터페이스 설명
Firebase 앱에는 서비스 모음에 대한 초기화 정보가 포함되어 있습니다.
AppOptions initialApp()에 전달할 수 있는 옵션
사용자 인증 정보 Firebase 서비스 인증에 사용되는 Google OAuth2 액세스 토큰을 제공하는 인터페이스입니다.대부분의 경우 직접 구현할 필요가 없으며 대신 firebase-admin/app 모듈에서 제공하는 기본 구현을 사용할 수 있습니다.
FirebaseArrayIndexError FirebaseError 객체와 오류가 발생한 항목을 가져오는 데 사용할 수 있는 색인이 모두 포함된 복합 유형입니다.
Firebase 오류 FirebaseError는 표준 JavaScript Error 객체의 서브클래스입니다. 메시지 문자열과 스택 트레이스 외에도 문자열 코드가 포함됩니다.
GoogleOAuthAccessToken Google OAuth 2.0 액세스 토큰용 인터페이스입니다.
서비스 계정

변수

변수 설명
SDK_VERSION

applicationDefault(httpAgent)

Google 애플리케이션 기본 사용자 인증 정보에서 생성된 사용자 인증 정보로 Firebase 서비스에 대한 관리 액세스 권한을 반환합니다. 이 사용자 인증 정보는 initialApp() 호출에 사용할 수 있습니다.

Google 애플리케이션 기본 사용자 인증 정보는 Google App Engine 및 Google Compute Engine과 같은 모든 Google 인프라에서 사용할 수 있습니다.

자세한 내용은 SDK 초기화를 참고하세요.

서명:

export declare function applicationDefault(httpAgent?: Agent): Credential;

매개변수

매개변수 유형 설명
http에이전트 상담사 Google 토큰 서버에서 액세스 토큰을 검색할 때 사용할 선택적 HTTP 에이전트입니다.

반환:

사용자 인증 정보

앱을 초기화하는 데 사용할 수 있는 Google 애플리케이션 기본 사용자 인증 정보를 통해 인증된 사용자 인증 정보입니다.

initializeApp({
  credential: applicationDefault(),
  databaseURL: "https://<DATABASE_NAME>.firebaseio.com"
});

cert(serviceAccountPathOrObject, httpAgent)

Firebase 서비스에 대한 관리 액세스 권한을 부여하는, 제공된 서비스 계정에서 생성된 사용자 인증 정보를 반환합니다. 이 사용자 인증 정보는 initialApp() 호출에 사용할 수 있습니다.

자세한 내용은 SDK 초기화를 참고하세요.

서명:

export declare function cert(serviceAccountPathOrObject: string | ServiceAccount, httpAgent?: Agent): Credential;

매개변수

매개변수 유형 설명
serviceAccountPathOrObject 문자열 | 서비스 계정 서비스 계정 키 JSON 파일 또는 서비스 계정 키를 나타내는 객체의 경로입니다.
http에이전트 상담사 Google 토큰 서버에서 액세스 토큰을 검색할 때 사용할 선택적 HTTP 에이전트입니다.

반환:

사용자 인증 정보

제공된 서비스 계정을 통해 인증된 사용자 인증 정보로, 앱을 초기화하는 데 사용할 수 있습니다.

예 1

// Providing a path to a service account key JSON file
const serviceAccount = require("path/to/serviceAccountKey.json");
initializeApp({
  credential: cert(serviceAccount),
  databaseURL: "https://<DATABASE_NAME>.firebaseio.com"
});

예 2

// Providing a service account object inline
initializeApp({
  credential: cert({
    projectId: "<PROJECT_ID>",
    clientEmail: "foo@<PROJECT_ID>.iam.gserviceaccount.com",
    privateKey: "-----BEGIN PRIVATE KEY-----<KEY>-----END PRIVATE KEY-----\n"
  }),
  databaseURL: "https://<DATABASE_NAME>.firebaseio.com"
});

deleteApp(앱)

지정된 App를 사용할 수 없게 렌더링하고 연결된 모든 서비스의 리소스를 해제합니다 (백엔드 리소스는 정리되지는 *않음*). SDK를 로컬에서 실행하는 경우 프로세스를 정상적으로 종료하기 위해 이 메서드를 호출해야 합니다.

서명:

export declare function deleteApp(app: App): Promise<void>;

매개변수

매개변수 유형 설명

반환:

프로미스<void>

deleteApp(app)
  .then(function() {
    console.log("App deleted successfully");
  })
  .catch(function(error) {
    console.log("Error deleting app:", error);
  });

getApp(appName)

서명:

export declare function getApp(appName?: string): App;

매개변수

매개변수 유형 설명
앱 이름 문자열

반환:

getApps()

서명:

export declare function getApps(): App[];

반환:

[]

initialApp(options, appName)

서명:

export declare function initializeApp(options?: AppOptions, appName?: string): App;

매개변수

매개변수 유형 설명
옵션 AppOptions
앱 이름 문자열

반환:

refreshToken(refreshTokenPathOrObject, httpAgent)

Firebase 서비스에 대한 관리 액세스 권한을 부여하는, 제공된 갱신 토큰에서 생성된 사용자 인증 정보를 반환합니다. 이 사용자 인증 정보는 initialApp() 호출에 사용할 수 있습니다.

자세한 내용은 SDK 초기화를 참고하세요.

서명:

export declare function refreshToken(refreshTokenPathOrObject: string | object, httpAgent?: Agent): Credential;

매개변수

매개변수 유형 설명
refreshTokenPathOrObject 문자열 | 객체 Google OAuth2 갱신 토큰 JSON 파일 또는 Google OAuth2 갱신 토큰을 나타내는 객체의 경로입니다.
http에이전트 상담사 Google 토큰 서버에서 액세스 토큰을 검색할 때 사용할 선택적 HTTP 에이전트입니다.

반환:

사용자 인증 정보

제공된 서비스 계정을 통해 인증된 사용자 인증 정보로, 앱을 초기화하는 데 사용할 수 있습니다.

// Providing a path to a refresh token JSON file
const refreshToken = require("path/to/refreshToken.json");
initializeApp({
  credential: refreshToken(refreshToken),
  databaseURL: "https://<DATABASE_NAME>.firebaseio.com"
});

SDK_VERSION

서명:

SDK_VERSION: string