Lumen help

Adding a configuration

A configuration tells the Lumen CDN (content delivery network) what to do when it receives requests for your content. Once you have a configuration ready, you deploy it (promote it) to either your staging or production environment. Media portal also lets you track the history for a configuration.

To add a configuration:

From the main menu, select My Services > Caching.

From the lists, select the access group and SCID (service component ID) you want to work with.

My Services - Caching (with SCID selected)

Click Add Configuration.

In the Configuration Name field, type a name for the configuration.

A configuration always requires properties, but doesn't need definitions unless you plan to use match rules. Do one of the following:

If you only need to add properties to this configuration, skip to step 9.
If you need to add definitions to use later with match rules, continue with step 7.

To add a service-wide definition to the configuration, select the type of definition you want to add, fill in the details for the definition, then click Add Definition. Use the sections below to help fill in the fields for each definition.

In the Definition Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

From the list, select a country to add to the definition. (You can also start typing the country name to save scrolling through the list.)

my services caching add configuration geo regions new definition with definition name and two countries added

To add another country, click Add, then select a country from the list.

Repeat steps 5–6 to continue adding countries to the definition.

In the Service-Wide Definition section, click IP Groups.

In the Definition Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

Add IP addresses to the definition:
1. In the IP Addresses in field, type an IP address you want to include in the definition.
2. To add additional IP addresses, click Add, then repeat step a.

Note: You can add IP addresses individually or as a range using CIDR notation.

In the Service-Wide Definition section, click Token Authentication.

my services caching add configuration token authentication new definition

In the Definition Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

Add secret names (up to 10) to the definition:
1. Above the Secret Name section, click Add.
2. Type a secret name in the field.
3. To add addtional secret names, repeat steps a and b.

Add query parameters to include or exclude from the hash to the definition:
1. Above the Query Parameter Name field, click Add.
2. Type a query parameter name.
3. To add addtional query parameter names, repeat steps a and b.

From the Date Preference list, select your preference: EPOCH or GMT.

From the Query Parameter Control list, select whether to include or exclude the query parameters you added.

If you want to use a query string other than nva (not valid after), type it in the NVA Name field.

If you want to use a query string other than nvb (not valid before), type it in the NVB Name field.

If you want to use a query string other than hash, type it in the Hash field.

In the Service-Wide Definition section, click AWS4 Authentication.

Media portal lists the AWS4-authentication definitions for the configuration (if any).

my services caching add configuration aws4 authentication new definition

In the AWS4 Authentication Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

Fill in Secret and Access Key ID fields with the information you received from Amazon when you registered.

In the Service-Wide Definition section, click Log Streaming Endpoints.

my-services caching add configuration log streaming endpoints new definition

In the Definition Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

Fill in the information for the definition:
1. From the Log Format list, select the format you want the log to use: JSON_Newline or JSON_Array.
2. If you want to check whether the presented certificate CN (common name) matches the hostname, select the Validate Certificate checbox.
3. From the Protocol list, select the protocol you want to use to deliver the logs.
4. In the Host field, type the hostname of the remote server.
5. In the Port field, type the port the remote server is listening on.
6. In the Max Bites per Message field, type the maximum number of bytes of log data that will be sent in each post.
7. In the Path field, type the path where the logs will be placed on the remote server.
8. In the Max Post Interval field, type the maximum time the system willl hold logs until they are sent to the remote server (if the log hasn't yet reached the number of bytes you specified above).
9. In the Connections field, select the number of connections.
10. To create custom headers to be added to the requests, click Add, then type the name and value for the request header.
11. To add additional headers, repeat step j.

In the Service-Wide Definition section, click Request Headers.

my services caching add configuration request headers

In the Definiton Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

Fill in the information for the request header:
1. In the Header Name field, type the name of the request header.
2. In the Header Value field, type the value to be returned for that header.
3. To add additional headers, click Add, then repeat steps a and b.

In the Service-Wide Definition section, click Response Headers.

my services caching add configuration response headers

In the Definition Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

Do one of the following:
- To specify categories of HTTP status codes you want to include in the definition, select the checkbox(es) next to those categories. You can also select the Custom Status Code checkbox and specify other status codes (separated by a comma) in the field that appears.
- To add all status codes to the definition, select the All Responses checkbox.

Fill in the information for the response header:
1. In the Header Name field, type the name of the response header.
2. In the Header Value field, type the value to be returned for that header.
3. To add additional headers, click Add, then repeat steps a and b.

In the Service-Wide Definition section, click DCT.

my services caching add configuration dct

In the Definition Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

Add extensions to the definiton that you'd like DCT applied to:
1. Type an extension in the field.
2. To add additional extensions, click Add, then fill in the field.

To make this definition the default DCT definition for the configuration, click the Default checkbox.

In the Service-Wide Definition section, click Accept-Encoding.

my services caching add configuration accept encoding

In the Definition Name field, type a name for the definition. (You can leave the auto-generated name or type a name more meaningful to you.)

Add extensions to the definiton:
1. Type an extension in the field.
2. To add additional extensions, click Add, then fill in the field.

Add compression types to the definition:
1. Type the compression type in the field.
2. To add additional compression types, click Add, then fill in the field.

To make this definition the default accept-encoding definition for the configuration, click the Default checkbox.

Repeat step 7 as needed to continue adding definitions.

To add properties to the configuration, click Add Property, fill in the details for the property, then click Done.

When you're done building the configuration, click Save.

Media portal saves the configuration and assigns a version of 1 to it. If you're ready to push the configuration to an environment, you can promote it.