为 Amazon Q 开发者版配置防火墙、代理服务器或数据边界 - Amazon Q 开发者版
一般 URLs 到许可名单Amazon S3 存储桶 URLs 和 ARNs 允许名单在 Amazon Q 中配置公司代理

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

为 Amazon Q 开发者版配置防火墙、代理服务器或数据边界

如果您使用的是防火墙、代理服务器或数据边界，请确保将以下内容和 URLs Amazon 资源名称 (ARNs) 的流量列入许可名单，以便 Amazon Q 按预期运行。

一般 URLs 到许可名单

在以下内容中 URLs，替换：

URL 用途

idc-directory-id-or-alias.awsapps.com

身份验证

oidc.sso-region.amazonaws.com

身份验证

*.sso.sso-region.amazonaws.com

身份验证

*.sso-portal.sso-region.amazonaws.com

身份验证

*.aws.dev

身份验证

*.awsstatic.com

身份验证

*.console.aws.a2z.com

身份验证

*.sso.amazonaws.com

身份验证

https://codewhisperer.us-east-1.amazonaws.com

Amazon Q 开发者版功能

https://q.profile-region.amazonaws.com

Amazon Q 开发者版功能

https://idetoolkits-hostedfiles.amazonaws.com/*

IDE 中的 Amazon Q 开发者版，配置

https://idetoolkits.amazonwebservices.com/*

IDE 中的 Amazon Q 开发者版，端点

q-developer-integration.us-east-1.api.aws

IDE 中的 Amazon Q 开发者版，端点

https://aws-toolkit-language-servers.amazonaws.com/*

IDE 中的 Amazon Q 开发者版，语言处理

https://aws-language-servers.us-east-1.amazonaws.com/*

IDE 中的 Amazon Q 开发者版，语言处理

https://client-telemetry.us-east-1.amazonaws.com

IDE 中的 Amazon Q 开发者版，遥测

cognito-identity.us-east-1.amazonaws.com

IDE 中的 Amazon Q 开发者版，遥测

Amazon S3 存储桶 URLs 和 ARNs 允许名单

对于某些功能，Amazon Q 会将项目上传到 AWS 服务拥有的 Amazon S3 存储桶。如果您使用数据边界来控制环境中对 Amazon S3 的访问，则可能需要明确允许访问这些存储桶才能使用相应的 Amazon Q 功能。

下表列出了 Amazon Q 需要访问的每个 Amazon S3 存储桶的 URL 和 ARN，以及使用每个存储桶的功能。可以使用存储桶 URL 或存储桶 ARN 将这些存储桶列入允许列表，具体取决于您如何控制对 Amazon S3 的访问权限。

您只需要在安装了 Amazon Q 开发者配置文件的 AWS 地区将存储桶列入许可名单。有关 Amazon Q 开发者版配置文件的更多信息，请参阅什么是 Amazon Q 开发者版配置文件？。

Amazon S3 存储桶 URL 和 ARN 用途

美国东部（弗吉尼亚州北部）：

  • https://amazonq-code-scan-us-east-1-29121b44f7b.s3.amazonaws.com/

  • arn:aws:s3:::amazonq-code-scan-us-east-1-29121b44f7b

欧洲地区（法兰克福）：

  • https://amazonq-code-scan-eu-central-1-9374e402cc5.s3.amazonaws.com/

  • arn:aws:s3:::amazonq-code-scan-eu-central-1-9374e402cc5

用于上传 Amazon Q 代码审查的构件的 Amazon S3 存储桶

美国东部（弗吉尼亚州北部）：

  • https://amazonq-code-transformation-us-east-1-c6160f047e0.s3.amazonaws.com/

  • arn:aws:s3:::amazonq-code-transformation-us-east-1-c6160f047e0

欧洲地区（法兰克福）：

  • https://amazonq-code-transformation-eu-central-1-a0a89cc2b94.s3.amazonaws.com/

  • arn:aws:s3:::amazonq-code-transformation-eu-central-1-a0a89cc2b94

用于上传 Amazon Q 代码转换的构件的 Amazon S3 存储桶

在 Amazon Q 中配置公司代理

如果最终用户在公司代理后面工作，请让他们完成以下步骤，以成功连接到 Amazon Q。

步骤 1：在 IDE 中配置代理设置

在 IDE 中指定代理服务器的 URL。

注意

不支持 SOCKS 代理和代理自动配置（PAC）文件。您必须按照以下说明手动配置 HTTP 或 HTTPS 代理。

Eclipse

  1. 在 Eclipse 中，按以下方式打开首选项：

    • 在 Windows 或 Ubuntu 上：

      • 从 Eclipse 菜单栏中选择窗口，然后选择首选项。

    • 在 macOS 上：

      • 从菜单栏中选择 Eclipse，然后根据您的 macOS 版本选择设置或首选项。

  2. 在搜索栏中，输入 Amazon Q 并打开 Amazon Q。

  3. 在代理设置下，将 HTTPS 代理 URL 设置为公司代理 URL。

    示例：http://proxy.company.com:8080、https://proxy.company.com:8443

  4. 将 Amazon Q 设置保持为打开状态，然后转到下一步。

JetBrains

在中 JetBrains，按照 IntelliJ IDEA 文档的 HTTP 代理主题中的指导手动配置代理服务器的主机名和端口。

Visual Studio

  1. 从 Visual Studio 主菜单中选择工具，然后选择选项。

  2. 从选项菜单中展开 AWS Toolkit，然后选择代理。

  3. 从代理菜单中，将主机和端口设置为公司代理主机和端口。

    示例：http://proxy.company.com:8080、https://proxy.company.com:8443

