aws_sdk_pcaconnectorscep/client/

create_connector.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`CreateConnector`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`certificate_authority_arn(impl Into<String>)`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder::certificate_authority_arn) / [`set_certificate_authority_arn(Option<String>)`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder::set_certificate_authority_arn):<br>required: **true**<br><p>The Amazon Resource Name (ARN) of the Amazon Web Services Private Certificate Authority certificate authority to use with this connector. Due to security vulnerabilities present in the SCEP protocol, we recommend using a private CA that's dedicated for use with the connector.</p> <p>To retrieve the private CAs associated with your account, you can call <a href="https://docs.aws.amazon.com/privateca/latest/APIReference/API_ListCertificateAuthorities.html">ListCertificateAuthorities</a> using the Amazon Web Services Private CA API.</p><br>
    ///   - [`mobile_device_management(MobileDeviceManagement)`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder::mobile_device_management) / [`set_mobile_device_management(Option<MobileDeviceManagement>)`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder::set_mobile_device_management):<br>required: **false**<br><p>If you don't supply a value, by default Connector for SCEP creates a connector for general-purpose use. A general-purpose connector is designed to work with clients or endpoints that support the SCEP protocol, except Connector for SCEP for Microsoft Intune. With connectors for general-purpose use, you manage SCEP challenge passwords using Connector for SCEP. For information about considerations and limitations with using Connector for SCEP, see <a href="https://docs.aws.amazon.com/privateca/latest/userguide/scep-connector.htmlc4scep-considerations-limitations.html">Considerations and Limitations</a>.</p> <p>If you provide an <code>IntuneConfiguration</code>, Connector for SCEP creates a connector for use with Microsoft Intune, and you manage the challenge passwords using Microsoft Intune. For more information, see <a href="https://docs.aws.amazon.com/privateca/latest/userguide/scep-connector.htmlconnector-for-scep-intune.html">Using Connector for SCEP for Microsoft Intune</a>.</p><br>
    ///   - [`client_token(impl Into<String>)`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder::set_client_token):<br>required: **false**<br><p>Custom string that can be used to distinguish between calls to the <a href="https://docs.aws.amazon.com/C4SCEP_API/pca-connector-scep/latest/APIReference/API_CreateChallenge.html">CreateChallenge</a> action. Client tokens for <code>CreateChallenge</code> time out after five minutes. Therefore, if you call <code>CreateChallenge</code> multiple times with the same client token within five minutes, Connector for SCEP recognizes that you are requesting only one challenge and will only respond with one. If you change the client token for each call, Connector for SCEP recognizes that you are requesting multiple challenge passwords.</p><br>
    ///   - [`tags(impl Into<String>, impl Into<String>)`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder::tags) / [`set_tags(Option<HashMap::<String, String>>)`](crate::operation::create_connector::builders::CreateConnectorFluentBuilder::set_tags):<br>required: **false**<br><p>The key-value pairs to associate with the resource.</p><br>
    /// - On success, responds with [`CreateConnectorOutput`](crate::operation::create_connector::CreateConnectorOutput) with field(s):
    ///   - [`connector_arn(Option<String>)`](crate::operation::create_connector::CreateConnectorOutput::connector_arn): <p>Returns the Amazon Resource Name (ARN) of the connector.</p>
    /// - On failure, responds with [`SdkError<CreateConnectorError>`](crate::operation::create_connector::CreateConnectorError)
    pub fn create_connector(&self) -> crate::operation::create_connector::builders::CreateConnectorFluentBuilder {
        crate::operation::create_connector::builders::CreateConnectorFluentBuilder::new(self.handle.clone())
    }
}