An account represents the highest level of scoping for Ooyala Flex objects, and nothing can be accessed outside an account. An account is normally assigned to a company or business unit. It can consist of sub-accounts, groups, roles, workspaces, and users. Object visibility is currently set at the account level.
Most customisation of Ooyala Flex occurs at the account level. The following properties can be set and viewed at account level:
- Owner: The person that created the user in the system.
- Ooyala Flex Console URL: Typically the account name (with character escaping where necessary) pre-pended to the main Ooyala Flex console domain, for example: account.ooyalaflex.com
- Metadata: Custom fields for managing basic account details.
- Theme: The branding, look and feel of an account.
- Members: A collection of users that belong to this account.
- Sub-Accounts: A collection of sub-accounts that belong to this account.
- Groups: A collection of groups that belong to this account.
- Roles: A collection of roles that belong to this account.
- Variants: Can be used to customise existing object types.
- Properties: Supports the advanced configuration of Ooyala Flex at the account level and also environmental variables.
The Master Account
The Master account is immutable and always exists. This account is created when a new Ooyala Flex platform is installed. The master account owns all other accounts, and is only accessed by the master user. A master account is primarily used for setting up other accounts, as well as system-wide configuration.
Creating an Account
1) Log in in as master user, or the owner of the account that will be making the new account or sub-account.
2) On the Toolbar, click New:
3) From the drop down, select Account.
4) In the Create new Account section, fill in a name and an optional description:
5) Click Save to finalise.
6) Click Enable to enable the account.
7) Set up any properties for your new account. In particular, obtain and apply URLs.
When you create a new account, a default workspace is created with the same name.
A sub-account represents an account that belongs to an existing account. Sub-accounts are useful, for example when an account that belongs to a single company needs to be split up into multiple business units with self-administration. An account can access all of the objects that belong to its sub-accounts.
Creating a Sub-Account
To create a sub-account, follow these steps:
Make sure you are logged into the account, in which you want to create the sub-account.
- On the Toolbar, click New:
- From the drop down, select Sub-Account:
- In the Create New Sub-account section, fill in the name and an
- Click Save to finalise:
- Click Enable:
- Once the sub-account is enabled, it is automatically available as a sub-account of the
account you are in: Note: You cannot associate a sub-account with multiple accounts.
When you have created your account, you can apply metadata to that account, by clicking the Metadata sub-tab, located in the account details screen:
When you click the Metadata sub-tab, several metadata fields are displayed. These fields deal with publish functionality, authentication, and analytics configuration for the account:
The following metadata fields are present for accounts:
|Publish||complex||0..1||Define this to enable Publish functionality for this account.|
CDN Storage Resource
|single option||The CDN storage resource to use for Publish file publishing.|
|string||Maximum number of users allowed in the account.|
|string||Maximum number of actions allowed in the account.|
|string||Maximum number of workflow definitions allowed in the account.|
|string||Maximum number of sub-accounts allowed in the account.|
|string||The date on which the note was written.|
|External Authentication||complex||0..1||Define this to enable external authentication for this account.|
|string||The endpoint URL for the external authentication to use for this account.|
|single option||Role to be assigned to new user.|
|single option||The default workspace for the new user.|
|single option||0..1||The workspaces for the new user.|
|Default Timezone||string||The default timezone for the new user.|
Default Country Code
|string||The default country code for the new user. Example: "en" (English), "ja" (Japanese), "us" (United States).|
|single option||Owner to be assigned to new user.|
|single option||Authentication provider.|
|SAML Configuration||complex||0..*||Define this to enable SAML authentication for this account.|
|SAML IDP Display Name||string||SAML Identity Provider name to be used in login forms.|
|SAML IDP metadata URL||string||SAML Identity Provider URL to retrieve metadata.|
|complex||Definition of the authentication features and constraints.|
|string||Define the lock time that should pass to unlock the account after several failed attempts to log in (#).|
Maximum number of failed attempts
|string||Define the maximum number of failed attempts before lock the user (#).|
Maximum number of forced attempts
|string||Define the total number of failed login attempts before the user's account is disabled. (#).|
|complex||Definition of the password constraints.|
Days to expire
|string||Amount of days a password expires after been defined (#).|
Maximum password length
|string||The maximum amount of characters that the password should contains (#).|
Minimum password length
|string||The minimum amount of characters that the password should contains (#).|
Type of Password Validation
|single option||Define the mechanism used to validate the password.|
|complex||Definition of the password constraints.|
Type of Sequence
|boolean||Type of sequence allowed to use in the password.|
|string||Regular expression to define the allowed characters on the password.|
|boolean||Set of custom configuration available on the password validation process.|
|Analytics configuration||complex||Definition of the authentication features and constraints.|
Web analytics collector URL
|string||The endpoint URL for the Publish instance to use for sending events.|
|Token created in Publish to increase security.|
Adjusting the theme
Once an account has been created, you can continue configuring it using the various sub-tabs located in the Details screen for the account. One of the most useful sub-tabs is the Theme sub-tab. This tab allows you to customise the Ooyala Flex console, so that it matches your organisation's look and feel:
You can adjust the following areas in the Theme sub-tab:
To adjust the theme of your Account follow these steps:
1) In the details screen for the Account you wish to edit, click the Edit option.
2) Click the Theme sub-tab, and click the Edit option.
Summary Includes: Name, Description, and Company Name fields.
You can change the summary text by deleting the default text, and then entering new text. The Name and Company Name fields are mandatory, and must be filled in.
The Links section includes: Logo URL, Header Link URL, and Help Link URL. You can change the links for the various fields, by entering a valid URL.
The Colours section includes: Header Text, Header Background, Tabbed Navigation, Table Header Background etc. In order to change the colour for a particular area of Ooyala Flex, you can simply select the colour from the colour picker, or enter a hexadecimal colour code.
The images that can be changed are:
- Login Logo
- Main Logo
- Client Splash Logo
- Bookmark Icon
- Client Logo
To add an image simply click the Choose File button next to the respective field, and select the image file.
1) In the Dashboard tab, click your name located in the top-right corner of the screen.
2) In the User Details section, click the Switch tab.
3) In the Switch to Account field, select an account from the drop down.
4) In the Workspace field, select a workspace.
5) Click Go.