Amazon S3 / MinIO Odoo Integration v.19

De tool hangt af van de externe bibliotheek 'boto3'. Installeer die voor je Odoo-server met:

1. Zet de optie 'Amazon S3 Sync' aan (Cloud Storage > Configuration > Configuration). De optionele add-on Amazon S3 Odoo Integration is vereist
2. Open de Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Maak een nieuwe bucket of kies een bestaande. Kopieer de exacte bucketnaam: die moet in Odoo in het veld 'Bucket' worden ingevoerd
4. Open de bucketdetails en kopieer de AWS Region. Voer die in Odoo in het veld 'Region' in (bijvoorbeeld eu-west-1 of us-east-1)
5. Open de AWS IAM Console: https://console.aws.amazon.com/iam/
6. Maak een nieuwe IAM-gebruiker of kies een bestaande technische gebruiker. Deze gebruiker moet volledige rechten hebben om objecten in de geselecteerde bucket te listen, lezen, aanmaken, schrijven, kopiëren en verwijderen. Je kan de volledige admin-rechten kiezen, of een nieuw policy aanmaken (zie hieronder)
7. Open in het IAM-gebruikersformulier het tabblad 'Security credentials' en druk op 'Create access key'
8. Selecteer op de pagina 'Access key best practices & alternatives' de optie Application running outside AWS. Dat is de juiste optie wanneer je Odoo-server via een access key van buiten AWS, vanaf Odoo.sh, vanaf je eigen server of vanaf een andere hostingprovider met S3 verbindt. Als je Odoo op een AWS EC2-instance staat, mag je in plaats daarvan Application running on an AWS compute service kiezen; de velden die je naar Odoo kopieert zijn hetzelfde
9. Druk op 'Next'. Voer in de volgende stap optioneel een description tag in zoals Odoo S3 Sync en druk daarna op 'Create access key'
10. Kopieer op de laatste AWS-pagina Access key of Access key ID naar het Odoo-veld 'Access Key'
11. Kopieer Secret access key naar het Odoo-veld 'Secret Key'. Belangrijk: AWS toont de secret key slechts één keer, dus bewaar die voordat je het venster sluit
12. Als je een S3-compatibele provider gebruikt in plaats van AWS S3, kopieer dan de endpoint URL uit het adminpaneel van die provider en voer die in Odoo in het veld 'Amazon S3 endpoint URL' in. MinIO gebruikt vaak een URL zoals https://minio.example.com of http://localhost:9000; LocalStack gebruikt meestal http://localhost:4566
13. Ga naar Odoo Cloud Storage > Configuration > Cloud Clients en druk op 'Create'
14. Voer als referentie een naam in die voor alle gebruikers duidelijk is
15. Kies als Cloud client 'Amazon S3'
16. Voer als Root folder name een titel in die als bovenliggende S3-prefix voor alle gesynchroniseerde mappen wordt gebruikt. Bijvoorbeeld 'Odoo' of 'OdooERP'
17. Vul de velden 'Bucket', 'Region', 'Access Key', 'Secret Key' in, en indien nodig 'Amazon S3 endpoint URL' en addressing style
18. Kies of Odoo tijdelijke presigned URLs of openbare bucket-/CDN-URLs moet gebruiken. Houd voor privébuckets presigned URLs ingeschakeld en stel de levensduur in seconden in
19. Druk op 'Confirm'. Odoo controleert de buckettoegang en maakt of verifieert de root-folderprefix. De Amazon S3 - Odoo-synchronisatie is klaar om te lopen
20. Pas de nieuw aangemaakte cloudclient toe op mapregels en/of handmatige mappen die naar die Amazon S3-bucket gesynchroniseerd moeten worden
21. Wacht tot de geplande sync-job start. Alleen voor testdoeleinden: start de integratie handmatig via Cloud Storage > Configuration > Configuration > de knop 'Launch sync'.

Nuttige AWS-documentatie: een S3-bucket aanmaken: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM-access keys beheren: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Voorbeeld van een bucket policy

