Registration
  • Updated on 28 May 2020
  • 1 minute to read
  • Print
  • Share
  • Dark
    Light

Registration

  • Print
  • Share
  • Dark
    Light

Registering For Fathym

The Fathym Low-Code Framework enables developers to rapidly build data-driven applications by applying best practice workflows for cloud infrastructure automation and application management. The cloud infrastructure Fathym uses is Microsoft Azure. In creating your workspace, Fathym guides you through setting up an automated, enterprise-grade, Azure-hosted environment with just a few clicks.

The Fathym Low-Code Framework configures the following for your workspace:

  1. Configures an enterprise-scalable, cost-effective infrastructure on the Azure cloud (free for 14 days)
  2. Deploys an SSL certificate for a secured application host 
  3. Manages Azure, other clouds, and legacy infrastructure with our enterprise orchestration tools

Additionally, the Fathym Low-Code Framework sets up the following DevOps functions for your workspace:

  1. Connects with your Azure DevOps instance and assists managing your code, builds, releases, and more
  2. Sets up Git-based source control for your infrastructure and connect it to builds for auto-deploying to Azure

 

Setting up the Fathym Low-Code Framework includes the following topics:

  • Set up your Azure account
  • Configure your project details
  • Connect your Azure account to Fathym
  • Select your project infrastructure
  • Review and launch
  • Begin configuring your IDE


Prerequisites

Before setting up the Fathym Framework you will need to set up a Microsoft account for your organization so Fathym can connect with Microsoft Azure. This way everything you create in Fathym is provisioned in your own Azure infrastructure, meaning you maintain all ownership and we don't lock you in. 

Note that Azure charges you incur will be billed back to you. If you are setting up a new Azure account, you will get a $200 credit to use within 30 days, as well as 12 months of many services for free.

Important: In order to have access to the necessary permissions and settings required for setup in Azure, your Azure account needs to be at the administrator level.


 

Set Up Your Azure Account

Setting up your Azure account includes the following tasks:

  • Create a new registration
  • Set up a contributor role
  • Generate an app auth key

 

Create a New Registration

  1. From the Azure portal, select Azure Active Directory.
  2. From the left menu pane, select App registrations, then click +New Registration.


  1. On Register an application, complete the following fields:
    • Name
      • This is your Display Name value.
    • Supported Account Types
      • Select the Accounts in this organizational directory only option.
    • Redirect URI
      • Enter a web value, for example, https://www.yourcompany.com.
  2. Click Register.
    Close this pane using the X in the upper-right corner. Your application should display on the App registrations page under the Owned Applications tab.

 

Generate an App Auth Key

To generate the value for the Azure App Auth key:

  1. From the left menu pane of your organization’s App Registration page in Azure, select Certificates & secrets.
    A client secret is an alphanumeric string Azure uses to verify its identity when requesting a token.
  2. In the Client secrets section, click + New client secret.
  3. Enter a useful description, specify the expiration date, then click Add.
    • Example description: Fathym Platform Key.

      A screenshot of a cell phone

Description automatically generated

 

Locate Your Azure App Auth Key

  1. To retrieve the Azure App Auth key value from Azure, go to the left menu pane of your organization’s App Registration page, then select Certificates & secrets.
  2. Locate your client secret and hover over the alphanumeric value to invoke the copy function.
    Note: Once you copy the secret’s value it is not retrievable again.
  3. Paste the new value in the Azure App Auth key field in Fathym.


Set Up an Azure Contributor Role

You will need to connect your Azure registration with your account.

  1. From the Azure portal home page, select Subscriptions. Alternatively, you can type subscriptions in the search box at the top of the page.
  2. On the Subscriptions page, select a valid subscription for your organization.
  3. On the left pane menu, select Access control (IAM).
  4. On the Access control (IAM) page, select the Role assignments tab.
  5. Click + Add, then select Add role assignment.
  6. On the Add role assignment pane on the right, select Contributor for the Role field.
  7. Select Azure AD user, group, or service principal for the Assign access to field.
  8. Select the registration you created in the previous section for the Select field.
  9. Click Save.
    You should see a banner popup confirming the role assignment, and the new contributor you added should display on the main section of the screen.

 

 

Configure Your Workspace Details

  1. Navigate to fathym.com/pricing, choose your package, and log in with your Microsoft credentials.
  2. Give your workspace a Workspace Name.
  3. Give your workspace a Workspace  Lookup.
    • This will be your workspace's URL and will also be the value is used throughout your organization’s assets that Fathym sets up. Valid characters are lower-case letters and hyphens (-).
    • The URL will look like https://YourWorkSpaceLookup.fathym-it.com
  4. Agree to Fathym's Enterprise Agreement and Terms of Services.
  5. Click Save Details.



Set Up Workspace Infrastructure and Connect Your Azure Account to Fathym

Locate Your Azure App ID and Azure Tenant Credentials

  1. From the Azure portal, select Azure Active Directory.
  2. From the left menu pane, select App registrations.
  3. Under Display Name, select your organization.
  4. Hover over each value to invoke the copy function.
  5. Paste the value of each ID to its corresponding field on Fathym’s Microsoft Azure Subscription Setup form.

Locate Your Azure Subscription ID Credentials

  1. From the Azure portal, select Subscriptions.
  2. This will list out the Subscription Names along with the Subscription ID.
  3. Alternatively, the Subscription ID can be located on the Overview tab after selecting Subscriptions.
  4. Hover over the Subscription ID to invoke the copy function.
  5. Paste the value of the ID to its corresponding field on Fathym’s Microsoft Azure Subscription Setup form.


Locate Your Azure App Auth Key

  1. To retrieve the Azure App Auth key value from Azure, go to the left menu pane of your organization’s App Registration page, then select Certificates & secrets.
  2. Locate your client secret and hover over the alphanumeric value to invoke the copy function.
    Note: Once you copy the secret’s value it is not retrievable again.
  3. Paste the new value in the Azure App Auth key field in Fathym.


Choose Your Infrastructure Template

  1. Choose your server location
  2. Choose your Infrastructure Template
    • The Low Code Unit Runtime Template installs all of the Azure resources that are required to run the Fathym Framework and is sufficient for building and hosting applications and APIs.
    • The Low Code Unit Runtime Template w/ IoT installs all of the above and will provision the infrastructure to connect devices and real-time data flows, enabling Internet of Things (IoT) projects. This includes the initial best practice Data Flow resources, like an IoT Hub, Event Hub, Cold Storage, Warm Storage, and Hot Storage.
  3. Click Review and Launch


Launch Your Workspace

You are now ready to Finalize and Deploy your Workspace. 

This process can take up to 15 minutes. After clicking Finalize and Deploy, Fathym will provision your Azure cloud and personalized IDE (Integrated Developer Environment), giving you the ability to deploy and launch data flows, dashboards and applications.

Behind the scenes, Fathym is:

  1. Setting up your custom workspace and IDE
  2. Setting up secure hosting
  3. Connecting with your Azure so that you maintain full ownership and control of your project
  4. Connecting with DevOps for source control, version control, builds and deployment
  5. Configuring and connecting a scalable, cost effective infrastructure on Microsoft Azure
  6. Configuring your domain, including user security, host setup and free open source SSL security
  7. Configuring our Micro-Application Orchestration framework so that you can build and run custom units of code and applications called Low Code Units

 

When the Setup is complete, click Open Enterprise IDE to begin building with Fathym.




Was this article helpful?