As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Começando com AWS SDK para SAP ABAP Esta seção descreve como começar a usar o SDK. Ele inclui informações sobre como instalar o SDK, realizar a configuração básica e criar um exemplo de código Hello World que traduz uma frase de um idioma para outro. Se você é iniciante no AWS SDK, recomendamos realizar essas etapas em um ambiente sandbox. **Topics** + [Etapa 1: Prepare sua AWS conta](#prepare-account) + [Etapa 2: instalar o SDK](#installation-sdk) + [Etapa 3: configurar o SDK](#configure) + [Etapa 4: configuração funcional](#functional-setup) + [Etapa 5: Autorizar usuários do SAP](#authorize-users) + [Etapa 6: escrever o código](#write-code) + [Etapa 7: executar o aplicativo](#run-application) ## Etapa 1: Prepare sua AWS conta Para começar a usar o SDK para SAP ABAP, você deve ter uma Conta da AWS ativa. Você precisa de um, Conta da AWS mesmo que seu sistema SAP esteja hospedado localmente, na SAP Business Technology Platform (BTP) ou com outro provedor de nuvem. Se o seu sistema SAP estiver sendo executado na AWS nuvem, você fará chamadas para AWS serviços em seu Conta da AWS. **Topics** + [Perfil do IAM para usuários do SAP](#iamrole) + [Autenticação](#authentication) ### Perfil do IAM para usuários do SAP + Crie um perfil do IAM com as instruções fornecidas no *Guia do usuário da AWS Identity and Access Management *. Para obter mais informações, consulte [Criação de uma função para delegar permissões a um AWS serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html). Observe o nome do recurso da Amazon (ARN) do perfil do IAM para uso posterior. + Selecione Amazon EC2 como o caso de uso. + Use `SapDemoTranslate` como nome do perfil. + Anexe o perfil `TranslateReadOnly` ao perfil. + O perfil deve ter as seguintes entidades para permitir que o sistema SAP assuma o perfil. Substitua `"111122223333"` pelo número da sua conta da AWS . ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sts:AssumeRole" ], "Principal": { "AWS": "111122223333" } } ] } ``` ------ Este exemplo mostra que qualquer diretor da Conta da AWS `"111122223333"` pode assumir a função. Essa é uma permissão ampla que é adequada para proof-of-concept. Você pode usar uma entidade principal mais restrito para produção, como nos exemplos a seguir. + Um usuário específico — quando o sistema SAP está usando um dos seguintes: + Credenciais criptografadas por SSF de um sistema SAP local + Credenciais do serviço SAP Credential Store no ambiente SAP BTP, ABAP + Um perfil específico, quando o sistema SAP está no Amazon EC2 e há um perfil de instância. + Amazon EC2, quando o sistema SAP está no Amazon EC2 e *não há* perfil de instância. Para obter mais informações, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/best-practices.html). ### Autenticação A autenticação depende de onde seu sistema SAP está hospedado. **Topics** + [Na AWS nuvem](#aws-cloud) + [No local, SAP BTP ou outra nuvem](#on-premises-other) #### Na AWS nuvem Certifique-se de que a instância EC2 na qual seu sistema SAP está sendo executado tenha um perfil de instância com as seguintes permissões. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "arn:aws:iam::111122223333:role/SapDemoTranslate" } ] } ``` ------ Adicione o ARN que você anotou na etapa anterior. Essa permissão permite que seu sistema SAP assuma o perfil `SapDemoTranslate` em nome do usuário do ABAP. #### No local, SAP BTP ou outra nuvem Se seu sistema SAP estiver localizado no local, no SAP BTP ou em outra nuvem, use as etapas a seguir para estabelecer uma conexão para autenticação usando a chave de acesso secreta. 1. Criar um usuário do IAM. Para obter mais informações, consulte [Criar usuários do IAM (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#id_users_create_console) . 1. Use `SapDemoSID` como o nome de usuário do IAM. `SID` é o ID do sistema do seu sistema SAP. 1. Atribua um perfil `SapDemoTranslate` a esse usuário. Guarde a `access_key` mão`secret_access_key`. Você deve configurar essas credenciais em seu sistema SAP. **nota** Se seu sistema SAP estiver localizado no local, no SAP BTP ou em outra nuvem, você poderá autenticar usando uma das seguintes opções. [Autenticação de chave de acesso secreta](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/system-authentication.html#key-authentication) usando SSF ou SAP Credential Store [Usando certificados com o IAM Roles Anywhere](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/using-iam.html) ## Etapa 2: instalar o SDK Consulte as guias a seguir para obter instruções de instalação. ------ #### [ SDK for SAP ABAP ] Importe o SDK para transportes SAP ABAP em seu sistema SAP. Você pode importar os transportes para qualquer cliente. Para obter mais informações, consulte [Instalando o SDK para SAP ABAP](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/installation.html). ------ #### [ SDK for SAP ABAP - BTP edition ] Instale o SDK para SAP ABAP - edição BTP usando o aplicativo **Deploy** Product. Para obter mais informações, consulte [Instalando o SDK para SAP ABAP - edição BTP](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/installation-btp.html). ------ ## Etapa 3: configurar o SDK Antes de configurar o SDK, verifique se você tem as autorizações necessárias. Para obter mais informações, consulte [Autorizações SAP](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/authorizations.html). Consulte as guias a seguir para obter instruções de configuração. ------ #### [ SDK for SAP ABAP ] Execute a `/AWS1/IMG` transação para abrir o Guia de implementação do SDK para SAP ABAP. Para executar essa transação, insira `/n/AWS1/IMG ` na barra de comando do seu sistema SAP e escolha **Enter**. Conclua as configurações a seguir. + Acesse **Pré-requisitos técnicos**. + Analise os [parâmetros](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/prerequisites.html#parameters) recomendados e a [conectividade HTTPS](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/prerequisites.html#https-connectivity). + Vá para **Configurações globais** → **Configurar cenários**. + Altere as configurações, de acordo com as recomendações em [Configurações globais](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/global-settings.html). + Vá para **Configurações globais** → **Configurações técnicas**. + Altere as configurações, de acordo com as recomendações em [Configurações globais](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/global-settings.html). + Vá para **Configurações de runtime** → **Registrar e rastrear**. + Selecione **Novas entradas**. + **Nível de rastreamento**: sem rastreamento. + **Linhas de despejo máximas**: `100`. + **OPT-IN: enh telemetry**: mantenha isso em branco. + Selecione **Salvar**. + Vá para **Configurações de runtime** → **Cenário ativo**. + Em **Novo cenário**, selecione `DEFAULT`. + Selecione **Confirmar alteração de cenário**. + Aceite a solicitação. **Pré-requisitos para sistemas on-premises** Se o sistema SAP estiver sendo executado on-premises ou em outra nuvem, as credenciais deverão ser armazenadas no banco de dados SAP. As credenciais são criptografadas usando o SAP SSF e exigem uma biblioteca criptográfica configurada, como a da SAP. CommonCryptoLib As etapas para configurar o SSF para SDK para SAP ABAP estão descritas na transação `/AWS1/IMG`. **nota** O pré-requisito anterior não se aplicará se seu sistema SAP estiver sendo executado no Amazon EC2. Os sistemas SAP executados no Amazon EC2 recuperam credenciais de curta duração e rotativas automáticas dos metadados da instância do Amazon EC2. ------ #### [ SDK for SAP ABAP - BTP edition ] Abra seu ambiente ABAP em um navegador da Web e navegue até o aplicativo Custom Business Configurations. Conclua as configurações a seguir. + Vá para **Configurar cenários**. + Altere as configurações, de acordo com as recomendações em [Configurações globais](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/global-settings.html). + Vá para **Configurações técnicas**. + Altere as configurações, de acordo com as recomendações em [Configurações globais](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/global-settings.html). ------ ## Etapa 4: configuração funcional Consulte as guias a seguir para obter instruções de configuração. ------ #### [ SDK for SAP ABAP ] Execute a transação `/AWS1/IMG` (insira `/n/AWS1/IMG` na barra de comando e escolha **Enter**) para abrir o guia de implementação do AWS SDK. + Vá para **Configuração do aplicativo** → **Perfil do SDK**. + Selecione **Novas entradas**. + **Perfil**: `DEMO`. + **Descrição:** `Demo profile`. + Selecione **Salvar**. + Destaque a entrada que você criou e clique na ramificação de árvore **Autenticação e Configurações**. + Selecione **Novas entradas**. + **SID**: o ID do sistema SAP em que você está atualmente. + **Cliente**: o cliente do sistema SAP em que você está atualmente. + **ID do cenário**: a lista suspensa onde você encontrará o cenário PADRÃO criado pelo administrador do Basis. + **AWS Região**: insira a AWS região para a qual você deseja fazer chamadas. Se o seu sistema SAP estiver sendo executado AWS, insira a AWS região em que ele está sendo executado. + Método de autenticação: + Selecione o **Perfil da instância por meio de metadados** se seu sistema SAP estiver em execução no Amazon EC2. + Selecione **Credenciais do armazenamento SSF** se seu sistema SAP estiver sendo executado on-premises ou em outra nuvem. + Selecione **Definir credenciais**. + Insira a ID da chave de acesso e a chave de acesso secreta que você criou na etapa anterior. + Mantenha a opção **Desativar perfis do IAM**. + Selecione **Salvar**. + Clique na ramificação da árvore de **Mapeamento de perfis do IAM**. + Selecione **Novas entradas**. + Insira o **número de sequência**: 010. + Insira o **perfil lógico do IAM**: TESTUSER. + Insira o **ARN do perfil do IAM**: insira o arn:aws: do perfil do IAM que contém a política `TranslateReadOnly` criada na etapa anterior. ------ #### [ SDK for SAP ABAP - BTP edition ] Configure a autenticação usando o SAP Credential Store. Para obter mais informações, consulte [Usando o SAP Credential Store](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/credential-store.html). Abra seu ambiente ABAP em um navegador da Web e navegue até o aplicativo Custom Business Configurations. + Acesse o **Perfil do SDK**. + Selecione **Editar** para criar um novo perfil. + **Perfil**: `DEMO`. + **Descrição:** `Demo profile`. + Selecione a tecla de seta para a direita ao lado da entrada criada para navegar até a guia **Autenticação e Configurações**. Selecione **Novas entradas**. + **SID**: o ID do sistema SAP em que você está atualmente. + **Cliente**: o cliente do sistema SAP em que você está atualmente. + **ID do cenário**: a lista suspensa onde você encontrará o cenário PADRÃO criado pelo administrador do Basis. + **AWS Região**: insira a AWS região para a qual você deseja fazer chamadas. Se o seu sistema SAP estiver sendo executado AWS, insira a AWS região em que ele está sendo executado. + Método de autenticação: selecione **as credenciais do SAP Credential Store**. + Insira o **namespace** e o **nome da chave** das credenciais armazenadas no SAP Credentials Store. + Insira o nome do **Acordo de Comunicação** criado para estabelecer a comunicação entre o SDK para SAP ABAP - edição BTP e o SAP Credential Store. + Mantenha a opção **Desativar perfis do IAM**. + Clique com o botão direito do mouse na tecla de seta direita ao lado da entrada criada para navegar até a guia **Mapeamento de funções do IAM**. Selecione **Novas entradas**. + Insira o **número de sequência**: 010. + Insira o **perfil lógico do IAM**: TESTUSER. + Insira o **ARN do perfil do IAM**: insira o arn:aws: do perfil do IAM que contém a política `TranslateReadOnly` criada na etapa anterior. ------ ## Etapa 5: Autorizar usuários do SAP Os usuários do SAP não estão autorizados a usar a AWS funcionalidade por padrão. Os usuários devem ser explicitamente autorizados usando as autorizações do SAP. Consulte as guias a seguir para obter mais detalhes. ------ #### [ SDK for SAP ABAP ] **Crie um perfil PFCG** + Vá para a transação `PFCG` + Insira o nome do perfil `ZAWS_SDK_DEMO_TESTUSER` e selecione **Criar perfil único**. + **Descrição:** `Role for demo AWS SDK functionality` + Vá até a guia **Autorizações**. + Selecione **Alterar dados de autorização** e aceite o pop-up informativo. + No pop-up *Escolher modelo*, selecione **Não selecionar modelos**. + Selecione **Adicionar manualmente** na barra de ferramentas. + Adicione os seguintes objetos de autorização: + `/AWS1/LROL` + `/AWS1/SESS` + Na árvore de autorização, insira: + Perfil para acessar a AWS APIs: `DEMO` + Perfil lógico do IAM: `TESTUSER` + Selecione **Salvar**. + Selecione **Gerar**. + Selecione **Voltar**. + Selecione **Salvar** para salvar o perfil. **Atribuir o perfil PFCG aos usuários do SAP** Qualquer usuário que tenha a `ZAWS_SDK_DEMO_TESTUSER` função atribuída será autorizado a usar as funções do AWS SDK com as configurações definidas no perfil do `DEMO` SDK. O usuário autorizado também assumirá o perfil do IAM mapeado para o padrão lógico do IAM `TESTUSER` nesse perfil. + Execute a transação `SU01`. + Insira o ID de usuário de um usuário do SAP que testará a funcionalidade AWS do SDK. + Selecione **Alterar**. + Vá até a guia **Perfis** e atribua o perfil `ZAWS_SDK_DEMO_TESTUSER` ao usuário. + Selecione **Salvar**. ------ #### [ SDK for SAP ABAP - BTP edition ] **Crie uma função comercial** + Abra seu ambiente ABAP em um navegador da Web e navegue até o aplicativo **Maintain Business Roles**. + Selecione **Criar a partir do modelo** e insira os detalhes a seguir. + **Modelo** — Escolha`/AWS1/RT_BTP_ENDUSER`. + **Nova ID da função comercial** — insira uma ID. + **Descrição da nova função comercial** — insira uma descrição. + Selecione **OK** para ver a página da função comercial. + Na guia **Detalhes gerais da função**, **acesse Categorias de acesso** e defina o campo **Ajuda para gravação, leitura e valor** como **Restrito**. + Selecione **Manter restrições** e expanda **Tipos de restrição atribuídos** no painel de navegação esquerdo. Atualize o campo a seguir na seção **Restrições e valores**. + Em **Escolher sessão do SDK**, selecione o ícone de lápis ao lado do **Perfil do SDK** e navegue até a guia **Intervalos**. Digite `DEMO` e selecione **Adicionar**. + Em **Escolher função lógica do IAM**, selecione o ícone de lápis ao lado da **função lógica do IAM** e navegue até a guia **Intervalos**. Digite `TESTUSER` e selecione **Adicionar**. Selecione o ícone de lápis ao lado do **Perfil do SDK** e navegue até a guia **Intervalos**. Digite `DEMO` e selecione **Adicionar** + Navegue de volta até o modelo de Função Comercial e abra a guia **Usuários Comerciais**. Selecione **Adicionar** para atribuir a função comercial recém-criada a um usuário comercial da SAP que testará a funcionalidade do SDK. Selecione **Salvar**. Qualquer usuário comercial atribuído à função comercial criada será autorizado a usar as funções do AWS SDK com as configurações definidas no perfil do `DEMO` SDK. O usuário autorizado também assumirá o perfil do IAM mapeado para o padrão lógico do IAM `TESTUSER` nesse perfil. ------ ## Etapa 6: escrever o código Consulte as guias a seguir para obter mais detalhes. ------ #### [ SDK for SAP ABAP ] 1. Encerrar transação `SE38`. + Insira `ZDEMO_TRANSLATE_HELLO_WORLD` como nome do programa. + Selecione `Create`. + Insira `AWS SDK Hello World In Any Language` como título. + Tipo: escolha **Programa executável**. + Status: escolha **Programa de teste**. + Selecione **Salvar**. + Salve o programa como um **objeto local**. **Adicione o seguinte código**. ``` *&---------------------------------------------------------------------* *& Report  ZAWS1_DEMO_XL8_SIMPLE *& *&---------------------------------------------------------------------* *& A simple demo of language translation with AWS Translate *& *&---------------------------------------------------------------------* REPORT zaws1_demo_xl8_simple. START-OF-SELECTION.   PARAMETERS pv_text TYPE /aws1/xl8boundedlengthstring DEFAULT 'Hello, World' OBLIGATORY.   PARAMETERS pv_lang1 TYPE languageiso DEFAULT 'EN' OBLIGATORY.   PARAMETERS pv_lang2 TYPE languageiso DEFAULT 'ES' OBLIGATORY.   TRY.       DATA(go_session) = /aws1/cl_rt_session_aws=>create( 'DEMO' ).       DATA(go_xl8)     = /aws1/cl_xl8_factory=>create( go_session ).       DATA(lo_output) = go_xl8->translatetext(            iv_text               = pv_text            iv_sourcelanguagecode = CONV /aws1/xl8languagecodestring( pv_lang1 )            iv_targetlanguagecode = CONV /aws1/xl8languagecodestring( pv_lang2 )       ).       WRITE: / 'Source Phrase: ', pv_text.       WRITE: / 'Target Phrase: ', lo_output->get_translatedtext( ).     CATCH /aws1/cx_xl8unsuppedlanguage00 INTO DATA(lo_lang).       WRITE: / 'ERROR' COLOR COL_NEGATIVE,                'Cannot translate from',                lo_lang->sourcelanguagecode,                'to',                lo_lang->targetlanguagecode.     CATCH cx_root INTO DATA(lo_root).       WRITE: / 'ERROR' COLOR COL_NEGATIVE, lo_root->get_text( ).   ENDTRY. ``` ------ #### [ SDK for SAP ABAP - BTP edition ] 1. Clique com o botão direito do mouse no pacote em que a classe ABAP precisa ser criada e selecione **Novo** > Classe **ABAP**. 1. Insira `ZCL_DEMO_XL8_SIMPLE` o nome da classe e adicione uma descrição da classe. Escolha **Próximo**. 1. Crie ou escolha uma solicitação de transporte. Selecione **Concluir**. **Adicione o seguinte código**. ``` CLASS zcl_demo_xl8_simple DEFINITION PUBLIC FINAL CREATE PUBLIC . PUBLIC SECTION. INTERFACES if_oo_adt_classrun. PROTECTED SECTION. PRIVATE SECTION. ENDCLASS. CLASS zcl_demo_xl8_simple IMPLEMENTATION. METHOD if_oo_adt_classrun~main. TRY. " input parameters DATA(pv_text) = |Hello, World|. DATA(pv_lang1) = |EN|. DATA(pv_lang2) = |ES|. DATA(go_session) = /aws1/cl_rt_session_aws=>create( 'DEMO' ). DATA(go_xl8) = /aws1/cl_xl8_factory=>create( go_session ). DATA(lo_output) = go_xl8->translatetext( iv_text = pv_text iv_sourcelanguagecode = pv_lang1 iv_targetlanguagecode = pv_lang2 ). out->write( |Source Phrase: { pv_text }| ). out->write( |Target Phrase: { lo_output->get_translatedtext( ) }| ). CATCH /aws1/cx_xl8unsuppedlanguage00 INTO DATA(lo_lang). out->write( |ERROR - Cannot translate from { lo_lang->sourcelanguagecode } to { lo_lang->targetlanguagecode }| ). CATCH cx_root INTO DATA(lo_root). out->write( |ERROR - { lo_root->get_text( ) }| ). ENDTRY. ENDMETHOD. ENDCLASS. ``` ------ [Para obter detalhes sobre como escrever código ABAP que usa o SDK, consulte Usando. AWS SDK para SAP ABAP](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/using-sdk.html) ## Etapa 7: executar o aplicativo Consulte as guias a seguir para obter mais detalhes. ------ #### [ SDK for SAP ABAP ] Execute o aplicativo no `SE38`. Se for bem-sucedido, o seguinte será o resultado. ``` Source Phrase: Hello, World Target Phrase: Hola, mundo ``` Se você não tiver autorizações, configurações ou pré-requisitos básicos, poderá receber uma mensagem de erro. Veja o exemplo a seguir. ``` ERROR Could not find configuration under profile DEMO with scenario DEFAULT for SBX:001 ``` Se seu perfil do SAP autorizar você a usar um perfil do SDK e mapeá-lo para um perfil lógico do IAM, enquanto suas permissões do IAM não estiverem configuradas para que o sistema SAP assuma o perfil do IAM, o seguinte será seu resultado. ``` ERROR Could not assume role arn:aws:iam::111122223333:role/SapDemoTranslate ``` Nesse caso, revise suas permissões do IAM e a configuração de confiança nos perfis, nos usuários ou em ambos do IAM definidos em [Etapa 1: Prepare sua AWS conta](#prepare-account). ------ #### [ SDK for SAP ABAP - BTP edition ] Execute o aplicativo no **Eclipse** > **Executar como** > **Aplicativo ABAP (Console)**. Se for bem-sucedido, o seguinte será o resultado. ``` Source Phrase: Hello, World Target Phrase: Hola, mundo ``` Se você não tiver autorizações, configurações ou pré-requisitos básicos, poderá receber uma mensagem de erro. Veja o exemplo a seguir. ``` ERROR Could not find configuration under profile DEMO with scenario DEFAULT for SBX:001 ``` Se seu perfil do SAP autorizar você a usar um perfil do SDK e mapeá-lo para um perfil lógico do IAM, enquanto suas permissões do IAM não estiverem configuradas para que o sistema SAP assuma o perfil do IAM, o seguinte será seu resultado. ``` ERROR Could not assume role arn:aws:iam::111122223333:role/SapDemoTranslate ``` Nesse caso, revise suas permissões do IAM e a configuração de confiança nos perfis, nos usuários ou em ambos do IAM definidos em [Etapa 1: Prepare sua AWS conta](#prepare-account). ------