Configuração do Openflow - Snowflake Deployment: Configurar domínios permitidos para conectores Openflow

Openflow - Snowflake Deployments access external domain resources. Snowflake controls access to external domains using network rules and external access integrations to either grant or deny access to specific domains.

This topic describes the process of creating a network rule and creating an external access integration to grant access to a specific domain. In addition, the known domains used by Openflow connectors are provided.

Existem dois fluxos de trabalho possíveis para gerenciar o acesso a domínios externos:

Create a network rule granting access to one or more domains

To create a new network rule that grants access to one or more domain/port combinations, execute an SQL statement similar to:

USE ROLE SECURITYADMIN;

CREATE NETWORK RULE MY_OPENFLOW_NETWORK_RULE
   TYPE = HOST_PORT
   MODE = EGRESS
   VALUE_LIST = ('<domain>', '<domain>');
Copy

For example, to allow Snowflake to access googleads.googleapis.com, execute the following.

USE ROLE SECURITYADMIN;

CREATE NETWORK RULE GOOGLEADS_OPENFLOW_NETWORK_RULE
   TYPE = HOST_PORT
   MODE = EGRESS
   VALUE_LIST = ('googleads.googleapis.com');
Copy

For more information, see CREATE NETWORK RULE.

After the network rule is created, a external access integration has to be created.

To create a new integration, execute an SQL statement similar to:

USE ROLE SECURITYADMIN;

CREATE EXTERNAL ACCESS INTEGRATION MY_OPENFLOW_EAI
   ALLOWED_NETWORK_RULES = (MY_OPENFLOW_NETWORK_RULE)
   ENABLED = TRUE
   COMMENT = 'External Access Integration for Openflow connectivity';
Copy

Alter an existing network rule granting access to one or more domains

To alter an existing network rule to grant access to one or more domain/port combinations, execute an SQL statement similar to:

USE ROLE SECURITYADMIN;

ALTER NETWORK RULE GOOGLEADS_OPENFLOW_NETWORK_RULE SET
   VALUE_LIST = ('<existing domain>', '<existing domain>', 'googleads.googleapis.com');
Copy

For more information, see ALTER NETWORK RULE.

Nota

Use SHOW NETWORK RULES to list the existing network rules. . Use DESCRIBE NETWORK RULE to describe the properties of a specific network rule.

If the altered network rule is already associated with an external access integration, it will be updated automatically. If you do not have an external access integration for the altered network rule, refer to the section above for instructions on creating a new integration.

Next steps

  1. Associate an external access integration with your runtime:

    1. Navigate to the Openflow canvas.

    2. Select the Runtimes tab.

    3. For the runtime which requires the new external access integration, click the Vertical more icon menu.

    4. Select External access integrations.

    5. Select all required external access integrations from the dropdown list. . Note you may select multiple external access integrations.

    6. Click Save.

      Nota

      Restarting the runtime is not required and the changes are applied immediately.

  2. Deploy a connector in a runtime, for a list of connectors available in Openflow, see Conectores Openflow.

Domínios utilizados ​​por conectores OpenFlow

The following domains are used by Openflow connectors and require network rules to be granted access.

Amazon Ads

Os seguintes domínios são utilizados ​​pelo conector Amazon Ads.

  • advertising-api.amazon.com

  • advertising-api-eu.amazon.com

  • advertising-api-fe.amazon.com

  • api.amazon.com

  • api.amazon.co.uk

  • api.amazon.co.jp

  • Localização do relatório. Por exemplo, offline-report-storage-eu-west-1-prod.s3.eu-west-1.amazonaws.com é utilizado para baixar relatórios.

A localização exata do URL do relatório nem sempre é conhecida antes da criação de um relatório. A Snowflake recomenda permitir a listagem de todas as regiões S3:

  • *.s3.eu-west-[1-3].amazonaws.com

  • *.s3.eu-central-[1-2].amazonaws.com

  • *.s3.eu-north-1.amazonaws.com

  • *.s3.eu-south-[1-2].amazonaws.com

  • *.s3.il-central-1.amazonaws.com

  • Para advertising-api-fe.amazon.com (Far East / APAC):

    • *.s3.ap-northeast-[1-3].amazonaws.com

    • *.s3.ap-south-[1-2].amazonaws.com

    • *.s3.ap-southeast-[1-7].amazonaws.com

    • *.s3.ap-east-[1-2].amazonaws.com

    • *.s3.me-south-1.amazonaws.com

    • *.s3.me-central-1.amazonaws.com

    • *.s3.af-south-1.amazonaws.com

