Applies to: BLAZE

Summary

Third-party systems or devices can use HTTP requests to send generic events into BLAZE and trigger rules. This article describes a basic configuration using Digest Authentication. For a more secure system, use the Bearer Token Authentication. It requires BLAZE Server v1.2.205 or later.

Generic Events

Creating a System User to Receive Triggers 

To create a system user:

1. Log in to BLAZE with an administrator role. 
    
2. Go to Settings > Users and click + Add user. 
   
   This system user receives the HTTP requests. 
    
3. Click Next > Enable digest authentication. 
    
4. Re-enter the user’s password and click Enable digest authentication. 
    
5. 

Creating a BLAZE Rule 

To create a BLAZE rule:

1. Go to Settings > Rules.
    
2. Click + Add rule > + Add event and select Generic event. 
    
3. Enter a text value for Source. 
   
   Avoid spaces and special characters that might cause issues in the HTTP request. 
   
   BLAZE will add an event to the Events log. 
    
4. Add a bookmark action to make the event easier to find.
   
   

Identifying BLAZE Server and Device Details 

To identify BLAZE Server and device details:

1. Go to Settings > Servers. 
    
2. Locate the server and its IP address. 
    
3. Go to Settings > Devices. 
    
4. Select the device(s) to associate with the event.
    
5. Document the Channel ID. 
   
   

Configuring the HTTP Request 

To configure the HTTP request:

1. Gather the following information: 
   
   System user name – ex: trigger 
   System user password – ex: Password1! 
   BLAZE server IP address – ex: 192.168.254.203  
   Source name used in the rule – ex: ACS-DF  
   Channel ID(s) of the associated device(s) – ex: a08a7e65-e5a2-49c6-963d-3c832f63f114 and 0d121b02-93d9-45eb-bc57-50436e29c732   
   Caption – ex: Door 47  
   Description – ex: Vault
    

2. Enter the full HTTP request in a web browser. 
   
   Ex: http://trigger:Password1!@192.168.254.203:8000/api/v1/event/generate:generic?source=ACS-DF&caption=Door 47 &description= Vault&channelIds=[a08a7e65-e5a2-49c6-963d-3c832f63f114,0d121b02-93d9-45eb-bc57-50436e29c732]  
   
   You should see a response echoing what was sent. 
    

   
    

3. Go to the BLAZE home page and click Events. 
    

4. Select the generic event then click the Play icon or Open in new tab to replay video from the associated camera. 
   
   The bookmarked event will also be associated with the device.