diff --git a/docs/Administration Console/configuring_ip_allow_lists.md b/docs/Administration Console/configuring_ip_allow_lists.md deleted file mode 100644 index 2a0dd34..0000000 --- a/docs/Administration Console/configuring_ip_allow_lists.md +++ /dev/null @@ -1,33 +0,0 @@ -# Configuring IP Allow Lists - -You can protect access to your NetBox Cloud instance by adding IPv4 and IPv6 addresses and ranges to an **IP Allow List** to control which source IP’s your instance will accept connections from. - -**Note** - Be careful as once you add CIDR ranges to the **IP Allow List** you will NOT be able to access the WebUI or API of your instance from any other IP addresses than those covered in the list. However, don’t worry if you make a mistake as you can easily remove incorrect entries from the list. - -Watch this quick video or follow the steps outlined below: - - - - -1. Login to the NetBox Labs [Console](https://console.netboxlabs.com/dashboard/) and then click on the name of the NetBox instance you are updating, on the left-hand side. - ![select netbox instance](../images/ip_allow_list/ip_allow_list_1.png) - -2. Scroll down to the **IP Allow List** section and click **Add** on the right hand side: - - ![Add new IP](../images/ip_allow_list/ip_allow_list_2.png) - -3. Add your IP address or range in CIDR notation. Give the range a description, and click **Publish** to add it to the list: - - ![Publish IP allow List](../images/ip_allow_list/ip_allow_list_3.png) - - **Note** if you are adding multiple entries, then you can click **Publish** after adding them all. - -4. To remove an entry from the IP Allow List, click the trash can icon next to the entry, which marks the entry for deletion: - - ![remove entry](../images/ip_allow_list/ip_allow_list_4.png) - -5. Then click **Publish** to remove the entry. Again, you can update multiple entries before clicking on **Publish**. - - ![Publish IP allow list](../images/ip_allow_list/ip_allow_list_5.png) - -If you encounter any issues while working with the IP Allow List raise a support ticket by emailing the [NetBox Labs Support Team](mailto:support@netboxlabs.com) \ No newline at end of file diff --git a/docs/Administration Console/prefix-lists.md b/docs/Administration Console/prefix-lists.md new file mode 100644 index 0000000..2f51d15 --- /dev/null +++ b/docs/Administration Console/prefix-lists.md @@ -0,0 +1,102 @@ +# Prefix Lists + +You can secure access to your NetBox Cloud instance by adding IPv4 and IPv6 addresses and ranges to **Prefix Lists**, which can then be applied to NetBox instances to control which source IPs your instances will accept connections from. + +The following features are available in the NetBox Labs [Admin Console](https://console.netboxlabs.com) when working with prefix lists: + +- Create, Edit and Delete prefix lists +- Synchronize prefix lists from a NetBox instance using tags + +There is also large list support (~15K prefixes) and separate prefixes can be applied to the NetBox Cloud UI, API and GraphQL interfaces. + +**Note** - When you have built your prefix lists in the Admin Console, raise a support ticket by emailing the [NetBox Labs Support Team](mailto:support@netboxlabs.com) and we will apply them to your NetBox Cloud instances. + +Watch this quick video or follow the steps outlined below to start managing your prefix lists: + + + +## Create a Prefix List (not synchronized with a NetBox) + +1. From within the Admin Console, navigate to **Settings** in the left-hand menu + + ![settings](../images/prefix-lists/settings.png) + +2. Scroll down and click to expand the **Prefix List** section, and then click on **Create Prefix List** on the right hand side to start the wizard: + + ![create prefix list](../images/prefix-lists/create-prefix-list.png) + +3. Give the prefix list a name and then click **CREATE PREFIX LIST**: + + ![name prefix list](../images/prefix-lists/create-prefix-list-non-sync-1.png) + +4. Enter the first prefix and give it a description. If you wish to add additional prefixes then you can also do that here by clicking **+ ADD ADDITIONAL PREFIX**, then when you are happy click **CREATE PREFIXES**. + + *Note* - if you wish to add the IP address that you are currently using then click **Use Current IP Address** and this will add it to the prefix list: + + ![enter prefixes](../images/prefix-lists/create-prefix-list-non-sync-2.png) + + 5. You can then view the prefix list from within **Settings > Prefix List**: + + ![view prefix list](../images/prefix-lists/create-prefix-list-non-sync-3.png) + +## Create a Prefix List (synchronized with a NetBox) + +1. From within the Admin Console, navigate to **Settings** in the left-hand menu + + ![settings](../images/prefix-lists/settings.png) + +2. Scroll down and click to expand the **Prefix List** section, and then click on **Create Prefix List** on the right hand side to start the wizard: + + ![create prefix list](../images/prefix-lists/create-prefix-list.png) + +3. Give the prefix list a name and then select the **Yes** radio button to sync the prefix list from a NetBox. Then select the NetBox instance you wish to sync from, specify the NetBox Tag that you wish to use, and then click **CREATE PREFIX LIST**: + + ![create prefix list](../images/prefix-lists/create-prefix-list-sync-1.png) + +4. Switch to your NetBox instance, and go to **Customization > Tags** and create the required tag(s) to be applied to any prefixes that are to be synchronized to the Prefix List: + + ![create tags](../images/prefix-lists/create-prefix-list-sync-2.png) + +5. Under **IPAM > Prefixes** add the prefixes, give them a description and tag them with the appropriate tag: + + ![view prefix list](../images/prefix-lists/create-prefix-list-sync-3.png) + +6. You can then view the prefixes in NetBox under **IPAM > Prefixes** (*Tip* - filter on the tag): + + ![view prefixes](../images/prefix-lists/create-prefix-list-sync-4.png) + +7. Switch back to the Admin Console to view the prefix list from within **Settings > Prefix List**. *Note* - it can take a few minutes for the prefix list to be fully synchronized from NetBox. + + ![view prefix list](../images/prefix-lists/create-prefix-list-sync-5.png) + +## Edit a Prefix List + +*Note* - this only works for prefix lists that are not synchronized with a NetBox. To edit NetBox synchronized prefix lists you should make the edits within NetBox. + +1. From within the Admin Console, navigate to **Settings** in the left-hand menu, and then scroll down and click to expand the **Prefix List** section. Then click on the name of the prefix list you wish to edit: + + ![edit prefix list](../images/prefix-lists/edit-prefix-list-1.png) + +2. To add more prefixes to the list, click on **Create Prefix** and then follow the wizard again to add more prefixes. + +3. To edit a prefix, click **EDIT** and then make your required changes and then click **EDIT PREFIX** to save your changes: + + ![edit prefix](../images/prefix-lists/edit-prefix-list-2.png) + +4. To delete a prefix, click **DELETE** and then if you are sure you wish to delete the prefix, click **DELETE PREFIX** when prompted: + + ![delete prefix](../images/prefix-lists/edit-prefix-list-3.png) + +## Delete a Prefix List + +*Note* - in order for a prefix list to be deleted it must first be detached from any NetBox instances that it is securing. You will need to contact support and request this before you can delete it. + +1. From within the Admin Console, navigate to **Settings** in the left-hand menu, and then scroll down and click to expand the **Prefix List** section. Then click on the name of the prefix list you wish to delete, and click **DELETE PREFIX LIST**: + + ![delete prefix list](../images/prefix-lists/delete-prefix-list-1.png) + +2. If you are sure you wish to delete the prefix list then click **DELETE PREFIX LIST** when you are prompted to confirm the deletion: + + ![delete prefix list](../images/prefix-lists/delete-prefix-list-2.png) + +If you encounter any issues while working with the IP Allow List raise a support ticket by emailing the [NetBox Labs Support Team](mailto:support@netboxlabs.com) \ No newline at end of file diff --git a/docs/images/prefix-lists/create-prefix-list-non-sync-1.png b/docs/images/prefix-lists/create-prefix-list-non-sync-1.png new file mode 100644 index 0000000..a5d7e21 Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list-non-sync-1.png differ diff --git a/docs/images/prefix-lists/create-prefix-list-non-sync-2.png b/docs/images/prefix-lists/create-prefix-list-non-sync-2.png new file mode 100644 index 0000000..f3d85b5 Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list-non-sync-2.png differ diff --git a/docs/images/prefix-lists/create-prefix-list-non-sync-3.png b/docs/images/prefix-lists/create-prefix-list-non-sync-3.png new file mode 100644 index 0000000..38d5a9e Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list-non-sync-3.png differ diff --git a/docs/images/prefix-lists/create-prefix-list-sync-1.png b/docs/images/prefix-lists/create-prefix-list-sync-1.png new file mode 100644 index 0000000..628b4f0 Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list-sync-1.png differ diff --git a/docs/images/prefix-lists/create-prefix-list-sync-2.png b/docs/images/prefix-lists/create-prefix-list-sync-2.png new file mode 100644 index 0000000..edbb4be Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list-sync-2.png differ diff --git a/docs/images/prefix-lists/create-prefix-list-sync-3.png b/docs/images/prefix-lists/create-prefix-list-sync-3.png new file mode 100644 index 0000000..3bddab0 Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list-sync-3.png differ diff --git a/docs/images/prefix-lists/create-prefix-list-sync-4.png b/docs/images/prefix-lists/create-prefix-list-sync-4.png new file mode 100644 index 0000000..9449dd6 Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list-sync-4.png differ diff --git a/docs/images/prefix-lists/create-prefix-list-sync-5.png b/docs/images/prefix-lists/create-prefix-list-sync-5.png new file mode 100644 index 0000000..e228ff2 Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list-sync-5.png differ diff --git a/docs/images/prefix-lists/create-prefix-list.png b/docs/images/prefix-lists/create-prefix-list.png new file mode 100644 index 0000000..995f6ed Binary files /dev/null and b/docs/images/prefix-lists/create-prefix-list.png differ diff --git a/docs/images/prefix-lists/delete-prefix-list-1.png b/docs/images/prefix-lists/delete-prefix-list-1.png new file mode 100644 index 0000000..ce605c4 Binary files /dev/null and b/docs/images/prefix-lists/delete-prefix-list-1.png differ diff --git a/docs/images/prefix-lists/delete-prefix-list-2.png b/docs/images/prefix-lists/delete-prefix-list-2.png new file mode 100644 index 0000000..ec396d5 Binary files /dev/null and b/docs/images/prefix-lists/delete-prefix-list-2.png differ diff --git a/docs/images/prefix-lists/edit-prefix-list-1.png b/docs/images/prefix-lists/edit-prefix-list-1.png new file mode 100644 index 0000000..bcd4e64 Binary files /dev/null and b/docs/images/prefix-lists/edit-prefix-list-1.png differ diff --git a/docs/images/prefix-lists/edit-prefix-list-2.png b/docs/images/prefix-lists/edit-prefix-list-2.png new file mode 100644 index 0000000..9030337 Binary files /dev/null and b/docs/images/prefix-lists/edit-prefix-list-2.png differ diff --git a/docs/images/prefix-lists/edit-prefix-list-3.png b/docs/images/prefix-lists/edit-prefix-list-3.png new file mode 100644 index 0000000..909ffef Binary files /dev/null and b/docs/images/prefix-lists/edit-prefix-list-3.png differ diff --git a/docs/images/prefix-lists/settings.png b/docs/images/prefix-lists/settings.png new file mode 100644 index 0000000..92cf2f4 Binary files /dev/null and b/docs/images/prefix-lists/settings.png differ diff --git a/mkdocs.yml b/mkdocs.yml index 813c839..d565428 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -37,8 +37,8 @@ plugins: nav: - Home: index.md - Guides: + - Prefix Lists: "Administration Console/prefix-lists.md" - Working with Database Backups: "Administration Console/working_with_database_backups.md" - - Configure IP Allow List: "Administration Console/configuring_ip_allow_lists.md" - Upgrade NetBox Cloud: "Administration Console/upgrading-nbc.md" - Set up Two-Factor Authentication: "Administration Console/set_up_2fa.md" - Migrate to NetBox Cloud: "NetBox Cloud/migrating-to-netbox-cloud.md"