Amazon S3 heeft een belangrijk kenmerk: de in Odoo getoonde URL is altijd een Amazon-zijdige link.

Als Use Public URLs aan staat, slaat Odoo een directe S3-object-URL op. Die link werkt alleen als de bucket, prefix, het object, CDN of compatibele endpoint publiek leesbaar is. Anders toont Amazon S3 AccessDenied, ook als de gebruiker is aangemeld bij de AWS-console.

Voor publieke links configureert je bucketrechten in Amazon S3 en staat je publieke leestoegang tot de Odoo-prefix toe. Voorbeeld van een bucketpolicy:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PublicReadOdooPrefix",
      "Effect": "Allow",
      "Principal": "*",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/Odoo/*"
    }
  ]
}

Vervang YOUR_BUCKET_NAME door de echte bucketnaam en Odoo/ door de gekozen rootmapprefix. Zorg ook dat Amazon S3 Block public access die bucketpolicy niet blokkeert.

Als Use Public URLs uit staat, slaat Odoo AWS Console-links naar het bucketobject of de prefix op. Die zijn nuttig voor Amazon-gebruikers: wie de link opent, moet bij AWS zijn aangemeld en IAM-toegang tot dat object hebben. Zonder AWS-toegang opent Amazon het bestand niet.

1. Zorg voor een draaiende MinIO-server
2. Open de MinIO Console
3. Maak een nieuwe bucket of kies een bestaande. Kopieer de exacte bucketnaam: die moet in Odoo in het veld 'Bucket' worden ingevoerd
4. Maak toegangsgegevens voor Odoo. Gebruik in MinIO een access key / secret key-paar of een service account met rechten om objecten in de geselecteerde bucket te listen, lezen, aanmaken, schrijven, kopiëren en verwijderen
5. Kopieer de MinIO Access Key naar het Odoo-veld 'Access Key'
6. Kopieer de MinIO Secret Key naar het Odoo-veld 'Secret Key'. Belangrijk: bewaar de secret voordat je de MinIO-pagina sluit als MinIO die slechts één keer toont
7. Kopieer de MinIO S3 API-endpoint-URL naar Odoo in het veld 'Amazon S3 endpoint URL'. Een lokale server gebruikt meestal http://localhost:9000, een productieserver bijvoorbeeld https://minio.example.com
8. Ga naar Odoo Cloud Storage > Configuration > Cloud Clients en druk op 'Create'
9. Voer als referentie een naam in die voor alle gebruikers duidelijk is
10. Kies als Cloud client 'MinIO'
11. Voer als Root folder name een titel in die als bovenliggende MinIO-objectprefix voor alle gesynchroniseerde mappen wordt gebruikt. Bijvoorbeeld 'Odoo' of 'OdooERP'
12. Vul de velden 'Bucket', 'Access Key', 'Secret Key' en 'Amazon S3 endpoint URL' in. Het veld 'Region' is optioneel voor MinIO; als het leeg is, gebruikt Odoo us-east-1 voor S3-compatibele signing
13. Houd de addressing style op Path-style. Dit is de aanbevolen optie voor MinIO-endpoints, vooral wanneer de MinIO-host geen bucket-specifieke DNS-namen biedt
14. Kies of Odoo directe openbare MinIO-URLs moet gebruiken. Schakel 'Use Public URLs' alleen in wanneer de bucket, prefix, reverse proxy of CDN openbaar leesbaar is. Laat het voor privé-MinIO-buckets uitgeschakeld
15. Druk op 'Confirm'. Odoo controleert de buckettoegang en maakt of verifieert de root-folderprefix. De MinIO - Odoo-synchronisatie is klaar om te lopen
16. Pas de nieuw aangemaakte cloudclient toe op mapregels en/of handmatige mappen die naar die MinIO-bucket gesynchroniseerd moeten worden
17. Wacht tot de geplande sync-job start. Alleen voor testdoeleinden: start de integratie handmatig via Cloud Storage > Configuration > Configuration > de knop 'Launch sync'.

Nuttige MinIO-documentatie: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.