AWS neptune-analytics documentation change
Summary
Restructured notebook creation documentation to reference Neptune workbench guide, added IAM role creation link, and removed detailed SageMaker notebook configuration steps
Security assessment
Added explicit reference to IAM role creation documentation which is a security feature. Removed environment variables related to SSL and authentication, but these were replaced with references to external documentation rather than indicating a vulnerability. The change improves security documentation by emphasizing proper IAM role setup.
Diff
diff --git a/neptune-analytics/latest/userguide/create-notebook-console.md b/neptune-analytics/latest/userguide/create-notebook-console.md index 53b02d634..256ea412a 100644 --- a//neptune-analytics/latest/userguide/create-notebook-console.md +++ b//neptune-analytics/latest/userguide/create-notebook-console.md @@ -5 +5 @@ -Create an IAM roleCreate the notebook +Create an IAM role @@ -9 +9,8 @@ Create an IAM roleCreate the notebook -You can create a new notebook manually using the AWS Management Console if you aren't able to use AWS CloudFormation. The first thing you need is an IAM role to use for the notebook. If you already have one, you can skip the following section. +You can create a new notebook for Neptune Analytics by following the instructions mentioned in [ Using the Neptune workbench to host Neptune notebooks](https://docs.aws.amazon.com/neptune/latest/userguide/graph-notebooks.html#graph-notebooks-workbench) with a few changes: + + * While selecting the Neptune service, please choose **Analytics**. + + * The console can create an AWS AWS Identity and Access Management role for your notebooks, or you can create one yourself by following [ Create an IAM role for a Neptune Analytics notebook](https://docs.aws.amazon.com/neptune-analytics/latest/userguide/create-notebook-console.html#create-notebook-iam-role). + + + @@ -99,60 +105,0 @@ You can create a new notebook manually using the AWS Management Console if you a -## Next, create the Neptune Analytics notebook in SageMaker AI - -###### - - 1. Open the Amazon SageMaker AI console at [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/). - - 2. In the navigation pane, expand **Notebook** , then choose **Notebook instances**. - - 3. Choose **Create notebook instance**. - - 4. In **Notebook instance settings** , under **Notebook instance name** , give the notebook a name prefixed by `aws-neptune-` (for example, `aws-neptune-my-test-notebook`). - - 5. Under **Platform identifier** , select **Amazon Linux 2, JupyterLab 3**. - - 6. Select **Additional configuration**. - - 7. Under **Lifecycle configuration** , choose **Create a new lifecycle configuration**. - - 8. In **Configuration** , under **Name** enter the notebook instance name from step 4. - - 9. In **Scripts** , under **Start notebook** , replace the existing script with this: - - #!/bin/bash - - sudo -u ec2-user -i <<'EOF' - - echo "export GRAPH_NOTEBOOK_AUTH_MODE=IAM" >> ~/.bashrc - echo "export GRAPH_NOTEBOOK_SSL=True" >> ~/.bashrc - echo "export GRAPH_NOTEBOOK_SERVICE=neptune-graph" >> ~/.bashrc - echo "export GRAPH_NOTEBOOK_HOST=(Neptune Analytics graph endpoint, public or private)" >> ~/.bashrc - echo "export GRAPH_NOTEBOOK_PORT=8182" >> ~/.bashrc - echo "export NEPTUNE_LOAD_FROM_S3_ROLE_ARN=" >> ~/.bashrc - echo "export AWS_REGION=(AWS region)" >> ~/.bashrc - - aws s3 cp s3://aws-neptune-notebook-(AWS region)/graph_notebook.tar.gz /tmp/graph_notebook.tar.gz - rm -rf /tmp/graph_notebook - tar -zxvf /tmp/graph_notebook.tar.gz -C /tmp - /tmp/graph_notebook/install.sh - - EOF - - 10. Select **Create configuration**. - - 11. In **Permissions and encryption** , under **IAM Role** , select the role you created above. - - 12. In **Network** , if you are using a private graph endpoint: - - 1. Under **VPC** , select the VPC where the Neptune Analytics graph resides. - - 2. Under **Subnet** , select a subnet associated with the Neptune Analytics graph. - - 3. Under **Security Group(s)** , select all the security groups associated with the Neptune Analytics graph. - - 13. Choose **Create notebook instance**. - - 14. After 5 or 10 minutes, when your new notebook reaches `Ready` status, select it. Choose **Open Jupyter** or **Open JupyterLab**. - - - -