Package: ethyca-fides
Meet Fides: Privacy as Code:zap: OverviewFides (pronounced/fee-dhez/, from Latin: Fidēs) is an open-source privacy engineering platform for managing the fulfillment of data privacy requests in your runtime environment, and the enforcement of privacy regulations in your code.:rocket: Quick StartGetting StartedIn order to get started quickly with Fides, a sample project is bundled within the Fides CLI that will set up a server, privacy center, and a sample application for you to experiment with.Minimum requirements (for all platforms)Docker(version 20.10.11 or later)Python(version 3.8 through 3.10)Download and install FidesYou can easily download and install Fides usingpip. Run the following command to get started:pipinstallethyca-fidesDeploy the Fides sample projectBy default, Fides ships with a small project belonging to a fictional e-commerce store. Running thefides deploy upcommand builds a Fides project with all you need to run your first Data Subject Request against real databases.fidesdeployupExplore the sample projectWhen your deployment finishes, a welcome screen will explain the key components of Fides and the sample "Cookie House" project.If your browser does not open automatically, you should navigate tohttp://localhost:3000/landing.The project contains:The Fides Admin UI for managing privacy requestsThe FidesPrivacy Centerfor submitting requestsThe sample "Cookie House" eCommerce site for testingA DSR Directory on your computer to view results (./fides_uploads)Run your first Privacy Access RequestNavigate to the Fides Privacy Center (http://localhost:3001), submit a "Download your data" request, provide the email address for the sample user (jane@example.com), and submit the request.Then, navigate to the Fides Admin UI (http://localhost:8080) to review the pending privacy request.Use usernameroot_userand passwordTestpassword1!to login, approve the request, and review the resulting package in your./fides_uploadsfolder!Next StepsCongratulations! You've just run an entire privacy request in under 5 minutes! Fides offers many more tools to help take control of your data privacy. To find out more, you can run a privacy request onyour own infrastructure, discoverdata mapping, or learn about theFides Taxonomy.:book: Learn MoreThe Fides core team is committed to providing a variety of documentation to help get you started using Fides.  As such, all interactions are governed by theFides Code of Conduct.DocumentationFor more information on getting started with Fides, how to configure and set up Fides, and more about the Fides ecosystem of open source projects:Documentation:https://docs.ethyca.comWebsite:www.ethyca.com/fidesSupportJoin the conversation on:SlackTwitterDiscussionsContributingWe welcome and encourage all types of contributions and improvements!  Please see ourcontribution guideto opening issues for bugs, new features, and security or experience enhancements.Read about theFides communityor dive into thecontributor guidesfor information about contributions, documentation, code style, testing and more. Ethyca is committed to fostering a safe and collaborative environment, such that all interactions are governed by theFides Code of Conduct.:balance_scale: LicenseTheFidesecosystem of tools are licensed under theApache Software License Version 2.0.
Fides tools are built onfideslang, the Fides language specification, which is licensed underCC by 4.Fides is created and sponsored by Ethyca: a developer tools company building the trust infrastructure of the internet. If you have questions or need assistance getting started, let us know atfides@ethyca.com!⚠️ Advanced Setup for Microsoft SQL Server (MSSQL) SupportBy default, runningpip install ethyca-fideslocally will not install the optional Python libraries needed for Microsoft SQL Server, since these rely on additional system dependencies (freetds)! However, if youdowant to connect to MSSQL, you have two options:Use our pre-built Docker images which install these optional dependencies automatically:ethyca/fides. See ourDeployment Guidefor more!Install the required dependencies on your local development machine and runpip install ethyca-fides[all]to include "all" the optional libraries. Keep reading to learn more about this!For local development setup on macOS, follow these steps:Install the required development libraries from Homebrew:brewinstallfreetdsopensslAdd the following to your shell (i.e..zshrc) to ensure your compiler can access thefreetdsandopenssllibraries, updating the paths & versions to match your local install:exportLDFLAGS="-L/opt/homebrew/Cellar/freetds/1.3.18/lib -L/opt/homebrew/Cellar/openssl@1.1/1.1.1u/lib"`exportCFLAGS="-I/opt/homebrew/Cellar/freetds/1.3.18/include"Reinstall Fides with MSSQL support by including theallextra requirement:pipinstallethyca-fides[all]