Question

Answer

1. Create an Azure Application. In this case, DH-Test is the name of the Application being used
   
   
2. You will see the details of the Application showing the Client ID, Object ID and Tenant ID
   
3. Within Digital Hive, you will need to enable OIDC Auth as per Enable OIDC Authentication . You will need to use the Client ID, Secret and Tenant ID from the above screenshot. 
   
4. Once complete, restart the Digital Hive Node 1 service for the changes to take effect 
   
5. Log into Digital Hive as an Administrator and click your Avatar and select Manage Digital Hive
   
6. On the left hand side, expand Security and click Tenants
   
7. On the right hand side, click the Advanced tab to expand
   
8. You will now see the "Download Tenant Template". Click on it to download the file to get started. 
   
9. Open the Excel file and you will see various Options in there.
   
10. You will need to add the requested information to begin. 
    
11. In this example, We are creating 2 tenants called Apple and Samsung. 
    
12. You can define the Maximum number of users per tenant as needed. 
13. We have an existing Hive called Superstore. You can use that hive as the starting point. The Properties.hiveTemplates let`s you create a new Hive called Apple Superstore or Samsung Superstore (tenantName HiveName). You can then modify the pages as needed for each tenant. You can leave it as blank if you don`t want to create a new hive based on an existing one. 
    
14. You can give any number for the properties.accountId
    
15. Save the Excel file.
    
16. Within Digital Hive, click Import Tenants
    
17. Click Import Tenants and select Upload a file and add the Excel file. 
    
18. Click Import. 
    
19. You will see a Dialog box showing progress
    
20. Once complete, you will see the Tenants created
    
21. If you click the Hives icon on the top, you will see the 2 newly created hives as well
    
22. It will automatically create 2 roles for each Tenant added. The first role is called TenantName_Admin and the Second one is TenantName_Consumer. The TenantName_Admin user has the capability to Manage Tenants. You can add capabilities as needed for the role. By default, they have only View Content and Execute Artifact capabilities. 
    
    
23. If you log out and log back in, you will see the Manage Tenants option under your Name avatar
    
24. Click Manage Digital Hive and select Tenants on the left hand side
    
25. Click Manage Security Roles on the top and click Add Security Role
    
26. We set the security roles in Digital Hive and pass them during Power BI Embed report executions, the roles are predefined in the Powerbi reports that secures who can see what. So, create that role that has already been created on the Power BI side. I have added a role called SecurityNPH which already exists on the Power BI side. 
    
27. Next step is to add the users to the tenant. Download the Member Template
    
28. Open the downloaded Excel file and fill in the details. We are adding a user to the Apple Tenant and to the SecurityNPH role. You can define him as an Admin or not. Save the file. 
    
29. We will now import the users. Click Import Members and upload the Excel file and click Import.
    
30. You will get a prompt box saying to wait for the process to complete
    
31. Once complete, you can see it saying 1/5 under Members for the Apple Tenant
    
32. Click and open the Apple Tenant to see the details of the Member added
    
33. You can view more details of the user by clicking on the email address under the Email column, which will also show the Security Role he belongs to 
    
34. The newly created user will receive an email with an invite to join the tenant. Once they click the "Accept Invitation", it will log them into the tenant. The other alternative for the user to log in once they have been added is to get the Web URL for the tenant from the Administrator (Digital Hive log in URL) and log in directly.