Visual Studio Code

  1. 在 VS Code 中，按 CMD + ,（Mac）或 Ctrl + ,（Windows/Linux）打开 VS Code 设置。

  2. 从设置搜索栏中输入 Http: Proxy，然后在搜索结果中找到它。

  3. 输入公司代理 URL。

    示例：http://proxy.company.com:8080、https://proxy.company.com:8443

  4. （可选）在设置搜索栏中输入 HTTP: No Proxy，然后在结果中找到它。

  5. 选择添加项目按钮，然后添加绕过代理的域，用逗号分隔。

步骤 2：配置 SSL 证书处理

Amazon Q 自动检测并使用您系统上安装的可信证书。如果您遇到证书错误，则必须通过完成以下过程来手动指定证书捆绑包。

注意

以下是需要手动配置的情形。

  • 配置代理后，您遇到了与证书相关的错误。

  • 公司代理使用的证书不在系统的信任存储中。

  • Amazon Q 无法自动检测公司证书。

Eclipse

  • 在 Eclipse 的 Amazon Q 设置中，在代理设置下，将 CA 证书 PEM 设置为公司证书文件的路径。文件必须具有 .pem 文件扩展名。（不能使用 .crt 文件。）

    示例路径与以下内容类似：

    /path/to/corporate-ca-bundle.pem

    有关获取此文件的说明，请参阅获取公司证书。

JetBrains

在中 JetBrains，按照 IntelliJ IDEA 文档中受信任的根证书主题中的指导手动安装您的公司证书。

有关获取证书的说明，请参阅获取公司证书。

Visual Studio

  • 配置以下 Windows 环境变量：

    • NODE_OPTIONS = --use-openssl-ca

    • NODE_EXTRA_CA_CERTS = cert-path

    cert-path替换为公司证书文件的路径。文件必须具有 .pem 文件扩展名。（不能使用 .crt 文件。）

    示例路径与以下内容类似：

    /path/to/corporate-ca-bundle.pem

    有关获取公司证书文件的说明，请参阅获取公司证书。有关 Windows 环境变量的详细信息，请参阅 Node.js documentation。

Visual Studio Code

  1. 在 VS Code 中，按 CMD + ,（Mac）或 Ctrl + ,（Windows/Linux）打开 VS Code 设置。

  2. 从设置搜索栏中输入 Amazon Q › Proxy: Certificate Authority，然后在搜索结果中找到它。

  3. 输入公司证书文件的路径。它将具有 .pem 或 .crt 文件扩展名。

    示例路径与以下内容类似：

    /path/to/corporate-ca-bundle.pem

    有关获取此文件的说明，请参阅获取公司证书。

步骤 3：重新启动 IDE

您必须重新启动 IDE 才能使用所做的更改更新 Amazon Q。

故障排查

如果您已完成前几节中的步骤，但仍遇到问题，请按照以下说明进行故障排除。

Eclipse

  1. 确保代理 URL 格式包含 http:// 或 https://。

  2. 确保证书文件路径正确且可访问。

  3. 在 Eclipse 错误日志中查看 Amazon Q 日志。要导航至错误日志，请执行以下操作之一：

    • 在 Eclipse 中登录 Amazon Q，选择右上角 Q 图标旁边的向下箭头，然后依次选择帮助和查看日志。

    • 从 Eclipse 菜单中依次选择窗口、显示视图和错误日志。

    注意

    如果您遇到以下错误消息：

JetBrains

  1. 确保代理 URL 格式包含 http:// 或 https://。

  2. 确保证书文件路径正确且可访问。

  3. 在日志文件中查看您的 Amazon Q JetBrains 日志。有关查找日志文件的帮助，请参阅 “Support（ JetBrains IDEs 支持）” 页面上的 “查找 IDE 日志文件”。

    注意

    如果您遇到以下错误消息：

Visual Studio

  1. 确保代理 URL 格式包含 http:// 或 https://。

  2. 确保证书文件路径正确且可访问。

  3. 按如下方式查看 AWS Toolkit 扩展程序的日志：

    • 在 Visual Studio 主菜单中，展开扩展。

    • 选择 AWS Toolkit 展开 AWS 工具包菜单，然后选择查看 Toolkit 日志。

    • 当 AWS Toolkit 日志文件夹在您的操作系统中打开时，按日期对文件进行排序，然后找到任何包含与当前问题相关的信息的日志文件。

  4. 在 Visual Studio 活动日志中查看 Amazon Q 日志。有关更多信息，请参阅 Troubleshooting Extensions with the Activity Log。

    注意

    如果您遇到以下错误消息：

Visual Studio Code

  1. 确保代理 URL 格式包含 http:// 或 https://。

  2. 确保证书文件路径正确且可访问。

  3. 在 VS Code 的输出面板中查看 Amazon Q 日志。

    注意

    如果您遇到以下错误消息：

获取公司证书

要获取公司证书，请向您的 IT 团队询问以下信息：

  • 公司证书捆绑包，通常是 .pem 或 .crt 文件。

  • 代理服务器详细信息，包括主机名、端口和身份验证方法。

或者，从浏览器导出证书：

  1. 访问公司域上的任何 HTTPS 网站。

  2. 在地址栏附近，选择锁图标或类似图标。（此图标因浏览器供应商而异。）

  3. 将根证书导出到文件中。确保包括整个证书链。根据您使用的浏览器，导出根证书的步骤会略有不同。有关详细步骤，请查阅浏览器的文档。