Usted está aquí:
Crear o modificar una credencial nombrada
Configure una credencial nombrada para especificar la URL de un extremo de llamada. Para especificar los parámetros de autenticación requeridos para la llamada, conecte la credencial nombrada a una credencial externa.
Ediciones necesarias
| Disponible en: Salesforce Classic (no disponible en todas las organizaciones) y Lightning Experience |
| Disponible en: todas las ediciones |
| Permisos de usuario necesarios | |
|---|---|
| Para ver credenciales nombradas: | Ver parámetros y configuración |
| Para crear, modificar o eliminar credenciales nombradas: | Gestionar credenciales denominadas o personalizar aplicación |
Antes de crear una credencial nombrada, debe crear una credencial externa a la que vincularla. Consulte Crear o modificar una credencial externa. Para obtener una descripción general de los pasos requeridos para configurar una credencial nombrada, consulte Crear credenciales nombradas y credenciales externas.
- Desde Configuración, en el cuadro Búsqueda rápida, ingrese Credenciales nombradas y luego seleccione Credenciales nombradas.
- Haga clic en Credenciales nombradas.
-
Para crear una nueva credencial nombrada, haga clic en Nuevo. Para modificar una credencial nombrada existente, haga clic en su vínculo en la lista de credenciales nombradas y, a continuación, haga clic en Modificar.
Nota Si desea crear una credencial nombrada heredada, seleccione Nueva heredada desde el menú desplegable en su lugar y siga las instrucciones en Definir una credencial nombrada heredada. Las credenciales nombradas heredadas ya no se actualizan o mejoran. -
Rellene los campos.
Campo Descripción Etiqueta Nombre fácil de recordar para la credencial nombrada que se muestra en la interfaz de usuario de Salesforce, como en vistas de lista. Nombre Un identificador exclusivo empleado para hacer referencia a esta credencial nombrada desde definiciones de llamadas a través de la API.
El nombre solo puede contener guiones bajos y caracteres alfanuméricos. Debe ser exclusivo, comenzar por una letra, no terminar con un guión bajo y no contener espacios ni dos guiones bajos consecutivos.
URL La URL o URL de raíz del extremo de la llamada. Debe comenzar por
https://. Puede incluir una ruta pero no una cadena de consulta. Por ejemplo:https://my_endpoint.example.com/secure/payrollNo obstante, puede anexar una cadena de consulta y una ruta específica en la referencia de la definición de la llamada a la credencial nombrada.
Por ejemplo, una llamada de Apex puede hacer referencia a la credencial nombrada “My_Payroll_System” de la manera siguiente.
HttpRequest req = new HttpRequest(); req.setEndpoint('callout:My_Payroll_System/paystubs?format=json');Activado para llamadas De forma predeterminada, la capacidad de realizar llamadas con la credencial nombrada está activada. Existen dos excepciones donde este campo está desactivado: Cuando la credencial nombrada se crea desde una aplicación Apex o cuando cualquier extremo en la credencial nombrada o su credencial externa relacionada o proveedor de identidad de autenticación se actualiza desde una aplicación Apex. Tenga en cuenta las consideraciones de seguridad al activar llamadas para credenciales nombradas que se originan o se actualizan desde Apex. Autenticación Credencial externa El nombre de una credencial externa. Consulte Crear o modificar una credencial externa. Certificado de cliente Opcional. Si especifica un certificado, su organización de Salesforce lo proporciona al establecer cada conexión SSL bidireccional con el sistema externo. Se utiliza el certificado para firmas digitales, lo que comprueba que las solicitudes proceden de su organización de Salesforce. Opciones de llamadas Generar encabezado de autorización De forma predeterminada, Salesforce genera un encabezado de autorización y lo aplica a cada llamada que hace referencia a la credencial nombrada.
Anule esta opción solo si se aplica una de las siguientes declaraciones.
- El extremo remoto no admite encabezados de autorización.
- Va a generar un encabezado de autorización creando un encabezado personalizado y asignándole el nombre “Autorización”. Por ejemplo, cree un encabezado de autorización personalizado si está utilizando la autorización básica HTTP. Del mismo modo, en llamadas de Apex, puede hacer que el código construya un encabezado de autorización personalizado para cada llamada.
Esta opción es necesaria si hace referencia a la credencial nombrada desde un origen de datos externo. Consulte Encabezados personalizados y cuerpos de llamadas de Apex que utilizan credenciales nombradas.
Permitir fórmulas en encabezado HTTP Utilice campos de credenciales como campos de fórmula en encabezados personalizados de credenciales nombradas, encabezados personalizados de credenciales externas y encabezados HTTP de Apex. Por ejemplo:
Client-ID: {!$Credential.MyExtCred.MyClientId}El valor predeterminado es falso. Consulte Encabezados personalizados y cuerpos de llamadas de Apex que utilizan credenciales nombradas.
Permitir fórmulas en el cuerpo de HTTP Permita a Apex construir el cuerpo de HTTP de la llamada con campos de credenciales disponibles como campos de fórmula. El valor predeterminado es falso. Consulte Encabezados personalizados y cuerpos de llamadas de Apex que utilizan credenciales nombradas. Conexión de red saliente Utilice una conexión privada que omita la Internet pública. Ingrese el nombre de una conexión de red saliente existente. Consulte Proteger integraciones entre nubes con Conexión privada.
Si selecciona esta opción, su nueva credencial nombrada tiene PrivateEndpoint como su tipo. De lo contrario, la credencial nombrada tiene un tipo SecuredEndpoint.
Espacios de nombres permitidos para llamadas Lista opcional de espacios de nombres que identifica los paquetes gestionados que se permiten realizar llamadas utilizando esta credencial nombrada.
- Para paquetes gestionados, el suscriptor debe agregar el espacio de nombres del paquete a una lista de espacios de nombres permitidos de una credencial nombrada para activar las llamadas. Esta acción no es necesaria si la credencial nombrada está instalada como parte del mismo paquete.
- Si dispone de varias organizaciones, puede crear una credencial nombrada con el mismo nombre pero con una URL de extremo diferente en cada organización. A continuación, puede empaquetar e implementar (en todas las organizaciones) una definición de llamada que hace referencia al nombre compartido de esas credenciales nombradas. Por ejemplo, la credencial nombrada en cada organización puede tener una URL de extremo diferente para dar cabida a diferencias en entornos de desarrollo y producción. Si una llamada de Apex especifica el nombre compartido de esas credenciales nombradas, las clase de Apex que define la llamada se puede empaquetar e implementar en todas esas organizaciones sin comprobar el entorno de forma programática.
Las credenciales nombradas no se agregan automáticamente a paquetes. Si empaqueta una fuente de datos externa o código de Apex que especifica una credencial nombrada como un extremo de llamada, agregue la credencial nombrada al paquete. Además, asegúrese de que la organización de suscriptor tiene una credencial nombrada válida con el mismo nombre.
- Haga clic en Guardar. Se le llevará a la pantalla Credenciales nombradas.
- De manera opcional, cree un encabezado personalizado para esta credencial nombrada o modifique un encabezado personalizado existente. Consulte Crear y modificar encabezados personalizados.
Para hacer referencia a una credencial denominada desde una definición de llamada, utilice la dirección URL de la credencial denominada. La URL de una credencial con nombre contiene el esquema callout:, el nombre de la credencial con nombre y una ruta opcional. Por ejemplo: callout:Mi_credencial_nombrada/alguna_ruta.
Puede adjuntar una cadena de consulta a una dirección URL de una credencial nombrada. Utilice una interrogación (?) como el separador entre la dirección URL de una credencial nombrada y la cadena de consulta. Por ejemplo: callout:Mi_credencial_nombrada/alguna_ruta?format=json.
Finalizó los pasos principales para crear una credencial nombrada. A continuación, otorgue acceso a principales de credenciales externas y credenciales externas de usuario para autorizar a los usuarios a realizar llamadas autenticadas.
