HawkService
Class: HawkService
Verify signature and sign server
Implementation of hawk protocol https://github.com/mozilla/hawk#readme
Webda Modda
Hawk
Extends
Service<HawkServiceParameters>
Implements
RequestFilter
Constructors
new HawkService(webda, name, params)
new HawkService(
webda,name,params?):HawkService
Service
Parameters
• webda: Core<CoreEvents>
The main instance of Webda
• name: string
The name of the service
• params?: DeepPartial<HawkServiceParameters>
The parameters block define in the configuration file
Returns
Inherited from
Service<HawkServiceParameters>.constructor
Source
core/lib/services/service.d.ts:167
Properties
_createException
_createException:
string
Inherited from
Service._createException
Source
core/lib/services/service.d.ts:148
_initException
_initException:
any
Inherited from
Service._initException
Source
core/lib/services/service.d.ts:150
_initTime
_initTime:
number
Inherited from
Service._initTime
Source
core/lib/services/service.d.ts:149
_name
protected_name:string
Service name
Inherited from
Service._name
Source
core/lib/services/service.d.ts:141
_webda
protected_webda:Core<CoreEvents>
Webda Core object
Inherited from
Service._webda
Source
core/lib/services/service.d.ts:137
cryptoService
protectedcryptoService:default<CryptoServiceParameters>
CryptoService
Source
logger
protectedlogger:Logger
Logger with class context
Inherited from
Service.logger
Source
core/lib/services/service.d.ts:154
metrics?
protectedmetrics?:any
Get metrics
Inherited from
Service.metrics
Source
core/lib/services/service.d.ts:158
model
model:
CoreModelDefinition<ApiKey>
Model to use for apikey
Source
parameters
protectedparameters:HawkServiceParameters
Hold the parameters for your service
It will be bring from the webda.config.json
Inherited from
Service.parameters
Source
core/lib/services/service.d.ts:147
RegistryEntry
staticRegistryEntry:string="HawkOrigins"
Source
captureRejectionSymbol
staticreadonlycaptureRejectionSymbol: typeofcaptureRejectionSymbol
Inherited from
Service.captureRejectionSymbol
Source
hawk/node_modules/@types/node/events.d.ts:328
captureRejections
staticcaptureRejections:boolean
Sets or gets the default captureRejection value for all emitters.
Inherited from
Service.captureRejections
Source
hawk/node_modules/@types/node/events.d.ts:333
defaultMaxListeners
staticdefaultMaxListeners:number
Inherited from
Service.defaultMaxListeners
Source
hawk/node_modules/@types/node/events.d.ts:334
errorMonitor
staticreadonlyerrorMonitor: typeoferrorMonitor
This symbol shall be used to install a listener for only monitoring 'error'
events. Listeners installed using this symbol are called before the regular
'error' listeners are called.
Installing a listener using this symbol does not change the behavior once an
'error' event is emitted, therefore the process will still crash if no
regular 'error' listener is installed.
Inherited from
Service.errorMonitor
Source
hawk/node_modules/@types/node/events.d.ts:327
Methods
__clean()
__clean():
Promise<void>
Clean the service data, can only be used in test mode
Returns
Promise<void>
Inherited from
Service.__clean
Abstract
Source
core/lib/services/service.d.ts:318
_redirect()
_redirect(
context):Promise<void>
Redirect with a CSRF
Parameters
• context: WebContext<any, any>
Returns
Promise<void>
Source
addListener()
addListener(
eventName,listener):this
Alias for emitter.on(eventName, listener).
Parameters
• eventName: string | symbol
• listener: (...args) => void
Returns
this
Inherited from
Service.addListener
Since
v0.1.26
Source
hawk/node_modules/@types/node/events.d.ts:354
addRoute()
protectedaddRoute(url,methods,executer,openapi?,override?):void
Add a route dynamicaly
Parameters
• url: string
of the route can contains dynamic part like {uuid}
• methods: HttpMethodType[]
• executer: Function
Method to execute for this route
• openapi?: OpenAPIWebdaDefinition
• override?: boolean
Returns
void
Inherited from
Service.addRoute
Source
core/lib/services/service.d.ts:241
authorizeClientEvent()
authorizeClientEvent(
_event,_context):boolean
Authorize a public event subscription
Parameters
• _event: string
• _context: OperationContext<any, any>
Returns
boolean
Inherited from
Service.authorizeClientEvent
Source
core/lib/services/service.d.ts:219
checkOPTIONS()
checkOPTIONS(
origin):Promise<boolean>
Parameters
• origin: string
Returns
Promise<boolean>
Source
checkRequest()
checkRequest(
context):Promise<boolean>
Stricly parse the request's attributes and then approve or reject
Parameters
• context: WebContext<any, any>
Returns
Promise<boolean>
Implementation of
RequestFilter.checkRequest
Source
computeParameters()
computeParameters():
void
Used to compute or derivate input parameter to attribute
Returns
void
Inherited from
Service.computeParameters
Source
core/lib/services/service.d.ts:175
emit()
emit<
Key>(event,data):boolean
Override to allow capturing long listeners
Type parameters
• Key extends string | number
Parameters
• event: symbol | Key
• data: Events[Key]
Returns
boolean
Inherited from
Service.emit
Source
core/lib/services/service.d.ts:288
emitSync()
emitSync<
Key>(event,data):Promise<any[]>
Emit the event with data and wait for Promise to finish if listener returned a Promise
Type parameters
• Key extends string | number
Parameters
• event: Key
• data: Events[Key]
Returns
Promise<any[]>
Inherited from
Service.emitSync
Source
core/lib/services/service.d.ts:283
eventNames()
eventNames(): (
string|symbol)[]
Returns an array listing the events for which the emitter has registered
listeners. The values in the array are strings or Symbols.
const EventEmitter = require('events');
const myEE = new EventEmitter();
myEE.on('foo', () => {});
myEE.on('bar', () => {});
const sym = Symbol('symbol');
myEE.on(sym, () => {});
console.log(myEE.eventNames());
// Prints: [ 'foo', 'bar', Symbol(symbol) ]
Returns
(string | symbol)[]
Inherited from
Service.eventNames
Since
v6.0.0
Source
hawk/node_modules/@types/node/events.d.ts:669
getApiKey()
getApiKey(
id,_timestamp):Promise<HawkCredentials>
Parameters
• id: any
• _timestamp: any= undefined
used to invalidate cache
Returns
Promise<HawkCredentials>
Source
getClientEvents()
getClientEvents():
string[]
Return the events that an external system can subscribe to
Returns
string[]
Inherited from
Service.getClientEvents
Source
core/lib/services/service.d.ts:213
getHawkRequest()
getHawkRequest(
context):Promise<Object>
Return information for hawk
Parameters
• context: WebContext<any, any>
Returns
Promise<Object>
authorization
authorization:
stringcontentType
contentType:
stringhost
host:
stringmethod
method:
HttpMethodTypepayload
payload:
string|Bufferport
port:
numberurl
url:
string
Source
getMaxListeners()
getMaxListeners():
number
Returns the current max listener value for the EventEmitter which is either
set by emitter.setMaxListeners(n) or defaults to defaultMaxListeners.
Returns
number
Inherited from
Service.getMaxListeners
Since
v1.0.0
Source
hawk/node_modules/@types/node/events.d.ts:526
getMetric()
getMetric<
T>(type,configuration):T
Add service name label
Type parameters
• T = Counter<string> | Histogram<string> | Gauge<string>
Parameters
• type: Constructor<T, [MetricConfiguration<T>]>
• configuration: MetricConfiguration<T>
Returns
T
Inherited from
Service.getMetric
Source
core/lib/services/service.d.ts:207
getName()
getName():
string
Get service name
Returns
string
Inherited from
Service.getName
Source
core/lib/services/service.d.ts:312
getOpenApiReplacements()
getOpenApiReplacements():
any
Return variables for replacement in openapi
Returns
any
Inherited from
Service.getOpenApiReplacements
Source
core/lib/services/service.d.ts:246
getOperationId()
getOperationId(
id):string
If undefined is returned it cancel the operation registration
Parameters
• id: string
Returns
string
Inherited from
Service.getOperationId
Source
core/lib/services/service.d.ts:233
getOrigins()
getOrigins():
Promise<any>
Returns
Promise<any>
Source
getParameters()
getParameters():
HawkServiceParameters
Get the service parameters
Returns
Inherited from
Service.getParameters
Source
core/lib/services/service.d.ts:179
getService()
getService<
K>(service):K
Return a webda service
Type parameters
• K extends Service<ServiceParameters, Events>
Parameters
• service: string
name to retrieve
Returns
K
Inherited from
Service.getService
Source
core/lib/services/service.d.ts:308
getUrl()
getUrl(
url,_methods):string
Return the full path url based on parameters
Parameters
• url: string
relative url to service
• _methods: HttpMethodType[]
in case we need filtering (like Store)
Returns
string
absolute url or undefined if need to skip the Route
Inherited from
Service.getUrl
Source
core/lib/services/service.d.ts:227
getWebda()
getWebda():
Core<CoreEvents>
Return WebdaCore
Returns
Core<CoreEvents>
Inherited from
Service.getWebda
Source
core/lib/services/service.d.ts:183