---
title: Deploying the integration files
description: To get started with the integration, deploy the Microsoft Login Integration Kit files to your PingFederate directory.
component: microsoft-login
page_id: microsoft-login:setup:pf_microsoft_login_ik_deploying_the_integration_files
canonical_url: https://docs.pingidentity.com/integrations/microsoft-login/setup/pf_microsoft_login_ik_deploying_the_integration_files.html
revdate: September 17, 2025
section_ids:
  steps: Steps
---

# Deploying the integration files

To get started with the integration, deploy the Microsoft Login Integration Kit files to your PingFederate directory.

## Steps

1. Download the Microsoft Login Integration Kit `.zip` archive from the [**Add-ons** tab of the PingFederate downloads page](https://www.pingidentity.com/en/resources/downloads/pingfederate.html) or the [Ping Identity Marketplace](https://marketplace.pingone.com/item/microsoft-login-integration-kit).

2. Stop PingFederate if it's running.

3. If you're upgrading an existing deployment, back up your customizations and delete previous versions of the integration files.

   1. Back up any Microsoft Login Integration Kit files that you customized in `<pf_install>/pingfederate/server/default/conf/`.

   2. Delete `pf-microsoft-idp-adapter-<version>.jar` from `<pf_install>/pingfederate/server/default/deploy`.

4. Extract the `.zip` archive and merge the contents of the `dist` directory with your `<pf_install>/pingfederate` directory.

5. If there's more than one version of the `pf-authn-api-sdk-<version>.jar` file in your `<pf_install>/pingfederate/server/default/lib` directory, delete all but the latest version of the file.

6. If you backed up any customized files, modify the new files with your customizations.

7. Start PingFederate.

8. If you operate PingFederate in a cluster, repeat steps 2 - 7 for each engine node.