Module: FirebaseAdmin::Client::Accounts

Included in:
FirebaseAdmin::Client
Defined in:
lib/firebase-admin/client/accounts.rb

Overview

Defines methods related to accounts

Instance Method Summary collapse

Instance Method Details

#create_account(params) ⇒ Resource

Create a new account

)

Examples:

FirebaseAdmin.create_account(
  :email => "[email protected]",
  :password => "super-secret",
  :phoneNumber => "+5555555555",
  :displayName => "LeBron James",
  :photoUrl => "http://www.example.com/photo.jpg",
  :customAttributes => {
    :roles => ['admin']
  }

Parameters:

  • params (Hash) —

    A customizable set of params

  • options (Hash) —

    a customizable set of options

  • customAttributes (Hash) —

    a customizable set of options

Returns:

  • (Resource)

See Also:



32
33
34
 
# File 'lib/firebase-admin/client/accounts.rb', line 32

def (params)
  post("v1/projects/#{project_id}/accounts", params)
end

#create_custom_token(uid) ⇒ String

Create a custom JWT token for a UID

Examples:

FirebaseAdmin.create_custom_token('...')

Parameters:

  • uid (String) —

    The uid of a user

Returns:

  • (String)

See Also:



119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'lib/firebase-admin/client/accounts.rb', line 119

def create_custom_token(uid)
  if .nil? ||  == ''
    raise InvalidCredentials,
          "No client email provided via options, 'GOOGLE_APPLICATION_CREDENTIALS' or 'GOOGLE_CLIENT_EMAIL'"
  end

  if .nil? ||  == ''
    raise InvalidCredentials,
          "No private key provided via options, 'GOOGLE_APPLICATION_CREDENTIALS' or 'GOOGLE_PRIVATE_KEY'"
  end

  now_seconds = Time.now.to_i
  payload = {
    iss: ,
    sub: ,
    aud: 'https://identitytoolkit.googleapis.com/google.identity.identitytoolkit.v1.IdentityToolkit',
    iat: now_seconds,
    exp: now_seconds + (60 * 60), # Maximum expiration time is one hour
    uid: uid
  }
  JWT.encode(payload, OpenSSL::PKey::RSA.new(unescape()), 'RS256')
end

#get_user_by(key, value) ⇒ Resource

Get user by email/phone/uid

Examples:

FirebaseAdmin.get_user_by(:email, "[email protected]")

Parameters:

  • key (String) —

    either :email or :phone

  • value (String) —

    the value to search for

Returns:

  • (Resource) 


151
152
153
154
155
156
 
# File 'lib/firebase-admin/client/accounts.rb', line 151

def get_user_by(key, value)
  params = {}
  params[key] = Array(value)
  response = post('v1/accounts:lookup', params)
  (response[:users] || []).first
end

#reset ⇒ Resource

Reset emulator

Examples:

FirebaseAdmin.reset()

Returns:

  • (Resource)

See Also:



165
166
167
 
# File 'lib/firebase-admin/client/accounts.rb', line 165

def reset
  delete("emulator/v1/projects/#{project_id}/accounts")
end

#sign_in_for_uid(uid) ⇒ Resource

Sign in based on the UID of an account This generates a custom token for the UID and signs in using the custom token

Examples:

FirebaseAdmin.("...")

Parameters:

  • uid (String) —

    The uid of a user

Returns:

  • (Resource) —

    with idToken



105
106
107
108
 
# File 'lib/firebase-admin/client/accounts.rb', line 105

def (uid)
  custom_token = create_custom_token(uid)
  (custom_token)
end

#sign_in_with_custom_token(token) ⇒ Resource

Sign in with custom token

Examples:

FirebaseAdmin.("...")

Parameters:

  • token (String) —

    A custom token

Returns:

  • (Resource) —

    with idToken



92
93
94
 
# File 'lib/firebase-admin/client/accounts.rb', line 92

def (token)
  post('v1/accounts:signInWithCustomToken', { token: token, returnSecureToken: true })
end

#sign_in_with_password(params) ⇒ Resource

Sign in with a password

)

Examples:

FirebaseAdmin.sign_in_with_password(
  email: "[email protected]",
  password: "super-secret"

Parameters:

  • params (Hash) —

    A customizable set of params

  • options (Hash) —

    a customizable set of options

Returns:

  • (Resource)

See Also:



80
81
82
 
# File 'lib/firebase-admin/client/accounts.rb', line 80

def (params)
  post('v1/accounts:signInWithPassword', params)
end

#update_account(params) ⇒ Resource

Update an existing account

)

Examples:

FirebaseAdmin.update_account(
  email: "[email protected]",
  password: "super-secret",
  phoneNumber: "+5555555555",
  displayName: "LeBron James",
  photoUrl: "http://www.example.com/photo.jpg",
  localId: "1234",
  customAttributes: {
    :roles => ['admin']
  }

Parameters:

  • params (Hash) —

    A customizable set of params

  • options (Hash) —

    a customizable set of options

  • customAttributes (Hash) —

    a customizable set of options

Returns:

  • (Resource)

See Also:



62
63
64
 
# File 'lib/firebase-admin/client/accounts.rb', line 62

def (params)
  post("v1/projects/#{project_id}/accounts:update", params)
end