O último domínio obtido do URL do relatório é retornado após o relatório estar pronto para ser buscado. Este é um bucket Amazon S3 em que o relatório é armazenado. Os clientes precisarão especificar sua própria região AWS, por exemplo, us-east-1 ou eu-west-1, e um bucket específico. Como pode não ser possível saber a região e o bucket exatos, a Snowflake sugere o uso de curingas e a listagem de todas as regiões possíveis para uma determinada localização.

AWS Secret Manager

Os seguintes domínios são utilizados ​​pelo conector AWS Secret Manager.

  • secretsmanager.us-west-2.amazonaws.com

  • sts.us-west-2.amazonaws.com

  • aws.amazon.com

  • amazonaws.com

Box

Os seguintes domínios são utilizados ​​pelo conector Box.

  • api.box.com

  • box.com

Confluence

Os seguintes domínios são utilizados ​​pelo conector Confluence.

Microsoft Dataverse

Os seguintes domínios são utilizados ​​pelo conector Dataverse.

  • Nome de domínio específico do cliente, como org12345467.crm.dynamics.com

  • Para OAuth, login.microsoftonline.com

Google Drive

Os seguintes domínios são utilizados ​​pelo conector Google Drive:

  • drive.google.com

  • www.googleapis.com

  • oauth2.googleapis.com

  • www.googleapis.com

Google Sheets

Os seguintes domínios são utilizados ​​pelo conector Google Sheets.

  • sheets.googleapis.com

Hubspot

Os seguintes domínios são utilizados ​​pelo conector HubSpot.

  • api.hubapi.com

Jira Cloud

Os seguintes domínios são utilizados ​​pelo conector Jira Cloud.

  • Nome de domínio específico do cliente, por exemplo, company-name.atlassian.net

  • api.atlassian.com

Kafka

Os seguintes domínios são utilizados ​​pelo conector Kafka.

  • Servidores bootstrap do Kafka do cliente e todos os brokers do Kafka

Kinesis

Os seguintes domínios são utilizados ​​pelo conector Kinesis.

  • Depende da região da AWS. Por exemplo:

    para us-west-2:

    • kinesis.us-west-2.amazonaws.com

    • kinesis-fips.us-west-2.api.aws

    • kinesis-fips.us-west-2.amazonaws.com

    • kinesis.us-west-2.api.aws

    • *.control-kinesis.us-west-2.amazonaws.com

    • *.control-kinesis.us-west-2.api.aws

    • *.data-kinesis.us-west-2.amazonaws.com

    • *.data-kinesis.us-west-2.api.aws

    • dynamodb.us-west-2.amazonaws.com

    • monitoring.us-west-2.amazonaws.com:80

    • monitoring.us-west-2.amazonaws.com:443

    • monitoring-fips.us-west-2.amazonaws.com:80

    • monitoring-fips.us-west-2.amazonaws.com:443

    • monitoring.us-west-2.api.aws:80

    • monitoring.us-west-2.api.aws:443

LinkedIn Ads

Os seguintes domínios são utilizados ​​pelo conector LinkedIn Ads.

  • www.linkedin.com

  • api.linkedin.com

Meta Ads

Os seguintes domínios são utilizados ​​pelo conector de Meta Ads.

  • graph.facebook.com

MySQL

Os seguintes domínios são utilizados ​​pelo conector MySQL.

  • Combinação de porta e domínio específica do cliente.

PostgreSQL

Os seguintes domínios são utilizados ​​pelo conector PostgreSQL.

  • Combinação de porta e domínio específica do cliente.

SharePoint

Os seguintes domínios são utilizados ​​pelo conector SharePoint.

  • Domínio específico do cliente: por exemplo, company-domain.sharepoint.com ou um alias que redireciona para company-domain.sharepoint.com

  • graph.microsoft.com:80

  • graph.microsoft.com:443

  • login.microsoftonline.com

Slack

Os seguintes domínios são utilizados ​​pelo conector Slack.

  • slack.com e api.slack.com

SQL Server

Os seguintes domínios são utilizados ​​pelo conector SQL Server.

  • Combinação de porta e domínio específica do cliente.

Workday

Os seguintes domínios são utilizados ​​pelo conector Workday.

  • Customer-specific domain and port combination. For example, company-domain.tenant.myworkday.com.

    Para obter o domínio, você pode usar o URL do relatório (o URL base é sempre o mesmo).